@modelstatus/cli 0.1.35 → 0.1.37

package/src/tui/game/DkGame.js

@@ -1,187 +1,21 @@
-/* Donkey Kong — thin Ink wrapper. h = React.createElement (NO JSX, per ui.js).
+/* RETIRED. The old Ink-overlay Donkey Kong (a React component running a useTick
+ * frame loop, mounted as an overlay inside ScanView) has been replaced by the
+ * direct-ANSI, Ink-free game:
  *
- * Holds the game state + a synchronously-mutated inputRef (the stale-closure-safe
- * pattern from useSearch / scan.js refIdxRef), runs the frame loop via useTick
- * GATED so it NEVER ticks at idle, and composes a fixed-height block:
- *   row 0: scan-progress HUD (live scan fields → SweepBar)        }
- *   row 1: game stats (♥ lives · score · level · best · message)  } HUD_ROWS = 2
- *   rows 2..2+BOARD_H-1: the board (one colored <Text> per row)
- *   last row: in-game KeyBar
- * Total rows = BOARD_H + 3 == the terminal `height` (boardSize math), so the
- * surrounding window chrome never jumps and Ink keeps diffing.
+ *   - src/tui/game/loop.js   — 60Hz fixed-timestep loop (own raw mode + alt screen)
+ *   - src/tui/game/term.js   — double-buffered diff renderer (never clears mid-play)
+ *   - src/tui/game/input.js  — raw-stdin held-key model
+ *   - src/tui/game/dk-core.js— pure sub-cell fixed-point physics engine
  *
- * The component owns its own useInput (gated on `active` + `gameMode`) so it is
- * independently mountable + testable; when embedded in ScanView the wrapper
- * simply passes `active` through and relies on ui.setCapturing to stop the
- * global app keys leaking. The SCAN is never touched — we only READ the hook
- * fields the design surfaces (scan.filesScanned / scan.candidates.length /
- * scan.phase). */
-import React from "react";
-import { Box, Text, useInput } from "ink";
-import { h, C, LIGHT, GLYPH, KeyBar, SweepBar, useTick, cell, fmtNum } from "../ui.js";
-import { GAME_GLYPH, GAME_COLORS, colorize } from "./dk-render.js";
-import { initGame, stepGame, nextLevel, FRAME_MS, boardSize, MIN_W, MIN_H } from "./dk-core.js";
-
-const BG_ON = !(process.env.MM_ASCII === "1" || process.env.TERM === "dumb") && process.env.NO_COLOR == null;
-
-const GAME_KEYS = [
-  { k: "←→", label: "move" },
-  { k: "↑↓", label: "climb" },
-  { k: "spc", label: "jump" },
-  { k: "p", label: "pause" },
-  { k: "r", label: "restart" },
-  { k: "q", label: "back to scan" },
-];
-
-const freshInput = () => ({ left: false, right: false, up: false, down: false, jump: false });
-
-/**
- * DonkeyKong overlay.
- *  props:
- *   - width, height: the SAME numbers ScanView gets (drive boardSize)
- *   - scan: the useStreamingScan return (read-only — filesScanned, candidates, phase)
- *   - ui: shell helpers ({ showToast, setCapturing, setHandlesBack })
- *   - onExit: called when the player quits the game (q / esc / backspace)
- *   - active: input gate (mirrors ScanView's `active`)
- *   - level: starting level (default 1)
+ * Reached via `mm play` (standalone) or the Scan-tab P key, which UNMOUNTS Ink,
+ * runs the loop, then REMOUNTS the TUI (see src/tui/views/scan.js launchGame +
+ * src/tui/app.js appController). This file is kept only as a tombstone — nothing
+ * imports it. It intentionally exports nothing and pulls in no dependencies.
+ *
+ * This file can be deleted outright; it is retained as a no-op so an accidental
+ * stale import fails loudly rather than resurrecting the old flicker-prone path.
  */
-export function DonkeyKong({ width = 78, height = 14, scan = {}, ui = {}, onExit = () => {}, active = true, level = 1 }) {
-  const dims = { width, height };
-  const { BOARD_W, BOARD_H } = boardSize(width, height);
-  const playable = BOARD_W >= MIN_W && BOARD_H >= MIN_H;
-
-  const [game, setGame] = React.useState(() => initGame({ ...dims, level }));
-  const [paused, setPaused] = React.useState(false);
-  const pausedRef = React.useRef(false);
-  const inputRef = React.useRef(freshInput());
-  const highRef = React.useRef(0);
-
-  // Track the running session high score (kept in a ref so it survives restarts
-  // within this mount; shown in the HUD).
-  if (game && game.score > highRef.current) highRef.current = game.score;
-
-  const scanLive = scan.phase ? scan.phase !== "done" : true;
-  // The loop NEVER ticks at idle: only while (a) the overlay is up [it's mounted
-  // = up], (b) not paused, (c) the game isn't on a terminal frozen frame, and
-  // (d) the scan is still live (or just finishing). Per the design's idle rule.
-  const playing = game && game.status === "playing";
-  const ticking = playable && active && !paused && playing && (scanLive || game.frame < 1);
-  const tick = useTick(FRAME_MS, ticking);
-
-  // One advance per frame; read + clear the synchronous input ref each tick so a
-  // keypress in the same tick is seen (and isn't applied twice).
-  React.useEffect(() => {
-    if (!ticking) return;
-    setGame((g) => {
-      const ng = stepGame(g, { input: inputRef.current });
-      return ng;
-    });
-    inputRef.current = freshInput();
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [tick]);
-
-  // Auto level-up a beat after a win: hold the "you saved her" frame for ~1s,
-  // then rebuild the next level carrying score + lives.
-  React.useEffect(() => {
-    if (game && game.status === "won") {
-      const t = setTimeout(() => setGame((g) => (g.status === "won" ? nextLevel(g, dims) : g)), 1000);
-      return () => clearTimeout(t);
-    }
-    return undefined;
-  }, [game && game.status, game && game.level]); // eslint-disable-line react-hooks/exhaustive-deps
-
-  function exit() {
-    ui.setCapturing?.(false);
-    ui.setHandlesBack?.(false);
-    onExit();
-  }
-
-  // Single input owner for the overlay. q / esc / backspace exit; r restarts;
-  // p toggles ONLY the game loop (the scan keeps running). Movement keys set the
-  // synchronous intent flags consumed next tick. Ctrl-C is NOT swallowed.
-  useInput(
-    (input, key) => {
-      if (!active) return;
-      if (key.ctrl && input === "c") return; // let the global handler exit the app
-      if (input === "q" || key.escape || key.backspace || key.delete) return exit();
-      if (input === "r") { setGame(initGame({ ...dims, level: 1 })); inputRef.current = freshInput(); return; }
-      if (input === "p") { pausedRef.current = !pausedRef.current; setPaused(pausedRef.current); return; }
-      const ir = inputRef.current;
-      if (key.leftArrow || input === "h") ir.left = true;
-      else if (key.rightArrow || input === "l") ir.right = true;
-      else if (key.upArrow || input === "k") ir.up = true;
-      else if (key.downArrow || input === "j") ir.down = true;
-      else if (input === " ") ir.jump = true;
-    },
-    { isActive: active },
-  );
-
-  // --- too-small guard: a single line, no loop, nothing animates -----------
-  if (!playable) {
-    return h(
-      Box,
-      { flexDirection: "column" },
-      h(Text, { color: "#d97706" }, "  terminal too small for the game — resize to ~30x12, q to go back"),
-    );
-  }
-
-  // ---- HUD row 1: live scan progress ----
-  const files = scan.filesScanned || 0;
-  const models = (scan.candidates && scan.candidates.length) || 0;
-  const dirs = scan.dirsSeen || 0;
-  const barW = Math.max(10, Math.min(22, BOARD_W - 28));
-  // SweepBar renders a <Box>, which can't nest inside a <Text> — so the live HUD
-  // row is a flex <Box> with the bar as a sibling of the text spans.
-  const hud1 = scanLive
-    ? h(
-        Box,
-        { flexDirection: "row" },
-        h(Text, { color: C.FG_FAINT }, "  scanning "),
-        h(SweepBar, { tick, width: barW }),
-        h(Text, { color: C.FG_DIM }, `  files ${fmtNum(files)} · models ${fmtNum(models)} · dirs ${fmtNum(dirs)}`),
-      )
-    : h(
-        Text,
-        {},
-        h(Text, { color: "#16a34a" }, `  ${GLYPH.check} scan complete`),
-        h(Text, { color: C.FG_DIM }, ` · ${fmtNum(models)} models · q to view results`),
-      );
-
-  // ---- HUD row 2: game stats + transient message ----
-  const livesStr = "♥".repeat(Math.max(0, game.lives)) || "—";
-  const statusTag =
-    game.status === "over" ? `  ${game.message} · r restart · q back`
-      : game.status === "won" ? `  ${GLYPH.spark} ${game.message}`
-      : game.message ? `  ${game.message}` : "";
-  const hud2 = h(
-    Text,
-    {},
-    h(Text, { color: LIGHT.red }, `  ${livesStr}`),
-    h(Text, { color: C.FG_DIM }, "   score "),
-    h(Text, { color: C.ACCENT, bold: true }, fmtNum(game.score)),
-    h(Text, { color: C.FG_DIM }, `   lvl ${game.level}` + (paused ? "  ⏸ paused" : "")),
-    h(Text, { color: C.FG_FAINT }, `   best ${fmtNum(Math.max(highRef.current, game.score))}`),
-    h(Text, { color: game.status === "over" ? "#dc2626" : C.FG_STRONG }, statusTag),
-  );
-
-  // ---- board: one colored <Text> per row, padded to BOARD_W ----
-  const useColor = BG_ON;
-  const spanRows = colorize(game, { glyph: GAME_GLYPH, colors: GAME_COLORS });
-  const boardNodes = spanRows.map((spans, y) =>
-    h(
-      Text,
-      { key: "b" + y, wrap: "truncate" },
-      ...(useColor
-        ? spans.map((sp, i) => h(Text, { key: i, color: sp.color }, sp.text))
-        : [h(Text, { key: 0, color: C.FG }, spans.map((sp) => sp.text).join("").slice(0, BOARD_W).padEnd(BOARD_W))]),
-    ),
-  );
-  // Defensive height pin: render EXACTLY BOARD_H board rows.
-  while (boardNodes.length < BOARD_H) boardNodes.push(h(Text, { key: "bp" + boardNodes.length, color: C.FG }, cell("", BOARD_W)));
-
-  const keybar = h(KeyBar, { keys: GAME_KEYS, width });
-
-  return h(Box, { flexDirection: "column" }, hud1, hud2, ...boardNodes.slice(0, BOARD_H), keybar);
-}
-
-export default DonkeyKong;
+throw new Error(
+  "DkGame.js is retired — the Ink overlay game was replaced by the direct-ANSI loop " +
+    "(src/tui/game/loop.js). Use `mm play` or the Scan-tab P key. Do not import DkGame.js.",
+);