@timurproko/a1 0.1.8-dev.50ebb19 → 0.1.8-dev.510

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

@@ -1,245 +0,0 @@
-import { displayWidth, faint, truncateToWidth } from "./text.js";
-const MAX_VALUE_LENGTH = 4_096;
-const GRAPHEMES = new Intl.Segmenter(undefined, { granularity: "grapheme" });
-/** Character class for a word boundary: 0 space, 1 word, 2 anything else. */
-function charClass(character) {
-    if (/\s/.test(character))
-        return 0;
-    if (/[\p{L}\p{N}_]/u.test(character))
-        return 1;
-    return 2;
-}
-/**
- * Where a word jump to the left lands: past any whitespace, then past the run of
- * characters of one class, so a word and a run of punctuation each count as one.
- */
-export function wordLeft(text, from) {
-    const graphemes = [...GRAPHEMES.segment(text.slice(0, from))].map(entry => entry.segment);
-    let at = from;
-    let index = graphemes.length - 1;
-    while (index >= 0 && charClass(graphemes[index] ?? "") === 0)
-        at -= (graphemes[index--] ?? "").length;
-    if (index >= 0) {
-        const cls = charClass(graphemes[index] ?? "");
-        while (index >= 0 && charClass(graphemes[index] ?? "") === cls)
-            at -= (graphemes[index--] ?? "").length;
-    }
-    return at;
-}
-/** Where a word jump to the right lands, by the same rules mirrored. */
-export function wordRight(text, from) {
-    const graphemes = [...GRAPHEMES.segment(text.slice(from))].map(entry => entry.segment);
-    let at = from;
-    let index = 0;
-    while (index < graphemes.length && charClass(graphemes[index] ?? "") === 0)
-        at += (graphemes[index++] ?? "").length;
-    if (index < graphemes.length) {
-        const cls = charClass(graphemes[index] ?? "");
-        while (index < graphemes.length && charClass(graphemes[index] ?? "") === cls)
-            at += (graphemes[index++] ?? "").length;
-    }
-    return at;
-}
-/**
- * A single-line editable value with a caret and horizontal scrolling. Accept and
- * cancel are reported distinctly so a caller can commit or discard; cancelling
- * never changes the caller's value.
- */
-export class LineInput {
-    #value;
-    #caret;
-    #offset = 0;
-    constructor(value = "") {
-        this.#value = value.slice(0, MAX_VALUE_LENGTH);
-        this.#caret = this.#value.length;
-    }
-    get value() {
-        return this.#value;
-    }
-    get caret() {
-        return this.#caret;
-    }
-    setValue(value) {
-        this.#value = value.slice(0, MAX_VALUE_LENGTH);
-        this.#caret = Math.min(this.#caret, this.#value.length);
-        this.#offset = 0;
-    }
-    insert(text) {
-        const printable = [...text].filter(character => {
-            const code = character.codePointAt(0) ?? 0;
-            return code >= 0x20 && code !== 0x7f;
-        }).join("");
-        if (printable.length === 0)
-            return;
-        const next = this.#value.slice(0, this.#caret) + printable + this.#value.slice(this.#caret);
-        if (next.length > MAX_VALUE_LENGTH)
-            return;
-        this.#value = next;
-        this.#caret += printable.length;
-    }
-    backspace() {
-        if (this.#caret === 0)
-            return;
-        this.#value = this.#value.slice(0, this.#caret - 1) + this.#value.slice(this.#caret);
-        this.#caret -= 1;
-    }
-    deleteForward() {
-        if (this.#caret >= this.#value.length)
-            return;
-        this.#value = this.#value.slice(0, this.#caret) + this.#value.slice(this.#caret + 1);
-    }
-    moveCaret(delta) {
-        this.#caret = Math.min(Math.max(this.#caret + delta, 0), this.#value.length);
-    }
-    /** Moves the caret one word, in whichever direction the sign says. */
-    moveCaretByWord(direction) {
-        this.#caret = direction < 0 ? wordLeft(this.#value, this.#caret) : wordRight(this.#value, this.#caret);
-    }
-    /** Removes the word before the caret, leaving the caret where it began. */
-    deleteWordBefore() {
-        const to = wordLeft(this.#value, this.#caret);
-        if (to >= this.#caret)
-            return;
-        this.#value = this.#value.slice(0, to) + this.#value.slice(this.#caret);
-        this.#caret = to;
-    }
-    /** Removes the word after the caret, leaving the caret where it is. */
-    deleteWordAfter() {
-        const to = wordRight(this.#value, this.#caret);
-        if (to <= this.#caret)
-            return;
-        this.#value = this.#value.slice(0, this.#caret) + this.#value.slice(to);
-    }
-    moveCaretToStart() {
-        this.#caret = 0;
-    }
-    moveCaretToEnd() {
-        this.#caret = this.#value.length;
-    }
-    /** Visible slice for a width, scrolled so the caret stays on screen. */
-    view(width) {
-        if (width <= 0)
-            return { text: "", caretColumn: 0 };
-        const before = this.#value.slice(0, this.#caret);
-        const caretWidth = displayWidth(before);
-        if (caretWidth < this.#offset)
-            this.#offset = caretWidth;
-        if (caretWidth >= this.#offset + width)
-            this.#offset = caretWidth - width + 1;
-        if (this.#offset < 0)
-            this.#offset = 0;
-        let start = 0;
-        let consumed = 0;
-        for (const character of this.#value) {
-            if (consumed >= this.#offset)
-                break;
-            consumed += displayWidth(character);
-            start += character.length;
-        }
-        return {
-            text: truncateToWidth(this.#value.slice(start), width),
-            caretColumn: Math.max(0, Math.min(width, caretWidth - this.#offset)),
-        };
-    }
-}
-/** Applies one key to the input and reports whether the caller should commit. */
-export function handleLineInputKey(input, data) {
-    if (data === "\r" || data === "\n")
-        return { kind: "accepted", value: input.value };
-    if (data === "\u001b" || data === "\u0003")
-        return { kind: "cancelled" };
-    // A word delete is decided before a plain one: on Windows Terminal the raw
-    // backspace byte IS ctrl+backspace, and the plain branch would swallow it.
-    if (data === "\b" || data === "\u001b\u007f" || data === "\u0017") {
-        input.deleteWordBefore();
-        return { kind: "editing" };
-    }
-    if (data === "\u001b[3;5~" || data === "\u001b[3;3~" || data === "\u001bd") {
-        input.deleteWordAfter();
-        return { kind: "editing" };
-    }
-    if (data === "\u007f") {
-        input.backspace();
-        return { kind: "editing" };
-    }
-    if (data === "\u001b[3~") {
-        input.deleteForward();
-        return { kind: "editing" };
-    }
-    if (data === "\u001b[1;5D" || data === "\u001b[1;3D" || data === "\u001bb") {
-        input.moveCaretByWord(-1);
-        return { kind: "editing" };
-    }
-    if (data === "\u001b[1;5C" || data === "\u001b[1;3C" || data === "\u001bf") {
-        input.moveCaretByWord(1);
-        return { kind: "editing" };
-    }
-    if (data === "\u001b[D") {
-        input.moveCaret(-1);
-        return { kind: "editing" };
-    }
-    if (data === "\u001b[C") {
-        input.moveCaret(1);
-        return { kind: "editing" };
-    }
-    if (data === "\u001b[H" || data === "\u0001") {
-        input.moveCaretToStart();
-        return { kind: "editing" };
-    }
-    if (data === "\u001b[F" || data === "\u0005") {
-        input.moveCaretToEnd();
-        return { kind: "editing" };
-    }
-    // Any other escape sequence is a key this input has no answer for - a page
-    // key, a function key, a chord. It is swallowed rather than typed, because the
-    // one thing it certainly is not is text the reader meant to enter.
-    if (data.startsWith("\u001b"))
-        return { kind: "editing" };
-    input.insert(data);
-    return { kind: "editing" };
-}
-/**
- * The prompt the reference draws at the head of an input row, in the grey it
- * uses for one (#9AA0A6), painted foreground-only so anything drawn behind the
- * row survives.
- */
-/** A rule drawn in the prompt's own grey, as the reference rules an input row. */
-export function promptRule(width) {
-    return `\u001b[38;2;154;160;166m${"─".repeat(Math.max(0, width))}\u001b[39m`;
-}
-export const PROMPT_GLYPH = `\u001b[38;2;154;160;166m❯\u001b[39m `;
-/**
- * The caret the reference draws: the cell under it is reversed rather than given
- * a colour of its own, so it reads as a block in whatever theme is in use.
- */
-export function caretCell(text) {
-    return `\u001b[7m${text}\u001b[27m`;
-}
-/** The input row as the reference draws one, padded to exactly the width. */
-export function renderInputRow(input, width, options = {}) {
-    const inner = Math.max(0, width - 2);
-    const view = input.view(inner);
-    const placeholder = options.placeholder ?? "";
-    const empty = view.text.length === 0 && placeholder.length > 0;
-    const before = view.text.slice(0, view.caretColumn);
-    const under = view.text.slice(view.caretColumn, view.caretColumn + 1) || " ";
-    const after = view.text.slice(view.caretColumn + 1);
-    // Typed text is left unpainted, the caret reverses its cell, and the
-    // placeholder is quietened by weight rather than by a colour of its own.
-    const body = empty
-        ? `${caretCell(placeholder.slice(0, 1))}${faint(placeholder.slice(1))}`
-        : `${before}${caretCell(under)}${after}`;
-    const plain = empty
-        ? placeholder
-        : `${view.text}${view.caretColumn >= view.text.length ? " " : ""}`;
-    const row = padVisible(truncateToWidth(`${PROMPT_GLYPH}${body}`, width), width, `❯ ${plain}`);
-    if (options.ruled === false)
-        return { lines: [row] };
-    const rule = promptRule(width);
-    return { lines: [rule, row, rule] };
-}
-/** Pads by visible width, so styling escapes do not shift the layout. */
-function padVisible(line, width, raw) {
-    const visible = displayWidth(raw);
-    return visible >= width ? line : line + " ".repeat(width - visible);
-}

package/dist/src/foundation/ui-components/list-view.d.ts

@@ -1,66 +0,0 @@
-import type { UiTheme } from "./theme.js";
-/**
- * A list of things that each carry a label and a value. It owns where a value
- * starts, how a row reads when it is selected or pointed at, and which part of a
- * row the pointer is on — so a screen decides what a row means and this decides
- * how it looks and where it can be touched.
- */
-/** The part of a row the pointer is over. A label selects; a value acts. */
-export type ListRegion = "label" | "value" | "minus" | "plus";
-/** Columns a stepper's controls occupy on either side of the value. */
-export declare const STEPPER_RESERVE = 2;
-export interface ListViewRow {
-    /** Identity of the row, as the screen knows it. */
-    readonly key: string;
-    readonly label: string;
-    /** The value as it should read. Formatting belongs to the screen. */
-    readonly value: string;
-    /** Trailing note, such as where a value came from. */
-    readonly suffix?: string;
-    /**
-     * Present when the value is stepped. Each end says whether it can still act;
-     * an end that cannot is drawn as unavailable rather than explaining itself.
-     */
-    readonly stepper?: {
-        readonly lower: boolean;
-        readonly raise: boolean;
-    };
-}
-export interface ListRowState {
-    /** The keyboard's row. */
-    readonly selected: boolean;
-    /** The pointer's row, and where on it the pointer is. */
-    readonly hovered: boolean;
-    readonly region: ListRegion;
-}
-/** Where a row was drawn, so a later pointer report can be read against it. */
-export interface ListRowPlacement {
-    readonly key: string;
-    readonly screenRow: number;
-    readonly valueColumn: number;
-    readonly valueWidth: number;
-    readonly stepper: boolean;
-}
-/**
- * The column every value begins at: past the widest label, with room to breathe,
- * and with the stepper's columns reserved for every row when any row has one, so
- * a number does not shift its own value out of the column it shares.
- */
-export declare function valueColumnFor(rows: readonly ListViewRow[], indent?: number, gap?: number): number;
-/** A group's name, above the rows that belong to it. */
-export declare function renderGroupHeader(title: string, width: number, theme: UiTheme): string;
-/**
- * One row, painted. The label carries the selection, the value carries the
- * pointer, and the stepper appears only when the pointer is on the value it
- * belongs to — an affordance, not decoration.
- */
-export declare function renderListRow(row: ListViewRow, state: ListRowState, valueColumn: number, width: number, theme: UiTheme): string;
-/** A line that stands in for rows: why a group has none, or what it is waiting on. */
-export declare function renderNote(text: string, width: number, theme: UiTheme): string;
-/** Where the value of a row starts and ends, for reading a pointer against it. */
-export declare function placementFor(row: ListViewRow, screenRow: number, valueColumn: number, hovered: boolean): ListRowPlacement;
-/**
- * The part of a row a column falls on. The stepper's controls sit in the columns
- * reserved before and after the value, so they are only reachable while drawn.
- */
-export declare function regionAt(placement: ListRowPlacement, column: number): ListRegion;

package/dist/src/foundation/ui-components/list-view.js

@@ -1,76 +0,0 @@
-import { displayWidth, truncateToWidth } from "./text.js";
-/** Columns a stepper's controls occupy on either side of the value. */
-export const STEPPER_RESERVE = 2;
-/**
- * The column every value begins at: past the widest label, with room to breathe,
- * and with the stepper's columns reserved for every row when any row has one, so
- * a number does not shift its own value out of the column it shares.
- */
-export function valueColumnFor(rows, indent = 4, gap = 2) {
-    const widest = Math.max(0, ...rows.map(row => displayWidth(row.label)));
-    const stepper = rows.some(row => row.stepper !== undefined) ? STEPPER_RESERVE : 0;
-    return indent + widest + gap + stepper;
-}
-/** A group's name, above the rows that belong to it. */
-export function renderGroupHeader(title, width, theme) {
-    return truncateToWidth(theme.fg("accent", theme.bold(title)), width);
-}
-/**
- * One row, painted. The label carries the selection, the value carries the
- * pointer, and the stepper appears only when the pointer is on the value it
- * belongs to — an affordance, not decoration.
- */
-export function renderListRow(row, state, valueColumn, width, theme) {
-    const cursor = state.selected ? "→ " : "  ";
-    const leftRaw = `${cursor}  ${row.label}`;
-    const left = `${theme.fg("accent", cursor)}  ${state.selected ? theme.fg("accent", row.label) : theme.plain(row.label)}`;
-    const gap = Math.max(2, valueColumn - displayWidth(leftRaw));
-    // Pointing anywhere on the row is pointing at the item; pointing at the value
-    // is what brightens it. The selection speaks through the label alone.
-    const valueHovered = state.hovered && state.region !== "label";
-    const stepper = row.stepper !== undefined && valueHovered;
-    const value = valueHovered ? theme.plain(row.value) : theme.fg("muted", row.value);
-    const minus = stepper
-        ? row.stepper?.lower === true
-            ? state.region === "minus" ? theme.plain("- ") : theme.fg("dim", "- ")
-            : theme.disabled("- ")
-        : "";
-    const plus = stepper
-        ? row.stepper?.raise === true
-            ? state.region === "plus" ? theme.plain(" +") : theme.fg("dim", " +")
-            : theme.disabled(" +")
-        : "";
-    const indent = Math.max(2, stepper ? gap - STEPPER_RESERVE : gap);
-    const suffix = row.suffix === undefined ? "" : theme.fg("dim", `  ${row.suffix}`);
-    return truncateToWidth(`${left}${" ".repeat(indent)}${minus}${value}${plus}${suffix}`, width);
-}
-/** A line that stands in for rows: why a group has none, or what it is waiting on. */
-export function renderNote(text, width, theme) {
-    return truncateToWidth(theme.fg("muted", `    ${text}`), width);
-}
-/** Where the value of a row starts and ends, for reading a pointer against it. */
-export function placementFor(row, screenRow, valueColumn, hovered) {
-    const stepper = row.stepper !== undefined && hovered;
-    return {
-        key: row.key,
-        screenRow,
-        valueColumn: stepper ? valueColumn - STEPPER_RESERVE : valueColumn,
-        valueWidth: displayWidth(row.value),
-        stepper,
-    };
-}
-/**
- * The part of a row a column falls on. The stepper's controls sit in the columns
- * reserved before and after the value, so they are only reachable while drawn.
- */
-export function regionAt(placement, column) {
-    const start = placement.valueColumn + 1;
-    const end = start + placement.valueWidth;
-    if (column >= start && column <= end)
-        return "value";
-    if (placement.stepper && column >= start - STEPPER_RESERVE && column < start)
-        return "minus";
-    if (placement.stepper && column > end && column <= end + STEPPER_RESERVE)
-        return "plus";
-    return "label";
-}

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

@@ -1,15 +0,0 @@
-import type { PaneMouseEvent } from "./pane.js";
-/**
- * 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 declare const MOUSE_TRACKING_ON = "\u001B[?1006h\u001B[?1000h\u001B[?1003h";
-export declare const MOUSE_TRACKING_OFF = "\u001B[?1003l\u001B[?1000l\u001B[?1006l";
-export interface ParsedMouseInput {
-    readonly events: readonly PaneMouseEvent[];
-    /** Input with every mouse report removed, for ordinary key handling. */
-    readonly rest: string;
-}
-/** Extracts SGR mouse reports, leaving any keyboard input untouched. */
-export declare function parseMouseInput(data: string): ParsedMouseInput;

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[];
-}