sokoban/docs/project-changelog.md

Project Changelog

2026-04-12 — Svelte rewrite

Changed

• Replaced Phaser 3 with Svelte 5 as the rendering and UI layer. The game is now a static DOM app — native <button> elements, CSS grid board, transform animations with CSS transitions.
• Bundle shrinks from ~1.5 MB Phaser to 65 kB JS / 23 kB gzipped (about 60× smaller).
• New layout: src/App.svelte, src/views/*.svelte, src/lib/core/, src/lib/data/. Framework-agnostic core modules (level-parser, board-model, progress-store, microban-levels) moved from src/game/core → src/lib/core with zero code changes.
• Theme moved from a JS theme.js module into CSS custom properties in src/app.css.
• Native buttons replace the bespoke Phaser button factory — click reliability is now a browser concern, not ours.
• Vite configs cleaned up: removed Phaser-specific manualChunks, the terser block, and the phasermsg plugin.
• npm run dev / npm run build no longer wrap node log.js (Phaser analytics ping removed).

Added

• src/views/AppButton.svelte — shared themed button, wraps native <button> with hover, focus-visible, and disabled styles.
• src/views/Board.svelte — presentational DOM renderer: floor, walls, targets, boxes, player, each via absolute positioning inside a sized container.
• Live resize listener in GameView.svelte so tile size re-computes when the window changes.

Removed

• phaser dependency, terser devDependency.
• src/game/ (old main.js, scenes/, ui/, core/theme.js).
• log.js (Phaser analytics ping).

2026-04-11 — Full Microban set

Changed

• Level data expanded from the first 100 Microban puzzles to the complete 155-level set, including the oversized finale mazes ("Take the long way home", "The Dungeon"). Credit language updated everywhere to match.

2026-04-11 — Overhaul

Added

• 100 Microban levels (David W. Skinner) as the new stock level set, replacing the 3 hand-crafted puzzles. Stored as XSB text in src/game/data/microban-levels.js.
• XSB level parser (core/level-parser.js) with flood-fill floor detection.
• BoardModel (core/board-model.js) — pure state, undo history, win detection.
• Progress store (core/progress-store.js) — localStorage persistence of completion + best move count, fails gracefully if unavailable.
• BoardRenderer (ui/board-renderer.js) — floor/wall/target/box/player drawing with animated moves.
• Button factory (ui/button-factory.js) — one rounded-button implementation shared by every scene.
• Nord theme (core/theme.js) — palette, fonts, and responsive tile-size helper.
• Paginated level select: 5×4 grid × 5 pages, shows ✓ + best move count per completed level.
• WASD controls, U/Z undo, R restart, Esc to menu, move counter, win overlay with NEXT / LEVELS buttons.
• docs/ — PDR, codebase summary, code standards, system architecture, roadmap, this changelog.

Changed

• Scenes renamed to kebab-case (menu-scene.js, level-scene.js, game-scene.js) and rebuilt against the new core/ui modules.
• main.js now imports a shared theme and registers only the three new scenes.
• public/style.css now uses a radial gradient background and rounds the game container.
• index.html title updated.

Removed

• MenuScene.js, LevelScene.js, MainScene.js (old PascalCase versions).
• public/assets/levels/level1.json, level2.json, level3.json.
• Arcade Physics setup inside MainScene — it was configured but never actually drove movement (moves were all tween-based on a grid). Colliders, physics.world.shutdown() call, and the hand-rolled shutdown/destroy lifecycle overrides are gone.
• Unused import game from '../main.js' in the old MainScene.
• Hardcoded totalLevels: 3 and 3-element levelCompleted array in the game registry — replaced with dynamic lookup via progressStore.

Fixed

• Scene restart no longer leaves dangling event listeners (Phaser handles this itself; the previous manual removeAllListeners was both redundant and fragile).
• Level select now scales to 100 puzzles via pagination instead of a single-row layout.