@bastani/atomic 0.7.17 → 0.8.0

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

@@ -0,0 +1,91 @@
+import { truncateToWidth, visibleWidth, wrapTextWithAnsi } from "@earendil-works/pi-tui";
+import { ROW_INTENT_META } from "../../state/row-intent.js";
+const ACTIVE_POINTER = "❯ ";
+const INACTIVE_POINTER = "  ";
+const CHECKED = "[✔]";
+const UNCHECKED = "[ ]";
+const NUMBER_SEPARATOR = ". ";
+const BOX_LABEL_GAP = " ";
+// CC parity: description continuation indents to col 2 (past the pointer slot), NOT to the
+// full prefix column. Wrap width still uses prefixVisibleWidth so naturalHeight matches render.
+const CONTINUATION_INDENT = "  ";
+export const MULTI_SUBMIT_LABEL = "Submit";
+/**
+ * Renders the multi-select option list (one row per option — pointer + checkbox + label —
+ * plus zero or more wrapped continuation lines per description).
+ *
+ * `naturalHeight(width)` is state-INDEPENDENT (depends only on theme glyph widths,
+ * question.options, and width) so the host can compute a stable globalContentHeight
+ * without rendering. `naturalHeight(w) === render(w).length` for every props.
+ *
+ * `setProps(props)` is a pure field reassignment — no render, no invalidate side effects.
+ */
+export class MultiSelectView {
+    constructor(theme, question) {
+        this.theme = theme;
+        this.question = question;
+        this.props = { rows: [], nextActive: false, nextLabel: ROW_INTENT_META.next.label };
+    }
+    setProps(props) {
+        this.props = props;
+    }
+    handleInput(_data) { }
+    invalidate() { }
+    render(width) {
+        const lines = [];
+        const prefixWidth = this.prefixVisibleWidth();
+        const contentWidth = Math.max(1, width - prefixWidth);
+        const numberWidth = String(Math.max(1, this.question.options.length)).length;
+        for (let i = 0; i < this.question.options.length; i++) {
+            const opt = this.question.options[i];
+            const row = this.props.rows[i];
+            if (!opt || !row)
+                continue;
+            const pointer = row.active ? this.theme.fg("accent", ACTIVE_POINTER) : INACTIVE_POINTER;
+            // Checked uses the same `accent` hue as the active-row label so checked rows read
+            // as "selected" rather than "success" — matches the visual rhythm of the rest of
+            // the dialog (active pointer, label, picker rows are all accent).
+            const box = row.checked ? this.theme.fg("accent", CHECKED) : this.theme.fg("muted", UNCHECKED);
+            const label = truncateToWidth(opt.label, contentWidth, "…");
+            const styledLabel = row.active ? this.theme.fg("accent", this.theme.bold(label)) : label;
+            const num = String(i + 1).padStart(numberWidth, " ");
+            const line = `${pointer}${num}${NUMBER_SEPARATOR}${box}${BOX_LABEL_GAP}${styledLabel}`;
+            lines.push(truncateToWidth(line, width, ""));
+            if (opt.description) {
+                const wrapped = wrapTextWithAnsi(opt.description, contentWidth);
+                for (const segment of wrapped) {
+                    lines.push(CONTINUATION_INDENT + this.theme.fg("muted", segment));
+                }
+            }
+        }
+        const nextPointer = this.props.nextActive ? this.theme.fg("accent", ACTIVE_POINTER) : INACTIVE_POINTER;
+        const nextLabel = this.props.nextActive
+            ? this.theme.fg("accent", this.theme.bold(this.props.nextLabel))
+            : this.props.nextLabel;
+        lines.push(truncateToWidth(`${nextPointer}${nextLabel}`, width, ""));
+        return lines;
+    }
+    naturalHeight(width) {
+        const contentWidth = Math.max(1, width - this.prefixVisibleWidth());
+        let total = 0;
+        for (const opt of this.question.options) {
+            if (!opt)
+                continue;
+            total += 1; // row line
+            if (opt.description) {
+                total += wrapTextWithAnsi(opt.description, contentWidth).length;
+            }
+        }
+        return total + 1; // Next sentinel row (no description; never wraps).
+    }
+    prefixVisibleWidth() {
+        // Canonical prefix for OPTION rows: INACTIVE_POINTER + numberWidth digits + NUMBER_SEPARATOR
+        // + UNCHECKED + BOX_LABEL_GAP. State-independent because ACTIVE/INACTIVE pointer share
+        // visibleWidth, CHECKED/UNCHECKED share visibleWidth, and numberWidth is constant per question.
+        // The Next sentinel uses a bare `pointer + "Next"` shape — its width never exceeds this prefix
+        // at any reasonable terminal width, so it's safe to leave it out of the canonical computation.
+        const numberWidth = String(Math.max(1, this.question.options.length)).length;
+        return (visibleWidth(INACTIVE_POINTER) + numberWidth + visibleWidth(`${NUMBER_SEPARATOR}${UNCHECKED}${BOX_LABEL_GAP}`));
+    }
+}
+//# sourceMappingURL=multi-select-view.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"multi-select-view.js","sourceRoot":"","sources":["../../../../../../src/core/tools/ask-user-question/view/components/multi-select-view.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Theme } from \"../../../../../modes/interactive/theme/theme.js\";\nimport { truncateToWidth, visibleWidth, wrapTextWithAnsi } from \"@earendil-works/pi-tui\";\nimport { ROW_INTENT_META } from \"../../state/row-intent.js\";\nimport type { QuestionData } from \"../../tool/types.js\";\nimport type { StatefulView } from \"../stateful-view.js\";\n\nconst ACTIVE_POINTER = \"❯ \";\nconst INACTIVE_POINTER = \"  \";\nconst CHECKED = \"[✔]\";\nconst UNCHECKED = \"[ ]\";\nconst NUMBER_SEPARATOR = \". \";\nconst BOX_LABEL_GAP = \" \";\n// CC parity: description continuation indents to col 2 (past the pointer slot), NOT to the\n// full prefix column. Wrap width still uses prefixVisibleWidth so naturalHeight matches render.\nconst CONTINUATION_INDENT = \"  \";\n\nexport const MULTI_SUBMIT_LABEL = \"Submit\";\n\nexport interface MultiSelectViewProps {\n\trows: ReadonlyArray<{ checked: boolean; active: boolean }>;\n\tnextActive: boolean;\n\tnextLabel: string;\n}\n\n/**\n * Renders the multi-select option list (one row per option — pointer + checkbox + label —\n * plus zero or more wrapped continuation lines per description).\n *\n * `naturalHeight(width)` is state-INDEPENDENT (depends only on theme glyph widths,\n * question.options, and width) so the host can compute a stable globalContentHeight\n * without rendering. `naturalHeight(w) === render(w).length` for every props.\n *\n * `setProps(props)` is a pure field reassignment — no render, no invalidate side effects.\n */\nexport class MultiSelectView implements StatefulView<MultiSelectViewProps> {\n\tprivate props: MultiSelectViewProps;\n\n\tconstructor(\n\t\tprivate readonly theme: Theme,\n\t\tprivate readonly question: QuestionData,\n\t) {\n\t\tthis.props = { rows: [], nextActive: false, nextLabel: ROW_INTENT_META.next.label };\n\t}\n\n\tsetProps(props: MultiSelectViewProps): 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 lines: string[] = [];\n\t\tconst prefixWidth = this.prefixVisibleWidth();\n\t\tconst contentWidth = Math.max(1, width - prefixWidth);\n\t\tconst numberWidth = String(Math.max(1, this.question.options.length)).length;\n\t\tfor (let i = 0; i < this.question.options.length; i++) {\n\t\t\tconst opt = this.question.options[i];\n\t\t\tconst row = this.props.rows[i];\n\t\t\tif (!opt || !row) continue;\n\t\t\tconst pointer = row.active ? this.theme.fg(\"accent\", ACTIVE_POINTER) : INACTIVE_POINTER;\n\t\t\t// Checked uses the same `accent` hue as the active-row label so checked rows read\n\t\t\t// as \"selected\" rather than \"success\" — matches the visual rhythm of the rest of\n\t\t\t// the dialog (active pointer, label, picker rows are all accent).\n\t\t\tconst box = row.checked ? this.theme.fg(\"accent\", CHECKED) : this.theme.fg(\"muted\", UNCHECKED);\n\t\t\tconst label = truncateToWidth(opt.label, contentWidth, \"…\");\n\t\t\tconst styledLabel = row.active ? this.theme.fg(\"accent\", this.theme.bold(label)) : label;\n\t\t\tconst num = String(i + 1).padStart(numberWidth, \" \");\n\t\t\tconst line = `${pointer}${num}${NUMBER_SEPARATOR}${box}${BOX_LABEL_GAP}${styledLabel}`;\n\t\t\tlines.push(truncateToWidth(line, width, \"\"));\n\t\t\tif (opt.description) {\n\t\t\t\tconst wrapped = wrapTextWithAnsi(opt.description, contentWidth);\n\t\t\t\tfor (const segment of wrapped) {\n\t\t\t\t\tlines.push(CONTINUATION_INDENT + this.theme.fg(\"muted\", segment));\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\tconst nextPointer = this.props.nextActive ? this.theme.fg(\"accent\", ACTIVE_POINTER) : INACTIVE_POINTER;\n\t\tconst nextLabel = this.props.nextActive\n\t\t\t? this.theme.fg(\"accent\", this.theme.bold(this.props.nextLabel))\n\t\t\t: this.props.nextLabel;\n\t\tlines.push(truncateToWidth(`${nextPointer}${nextLabel}`, width, \"\"));\n\t\treturn lines;\n\t}\n\n\tnaturalHeight(width: number): number {\n\t\tconst contentWidth = Math.max(1, width - this.prefixVisibleWidth());\n\t\tlet total = 0;\n\t\tfor (const opt of this.question.options) {\n\t\t\tif (!opt) continue;\n\t\t\ttotal += 1; // row line\n\t\t\tif (opt.description) {\n\t\t\t\ttotal += wrapTextWithAnsi(opt.description, contentWidth).length;\n\t\t\t}\n\t\t}\n\t\treturn total + 1; // Next sentinel row (no description; never wraps).\n\t}\n\n\tprivate prefixVisibleWidth(): number {\n\t\t// Canonical prefix for OPTION rows: INACTIVE_POINTER + numberWidth digits + NUMBER_SEPARATOR\n\t\t// + UNCHECKED + BOX_LABEL_GAP. State-independent because ACTIVE/INACTIVE pointer share\n\t\t// visibleWidth, CHECKED/UNCHECKED share visibleWidth, and numberWidth is constant per question.\n\t\t// The Next sentinel uses a bare `pointer + \"Next\"` shape — its width never exceeds this prefix\n\t\t// at any reasonable terminal width, so it's safe to leave it out of the canonical computation.\n\t\tconst numberWidth = String(Math.max(1, this.question.options.length)).length;\n\t\treturn (\n\t\t\tvisibleWidth(INACTIVE_POINTER) + numberWidth + visibleWidth(`${NUMBER_SEPARATOR}${UNCHECKED}${BOX_LABEL_GAP}`)\n\t\t);\n\t}\n}\n"]}

package/dist/core/tools/ask-user-question/view/components/option-list-view.d.ts

@@ -0,0 +1,43 @@
+import type { StatefulView } from "../stateful-view.js";
+import { type WrappingSelectItem, type WrappingSelectTheme } from "./wrapping-select.js";
+/**
+ * Maximum number of option rows visible in the WrappingSelect window. Lifted here from
+ * `preview-pane.ts` so the cap travels with the option-list owner.
+ */
+export declare const MAX_VISIBLE_OPTIONS = 10;
+export interface OptionListViewConfig {
+    items: readonly WrappingSelectItem[];
+    theme: WrappingSelectTheme;
+}
+/**
+ * Per-tick projection of OptionListView state. After Phase 11b, `inputBuffer`
+ * is part of the props bag — the session-owned `inlineInput` (a headless
+ * `pi-tui` Input instance) supplies its current `getValue()` here per tick.
+ * `OptionListView` is purely props-driven; the imperative buffer surface and
+ * read-back getters are gone.
+ */
+export interface OptionListViewProps {
+    selectedIndex: number;
+    focused: boolean;
+    inputBuffer: string;
+    /** Optional previously-confirmed indicator. Omit when no marker should be drawn. */
+    confirmed?: {
+        index: number;
+        labelOverride?: string;
+    };
+}
+/**
+ * Sole owner of the option list's interactive state. Wraps a single
+ * `WrappingSelect`. Implements `StatefulView<OptionListViewProps>`:
+ * `setProps` is the only mutator; render output reflects the last props
+ * received.
+ */
+export declare class OptionListView implements StatefulView<OptionListViewProps> {
+    private readonly select;
+    constructor(config: OptionListViewConfig);
+    setProps(props: OptionListViewProps): void;
+    handleInput(_data: string): void;
+    invalidate(): void;
+    render(width: number): string[];
+}
+//# sourceMappingURL=option-list-view.d.ts.map

package/dist/core/tools/ask-user-question/view/components/option-list-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"option-list-view.d.ts","sourceRoot":"","sources":["../../../../../../src/core/tools/ask-user-question/view/components/option-list-view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAkB,KAAK,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEzG;;;GAGG;AACH,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC,MAAM,WAAW,oBAAoB;IACpC,KAAK,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACrC,KAAK,EAAE,mBAAmB,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,oFAAoF;IACpF,SAAS,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACtD;AAED;;;;;GAKG;AACH,qBAAa,cAAe,YAAW,YAAY,CAAC,mBAAmB,CAAC;IACvE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IAExC,YAAY,MAAM,EAAE,oBAAoB,EAQvC;IAED,QAAQ,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAKzC;IAED,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAG;IAEnC,UAAU,IAAI,IAAI,CAEjB;IAED,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAE9B;CACD","sourcesContent":["import type { StatefulView } from \"../stateful-view.js\";\nimport { WrappingSelect, type WrappingSelectItem, type WrappingSelectTheme } from \"./wrapping-select.js\";\n\n/**\n * Maximum number of option rows visible in the WrappingSelect window. Lifted here from\n * `preview-pane.ts` so the cap travels with the option-list owner.\n */\nexport const MAX_VISIBLE_OPTIONS = 10;\n\nexport interface OptionListViewConfig {\n\titems: readonly WrappingSelectItem[];\n\ttheme: WrappingSelectTheme;\n}\n\n/**\n * Per-tick projection of OptionListView state. After Phase 11b, `inputBuffer`\n * is part of the props bag — the session-owned `inlineInput` (a headless\n * `pi-tui` Input instance) supplies its current `getValue()` here per tick.\n * `OptionListView` is purely props-driven; the imperative buffer surface and\n * read-back getters are gone.\n */\nexport interface OptionListViewProps {\n\tselectedIndex: number;\n\tfocused: boolean;\n\tinputBuffer: string;\n\t/** Optional previously-confirmed indicator. Omit when no marker should be drawn. */\n\tconfirmed?: { index: number; labelOverride?: string };\n}\n\n/**\n * Sole owner of the option list's interactive state. Wraps a single\n * `WrappingSelect`. Implements `StatefulView<OptionListViewProps>`:\n * `setProps` is the only mutator; render output reflects the last props\n * received.\n */\nexport class OptionListView implements StatefulView<OptionListViewProps> {\n\tprivate readonly select: WrappingSelect;\n\n\tconstructor(config: OptionListViewConfig) {\n\t\t// Reserve a slot for the chat row in the WrappingSelect's number-padding so\n\t\t// the column width is identical whether or not the user navigates into chat\n\t\t// (chat row uses items.length + 1).\n\t\tthis.select = new WrappingSelect(config.items, Math.min(config.items.length, MAX_VISIBLE_OPTIONS), config.theme, {\n\t\t\tnumberStartOffset: 0,\n\t\t\ttotalItemsForNumbering: config.items.length + 1,\n\t\t});\n\t}\n\n\tsetProps(props: OptionListViewProps): void {\n\t\tthis.select.setSelectedIndex(props.selectedIndex);\n\t\tthis.select.setFocused(props.focused);\n\t\tthis.select.setConfirmedIndex(props.confirmed?.index, props.confirmed?.labelOverride);\n\t\tthis.select.setInputBuffer(props.inputBuffer);\n\t}\n\n\thandleInput(_data: string): void {}\n\n\tinvalidate(): void {\n\t\tthis.select.invalidate();\n\t}\n\n\trender(width: number): string[] {\n\t\treturn this.select.render(width);\n\t}\n}\n"]}

package/dist/core/tools/ask-user-question/view/components/option-list-view.js

@@ -0,0 +1,37 @@
+import { WrappingSelect } from "./wrapping-select.js";
+/**
+ * Maximum number of option rows visible in the WrappingSelect window. Lifted here from
+ * `preview-pane.ts` so the cap travels with the option-list owner.
+ */
+export const MAX_VISIBLE_OPTIONS = 10;
+/**
+ * Sole owner of the option list's interactive state. Wraps a single
+ * `WrappingSelect`. Implements `StatefulView<OptionListViewProps>`:
+ * `setProps` is the only mutator; render output reflects the last props
+ * received.
+ */
+export class OptionListView {
+    constructor(config) {
+        // Reserve a slot for the chat row in the WrappingSelect's number-padding so
+        // the column width is identical whether or not the user navigates into chat
+        // (chat row uses items.length + 1).
+        this.select = new WrappingSelect(config.items, Math.min(config.items.length, MAX_VISIBLE_OPTIONS), config.theme, {
+            numberStartOffset: 0,
+            totalItemsForNumbering: config.items.length + 1,
+        });
+    }
+    setProps(props) {
+        this.select.setSelectedIndex(props.selectedIndex);
+        this.select.setFocused(props.focused);
+        this.select.setConfirmedIndex(props.confirmed?.index, props.confirmed?.labelOverride);
+        this.select.setInputBuffer(props.inputBuffer);
+    }
+    handleInput(_data) { }
+    invalidate() {
+        this.select.invalidate();
+    }
+    render(width) {
+        return this.select.render(width);
+    }
+}
+//# sourceMappingURL=option-list-view.js.map

package/dist/core/tools/ask-user-question/view/components/option-list-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"option-list-view.js","sourceRoot":"","sources":["../../../../../../src/core/tools/ask-user-question/view/components/option-list-view.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAqD,MAAM,sBAAsB,CAAC;AAEzG;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAsBtC;;;;;GAKG;AACH,MAAM,OAAO,cAAc;IAG1B,YAAY,MAA4B;QACvC,4EAA4E;QAC5E,4EAA4E;QAC5E,oCAAoC;QACpC,IAAI,CAAC,MAAM,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,mBAAmB,CAAC,EAAE,MAAM,CAAC,KAAK,EAAE;YAChH,iBAAiB,EAAE,CAAC;YACpB,sBAAsB,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;SAC/C,CAAC,CAAC;IACJ,CAAC;IAED,QAAQ,CAAC,KAA0B;QAClC,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QACtF,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC/C,CAAC;IAED,WAAW,CAAC,KAAa,IAAS,CAAC;IAEnC,UAAU;QACT,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;IAC1B,CAAC;IAED,MAAM,CAAC,KAAa;QACnB,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;CACD","sourcesContent":["import type { StatefulView } from \"../stateful-view.js\";\nimport { WrappingSelect, type WrappingSelectItem, type WrappingSelectTheme } from \"./wrapping-select.js\";\n\n/**\n * Maximum number of option rows visible in the WrappingSelect window. Lifted here from\n * `preview-pane.ts` so the cap travels with the option-list owner.\n */\nexport const MAX_VISIBLE_OPTIONS = 10;\n\nexport interface OptionListViewConfig {\n\titems: readonly WrappingSelectItem[];\n\ttheme: WrappingSelectTheme;\n}\n\n/**\n * Per-tick projection of OptionListView state. After Phase 11b, `inputBuffer`\n * is part of the props bag — the session-owned `inlineInput` (a headless\n * `pi-tui` Input instance) supplies its current `getValue()` here per tick.\n * `OptionListView` is purely props-driven; the imperative buffer surface and\n * read-back getters are gone.\n */\nexport interface OptionListViewProps {\n\tselectedIndex: number;\n\tfocused: boolean;\n\tinputBuffer: string;\n\t/** Optional previously-confirmed indicator. Omit when no marker should be drawn. */\n\tconfirmed?: { index: number; labelOverride?: string };\n}\n\n/**\n * Sole owner of the option list's interactive state. Wraps a single\n * `WrappingSelect`. Implements `StatefulView<OptionListViewProps>`:\n * `setProps` is the only mutator; render output reflects the last props\n * received.\n */\nexport class OptionListView implements StatefulView<OptionListViewProps> {\n\tprivate readonly select: WrappingSelect;\n\n\tconstructor(config: OptionListViewConfig) {\n\t\t// Reserve a slot for the chat row in the WrappingSelect's number-padding so\n\t\t// the column width is identical whether or not the user navigates into chat\n\t\t// (chat row uses items.length + 1).\n\t\tthis.select = new WrappingSelect(config.items, Math.min(config.items.length, MAX_VISIBLE_OPTIONS), config.theme, {\n\t\t\tnumberStartOffset: 0,\n\t\t\ttotalItemsForNumbering: config.items.length + 1,\n\t\t});\n\t}\n\n\tsetProps(props: OptionListViewProps): void {\n\t\tthis.select.setSelectedIndex(props.selectedIndex);\n\t\tthis.select.setFocused(props.focused);\n\t\tthis.select.setConfirmedIndex(props.confirmed?.index, props.confirmed?.labelOverride);\n\t\tthis.select.setInputBuffer(props.inputBuffer);\n\t}\n\n\thandleInput(_data: string): void {}\n\n\tinvalidate(): void {\n\t\tthis.select.invalidate();\n\t}\n\n\trender(width: number): string[] {\n\t\treturn this.select.render(width);\n\t}\n}\n"]}

package/dist/core/tools/ask-user-question/view/components/preview/markdown-content-cache.d.ts

@@ -0,0 +1,36 @@
+import type { Theme } from "../../../../../../modes/interactive/theme/theme.js";
+import { type MarkdownTheme } from "@earendil-works/pi-tui";
+import type { QuestionData } from "../../../tool/types.js";
+/** CC parity in side-by-side layout. */
+export declare const MAX_PREVIEW_HEIGHT_SIDE_BY_SIDE = 20;
+/** Preserves narrow-terminal protection in stacked layout. */
+export declare const MAX_PREVIEW_HEIGHT_STACKED = 15;
+export declare const NO_PREVIEW_TEXT = "No preview available";
+/** 1 blank separator + 1 affordance text row reserved when `hasAnyPreview` (height stability of the affordance row's offset relative to the box). */
+export declare const NOTES_AFFORDANCE_OVERHEAD = 2;
+/**
+ * Per-question cache for rendered markdown previews. Width-keyed: switching the
+ * inner width invalidates every cached `Markdown`'s render output (pi-tui's
+ * `Markdown.render(width)` re-wraps when width changes).
+ *
+ * Replaces the inline `previewTexts`, `markdownCache`, `cachedWidth` triple from
+ * the previous monolithic `preview-pane.ts`. One Markdown per option, lazy on
+ * first request, never re-constructed — count semantics frozen by tests.
+ */
+export declare class MarkdownContentCache {
+    private readonly previewTexts;
+    private readonly markdownCache;
+    private cachedWidth;
+    private readonly theme;
+    private readonly markdownTheme;
+    constructor(question: QuestionData, theme: Theme, markdownTheme: MarkdownTheme);
+    hasAnyPreview(): boolean;
+    has(optionIndex: number): boolean;
+    /**
+     * Compute the body lines for a given option at a given inner width. Width changes
+     * invalidate the per-Markdown render cache.
+     */
+    bodyFor(optionIndex: number, innerWidth: number): string[];
+    invalidate(): void;
+}
+//# sourceMappingURL=markdown-content-cache.d.ts.map

package/dist/core/tools/ask-user-question/view/components/preview/markdown-content-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-content-cache.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/tools/ask-user-question/view/components/preview/markdown-content-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oDAAoD,CAAC;AAChF,OAAO,EAAY,KAAK,aAAa,EAAgB,MAAM,wBAAwB,CAAC;AACpF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAG3D,wCAAwC;AACxC,eAAO,MAAM,+BAA+B,KAAK,CAAC;AAClD,8DAA8D;AAC9D,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAC7C,eAAO,MAAM,eAAe,yBAAyB,CAAC;AACtD,qJAAqJ;AACrJ,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C;;;;;;;;GAQG;AACH,qBAAa,oBAAoB;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsB;IACnD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAwB;IACtD,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAE9C,YAAY,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,aAAa,EAS7E;IAED,aAAa,IAAI,OAAO,CAEvB;IAED,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAEhC;IAED;;;OAGG;IACH,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAiBzD;IAED,UAAU,IAAI,IAAI,CAGjB;CACD","sourcesContent":["import type { Theme } from \"../../../../../../modes/interactive/theme/theme.js\";\nimport { Markdown, type MarkdownTheme, visibleWidth } from \"@earendil-works/pi-tui\";\nimport type { QuestionData } from \"../../../tool/types.js\";\nimport { stripFenceMarkers } from \"./preview-box-renderer.js\";\n\n/** CC parity in side-by-side layout. */\nexport const MAX_PREVIEW_HEIGHT_SIDE_BY_SIDE = 20;\n/** Preserves narrow-terminal protection in stacked layout. */\nexport const MAX_PREVIEW_HEIGHT_STACKED = 15;\nexport const NO_PREVIEW_TEXT = \"No preview available\";\n/** 1 blank separator + 1 affordance text row reserved when `hasAnyPreview` (height stability of the affordance row's offset relative to the box). */\nexport const NOTES_AFFORDANCE_OVERHEAD = 2;\n\n/**\n * Per-question cache for rendered markdown previews. Width-keyed: switching the\n * inner width invalidates every cached `Markdown`'s render output (pi-tui's\n * `Markdown.render(width)` re-wraps when width changes).\n *\n * Replaces the inline `previewTexts`, `markdownCache`, `cachedWidth` triple from\n * the previous monolithic `preview-pane.ts`. One Markdown per option, lazy on\n * first request, never re-constructed — count semantics frozen by tests.\n */\nexport class MarkdownContentCache {\n\tprivate readonly previewTexts: Map<number, string>;\n\tprivate readonly markdownCache: Map<number, Markdown>;\n\tprivate cachedWidth: number | undefined;\n\tprivate readonly theme: Theme;\n\tprivate readonly markdownTheme: MarkdownTheme;\n\n\tconstructor(question: QuestionData, theme: Theme, markdownTheme: MarkdownTheme) {\n\t\tthis.theme = theme;\n\t\tthis.markdownTheme = markdownTheme;\n\t\tthis.previewTexts = new Map();\n\t\tfor (let i = 0; i < question.options.length; i++) {\n\t\t\tconst raw = question.options[i]?.preview;\n\t\t\tif (raw && raw.length > 0) this.previewTexts.set(i, raw);\n\t\t}\n\t\tthis.markdownCache = new Map();\n\t}\n\n\thasAnyPreview(): boolean {\n\t\treturn this.previewTexts.size > 0;\n\t}\n\n\thas(optionIndex: number): boolean {\n\t\treturn this.previewTexts.has(optionIndex);\n\t}\n\n\t/**\n\t * Compute the body lines for a given option at a given inner width. Width changes\n\t * invalidate the per-Markdown render cache.\n\t */\n\tbodyFor(optionIndex: number, innerWidth: number): string[] {\n\t\tif (this.cachedWidth !== innerWidth) {\n\t\t\tfor (const md of this.markdownCache.values()) md.invalidate();\n\t\t\tthis.cachedWidth = innerWidth;\n\t\t}\n\t\tconst text = this.previewTexts.get(optionIndex);\n\t\tif (!text) {\n\t\t\tconst placeholder = this.theme.fg(\"dim\", NO_PREVIEW_TEXT);\n\t\t\tconst pad = Math.max(0, innerWidth - visibleWidth(placeholder));\n\t\t\treturn [placeholder + \" \".repeat(pad)];\n\t\t}\n\t\tlet md = this.markdownCache.get(optionIndex);\n\t\tif (!md) {\n\t\t\tmd = new Markdown(text, 0, 0, this.markdownTheme);\n\t\t\tthis.markdownCache.set(optionIndex, md);\n\t\t}\n\t\treturn stripFenceMarkers(md.render(innerWidth));\n\t}\n\n\tinvalidate(): void {\n\t\tfor (const md of this.markdownCache.values()) md.invalidate();\n\t\tthis.cachedWidth = undefined;\n\t}\n}\n"]}

package/dist/core/tools/ask-user-question/view/components/preview/markdown-content-cache.js

@@ -0,0 +1,66 @@
+import { Markdown, visibleWidth } from "@earendil-works/pi-tui";
+import { stripFenceMarkers } from "./preview-box-renderer.js";
+/** CC parity in side-by-side layout. */
+export const MAX_PREVIEW_HEIGHT_SIDE_BY_SIDE = 20;
+/** Preserves narrow-terminal protection in stacked layout. */
+export const MAX_PREVIEW_HEIGHT_STACKED = 15;
+export const NO_PREVIEW_TEXT = "No preview available";
+/** 1 blank separator + 1 affordance text row reserved when `hasAnyPreview` (height stability of the affordance row's offset relative to the box). */
+export const NOTES_AFFORDANCE_OVERHEAD = 2;
+/**
+ * Per-question cache for rendered markdown previews. Width-keyed: switching the
+ * inner width invalidates every cached `Markdown`'s render output (pi-tui's
+ * `Markdown.render(width)` re-wraps when width changes).
+ *
+ * Replaces the inline `previewTexts`, `markdownCache`, `cachedWidth` triple from
+ * the previous monolithic `preview-pane.ts`. One Markdown per option, lazy on
+ * first request, never re-constructed — count semantics frozen by tests.
+ */
+export class MarkdownContentCache {
+    constructor(question, theme, markdownTheme) {
+        this.theme = theme;
+        this.markdownTheme = markdownTheme;
+        this.previewTexts = new Map();
+        for (let i = 0; i < question.options.length; i++) {
+            const raw = question.options[i]?.preview;
+            if (raw && raw.length > 0)
+                this.previewTexts.set(i, raw);
+        }
+        this.markdownCache = new Map();
+    }
+    hasAnyPreview() {
+        return this.previewTexts.size > 0;
+    }
+    has(optionIndex) {
+        return this.previewTexts.has(optionIndex);
+    }
+    /**
+     * Compute the body lines for a given option at a given inner width. Width changes
+     * invalidate the per-Markdown render cache.
+     */
+    bodyFor(optionIndex, innerWidth) {
+        if (this.cachedWidth !== innerWidth) {
+            for (const md of this.markdownCache.values())
+                md.invalidate();
+            this.cachedWidth = innerWidth;
+        }
+        const text = this.previewTexts.get(optionIndex);
+        if (!text) {
+            const placeholder = this.theme.fg("dim", NO_PREVIEW_TEXT);
+            const pad = Math.max(0, innerWidth - visibleWidth(placeholder));
+            return [placeholder + " ".repeat(pad)];
+        }
+        let md = this.markdownCache.get(optionIndex);
+        if (!md) {
+            md = new Markdown(text, 0, 0, this.markdownTheme);
+            this.markdownCache.set(optionIndex, md);
+        }
+        return stripFenceMarkers(md.render(innerWidth));
+    }
+    invalidate() {
+        for (const md of this.markdownCache.values())
+            md.invalidate();
+        this.cachedWidth = undefined;
+    }
+}
+//# sourceMappingURL=markdown-content-cache.js.map

package/dist/core/tools/ask-user-question/view/components/preview/markdown-content-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-content-cache.js","sourceRoot":"","sources":["../../../../../../../src/core/tools/ask-user-question/view/components/preview/markdown-content-cache.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAsB,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D,wCAAwC;AACxC,MAAM,CAAC,MAAM,+BAA+B,GAAG,EAAE,CAAC;AAClD,8DAA8D;AAC9D,MAAM,CAAC,MAAM,0BAA0B,GAAG,EAAE,CAAC;AAC7C,MAAM,CAAC,MAAM,eAAe,GAAG,sBAAsB,CAAC;AACtD,qJAAqJ;AACrJ,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC;AAE3C;;;;;;;;GAQG;AACH,MAAM,OAAO,oBAAoB;IAOhC,YAAY,QAAsB,EAAE,KAAY,EAAE,aAA4B;QAC7E,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,YAAY,GAAG,IAAI,GAAG,EAAE,CAAC;QAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAClD,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC;YACzC,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;gBAAE,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,CAAC,aAAa,GAAG,IAAI,GAAG,EAAE,CAAC;IAChC,CAAC;IAED,aAAa;QACZ,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,CAAC;IACnC,CAAC;IAED,GAAG,CAAC,WAAmB;QACtB,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC3C,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,WAAmB,EAAE,UAAkB;QAC9C,IAAI,IAAI,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;YACrC,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE;gBAAE,EAAE,CAAC,UAAU,EAAE,CAAC;YAC9D,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAC/B,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,EAAE,CAAC;YACX,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;YAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC,CAAC;YAChE,OAAO,CAAC,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACxC,CAAC;QACD,IAAI,EAAE,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC7C,IAAI,CAAC,EAAE,EAAE,CAAC;YACT,EAAE,GAAG,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;YAClD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QACzC,CAAC;QACD,OAAO,iBAAiB,CAAC,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,UAAU;QACT,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE;YAAE,EAAE,CAAC,UAAU,EAAE,CAAC;QAC9D,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;IAC9B,CAAC;CACD","sourcesContent":["import type { Theme } from \"../../../../../../modes/interactive/theme/theme.js\";\nimport { Markdown, type MarkdownTheme, visibleWidth } from \"@earendil-works/pi-tui\";\nimport type { QuestionData } from \"../../../tool/types.js\";\nimport { stripFenceMarkers } from \"./preview-box-renderer.js\";\n\n/** CC parity in side-by-side layout. */\nexport const MAX_PREVIEW_HEIGHT_SIDE_BY_SIDE = 20;\n/** Preserves narrow-terminal protection in stacked layout. */\nexport const MAX_PREVIEW_HEIGHT_STACKED = 15;\nexport const NO_PREVIEW_TEXT = \"No preview available\";\n/** 1 blank separator + 1 affordance text row reserved when `hasAnyPreview` (height stability of the affordance row's offset relative to the box). */\nexport const NOTES_AFFORDANCE_OVERHEAD = 2;\n\n/**\n * Per-question cache for rendered markdown previews. Width-keyed: switching the\n * inner width invalidates every cached `Markdown`'s render output (pi-tui's\n * `Markdown.render(width)` re-wraps when width changes).\n *\n * Replaces the inline `previewTexts`, `markdownCache`, `cachedWidth` triple from\n * the previous monolithic `preview-pane.ts`. One Markdown per option, lazy on\n * first request, never re-constructed — count semantics frozen by tests.\n */\nexport class MarkdownContentCache {\n\tprivate readonly previewTexts: Map<number, string>;\n\tprivate readonly markdownCache: Map<number, Markdown>;\n\tprivate cachedWidth: number | undefined;\n\tprivate readonly theme: Theme;\n\tprivate readonly markdownTheme: MarkdownTheme;\n\n\tconstructor(question: QuestionData, theme: Theme, markdownTheme: MarkdownTheme) {\n\t\tthis.theme = theme;\n\t\tthis.markdownTheme = markdownTheme;\n\t\tthis.previewTexts = new Map();\n\t\tfor (let i = 0; i < question.options.length; i++) {\n\t\t\tconst raw = question.options[i]?.preview;\n\t\t\tif (raw && raw.length > 0) this.previewTexts.set(i, raw);\n\t\t}\n\t\tthis.markdownCache = new Map();\n\t}\n\n\thasAnyPreview(): boolean {\n\t\treturn this.previewTexts.size > 0;\n\t}\n\n\thas(optionIndex: number): boolean {\n\t\treturn this.previewTexts.has(optionIndex);\n\t}\n\n\t/**\n\t * Compute the body lines for a given option at a given inner width. Width changes\n\t * invalidate the per-Markdown render cache.\n\t */\n\tbodyFor(optionIndex: number, innerWidth: number): string[] {\n\t\tif (this.cachedWidth !== innerWidth) {\n\t\t\tfor (const md of this.markdownCache.values()) md.invalidate();\n\t\t\tthis.cachedWidth = innerWidth;\n\t\t}\n\t\tconst text = this.previewTexts.get(optionIndex);\n\t\tif (!text) {\n\t\t\tconst placeholder = this.theme.fg(\"dim\", NO_PREVIEW_TEXT);\n\t\t\tconst pad = Math.max(0, innerWidth - visibleWidth(placeholder));\n\t\t\treturn [placeholder + \" \".repeat(pad)];\n\t\t}\n\t\tlet md = this.markdownCache.get(optionIndex);\n\t\tif (!md) {\n\t\t\tmd = new Markdown(text, 0, 0, this.markdownTheme);\n\t\t\tthis.markdownCache.set(optionIndex, md);\n\t\t}\n\t\treturn stripFenceMarkers(md.render(innerWidth));\n\t}\n\n\tinvalidate(): void {\n\t\tfor (const md of this.markdownCache.values()) md.invalidate();\n\t\tthis.cachedWidth = undefined;\n\t}\n}\n"]}

package/dist/core/tools/ask-user-question/view/components/preview/preview-block-renderer.d.ts

@@ -0,0 +1,46 @@
+import type { Theme } from "../../../../../../modes/interactive/theme/theme.js";
+import type { MarkdownTheme } from "@earendil-works/pi-tui";
+import type { QuestionData } from "../../../tool/types.js";
+import type { PreviewLayoutMode } from "./preview-layout-decider.js";
+/**
+ * Affordance text shown below the bordered preview when focused on a preview-bearing option.
+ * Re-exported by `preview-pane.ts` for the existing test surface.
+ */
+export declare const NOTES_AFFORDANCE_TEXT = "Notes: press n to add notes";
+export interface PreviewBlockRendererConfig {
+    question: QuestionData;
+    theme: Theme;
+    markdownTheme: MarkdownTheme;
+}
+/**
+ * Renders the bordered markdown preview block for a single question (one block per render call,
+ * for the option at `optionIndex`). Owns a per-question `MarkdownContentCache`.
+ *
+ * NOT a `Component` — pure render-and-measure helper consumed by `PreviewPane`. The layout mode
+ * is threaded as an explicit param (never re-derived from column width post-split).
+ *
+ * The affordance row is always emitted (visually empty when gated) so the preview block's row
+ * count is height-stable across affordance-state transitions.
+ */
+export declare class PreviewBlockRenderer {
+    private readonly theme;
+    private readonly cache;
+    constructor(config: PreviewBlockRendererConfig);
+    hasAnyPreview(): boolean;
+    has(optionIndex: number): boolean;
+    invalidate(): void;
+    /**
+     * Height contribution of the preview block: `BORDER_VERTICAL_OVERHEAD + contentRows +
+     * NOTES_AFFORDANCE_OVERHEAD`. Always returns the same value as `renderBlock(...).length`
+     * — the affordance overhead is constant, not gated by `focused`/`notesVisible`.
+     */
+    blockHeight(width: number, optionIndex: number, mode: PreviewLayoutMode): number;
+    /**
+     * Render the full preview block at `width`: bordered box + blank separator + affordance row.
+     * `focused` and `notesVisible` together gate the affordance text (visible only when the
+     * focused option carries a preview AND notes mode is inactive). The affordance row is ALWAYS
+     * emitted (as an empty string when gated) so the row count is invariant.
+     */
+    renderBlock(width: number, optionIndex: number, mode: PreviewLayoutMode, focused: boolean, notesVisible: boolean): string[];
+}
+//# sourceMappingURL=preview-block-renderer.d.ts.map

package/dist/core/tools/ask-user-question/view/components/preview/preview-block-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-block-renderer.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/tools/ask-user-question/view/components/preview/preview-block-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oDAAoD,CAAC;AAChF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAc3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAErE;;;GAGG;AACH,eAAO,MAAM,qBAAqB,gCAAgC,CAAC;AAEnE,MAAM,WAAW,0BAA0B;IAC1C,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,EAAE,KAAK,CAAC;IACb,aAAa,EAAE,aAAa,CAAC;CAC7B;AAED;;;;;;;;;GASG;AACH,qBAAa,oBAAoB;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuB;IAE7C,YAAY,MAAM,EAAE,0BAA0B,EAG7C;IAED,aAAa,IAAI,OAAO,CAEvB;IAED,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAEhC;IAED,UAAU,IAAI,IAAI,CAEjB;IAED;;;;OAIG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAO/E;IAED;;;;;OAKG;IACH,WAAW,CACV,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,iBAAiB,EACvB,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,OAAO,GACnB,MAAM,EAAE,CAmBV;CACD","sourcesContent":["import type { Theme } from \"../../../../../../modes/interactive/theme/theme.js\";\nimport type { MarkdownTheme } from \"@earendil-works/pi-tui\";\nimport type { QuestionData } from \"../../../tool/types.js\";\nimport {\n\tMAX_PREVIEW_HEIGHT_SIDE_BY_SIDE,\n\tMAX_PREVIEW_HEIGHT_STACKED,\n\tMarkdownContentCache,\n\tNOTES_AFFORDANCE_OVERHEAD,\n} from \"./markdown-content-cache.js\";\nimport {\n\tBORDER_HORIZONTAL_OVERHEAD,\n\tBORDER_INNER_PADDING_HORIZONTAL,\n\tBORDER_VERTICAL_OVERHEAD,\n\tcomputeBoxDimensions,\n\trenderBorderedBox,\n} from \"./preview-box-renderer.js\";\nimport type { PreviewLayoutMode } from \"./preview-layout-decider.js\";\n\n/**\n * Affordance text shown below the bordered preview when focused on a preview-bearing option.\n * Re-exported by `preview-pane.ts` for the existing test surface.\n */\nexport const NOTES_AFFORDANCE_TEXT = \"Notes: press n to add notes\";\n\nexport interface PreviewBlockRendererConfig {\n\tquestion: QuestionData;\n\ttheme: Theme;\n\tmarkdownTheme: MarkdownTheme;\n}\n\n/**\n * Renders the bordered markdown preview block for a single question (one block per render call,\n * for the option at `optionIndex`). Owns a per-question `MarkdownContentCache`.\n *\n * NOT a `Component` — pure render-and-measure helper consumed by `PreviewPane`. The layout mode\n * is threaded as an explicit param (never re-derived from column width post-split).\n *\n * The affordance row is always emitted (visually empty when gated) so the preview block's row\n * count is height-stable across affordance-state transitions.\n */\nexport class PreviewBlockRenderer {\n\tprivate readonly theme: Theme;\n\tprivate readonly cache: MarkdownContentCache;\n\n\tconstructor(config: PreviewBlockRendererConfig) {\n\t\tthis.theme = config.theme;\n\t\tthis.cache = new MarkdownContentCache(config.question, config.theme, config.markdownTheme);\n\t}\n\n\thasAnyPreview(): boolean {\n\t\treturn this.cache.hasAnyPreview();\n\t}\n\n\thas(optionIndex: number): boolean {\n\t\treturn this.cache.has(optionIndex);\n\t}\n\n\tinvalidate(): void {\n\t\tthis.cache.invalidate();\n\t}\n\n\t/**\n\t * Height contribution of the preview block: `BORDER_VERTICAL_OVERHEAD + contentRows +\n\t * NOTES_AFFORDANCE_OVERHEAD`. Always returns the same value as `renderBlock(...).length`\n\t * — the affordance overhead is constant, not gated by `focused`/`notesVisible`.\n\t */\n\tblockHeight(width: number, optionIndex: number, mode: PreviewLayoutMode): number {\n\t\tconst cap = mode === \"side-by-side\" ? MAX_PREVIEW_HEIGHT_SIDE_BY_SIDE : MAX_PREVIEW_HEIGHT_STACKED;\n\t\tconst contentBudget = Math.max(1, cap - BORDER_VERTICAL_OVERHEAD - NOTES_AFFORDANCE_OVERHEAD);\n\t\tconst innerWidth = Math.max(1, width - BORDER_HORIZONTAL_OVERHEAD - 2 * BORDER_INNER_PADDING_HORIZONTAL);\n\t\tconst rawRows = this.cache.bodyFor(optionIndex, innerWidth).length;\n\t\tconst contentRows = Math.min(rawRows, contentBudget);\n\t\treturn BORDER_VERTICAL_OVERHEAD + contentRows + NOTES_AFFORDANCE_OVERHEAD;\n\t}\n\n\t/**\n\t * Render the full preview block at `width`: bordered box + blank separator + affordance row.\n\t * `focused` and `notesVisible` together gate the affordance text (visible only when the\n\t * focused option carries a preview AND notes mode is inactive). The affordance row is ALWAYS\n\t * emitted (as an empty string when gated) so the row count is invariant.\n\t */\n\trenderBlock(\n\t\twidth: number,\n\t\toptionIndex: number,\n\t\tmode: PreviewLayoutMode,\n\t\tfocused: boolean,\n\t\tnotesVisible: boolean,\n\t): string[] {\n\t\tconst cap = mode === \"side-by-side\" ? MAX_PREVIEW_HEIGHT_SIDE_BY_SIDE : MAX_PREVIEW_HEIGHT_STACKED;\n\t\tconst contentBudget = Math.max(1, cap - BORDER_VERTICAL_OVERHEAD - NOTES_AFFORDANCE_OVERHEAD);\n\t\tconst maxInnerWidth = Math.max(1, width - BORDER_HORIZONTAL_OVERHEAD - 2 * BORDER_INNER_PADDING_HORIZONTAL);\n\n\t\tconst raw = this.cache.bodyFor(optionIndex, maxInnerWidth);\n\t\tconst truncated = raw.length > contentBudget;\n\t\tconst hidden = truncated ? raw.length - contentBudget : 0;\n\t\tconst contentLines = truncated ? raw.slice(0, contentBudget) : raw;\n\n\t\tconst { boxWidth } = computeBoxDimensions(contentLines, maxInnerWidth);\n\t\tconst colorFn = (s: string) => this.theme.fg(\"accent\", s);\n\t\tconst boxedLines = renderBorderedBox(contentLines, boxWidth, colorFn, hidden);\n\n\t\tconst showAffordance = focused && !notesVisible && this.cache.has(optionIndex);\n\t\tconst affordance = showAffordance\n\t\t\t? this.theme.fg(\"muted\", NOTES_AFFORDANCE_TEXT)\n\t\t\t: \"\";\n\t\treturn [...boxedLines, \"\", affordance];\n\t}\n}\n"]}

package/dist/core/tools/ask-user-question/view/components/preview/preview-block-renderer.js

@@ -0,0 +1,69 @@
+import { MAX_PREVIEW_HEIGHT_SIDE_BY_SIDE, MAX_PREVIEW_HEIGHT_STACKED, MarkdownContentCache, NOTES_AFFORDANCE_OVERHEAD, } from "./markdown-content-cache.js";
+import { BORDER_HORIZONTAL_OVERHEAD, BORDER_INNER_PADDING_HORIZONTAL, BORDER_VERTICAL_OVERHEAD, computeBoxDimensions, renderBorderedBox, } from "./preview-box-renderer.js";
+/**
+ * Affordance text shown below the bordered preview when focused on a preview-bearing option.
+ * Re-exported by `preview-pane.ts` for the existing test surface.
+ */
+export const NOTES_AFFORDANCE_TEXT = "Notes: press n to add notes";
+/**
+ * Renders the bordered markdown preview block for a single question (one block per render call,
+ * for the option at `optionIndex`). Owns a per-question `MarkdownContentCache`.
+ *
+ * NOT a `Component` — pure render-and-measure helper consumed by `PreviewPane`. The layout mode
+ * is threaded as an explicit param (never re-derived from column width post-split).
+ *
+ * The affordance row is always emitted (visually empty when gated) so the preview block's row
+ * count is height-stable across affordance-state transitions.
+ */
+export class PreviewBlockRenderer {
+    constructor(config) {
+        this.theme = config.theme;
+        this.cache = new MarkdownContentCache(config.question, config.theme, config.markdownTheme);
+    }
+    hasAnyPreview() {
+        return this.cache.hasAnyPreview();
+    }
+    has(optionIndex) {
+        return this.cache.has(optionIndex);
+    }
+    invalidate() {
+        this.cache.invalidate();
+    }
+    /**
+     * Height contribution of the preview block: `BORDER_VERTICAL_OVERHEAD + contentRows +
+     * NOTES_AFFORDANCE_OVERHEAD`. Always returns the same value as `renderBlock(...).length`
+     * — the affordance overhead is constant, not gated by `focused`/`notesVisible`.
+     */
+    blockHeight(width, optionIndex, mode) {
+        const cap = mode === "side-by-side" ? MAX_PREVIEW_HEIGHT_SIDE_BY_SIDE : MAX_PREVIEW_HEIGHT_STACKED;
+        const contentBudget = Math.max(1, cap - BORDER_VERTICAL_OVERHEAD - NOTES_AFFORDANCE_OVERHEAD);
+        const innerWidth = Math.max(1, width - BORDER_HORIZONTAL_OVERHEAD - 2 * BORDER_INNER_PADDING_HORIZONTAL);
+        const rawRows = this.cache.bodyFor(optionIndex, innerWidth).length;
+        const contentRows = Math.min(rawRows, contentBudget);
+        return BORDER_VERTICAL_OVERHEAD + contentRows + NOTES_AFFORDANCE_OVERHEAD;
+    }
+    /**
+     * Render the full preview block at `width`: bordered box + blank separator + affordance row.
+     * `focused` and `notesVisible` together gate the affordance text (visible only when the
+     * focused option carries a preview AND notes mode is inactive). The affordance row is ALWAYS
+     * emitted (as an empty string when gated) so the row count is invariant.
+     */
+    renderBlock(width, optionIndex, mode, focused, notesVisible) {
+        const cap = mode === "side-by-side" ? MAX_PREVIEW_HEIGHT_SIDE_BY_SIDE : MAX_PREVIEW_HEIGHT_STACKED;
+        const contentBudget = Math.max(1, cap - BORDER_VERTICAL_OVERHEAD - NOTES_AFFORDANCE_OVERHEAD);
+        const maxInnerWidth = Math.max(1, width - BORDER_HORIZONTAL_OVERHEAD - 2 * BORDER_INNER_PADDING_HORIZONTAL);
+        const raw = this.cache.bodyFor(optionIndex, maxInnerWidth);
+        const truncated = raw.length > contentBudget;
+        const hidden = truncated ? raw.length - contentBudget : 0;
+        const contentLines = truncated ? raw.slice(0, contentBudget) : raw;
+        const { boxWidth } = computeBoxDimensions(contentLines, maxInnerWidth);
+        const colorFn = (s) => this.theme.fg("accent", s);
+        const boxedLines = renderBorderedBox(contentLines, boxWidth, colorFn, hidden);
+        const showAffordance = focused && !notesVisible && this.cache.has(optionIndex);
+        const affordance = showAffordance
+            ? this.theme.fg("muted", NOTES_AFFORDANCE_TEXT)
+            : "";
+        return [...boxedLines, "", affordance];
+    }
+}
+//# sourceMappingURL=preview-block-renderer.js.map

package/dist/core/tools/ask-user-question/view/components/preview/preview-block-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-block-renderer.js","sourceRoot":"","sources":["../../../../../../../src/core/tools/ask-user-question/view/components/preview/preview-block-renderer.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Theme } from \"../../../../../../modes/interactive/theme/theme.js\";\nimport type { MarkdownTheme } from \"@earendil-works/pi-tui\";\nimport type { QuestionData } from \"../../../tool/types.js\";\nimport {\n\tMAX_PREVIEW_HEIGHT_SIDE_BY_SIDE,\n\tMAX_PREVIEW_HEIGHT_STACKED,\n\tMarkdownContentCache,\n\tNOTES_AFFORDANCE_OVERHEAD,\n} from \"./markdown-content-cache.js\";\nimport {\n\tBORDER_HORIZONTAL_OVERHEAD,\n\tBORDER_INNER_PADDING_HORIZONTAL,\n\tBORDER_VERTICAL_OVERHEAD,\n\tcomputeBoxDimensions,\n\trenderBorderedBox,\n} from \"./preview-box-renderer.js\";\nimport type { PreviewLayoutMode } from \"./preview-layout-decider.js\";\n\n/**\n * Affordance text shown below the bordered preview when focused on a preview-bearing option.\n * Re-exported by `preview-pane.ts` for the existing test surface.\n */\nexport const NOTES_AFFORDANCE_TEXT = \"Notes: press n to add notes\";\n\nexport interface PreviewBlockRendererConfig {\n\tquestion: QuestionData;\n\ttheme: Theme;\n\tmarkdownTheme: MarkdownTheme;\n}\n\n/**\n * Renders the bordered markdown preview block for a single question (one block per render call,\n * for the option at `optionIndex`). Owns a per-question `MarkdownContentCache`.\n *\n * NOT a `Component` — pure render-and-measure helper consumed by `PreviewPane`. The layout mode\n * is threaded as an explicit param (never re-derived from column width post-split).\n *\n * The affordance row is always emitted (visually empty when gated) so the preview block's row\n * count is height-stable across affordance-state transitions.\n */\nexport class PreviewBlockRenderer {\n\tprivate readonly theme: Theme;\n\tprivate readonly cache: MarkdownContentCache;\n\n\tconstructor(config: PreviewBlockRendererConfig) {\n\t\tthis.theme = config.theme;\n\t\tthis.cache = new MarkdownContentCache(config.question, config.theme, config.markdownTheme);\n\t}\n\n\thasAnyPreview(): boolean {\n\t\treturn this.cache.hasAnyPreview();\n\t}\n\n\thas(optionIndex: number): boolean {\n\t\treturn this.cache.has(optionIndex);\n\t}\n\n\tinvalidate(): void {\n\t\tthis.cache.invalidate();\n\t}\n\n\t/**\n\t * Height contribution of the preview block: `BORDER_VERTICAL_OVERHEAD + contentRows +\n\t * NOTES_AFFORDANCE_OVERHEAD`. Always returns the same value as `renderBlock(...).length`\n\t * — the affordance overhead is constant, not gated by `focused`/`notesVisible`.\n\t */\n\tblockHeight(width: number, optionIndex: number, mode: PreviewLayoutMode): number {\n\t\tconst cap = mode === \"side-by-side\" ? MAX_PREVIEW_HEIGHT_SIDE_BY_SIDE : MAX_PREVIEW_HEIGHT_STACKED;\n\t\tconst contentBudget = Math.max(1, cap - BORDER_VERTICAL_OVERHEAD - NOTES_AFFORDANCE_OVERHEAD);\n\t\tconst innerWidth = Math.max(1, width - BORDER_HORIZONTAL_OVERHEAD - 2 * BORDER_INNER_PADDING_HORIZONTAL);\n\t\tconst rawRows = this.cache.bodyFor(optionIndex, innerWidth).length;\n\t\tconst contentRows = Math.min(rawRows, contentBudget);\n\t\treturn BORDER_VERTICAL_OVERHEAD + contentRows + NOTES_AFFORDANCE_OVERHEAD;\n\t}\n\n\t/**\n\t * Render the full preview block at `width`: bordered box + blank separator + affordance row.\n\t * `focused` and `notesVisible` together gate the affordance text (visible only when the\n\t * focused option carries a preview AND notes mode is inactive). The affordance row is ALWAYS\n\t * emitted (as an empty string when gated) so the row count is invariant.\n\t */\n\trenderBlock(\n\t\twidth: number,\n\t\toptionIndex: number,\n\t\tmode: PreviewLayoutMode,\n\t\tfocused: boolean,\n\t\tnotesVisible: boolean,\n\t): string[] {\n\t\tconst cap = mode === \"side-by-side\" ? MAX_PREVIEW_HEIGHT_SIDE_BY_SIDE : MAX_PREVIEW_HEIGHT_STACKED;\n\t\tconst contentBudget = Math.max(1, cap - BORDER_VERTICAL_OVERHEAD - NOTES_AFFORDANCE_OVERHEAD);\n\t\tconst maxInnerWidth = Math.max(1, width - BORDER_HORIZONTAL_OVERHEAD - 2 * BORDER_INNER_PADDING_HORIZONTAL);\n\n\t\tconst raw = this.cache.bodyFor(optionIndex, maxInnerWidth);\n\t\tconst truncated = raw.length > contentBudget;\n\t\tconst hidden = truncated ? raw.length - contentBudget : 0;\n\t\tconst contentLines = truncated ? raw.slice(0, contentBudget) : raw;\n\n\t\tconst { boxWidth } = computeBoxDimensions(contentLines, maxInnerWidth);\n\t\tconst colorFn = (s: string) => this.theme.fg(\"accent\", s);\n\t\tconst boxedLines = renderBorderedBox(contentLines, boxWidth, colorFn, hidden);\n\n\t\tconst showAffordance = focused && !notesVisible && this.cache.has(optionIndex);\n\t\tconst affordance = showAffordance\n\t\t\t? this.theme.fg(\"muted\", NOTES_AFFORDANCE_TEXT)\n\t\t\t: \"\";\n\t\treturn [...boxedLines, \"\", affordance];\n\t}\n}\n"]}

package/dist/core/tools/ask-user-question/view/components/preview/preview-box-renderer.d.ts

@@ -0,0 +1,39 @@
+/** Top + bottom border rows consumed by `renderBorderedBox`. */
+export declare const BORDER_VERTICAL_OVERHEAD = 2;
+/** Left + right vertical bar columns (`│ ... │`) consumed by `renderBorderedBox`. */
+export declare const BORDER_HORIZONTAL_OVERHEAD = 2;
+/** Inner horizontal padding (1 col) between each border bar and content area. */
+export declare const BORDER_INNER_PADDING_HORIZONTAL = 1;
+/** Floor for the preview box's inner content width — CC parity (`PreviewBox.minWidth`). */
+export declare const BOX_MIN_CONTENT_WIDTH = 40;
+/**
+ * Drops fenced-code-block marker lines (` ``` ` opener/closer) from rendered markdown.
+ * pi-tui's Markdown emits literal opening ` ```lang ` and closing ` ``` ` lines around
+ * code blocks; this strip leaves only the highlighted code body. Inline code
+ * (`codespan`) is unaffected — pi-tui already renders it without backticks.
+ */
+export declare function stripFenceMarkers(lines: readonly string[]): string[];
+/**
+ * Wraps `lines` in a 4-sided ASCII border with 1 col of inner horizontal padding.
+ * Layout per content row: `│` + ` ` + content padded to `contentInner` + ` ` + `│`,
+ * where `contentInner = width - BORDER_HORIZONTAL_OVERHEAD - 2 * BORDER_INNER_PADDING_HORIZONTAL`.
+ * Top/bottom dash runs span corner-to-corner (`width - BORDER_HORIZONTAL_OVERHEAD`). When
+ * `hidden > 0`, the bottom-row dash run is replaced with ` ✂ ── N lines hidden ── ` (corners stay).
+ */
+export declare function renderBorderedBox(lines: readonly string[], width: number, colorFn: (s: string) => string, hidden?: number): string[];
+/**
+ * Compute box dimensions from content lines. Pure of args.
+ *
+ * CC parity:
+ *   contentWidth = max(minWidth, widestRenderedLine)
+ *   boxWidth     = min(contentWidth + 4, effectiveMaxWidth)
+ *
+ * Trailing whitespace is stripped before measuring because pi-tui's
+ * `Markdown.render(width)` pads every line to `width`, which would otherwise force
+ * the box to fill the whole column allocation.
+ */
+export declare function computeBoxDimensions(contentLines: readonly string[], maxInnerWidth: number): {
+    innerWidth: number;
+    boxWidth: number;
+};
+//# sourceMappingURL=preview-box-renderer.d.ts.map

package/dist/core/tools/ask-user-question/view/components/preview/preview-box-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-box-renderer.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/tools/ask-user-question/view/components/preview/preview-box-renderer.ts"],"names":[],"mappings":"AAMA,gEAAgE;AAChE,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAC1C,qFAAqF;AACrF,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAC5C,iFAAiF;AACjF,eAAO,MAAM,+BAA+B,IAAI,CAAC;AACjD,2FAA2F;AAC3F,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAKpE;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,EAC9B,MAAM,SAAI,GACR,MAAM,EAAE,CAoBV;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CACnC,YAAY,EAAE,SAAS,MAAM,EAAE,EAC/B,aAAa,EAAE,MAAM,GACnB;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAS1C","sourcesContent":["import { truncateToWidth, visibleWidth } from \"@earendil-works/pi-tui\";\n\nconst ANSI_SGR_RE = /\\x1b\\[[0-9;]*m/g;\nconst ANSI_OSC8_RE = /\\x1b\\]8;[^\\x07\\x1b]*(?:\\x07|\\x1b\\\\)/g;\nconst FENCE_MARKER_RE = /^`{3}/;\n\n/** Top + bottom border rows consumed by `renderBorderedBox`. */\nexport const BORDER_VERTICAL_OVERHEAD = 2;\n/** Left + right vertical bar columns (`│ ... │`) consumed by `renderBorderedBox`. */\nexport const BORDER_HORIZONTAL_OVERHEAD = 2;\n/** Inner horizontal padding (1 col) between each border bar and content area. */\nexport const BORDER_INNER_PADDING_HORIZONTAL = 1;\n/** Floor for the preview box's inner content width — CC parity (`PreviewBox.minWidth`). */\nexport const BOX_MIN_CONTENT_WIDTH = 40;\n\n/**\n * Drops fenced-code-block marker lines (` ``` ` opener/closer) from rendered markdown.\n * pi-tui's Markdown emits literal opening ` ```lang ` and closing ` ``` ` lines around\n * code blocks; this strip leaves only the highlighted code body. Inline code\n * (`codespan`) is unaffected — pi-tui already renders it without backticks.\n */\nexport function stripFenceMarkers(lines: readonly string[]): string[] {\n\treturn lines.filter((line) => {\n\t\tconst clean = line.replace(ANSI_SGR_RE, \"\").replace(ANSI_OSC8_RE, \"\");\n\t\treturn !FENCE_MARKER_RE.test(clean);\n\t});\n}\n\n/**\n * Wraps `lines` in a 4-sided ASCII border with 1 col of inner horizontal padding.\n * Layout per content row: `│` + ` ` + content padded to `contentInner` + ` ` + `│`,\n * where `contentInner = width - BORDER_HORIZONTAL_OVERHEAD - 2 * BORDER_INNER_PADDING_HORIZONTAL`.\n * Top/bottom dash runs span corner-to-corner (`width - BORDER_HORIZONTAL_OVERHEAD`). When\n * `hidden > 0`, the bottom-row dash run is replaced with ` ✂ ── N lines hidden ── ` (corners stay).\n */\nexport function renderBorderedBox(\n\tlines: readonly string[],\n\twidth: number,\n\tcolorFn: (s: string) => string,\n\thidden = 0,\n): string[] {\n\tconst dashSpan = Math.max(1, width - BORDER_HORIZONTAL_OVERHEAD);\n\tconst contentInner = Math.max(1, dashSpan - 2 * BORDER_INNER_PADDING_HORIZONTAL);\n\tconst pad = \" \".repeat(BORDER_INNER_PADDING_HORIZONTAL);\n\tconst top = colorFn(`┌${\"─\".repeat(dashSpan)}┐`);\n\tconst out: string[] = [top];\n\tfor (const line of lines) {\n\t\tconst padded = truncateToWidth(line, contentInner, \"\", true);\n\t\tout.push(`${colorFn(\"│\")}${pad}${padded}${pad}${colorFn(\"│\")}`);\n\t}\n\tif (hidden > 0) {\n\t\tconst indicator = ` ✂ ── ${hidden} lines hidden ── `;\n\t\tconst space = dashSpan - indicator.length;\n\t\tconst leftFill = \"─\".repeat(Math.max(0, Math.floor(space / 2)));\n\t\tconst rightFill = \"─\".repeat(Math.max(0, dashSpan - leftFill.length - indicator.length));\n\t\tout.push(colorFn(`└${leftFill}${indicator}${rightFill}┘`));\n\t} else {\n\t\tout.push(colorFn(`└${\"─\".repeat(dashSpan)}┘`));\n\t}\n\treturn out;\n}\n\n/**\n * Compute box dimensions from content lines. Pure of args.\n *\n * CC parity:\n *   contentWidth = max(minWidth, widestRenderedLine)\n *   boxWidth     = min(contentWidth + 4, effectiveMaxWidth)\n *\n * Trailing whitespace is stripped before measuring because pi-tui's\n * `Markdown.render(width)` pads every line to `width`, which would otherwise force\n * the box to fill the whole column allocation.\n */\nexport function computeBoxDimensions(\n\tcontentLines: readonly string[],\n\tmaxInnerWidth: number,\n): { innerWidth: number; boxWidth: number } {\n\tlet widest = Math.min(BOX_MIN_CONTENT_WIDTH, maxInnerWidth);\n\tfor (const line of contentLines) {\n\t\tconst w = visibleWidth(line.replace(/\\s+$/, \"\"));\n\t\tif (w > widest) widest = w;\n\t}\n\tconst innerWidth = Math.min(widest, maxInnerWidth);\n\tconst boxWidth = innerWidth + BORDER_HORIZONTAL_OVERHEAD + 2 * BORDER_INNER_PADDING_HORIZONTAL;\n\treturn { innerWidth, boxWidth };\n}\n"]}

package/dist/core/tools/ask-user-question/view/components/preview/preview-box-renderer.js

@@ -0,0 +1,76 @@
+import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
+const ANSI_SGR_RE = /\x1b\[[0-9;]*m/g;
+const ANSI_OSC8_RE = /\x1b\]8;[^\x07\x1b]*(?:\x07|\x1b\\)/g;
+const FENCE_MARKER_RE = /^`{3}/;
+/** Top + bottom border rows consumed by `renderBorderedBox`. */
+export const BORDER_VERTICAL_OVERHEAD = 2;
+/** Left + right vertical bar columns (`│ ... │`) consumed by `renderBorderedBox`. */
+export const BORDER_HORIZONTAL_OVERHEAD = 2;
+/** Inner horizontal padding (1 col) between each border bar and content area. */
+export const BORDER_INNER_PADDING_HORIZONTAL = 1;
+/** Floor for the preview box's inner content width — CC parity (`PreviewBox.minWidth`). */
+export const BOX_MIN_CONTENT_WIDTH = 40;
+/**
+ * Drops fenced-code-block marker lines (` ``` ` opener/closer) from rendered markdown.
+ * pi-tui's Markdown emits literal opening ` ```lang ` and closing ` ``` ` lines around
+ * code blocks; this strip leaves only the highlighted code body. Inline code
+ * (`codespan`) is unaffected — pi-tui already renders it without backticks.
+ */
+export function stripFenceMarkers(lines) {
+    return lines.filter((line) => {
+        const clean = line.replace(ANSI_SGR_RE, "").replace(ANSI_OSC8_RE, "");
+        return !FENCE_MARKER_RE.test(clean);
+    });
+}
+/**
+ * Wraps `lines` in a 4-sided ASCII border with 1 col of inner horizontal padding.
+ * Layout per content row: `│` + ` ` + content padded to `contentInner` + ` ` + `│`,
+ * where `contentInner = width - BORDER_HORIZONTAL_OVERHEAD - 2 * BORDER_INNER_PADDING_HORIZONTAL`.
+ * Top/bottom dash runs span corner-to-corner (`width - BORDER_HORIZONTAL_OVERHEAD`). When
+ * `hidden > 0`, the bottom-row dash run is replaced with ` ✂ ── N lines hidden ── ` (corners stay).
+ */
+export function renderBorderedBox(lines, width, colorFn, hidden = 0) {
+    const dashSpan = Math.max(1, width - BORDER_HORIZONTAL_OVERHEAD);
+    const contentInner = Math.max(1, dashSpan - 2 * BORDER_INNER_PADDING_HORIZONTAL);
+    const pad = " ".repeat(BORDER_INNER_PADDING_HORIZONTAL);
+    const top = colorFn(`┌${"─".repeat(dashSpan)}┐`);
+    const out = [top];
+    for (const line of lines) {
+        const padded = truncateToWidth(line, contentInner, "", true);
+        out.push(`${colorFn("│")}${pad}${padded}${pad}${colorFn("│")}`);
+    }
+    if (hidden > 0) {
+        const indicator = ` ✂ ── ${hidden} lines hidden ── `;
+        const space = dashSpan - indicator.length;
+        const leftFill = "─".repeat(Math.max(0, Math.floor(space / 2)));
+        const rightFill = "─".repeat(Math.max(0, dashSpan - leftFill.length - indicator.length));
+        out.push(colorFn(`└${leftFill}${indicator}${rightFill}┘`));
+    }
+    else {
+        out.push(colorFn(`└${"─".repeat(dashSpan)}┘`));
+    }
+    return out;
+}
+/**
+ * Compute box dimensions from content lines. Pure of args.
+ *
+ * CC parity:
+ *   contentWidth = max(minWidth, widestRenderedLine)
+ *   boxWidth     = min(contentWidth + 4, effectiveMaxWidth)
+ *
+ * Trailing whitespace is stripped before measuring because pi-tui's
+ * `Markdown.render(width)` pads every line to `width`, which would otherwise force
+ * the box to fill the whole column allocation.
+ */
+export function computeBoxDimensions(contentLines, maxInnerWidth) {
+    let widest = Math.min(BOX_MIN_CONTENT_WIDTH, maxInnerWidth);
+    for (const line of contentLines) {
+        const w = visibleWidth(line.replace(/\s+$/, ""));
+        if (w > widest)
+            widest = w;
+    }
+    const innerWidth = Math.min(widest, maxInnerWidth);
+    const boxWidth = innerWidth + BORDER_HORIZONTAL_OVERHEAD + 2 * BORDER_INNER_PADDING_HORIZONTAL;
+    return { innerWidth, boxWidth };
+}
+//# sourceMappingURL=preview-box-renderer.js.map