Open Routes 38 to 41, Olivine and Cianwood to the Mineral Badge (#32)

Enable Route 38 and its Ecruteak gate, Route 39 with the MooMoo farm,
Olivine City and its buildings, the Lighthouse's six floors, Routes 40
and 41, and Cianwood City with its gym, pharmacy, Photo Studio, Mania's
house, the Poke Seer and the Lugia speech house. Olivine's port, the
Battle Tower gate and Whirl Islands stay closed. The story runs from the
rival in Olivine through Jasmine and Amphy, Suicune and Eusine, the
SecretPotion, Chuck's boulders, the STORMBADGE, TM01 and HM02, back to
Amphy's cure, Jasmine, the MINERALBADGE and TM23.

Port GiveShuckle and ReturnShuckie with every return code and Mania's
wrong last-Pokemon speech, PokeSeer with its high-byte-only OT check and
reused caught level, PhotoStudio's no-printer path (Printer Error 2),
and PlaySlowCry. wMooMooBerries joins the saved script bytes.

Port trainer item AI: the 13 healing, status and X items, the
highest-level gate, item use while Mean Look or Wrap prevents
switching, and the original's random and state quirks, checked against
the ROM over 5,632 states. Leaders with items are no longer refused.

Game Corner sprites match the original frame by frame: cursor and reel
positions, Golem's whole-frame flips, frame timing, the frame a removed
sprite is still drawn, and the Golem roll's screen shake. The Burned
Tower rival's garbage trainer header is documented as a boundary: its
seen text dispatches text command $7f into home code before any battle.

The playthrough continues for six stages to Jasmine; its driver can
Surf, fish and travel through floors joined by holes. New tests cover
trainer items, Olivine and Cianwood side content, and reference checks
for trainer items, trainer sight and Game Corner animations.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

tests/world-driver.ts

@@ -88,11 +88,17 @@ const edges = (tile: number): readonly Direction[] =>
 const isWarpHazard = (tile: number) =>
   (tile & 0xf0) === 0x60 || (tile & 0xf0) === 0x70;
 
-/** Shortest walkable path on the current map, avoiding other warps. */
+/** COLL_WATER and the unused COLL_WATER_21: open water a surfer crosses
+ * freely, unlike currents, waterfalls and whirlpools. */
+const isOpenWater = (tile: number) => tile === 0x29 || tile === 0x21;
+
+/** Shortest walkable path on the current map, avoiding other warps.
+ * `water` also crosses open water, for a player who can Surf. */
 export function findPath(
   world: GameWorld,
   targetX: number,
   targetY: number,
+  { water = false } = {},
 ): Direction[] {
   const queue = [{ x: world.x, y: world.y, path: [] as Direction[] }];
   const visited = new Set<string>();
@@ -108,7 +114,8 @@ export function findPath(
       if (x < 0 || y < 0 || x >= world.map.width || y >= world.map.height)
         continue;
       const tile = world.assets.collision(world.map, x, y);
-      if (world.assets.permission(tile) !== 0) continue;
+      if (world.assets.permission(tile) !== 0 && !(water && isOpenWater(tile)))
+        continue;
       if (
         edges(world.assets.collision(world.map, node.x, node.y)).includes(direction) ||
         edges(tile).includes(OPPOSITE[direction])