@terminalgames/ink-sokoban 0.1.0

package/README.md

@@ -0,0 +1,105 @@
+# Ink Sokoban
+
+Terminal Sokoban built with [Ink](https://github.com/vadimdemedes/ink). Push
+every crate onto its mark to clear each of the bundled puzzles — a 40-level
+campaign that starts with tiny one-screen warm-ups and grows into wide, walled
+vaults with a dozen crates to shuffle.
+
+## Install
+
+Requires **Node 20+**.
+
+The unscoped name `ink-sokoban` may be taken on npm, so this package publishes
+as **`@terminalgames/ink-sokoban`**. The command is still **`ink-sokoban`**.
+
+### Run without installing (easiest)
+
+```bash
+npx @terminalgames/ink-sokoban
+```
+
+### Global install
+
+If `npm install -g` fails with `EACCES`, your npm global prefix is probably
+system-owned (`/usr/local`). Either use `npx` above, or point npm at a
+user-owned directory:
+
+```bash
+mkdir -p ~/.npm-global
+npm config set prefix ~/.npm-global
+echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
+source ~/.bashrc
+npm install -g @terminalgames/ink-sokoban
+```
+
+Then:
+
+```bash
+ink-sokoban
+```
+
+## How to play
+
+Move the player (`☻`) around the grid and push crates (`◇`) onto the target
+marks (`·`). A crate sitting on a mark turns into `◆`. Clear a level by filling
+every mark; then press `n` for the next puzzle.
+
+Moves are turn-based and grid-aligned. You can only **push** crates — never
+pull — and a push is blocked if a wall or another crate is behind the crate.
+Stuck? Press `u` to undo (unlimited, back to the level start) or `r` to restart.
+
+## Controls
+
+| Key | Action |
+| --- | --- |
+| `h` / `←` | Move left |
+| `j` / `↓` | Move down |
+| `k` / `↑` | Move up |
+| `l` / `→` | Move right |
+| `u` | Undo last move |
+| `r` | Restart level |
+| `n` | Next level (after a solve) |
+| `p` | Pause / resume |
+| `?` | Toggle help (shows legal pushes) |
+| `q` | Quit |
+
+The sidebar tracks the current level, move count, push count, undo count, and
+resets.
+
+## Development
+
+```bash
+npm install
+npm run build
+node dist/cli.js
+```
+
+```bash
+npm test
+npm run typecheck
+```
+
+Game logic lives in pure TypeScript modules under `src/game/` (`levels.ts` for
+the puzzle data + XSB parser, `engine.ts` for the move/push/undo rules); the Ink
+UI is under `src/ui/`. Every shipped level is verified solvable by a search in
+`tests/game/levels.test.ts`.
+
+Two dev-only helpers live under `scripts/` (build first, then run with `node`):
+`verify-levels.mjs` runs that same BFS but prints per-level diagnostics
+(dimensions, crate count, solution depth, nodes explored) for tuning new
+layouts, and `preview.mjs <index>` renders a single level the way the player
+sees it.
+
+## Credits
+
+The bundled levels are original layouts written in the compact, one-screen
+style popularised by the **Microban** collection by **David W. Skinner**.
+
+## Publish
+
+Maintainers only. Requires access to the `@terminalgames` npm organization:
+
+```bash
+npm login
+npm publish --access public
+```

package/dist/cli.d.ts

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+export type RunCliOptions = {
+    level?: number;
+};
+export declare function runCli(options?: RunCliOptions): void;

package/dist/cli.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+import { render } from 'ink';
+import React from 'react';
+import { pathToFileURL } from 'node:url';
+import { App } from './ui/App.js';
+export function runCli(options = {}) {
+    render(React.createElement(App, { initialLevel: options.level ?? 0 }));
+}
+function isDirectRun(entrypoint = process.argv[1]) {
+    return entrypoint !== undefined && import.meta.url === pathToFileURL(entrypoint).href;
+}
+if (isDirectRun()) {
+    runCli();
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAC,MAAM,EAAC,MAAM,KAAK,CAAC;AAC3B,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAC,aAAa,EAAC,MAAM,UAAU,CAAC;AACvC,OAAO,EAAC,GAAG,EAAC,MAAM,aAAa,CAAC;AAMhC,MAAM,UAAU,MAAM,CAAC,UAAyB,EAAE;IAChD,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,GAAG,EAAE,EAAC,YAAY,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC,EAAC,CAAC,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,WAAW,CAAC,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/C,OAAO,UAAU,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,aAAa,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC;AACxF,CAAC;AAED,IAAI,WAAW,EAAE,EAAE,CAAC;IAClB,MAAM,EAAE,CAAC;AACX,CAAC"}

package/dist/game/engine.d.ts

@@ -0,0 +1,31 @@
+import { type Point } from './levels.js';
+export type { Point } from './levels.js';
+export type GameStatus = 'playing' | 'paused' | 'solved' | 'complete';
+export type GameAction = 'move-up' | 'move-down' | 'move-left' | 'move-right' | 'undo' | 'restart' | 'next-level' | 'pause';
+export type Move = {
+    dx: number;
+    dy: number;
+    pushedBox: boolean;
+};
+export type SokobanState = {
+    levelIndex: number;
+    levelCount: number;
+    levelName: string;
+    width: number;
+    height: number;
+    walls: boolean[][];
+    targets: boolean[][];
+    boxes: Point[];
+    player: Point;
+    moves: number;
+    pushes: number;
+    undoCount: number;
+    resets: number;
+    history: Move[];
+    status: GameStatus;
+};
+export declare function createInitialState(levelIndex?: number): SokobanState;
+export declare function isSolved(state: SokobanState): boolean;
+export declare function applyAction(state: SokobanState, action: GameAction): SokobanState;
+export declare function isWall(state: SokobanState, x: number, y: number): boolean;
+export declare function boxIndexAt(boxes: Point[], x: number, y: number): number;

package/dist/game/engine.js

@@ -0,0 +1,157 @@
+import { LEVELS, parseLevel } from './levels.js';
+const DELTAS = {
+    'move-up': { dx: 0, dy: -1, pushedBox: false },
+    'move-down': { dx: 0, dy: 1, pushedBox: false },
+    'move-left': { dx: -1, dy: 0, pushedBox: false },
+    'move-right': { dx: 1, dy: 0, pushedBox: false }
+};
+export function createInitialState(levelIndex = 0) {
+    const level = LEVELS[levelIndex];
+    if (level === undefined) {
+        throw new Error(`No level at index ${levelIndex}`);
+    }
+    const parsed = parseLevel(level.text);
+    return {
+        levelIndex,
+        levelCount: LEVELS.length,
+        levelName: level.name,
+        width: parsed.width,
+        height: parsed.height,
+        walls: parsed.walls,
+        targets: parsed.targets,
+        boxes: parsed.boxes.map(box => ({ ...box })),
+        player: { ...parsed.player },
+        moves: 0,
+        pushes: 0,
+        undoCount: 0,
+        resets: 0,
+        history: [],
+        status: 'playing'
+    };
+}
+export function isSolved(state) {
+    for (let y = 0; y < state.height; y += 1) {
+        for (let x = 0; x < state.width; x += 1) {
+            if (state.targets[y][x] && boxIndexAt(state.boxes, x, y) === -1) {
+                return false;
+            }
+        }
+    }
+    return true;
+}
+export function applyAction(state, action) {
+    switch (action) {
+        case 'restart':
+            return restart(state);
+        case 'next-level':
+            return nextLevel(state);
+        case 'pause':
+            return togglePause(state);
+        case 'undo':
+            return undo(state);
+        case 'move-up':
+        case 'move-down':
+        case 'move-left':
+        case 'move-right':
+            return move(state, DELTAS[action]);
+        default:
+            return state;
+    }
+}
+function move(state, delta) {
+    if (state.status !== 'playing') {
+        return state;
+    }
+    const { dx, dy } = delta;
+    const targetX = state.player.x + dx;
+    const targetY = state.player.y + dy;
+    if (isWall(state, targetX, targetY)) {
+        return state;
+    }
+    const boxIndex = boxIndexAt(state.boxes, targetX, targetY);
+    // Empty floor: just step.
+    if (boxIndex === -1) {
+        return finishMove(state, { x: targetX, y: targetY }, state.boxes, { dx, dy, pushedBox: false });
+    }
+    // A box is in the way — can only move it by pushing into a free cell.
+    const beyondX = targetX + dx;
+    const beyondY = targetY + dy;
+    if (isWall(state, beyondX, beyondY) || boxIndexAt(state.boxes, beyondX, beyondY) !== -1) {
+        return state; // blocked: wall or another box behind it
+    }
+    const boxes = state.boxes.map((box, index) => index === boxIndex ? { x: beyondX, y: beyondY } : box);
+    return finishMove(state, { x: targetX, y: targetY }, boxes, { dx, dy, pushedBox: true });
+}
+function finishMove(state, player, boxes, record) {
+    const next = {
+        ...state,
+        player,
+        boxes,
+        moves: state.moves + 1,
+        pushes: state.pushes + (record.pushedBox ? 1 : 0),
+        history: [...state.history, record]
+    };
+    if (isSolved(next)) {
+        next.status = 'solved';
+    }
+    return next;
+}
+function undo(state) {
+    const last = state.history[state.history.length - 1];
+    if (last === undefined) {
+        return state;
+    }
+    const { dx, dy, pushedBox } = last;
+    let boxes = state.boxes;
+    if (pushedBox) {
+        // The box now sits one cell ahead of the player; drag it back onto the
+        // player's current cell, then the player retreats to where it came from.
+        const boxX = state.player.x + dx;
+        const boxY = state.player.y + dy;
+        const boxIndex = boxIndexAt(state.boxes, boxX, boxY);
+        boxes = state.boxes.map((box, index) => index === boxIndex ? { x: state.player.x, y: state.player.y } : box);
+    }
+    return {
+        ...state,
+        player: { x: state.player.x - dx, y: state.player.y - dy },
+        boxes,
+        moves: state.moves - 1,
+        pushes: state.pushes - (pushedBox ? 1 : 0),
+        undoCount: state.undoCount + 1,
+        history: state.history.slice(0, -1),
+        status: 'playing'
+    };
+}
+function restart(state) {
+    const fresh = createInitialState(state.levelIndex);
+    return { ...fresh, resets: state.resets + 1 };
+}
+function nextLevel(state) {
+    if (state.status !== 'solved') {
+        return state;
+    }
+    const nextIndex = state.levelIndex + 1;
+    if (nextIndex >= LEVELS.length) {
+        return { ...state, status: 'complete' };
+    }
+    return createInitialState(nextIndex);
+}
+function togglePause(state) {
+    if (state.status === 'playing') {
+        return { ...state, status: 'paused' };
+    }
+    if (state.status === 'paused') {
+        return { ...state, status: 'playing' };
+    }
+    return state;
+}
+export function isWall(state, x, y) {
+    if (y < 0 || y >= state.height || x < 0 || x >= state.width) {
+        return true;
+    }
+    return state.walls[y][x];
+}
+export function boxIndexAt(boxes, x, y) {
+    return boxes.findIndex(box => box.x === x && box.y === y);
+}
+//# sourceMappingURL=engine.js.map

package/dist/game/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../src/game/engine.ts"],"names":[],"mappings":"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"}

package/dist/game/levels.d.ts

@@ -0,0 +1,18 @@
+export type Point = {
+    x: number;
+    y: number;
+};
+export type Level = {
+    name: string;
+    text: string;
+};
+export type ParsedLevel = {
+    width: number;
+    height: number;
+    walls: boolean[][];
+    targets: boolean[][];
+    boxes: Point[];
+    player: Point;
+};
+export declare const LEVELS: Level[];
+export declare function parseLevel(text: string): ParsedLevel;

package/dist/game/levels.js

@@ -0,0 +1,565 @@
+// Levels use the classic XSB notation:
+//   #  wall            @  player          +  player on target
+//   $  box             *  box on target   .  target
+//   (space / - / _)    floor
+//
+// A 40-level campaign of original, hand-authored layouts in the compact
+// "one screen" tradition popularised by David W. Skinner's Microban set (see
+// README credits). Boards start tiny and grow gradually — the early levels are
+// a few cells across, the late ones span roughly a dozen — while box counts and
+// the amount of maneuvering ramp up alongside. Every shipped level is verified
+// solvable (and not already solved) by the BFS search in
+// tests/game/levels.test.ts; scripts/verify-levels.mjs prints per-level
+// diagnostics for tuning.
+export const LEVELS = [
+    // ── Tier 1: first light (tiny, 1–4 boxes) ───────────────────────────────
+    {
+        name: 'First Light',
+        text: `
+#######
+#@ $ .#
+#######
+`
+    },
+    {
+        name: 'Twin Slots',
+        text: `
+######
+#@ $.#
+#  $.#
+######
+`
+    },
+    {
+        name: 'The Turn',
+        text: `
+######
+#@   #
+# $  #
+#  . #
+######
+`
+    },
+    {
+        name: 'Sidestep',
+        text: `
+######
+#   .#
+# @$ #
+#   ##
+######
+`
+    },
+    {
+        name: 'Bookends',
+        text: `
+#######
+#.   .#
+# $@$ #
+#     #
+#######
+`
+    },
+    {
+        name: 'Two-Step',
+        text: `
+#######
+#  @  #
+# $ $ #
+#.   .#
+#######
+`
+    },
+    {
+        name: 'Compass',
+        text: `
+#######
+#  .  #
+#  $  #
+#.$@$.#
+#  $  #
+#  .  #
+#######
+`
+    },
+    {
+        name: 'Observatory',
+        text: `
+########
+#  .   #
+#  $   #
+#.$@$. #
+#      #
+########
+`
+    },
+    // ── Tier 2: open sky (8–9 wide, lanes and lifts) ─────────────────────────
+    {
+        name: 'Three Lanes',
+        text: `
+#########
+#.  $  @#
+#.  $   #
+#.  $   #
+#       #
+#########
+`
+    },
+    {
+        name: 'Lift Off',
+        text: `
+########
+# . .. #
+#      #
+#      #
+# $ $$ #
+#@     #
+########
+`
+    },
+    {
+        name: 'Long Haul',
+        text: `
+########
+#@$   .#
+#      #
+# $   .#
+#      #
+# $   .#
+########
+`
+    },
+    {
+        name: 'Four Winds',
+        text: `
+#######
+#.  $ #
+#.  $ #
+#.  $ #
+#.  $ #
+#    @#
+#######
+`
+    },
+    {
+        name: 'Switchback',
+        text: `
+#########
+#   ...##
+#       #
+#@$$$   #
+#       #
+#########
+`
+    },
+    {
+        name: 'Four Corners',
+        text: `
+#########
+#  . .  #
+#       #
+#  $ $  #
+#@      #
+#  $ $  #
+#  . .  #
+#########
+`
+    },
+    // ── Tier 3: the vaults (walled combs, 4–6 boxes) ─────────────────────────
+    // From here on the boards grow in footprint but stay confined: lanes are
+    // separated by walls so each box has a single forced path to its mark, which
+    // keeps every layout provably solvable and quick for the BFS to confirm.
+    {
+        name: 'Portcullis',
+        text: `
+#########
+#@      #
+#$#$#$#$#
+#.#.#.#.#
+#########
+`
+    },
+    {
+        name: 'Lantern Row',
+        text: `
+#########
+#@      #
+#$#$#$#$#
+# # # # #
+#.#.#.#.#
+#########
+`
+    },
+    {
+        name: 'Stalactites',
+        text: `
+#########
+#.#.#.#.#
+# # # # #
+#$#$#$#$#
+#@      #
+#########
+`
+    },
+    {
+        name: 'The Cellars',
+        text: `
+###########
+#@        #
+#$#$#$#$#$#
+# # # # # #
+#.#.#.#.#.#
+###########
+`
+    },
+    {
+        name: 'The Mirror',
+        text: `
+#######
+#.#.#.#
+#$#$#$#
+#@    #
+#$#$#$#
+#.#.#.#
+#######
+`
+    },
+    {
+        name: 'Vault Rows',
+        text: `
+###########
+#@        #
+#$#$#$#$#$#
+# # # # # #
+# # # # # #
+#.#.#.#.#.#
+###########
+`
+    },
+    {
+        name: 'Stalagmites',
+        text: `
+###########
+#.#.#.#.#.#
+# # # # # #
+#$#$#$#$#$#
+#@        #
+###########
+`
+    },
+    {
+        name: 'Deep Wells',
+        text: `
+#########
+#@      #
+#$#$#$#$#
+# # # # #
+# # # # #
+#.#.#.#.#
+#########
+`
+    },
+    // ── Tier 4: the works (wider combs and side corridors, 4–6 boxes) ────────
+    {
+        name: 'Dovetail',
+        text: `
+#########
+#.#.#.#.#
+#$#$#$#$#
+#@      #
+#$#$#$#$#
+#.#.#.#.#
+#########
+`
+    },
+    {
+        name: 'The Granary',
+        text: `
+#############
+#@          #
+#$#$#$#$#$#$#
+# # # # # # #
+#.#.#.#.#.#.#
+#############
+`
+    },
+    {
+        name: 'Catacomb',
+        text: `
+###########
+#.#.#.#.#.#
+# # # # # #
+# # # # # #
+#$#$#$#$#$#
+#@        #
+###########
+`
+    },
+    {
+        name: 'Twin Combs',
+        text: `
+#######
+#.#.#.#
+# # # #
+#$#$#$#
+#@    #
+#$#$#$#
+# # # #
+#.#.#.#
+#######
+`
+    },
+    {
+        name: 'The Spillway',
+        text: `
+#############
+#@          #
+#$#$#$#$#$#$#
+# # # # # # #
+# # # # # # #
+#.#.#.#.#.#.#
+#############
+`
+    },
+    {
+        name: 'Honeycomb',
+        text: `
+#############
+#.#.#.#.#.#.#
+# # # # # # #
+#$#$#$#$#$#$#
+#@          #
+#############
+`
+    },
+    {
+        name: 'The Sluice',
+        text: `
+##########
+#.    $ @#
+######## #
+#.    $  #
+######## #
+#.    $  #
+######## #
+#.    $  #
+##########
+`
+    },
+    {
+        name: 'Deep Vaults',
+        text: `
+###########
+#@        #
+#$#$#$#$#$#
+# # # # # #
+# # # # # #
+# # # # # #
+#.#.#.#.#.#
+###########
+`
+    },
+    // ── Tier 5: the deep (largest footprints, long forced hauls) ─────────────
+    {
+        name: 'Drift',
+        text: `
+##########
+#@ $    .#
+# ########
+#  $    .#
+# ########
+#  $    .#
+# ########
+#  $    .#
+##########
+`
+    },
+    {
+        name: 'The Reckoning',
+        text: `
+###########
+#.#.#.#.#.#
+#$#$#$#$#$#
+#@        #
+#$#$#$#$#$#
+#.#.#.#.#.#
+###########
+`
+    },
+    {
+        name: 'Cold Storage',
+        text: `
+#######
+#.#.#.#
+# # # #
+# # # #
+#$#$#$#
+#@    #
+#$#$#$#
+# # # #
+# # # #
+#.#.#.#
+#######
+`
+    },
+    {
+        name: 'Honeycomb Deep',
+        text: `
+#############
+#.#.#.#.#.#.#
+# # # # # # #
+# # # # # # #
+#$#$#$#$#$#$#
+#@          #
+#############
+`
+    },
+    {
+        name: 'The Sluice II',
+        text: `
+############
+#.      $ @#
+########## #
+#.      $  #
+########## #
+#.      $  #
+########## #
+#.      $  #
+############
+`
+    },
+    {
+        name: 'The Reactor',
+        text: `
+###########
+#.#.#.#.#.#
+# # # # # #
+# # # # # #
+#$#$#$#$#$#
+#@        #
+###########
+`
+    },
+    {
+        name: 'Deep Storage',
+        text: `
+##########
+#.   $  @#
+######## #
+#.   $   #
+######## #
+#.   $   #
+######## #
+#.   $   #
+######## #
+#.   $   #
+##########
+`
+    },
+    {
+        name: 'The Bulwark',
+        text: `
+###########
+#@ $     .#
+# #########
+#  $     .#
+# #########
+#  $     .#
+# #########
+#  $     .#
+###########
+`
+    },
+    {
+        name: 'Leviathan',
+        text: `
+#########
+#.#.#.#.#
+# # # # #
+#$#$#$#$#
+#@      #
+#$#$#$#$#
+# # # # #
+#.#.#.#.#
+#########
+`
+    },
+    {
+        name: 'Event Horizon',
+        text: `
+#############
+#.#.#.#.#.#.#
+#$#$#$#$#$#$#
+#@          #
+#$#$#$#$#$#$#
+#.#.#.#.#.#.#
+#############
+`
+    }
+];
+const FLOOR_CHARS = new Set([' ', '-', '_']);
+export function parseLevel(text) {
+    const rows = text.replace(/\r/g, '').split('\n');
+    // Drop blank leading/trailing lines so levels can be written with surrounding
+    // newlines in template literals.
+    while (rows.length > 0 && rows[0].trim() === '') {
+        rows.shift();
+    }
+    while (rows.length > 0 && rows[rows.length - 1].trim() === '') {
+        rows.pop();
+    }
+    if (rows.length === 0) {
+        throw new Error('Level is empty');
+    }
+    const height = rows.length;
+    const width = rows.reduce((max, row) => Math.max(max, row.length), 0);
+    const walls = [];
+    const targets = [];
+    const boxes = [];
+    let player;
+    for (let y = 0; y < height; y += 1) {
+        const wallRow = [];
+        const targetRow = [];
+        const row = rows[y];
+        for (let x = 0; x < width; x += 1) {
+            const char = x < row.length ? row[x] : ' ';
+            let isWall = false;
+            let isTarget = false;
+            switch (char) {
+                case '#':
+                    isWall = true;
+                    break;
+                case '@':
+                    player = { x, y };
+                    break;
+                case '+':
+                    player = { x, y };
+                    isTarget = true;
+                    break;
+                case '$':
+                    boxes.push({ x, y });
+                    break;
+                case '*':
+                    boxes.push({ x, y });
+                    isTarget = true;
+                    break;
+                case '.':
+                    isTarget = true;
+                    break;
+                default:
+                    if (!FLOOR_CHARS.has(char)) {
+                        throw new Error(`Unknown level character: ${JSON.stringify(char)}`);
+                    }
+            }
+            wallRow.push(isWall);
+            targetRow.push(isTarget);
+        }
+        walls.push(wallRow);
+        targets.push(targetRow);
+    }
+    if (player === undefined) {
+        throw new Error('Level has no player');
+    }
+    return { width, height, walls, targets, boxes, player };
+}
+//# sourceMappingURL=levels.js.map

package/dist/game/levels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"levels.js","sourceRoot":"","sources":["../../src/game/levels.ts"],"names":[],"mappings":"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"}

package/dist/ui/App.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+export type AppProps = {
+    initialLevel?: number;
+    onExit?: () => void;
+};
+export declare function App({ initialLevel, onExit }: AppProps): React.ReactElement;

package/dist/ui/App.js

@@ -0,0 +1,33 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React from 'react';
+import { Box, useApp, useInput } from 'ink';
+import { applyAction, createInitialState } from '../game/engine.js';
+import { MapView } from './MapView.js';
+import { mapInputToAction } from './input.js';
+import { Sidebar } from './Sidebar.js';
+export function App({ initialLevel = 0, onExit }) {
+    const { exit } = useApp();
+    const [state, setState] = React.useState(() => createInitialState(initialLevel));
+    const [showHelp, setShowHelp] = React.useState(false);
+    // Sokoban is turn-based: state only changes in response to a keypress, so
+    // there is no game-loop timer (unlike tetris's gravity tick).
+    useInput((input, key) => {
+        const action = mapInputToAction(input, key);
+        if (action === undefined) {
+            return;
+        }
+        if (action === 'toggle-help') {
+            setShowHelp(current => !current);
+            return;
+        }
+        if (action === 'quit') {
+            onExit?.();
+            exit();
+            return;
+        }
+        const gameAction = action;
+        setState(current => applyAction(current, gameAction));
+    });
+    return (_jsxs(Box, { children: [_jsx(MapView, { state: state }), _jsx(Sidebar, { state: state, showHelp: showHelp })] }));
+}
+//# sourceMappingURL=App.js.map

package/dist/ui/App.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"App.js","sourceRoot":"","sources":["../../src/ui/App.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAC,MAAM,KAAK,CAAC;AAC1C,OAAO,EAAC,WAAW,EAAE,kBAAkB,EAAqC,MAAM,mBAAmB,CAAC;AACtG,OAAO,EAAC,OAAO,EAAC,MAAM,cAAc,CAAC;AACrC,OAAO,EAAC,gBAAgB,EAAC,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAC,OAAO,EAAC,MAAM,cAAc,CAAC;AAOrC,MAAM,UAAU,GAAG,CAAC,EAAC,YAAY,GAAG,CAAC,EAAE,MAAM,EAAW;IACtD,MAAM,EAAC,IAAI,EAAC,GAAG,MAAM,EAAE,CAAC;IACxB,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAe,GAAG,EAAE,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAAC;IAC/F,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAEtD,0EAA0E;IAC1E,8DAA8D;IAC9D,QAAQ,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACtB,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAE5C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO;QACT,CAAC;QAED,IAAI,MAAM,KAAK,aAAa,EAAE,CAAC;YAC7B,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;YACjC,OAAO;QACT,CAAC;QAED,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;YACtB,MAAM,EAAE,EAAE,CAAC;YACX,IAAI,EAAE,CAAC;YACP,OAAO;QACT,CAAC;QAED,MAAM,UAAU,GAAG,MAAoB,CAAC;QACxC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,OAAO,CACL,MAAC,GAAG,eACF,KAAC,OAAO,IAAC,KAAK,EAAE,KAAK,GAAI,EACzB,KAAC,OAAO,IAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,GAAI,IACzC,CACP,CAAC;AACJ,CAAC"}

package/dist/ui/Cell.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+import { type Tile } from './palette.js';
+export type CellProps = {
+    tile: Tile;
+};
+export declare function Cell({ tile }: CellProps): React.ReactElement;

package/dist/ui/Cell.js

@@ -0,0 +1,8 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Text } from 'ink';
+import { tileGlyph, tileStyle } from './palette.js';
+export function Cell({ tile }) {
+    const style = tileStyle(tile);
+    return _jsx(Text, { ...style, children: tileGlyph(tile) });
+}
+//# sourceMappingURL=Cell.js.map

package/dist/ui/Cell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Cell.js","sourceRoot":"","sources":["../../src/ui/Cell.tsx"],"names":[],"mappings":";AACA,OAAO,EAAC,IAAI,EAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EAAC,SAAS,EAAE,SAAS,EAAY,MAAM,cAAc,CAAC;AAM7D,MAAM,UAAU,IAAI,CAAC,EAAC,IAAI,EAAY;IACpC,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAE9B,OAAO,KAAC,IAAI,OAAK,KAAK,YAAG,SAAS,CAAC,IAAI,CAAC,GAAQ,CAAC;AACnD,CAAC"}

package/dist/ui/MapView.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import { type SokobanState } from '../game/engine.js';
+import { type Tile } from './palette.js';
+export type MapViewProps = {
+    state: SokobanState;
+};
+export declare function MapView({ state }: MapViewProps): React.ReactElement;
+export declare function tileAt(state: SokobanState, x: number, y: number): Tile;

package/dist/ui/MapView.js

@@ -0,0 +1,35 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { Box, Text } from 'ink';
+import { boxIndexAt } from '../game/engine.js';
+import { Cell } from './Cell.js';
+import { ui } from './palette.js';
+export function MapView({ state }) {
+    const banner = bannerFor(state);
+    return (_jsxs(Box, { flexDirection: "column", flexShrink: 0, children: [_jsxs(Text, { bold: true, color: ui.title, children: ["\u2726 ", state.levelName] }), _jsx(Box, { flexDirection: "column", borderStyle: "round", borderColor: ui.frame, paddingX: 1, children: Array.from({ length: state.height }, (_, y) => (_jsx(Box, { children: Array.from({ length: state.width }, (_, x) => (_jsx(Cell, { tile: tileAt(state, x, y) }, `cell-${y}-${x}`))) }, `row-${y}`))) }), banner === undefined ? (_jsx(Text, { children: " " })) : (_jsx(Text, { bold: true, color: banner.color, children: banner.label }))] }));
+}
+export function tileAt(state, x, y) {
+    if (state.walls[y][x]) {
+        return 'wall';
+    }
+    const isTarget = state.targets[y][x];
+    if (state.player.x === x && state.player.y === y) {
+        return isTarget ? 'player-on-target' : 'player';
+    }
+    if (boxIndexAt(state.boxes, x, y) !== -1) {
+        return isTarget ? 'box-on-target' : 'box';
+    }
+    return isTarget ? 'target' : 'floor';
+}
+function bannerFor(state) {
+    switch (state.status) {
+        case 'solved':
+            return { label: '✦ Solved! — press n for next level', color: ui.ok };
+        case 'paused':
+            return { label: '❚❚ Paused — press p to resume', color: ui.warn };
+        case 'complete':
+            return { label: '★ All levels complete! — press q to quit', color: ui.accent };
+        default:
+            return undefined;
+    }
+}
+//# sourceMappingURL=MapView.js.map

package/dist/ui/MapView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MapView.js","sourceRoot":"","sources":["../../src/ui/MapView.tsx"],"names":[],"mappings":"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"}

package/dist/ui/Sidebar.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import { type SokobanState } from '../game/engine.js';
+export type SidebarProps = {
+    state: SokobanState;
+    showHelp: boolean;
+};
+export declare function Sidebar({ state, showHelp }: SidebarProps): React.ReactElement;

package/dist/ui/Sidebar.js

@@ -0,0 +1,49 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from 'ink';
+import { applyAction } from '../game/engine.js';
+import { ui } from './palette.js';
+const labelWidth = 8;
+export function Sidebar({ state, showHelp }) {
+    return (_jsxs(Box, { flexDirection: "column", marginLeft: 3, width: 30, children: [_jsx(Text, { bold: true, color: ui.title, children: "\u25C6 Ink Sokoban" }), _jsx(Text, { dimColor: true, children: '─'.repeat(26) }), _jsx(Stat, { label: "Level", value: `${state.levelIndex + 1}/${state.levelCount}` }), _jsx(Stat, { label: "Moves", value: String(state.moves) }), _jsx(Stat, { label: "Pushes", value: String(state.pushes) }), _jsx(Stat, { label: "Undo", value: String(state.undoCount) }), _jsx(Stat, { label: "Resets", value: String(state.resets) }), _jsx(Text, { children: " " }), _jsx(StatusBanner, { status: state.status }), _jsx(Text, { children: " " }), showHelp ? _jsx(HelpPanel, { state: state }) : _jsx(HintPanel, {})] }));
+}
+function Stat({ label, value }) {
+    return (_jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: label.padEnd(labelWidth) }), _jsx(Text, { bold: true, children: value })] }));
+}
+function StatusBanner({ status }) {
+    if (status === 'paused') {
+        return (_jsx(Text, { color: ui.warn, bold: true, children: "\u275A\u275A Paused" }));
+    }
+    if (status === 'solved') {
+        return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: ui.ok, bold: true, children: "\u2726 Solved" }), _jsx(Text, { dimColor: true, children: "Press n for next level" })] }));
+    }
+    if (status === 'complete') {
+        return (_jsx(Text, { color: ui.accent, bold: true, children: "\u2605 All levels complete" }));
+    }
+    return (_jsx(Text, { color: ui.ok, bold: true, children: "\u25CF Playing" }));
+}
+function HintPanel() {
+    return _jsx(Text, { dimColor: true, children: "Hint: ? for controls" });
+}
+function HelpPanel({ state }) {
+    return (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { dimColor: true, children: '─'.repeat(26) }), _jsx(Text, { bold: true, children: "Controls" }), _jsx(HelpRow, { keys: "h j k l", action: "Move" }), _jsx(HelpRow, { keys: "\u2190 \u2193 \u2191 \u2192", action: "Move" }), _jsx(HelpRow, { keys: "u", action: "Undo" }), _jsx(HelpRow, { keys: "r", action: "Restart" }), _jsx(HelpRow, { keys: "n", action: "Next level" }), _jsx(HelpRow, { keys: "p", action: "Pause" }), _jsx(HelpRow, { keys: "?", action: "Help" }), _jsx(HelpRow, { keys: "q", action: "Quit" }), _jsx(Text, { children: " " }), _jsx(Text, { bold: true, children: "Legal pushes" }), _jsx(PushHints, { state: state })] }));
+}
+// Shows which directions would currently shove a box (the optional "reachable
+// push directions" hint). A direction lights up only if moving that way is a
+// legal push from the player's current square.
+function PushHints({ state }) {
+    const directions = [
+        { label: '↑', action: 'move-up' },
+        { label: '↓', action: 'move-down' },
+        { label: '←', action: 'move-left' },
+        { label: '→', action: 'move-right' }
+    ];
+    const live = directions.filter(({ action }) => applyAction(state, action).pushes > state.pushes);
+    if (live.length === 0) {
+        return _jsx(Text, { dimColor: true, children: "none from here" });
+    }
+    return (_jsx(Text, { color: ui.crate, bold: true, children: live.map(({ label }) => label).join(' ') }));
+}
+function HelpRow({ keys, action }) {
+    return (_jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: keys.padEnd(10) }), action] }));
+}
+//# sourceMappingURL=Sidebar.js.map

package/dist/ui/Sidebar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Sidebar.js","sourceRoot":"","sources":["../../src/ui/Sidebar.tsx"],"names":[],"mappings":"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"}

package/dist/ui/input.d.ts

@@ -0,0 +1,8 @@
+export type InputKey = {
+    leftArrow?: boolean;
+    rightArrow?: boolean;
+    upArrow?: boolean;
+    downArrow?: boolean;
+};
+export type UiAction = 'move-up' | 'move-down' | 'move-left' | 'move-right' | 'undo' | 'restart' | 'next-level' | 'pause' | 'toggle-help' | 'quit';
+export declare function mapInputToAction(input: string, key: InputKey): UiAction | undefined;

package/dist/ui/input.js

@@ -0,0 +1,34 @@
+export function mapInputToAction(input, key) {
+    if (input === 'k' || key.upArrow) {
+        return 'move-up';
+    }
+    if (input === 'j' || key.downArrow) {
+        return 'move-down';
+    }
+    if (input === 'h' || key.leftArrow) {
+        return 'move-left';
+    }
+    if (input === 'l' || key.rightArrow) {
+        return 'move-right';
+    }
+    if (input === 'u') {
+        return 'undo';
+    }
+    if (input === 'r') {
+        return 'restart';
+    }
+    if (input === 'n') {
+        return 'next-level';
+    }
+    if (input === 'p') {
+        return 'pause';
+    }
+    if (input === '?') {
+        return 'toggle-help';
+    }
+    if (input === 'q') {
+        return 'quit';
+    }
+    return undefined;
+}
+//# sourceMappingURL=input.js.map

package/dist/ui/input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.js","sourceRoot":"","sources":["../../src/ui/input.ts"],"names":[],"mappings":"AAmBA,MAAM,UAAU,gBAAgB,CAAC,KAAa,EAAE,GAAa;IAC3D,IAAI,KAAK,KAAK,GAAG,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;QACjC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,KAAK,KAAK,GAAG,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;QACnC,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,IAAI,KAAK,KAAK,GAAG,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;QACnC,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,IAAI,KAAK,KAAK,GAAG,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;QACpC,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;QAClB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;QAClB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;QAClB,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;QAClB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;QAClB,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;QAClB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/ui/palette.d.ts

@@ -0,0 +1,22 @@
+export type Tile = 'wall' | 'floor' | 'target' | 'box' | 'box-on-target' | 'player' | 'player-on-target';
+export type TileStyle = {
+    color?: string;
+    backgroundColor?: string;
+    bold?: boolean;
+    dimColor?: boolean;
+};
+export declare const ui: {
+    readonly accent: "cyan";
+    readonly muted: "gray";
+    readonly title: "cyan";
+    readonly danger: "red";
+    readonly warn: "yellow";
+    readonly ok: "green";
+    readonly frame: "#475569";
+    readonly star: "#64748b";
+    readonly crate: "#d8a657";
+    readonly docked: "#7dcfb6";
+    readonly probe: "#e8e8e8";
+};
+export declare function tileGlyph(tile: Tile): string;
+export declare function tileStyle(tile: Tile): TileStyle;

package/dist/ui/palette.js

@@ -0,0 +1,43 @@
+// Muted "observatory" palette: deep slate frame, dim starfield targets, a warm
+// amber crate that turns cool green once it settles onto its mark, and a bright
+// probe for the player.
+export const ui = {
+    accent: 'cyan',
+    muted: 'gray',
+    title: 'cyan',
+    danger: 'red',
+    warn: 'yellow',
+    ok: 'green',
+    frame: '#475569',
+    star: '#64748b',
+    crate: '#d8a657',
+    docked: '#7dcfb6',
+    probe: '#e8e8e8'
+};
+// Every tile renders as two terminal columns so the map keeps a roughly square
+// aspect ratio (same trick the tetris well uses).
+const GLYPHS = {
+    wall: '██',
+    floor: '  ',
+    target: '· ',
+    box: '◇ ',
+    'box-on-target': '◆ ',
+    player: '☻ ',
+    'player-on-target': '☻ '
+};
+const STYLES = {
+    wall: { color: ui.frame },
+    floor: {},
+    target: { color: ui.star, dimColor: true },
+    box: { color: ui.crate, bold: true },
+    'box-on-target': { color: ui.docked, bold: true },
+    player: { color: ui.probe, bold: true },
+    'player-on-target': { color: ui.docked, bold: true }
+};
+export function tileGlyph(tile) {
+    return GLYPHS[tile];
+}
+export function tileStyle(tile) {
+    return STYLES[tile];
+}
+//# sourceMappingURL=palette.js.map

package/dist/ui/palette.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"palette.js","sourceRoot":"","sources":["../../src/ui/palette.ts"],"names":[],"mappings":"AAgBA,+EAA+E;AAC/E,gFAAgF;AAChF,wBAAwB;AACxB,MAAM,CAAC,MAAM,EAAE,GAAG;IAChB,MAAM,EAAE,MAAM;IACd,KAAK,EAAE,MAAM;IACb,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,KAAK;IACb,IAAI,EAAE,QAAQ;IACd,EAAE,EAAE,OAAO;IACX,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,KAAK,EAAE,SAAS;CACR,CAAC;AAEX,+EAA+E;AAC/E,kDAAkD;AAClD,MAAM,MAAM,GAAyB;IACnC,IAAI,EAAE,IAAI;IACV,KAAK,EAAE,IAAI;IACX,MAAM,EAAE,IAAI;IACZ,GAAG,EAAE,IAAI;IACT,eAAe,EAAE,IAAI;IACrB,MAAM,EAAE,IAAI;IACZ,kBAAkB,EAAE,IAAI;CACzB,CAAC;AAEF,MAAM,MAAM,GAA4B;IACtC,IAAI,EAAE,EAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAAC;IACvB,KAAK,EAAE,EAAE;IACT,MAAM,EAAE,EAAC,KAAK,EAAE,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAC;IACxC,GAAG,EAAE,EAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAC;IAClC,eAAe,EAAE,EAAC,KAAK,EAAE,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAC;IAC/C,MAAM,EAAE,EAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAC;IACrC,kBAAkB,EAAE,EAAC,KAAK,EAAE,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAC;CACnD,CAAC;AAEF,MAAM,UAAU,SAAS,CAAC,IAAU;IAClC,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAU;IAClC,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@terminalgames/ink-sokoban",
+  "version": "0.1.0",
+  "description": "Terminal Sokoban built with Ink.",
+  "type": "module",
+  "main": "./dist/cli.js",
+  "types": "./dist/cli.d.ts",
+  "bin": {
+    "ink-sokoban": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build && npm test",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "cli",
+    "ink",
+    "sokoban",
+    "puzzle",
+    "game",
+    "terminal"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "ink": "^7.0.4",
+    "react": "^19.2.6"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.1",
+    "@types/react": "^19.2.15",
+    "ink-testing-library": "^4.0.0",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.7"
+  }
+}