apex-code 0.0.1-alpha.0 → 0.0.1-alpha.10

package/dist/modes/interactive/components/custom-editor.d.ts

@@ -1,17 +1,88 @@
 import { Editor, type EditorOptions, type EditorTheme, type TUI } from "@earendil-works/pi-tui";
 import type { AppKeybinding, KeybindingsManager } from "../../../core/keybindings.ts";
+export interface CustomEditorOptions extends EditorOptions {
+    /** Marker rendered at the start of the first input line, e.g. `"> "`. */
+    promptPrefix?: string;
+    /** Styles the prompt prefix. Defaults to leaving it unstyled. */
+    promptColor?: (text: string) => string;
+    /** Shown in place of the empty input line. */
+    placeholder?: string;
+    /** Styles the placeholder. Defaults to leaving it unstyled. */
+    placeholderColor?: (text: string) => string;
+    /** Styles a leading `/command` token. Defaults to leaving it unstyled. */
+    commandColor?: (text: string) => string;
+    /** Applies the filled prompt surface around the editor block. */
+    surfaceColor?: (text: string) => string;
+    /** Rule drawn above the autocomplete rows. Omit for no rule. */
+    autocompleteRule?: (width: number) => string;
+    /** Keybinding footer drawn under the autocomplete rows. Omit for no footer. */
+    autocompleteFooter?: () => string;
+}
 /**
  * Custom editor that handles app-level keybindings for coding-agent.
+ *
+ * The prompt prefix and placeholder are layered on in `render` rather than
+ * inside the base Editor, because `packages/tui` is frozen under ADR 0001 and
+ * its `EditorOptions` has no hook for either.
  */
 export declare class CustomEditor extends Editor {
     private keybindings;
+    private readonly promptPrefix;
+    private readonly promptColor;
+    private readonly placeholderColor;
+    private readonly commandColor;
+    private readonly surfaceColor;
+    private readonly placeholder;
+    private readonly autocompleteRule;
+    private readonly autocompleteFooter;
+    private modeLabel;
     actionHandlers: Map<AppKeybinding, () => void>;
     onEscape?: () => void;
     onCtrlD?: () => void;
     onPasteImage?: () => void;
     /** Handler for extension-registered shortcuts. Returns true if handled. */
     onExtensionShortcut?: (data: string) => boolean;
-    constructor(tui: TUI, theme: EditorTheme, keybindings: KeybindingsManager, options?: EditorOptions);
+    constructor(tui: TUI, theme: EditorTheme, keybindings: KeybindingsManager, options?: CustomEditorOptions);
+    render(width: number): string[];
+    private renderEditor;
+    /**
+     * Brackets the autocomplete rows with a rule and a keybinding footer.
+     *
+     * The rows arrive after the editor's second border, so the same border count
+     * that separates the box from its dropdown elsewhere in this file finds them
+     * here. Nothing is added when the dropdown is closed.
+     */
+    private withAutocompleteChrome;
+    private withSurface;
+    private editorBlockLineCount;
+    private surfaceLine;
+    setModeLabel(label: string | undefined): void;
+    private isBorderLine;
+    /**
+     * Tint a leading `/command` on the first input line.
+     *
+     * The base Editor emits input text unstyled, so the only styling already
+     * present on the line is the cursor cell — which `colorVisibleRange` steps
+     * over. Only the command token is tinted; arguments after it stay plain, so
+     * the highlight marks what is being invoked rather than the whole line.
+     */
+    private withCommandColor;
+    /**
+     * Replace the sole content line with the placeholder while the input is
+     * empty. Index 1 is always the first content line, and an empty editor has
+     * exactly one, so no line classification is needed here.
+     */
+    private withPlaceholder;
+    /**
+     * The base Editor renders an empty line as the hardware-cursor marker
+     * followed by a reverse-video cell: `CURSOR_MARKER ESC[7m <space> ESC[0m`.
+     * Both parts are kept verbatim.
+     *
+     * The `ESC[7m … ESC[0m` run is matched explicitly. Do not "simplify" this to
+     * a general leading-SGR match such as `(?:\x1b\[[0-9;]*m)*` — see hazard 2 at
+     * the top of this file for what that breaks.
+     */
+    private sliceLeadingCursorCell;
     /**
      * Register a handler for an app action.
      */

package/dist/modes/interactive/components/custom-editor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"custom-editor.d.ts","sourceRoot":"","sources":["../../../../src/modes/interactive/components/custom-editor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,KAAK,WAAW,EAAE,KAAK,GAAG,EAAE,MAAM,wBAAwB,CAAC;AAChG,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAEtF;;GAEG;AACH,qBAAa,YAAa,SAAQ,MAAM;IACvC,OAAO,CAAC,WAAW,CAAqB;IACjC,cAAc,EAAE,GAAG,CAAC,aAAa,EAAE,MAAM,IAAI,CAAC,CAAa;IAG3D,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IACjC,2EAA2E;IACpE,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAEvD,YAAY,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,aAAa,EAGjG;IAED;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI,CAEzD;IAED,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CA2D9B;CACD","sourcesContent":["import { Editor, type EditorOptions, type EditorTheme, type TUI } from \"@earendil-works/pi-tui\";\nimport type { AppKeybinding, KeybindingsManager } from \"../../../core/keybindings.ts\";\n\n/**\n * Custom editor that handles app-level keybindings for coding-agent.\n */\nexport class CustomEditor extends Editor {\n\tprivate keybindings: KeybindingsManager;\n\tpublic actionHandlers: Map<AppKeybinding, () => void> = new Map();\n\n\t// Special handlers that can be dynamically replaced\n\tpublic onEscape?: () => void;\n\tpublic onCtrlD?: () => void;\n\tpublic onPasteImage?: () => void;\n\t/** Handler for extension-registered shortcuts. Returns true if handled. */\n\tpublic onExtensionShortcut?: (data: string) => boolean;\n\n\tconstructor(tui: TUI, theme: EditorTheme, keybindings: KeybindingsManager, options?: EditorOptions) {\n\t\tsuper(tui, theme, options);\n\t\tthis.keybindings = keybindings;\n\t}\n\n\t/**\n\t * Register a handler for an app action.\n\t */\n\tonAction(action: AppKeybinding, handler: () => void): void {\n\t\tthis.actionHandlers.set(action, handler);\n\t}\n\n\thandleInput(data: string): void {\n\t\t// Check extension-registered shortcuts first\n\t\tif (this.onExtensionShortcut?.(data)) {\n\t\t\treturn;\n\t\t}\n\n\t\t// Check for clipboard paste keybinding\n\t\tif (this.keybindings.matches(data, \"app.clipboard.pasteImage\")) {\n\t\t\tthis.onPasteImage?.();\n\t\t\treturn;\n\t\t}\n\n\t\t// Check app keybindings first\n\n\t\t// Escape/interrupt - only if autocomplete is NOT active\n\t\tif (this.keybindings.matches(data, \"app.interrupt\")) {\n\t\t\tif (!this.isShowingAutocomplete()) {\n\t\t\t\t// Use dynamic onEscape if set, otherwise registered handler\n\t\t\t\tconst handler = this.onEscape ?? this.actionHandlers.get(\"app.interrupt\");\n\t\t\t\tif (handler) {\n\t\t\t\t\thandler();\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t}\n\t\t\t// Let parent handle escape for autocomplete cancellation\n\t\t\tsuper.handleInput(data);\n\t\t\treturn;\n\t\t}\n\n\t\t// Exit (Ctrl+D) - only when editor is empty\n\t\tif (this.keybindings.matches(data, \"app.exit\")) {\n\t\t\tif (this.getText().length === 0) {\n\t\t\t\tconst handler = this.onCtrlD ?? this.actionHandlers.get(\"app.exit\");\n\t\t\t\tif (handler) handler();\n\t\t\t\treturn;\n\t\t\t}\n\t\t\t// Fall through to editor handling for delete-char-forward when not empty\n\t\t}\n\n\t\t// Explicit history bindings take precedence over app actions while the editor is focused.\n\t\t// This lets users bind Ctrl+P even though it cycles models by default.\n\t\tif (\n\t\t\tthis.keybindings.matches(data, \"tui.editor.historyPrevious\") ||\n\t\t\tthis.keybindings.matches(data, \"tui.editor.historyNext\")\n\t\t) {\n\t\t\tsuper.handleInput(data);\n\t\t\treturn;\n\t\t}\n\n\t\t// Check all other app actions\n\t\tfor (const [action, handler] of this.actionHandlers) {\n\t\t\tif (action !== \"app.interrupt\" && action !== \"app.exit\" && this.keybindings.matches(data, action)) {\n\t\t\t\thandler();\n\t\t\t\treturn;\n\t\t\t}\n\t\t}\n\n\t\t// Pass to parent for editor handling\n\t\tsuper.handleInput(data);\n\t}\n}\n"]}
+{"version":3,"file":"custom-editor.d.ts","sourceRoot":"","sources":["../../../../src/modes/interactive/components/custom-editor.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,MAAM,EACN,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,GAAG,EAGR,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAGtF,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACzD,yEAAyE;IACzE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACvC,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5C,0EAA0E;IAC1E,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACxC,iEAAiE;IACjE,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACxC,gEAAgE;IAChE,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAC7C,+EAA+E;IAC/E,kBAAkB,CAAC,EAAE,MAAM,MAAM,CAAC;CAClC;AAwHD;;;;;;GAMG;AACH,qBAAa,YAAa,SAAQ,MAAM;IACvC,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA2B;IACvD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA2B;IAC5D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyC;IACtE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyC;IACtE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA0C;IAC3E,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA6B;IAChE,OAAO,CAAC,SAAS,CAAM;IAChB,cAAc,EAAE,GAAG,CAAC,aAAa,EAAE,MAAM,IAAI,CAAC,CAAa;IAG3D,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IACjC,2EAA2E;IACpE,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAEvD,YAAY,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,mBAAmB,EAWvG;IAEQ,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAMvC;IAED,OAAO,CAAC,YAAY;IAqCpB;;;;;;OAMG;IACH,OAAO,CAAC,sBAAsB;IAa9B,OAAO,CAAC,WAAW;IAiBnB,OAAO,CAAC,oBAAoB;IAS5B,OAAO,CAAC,WAAW;IAuCnB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAG5C;IAED,OAAO,CAAC,YAAY;IAKpB;;;;;;;OAOG;IACH,OAAO,CAAC,gBAAgB;IAyBxB;;;;OAIG;IACH,OAAO,CAAC,eAAe;IA2BvB;;;;;;;;OAQG;IACH,OAAO,CAAC,sBAAsB;IAK9B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI,CAEzD;IAED,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CA2D9B;CACD","sourcesContent":["import {\n\tCURSOR_MARKER,\n\tEditor,\n\ttype EditorOptions,\n\ttype EditorTheme,\n\ttype TUI,\n\ttruncateToWidth,\n\tvisibleWidth,\n} from \"@earendil-works/pi-tui\";\nimport type { AppKeybinding, KeybindingsManager } from \"../../../core/keybindings.ts\";\nimport { stripAnsi } from \"../../../utils/ansi.ts\";\n\nexport interface CustomEditorOptions extends EditorOptions {\n\t/** Marker rendered at the start of the first input line, e.g. `\"> \"`. */\n\tpromptPrefix?: string;\n\t/** Styles the prompt prefix. Defaults to leaving it unstyled. */\n\tpromptColor?: (text: string) => string;\n\t/** Shown in place of the empty input line. */\n\tplaceholder?: string;\n\t/** Styles the placeholder. Defaults to leaving it unstyled. */\n\tplaceholderColor?: (text: string) => string;\n\t/** Styles a leading `/command` token. Defaults to leaving it unstyled. */\n\tcommandColor?: (text: string) => string;\n\t/** Applies the filled prompt surface around the editor block. */\n\tsurfaceColor?: (text: string) => string;\n\t/** Rule drawn above the autocomplete rows. Omit for no rule. */\n\tautocompleteRule?: (width: number) => string;\n\t/** Keybinding footer drawn under the autocomplete rows. Omit for no footer. */\n\tautocompleteFooter?: () => string;\n}\n\n/** Box-drawing horizontal rule: the character the base Editor draws borders from. */\nconst BORDER_CHAR = \"─\";\n\n/**\n * The two shapes the base Editor draws a border in: a plain full-width rule, and\n * the scroll indicator (`─── ↑ 3 more ────`).\n *\n * Both are anchored deliberately. A prefix test would count any content line that\n * merely *starts* with the rule character — a pasted divider, `─notes` — as a\n * border, which is worse than it sounds: {@link CustomEditor.render} tells the\n * content region from the autocomplete region by counting borders, so one\n * miscount shifts every later line into the wrong region.\n */\nconst BORDER_RULE = /^─+$/;\nconst BORDER_SCROLL = /^─+ [↑↓] \\d+ more/;\n\n/**\n * A leading `/command` token: optional indent, a slash, then non-space.\n * Matched against the line's *visible* text, not the rendered string.\n */\nconst COMMAND_TOKEN = /^(\\s*)(\\/\\S+)/;\n\n/**\n * One ANSI control sequence: a CSI escape (`ESC [ … letter`) or the APC\n * hardware-cursor marker (`ESC _ … BEL`). Sticky, for position-by-position\n * scanning in {@link colorVisibleRange}.\n */\nconst CONTROL_SEQUENCE = /\\x1b\\[[0-9;]*[A-Za-z]|\\x1b_[^\\x07]*\\x07/y;\n\n/** The reverse-video cursor cell emitted by the inherited editor. */\nconst INVERTED_CURSOR_CELL = /\\x1b\\[7m[\\s\\S]\\x1b\\[(?:0|27)m/y;\n\nconst SURFACE_PADDING = 2;\n\n/**\n * ============================ ANSI measuring hazards ============================\n *\n * Two traps live in the rendered strings this file post-processes. Both produced\n * real bugs; both are cheap to re-introduce. Read this before touching the width\n * maths or any leading-sequence match.\n *\n * 1. DO NOT COMPOSE `stripAnsi` WITH `visibleWidth`.\n *\n *    `stripAnsi` removes SGR colour codes but leaves the APC hardware-cursor\n *    marker (`ESC _pi:c BEL`, see CURSOR_MARKER in packages/tui) fully intact —\n *    all seven bytes of it. `visibleWidth` already handles that marker correctly\n *    and scores it zero.\n *\n *    So `visibleWidth(stripAnsi(line))` counts seven phantom columns on every\n *    line carrying a cursor, which silently widened each placeholder line past\n *    the terminal width. Measure with `visibleWidth` alone. Use `stripAnsi` only\n *    to read text, never to measure it.\n *\n * 2. DO NOT MATCH THE LEADING SEQUENCE RUN GENERICALLY.\n *\n *    The base Editor renders an empty line as:\n *        CURSOR_MARKER  ESC[7m  <space>  ESC[0m  <padding>\n *    The `ESC[7m` turns on reverse video for exactly the one-cell cursor block,\n *    and `ESC[0m` turns it back off.\n *\n *    A permissive prefix match such as `(?:\\x1b\\[[0-9;]*m)*` consumes that\n *    `ESC[7m` as though it were ordinary leading styling. Whatever is appended\n *    next then inherits reverse video, and because the matching `ESC[0m` was\n *    left behind in the discarded remainder, the inversion runs on through the\n *    placeholder and the rest of the frame. Match the reverse-video run\n *    explicitly instead — see {@link CustomEditor.sliceLeadingCursorCell}.\n *\n * ==============================================================================\n */\n\n/**\n * Wrap the visible characters in `[start, end)` with `colorFn`, leaving every\n * control sequence in place.\n *\n * The range is in visible columns, so it is unaffected by however many escape\n * sequences are interleaved. That matters because the cursor cell can land in\n * the middle of the token being coloured: with the caret at column 3 of\n * `/model`, the line reads `/mo` + CURSOR_MARKER + `ESC[7m` + `d` + `ESC[0m` +\n * `el`. Colour is therefore re-opened after every control sequence rather than\n * once around the whole token, since the cursor cell's `ESC[0m` would otherwise\n * cancel it partway through.\n */\nfunction colorVisibleRange(line: string, start: number, end: number, colorFn: (text: string) => string): string {\n\tlet out = \"\";\n\tlet buffer = \"\";\n\tlet column = 0;\n\tlet index = 0;\n\n\tconst flush = () => {\n\t\tif (buffer) {\n\t\t\tout += colorFn(buffer);\n\t\t\tbuffer = \"\";\n\t\t}\n\t};\n\n\twhile (index < line.length) {\n\t\tCONTROL_SEQUENCE.lastIndex = index;\n\t\tconst control = CONTROL_SEQUENCE.exec(line);\n\t\tif (control) {\n\t\t\tflush();\n\t\t\tout += control[0];\n\t\t\tindex = CONTROL_SEQUENCE.lastIndex;\n\t\t\tcontinue;\n\t\t}\n\t\tconst char = line[index];\n\t\tif (column >= start && column < end) {\n\t\t\tbuffer += char;\n\t\t} else {\n\t\t\tflush();\n\t\t\tout += char;\n\t\t}\n\t\tcolumn += visibleWidth(char);\n\t\tindex += 1;\n\t}\n\tflush();\n\treturn out;\n}\n\n/**\n * Custom editor that handles app-level keybindings for coding-agent.\n *\n * The prompt prefix and placeholder are layered on in `render` rather than\n * inside the base Editor, because `packages/tui` is frozen under ADR 0001 and\n * its `EditorOptions` has no hook for either.\n */\nexport class CustomEditor extends Editor {\n\tprivate keybindings: KeybindingsManager;\n\tprivate readonly promptPrefix: string;\n\tprivate readonly promptColor: (text: string) => string;\n\tprivate readonly placeholderColor: (text: string) => string;\n\tprivate readonly commandColor: ((text: string) => string) | undefined;\n\tprivate readonly surfaceColor: ((text: string) => string) | undefined;\n\tprivate readonly placeholder: string | undefined;\n\tprivate readonly autocompleteRule: ((width: number) => string) | undefined;\n\tprivate readonly autocompleteFooter: (() => string) | undefined;\n\tprivate modeLabel = \"\";\n\tpublic actionHandlers: Map<AppKeybinding, () => void> = new Map();\n\n\t// Special handlers that can be dynamically replaced\n\tpublic onEscape?: () => void;\n\tpublic onCtrlD?: () => void;\n\tpublic onPasteImage?: () => void;\n\t/** Handler for extension-registered shortcuts. Returns true if handled. */\n\tpublic onExtensionShortcut?: (data: string) => boolean;\n\n\tconstructor(tui: TUI, theme: EditorTheme, keybindings: KeybindingsManager, options?: CustomEditorOptions) {\n\t\tsuper(tui, theme, options);\n\t\tthis.keybindings = keybindings;\n\t\tthis.promptPrefix = options?.promptPrefix ?? \"\";\n\t\tthis.promptColor = options?.promptColor ?? ((text) => text);\n\t\tthis.placeholder = options?.placeholder;\n\t\tthis.placeholderColor = options?.placeholderColor ?? ((text) => text);\n\t\tthis.commandColor = options?.commandColor;\n\t\tthis.surfaceColor = options?.surfaceColor;\n\t\tthis.autocompleteRule = options?.autocompleteRule;\n\t\tthis.autocompleteFooter = options?.autocompleteFooter;\n\t}\n\n\toverride render(width: number): string[] {\n\t\tconst canRenderSurface = this.surfaceColor !== undefined && width > 0;\n\t\tconst surfacePadding = canRenderSurface ? Math.min(SURFACE_PADDING, Math.floor((width - 1) / 2)) : 0;\n\t\tconst editorWidth = canRenderSurface ? width - surfacePadding * 2 : width;\n\t\tconst lines = this.withAutocompleteChrome(this.renderEditor(editorWidth), editorWidth);\n\t\treturn canRenderSurface ? this.withSurface(lines, width, surfacePadding) : lines;\n\t}\n\n\tprivate renderEditor(width: number): string[] {\n\t\tconst promptPrefix = this.modeLabel ? `[${this.modeLabel}] ${this.promptPrefix}` : this.promptPrefix;\n\t\tconst prefixWidth = visibleWidth(promptPrefix);\n\t\t// Reserve the prefix out of the width handed to the base Editor, so its\n\t\t// wrapping, scrolling and cursor column all account for the space the\n\t\t// prefix occupies. Bail out entirely when the terminal cannot spare it.\n\t\tif (prefixWidth === 0 || width <= prefixWidth + 4) {\n\t\t\treturn this.withCommandColor(this.withPlaceholder(super.render(width)));\n\t\t}\n\n\t\tconst inner = this.withCommandColor(this.withPlaceholder(super.render(width - prefixWidth)));\n\t\tconst borderPad = this.borderColor(BORDER_CHAR.repeat(prefixWidth));\n\t\tconst blank = \" \".repeat(prefixWidth);\n\t\tconst styledPrefix = this.promptColor(promptPrefix);\n\n\t\t// Structure is: top border, content lines, bottom border, then optional\n\t\t// autocomplete rows. Counting borders tells the three regions apart\n\t\t// without depending on how many lines each contains.\n\t\tlet borders = 0;\n\t\tlet firstContentLine = true;\n\t\treturn inner.map((line) => {\n\t\t\tif (this.isBorderLine(line)) {\n\t\t\t\tborders++;\n\t\t\t\treturn borderPad + line;\n\t\t\t}\n\t\t\tif (borders !== 1) {\n\t\t\t\t// Autocomplete rows sit below the box; indent them to match.\n\t\t\t\treturn blank + line;\n\t\t\t}\n\t\t\tif (firstContentLine) {\n\t\t\t\tfirstContentLine = false;\n\t\t\t\treturn styledPrefix + line;\n\t\t\t}\n\t\t\treturn blank + line;\n\t\t});\n\t}\n\n\t/**\n\t * Brackets the autocomplete rows with a rule and a keybinding footer.\n\t *\n\t * The rows arrive after the editor's second border, so the same border count\n\t * that separates the box from its dropdown elsewhere in this file finds them\n\t * here. Nothing is added when the dropdown is closed.\n\t */\n\tprivate withAutocompleteChrome(lines: string[], width: number): string[] {\n\t\tif (!this.autocompleteRule && !this.autocompleteFooter) return lines;\n\t\tconst blockLineCount = this.editorBlockLineCount(lines);\n\t\tconst rows = lines.slice(blockLineCount);\n\t\tif (rows.length === 0) return lines;\n\n\t\tconst chrome = [...lines.slice(0, blockLineCount)];\n\t\tif (this.autocompleteRule) chrome.push(this.autocompleteRule(width));\n\t\tchrome.push(...rows);\n\t\tif (this.autocompleteFooter) chrome.push(this.autocompleteFooter());\n\t\treturn chrome;\n\t}\n\n\tprivate withSurface(lines: string[], width: number, padding: number): string[] {\n\t\tconst surfaceColor = this.surfaceColor;\n\t\tif (!surfaceColor) return lines;\n\n\t\tconst result = [this.surfaceLine(\" \".repeat(width), surfaceColor)];\n\t\tconst editorBlockLineCount = this.editorBlockLineCount(lines);\n\t\tconst editorContent = lines.slice(1, Math.max(1, editorBlockLineCount - 1));\n\t\tfor (const line of editorContent) {\n\t\t\tresult.push(this.surfaceLine(`${\" \".repeat(padding)}${line}${\" \".repeat(padding)}`, surfaceColor));\n\t\t}\n\t\tresult.push(this.surfaceLine(\" \".repeat(width), surfaceColor));\n\t\tfor (const line of lines.slice(editorBlockLineCount)) {\n\t\t\tresult.push(`${\" \".repeat(padding)}${line}`);\n\t\t}\n\t\treturn result;\n\t}\n\n\tprivate editorBlockLineCount(lines: string[]): number {\n\t\tlet borders = 0;\n\t\tfor (let index = 0; index < lines.length; index++) {\n\t\t\tif (this.isBorderLine(lines[index])) borders++;\n\t\t\tif (borders === 2) return index + 1;\n\t\t}\n\t\treturn lines.length;\n\t}\n\n\tprivate surfaceLine(line: string, surfaceColor: (text: string) => string): string {\n\t\tlet output = \"\";\n\t\tlet visibleText = \"\";\n\t\tlet index = 0;\n\n\t\tconst flush = () => {\n\t\t\tif (visibleText) {\n\t\t\t\toutput += surfaceColor(visibleText);\n\t\t\t\tvisibleText = \"\";\n\t\t\t}\n\t\t};\n\n\t\twhile (index < line.length) {\n\t\t\tINVERTED_CURSOR_CELL.lastIndex = index;\n\t\t\tconst cursorCell = INVERTED_CURSOR_CELL.exec(line);\n\t\t\tif (cursorCell) {\n\t\t\t\tflush();\n\t\t\t\toutput += cursorCell[0];\n\t\t\t\tindex = INVERTED_CURSOR_CELL.lastIndex;\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tCONTROL_SEQUENCE.lastIndex = index;\n\t\t\tconst control = CONTROL_SEQUENCE.exec(line);\n\t\t\tif (control) {\n\t\t\t\tflush();\n\t\t\t\toutput += control[0];\n\t\t\t\tindex = CONTROL_SEQUENCE.lastIndex;\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tvisibleText += line[index];\n\t\t\tindex += 1;\n\t\t}\n\n\t\tflush();\n\t\treturn output;\n\t}\n\n\tsetModeLabel(label: string | undefined): void {\n\t\tthis.modeLabel = label ?? \"\";\n\t\tthis.invalidate();\n\t}\n\n\tprivate isBorderLine(line: string): boolean {\n\t\tconst visible = stripAnsi(line.split(CURSOR_MARKER).join(\"\"));\n\t\treturn BORDER_RULE.test(visible) || BORDER_SCROLL.test(visible);\n\t}\n\n\t/**\n\t * Tint a leading `/command` on the first input line.\n\t *\n\t * The base Editor emits input text unstyled, so the only styling already\n\t * present on the line is the cursor cell — which `colorVisibleRange` steps\n\t * over. Only the command token is tinted; arguments after it stay plain, so\n\t * the highlight marks what is being invoked rather than the whole line.\n\t */\n\tprivate withCommandColor(lines: string[]): string[] {\n\t\tconst commandColor = this.commandColor;\n\t\tif (!commandColor || lines.length < 2) {\n\t\t\treturn lines;\n\t\t}\n\t\t// Read the token from the model rather than the rendered line: the first\n\t\t// visual row is the start of the text only when the caret has not scrolled\n\t\t// the view down, and getText is unambiguous either way.\n\t\tconst firstLine = this.getText().split(\"\\n\", 1)[0] ?? \"\";\n\t\tconst match = COMMAND_TOKEN.exec(firstLine);\n\t\tif (!match) {\n\t\t\treturn lines;\n\t\t}\n\t\tconst [, indent, token] = match;\n\t\t// The rendered row must still begin with that token, or the view has\n\t\t// scrolled and the highlight would land on unrelated text.\n\t\tif (!stripAnsi(lines[1].split(CURSOR_MARKER).join(\"\")).startsWith(`${indent}${token}`)) {\n\t\t\treturn lines;\n\t\t}\n\t\tconst start = visibleWidth(indent);\n\t\tconst updated = [...lines];\n\t\tupdated[1] = colorVisibleRange(lines[1], start, start + visibleWidth(token), commandColor);\n\t\treturn updated;\n\t}\n\n\t/**\n\t * Replace the sole content line with the placeholder while the input is\n\t * empty. Index 1 is always the first content line, and an empty editor has\n\t * exactly one, so no line classification is needed here.\n\t */\n\tprivate withPlaceholder(lines: string[]): string[] {\n\t\tconst placeholder = this.placeholder;\n\t\tif (!placeholder || lines.length < 2 || this.getText().length > 0 || this.isShowingAutocomplete()) {\n\t\t\treturn lines;\n\t\t}\n\t\tconst contentLine = lines[1];\n\t\t// Preserve the cursor cell when focused; unfocused there is none, and the\n\t\t// placeholder simply starts at column zero.\n\t\tconst cursorCell = this.sliceLeadingCursorCell(contentLine);\n\t\t// Measure with visibleWidth alone — never visibleWidth(stripAnsi(...)),\n\t\t// which scores the cursor marker as seven columns. See hazard 1 at the top\n\t\t// of this file.\n\t\tconst available = visibleWidth(contentLine) - visibleWidth(cursorCell);\n\t\tif (available <= 0) {\n\t\t\treturn lines;\n\t\t}\n\t\t// Cut by display width, not by String.slice: `available` counts terminal\n\t\t// columns, while slice counts UTF-16 code units. They only agree for\n\t\t// plain ASCII, and disagreeing splits a surrogate pair or overruns the\n\t\t// line on the first wide character.\n\t\tconst text = truncateToWidth(placeholder, available, \"\");\n\t\tconst padding = \" \".repeat(Math.max(0, available - visibleWidth(text)));\n\t\tconst updated = [...lines];\n\t\tupdated[1] = cursorCell + this.placeholderColor(text) + padding;\n\t\treturn updated;\n\t}\n\n\t/**\n\t * The base Editor renders an empty line as the hardware-cursor marker\n\t * followed by a reverse-video cell: `CURSOR_MARKER ESC[7m <space> ESC[0m`.\n\t * Both parts are kept verbatim.\n\t *\n\t * The `ESC[7m … ESC[0m` run is matched explicitly. Do not \"simplify\" this to\n\t * a general leading-SGR match such as `(?:\\x1b\\[[0-9;]*m)*` — see hazard 2 at\n\t * the top of this file for what that breaks.\n\t */\n\tprivate sliceLeadingCursorCell(line: string): string {\n\t\tconst match = /^(?:\\x1b_pi:c\\x07)?(?:\\x1b\\[7m.\\x1b\\[(?:0|27)m)?/.exec(line);\n\t\treturn match?.[0] ?? \"\";\n\t}\n\n\t/**\n\t * Register a handler for an app action.\n\t */\n\tonAction(action: AppKeybinding, handler: () => void): void {\n\t\tthis.actionHandlers.set(action, handler);\n\t}\n\n\thandleInput(data: string): void {\n\t\t// Check extension-registered shortcuts first\n\t\tif (this.onExtensionShortcut?.(data)) {\n\t\t\treturn;\n\t\t}\n\n\t\t// Check for clipboard paste keybinding\n\t\tif (this.keybindings.matches(data, \"app.clipboard.pasteImage\")) {\n\t\t\tthis.onPasteImage?.();\n\t\t\treturn;\n\t\t}\n\n\t\t// Check app keybindings first\n\n\t\t// Escape/interrupt - only if autocomplete is NOT active\n\t\tif (this.keybindings.matches(data, \"app.interrupt\")) {\n\t\t\tif (!this.isShowingAutocomplete()) {\n\t\t\t\t// Use dynamic onEscape if set, otherwise registered handler\n\t\t\t\tconst handler = this.onEscape ?? this.actionHandlers.get(\"app.interrupt\");\n\t\t\t\tif (handler) {\n\t\t\t\t\thandler();\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t}\n\t\t\t// Let parent handle escape for autocomplete cancellation\n\t\t\tsuper.handleInput(data);\n\t\t\treturn;\n\t\t}\n\n\t\t// Exit (Ctrl+D) - only when editor is empty\n\t\tif (this.keybindings.matches(data, \"app.exit\")) {\n\t\t\tif (this.getText().length === 0) {\n\t\t\t\tconst handler = this.onCtrlD ?? this.actionHandlers.get(\"app.exit\");\n\t\t\t\tif (handler) handler();\n\t\t\t\treturn;\n\t\t\t}\n\t\t\t// Fall through to editor handling for delete-char-forward when not empty\n\t\t}\n\n\t\t// Explicit history bindings take precedence over app actions while the editor is focused.\n\t\t// This lets users bind Ctrl+P even though it cycles models by default.\n\t\tif (\n\t\t\tthis.keybindings.matches(data, \"tui.editor.historyPrevious\") ||\n\t\t\tthis.keybindings.matches(data, \"tui.editor.historyNext\")\n\t\t) {\n\t\t\tsuper.handleInput(data);\n\t\t\treturn;\n\t\t}\n\n\t\t// Check all other app actions\n\t\tfor (const [action, handler] of this.actionHandlers) {\n\t\t\tif (action !== \"app.interrupt\" && action !== \"app.exit\" && this.keybindings.matches(data, action)) {\n\t\t\t\thandler();\n\t\t\t\treturn;\n\t\t\t}\n\t\t}\n\n\t\t// Pass to parent for editor handling\n\t\tsuper.handleInput(data);\n\t}\n}\n"]}

package/dist/modes/interactive/components/custom-editor.js

@@ -1,9 +1,132 @@
-import { Editor } from "@earendil-works/pi-tui";
+import { CURSOR_MARKER, Editor, truncateToWidth, visibleWidth, } from "@earendil-works/pi-tui";
+import { stripAnsi } from "../../../utils/ansi.js";
+/** Box-drawing horizontal rule: the character the base Editor draws borders from. */
+const BORDER_CHAR = "─";
+/**
+ * The two shapes the base Editor draws a border in: a plain full-width rule, and
+ * the scroll indicator (`─── ↑ 3 more ────`).
+ *
+ * Both are anchored deliberately. A prefix test would count any content line that
+ * merely *starts* with the rule character — a pasted divider, `─notes` — as a
+ * border, which is worse than it sounds: {@link CustomEditor.render} tells the
+ * content region from the autocomplete region by counting borders, so one
+ * miscount shifts every later line into the wrong region.
+ */
+const BORDER_RULE = /^─+$/;
+const BORDER_SCROLL = /^─+ [↑↓] \d+ more/;
+/**
+ * A leading `/command` token: optional indent, a slash, then non-space.
+ * Matched against the line's *visible* text, not the rendered string.
+ */
+const COMMAND_TOKEN = /^(\s*)(\/\S+)/;
+/**
+ * One ANSI control sequence: a CSI escape (`ESC [ … letter`) or the APC
+ * hardware-cursor marker (`ESC _ … BEL`). Sticky, for position-by-position
+ * scanning in {@link colorVisibleRange}.
+ */
+const CONTROL_SEQUENCE = /\x1b\[[0-9;]*[A-Za-z]|\x1b_[^\x07]*\x07/y;
+/** The reverse-video cursor cell emitted by the inherited editor. */
+const INVERTED_CURSOR_CELL = /\x1b\[7m[\s\S]\x1b\[(?:0|27)m/y;
+const SURFACE_PADDING = 2;
+/**
+ * ============================ ANSI measuring hazards ============================
+ *
+ * Two traps live in the rendered strings this file post-processes. Both produced
+ * real bugs; both are cheap to re-introduce. Read this before touching the width
+ * maths or any leading-sequence match.
+ *
+ * 1. DO NOT COMPOSE `stripAnsi` WITH `visibleWidth`.
+ *
+ *    `stripAnsi` removes SGR colour codes but leaves the APC hardware-cursor
+ *    marker (`ESC _pi:c BEL`, see CURSOR_MARKER in packages/tui) fully intact —
+ *    all seven bytes of it. `visibleWidth` already handles that marker correctly
+ *    and scores it zero.
+ *
+ *    So `visibleWidth(stripAnsi(line))` counts seven phantom columns on every
+ *    line carrying a cursor, which silently widened each placeholder line past
+ *    the terminal width. Measure with `visibleWidth` alone. Use `stripAnsi` only
+ *    to read text, never to measure it.
+ *
+ * 2. DO NOT MATCH THE LEADING SEQUENCE RUN GENERICALLY.
+ *
+ *    The base Editor renders an empty line as:
+ *        CURSOR_MARKER  ESC[7m  <space>  ESC[0m  <padding>
+ *    The `ESC[7m` turns on reverse video for exactly the one-cell cursor block,
+ *    and `ESC[0m` turns it back off.
+ *
+ *    A permissive prefix match such as `(?:\x1b\[[0-9;]*m)*` consumes that
+ *    `ESC[7m` as though it were ordinary leading styling. Whatever is appended
+ *    next then inherits reverse video, and because the matching `ESC[0m` was
+ *    left behind in the discarded remainder, the inversion runs on through the
+ *    placeholder and the rest of the frame. Match the reverse-video run
+ *    explicitly instead — see {@link CustomEditor.sliceLeadingCursorCell}.
+ *
+ * ==============================================================================
+ */
+/**
+ * Wrap the visible characters in `[start, end)` with `colorFn`, leaving every
+ * control sequence in place.
+ *
+ * The range is in visible columns, so it is unaffected by however many escape
+ * sequences are interleaved. That matters because the cursor cell can land in
+ * the middle of the token being coloured: with the caret at column 3 of
+ * `/model`, the line reads `/mo` + CURSOR_MARKER + `ESC[7m` + `d` + `ESC[0m` +
+ * `el`. Colour is therefore re-opened after every control sequence rather than
+ * once around the whole token, since the cursor cell's `ESC[0m` would otherwise
+ * cancel it partway through.
+ */
+function colorVisibleRange(line, start, end, colorFn) {
+    let out = "";
+    let buffer = "";
+    let column = 0;
+    let index = 0;
+    const flush = () => {
+        if (buffer) {
+            out += colorFn(buffer);
+            buffer = "";
+        }
+    };
+    while (index < line.length) {
+        CONTROL_SEQUENCE.lastIndex = index;
+        const control = CONTROL_SEQUENCE.exec(line);
+        if (control) {
+            flush();
+            out += control[0];
+            index = CONTROL_SEQUENCE.lastIndex;
+            continue;
+        }
+        const char = line[index];
+        if (column >= start && column < end) {
+            buffer += char;
+        }
+        else {
+            flush();
+            out += char;
+        }
+        column += visibleWidth(char);
+        index += 1;
+    }
+    flush();
+    return out;
+}
 /**
  * Custom editor that handles app-level keybindings for coding-agent.
+ *
+ * The prompt prefix and placeholder are layered on in `render` rather than
+ * inside the base Editor, because `packages/tui` is frozen under ADR 0001 and
+ * its `EditorOptions` has no hook for either.
  */
 export class CustomEditor extends Editor {
     keybindings;
+    promptPrefix;
+    promptColor;
+    placeholderColor;
+    commandColor;
+    surfaceColor;
+    placeholder;
+    autocompleteRule;
+    autocompleteFooter;
+    modeLabel = "";
     actionHandlers = new Map();
     // Special handlers that can be dynamically replaced
     onEscape;
@@ -14,6 +137,220 @@ export class CustomEditor extends Editor {
     constructor(tui, theme, keybindings, options) {
         super(tui, theme, options);
         this.keybindings = keybindings;
+        this.promptPrefix = options?.promptPrefix ?? "";
+        this.promptColor = options?.promptColor ?? ((text) => text);
+        this.placeholder = options?.placeholder;
+        this.placeholderColor = options?.placeholderColor ?? ((text) => text);
+        this.commandColor = options?.commandColor;
+        this.surfaceColor = options?.surfaceColor;
+        this.autocompleteRule = options?.autocompleteRule;
+        this.autocompleteFooter = options?.autocompleteFooter;
+    }
+    render(width) {
+        const canRenderSurface = this.surfaceColor !== undefined && width > 0;
+        const surfacePadding = canRenderSurface ? Math.min(SURFACE_PADDING, Math.floor((width - 1) / 2)) : 0;
+        const editorWidth = canRenderSurface ? width - surfacePadding * 2 : width;
+        const lines = this.withAutocompleteChrome(this.renderEditor(editorWidth), editorWidth);
+        return canRenderSurface ? this.withSurface(lines, width, surfacePadding) : lines;
+    }
+    renderEditor(width) {
+        const promptPrefix = this.modeLabel ? `[${this.modeLabel}] ${this.promptPrefix}` : this.promptPrefix;
+        const prefixWidth = visibleWidth(promptPrefix);
+        // Reserve the prefix out of the width handed to the base Editor, so its
+        // wrapping, scrolling and cursor column all account for the space the
+        // prefix occupies. Bail out entirely when the terminal cannot spare it.
+        if (prefixWidth === 0 || width <= prefixWidth + 4) {
+            return this.withCommandColor(this.withPlaceholder(super.render(width)));
+        }
+        const inner = this.withCommandColor(this.withPlaceholder(super.render(width - prefixWidth)));
+        const borderPad = this.borderColor(BORDER_CHAR.repeat(prefixWidth));
+        const blank = " ".repeat(prefixWidth);
+        const styledPrefix = this.promptColor(promptPrefix);
+        // Structure is: top border, content lines, bottom border, then optional
+        // autocomplete rows. Counting borders tells the three regions apart
+        // without depending on how many lines each contains.
+        let borders = 0;
+        let firstContentLine = true;
+        return inner.map((line) => {
+            if (this.isBorderLine(line)) {
+                borders++;
+                return borderPad + line;
+            }
+            if (borders !== 1) {
+                // Autocomplete rows sit below the box; indent them to match.
+                return blank + line;
+            }
+            if (firstContentLine) {
+                firstContentLine = false;
+                return styledPrefix + line;
+            }
+            return blank + line;
+        });
+    }
+    /**
+     * Brackets the autocomplete rows with a rule and a keybinding footer.
+     *
+     * The rows arrive after the editor's second border, so the same border count
+     * that separates the box from its dropdown elsewhere in this file finds them
+     * here. Nothing is added when the dropdown is closed.
+     */
+    withAutocompleteChrome(lines, width) {
+        if (!this.autocompleteRule && !this.autocompleteFooter)
+            return lines;
+        const blockLineCount = this.editorBlockLineCount(lines);
+        const rows = lines.slice(blockLineCount);
+        if (rows.length === 0)
+            return lines;
+        const chrome = [...lines.slice(0, blockLineCount)];
+        if (this.autocompleteRule)
+            chrome.push(this.autocompleteRule(width));
+        chrome.push(...rows);
+        if (this.autocompleteFooter)
+            chrome.push(this.autocompleteFooter());
+        return chrome;
+    }
+    withSurface(lines, width, padding) {
+        const surfaceColor = this.surfaceColor;
+        if (!surfaceColor)
+            return lines;
+        const result = [this.surfaceLine(" ".repeat(width), surfaceColor)];
+        const editorBlockLineCount = this.editorBlockLineCount(lines);
+        const editorContent = lines.slice(1, Math.max(1, editorBlockLineCount - 1));
+        for (const line of editorContent) {
+            result.push(this.surfaceLine(`${" ".repeat(padding)}${line}${" ".repeat(padding)}`, surfaceColor));
+        }
+        result.push(this.surfaceLine(" ".repeat(width), surfaceColor));
+        for (const line of lines.slice(editorBlockLineCount)) {
+            result.push(`${" ".repeat(padding)}${line}`);
+        }
+        return result;
+    }
+    editorBlockLineCount(lines) {
+        let borders = 0;
+        for (let index = 0; index < lines.length; index++) {
+            if (this.isBorderLine(lines[index]))
+                borders++;
+            if (borders === 2)
+                return index + 1;
+        }
+        return lines.length;
+    }
+    surfaceLine(line, surfaceColor) {
+        let output = "";
+        let visibleText = "";
+        let index = 0;
+        const flush = () => {
+            if (visibleText) {
+                output += surfaceColor(visibleText);
+                visibleText = "";
+            }
+        };
+        while (index < line.length) {
+            INVERTED_CURSOR_CELL.lastIndex = index;
+            const cursorCell = INVERTED_CURSOR_CELL.exec(line);
+            if (cursorCell) {
+                flush();
+                output += cursorCell[0];
+                index = INVERTED_CURSOR_CELL.lastIndex;
+                continue;
+            }
+            CONTROL_SEQUENCE.lastIndex = index;
+            const control = CONTROL_SEQUENCE.exec(line);
+            if (control) {
+                flush();
+                output += control[0];
+                index = CONTROL_SEQUENCE.lastIndex;
+                continue;
+            }
+            visibleText += line[index];
+            index += 1;
+        }
+        flush();
+        return output;
+    }
+    setModeLabel(label) {
+        this.modeLabel = label ?? "";
+        this.invalidate();
+    }
+    isBorderLine(line) {
+        const visible = stripAnsi(line.split(CURSOR_MARKER).join(""));
+        return BORDER_RULE.test(visible) || BORDER_SCROLL.test(visible);
+    }
+    /**
+     * Tint a leading `/command` on the first input line.
+     *
+     * The base Editor emits input text unstyled, so the only styling already
+     * present on the line is the cursor cell — which `colorVisibleRange` steps
+     * over. Only the command token is tinted; arguments after it stay plain, so
+     * the highlight marks what is being invoked rather than the whole line.
+     */
+    withCommandColor(lines) {
+        const commandColor = this.commandColor;
+        if (!commandColor || lines.length < 2) {
+            return lines;
+        }
+        // Read the token from the model rather than the rendered line: the first
+        // visual row is the start of the text only when the caret has not scrolled
+        // the view down, and getText is unambiguous either way.
+        const firstLine = this.getText().split("\n", 1)[0] ?? "";
+        const match = COMMAND_TOKEN.exec(firstLine);
+        if (!match) {
+            return lines;
+        }
+        const [, indent, token] = match;
+        // The rendered row must still begin with that token, or the view has
+        // scrolled and the highlight would land on unrelated text.
+        if (!stripAnsi(lines[1].split(CURSOR_MARKER).join("")).startsWith(`${indent}${token}`)) {
+            return lines;
+        }
+        const start = visibleWidth(indent);
+        const updated = [...lines];
+        updated[1] = colorVisibleRange(lines[1], start, start + visibleWidth(token), commandColor);
+        return updated;
+    }
+    /**
+     * Replace the sole content line with the placeholder while the input is
+     * empty. Index 1 is always the first content line, and an empty editor has
+     * exactly one, so no line classification is needed here.
+     */
+    withPlaceholder(lines) {
+        const placeholder = this.placeholder;
+        if (!placeholder || lines.length < 2 || this.getText().length > 0 || this.isShowingAutocomplete()) {
+            return lines;
+        }
+        const contentLine = lines[1];
+        // Preserve the cursor cell when focused; unfocused there is none, and the
+        // placeholder simply starts at column zero.
+        const cursorCell = this.sliceLeadingCursorCell(contentLine);
+        // Measure with visibleWidth alone — never visibleWidth(stripAnsi(...)),
+        // which scores the cursor marker as seven columns. See hazard 1 at the top
+        // of this file.
+        const available = visibleWidth(contentLine) - visibleWidth(cursorCell);
+        if (available <= 0) {
+            return lines;
+        }
+        // Cut by display width, not by String.slice: `available` counts terminal
+        // columns, while slice counts UTF-16 code units. They only agree for
+        // plain ASCII, and disagreeing splits a surrogate pair or overruns the
+        // line on the first wide character.
+        const text = truncateToWidth(placeholder, available, "");
+        const padding = " ".repeat(Math.max(0, available - visibleWidth(text)));
+        const updated = [...lines];
+        updated[1] = cursorCell + this.placeholderColor(text) + padding;
+        return updated;
+    }
+    /**
+     * The base Editor renders an empty line as the hardware-cursor marker
+     * followed by a reverse-video cell: `CURSOR_MARKER ESC[7m <space> ESC[0m`.
+     * Both parts are kept verbatim.
+     *
+     * The `ESC[7m … ESC[0m` run is matched explicitly. Do not "simplify" this to
+     * a general leading-SGR match such as `(?:\x1b\[[0-9;]*m)*` — see hazard 2 at
+     * the top of this file for what that breaks.
+     */
+    sliceLeadingCursorCell(line) {
+        const match = /^(?:\x1b_pi:c\x07)?(?:\x1b\[7m.\x1b\[(?:0|27)m)?/.exec(line);
+        return match?.[0] ?? "";
     }
     /**
      * Register a handler for an app action.

package/dist/modes/interactive/components/custom-editor.js.map

@@ -1 +1 @@
-{"version":3,"file":"custom-editor.js","sourceRoot":"","sources":["../../../../src/modes/interactive/components/custom-editor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAkD,MAAM,wBAAwB,CAAC;AAGhG;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,MAAM;IAC/B,WAAW,CAAqB;IACjC,cAAc,GAAmC,IAAI,GAAG,EAAE,CAAC;IAElE,oDAAoD;IAC7C,QAAQ,CAAc;IACtB,OAAO,CAAc;IACrB,YAAY,CAAc;IACjC,2EAA2E;IACpE,mBAAmB,CAA6B;IAEvD,YAAY,GAAQ,EAAE,KAAkB,EAAE,WAA+B,EAAE,OAAuB,EAAE;QACnG,KAAK,CAAC,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QAC3B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IAAA,CAC/B;IAED;;OAEG;IACH,QAAQ,CAAC,MAAqB,EAAE,OAAmB,EAAQ;QAC1D,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAA,CACzC;IAED,WAAW,CAAC,IAAY,EAAQ;QAC/B,6CAA6C;QAC7C,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,OAAO;QACR,CAAC;QAED,uCAAuC;QACvC,IAAI,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,0BAA0B,CAAC,EAAE,CAAC;YAChE,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC;YACtB,OAAO;QACR,CAAC;QAED,8BAA8B;QAE9B,wDAAwD;QACxD,IAAI,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,eAAe,CAAC,EAAE,CAAC;YACrD,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,CAAC;gBACnC,4DAA4D;gBAC5D,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;gBAC1E,IAAI,OAAO,EAAE,CAAC;oBACb,OAAO,EAAE,CAAC;oBACV,OAAO;gBACR,CAAC;YACF,CAAC;YACD,yDAAyD;YACzD,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YACxB,OAAO;QACR,CAAC;QAED,4CAA4C;QAC5C,IAAI,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,CAAC;YAChD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACjC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;gBACpE,IAAI,OAAO;oBAAE,OAAO,EAAE,CAAC;gBACvB,OAAO;YACR,CAAC;YACD,yEAAyE;QAC1E,CAAC;QAED,0FAA0F;QAC1F,uEAAuE;QACvE,IACC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,4BAA4B,CAAC;YAC5D,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,wBAAwB,CAAC,EACvD,CAAC;YACF,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YACxB,OAAO;QACR,CAAC;QAED,8BAA8B;QAC9B,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACrD,IAAI,MAAM,KAAK,eAAe,IAAI,MAAM,KAAK,UAAU,IAAI,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;gBACnG,OAAO,EAAE,CAAC;gBACV,OAAO;YACR,CAAC;QACF,CAAC;QAED,qCAAqC;QACrC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAAA,CACxB;CACD","sourcesContent":["import { Editor, type EditorOptions, type EditorTheme, type TUI } from \"@earendil-works/pi-tui\";\nimport type { AppKeybinding, KeybindingsManager } from \"../../../core/keybindings.ts\";\n\n/**\n * Custom editor that handles app-level keybindings for coding-agent.\n */\nexport class CustomEditor extends Editor {\n\tprivate keybindings: KeybindingsManager;\n\tpublic actionHandlers: Map<AppKeybinding, () => void> = new Map();\n\n\t// Special handlers that can be dynamically replaced\n\tpublic onEscape?: () => void;\n\tpublic onCtrlD?: () => void;\n\tpublic onPasteImage?: () => void;\n\t/** Handler for extension-registered shortcuts. Returns true if handled. */\n\tpublic onExtensionShortcut?: (data: string) => boolean;\n\n\tconstructor(tui: TUI, theme: EditorTheme, keybindings: KeybindingsManager, options?: EditorOptions) {\n\t\tsuper(tui, theme, options);\n\t\tthis.keybindings = keybindings;\n\t}\n\n\t/**\n\t * Register a handler for an app action.\n\t */\n\tonAction(action: AppKeybinding, handler: () => void): void {\n\t\tthis.actionHandlers.set(action, handler);\n\t}\n\n\thandleInput(data: string): void {\n\t\t// Check extension-registered shortcuts first\n\t\tif (this.onExtensionShortcut?.(data)) {\n\t\t\treturn;\n\t\t}\n\n\t\t// Check for clipboard paste keybinding\n\t\tif (this.keybindings.matches(data, \"app.clipboard.pasteImage\")) {\n\t\t\tthis.onPasteImage?.();\n\t\t\treturn;\n\t\t}\n\n\t\t// Check app keybindings first\n\n\t\t// Escape/interrupt - only if autocomplete is NOT active\n\t\tif (this.keybindings.matches(data, \"app.interrupt\")) {\n\t\t\tif (!this.isShowingAutocomplete()) {\n\t\t\t\t// Use dynamic onEscape if set, otherwise registered handler\n\t\t\t\tconst handler = this.onEscape ?? this.actionHandlers.get(\"app.interrupt\");\n\t\t\t\tif (handler) {\n\t\t\t\t\thandler();\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t}\n\t\t\t// Let parent handle escape for autocomplete cancellation\n\t\t\tsuper.handleInput(data);\n\t\t\treturn;\n\t\t}\n\n\t\t// Exit (Ctrl+D) - only when editor is empty\n\t\tif (this.keybindings.matches(data, \"app.exit\")) {\n\t\t\tif (this.getText().length === 0) {\n\t\t\t\tconst handler = this.onCtrlD ?? this.actionHandlers.get(\"app.exit\");\n\t\t\t\tif (handler) handler();\n\t\t\t\treturn;\n\t\t\t}\n\t\t\t// Fall through to editor handling for delete-char-forward when not empty\n\t\t}\n\n\t\t// Explicit history bindings take precedence over app actions while the editor is focused.\n\t\t// This lets users bind Ctrl+P even though it cycles models by default.\n\t\tif (\n\t\t\tthis.keybindings.matches(data, \"tui.editor.historyPrevious\") ||\n\t\t\tthis.keybindings.matches(data, \"tui.editor.historyNext\")\n\t\t) {\n\t\t\tsuper.handleInput(data);\n\t\t\treturn;\n\t\t}\n\n\t\t// Check all other app actions\n\t\tfor (const [action, handler] of this.actionHandlers) {\n\t\t\tif (action !== \"app.interrupt\" && action !== \"app.exit\" && this.keybindings.matches(data, action)) {\n\t\t\t\thandler();\n\t\t\t\treturn;\n\t\t\t}\n\t\t}\n\n\t\t// Pass to parent for editor handling\n\t\tsuper.handleInput(data);\n\t}\n}\n"]}
+{"version":3,"file":"custom-editor.js","sourceRoot":"","sources":["../../../../src/modes/interactive/components/custom-editor.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n\tCURSOR_MARKER,\n\tEditor,\n\ttype EditorOptions,\n\ttype EditorTheme,\n\ttype TUI,\n\ttruncateToWidth,\n\tvisibleWidth,\n} from \"@earendil-works/pi-tui\";\nimport type { AppKeybinding, KeybindingsManager } from \"../../../core/keybindings.ts\";\nimport { stripAnsi } from \"../../../utils/ansi.ts\";\n\nexport interface CustomEditorOptions extends EditorOptions {\n\t/** Marker rendered at the start of the first input line, e.g. `\"> \"`. */\n\tpromptPrefix?: string;\n\t/** Styles the prompt prefix. Defaults to leaving it unstyled. */\n\tpromptColor?: (text: string) => string;\n\t/** Shown in place of the empty input line. */\n\tplaceholder?: string;\n\t/** Styles the placeholder. Defaults to leaving it unstyled. */\n\tplaceholderColor?: (text: string) => string;\n\t/** Styles a leading `/command` token. Defaults to leaving it unstyled. */\n\tcommandColor?: (text: string) => string;\n\t/** Applies the filled prompt surface around the editor block. */\n\tsurfaceColor?: (text: string) => string;\n\t/** Rule drawn above the autocomplete rows. Omit for no rule. */\n\tautocompleteRule?: (width: number) => string;\n\t/** Keybinding footer drawn under the autocomplete rows. Omit for no footer. */\n\tautocompleteFooter?: () => string;\n}\n\n/** Box-drawing horizontal rule: the character the base Editor draws borders from. */\nconst BORDER_CHAR = \"─\";\n\n/**\n * The two shapes the base Editor draws a border in: a plain full-width rule, and\n * the scroll indicator (`─── ↑ 3 more ────`).\n *\n * Both are anchored deliberately. A prefix test would count any content line that\n * merely *starts* with the rule character — a pasted divider, `─notes` — as a\n * border, which is worse than it sounds: {@link CustomEditor.render} tells the\n * content region from the autocomplete region by counting borders, so one\n * miscount shifts every later line into the wrong region.\n */\nconst BORDER_RULE = /^─+$/;\nconst BORDER_SCROLL = /^─+ [↑↓] \\d+ more/;\n\n/**\n * A leading `/command` token: optional indent, a slash, then non-space.\n * Matched against the line's *visible* text, not the rendered string.\n */\nconst COMMAND_TOKEN = /^(\\s*)(\\/\\S+)/;\n\n/**\n * One ANSI control sequence: a CSI escape (`ESC [ … letter`) or the APC\n * hardware-cursor marker (`ESC _ … BEL`). Sticky, for position-by-position\n * scanning in {@link colorVisibleRange}.\n */\nconst CONTROL_SEQUENCE = /\\x1b\\[[0-9;]*[A-Za-z]|\\x1b_[^\\x07]*\\x07/y;\n\n/** The reverse-video cursor cell emitted by the inherited editor. */\nconst INVERTED_CURSOR_CELL = /\\x1b\\[7m[\\s\\S]\\x1b\\[(?:0|27)m/y;\n\nconst SURFACE_PADDING = 2;\n\n/**\n * ============================ ANSI measuring hazards ============================\n *\n * Two traps live in the rendered strings this file post-processes. Both produced\n * real bugs; both are cheap to re-introduce. Read this before touching the width\n * maths or any leading-sequence match.\n *\n * 1. DO NOT COMPOSE `stripAnsi` WITH `visibleWidth`.\n *\n *    `stripAnsi` removes SGR colour codes but leaves the APC hardware-cursor\n *    marker (`ESC _pi:c BEL`, see CURSOR_MARKER in packages/tui) fully intact —\n *    all seven bytes of it. `visibleWidth` already handles that marker correctly\n *    and scores it zero.\n *\n *    So `visibleWidth(stripAnsi(line))` counts seven phantom columns on every\n *    line carrying a cursor, which silently widened each placeholder line past\n *    the terminal width. Measure with `visibleWidth` alone. Use `stripAnsi` only\n *    to read text, never to measure it.\n *\n * 2. DO NOT MATCH THE LEADING SEQUENCE RUN GENERICALLY.\n *\n *    The base Editor renders an empty line as:\n *        CURSOR_MARKER  ESC[7m  <space>  ESC[0m  <padding>\n *    The `ESC[7m` turns on reverse video for exactly the one-cell cursor block,\n *    and `ESC[0m` turns it back off.\n *\n *    A permissive prefix match such as `(?:\\x1b\\[[0-9;]*m)*` consumes that\n *    `ESC[7m` as though it were ordinary leading styling. Whatever is appended\n *    next then inherits reverse video, and because the matching `ESC[0m` was\n *    left behind in the discarded remainder, the inversion runs on through the\n *    placeholder and the rest of the frame. Match the reverse-video run\n *    explicitly instead — see {@link CustomEditor.sliceLeadingCursorCell}.\n *\n * ==============================================================================\n */\n\n/**\n * Wrap the visible characters in `[start, end)` with `colorFn`, leaving every\n * control sequence in place.\n *\n * The range is in visible columns, so it is unaffected by however many escape\n * sequences are interleaved. That matters because the cursor cell can land in\n * the middle of the token being coloured: with the caret at column 3 of\n * `/model`, the line reads `/mo` + CURSOR_MARKER + `ESC[7m` + `d` + `ESC[0m` +\n * `el`. Colour is therefore re-opened after every control sequence rather than\n * once around the whole token, since the cursor cell's `ESC[0m` would otherwise\n * cancel it partway through.\n */\nfunction colorVisibleRange(line: string, start: number, end: number, colorFn: (text: string) => string): string {\n\tlet out = \"\";\n\tlet buffer = \"\";\n\tlet column = 0;\n\tlet index = 0;\n\n\tconst flush = () => {\n\t\tif (buffer) {\n\t\t\tout += colorFn(buffer);\n\t\t\tbuffer = \"\";\n\t\t}\n\t};\n\n\twhile (index < line.length) {\n\t\tCONTROL_SEQUENCE.lastIndex = index;\n\t\tconst control = CONTROL_SEQUENCE.exec(line);\n\t\tif (control) {\n\t\t\tflush();\n\t\t\tout += control[0];\n\t\t\tindex = CONTROL_SEQUENCE.lastIndex;\n\t\t\tcontinue;\n\t\t}\n\t\tconst char = line[index];\n\t\tif (column >= start && column < end) {\n\t\t\tbuffer += char;\n\t\t} else {\n\t\t\tflush();\n\t\t\tout += char;\n\t\t}\n\t\tcolumn += visibleWidth(char);\n\t\tindex += 1;\n\t}\n\tflush();\n\treturn out;\n}\n\n/**\n * Custom editor that handles app-level keybindings for coding-agent.\n *\n * The prompt prefix and placeholder are layered on in `render` rather than\n * inside the base Editor, because `packages/tui` is frozen under ADR 0001 and\n * its `EditorOptions` has no hook for either.\n */\nexport class CustomEditor extends Editor {\n\tprivate keybindings: KeybindingsManager;\n\tprivate readonly promptPrefix: string;\n\tprivate readonly promptColor: (text: string) => string;\n\tprivate readonly placeholderColor: (text: string) => string;\n\tprivate readonly commandColor: ((text: string) => string) | undefined;\n\tprivate readonly surfaceColor: ((text: string) => string) | undefined;\n\tprivate readonly placeholder: string | undefined;\n\tprivate readonly autocompleteRule: ((width: number) => string) | undefined;\n\tprivate readonly autocompleteFooter: (() => string) | undefined;\n\tprivate modeLabel = \"\";\n\tpublic actionHandlers: Map<AppKeybinding, () => void> = new Map();\n\n\t// Special handlers that can be dynamically replaced\n\tpublic onEscape?: () => void;\n\tpublic onCtrlD?: () => void;\n\tpublic onPasteImage?: () => void;\n\t/** Handler for extension-registered shortcuts. Returns true if handled. */\n\tpublic onExtensionShortcut?: (data: string) => boolean;\n\n\tconstructor(tui: TUI, theme: EditorTheme, keybindings: KeybindingsManager, options?: CustomEditorOptions) {\n\t\tsuper(tui, theme, options);\n\t\tthis.keybindings = keybindings;\n\t\tthis.promptPrefix = options?.promptPrefix ?? \"\";\n\t\tthis.promptColor = options?.promptColor ?? ((text) => text);\n\t\tthis.placeholder = options?.placeholder;\n\t\tthis.placeholderColor = options?.placeholderColor ?? ((text) => text);\n\t\tthis.commandColor = options?.commandColor;\n\t\tthis.surfaceColor = options?.surfaceColor;\n\t\tthis.autocompleteRule = options?.autocompleteRule;\n\t\tthis.autocompleteFooter = options?.autocompleteFooter;\n\t}\n\n\toverride render(width: number): string[] {\n\t\tconst canRenderSurface = this.surfaceColor !== undefined && width > 0;\n\t\tconst surfacePadding = canRenderSurface ? Math.min(SURFACE_PADDING, Math.floor((width - 1) / 2)) : 0;\n\t\tconst editorWidth = canRenderSurface ? width - surfacePadding * 2 : width;\n\t\tconst lines = this.withAutocompleteChrome(this.renderEditor(editorWidth), editorWidth);\n\t\treturn canRenderSurface ? this.withSurface(lines, width, surfacePadding) : lines;\n\t}\n\n\tprivate renderEditor(width: number): string[] {\n\t\tconst promptPrefix = this.modeLabel ? `[${this.modeLabel}] ${this.promptPrefix}` : this.promptPrefix;\n\t\tconst prefixWidth = visibleWidth(promptPrefix);\n\t\t// Reserve the prefix out of the width handed to the base Editor, so its\n\t\t// wrapping, scrolling and cursor column all account for the space the\n\t\t// prefix occupies. Bail out entirely when the terminal cannot spare it.\n\t\tif (prefixWidth === 0 || width <= prefixWidth + 4) {\n\t\t\treturn this.withCommandColor(this.withPlaceholder(super.render(width)));\n\t\t}\n\n\t\tconst inner = this.withCommandColor(this.withPlaceholder(super.render(width - prefixWidth)));\n\t\tconst borderPad = this.borderColor(BORDER_CHAR.repeat(prefixWidth));\n\t\tconst blank = \" \".repeat(prefixWidth);\n\t\tconst styledPrefix = this.promptColor(promptPrefix);\n\n\t\t// Structure is: top border, content lines, bottom border, then optional\n\t\t// autocomplete rows. Counting borders tells the three regions apart\n\t\t// without depending on how many lines each contains.\n\t\tlet borders = 0;\n\t\tlet firstContentLine = true;\n\t\treturn inner.map((line) => {\n\t\t\tif (this.isBorderLine(line)) {\n\t\t\t\tborders++;\n\t\t\t\treturn borderPad + line;\n\t\t\t}\n\t\t\tif (borders !== 1) {\n\t\t\t\t// Autocomplete rows sit below the box; indent them to match.\n\t\t\t\treturn blank + line;\n\t\t\t}\n\t\t\tif (firstContentLine) {\n\t\t\t\tfirstContentLine = false;\n\t\t\t\treturn styledPrefix + line;\n\t\t\t}\n\t\t\treturn blank + line;\n\t\t});\n\t}\n\n\t/**\n\t * Brackets the autocomplete rows with a rule and a keybinding footer.\n\t *\n\t * The rows arrive after the editor's second border, so the same border count\n\t * that separates the box from its dropdown elsewhere in this file finds them\n\t * here. Nothing is added when the dropdown is closed.\n\t */\n\tprivate withAutocompleteChrome(lines: string[], width: number): string[] {\n\t\tif (!this.autocompleteRule && !this.autocompleteFooter) return lines;\n\t\tconst blockLineCount = this.editorBlockLineCount(lines);\n\t\tconst rows = lines.slice(blockLineCount);\n\t\tif (rows.length === 0) return lines;\n\n\t\tconst chrome = [...lines.slice(0, blockLineCount)];\n\t\tif (this.autocompleteRule) chrome.push(this.autocompleteRule(width));\n\t\tchrome.push(...rows);\n\t\tif (this.autocompleteFooter) chrome.push(this.autocompleteFooter());\n\t\treturn chrome;\n\t}\n\n\tprivate withSurface(lines: string[], width: number, padding: number): string[] {\n\t\tconst surfaceColor = this.surfaceColor;\n\t\tif (!surfaceColor) return lines;\n\n\t\tconst result = [this.surfaceLine(\" \".repeat(width), surfaceColor)];\n\t\tconst editorBlockLineCount = this.editorBlockLineCount(lines);\n\t\tconst editorContent = lines.slice(1, Math.max(1, editorBlockLineCount - 1));\n\t\tfor (const line of editorContent) {\n\t\t\tresult.push(this.surfaceLine(`${\" \".repeat(padding)}${line}${\" \".repeat(padding)}`, surfaceColor));\n\t\t}\n\t\tresult.push(this.surfaceLine(\" \".repeat(width), surfaceColor));\n\t\tfor (const line of lines.slice(editorBlockLineCount)) {\n\t\t\tresult.push(`${\" \".repeat(padding)}${line}`);\n\t\t}\n\t\treturn result;\n\t}\n\n\tprivate editorBlockLineCount(lines: string[]): number {\n\t\tlet borders = 0;\n\t\tfor (let index = 0; index < lines.length; index++) {\n\t\t\tif (this.isBorderLine(lines[index])) borders++;\n\t\t\tif (borders === 2) return index + 1;\n\t\t}\n\t\treturn lines.length;\n\t}\n\n\tprivate surfaceLine(line: string, surfaceColor: (text: string) => string): string {\n\t\tlet output = \"\";\n\t\tlet visibleText = \"\";\n\t\tlet index = 0;\n\n\t\tconst flush = () => {\n\t\t\tif (visibleText) {\n\t\t\t\toutput += surfaceColor(visibleText);\n\t\t\t\tvisibleText = \"\";\n\t\t\t}\n\t\t};\n\n\t\twhile (index < line.length) {\n\t\t\tINVERTED_CURSOR_CELL.lastIndex = index;\n\t\t\tconst cursorCell = INVERTED_CURSOR_CELL.exec(line);\n\t\t\tif (cursorCell) {\n\t\t\t\tflush();\n\t\t\t\toutput += cursorCell[0];\n\t\t\t\tindex = INVERTED_CURSOR_CELL.lastIndex;\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tCONTROL_SEQUENCE.lastIndex = index;\n\t\t\tconst control = CONTROL_SEQUENCE.exec(line);\n\t\t\tif (control) {\n\t\t\t\tflush();\n\t\t\t\toutput += control[0];\n\t\t\t\tindex = CONTROL_SEQUENCE.lastIndex;\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tvisibleText += line[index];\n\t\t\tindex += 1;\n\t\t}\n\n\t\tflush();\n\t\treturn output;\n\t}\n\n\tsetModeLabel(label: string | undefined): void {\n\t\tthis.modeLabel = label ?? \"\";\n\t\tthis.invalidate();\n\t}\n\n\tprivate isBorderLine(line: string): boolean {\n\t\tconst visible = stripAnsi(line.split(CURSOR_MARKER).join(\"\"));\n\t\treturn BORDER_RULE.test(visible) || BORDER_SCROLL.test(visible);\n\t}\n\n\t/**\n\t * Tint a leading `/command` on the first input line.\n\t *\n\t * The base Editor emits input text unstyled, so the only styling already\n\t * present on the line is the cursor cell — which `colorVisibleRange` steps\n\t * over. Only the command token is tinted; arguments after it stay plain, so\n\t * the highlight marks what is being invoked rather than the whole line.\n\t */\n\tprivate withCommandColor(lines: string[]): string[] {\n\t\tconst commandColor = this.commandColor;\n\t\tif (!commandColor || lines.length < 2) {\n\t\t\treturn lines;\n\t\t}\n\t\t// Read the token from the model rather than the rendered line: the first\n\t\t// visual row is the start of the text only when the caret has not scrolled\n\t\t// the view down, and getText is unambiguous either way.\n\t\tconst firstLine = this.getText().split(\"\\n\", 1)[0] ?? \"\";\n\t\tconst match = COMMAND_TOKEN.exec(firstLine);\n\t\tif (!match) {\n\t\t\treturn lines;\n\t\t}\n\t\tconst [, indent, token] = match;\n\t\t// The rendered row must still begin with that token, or the view has\n\t\t// scrolled and the highlight would land on unrelated text.\n\t\tif (!stripAnsi(lines[1].split(CURSOR_MARKER).join(\"\")).startsWith(`${indent}${token}`)) {\n\t\t\treturn lines;\n\t\t}\n\t\tconst start = visibleWidth(indent);\n\t\tconst updated = [...lines];\n\t\tupdated[1] = colorVisibleRange(lines[1], start, start + visibleWidth(token), commandColor);\n\t\treturn updated;\n\t}\n\n\t/**\n\t * Replace the sole content line with the placeholder while the input is\n\t * empty. Index 1 is always the first content line, and an empty editor has\n\t * exactly one, so no line classification is needed here.\n\t */\n\tprivate withPlaceholder(lines: string[]): string[] {\n\t\tconst placeholder = this.placeholder;\n\t\tif (!placeholder || lines.length < 2 || this.getText().length > 0 || this.isShowingAutocomplete()) {\n\t\t\treturn lines;\n\t\t}\n\t\tconst contentLine = lines[1];\n\t\t// Preserve the cursor cell when focused; unfocused there is none, and the\n\t\t// placeholder simply starts at column zero.\n\t\tconst cursorCell = this.sliceLeadingCursorCell(contentLine);\n\t\t// Measure with visibleWidth alone — never visibleWidth(stripAnsi(...)),\n\t\t// which scores the cursor marker as seven columns. See hazard 1 at the top\n\t\t// of this file.\n\t\tconst available = visibleWidth(contentLine) - visibleWidth(cursorCell);\n\t\tif (available <= 0) {\n\t\t\treturn lines;\n\t\t}\n\t\t// Cut by display width, not by String.slice: `available` counts terminal\n\t\t// columns, while slice counts UTF-16 code units. They only agree for\n\t\t// plain ASCII, and disagreeing splits a surrogate pair or overruns the\n\t\t// line on the first wide character.\n\t\tconst text = truncateToWidth(placeholder, available, \"\");\n\t\tconst padding = \" \".repeat(Math.max(0, available - visibleWidth(text)));\n\t\tconst updated = [...lines];\n\t\tupdated[1] = cursorCell + this.placeholderColor(text) + padding;\n\t\treturn updated;\n\t}\n\n\t/**\n\t * The base Editor renders an empty line as the hardware-cursor marker\n\t * followed by a reverse-video cell: `CURSOR_MARKER ESC[7m <space> ESC[0m`.\n\t * Both parts are kept verbatim.\n\t *\n\t * The `ESC[7m … ESC[0m` run is matched explicitly. Do not \"simplify\" this to\n\t * a general leading-SGR match such as `(?:\\x1b\\[[0-9;]*m)*` — see hazard 2 at\n\t * the top of this file for what that breaks.\n\t */\n\tprivate sliceLeadingCursorCell(line: string): string {\n\t\tconst match = /^(?:\\x1b_pi:c\\x07)?(?:\\x1b\\[7m.\\x1b\\[(?:0|27)m)?/.exec(line);\n\t\treturn match?.[0] ?? \"\";\n\t}\n\n\t/**\n\t * Register a handler for an app action.\n\t */\n\tonAction(action: AppKeybinding, handler: () => void): void {\n\t\tthis.actionHandlers.set(action, handler);\n\t}\n\n\thandleInput(data: string): void {\n\t\t// Check extension-registered shortcuts first\n\t\tif (this.onExtensionShortcut?.(data)) {\n\t\t\treturn;\n\t\t}\n\n\t\t// Check for clipboard paste keybinding\n\t\tif (this.keybindings.matches(data, \"app.clipboard.pasteImage\")) {\n\t\t\tthis.onPasteImage?.();\n\t\t\treturn;\n\t\t}\n\n\t\t// Check app keybindings first\n\n\t\t// Escape/interrupt - only if autocomplete is NOT active\n\t\tif (this.keybindings.matches(data, \"app.interrupt\")) {\n\t\t\tif (!this.isShowingAutocomplete()) {\n\t\t\t\t// Use dynamic onEscape if set, otherwise registered handler\n\t\t\t\tconst handler = this.onEscape ?? this.actionHandlers.get(\"app.interrupt\");\n\t\t\t\tif (handler) {\n\t\t\t\t\thandler();\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t}\n\t\t\t// Let parent handle escape for autocomplete cancellation\n\t\t\tsuper.handleInput(data);\n\t\t\treturn;\n\t\t}\n\n\t\t// Exit (Ctrl+D) - only when editor is empty\n\t\tif (this.keybindings.matches(data, \"app.exit\")) {\n\t\t\tif (this.getText().length === 0) {\n\t\t\t\tconst handler = this.onCtrlD ?? this.actionHandlers.get(\"app.exit\");\n\t\t\t\tif (handler) handler();\n\t\t\t\treturn;\n\t\t\t}\n\t\t\t// Fall through to editor handling for delete-char-forward when not empty\n\t\t}\n\n\t\t// Explicit history bindings take precedence over app actions while the editor is focused.\n\t\t// This lets users bind Ctrl+P even though it cycles models by default.\n\t\tif (\n\t\t\tthis.keybindings.matches(data, \"tui.editor.historyPrevious\") ||\n\t\t\tthis.keybindings.matches(data, \"tui.editor.historyNext\")\n\t\t) {\n\t\t\tsuper.handleInput(data);\n\t\t\treturn;\n\t\t}\n\n\t\t// Check all other app actions\n\t\tfor (const [action, handler] of this.actionHandlers) {\n\t\t\tif (action !== \"app.interrupt\" && action !== \"app.exit\" && this.keybindings.matches(data, action)) {\n\t\t\t\thandler();\n\t\t\t\treturn;\n\t\t\t}\n\t\t}\n\n\t\t// Pass to parent for editor handling\n\t\tsuper.handleInput(data);\n\t}\n}\n"]}

package/dist/modes/interactive/components/dynamic-border.d.ts

@@ -2,13 +2,19 @@ import type { Component } from "@earendil-works/pi-tui";
 /**
  * Dynamic border component that adjusts to viewport width.
  *
+ * It is the boundary every overlay draws, so it is deliberately quiet: a dotted
+ * rule in `borderMuted` rather than a solid one in the brand accent. A
+ * full-width accent rule above and below every selector made the accent the
+ * loudest thing on screen in exactly the moment the user is reading a list.
+ *
  * Note: When used from extensions loaded via jiti, the global `theme` may be undefined
  * because jiti creates a separate module cache. Always pass an explicit color
  * function when using DynamicBorder in components exported for extension use.
  */
 export declare class DynamicBorder implements Component {
     private color;
-    constructor(color?: (str: string) => string);
+    private glyph;
+    constructor(color?: (str: string) => string, glyph?: string);
     invalidate(): void;
     render(width: number): string[];
 }

package/dist/modes/interactive/components/dynamic-border.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dynamic-border.d.ts","sourceRoot":"","sources":["../../../../src/modes/interactive/components/dynamic-border.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAGxD;;;;;;GAMG;AACH,qBAAa,aAAc,YAAW,SAAS;IAC9C,OAAO,CAAC,KAAK,CAA0B;IAEvC,YAAY,KAAK,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAyC,EAE5E;IAED,UAAU,IAAI,IAAI,CAEjB;IAED,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAE9B;CACD","sourcesContent":["import type { Component } from \"@earendil-works/pi-tui\";\nimport { theme } from \"../theme/theme.ts\";\n\n/**\n * Dynamic border component that adjusts to viewport width.\n *\n * Note: When used from extensions loaded via jiti, the global `theme` may be undefined\n * because jiti creates a separate module cache. Always pass an explicit color\n * function when using DynamicBorder in components exported for extension use.\n */\nexport class DynamicBorder implements Component {\n\tprivate color: (str: string) => string;\n\n\tconstructor(color: (str: string) => string = (str) => theme.fg(\"border\", str)) {\n\t\tthis.color = color;\n\t}\n\n\tinvalidate(): void {\n\t\t// No cached state to invalidate currently\n\t}\n\n\trender(width: number): string[] {\n\t\treturn [this.color(\"─\".repeat(Math.max(1, width)))];\n\t}\n}\n"]}
+{"version":3,"file":"dynamic-border.d.ts","sourceRoot":"","sources":["../../../../src/modes/interactive/components/dynamic-border.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAMxD;;;;;;;;;;;GAWG;AACH,qBAAa,aAAc,YAAW,SAAS;IAC9C,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,KAAK,CAAS;IAEtB,YAAY,KAAK,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAA8C,EAAE,KAAK,SAAe,EAGvG;IAED,UAAU,IAAI,IAAI,CAEjB;IAED,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAE9B;CACD","sourcesContent":["import type { Component } from \"@earendil-works/pi-tui\";\nimport { theme } from \"../theme/theme.ts\";\n\n/** Dotted, so an overlay boundary never reads as the solid structural rule. */\nconst OVERLAY_RULE = \"┄\";\n\n/**\n * Dynamic border component that adjusts to viewport width.\n *\n * It is the boundary every overlay draws, so it is deliberately quiet: a dotted\n * rule in `borderMuted` rather than a solid one in the brand accent. A\n * full-width accent rule above and below every selector made the accent the\n * loudest thing on screen in exactly the moment the user is reading a list.\n *\n * Note: When used from extensions loaded via jiti, the global `theme` may be undefined\n * because jiti creates a separate module cache. Always pass an explicit color\n * function when using DynamicBorder in components exported for extension use.\n */\nexport class DynamicBorder implements Component {\n\tprivate color: (str: string) => string;\n\tprivate glyph: string;\n\n\tconstructor(color: (str: string) => string = (str) => theme.fg(\"borderMuted\", str), glyph = OVERLAY_RULE) {\n\t\tthis.color = color;\n\t\tthis.glyph = glyph;\n\t}\n\n\tinvalidate(): void {\n\t\t// No cached state to invalidate currently\n\t}\n\n\trender(width: number): string[] {\n\t\treturn [this.color(this.glyph.repeat(Math.max(1, width)))];\n\t}\n}\n"]}