Complete the overworld foundation

Port forced movement (turn delays, bumps, ice, currents, pits), dynamic
return warps, elevators, Surf, Cut, Strength and cycling rules, working
map blocks with changeblock/changemapblocks, and the remaining NPC
movement types and movement commands.

Add tileset animation from the ROM's command tables, grass sprite
priority and special map palettes; room decorations with ownership, the
bedroom PC and save migration; and Key Items access to the Bicycle.

Fourteen original-engine traces compare positions, facing, actors, event
flags and scripted poses. Tile animation matches original VRAM for four
tilesets, and LoadMapPals matches 192 palette cases. skyfall_top now
keeps the $60 sprite offset its step function leaves behind.

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

tests/foundation-browser.spec.ts

@@ -0,0 +1,118 @@
+import { test, expect, type Page } from "@playwright/test";
+import { existsSync, readFileSync } from "node:fs";
+import { resolve } from "node:path";
+const romPath = resolve(
+  process.env.CRYSTAL_ROM_PATH ??
+    "Pokemon - Crystal Version (UE) (V1.1) [C][!].gbc",
+);
+test.beforeEach(() =>
+  test.skip(!existsSync(romPath), "Requires the local user ROM."),
+);
+
+async function start(page: Page, room: boolean | "poster" = false) {
+  await page.route("**/src/game/runtime.ts", async (route) => {
+    const response = await route.fetch(),
+      source = await response.text();
+    const needle = "const world = new GameWorld(assets);";
+    expect(source).toContain(needle);
+    await route.fulfill({
+      response,
+      body: source.replace(
+        needle,
+        `const { foundationFixture } = await import('/tests/foundation-fixture.ts'); const world = foundationFixture(assets, ${JSON.stringify(room)});`,
+      ),
+    });
+  });
+  await page.clock.install({ time: new Date("2026-09-22T12:00:00") });
+  await page.goto("/");
+  await page.locator("#rom-file").setInputFiles(romPath);
+  await expect(page.locator("#status")).toContainText("verified");
+  await page.clock.pauseAt(new Date("2026-09-22T12:05:00"));
+  await page.locator("#play").click();
+}
+async function backup(page: Page) {
+  await page.locator("#tab-saves").click();
+  const download = page.waitForEvent("download");
+  await page.locator("#backup").click();
+  const path = (await (await download).path())!;
+  const record = JSON.parse(readFileSync(path, "utf8"));
+  return {
+    path,
+    state: JSON.parse(Buffer.from(record.state, "base64").toString("utf8")),
+  };
+}
+test("Start opens Key Items, freezes movement, and uses the Bicycle with keyboard and touch", async ({
+  page,
+}) => {
+  await start(page);
+  await page.keyboard.press("Enter");
+  await expect(page.locator("#field-menu")).toBeVisible();
+  await page.keyboard.down("ArrowDown");
+  await page.clock.runFor(1000);
+  await page.keyboard.up("ArrowDown");
+  await expect(page.locator("#game-screen")).toHaveAttribute("data-y", "6");
+  await page
+    .locator("#field-items")
+    .getByRole("button", { name: "BICYCLE", exact: true })
+    .click();
+  await page.keyboard.press("KeyX");
+  await page.clock.runFor(500);
+  await expect(page.locator("#field-menu")).toBeHidden();
+  await expect(page.locator("#game-notice")).toHaveText("");
+  expect((await backup(page)).state.playerState).toBe(1);
+});
+test("the bedroom PC puts away a decoration and saves the result", async ({
+  page,
+}) => {
+  await start(page, true);
+  await page.keyboard.press("KeyX");
+  await expect(page.locator("#game-notice")).toHaveText("");
+  await expect(page.locator("#dialogue-text")).toHaveText("DECORATION");
+  const choices = page.locator("#dialogue-choice");
+  await choices.getByRole("option", { name: "BED", exact: true }).click();
+  await choices
+    .getByRole("option", { name: "PUT IT AWAY", exact: true })
+    .click();
+  await page.keyboard.press("KeyX");
+  await choices.getByRole("option", { name: "EXIT", exact: true }).click();
+  await page.clock.runFor(500);
+  await expect(page.locator("#game-notice")).toHaveText("");
+  expect((await backup(page)).state.decorations.bed).toBe(0);
+});
+test("B cancels the pack and an indoor Bicycle attempt leaves the player walking", async ({
+  page,
+}) => {
+  await start(page, true);
+  await page.keyboard.press("Enter");
+  await page.keyboard.press("KeyZ");
+  await expect(page.locator("#field-menu")).toBeHidden();
+  await page.keyboard.press("Enter");
+  await page
+    .locator("#field-items")
+    .getByRole("button", { name: "BICYCLE", exact: true })
+    .click();
+  await expect(page.locator("#game-notice")).toContainText("can’t use");
+  expect((await backup(page)).state.playerState).toBe(0);
+});
+
+test("the Town Map poster opens a native map and closes with B", async ({
+  page,
+}) => {
+  await page.setViewportSize({ width: 320, height: 568 });
+  await start(page, "poster");
+  await page.keyboard.press("KeyX");
+  await expect(page.locator("#dialogue-text")).toContainText("TOWN MAP");
+  await page.keyboard.press("KeyX");
+  await expect(page.locator("#town-map-view")).toBeVisible();
+  const colors = await page
+    .locator("#town-map-canvas")
+    .evaluate(
+      (canvas: HTMLCanvasElement) =>
+        new Set(canvas.getContext("2d")!.getImageData(0, 0, 160, 144).data)
+          .size,
+    );
+  expect(colors).toBeGreaterThan(8);
+  await page.keyboard.press("KeyZ");
+  await expect(page.locator("#town-map-view")).toBeHidden();
+  await expect(page.locator("#game-notice")).toHaveText("");
+});