@timurproko/a1 0.2.6 → 0.2.7-dev.1222

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.d.ts

@@ -1,10 +1,10 @@
+import type { PaneRect } from "./frame.js";
 import { LineInput } from "./line-input.js";
 import { type ShortcutHintEntry } from "./shortcut-hints.js";
 import type { UiTheme } from "./theme.js";
 /**
- * The panel a value with parts is edited in: at the foot of the screen, over the
- * surface it was opened from, ruled off above and below. It shows every part,
- * marks the one in hand, says what that part does, and says how to change it.
+ * Semantic content and overlay composition for Settings configure dialogs. The setting supplies
+ * rows and behavior; this component owns compact geometry, backdrop dimming, and panel placement.
  */
 export interface DialogRow {
     readonly label: string;
@@ -39,14 +39,23 @@ export interface SteppedDialogPanelState {
     readonly index: number;
     readonly hint: readonly ShortcutHintEntry[];
 }
+/** Canonical native-matching background for every owned floating dialog surface. */
+export declare function renderFloatingDialogSurface(text: string, mode: "truecolor" | "256color"): string;
+/** Existing raised-menu background, centralized beside the darker dialog surface. */
+export declare function renderFloatingMenuSurface(text: string, mode: "truecolor" | "256color"): string;
+/** The shared compact width used by Settings configure dialogs and native tab dialogs. */
+export declare function configureDialogWidth(width: number): number;
+/** Rows available to a selector after retaining its title, description, control, and guidance. */
+export declare function configureDialogChoiceCapacity(height: number, hasInput: boolean, descriptionRows?: number): number;
+/** Number of modal rows a plain description occupies at the shared content width. */
+export declare function configureDialogTextRows(text: string, width: number): number;
+/** Dims a completed screen and overlays one full-intensity panel without disturbing ANSI tails. */
+export declare function renderCenteredDialogOverlay(frame: readonly string[], dialogRows: readonly string[], rect: PaneRect, theme: UiTheme): readonly string[];
 /** The column values start at: past the widest label, capped so one long name cannot push them off. */
 export declare function dialogValueColumn(rows: readonly DialogRow[]): number;
-/**
- * The panel's lines. The first line is its rule, so the row at index N is drawn
- * one line below the panel's top.
- */
+/** The semantic rows for one generic configure modal. */
 export declare function renderDialogPanel(state: DialogPanelState, width: number, theme: UiTheme): readonly string[];
-/** Owned stepped-selector composition for structured settings with nested choices. */
+/** Owned stepped-selector content for structured settings with nested choices. */
 export declare function renderSteppedDialogPanel(state: SteppedDialogPanelState, width: number, theme: UiTheme): readonly string[];
 /** The row a pointer report lands on, or null when it is not on one. */
 export declare function dialogRowAt(frame: DialogPanelFrame, row: number, column: number, valueWidth: number): number | null;

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

@@ -1,24 +1,77 @@
 import { LineInput, renderInputRow } from "./line-input.js";
-import { renderShortcutHints, renderShortcutHintsWithClose, shortcutHintsText } from "./shortcut-hints.js";
-import { displayWidth, truncateToWidth } from "./text.js";
+import { renderShortcutHintsWithClose } from "./shortcut-hints.js";
+import { overlaySpan } from "./spans.js";
+import { displayWidth, padToWidth, truncateToWidth } from "./text.js";
 const LABEL_COLUMN_CAP = 30;
 const STEPPED_LABEL_COLUMN_CAP = 46;
+const CONFIGURE_MODAL_MAX_WIDTH = 60;
+const CONFIGURE_MODAL_PADDING_X = 2;
+const SGR = /\u001b\[[0-9;]*m/gu;
+/** Canonical native-matching background for every owned floating dialog surface. */
+export function renderFloatingDialogSurface(text, mode) {
+    const background = mode === "truecolor" ? "\u001b[48;2;38;38;38m" : "\u001b[48;5;235m";
+    return `${background}${text}\u001b[49m`;
+}
+/** Existing raised-menu background, centralized beside the darker dialog surface. */
+export function renderFloatingMenuSurface(text, mode) {
+    const background = mode === "truecolor" ? "\u001b[48;2;55;55;55m" : "\u001b[48;5;237m";
+    return `${background}${text}\u001b[49m`;
+}
+/** The shared compact width used by Settings configure dialogs and native tab dialogs. */
+export function configureDialogWidth(width) {
+    return Math.min(CONFIGURE_MODAL_MAX_WIDTH, Math.max(0, width));
+}
+/** Rows available to a selector after retaining its title, description, control, and guidance. */
+export function configureDialogChoiceCapacity(height, hasInput, descriptionRows = 1) {
+    const wrappedDescriptionRows = Math.max(1, descriptionRows);
+    return Math.max(1, Math.max(0, height) - (hasInput ? 9 : 7) - (wrappedDescriptionRows - 1));
+}
+/** Number of modal rows a plain description occupies at the shared content width. */
+export function configureDialogTextRows(text, width) {
+    return wrapText(text, Math.max(0, configureDialogWidth(width) - CONFIGURE_MODAL_PADDING_X * 2)).length;
+}
+/** One frame path for every semantic row, regardless of which configure dialog supplies content. */
+function dialogPanelLayout(width, theme) {
+    const frameWidth = Math.max(0, width);
+    const left = Math.min(CONFIGURE_MODAL_PADDING_X, frameWidth);
+    const right = Math.min(CONFIGURE_MODAL_PADDING_X, frameWidth - left);
+    const contentWidth = Math.max(0, frameWidth - left - right);
+    return {
+        blank: " ".repeat(frameWidth),
+        contentWidth,
+        contentRow: (painted, raw = painted, selected = false) => {
+            const content = pad(truncateToWidth(painted, contentWidth), contentWidth, raw);
+            const rightPadding = " ".repeat(right);
+            return `${" ".repeat(left)}${selected ? theme.highlight(content) : content}${selected ? theme.panel(rightPadding) : rightPadding}`;
+        },
+    };
+}
+/** Dims a completed screen and overlays one full-intensity panel without disturbing ANSI tails. */
+export function renderCenteredDialogOverlay(frame, dialogRows, rect, theme) {
+    const width = Math.max(0, rect.width);
+    const height = Math.max(0, rect.height);
+    const panelWidth = configureDialogWidth(width);
+    const visibleDialog = dialogRows.slice(0, height);
+    const top = Math.max(0, Math.floor((height - visibleDialog.length) / 2));
+    const left = Math.max(0, Math.floor((width - panelWidth) / 2));
+    return Array.from({ length: height }, (_, row) => {
+        const backdrop = dimStyledLine(frame[row] ?? "", width);
+        const dialogRow = visibleDialog[row - top];
+        if (dialogRow === undefined || panelWidth === 0)
+            return backdrop;
+        const panel = `\u001b[22;39;49m${theme.panel(padToWidth(dialogRow, panelWidth))}`;
+        return overlaySpan(backdrop, left, left + panelWidth, panel);
+    });
+}
 /** 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))));
     return 2 + widest + 2;
 }
-/**
- * The panel's lines. The first line is its rule, so the row at index N is drawn
- * one line below the panel's top.
- */
+/** The semantic rows for one generic configure modal. */
 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)))}`;
@@ -27,32 +80,28 @@ export function renderDialogPanel(state, width, theme) {
         const content = selected
             ? `${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(content, raw, selected);
     });
     const description = state.rows[state.index]?.description ?? "";
+    const descriptionRows = wrapText(description, layout.contentWidth);
     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.blank,
+        layout.contentRow(theme.bold(theme.fg("accent", state.title)), state.title),
+        ...descriptionRows.map(line => layout.contentRow(theme.fg("dim", line), line)),
+        layout.blank,
         ...rows,
-        "",
-        contentRow(hint, plainHint),
-        rule,
+        layout.blank,
+        layout.contentRow(hint, plainHint),
+        layout.blank,
     ];
 }
-/** Owned stepped-selector composition for structured settings with nested choices. */
+/** Owned stepped-selector content 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 +114,35 @@ 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(content, raw, selected);
     });
     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)),
+            layout.blank,
+        ];
+    const descriptionRows = wrapText(state.description, layout.contentWidth);
     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.blank,
+        layout.contentRow(paintedTitle, title),
+        ...descriptionRows.map(line => layout.contentRow(theme.fg("dim", line), line)),
+        layout.blank,
         ...input,
         ...rows,
-        "",
-        renderSteppedHint(state.hint, width, theme),
-        rule,
+        layout.blank,
+        layout.contentRow(renderShortcutHintsWithClose(state.hint, theme, layout.contentWidth)),
+        layout.blank,
     ];
 }
-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;
@@ -102,3 +155,26 @@ function pad(line, width, raw) {
     const visible = displayWidth(raw);
     return visible >= width ? line : line + " ".repeat(width - visible);
 }
+function dimStyledLine(line, width) {
+    const padded = padToWidth(line, width);
+    return `\u001b[2m${padded.replace(SGR, sequence => `${sequence}\u001b[2m`)}\u001b[22m`;
+}
+function wrapText(text, width) {
+    if (text.length === 0 || width <= 0)
+        return [""];
+    const lines = [];
+    let line = "";
+    for (const word of text.split(/\s+/u)) {
+        const candidate = `${line}${line.length === 0 ? "" : " "}${word}`;
+        if (line.length > 0 && displayWidth(candidate) > width) {
+            lines.push(line);
+            line = word;
+        }
+        else {
+            line = candidate;
+        }
+    }
+    if (line.length > 0)
+        lines.push(truncateToWidth(line, width));
+    return lines.length === 0 ? [""] : lines;
+}

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

@@ -1,4 +1,4 @@
-export { dialogRowAt, dialogValueColumn, renderDialogPanel, renderSteppedDialogPanel } from "./dialog-panel.js";
+export { configureDialogChoiceCapacity, configureDialogTextRows, configureDialogWidth, dialogRowAt, dialogValueColumn, renderCenteredDialogOverlay, renderDialogPanel, renderSteppedDialogPanel, } from "./dialog-panel.js";
 export type { DialogPanelFrame, DialogPanelState, DialogRow, SteppedDialogPanelState } from "./dialog-panel.js";
 export { FrameContractError, assertPaneRect, finalizeFrame, validateFrame } from "./frame.js";
 export type { PaneRect } from "./frame.js";
@@ -19,7 +19,7 @@ export { progressStatusFrame, progressStatusText } from "./progress-status.js";
 export type { ProgressStatusFrameStyles, ProgressStatusMarker } from "./progress-status.js";
 export { FrameCache, RENDER_REVISION_KINDS, RenderRevisionTracker, ZERO_REVISIONS, normalizeRevisions, revisionsEqual } from "./revision.js";
 export type { RenderCacheContract, RenderRevisionKind, RenderRevisions } from "./revision.js";
-export { MAX_COPY_ROWS, MAX_COPY_SOURCE_UNITS, selectionCopyLineContent, selectionCopyRowText } from "./selection-copy.js";
+export { COPY_ACKNOWLEDGEMENT_DURATION_MS, MAX_COPY_ROWS, MAX_COPY_SOURCE_UNITS, copyAcknowledgementText, selectionCopyLineContent, selectionCopyRowText } from "./selection-copy.js";
 export type { SelectionCopyPrompt, SelectionCopyRow, SelectionCopySnapshot } from "./selection-copy.js";
 export { ScrollbarRails, isThumbRow, scrollForThumbRow, scrollForTrackPage, scrollbarGeometry, scrollbarPresentation, scrollbarReservesSpace, scrollbarSelectionRows, scrollbarWheelRows, } from "./scrollbar.js";
 export type { RailPointer, RailPosition, ScrollbarAppearance, ScrollbarGeometry, ScrollbarInput, ScrollbarPresentation, ScrollbarPresentationInput, ScrollbarSpeed, ScrollbarStyle, } from "./scrollbar.js";
@@ -32,8 +32,8 @@ export { readVisibleHyperlinks } from "./visible-hyperlinks.js";
 export type { VisibleHyperlinkRange, VisibleHyperlinkRow } from "./visible-hyperlinks.js";
 export { renderStatusLine, statusText } from "./status-line.js";
 export type { StatusLineInput } from "./status-line.js";
-export { SUBMITTED_PROMPT_PREFIX_WIDTH, composeSubmittedPromptRows, formatSubmittedPromptTime, submittedPromptLayout } from "./submitted-prompt.js";
-export type { SubmittedPromptLayout, SubmittedPromptStyle } from "./submitted-prompt.js";
+export { SUBMITTED_PROMPT_PREFIX_WIDTH, composeSubmittedPromptRows, formatLocalTime, formatSubmittedPromptTime, submittedPromptLayout } from "./submitted-prompt.js";
+export type { SubmittedPromptLayout, SubmittedPromptStyle, UiTimeFormat } from "./submitted-prompt.js";
 export { numericValues, steppedValue, stepperEnds } from "./stepper.js";
 export type { NumericRange } from "./stepper.js";
 export { TranscriptViewport, assertTranscriptViewportFrameDescriptor } from "./transcript-viewport.js";
@@ -42,7 +42,7 @@ export { RAIL_COLUMNS, renderEmptyState, withScrollbarRail } from "./surface.js"
 export type { RailOptions } from "./surface.js";
 export { displayColumnSlice, displayWidth, displayWordColumnRange, faint, padToWidth, stripAnsi, truncateToWidth } from "./text.js";
 export type { DisplayColumnRange, DisplayColumnSlice } from "./text.js";
-export { TEXT_SELECTION_MULTI_CLICK_MS, extendTextSelection, orderedTextSelection, plainTextBetweenColumns, pressTextSelection, releaseTextSelection, textSelectionLineExtendColumn, textSelectionPointAt, textSelectionText, usefulTextLineContent, } from "./text-selection.js";
+export { TEXT_SELECTION_MULTI_CLICK_MS, extendTextSelection, orderedTextSelection, paintTextSelection, plainTextBetweenColumns, pressTextSelection, releaseTextSelection, textSelectionLineExtendColumn, textSelectionPointAt, textSelectionText, usefulTextLineContent, } from "./text-selection.js";
 export type { OrderedTextSelection, TextSelection, TextSelectionClick, TextSelectionLineContent, TextSelectionPoint, TextSelectionPressInput, } from "./text-selection.js";
 export { PLAIN_THEME } from "./theme.js";
 export type { UiTheme, UiThemeToken } from "./theme.js";

package/dist/ui/components/index.js

@@ -1,4 +1,4 @@
-export { dialogRowAt, dialogValueColumn, renderDialogPanel, renderSteppedDialogPanel } from "./dialog-panel.js";
+export { configureDialogChoiceCapacity, configureDialogTextRows, configureDialogWidth, dialogRowAt, dialogValueColumn, renderCenteredDialogOverlay, renderDialogPanel, renderSteppedDialogPanel, } from "./dialog-panel.js";
 export { FrameContractError, assertPaneRect, finalizeFrame, validateFrame } from "./frame.js";
 export { humanizeLabel, humanizeTitle } from "./label.js";
 export { LineInput, caretCell, handleLineInputKey, renderInputRow, wordLeft, wordRight } from "./line-input.js";
@@ -9,18 +9,18 @@ export { MOUSE_TRACKING_OFF, MOUSE_TRACKING_ON, parseMouseInput, routeMouseInput
 export { isInsidePane, toPaneLocalMouse } from "./pane.js";
 export { progressStatusFrame, progressStatusText } from "./progress-status.js";
 export { FrameCache, RENDER_REVISION_KINDS, RenderRevisionTracker, ZERO_REVISIONS, normalizeRevisions, revisionsEqual } from "./revision.js";
-export { MAX_COPY_ROWS, MAX_COPY_SOURCE_UNITS, selectionCopyLineContent, selectionCopyRowText } from "./selection-copy.js";
+export { COPY_ACKNOWLEDGEMENT_DURATION_MS, MAX_COPY_ROWS, MAX_COPY_SOURCE_UNITS, copyAcknowledgementText, selectionCopyLineContent, selectionCopyRowText } from "./selection-copy.js";
 export { ScrollbarRails, isThumbRow, scrollForThumbRow, scrollForTrackPage, scrollbarGeometry, scrollbarPresentation, scrollbarReservesSpace, scrollbarSelectionRows, scrollbarWheelRows, } from "./scrollbar.js";
 export { assertOwnedShortcutHintConventions, renderShortcutHints, renderShortcutHintsWithClose, shortcutHintsText } from "./shortcut-hints.js";
 export { GLOBAL_SCOPE, ShortcutRegistry, assembleShortcuts, assertNoShortcutConflicts } from "./shortcuts.js";
 export { backgroundSgrSpan, heldNativeHyperlinkStyle, hyperlinkSgrSpan, hyperlinkTargetAtColumn, nativeHyperlinkStyle, overlaySpan } from "./spans.js";
 export { readVisibleHyperlinks } from "./visible-hyperlinks.js";
 export { renderStatusLine, statusText } from "./status-line.js";
-export { SUBMITTED_PROMPT_PREFIX_WIDTH, composeSubmittedPromptRows, formatSubmittedPromptTime, submittedPromptLayout } from "./submitted-prompt.js";
+export { SUBMITTED_PROMPT_PREFIX_WIDTH, composeSubmittedPromptRows, formatLocalTime, formatSubmittedPromptTime, submittedPromptLayout } from "./submitted-prompt.js";
 export { numericValues, steppedValue, stepperEnds } from "./stepper.js";
 export { TranscriptViewport, assertTranscriptViewportFrameDescriptor } from "./transcript-viewport.js";
 export { RAIL_COLUMNS, renderEmptyState, withScrollbarRail } from "./surface.js";
 export { displayColumnSlice, displayWidth, displayWordColumnRange, faint, padToWidth, stripAnsi, truncateToWidth } from "./text.js";
-export { TEXT_SELECTION_MULTI_CLICK_MS, extendTextSelection, orderedTextSelection, plainTextBetweenColumns, pressTextSelection, releaseTextSelection, textSelectionLineExtendColumn, textSelectionPointAt, textSelectionText, usefulTextLineContent, } from "./text-selection.js";
+export { TEXT_SELECTION_MULTI_CLICK_MS, extendTextSelection, orderedTextSelection, paintTextSelection, plainTextBetweenColumns, pressTextSelection, releaseTextSelection, textSelectionLineExtendColumn, textSelectionPointAt, textSelectionText, usefulTextLineContent, } from "./text-selection.js";
 export { PLAIN_THEME } from "./theme.js";
 export { menuRowAt, renderValueMenu, valueMenuFrame } from "./value-menu.js";

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";
@@ -56,10 +57,12 @@ export declare function caretCell(text: string): string;
 export interface InputRowOptions {
     /** Shown quietly while nothing has been typed, with the caret on its first cell. */
     readonly placeholder?: string;
-    /** Rules above and below, in the prompt's own grey. Default true. */
+    /** Theme-border rules. */
     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,9 +1,11 @@
 import { type UiTheme } from "./theme.js";
-export declare const PROMPT_GLYPH = "\u276F ";
-export declare const PROMPT_PREFIX_WIDTH = 2;
-export declare function promptRuleText(text: string): string;
-export declare function promptRule(width: number): string;
-export declare function promptArrow(text: string, theme: Pick<UiTheme, "fg">): string;
+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 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. */
@@ -19,9 +21,9 @@ export interface PromptInputMetrics {
 }
 /** Composes shared input chrome around controller-owned body rows without owning editing state. */
 export declare class PromptInput {
-    readonly theme: Pick<UiTheme, "fg">;
+    readonly theme: RuleTheme;
     readonly metrics: PromptInputMetrics;
-    constructor(theme?: Pick<UiTheme, "fg">, metrics?: PromptInputMetrics);
+    constructor(theme?: RuleTheme, metrics?: PromptInputMetrics);
     styleRule(text: string): string;
     geometry(width: number, padding?: number, promptGlyph?: string): {
         prefixWidth: number;
@@ -30,5 +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,22 +1,24 @@
 import { displayWidth, truncateToWidth } from "./text.js";
 import { PLAIN_THEME } from "./theme.js";
-export const PROMPT_GLYPH = "❯ ";
-export const PROMPT_PREFIX_WIDTH = 2;
-export function promptRuleText(text) {
-    return `\u001b[38;2;154;160;166m${text}\u001b[39m`;
+export const PROMPT_GLYPH = "";
+export const PROMPT_PREFIX_WIDTH = 0;
+export function promptRuleText(text, theme) {
+    return theme.fg("border", text);
 }
-export function promptRule(width) {
-    return promptRuleText("─".repeat(Math.max(0, width)));
+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 {
     theme;
     metrics;
     constructor(theme = PLAIN_THEME, metrics = { measure: displayWidth, truncate: truncateToWidth }) { this.theme = theme; this.metrics = metrics; }
-    styleRule(text) { return promptRuleText(text); }
+    styleRule(text) { return promptRuleText(text, this.theme); }
     geometry(width, padding = 0, promptGlyph = PROMPT_GLYPH) {
         const prefixWidth = Math.min(this.metrics.measure(promptGlyph), Math.max(0, width));
         // Compatibility: editor wrapping needs room for a two-cell grapheme plus its cursor cell.
@@ -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,11 +42,11 @@ 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)
-            : fit(fragment + promptRule(Math.max(0, width - this.metrics.measure(fragment))));
+            ? promptRule(width, this.theme)
+            : fit(fragment + promptRule(Math.max(0, width - this.metrics.measure(fragment)), this.theme));
         return [
             ...(ruled ? [rule(body.topRule)] : []),
             ...rows,

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

@@ -6,7 +6,7 @@
 export interface ScrollbarGeometry {
     /** Rows in the track. */
     readonly trackHeight: number;
-    /** Thumb height in rows, at least one. */
+    /** Thumb height in rows, at least two when the track permits. */
     readonly thumbHeight: number;
     /** Zero-based row of the thumb's top within the track. */
     readonly thumbTop: number;

package/dist/ui/components/scrollbar.js

@@ -39,7 +39,7 @@ export function scrollbarGeometry(input) {
         return null;
     const maxScroll = contentLength - viewportHeight;
     const scroll = Math.min(Math.max(input.scroll, 0), maxScroll);
-    const thumbHeight = Math.max(1, Math.min(trackHeight, Math.round(trackHeight * viewportHeight / contentLength)));
+    const thumbHeight = Math.min(trackHeight, Math.max(2, Math.round(trackHeight * viewportHeight / contentLength)));
     const travel = trackHeight - thumbHeight;
     const thumbTop = maxScroll === 0 ? 0 : Math.min(travel, Math.round(travel * scroll / maxScroll));
     return { trackHeight, thumbHeight, thumbTop, maxScroll };

package/dist/ui/components/selection-copy.d.ts

@@ -2,23 +2,23 @@ import { type OrderedTextSelection, type TextSelectionLineContent } from "./text
 /** Bound selected-source retention independently of history length and encoded payload size. */
 export declare const MAX_COPY_SOURCE_UNITS: number;
 export declare const MAX_COPY_ROWS = 65536;
+export declare const COPY_ACKNOWLEDGEMENT_DURATION_MS = 1000;
+export declare function copyAcknowledgementText(characters: number): string;
 export type SelectionCopyPrompt = "first" | "continuation" | undefined;
 export interface SelectionCopyRow {
     readonly text: string;
     readonly prompt?: "first" | "continuation";
 }
-/** Immutable selected rows only; safe to transfer to an isolated text preparer. */
 export interface SelectionCopySnapshot {
     readonly selection: OrderedTextSelection;
     readonly revision: number;
-    /** Prompt copy/cut already supplies exact expanded text; do not apply transcript chrome stripping. */
     readonly literal?: boolean;
     readonly rows: readonly SelectionCopyRow[];
     readonly sourceUnits: number;
     readonly captureMs?: number;
     readonly rejected?: "size";
 }
-/** Shares the viewport's semantic chrome exclusions with isolated copy preparation. */
 export declare function selectionCopyLineContent(text: string, prompt: SelectionCopyPrompt): TextSelectionLineContent;
+export declare function literalSelectionCopySnapshot(text: string, revision?: number): SelectionCopySnapshot | null;
 /** Extracts one snapshot row with the existing grapheme/newline policy; run expensive rows off-thread. */
 export declare function selectionCopyRowText(snapshot: Pick<SelectionCopySnapshot, "selection" | "literal">, row: SelectionCopyRow, index: number): string;

package/dist/ui/components/selection-copy.js

@@ -3,7 +3,10 @@ import { stripAnsi } from "./text.js";
 /** Bound selected-source retention independently of history length and encoded payload size. */
 export const MAX_COPY_SOURCE_UNITS = 32 * 1024 * 1024;
 export const MAX_COPY_ROWS = 65_536;
-/** Shares the viewport's semantic chrome exclusions with isolated copy preparation. */
+export const COPY_ACKNOWLEDGEMENT_DURATION_MS = 1_000;
+export function copyAcknowledgementText(characters) {
+    return `copied ${characters} chars to clipboard`;
+}
 export function selectionCopyLineContent(text, prompt) {
     const plain = stripAnsi(text);
     if (prompt !== undefined) {
@@ -19,6 +22,18 @@ export function selectionCopyLineContent(text, prompt) {
         return { from, to: from + 1 };
     return usefulTextLineContent(plain, from);
 }
+export function literalSelectionCopySnapshot(text, revision = 0) {
+    if (text.trim().length === 0)
+        return null;
+    const selection = {
+        start: { line: 0, column: 0 },
+        end: { line: 0, column: Number.MAX_SAFE_INTEGER },
+    };
+    if (text.length > MAX_COPY_SOURCE_UNITS) {
+        return { literal: true, selection, revision, rows: [], sourceUnits: 0, rejected: "size" };
+    }
+    return { literal: true, selection, revision, rows: [{ text }], sourceUnits: text.length };
+}
 /** Extracts one snapshot row with the existing grapheme/newline policy; run expensive rows off-thread. */
 export function selectionCopyRowText(snapshot, row, index) {
     if (snapshot.literal)

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,5 +1,8 @@
-/** Visible width of the submitted-prompt prefix (`❯ `). */
-export declare const SUBMITTED_PROMPT_PREFIX_WIDTH = 2;
+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 = 3;
 export interface SubmittedPromptStyle {
     readonly prefix?: (text: string) => string;
     readonly timestamp?: (text: string) => string;
@@ -8,16 +11,16 @@ export interface SubmittedPromptLayout {
     readonly contentWidth: number;
     readonly timestamp: string | null;
 }
-/** Formats transcript metadata, never render time, as local 24-hour HH:mm. */
-export declare function formatSubmittedPromptTime(source: Date | number): string | null;
+/** Formats transcript metadata, never render time, in the active A1 time format. */
+export declare function formatSubmittedPromptTime(source: Date | number, format?: UiTimeFormat): string | null;
 /**
  * Computes the width at which the prompt's Markdown body must be rendered.
  * The timestamp is omitted rather than allowing it to crowd useful content.
  */
-export declare function submittedPromptLayout(width: number, source?: Date | number | null): SubmittedPromptLayout;
+export declare function submittedPromptLayout(width: number, source?: Date | number | null, format?: UiTimeFormat): SubmittedPromptLayout;
 /**
  * Composes already-rendered prompt content into the compact submitted bar.
  * Continuations align below the content, not below the prefix, and no row can
  * exceed the supplied terminal width even when the content renderer misbehaves.
  */
-export declare function composeSubmittedPromptRows(contentRows: readonly string[], width: number, source?: Date | number | null, style?: SubmittedPromptStyle): readonly string[];
+export declare function composeSubmittedPromptRows(contentRows: readonly string[], width: number, source?: Date | number | null, style?: SubmittedPromptStyle, format?: UiTimeFormat): readonly string[];