@timurproko/a1 0.1.8-dev.21b95d6 → 0.1.8-dev.224

package/dist/{src/foundation/ui-components → ui/components}/text.js

@@ -6,12 +6,22 @@
  */
 const ANSI_PATTERN = /\[[0-9;:?]*[ -/]*[@-~]|\][^]*(?:|\\)|[@-Z\\-_]/g;
 const SEGMENTER = new Intl.Segmenter(undefined, { granularity: "grapheme" });
+const WORD_SEGMENTER = new Intl.Segmenter(undefined, { granularity: "word" });
+/**
+ * Recommended-for-general-interchange emoji. Terminals give every one of these
+ * two columns wherever its code points sit, so the wide blocks in
+ * `codePointWidth` cannot carry the measurement alone: a lone U+26A1 or any
+ * U+FE0F presentation sequence escapes them and would measure one column short.
+ */
+const RGI_EMOJI_PATTERN = /^\p{RGI_Emoji}$/v;
+/** Columns a terminal advances for a tab, matching the host runtime. */
+const TAB_WIDTH = 3;
 /** Removes styling sequences so only visible characters remain. */
 export function stripAnsi(text) {
     return text.replace(ANSI_PATTERN, "");
 }
 function codePointWidth(codePoint) {
-    // Zero-width: combining marks, joiners, variation selectors, and format characters.
+    // Protocol: zero-width includes combining marks, joiners, variation selectors, and format characters.
     if (codePoint === 0x200d || codePoint === 0xfeff)
         return 0;
     if (codePoint >= 0x0300 && codePoint <= 0x036f)
@@ -28,7 +38,7 @@ function codePointWidth(codePoint) {
         return 0;
     if (codePoint >= 0xe0100 && codePoint <= 0xe01ef)
         return 0;
-    // Wide: CJK, Hangul, fullwidth forms, and the emoji planes terminals render double-width.
+    // Protocol: wide cells include CJK, Hangul, fullwidth forms, and the emoji planes terminals render double-width.
     if (codePoint >= 0x1100 && codePoint <= 0x115f)
         return 2;
     if (codePoint >= 0x2e80 && codePoint <= 0xa4cf && codePoint !== 0x303f)
@@ -49,19 +59,71 @@ function codePointWidth(codePoint) {
         return 2;
     if (codePoint >= 0x20000 && codePoint <= 0x3fffd)
         return 2;
-    // Control characters occupy nothing.
+    // Protocol: a tab advances to the host runtime's stop; other control characters occupy nothing.
+    if (codePoint === 0x09)
+        return TAB_WIDTH;
     if (codePoint < 0x20 || (codePoint >= 0x7f && codePoint < 0xa0))
         return 0;
     return 1;
 }
-/** Width of one grapheme cluster: the widest code point it contains, marks excluded. */
+/** Cheap pre-filter: only clusters that could be emoji pay for the RGI test. */
+function couldBeEmoji(grapheme) {
+    const codePoint = grapheme.codePointAt(0) ?? 0;
+    return ((codePoint >= 0x1f000 && codePoint <= 0x1fbff) ||
+        (codePoint >= 0x2300 && codePoint <= 0x23ff) ||
+        (codePoint >= 0x2600 && codePoint <= 0x27bf) ||
+        (codePoint >= 0x2b00 && codePoint <= 0x2bff) ||
+        grapheme.length > 1);
+}
+/** Width of one grapheme cluster: two for emoji, else the widest code point it contains. */
 function graphemeWidth(grapheme) {
+    if (couldBeEmoji(grapheme) && RGI_EMOJI_PATTERN.test(grapheme))
+        return 2;
     let width = 0;
     for (const character of grapheme) {
         width = Math.max(width, codePointWidth(character.codePointAt(0) ?? 0));
     }
     return width;
 }
+/** Visible-column segment (word, whitespace, or punctuation) under a pointer column. */
+export function displayWordColumnRange(text, pointerColumn) {
+    const plain = stripAnsi(text);
+    const pointer = Math.max(0, pointerColumn);
+    let column = 0;
+    for (const { segment } of WORD_SEGMENTER.segment(plain)) {
+        const width = displayWidth(segment);
+        const from = column;
+        const to = column + width;
+        if (pointer >= from && pointer < to)
+            return { from, to };
+        column = to;
+    }
+    return null;
+}
+/** Plain graphemes intersecting a visible-column range, expanded at wide-character edges. */
+export function displayColumnSlice(text, requestedFrom, requestedTo) {
+    const plain = stripAnsi(text);
+    const from = Math.max(0, requestedFrom);
+    const to = Math.max(from, requestedTo);
+    let column = 0;
+    let actualFrom;
+    let actualTo = from;
+    let selected = "";
+    for (const { segment } of SEGMENTER.segment(plain)) {
+        const width = graphemeWidth(segment);
+        const start = column;
+        const end = column + width;
+        if (end > from && start < to) {
+            actualFrom ??= start;
+            actualTo = end;
+            selected += segment;
+        }
+        column = end;
+        if (start >= to)
+            break;
+    }
+    return { from: actualFrom ?? from, to: actualFrom === undefined ? from : actualTo, text: selected };
+}
 /** Columns this text occupies once styling is removed. */
 export function displayWidth(text) {
     let width = 0;

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

@@ -0,0 +1,146 @@
+import { type ScrollbarAppearance, type ScrollbarGeometry, type ScrollbarStyle } from "./scrollbar.js";
+export interface TranscriptPromptAnchor {
+    readonly id: string;
+    readonly firstRow: number;
+    readonly lastRow: number;
+    /** The source first row, including its submitted-prompt styling and timestamp. */
+    readonly sourceRow: string;
+}
+export interface TranscriptViewportConfig {
+    readonly scrollbarAppearance: ScrollbarAppearance;
+    readonly scrollbarStyle: ScrollbarStyle;
+}
+export interface TranscriptViewportTheme {
+    readonly track: (text: string) => string;
+    readonly thumb: (text: string, active: boolean) => string;
+    readonly sticky: (text: string, hovered: boolean) => string;
+    readonly quietSticky: (text: string) => string;
+    readonly bottomControl: (text: string, hovered: boolean) => string;
+    readonly selection: (line: string, from: number, to: number) => string;
+}
+export interface TranscriptViewportFrameInput {
+    readonly documentRows: readonly string[];
+    /** Optional paint-only transform; semantic selection and copying keep documentRows exact. */
+    readonly paintDocumentRow?: (row: string) => string;
+    /** Leading document rows that participate in pointer selection and copying. */
+    readonly selectableDocumentRowCount?: number;
+    readonly dockRows: readonly string[];
+    readonly promptAnchors: readonly TranscriptPromptAnchor[];
+    readonly width: number;
+    readonly height: number;
+    /**
+     * Optional zero-based terminal row for the floating bottom control. The shell
+     * supplies a stable anchor above its editor group so transient status and
+     * notification rows cannot make the control jump vertically.
+     */
+    readonly bottomControlRow?: number;
+    readonly now?: number;
+    readonly theme?: TranscriptViewportTheme;
+}
+export interface TranscriptViewportHitRegions {
+    readonly viewportHeight: number;
+    readonly rail: {
+        readonly column: number;
+        /** One-based terminal row. The one-row top inset is intentionally excluded. */
+        readonly rowStart: number;
+        readonly trackHeight: number;
+        readonly geometry: ScrollbarGeometry;
+    } | null;
+    readonly sticky: {
+        readonly row: number;
+        readonly target: number;
+        readonly width: number;
+    } | null;
+    readonly bottom: {
+        readonly row: number;
+        readonly columnStart: number;
+        readonly columnEnd: number;
+    } | null;
+}
+export interface TranscriptViewportFrameDescriptor {
+    readonly frameId: number;
+    readonly width: number;
+    readonly height: number;
+    readonly transcript: {
+        readonly rowStart: number;
+        readonly rowEnd: number;
+    } | null;
+    readonly dock: {
+        readonly rowStart: number;
+        readonly rowEnd: number;
+    } | null;
+    readonly previousDocumentRange: {
+        readonly start: number;
+        readonly end: number;
+    } | null;
+    readonly nextDocumentRange: {
+        readonly start: number;
+        readonly end: number;
+    };
+    readonly previousFollowingEnd: boolean | null;
+    readonly followingEnd: boolean;
+    readonly verticalShiftRows: number;
+    readonly safeVerticalShift: boolean;
+    /** Monotonic interaction revision used to reject stale selection evidence. */
+    readonly selectionRevision: number;
+    /** One-based terminal rows whose source or normalized selection range changed. */
+    readonly selectionDamagedRows: readonly number[];
+    readonly cause: "initial" | "steady" | "dock-input" | "follow-shift" | "detached" | "geometry-change";
+}
+export interface TranscriptViewportFrame {
+    readonly rows: readonly string[];
+    readonly contentWidth: number;
+    readonly scrollTop: number;
+    readonly maxScroll: number;
+    readonly followingEnd: boolean;
+    readonly hits: TranscriptViewportHitRegions;
+    readonly descriptor: TranscriptViewportFrameDescriptor;
+    /** Deterministic evidence for bounded selection-only row composition. */
+    readonly selectionDamage: {
+        readonly revision: number;
+        readonly recomputedRows: readonly number[];
+        readonly reusedRows: readonly number[];
+        readonly cacheEntries: number;
+    };
+}
+/**
+ * A1-owned viewport state. It knows only rows and semantic prompt anchors; Pi
+ * components and transcript payloads remain outside this neutral boundary.
+ */
+export declare class TranscriptViewport {
+    #private;
+    get scrollTop(): number;
+    get maxScroll(): number;
+    get followingEnd(): boolean;
+    get newMessages(): number;
+    get frame(): TranscriptViewportFrame | null;
+    get selectionRevision(): number;
+    /** Counts one completed assistant reply while detached; tool rows never call this. */
+    noteNewMessage(): boolean;
+    setConfig(config: TranscriptViewportConfig): void;
+    noteScrollActivity(now?: number, lingerMs?: number): void;
+    setRailHovered(hovered: boolean): void;
+    setRailDragging(dragging: boolean): void;
+    setStickyHovered(hovered: boolean): void;
+    setBottomHovered(hovered: boolean): void;
+    get selectionActive(): boolean;
+    get hasSelection(): boolean;
+    pressSelection(column: number, viewportRow: number, now?: number): boolean;
+    extendSelection(column: number, viewportRow: number, now?: number, autoScroll?: boolean): boolean;
+    releaseSelection(): boolean;
+    clearSelection(): boolean;
+    selectedText(): string | null;
+    scrollBy(lines: number, now?: number): boolean;
+    scrollTo(position: number, now?: number): boolean;
+    scrollToEnd(now?: number): boolean;
+    /** Jumps to the pinned prompt governing this position, then earlier prompts. */
+    scrollToPreviousPrompt(now?: number): boolean;
+    /** Jumps to the next submitted prompt after the prompt at the current stop. */
+    scrollToNextPrompt(now?: number): boolean;
+    reset(): void;
+    clearTransient(): void;
+    compose(input: TranscriptViewportFrameInput): TranscriptViewportFrame;
+    /** Reuses an established transcript frame when only same-height dock rows changed. */
+    composeDockOnly(dockRows: readonly string[], width: number, height: number): TranscriptViewportFrame | null;
+}
+export declare function assertTranscriptViewportFrameDescriptor(descriptor: TranscriptViewportFrameDescriptor): void;