@timurproko/a1 0.2.7-dev.810 → 0.2.7-dev.828

package/dist/native/linux-x64/manifest.json

@@ -7,7 +7,7 @@
   "platform": "linux",
   "architecture": "x64",
   "capability": "supported",
-  "builtAt": "2026-10-23T09:16:44.112Z",
+  "builtAt": "2026-10-27T13:50:03.363Z",
   "artifact": {
     "filename": "process-guardian.node",
     "sha256": "118e5954e3864672bd8482ab7edf419cb27dcdf2533720316979b7f5cc5a53a5",

package/dist/native/linux-x64/terminal-host.manifest.json

@@ -9,11 +9,11 @@
   "architecture": "x64",
   "target": "x86_64-unknown-linux-gnu",
   "capability": "supported",
-  "builtAt": "2026-10-23T09:18:34.630Z",
+  "builtAt": "2026-10-27T13:53:30.629Z",
   "artifact": {
     "filename": "terminal-host.node",
-    "sha256": "707e4140e1c1b4b2c78c45373d8471bbbcc6232e7ad5d14ad8f5a76a90b6265b",
-    "size": 6997376
+    "sha256": "e0b59bb80d065f8c345ec0371bf90c8da2364f42082857d604491f83811574e6",
+    "size": 7292480
   },
   "entry": {
     "filename": "dist/foundation/resident-tabs/host-entry.js",

package/dist/native/win32-x64/manifest.json

@@ -7,10 +7,10 @@
   "platform": "win32",
   "architecture": "x64",
   "capability": "supported",
-  "builtAt": "2026-10-23T09:17:41.474Z",
+  "builtAt": "2026-10-27T13:50:41.076Z",
   "artifact": {
     "filename": "process-guardian.node",
-    "sha256": "f0fb48d96ea06a21d77a4df332ec863d3830caf8ce6adfebcb2a4bb4d86fabdf",
+    "sha256": "f6400de0c563ee49f8e7ad05d91f6ad3d016434e75963e1c427ff4e15cb2bffe",
     "size": 402432
   },
   "provenance": {

package/dist/native/win32-x64/terminal-host.manifest.json

@@ -9,11 +9,11 @@
   "architecture": "x64",
   "target": "x86_64-pc-windows-msvc",
   "capability": "supported",
-  "builtAt": "2026-10-23T09:20:49.040Z",
+  "builtAt": "2026-10-27T13:54:43.955Z",
   "artifact": {
     "filename": "terminal-host.node",
-    "sha256": "f511333451655f6fdef1da7710c54c9e65058e367f6e8be3b8ac0420fcc70fa1",
-    "size": 6078464
+    "sha256": "d9aacaeaebb031a6647e07f9c99dcd414c95aa1aa8d50d10cc3541ad12a2e5a6",
+    "size": 6375936
   },
   "entry": {
     "filename": "dist/foundation/resident-tabs/host-entry.js",

package/dist/product-identity.d.ts

@@ -1,4 +1,4 @@
-declare const ENVIRONMENT_KEYS: readonly ["clipboardDiagnostics", "configDir", "dataDir", "databasePath", "developmentInstanceId", "developmentRoot", "endpoint", "exitNoticePath", "paneId", "probeTrace", "processGuardianPath", "prFooterPreview", "profileHome", "residentFixtureControlDir", "residentProgressObservationDir", "residentProgressRunId", "residentProgressTabId", "residentProgressTabIncarnation", "runtimeDir", "sessionRuntimeId", "skipVersionCheck", "startupTrace", "suggestionDiagnostics", "tabEndpoint", "tabId", "tabToken", "tabsEndpoint", "terminalHostPath", "terminalSessionId"];
+declare const ENVIRONMENT_KEYS: readonly ["clipboardDiagnostics", "configDir", "dataDir", "databasePath", "developmentHistoryDataDir", "developmentInstanceId", "developmentRoot", "endpoint", "exitNoticePath", "paneId", "probeTrace", "processGuardianPath", "prFooterPreview", "profileHome", "residentFixtureControlDir", "residentProgressObservationDir", "residentProgressRunId", "residentProgressTabId", "residentProgressTabIncarnation", "runtimeDir", "sessionRuntimeId", "skipVersionCheck", "startupTrace", "suggestionDiagnostics", "tabEndpoint", "tabId", "tabReleaseId", "tabToken", "tabsEndpoint", "terminalHostPath", "terminalSessionId"];
 declare const FILESYSTEM_KEYS: readonly ["slug", "windowsDirectory", "unixDirectory", "temporaryPrefix"];
 declare const STATE_KEYS: readonly ["windowsControlDirectory", "unixControlDirectory", "developmentDirectory", "piAgentProfile", "piVanillaProfile", "sessionRepositoryDirectory", "sessionWorktreeClaimDirectory"];
 declare const ENDPOINT_KEYS: readonly ["windowsPipeStem", "unixSocketFilename", "metadataFilename", "supervisorLogFilename", "databaseFilename"];

package/dist/product-identity.js

@@ -1,7 +1,7 @@
 import rawIdentity from "./product-identity.json" with { type: "json" };
 const ENVIRONMENT_KEYS = [
-    "clipboardDiagnostics", "configDir", "dataDir", "databasePath", "developmentInstanceId", "developmentRoot", "endpoint", "exitNoticePath",
-    "paneId", "probeTrace", "processGuardianPath", "prFooterPreview", "profileHome", "residentFixtureControlDir", "residentProgressObservationDir", "residentProgressRunId", "residentProgressTabId", "residentProgressTabIncarnation", "runtimeDir", "sessionRuntimeId", "skipVersionCheck", "startupTrace", "suggestionDiagnostics", "tabEndpoint", "tabId", "tabToken", "tabsEndpoint", "terminalHostPath", "terminalSessionId",
+    "clipboardDiagnostics", "configDir", "dataDir", "databasePath", "developmentHistoryDataDir", "developmentInstanceId", "developmentRoot", "endpoint", "exitNoticePath",
+    "paneId", "probeTrace", "processGuardianPath", "prFooterPreview", "profileHome", "residentFixtureControlDir", "residentProgressObservationDir", "residentProgressRunId", "residentProgressTabId", "residentProgressTabIncarnation", "runtimeDir", "sessionRuntimeId", "skipVersionCheck", "startupTrace", "suggestionDiagnostics", "tabEndpoint", "tabId", "tabReleaseId", "tabToken", "tabsEndpoint", "terminalHostPath", "terminalSessionId",
 ];
 const FILESYSTEM_KEYS = ["slug", "windowsDirectory", "unixDirectory", "temporaryPrefix"];
 const STATE_KEYS = ["windowsControlDirectory", "unixControlDirectory", "developmentDirectory", "piAgentProfile", "piVanillaProfile", "sessionRepositoryDirectory", "sessionWorktreeClaimDirectory"];

package/dist/product-identity.json

@@ -14,6 +14,7 @@
         "configDir": "A1_CONFIG_DIR",
         "dataDir": "A1_DATA_DIR",
         "databasePath": "A1_DATABASE_PATH",
+        "developmentHistoryDataDir": "A1_DEV_HISTORY_DATA_DIR",
         "developmentInstanceId": "A1_DEV_INSTANCE_ID",
         "developmentRoot": "A1_DEV_ROOT",
         "endpoint": "A1_ENDPOINT",
@@ -35,6 +36,7 @@
         "suggestionDiagnostics": "A1_SUGGESTION_DIAGNOSTICS",
         "tabEndpoint": "A1_TAB_ENDPOINT",
         "tabId": "A1_TAB_ID",
+        "tabReleaseId": "A1_TAB_RELEASE_ID",
         "tabToken": "A1_TAB_TOKEN",
         "tabsEndpoint": "A1_TABS_ENDPOINT",
         "terminalHostPath": "A1_TERMINAL_HOST_PATH",

package/dist/ui/apps/host.d.ts

@@ -20,6 +20,8 @@ export interface AppHostOptions {
     readonly closeOnInterrupt: boolean;
     /** Colours handed to every presented app. Absent renders plain text. */
     readonly theme?: UiTheme;
+    /** Lets a focused app claim the first interrupt for an editor selection before host close/exit policy. */
+    readonly appInputBeforeInterrupt?: boolean;
 }
 /**
  * Presents at most one app. An opted-in interrupt closes at the host boundary;

package/dist/ui/apps/host.js

@@ -15,6 +15,7 @@ export class UiAppHost {
     #surface;
     #closeOnInterrupt;
     #theme;
+    #appInputBeforeInterrupt;
     // Invariant: the first interrupt timestamp is null whenever the chord is disarmed.
     #interruptArmedAt = null;
     #renderedInterruptArmed;
@@ -25,6 +26,7 @@ export class UiAppHost {
         this.#surface = options.surface;
         this.#closeOnInterrupt = options.closeOnInterrupt;
         this.#theme = options.theme;
+        this.#appInputBeforeInterrupt = options.appInputBeforeInterrupt === true;
     }
     get presented() {
         return this.#app;
@@ -71,7 +73,7 @@ export class UiAppHost {
         const app = this.#app;
         if (app === null)
             return { consumed: false };
-        if (data === INTERRUPT && this.#closeOnInterrupt) {
+        if (data === INTERRUPT && this.#closeOnInterrupt && !this.#appInputBeforeInterrupt) {
             this.close();
             return { consumed: true, render: true };
         }
@@ -83,6 +85,10 @@ export class UiAppHost {
                 this.render();
             return result;
         }
+        if (data === INTERRUPT && this.#closeOnInterrupt) {
+            this.close();
+            return { consumed: true, render: true };
+        }
         if (data === INTERRUPT)
             return this.#interrupt();
         return { consumed: false };

package/dist/ui/components/dialog-panel.js

@@ -1,8 +1,18 @@
+import { dialogFrameGeometry, insetDialogContent } from "../../contracts/presentation/index.js";
 import { LineInput, renderInputRow } from "./line-input.js";
-import { renderShortcutHints, renderShortcutHintsWithClose, shortcutHintsText } from "./shortcut-hints.js";
+import { renderShortcutHintsWithClose } from "./shortcut-hints.js";
 import { displayWidth, truncateToWidth } from "./text.js";
 const LABEL_COLUMN_CAP = 30;
 const STEPPED_LABEL_COLUMN_CAP = 46;
+/** One frame path for every semantic row, regardless of which dialog supplies the content. */
+function dialogPanelLayout(width, theme) {
+    const geometry = dialogFrameGeometry(width);
+    return {
+        rule: theme.fg("border", "─".repeat(geometry.frameWidth)),
+        contentWidth: geometry.contentWidth,
+        contentRow: (painted, raw = painted) => insetDialogContent(pad(truncateToWidth(painted, geometry.contentWidth), geometry.contentWidth, raw), geometry),
+    };
+}
 /** The column values start at: past the widest label, capped so one long name cannot push them off. */
 export function dialogValueColumn(rows) {
     const widest = Math.min(LABEL_COLUMN_CAP, Math.max(0, ...rows.map(row => displayWidth(row.label))));
@@ -14,11 +24,7 @@ export function dialogValueColumn(rows) {
  */
 export function renderDialogPanel(state, width, theme) {
     const labelColumn = Math.min(LABEL_COLUMN_CAP, Math.max(0, ...state.rows.map(row => displayWidth(row.label))));
-    const rule = theme.fg("border", "─".repeat(Math.max(0, width)));
-    const contentPadding = Math.min(1, Math.max(0, width));
-    const contentWidth = Math.max(0, width - contentPadding);
-    const inset = " ".repeat(contentPadding);
-    const contentRow = (painted, raw) => `${inset}${pad(truncateToWidth(painted, contentWidth), contentWidth, raw)}`;
+    const layout = dialogPanelLayout(width, theme);
     const rows = state.rows.map((row, index) => {
         const selected = index === state.index;
         const padded = `${row.label}${" ".repeat(Math.max(0, labelColumn - displayWidth(row.label)))}`;
@@ -28,31 +34,27 @@ export function renderDialogPanel(state, width, theme) {
             ? `${theme.fg("accent", cursor)}${theme.fg("text", padded)}  ${theme.fg("muted", row.value)}`
             : `${cursor}${padded}  ${theme.fg("muted", row.value)}`;
         const painted = selected ? theme.highlight(content) : content;
-        return contentRow(painted, raw);
+        return layout.contentRow(painted, raw);
     });
     const description = state.rows[state.index]?.description ?? "";
     const hint = typeof state.hint === "string"
         ? theme.fg("dim", state.hint)
-        : renderShortcutHintsWithClose(state.hint, theme, contentWidth, 0);
+        : renderShortcutHintsWithClose(state.hint, theme, layout.contentWidth, 0);
     const plainHint = typeof state.hint === "string" ? state.hint : " ".repeat(displayWidth(hint));
     return [
-        rule,
-        contentRow(theme.bold(theme.fg("accent", state.title)), state.title),
-        contentRow(theme.fg("dim", description), description),
+        layout.rule,
+        layout.contentRow(theme.bold(theme.fg("accent", state.title)), state.title),
+        layout.contentRow(theme.fg("dim", description), description),
         "",
         ...rows,
         "",
-        contentRow(hint, plainHint),
-        rule,
+        layout.contentRow(hint, plainHint),
+        layout.rule,
     ];
 }
 /** Owned stepped-selector composition for structured settings with nested choices. */
 export function renderSteppedDialogPanel(state, width, theme) {
-    const rule = theme.fg("border", "─".repeat(Math.max(0, width)));
-    const contentPadding = Math.min(1, Math.max(0, width));
-    const contentWidth = Math.max(0, width - contentPadding);
-    const inset = " ".repeat(contentPadding);
-    const contentRow = (painted, raw) => `${inset}${pad(truncateToWidth(painted, contentWidth), contentWidth, raw)}`;
+    const layout = dialogPanelLayout(width, theme);
     const labelColumn = Math.min(STEPPED_LABEL_COLUMN_CAP, Math.max(0, ...state.rows.map(row => displayWidth(`${row.label}${row.labelSuffix ?? ""}`))));
     const rows = state.rows.map((row, index) => {
         const selected = index === state.index;
@@ -65,31 +67,34 @@ export function renderSteppedDialogPanel(state, width, theme) {
         const content = selected
             ? `${theme.fg("accent", cursor)}${label}${theme.fg("muted", suffix)}`
             : `${cursor}${label}${theme.fg("muted", suffix)}`;
-        return contentRow(selected ? theme.highlight(content) : content, raw);
+        return layout.contentRow(selected ? theme.highlight(content) : content, raw);
     });
     const input = state.input === undefined
         ? []
-        : [...renderInputRow(state.input, width, { ruled: false, promptGlyph: "> ", theme }).lines, ""];
+        : [
+            ...renderInputRow(state.input, layout.contentWidth, {
+                ruled: false,
+                promptGlyph: "> ",
+                promptRole: "accent",
+                theme,
+            }).lines.map(row => layout.contentRow(row)),
+            "",
+        ];
     const step = `(step ${state.step}/${state.steps})`;
     const title = `${state.title} ${step}`;
     const paintedTitle = `${theme.bold(theme.fg("accent", state.title))} ${theme.fg("dim", step)}`;
     return [
-        rule,
-        contentRow(paintedTitle, title),
-        contentRow(theme.fg("dim", state.description), state.description),
+        layout.rule,
+        layout.contentRow(paintedTitle, title),
+        layout.contentRow(theme.fg("dim", state.description), state.description),
         "",
         ...input,
         ...rows,
         "",
-        renderSteppedHint(state.hint, width, theme),
-        rule,
+        layout.contentRow(renderShortcutHintsWithClose(state.hint, theme, layout.contentWidth)),
+        layout.rule,
     ];
 }
-function renderSteppedHint(entries, width, theme) {
-    const raw = shortcutHintsText(entries, 1, " · ");
-    const painted = renderShortcutHints(entries, theme, 1, theme.fg("dim", " · "));
-    return `${truncateToWidth(painted, width)}${" ".repeat(Math.max(0, width - displayWidth(raw)))}`;
-}
 /** The row a pointer report lands on, or null when it is not on one. */
 export function dialogRowAt(frame, row, column, valueWidth) {
     const at = row - frame.firstRow;

package/dist/ui/components/line-input.d.ts

@@ -1,3 +1,4 @@
+import { type PromptMarkerRole } from "./prompt-input.js";
 import type { UiTheme } from "./theme.js";
 export type LineInputOutcome = {
     readonly kind: "editing";
@@ -60,6 +61,8 @@ export interface InputRowOptions {
     readonly ruled?: boolean;
     /** Prompt marker including any following spacing. Defaults to the shared prompt glyph. */
     readonly promptGlyph?: string;
+    /** Semantic foreground for a configured prompt marker. */
+    readonly promptRole?: PromptMarkerRole;
     readonly theme?: Pick<UiTheme, "fg">;
 }
 export interface InputRow {

package/dist/ui/components/line-input.js

@@ -220,5 +220,7 @@ export function renderInputRow(input, width, options = {}) {
     const body = empty
         ? `${caretCell(placeholder.slice(0, 1))}${faint(placeholder.slice(1))}`
         : `${before}${caretCell(under)}${after}`;
-    return { lines: presentation.render(width, () => ({ rows: [body] }), options.ruled, 0, options.promptGlyph) };
+    return {
+        lines: presentation.render(width, () => ({ rows: [body] }), options.ruled, 0, options.promptGlyph, options.promptRole),
+    };
 }

package/dist/ui/components/prompt-input.d.ts

@@ -1,10 +1,11 @@
 import { type UiTheme } from "./theme.js";
-export declare const PROMPT_GLYPH = "\u276F ";
-export declare const PROMPT_PREFIX_WIDTH = 2;
+export declare const PROMPT_GLYPH = "";
+export declare const PROMPT_PREFIX_WIDTH = 0;
 type RuleTheme = Pick<UiTheme, "fg">;
 export declare function promptRuleText(text: string, theme: RuleTheme): string;
 export declare function promptRule(width: number, theme: RuleTheme): string;
-export declare function promptArrow(text: string, theme: RuleTheme): string;
+export type PromptMarkerRole = "muted" | "accent";
+export declare function promptArrow(text: string, theme: RuleTheme, role?: PromptMarkerRole): string;
 export interface PromptInputBody {
     readonly rows: readonly string[];
     /** Semantic border fragments retain editor history and scroll annotations. */
@@ -31,6 +32,6 @@ export declare class PromptInput {
         contentWidth: number;
         layoutWidth: number;
     };
-    render(width: number, renderBody: (innerWidth: number) => PromptInputBody, ruled?: boolean, padding?: number, promptGlyph?: string): string[];
+    render(width: number, renderBody: (innerWidth: number) => PromptInputBody, ruled?: boolean, padding?: number, promptGlyph?: string, promptRole?: PromptMarkerRole): string[];
 }
 export {};

package/dist/ui/components/prompt-input.js

@@ -1,15 +1,17 @@
 import { displayWidth, truncateToWidth } from "./text.js";
 import { PLAIN_THEME } from "./theme.js";
-export const PROMPT_GLYPH = "❯ ";
-export const PROMPT_PREFIX_WIDTH = 2;
+export const PROMPT_GLYPH = "";
+export const PROMPT_PREFIX_WIDTH = 0;
 export function promptRuleText(text, theme) {
     return theme.fg("border", text);
 }
 export function promptRule(width, theme) {
     return promptRuleText("─".repeat(Math.max(0, width)), theme);
 }
-export function promptArrow(text, theme) {
-    return theme.fg("muted", text);
+export function promptArrow(text, theme, role = "muted") {
+    if (role === "accent" && text.startsWith(">"))
+        return `${theme.fg(role, ">")}${text.slice(1)}`;
+    return theme.fg(role, text);
 }
 /** Composes shared input chrome around controller-owned body rows without owning editing state. */
 export class PromptInput {
@@ -26,7 +28,7 @@ export class PromptInput {
         const contentWidth = Math.max(1, innerWidth - paddingX * 2);
         return { prefixWidth, innerWidth, paddingX, contentWidth, layoutWidth: Math.max(1, contentWidth - (paddingX ? 0 : 1)) };
     }
-    render(width, renderBody, ruled = true, padding = 0, promptGlyph = PROMPT_GLYPH) {
+    render(width, renderBody, ruled = true, padding = 0, promptGlyph = PROMPT_GLYPH, promptRole = "muted") {
         if (width <= 0)
             return [];
         const { prefixWidth, innerWidth } = this.geometry(width, padding, promptGlyph);
@@ -40,7 +42,7 @@ export class PromptInput {
             return clipped + " ".repeat(Math.max(0, width - this.metrics.measure(clipped)));
         };
         const rows = body.rows.map((row, index) => fit(`${index === 0
-            ? promptArrow(promptGlyph, this.theme)
+            ? promptArrow(promptGlyph, this.theme, promptRole)
             : " ".repeat(prefixWidth)}${row}`));
         const rule = (fragment) => fragment === undefined
             ? promptRule(width, this.theme)

package/dist/ui/components/spans.js

@@ -1,4 +1,4 @@
-import { displayWidth } from "./text.js";
+import { displayWidth, graphemeWidth } from "./text.js";
 /**
  * Ported from the A1 UI reference implementation (`core/presentation/spans.ts`).
  * Writing over part of a rendered row is not string slicing: the row carries
@@ -53,7 +53,7 @@ export function overlaySpan(line, from, to, span, options = {}) {
             continue;
         }
         for (const { segment } of GRAPHEMES.segment(token)) {
-            const width = displayWidth(segment);
+            const width = graphemeWidth(segment);
             if (column + width <= from)
                 head += segment;
             else if (column >= to)

package/dist/ui/components/submitted-prompt.d.ts

@@ -1,8 +1,8 @@
 export type UiTimeFormat = "20:00" | "8:00 PM";
 /** Deterministic local hour/minute presentation shared by A1-owned time labels. */
 export declare function formatLocalTime(source: Date | number, format?: UiTimeFormat): string | null;
-/** Visible width of the submitted-prompt prefix (`❯ `). */
-export declare const SUBMITTED_PROMPT_PREFIX_WIDTH = 2;
+/** Visible width of the submitted-prompt prefix (` ❯ `). */
+export declare const SUBMITTED_PROMPT_PREFIX_WIDTH = 3;
 export interface SubmittedPromptStyle {
     readonly prefix?: (text: string) => string;
     readonly timestamp?: (text: string) => string;

package/dist/ui/components/submitted-prompt.js

@@ -10,8 +10,8 @@ export function formatLocalTime(source, format = "8:00 PM") {
         return `${String(hour).padStart(2, "0")}:${minute}`;
     return `${hour % 12 || 12}:${minute} ${hour < 12 ? "AM" : "PM"}`;
 }
-/** Visible width of the submitted-prompt prefix (`❯ `). */
-export const SUBMITTED_PROMPT_PREFIX_WIDTH = 2;
+/** Visible width of the submitted-prompt prefix (` ❯ `). */
+export const SUBMITTED_PROMPT_PREFIX_WIDTH = 3;
 const TIMESTAMP_MARGIN = 3;
 const MIN_USEFUL_CONTENT_WIDTH = 8;
 /** Formats transcript metadata, never render time, in the active A1 time format. */
@@ -42,7 +42,7 @@ export function composeSubmittedPromptRows(contentRows, width, source, style = {
     if (width <= 0)
         return [];
     const layout = submittedPromptLayout(width, source, format);
-    const prefix = (style.prefix ?? identity)("❯ ");
+    const prefix = (style.prefix ?? identity)(" ❯ ");
     const rows = (contentRows.length === 0 ? [""] : contentRows).map((row, index) => {
         const content = truncateToWidth(row, layout.contentWidth);
         return `${index === 0 ? prefix : " ".repeat(SUBMITTED_PROMPT_PREFIX_WIDTH)}${content}`;

package/dist/ui/components/surface.js

@@ -29,10 +29,12 @@ export function withScrollbarRail(lines, geometry, contentWidth, theme, options
  */
 export function renderEmptyState(message, mark, height, width, theme) {
     const middle = Math.floor(height / 2);
+    const messageRow = Math.min(Math.max(0, height - 1), middle + 1);
+    const markRow = messageRow - 1;
     return Array.from({ length: Math.max(0, height) }, (_line, index) => {
-        if (index === middle - 1)
+        if (index === markRow)
             return centre(theme.fg("muted", mark), mark, width);
-        return index === middle ? centre(theme.fg("muted", message), message, width) : "";
+        return index === messageRow ? centre(theme.fg("muted", message), message, width) : "";
     });
 }
 function centre(painted, raw, width) {

package/dist/ui/components/text.d.ts

@@ -1,11 +1,8 @@
-/**
- * Display-width text handling. Terminals lay out by column, not by code unit,
- * so measuring with `String.length` mis-sizes CJK, emoji, and combining marks,
- * and counting styling escapes as visible width breaks every layout that uses
- * colour.
- */
+/** Terminal-column geometry: preserve graphemes, Unicode cell widths and ANSI styling. */
 /** Removes styling sequences so only visible characters remain. */
 export declare function stripAnsi(text: string): string;
+/** Width of one grapheme cluster: two for emoji, else the widest code point it contains. */
+export declare function graphemeWidth(grapheme: string): number;
 export interface DisplayColumnRange {
     readonly from: number;
     readonly to: number;

package/dist/ui/components/text.js

@@ -1,9 +1,4 @@
-/**
- * Display-width text handling. Terminals lay out by column, not by code unit,
- * so measuring with `String.length` mis-sizes CJK, emoji, and combining marks,
- * and counting styling escapes as visible width breaks every layout that uses
- * colour.
- */
+/** Terminal-column geometry: preserve graphemes, Unicode cell widths and ANSI styling. */
 const ANSI_PATTERN = /\[[0-9;:?]*[ -/]*[@-~]|[\]_][^]*(?:|\\)|[@-Z\\-_]/g;
 const SEGMENTER = new Intl.Segmenter(undefined, { granularity: "grapheme" });
 const WORD_SEGMENTER = new Intl.Segmenter(undefined, { granularity: "word" });
@@ -76,7 +71,7 @@ function couldBeEmoji(grapheme) {
         grapheme.length > 1);
 }
 /** Width of one grapheme cluster: two for emoji, else the widest code point it contains. */
-function graphemeWidth(grapheme) {
+export function graphemeWidth(grapheme) {
     if (couldBeEmoji(grapheme) && RGI_EMOJI_PATTERN.test(grapheme))
         return 2;
     let width = 0;
@@ -126,8 +121,11 @@ export function displayColumnSlice(text, requestedFrom, requestedTo) {
 }
 /** Columns this text occupies once styling is removed. */
 export function displayWidth(text) {
+    const plain = stripAnsi(text);
+    if (!/[^\x20-\x7e]/u.test(plain))
+        return plain.length;
     let width = 0;
-    for (const { segment } of SEGMENTER.segment(stripAnsi(text)))
+    for (const { segment } of SEGMENTER.segment(plain))
         width += graphemeWidth(segment);
     return width;
 }

package/dist/ui/components/transcript-viewport.d.ts

@@ -178,7 +178,7 @@ export declare class TranscriptViewport {
     releaseSelection(): boolean;
     clearSelection(): boolean;
     selectedText(): string | null;
-    /** Captures visible selected text, not off-screen history. */
+    /** Captures selected text, including document rows of a visible selection scrolled off-screen. */
     captureSelectedText(): SelectionCopySnapshot | null;
     scrollBy(lines: number, now?: number): boolean;
     scrollTo(position: number, now?: number): boolean;