Merge PR #143: correct Spanish Spheda and jump gate text

Apply anchored PAL Spanish script and event corrections without changing PS2 code.
Review the implementation for native style, retail operand types and bounded growth.

Invalidate motion storage across appended text and cache actual patched lengths.
Add loader regressions and validate the retail text through the archive-aware VFS.

Validation: Windows Debug build, clang-format, clang-tidy, and focused script text,
script timing, data loader and character motion regression suites.

Author: Adubbz

docs/PC.md

@@ -479,6 +479,30 @@ to move or throw away. `port/src/message_text.cpp` replaces the message in all
 five PAL languages with the translation's wording plus both, for example
 `You can only carry 999 "Thick Hide".`
 
+The PAL disc's Spanish script for the map where Max learns Spheda
+(`map/s/s17/s17_5.stb`) is a byte-for-byte copy of the Italian one, so its
+Spheda tutorial, prompts and dialogue read in Italian. `port/src/script_text.cpp`
+gives those 19 strings Spanish text when the script is read from the data index
+(`ResolveFile` in `port/src/dataread.cpp`), after the NTSC timing conversion. Each
+line is anchored on its push instruction and the Italian text it must find there;
+a script that does not show every line is left unchanged with a warning. A text
+that fits is written over the Italian one, a longer one is appended after the
+script, so the file reads 1 KB or so longer and size queries report the same.
+The wording keeps the PAL Spanish names (Esfera, Esfeda, Bastón Multiusos, Ayuda).
+
+The Spanish text of the Spheda lesson that follows (`event/e300/e314/e314_5.txt`)
+says there is nothing more to remember right before the colour rules, and has a
+Sphere turn black, a colour it never takes. The same file corrects those three
+lines by their exact text: "Tienes que acordarte de otra cosa más.", "De azul a
+rojo, de rojo a azul." and "...y cambiará el color.".
+
+The Spanish jump gate menus in Gundorada (`map/f/f04/f04_5.stb` and
+`map/s/s30/s30_5.stb`) put East and West on one line, "Puerta de salto Este --
+Oeste", so they show one destination fewer than the script offers: the last
+choice is blank and the ones after North lead one destination further than they
+say. The same file gives the three menus the English menu's lines, with East and
+West apart and the time gate named "Puerta del tiempo".
+
 ### darkchronicle
 
 ```

port/src/dataread.cpp

@@ -14,6 +14,7 @@
 #include <cstdio>
 #include <cstring>
 #include <filesystem>
+#include <limits>
 #include <optional>
 #include <print>
 #include <span>
@@ -22,6 +23,7 @@
 #include <thread>
 #include <unordered_map>
 #include <unordered_set>
+#include <utility>
 #include <vector>
 
 #include "bounded_text.hpp"
@@ -38,6 +40,7 @@
 #include "platform/texture_catalog.hpp"
 #include "platform/vfs.hpp"
 #include "profile.hpp"
+#include "script_text.hpp"
 #include "script_timing.hpp"
 #include "texture_copy.hpp"
 #include "texture_source.hpp"
@@ -261,6 +264,22 @@ bool ConvertScriptTiming(const std::string &key, void *buffer, int size) {
     return ok;
 }
 
+/**
+ * Corrects PAL text and records the complete patched buffer extent.
+ */
+int PatchScriptText(const std::string &key, void *buffer, int size) {
+    if (size < 0 || (!key.ends_with(".stb") && !key.ends_with(".txt"))) {
+        return size;
+    }
+    const auto extra = script_text::Extra(key);
+    if (extra > 0) {
+        ReportDestination(static_cast<unsigned char *>(buffer) + size, extra);
+    }
+    const auto patched = static_cast<int>(script_text::Patch(key, static_cast<unsigned char *>(buffer), static_cast<std::size_t>(size)));
+    loaded_buffers[buffer] = static_cast<std::size_t>(patched);
+    return patched;
+}
+
 // sceOpen maps host0: onto the save tree, so this reads back whatever WriteFile put there. -1 when the
 // save tree does not have the file, which sends the caller on to the data index.
 int ReadSaveFile(const char *name, void *buffer, bool size_only) {
@@ -317,17 +336,23 @@ int ResolveFile(const char *name, const std::string &key, void *buffer, bool siz
     if (!file) {
         return -1;
     }
+    const auto raw_size = FileSize(*file);
+    const auto extra = script_text::Extra(key);
+    if (!raw_size || std::cmp_greater(extra, std::numeric_limits<int>::max() - *raw_size)) {
+        return -1;
+    }
     if (!size_only) {
-        const int size = ReadWhole(*file, buffer);
+        int size = ReadWhole(*file, buffer);
         if (size >= 0) {
             if (!ConvertScriptTiming(key, buffer, size)) {
                 return -1;
             }
+            size = PatchScriptText(key, buffer, size);
             TextureSourceRegister(buffer, file->relative, static_cast<std::size_t>(size));
         }
         return size;
     }
-    return FileSize(*file).value_or(-1);
+    return *raw_size + static_cast<int>(extra);
 }
 
 CacheSlot *CacheFind(const std::string &key) {
@@ -878,7 +903,7 @@ PORT_OVERRIDE int LoadFileCacheBG(char *path) {
         cache_next += quadwords;
     }
 
-    if (!LoadFileBG(path, buffer, nullptr)) {
+    if (!LoadFileBG(path, buffer, &size)) {
         return 0;
     }
     return CacheRecord(key, buffer, size);