@inhuman.tools/quickdraw 0.0.0-bootstrap.0 → 0.2.0

package/dist/layout/selection.js

@@ -0,0 +1,312 @@
+/**
+ * Selection state model — buffer-cell-space ranges with granularity.
+ *
+ * State lives renderer/main-side (the buffer owner). The host wires mouse
+ * gestures (Phase 1d) and keyboard selection into transitions on this type;
+ * paint (Phase 1c) reads it to mark cells `selected`.
+ *
+ * Two cooperating concepts:
+ *
+ *  1. GLOBAL state (this module): anchor/active cells + granularity. Knows
+ *     "this cell is fully inside the selection range" — the cheap, geometry-
+ *     only membership test. Does NOT know what text a cell renders.
+ *
+ *  2. COMPONENT-delegated serialization (Phase 2b): each widget declares how
+ *     its cells map back to semantic content (markdown source, diff text,
+ *     code). The global layer asks "is this cell selected?" and the component
+ *     answers "what text does it produce?"
+ *
+ * Geometry law (the bifunctor):
+ *  - `"char"` / `"word"` — **stream** range in document order (row-major).
+ *    Multi-line: first row from start.col→EOL, middle rows full width, last
+ *    row SOL→end.col. Same model every terminal/editor uses for drag-select.
+ *  - `"line"` — full row width for every row in the vertical span.
+ *  - `"rect"` — axis-aligned column block (Alt+drag / tmux rectangle).
+ *  - `"structural"` — bounding box of a LayoutNode (refined by component).
+ *
+ * Cell coordinates are 0-indexed buffer cells (matching `elementAt`'s
+ * internal rect math after the 1-based SGR subtraction).
+ */
+/** Clamp a cell into a rect (inclusive). */
+export function clampCell(cell, rect) {
+    const maxC = rect.x + Math.max(1, rect.w) - 1;
+    const maxR = rect.y + Math.max(1, rect.h) - 1;
+    return {
+        col: Math.min(maxC, Math.max(rect.x, cell.col)),
+        row: Math.min(maxR, Math.max(rect.y, cell.row)),
+    };
+}
+/** Clip an inclusive column range to contain on this row; null if row outside. */
+function clipRangeToContain(range, row, contain) {
+    if (!contain)
+        return range;
+    if (row < contain.y || row >= contain.y + contain.h)
+        return null;
+    const c0 = contain.x;
+    const c1 = contain.x + contain.w - 1;
+    const start = Math.max(range[0], c0);
+    const end = Math.min(range[1], c1);
+    if (end < start)
+        return null;
+    return [start, end];
+}
+/**
+ * Start a new selection at a cell. Anchor and active both start at the cell;
+ * a subsequent drag/extend moves `active`. When `contain` is set, the cell is
+ * clamped into that rect and the confinement rides on the state.
+ */
+export function startSelection(cell, granularity = "char", anchorKey, contain) {
+    const c = contain ? clampCell(cell, contain) : cell;
+    return { anchor: c, active: c, granularity, anchorKey, contain };
+}
+/** Move the active end (drag / shift-click extend / keyboard arrow). */
+export function extendSelection(sel, cell) {
+    if (!sel)
+        return null;
+    const c = sel.contain ? clampCell(cell, sel.contain) : cell;
+    return { ...sel, active: c };
+}
+/** Clear the selection. */
+export function clearSelection() {
+    return null;
+}
+/**
+ * True when anchor and active are the same cell (collapsed caret / click
+ * without drag). Copy-on-select hosts should skip OSC 52 for collapsed
+ * selections unless multi-click expanded the range.
+ */
+export function isCollapsed(sel) {
+    if (!sel)
+        return true;
+    return sel.anchor.col === sel.active.col && sel.anchor.row === sel.active.row;
+}
+/**
+ * True when the selection covers more than one cell under its geometry law.
+ * For `"line"` a single-row collapsed click still selects the full line, so
+ * this is true whenever granularity is line (or structural) even if collapsed.
+ */
+export function hasCopyableExtent(sel) {
+    if (!sel)
+        return false;
+    if (sel.granularity === "line" || sel.granularity === "structural")
+        return true;
+    if (sel.granularity === "word") {
+        // Word may be expanded (anchor ≠ active) or still collapsed pre-snap.
+        return !isCollapsed(sel);
+    }
+    return !isCollapsed(sel);
+}
+/** Document-order comparison: earlier row, then earlier col. */
+function docBefore(a, b) {
+    return a.row < b.row || (a.row === b.row && a.col < b.col);
+}
+/**
+ * Stream endpoints in document order (start ≤ end). Used by char/word geometry.
+ * Anchor/active may be in either drag direction.
+ */
+export function streamEndpoints(sel) {
+    if (docBefore(sel.active, sel.anchor)) {
+        return { start: sel.active, end: sel.anchor };
+    }
+    return { start: sel.anchor, end: sel.active };
+}
+/**
+ * Axis-aligned corners (min/max col and row independently). Correct for
+ * `"rect"`; for stream ranges this is only a loose envelope — use
+ * {@link rowRange} for exact per-row membership.
+ */
+function axisCorners(sel) {
+    return {
+        tl: {
+            col: Math.min(sel.anchor.col, sel.active.col),
+            row: Math.min(sel.anchor.row, sel.active.row),
+        },
+        br: {
+            col: Math.max(sel.anchor.col, sel.active.col),
+            row: Math.max(sel.anchor.row, sel.active.row),
+        },
+    };
+}
+/**
+ * Bounding rect envelope of the selection in buffer coordinates.
+ *
+ * For multi-line stream (`"char"`/`"word"`) and `"line"`, the envelope spans
+ * full row width when `rowWidth` is supplied — paint loops walk this rect and
+ * filter with {@link rowRange}. When `rowWidth` is omitted, multi-line
+ * stream uses a conservative full-width sentinel (caller should prefer
+ * providing width).
+ *
+ * For `"rect"` the envelope IS the selected region.
+ */
+export function selectionRect(sel, rowWidth = Number.MAX_SAFE_INTEGER) {
+    const w = Math.max(1, rowWidth);
+    // When confined, the envelope is at most the contain box (input never
+    // "selects" the rest of the terminal).
+    if (sel.contain) {
+        return { ...sel.contain };
+    }
+    if (sel.granularity === "rect" || sel.granularity === "structural") {
+        const { tl, br } = axisCorners(sel);
+        return {
+            x: tl.col,
+            y: tl.row,
+            w: br.col - tl.col + 1,
+            h: br.row - tl.row + 1,
+        };
+    }
+    if (sel.granularity === "line") {
+        const r0 = Math.min(sel.anchor.row, sel.active.row);
+        const r1 = Math.max(sel.anchor.row, sel.active.row);
+        return { x: 0, y: r0, w, h: r1 - r0 + 1 };
+    }
+    // char / word — stream envelope
+    const { start, end } = streamEndpoints(sel);
+    if (start.row === end.row) {
+        const c0 = Math.min(start.col, end.col);
+        const c1 = Math.max(start.col, end.col);
+        return { x: c0, y: start.row, w: c1 - c0 + 1, h: 1 };
+    }
+    // Multi-line stream spans full width (first line may start mid-row; last may
+    // end mid-row — rowRange filters the corners).
+    return { x: 0, y: start.row, w, h: end.row - start.row + 1 };
+}
+/**
+ * Column range selected on a given row, or `null` if the row is outside the
+ * selection. Returned range is **inclusive** on both ends: `[startCol, endCol]`.
+ *
+ * Geometry by granularity:
+ * - `"char"` / `"word"` — stream: first/middle/last row rules
+ * - `"line"` — full row `[0, rowWidth-1]`
+ * - `"rect"` / `"structural"` — axis box columns on every selected row
+ */
+export function rowRange(sel, row, rowWidth) {
+    if (rowWidth <= 0)
+        return null;
+    const lastCol = rowWidth - 1;
+    let range = null;
+    if (sel.granularity === "line") {
+        const r0 = Math.min(sel.anchor.row, sel.active.row);
+        const r1 = Math.max(sel.anchor.row, sel.active.row);
+        if (row < r0 || row > r1)
+            return null;
+        range = [0, lastCol];
+    }
+    else if (sel.granularity === "rect" || sel.granularity === "structural") {
+        const { tl, br } = axisCorners(sel);
+        if (row < tl.row || row > br.row)
+            return null;
+        range = [tl.col, br.col];
+    }
+    else {
+        // char / word — stream
+        const { start, end } = streamEndpoints(sel);
+        if (row < start.row || row > end.row)
+            return null;
+        if (start.row === end.row) {
+            range = [Math.min(start.col, end.col), Math.max(start.col, end.col)];
+        }
+        else if (row === start.row) {
+            range = [start.col, lastCol];
+        }
+        else if (row === end.row) {
+            range = [0, end.col];
+        }
+        else {
+            range = [0, lastCol];
+        }
+    }
+    return clipRangeToContain(range, row, sel.contain);
+}
+// ── Word bounds (for double-click snap) ─────────────────────────────────────
+/**
+ * Word character class for double-click selection. Letters, marks, numbers,
+ * underscore — the terminal/editor convergence set. Everything else is a
+ * separator (including whitespace and punctuation).
+ */
+function isWordChar(ch) {
+    if (!ch)
+        return false;
+    // First code point only (cell may hold a grapheme; we still classify by it).
+    const cp = ch.codePointAt(0);
+    if (cp === undefined)
+        return false;
+    // ASCII fast path
+    if ((cp >= 0x30 && cp <= 0x39) || // 0-9
+        (cp >= 0x41 && cp <= 0x5a) || // A-Z
+        (cp >= 0x61 && cp <= 0x7a) || // a-z
+        cp === 0x5f // _
+    ) {
+        return true;
+    }
+    // Unicode letters / marks / numbers (no full ICU; good enough for TUI copy).
+    try {
+        return /[\p{L}\p{M}\p{N}]/u.test(String.fromCodePoint(cp));
+    }
+    catch {
+        return false;
+    }
+}
+export function wordBoundsOnRow(cells, col) {
+    if (col < 0 || col >= cells.length)
+        return [Math.max(0, col), Math.max(0, col)];
+    const ch = cells[col] ?? "";
+    if (!isWordChar(ch))
+        return [col, col];
+    let start = col;
+    while (start > 0 && isWordChar(cells[start - 1] ?? ""))
+        start--;
+    let end = col;
+    while (end + 1 < cells.length && isWordChar(cells[end + 1] ?? ""))
+        end++;
+    return [start, end];
+}
+/**
+ * Expand a collapsed (or any) selection to the full word under `cell`.
+ * Sets anchor to word start and active to word end on that row.
+ */
+export function expandToWordAt(cell, getRowCells, anchorKey, contain) {
+    const c = contain ? clampCell(cell, contain) : cell;
+    const cells = getRowCells(c.row);
+    if (!cells || cells.length === 0) {
+        return startSelection(c, "word", anchorKey, contain);
+    }
+    let [a, b] = wordBoundsOnRow(cells, c.col);
+    // Word snap must not escape the input box.
+    if (contain) {
+        a = Math.max(a, contain.x);
+        b = Math.min(b, contain.x + contain.w - 1);
+    }
+    return {
+        anchor: { col: a, row: c.row },
+        active: { col: b, row: c.row },
+        granularity: "word",
+        anchorKey,
+        contain,
+    };
+}
+/**
+ * Expand to full line under `cell` (triple-click). Anchor at col 0, active at
+ * last content-ish col when `rowWidth` known; granularity `"line"` so
+ * {@link rowRange} already spans full width either way. With `contain`, the
+ * "line" is the input row only (cols of the box), never the whole terminal.
+ */
+export function expandToLineAt(cell, rowWidth, anchorKey, contain) {
+    if (contain) {
+        const row = clampCell(cell, contain).row;
+        return {
+            anchor: { col: contain.x, row },
+            active: { col: contain.x + contain.w - 1, row },
+            granularity: "line",
+            anchorKey,
+            contain,
+        };
+    }
+    const last = Math.max(0, rowWidth - 1);
+    return {
+        anchor: { col: 0, row: cell.row },
+        active: { col: last, row: cell.row },
+        granularity: "line",
+        anchorKey,
+    };
+}
+//# sourceMappingURL=selection.js.map

package/dist/layout/selection.js.map

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

package/dist/layout/selection_gesture.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Selection gesture state machine — mouse events → SelectionState transitions.
+ *
+ * Pure state, no I/O. The host wires decoded mouse events in and reads
+ * {@link GestureOutput} (a selection snapshot + optional edge-scroll signal)
+ * out for paint + autoscroll.
+ *
+ * Visible-selection law (terminal/editor convergence):
+ *   - A bare single click does **not** create a 1-cell selection. It only
+ *     records the press so a subsequent drag can start from that cell, and
+ *     clears any prior selection (click-to-dismiss).
+ *   - Selection appears on: drag past the press cell, double-click (word),
+ *     triple-click (line), Alt+drag (rect), or Shift+click extend.
+ *
+ * Containment (`userSelect: "contain"`, e.g. composer input):
+ *   - When the press lands inside a contain region, the selection is armed
+ *     with that rect. Every subsequent endpoint is clamped into it — drag
+ *     cannot leave the input (browser <textarea> model).
+ *
+ * Click-count grammar:
+ *   single   — arm a potential drag (no paint yet)
+ *   double   — word granularity + expand to word bounds (when getRowCells given)
+ *   triple   — line granularity + expand to full line (within contain if set)
+ *   quad+    — cycles back to char (structural walk is Phase 4)
+ *
+ * Modifiers:
+ *   Alt      — rectangular block granularity during a drag
+ *   Shift    — extend the existing selection from its anchor (shift+click)
+ */
+import { type Cell, type SelectionState } from "./selection.js";
+import type { Rect } from "./types.js";
+export type ContainRegion = {
+    key: string;
+    rect: Rect;
+};
+export type GestureEvent = {
+    kind: "press" | "release" | "drag";
+    /** 0-indexed buffer cell (caller subtracts the SGR 1-base). */
+    col: number;
+    row: number;
+    /** Event timestamp in ms (for multi-click windowing). */
+    tMs: number;
+    shift?: boolean;
+    alt?: boolean;
+    ctrl?: boolean;
+    meta?: boolean;
+    /** Optional LayoutNode key under the pointer (host hit-tests). */
+    key?: string;
+};
+export type GestureOutput = {
+    selection: SelectionState | null;
+    /**
+     * Edge-scroll signal during a drag. `undefined` when the drag is inside the
+     * viewport. The host drives the actual scroll interval; this just flags
+     * direction + that autoscroll is needed.
+     */
+    scroll?: "up" | "down";
+    /**
+     * True when this event completed a gesture that should copy-on-select
+     * (release with a real extent). Hosts can also call `hasCopyableExtent`.
+     */
+    copyReady?: boolean;
+};
+export type GestureMachineOpts = {
+    /** Viewport height in rows — for drag-to-edge-scroll detection. */
+    viewportH?: number;
+    /** Viewport width in cols — for triple-click line expand (non-contain). */
+    viewportW?: number;
+    /**
+     * Optional row text accessor for double-click word snap. Return one row of
+     * cell `ch` strings (index = column). When omitted, word granularity is set
+     * but a collapsed word is discarded on release (same as bare click).
+     */
+    getRowCells?: (row: number) => readonly string[] | null | undefined;
+    /**
+     * Resolve `userSelect: "contain"` region at a cell (composer body, etc.).
+     * When non-null, the gesture arms confinement for the whole drag.
+     */
+    containAt?: (cell: Cell) => ContainRegion | null;
+};
+export declare function createGestureMachine(opts?: GestureMachineOpts): {
+    handle: (ev: GestureEvent) => GestureOutput;
+    clear: () => SelectionState | null;
+    selection: () => SelectionState | null;
+    /** Update viewport dims without rebuilding (resize). */
+    setViewport: (w: number, h: number) => void;
+};
+//# sourceMappingURL=selection_gesture.d.ts.map

package/dist/layout/selection_gesture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection_gesture.d.ts","sourceRoot":"","sources":["../../src/layout/selection_gesture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAOL,KAAK,IAAI,EAET,KAAK,cAAc,EACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAOvC,MAAM,MAAM,aAAa,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,CAAC;AAExD,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACnC,+DAA+D;IAC/D,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,yDAAyD;IACzD,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,kEAAkE;IAClE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,EAAE,cAAc,GAAG,IAAI,CAAC;IACjC;;;;OAIG;IACH,MAAM,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IACvB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,SAAS,MAAM,EAAE,GAAG,IAAI,GAAG,SAAS,CAAC;IACpE;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,aAAa,GAAG,IAAI,CAAC;CAClD,CAAC;AAgCF,wBAAgB,oBAAoB,CAAC,IAAI,GAAE,kBAAuB,GAAG;IACnE,MAAM,EAAE,CAAC,EAAE,EAAE,YAAY,KAAK,aAAa,CAAC;IAC5C,KAAK,EAAE,MAAM,cAAc,GAAG,IAAI,CAAC;IACnC,SAAS,EAAE,MAAM,cAAc,GAAG,IAAI,CAAC;IACvC,wDAAwD;IACxD,WAAW,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7C,CAwNA"}

package/dist/layout/selection_gesture.js

@@ -0,0 +1,239 @@
+/**
+ * Selection gesture state machine — mouse events → SelectionState transitions.
+ *
+ * Pure state, no I/O. The host wires decoded mouse events in and reads
+ * {@link GestureOutput} (a selection snapshot + optional edge-scroll signal)
+ * out for paint + autoscroll.
+ *
+ * Visible-selection law (terminal/editor convergence):
+ *   - A bare single click does **not** create a 1-cell selection. It only
+ *     records the press so a subsequent drag can start from that cell, and
+ *     clears any prior selection (click-to-dismiss).
+ *   - Selection appears on: drag past the press cell, double-click (word),
+ *     triple-click (line), Alt+drag (rect), or Shift+click extend.
+ *
+ * Containment (`userSelect: "contain"`, e.g. composer input):
+ *   - When the press lands inside a contain region, the selection is armed
+ *     with that rect. Every subsequent endpoint is clamped into it — drag
+ *     cannot leave the input (browser <textarea> model).
+ *
+ * Click-count grammar:
+ *   single   — arm a potential drag (no paint yet)
+ *   double   — word granularity + expand to word bounds (when getRowCells given)
+ *   triple   — line granularity + expand to full line (within contain if set)
+ *   quad+    — cycles back to char (structural walk is Phase 4)
+ *
+ * Modifiers:
+ *   Alt      — rectangular block granularity during a drag
+ *   Shift    — extend the existing selection from its anchor (shift+click)
+ */
+import { clampCell, expandToLineAt, expandToWordAt, extendSelection, clearSelection, startSelection, } from "./selection.js";
+/** Multi-click window in milliseconds (browser convention). */
+const MULTI_CLICK_MS = 500;
+/** Movement tolerance in cells — exceed this and it's a drag, not a click. */
+const MOVE_TOLERANCE = 5;
+/**
+ * Should this selection paint / copy? Collapsed char (and collapsed word
+ * without snap) is not a selection — it's a caret arm or a failed expand.
+ */
+function hasVisibleExtent(sel) {
+    if (!sel)
+        return false;
+    if (sel.granularity === "line" || sel.granularity === "structural")
+        return true;
+    return sel.anchor.col !== sel.active.col || sel.anchor.row !== sel.active.row;
+}
+export function createGestureMachine(opts = {}) {
+    let viewportH = opts.viewportH;
+    let viewportW = opts.viewportW;
+    const getRowCells = opts.getRowCells;
+    const containAt = opts.containAt;
+    const st = {
+        sel: null,
+        lastPressCell: null,
+        lastPressKey: undefined,
+        contain: undefined,
+        lastPressMs: -Infinity,
+        clickCount: 0,
+        dragging: false,
+        armedGranularity: "char",
+        movedOrExpanded: false,
+    };
+    function clickCountToGranularity(count) {
+        if (count >= 4)
+            return "char";
+        return ["char", "word", "line"][Math.min(count, 3) - 1];
+    }
+    function sameCell(a, b) {
+        return a.col === b.col && a.row === b.row;
+    }
+    function manhattan(a, b) {
+        return Math.abs(a.col - b.col) + Math.abs(a.row - b.row);
+    }
+    function edgeScroll(row) {
+        // Contained drags never autoscroll the outer viewport off the input.
+        if (st.contain)
+            return undefined;
+        if (viewportH === undefined)
+            return undefined;
+        if (row < 0)
+            return "up";
+        if (row >= viewportH)
+            return "down";
+        return undefined;
+    }
+    function clamp(cell) {
+        return st.contain ? clampCell(cell, st.contain) : cell;
+    }
+    /**
+     * Is the cell inside the armed contain rect (inclusive)? A pointer off the
+     * box is not over the input's content, so its cell carries no position —
+     * the endpoint stays at the last in-box cell instead.
+     */
+    function inContain(cell) {
+        const r = st.contain;
+        if (!r)
+            return true;
+        const maxC = r.x + Math.max(1, r.w) - 1;
+        const maxR = r.y + Math.max(1, r.h) - 1;
+        return cell.col >= r.x && cell.col <= maxC && cell.row >= r.y && cell.row <= maxR;
+    }
+    function armContain(cell, evKey) {
+        const region = containAt?.(cell) ?? null;
+        st.contain = region?.rect;
+        st.lastPressKey = region?.key ?? evKey;
+        return clamp(cell);
+    }
+    /** Materialize a selection at press for multi-click / Alt; char stays armed only. */
+    function materializeAtPress(cell, gran) {
+        const key = st.lastPressKey;
+        const contain = st.contain;
+        if (gran === "word") {
+            if (getRowCells) {
+                st.movedOrExpanded = true;
+                return expandToWordAt(cell, getRowCells, key, contain);
+            }
+            return null;
+        }
+        if (gran === "line") {
+            st.movedOrExpanded = true;
+            return expandToLineAt(cell, viewportW ?? 1, key, contain);
+        }
+        if (gran === "rect") {
+            return null;
+        }
+        return null;
+    }
+    function handle(ev) {
+        if (ev.kind === "press") {
+            // Shift+click extends the existing selection from its anchor.
+            // Clamp into the existing contain (if any); do not re-arm from the new cell.
+            if (ev.shift && st.sel && hasVisibleExtent(st.sel)) {
+                st.contain = st.sel.contain;
+                const cell = clamp({ col: ev.col, row: ev.row });
+                st.sel = extendSelection(st.sel, cell);
+                st.dragging = true;
+                st.movedOrExpanded = true;
+                st.lastPressCell = cell;
+                st.lastPressMs = ev.tMs;
+                return { selection: st.sel };
+            }
+            const raw = { col: ev.col, row: ev.row };
+            // Multi-click detection uses the raw press cell (pre-clamp) so double-click
+            // still matches the same physical click target.
+            const withinWindow = ev.tMs - st.lastPressMs <= MULTI_CLICK_MS;
+            const sameSpot = st.lastPressCell !== null && sameCell(st.lastPressCell, clamp(raw));
+            // For multi-click, re-use prior contain if same spot; else arm fresh.
+            const cell = withinWindow && sameSpot && st.contain ? clamp(raw) : armContain(raw, ev.key);
+            st.clickCount = withinWindow && sameSpot ? st.clickCount + 1 : 1;
+            st.lastPressCell = cell;
+            st.lastPressMs = ev.tMs;
+            const granularity = clickCountToGranularity(st.clickCount);
+            const gran = ev.alt ? "rect" : granularity;
+            st.armedGranularity = gran;
+            st.movedOrExpanded = false;
+            st.dragging = true;
+            // Clear any prior selection at gesture START (press), not release.
+            // materializeAtPress returns null for bare char (armed only); word/line
+            // replace the old range immediately. Hosts recolor from this return.
+            st.sel = materializeAtPress(cell, gran);
+            return { selection: hasVisibleExtent(st.sel) ? st.sel : null };
+        }
+        if (ev.kind === "drag") {
+            const raw = { col: ev.col, row: ev.row };
+            // Containment clamps the endpoint into the input, so a pointer *off* the
+            // box still projects onto it — that projection can land on the anchor
+            // and erase a range the drag already established (pointer drifting above
+            // a single-row input in the anchor's column). An off-box cell carries no
+            // real position then; keep the endpoint the drag last set.
+            const clamped = clamp(raw);
+            const offBox = !inContain(raw);
+            const cell = offBox && st.sel !== null && sameCell(clamped, st.sel.anchor) ? st.sel.active : clamped;
+            if (st.clickCount > 1 && st.lastPressCell && manhattan(st.lastPressCell, cell) > MOVE_TOLERANCE) {
+                st.clickCount = 1;
+                st.armedGranularity = "char";
+                st.sel = startSelection(st.lastPressCell, "char", st.lastPressKey, st.contain);
+                st.movedOrExpanded = !sameCell(st.lastPressCell, cell);
+            }
+            const gran = st.armedGranularity === "rect" ? "rect" : (st.sel?.granularity ?? st.armedGranularity);
+            if (!st.sel) {
+                const origin = st.lastPressCell ?? cell;
+                st.sel = startSelection(origin, gran, st.lastPressKey, st.contain);
+            }
+            if (!sameCell(st.sel.active, cell))
+                st.movedOrExpanded = true;
+            st.sel = extendSelection({ ...st.sel, granularity: gran }, cell);
+            if (!hasVisibleExtent(st.sel)) {
+                return {
+                    selection: null,
+                    scroll: edgeScroll(ev.row),
+                };
+            }
+            return { selection: st.sel, scroll: edgeScroll(ev.row) };
+        }
+        if (ev.kind === "release") {
+            st.dragging = false;
+            const raw = { col: ev.col, row: ev.row };
+            const clamped = clamp(raw);
+            // Same law as drag: a release off the box projects onto the input, and
+            // that projection must not collapse the range at button-up — the drag
+            // already established the extent the host commits as the draft mark.
+            const cell = !inContain(raw) && st.sel !== null && sameCell(clamped, st.sel.anchor) ? st.sel.active : clamped;
+            if (st.sel && hasVisibleExtent(st.sel) && st.clickCount <= 1 && !sameCell(st.sel.active, cell)) {
+                st.sel = extendSelection(st.sel, cell);
+                st.movedOrExpanded = true;
+            }
+            if (!hasVisibleExtent(st.sel)) {
+                st.sel = null;
+                st.movedOrExpanded = false;
+                st.armedGranularity = "char";
+                st.contain = undefined;
+                return { selection: null, copyReady: false };
+            }
+            const copyReady = st.movedOrExpanded || hasVisibleExtent(st.sel);
+            st.armedGranularity = "char";
+            return { selection: st.sel, copyReady };
+        }
+        return { selection: hasVisibleExtent(st.sel) ? st.sel : null };
+    }
+    function clear() {
+        st.sel = clearSelection();
+        st.clickCount = 0;
+        st.lastPressCell = null;
+        st.lastPressKey = undefined;
+        st.contain = undefined;
+        st.dragging = false;
+        st.movedOrExpanded = false;
+        st.armedGranularity = "char";
+        return st.sel;
+    }
+    function selection() {
+        return hasVisibleExtent(st.sel) ? st.sel : null;
+    }
+    function setViewport(w, h) {
+        viewportW = w;
+        viewportH = h;
+    }
+    return { handle, clear, selection, setViewport };
+}
+//# sourceMappingURL=selection_gesture.js.map