@timurproko/a1 0.1.8-dev.de7821a → 0.2.0

package/dist/src/foundation/ui-components/mouse.js

@@ -1,46 +0,0 @@
-/**
- * SGR mouse reporting. A screen that wants hover, click, and drag needs the
- * terminal to send reports; nothing else in A1 turns this on, and the sequences
- * are paired so the terminal is always left as it was found.
- */
-export const MOUSE_TRACKING_ON = "\u001b[?1006h\u001b[?1000h\u001b[?1003h";
-export const MOUSE_TRACKING_OFF = "\u001b[?1003l\u001b[?1000l\u001b[?1006l";
-const SGR_PATTERN = /\u001b\[<(\d+);(\d+);(\d+)([Mm])/g;
-/** Extracts SGR mouse reports, leaving any keyboard input untouched. */
-export function parseMouseInput(data) {
-    if (!data.includes("\u001b[<"))
-        return { events: [], rest: data };
-    const events = [];
-    let rest = "";
-    let index = 0;
-    SGR_PATTERN.lastIndex = 0;
-    for (let match = SGR_PATTERN.exec(data); match !== null; match = SGR_PATTERN.exec(data)) {
-        rest += data.slice(index, match.index);
-        index = match.index + match[0].length;
-        const code = Number.parseInt(match[1] ?? "", 10);
-        const column = Number.parseInt(match[2] ?? "", 10);
-        const row = Number.parseInt(match[3] ?? "", 10);
-        const released = match[4] === "m";
-        if (!Number.isInteger(code) || !Number.isInteger(column) || !Number.isInteger(row))
-            continue;
-        const event = toEvent(code, column, row, released);
-        if (event !== null)
-            events.push(event);
-    }
-    rest += data.slice(index);
-    return { events: Object.freeze(events), rest };
-}
-function toEvent(code, column, row, released) {
-    if ((code & 64) !== 0) {
-        const kind = (code & 1) === 0 ? "wheel-up" : "wheel-down";
-        return { kind, button: 0, column, row };
-    }
-    const button = code & 3;
-    if ((code & 32) !== 0)
-        return { kind: "motion", button, column, row };
-    if (released)
-        return { kind: "release", button, column, row };
-    if (button === 3)
-        return { kind: "release", button: 0, column, row };
-    return { kind: "press", button, column, row };
-}

package/dist/src/foundation/ui-components/scrollbar.d.ts

@@ -1,62 +0,0 @@
-/**
- * One scrollbar for every scrollable surface. Hover and drag belong to a named
- * rail rather than to a global, because two scrollable surfaces can be visible
- * at once and a shared flag lights up the wrong one.
- */
-export interface ScrollbarGeometry {
-    /** Rows in the track. */
-    readonly trackHeight: number;
-    /** Thumb height in rows, at least one. */
-    readonly thumbHeight: number;
-    /** Zero-based row of the thumb's top within the track. */
-    readonly thumbTop: number;
-    /** Highest scroll position the content allows. */
-    readonly maxScroll: number;
-}
-export interface ScrollbarInput {
-    readonly contentLength: number;
-    readonly viewportHeight: number;
-    readonly scroll: number;
-    readonly trackHeight: number;
-}
-/** Null when the content fits: no scrollbar is drawn and no width is reserved. */
-export declare function scrollbarGeometry(input: ScrollbarInput): ScrollbarGeometry | null;
-export declare function scrollbarReservesSpace(geometry: ScrollbarGeometry | null): boolean;
-/** True when this track row is part of the thumb. */
-export declare function isThumbRow(geometry: ScrollbarGeometry | null, trackRow: number): boolean;
-/** Scroll position for a thumb dragged to a track row. */
-export declare function scrollForThumbRow(geometry: ScrollbarGeometry | null, trackRow: number): number;
-/** Scroll position after paging on the track above or below the thumb. */
-export declare function scrollForTrackPage(geometry: ScrollbarGeometry | null, trackRow: number, scroll: number, viewportHeight: number): number;
-export interface RailPosition {
-    /** Identity of this rail. Two surfaces never share one. */
-    readonly key: string;
-    /** Column the rail is drawn in, one-based. */
-    readonly column: number;
-    /** First row of the track within the surface, zero-based. */
-    readonly rowStart: number;
-    readonly trackHeight: number;
-}
-export interface RailPointer {
-    readonly column: number;
-    readonly row: number;
-}
-/**
- * Hover and drag state for every rail on screen. State is keyed by rail, so a
- * pointer over one rail cannot make another appear hot, and a drag started on
- * one rail cannot be continued by a report addressed to another.
- */
-export declare class ScrollbarRails {
-    #private;
-    isHovered(key: string): boolean;
-    isDragging(key: string): boolean;
-    get draggingKey(): string | null;
-    /** Records the pointer position. Returns the rail it is over, if any. */
-    notePointer(rails: readonly RailPosition[], pointer: RailPointer): string | null;
-    /** Starts a drag when the pointer is on that rail's thumb. */
-    beginDrag(rail: RailPosition, geometry: ScrollbarGeometry | null, pointer: RailPointer): boolean;
-    /** Scroll position for a drag in progress, or null when this rail is not being dragged. */
-    dragTo(rail: RailPosition, geometry: ScrollbarGeometry | null, pointer: RailPointer): number | null;
-    endDrag(): void;
-    clear(): void;
-}

package/dist/src/foundation/ui-components/scrollbar.js

@@ -1,102 +0,0 @@
-/**
- * One scrollbar for every scrollable surface. Hover and drag belong to a named
- * rail rather than to a global, because two scrollable surfaces can be visible
- * at once and a shared flag lights up the wrong one.
- */
-/** Null when the content fits: no scrollbar is drawn and no width is reserved. */
-export function scrollbarGeometry(input) {
-    const { contentLength, viewportHeight, trackHeight } = input;
-    if (trackHeight <= 0 || viewportHeight <= 0)
-        return null;
-    if (contentLength <= viewportHeight)
-        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 travel = trackHeight - thumbHeight;
-    const thumbTop = maxScroll === 0 ? 0 : Math.min(travel, Math.round(travel * scroll / maxScroll));
-    return { trackHeight, thumbHeight, thumbTop, maxScroll };
-}
-export function scrollbarReservesSpace(geometry) {
-    return geometry !== null;
-}
-/** True when this track row is part of the thumb. */
-export function isThumbRow(geometry, trackRow) {
-    if (geometry === null)
-        return false;
-    return trackRow >= geometry.thumbTop && trackRow < geometry.thumbTop + geometry.thumbHeight;
-}
-/** Scroll position for a thumb dragged to a track row. */
-export function scrollForThumbRow(geometry, trackRow) {
-    if (geometry === null)
-        return 0;
-    const travel = geometry.trackHeight - geometry.thumbHeight;
-    if (travel <= 0)
-        return 0;
-    const clamped = Math.min(Math.max(trackRow, 0), travel);
-    return Math.round(clamped * geometry.maxScroll / travel);
-}
-/** Scroll position after paging on the track above or below the thumb. */
-export function scrollForTrackPage(geometry, trackRow, scroll, viewportHeight) {
-    if (geometry === null)
-        return scroll;
-    const page = Math.max(1, viewportHeight);
-    const next = trackRow < geometry.thumbTop ? scroll - page : scroll + page;
-    return Math.min(Math.max(next, 0), geometry.maxScroll);
-}
-/**
- * Hover and drag state for every rail on screen. State is keyed by rail, so a
- * pointer over one rail cannot make another appear hot, and a drag started on
- * one rail cannot be continued by a report addressed to another.
- */
-export class ScrollbarRails {
-    #hovered = new Set();
-    #dragging;
-    isHovered(key) {
-        return this.#hovered.has(key);
-    }
-    isDragging(key) {
-        return this.#dragging?.key === key;
-    }
-    get draggingKey() {
-        return this.#dragging?.key ?? null;
-    }
-    /** Records the pointer position. Returns the rail it is over, if any. */
-    notePointer(rails, pointer) {
-        this.#hovered.clear();
-        for (const rail of rails) {
-            if (pointer.column !== rail.column)
-                continue;
-            const trackRow = pointer.row - rail.rowStart;
-            if (trackRow < 0 || trackRow >= rail.trackHeight)
-                continue;
-            this.#hovered.add(rail.key);
-            return rail.key;
-        }
-        return null;
-    }
-    /** Starts a drag when the pointer is on that rail's thumb. */
-    beginDrag(rail, geometry, pointer) {
-        if (geometry === null || pointer.column !== rail.column)
-            return false;
-        const trackRow = pointer.row - rail.rowStart;
-        if (!isThumbRow(geometry, trackRow))
-            return false;
-        this.#dragging = { key: rail.key, grabOffset: trackRow - geometry.thumbTop };
-        return true;
-    }
-    /** Scroll position for a drag in progress, or null when this rail is not being dragged. */
-    dragTo(rail, geometry, pointer) {
-        const dragging = this.#dragging;
-        if (dragging === undefined || dragging.key !== rail.key || geometry === null)
-            return null;
-        return scrollForThumbRow(geometry, pointer.row - rail.rowStart - dragging.grabOffset);
-    }
-    endDrag() {
-        this.#dragging = undefined;
-    }
-    clear() {
-        this.#hovered.clear();
-        this.#dragging = undefined;
-    }
-}

package/dist/src/foundation/ui-components/shortcuts.d.ts

@@ -1,57 +0,0 @@
-/**
- * Shortcuts as declared data. Dispatch resolves a key through declarations
- * rather than inline comparisons, conflicts are reported when the registry is
- * assembled, and any listing is generated from the same declarations — so a
- * listed shortcut is one dispatch would actually invoke.
- */
-export interface ShortcutDeclaration {
-    /** Key token, for example `up`, `shift+down`, `ctrl+c`, or a literal character. */
-    readonly key: string;
-    /** Screen this applies to, or `global` for every screen. */
-    readonly scope: string;
-    readonly description: string;
-    /** Grouping label for the listing. */
-    readonly section?: string;
-    /**
-     * How this key reads on a screen's hint line, when it belongs there. Keys that
-     * do one thing together — the two arrows, enter and space — declare the same
-     * pair and are shown once.
-     */
-    readonly hint?: {
-        readonly keys: string;
-        readonly does: string;
-    };
-}
-export declare const GLOBAL_SCOPE = "global";
-export interface ShortcutConflict {
-    readonly key: string;
-    readonly scopes: readonly [string, string];
-    readonly descriptions: readonly [string, string];
-    readonly kind: "duplicate" | "shadowed";
-}
-export interface ShortcutRegistryResult {
-    readonly declarations: readonly ShortcutDeclaration[];
-    readonly conflicts: readonly ShortcutConflict[];
-}
-/**
- * Assembles declarations and reports every key claimed twice in overlapping
- * scopes. A screen claiming a global key is reported as shadowed rather than
- * silently resolved by declaration order.
- */
-export declare function assembleShortcuts(declarations: readonly ShortcutDeclaration[]): ShortcutRegistryResult;
-export declare function assertNoShortcutConflicts(result: ShortcutRegistryResult): void;
-export declare class ShortcutRegistry<Action extends string = string> {
-    #private;
-    declare(declaration: ShortcutDeclaration, action: Action): void;
-    /** The action this key invokes in this scope, preferring a screen over a global. */
-    resolve(key: string, scope: string): Action | null;
-    assemble(): ShortcutRegistryResult;
-    /**
-     * The hint line, in the order the screen declares its keys. It is rendered from
-     * the same declarations dispatch reads, so a key cannot be described here and
-     * bound to something else, or bound and never mentioned.
-     */
-    hint(scope: string, separator?: string): string;
-    /** The listing, derived from the declarations dispatch reads. */
-    list(scope?: string): readonly ShortcutDeclaration[];
-}

package/dist/src/foundation/ui-components/shortcuts.js

@@ -1,81 +0,0 @@
-/**
- * Shortcuts as declared data. Dispatch resolves a key through declarations
- * rather than inline comparisons, conflicts are reported when the registry is
- * assembled, and any listing is generated from the same declarations — so a
- * listed shortcut is one dispatch would actually invoke.
- */
-export const GLOBAL_SCOPE = "global";
-function overlaps(left, right) {
-    return left === right || left === GLOBAL_SCOPE || right === GLOBAL_SCOPE;
-}
-/**
- * Assembles declarations and reports every key claimed twice in overlapping
- * scopes. A screen claiming a global key is reported as shadowed rather than
- * silently resolved by declaration order.
- */
-export function assembleShortcuts(declarations) {
-    const conflicts = [];
-    for (let left = 0; left < declarations.length; left++) {
-        for (let right = left + 1; right < declarations.length; right++) {
-            const a = declarations[left];
-            const b = declarations[right];
-            if (a === undefined || b === undefined)
-                continue;
-            if (a.key !== b.key || !overlaps(a.scope, b.scope))
-                continue;
-            conflicts.push({
-                key: a.key,
-                scopes: [a.scope, b.scope],
-                descriptions: [a.description, b.description],
-                kind: a.scope === b.scope ? "duplicate" : "shadowed",
-            });
-        }
-    }
-    return { declarations: Object.freeze([...declarations]), conflicts: Object.freeze(conflicts) };
-}
-export function assertNoShortcutConflicts(result) {
-    const duplicate = result.conflicts.find(conflict => conflict.kind === "duplicate");
-    if (duplicate) {
-        throw new Error(`shortcut ${duplicate.key} is declared twice in scope ${duplicate.scopes[0]}: `
-            + `"${duplicate.descriptions[0]}" and "${duplicate.descriptions[1]}"`);
-    }
-}
-export class ShortcutRegistry {
-    #declarations = [];
-    #actions = new Map();
-    declare(declaration, action) {
-        this.#declarations.push(declaration);
-        this.#actions.set(`${declaration.scope}\u0000${declaration.key}`, action);
-    }
-    /** The action this key invokes in this scope, preferring a screen over a global. */
-    resolve(key, scope) {
-        return this.#actions.get(`${scope}\u0000${key}`) ?? this.#actions.get(`${GLOBAL_SCOPE}\u0000${key}`) ?? null;
-    }
-    assemble() {
-        return assembleShortcuts(this.#declarations);
-    }
-    /**
-     * The hint line, in the order the screen declares its keys. It is rendered from
-     * the same declarations dispatch reads, so a key cannot be described here and
-     * bound to something else, or bound and never mentioned.
-     */
-    hint(scope, separator = " · ") {
-        const shown = new Map();
-        for (const declaration of this.#declarations) {
-            if (declaration.hint === undefined)
-                continue;
-            if (declaration.scope !== scope && declaration.scope !== GLOBAL_SCOPE)
-                continue;
-            if (!shown.has(declaration.hint.keys))
-                shown.set(declaration.hint.keys, declaration.hint.does);
-        }
-        return [...shown].map(([keys, does]) => `${keys} ${does}`).join(separator);
-    }
-    /** The listing, derived from the declarations dispatch reads. */
-    list(scope) {
-        const inScope = scope === undefined
-            ? this.#declarations
-            : this.#declarations.filter(declaration => declaration.scope === scope || declaration.scope === GLOBAL_SCOPE);
-        return Object.freeze([...inScope].sort((left, right) => (left.section ?? "").localeCompare(right.section ?? "") || left.key.localeCompare(right.key)));
-    }
-}

package/dist/src/foundation/ui-components/spans.d.ts

@@ -1,7 +0,0 @@
-/**
- * Replaces the visible columns `[from, to)` of `line` with `span`, preserving
- * the styling before it and re-asserting whatever was still open afterwards, so
- * the tail keeps the colour it had. A wide character straddling either edge is
- * replaced by spaces rather than split.
- */
-export declare function overlaySpan(line: string, from: number, to: number, span: string): string;

package/dist/src/foundation/ui-components/spans.js

@@ -1,59 +0,0 @@
-import { displayWidth } 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
- * styling and hyperlink sequences, and cutting through them either loses the
- * styling of the tail or leaks the span's own reset into it.
- */
-const ANSI_SEQUENCE = "\\u001b(?:\\[[0-?]*[ -/]*[@-~]|[\\]_][^\\u0007\\u001b]*(?:\\u0007|\\u001b\\\\|$))";
-const ANSI_SPLIT = new RegExp(`(${ANSI_SEQUENCE})`);
-const HYPERLINK = /^\]8;;([^]*)(?:|\\)?$/;
-const HYPERLINK_OFF = "]8;;\\";
-const GRAPHEMES = new Intl.Segmenter(undefined, { granularity: "grapheme" });
-/**
- * Replaces the visible columns `[from, to)` of `line` with `span`, preserving
- * the styling before it and re-asserting whatever was still open afterwards, so
- * the tail keeps the colour it had. A wide character straddling either edge is
- * replaced by spaces rather than split.
- */
-export function overlaySpan(line, from, to, span) {
-    let head = "";
-    let replay = "";
-    let tail = "";
-    let column = 0;
-    let hyperlinkOpen = false;
-    for (const token of line.split(ANSI_SPLIT)) {
-        if (!token)
-            continue;
-        if (token.startsWith("")) {
-            if (column >= to) {
-                tail += token;
-                continue;
-            }
-            if (column < from) {
-                head += token;
-                const link = HYPERLINK.exec(token);
-                if (link)
-                    hyperlinkOpen = (link[1] ?? "").length > 0;
-            }
-            // Re-assert everything still active: the span's own reset clobbers the tail.
-            replay += token;
-            continue;
-        }
-        for (const { segment } of GRAPHEMES.segment(token)) {
-            const width = displayWidth(segment);
-            if (column + width <= from)
-                head += segment;
-            else if (column >= to)
-                tail += segment;
-            else if (column < from)
-                head += " ".repeat(from - column);
-            else if (column + width > to)
-                tail += " ".repeat(column + width - to);
-            column += width;
-        }
-    }
-    if (column < from)
-        head += " ".repeat(from - column);
-    return head + (hyperlinkOpen ? HYPERLINK_OFF : "") + span + replay + tail;
-}

package/dist/src/foundation/ui-components/surface.d.ts

@@ -1,20 +0,0 @@
-import { type ScrollbarGeometry } from "./scrollbar.js";
-import type { UiTheme } from "./theme.js";
-/**
- * The chrome around a list: the rail down its right edge, and what it shows when
- * there is nothing to list. Both are the same on any screen, so neither is a
- * screen's to draw.
- */
-/** Columns the rail occupies: its own, plus the gap before it. */
-export declare const RAIL_COLUMNS = 2;
-export interface RailOptions {
-    /** Rows at the top the rail does not run beside, such as a sticky header. */
-    readonly topInset?: number;
-}
-/** Draws the rail beside each row, padding the rows to a common width first. */
-export declare function withScrollbarRail(lines: readonly string[], geometry: ScrollbarGeometry | null, contentWidth: number, theme: UiTheme, options?: RailOptions): readonly string[];
-/**
- * What a list shows instead of rows: a mark and a line, both quiet, sitting in
- * the middle of the space the rows would have had.
- */
-export declare function renderEmptyState(message: string, mark: string, height: number, width: number, theme: UiTheme): readonly string[];

package/dist/src/foundation/ui-components/surface.js

@@ -1,38 +0,0 @@
-import { isThumbRow } from "./scrollbar.js";
-import { displayWidth } from "./text.js";
-/**
- * The chrome around a list: the rail down its right edge, and what it shows when
- * there is nothing to list. Both are the same on any screen, so neither is a
- * screen's to draw.
- */
-/** Columns the rail occupies: its own, plus the gap before it. */
-export const RAIL_COLUMNS = 2;
-/** Draws the rail beside each row, padding the rows to a common width first. */
-export function withScrollbarRail(lines, geometry, contentWidth, theme, options = {}) {
-    const inset = options.topInset ?? 0;
-    return lines.map((line, offset) => {
-        const cell = offset < inset || geometry === null
-            ? " "
-            : isThumbRow(geometry, offset - inset) ? theme.fg("accent", "│") : theme.fg("dim", "│");
-        return `${pad(line, contentWidth)} ${cell}`;
-    });
-}
-/**
- * What a list shows instead of rows: a mark and a line, both quiet, sitting in
- * the middle of the space the rows would have had.
- */
-export function renderEmptyState(message, mark, height, width, theme) {
-    const middle = Math.floor(height / 2);
-    return Array.from({ length: Math.max(0, height) }, (_line, index) => {
-        if (index === middle - 1)
-            return centre(theme.fg("muted", mark), mark, width);
-        return index === middle ? centre(theme.fg("muted", message), message, width) : "";
-    });
-}
-function centre(painted, raw, width) {
-    return `${" ".repeat(Math.max(0, Math.floor((width - displayWidth(raw)) / 2)))}${painted}`;
-}
-function pad(line, width) {
-    const visible = displayWidth(line);
-    return visible >= width ? line : line + " ".repeat(width - visible);
-}

package/dist/src/foundation/ui-components/text.d.ts

@@ -1,24 +0,0 @@
-/**
- * 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.
- */
-/** Removes styling sequences so only visible characters remain. */
-export declare function stripAnsi(text: string): string;
-/** Columns this text occupies once styling is removed. */
-export declare function displayWidth(text: string): number;
-/**
- * Truncates to a column budget without splitting a grapheme. Styling sequences
- * are carried through and a reset is appended when any style was opened, so a
- * truncated row cannot leak colour into the rest of the line.
- */
-export declare function truncateToWidth(text: string, maxWidth: number): string;
-/** Pads to an exact column count, truncating when the text is already wider. */
-export declare function padToWidth(text: string, width: number): string;
-/**
- * A control that is present but cannot be used: the terminal own faint
- * attribute over whatever colour it already carries, so it reads as half of what
- * it would otherwise be in any theme.
- */
-export declare function faint(text: string): string;

package/dist/src/foundation/ui-components/text.js

@@ -1,123 +0,0 @@
-/**
- * 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.
- */
-const ANSI_PATTERN = /\[[0-9;:?]*[ -/]*[@-~]|\][^]*(?:|\\)|[@-Z\\-_]/g;
-const SEGMENTER = new Intl.Segmenter(undefined, { granularity: "grapheme" });
-/** 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.
-    if (codePoint === 0x200d || codePoint === 0xfeff)
-        return 0;
-    if (codePoint >= 0x0300 && codePoint <= 0x036f)
-        return 0;
-    if (codePoint >= 0x200b && codePoint <= 0x200f)
-        return 0;
-    if (codePoint >= 0xfe00 && codePoint <= 0xfe0f)
-        return 0;
-    if (codePoint >= 0x20d0 && codePoint <= 0x20f0)
-        return 0;
-    if (codePoint >= 0x1ab0 && codePoint <= 0x1aff)
-        return 0;
-    if (codePoint >= 0x1dc0 && codePoint <= 0x1dff)
-        return 0;
-    if (codePoint >= 0xe0100 && codePoint <= 0xe01ef)
-        return 0;
-    // Wide: 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)
-        return 2;
-    if (codePoint >= 0xac00 && codePoint <= 0xd7a3)
-        return 2;
-    if (codePoint >= 0xf900 && codePoint <= 0xfaff)
-        return 2;
-    if (codePoint >= 0xfe30 && codePoint <= 0xfe6f)
-        return 2;
-    if (codePoint >= 0xff00 && codePoint <= 0xff60)
-        return 2;
-    if (codePoint >= 0xffe0 && codePoint <= 0xffe6)
-        return 2;
-    if (codePoint >= 0x1f300 && codePoint <= 0x1f64f)
-        return 2;
-    if (codePoint >= 0x1f900 && codePoint <= 0x1f9ff)
-        return 2;
-    if (codePoint >= 0x20000 && codePoint <= 0x3fffd)
-        return 2;
-    // Control characters occupy nothing.
-    if (codePoint < 0x20 || (codePoint >= 0x7f && codePoint < 0xa0))
-        return 0;
-    return 1;
-}
-/** Width of one grapheme cluster: the widest code point it contains, marks excluded. */
-function graphemeWidth(grapheme) {
-    let width = 0;
-    for (const character of grapheme) {
-        width = Math.max(width, codePointWidth(character.codePointAt(0) ?? 0));
-    }
-    return width;
-}
-/** Columns this text occupies once styling is removed. */
-export function displayWidth(text) {
-    let width = 0;
-    for (const { segment } of SEGMENTER.segment(stripAnsi(text)))
-        width += graphemeWidth(segment);
-    return width;
-}
-/**
- * Truncates to a column budget without splitting a grapheme. Styling sequences
- * are carried through and a reset is appended when any style was opened, so a
- * truncated row cannot leak colour into the rest of the line.
- */
-export function truncateToWidth(text, maxWidth) {
-    if (maxWidth <= 0)
-        return "";
-    if (displayWidth(text) <= maxWidth)
-        return text;
-    let out = "";
-    let width = 0;
-    let styled = false;
-    let index = 0;
-    while (index < text.length) {
-        ANSI_PATTERN.lastIndex = index;
-        const match = ANSI_PATTERN.exec(text);
-        if (match && match.index === index) {
-            out += match[0];
-            styled = true;
-            index += match[0].length;
-            continue;
-        }
-        const nextEscape = match ? match.index : text.length;
-        for (const { segment } of SEGMENTER.segment(text.slice(index, nextEscape))) {
-            const segmentWidth = graphemeWidth(segment);
-            if (width + segmentWidth > maxWidth)
-                return styled ? `${out}` : out;
-            out += segment;
-            width += segmentWidth;
-        }
-        index = nextEscape;
-    }
-    return styled ? `${out}` : out;
-}
-/** Pads to an exact column count, truncating when the text is already wider. */
-export function padToWidth(text, width) {
-    if (width <= 0)
-        return "";
-    const current = displayWidth(text);
-    if (current > width)
-        return truncateToWidth(text, width);
-    return text + " ".repeat(width - current);
-}
-/**
- * A control that is present but cannot be used: the terminal own faint
- * attribute over whatever colour it already carries, so it reads as half of what
- * it would otherwise be in any theme.
- */
-export function faint(text) {
-    return `${text}`;
-}

package/dist/src/foundation/ui-components/theme.d.ts

@@ -1,23 +0,0 @@
-/**
- * Colour as a port, so a screen can be rendered and asserted without a terminal
- * or a theme, and so the component layer never imports a Pi adapter.
- */
-export type UiThemeToken = "accent" | "text" | "muted" | "dim" | "border" | "error";
-export interface UiTheme {
-    fg(token: UiThemeToken, text: string): string;
-    bold(text: string): string;
-    /**
-     * The terminal's own foreground, left unpainted. What a list's own text is:
-     * a theme built for a light background would otherwise write near-black rows
-     * into a dark terminal, which is how the engine leaves its lists too.
-     */
-    plain(text: string): string;
-    /** Inverted styling for the active row of a floating surface. */
-    highlight(text: string): string;
-    /** A control that is present but cannot act: quieter than quiet text. */
-    disabled(text: string): string;
-    /** Background for a floating surface, so it reads as above the content. */
-    panel(text: string): string;
-}
-/** Renders every token as plain text. What tests assert against. */
-export declare const PLAIN_THEME: UiTheme;

package/dist/src/foundation/ui-components/theme.js

@@ -1,13 +0,0 @@
-/**
- * Colour as a port, so a screen can be rendered and asserted without a terminal
- * or a theme, and so the component layer never imports a Pi adapter.
- */
-/** Renders every token as plain text. What tests assert against. */
-export const PLAIN_THEME = Object.freeze({
-    fg: (_token, text) => text,
-    bold: (text) => text,
-    plain: (text) => text,
-    highlight: (text) => text,
-    disabled: (text) => text,
-    panel: (text) => text,
-});