@nuvin/ink 7.0.2-alpha → 7.1.0-alpha

package/build/text-selection-controller.d.ts

@@ -0,0 +1,106 @@
+import { type TextSelectionPoint, type TextSelectionSpan } from './text-selection.js';
+/**
+Live viewport of the selection container, in Ink output grid cells.
+*/
+export type SelectionViewport = {
+    top: number;
+    left: number;
+    width: number;
+    height: number;
+    /** Vertical scroll offset in rendered rows: content row shown at `top`. */
+    scrollY: number;
+};
+export type TextSelectionSnapshot = {
+    /** Content coordinates (see TextSelectionPoint). */
+    anchor: TextSelectionPoint | null;
+    focus: TextSelectionPoint | null;
+    isDragging: boolean;
+    text: string;
+    isEmpty: boolean;
+};
+export type TextSelectionActions = {
+    /**
+    Points passed to start/update are 0-based SCREEN cells on the Ink output
+    grid; the controller converts to content space via the viewport provider.
+    */
+    start: (screenPoint: {
+        x: number;
+        y: number;
+    }) => void;
+    update: (screenPoint: {
+        x: number;
+        y: number;
+    }) => void;
+    finish: () => void;
+    clear: () => void;
+    /**
+    Registered by the mouse bridge. Returning null means "no scroll container":
+    the whole output grid is the viewport with scrollY = 0.
+    */
+    setViewportProvider: (provider: (() => SelectionViewport | null) | null) => void;
+};
+/**
+Selection actions plus an imperative snapshot read. Unlike the snapshot from
+`useTextSelection()`, holding this handle does NOT subscribe the component to
+selection changes — use it where selection state is only needed at event time
+(mouse bridges, key handlers) so drags never re-render the host component.
+*/
+export type TextSelectionHandle = TextSelectionActions & {
+    getSnapshot: () => TextSelectionSnapshot;
+};
+/**
+Framework-agnostic selection state owned by an Ink instance. Selection points
+live in content space (container-relative rows that survive scrolling); the
+viewport provider converts screen ↔ content at event time and paint time.
+*/
+export declare class TextSelectionController {
+    /** Wired by Ink to schedule a repaint when the highlight must change. */
+    onInvalidate?: () => void;
+    private anchor;
+    private focus;
+    private isDragging;
+    private text;
+    private readonly rowCache;
+    private viewportProvider;
+    private lastViewport;
+    private readonly listeners;
+    private snapshot;
+    private notifyScheduled;
+    subscribe: (listener: () => void) => (() => void);
+    getSnapshot: () => TextSelectionSnapshot;
+    setViewportProvider: (provider: (() => SelectionViewport | null) | null) => void;
+    start: (screenPoint: {
+        x: number;
+        y: number;
+    }) => void;
+    update: (screenPoint: {
+        x: number;
+        y: number;
+    }) => void;
+    finish: () => void;
+    clear: () => void;
+    /**
+    Called from the renderer's paint hook on every render of the main output.
+    Caches visible rows under content-row keys. Never invalidates synchronously
+    — it runs during a render pass and must not schedule another render.
+
+    While dragging, cache entries update freely (auto-scroll depends on it).
+    After `finish()`, the cache is frozen: existing entries are never
+    overwritten, so extracted text is immutable. If a visible row inside the
+    selected range no longer matches its frozen entry (content reflowed
+    underneath the selection), the selection auto-clears.
+    */
+    captureRows: (plainRows: readonly string[], maskRows?: ReadonlyArray<readonly boolean[]>) => void;
+    /**
+    Convert the selection's content spans to screen spans using the current
+    viewport. Rows outside the viewport or the grid are dropped (they are
+    still part of the extracted text).
+    */
+    getPaintSpans: (outputWidth: number, outputHeight: number) => TextSelectionSpan[];
+    private resolveViewport;
+    private toContentPoint;
+    /** Returns true when the extracted text changed. */
+    private recomputeText;
+    private emit;
+    private scheduleNotify;
+}

package/build/text-selection-controller.js

@@ -0,0 +1,311 @@
+/* eslint-disable @typescript-eslint/no-restricted-types --
+   The public selection API uses null (matching React ref idioms and the
+   mouse bridge in ink-input); keep it consistent throughout this file. */
+import stringWidth from 'string-width';
+import { extractTextFromRows, getSelectionSpans, } from './text-selection.js';
+const fullGridViewport = {
+    top: 0,
+    left: 0,
+    width: Number.POSITIVE_INFINITY,
+    height: Number.POSITIVE_INFINITY,
+    scrollY: 0,
+};
+/**
+Framework-agnostic selection state owned by an Ink instance. Selection points
+live in content space (container-relative rows that survive scrolling); the
+viewport provider converts screen ↔ content at event time and paint time.
+*/
+export class TextSelectionController {
+    /** Wired by Ink to schedule a repaint when the highlight must change. */
+    onInvalidate;
+    anchor = null;
+    focus = null;
+    isDragging = false;
+    text = '';
+    rowCache = new Map();
+    viewportProvider = null;
+    // Last viewport a registered provider returned. Reused for one-frame gaps
+    // where the provider returns null (e.g. bounds momentarily 0 mid-re-render),
+    // so the highlight doesn't flash to full-grid coordinates and the frozen
+    // row cache isn't compared against a differently-sliced viewport.
+    lastViewport = null;
+    listeners = new Set();
+    snapshot;
+    notifyScheduled = false;
+    subscribe = (listener) => {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    };
+    getSnapshot = () => {
+        this.snapshot ??= {
+            anchor: this.anchor,
+            focus: this.focus,
+            isDragging: this.isDragging,
+            text: this.text,
+            isEmpty: this.text.length === 0,
+        };
+        return this.snapshot;
+    };
+    setViewportProvider = (provider) => {
+        this.viewportProvider = provider;
+    };
+    start = (screenPoint) => {
+        const point = this.toContentPoint(screenPoint);
+        this.anchor = point;
+        this.focus = point;
+        this.isDragging = true;
+        this.recomputeText();
+        this.emit();
+        this.onInvalidate?.();
+    };
+    update = (screenPoint) => {
+        if (!this.anchor) {
+            return;
+        }
+        const point = this.toContentPoint(screenPoint);
+        const focusChanged = this.focus?.x !== point.x || this.focus.y !== point.y;
+        this.focus = point;
+        const textChanged = this.recomputeText();
+        if (focusChanged || textChanged) {
+            this.emit();
+            this.onInvalidate?.();
+        }
+    };
+    finish = () => {
+        if (!this.isDragging) {
+            return;
+        }
+        this.isDragging = false;
+        this.emit();
+    };
+    clear = () => {
+        const hadSelection = this.anchor !== null || this.text.length > 0 || this.isDragging;
+        this.anchor = null;
+        this.focus = null;
+        this.isDragging = false;
+        this.text = '';
+        this.rowCache.clear();
+        if (hadSelection) {
+            this.emit();
+            this.onInvalidate?.();
+        }
+    };
+    /**
+    Called from the renderer's paint hook on every render of the main output.
+    Caches visible rows under content-row keys. Never invalidates synchronously
+    — it runs during a render pass and must not schedule another render.
+
+    While dragging, cache entries update freely (auto-scroll depends on it).
+    After `finish()`, the cache is frozen: existing entries are never
+    overwritten, so extracted text is immutable. If a visible row inside the
+    selected range no longer matches its frozen entry (content reflowed
+    underneath the selection), the selection auto-clears.
+    */
+    captureRows = (plainRows, maskRows) => {
+        const resolved = this.resolveViewport();
+        // A registered provider that returns null means the container's bounds are
+        // not measurable this frame (transient during a re-render). Capturing or
+        // comparing against the full-grid fallback would corrupt the cache and
+        // spuriously auto-clear a finished selection. Skip the frame instead.
+        if (!resolved.available && this.anchor !== null) {
+            return;
+        }
+        const { viewport } = resolved;
+        const top = Math.max(0, viewport.top);
+        const left = Math.max(0, viewport.left);
+        const bottom = Math.min(plainRows.length, viewport.top + viewport.height);
+        const hasSelection = this.anchor !== null && this.focus !== null;
+        const frozen = hasSelection && !this.isDragging;
+        // Without a selection there is nothing to preserve: reset the cache to
+        // the currently visible rows so a subsequent start() has fresh data and
+        // stale rows from earlier scroll positions don't accumulate.
+        if (!hasSelection) {
+            this.rowCache.clear();
+        }
+        let mismatch = false;
+        const range = hasSelection
+            ? (() => {
+                const [a, b] = [this.anchor, this.focus];
+                return a.y <= b.y ? { min: a.y, max: b.y } : { min: b.y, max: a.y };
+            })()
+            : undefined;
+        for (let y = top; y < bottom; y++) {
+            const contentY = viewport.scrollY + (y - viewport.top);
+            const text = sliceRow(plainRows[y] ?? '', left, viewport.width);
+            const mask = maskRows
+                ? sliceMask(maskRows[y], left, viewport.width)
+                : undefined;
+            const row = { text, mask };
+            const existing = this.rowCache.get(contentY);
+            if (frozen && existing) {
+                if (range &&
+                    contentY >= range.min &&
+                    contentY <= range.max &&
+                    existing.text !== text) {
+                    mismatch = true;
+                    break;
+                }
+                continue;
+            }
+            this.rowCache.set(contentY, row);
+        }
+        if (mismatch) {
+            // Content reflowed underneath a finished selection: clearing is the
+            // only honest option. Defer the notification outside the render pass.
+            this.anchor = null;
+            this.focus = null;
+            this.isDragging = false;
+            this.text = '';
+            this.rowCache.clear();
+            this.snapshot = undefined;
+            this.scheduleNotify(true);
+            return;
+        }
+        if (hasSelection && !frozen && this.recomputeText()) {
+            this.scheduleNotify(false);
+        }
+        else if (hasSelection &&
+            frozen &&
+            this.text.length === 0 && // Rows may have arrived only after the gesture ended.
+            this.recomputeText()) {
+            this.scheduleNotify(false);
+        }
+    };
+    /**
+    Convert the selection's content spans to screen spans using the current
+    viewport. Rows outside the viewport or the grid are dropped (they are
+    still part of the extracted text).
+    */
+    getPaintSpans = (outputWidth, outputHeight) => {
+        if (!this.anchor || !this.focus) {
+            return [];
+        }
+        const { viewport } = this.resolveViewport();
+        const spans = getSelectionSpans(this.anchor, this.focus, y => this.rowCache.get(y));
+        const left = Math.max(0, viewport.left);
+        const right = Math.min(outputWidth, viewport.left + viewport.width);
+        const screenTop = Math.max(0, viewport.top);
+        const screenBottom = Math.min(outputHeight, viewport.top + viewport.height);
+        const result = [];
+        for (const span of spans) {
+            const screenY = viewport.top + (span.y - viewport.scrollY);
+            if (screenY < screenTop || screenY >= screenBottom) {
+                continue;
+            }
+            const x1 = Math.max(left, viewport.left + span.x1);
+            const x2 = Math.min(right, viewport.left + span.x2);
+            if (x2 <= x1) {
+                continue;
+            }
+            result.push({ y: screenY, x1, x2 });
+        }
+        return result;
+    };
+    resolveViewport() {
+        if (!this.viewportProvider) {
+            // No scroll container: the whole grid is the viewport.
+            return { viewport: fullGridViewport, available: true };
+        }
+        const current = this.viewportProvider();
+        if (current) {
+            this.lastViewport = current;
+            return { viewport: current, available: true };
+        }
+        // Provider registered but bounds unavailable this frame. Reuse the last
+        // known viewport so the highlight stays put; report unavailable so
+        // captureRows skips the frame.
+        return {
+            viewport: this.lastViewport ?? fullGridViewport,
+            available: false,
+        };
+    }
+    toContentPoint(screenPoint) {
+        const { viewport } = this.resolveViewport();
+        const maxX = viewport.width === Number.POSITIVE_INFINITY
+            ? Number.POSITIVE_INFINITY
+            : viewport.left + viewport.width - 1;
+        const maxY = viewport.height === Number.POSITIVE_INFINITY
+            ? Number.POSITIVE_INFINITY
+            : viewport.top + viewport.height - 1;
+        const x = Math.min(Math.max(screenPoint.x, viewport.left), maxX);
+        const y = Math.min(Math.max(screenPoint.y, viewport.top), maxY);
+        return {
+            x: x - viewport.left,
+            y: y - viewport.top + viewport.scrollY,
+        };
+    }
+    /** Returns true when the extracted text changed. */
+    recomputeText() {
+        const next = this.anchor && this.focus
+            ? extractTextFromRows(this.anchor, this.focus, y => this.rowCache.get(y))
+            : '';
+        if (next === this.text) {
+            return false;
+        }
+        this.text = next;
+        return true;
+    }
+    emit() {
+        this.snapshot = undefined;
+        for (const listener of this.listeners) {
+            listener();
+        }
+    }
+    scheduleNotify(invalidate) {
+        this.snapshot = undefined;
+        if (this.notifyScheduled) {
+            return;
+        }
+        this.notifyScheduled = true;
+        queueMicrotask(() => {
+            this.notifyScheduled = false;
+            for (const listener of this.listeners) {
+                listener();
+            }
+            if (invalidate) {
+                this.onInvalidate?.();
+            }
+        });
+    }
+}
+// Slice a row by display cells, not string indices, so wide characters keep
+// the text aligned with the cell-indexed mask. A wide glyph straddling the
+// viewport edge is replaced by spaces for the cells that remain visible.
+const sliceRow = (row, left, width) => {
+    if (left === 0 && width === Number.POSITIVE_INFINITY) {
+        return row.trimEnd();
+    }
+    const right = width === Number.POSITIVE_INFINITY
+        ? Number.POSITIVE_INFINITY
+        : left + width;
+    let cell = 0;
+    let result = '';
+    for (const char of row) {
+        const charWidth = Math.max(1, stringWidth(char));
+        const start = cell;
+        const end = cell + charWidth;
+        cell = end;
+        if (end <= left) {
+            continue;
+        }
+        if (start >= right) {
+            break;
+        }
+        result +=
+            start >= left && end <= right
+                ? char
+                : ' '.repeat(Math.min(end, right) - Math.max(start, left));
+    }
+    return result.trimEnd();
+};
+const sliceMask = (mask, left, width) => {
+    if (!mask) {
+        return undefined;
+    }
+    return width === Number.POSITIVE_INFINITY
+        ? mask.slice(left)
+        : mask.slice(left, left + width);
+};
+//# sourceMappingURL=text-selection-controller.js.map

package/build/text-selection-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-selection-controller.js","sourceRoot":"","sources":["../src/text-selection-controller.ts"],"names":[],"mappings":"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"}

package/build/text-selection.d.ts

@@ -0,0 +1,41 @@
+/**
+A point in container content space: `x` is cells from the container's content
+left edge, `y` is the content row index (survives scrolling).
+*/
+export type TextSelectionPoint = {
+    x: number;
+    y: number;
+};
+export type TextSelectionSpan = {
+    y: number;
+    x1: number;
+    x2: number;
+};
+/**
+A single cached row of rendered content. `mask` flags which display cells are
+selectable (written by `<Text>` and not opted out); a missing mask means every
+cell is selectable.
+*/
+export type SelectionRow = {
+    text: string;
+    mask?: readonly boolean[];
+};
+export type RowLookup = (y: number) => SelectionRow | undefined;
+export declare function normalizeSelection(anchor: TextSelectionPoint, focus: TextSelectionPoint): {
+    start: TextSelectionPoint;
+    end: TextSelectionPoint;
+};
+/**
+One past the last printable selectable cell of the row. Trailing whitespace
+and trailing chrome cells are excluded.
+*/
+export declare function getRowEnd(row: SelectionRow): number;
+export declare function getSelectionSpans(anchor: TextSelectionPoint, focus: TextSelectionPoint, getRow: RowLookup): TextSelectionSpan[];
+/**
+Extract the selectable text of `row` between display cells `[from, to)`.
+Non-selectable runs at the edges are dropped; interior non-selectable runs
+collapse to a single space. Wide glyphs are included when the range overlaps
+either of their cells.
+*/
+export declare function sliceSelectableCells(row: SelectionRow, from: number, to: number): string;
+export declare function extractTextFromRows(anchor: TextSelectionPoint, focus: TextSelectionPoint, getRow: RowLookup): string;

package/build/text-selection.js

@@ -0,0 +1,101 @@
+import stringWidth from 'string-width';
+export function normalizeSelection(anchor, focus) {
+    if (anchor.y < focus.y || (anchor.y === focus.y && anchor.x <= focus.x)) {
+        return { start: anchor, end: focus };
+    }
+    return { start: focus, end: anchor };
+}
+const isCharSelectable = (mask, charStart, charEnd) => {
+    if (!mask) {
+        return true;
+    }
+    for (let cell = charStart; cell < charEnd; cell++) {
+        if (mask[cell] === false) {
+            return false;
+        }
+    }
+    return true;
+};
+/**
+One past the last printable selectable cell of the row. Trailing whitespace
+and trailing chrome cells are excluded.
+*/
+export function getRowEnd(row) {
+    const { text, mask } = row;
+    let cell = 0;
+    let end = 0;
+    for (const char of text) {
+        const width = Math.max(1, stringWidth(char));
+        const charStart = cell;
+        const charEnd = cell + width;
+        cell = charEnd;
+        if (/^\s*$/.test(char)) {
+            continue;
+        }
+        if (isCharSelectable(mask, charStart, charEnd)) {
+            end = charEnd;
+        }
+    }
+    return end;
+}
+export function getSelectionSpans(anchor, focus, getRow) {
+    const { start, end } = normalizeSelection(anchor, focus);
+    if (start.x === end.x && start.y === end.y) {
+        return [];
+    }
+    const spans = [];
+    for (let { y } = start; y <= end.y; y++) {
+        const rowEnd = getRowEnd(getRow(y) ?? { text: '' });
+        let x1 = y === start.y ? start.x : 0;
+        let x2 = y === end.y ? end.x : rowEnd;
+        x1 = Math.max(0, Math.min(x1, rowEnd));
+        x2 = Math.max(0, Math.min(x2, rowEnd));
+        // Emit empty spans (x1 === x2) so blank lines survive extraction.
+        spans.push({ y, x1, x2 });
+    }
+    return spans;
+}
+/**
+Extract the selectable text of `row` between display cells `[from, to)`.
+Non-selectable runs at the edges are dropped; interior non-selectable runs
+collapse to a single space. Wide glyphs are included when the range overlaps
+either of their cells.
+*/
+export function sliceSelectableCells(row, from, to) {
+    if (to <= from) {
+        return '';
+    }
+    const { text, mask } = row;
+    let cell = 0;
+    let result = '';
+    let pendingGap = false;
+    for (const char of text) {
+        const width = Math.max(1, stringWidth(char));
+        const charStart = cell;
+        const charEnd = cell + width;
+        cell = charEnd;
+        if (charEnd <= from) {
+            continue;
+        }
+        if (charStart >= to) {
+            break;
+        }
+        if (isCharSelectable(mask, charStart, charEnd)) {
+            if (pendingGap && result.length > 0) {
+                result += ' ';
+            }
+            pendingGap = false;
+            result += char;
+        }
+        else if (result.length > 0) {
+            pendingGap = true;
+        }
+    }
+    return result;
+}
+export function extractTextFromRows(anchor, focus, getRow) {
+    return getSelectionSpans(anchor, focus, getRow)
+        .map(span => sliceSelectableCells(getRow(span.y) ?? { text: '' }, span.x1, span.x2))
+        .join('\n');
+}
+//# sourceMappingURL=text-selection.js.map

package/build/text-selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-selection.js","sourceRoot":"","sources":["../src/text-selection.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@nuvin/ink",
-	"version": "7.0.2-alpha",
+	"version": "7.1.0-alpha",
 	"description": "React for CLI",
 	"license": "MIT",
 	"repository": "marschhuynh/ink",

package/readme.md

@@ -2527,6 +2527,52 @@ Type: `() => void`
 
 Resets `frame`, `time`, and `delta` to `0` and restarts timing from the current moment. Useful for one-shot animations triggered by events.
 
+### useTextSelection()
+
+A React hook exposing the instance-owned text selection: the currently selected terminal text plus actions to drive a selection programmatically. Ink paints the highlight as a final overlay on the rendered output and recomputes `text` as rows render.
+
+Selection is **Text-only**: only cells written by `<Text>` components are highlighted and extracted. Box borders, backgrounds, and padding/margin gaps are never part of a selection. Mark chrome text (icons, line-number gutters, diff markers) with `<Text selectable={false}>` to exclude it too — extraction drops chrome at the edges of a line and collapses interior chrome gaps to a single space.
+
+```jsx
+import {Text, useTextSelection} from 'ink';
+
+const SelectionFooter = () => {
+	const selection = useTextSelection();
+
+	return <Text dimColor>{selection.isEmpty ? 'no selection' : selection.text}</Text>;
+};
+```
+
+This hook is mouse-agnostic; mouse-driven selection (click-and-drag, edge auto-scroll) is provided by `useMouseTextSelection()` in `@nuvin/ink-input`, which drives these same actions.
+
+When a component only needs to *drive* the selection (mouse bridges, key handlers that clear it), use `useTextSelectionActions()` instead: it returns the same actions plus an imperative `getSnapshot()` but never subscribes, so the host component does not re-render on selection changes. Reserve `useTextSelection()` for components that display selection state.
+
+#### Return value
+
+- `anchor` / `focus` — `{x, y} | null` in **content space**: `x` is cells from the selection container's left edge, `y` is the content row index (survives scrolling).
+- `isDragging` — `boolean`, true between `start()` and `finish()`.
+- `text` — `string`, the selected text. Blank lines inside the selection are preserved; trailing whitespace is not selectable.
+- `isEmpty` — `boolean`, true when no text is selected.
+- `start(screenPoint)` / `update(screenPoint)` — begin/extend a selection. Points are 0-based **screen cells** on the Ink output grid; the registered viewport provider converts them to content space.
+- `finish()` — end the drag; the selected text stays available (and is frozen — if content reflows underneath a finished selection, it auto-clears rather than silently changing).
+- `clear()` — clear the selection and its row cache.
+- `setViewportProvider(fn)` — register a function returning `{top, left, width, height, scrollY}` for the selection container (in output grid cells, `scrollY` in rendered rows). Return `null`, or pass `null`, to treat the whole output grid as the viewport.
+
+#### `<Text selectable>`
+
+Type: `boolean`\
+Default: `true`
+
+When `false`, the text is never highlighted and never appears in extracted selection text. Note that nested `<Text>` squashes into its outermost `<Text>` ancestor's write, so `selectable` must be set on the outermost text element (use sibling `<Text>` elements in a `<Box>` to mix chrome and content on one line).
+
+#### Known limits
+
+- Mouse-to-grid mapping (in `useMouseTextSelection`) assumes the Ink output starts at terminal cell (1,1) — i.e. fullscreen/alternate-screen apps.
+- The selection container must not be nested inside another scroll container (`getBounds()` ignores ancestor scroll offsets).
+- A Text node's own padding cells count as selectable.
+- Horizontal scrolling containers are not supported.
+- Clipboard integration is app-owned: read `useTextSelection().text` and apply your own copy policy.
+
 ## API
 
 #### render(tree, options?)