@north-light/crouter 0.3.191 → 0.3.193

package/dist/clients/inbox/tui/panel.d.ts

@@ -1,2 +1,4 @@
-import type { MountedPanel, MountedPanelOpts } from './types.js';
+import type { PageResponses } from '../../../core/human/page-schema.js';
+import type { MountedPanel, MountedPanelOpts, TuiState } from './types.js';
+export declare function collectResponses(state: TuiState): PageResponses;
 export declare function mountPanel(opts: MountedPanelOpts): MountedPanel;

package/dist/clients/inbox/tui/panel.js

@@ -1,125 +1,56 @@
-import { readFileSync, renameSync, unlinkSync, writeFileSync } from 'node:fs';
-import { assignShortcuts, handleKeypress } from './input.js';
+import { handleKeypress } from './input.js';
 import { clampItemReviewScroll, renderFinal, renderItemReview, renderOverview } from './render.js';
-// ── Internal helpers ──────────────────────────────────────────────────────────
-function buildInitialState(deck, editorAvailable = false, wrapWidth = 80) {
-    // Single-question decks skip the overview list — there's nothing to overview,
-    // and overview hides the option hotkeys so users press 'y' and nothing happens.
-    const initialPhase = deck.interactions.length === 1 ? 'item-review' : 'overview';
-    const responses = new Map();
-    const preAnsweredIds = new Set();
-    // Seed responses + preAnsweredIds from any `preAnswered` field. The seeded
-    // response counts as answered for navigation/auto-advance, but is rendered
-    // distinctly so the human knows it carried over. `tryResume` runs after and
-    // takes priority — mid-deck progress should not be overwritten by defaults.
-    for (const interaction of deck.interactions) {
-        const pa = interaction.preAnswered;
-        if (pa === undefined)
+import { pageComplete, slotAnswered } from './slots.js';
+function projectProse(projection) {
+    const overviewProse = [];
+    const slotProse = new Map();
+    let pending = [];
+    let seenSlot = false;
+    for (const block of projection) {
+        if (block.kind === 'prose') {
+            if (block.markdown.trim() !== '')
+                pending.push(block.markdown);
             continue;
-        const response = { id: interaction.id };
-        if (pa.selectedOptionId !== undefined)
-            response.selectedOptionId = pa.selectedOptionId;
-        if (pa.selectedOptionIds !== undefined)
-            response.selectedOptionIds = [...pa.selectedOptionIds];
-        if (pa.freetext !== undefined)
-            response.freetext = pa.freetext;
-        responses.set(interaction.id, response);
-        preAnsweredIds.add(interaction.id);
-    }
-    // Start cursor on the first unanswered interaction — humans land where they
-    // need to act. If every interaction is pre-answered, fall back to index 0.
-    const firstUnanswered = deck.interactions.findIndex((i) => !responses.has(i.id));
-    return {
-        phase: initialPhase,
-        currentIndex: firstUnanswered >= 0 ? firstUnanswered : 0,
-        interactions: deck.interactions,
-        responses,
-        preAnsweredIds,
-        inputMode: null,
-        selectedAction: 0,
-        bodyMode: 'question',
-        scrollOffset: 0,
-        bodyScrollOffsets: { question: 0 },
-        hscrollOffset: 0,
-        hscrollMax: 0,
-        wrapWidth,
-        editorAvailable,
-    };
-}
-function collectResponses(state) {
-    const out = [];
-    for (const interaction of state.interactions) {
-        const r = state.responses.get(interaction.id);
-        if (r !== undefined)
-            out.push(r);
-    }
-    return out;
-}
-function tryResume(state, progressPath, interactions) {
-    try {
-        const prior = JSON.parse(readFileSync(progressPath, 'utf8'));
-        if (!Array.isArray(prior.responses))
-            return;
-        const validIds = new Set(interactions.map((i) => i.id));
-        for (const r of prior.responses) {
-            if (validIds.has(r.id))
-                state.responses.set(r.id, r);
         }
-        const firstUnanswered = interactions.findIndex((i) => !state.responses.has(i.id));
-        state.currentIndex = firstUnanswered >= 0 ? firstUnanswered : 0;
+        if (!seenSlot)
+            overviewProse.push(...pending);
+        else
+            slotProse.set(block.slotIndex, pending);
+        pending = [];
+        seenSlot = true;
     }
-    catch {
-        // corrupt or missing progress file — start fresh
+    // A page with no slots has no final phase to reach — its prose is the overview.
+    if (!seenSlot) {
+        overviewProse.push(...pending);
+        return { overviewProse, slotProse, finalProse: [] };
     }
+    return { overviewProse, slotProse, finalProse: pending };
 }
-function atomicWriteProgress(progressPath, responses) {
-    const payload = JSON.stringify({ partial: true, responses, savedAt: new Date().toISOString() }, null, 2);
-    const tmp = `${progressPath}.tmp`;
-    try {
-        writeFileSync(tmp, payload);
-        renameSync(tmp, progressPath);
-    }
-    catch {
-        // best-effort
-    }
-}
-function rebindPersist(internals) {
-    internals.state.persist = () => {
-        const responses = collectResponses(internals.state);
-        if (internals.progressPath !== undefined)
-            atomicWriteProgress(internals.progressPath, responses);
-        internals.callbacks.onProgress?.(responses);
-    };
+function buildInitialState(manifest, projection, initialResponses, productKinds, editorAvailable, wrapWidth) {
+    const prose = projectProse(projection);
+    const responses = new Map();
+    const validIds = new Set(manifest.slots.flatMap((slot) => slot.id === undefined ? [] : [slot.id]));
+    for (const [id, response] of Object.entries(initialResponses ?? {}))
+        if (validIds.has(id))
+            responses.set(id, response);
+    const state = { phase: manifest.slots.length === 1 ? 'item-review' : 'overview', currentIndex: 0, manifest, slots: manifest.slots, ...prose, responses, productKinds, inputMode: null, selectedAction: 0, bodyMode: 'question', scrollOffset: 0, bodyScrollOffsets: { question: 0 }, hscrollOffset: 0, hscrollMax: 0, wrapWidth, editorAvailable };
+    const first = manifest.slots.findIndex((slot) => slot.id !== undefined && !slotAnswered(state, slot));
+    if (first >= 0)
+        state.currentIndex = first;
+    return state;
 }
+export function collectResponses(state) { return Object.fromEntries(state.responses); }
+function rebindPersist(internals) { internals.state.persist = () => internals.callbacks.onProgress?.(collectResponses(internals.state)); }
 export function mountPanel(opts) {
-    const internals = {
-        state: buildInitialState(opts.deck, opts.onEditorRequest !== undefined, opts.cols),
-        cols: opts.cols,
-        rows: opts.rows,
-        mounted: true,
-        progressPath: opts.progressPath,
-        callbacks: {
-            onProgress: opts.onProgress, onComplete: opts.onComplete, onExit: opts.onExit,
-            onDirty: opts.onDirty, onEditorRequest: opts.onEditorRequest,
-        },
-    };
-    assignShortcuts(internals.state.interactions);
+    const internals = { state: buildInitialState(opts.manifest, opts.projection, opts.initialResponses, opts.productKinds ?? [], opts.onEditorRequest !== undefined, opts.cols), cols: opts.cols, rows: opts.rows, mounted: true, callbacks: { onProgress: opts.onProgress, onComplete: opts.onComplete, onExit: opts.onExit, onDirty: opts.onDirty, onEditorRequest: opts.onEditorRequest } };
     rebindPersist(internals);
-    if (internals.progressPath !== undefined) {
-        tryResume(internals.state, internals.progressPath, opts.deck.interactions);
-    }
     const renderLines = () => {
-        switch (internals.state.phase) {
-            case 'overview': return renderOverview(internals.state, internals.cols, internals.rows);
-            case 'item-review':
-                // The one pre-render clamp: keeps scrollOffset/hscrollOffset inside the
-                // current body's bounds (so u/d and h/l stay responsive) and publishes
-                // the live horizontal reach the input layer reads. The renderer itself
-                // stays pure; running it here covers mount, resize and every keypress.
-                clampItemReviewScroll(internals.state, internals.cols, internals.rows);
-                return renderItemReview(internals.state, internals.cols, internals.rows);
-            case 'final': return renderFinal(internals.state, internals.cols, internals.rows);
-        }
+        if (internals.state.phase === 'overview')
+            return renderOverview(internals.state, internals.cols, internals.rows);
+        if (internals.state.phase === 'final')
+            return renderFinal(internals.state, internals.cols, internals.rows);
+        clampItemReviewScroll(internals.state, internals.cols, internals.rows);
+        return renderItemReview(internals.state, internals.cols, internals.rows);
     };
     return {
         handleKey(input, key) {
@@ -129,89 +60,30 @@ export function mountPanel(opts) {
                 internals.callbacks.onEditorRequest();
                 return;
             }
-            const onAutoComplete = () => {
-                const responses = collectResponses(internals.state);
-                if (internals.progressPath !== undefined) {
-                    try {
-                        unlinkSync(internals.progressPath);
-                    }
-                    catch { /* ignore */ }
-                }
-                internals.callbacks.onComplete?.(responses);
-            };
-            handleKeypress(input, key, internals.state, () => { }, () => {
+            handleKeypress(input, key, internals.state, () => internals.callbacks.onDirty?.(), (submit) => {
                 const responses = collectResponses(internals.state);
-                if (responses.length >= internals.state.interactions.length) {
-                    onAutoComplete();
-                }
-                else {
+                if (submit === true && pageComplete(internals.state))
+                    internals.callbacks.onComplete?.(responses);
+                else
                     internals.callbacks.onExit?.();
-                }
             });
+            internals.callbacks.onDirty?.();
         },
-        render() {
-            if (!internals.mounted)
-                return [];
-            return renderLines();
-        },
-        handleResize(cols, rows) {
-            internals.cols = cols;
-            internals.rows = rows;
-            internals.state.wrapWidth = cols;
-            return renderLines();
-        },
-        unmount() {
-            if (!internals.mounted)
-                return;
-            internals.mounted = false;
-            internals.state.persist = undefined;
-        },
-        loadDeck(deck, loadOpts) {
+        render: () => internals.mounted ? renderLines() : [],
+        handleResize(cols, rows) { internals.cols = cols; internals.rows = rows; internals.state.wrapWidth = cols; return renderLines(); },
+        unmount() { internals.mounted = false; internals.state.persist = undefined; },
+        loadPage(manifest, projection, loadOpts) {
             if (!internals.mounted)
                 return;
             const prior = collectResponses(internals.state);
-            internals.state = buildInitialState(deck, internals.callbacks.onEditorRequest !== undefined, internals.cols);
-            if (loadOpts !== undefined && loadOpts.progressPath !== undefined) {
-                internals.progressPath = loadOpts.progressPath;
-            }
-            assignShortcuts(internals.state.interactions);
+            const merged = { ...(loadOpts?.initialResponses ?? {}), ...prior };
+            internals.state = buildInitialState(manifest, projection, merged, loadOpts?.productKinds ?? internals.state.productKinds, internals.callbacks.onEditorRequest !== undefined, internals.cols);
             rebindPersist(internals);
-            if (internals.progressPath !== undefined) {
-                tryResume(internals.state, internals.progressPath, deck.interactions);
-            }
-            // A live request replacement is allowed to add/remove questions but not
-            // discard answers the human has already made to surviving ids.
-            const validIds = new Set(deck.interactions.map((interaction) => interaction.id));
-            for (const response of prior) {
-                if (validIds.has(response.id))
-                    internals.state.responses.set(response.id, response);
-            }
-            const currentId = internals.state.interactions[internals.state.currentIndex]?.id;
-            if (currentId === undefined || !validIds.has(currentId)) {
-                const firstUnanswered = internals.state.interactions.findIndex((interaction) => !internals.state.responses.has(interaction.id));
-                internals.state.currentIndex = firstUnanswered >= 0 ? firstUnanswered : 0;
-            }
-        },
-        canAcceptHostKeys() {
-            if (!internals.mounted)
-                return false;
-            return internals.state.inputMode === null;
-        },
-        atDeckTop() {
-            if (!internals.mounted)
-                return true;
-            return internals.state.phase === 'overview' && internals.state.inputMode === null;
-        },
-        getInputBuffer() {
-            if (!internals.mounted || internals.state.inputMode === null)
-                return undefined;
-            return internals.state.inputMode.buffer;
-        },
-        setInputBuffer(text) {
-            if (!internals.mounted || internals.state.inputMode === null)
-                return;
-            internals.state.inputMode.buffer = text;
-            internals.state.inputMode.cursor = [...text].length;
         },
+        canAcceptHostKeys: () => internals.mounted && internals.state.inputMode === null,
+        atPageTop: () => !internals.mounted || (internals.state.phase === 'overview' && internals.state.inputMode === null),
+        getInputBuffer: () => !internals.mounted || internals.state.inputMode === null ? undefined : internals.state.inputMode.buffer,
+        setInputBuffer(text) { if (!internals.mounted || internals.state.inputMode === null)
+            return; internals.state.inputMode.buffer = text; internals.state.inputMode.cursor = [...text].length; },
     };
 }

package/dist/clients/inbox/tui/render.d.ts

@@ -1,37 +1,12 @@
 import type { TuiState } from './types.js';
-import type { Interaction, InteractionResponse } from '../../../core/human/types.js';
 export declare function renderOverview(state: TuiState, cols: number, rows: number): string[];
-/**
- * Render a (possibly multiline) input buffer with a visible cursor at
- * `cursor` (a code-point index). A private-use sentinel is inserted at the
- * cursor position, the result is hard-wrapped (so `\n` and width-wrapping
- * behave exactly as they would without a cursor), then the sentinel is
- * swapped for a reverse-video block on whichever wrapped line it landed on.
- * `stringWidth('\uE000') === 1`, so it occupies exactly one column and never
- * throws off the wrap math.
- */
 export declare function renderInputBuffer(buffer: string, cursor: number, maxWidth: number): string[];
-/** Code-point bounds of every visual row `renderInputBuffer` paints, mirroring
- *  `hardWrap` (character-based, lossless) so a cursor index maps to the row the
- *  human actually sees. `end` is exclusive of the row's trailing '\n', if any. */
 export declare function wrappedRowBounds(buffer: string, width: number): {
     start: number;
     end: number;
 }[];
-/** Vertical motion by *visual* row — what up/down mean in a wrapped input box,
- *  where one long soft-wrapped paragraph spans many rows. Returns the new
- *  code-point cursor, unchanged when there is no row in that direction. */
 export declare function verticalCursor(buffer: string, cursor: number, delta: number, width: number): number;
-/**
- * Clamp state.scrollOffset to the current body's scroll bounds. The host runs
- * this as a pre-render step (from the input path) so `renderItemReview` stays a
- * pure function of state — the clamp keeps u/d scrolling responsive without the
- * renderer mutating state mid-frame.
- */
 export declare function clampItemReviewScroll(state: TuiState, cols: number, rows: number): void;
-/** Pan the card body horizontally. Clamping happens in the pre-render clamp
- *  the host already runs, exactly like vertical over-scroll. */
 export declare function panItemReview(state: TuiState, direction: -1 | 1): void;
 export declare function renderItemReview(state: TuiState, cols: number, rows: number): string[];
 export declare function renderFinal(state: TuiState, cols: number, rows: number): string[];
-export declare function responseSummary(r: InteractionResponse, interaction: Interaction): string;