@bastani/atomic 0.7.17 → 0.8.0-0

package/dist/core/tools/ask-user-question/view/components/submit-picker.d.ts

@@ -0,0 +1,37 @@
+import type { Theme } from "../../../../../modes/interactive/theme/theme.js";
+import type { StatefulView } from "../stateful-view.js";
+export declare const SUBMIT_LABEL = "Submit answers";
+export declare const CANCEL_LABEL = "Cancel";
+/**
+ * Per-tick projection of SubmitPicker state. The picker is a fixed 2-row
+ * structure (Submit / Cancel) — labels are static, only the active marker
+ * varies per tick. `selectSubmitPickerProps` precomputes `active` per row.
+ */
+export interface SubmitPickerProps {
+    /** Per-row active flag. Length always 2: row 0 = Submit, row 1 = Cancel. */
+    rows: ReadonlyArray<{
+        active: boolean;
+    }>;
+}
+/**
+ * Static 2-row picker rendered on the Submit Tab. Row 0 = "Submit answers", Row 1 = "Cancel".
+ *
+ * - Active pointer (❯) follows `props.rows[i].active` per tick.
+ * - Both rows render in normal style at all times — D1 (revised) allows partial submission,
+ *   so Submit is never dimmed or visually marked as unselectable. The warning header in
+ *   `buildSubmitContainer` is the sole signal of incompleteness.
+ * - `naturalHeight(width)` is state-INDEPENDENT and returns a constant 2, so the
+ *   chrome-mirror layout in `buildSubmitContainer` can subtract a fixed 2 lines without
+ *   re-rendering.
+ */
+export declare class SubmitPicker implements StatefulView<SubmitPickerProps> {
+    private readonly theme;
+    private props;
+    constructor(theme: Theme);
+    setProps(props: SubmitPickerProps): void;
+    handleInput(_data: string): void;
+    invalidate(): void;
+    naturalHeight(_width: number): number;
+    render(width: number): string[];
+}
+//# sourceMappingURL=submit-picker.d.ts.map

package/dist/core/tools/ask-user-question/view/components/submit-picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"submit-picker.d.ts","sourceRoot":"","sources":["../../../../../../src/core/tools/ask-user-question/view/components/submit-picker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iDAAiD,CAAC;AAE7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAMxD,eAAO,MAAM,YAAY,mBAAmB,CAAC;AAC7C,eAAO,MAAM,YAAY,WAAW,CAAC;AAErC;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IACjC,4EAA4E;IAC5E,IAAI,EAAE,aAAa,CAAC;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACzC;AAED;;;;;;;;;;GAUG;AACH,qBAAa,YAAa,YAAW,YAAY,CAAC,iBAAiB,CAAC;IAGvD,OAAO,CAAC,QAAQ,CAAC,KAAK;IAFlC,OAAO,CAAC,KAAK,CAAoB;IAEjC,YAA6B,KAAK,EAAE,KAAK,EAExC;IAED,QAAQ,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAEvC;IAED,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAG;IAEnC,UAAU,IAAI,IAAI,CAAG;IAErB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpC;IAED,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAW9B;CACD","sourcesContent":["import type { Theme } from \"../../../../../modes/interactive/theme/theme.js\";\nimport { truncateToWidth } from \"@earendil-works/pi-tui\";\nimport type { StatefulView } from \"../stateful-view.js\";\n\nconst ACTIVE_POINTER = \"❯ \";\nconst INACTIVE_POINTER = \"  \";\nconst NUMBER_SEPARATOR = \". \";\n\nexport const SUBMIT_LABEL = \"Submit answers\";\nexport const CANCEL_LABEL = \"Cancel\";\n\n/**\n * Per-tick projection of SubmitPicker state. The picker is a fixed 2-row\n * structure (Submit / Cancel) — labels are static, only the active marker\n * varies per tick. `selectSubmitPickerProps` precomputes `active` per row.\n */\nexport interface SubmitPickerProps {\n\t/** Per-row active flag. Length always 2: row 0 = Submit, row 1 = Cancel. */\n\trows: ReadonlyArray<{ active: boolean }>;\n}\n\n/**\n * Static 2-row picker rendered on the Submit Tab. Row 0 = \"Submit answers\", Row 1 = \"Cancel\".\n *\n * - Active pointer (❯) follows `props.rows[i].active` per tick.\n * - Both rows render in normal style at all times — D1 (revised) allows partial submission,\n *   so Submit is never dimmed or visually marked as unselectable. The warning header in\n *   `buildSubmitContainer` is the sole signal of incompleteness.\n * - `naturalHeight(width)` is state-INDEPENDENT and returns a constant 2, so the\n *   chrome-mirror layout in `buildSubmitContainer` can subtract a fixed 2 lines without\n *   re-rendering.\n */\nexport class SubmitPicker implements StatefulView<SubmitPickerProps> {\n\tprivate props: SubmitPickerProps;\n\n\tconstructor(private readonly theme: Theme) {\n\t\tthis.props = { rows: [{ active: false }, { active: false }] };\n\t}\n\n\tsetProps(props: SubmitPickerProps): void {\n\t\tthis.props = props;\n\t}\n\n\thandleInput(_data: string): void {}\n\n\tinvalidate(): void {}\n\n\tnaturalHeight(_width: number): number {\n\t\treturn 2;\n\t}\n\n\trender(width: number): string[] {\n\t\tconst lines: string[] = [];\n\t\tfor (let i = 0; i < 2; i++) {\n\t\t\tconst text = i === 0 ? SUBMIT_LABEL : CANCEL_LABEL;\n\t\t\tconst active = this.props.rows[i]?.active ?? false;\n\t\t\tconst pointer = active ? ACTIVE_POINTER : INACTIVE_POINTER;\n\t\t\tconst number = `${i + 1}${NUMBER_SEPARATOR}`;\n\t\t\tconst label = active ? this.theme.fg(\"accent\", this.theme.bold(text)) : this.theme.fg(\"text\", text);\n\t\t\tlines.push(truncateToWidth(`${pointer}${number}${label}`, width, \"\"));\n\t\t}\n\t\treturn lines;\n\t}\n}\n"]}

package/dist/core/tools/ask-user-question/view/components/submit-picker.js

@@ -0,0 +1,44 @@
+import { truncateToWidth } from "@earendil-works/pi-tui";
+const ACTIVE_POINTER = "❯ ";
+const INACTIVE_POINTER = "  ";
+const NUMBER_SEPARATOR = ". ";
+export const SUBMIT_LABEL = "Submit answers";
+export const CANCEL_LABEL = "Cancel";
+/**
+ * Static 2-row picker rendered on the Submit Tab. Row 0 = "Submit answers", Row 1 = "Cancel".
+ *
+ * - Active pointer (❯) follows `props.rows[i].active` per tick.
+ * - Both rows render in normal style at all times — D1 (revised) allows partial submission,
+ *   so Submit is never dimmed or visually marked as unselectable. The warning header in
+ *   `buildSubmitContainer` is the sole signal of incompleteness.
+ * - `naturalHeight(width)` is state-INDEPENDENT and returns a constant 2, so the
+ *   chrome-mirror layout in `buildSubmitContainer` can subtract a fixed 2 lines without
+ *   re-rendering.
+ */
+export class SubmitPicker {
+    constructor(theme) {
+        this.theme = theme;
+        this.props = { rows: [{ active: false }, { active: false }] };
+    }
+    setProps(props) {
+        this.props = props;
+    }
+    handleInput(_data) { }
+    invalidate() { }
+    naturalHeight(_width) {
+        return 2;
+    }
+    render(width) {
+        const lines = [];
+        for (let i = 0; i < 2; i++) {
+            const text = i === 0 ? SUBMIT_LABEL : CANCEL_LABEL;
+            const active = this.props.rows[i]?.active ?? false;
+            const pointer = active ? ACTIVE_POINTER : INACTIVE_POINTER;
+            const number = `${i + 1}${NUMBER_SEPARATOR}`;
+            const label = active ? this.theme.fg("accent", this.theme.bold(text)) : this.theme.fg("text", text);
+            lines.push(truncateToWidth(`${pointer}${number}${label}`, width, ""));
+        }
+        return lines;
+    }
+}
+//# sourceMappingURL=submit-picker.js.map

package/dist/core/tools/ask-user-question/view/components/submit-picker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"submit-picker.js","sourceRoot":"","sources":["../../../../../../src/core/tools/ask-user-question/view/components/submit-picker.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGzD,MAAM,cAAc,GAAG,IAAI,CAAC;AAC5B,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAC9B,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAE9B,MAAM,CAAC,MAAM,YAAY,GAAG,gBAAgB,CAAC;AAC7C,MAAM,CAAC,MAAM,YAAY,GAAG,QAAQ,CAAC;AAYrC;;;;;;;;;;GAUG;AACH,MAAM,OAAO,YAAY;IAGxB,YAA6B,KAAY;qBAAZ,KAAK;QACjC,IAAI,CAAC,KAAK,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IAC/D,CAAC;IAED,QAAQ,CAAC,KAAwB;QAChC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACpB,CAAC;IAED,WAAW,CAAC,KAAa,IAAS,CAAC;IAEnC,UAAU,KAAU,CAAC;IAErB,aAAa,CAAC,MAAc;QAC3B,OAAO,CAAC,CAAC;IACV,CAAC;IAED,MAAM,CAAC,KAAa;QACnB,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC;YACnD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,KAAK,CAAC;YACnD,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,gBAAgB,CAAC;YAC3D,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,gBAAgB,EAAE,CAAC;YAC7C,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YACpG,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;QACvE,CAAC;QACD,OAAO,KAAK,CAAC;IACd,CAAC;CACD","sourcesContent":["import type { Theme } from \"../../../../../modes/interactive/theme/theme.js\";\nimport { truncateToWidth } from \"@earendil-works/pi-tui\";\nimport type { StatefulView } from \"../stateful-view.js\";\n\nconst ACTIVE_POINTER = \"❯ \";\nconst INACTIVE_POINTER = \"  \";\nconst NUMBER_SEPARATOR = \". \";\n\nexport const SUBMIT_LABEL = \"Submit answers\";\nexport const CANCEL_LABEL = \"Cancel\";\n\n/**\n * Per-tick projection of SubmitPicker state. The picker is a fixed 2-row\n * structure (Submit / Cancel) — labels are static, only the active marker\n * varies per tick. `selectSubmitPickerProps` precomputes `active` per row.\n */\nexport interface SubmitPickerProps {\n\t/** Per-row active flag. Length always 2: row 0 = Submit, row 1 = Cancel. */\n\trows: ReadonlyArray<{ active: boolean }>;\n}\n\n/**\n * Static 2-row picker rendered on the Submit Tab. Row 0 = \"Submit answers\", Row 1 = \"Cancel\".\n *\n * - Active pointer (❯) follows `props.rows[i].active` per tick.\n * - Both rows render in normal style at all times — D1 (revised) allows partial submission,\n *   so Submit is never dimmed or visually marked as unselectable. The warning header in\n *   `buildSubmitContainer` is the sole signal of incompleteness.\n * - `naturalHeight(width)` is state-INDEPENDENT and returns a constant 2, so the\n *   chrome-mirror layout in `buildSubmitContainer` can subtract a fixed 2 lines without\n *   re-rendering.\n */\nexport class SubmitPicker implements StatefulView<SubmitPickerProps> {\n\tprivate props: SubmitPickerProps;\n\n\tconstructor(private readonly theme: Theme) {\n\t\tthis.props = { rows: [{ active: false }, { active: false }] };\n\t}\n\n\tsetProps(props: SubmitPickerProps): void {\n\t\tthis.props = props;\n\t}\n\n\thandleInput(_data: string): void {}\n\n\tinvalidate(): void {}\n\n\tnaturalHeight(_width: number): number {\n\t\treturn 2;\n\t}\n\n\trender(width: number): string[] {\n\t\tconst lines: string[] = [];\n\t\tfor (let i = 0; i < 2; i++) {\n\t\t\tconst text = i === 0 ? SUBMIT_LABEL : CANCEL_LABEL;\n\t\t\tconst active = this.props.rows[i]?.active ?? false;\n\t\t\tconst pointer = active ? ACTIVE_POINTER : INACTIVE_POINTER;\n\t\t\tconst number = `${i + 1}${NUMBER_SEPARATOR}`;\n\t\t\tconst label = active ? this.theme.fg(\"accent\", this.theme.bold(text)) : this.theme.fg(\"text\", text);\n\t\t\tlines.push(truncateToWidth(`${pointer}${number}${label}`, width, \"\"));\n\t\t}\n\t\treturn lines;\n\t}\n}\n"]}

package/dist/core/tools/ask-user-question/view/components/tab-bar.d.ts

@@ -0,0 +1,32 @@
+import type { Theme } from "../../../../../modes/interactive/theme/theme.js";
+import type { StatefulView } from "../stateful-view.js";
+/**
+ * Per-tick projection of TabBar state. The selector
+ * (`selectTabBarProps`) hoists every render-time derivation
+ * (`allAnswered`, `answered`, `isActive`, `submitActive`) into props so
+ * `render()` is pure styling. Replaces the prior `setConfig(TabBarConfig)`
+ * snowflake and the inline `+ 1` magic at `props-adapter.ts:127`.
+ */
+export interface TabBarProps {
+    /** One per author-defined question, in order. */
+    tabs: ReadonlyArray<{
+        label: string;
+        answered: boolean;
+        active: boolean;
+    }>;
+    /** Submit-tab state. `allAnswered` drives the success/dim color picker. */
+    submit: {
+        active: boolean;
+        allAnswered: boolean;
+    };
+}
+export declare class TabBar implements StatefulView<TabBarProps> {
+    private readonly theme;
+    private props;
+    constructor(theme: Theme);
+    setProps(props: TabBarProps): void;
+    handleInput(_data: string): void;
+    invalidate(): void;
+    render(width: number): string[];
+}
+//# sourceMappingURL=tab-bar.d.ts.map

package/dist/core/tools/ask-user-question/view/components/tab-bar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tab-bar.d.ts","sourceRoot":"","sources":["../../../../../../src/core/tools/ask-user-question/view/components/tab-bar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iDAAiD,CAAC;AAE7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC3B,iDAAiD;IACjD,IAAI,EAAE,aAAa,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC3E,2EAA2E;IAC3E,MAAM,EAAE;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,WAAW,EAAE,OAAO,CAAA;KAAE,CAAC;CAClD;AAED,qBAAa,MAAO,YAAW,YAAY,CAAC,WAAW,CAAC;IAG3C,OAAO,CAAC,QAAQ,CAAC,KAAK;IAFlC,OAAO,CAAC,KAAK,CAAc;IAE3B,YAA6B,KAAK,EAAE,KAAK,EAExC;IAED,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAEjC;IAED,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAG;IAEnC,UAAU,IAAI,IAAI,CAAG;IAErB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAsB9B;CACD","sourcesContent":["import type { Theme } from \"../../../../../modes/interactive/theme/theme.js\";\nimport { truncateToWidth } from \"@earendil-works/pi-tui\";\nimport type { StatefulView } from \"../stateful-view.js\";\n\n/**\n * Per-tick projection of TabBar state. The selector\n * (`selectTabBarProps`) hoists every render-time derivation\n * (`allAnswered`, `answered`, `isActive`, `submitActive`) into props so\n * `render()` is pure styling. Replaces the prior `setConfig(TabBarConfig)`\n * snowflake and the inline `+ 1` magic at `props-adapter.ts:127`.\n */\nexport interface TabBarProps {\n\t/** One per author-defined question, in order. */\n\ttabs: ReadonlyArray<{ label: string; answered: boolean; active: boolean }>;\n\t/** Submit-tab state. `allAnswered` drives the success/dim color picker. */\n\tsubmit: { active: boolean; allAnswered: boolean };\n}\n\nexport class TabBar implements StatefulView<TabBarProps> {\n\tprivate props: TabBarProps;\n\n\tconstructor(private readonly theme: Theme) {\n\t\tthis.props = { tabs: [], submit: { active: false, allAnswered: false } };\n\t}\n\n\tsetProps(props: TabBarProps): void {\n\t\tthis.props = props;\n\t}\n\n\thandleInput(_data: string): void {}\n\n\tinvalidate(): void {}\n\n\trender(width: number): string[] {\n\t\tconst pieces: string[] = [\" ← \"];\n\n\t\tfor (const tab of this.props.tabs) {\n\t\t\tconst box = tab.answered ? \"■\" : \"□\";\n\t\t\tconst rawSeg = ` ${box} ${tab.label} `;\n\t\t\tconst styled = tab.active\n\t\t\t\t? this.theme.bg(\"selectedBg\", this.theme.fg(\"text\", rawSeg))\n\t\t\t\t: this.theme.fg(tab.answered ? \"success\" : \"muted\", rawSeg);\n\t\t\tpieces.push(styled);\n\t\t\tpieces.push(\" \");\n\t\t}\n\n\t\tconst submitText = \" ✓ Submit \";\n\t\tconst submitStyled = this.props.submit.active\n\t\t\t? this.theme.bg(\"selectedBg\", this.theme.fg(\"text\", submitText))\n\t\t\t: this.theme.fg(this.props.submit.allAnswered ? \"success\" : \"dim\", submitText);\n\t\tpieces.push(submitStyled);\n\t\tpieces.push(\" →\");\n\n\t\tconst tabLine = truncateToWidth(pieces.join(\"\"), width, \"\");\n\t\treturn [tabLine, \"\"];\n\t}\n}\n"]}

package/dist/core/tools/ask-user-question/view/components/tab-bar.js

@@ -0,0 +1,33 @@
+import { truncateToWidth } from "@earendil-works/pi-tui";
+export class TabBar {
+    constructor(theme) {
+        this.theme = theme;
+        this.props = { tabs: [], submit: { active: false, allAnswered: false } };
+    }
+    setProps(props) {
+        this.props = props;
+    }
+    handleInput(_data) { }
+    invalidate() { }
+    render(width) {
+        const pieces = [" ← "];
+        for (const tab of this.props.tabs) {
+            const box = tab.answered ? "■" : "□";
+            const rawSeg = ` ${box} ${tab.label} `;
+            const styled = tab.active
+                ? this.theme.bg("selectedBg", this.theme.fg("text", rawSeg))
+                : this.theme.fg(tab.answered ? "success" : "muted", rawSeg);
+            pieces.push(styled);
+            pieces.push(" ");
+        }
+        const submitText = " ✓ Submit ";
+        const submitStyled = this.props.submit.active
+            ? this.theme.bg("selectedBg", this.theme.fg("text", submitText))
+            : this.theme.fg(this.props.submit.allAnswered ? "success" : "dim", submitText);
+        pieces.push(submitStyled);
+        pieces.push(" →");
+        const tabLine = truncateToWidth(pieces.join(""), width, "");
+        return [tabLine, ""];
+    }
+}
+//# sourceMappingURL=tab-bar.js.map

package/dist/core/tools/ask-user-question/view/components/tab-bar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tab-bar.js","sourceRoot":"","sources":["../../../../../../src/core/tools/ask-user-question/view/components/tab-bar.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAiBzD,MAAM,OAAO,MAAM;IAGlB,YAA6B,KAAY;qBAAZ,KAAK;QACjC,IAAI,CAAC,KAAK,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE,CAAC;IAC1E,CAAC;IAED,QAAQ,CAAC,KAAkB;QAC1B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACpB,CAAC;IAED,WAAW,CAAC,KAAa,IAAS,CAAC;IAEnC,UAAU,KAAU,CAAC;IAErB,MAAM,CAAC,KAAa;QACnB,MAAM,MAAM,GAAa,CAAC,KAAK,CAAC,CAAC;QAEjC,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YACnC,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;YACrC,MAAM,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,CAAC,KAAK,GAAG,CAAC;YACvC,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM;gBACxB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBAC5D,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC7D,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACpB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,UAAU,GAAG,YAAY,CAAC;QAChC,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM;YAC5C,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;YAChE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QAChF,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC1B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAElB,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QAC5D,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACtB,CAAC;CACD","sourcesContent":["import type { Theme } from \"../../../../../modes/interactive/theme/theme.js\";\nimport { truncateToWidth } from \"@earendil-works/pi-tui\";\nimport type { StatefulView } from \"../stateful-view.js\";\n\n/**\n * Per-tick projection of TabBar state. The selector\n * (`selectTabBarProps`) hoists every render-time derivation\n * (`allAnswered`, `answered`, `isActive`, `submitActive`) into props so\n * `render()` is pure styling. Replaces the prior `setConfig(TabBarConfig)`\n * snowflake and the inline `+ 1` magic at `props-adapter.ts:127`.\n */\nexport interface TabBarProps {\n\t/** One per author-defined question, in order. */\n\ttabs: ReadonlyArray<{ label: string; answered: boolean; active: boolean }>;\n\t/** Submit-tab state. `allAnswered` drives the success/dim color picker. */\n\tsubmit: { active: boolean; allAnswered: boolean };\n}\n\nexport class TabBar implements StatefulView<TabBarProps> {\n\tprivate props: TabBarProps;\n\n\tconstructor(private readonly theme: Theme) {\n\t\tthis.props = { tabs: [], submit: { active: false, allAnswered: false } };\n\t}\n\n\tsetProps(props: TabBarProps): void {\n\t\tthis.props = props;\n\t}\n\n\thandleInput(_data: string): void {}\n\n\tinvalidate(): void {}\n\n\trender(width: number): string[] {\n\t\tconst pieces: string[] = [\" ← \"];\n\n\t\tfor (const tab of this.props.tabs) {\n\t\t\tconst box = tab.answered ? \"■\" : \"□\";\n\t\t\tconst rawSeg = ` ${box} ${tab.label} `;\n\t\t\tconst styled = tab.active\n\t\t\t\t? this.theme.bg(\"selectedBg\", this.theme.fg(\"text\", rawSeg))\n\t\t\t\t: this.theme.fg(tab.answered ? \"success\" : \"muted\", rawSeg);\n\t\t\tpieces.push(styled);\n\t\t\tpieces.push(\" \");\n\t\t}\n\n\t\tconst submitText = \" ✓ Submit \";\n\t\tconst submitStyled = this.props.submit.active\n\t\t\t? this.theme.bg(\"selectedBg\", this.theme.fg(\"text\", submitText))\n\t\t\t: this.theme.fg(this.props.submit.allAnswered ? \"success\" : \"dim\", submitText);\n\t\tpieces.push(submitStyled);\n\t\tpieces.push(\" →\");\n\n\t\tconst tabLine = truncateToWidth(pieces.join(\"\"), width, \"\");\n\t\treturn [tabLine, \"\"];\n\t}\n}\n"]}

package/dist/core/tools/ask-user-question/view/components/wrapping-select.d.ts

@@ -0,0 +1,122 @@
+import type { Component } from "@earendil-works/pi-tui";
+/**
+ * Row-intent discriminated union. `kind` is the single discriminator —
+ * pre-1.0.3 boolean flags have been removed (see `banned-flags.test.ts`).
+ * Modeled after `QuestionnaireAction` (`key-router.ts:13-32`) and `Effect`
+ * (`state-reducer.ts:26-32`) — pure literal-tagged variants, no shared base,
+ * exhaustive-`switch` enforcement via non-`void` returns.
+ *
+ * Variant semantics:
+ * - `option`: a regular author-defined option row.
+ * - `other`: the inline free-text input row appended to single-select questions
+ *   (label is "Type something."). Renders as inline `Input` when active.
+ * - `chat`: the abandon-questionnaire escape-hatch row (label is "Chat about this").
+ * - `next`: the explicit commit-and-advance row appended to multi-select questions
+ *   (label is "Next"). Renders without a number / checkbox.
+ */
+export type WrappingSelectItem = {
+    kind: "option";
+    label: string;
+    description?: string;
+} | {
+    kind: "other";
+    label: string;
+    description?: string;
+} | {
+    kind: "chat";
+    label: string;
+    description?: string;
+} | {
+    kind: "next";
+    label: string;
+    description?: string;
+};
+export interface WrappingSelectTheme {
+    selectedText: (text: string) => string;
+    description: (text: string) => string;
+    scrollInfo: (text: string) => string;
+}
+/**
+ * Numbering controls.
+ *
+ * Use `numberStartOffset` + `totalItemsForNumbering` when a list is logically a slice of a
+ * larger numbered sequence — e.g. the chat row lives in its own WrappingSelect but should
+ * render as `(N+1).` where N is the previous list's item count, with the column padded as
+ * if both lists were one continuous numbered sequence.
+ */
+export interface WrappingSelectOptions {
+    /** Start numbering at this offset + 1 (default 0 → rows labeled 1, 2, 3 …). */
+    numberStartOffset?: number;
+    /** Override the total used to pad the number column (useful when items span multiple lists). */
+    totalItemsForNumbering?: number;
+}
+export declare class WrappingSelect implements Component {
+    private static readonly ACTIVE_POINTER;
+    private static readonly INACTIVE_POINTER;
+    private static readonly NUMBER_SEPARATOR;
+    private static readonly INPUT_CURSOR;
+    private static readonly CONFIRMED_MARK;
+    private static readonly MIN_CONTENT_WIDTH;
+    private readonly items;
+    private readonly maxVisible;
+    private readonly theme;
+    private numberStartOffset;
+    private totalItemsForNumbering;
+    private selectedIndex;
+    private focused;
+    private inputBuffer;
+    /**
+     * Index of the row that was previously confirmed for this list (e.g. the user's prior
+     * answer when re-entering a multi-question tab). Renders `<label> ✔` in the active-row
+     * styling but WITHOUT the `❯` pointer — pointer is reserved for the live cursor. When
+     * `selectedIndex === confirmedIndex && focused`, the active rendering wins (no double-mark).
+     */
+    private confirmedIndex;
+    /**
+     * When set together with `confirmedIndex`, replaces the row's static label at render time.
+     * Used for the `kind: "other"` sentinel — its label is "Type something." but if the user's
+     * prior answer was custom text, we render that text instead (e.g. `4. Hello ✔`).
+     */
+    private confirmedLabelOverride;
+    constructor(items: readonly WrappingSelectItem[], maxVisible: number, theme: WrappingSelectTheme, options?: WrappingSelectOptions);
+    /**
+     * Update the numbering offset + total padding width without rebuilding the component.
+     * Used by the host to keep the chat-row WrappingSelect's number aligned with the active tab's
+     * options list when the user switches tabs (each tab can have a different items count).
+     */
+    setNumbering(numberStartOffset: number, totalItemsForNumbering: number): void;
+    setSelectedIndex(index: number): void;
+    setFocused(focused: boolean): void;
+    /**
+     * Mark a previously-confirmed row. Pass `undefined` to clear. `labelOverride` replaces
+     * the row's static `item.label` at render time — used for the `kind: "other"` sentinel so
+     * the row reads `Hello ✔` instead of `Type something. ✔` when the prior answer was custom
+     * text.
+     */
+    setConfirmedIndex(index: number | undefined, labelOverride?: string): void;
+    setInputBuffer(text: string): void;
+    /** Intentionally empty — input is routed at the container level. */
+    handleInput(_data: string): void;
+    invalidate(): void;
+    render(width: number): string[];
+    private computeVisibleWindow;
+    private hasItemsOutsideWindow;
+    private renderItem;
+    private buildRowPrefix;
+    private shouldRenderAsInlineInput;
+    /**
+     * Render the inline input row across one or more lines, wrapping at `contentWidth`
+     * so long input doesn't run off the right edge or trip the parent renderer's
+     * width invariant. Mirrors `renderLabelBlock`'s contract: first line carries
+     * `rowPrefix`, continuation lines carry `continuationPrefix` (spaces), and every
+     * emitted line passes through `theme.selectedText`. The trailing cursor glyph
+     * `▌` is appended to the buffer pre-wrap so it lands at the visual end of the
+     * input — `Input` only exposes `getValue()` (cursor offset is private), so
+     * cursor-mid-string is intentionally not rendered here; that would require
+     * either an `Input.getCursorOffset()` API or delegating to `Input.render`.
+     */
+    private renderInlineInputRow;
+    private renderLabelBlock;
+    private renderDescriptionBlock;
+}
+//# sourceMappingURL=wrapping-select.d.ts.map

package/dist/core/tools/ask-user-question/view/components/wrapping-select.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrapping-select.d.ts","sourceRoot":"","sources":["../../../../../../src/core/tools/ask-user-question/view/components/wrapping-select.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Component } from \"@earendil-works/pi-tui\";\nimport { visibleWidth, wrapTextWithAnsi } from \"@earendil-works/pi-tui\";\n\n/**\n * Row-intent discriminated union. `kind` is the single discriminator —\n * pre-1.0.3 boolean flags have been removed (see `banned-flags.test.ts`).\n * Modeled after `QuestionnaireAction` (`key-router.ts:13-32`) and `Effect`\n * (`state-reducer.ts:26-32`) — pure literal-tagged variants, no shared base,\n * exhaustive-`switch` enforcement via non-`void` returns.\n *\n * Variant semantics:\n * - `option`: a regular author-defined option row.\n * - `other`: the inline free-text input row appended to single-select questions\n *   (label is \"Type something.\"). Renders as inline `Input` when active.\n * - `chat`: the abandon-questionnaire escape-hatch row (label is \"Chat about this\").\n * - `next`: the explicit commit-and-advance row appended to multi-select questions\n *   (label is \"Next\"). Renders without a number / checkbox.\n */\nexport type WrappingSelectItem =\n\t| { kind: \"option\"; label: string; description?: string }\n\t| { kind: \"other\"; label: string; description?: string }\n\t| { kind: \"chat\"; label: string; description?: string }\n\t| { kind: \"next\"; label: string; description?: string };\n\nexport interface WrappingSelectTheme {\n\tselectedText: (text: string) => string;\n\tdescription: (text: string) => string;\n\tscrollInfo: (text: string) => string;\n}\n\n/**\n * Numbering controls.\n *\n * Use `numberStartOffset` + `totalItemsForNumbering` when a list is logically a slice of a\n * larger numbered sequence — e.g. the chat row lives in its own WrappingSelect but should\n * render as `(N+1).` where N is the previous list's item count, with the column padded as\n * if both lists were one continuous numbered sequence.\n */\nexport interface WrappingSelectOptions {\n\t/** Start numbering at this offset + 1 (default 0 → rows labeled 1, 2, 3 …). */\n\tnumberStartOffset?: number;\n\t/** Override the total used to pad the number column (useful when items span multiple lists). */\n\ttotalItemsForNumbering?: number;\n}\n\nexport class WrappingSelect implements Component {\n\tprivate static readonly ACTIVE_POINTER = \"❯ \";\n\tprivate static readonly INACTIVE_POINTER = \"  \";\n\tprivate static readonly NUMBER_SEPARATOR = \". \";\n\tprivate static readonly INPUT_CURSOR = \"▌\";\n\tprivate static readonly CONFIRMED_MARK = \" ✔\";\n\tprivate static readonly MIN_CONTENT_WIDTH = 1;\n\n\tprivate readonly items: readonly WrappingSelectItem[];\n\tprivate readonly maxVisible: number;\n\tprivate readonly theme: WrappingSelectTheme;\n\tprivate numberStartOffset: number;\n\tprivate totalItemsForNumbering: number;\n\n\tprivate selectedIndex = 0;\n\tprivate focused = true;\n\tprivate inputBuffer = \"\";\n\t/**\n\t * Index of the row that was previously confirmed for this list (e.g. the user's prior\n\t * answer when re-entering a multi-question tab). Renders `<label> ✔` in the active-row\n\t * styling but WITHOUT the `❯` pointer — pointer is reserved for the live cursor. When\n\t * `selectedIndex === confirmedIndex && focused`, the active rendering wins (no double-mark).\n\t */\n\tprivate confirmedIndex: number | undefined = undefined;\n\t/**\n\t * When set together with `confirmedIndex`, replaces the row's static label at render time.\n\t * Used for the `kind: \"other\"` sentinel — its label is \"Type something.\" but if the user's\n\t * prior answer was custom text, we render that text instead (e.g. `4. Hello ✔`).\n\t */\n\tprivate confirmedLabelOverride: string | undefined = undefined;\n\n\tconstructor(\n\t\titems: readonly WrappingSelectItem[],\n\t\tmaxVisible: number,\n\t\ttheme: WrappingSelectTheme,\n\t\toptions: WrappingSelectOptions = {},\n\t) {\n\t\tthis.items = items;\n\t\tthis.maxVisible = Math.max(1, maxVisible);\n\t\tthis.theme = theme;\n\t\tthis.numberStartOffset = options.numberStartOffset ?? 0;\n\t\tthis.totalItemsForNumbering = options.totalItemsForNumbering ?? items.length;\n\t}\n\n\t/**\n\t * Update the numbering offset + total padding width without rebuilding the component.\n\t * Used by the host to keep the chat-row WrappingSelect's number aligned with the active tab's\n\t * options list when the user switches tabs (each tab can have a different items count).\n\t */\n\tsetNumbering(numberStartOffset: number, totalItemsForNumbering: number): void {\n\t\tthis.numberStartOffset = numberStartOffset;\n\t\tthis.totalItemsForNumbering = Math.max(1, totalItemsForNumbering);\n\t}\n\n\tsetSelectedIndex(index: number): void {\n\t\tthis.selectedIndex = Math.max(0, Math.min(index, this.items.length - 1));\n\t}\n\n\tsetFocused(focused: boolean): void {\n\t\tthis.focused = focused;\n\t}\n\n\t/**\n\t * Mark a previously-confirmed row. Pass `undefined` to clear. `labelOverride` replaces\n\t * the row's static `item.label` at render time — used for the `kind: \"other\"` sentinel so\n\t * the row reads `Hello ✔` instead of `Type something. ✔` when the prior answer was custom\n\t * text.\n\t */\n\tsetConfirmedIndex(index: number | undefined, labelOverride?: string): void {\n\t\tif (index === undefined) {\n\t\t\tthis.confirmedIndex = undefined;\n\t\t\tthis.confirmedLabelOverride = undefined;\n\t\t\treturn;\n\t\t}\n\t\tthis.confirmedIndex = Math.max(0, Math.min(index, this.items.length - 1));\n\t\tthis.confirmedLabelOverride = labelOverride;\n\t}\n\n\tsetInputBuffer(text: string): void {\n\t\tthis.inputBuffer = text;\n\t}\n\n\t/** Intentionally empty — input is routed at the container level. */\n\thandleInput(_data: string): void {}\n\n\tinvalidate(): void {}\n\n\trender(width: number): string[] {\n\t\tif (this.items.length === 0) return [];\n\n\t\tconst { startIndex, endIndex } = this.computeVisibleWindow();\n\t\tconst numberWidth = String(Math.max(1, this.totalItemsForNumbering)).length;\n\t\tconst lines: string[] = [];\n\n\t\tfor (let i = startIndex; i < endIndex; i++) {\n\t\t\tconst item = this.items[i];\n\t\t\tif (!item) continue;\n\t\t\tconst isActive = i === this.selectedIndex && this.focused;\n\t\t\tlines.push(...this.renderItem(item, i, isActive, width, numberWidth));\n\t\t}\n\n\t\tif (this.hasItemsOutsideWindow(startIndex, endIndex)) {\n\t\t\tlines.push(this.theme.scrollInfo(`  (${this.selectedIndex + 1}/${this.items.length})`));\n\t\t}\n\t\treturn lines;\n\t}\n\n\tprivate computeVisibleWindow(): { startIndex: number; endIndex: number } {\n\t\tconst half = Math.floor(this.maxVisible / 2);\n\t\tconst startIndex = Math.max(0, Math.min(this.selectedIndex - half, this.items.length - this.maxVisible));\n\t\tconst endIndex = Math.min(startIndex + this.maxVisible, this.items.length);\n\t\treturn { startIndex, endIndex };\n\t}\n\n\tprivate hasItemsOutsideWindow(startIndex: number, endIndex: number): boolean {\n\t\treturn startIndex > 0 || endIndex < this.items.length;\n\t}\n\n\tprivate renderItem(\n\t\titem: WrappingSelectItem,\n\t\tindex: number,\n\t\tisActive: boolean,\n\t\twidth: number,\n\t\tnumberWidth: number,\n\t): string[] {\n\t\tconst rowPrefix = this.buildRowPrefix(index, isActive, numberWidth);\n\t\tconst continuationPrefix = \" \".repeat(visibleWidth(rowPrefix));\n\t\tconst contentWidth = Math.max(WrappingSelect.MIN_CONTENT_WIDTH, width - visibleWidth(rowPrefix));\n\n\t\tif (this.shouldRenderAsInlineInput(item, isActive)) {\n\t\t\treturn this.renderInlineInputRow(rowPrefix, continuationPrefix, contentWidth);\n\t\t}\n\n\t\t// Confirmed row gets a trailing ` ✔` and accent+bold styling; pointer is independent\n\t\t// (still ❯ when active). When `index === confirmedIndex` AND `isActive`, both `❯` and\n\t\t// `✔` appear on the same row — load-bearing for the case where the prior answer was\n\t\t// row 0 (cursor resets to 0 on tab-back, so the confirmed row IS the active row).\n\t\t// Optional `confirmedLabelOverride` replaces the static label (used for `kind: \"other\"`\n\t\t// + `kind: \"custom\"` answer); the inline-input branch above still wins for `kind: \"other\" + isActive`.\n\t\tconst isConfirmed = index === this.confirmedIndex;\n\t\tconst label = isConfirmed\n\t\t\t? `${this.confirmedLabelOverride ?? item.label}${WrappingSelect.CONFIRMED_MARK}`\n\t\t\t: item.label;\n\t\tconst applySelectedStyle = isActive || isConfirmed;\n\n\t\treturn [\n\t\t\t...this.renderLabelBlock(label, rowPrefix, continuationPrefix, contentWidth, applySelectedStyle),\n\t\t\t...this.renderDescriptionBlock(item.description, continuationPrefix, contentWidth),\n\t\t];\n\t}\n\n\tprivate buildRowPrefix(index: number, isActive: boolean, numberWidth: number): string {\n\t\tconst pointer = isActive ? WrappingSelect.ACTIVE_POINTER : WrappingSelect.INACTIVE_POINTER;\n\t\tconst displayNumber = this.numberStartOffset + index + 1;\n\t\tconst paddedNumber = String(displayNumber).padStart(numberWidth, \" \");\n\t\treturn `${pointer}${paddedNumber}${WrappingSelect.NUMBER_SEPARATOR}`;\n\t}\n\n\tprivate shouldRenderAsInlineInput(item: WrappingSelectItem, isActive: boolean): boolean {\n\t\treturn item.kind === \"other\" && isActive;\n\t}\n\n\t/**\n\t * Render the inline input row across one or more lines, wrapping at `contentWidth`\n\t * so long input doesn't run off the right edge or trip the parent renderer's\n\t * width invariant. Mirrors `renderLabelBlock`'s contract: first line carries\n\t * `rowPrefix`, continuation lines carry `continuationPrefix` (spaces), and every\n\t * emitted line passes through `theme.selectedText`. The trailing cursor glyph\n\t * `▌` is appended to the buffer pre-wrap so it lands at the visual end of the\n\t * input — `Input` only exposes `getValue()` (cursor offset is private), so\n\t * cursor-mid-string is intentionally not rendered here; that would require\n\t * either an `Input.getCursorOffset()` API or delegating to `Input.render`.\n\t */\n\tprivate renderInlineInputRow(rowPrefix: string, continuationPrefix: string, contentWidth: number): string[] {\n\t\tconst raw = `${this.inputBuffer}${WrappingSelect.INPUT_CURSOR}`;\n\t\tconst wrapped = wrapTextWithAnsi(raw, contentWidth);\n\t\treturn wrapped.map((segment, index) => {\n\t\t\tconst prefix = index === 0 ? rowPrefix : continuationPrefix;\n\t\t\treturn this.theme.selectedText(`${prefix}${segment}`);\n\t\t});\n\t}\n\n\tprivate renderLabelBlock(\n\t\tlabel: string,\n\t\trowPrefix: string,\n\t\tcontinuationPrefix: string,\n\t\tcontentWidth: number,\n\t\tapplySelectedStyle: boolean,\n\t): string[] {\n\t\tconst wrapped = wrapTextWithAnsi(label, contentWidth);\n\t\treturn wrapped.map((segment, index) => {\n\t\t\tconst prefix = index === 0 ? rowPrefix : continuationPrefix;\n\t\t\tconst line = `${prefix}${segment}`;\n\t\t\treturn applySelectedStyle ? this.theme.selectedText(line) : line;\n\t\t});\n\t}\n\n\tprivate renderDescriptionBlock(\n\t\tdescription: string | undefined,\n\t\tcontinuationPrefix: string,\n\t\tcontentWidth: number,\n\t): string[] {\n\t\tif (!description) return [];\n\t\tconst wrapped = wrapTextWithAnsi(description, contentWidth);\n\t\treturn wrapped.map((segment) => `${continuationPrefix}${this.theme.description(segment)}`);\n\t}\n}\n"]}

package/dist/core/tools/ask-user-question/view/components/wrapping-select.js

@@ -0,0 +1,161 @@
+import { visibleWidth, wrapTextWithAnsi } from "@earendil-works/pi-tui";
+export class WrappingSelect {
+    static { this.ACTIVE_POINTER = "❯ "; }
+    static { this.INACTIVE_POINTER = "  "; }
+    static { this.NUMBER_SEPARATOR = ". "; }
+    static { this.INPUT_CURSOR = "▌"; }
+    static { this.CONFIRMED_MARK = " ✔"; }
+    static { this.MIN_CONTENT_WIDTH = 1; }
+    constructor(items, maxVisible, theme, options = {}) {
+        this.selectedIndex = 0;
+        this.focused = true;
+        this.inputBuffer = "";
+        /**
+         * Index of the row that was previously confirmed for this list (e.g. the user's prior
+         * answer when re-entering a multi-question tab). Renders `<label> ✔` in the active-row
+         * styling but WITHOUT the `❯` pointer — pointer is reserved for the live cursor. When
+         * `selectedIndex === confirmedIndex && focused`, the active rendering wins (no double-mark).
+         */
+        this.confirmedIndex = undefined;
+        /**
+         * When set together with `confirmedIndex`, replaces the row's static label at render time.
+         * Used for the `kind: "other"` sentinel — its label is "Type something." but if the user's
+         * prior answer was custom text, we render that text instead (e.g. `4. Hello ✔`).
+         */
+        this.confirmedLabelOverride = undefined;
+        this.items = items;
+        this.maxVisible = Math.max(1, maxVisible);
+        this.theme = theme;
+        this.numberStartOffset = options.numberStartOffset ?? 0;
+        this.totalItemsForNumbering = options.totalItemsForNumbering ?? items.length;
+    }
+    /**
+     * Update the numbering offset + total padding width without rebuilding the component.
+     * Used by the host to keep the chat-row WrappingSelect's number aligned with the active tab's
+     * options list when the user switches tabs (each tab can have a different items count).
+     */
+    setNumbering(numberStartOffset, totalItemsForNumbering) {
+        this.numberStartOffset = numberStartOffset;
+        this.totalItemsForNumbering = Math.max(1, totalItemsForNumbering);
+    }
+    setSelectedIndex(index) {
+        this.selectedIndex = Math.max(0, Math.min(index, this.items.length - 1));
+    }
+    setFocused(focused) {
+        this.focused = focused;
+    }
+    /**
+     * Mark a previously-confirmed row. Pass `undefined` to clear. `labelOverride` replaces
+     * the row's static `item.label` at render time — used for the `kind: "other"` sentinel so
+     * the row reads `Hello ✔` instead of `Type something. ✔` when the prior answer was custom
+     * text.
+     */
+    setConfirmedIndex(index, labelOverride) {
+        if (index === undefined) {
+            this.confirmedIndex = undefined;
+            this.confirmedLabelOverride = undefined;
+            return;
+        }
+        this.confirmedIndex = Math.max(0, Math.min(index, this.items.length - 1));
+        this.confirmedLabelOverride = labelOverride;
+    }
+    setInputBuffer(text) {
+        this.inputBuffer = text;
+    }
+    /** Intentionally empty — input is routed at the container level. */
+    handleInput(_data) { }
+    invalidate() { }
+    render(width) {
+        if (this.items.length === 0)
+            return [];
+        const { startIndex, endIndex } = this.computeVisibleWindow();
+        const numberWidth = String(Math.max(1, this.totalItemsForNumbering)).length;
+        const lines = [];
+        for (let i = startIndex; i < endIndex; i++) {
+            const item = this.items[i];
+            if (!item)
+                continue;
+            const isActive = i === this.selectedIndex && this.focused;
+            lines.push(...this.renderItem(item, i, isActive, width, numberWidth));
+        }
+        if (this.hasItemsOutsideWindow(startIndex, endIndex)) {
+            lines.push(this.theme.scrollInfo(`  (${this.selectedIndex + 1}/${this.items.length})`));
+        }
+        return lines;
+    }
+    computeVisibleWindow() {
+        const half = Math.floor(this.maxVisible / 2);
+        const startIndex = Math.max(0, Math.min(this.selectedIndex - half, this.items.length - this.maxVisible));
+        const endIndex = Math.min(startIndex + this.maxVisible, this.items.length);
+        return { startIndex, endIndex };
+    }
+    hasItemsOutsideWindow(startIndex, endIndex) {
+        return startIndex > 0 || endIndex < this.items.length;
+    }
+    renderItem(item, index, isActive, width, numberWidth) {
+        const rowPrefix = this.buildRowPrefix(index, isActive, numberWidth);
+        const continuationPrefix = " ".repeat(visibleWidth(rowPrefix));
+        const contentWidth = Math.max(WrappingSelect.MIN_CONTENT_WIDTH, width - visibleWidth(rowPrefix));
+        if (this.shouldRenderAsInlineInput(item, isActive)) {
+            return this.renderInlineInputRow(rowPrefix, continuationPrefix, contentWidth);
+        }
+        // Confirmed row gets a trailing ` ✔` and accent+bold styling; pointer is independent
+        // (still ❯ when active). When `index === confirmedIndex` AND `isActive`, both `❯` and
+        // `✔` appear on the same row — load-bearing for the case where the prior answer was
+        // row 0 (cursor resets to 0 on tab-back, so the confirmed row IS the active row).
+        // Optional `confirmedLabelOverride` replaces the static label (used for `kind: "other"`
+        // + `kind: "custom"` answer); the inline-input branch above still wins for `kind: "other" + isActive`.
+        const isConfirmed = index === this.confirmedIndex;
+        const label = isConfirmed
+            ? `${this.confirmedLabelOverride ?? item.label}${WrappingSelect.CONFIRMED_MARK}`
+            : item.label;
+        const applySelectedStyle = isActive || isConfirmed;
+        return [
+            ...this.renderLabelBlock(label, rowPrefix, continuationPrefix, contentWidth, applySelectedStyle),
+            ...this.renderDescriptionBlock(item.description, continuationPrefix, contentWidth),
+        ];
+    }
+    buildRowPrefix(index, isActive, numberWidth) {
+        const pointer = isActive ? WrappingSelect.ACTIVE_POINTER : WrappingSelect.INACTIVE_POINTER;
+        const displayNumber = this.numberStartOffset + index + 1;
+        const paddedNumber = String(displayNumber).padStart(numberWidth, " ");
+        return `${pointer}${paddedNumber}${WrappingSelect.NUMBER_SEPARATOR}`;
+    }
+    shouldRenderAsInlineInput(item, isActive) {
+        return item.kind === "other" && isActive;
+    }
+    /**
+     * Render the inline input row across one or more lines, wrapping at `contentWidth`
+     * so long input doesn't run off the right edge or trip the parent renderer's
+     * width invariant. Mirrors `renderLabelBlock`'s contract: first line carries
+     * `rowPrefix`, continuation lines carry `continuationPrefix` (spaces), and every
+     * emitted line passes through `theme.selectedText`. The trailing cursor glyph
+     * `▌` is appended to the buffer pre-wrap so it lands at the visual end of the
+     * input — `Input` only exposes `getValue()` (cursor offset is private), so
+     * cursor-mid-string is intentionally not rendered here; that would require
+     * either an `Input.getCursorOffset()` API or delegating to `Input.render`.
+     */
+    renderInlineInputRow(rowPrefix, continuationPrefix, contentWidth) {
+        const raw = `${this.inputBuffer}${WrappingSelect.INPUT_CURSOR}`;
+        const wrapped = wrapTextWithAnsi(raw, contentWidth);
+        return wrapped.map((segment, index) => {
+            const prefix = index === 0 ? rowPrefix : continuationPrefix;
+            return this.theme.selectedText(`${prefix}${segment}`);
+        });
+    }
+    renderLabelBlock(label, rowPrefix, continuationPrefix, contentWidth, applySelectedStyle) {
+        const wrapped = wrapTextWithAnsi(label, contentWidth);
+        return wrapped.map((segment, index) => {
+            const prefix = index === 0 ? rowPrefix : continuationPrefix;
+            const line = `${prefix}${segment}`;
+            return applySelectedStyle ? this.theme.selectedText(line) : line;
+        });
+    }
+    renderDescriptionBlock(description, continuationPrefix, contentWidth) {
+        if (!description)
+            return [];
+        const wrapped = wrapTextWithAnsi(description, contentWidth);
+        return wrapped.map((segment) => `${continuationPrefix}${this.theme.description(segment)}`);
+    }
+}
+//# sourceMappingURL=wrapping-select.js.map

package/dist/core/tools/ask-user-question/view/components/wrapping-select.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrapping-select.js","sourceRoot":"","sources":["../../../../../../src/core/tools/ask-user-question/view/components/wrapping-select.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Component } from \"@earendil-works/pi-tui\";\nimport { visibleWidth, wrapTextWithAnsi } from \"@earendil-works/pi-tui\";\n\n/**\n * Row-intent discriminated union. `kind` is the single discriminator —\n * pre-1.0.3 boolean flags have been removed (see `banned-flags.test.ts`).\n * Modeled after `QuestionnaireAction` (`key-router.ts:13-32`) and `Effect`\n * (`state-reducer.ts:26-32`) — pure literal-tagged variants, no shared base,\n * exhaustive-`switch` enforcement via non-`void` returns.\n *\n * Variant semantics:\n * - `option`: a regular author-defined option row.\n * - `other`: the inline free-text input row appended to single-select questions\n *   (label is \"Type something.\"). Renders as inline `Input` when active.\n * - `chat`: the abandon-questionnaire escape-hatch row (label is \"Chat about this\").\n * - `next`: the explicit commit-and-advance row appended to multi-select questions\n *   (label is \"Next\"). Renders without a number / checkbox.\n */\nexport type WrappingSelectItem =\n\t| { kind: \"option\"; label: string; description?: string }\n\t| { kind: \"other\"; label: string; description?: string }\n\t| { kind: \"chat\"; label: string; description?: string }\n\t| { kind: \"next\"; label: string; description?: string };\n\nexport interface WrappingSelectTheme {\n\tselectedText: (text: string) => string;\n\tdescription: (text: string) => string;\n\tscrollInfo: (text: string) => string;\n}\n\n/**\n * Numbering controls.\n *\n * Use `numberStartOffset` + `totalItemsForNumbering` when a list is logically a slice of a\n * larger numbered sequence — e.g. the chat row lives in its own WrappingSelect but should\n * render as `(N+1).` where N is the previous list's item count, with the column padded as\n * if both lists were one continuous numbered sequence.\n */\nexport interface WrappingSelectOptions {\n\t/** Start numbering at this offset + 1 (default 0 → rows labeled 1, 2, 3 …). */\n\tnumberStartOffset?: number;\n\t/** Override the total used to pad the number column (useful when items span multiple lists). */\n\ttotalItemsForNumbering?: number;\n}\n\nexport class WrappingSelect implements Component {\n\tprivate static readonly ACTIVE_POINTER = \"❯ \";\n\tprivate static readonly INACTIVE_POINTER = \"  \";\n\tprivate static readonly NUMBER_SEPARATOR = \". \";\n\tprivate static readonly INPUT_CURSOR = \"▌\";\n\tprivate static readonly CONFIRMED_MARK = \" ✔\";\n\tprivate static readonly MIN_CONTENT_WIDTH = 1;\n\n\tprivate readonly items: readonly WrappingSelectItem[];\n\tprivate readonly maxVisible: number;\n\tprivate readonly theme: WrappingSelectTheme;\n\tprivate numberStartOffset: number;\n\tprivate totalItemsForNumbering: number;\n\n\tprivate selectedIndex = 0;\n\tprivate focused = true;\n\tprivate inputBuffer = \"\";\n\t/**\n\t * Index of the row that was previously confirmed for this list (e.g. the user's prior\n\t * answer when re-entering a multi-question tab). Renders `<label> ✔` in the active-row\n\t * styling but WITHOUT the `❯` pointer — pointer is reserved for the live cursor. When\n\t * `selectedIndex === confirmedIndex && focused`, the active rendering wins (no double-mark).\n\t */\n\tprivate confirmedIndex: number | undefined = undefined;\n\t/**\n\t * When set together with `confirmedIndex`, replaces the row's static label at render time.\n\t * Used for the `kind: \"other\"` sentinel — its label is \"Type something.\" but if the user's\n\t * prior answer was custom text, we render that text instead (e.g. `4. Hello ✔`).\n\t */\n\tprivate confirmedLabelOverride: string | undefined = undefined;\n\n\tconstructor(\n\t\titems: readonly WrappingSelectItem[],\n\t\tmaxVisible: number,\n\t\ttheme: WrappingSelectTheme,\n\t\toptions: WrappingSelectOptions = {},\n\t) {\n\t\tthis.items = items;\n\t\tthis.maxVisible = Math.max(1, maxVisible);\n\t\tthis.theme = theme;\n\t\tthis.numberStartOffset = options.numberStartOffset ?? 0;\n\t\tthis.totalItemsForNumbering = options.totalItemsForNumbering ?? items.length;\n\t}\n\n\t/**\n\t * Update the numbering offset + total padding width without rebuilding the component.\n\t * Used by the host to keep the chat-row WrappingSelect's number aligned with the active tab's\n\t * options list when the user switches tabs (each tab can have a different items count).\n\t */\n\tsetNumbering(numberStartOffset: number, totalItemsForNumbering: number): void {\n\t\tthis.numberStartOffset = numberStartOffset;\n\t\tthis.totalItemsForNumbering = Math.max(1, totalItemsForNumbering);\n\t}\n\n\tsetSelectedIndex(index: number): void {\n\t\tthis.selectedIndex = Math.max(0, Math.min(index, this.items.length - 1));\n\t}\n\n\tsetFocused(focused: boolean): void {\n\t\tthis.focused = focused;\n\t}\n\n\t/**\n\t * Mark a previously-confirmed row. Pass `undefined` to clear. `labelOverride` replaces\n\t * the row's static `item.label` at render time — used for the `kind: \"other\"` sentinel so\n\t * the row reads `Hello ✔` instead of `Type something. ✔` when the prior answer was custom\n\t * text.\n\t */\n\tsetConfirmedIndex(index: number | undefined, labelOverride?: string): void {\n\t\tif (index === undefined) {\n\t\t\tthis.confirmedIndex = undefined;\n\t\t\tthis.confirmedLabelOverride = undefined;\n\t\t\treturn;\n\t\t}\n\t\tthis.confirmedIndex = Math.max(0, Math.min(index, this.items.length - 1));\n\t\tthis.confirmedLabelOverride = labelOverride;\n\t}\n\n\tsetInputBuffer(text: string): void {\n\t\tthis.inputBuffer = text;\n\t}\n\n\t/** Intentionally empty — input is routed at the container level. */\n\thandleInput(_data: string): void {}\n\n\tinvalidate(): void {}\n\n\trender(width: number): string[] {\n\t\tif (this.items.length === 0) return [];\n\n\t\tconst { startIndex, endIndex } = this.computeVisibleWindow();\n\t\tconst numberWidth = String(Math.max(1, this.totalItemsForNumbering)).length;\n\t\tconst lines: string[] = [];\n\n\t\tfor (let i = startIndex; i < endIndex; i++) {\n\t\t\tconst item = this.items[i];\n\t\t\tif (!item) continue;\n\t\t\tconst isActive = i === this.selectedIndex && this.focused;\n\t\t\tlines.push(...this.renderItem(item, i, isActive, width, numberWidth));\n\t\t}\n\n\t\tif (this.hasItemsOutsideWindow(startIndex, endIndex)) {\n\t\t\tlines.push(this.theme.scrollInfo(`  (${this.selectedIndex + 1}/${this.items.length})`));\n\t\t}\n\t\treturn lines;\n\t}\n\n\tprivate computeVisibleWindow(): { startIndex: number; endIndex: number } {\n\t\tconst half = Math.floor(this.maxVisible / 2);\n\t\tconst startIndex = Math.max(0, Math.min(this.selectedIndex - half, this.items.length - this.maxVisible));\n\t\tconst endIndex = Math.min(startIndex + this.maxVisible, this.items.length);\n\t\treturn { startIndex, endIndex };\n\t}\n\n\tprivate hasItemsOutsideWindow(startIndex: number, endIndex: number): boolean {\n\t\treturn startIndex > 0 || endIndex < this.items.length;\n\t}\n\n\tprivate renderItem(\n\t\titem: WrappingSelectItem,\n\t\tindex: number,\n\t\tisActive: boolean,\n\t\twidth: number,\n\t\tnumberWidth: number,\n\t): string[] {\n\t\tconst rowPrefix = this.buildRowPrefix(index, isActive, numberWidth);\n\t\tconst continuationPrefix = \" \".repeat(visibleWidth(rowPrefix));\n\t\tconst contentWidth = Math.max(WrappingSelect.MIN_CONTENT_WIDTH, width - visibleWidth(rowPrefix));\n\n\t\tif (this.shouldRenderAsInlineInput(item, isActive)) {\n\t\t\treturn this.renderInlineInputRow(rowPrefix, continuationPrefix, contentWidth);\n\t\t}\n\n\t\t// Confirmed row gets a trailing ` ✔` and accent+bold styling; pointer is independent\n\t\t// (still ❯ when active). When `index === confirmedIndex` AND `isActive`, both `❯` and\n\t\t// `✔` appear on the same row — load-bearing for the case where the prior answer was\n\t\t// row 0 (cursor resets to 0 on tab-back, so the confirmed row IS the active row).\n\t\t// Optional `confirmedLabelOverride` replaces the static label (used for `kind: \"other\"`\n\t\t// + `kind: \"custom\"` answer); the inline-input branch above still wins for `kind: \"other\" + isActive`.\n\t\tconst isConfirmed = index === this.confirmedIndex;\n\t\tconst label = isConfirmed\n\t\t\t? `${this.confirmedLabelOverride ?? item.label}${WrappingSelect.CONFIRMED_MARK}`\n\t\t\t: item.label;\n\t\tconst applySelectedStyle = isActive || isConfirmed;\n\n\t\treturn [\n\t\t\t...this.renderLabelBlock(label, rowPrefix, continuationPrefix, contentWidth, applySelectedStyle),\n\t\t\t...this.renderDescriptionBlock(item.description, continuationPrefix, contentWidth),\n\t\t];\n\t}\n\n\tprivate buildRowPrefix(index: number, isActive: boolean, numberWidth: number): string {\n\t\tconst pointer = isActive ? WrappingSelect.ACTIVE_POINTER : WrappingSelect.INACTIVE_POINTER;\n\t\tconst displayNumber = this.numberStartOffset + index + 1;\n\t\tconst paddedNumber = String(displayNumber).padStart(numberWidth, \" \");\n\t\treturn `${pointer}${paddedNumber}${WrappingSelect.NUMBER_SEPARATOR}`;\n\t}\n\n\tprivate shouldRenderAsInlineInput(item: WrappingSelectItem, isActive: boolean): boolean {\n\t\treturn item.kind === \"other\" && isActive;\n\t}\n\n\t/**\n\t * Render the inline input row across one or more lines, wrapping at `contentWidth`\n\t * so long input doesn't run off the right edge or trip the parent renderer's\n\t * width invariant. Mirrors `renderLabelBlock`'s contract: first line carries\n\t * `rowPrefix`, continuation lines carry `continuationPrefix` (spaces), and every\n\t * emitted line passes through `theme.selectedText`. The trailing cursor glyph\n\t * `▌` is appended to the buffer pre-wrap so it lands at the visual end of the\n\t * input — `Input` only exposes `getValue()` (cursor offset is private), so\n\t * cursor-mid-string is intentionally not rendered here; that would require\n\t * either an `Input.getCursorOffset()` API or delegating to `Input.render`.\n\t */\n\tprivate renderInlineInputRow(rowPrefix: string, continuationPrefix: string, contentWidth: number): string[] {\n\t\tconst raw = `${this.inputBuffer}${WrappingSelect.INPUT_CURSOR}`;\n\t\tconst wrapped = wrapTextWithAnsi(raw, contentWidth);\n\t\treturn wrapped.map((segment, index) => {\n\t\t\tconst prefix = index === 0 ? rowPrefix : continuationPrefix;\n\t\t\treturn this.theme.selectedText(`${prefix}${segment}`);\n\t\t});\n\t}\n\n\tprivate renderLabelBlock(\n\t\tlabel: string,\n\t\trowPrefix: string,\n\t\tcontinuationPrefix: string,\n\t\tcontentWidth: number,\n\t\tapplySelectedStyle: boolean,\n\t): string[] {\n\t\tconst wrapped = wrapTextWithAnsi(label, contentWidth);\n\t\treturn wrapped.map((segment, index) => {\n\t\t\tconst prefix = index === 0 ? rowPrefix : continuationPrefix;\n\t\t\tconst line = `${prefix}${segment}`;\n\t\t\treturn applySelectedStyle ? this.theme.selectedText(line) : line;\n\t\t});\n\t}\n\n\tprivate renderDescriptionBlock(\n\t\tdescription: string | undefined,\n\t\tcontinuationPrefix: string,\n\t\tcontentWidth: number,\n\t): string[] {\n\t\tif (!description) return [];\n\t\tconst wrapped = wrapTextWithAnsi(description, contentWidth);\n\t\treturn wrapped.map((segment) => `${continuationPrefix}${this.theme.description(segment)}`);\n\t}\n}\n"]}

package/dist/core/tools/ask-user-question/view/dialog-builder.d.ts

@@ -0,0 +1,66 @@
+import type { Theme } from "../../../../modes/interactive/theme/theme.js";
+import { type Component, type Input } from "@earendil-works/pi-tui";
+import type { QuestionnaireState } from "../state/state.js";
+import type { QuestionData } from "../tool/types.js";
+import type { ChatRowView } from "./components/chat-row-view.js";
+import type { PreviewPaneProps } from "./components/preview/preview-pane.js";
+import type { TabBar } from "./components/tab-bar.js";
+import type { StatefulView } from "./stateful-view.js";
+import type { TabComponents } from "./tab-components.js";
+export declare const HINT_PART_ENTER = "Enter to select";
+export declare const HINT_PART_NAV = "\u2191/\u2193 to navigate";
+export declare const HINT_PART_TOGGLE = "Space to toggle";
+export declare const HINT_PART_NOTES = "n to add notes";
+export declare const HINT_PART_TAB = "Tab to switch questions";
+export declare const HINT_PART_CANCEL = "Esc to cancel";
+export declare const HINT_SINGLE: string;
+export declare const HINT_MULTI: string;
+export declare const HINT_MULTISELECT_SUFFIX = " \u00B7 Space to toggle";
+export declare const HINT_NOTES_SUFFIX = " \u00B7 n to add notes";
+export declare const REVIEW_HEADING = "Review your answers";
+export declare const READY_PROMPT = "Ready to submit your answers?";
+export declare const INCOMPLETE_WARNING_PREFIX = "\u26A0 Answer remaining questions before submitting:";
+export type DialogState = QuestionnaireState;
+/** Per-tick projection of dialog state. Written by the adapter; read by the strategy thunk. */
+export interface DialogProps {
+    state: DialogState;
+    activePreviewPane: StatefulView<PreviewPaneProps>;
+}
+/** Construction-time config for `DialogView`. Frozen after construction. */
+export interface DialogConfig {
+    theme: Theme;
+    questions: readonly QuestionData[];
+    tabBar: TabBar | undefined;
+    notesInput: Input;
+    chatRow: ChatRowView;
+    isMulti: boolean;
+    tabsByIndex: ReadonlyArray<TabComponents>;
+    /** Optional so single-question mode and non-submit tests can omit it; SubmitTabStrategy falls back to Spacer rows. */
+    submitPicker?: Component;
+    /** Worst-case body height across all tabs/options. Determines the stable overall dialog footprint. */
+    getBodyHeight: (width: number) => number;
+    /** Body height of the CURRENTLY active tab/option. The chrome subtracts this from `getBodyHeight` to absorb the residual OUTSIDE the bordered region. */
+    getCurrentBodyHeight: (width: number) => number;
+}
+/**
+ * The 7th renderable, promoted from a structural literal to a named class so
+ * all view-layer components share one explicit `implements StatefulView<P>`
+ * contract. `setProps(DialogProps)` writes the live cell read by the
+ * strategy thunk during `render()`. `liveProps.activePreviewPane` is a
+ * resolved pane reference threaded by the adapter per tick — the dialog
+ * itself does not derive it.
+ */
+export declare class DialogView implements StatefulView<DialogProps> {
+    private liveProps;
+    private readonly config;
+    private readonly questionStrategy;
+    private readonly submitStrategy;
+    private readonly maxFooterRowCount;
+    constructor(config: DialogConfig, initialProps: DialogProps);
+    setProps(props: DialogProps): void;
+    handleInput(_data: string): void;
+    invalidate(): void;
+    render(width: number): string[];
+    private buildContainerFromStrategy;
+}
+//# sourceMappingURL=dialog-builder.d.ts.map