geneseed 3.14.0 → 3.15.0

package/js/ui/tui.mjs

@@ -21,13 +21,11 @@
  * deleted the day the real one crossed, would be a second user interface and not a port.
  *
  * WHAT DOES CROSS is the alignment contract — the functions below that decide what a row
- * looks like before any curses call is made. They have no caller in this file yet, and that
- * is deliberate and dated: **P7c is the due date**, when `_tui_loop` and the eighteen
- * screens of `_harness_tui_views.py` arrive and consume them. They are here now because they
- * are the half that can be gated exhaustively, and `tests/test_pure_function_parity.py`
- * gates every one of them in both glyph modes. Deleting any of them turns that gate red —
- * this port has shipped code before whose absence nothing would have noticed, and these are
- * not that.
+ * looks like: display width, fitting, glyph tiers, the catalogue's entries and detail lines.
+ * Each has a caller outside this file (the catalogue, the status panel, the web console).
+ * The panel itself was REJECTED, not deferred, so the helpers that existed only for it —
+ * the spinner, the wordmark, scroll clamping, the progress bar and the theme preview/flair
+ * readers — were deleted rather than kept waiting for a screen that will not come.
  *
  * WHAT IS DELIBERATELY NOT HERE: `_bx` (its non-ASCII arm returned `curses.ACS_*` chtype
  * ints, which belonged with the window) and every `(stdscr, curses, pal)` drawing helper.
@@ -37,14 +35,10 @@
  * **DO NOT WRITE A SECOND LINE BREAKER.** This block used to argue that `textwrap.wrap` was
  * "a second `difflib` — a stdlib payload with no Node twin". It has one since P1:
  * `wrapText` in `js/ui/cli.mjs`, written because `--help` was the caller that finally
- * required it, frozen at `tests/__snapshots__/textwrap.json` at every width from 11 to 198.
+ * required it, pinned by the written-out rows in `tests/unit/text_layout.test.mjs`.
  * Anything that needs wrapping wraps THAT. `_parse_laws`, `load_registry`, `entity_status` and
  * `_tui_inventory` crossed in P6c and live in `js/inspect/inventory.mjs`.
  */
-import path from 'node:path';
-
-import { THEMES } from '../build/source.mjs';
-import { readJsonMaybe } from '../hosts/installs.mjs';
 import { splitLines } from '../lib/udiff.mjs';
 import { printOut } from '../lib/fs.mjs';
 
@@ -58,7 +52,6 @@ import { printOut } from '../lib/fs.mjs';
 const TUI_ASCII = !!process.env.GENESEED_TUI_ASCII;
 const TUI_PLAIN = !!process.env.GENESEED_TUI_PLAIN;
 const TUI_EMOJI = !(TUI_ASCII || TUI_PLAIN);
-const TUI_ANIM = TUI_EMOJI;
 
 /** `_glyphs` — the one glyph table for the whole TUI, unicode or ASCII stand-ins. */
 export function glyphs(asciiMode) {
@@ -269,119 +262,18 @@ export function mark(kind) {
   return TUI_ASCII ? asc : (TUI_EMOJI ? emoji : sym);
 }
 
-const SPIN = '⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏';
-
-/** `_spin` — one spinner frame for tick `i`; a static dot in the non-animated tiers. */
-export function spin(i) {
-  if (!TUI_ANIM) return TUI_ASCII ? '-' : '·';
-  const frames = TUI_ASCII ? '|/-\\' : SPIN;
-  // `frames[i % len]` on the reference indexes CODE POINTS; the braille frames are BMP so
-  // UTF-16 indexing agrees, but spelling it through `[...frames]` keeps that an argument
-  // about the data rather than a coincidence. Python's `%` on a negative `i` returns a
-  // non-negative remainder and JavaScript's does not, so the modulo is corrected.
-  const f = [...frames];
-  return f[((i % f.length) + f.length) % f.length];
-}
-
-const LOGO_FONT = {
-  G: [' ### ', '#    ', '# ## ', '#  # ', ' ### '],
-  E: ['#### ', '#    ', '###  ', '#    ', '#### '],
-  N: ['#   #', '##  #', '# # #', '#  ##', '#   #'],
-  S: [' ####', '#    ', ' ### ', '    #', '#### '],
-  D: ['###  ', '#  # ', '#   #', '#  # ', '###  '],
-};
-
-/** `_logo_lines` — the GENESEED wordmark as 5 text rows. */
-export function logoLines() {
-  const ink = TUI_ASCII ? '#' : '█';
-  const rows = [];
-  for (let r = 0; r < 5; r += 1) {
-    rows.push([...'GENESEED'].map((c) => LOGO_FONT[c][r].replaceAll('#', ink)).join(' '));
-  }
-  return rows;
-}
-
-// ---- layout maths --------------------------------------------------------------------
-
-/** `_clamp` — clamp a scroll offset so [top, top+viewH) stays inside `total`. */
-export function clamp(top, total, viewH) {
-  return Math.max(0, Math.min(top, Math.max(0, total - viewH)));
-}
-
-const BAR_EIGHTHS = ' ▏▎▍▌▋▊▉█';
-
-/** `_progress_bar` — a determinate bar exactly `width` display columns wide. */
-export function progressBar(frac, width = 24) {
-  const f = Math.max(0.0, Math.min(1.0, frac));
-  if (TUI_ASCII) {
-    const filled = roundHalfEven(f * width);
-    return '#'.repeat(filled) + '-'.repeat(width - filled);
-  }
-  const eighths = roundHalfEven(f * width * 8);
-  const full = Math.floor(eighths / 8);
-  const rem = eighths % 8;
-  if (full >= width) return '█'.repeat(width);
-  return '█'.repeat(full) + [...BAR_EIGHTHS][rem] + ' '.repeat(width - full - 1);
-}
-
-/**
- * `round()` — Python rounds HALF TO EVEN and `Math.round` rounds half UP, and this is the
- * one place in the file where that shows: a bar at exactly 0.5 of a cell is the frontier
- * case the eighths resolution exists to draw, and `round(0.5)` is 0 there and 1 here.
- */
-function roundHalfEven(x) {
-  const f = Math.floor(x);
-  const d = x - f;
-  if (d > 0.5) return f + 1;
-  if (d < 0.5) return f;
-  return f % 2 === 0 ? f : f + 1;
-}
-
-// ---- theme reads ---------------------------------------------------------------------
-
-/** `_theme_preview` — right-panel preview rows for a theme, as (kind, text) pairs. */
-export function themePreview(key) {
-  const data = readJsonMaybe(path.join(THEMES, `${key}.json`));
-  if (!data || typeof data !== 'object') return [['dim', '(no preview available)']];
-  const lines = [['title', key], ['', '']];
-  if (data.TAGLINE) lines.push(['dim', data.TAGLINE], ['', '']);
-  if (data.LOADED_SIGIL) lines.push(['ok', data.LOADED_SIGIL], ['', '']);
-  if (data.VOICE) lines.push(['', `Voice — ${data.VOICE}`], ['', '']);
-  if (data.LEX_SEALED_SECRETS) lines.push(['', `e.g.  Rule I — ${data.LEX_SEALED_SECRETS}`]);
-  if (data.BENEDICTION) lines.push(['', ''], ['dim', data.BENEDICTION]);
-  return lines;
-}
-
-/** `_theme_flair` — the voice elements the setup chrome speaks in once a theme is chosen. */
-export function themeFlair(theme) {
-  const data = readJsonMaybe(path.join(THEMES, `${theme}.json`)) || {};
-  const banner = data.BANNER ?? '';
-  return {
-    accent: data.ACCENT ?? 'cyan',
-    tagline: data.TAGLINE ?? '',
-    sigil: data.LOADED_SIGIL ?? '',
-    // `str.splitlines()` — `js/lib/udiff.mjs`' twin, already gated. It answers `[]` for
-    // the empty string where `''.split('\n')` answers `['']`, which would put a blank row
-    // in the banner of every theme that omits one; and its boundary set is Python's rather
-    // than `\s`, which P6d measured apart.
-    banner: splitLines(banner),
-    benediction: data.BENEDICTION ?? '',
-  };
-}
-
 // ---- the inventory's two consumers ----------------------------------------------------
 
 /**
  * `_tui_entries` — the ordered (kind, label, data) rows for the left list. `head` is a
  * section divider and is not selectable.
  *
- * ⚠ THE TWO NEW TIERS ARE GUARDED, AND THE GUARD IS NOT DEFENSIVENESS. This function has two
- * recorded cases per platform in `tests/__snapshots__/primitives/`, replayed under
- * `deepStrictEqual`, and their argument is a synthetic inventory carrying exactly
- * `{agents, skills, laws, theme}` — no recorder survives to re-bless them. Reading
- * `inv.doctrines.length` there THROWS; emitting a head unconditionally changes the recorded
- * result array. Keyed on presence, the recording renders byte-identical and a real inventory
- * gets all three tiers.
+ * ⚠ THE TWO NEW TIERS ARE GUARDED, AND THE GUARD IS NOT DEFENSIVENESS. When they landed, this
+ * function had two recorded cases per platform in the former Python suite's corpus, and their
+ * argument was a synthetic inventory carrying exactly `{agents, skills, laws, theme}`. Reading
+ * `inv.doctrines.length` on such an inventory THROWS; emitting a head unconditionally changes
+ * the result array. Keyed on presence, an inventory without the tiers renders as it always did
+ * and a real inventory gets all three tiers.
  *
  * The order is CONSTITUTIONAL and not alphabetical: ontology, then invariants, then doctrines
  * — the order they are read in, the order AGENT.md renders them, and the order the console's
@@ -435,12 +327,11 @@ export function tuiEntries(inv) {
  * because line 554 moves `sel` onto the first SELECTABLE row — but line 555 is
  * `if not selectable: sel = 0`, and row 0 is always the AGENTS header. So an inventory with
  * no agents, no skills AND no laws crashes the panel on its first frame instead of drawing
- * an empty state. `_TUI_INV_EMPTY` in `tests/test_pure_function_parity.py` is the corpus
+ * an empty state. `_TUI_INV_EMPTY` in the former Python parity suite is the corpus
  * entry that surfaced it. **P7c must not reproduce the crash when it ports `_tui_loop`** —
  * the fix is one `or []` at the call site, and it belongs in the same change as the port.
  *
- * Its only consumer with direct assertions is `tests/unit/setup.test.mjs`; tests/fixtures/pure_probe.mjs
- * also dispatches it to exercise wizard/web_first test scenarios.
+ * Its only consumer with direct assertions is `tests/unit/setup.test.mjs`.
  */
 export function detailLines(kind, label, data) {
   // The three constitutional tiers share one treatment — the label, a blank, then the body —