@bastani/atomic 0.7.17-1 → 0.8.0-0

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

@@ -0,0 +1,91 @@
+export const SENTINEL_KINDS = ["other", "chat", "next"];
+export const ROW_INTENT_META = {
+    option: {
+        label: "",
+        reserved: false,
+        livesInMainList: true,
+        numbered: true,
+        activatesInputMode: false,
+        blocksMultiToggle: false,
+        autoSubmitsInMulti: false,
+        autoAppendOnSingleSelectNoPreview: false,
+        autoAppendOnMultiSelect: false,
+    },
+    other: {
+        label: "Type something.",
+        reserved: true,
+        livesInMainList: true,
+        numbered: true,
+        activatesInputMode: true,
+        blocksMultiToggle: false,
+        autoSubmitsInMulti: false,
+        autoAppendOnSingleSelectNoPreview: true,
+        autoAppendOnMultiSelect: false,
+    },
+    chat: {
+        label: "Chat about this",
+        reserved: true,
+        livesInMainList: false,
+        numbered: true,
+        activatesInputMode: false,
+        blocksMultiToggle: false,
+        autoSubmitsInMulti: false,
+        autoAppendOnSingleSelectNoPreview: false,
+        autoAppendOnMultiSelect: false,
+    },
+    next: {
+        label: "Next",
+        reserved: true,
+        livesInMainList: true,
+        numbered: false,
+        activatesInputMode: false,
+        blocksMultiToggle: true,
+        autoSubmitsInMulti: true,
+        autoAppendOnSingleSelectNoPreview: false,
+        autoAppendOnMultiSelect: true,
+    },
+};
+/**
+ * Kind-keyed label view. `option` is excluded — its label is per-instance,
+ * not per-kind. `types.ts#SENTINEL_LABELS` re-sources from here.
+ */
+export const LABELS_BY_KIND = {
+    other: ROW_INTENT_META.other.label,
+    chat: ROW_INTENT_META.chat.label,
+    next: ROW_INTENT_META.next.label,
+};
+/**
+ * Reserved-label set for runtime validation. Includes "Other" (a model-conditioned
+ * label that has no runtime kind) plus every sentinel with `reserved: true`.
+ */
+export const RESERVED_LABEL_SET = new Set([
+    "Other",
+    ...SENTINEL_KINDS.filter((k) => ROW_INTENT_META[k].reserved).map((k) => ROW_INTENT_META[k].label),
+]);
+/**
+ * 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 function sentinelsToAppend(question, hasAnyPreview) {
+    const out = [];
+    for (const k of SENTINEL_KINDS) {
+        const meta = ROW_INTENT_META[k];
+        if (!meta.livesInMainList)
+            continue;
+        if (question.multiSelect === true) {
+            if (meta.autoAppendOnMultiSelect)
+                out.push(k);
+        }
+        else {
+            if (meta.autoAppendOnSingleSelectNoPreview && !hasAnyPreview)
+                out.push(k);
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=row-intent.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"row-intent.js","sourceRoot":"","sources":["../../../../../src/core/tools/ask-user-question/state/row-intent.ts"],"names":[],"mappings":"AAiBA,MAAM,CAAC,MAAM,cAAc,GAA4B,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAsDjF,MAAM,CAAC,MAAM,eAAe,GAAmC;IAC9D,MAAM,EAAE;QACP,KAAK,EAAE,EAAE;QACT,QAAQ,EAAE,KAAK;QACf,eAAe,EAAE,IAAI;QACrB,QAAQ,EAAE,IAAI;QACd,kBAAkB,EAAE,KAAK;QACzB,iBAAiB,EAAE,KAAK;QACxB,kBAAkB,EAAE,KAAK;QACzB,iCAAiC,EAAE,KAAK;QACxC,uBAAuB,EAAE,KAAK;KAC9B;IACD,KAAK,EAAE;QACN,KAAK,EAAE,iBAAiB;QACxB,QAAQ,EAAE,IAAI;QACd,eAAe,EAAE,IAAI;QACrB,QAAQ,EAAE,IAAI;QACd,kBAAkB,EAAE,IAAI;QACxB,iBAAiB,EAAE,KAAK;QACxB,kBAAkB,EAAE,KAAK;QACzB,iCAAiC,EAAE,IAAI;QACvC,uBAAuB,EAAE,KAAK;KAC9B;IACD,IAAI,EAAE;QACL,KAAK,EAAE,iBAAiB;QACxB,QAAQ,EAAE,IAAI;QACd,eAAe,EAAE,KAAK;QACtB,QAAQ,EAAE,IAAI;QACd,kBAAkB,EAAE,KAAK;QACzB,iBAAiB,EAAE,KAAK;QACxB,kBAAkB,EAAE,KAAK;QACzB,iCAAiC,EAAE,KAAK;QACxC,uBAAuB,EAAE,KAAK;KAC9B;IACD,IAAI,EAAE;QACL,KAAK,EAAE,MAAM;QACb,QAAQ,EAAE,IAAI;QACd,eAAe,EAAE,IAAI;QACrB,QAAQ,EAAE,KAAK;QACf,kBAAkB,EAAE,KAAK;QACzB,iBAAiB,EAAE,IAAI;QACvB,kBAAkB,EAAE,IAAI;QACxB,iCAAiC,EAAE,KAAK;QACxC,uBAAuB,EAAE,IAAI;KAC7B;CACD,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAA6C;IACvE,KAAK,EAAE,eAAe,CAAC,KAAK,CAAC,KAAK;IAClC,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC,KAAK;IAChC,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC,KAAK;CAChC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAwB,IAAI,GAAG,CAAS;IACtE,OAAO;IACP,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;CACjG,CAAC,CAAC;AAEH;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAsB,EAAE,aAAsB;IAC/E,MAAM,GAAG,GAAmB,EAAE,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,cAAc,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI,CAAC,eAAe;YAAE,SAAS;QACpC,IAAI,QAAQ,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;YACnC,IAAI,IAAI,CAAC,uBAAuB;gBAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC/C,CAAC;aAAM,CAAC;YACP,IAAI,IAAI,CAAC,iCAAiC,IAAI,CAAC,aAAa;gBAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3E,CAAC;IACF,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC","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"]}

package/dist/core/tools/ask-user-question/state/selectors/contract.d.ts

@@ -0,0 +1,21 @@
+import type { QuestionData } from "../../tool/types.js";
+import type { PreviewPaneProps } from "../../view/components/preview/preview-pane.js";
+import type { WrappingSelectItem } from "../../view/components/wrapping-select.js";
+import type { ActiveView, StatefulView } from "../../view/stateful-view.js";
+import type { TabComponents } from "../../view/tab-components.js";
+import type { QuestionnaireState } from "../state.js";
+export interface BindingContext {
+    readonly questions: readonly QuestionData[];
+    readonly itemsByTab: ReadonlyArray<readonly WrappingSelectItem[]>;
+    readonly totalQuestions: number;
+    readonly activeView: ActiveView;
+    readonly inputBuffer: string;
+    readonly activePreviewPane: StatefulView<PreviewPaneProps>;
+}
+export interface PerTabBindingContext extends BindingContext {
+    readonly tab: TabComponents;
+    readonly i: number;
+}
+export type GlobalSelector<P> = (state: QuestionnaireState, ctx: BindingContext) => P;
+export type PerTabSelector<P> = (state: QuestionnaireState, ctx: PerTabBindingContext) => P;
+//# sourceMappingURL=contract.d.ts.map

package/dist/core/tools/ask-user-question/state/selectors/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../../../../../src/core/tools/ask-user-question/state/selectors/contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+CAA+C,CAAC;AACtF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0CAA0C,CAAC;AACnF,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,SAAS,EAAE,SAAS,YAAY,EAAE,CAAC;IAC5C,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,SAAS,kBAAkB,EAAE,CAAC,CAAC;IAClE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,iBAAiB,EAAE,YAAY,CAAC,gBAAgB,CAAC,CAAC;CAC3D;AAED,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IAC3D,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC;IAC5B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,kBAAkB,EAAE,GAAG,EAAE,cAAc,KAAK,CAAC,CAAC;AACtF,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,kBAAkB,EAAE,GAAG,EAAE,oBAAoB,KAAK,CAAC,CAAC","sourcesContent":["import type { QuestionData } from \"../../tool/types.js\";\nimport type { PreviewPaneProps } from \"../../view/components/preview/preview-pane.js\";\nimport type { WrappingSelectItem } from \"../../view/components/wrapping-select.js\";\nimport type { ActiveView, StatefulView } from \"../../view/stateful-view.js\";\nimport type { TabComponents } from \"../../view/tab-components.js\";\nimport type { QuestionnaireState } from \"../state.js\";\n\nexport interface BindingContext {\n\treadonly questions: readonly QuestionData[];\n\treadonly itemsByTab: ReadonlyArray<readonly WrappingSelectItem[]>;\n\treadonly totalQuestions: number;\n\treadonly activeView: ActiveView;\n\treadonly inputBuffer: string;\n\treadonly activePreviewPane: StatefulView<PreviewPaneProps>;\n}\n\nexport interface PerTabBindingContext extends BindingContext {\n\treadonly tab: TabComponents;\n\treadonly i: number;\n}\n\nexport type GlobalSelector<P> = (state: QuestionnaireState, ctx: BindingContext) => P;\nexport type PerTabSelector<P> = (state: QuestionnaireState, ctx: PerTabBindingContext) => P;\n"]}

package/dist/core/tools/ask-user-question/state/selectors/contract.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contract.js.map

package/dist/core/tools/ask-user-question/state/selectors/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../../../../../src/core/tools/ask-user-question/state/selectors/contract.ts"],"names":[],"mappings":"","sourcesContent":["import type { QuestionData } from \"../../tool/types.js\";\nimport type { PreviewPaneProps } from \"../../view/components/preview/preview-pane.js\";\nimport type { WrappingSelectItem } from \"../../view/components/wrapping-select.js\";\nimport type { ActiveView, StatefulView } from \"../../view/stateful-view.js\";\nimport type { TabComponents } from \"../../view/tab-components.js\";\nimport type { QuestionnaireState } from \"../state.js\";\n\nexport interface BindingContext {\n\treadonly questions: readonly QuestionData[];\n\treadonly itemsByTab: ReadonlyArray<readonly WrappingSelectItem[]>;\n\treadonly totalQuestions: number;\n\treadonly activeView: ActiveView;\n\treadonly inputBuffer: string;\n\treadonly activePreviewPane: StatefulView<PreviewPaneProps>;\n}\n\nexport interface PerTabBindingContext extends BindingContext {\n\treadonly tab: TabComponents;\n\treadonly i: number;\n}\n\nexport type GlobalSelector<P> = (state: QuestionnaireState, ctx: BindingContext) => P;\nexport type PerTabSelector<P> = (state: QuestionnaireState, ctx: PerTabBindingContext) => P;\n"]}

package/dist/core/tools/ask-user-question/state/selectors/derivations.d.ts

@@ -0,0 +1,44 @@
+import type { QuestionAnswer, QuestionData } from "../../tool/types.js";
+import type { WrappingSelectItem } from "../../view/components/wrapping-select.js";
+/**
+ * Pure derivation: does the option focused by `(currentTab, optionIndex)` carry a
+ * non-empty `preview` string? Mode gates (chat focus, notes mode, multiSelect) layer
+ * on top via dispatch branches; this predicate is intentionally mode-agnostic.
+ */
+export declare function computeFocusedOptionHasPreview(questions: readonly QuestionData[], currentTab: number, optionIndex: number): boolean;
+/**
+ * Numbering for the chat row's WrappingSelect, computed from the active tab's items.
+ *
+ * The chat row lives in its own one-item WrappingSelect; the host calls this on every tab
+ * switch / selection update to keep the chat row's `N. ` label continuous with the visible
+ * numbered rows of the active tab. The shape `{ offset, total }` mirrors
+ * `WrappingSelect.setNumbering(numberStartOffset, totalItemsForNumbering)` directly.
+ */
+export declare function chatNumberingFor(items: readonly WrappingSelectItem[]): {
+    offset: number;
+    total: number;
+};
+/**
+ * Which row in the active tab should be marked as "previously confirmed"? Drives the
+ * `WrappingSelect` confirmed-row indicator (label + ` ✔`) when the user navigates back
+ * to a question they already answered. Returns `undefined` when no marker should be drawn —
+ * multi-select handles its own `[✔]` boxes via `multiSelectChecked`, `kind: "chat"` ends the
+ * dialog so the row can never be re-entered, and a missing/non-matching answer (defensive)
+ * silently skips the marker.
+ */
+export declare function selectConfirmedIndicator(questions: readonly QuestionData[], currentTab: number, answers: ReadonlyMap<number, QuestionAnswer>, items: readonly WrappingSelectItem[]): {
+    index: number;
+    labelOverride?: string;
+} | undefined;
+/**
+ * Index of the preview pane to display for the current tab. The Submit tab (currentTab ===
+ * questions.length) reuses the last question's pane purely for layout — the strategy
+ * machinery picks the right body component independently. Defensive against `totalQuestions === 0`.
+ */
+export declare function selectActivePreviewPaneIndex(currentTab: number, totalQuestions: number): number;
+/**
+ * Items array for the active tab, with the same Submit-tab clamp as `selectActivePreviewPaneIndex`.
+ * Falls back to an empty array if the index lands outside the items array (defensive).
+ */
+export declare function selectActiveTabItems(itemsByTab: ReadonlyArray<readonly WrappingSelectItem[]>, currentTab: number, totalQuestions: number): readonly WrappingSelectItem[];
+//# sourceMappingURL=derivations.d.ts.map

package/dist/core/tools/ask-user-question/state/selectors/derivations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derivations.d.ts","sourceRoot":"","sources":["../../../../../../src/core/tools/ask-user-question/state/selectors/derivations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0CAA0C,CAAC;AAGnF;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC7C,SAAS,EAAE,SAAS,YAAY,EAAE,EAClC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GACjB,OAAO,CAKT;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,kBAAkB,EAAE,GAAG;IACvE,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACd,CAOA;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACvC,SAAS,EAAE,SAAS,YAAY,EAAE,EAClC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,EAC5C,KAAK,EAAE,SAAS,kBAAkB,EAAE,GAClC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAcvD;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAG/F;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CACnC,UAAU,EAAE,aAAa,CAAC,SAAS,kBAAkB,EAAE,CAAC,EACxD,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,GACpB,SAAS,kBAAkB,EAAE,CAG/B","sourcesContent":["import type { QuestionAnswer, QuestionData } from \"../../tool/types.js\";\nimport type { WrappingSelectItem } from \"../../view/components/wrapping-select.js\";\nimport { ROW_INTENT_META } from \"../row-intent.js\";\n\n/**\n * Pure derivation: does the option focused by `(currentTab, optionIndex)` carry a\n * non-empty `preview` string? Mode gates (chat focus, notes mode, multiSelect) layer\n * on top via dispatch branches; this predicate is intentionally mode-agnostic.\n */\nexport function computeFocusedOptionHasPreview(\n\tquestions: readonly QuestionData[],\n\tcurrentTab: number,\n\toptionIndex: number,\n): boolean {\n\tconst q = questions[currentTab];\n\tif (!q) return false;\n\tconst opt = q.options[optionIndex];\n\treturn !!opt && typeof opt.preview === \"string\" && opt.preview.length > 0;\n}\n\n/**\n * Numbering for the chat row's WrappingSelect, computed from the active tab's items.\n *\n * The chat row lives in its own one-item WrappingSelect; the host calls this on every tab\n * switch / selection update to keep the chat row's `N. ` label continuous with the visible\n * numbered rows of the active tab. The shape `{ offset, total }` mirrors\n * `WrappingSelect.setNumbering(numberStartOffset, totalItemsForNumbering)` directly.\n */\nexport function chatNumberingFor(items: readonly WrappingSelectItem[]): {\n\toffset: number;\n\ttotal: number;\n} {\n\t// Count only the visible-numbered rows. The Next sentinel renders without a number\n\t// (see MultiSelectView), so it must NOT advance the chat row's number — otherwise\n\t// chat reads as \"6.\" next to options labeled 1-4. Sourced from `ROW_INTENT_META[kind].numbered`\n\t// so adding a new non-numbered kind is a single META edit.\n\tconst count = items.filter((i) => ROW_INTENT_META[i.kind].numbered).length;\n\treturn { offset: count, total: count + 1 };\n}\n\n/**\n * Which row in the active tab should be marked as \"previously confirmed\"? Drives the\n * `WrappingSelect` confirmed-row indicator (label + ` ✔`) when the user navigates back\n * to a question they already answered. Returns `undefined` when no marker should be drawn —\n * multi-select handles its own `[✔]` boxes via `multiSelectChecked`, `kind: \"chat\"` ends the\n * dialog so the row can never be re-entered, and a missing/non-matching answer (defensive)\n * silently skips the marker.\n */\nexport function selectConfirmedIndicator(\n\tquestions: readonly QuestionData[],\n\tcurrentTab: number,\n\tanswers: ReadonlyMap<number, QuestionAnswer>,\n\titems: readonly WrappingSelectItem[],\n): { index: number; labelOverride?: string } | undefined {\n\tconst q = questions[currentTab];\n\tif (!q || q.multiSelect === true) return undefined;\n\tconst prior = answers.get(currentTab);\n\tif (!prior || prior.kind === \"chat\") return undefined;\n\tif (prior.kind === \"custom\") {\n\t\tconst otherIndex = items.findIndex((it) => it.kind === \"other\");\n\t\tif (otherIndex < 0) return undefined;\n\t\treturn { index: otherIndex, labelOverride: prior.answer ?? \"\" };\n\t}\n\tif (prior.kind !== \"option\" || typeof prior.answer !== \"string\") return undefined;\n\tconst index = items.findIndex((it) => it.kind === \"option\" && it.label === prior.answer);\n\tif (index < 0) return undefined;\n\treturn { index };\n}\n\n/**\n * Index of the preview pane to display for the current tab. The Submit tab (currentTab ===\n * questions.length) reuses the last question's pane purely for layout — the strategy\n * machinery picks the right body component independently. Defensive against `totalQuestions === 0`.\n */\nexport function selectActivePreviewPaneIndex(currentTab: number, totalQuestions: number): number {\n\tif (totalQuestions <= 0) return 0;\n\treturn Math.min(currentTab, totalQuestions - 1);\n}\n\n/**\n * Items array for the active tab, with the same Submit-tab clamp as `selectActivePreviewPaneIndex`.\n * Falls back to an empty array if the index lands outside the items array (defensive).\n */\nexport function selectActiveTabItems(\n\titemsByTab: ReadonlyArray<readonly WrappingSelectItem[]>,\n\tcurrentTab: number,\n\ttotalQuestions: number,\n): readonly WrappingSelectItem[] {\n\tconst idx = selectActivePreviewPaneIndex(currentTab, totalQuestions);\n\treturn itemsByTab[idx] ?? [];\n}\n"]}

package/dist/core/tools/ask-user-question/state/selectors/derivations.js

@@ -0,0 +1,76 @@
+import { ROW_INTENT_META } from "../row-intent.js";
+/**
+ * Pure derivation: does the option focused by `(currentTab, optionIndex)` carry a
+ * non-empty `preview` string? Mode gates (chat focus, notes mode, multiSelect) layer
+ * on top via dispatch branches; this predicate is intentionally mode-agnostic.
+ */
+export function computeFocusedOptionHasPreview(questions, currentTab, optionIndex) {
+    const q = questions[currentTab];
+    if (!q)
+        return false;
+    const opt = q.options[optionIndex];
+    return !!opt && typeof opt.preview === "string" && opt.preview.length > 0;
+}
+/**
+ * Numbering for the chat row's WrappingSelect, computed from the active tab's items.
+ *
+ * The chat row lives in its own one-item WrappingSelect; the host calls this on every tab
+ * switch / selection update to keep the chat row's `N. ` label continuous with the visible
+ * numbered rows of the active tab. The shape `{ offset, total }` mirrors
+ * `WrappingSelect.setNumbering(numberStartOffset, totalItemsForNumbering)` directly.
+ */
+export function chatNumberingFor(items) {
+    // Count only the visible-numbered rows. The Next sentinel renders without a number
+    // (see MultiSelectView), so it must NOT advance the chat row's number — otherwise
+    // chat reads as "6." next to options labeled 1-4. Sourced from `ROW_INTENT_META[kind].numbered`
+    // so adding a new non-numbered kind is a single META edit.
+    const count = items.filter((i) => ROW_INTENT_META[i.kind].numbered).length;
+    return { offset: count, total: count + 1 };
+}
+/**
+ * Which row in the active tab should be marked as "previously confirmed"? Drives the
+ * `WrappingSelect` confirmed-row indicator (label + ` ✔`) when the user navigates back
+ * to a question they already answered. Returns `undefined` when no marker should be drawn —
+ * multi-select handles its own `[✔]` boxes via `multiSelectChecked`, `kind: "chat"` ends the
+ * dialog so the row can never be re-entered, and a missing/non-matching answer (defensive)
+ * silently skips the marker.
+ */
+export function selectConfirmedIndicator(questions, currentTab, answers, items) {
+    const q = questions[currentTab];
+    if (!q || q.multiSelect === true)
+        return undefined;
+    const prior = answers.get(currentTab);
+    if (!prior || prior.kind === "chat")
+        return undefined;
+    if (prior.kind === "custom") {
+        const otherIndex = items.findIndex((it) => it.kind === "other");
+        if (otherIndex < 0)
+            return undefined;
+        return { index: otherIndex, labelOverride: prior.answer ?? "" };
+    }
+    if (prior.kind !== "option" || typeof prior.answer !== "string")
+        return undefined;
+    const index = items.findIndex((it) => it.kind === "option" && it.label === prior.answer);
+    if (index < 0)
+        return undefined;
+    return { index };
+}
+/**
+ * Index of the preview pane to display for the current tab. The Submit tab (currentTab ===
+ * questions.length) reuses the last question's pane purely for layout — the strategy
+ * machinery picks the right body component independently. Defensive against `totalQuestions === 0`.
+ */
+export function selectActivePreviewPaneIndex(currentTab, totalQuestions) {
+    if (totalQuestions <= 0)
+        return 0;
+    return Math.min(currentTab, totalQuestions - 1);
+}
+/**
+ * Items array for the active tab, with the same Submit-tab clamp as `selectActivePreviewPaneIndex`.
+ * Falls back to an empty array if the index lands outside the items array (defensive).
+ */
+export function selectActiveTabItems(itemsByTab, currentTab, totalQuestions) {
+    const idx = selectActivePreviewPaneIndex(currentTab, totalQuestions);
+    return itemsByTab[idx] ?? [];
+}
+//# sourceMappingURL=derivations.js.map

package/dist/core/tools/ask-user-question/state/selectors/derivations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"derivations.js","sourceRoot":"","sources":["../../../../../../src/core/tools/ask-user-question/state/selectors/derivations.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;;;GAIG;AACH,MAAM,UAAU,8BAA8B,CAC7C,SAAkC,EAClC,UAAkB,EAClB,WAAmB;IAEnB,MAAM,CAAC,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;IAChC,IAAI,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACrB,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACnC,OAAO,CAAC,CAAC,GAAG,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;AAC3E,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAoC;IAIpE,mFAAmF;IACnF,kFAAkF;IAClF,gGAAgG;IAChG,2DAA2D;IAC3D,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC;IAC3E,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC;AAC5C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,wBAAwB,CACvC,SAAkC,EAClC,UAAkB,EAClB,OAA4C,EAC5C,KAAoC;IAEpC,MAAM,CAAC,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;IAChC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACnD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACtC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,SAAS,CAAC;IACtD,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;QAChE,IAAI,UAAU,GAAG,CAAC;YAAE,OAAO,SAAS,CAAC;QACrC,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,KAAK,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;IACjE,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAClF,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,KAAK,QAAQ,IAAI,EAAE,CAAC,KAAK,KAAK,KAAK,CAAC,MAAM,CAAC,CAAC;IACzF,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAChC,OAAO,EAAE,KAAK,EAAE,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,4BAA4B,CAAC,UAAkB,EAAE,cAAsB;IACtF,IAAI,cAAc,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IAClC,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,cAAc,GAAG,CAAC,CAAC,CAAC;AACjD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CACnC,UAAwD,EACxD,UAAkB,EAClB,cAAsB;IAEtB,MAAM,GAAG,GAAG,4BAA4B,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IACrE,OAAO,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;AAC9B,CAAC","sourcesContent":["import type { QuestionAnswer, QuestionData } from \"../../tool/types.js\";\nimport type { WrappingSelectItem } from \"../../view/components/wrapping-select.js\";\nimport { ROW_INTENT_META } from \"../row-intent.js\";\n\n/**\n * Pure derivation: does the option focused by `(currentTab, optionIndex)` carry a\n * non-empty `preview` string? Mode gates (chat focus, notes mode, multiSelect) layer\n * on top via dispatch branches; this predicate is intentionally mode-agnostic.\n */\nexport function computeFocusedOptionHasPreview(\n\tquestions: readonly QuestionData[],\n\tcurrentTab: number,\n\toptionIndex: number,\n): boolean {\n\tconst q = questions[currentTab];\n\tif (!q) return false;\n\tconst opt = q.options[optionIndex];\n\treturn !!opt && typeof opt.preview === \"string\" && opt.preview.length > 0;\n}\n\n/**\n * Numbering for the chat row's WrappingSelect, computed from the active tab's items.\n *\n * The chat row lives in its own one-item WrappingSelect; the host calls this on every tab\n * switch / selection update to keep the chat row's `N. ` label continuous with the visible\n * numbered rows of the active tab. The shape `{ offset, total }` mirrors\n * `WrappingSelect.setNumbering(numberStartOffset, totalItemsForNumbering)` directly.\n */\nexport function chatNumberingFor(items: readonly WrappingSelectItem[]): {\n\toffset: number;\n\ttotal: number;\n} {\n\t// Count only the visible-numbered rows. The Next sentinel renders without a number\n\t// (see MultiSelectView), so it must NOT advance the chat row's number — otherwise\n\t// chat reads as \"6.\" next to options labeled 1-4. Sourced from `ROW_INTENT_META[kind].numbered`\n\t// so adding a new non-numbered kind is a single META edit.\n\tconst count = items.filter((i) => ROW_INTENT_META[i.kind].numbered).length;\n\treturn { offset: count, total: count + 1 };\n}\n\n/**\n * Which row in the active tab should be marked as \"previously confirmed\"? Drives the\n * `WrappingSelect` confirmed-row indicator (label + ` ✔`) when the user navigates back\n * to a question they already answered. Returns `undefined` when no marker should be drawn —\n * multi-select handles its own `[✔]` boxes via `multiSelectChecked`, `kind: \"chat\"` ends the\n * dialog so the row can never be re-entered, and a missing/non-matching answer (defensive)\n * silently skips the marker.\n */\nexport function selectConfirmedIndicator(\n\tquestions: readonly QuestionData[],\n\tcurrentTab: number,\n\tanswers: ReadonlyMap<number, QuestionAnswer>,\n\titems: readonly WrappingSelectItem[],\n): { index: number; labelOverride?: string } | undefined {\n\tconst q = questions[currentTab];\n\tif (!q || q.multiSelect === true) return undefined;\n\tconst prior = answers.get(currentTab);\n\tif (!prior || prior.kind === \"chat\") return undefined;\n\tif (prior.kind === \"custom\") {\n\t\tconst otherIndex = items.findIndex((it) => it.kind === \"other\");\n\t\tif (otherIndex < 0) return undefined;\n\t\treturn { index: otherIndex, labelOverride: prior.answer ?? \"\" };\n\t}\n\tif (prior.kind !== \"option\" || typeof prior.answer !== \"string\") return undefined;\n\tconst index = items.findIndex((it) => it.kind === \"option\" && it.label === prior.answer);\n\tif (index < 0) return undefined;\n\treturn { index };\n}\n\n/**\n * Index of the preview pane to display for the current tab. The Submit tab (currentTab ===\n * questions.length) reuses the last question's pane purely for layout — the strategy\n * machinery picks the right body component independently. Defensive against `totalQuestions === 0`.\n */\nexport function selectActivePreviewPaneIndex(currentTab: number, totalQuestions: number): number {\n\tif (totalQuestions <= 0) return 0;\n\treturn Math.min(currentTab, totalQuestions - 1);\n}\n\n/**\n * Items array for the active tab, with the same Submit-tab clamp as `selectActivePreviewPaneIndex`.\n * Falls back to an empty array if the index lands outside the items array (defensive).\n */\nexport function selectActiveTabItems(\n\titemsByTab: ReadonlyArray<readonly WrappingSelectItem[]>,\n\tcurrentTab: number,\n\ttotalQuestions: number,\n): readonly WrappingSelectItem[] {\n\tconst idx = selectActivePreviewPaneIndex(currentTab, totalQuestions);\n\treturn itemsByTab[idx] ?? [];\n}\n"]}

package/dist/core/tools/ask-user-question/state/selectors/focus.d.ts

@@ -0,0 +1,15 @@
+import type { ActiveView } from "../../view/stateful-view.js";
+/**
+ * Discriminated focus selector — single source of truth for "which view owns
+ * focus this tick?" Priority order matches the dispatcher cascade
+ * (`key-router.ts:151-178`) and the reducer's defensive clears
+ * (`state-reducer.ts:104-126`).
+ *
+ * Priority: notes > submit > chat > options.
+ */
+export declare function selectActiveView(state: {
+    notesVisible: boolean;
+    chatFocused: boolean;
+    currentTab: number;
+}, totalQuestions: number): ActiveView;
+//# sourceMappingURL=focus.d.ts.map

package/dist/core/tools/ask-user-question/state/selectors/focus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus.d.ts","sourceRoot":"","sources":["../../../../../../src/core/tools/ask-user-question/state/selectors/focus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAE9D;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC/B,KAAK,EAAE;IAAE,YAAY,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,EAC1E,cAAc,EAAE,MAAM,GACpB,UAAU,CAKZ","sourcesContent":["import type { ActiveView } from \"../../view/stateful-view.js\";\n\n/**\n * Discriminated focus selector — single source of truth for \"which view owns\n * focus this tick?\" Priority order matches the dispatcher cascade\n * (`key-router.ts:151-178`) and the reducer's defensive clears\n * (`state-reducer.ts:104-126`).\n *\n * Priority: notes > submit > chat > options.\n */\nexport function selectActiveView(\n\tstate: { notesVisible: boolean; chatFocused: boolean; currentTab: number },\n\ttotalQuestions: number,\n): ActiveView {\n\tif (state.notesVisible) return \"notes\";\n\tif (state.currentTab === totalQuestions) return \"submit\";\n\tif (state.chatFocused) return \"chat\";\n\treturn \"options\";\n}\n"]}

package/dist/core/tools/ask-user-question/state/selectors/focus.js

@@ -0,0 +1,18 @@
+/**
+ * Discriminated focus selector — single source of truth for "which view owns
+ * focus this tick?" Priority order matches the dispatcher cascade
+ * (`key-router.ts:151-178`) and the reducer's defensive clears
+ * (`state-reducer.ts:104-126`).
+ *
+ * Priority: notes > submit > chat > options.
+ */
+export function selectActiveView(state, totalQuestions) {
+    if (state.notesVisible)
+        return "notes";
+    if (state.currentTab === totalQuestions)
+        return "submit";
+    if (state.chatFocused)
+        return "chat";
+    return "options";
+}
+//# sourceMappingURL=focus.js.map

package/dist/core/tools/ask-user-question/state/selectors/focus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus.js","sourceRoot":"","sources":["../../../../../../src/core/tools/ask-user-question/state/selectors/focus.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC/B,KAA0E,EAC1E,cAAsB;IAEtB,IAAI,KAAK,CAAC,YAAY;QAAE,OAAO,OAAO,CAAC;IACvC,IAAI,KAAK,CAAC,UAAU,KAAK,cAAc;QAAE,OAAO,QAAQ,CAAC;IACzD,IAAI,KAAK,CAAC,WAAW;QAAE,OAAO,MAAM,CAAC;IACrC,OAAO,SAAS,CAAC;AAClB,CAAC","sourcesContent":["import type { ActiveView } from \"../../view/stateful-view.js\";\n\n/**\n * Discriminated focus selector — single source of truth for \"which view owns\n * focus this tick?\" Priority order matches the dispatcher cascade\n * (`key-router.ts:151-178`) and the reducer's defensive clears\n * (`state-reducer.ts:104-126`).\n *\n * Priority: notes > submit > chat > options.\n */\nexport function selectActiveView(\n\tstate: { notesVisible: boolean; chatFocused: boolean; currentTab: number },\n\ttotalQuestions: number,\n): ActiveView {\n\tif (state.notesVisible) return \"notes\";\n\tif (state.currentTab === totalQuestions) return \"submit\";\n\tif (state.chatFocused) return \"chat\";\n\treturn \"options\";\n}\n"]}

package/dist/core/tools/ask-user-question/state/selectors/projections.d.ts

@@ -0,0 +1,16 @@
+import type { ChatRowViewProps } from "../../view/components/chat-row-view.js";
+import { type MultiSelectViewProps } from "../../view/components/multi-select-view.js";
+import type { OptionListViewProps } from "../../view/components/option-list-view.js";
+import type { PreviewPaneProps } from "../../view/components/preview/preview-pane.js";
+import type { SubmitPickerProps } from "../../view/components/submit-picker.js";
+import type { TabBarProps } from "../../view/components/tab-bar.js";
+import type { DialogProps } from "../../view/dialog-builder.js";
+import type { GlobalSelector, PerTabSelector } from "./contract.js";
+export declare const selectMultiSelectProps: PerTabSelector<MultiSelectViewProps>;
+export declare const selectOptionListProps: PerTabSelector<OptionListViewProps>;
+export declare const selectSubmitPickerProps: GlobalSelector<SubmitPickerProps>;
+export declare const selectPreviewPaneProps: PerTabSelector<PreviewPaneProps>;
+export declare const selectTabBarProps: GlobalSelector<TabBarProps>;
+export declare const selectChatRowProps: GlobalSelector<ChatRowViewProps>;
+export declare const selectDialogProps: GlobalSelector<DialogProps>;
+//# sourceMappingURL=projections.d.ts.map

package/dist/core/tools/ask-user-question/state/selectors/projections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projections.d.ts","sourceRoot":"","sources":["../../../../../../src/core/tools/ask-user-question/state/selectors/projections.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAC/E,OAAO,EAAsB,KAAK,oBAAoB,EAAE,MAAM,4CAA4C,CAAC;AAC3G,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AACrF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+CAA+C,CAAC;AACtF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAEhE,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGpE,eAAO,MAAM,sBAAsB,EAAE,cAAc,CAAC,oBAAoB,CAevE,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,cAAc,CAAC,mBAAmB,CAUrE,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,cAAc,CAAC,iBAAiB,CAQrE,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,cAAc,CAAC,gBAAgB,CAIlE,CAAC;AAEH,eAAO,MAAM,iBAAiB,EAAE,cAAc,CAAC,WAAW,CAazD,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,cAAc,CAAC,gBAAgB,CAM/D,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,cAAc,CAAC,WAAW,CAGxD,CAAC","sourcesContent":["import type { ChatRowViewProps } from \"../../view/components/chat-row-view.js\";\nimport { MULTI_SUBMIT_LABEL, type MultiSelectViewProps } from \"../../view/components/multi-select-view.js\";\nimport type { OptionListViewProps } from \"../../view/components/option-list-view.js\";\nimport type { PreviewPaneProps } from \"../../view/components/preview/preview-pane.js\";\nimport type { SubmitPickerProps } from \"../../view/components/submit-picker.js\";\nimport type { TabBarProps } from \"../../view/components/tab-bar.js\";\nimport type { DialogProps } from \"../../view/dialog-builder.js\";\nimport { ROW_INTENT_META } from \"../row-intent.js\";\nimport type { GlobalSelector, PerTabSelector } from \"./contract.js\";\nimport { chatNumberingFor, selectActiveTabItems, selectConfirmedIndicator } from \"./derivations.js\";\n\nexport const selectMultiSelectProps: PerTabSelector<MultiSelectViewProps> = (state, ctx) => {\n\tconst question = ctx.questions[ctx.i];\n\tif (!question) return { rows: [], nextActive: false, nextLabel: ROW_INTENT_META.next.label };\n\tconst focused = ctx.activeView === \"options\";\n\tconst rows: { checked: boolean; active: boolean }[] = [];\n\tfor (let i = 0; i < question.options.length; i++) {\n\t\trows.push({\n\t\t\tchecked: state.multiSelectChecked.has(i),\n\t\t\tactive: focused && i === state.optionIndex,\n\t\t});\n\t}\n\tconst nextActive = focused && state.optionIndex === question.options.length;\n\tconst isLastQuestion = ctx.i === ctx.questions.length - 1;\n\tconst nextLabel = isLastQuestion ? MULTI_SUBMIT_LABEL : ROW_INTENT_META.next.label;\n\treturn { rows, nextActive, nextLabel };\n};\n\nexport const selectOptionListProps: PerTabSelector<OptionListViewProps> = (state, ctx) => {\n\tconst items = ctx.itemsByTab[ctx.i] ?? [];\n\tconst focused = ctx.activeView === \"options\";\n\tconst confirmed = selectConfirmedIndicator(ctx.questions, state.currentTab, state.answers, items);\n\treturn {\n\t\tselectedIndex: state.optionIndex,\n\t\tfocused,\n\t\tinputBuffer: ctx.inputBuffer,\n\t\t...(confirmed ? { confirmed } : {}),\n\t};\n};\n\nexport const selectSubmitPickerProps: GlobalSelector<SubmitPickerProps> = (state, ctx) => {\n\tconst focused = ctx.activeView === \"submit\";\n\treturn {\n\t\trows: [\n\t\t\t{ active: focused && state.submitChoiceIndex === 0 },\n\t\t\t{ active: focused && state.submitChoiceIndex === 1 },\n\t\t],\n\t};\n};\n\nexport const selectPreviewPaneProps: PerTabSelector<PreviewPaneProps> = (state, ctx) => ({\n\tnotesVisible: state.notesVisible,\n\tselectedIndex: state.optionIndex,\n\tfocused: ctx.activeView === \"options\",\n});\n\nexport const selectTabBarProps: GlobalSelector<TabBarProps> = (state, ctx) => {\n\tconst tabs = ctx.questions.map((q, i) => ({\n\t\tlabel: q.header && q.header.length > 0 ? q.header : `Q${i + 1}`,\n\t\tanswered: state.answers.has(i),\n\t\tactive: i === state.currentTab,\n\t}));\n\treturn {\n\t\ttabs,\n\t\tsubmit: {\n\t\t\tactive: state.currentTab === ctx.questions.length,\n\t\t\tallAnswered: state.answers.size === ctx.questions.length && ctx.questions.length > 0,\n\t\t},\n\t};\n};\n\nexport const selectChatRowProps: GlobalSelector<ChatRowViewProps> = (state, ctx) => {\n\tconst activeItems = selectActiveTabItems(ctx.itemsByTab, state.currentTab, ctx.totalQuestions);\n\treturn {\n\t\tfocused: ctx.activeView === \"chat\",\n\t\tnumbering: chatNumberingFor(activeItems),\n\t};\n};\n\nexport const selectDialogProps: GlobalSelector<DialogProps> = (state, ctx) => ({\n\tstate,\n\tactivePreviewPane: ctx.activePreviewPane,\n});\n"]}

package/dist/core/tools/ask-user-question/state/selectors/projections.js

@@ -0,0 +1,71 @@
+import { MULTI_SUBMIT_LABEL } from "../../view/components/multi-select-view.js";
+import { ROW_INTENT_META } from "../row-intent.js";
+import { chatNumberingFor, selectActiveTabItems, selectConfirmedIndicator } from "./derivations.js";
+export const selectMultiSelectProps = (state, ctx) => {
+    const question = ctx.questions[ctx.i];
+    if (!question)
+        return { rows: [], nextActive: false, nextLabel: ROW_INTENT_META.next.label };
+    const focused = ctx.activeView === "options";
+    const rows = [];
+    for (let i = 0; i < question.options.length; i++) {
+        rows.push({
+            checked: state.multiSelectChecked.has(i),
+            active: focused && i === state.optionIndex,
+        });
+    }
+    const nextActive = focused && state.optionIndex === question.options.length;
+    const isLastQuestion = ctx.i === ctx.questions.length - 1;
+    const nextLabel = isLastQuestion ? MULTI_SUBMIT_LABEL : ROW_INTENT_META.next.label;
+    return { rows, nextActive, nextLabel };
+};
+export const selectOptionListProps = (state, ctx) => {
+    const items = ctx.itemsByTab[ctx.i] ?? [];
+    const focused = ctx.activeView === "options";
+    const confirmed = selectConfirmedIndicator(ctx.questions, state.currentTab, state.answers, items);
+    return {
+        selectedIndex: state.optionIndex,
+        focused,
+        inputBuffer: ctx.inputBuffer,
+        ...(confirmed ? { confirmed } : {}),
+    };
+};
+export const selectSubmitPickerProps = (state, ctx) => {
+    const focused = ctx.activeView === "submit";
+    return {
+        rows: [
+            { active: focused && state.submitChoiceIndex === 0 },
+            { active: focused && state.submitChoiceIndex === 1 },
+        ],
+    };
+};
+export const selectPreviewPaneProps = (state, ctx) => ({
+    notesVisible: state.notesVisible,
+    selectedIndex: state.optionIndex,
+    focused: ctx.activeView === "options",
+});
+export const selectTabBarProps = (state, ctx) => {
+    const tabs = ctx.questions.map((q, i) => ({
+        label: q.header && q.header.length > 0 ? q.header : `Q${i + 1}`,
+        answered: state.answers.has(i),
+        active: i === state.currentTab,
+    }));
+    return {
+        tabs,
+        submit: {
+            active: state.currentTab === ctx.questions.length,
+            allAnswered: state.answers.size === ctx.questions.length && ctx.questions.length > 0,
+        },
+    };
+};
+export const selectChatRowProps = (state, ctx) => {
+    const activeItems = selectActiveTabItems(ctx.itemsByTab, state.currentTab, ctx.totalQuestions);
+    return {
+        focused: ctx.activeView === "chat",
+        numbering: chatNumberingFor(activeItems),
+    };
+};
+export const selectDialogProps = (state, ctx) => ({
+    state,
+    activePreviewPane: ctx.activePreviewPane,
+});
+//# sourceMappingURL=projections.js.map

package/dist/core/tools/ask-user-question/state/selectors/projections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projections.js","sourceRoot":"","sources":["../../../../../../src/core/tools/ask-user-question/state/selectors/projections.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ChatRowViewProps } from \"../../view/components/chat-row-view.js\";\nimport { MULTI_SUBMIT_LABEL, type MultiSelectViewProps } from \"../../view/components/multi-select-view.js\";\nimport type { OptionListViewProps } from \"../../view/components/option-list-view.js\";\nimport type { PreviewPaneProps } from \"../../view/components/preview/preview-pane.js\";\nimport type { SubmitPickerProps } from \"../../view/components/submit-picker.js\";\nimport type { TabBarProps } from \"../../view/components/tab-bar.js\";\nimport type { DialogProps } from \"../../view/dialog-builder.js\";\nimport { ROW_INTENT_META } from \"../row-intent.js\";\nimport type { GlobalSelector, PerTabSelector } from \"./contract.js\";\nimport { chatNumberingFor, selectActiveTabItems, selectConfirmedIndicator } from \"./derivations.js\";\n\nexport const selectMultiSelectProps: PerTabSelector<MultiSelectViewProps> = (state, ctx) => {\n\tconst question = ctx.questions[ctx.i];\n\tif (!question) return { rows: [], nextActive: false, nextLabel: ROW_INTENT_META.next.label };\n\tconst focused = ctx.activeView === \"options\";\n\tconst rows: { checked: boolean; active: boolean }[] = [];\n\tfor (let i = 0; i < question.options.length; i++) {\n\t\trows.push({\n\t\t\tchecked: state.multiSelectChecked.has(i),\n\t\t\tactive: focused && i === state.optionIndex,\n\t\t});\n\t}\n\tconst nextActive = focused && state.optionIndex === question.options.length;\n\tconst isLastQuestion = ctx.i === ctx.questions.length - 1;\n\tconst nextLabel = isLastQuestion ? MULTI_SUBMIT_LABEL : ROW_INTENT_META.next.label;\n\treturn { rows, nextActive, nextLabel };\n};\n\nexport const selectOptionListProps: PerTabSelector<OptionListViewProps> = (state, ctx) => {\n\tconst items = ctx.itemsByTab[ctx.i] ?? [];\n\tconst focused = ctx.activeView === \"options\";\n\tconst confirmed = selectConfirmedIndicator(ctx.questions, state.currentTab, state.answers, items);\n\treturn {\n\t\tselectedIndex: state.optionIndex,\n\t\tfocused,\n\t\tinputBuffer: ctx.inputBuffer,\n\t\t...(confirmed ? { confirmed } : {}),\n\t};\n};\n\nexport const selectSubmitPickerProps: GlobalSelector<SubmitPickerProps> = (state, ctx) => {\n\tconst focused = ctx.activeView === \"submit\";\n\treturn {\n\t\trows: [\n\t\t\t{ active: focused && state.submitChoiceIndex === 0 },\n\t\t\t{ active: focused && state.submitChoiceIndex === 1 },\n\t\t],\n\t};\n};\n\nexport const selectPreviewPaneProps: PerTabSelector<PreviewPaneProps> = (state, ctx) => ({\n\tnotesVisible: state.notesVisible,\n\tselectedIndex: state.optionIndex,\n\tfocused: ctx.activeView === \"options\",\n});\n\nexport const selectTabBarProps: GlobalSelector<TabBarProps> = (state, ctx) => {\n\tconst tabs = ctx.questions.map((q, i) => ({\n\t\tlabel: q.header && q.header.length > 0 ? q.header : `Q${i + 1}`,\n\t\tanswered: state.answers.has(i),\n\t\tactive: i === state.currentTab,\n\t}));\n\treturn {\n\t\ttabs,\n\t\tsubmit: {\n\t\t\tactive: state.currentTab === ctx.questions.length,\n\t\t\tallAnswered: state.answers.size === ctx.questions.length && ctx.questions.length > 0,\n\t\t},\n\t};\n};\n\nexport const selectChatRowProps: GlobalSelector<ChatRowViewProps> = (state, ctx) => {\n\tconst activeItems = selectActiveTabItems(ctx.itemsByTab, state.currentTab, ctx.totalQuestions);\n\treturn {\n\t\tfocused: ctx.activeView === \"chat\",\n\t\tnumbering: chatNumberingFor(activeItems),\n\t};\n};\n\nexport const selectDialogProps: GlobalSelector<DialogProps> = (state, ctx) => ({\n\tstate,\n\tactivePreviewPane: ctx.activePreviewPane,\n});\n"]}

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

@@ -0,0 +1,44 @@
+import type { QuestionData, QuestionnaireResult } from "../tool/types.js";
+import type { WrappingSelectItem } from "../view/components/wrapping-select.js";
+import type { QuestionnaireAction } from "./key-router.js";
+import type { QuestionnaireState } from "./state.js";
+/** Session-lifetime constants. No live-component reads — peripheral values live on canonical state. */
+export interface ApplyContext {
+    questions: readonly QuestionData[];
+    itemsByTab: ReadonlyArray<readonly WrappingSelectItem[]>;
+}
+/**
+ * Declarative side-effects emitted by `reduce`. The runtime executes them after
+ * committing the new state, then asks the props-adapter to re-project. Closed set —
+ * adding an effect requires updating both the union AND the runtime's `runEffect` switch
+ * (compiler-enforced exhaustive). No string-keyed escape hatch.
+ */
+export type Effect = {
+    kind: "set_input_buffer";
+    value: string;
+} | {
+    kind: "clear_input_buffer";
+} | {
+    kind: "set_notes_value";
+    value: string;
+} | {
+    kind: "set_notes_focused";
+    focused: boolean;
+} | {
+    kind: "forward_notes_keystroke";
+    data: string;
+} | {
+    kind: "done";
+    result: QuestionnaireResult;
+};
+export interface ApplyResult {
+    state: QuestionnaireState;
+    effects: readonly Effect[];
+}
+/**
+ * Pure reducer: (state, action, ctx) → (state, Effect[]). Mirrors `rpiv-todo`'s `applyTaskMutation`.
+ * Delegates to `HANDLERS` — per-kind handlers above are pure, named, and individually testable.
+ * `ignore` is also handled outside the reducer by `handleIgnoreInline` in the runtime fast path.
+ */
+export declare function reduce(state: QuestionnaireState, action: QuestionnaireAction, ctx: ApplyContext): ApplyResult;
+//# sourceMappingURL=state-reducer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state-reducer.d.ts","sourceRoot":"","sources":["../../../../../src/core/tools/ask-user-question/state/state-reducer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC1F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAG3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,uGAAuG;AACvG,MAAM,WAAW,YAAY;IAC5B,SAAS,EAAE,SAAS,YAAY,EAAE,CAAC;IACnC,UAAU,EAAE,aAAa,CAAC,SAAS,kBAAkB,EAAE,CAAC,CAAC;CACzD;AAED;;;;;GAKG;AACH,MAAM,MAAM,MAAM,GACf;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,oBAAoB,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,yBAAyB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAEjD,MAAM,WAAW,WAAW;IAC3B,KAAK,EAAE,kBAAkB,CAAC;IAC1B,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B;AA2PD;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,kBAAkB,EAAE,MAAM,EAAE,mBAAmB,EAAE,GAAG,EAAE,YAAY,GAAG,WAAW,CAG7G","sourcesContent":["import type { QuestionAnswer, QuestionData, QuestionnaireResult } from \"../tool/types.js\";\nimport type { WrappingSelectItem } from \"../view/components/wrapping-select.js\";\nimport type { QuestionnaireAction } from \"./key-router.js\";\nimport { ROW_INTENT_META } from \"./row-intent.js\";\nimport { computeFocusedOptionHasPreview } from \"./selectors/derivations.js\";\nimport type { QuestionnaireState } from \"./state.js\";\n\n/** Session-lifetime constants. No live-component reads — peripheral values live on canonical state. */\nexport interface ApplyContext {\n\tquestions: readonly QuestionData[];\n\titemsByTab: ReadonlyArray<readonly WrappingSelectItem[]>;\n}\n\n/**\n * Declarative side-effects emitted by `reduce`. The runtime executes them after\n * committing the new state, then asks the props-adapter to re-project. Closed set —\n * adding an effect requires updating both the union AND the runtime's `runEffect` switch\n * (compiler-enforced exhaustive). No string-keyed escape hatch.\n */\nexport type Effect =\n\t| { kind: \"set_input_buffer\"; value: string }\n\t| { kind: \"clear_input_buffer\" }\n\t| { kind: \"set_notes_value\"; value: string }\n\t| { kind: \"set_notes_focused\"; focused: boolean }\n\t| { kind: \"forward_notes_keystroke\"; data: string }\n\t| { kind: \"done\"; result: QuestionnaireResult };\n\nexport interface ApplyResult {\n\tstate: QuestionnaireState;\n\teffects: readonly Effect[];\n}\n\nfunction orderedAnswers(state: QuestionnaireState, questions: readonly QuestionData[]): QuestionAnswer[] {\n\tconst out: QuestionAnswer[] = [];\n\tfor (let i = 0; i < questions.length; i++) {\n\t\tconst a = state.answers.get(i);\n\t\tif (a) out.push(a);\n\t}\n\treturn out;\n}\n\nfunction withFocusedOptionHasPreview(\n\tstate: QuestionnaireState,\n\tquestions: readonly QuestionData[],\n): QuestionnaireState {\n\tconst focusedOptionHasPreview = computeFocusedOptionHasPreview(questions, state.currentTab, state.optionIndex);\n\tif (state.focusedOptionHasPreview === focusedOptionHasPreview) return state;\n\treturn { ...state, focusedOptionHasPreview };\n}\n\nfunction syncMultiSelectFromAnswers(\n\tanswers: ReadonlyMap<number, QuestionAnswer>,\n\tquestions: readonly QuestionData[],\n\ttab: number,\n): ReadonlySet<number> {\n\tconst q = questions[tab];\n\tif (!q?.multiSelect) return new Set();\n\tconst saved = answers.get(tab);\n\tconst labels = saved?.selected ?? [];\n\tconst indices = new Set<number>();\n\tfor (let i = 0; i < q.options.length; i++) {\n\t\tif (labels.includes(q.options[i]!.label)) indices.add(i);\n\t}\n\treturn indices;\n}\n\nfunction persistMultiSelectAnswer(state: QuestionnaireState, ctx: ApplyContext): ReadonlyMap<number, QuestionAnswer> {\n\tconst q = ctx.questions[state.currentTab];\n\tif (!q?.multiSelect) return state.answers;\n\tconst selected: string[] = [];\n\tfor (let i = 0; i < q.options.length; i++) {\n\t\tif (state.multiSelectChecked.has(i)) selected.push(q.options[i]!.label);\n\t}\n\tconst out = new Map(state.answers);\n\tif (selected.length === 0) {\n\t\tout.delete(state.currentTab);\n\t\treturn out;\n\t}\n\tconst pendingNotes = state.notesByTab.get(state.currentTab);\n\tout.set(state.currentTab, {\n\t\tquestionIndex: state.currentTab,\n\t\tquestion: q.question,\n\t\tkind: \"multi\",\n\t\tanswer: null,\n\t\tselected,\n\t\t...(pendingNotes && pendingNotes.length > 0 ? { notes: pendingNotes } : {}),\n\t});\n\treturn out;\n}\n\nfunction switchTabResult(state: QuestionnaireState, nextTab: number, ctx: ApplyContext): ApplyResult {\n\tconst notesValue = state.notesByTab.get(nextTab) ?? state.answers.get(nextTab)?.notes ?? \"\";\n\tconst transitioned: QuestionnaireState = {\n\t\t...state,\n\t\tcurrentTab: nextTab,\n\t\toptionIndex: 0,\n\t\tinputMode: false,\n\t\tnotesVisible: false,\n\t\tchatFocused: false,\n\t\tsubmitChoiceIndex: 0,\n\t\tmultiSelectChecked: syncMultiSelectFromAnswers(state.answers, ctx.questions, nextTab),\n\t\tnotesDraft: notesValue,\n\t};\n\tconst finalState = withFocusedOptionHasPreview(transitioned, ctx.questions);\n\treturn {\n\t\tstate: finalState,\n\t\teffects: [\n\t\t\t{ kind: \"set_notes_focused\", focused: false },\n\t\t\t{ kind: \"set_notes_value\", value: notesValue },\n\t\t],\n\t};\n}\n\nfunction doneFor(state: QuestionnaireState, ctx: ApplyContext, cancelled: boolean): ApplyResult {\n\tconst result: QuestionnaireResult = { answers: orderedAnswers(state, ctx.questions), cancelled };\n\treturn { state, effects: [{ kind: \"done\", result }] };\n}\n\n/**\n * Per-kind handler signature: action payload narrows to the matching union member\n * via `Extract`, so handlers consume fully-typed actions without `as` casts.\n */\ntype Handler<K extends QuestionnaireAction[\"kind\"]> = (\n\tstate: QuestionnaireState,\n\taction: Extract<QuestionnaireAction, { kind: K }>,\n\tctx: ApplyContext,\n) => ApplyResult;\n\nconst navHandler: Handler<\"nav\"> = (state, action, ctx) => {\n\tconst items = ctx.itemsByTab[state.currentTab] ?? [];\n\tconst item = items[action.nextIndex];\n\tconst inputMode = item ? ROW_INTENT_META[item.kind].activatesInputMode : false;\n\tconst next = withFocusedOptionHasPreview({ ...state, optionIndex: action.nextIndex, inputMode }, ctx.questions);\n\tif (!inputMode) {\n\t\treturn { state: next, effects: [{ kind: \"clear_input_buffer\" }] };\n\t}\n\tconst prior = state.answers.get(state.currentTab);\n\tif (prior?.kind === \"custom\" && typeof prior.answer === \"string\") {\n\t\treturn { state: next, effects: [{ kind: \"set_input_buffer\", value: prior.answer }] };\n\t}\n\treturn { state: next, effects: [] };\n};\n\nconst tabSwitchHandler: Handler<\"tab_switch\"> = (state, action, ctx) => switchTabResult(state, action.nextTab, ctx);\n\nconst confirmHandler: Handler<\"confirm\"> = (state, action, ctx) => {\n\tlet answer = action.answer;\n\tif (answer.kind === \"option\" && answer.answer) {\n\t\tconst q = ctx.questions[answer.questionIndex];\n\t\tconst matched = q?.options.find((o) => o.label === answer.answer);\n\t\tif (matched?.preview && matched.preview.length > 0) {\n\t\t\tanswer = { ...answer, preview: matched.preview };\n\t\t}\n\t}\n\tconst pendingNotes = state.notesByTab.get(answer.questionIndex);\n\tif (pendingNotes && pendingNotes.length > 0) {\n\t\tanswer = { ...answer, notes: pendingNotes };\n\t}\n\tconst answers = new Map(state.answers);\n\tanswers.set(answer.questionIndex, answer);\n\tconst next: QuestionnaireState = { ...state, answers };\n\tif (answer.kind === \"chat\") return doneFor(next, ctx, false);\n\tif (action.autoAdvanceTab !== undefined) return switchTabResult(next, action.autoAdvanceTab, ctx);\n\treturn doneFor(next, ctx, false);\n};\n\nconst toggleHandler: Handler<\"toggle\"> = (state, action, ctx) => {\n\tconst checked = new Set(state.multiSelectChecked);\n\tif (checked.has(action.index)) checked.delete(action.index);\n\telse checked.add(action.index);\n\tconst intermediate: QuestionnaireState = { ...state, multiSelectChecked: checked };\n\tconst answers = persistMultiSelectAnswer(intermediate, ctx);\n\treturn { state: { ...intermediate, answers }, effects: [] };\n};\n\nconst multiConfirmHandler: Handler<\"multi_confirm\"> = (state, action, ctx) => {\n\tconst q = ctx.questions[state.currentTab];\n\tif (!q) return { state, effects: [] };\n\tconst pendingNotes = state.notesByTab.get(state.currentTab);\n\tconst answers = new Map(state.answers);\n\tanswers.set(state.currentTab, {\n\t\tquestionIndex: state.currentTab,\n\t\tquestion: q.question,\n\t\tkind: \"multi\",\n\t\tanswer: null,\n\t\tselected: action.selected,\n\t\t...(pendingNotes && pendingNotes.length > 0 ? { notes: pendingNotes } : {}),\n\t});\n\tconst synced: QuestionnaireState = {\n\t\t...state,\n\t\tanswers,\n\t\tmultiSelectChecked: syncMultiSelectFromAnswers(answers, ctx.questions, state.currentTab),\n\t};\n\tif (action.autoAdvanceTab !== undefined) return switchTabResult(synced, action.autoAdvanceTab, ctx);\n\treturn doneFor(synced, ctx, false);\n};\n\nconst notesEnterHandler: Handler<\"notes_enter\"> = (state, _action, _ctx) => {\n\tconst value = state.answers.get(state.currentTab)?.notes ?? \"\";\n\treturn {\n\t\tstate: { ...state, notesVisible: true, notesDraft: value },\n\t\teffects: [\n\t\t\t{ kind: \"set_notes_value\", value },\n\t\t\t{ kind: \"set_notes_focused\", focused: true },\n\t\t],\n\t};\n};\n\nconst notesExitHandler: Handler<\"notes_exit\"> = (state, _action, _ctx) => {\n\tconst trimmed = state.notesDraft.trim();\n\tconst notes = new Map(state.notesByTab);\n\tconst answers = new Map(state.answers);\n\tif (trimmed.length === 0) {\n\t\tnotes.delete(state.currentTab);\n\t\tconst prev = answers.get(state.currentTab);\n\t\tif (prev?.notes) {\n\t\t\tconst stripped = { ...prev };\n\t\t\tdelete (stripped as { notes?: string }).notes;\n\t\t\tanswers.set(state.currentTab, stripped);\n\t\t}\n\t} else {\n\t\tnotes.set(state.currentTab, trimmed);\n\t\tconst prev = answers.get(state.currentTab);\n\t\tif (prev) answers.set(state.currentTab, { ...prev, notes: trimmed });\n\t}\n\treturn {\n\t\tstate: { ...state, notesByTab: notes, answers, notesVisible: false },\n\t\teffects: [{ kind: \"set_notes_focused\", focused: false }],\n\t};\n};\n\nconst focusOptionsHandler: Handler<\"focus_options\"> = (state, action, ctx) => {\n\tconst items = ctx.itemsByTab[state.currentTab] ?? [];\n\tconst focused = items[action.optionIndex];\n\tconst inputMode = focused ? ROW_INTENT_META[focused.kind].activatesInputMode : false;\n\tconst next = withFocusedOptionHasPreview(\n\t\t{ ...state, chatFocused: false, optionIndex: action.optionIndex, inputMode },\n\t\tctx.questions,\n\t);\n\treturn { state: next, effects: inputMode ? [] : [{ kind: \"clear_input_buffer\" }] };\n};\n\nconst cancelHandler: Handler<\"cancel\"> = (s, _a, c) => doneFor(s, c, true);\nconst submitHandler: Handler<\"submit\"> = (s, _a, c) => doneFor(s, c, false);\nconst submitNavHandler: Handler<\"submit_nav\"> = (s, a, _c) => ({\n\tstate: { ...s, submitChoiceIndex: a.nextIndex },\n\teffects: [],\n});\nconst focusChatHandler: Handler<\"focus_chat\"> = (s, _a, _c) => ({\n\tstate: { ...s, chatFocused: true },\n\teffects: [],\n});\nconst notesForwardHandler: Handler<\"notes_forward\"> = (s, a, _c) => ({\n\tstate: s,\n\teffects: [{ kind: \"forward_notes_keystroke\", data: a.data }],\n});\nconst ignoreHandler: Handler<\"ignore\"> = (s, _a, _c) => ({ state: s, effects: [] });\n\n/**\n * Compile-time-exhaustive dispatch table. `{ [K in Kind]: Handler<K> }` requires\n * an entry per union member — adding a new `QuestionnaireAction` variant fails to\n * compile here until a handler is registered, mirroring the `Record<RowKind, …>`\n * pattern used by `ROW_INTENT_META`.\n */\nconst HANDLERS: { [K in QuestionnaireAction[\"kind\"]]: Handler<K> } = {\n\tnav: navHandler,\n\ttab_switch: tabSwitchHandler,\n\tconfirm: confirmHandler,\n\ttoggle: toggleHandler,\n\tmulti_confirm: multiConfirmHandler,\n\tcancel: cancelHandler,\n\tnotes_enter: notesEnterHandler,\n\tnotes_exit: notesExitHandler,\n\tnotes_forward: notesForwardHandler,\n\tsubmit: submitHandler,\n\tsubmit_nav: submitNavHandler,\n\tfocus_chat: focusChatHandler,\n\tfocus_options: focusOptionsHandler,\n\tignore: ignoreHandler,\n};\n\n/**\n * Pure reducer: (state, action, ctx) → (state, Effect[]). Mirrors `rpiv-todo`'s `applyTaskMutation`.\n * Delegates to `HANDLERS` — per-kind handlers above are pure, named, and individually testable.\n * `ignore` is also handled outside the reducer by `handleIgnoreInline` in the runtime fast path.\n */\nexport function reduce(state: QuestionnaireState, action: QuestionnaireAction, ctx: ApplyContext): ApplyResult {\n\tconst handler = HANDLERS[action.kind] as Handler<typeof action.kind>;\n\treturn handler(state, action as never, ctx);\n}\n"]}