@bastani/atomic 0.7.17-1 → 0.8.0-0

package/dist/core/tools/ask-user-question/state/key-router.js

@@ -0,0 +1,240 @@
+import { Key, matchesKey } from "@earendil-works/pi-tui";
+import { ROW_INTENT_META } from "./row-intent.js";
+const KEYBIND_UP = "tui.select.up";
+const KEYBIND_DOWN = "tui.select.down";
+const KEYBIND_CONFIRM = "tui.select.confirm";
+const KEYBIND_CANCEL = "tui.select.cancel";
+const NOTES_ACTIVATE_KEY = "n";
+const SPACE_KEY = " ";
+export function wrapTab(index, total) {
+    if (total <= 0)
+        return 0;
+    return ((index % total) + total) % total;
+}
+export function allAnswered(state, runtime) {
+    if (runtime.questions.length === 0)
+        return false;
+    for (let i = 0; i < runtime.questions.length; i++) {
+        if (!state.answers.has(i))
+            return false;
+    }
+    return true;
+}
+function totalTabs(runtime) {
+    return runtime.isMulti ? runtime.questions.length + 1 : 1;
+}
+function computeAutoAdvanceTab(state, runtime) {
+    if (!runtime.isMulti)
+        return undefined;
+    if (state.currentTab < runtime.questions.length - 1)
+        return state.currentTab + 1;
+    return runtime.questions.length;
+}
+function buildSingleSelectAnswer(state, runtime) {
+    const q = runtime.questions[state.currentTab];
+    if (!q)
+        return null;
+    // Chat sentinel takes priority over inputMode: when chatFocused=true, the host overrides
+    // currentItem() to return the chat sentinel even if inputMode is still true (e.g. user
+    // navigated from "Type something." and DOWN focused the chat row).
+    const item = runtime.currentItem;
+    if (item?.kind === "chat") {
+        return {
+            questionIndex: state.currentTab,
+            question: q.question,
+            kind: "chat",
+            answer: item.label,
+        };
+    }
+    if (state.inputMode) {
+        const label = runtime.inputBuffer;
+        return {
+            questionIndex: state.currentTab,
+            question: q.question,
+            kind: "custom",
+            answer: label.length > 0 ? label : null,
+        };
+    }
+    if (!item)
+        return null;
+    if (item.kind === "other") {
+        return null;
+    }
+    if (item.kind === "next") {
+        return null;
+    }
+    return {
+        questionIndex: state.currentTab,
+        question: q.question,
+        kind: "option",
+        answer: item.label,
+    };
+}
+function buildMultiSelected(state, runtime) {
+    const q = runtime.questions[state.currentTab];
+    if (!q)
+        return [];
+    const out = [];
+    for (let i = 0; i < q.options.length; i++) {
+        if (state.multiSelectChecked.has(i)) {
+            const label = q.options[i]?.label;
+            if (typeof label === "string")
+                out.push(label);
+        }
+    }
+    return out;
+}
+function tabSwitchAction(data, state, runtime) {
+    if (!runtime.isMulti)
+        return null;
+    const total = totalTabs(runtime);
+    if (matchesKey(data, Key.tab) || matchesKey(data, Key.right)) {
+        return { kind: "tab_switch", nextTab: wrapTab(state.currentTab + 1, total) };
+    }
+    if (matchesKey(data, Key.shift("tab")) || matchesKey(data, Key.left)) {
+        return { kind: "tab_switch", nextTab: wrapTab(state.currentTab - 1, total) };
+    }
+    return null;
+}
+// DOWN at the last item emits focus_chat so the cycle [chat, option0, …, optionLast] wraps.
+function nextNavOnDown(state, runtime) {
+    if (runtime.items.length > 0 && state.optionIndex === runtime.items.length - 1) {
+        return { kind: "focus_chat" };
+    }
+    return { kind: "nav", nextIndex: wrapTab(state.optionIndex + 1, Math.max(1, runtime.items.length)) };
+}
+// UP at the top item emits focus_chat (symmetric with nextNavOnDown).
+function prevNavOnUp(state, runtime) {
+    if (runtime.items.length > 0 && state.optionIndex === 0) {
+        return { kind: "focus_chat" };
+    }
+    return { kind: "nav", nextIndex: wrapTab(state.optionIndex - 1, Math.max(1, runtime.items.length)) };
+}
+export function routeKey(data, state, runtime) {
+    const kb = runtime.keybindings;
+    if (state.notesVisible) {
+        if (kb.matches(data, KEYBIND_CANCEL))
+            return { kind: "notes_exit" };
+        if (kb.matches(data, KEYBIND_CONFIRM))
+            return { kind: "notes_exit" };
+        return { kind: "notes_forward", data };
+    }
+    if (state.chatFocused) {
+        if (kb.matches(data, KEYBIND_CANCEL))
+            return { kind: "cancel" };
+        if (kb.matches(data, KEYBIND_CONFIRM)) {
+            const answer = buildSingleSelectAnswer(state, runtime);
+            if (!answer)
+                return { kind: "ignore" };
+            return { kind: "confirm", answer, autoAdvanceTab: computeAutoAdvanceTab(state, runtime) };
+        }
+        // Continuous cycle: UP from chat → bottom of options (last navigable row), DOWN from
+        // chat → top of options (option 0). Symmetric with UP-at-top → focus_chat and
+        // DOWN-at-bottom → focus_chat below; together they form one wrapping cycle through
+        // `[chat, option0, …, optionLast]`.
+        if (kb.matches(data, KEYBIND_UP)) {
+            const last = Math.max(0, runtime.items.length - 1);
+            return { kind: "focus_options", optionIndex: last };
+        }
+        if (kb.matches(data, KEYBIND_DOWN)) {
+            return { kind: "focus_options", optionIndex: 0 };
+        }
+        const tab = tabSwitchAction(data, state, runtime);
+        if (tab)
+            return tab;
+        return { kind: "ignore" };
+    }
+    if (state.inputMode) {
+        if (kb.matches(data, KEYBIND_CONFIRM)) {
+            const answer = buildSingleSelectAnswer(state, runtime);
+            if (!answer)
+                return { kind: "ignore" };
+            return { kind: "confirm", answer, autoAdvanceTab: computeAutoAdvanceTab(state, runtime) };
+        }
+        if (kb.matches(data, KEYBIND_CANCEL))
+            return { kind: "cancel" };
+        if (kb.matches(data, KEYBIND_UP)) {
+            return prevNavOnUp(state, runtime);
+        }
+        if (kb.matches(data, KEYBIND_DOWN)) {
+            return nextNavOnDown(state, runtime);
+        }
+        return { kind: "ignore" };
+    }
+    if (runtime.isMulti && state.currentTab === runtime.questions.length) {
+        if (kb.matches(data, KEYBIND_CANCEL))
+            return { kind: "cancel" };
+        const tab = tabSwitchAction(data, state, runtime);
+        if (tab)
+            return tab;
+        if (kb.matches(data, KEYBIND_UP) || kb.matches(data, KEYBIND_DOWN)) {
+            const delta = kb.matches(data, KEYBIND_DOWN) ? 1 : -1;
+            const next = wrapTab(state.submitChoiceIndex + delta, 2);
+            return { kind: "submit_nav", nextIndex: (next === 1 ? 1 : 0) };
+        }
+        if (kb.matches(data, KEYBIND_CONFIRM)) {
+            // D1 (revised): Submit always submits; Cancel always cancels. The warning header
+            // is informational only — `allAnswered(state)` no longer gates submission. Partial
+            // answers flow through `orderedAnswers()` in the host.
+            return state.submitChoiceIndex === 1 ? { kind: "cancel" } : { kind: "submit" };
+        }
+        return { kind: "ignore" };
+    }
+    const tab = tabSwitchAction(data, state, runtime);
+    if (tab)
+        return tab;
+    const q = runtime.questions[state.currentTab];
+    if (!q)
+        return { kind: "ignore" };
+    if (data === NOTES_ACTIVATE_KEY && !q.multiSelect && state.focusedOptionHasPreview) {
+        return { kind: "notes_enter" };
+    }
+    if (kb.matches(data, KEYBIND_UP)) {
+        return prevNavOnUp(state, runtime);
+    }
+    if (kb.matches(data, KEYBIND_DOWN)) {
+        return nextNavOnDown(state, runtime);
+    }
+    if (q.multiSelect) {
+        const focusedKind = runtime.currentItem?.kind;
+        const focusedMeta = focusedKind ? ROW_INTENT_META[focusedKind] : undefined;
+        // Space toggles the focused row's checkbox. Suppressed on rows whose META declares
+        // `blocksMultiToggle` (the Next sentinel) — Next is not a real option and has no
+        // checked/unchecked state.
+        if (data === SPACE_KEY) {
+            if (focusedMeta?.blocksMultiToggle)
+                return { kind: "ignore" };
+            return { kind: "toggle", index: state.optionIndex };
+        }
+        if (kb.matches(data, KEYBIND_CONFIRM)) {
+            // Enter on a regular row toggles (matching Space) — committing the question is now
+            // gated behind explicit focus on a row whose META declares `autoSubmitsInMulti`
+            // (the Next sentinel), so Enter on options is a no-cost way to flip checkboxes
+            // without leaving the keyboard home row.
+            if (!focusedMeta?.autoSubmitsInMulti)
+                return { kind: "toggle", index: state.optionIndex };
+            // Enter on Next: carry autoAdvanceTab so the host can advance to the next tab in
+            // multi-question mode, OR submit the dialog in single-question mode
+            // (autoAdvanceTab === undefined when !isMulti). Without this, a single multi-select
+            // question would have no way to commit at all.
+            return {
+                kind: "multi_confirm",
+                selected: buildMultiSelected(state, runtime),
+                autoAdvanceTab: computeAutoAdvanceTab(state, runtime),
+            };
+        }
+        if (kb.matches(data, KEYBIND_CANCEL))
+            return { kind: "cancel" };
+        return { kind: "ignore" };
+    }
+    if (kb.matches(data, KEYBIND_CONFIRM)) {
+        const answer = buildSingleSelectAnswer(state, runtime);
+        if (!answer)
+            return { kind: "ignore" };
+        return { kind: "confirm", answer, autoAdvanceTab: computeAutoAdvanceTab(state, runtime) };
+    }
+    if (kb.matches(data, KEYBIND_CANCEL))
+        return { kind: "cancel" };
+    return { kind: "ignore" };
+}
+//# sourceMappingURL=key-router.js.map

package/dist/core/tools/ask-user-question/state/key-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-router.js","sourceRoot":"","sources":["../../../../../src/core/tools/ask-user-question/state/key-router.ts"],"names":[],"mappings":"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","sourcesContent":["import { Key, matchesKey } from \"@earendil-works/pi-tui\";\nimport type { QuestionAnswer } from \"../tool/types.js\";\nimport { ROW_INTENT_META } from \"./row-intent.js\";\nimport type { QuestionnaireRuntime, QuestionnaireState } from \"./state.js\";\n\nconst KEYBIND_UP = \"tui.select.up\";\nconst KEYBIND_DOWN = \"tui.select.down\";\nconst KEYBIND_CONFIRM = \"tui.select.confirm\";\nconst KEYBIND_CANCEL = \"tui.select.cancel\";\n\nconst NOTES_ACTIVATE_KEY = \"n\";\nconst SPACE_KEY = \" \";\n\nexport type QuestionnaireAction =\n\t| { kind: \"nav\"; nextIndex: number }\n\t| { kind: \"tab_switch\"; nextTab: number }\n\t| { kind: \"confirm\"; answer: QuestionAnswer; autoAdvanceTab?: number }\n\t| { kind: \"toggle\"; index: number }\n\t| { kind: \"multi_confirm\"; selected: string[]; autoAdvanceTab?: number }\n\t| { kind: \"cancel\" }\n\t| { kind: \"notes_enter\" }\n\t| { kind: \"notes_exit\" }\n\t| { kind: \"submit\" }\n\t| { kind: \"submit_nav\"; nextIndex: 0 | 1 }\n\t| { kind: \"focus_chat\" }\n\t/**\n\t * Carries the target index so UP/DOWN form a continuous cycle through\n\t * `[chat, option0, …, optionLast]`.\n\t */\n\t| { kind: \"focus_options\"; optionIndex: number }\n\t| { kind: \"notes_forward\"; data: string }\n\t| { kind: \"ignore\" };\n\nexport interface QuestionnaireKeybindings {\n\tmatches(data: string, name: string): boolean;\n}\n\nexport function wrapTab(index: number, total: number): number {\n\tif (total <= 0) return 0;\n\treturn ((index % total) + total) % total;\n}\n\nexport function allAnswered(state: QuestionnaireState, runtime: QuestionnaireRuntime): boolean {\n\tif (runtime.questions.length === 0) return false;\n\tfor (let i = 0; i < runtime.questions.length; i++) {\n\t\tif (!state.answers.has(i)) return false;\n\t}\n\treturn true;\n}\n\nfunction totalTabs(runtime: QuestionnaireRuntime): number {\n\treturn runtime.isMulti ? runtime.questions.length + 1 : 1;\n}\n\nfunction computeAutoAdvanceTab(state: QuestionnaireState, runtime: QuestionnaireRuntime): number | undefined {\n\tif (!runtime.isMulti) return undefined;\n\tif (state.currentTab < runtime.questions.length - 1) return state.currentTab + 1;\n\treturn runtime.questions.length;\n}\n\nfunction buildSingleSelectAnswer(state: QuestionnaireState, runtime: QuestionnaireRuntime): QuestionAnswer | null {\n\tconst q = runtime.questions[state.currentTab];\n\tif (!q) return null;\n\n\t// Chat sentinel takes priority over inputMode: when chatFocused=true, the host overrides\n\t// currentItem() to return the chat sentinel even if inputMode is still true (e.g. user\n\t// navigated from \"Type something.\" and DOWN focused the chat row).\n\tconst item = runtime.currentItem;\n\tif (item?.kind === \"chat\") {\n\t\treturn {\n\t\t\tquestionIndex: state.currentTab,\n\t\t\tquestion: q.question,\n\t\t\tkind: \"chat\",\n\t\t\tanswer: item.label,\n\t\t};\n\t}\n\n\tif (state.inputMode) {\n\t\tconst label = runtime.inputBuffer;\n\t\treturn {\n\t\t\tquestionIndex: state.currentTab,\n\t\t\tquestion: q.question,\n\t\t\tkind: \"custom\",\n\t\t\tanswer: label.length > 0 ? label : null,\n\t\t};\n\t}\n\tif (!item) return null;\n\tif (item.kind === \"other\") {\n\t\treturn null;\n\t}\n\tif (item.kind === \"next\") {\n\t\treturn null;\n\t}\n\treturn {\n\t\tquestionIndex: state.currentTab,\n\t\tquestion: q.question,\n\t\tkind: \"option\",\n\t\tanswer: item.label,\n\t};\n}\n\nfunction buildMultiSelected(state: QuestionnaireState, runtime: QuestionnaireRuntime): string[] {\n\tconst q = runtime.questions[state.currentTab];\n\tif (!q) return [];\n\tconst out: string[] = [];\n\tfor (let i = 0; i < q.options.length; i++) {\n\t\tif (state.multiSelectChecked.has(i)) {\n\t\t\tconst label = q.options[i]?.label;\n\t\t\tif (typeof label === \"string\") out.push(label);\n\t\t}\n\t}\n\treturn out;\n}\n\nfunction tabSwitchAction(\n\tdata: string,\n\tstate: QuestionnaireState,\n\truntime: QuestionnaireRuntime,\n): QuestionnaireAction | null {\n\tif (!runtime.isMulti) return null;\n\tconst total = totalTabs(runtime);\n\tif (matchesKey(data, Key.tab) || matchesKey(data, Key.right)) {\n\t\treturn { kind: \"tab_switch\", nextTab: wrapTab(state.currentTab + 1, total) };\n\t}\n\tif (matchesKey(data, Key.shift(\"tab\")) || matchesKey(data, Key.left)) {\n\t\treturn { kind: \"tab_switch\", nextTab: wrapTab(state.currentTab - 1, total) };\n\t}\n\treturn null;\n}\n\n// DOWN at the last item emits focus_chat so the cycle [chat, option0, …, optionLast] wraps.\nfunction nextNavOnDown(state: QuestionnaireState, runtime: QuestionnaireRuntime): QuestionnaireAction {\n\tif (runtime.items.length > 0 && state.optionIndex === runtime.items.length - 1) {\n\t\treturn { kind: \"focus_chat\" };\n\t}\n\treturn { kind: \"nav\", nextIndex: wrapTab(state.optionIndex + 1, Math.max(1, runtime.items.length)) };\n}\n\n// UP at the top item emits focus_chat (symmetric with nextNavOnDown).\nfunction prevNavOnUp(state: QuestionnaireState, runtime: QuestionnaireRuntime): QuestionnaireAction {\n\tif (runtime.items.length > 0 && state.optionIndex === 0) {\n\t\treturn { kind: \"focus_chat\" };\n\t}\n\treturn { kind: \"nav\", nextIndex: wrapTab(state.optionIndex - 1, Math.max(1, runtime.items.length)) };\n}\n\nexport function routeKey(data: string, state: QuestionnaireState, runtime: QuestionnaireRuntime): QuestionnaireAction {\n\tconst kb = runtime.keybindings;\n\n\tif (state.notesVisible) {\n\t\tif (kb.matches(data, KEYBIND_CANCEL)) return { kind: \"notes_exit\" };\n\t\tif (kb.matches(data, KEYBIND_CONFIRM)) return { kind: \"notes_exit\" };\n\t\treturn { kind: \"notes_forward\", data };\n\t}\n\n\tif (state.chatFocused) {\n\t\tif (kb.matches(data, KEYBIND_CANCEL)) return { kind: \"cancel\" };\n\t\tif (kb.matches(data, KEYBIND_CONFIRM)) {\n\t\t\tconst answer = buildSingleSelectAnswer(state, runtime);\n\t\t\tif (!answer) return { kind: \"ignore\" };\n\t\t\treturn { kind: \"confirm\", answer, autoAdvanceTab: computeAutoAdvanceTab(state, runtime) };\n\t\t}\n\t\t// Continuous cycle: UP from chat → bottom of options (last navigable row), DOWN from\n\t\t// chat → top of options (option 0). Symmetric with UP-at-top → focus_chat and\n\t\t// DOWN-at-bottom → focus_chat below; together they form one wrapping cycle through\n\t\t// `[chat, option0, …, optionLast]`.\n\t\tif (kb.matches(data, KEYBIND_UP)) {\n\t\t\tconst last = Math.max(0, runtime.items.length - 1);\n\t\t\treturn { kind: \"focus_options\", optionIndex: last };\n\t\t}\n\t\tif (kb.matches(data, KEYBIND_DOWN)) {\n\t\t\treturn { kind: \"focus_options\", optionIndex: 0 };\n\t\t}\n\t\tconst tab = tabSwitchAction(data, state, runtime);\n\t\tif (tab) return tab;\n\t\treturn { kind: \"ignore\" };\n\t}\n\n\tif (state.inputMode) {\n\t\tif (kb.matches(data, KEYBIND_CONFIRM)) {\n\t\t\tconst answer = buildSingleSelectAnswer(state, runtime);\n\t\t\tif (!answer) return { kind: \"ignore\" };\n\t\t\treturn { kind: \"confirm\", answer, autoAdvanceTab: computeAutoAdvanceTab(state, runtime) };\n\t\t}\n\t\tif (kb.matches(data, KEYBIND_CANCEL)) return { kind: \"cancel\" };\n\t\tif (kb.matches(data, KEYBIND_UP)) {\n\t\t\treturn prevNavOnUp(state, runtime);\n\t\t}\n\t\tif (kb.matches(data, KEYBIND_DOWN)) {\n\t\t\treturn nextNavOnDown(state, runtime);\n\t\t}\n\t\treturn { kind: \"ignore\" };\n\t}\n\n\tif (runtime.isMulti && state.currentTab === runtime.questions.length) {\n\t\tif (kb.matches(data, KEYBIND_CANCEL)) return { kind: \"cancel\" };\n\t\tconst tab = tabSwitchAction(data, state, runtime);\n\t\tif (tab) return tab;\n\t\tif (kb.matches(data, KEYBIND_UP) || kb.matches(data, KEYBIND_DOWN)) {\n\t\t\tconst delta = kb.matches(data, KEYBIND_DOWN) ? 1 : -1;\n\t\t\tconst next = wrapTab(state.submitChoiceIndex + delta, 2);\n\t\t\treturn { kind: \"submit_nav\", nextIndex: (next === 1 ? 1 : 0) as 0 | 1 };\n\t\t}\n\t\tif (kb.matches(data, KEYBIND_CONFIRM)) {\n\t\t\t// D1 (revised): Submit always submits; Cancel always cancels. The warning header\n\t\t\t// is informational only — `allAnswered(state)` no longer gates submission. Partial\n\t\t\t// answers flow through `orderedAnswers()` in the host.\n\t\t\treturn state.submitChoiceIndex === 1 ? { kind: \"cancel\" } : { kind: \"submit\" };\n\t\t}\n\t\treturn { kind: \"ignore\" };\n\t}\n\n\tconst tab = tabSwitchAction(data, state, runtime);\n\tif (tab) return tab;\n\n\tconst q = runtime.questions[state.currentTab];\n\tif (!q) return { kind: \"ignore\" };\n\n\tif (data === NOTES_ACTIVATE_KEY && !q.multiSelect && state.focusedOptionHasPreview) {\n\t\treturn { kind: \"notes_enter\" };\n\t}\n\n\tif (kb.matches(data, KEYBIND_UP)) {\n\t\treturn prevNavOnUp(state, runtime);\n\t}\n\tif (kb.matches(data, KEYBIND_DOWN)) {\n\t\treturn nextNavOnDown(state, runtime);\n\t}\n\n\tif (q.multiSelect) {\n\t\tconst focusedKind = runtime.currentItem?.kind;\n\t\tconst focusedMeta = focusedKind ? ROW_INTENT_META[focusedKind] : undefined;\n\t\t// Space toggles the focused row's checkbox. Suppressed on rows whose META declares\n\t\t// `blocksMultiToggle` (the Next sentinel) — Next is not a real option and has no\n\t\t// checked/unchecked state.\n\t\tif (data === SPACE_KEY) {\n\t\t\tif (focusedMeta?.blocksMultiToggle) return { kind: \"ignore\" };\n\t\t\treturn { kind: \"toggle\", index: state.optionIndex };\n\t\t}\n\t\tif (kb.matches(data, KEYBIND_CONFIRM)) {\n\t\t\t// Enter on a regular row toggles (matching Space) — committing the question is now\n\t\t\t// gated behind explicit focus on a row whose META declares `autoSubmitsInMulti`\n\t\t\t// (the Next sentinel), so Enter on options is a no-cost way to flip checkboxes\n\t\t\t// without leaving the keyboard home row.\n\t\t\tif (!focusedMeta?.autoSubmitsInMulti) return { kind: \"toggle\", index: state.optionIndex };\n\t\t\t// Enter on Next: carry autoAdvanceTab so the host can advance to the next tab in\n\t\t\t// multi-question mode, OR submit the dialog in single-question mode\n\t\t\t// (autoAdvanceTab === undefined when !isMulti). Without this, a single multi-select\n\t\t\t// question would have no way to commit at all.\n\t\t\treturn {\n\t\t\t\tkind: \"multi_confirm\",\n\t\t\t\tselected: buildMultiSelected(state, runtime),\n\t\t\t\tautoAdvanceTab: computeAutoAdvanceTab(state, runtime),\n\t\t\t};\n\t\t}\n\t\tif (kb.matches(data, KEYBIND_CANCEL)) return { kind: \"cancel\" };\n\t\treturn { kind: \"ignore\" };\n\t}\n\n\tif (kb.matches(data, KEYBIND_CONFIRM)) {\n\t\tconst answer = buildSingleSelectAnswer(state, runtime);\n\t\tif (!answer) return { kind: \"ignore\" };\n\t\treturn { kind: \"confirm\", answer, autoAdvanceTab: computeAutoAdvanceTab(state, runtime) };\n\t}\n\tif (kb.matches(data, KEYBIND_CANCEL)) return { kind: \"cancel\" };\n\treturn { kind: \"ignore\" };\n}\n"]}

package/dist/core/tools/ask-user-question/state/questionnaire-session.d.ts

@@ -0,0 +1,61 @@
+import type { Theme } from "../../../../modes/interactive/theme/theme.js";
+import type { QuestionnaireResult, QuestionParams } from "../tool/types.js";
+import type { WrappingSelectItem } from "../view/components/wrapping-select.js";
+export interface QuestionnaireSessionConfig {
+    tui: {
+        terminal: {
+            columns: number;
+        };
+        requestRender(): void;
+    };
+    theme: Theme;
+    params: QuestionParams;
+    itemsByTab: WrappingSelectItem[][];
+    done: (result: QuestionnaireResult) => void;
+}
+export interface QuestionnaireSessionComponent {
+    render(width: number): string[];
+    invalidate(): void;
+    handleInput(data: string): void;
+}
+/**
+ * Slim runtime: owns the canonical state cell, the input-buffer cell, the
+ * two-pass `notesVisible` dispatch loop, and the effect runner. State
+ * transitions go through the pure `reduce` reducer; UI fan-out goes through
+ * the `QuestionnairePropsAdapter` produced by `buildQuestionnaire`.
+ */
+export declare class QuestionnaireSession {
+    private state;
+    private readonly questions;
+    private readonly isMulti;
+    private readonly itemsByTab;
+    private readonly notesInput;
+    private readonly inlineInput;
+    private readonly viewAdapter;
+    private readonly tui;
+    private readonly done;
+    readonly component: QuestionnaireSessionComponent;
+    constructor(config: QuestionnaireSessionConfig);
+    dispatch(data: string): void;
+    private commit;
+    private mirrorNotesDraft;
+    private runEffect;
+    /**
+     * Per-keystroke `ignore` fast path: delegates to the headless `inlineInput`
+     * Input so bracketed-paste accumulator (`input.js:33-63`) and Kitty CSI-u
+     * decode (`input.js:155-163`) take effect. Cursor is NOT force-reset here —
+     * doing so would corrupt split-chunk pastes (a `\x05` byte mid-paste lands
+     * verbatim in `pasteBuffer` and survives `handlePaste`'s narrow strip).
+     * Cursor advances naturally via `insertCharacter` on typing/paste; cursor-
+     * movement keys (Left/Right/Home/End/word-jumps) are now functional, with
+     * the always-end visual cursor marker drawn independently by
+     * `WrappingSelect.renderInlineInputRow`. `viewAdapter.apply` is called
+     * directly without a reducer round-trip — preserves the D3 fast-path
+     * latency profile from Phase 11.
+     */
+    private handleIgnoreInline;
+    private runtime;
+    private applyContext;
+    private currentItem;
+}
+//# sourceMappingURL=questionnaire-session.d.ts.map

package/dist/core/tools/ask-user-question/state/questionnaire-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"questionnaire-session.d.ts","sourceRoot":"","sources":["../../../../../src/core/tools/ask-user-question/state/questionnaire-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,8CAA8C,CAAC;AAE1E,OAAO,KAAK,EAAgB,mBAAmB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC1F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAahF,MAAM,WAAW,0BAA0B;IAC1C,GAAG,EAAE;QAAE,QAAQ,EAAE;YAAE,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,aAAa,IAAI,IAAI,CAAA;KAAE,CAAC;IAC9D,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,cAAc,CAAC;IACvB,UAAU,EAAE,kBAAkB,EAAE,EAAE,CAAC;IACnC,IAAI,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAC;CAC5C;AAED,MAAM,WAAW,6BAA6B;IAC7C,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAChC,UAAU,IAAI,IAAI,CAAC;IACnB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAkBD;;;;;GAKG;AACH,qBAAa,oBAAoB;IAChC,OAAO,CAAC,KAAK,CAAsC;IAEnD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;IACpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyB;IAEpD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA4B;IAExD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAoC;IACxD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqC;IAE1D,QAAQ,CAAC,SAAS,EAAE,6BAA6B,CAAC;IAElD,YAAY,MAAM,EAAE,0BAA0B,EA8B7C;IAED,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAO3B;IAED,OAAO,CAAC,MAAM;IAQd,OAAO,CAAC,gBAAgB;IAKxB,OAAO,CAAC,SAAS;IAwBjB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,kBAAkB;IAM1B,OAAO,CAAC,OAAO;IAWf,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,WAAW;CAMnB","sourcesContent":["import type { Theme } from \"../../../../modes/interactive/theme/theme.js\";\nimport { getKeybindings, type Input } from \"@earendil-works/pi-tui\";\nimport type { QuestionData, QuestionnaireResult, QuestionParams } from \"../tool/types.js\";\nimport type { WrappingSelectItem } from \"../view/components/wrapping-select.js\";\nimport type { QuestionnairePropsAdapter } from \"../view/props-adapter.js\";\nimport { buildQuestionnaire } from \"./build-questionnaire.js\";\nimport { ROW_INTENT_META } from \"./row-intent.js\";\nimport { type QuestionnaireAction, routeKey } from \"./key-router.js\";\nimport { computeFocusedOptionHasPreview } from \"./selectors/derivations.js\";\nimport type { QuestionnaireRuntime, QuestionnaireState } from \"./state.js\";\nimport { type ApplyContext, type Effect, reduce } from \"./state-reducer.js\";\n\n// Module-level constant; reused for cursor-end mutations after setValue rehydration.\n// Ctrl-E → tui.editor.cursorLineEnd (public path; pi-tui keybindings.js:25-28).\nconst CURSOR_END = \"\\x05\";\n\nexport interface QuestionnaireSessionConfig {\n\ttui: { terminal: { columns: number }; requestRender(): void };\n\ttheme: Theme;\n\tparams: QuestionParams;\n\titemsByTab: WrappingSelectItem[][];\n\tdone: (result: QuestionnaireResult) => void;\n}\n\nexport interface QuestionnaireSessionComponent {\n\trender(width: number): string[];\n\tinvalidate(): void;\n\thandleInput(data: string): void;\n}\n\nfunction initialState(): QuestionnaireState {\n\treturn {\n\t\tcurrentTab: 0,\n\t\toptionIndex: 0,\n\t\tinputMode: false,\n\t\tnotesVisible: false,\n\t\tchatFocused: false,\n\t\tanswers: new Map(),\n\t\tmultiSelectChecked: new Set(),\n\t\tnotesByTab: new Map(),\n\t\tfocusedOptionHasPreview: false,\n\t\tsubmitChoiceIndex: 0,\n\t\tnotesDraft: \"\",\n\t};\n}\n\n/**\n * Slim runtime: owns the canonical state cell, the input-buffer cell, the\n * two-pass `notesVisible` dispatch loop, and the effect runner. State\n * transitions go through the pure `reduce` reducer; UI fan-out goes through\n * the `QuestionnairePropsAdapter` produced by `buildQuestionnaire`.\n */\nexport class QuestionnaireSession {\n\tprivate state: QuestionnaireState = initialState();\n\n\tprivate readonly questions: readonly QuestionData[];\n\tprivate readonly isMulti: boolean;\n\tprivate readonly itemsByTab: WrappingSelectItem[][];\n\n\tprivate readonly notesInput: Input;\n\tprivate readonly inlineInput: Input;\n\tprivate readonly viewAdapter: QuestionnairePropsAdapter;\n\n\tprivate readonly tui: QuestionnaireSessionConfig[\"tui\"];\n\tprivate readonly done: QuestionnaireSessionConfig[\"done\"];\n\n\treadonly component: QuestionnaireSessionComponent;\n\n\tconstructor(config: QuestionnaireSessionConfig) {\n\t\tthis.tui = config.tui;\n\t\tthis.done = config.done;\n\t\tthis.questions = config.params.questions;\n\t\tthis.isMulti = this.questions.length > 1;\n\t\tthis.itemsByTab = config.itemsByTab;\n\t\t// Seed from the focused option at start; the reducer keeps it in sync via withFocusedOptionHasPreview.\n\t\tthis.state = { ...this.state, focusedOptionHasPreview: computeFocusedOptionHasPreview(this.questions, 0, 0) };\n\n\t\tconst built = buildQuestionnaire({\n\t\t\ttui: this.tui,\n\t\t\ttheme: config.theme,\n\t\t\tquestions: this.questions,\n\t\t\titemsByTab: this.itemsByTab,\n\t\t\tisMulti: this.isMulti,\n\t\t\tinitialState: this.state,\n\t\t\tgetCurrentTab: () => this.state.currentTab,\n\t\t});\n\n\t\tthis.notesInput = built.notesInput;\n\t\tthis.inlineInput = built.inlineInput;\n\t\tthis.viewAdapter = built.adapter;\n\n\t\tthis.component = {\n\t\t\trender: built.render,\n\t\t\tinvalidate: built.invalidate,\n\t\t\thandleInput: (data) => this.dispatch(data),\n\t\t};\n\n\t\tthis.viewAdapter.apply(this.state);\n\t}\n\n\tdispatch(data: string): void {\n\t\tconst action = routeKey(data, this.state, this.runtime());\n\t\tif (action.kind === \"ignore\") {\n\t\t\tthis.handleIgnoreInline(data);\n\t\t\treturn;\n\t\t}\n\t\tthis.commit(action);\n\t}\n\n\tprivate commit(action: QuestionnaireAction): void {\n\t\tconst result = reduce(this.state, action, this.applyContext());\n\t\tthis.state = result.state;\n\t\tfor (const effect of result.effects) this.runEffect(effect);\n\t\tthis.state = this.mirrorNotesDraft(this.state);\n\t\tthis.viewAdapter.apply(this.state);\n\t}\n\n\tprivate mirrorNotesDraft(s: QuestionnaireState): QuestionnaireState {\n\t\tconst draft = this.notesInput.getValue();\n\t\treturn s.notesDraft === draft ? s : { ...s, notesDraft: draft };\n\t}\n\n\tprivate runEffect(effect: Effect): void {\n\t\tswitch (effect.kind) {\n\t\t\tcase \"set_input_buffer\":\n\t\t\t\tthis.inlineInput.setValue(effect.value);\n\t\t\t\tthis.inlineInput.handleInput(CURSOR_END);\n\t\t\t\treturn;\n\t\t\tcase \"clear_input_buffer\":\n\t\t\t\tthis.inlineInput.setValue(\"\");\n\t\t\t\treturn;\n\t\t\tcase \"set_notes_value\":\n\t\t\t\tthis.notesInput.setValue(effect.value);\n\t\t\t\treturn;\n\t\t\tcase \"set_notes_focused\":\n\t\t\t\tthis.notesInput.focused = effect.focused;\n\t\t\t\treturn;\n\t\t\tcase \"forward_notes_keystroke\":\n\t\t\t\tthis.notesInput.handleInput(effect.data);\n\t\t\t\treturn;\n\t\t\tcase \"done\":\n\t\t\t\tthis.done(effect.result);\n\t\t\t\treturn;\n\t\t}\n\t}\n\n\t/**\n\t * Per-keystroke `ignore` fast path: delegates to the headless `inlineInput`\n\t * Input so bracketed-paste accumulator (`input.js:33-63`) and Kitty CSI-u\n\t * decode (`input.js:155-163`) take effect. Cursor is NOT force-reset here —\n\t * doing so would corrupt split-chunk pastes (a `\\x05` byte mid-paste lands\n\t * verbatim in `pasteBuffer` and survives `handlePaste`'s narrow strip).\n\t * Cursor advances naturally via `insertCharacter` on typing/paste; cursor-\n\t * movement keys (Left/Right/Home/End/word-jumps) are now functional, with\n\t * the always-end visual cursor marker drawn independently by\n\t * `WrappingSelect.renderInlineInputRow`. `viewAdapter.apply` is called\n\t * directly without a reducer round-trip — preserves the D3 fast-path\n\t * latency profile from Phase 11.\n\t */\n\tprivate handleIgnoreInline(data: string): void {\n\t\tif (!this.state.inputMode) return;\n\t\tthis.inlineInput.handleInput(data);\n\t\tthis.viewAdapter.apply(this.state);\n\t}\n\n\tprivate runtime(): QuestionnaireRuntime {\n\t\treturn {\n\t\t\tkeybindings: getKeybindings(),\n\t\t\tinputBuffer: this.inlineInput.getValue(),\n\t\t\tquestions: this.questions,\n\t\t\tisMulti: this.isMulti,\n\t\t\tcurrentItem: this.currentItem(),\n\t\t\titems: this.itemsByTab[this.state.currentTab] ?? [],\n\t\t};\n\t}\n\n\tprivate applyContext(): ApplyContext {\n\t\treturn {\n\t\t\tquestions: this.questions,\n\t\t\titemsByTab: this.itemsByTab,\n\t\t};\n\t}\n\n\tprivate currentItem(): WrappingSelectItem | undefined {\n\t\tif (this.state.chatFocused) return { kind: \"chat\", label: ROW_INTENT_META.chat.label };\n\t\tconst arr = this.itemsByTab[this.state.currentTab] ?? [];\n\t\tif (this.state.optionIndex < arr.length) return arr[this.state.optionIndex];\n\t\treturn { kind: \"chat\", label: ROW_INTENT_META.chat.label };\n\t}\n}\n"]}

package/dist/core/tools/ask-user-question/state/questionnaire-session.js

@@ -0,0 +1,147 @@
+import { getKeybindings } from "@earendil-works/pi-tui";
+import { buildQuestionnaire } from "./build-questionnaire.js";
+import { ROW_INTENT_META } from "./row-intent.js";
+import { routeKey } from "./key-router.js";
+import { computeFocusedOptionHasPreview } from "./selectors/derivations.js";
+import { reduce } from "./state-reducer.js";
+// Module-level constant; reused for cursor-end mutations after setValue rehydration.
+// Ctrl-E → tui.editor.cursorLineEnd (public path; pi-tui keybindings.js:25-28).
+const CURSOR_END = "\x05";
+function initialState() {
+    return {
+        currentTab: 0,
+        optionIndex: 0,
+        inputMode: false,
+        notesVisible: false,
+        chatFocused: false,
+        answers: new Map(),
+        multiSelectChecked: new Set(),
+        notesByTab: new Map(),
+        focusedOptionHasPreview: false,
+        submitChoiceIndex: 0,
+        notesDraft: "",
+    };
+}
+/**
+ * Slim runtime: owns the canonical state cell, the input-buffer cell, the
+ * two-pass `notesVisible` dispatch loop, and the effect runner. State
+ * transitions go through the pure `reduce` reducer; UI fan-out goes through
+ * the `QuestionnairePropsAdapter` produced by `buildQuestionnaire`.
+ */
+export class QuestionnaireSession {
+    constructor(config) {
+        this.state = initialState();
+        this.tui = config.tui;
+        this.done = config.done;
+        this.questions = config.params.questions;
+        this.isMulti = this.questions.length > 1;
+        this.itemsByTab = config.itemsByTab;
+        // Seed from the focused option at start; the reducer keeps it in sync via withFocusedOptionHasPreview.
+        this.state = { ...this.state, focusedOptionHasPreview: computeFocusedOptionHasPreview(this.questions, 0, 0) };
+        const built = buildQuestionnaire({
+            tui: this.tui,
+            theme: config.theme,
+            questions: this.questions,
+            itemsByTab: this.itemsByTab,
+            isMulti: this.isMulti,
+            initialState: this.state,
+            getCurrentTab: () => this.state.currentTab,
+        });
+        this.notesInput = built.notesInput;
+        this.inlineInput = built.inlineInput;
+        this.viewAdapter = built.adapter;
+        this.component = {
+            render: built.render,
+            invalidate: built.invalidate,
+            handleInput: (data) => this.dispatch(data),
+        };
+        this.viewAdapter.apply(this.state);
+    }
+    dispatch(data) {
+        const action = routeKey(data, this.state, this.runtime());
+        if (action.kind === "ignore") {
+            this.handleIgnoreInline(data);
+            return;
+        }
+        this.commit(action);
+    }
+    commit(action) {
+        const result = reduce(this.state, action, this.applyContext());
+        this.state = result.state;
+        for (const effect of result.effects)
+            this.runEffect(effect);
+        this.state = this.mirrorNotesDraft(this.state);
+        this.viewAdapter.apply(this.state);
+    }
+    mirrorNotesDraft(s) {
+        const draft = this.notesInput.getValue();
+        return s.notesDraft === draft ? s : { ...s, notesDraft: draft };
+    }
+    runEffect(effect) {
+        switch (effect.kind) {
+            case "set_input_buffer":
+                this.inlineInput.setValue(effect.value);
+                this.inlineInput.handleInput(CURSOR_END);
+                return;
+            case "clear_input_buffer":
+                this.inlineInput.setValue("");
+                return;
+            case "set_notes_value":
+                this.notesInput.setValue(effect.value);
+                return;
+            case "set_notes_focused":
+                this.notesInput.focused = effect.focused;
+                return;
+            case "forward_notes_keystroke":
+                this.notesInput.handleInput(effect.data);
+                return;
+            case "done":
+                this.done(effect.result);
+                return;
+        }
+    }
+    /**
+     * Per-keystroke `ignore` fast path: delegates to the headless `inlineInput`
+     * Input so bracketed-paste accumulator (`input.js:33-63`) and Kitty CSI-u
+     * decode (`input.js:155-163`) take effect. Cursor is NOT force-reset here —
+     * doing so would corrupt split-chunk pastes (a `\x05` byte mid-paste lands
+     * verbatim in `pasteBuffer` and survives `handlePaste`'s narrow strip).
+     * Cursor advances naturally via `insertCharacter` on typing/paste; cursor-
+     * movement keys (Left/Right/Home/End/word-jumps) are now functional, with
+     * the always-end visual cursor marker drawn independently by
+     * `WrappingSelect.renderInlineInputRow`. `viewAdapter.apply` is called
+     * directly without a reducer round-trip — preserves the D3 fast-path
+     * latency profile from Phase 11.
+     */
+    handleIgnoreInline(data) {
+        if (!this.state.inputMode)
+            return;
+        this.inlineInput.handleInput(data);
+        this.viewAdapter.apply(this.state);
+    }
+    runtime() {
+        return {
+            keybindings: getKeybindings(),
+            inputBuffer: this.inlineInput.getValue(),
+            questions: this.questions,
+            isMulti: this.isMulti,
+            currentItem: this.currentItem(),
+            items: this.itemsByTab[this.state.currentTab] ?? [],
+        };
+    }
+    applyContext() {
+        return {
+            questions: this.questions,
+            itemsByTab: this.itemsByTab,
+        };
+    }
+    currentItem() {
+        if (this.state.chatFocused)
+            return { kind: "chat", label: ROW_INTENT_META.chat.label };
+        const arr = this.itemsByTab[this.state.currentTab] ?? [];
+        if (this.state.optionIndex < arr.length)
+            return arr[this.state.optionIndex];
+        return { kind: "chat", label: ROW_INTENT_META.chat.label };
+    }
+}
+//# sourceMappingURL=questionnaire-session.js.map

package/dist/core/tools/ask-user-question/state/questionnaire-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"questionnaire-session.js","sourceRoot":"","sources":["../../../../../src/core/tools/ask-user-question/state/questionnaire-session.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Theme } from \"../../../../modes/interactive/theme/theme.js\";\nimport { getKeybindings, type Input } from \"@earendil-works/pi-tui\";\nimport type { QuestionData, QuestionnaireResult, QuestionParams } from \"../tool/types.js\";\nimport type { WrappingSelectItem } from \"../view/components/wrapping-select.js\";\nimport type { QuestionnairePropsAdapter } from \"../view/props-adapter.js\";\nimport { buildQuestionnaire } from \"./build-questionnaire.js\";\nimport { ROW_INTENT_META } from \"./row-intent.js\";\nimport { type QuestionnaireAction, routeKey } from \"./key-router.js\";\nimport { computeFocusedOptionHasPreview } from \"./selectors/derivations.js\";\nimport type { QuestionnaireRuntime, QuestionnaireState } from \"./state.js\";\nimport { type ApplyContext, type Effect, reduce } from \"./state-reducer.js\";\n\n// Module-level constant; reused for cursor-end mutations after setValue rehydration.\n// Ctrl-E → tui.editor.cursorLineEnd (public path; pi-tui keybindings.js:25-28).\nconst CURSOR_END = \"\\x05\";\n\nexport interface QuestionnaireSessionConfig {\n\ttui: { terminal: { columns: number }; requestRender(): void };\n\ttheme: Theme;\n\tparams: QuestionParams;\n\titemsByTab: WrappingSelectItem[][];\n\tdone: (result: QuestionnaireResult) => void;\n}\n\nexport interface QuestionnaireSessionComponent {\n\trender(width: number): string[];\n\tinvalidate(): void;\n\thandleInput(data: string): void;\n}\n\nfunction initialState(): QuestionnaireState {\n\treturn {\n\t\tcurrentTab: 0,\n\t\toptionIndex: 0,\n\t\tinputMode: false,\n\t\tnotesVisible: false,\n\t\tchatFocused: false,\n\t\tanswers: new Map(),\n\t\tmultiSelectChecked: new Set(),\n\t\tnotesByTab: new Map(),\n\t\tfocusedOptionHasPreview: false,\n\t\tsubmitChoiceIndex: 0,\n\t\tnotesDraft: \"\",\n\t};\n}\n\n/**\n * Slim runtime: owns the canonical state cell, the input-buffer cell, the\n * two-pass `notesVisible` dispatch loop, and the effect runner. State\n * transitions go through the pure `reduce` reducer; UI fan-out goes through\n * the `QuestionnairePropsAdapter` produced by `buildQuestionnaire`.\n */\nexport class QuestionnaireSession {\n\tprivate state: QuestionnaireState = initialState();\n\n\tprivate readonly questions: readonly QuestionData[];\n\tprivate readonly isMulti: boolean;\n\tprivate readonly itemsByTab: WrappingSelectItem[][];\n\n\tprivate readonly notesInput: Input;\n\tprivate readonly inlineInput: Input;\n\tprivate readonly viewAdapter: QuestionnairePropsAdapter;\n\n\tprivate readonly tui: QuestionnaireSessionConfig[\"tui\"];\n\tprivate readonly done: QuestionnaireSessionConfig[\"done\"];\n\n\treadonly component: QuestionnaireSessionComponent;\n\n\tconstructor(config: QuestionnaireSessionConfig) {\n\t\tthis.tui = config.tui;\n\t\tthis.done = config.done;\n\t\tthis.questions = config.params.questions;\n\t\tthis.isMulti = this.questions.length > 1;\n\t\tthis.itemsByTab = config.itemsByTab;\n\t\t// Seed from the focused option at start; the reducer keeps it in sync via withFocusedOptionHasPreview.\n\t\tthis.state = { ...this.state, focusedOptionHasPreview: computeFocusedOptionHasPreview(this.questions, 0, 0) };\n\n\t\tconst built = buildQuestionnaire({\n\t\t\ttui: this.tui,\n\t\t\ttheme: config.theme,\n\t\t\tquestions: this.questions,\n\t\t\titemsByTab: this.itemsByTab,\n\t\t\tisMulti: this.isMulti,\n\t\t\tinitialState: this.state,\n\t\t\tgetCurrentTab: () => this.state.currentTab,\n\t\t});\n\n\t\tthis.notesInput = built.notesInput;\n\t\tthis.inlineInput = built.inlineInput;\n\t\tthis.viewAdapter = built.adapter;\n\n\t\tthis.component = {\n\t\t\trender: built.render,\n\t\t\tinvalidate: built.invalidate,\n\t\t\thandleInput: (data) => this.dispatch(data),\n\t\t};\n\n\t\tthis.viewAdapter.apply(this.state);\n\t}\n\n\tdispatch(data: string): void {\n\t\tconst action = routeKey(data, this.state, this.runtime());\n\t\tif (action.kind === \"ignore\") {\n\t\t\tthis.handleIgnoreInline(data);\n\t\t\treturn;\n\t\t}\n\t\tthis.commit(action);\n\t}\n\n\tprivate commit(action: QuestionnaireAction): void {\n\t\tconst result = reduce(this.state, action, this.applyContext());\n\t\tthis.state = result.state;\n\t\tfor (const effect of result.effects) this.runEffect(effect);\n\t\tthis.state = this.mirrorNotesDraft(this.state);\n\t\tthis.viewAdapter.apply(this.state);\n\t}\n\n\tprivate mirrorNotesDraft(s: QuestionnaireState): QuestionnaireState {\n\t\tconst draft = this.notesInput.getValue();\n\t\treturn s.notesDraft === draft ? s : { ...s, notesDraft: draft };\n\t}\n\n\tprivate runEffect(effect: Effect): void {\n\t\tswitch (effect.kind) {\n\t\t\tcase \"set_input_buffer\":\n\t\t\t\tthis.inlineInput.setValue(effect.value);\n\t\t\t\tthis.inlineInput.handleInput(CURSOR_END);\n\t\t\t\treturn;\n\t\t\tcase \"clear_input_buffer\":\n\t\t\t\tthis.inlineInput.setValue(\"\");\n\t\t\t\treturn;\n\t\t\tcase \"set_notes_value\":\n\t\t\t\tthis.notesInput.setValue(effect.value);\n\t\t\t\treturn;\n\t\t\tcase \"set_notes_focused\":\n\t\t\t\tthis.notesInput.focused = effect.focused;\n\t\t\t\treturn;\n\t\t\tcase \"forward_notes_keystroke\":\n\t\t\t\tthis.notesInput.handleInput(effect.data);\n\t\t\t\treturn;\n\t\t\tcase \"done\":\n\t\t\t\tthis.done(effect.result);\n\t\t\t\treturn;\n\t\t}\n\t}\n\n\t/**\n\t * Per-keystroke `ignore` fast path: delegates to the headless `inlineInput`\n\t * Input so bracketed-paste accumulator (`input.js:33-63`) and Kitty CSI-u\n\t * decode (`input.js:155-163`) take effect. Cursor is NOT force-reset here —\n\t * doing so would corrupt split-chunk pastes (a `\\x05` byte mid-paste lands\n\t * verbatim in `pasteBuffer` and survives `handlePaste`'s narrow strip).\n\t * Cursor advances naturally via `insertCharacter` on typing/paste; cursor-\n\t * movement keys (Left/Right/Home/End/word-jumps) are now functional, with\n\t * the always-end visual cursor marker drawn independently by\n\t * `WrappingSelect.renderInlineInputRow`. `viewAdapter.apply` is called\n\t * directly without a reducer round-trip — preserves the D3 fast-path\n\t * latency profile from Phase 11.\n\t */\n\tprivate handleIgnoreInline(data: string): void {\n\t\tif (!this.state.inputMode) return;\n\t\tthis.inlineInput.handleInput(data);\n\t\tthis.viewAdapter.apply(this.state);\n\t}\n\n\tprivate runtime(): QuestionnaireRuntime {\n\t\treturn {\n\t\t\tkeybindings: getKeybindings(),\n\t\t\tinputBuffer: this.inlineInput.getValue(),\n\t\t\tquestions: this.questions,\n\t\t\tisMulti: this.isMulti,\n\t\t\tcurrentItem: this.currentItem(),\n\t\t\titems: this.itemsByTab[this.state.currentTab] ?? [],\n\t\t};\n\t}\n\n\tprivate applyContext(): ApplyContext {\n\t\treturn {\n\t\t\tquestions: this.questions,\n\t\t\titemsByTab: this.itemsByTab,\n\t\t};\n\t}\n\n\tprivate currentItem(): WrappingSelectItem | undefined {\n\t\tif (this.state.chatFocused) return { kind: \"chat\", label: ROW_INTENT_META.chat.label };\n\t\tconst arr = this.itemsByTab[this.state.currentTab] ?? [];\n\t\tif (this.state.optionIndex < arr.length) return arr[this.state.optionIndex];\n\t\treturn { kind: \"chat\", label: ROW_INTENT_META.chat.label };\n\t}\n}\n"]}

package/dist/core/tools/ask-user-question/state/row-intent.d.ts

@@ -0,0 +1,91 @@
+import type { QuestionData } from "../tool/types.js";
+import type { WrappingSelectItem } from "../view/components/wrapping-select.js";
+/**
+ * Row kind discriminator. Single source of truth — derived from the runtime
+ * `WrappingSelectItem` union (`wrapping-select.ts:18-22`) so adding a new
+ * variant there forces a `ROW_INTENT_META` entry here (compile-time
+ * exhaustiveness via `Record<RowKind, …>`).
+ */
+export type RowKind = WrappingSelectItem["kind"];
+/**
+ * Sentinel kinds — the subset of `RowKind` representing protocol-driven rows
+ * (vs author-defined `option` rows). The auto-append walker, the reserved-label
+ * derivation, and `LABELS_BY_KIND` consumers iterate this list.
+ */
+export type SentinelKind = Exclude<RowKind, "option">;
+export declare const SENTINEL_KINDS: readonly SentinelKind[];
+/**
+ * Per-kind static metadata. Pure data — no closures, no per-kind handler
+ * functions. Behavior-bearing branches (answer construction in
+ * `key-router.ts:69-99`, the Next-row render block in `multi-select-view.ts`,
+ * and the inline-Input render branch in `wrapping-select.ts`) keep their
+ * exhaustive switches and READ flags from this table.
+ *
+ * Adding a new sentinel:
+ *   1. Add the variant to `WrappingSelectItem` (`wrapping-select.ts:18-22`).
+ *   2. Add an entry here. Compile fails until both edits are present.
+ *   3. (If user-facing) author wherever the row is synthesized — typically
+ *      `buildItemsForQuestion` for main-list residents, or the `chatList`
+ *      construction site for non-main-list rows.
+ *
+ * Field semantics:
+ * - `label` — user-facing string. For `option` it's an empty placeholder
+ *   (per-instance labels come from `QuestionData.options[i].label`); every
+ *   sentinel uses its META entry as the single source of truth.
+ * - `reserved` — author-facing labels matching this string trigger
+ *   `reserved_label` at validation time. `RESERVED_LABEL_SET` is derived.
+ * - `livesInMainList` — true iff the row appears in `itemsByTab[i]`. Chat
+ *   lives in its own `chatList` (`questionnaire-session.ts:95`) so its row
+ *   never enters the main list.
+ * - `numbered` — true iff the row contributes to the main-list numbering
+ *   offset that `chatNumberingFor` reads. Multi-select Next is the only
+ *   numberable=false row that lives in the list; chat is numbered=true but
+ *   `livesInMainList=false` so the flag is moot for chat.
+ * - `activatesInputMode` — true iff focusing the row should toggle
+ *   `state.inputMode = true`. Read by `state-reducer.ts` `nav` /
+ *   `focus_options` cases.
+ * - `blocksMultiToggle` — in multiSelect mode, Space (and Enter-as-toggle)
+ *   on this row is suppressed. The Next sentinel is the only true.
+ * - `autoSubmitsInMulti` — in multiSelect mode, Enter on this row commits
+ *   the question (emits `multi_confirm`). The Next sentinel is the only true.
+ * - `autoAppendOnSingleSelectNoPreview` — `buildItemsForQuestion` appends
+ *   this row when the question is single-select AND no option carries a
+ *   `preview`. The "other" sentinel is the only true.
+ * - `autoAppendOnMultiSelect` — `buildItemsForQuestion` appends this row
+ *   when the question is multi-select. The Next sentinel is the only true.
+ */
+export interface RowIntentMeta {
+    label: string;
+    reserved: boolean;
+    livesInMainList: boolean;
+    numbered: boolean;
+    activatesInputMode: boolean;
+    blocksMultiToggle: boolean;
+    autoSubmitsInMulti: boolean;
+    autoAppendOnSingleSelectNoPreview: boolean;
+    autoAppendOnMultiSelect: boolean;
+}
+export declare const ROW_INTENT_META: Record<RowKind, RowIntentMeta>;
+/**
+ * Kind-keyed label view. `option` is excluded — its label is per-instance,
+ * not per-kind. `types.ts#SENTINEL_LABELS` re-sources from here.
+ */
+export declare const LABELS_BY_KIND: {
+    readonly [K in SentinelKind]: string;
+};
+/**
+ * Reserved-label set for runtime validation. Includes "Other" (a model-conditioned
+ * label that has no runtime kind) plus every sentinel with `reserved: true`.
+ */
+export declare const RESERVED_LABEL_SET: ReadonlySet<string>;
+/**
+ * Walk the META table to synthesize sentinel rows for one question. The two
+ * append predicates are mutually exclusive in practice (`multiSelect` vs
+ * `!multiSelect && !hasAnyPreview`) but the walker doesn't enforce that —
+ * adding a third bucket only requires a new META flag.
+ *
+ * Returns sentinel descriptors in declaration order of `SENTINEL_KINDS`. The
+ * caller wraps each with the `WrappingSelectItem` shape (kind + label).
+ */
+export declare function sentinelsToAppend(question: QuestionData, hasAnyPreview: boolean): SentinelKind[];
+//# sourceMappingURL=row-intent.d.ts.map

package/dist/core/tools/ask-user-question/state/row-intent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"row-intent.d.ts","sourceRoot":"","sources":["../../../../../src/core/tools/ask-user-question/state/row-intent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAEhF;;;;;GAKG;AACH,MAAM,MAAM,OAAO,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAEjD;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AACtD,eAAO,MAAM,cAAc,EAAE,SAAS,YAAY,EAA8B,CAAC;AAEjF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,WAAW,aAAa;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,eAAe,EAAE,OAAO,CAAC;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iCAAiC,EAAE,OAAO,CAAC;IAC3C,uBAAuB,EAAE,OAAO,CAAC;CACjC;AAED,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,OAAO,EAAE,aAAa,CA6C1D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE;IAAE,QAAQ,EAAE,CAAC,IAAI,YAAY,GAAG,MAAM;CAIlE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAGjD,CAAC;AAEH;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,OAAO,GAAG,YAAY,EAAE,CAYhG","sourcesContent":["import type { QuestionData } from \"../tool/types.js\";\nimport type { WrappingSelectItem } from \"../view/components/wrapping-select.js\";\n\n/**\n * Row kind discriminator. Single source of truth — derived from the runtime\n * `WrappingSelectItem` union (`wrapping-select.ts:18-22`) so adding a new\n * variant there forces a `ROW_INTENT_META` entry here (compile-time\n * exhaustiveness via `Record<RowKind, …>`).\n */\nexport type RowKind = WrappingSelectItem[\"kind\"];\n\n/**\n * Sentinel kinds — the subset of `RowKind` representing protocol-driven rows\n * (vs author-defined `option` rows). The auto-append walker, the reserved-label\n * derivation, and `LABELS_BY_KIND` consumers iterate this list.\n */\nexport type SentinelKind = Exclude<RowKind, \"option\">;\nexport const SENTINEL_KINDS: readonly SentinelKind[] = [\"other\", \"chat\", \"next\"];\n\n/**\n * Per-kind static metadata. Pure data — no closures, no per-kind handler\n * functions. Behavior-bearing branches (answer construction in\n * `key-router.ts:69-99`, the Next-row render block in `multi-select-view.ts`,\n * and the inline-Input render branch in `wrapping-select.ts`) keep their\n * exhaustive switches and READ flags from this table.\n *\n * Adding a new sentinel:\n *   1. Add the variant to `WrappingSelectItem` (`wrapping-select.ts:18-22`).\n *   2. Add an entry here. Compile fails until both edits are present.\n *   3. (If user-facing) author wherever the row is synthesized — typically\n *      `buildItemsForQuestion` for main-list residents, or the `chatList`\n *      construction site for non-main-list rows.\n *\n * Field semantics:\n * - `label` — user-facing string. For `option` it's an empty placeholder\n *   (per-instance labels come from `QuestionData.options[i].label`); every\n *   sentinel uses its META entry as the single source of truth.\n * - `reserved` — author-facing labels matching this string trigger\n *   `reserved_label` at validation time. `RESERVED_LABEL_SET` is derived.\n * - `livesInMainList` — true iff the row appears in `itemsByTab[i]`. Chat\n *   lives in its own `chatList` (`questionnaire-session.ts:95`) so its row\n *   never enters the main list.\n * - `numbered` — true iff the row contributes to the main-list numbering\n *   offset that `chatNumberingFor` reads. Multi-select Next is the only\n *   numberable=false row that lives in the list; chat is numbered=true but\n *   `livesInMainList=false` so the flag is moot for chat.\n * - `activatesInputMode` — true iff focusing the row should toggle\n *   `state.inputMode = true`. Read by `state-reducer.ts` `nav` /\n *   `focus_options` cases.\n * - `blocksMultiToggle` — in multiSelect mode, Space (and Enter-as-toggle)\n *   on this row is suppressed. The Next sentinel is the only true.\n * - `autoSubmitsInMulti` — in multiSelect mode, Enter on this row commits\n *   the question (emits `multi_confirm`). The Next sentinel is the only true.\n * - `autoAppendOnSingleSelectNoPreview` — `buildItemsForQuestion` appends\n *   this row when the question is single-select AND no option carries a\n *   `preview`. The \"other\" sentinel is the only true.\n * - `autoAppendOnMultiSelect` — `buildItemsForQuestion` appends this row\n *   when the question is multi-select. The Next sentinel is the only true.\n */\nexport interface RowIntentMeta {\n\tlabel: string;\n\treserved: boolean;\n\tlivesInMainList: boolean;\n\tnumbered: boolean;\n\tactivatesInputMode: boolean;\n\tblocksMultiToggle: boolean;\n\tautoSubmitsInMulti: boolean;\n\tautoAppendOnSingleSelectNoPreview: boolean;\n\tautoAppendOnMultiSelect: boolean;\n}\n\nexport const ROW_INTENT_META: Record<RowKind, RowIntentMeta> = {\n\toption: {\n\t\tlabel: \"\",\n\t\treserved: false,\n\t\tlivesInMainList: true,\n\t\tnumbered: true,\n\t\tactivatesInputMode: false,\n\t\tblocksMultiToggle: false,\n\t\tautoSubmitsInMulti: false,\n\t\tautoAppendOnSingleSelectNoPreview: false,\n\t\tautoAppendOnMultiSelect: false,\n\t},\n\tother: {\n\t\tlabel: \"Type something.\",\n\t\treserved: true,\n\t\tlivesInMainList: true,\n\t\tnumbered: true,\n\t\tactivatesInputMode: true,\n\t\tblocksMultiToggle: false,\n\t\tautoSubmitsInMulti: false,\n\t\tautoAppendOnSingleSelectNoPreview: true,\n\t\tautoAppendOnMultiSelect: false,\n\t},\n\tchat: {\n\t\tlabel: \"Chat about this\",\n\t\treserved: true,\n\t\tlivesInMainList: false,\n\t\tnumbered: true,\n\t\tactivatesInputMode: false,\n\t\tblocksMultiToggle: false,\n\t\tautoSubmitsInMulti: false,\n\t\tautoAppendOnSingleSelectNoPreview: false,\n\t\tautoAppendOnMultiSelect: false,\n\t},\n\tnext: {\n\t\tlabel: \"Next\",\n\t\treserved: true,\n\t\tlivesInMainList: true,\n\t\tnumbered: false,\n\t\tactivatesInputMode: false,\n\t\tblocksMultiToggle: true,\n\t\tautoSubmitsInMulti: true,\n\t\tautoAppendOnSingleSelectNoPreview: false,\n\t\tautoAppendOnMultiSelect: true,\n\t},\n};\n\n/**\n * Kind-keyed label view. `option` is excluded — its label is per-instance,\n * not per-kind. `types.ts#SENTINEL_LABELS` re-sources from here.\n */\nexport const LABELS_BY_KIND: { readonly [K in SentinelKind]: string } = {\n\tother: ROW_INTENT_META.other.label,\n\tchat: ROW_INTENT_META.chat.label,\n\tnext: ROW_INTENT_META.next.label,\n};\n\n/**\n * Reserved-label set for runtime validation. Includes \"Other\" (a model-conditioned\n * label that has no runtime kind) plus every sentinel with `reserved: true`.\n */\nexport const RESERVED_LABEL_SET: ReadonlySet<string> = new Set<string>([\n\t\"Other\",\n\t...SENTINEL_KINDS.filter((k) => ROW_INTENT_META[k].reserved).map((k) => ROW_INTENT_META[k].label),\n]);\n\n/**\n * Walk the META table to synthesize sentinel rows for one question. The two\n * append predicates are mutually exclusive in practice (`multiSelect` vs\n * `!multiSelect && !hasAnyPreview`) but the walker doesn't enforce that —\n * adding a third bucket only requires a new META flag.\n *\n * Returns sentinel descriptors in declaration order of `SENTINEL_KINDS`. The\n * caller wraps each with the `WrappingSelectItem` shape (kind + label).\n */\nexport function sentinelsToAppend(question: QuestionData, hasAnyPreview: boolean): SentinelKind[] {\n\tconst out: SentinelKind[] = [];\n\tfor (const k of SENTINEL_KINDS) {\n\t\tconst meta = ROW_INTENT_META[k];\n\t\tif (!meta.livesInMainList) continue;\n\t\tif (question.multiSelect === true) {\n\t\t\tif (meta.autoAppendOnMultiSelect) out.push(k);\n\t\t} else {\n\t\t\tif (meta.autoAppendOnSingleSelectNoPreview && !hasAnyPreview) out.push(k);\n\t\t}\n\t}\n\treturn out;\n}\n"]}