BUILD_PR_GAMES_PACMANLITE_GAMEPLAY_MIGRATION_TO_NEXT

Migrated gameplay to PacmanLite_next.

Author: DavidQ

docs/dev/CODEX_COMMANDS.md

@@ -2,12 +2,11 @@ MODEL: GPT-5.4
 REASONING: high
 
 COMMAND:
-Execute BUILD_PR_GAMES_PACMANLITE_NEXT_TEMPLATE_BASELINE
+Execute BUILD_PR_GAMES_PACMANLITE_GAMEPLAY_MIGRATION_TO_NEXT
 
 Rules:
-- Copy from games/_template/**
-- Create games/PacmanLite_next/**
-- Do NOT modify games/PacmanLite/**
-- No gameplay
-- Canvas text required
-- Fail fast on ambiguity
+- Read games/PacmanLite/**
+- Write games/PacmanLite_next/**
+- Correct folder placement
+- No guessing
+- Do NOT modify original

docs/dev/COMMIT_COMMENT.txt

@@ -1,2 +1,2 @@
-BUILD_PR_GAMES_PACMANLITE_NEXT_TEMPLATE_BASELINE
-Created PacmanLite_next baseline from template.
+BUILD_PR_GAMES_PACMANLITE_GAMEPLAY_MIGRATION_TO_NEXT
+Migrated gameplay to PacmanLite_next.

docs/dev/NEXT_COMMAND.txt

@@ -1 +1 @@
-Create BUILD_PR_GAMES_PACMANLITE_GAMEPLAY_MIGRATION_TO_NEXT
+Create BUILD_PR_GAMES_PACMANLITE_CLEAR_DESTINATION

docs/pr/BUILD_PR_GAMES_PACMANLITE_GAMEPLAY_MIGRATION_TO_NEXT.md

@@ -0,0 +1,24 @@
+# BUILD PR — Games PacmanLite Gameplay Migration To Next
+
+## Purpose
+Migrate PacmanLite gameplay into games/PacmanLite_next.
+
+## Scope
+- Read from games/PacmanLite/**
+- Write to games/PacmanLite_next/**
+- Do NOT modify original
+
+## Rules
+- Place files in correct destination folders
+- No guessing destinations
+- Preserve structure
+- Wire index.html to boot gameplay
+
+## Acceptance Criteria
+- PacmanLite_next runs gameplay
+- Canvas visible
+- No console errors
+- Original unchanged
+
+## Output
+<project folder>/tmp/BUILD_PR_GAMES_PACMANLITE_GAMEPLAY_MIGRATION_TO_NEXT_delta.zip

games/PacmanLite_next/assets/preview.png

@@ -0,0 +1,15 @@
+/*
+Toolbox Aid
+David Quesenberry
+03/25/2026
+PacmanLiteConfig.js
+*/
+const PacmanLiteConfig = Object.freeze({
+  tileSize: 32,
+  playerSpeed: 192,
+  ghostSpeed: 120,
+  spawnPlayerTile: Object.freeze({ x: 9, y: 9 }),
+  spawnGhostTile: Object.freeze({ x: 13, y: 9 }),
+});
+
+export default PacmanLiteConfig;

games/PacmanLite_next/assets/preview.svg

@@ -0,0 +1,26 @@
+/*
+Toolbox Aid
+David Quesenberry
+03/25/2026
+PacmanLiteDebugOverlay.js
+*/
+export default class PacmanLiteDebugOverlay {
+  render(renderer, { world }) {
+    const info = [
+      `P TILE: ${world.debug.playerTile.x},${world.debug.playerTile.y}`,
+      `G TILE: ${world.debug.ghostTile.x},${world.debug.ghostTile.y}`,
+      `QUEUE: ${world.debug.queuedDirection || '-'}`,
+      `TARGET: ${world.debug.targetTile.x},${world.debug.targetTile.y}`,
+      `PELLETS: ${world.grid.pelletCount()}`,
+    ];
+    renderer.drawRect(622, 64, 300, 166, 'rgba(2, 6, 23, 0.86)');
+    renderer.strokeRect(622, 64, 300, 166, '#334155', 1);
+    info.forEach((line, index) => {
+      renderer.drawText(line, 638, 82 + (index * 28), {
+        color: '#94a3b8',
+        font: '15px monospace',
+        textBaseline: 'top',
+      });
+    });
+  }
+}

games/PacmanLite_next/game/PacmanLiteConfig.js

@@ -0,0 +1,46 @@
+/*
+Toolbox Aid
+David Quesenberry
+03/25/2026
+PacmanLiteGhostController.js
+*/
+import { DIRS, chooseDirectionTowardTarget } from './PacmanLiteNavigator.js';
+
+function near(a, b, epsilon = 1.2) {
+  return Math.abs(a - b) <= epsilon;
+}
+
+export default class PacmanLiteGhostController {
+  constructor({ speed = 120 } = {}) {
+    this.speed = speed;
+  }
+
+  update(dtSeconds, { grid, ghost, playerTile }) {
+    const ghostTile = grid.worldToTile(ghost.x, ghost.y);
+    const center = grid.tileToWorld(ghostTile.x, ghostTile.y);
+    const atCenter = near(ghost.x, center.x) && near(ghost.y, center.y);
+
+    if (atCenter) {
+      ghost.x = center.x;
+      ghost.y = center.y;
+      const next = chooseDirectionTowardTarget(
+        grid,
+        ghostTile.x,
+        ghostTile.y,
+        ghost.direction,
+        playerTile.x,
+        playerTile.y,
+      );
+      if (next) {
+        ghost.direction = next;
+      }
+    }
+
+    if (!ghost.direction) {
+      return;
+    }
+    const vec = DIRS[ghost.direction];
+    ghost.x += vec.x * this.speed * dtSeconds;
+    ghost.y += vec.y * this.speed * dtSeconds;
+  }
+}

games/PacmanLite_next/game/PacmanLiteDebugOverlay.js

@@ -0,0 +1,91 @@
+/*
+Toolbox Aid
+David Quesenberry
+03/25/2026
+PacmanLiteGrid.js
+*/
+const ROWS = [
+  '#################',
+  '#...............#',
+  '#.###.#####.###.#',
+  '#.#...#...#...#.#',
+  '#.#.###.#.###.#.#',
+  '#...#...#...#...#',
+  '###.#.#####.#.###',
+  '#...#...#...#...#',
+  '#.#####.#.#####.#',
+  '#.......#.......#',
+  '#.#####.#.#####.#',
+  '#...#...#...#...#',
+  '###.#.#####.#.###',
+  '#...#...#...#...#',
+  '#.#.###.#.###.#.#',
+  '#.#...#...#...#.#',
+  '#.###.#####.###.#',
+  '#...............#',
+  '#################',
+];
+
+export default class PacmanLiteGrid {
+  constructor({ tileSize = 32 } = {}) {
+    this.tileSize = tileSize;
+    this.rows = ROWS;
+    this.height = this.rows.length;
+    this.width = this.rows[0].length;
+    this.pellets = new Set();
+    this.seedPellets();
+  }
+
+  key(x, y) {
+    return `${x},${y}`;
+  }
+
+  seedPellets() {
+    this.pellets.clear();
+    for (let y = 0; y < this.height; y += 1) {
+      for (let x = 0; x < this.width; x += 1) {
+        if (this.isWalkable(x, y)) {
+          this.pellets.add(this.key(x, y));
+        }
+      }
+    }
+  }
+
+  isInside(x, y) {
+    return x >= 0 && y >= 0 && x < this.width && y < this.height;
+  }
+
+  isWalkable(x, y) {
+    if (!this.isInside(x, y)) {
+      return false;
+    }
+    return this.rows[y][x] !== '#';
+  }
+
+  tileToWorld(x, y) {
+    const center = this.tileSize * 0.5;
+    return {
+      x: (x * this.tileSize) + center,
+      y: (y * this.tileSize) + center,
+    };
+  }
+
+  worldToTile(px, py) {
+    return {
+      x: Math.floor(px / this.tileSize),
+      y: Math.floor(py / this.tileSize),
+    };
+  }
+
+  hasPellet(x, y) {
+    return this.pellets.has(this.key(x, y));
+  }
+
+  consumePellet(x, y) {
+    return this.pellets.delete(this.key(x, y));
+  }
+
+  pelletCount() {
+    return this.pellets.size;
+  }
+}