@bsuite/data-grid 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @bsuite/data-grid — main entry.
+ *
+ * A virtualized, spreadsheet-feel data grid: row + column virtualization
+ * (@tanstack/react-virtual), sorting/column order/sizing
+ * (@tanstack/react-table), cell-range selection, keyboard grid navigation,
+ * a TSV clipboard round-trip, a fill handle, and an undo/redo stack.
+ *
+ * No consumer app is wired to this package yet — it ships standalone.
+ * Import the pure logic (TSV, selection maths, fill maths, undo stack,
+ * keyboard maths, clipboard glue) independently via `@bsuite/data-grid/lib`
+ * if a host only needs the non-React pieces.
+ */
+export { DataGrid } from './DataGrid.js';
+export { TextEditor, NumberEditor, DateEditor, BooleanEditor, SelectEditor, } from './editors/index.js';
+export { formatCellValue, parseCellValue } from './formatting.js';
+export { cn } from './cn.js';
+export type { ColumnDataType, SelectOption, CellEditorProps, CellRendererProps, DataGridColumn, CellEdit, DataGridErrorPhase, DataGridError, DataGridHandle, DataGridProps, } from './types.js';
+export type { CellPosition, CellRange } from './lib/selection.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EACL,UAAU,EACV,YAAY,EACZ,UAAU,EACV,aAAa,EACb,YAAY,GACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAE7B,YAAY,EACV,cAAc,EACd,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,QAAQ,EACR,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,aAAa,GACd,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+/**
+ * @bsuite/data-grid — main entry.
+ *
+ * A virtualized, spreadsheet-feel data grid: row + column virtualization
+ * (@tanstack/react-virtual), sorting/column order/sizing
+ * (@tanstack/react-table), cell-range selection, keyboard grid navigation,
+ * a TSV clipboard round-trip, a fill handle, and an undo/redo stack.
+ *
+ * No consumer app is wired to this package yet — it ships standalone.
+ * Import the pure logic (TSV, selection maths, fill maths, undo stack,
+ * keyboard maths, clipboard glue) independently via `@bsuite/data-grid/lib`
+ * if a host only needs the non-React pieces.
+ */
+export { DataGrid } from './DataGrid.js';
+export { TextEditor, NumberEditor, DateEditor, BooleanEditor, SelectEditor, } from './editors/index.js';
+export { formatCellValue, parseCellValue } from './formatting.js';
+export { cn } from './cn.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EACL,UAAU,EACV,YAAY,EACZ,UAAU,EACV,aAAa,EACb,YAAY,GACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC"}

package/dist/lib/clipboard.d.ts

@@ -0,0 +1,28 @@
+import type { CellPosition, CellRange } from './selection.js';
+export interface ClipboardBounds {
+    maxRow: number;
+    maxCol: number;
+}
+/** Build the TSV text for a copy of `range`, using `getCellText` to render
+ * each cell's display value. Row-major, matching how a real spreadsheet
+ * serializes a selection. */
+export declare function buildCopyText(range: CellRange, getCellText: (pos: CellPosition) => string): string;
+export interface PasteEdit {
+    row: number;
+    col: number;
+    value: string;
+}
+/**
+ * Parse pasted TSV text anchored at `anchor`, clipped to the grid bounds.
+ * A paste that would run off the bottom/right edge of the grid is
+ * truncated rather than throwing — matches Excel/Sheets, which silently
+ * drop the overflow instead of erroring or resizing the sheet.
+ */
+export declare function buildPasteEdits(tsvText: string, anchor: CellPosition, bounds: ClipboardBounds): PasteEdit[];
+/**
+ * Excel/Sheets semantics: pasting a SINGLE copied cell onto a multi-cell
+ * selection repeats that value across the whole selection, rather than only
+ * landing on the anchor cell.
+ */
+export declare function expandSingleCellPasteToSelection(edits: PasteEdit[], selection: CellRange | undefined): PasteEdit[];
+//# sourceMappingURL=clipboard.d.ts.map

package/dist/lib/clipboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.d.ts","sourceRoot":"","sources":["../../src/lib/clipboard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG9D,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;6BAE6B;AAC7B,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,MAAM,GAAG,MAAM,CAUlG;AAED,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,eAAe,GAAG,SAAS,EAAE,CAc3G;AAED;;;;GAIG;AACH,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,SAAS,EAAE,EAClB,SAAS,EAAE,SAAS,GAAG,SAAS,GAC/B,SAAS,EAAE,CAKb"}

package/dist/lib/clipboard.js

@@ -0,0 +1,53 @@
+import { parseTsv, serializeTsv } from './tsv.js';
+import { rangeColCount, rangeRowCount, rangeToCells } from './selection.js';
+/** Build the TSV text for a copy of `range`, using `getCellText` to render
+ * each cell's display value. Row-major, matching how a real spreadsheet
+ * serializes a selection. */
+export function buildCopyText(range, getCellText) {
+    const rows = [];
+    for (let r = range.startRow; r <= range.endRow; r += 1) {
+        const row = [];
+        for (let c = range.startCol; c <= range.endCol; c += 1) {
+            row.push(getCellText({ row: r, col: c }));
+        }
+        rows.push(row);
+    }
+    return serializeTsv(rows);
+}
+/**
+ * Parse pasted TSV text anchored at `anchor`, clipped to the grid bounds.
+ * A paste that would run off the bottom/right edge of the grid is
+ * truncated rather than throwing — matches Excel/Sheets, which silently
+ * drop the overflow instead of erroring or resizing the sheet.
+ */
+export function buildPasteEdits(tsvText, anchor, bounds) {
+    const grid = parseTsv(tsvText);
+    const edits = [];
+    for (let r = 0; r < grid.length; r += 1) {
+        const targetRow = anchor.row + r;
+        if (targetRow < 0 || targetRow > bounds.maxRow)
+            continue;
+        const rowValues = grid[r];
+        for (let c = 0; c < rowValues.length; c += 1) {
+            const targetCol = anchor.col + c;
+            if (targetCol < 0 || targetCol > bounds.maxCol)
+                continue;
+            edits.push({ row: targetRow, col: targetCol, value: rowValues[c] });
+        }
+    }
+    return edits;
+}
+/**
+ * Excel/Sheets semantics: pasting a SINGLE copied cell onto a multi-cell
+ * selection repeats that value across the whole selection, rather than only
+ * landing on the anchor cell.
+ */
+export function expandSingleCellPasteToSelection(edits, selection) {
+    if (!selection || edits.length !== 1)
+        return edits;
+    if (rangeRowCount(selection) <= 1 && rangeColCount(selection) <= 1)
+        return edits;
+    const { value } = edits[0];
+    return rangeToCells(selection).map((pos) => ({ row: pos.row, col: pos.col, value }));
+}
+//# sourceMappingURL=clipboard.js.map

package/dist/lib/clipboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.js","sourceRoot":"","sources":["../../src/lib/clipboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAElD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAO5E;;6BAE6B;AAC7B,MAAM,UAAU,aAAa,CAAC,KAAgB,EAAE,WAA0C;IACxF,MAAM,IAAI,GAAe,EAAE,CAAC;IAC5B,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACvD,MAAM,GAAG,GAAa,EAAE,CAAC;QACzB,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YACvD,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5C,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAQD;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,MAAoB,EAAE,MAAuB;IAC5F,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAgB,EAAE,CAAC;IAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC;QACjC,IAAI,SAAS,GAAG,CAAC,IAAI,SAAS,GAAG,MAAM,CAAC,MAAM;YAAE,SAAS;QACzD,MAAM,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7C,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC;YACjC,IAAI,SAAS,GAAG,CAAC,IAAI,SAAS,GAAG,MAAM,CAAC,MAAM;gBAAE,SAAS;YACzD,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gCAAgC,CAC9C,KAAkB,EAClB,SAAgC;IAEhC,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACnD,IAAI,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACjF,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3B,OAAO,YAAY,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;AACvF,CAAC"}

package/dist/lib/fill.d.ts

@@ -0,0 +1,35 @@
+import type { CellPosition, CellRange } from './selection.js';
+export type FillDirection = 'down' | 'up' | 'left' | 'right' | 'none';
+export interface FillResult {
+    /** The full range after the fill (source ∪ newly-filled cells). */
+    range: CellRange;
+    direction: FillDirection;
+    /** Cells newly covered by the fill — excludes the original source range. */
+    filledCells: CellPosition[];
+}
+/**
+ * Excel's fill handle only ever extends along ONE axis, even when the
+ * pointer moves diagonally — it picks whichever direction moved furthest
+ * past the source range's edge. Dragging back inside the source range (or
+ * not past any edge) is a no-op.
+ */
+export declare function computeFillRange(source: CellRange, dragTo: CellPosition): FillResult;
+/**
+ * Maps a newly-filled cell back to the source cell whose value it should
+ * copy, cycling through the source range's rows (for vertical fills) or
+ * columns (for horizontal fills) — the same "repeat the pattern" behaviour
+ * Excel uses for a plain (non-series) fill.
+ */
+export declare function mapFillTargetToSource(target: CellPosition, source: CellRange, direction: FillDirection): CellPosition;
+/**
+ * Double-click-fill-down: Excel extends the fill down to match the extent of
+ * contiguous data in an adjacent column. `adjacentColHasValue` answers "does
+ * the adjacent column have a non-empty value at this row" for each row
+ * below `startRow`; the extent stops at the first gap or `maxRow`.
+ */
+export declare function computeFillDownExtent(params: {
+    startRow: number;
+    maxRow: number;
+    adjacentColHasValue: (row: number) => boolean;
+}): number;
+//# sourceMappingURL=fill.d.ts.map

package/dist/lib/fill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fill.d.ts","sourceRoot":"","sources":["../../src/lib/fill.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG9D,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAEtE,MAAM,WAAW,UAAU;IACzB,mEAAmE;IACnE,KAAK,EAAE,SAAS,CAAC;IACjB,SAAS,EAAE,aAAa,CAAC;IACzB,4EAA4E;IAC5E,WAAW,EAAE,YAAY,EAAE,CAAC;CAC7B;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,UAAU,CAoCpF;AAMD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,aAAa,GACvB,YAAY,CAYd;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;CAC/C,GAAG,MAAM,CAOT"}

package/dist/lib/fill.js

@@ -0,0 +1,76 @@
+import { isCellInRange, rangeColCount, rangeRowCount, rangeToCells } from './selection.js';
+/**
+ * Excel's fill handle only ever extends along ONE axis, even when the
+ * pointer moves diagonally — it picks whichever direction moved furthest
+ * past the source range's edge. Dragging back inside the source range (or
+ * not past any edge) is a no-op.
+ */
+export function computeFillRange(source, dragTo) {
+    const allCandidates = [
+        { dir: 'down', amount: dragTo.row - source.endRow },
+        { dir: 'up', amount: source.startRow - dragTo.row },
+        { dir: 'right', amount: dragTo.col - source.endCol },
+        { dir: 'left', amount: source.startCol - dragTo.col },
+    ];
+    const candidates = allCandidates.filter((c) => c.amount > 0);
+    if (candidates.length === 0) {
+        return { range: source, direction: 'none', filledCells: [] };
+    }
+    candidates.sort((a, b) => b.amount - a.amount);
+    const winner = candidates[0];
+    let range;
+    switch (winner.dir) {
+        case 'down':
+            range = { ...source, endRow: source.endRow + winner.amount };
+            break;
+        case 'up':
+            range = { ...source, startRow: source.startRow - winner.amount };
+            break;
+        case 'right':
+            range = { ...source, endCol: source.endCol + winner.amount };
+            break;
+        case 'left':
+            range = { ...source, startCol: source.startCol - winner.amount };
+            break;
+        default:
+            range = source;
+    }
+    const filledCells = rangeToCells(range).filter((cell) => !isCellInRange(cell, source));
+    return { range, direction: winner.dir, filledCells };
+}
+function wrapIndex(offset, period) {
+    return ((offset % period) + period) % period;
+}
+/**
+ * Maps a newly-filled cell back to the source cell whose value it should
+ * copy, cycling through the source range's rows (for vertical fills) or
+ * columns (for horizontal fills) — the same "repeat the pattern" behaviour
+ * Excel uses for a plain (non-series) fill.
+ */
+export function mapFillTargetToSource(target, source, direction) {
+    if (direction === 'none')
+        return target;
+    if (direction === 'down' || direction === 'up') {
+        const rowCount = rangeRowCount(source);
+        const rowOffset = wrapIndex(target.row - source.startRow, rowCount);
+        return { row: source.startRow + rowOffset, col: target.col };
+    }
+    const colCount = rangeColCount(source);
+    const colOffset = wrapIndex(target.col - source.startCol, colCount);
+    return { row: target.row, col: source.startCol + colOffset };
+}
+/**
+ * Double-click-fill-down: Excel extends the fill down to match the extent of
+ * contiguous data in an adjacent column. `adjacentColHasValue` answers "does
+ * the adjacent column have a non-empty value at this row" for each row
+ * below `startRow`; the extent stops at the first gap or `maxRow`.
+ */
+export function computeFillDownExtent(params) {
+    const { startRow, maxRow, adjacentColHasValue } = params;
+    let row = startRow;
+    while (row + 1 <= maxRow && adjacentColHasValue(row + 1)) {
+        row += 1;
+    }
+    return row;
+}
+//# sourceMappingURL=fill.js.map

package/dist/lib/fill.js.map

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

package/dist/lib/index.d.ts

@@ -0,0 +1,7 @@
+export { needsQuoting, quoteCell, serializeTsv, parseTsv } from './tsv.js';
+export { normalizeRange, clampRange, isCellInRange, rangeRowCount, rangeColCount, rangeToCells, rangesEqual, singleCellRange, isSingleCell, type CellPosition, type CellRange, } from './selection.js';
+export { computeFillRange, mapFillTargetToSource, computeFillDownExtent, type FillDirection, type FillResult, } from './fill.js';
+export { UndoStack, type UndoEntry } from './undo.js';
+export { moveFocus, moveTab, moveEnter, isPrintableEditTrigger, type ArrowKey, type GridBounds, type MoveOptions, } from './keyboard.js';
+export { buildCopyText, buildPasteEdits, expandSingleCellPasteToSelection, type ClipboardBounds, type PasteEdit, } from './clipboard.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC3E,OAAO,EACL,cAAc,EACd,UAAU,EACV,aAAa,EACb,aAAa,EACb,aAAa,EACb,YAAY,EACZ,WAAW,EACX,eAAe,EACf,YAAY,EACZ,KAAK,YAAY,EACjB,KAAK,SAAS,GACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACrB,KAAK,aAAa,EAClB,KAAK,UAAU,GAChB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EACL,SAAS,EACT,OAAO,EACP,SAAS,EACT,sBAAsB,EACtB,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,WAAW,GACjB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,aAAa,EACb,eAAe,EACf,gCAAgC,EAChC,KAAK,eAAe,EACpB,KAAK,SAAS,GACf,MAAM,gBAAgB,CAAC"}

package/dist/lib/index.js

@@ -0,0 +1,7 @@
+export { needsQuoting, quoteCell, serializeTsv, parseTsv } from './tsv.js';
+export { normalizeRange, clampRange, isCellInRange, rangeRowCount, rangeColCount, rangeToCells, rangesEqual, singleCellRange, isSingleCell, } from './selection.js';
+export { computeFillRange, mapFillTargetToSource, computeFillDownExtent, } from './fill.js';
+export { UndoStack } from './undo.js';
+export { moveFocus, moveTab, moveEnter, isPrintableEditTrigger, } from './keyboard.js';
+export { buildCopyText, buildPasteEdits, expandSingleCellPasteToSelection, } from './clipboard.js';
+//# sourceMappingURL=index.js.map

package/dist/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC3E,OAAO,EACL,cAAc,EACd,UAAU,EACV,aAAa,EACb,aAAa,EACb,aAAa,EACb,YAAY,EACZ,WAAW,EACX,eAAe,EACf,YAAY,GAGb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,GAGtB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,SAAS,EAAkB,MAAM,WAAW,CAAC;AACtD,OAAO,EACL,SAAS,EACT,OAAO,EACP,SAAS,EACT,sBAAsB,GAIvB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,aAAa,EACb,eAAe,EACf,gCAAgC,GAGjC,MAAM,gBAAgB,CAAC"}

package/dist/lib/keyboard.d.ts

@@ -0,0 +1,40 @@
+import type { CellPosition } from './selection.js';
+export interface GridBounds {
+    minRow: number;
+    maxRow: number;
+    minCol: number;
+    maxCol: number;
+}
+export type ArrowKey = 'ArrowUp' | 'ArrowDown' | 'ArrowLeft' | 'ArrowRight';
+export interface MoveOptions {
+    /** Ctrl (Windows/Linux) or Cmd (macOS) held — jump to the edge of a
+     * contiguous data region instead of moving one cell. */
+    ctrlOrCmd?: boolean;
+    /** Predicate for "this cell has no value" — drives the Ctrl+Arrow jump.
+     * Defaults to "never empty", which degrades Ctrl+Arrow to "jump to the
+     * grid edge" when the host doesn't supply data-awareness. */
+    isEmpty?: (pos: CellPosition) => boolean;
+}
+/**
+ * Plain arrow: move one cell, clamped to bounds.
+ * Ctrl/Cmd+arrow: jump to the edge of contiguous data, Excel-style —
+ *  - if the adjacent cell is empty, advance through empty cells and land on
+ *    the first non-empty cell found (or the grid edge if there is none)
+ *  - if the adjacent cell is non-empty, advance while cells stay non-empty
+ *    and land on the last non-empty cell before a gap (or the grid edge)
+ */
+export declare function moveFocus(current: CellPosition, key: ArrowKey, bounds: GridBounds, options?: MoveOptions): CellPosition;
+/** Tab moves right and wraps to the next row's first column; Shift+Tab
+ * moves left and wraps to the previous row's last column. */
+export declare function moveTab(current: CellPosition, bounds: GridBounds, shift: boolean): CellPosition;
+/** Enter moves down a row (same column); Shift+Enter moves up. */
+export declare function moveEnter(current: CellPosition, bounds: GridBounds, shift: boolean): CellPosition;
+/** True for a single, non-modified printable character — the trigger for
+ * "typing over a focused cell starts editing" (Excel/Sheets semantics). */
+export declare function isPrintableEditTrigger(e: {
+    key: string;
+    ctrlKey?: boolean;
+    metaKey?: boolean;
+    altKey?: boolean;
+}): boolean;
+//# sourceMappingURL=keyboard.d.ts.map

package/dist/lib/keyboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard.d.ts","sourceRoot":"","sources":["../../src/lib/keyboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,GAAG,YAAY,CAAC;AAE5E,MAAM,WAAW,WAAW;IAC1B;4DACwD;IACxD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;iEAE6D;IAC7D,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC;CAC1C;AAyBD;;;;;;;GAOG;AACH,wBAAgB,SAAS,CACvB,OAAO,EAAE,YAAY,EACrB,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,UAAU,EAClB,OAAO,GAAE,WAAgB,GACxB,YAAY,CA+Bd;AAED;6DAC6D;AAC7D,wBAAgB,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,GAAG,YAAY,CAS/F;AAED,kEAAkE;AAClE,wBAAgB,SAAS,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,GAAG,YAAY,CAGjG;AAED;2EAC2E;AAC3E,wBAAgB,sBAAsB,CAAC,CAAC,EAAE;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GAAG,OAAO,CAGV"}

package/dist/lib/keyboard.js

@@ -0,0 +1,85 @@
+const DIRECTION = {
+    ArrowUp: { dRow: -1, dCol: 0 },
+    ArrowDown: { dRow: 1, dCol: 0 },
+    ArrowLeft: { dRow: 0, dCol: -1 },
+    ArrowRight: { dRow: 0, dCol: 1 },
+};
+function inBounds(pos, bounds) {
+    return (pos.row >= bounds.minRow &&
+        pos.row <= bounds.maxRow &&
+        pos.col >= bounds.minCol &&
+        pos.col <= bounds.maxCol);
+}
+function clampPosition(pos, bounds) {
+    return {
+        row: Math.max(bounds.minRow, Math.min(pos.row, bounds.maxRow)),
+        col: Math.max(bounds.minCol, Math.min(pos.col, bounds.maxCol)),
+    };
+}
+/**
+ * Plain arrow: move one cell, clamped to bounds.
+ * Ctrl/Cmd+arrow: jump to the edge of contiguous data, Excel-style —
+ *  - if the adjacent cell is empty, advance through empty cells and land on
+ *    the first non-empty cell found (or the grid edge if there is none)
+ *  - if the adjacent cell is non-empty, advance while cells stay non-empty
+ *    and land on the last non-empty cell before a gap (or the grid edge)
+ */
+export function moveFocus(current, key, bounds, options = {}) {
+    const { dRow, dCol } = DIRECTION[key];
+    const isEmpty = options.isEmpty ?? (() => false);
+    if (!options.ctrlOrCmd) {
+        return clampPosition({ row: current.row + dRow, col: current.col + dCol }, bounds);
+    }
+    const next = { row: current.row + dRow, col: current.col + dCol };
+    if (!inBounds(next, bounds))
+        return current;
+    if (isEmpty(next)) {
+        let pos = next;
+        let forward = { row: pos.row + dRow, col: pos.col + dCol };
+        while (inBounds(forward, bounds) && isEmpty(forward)) {
+            pos = forward;
+            forward = { row: pos.row + dRow, col: pos.col + dCol };
+        }
+        if (inBounds(forward, bounds) && !isEmpty(forward)) {
+            pos = forward;
+        }
+        return pos;
+    }
+    let pos = next;
+    for (;;) {
+        const forward = { row: pos.row + dRow, col: pos.col + dCol };
+        if (!inBounds(forward, bounds) || isEmpty(forward))
+            break;
+        pos = forward;
+    }
+    return pos;
+}
+/** Tab moves right and wraps to the next row's first column; Shift+Tab
+ * moves left and wraps to the previous row's last column. */
+export function moveTab(current, bounds, shift) {
+    if (!shift) {
+        if (current.col < bounds.maxCol)
+            return { row: current.row, col: current.col + 1 };
+        if (current.row < bounds.maxRow)
+            return { row: current.row + 1, col: bounds.minCol };
+        return current;
+    }
+    if (current.col > bounds.minCol)
+        return { row: current.row, col: current.col - 1 };
+    if (current.row > bounds.minRow)
+        return { row: current.row - 1, col: bounds.maxCol };
+    return current;
+}
+/** Enter moves down a row (same column); Shift+Enter moves up. */
+export function moveEnter(current, bounds, shift) {
+    const delta = shift ? -1 : 1;
+    return clampPosition({ row: current.row + delta, col: current.col }, bounds);
+}
+/** True for a single, non-modified printable character — the trigger for
+ * "typing over a focused cell starts editing" (Excel/Sheets semantics). */
+export function isPrintableEditTrigger(e) {
+    if (e.ctrlKey || e.metaKey || e.altKey)
+        return false;
+    return e.key.length === 1;
+}
+//# sourceMappingURL=keyboard.js.map

package/dist/lib/keyboard.js.map

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

package/dist/lib/selection.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Cell-range selection maths — pure, no DOM/React. A selection is tracked
+ * as an anchor (where the drag/shift-click started) + a focus (where the
+ * pointer/keyboard currently is); this module normalizes that pair into an
+ * ordered rectangle and answers containment/enumeration questions over it.
+ */
+export interface CellPosition {
+    row: number;
+    col: number;
+}
+export interface CellRange {
+    startRow: number;
+    endRow: number;
+    startCol: number;
+    endCol: number;
+}
+export declare function normalizeRange(anchor: CellPosition, focus: CellPosition): CellRange;
+export declare function clampRange(range: CellRange, maxRow: number, maxCol: number): CellRange;
+export declare function isCellInRange(pos: CellPosition, range: CellRange): boolean;
+export declare function rangeRowCount(range: CellRange): number;
+export declare function rangeColCount(range: CellRange): number;
+export declare function rangeToCells(range: CellRange): CellPosition[];
+export declare function rangesEqual(a: CellRange, b: CellRange): boolean;
+export declare function singleCellRange(pos: CellPosition): CellRange;
+export declare function isSingleCell(range: CellRange): boolean;
+//# sourceMappingURL=selection.d.ts.map

package/dist/lib/selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.d.ts","sourceRoot":"","sources":["../../src/lib/selection.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,GAAG,SAAS,CAOnF;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAQtF;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAO1E;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAEtD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAEtD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,YAAY,EAAE,CAQ7D;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,GAAG,OAAO,CAO/D;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,YAAY,GAAG,SAAS,CAE5D;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAEtD"}

package/dist/lib/selection.js

@@ -0,0 +1,57 @@
+/**
+ * Cell-range selection maths — pure, no DOM/React. A selection is tracked
+ * as an anchor (where the drag/shift-click started) + a focus (where the
+ * pointer/keyboard currently is); this module normalizes that pair into an
+ * ordered rectangle and answers containment/enumeration questions over it.
+ */
+export function normalizeRange(anchor, focus) {
+    return {
+        startRow: Math.min(anchor.row, focus.row),
+        endRow: Math.max(anchor.row, focus.row),
+        startCol: Math.min(anchor.col, focus.col),
+        endCol: Math.max(anchor.col, focus.col),
+    };
+}
+export function clampRange(range, maxRow, maxCol) {
+    const clamp = (v, max) => Math.max(0, Math.min(v, max));
+    return {
+        startRow: clamp(range.startRow, maxRow),
+        endRow: clamp(range.endRow, maxRow),
+        startCol: clamp(range.startCol, maxCol),
+        endCol: clamp(range.endCol, maxCol),
+    };
+}
+export function isCellInRange(pos, range) {
+    return (pos.row >= range.startRow &&
+        pos.row <= range.endRow &&
+        pos.col >= range.startCol &&
+        pos.col <= range.endCol);
+}
+export function rangeRowCount(range) {
+    return range.endRow - range.startRow + 1;
+}
+export function rangeColCount(range) {
+    return range.endCol - range.startCol + 1;
+}
+export function rangeToCells(range) {
+    const cells = [];
+    for (let r = range.startRow; r <= range.endRow; r += 1) {
+        for (let c = range.startCol; c <= range.endCol; c += 1) {
+            cells.push({ row: r, col: c });
+        }
+    }
+    return cells;
+}
+export function rangesEqual(a, b) {
+    return (a.startRow === b.startRow &&
+        a.endRow === b.endRow &&
+        a.startCol === b.startCol &&
+        a.endCol === b.endCol);
+}
+export function singleCellRange(pos) {
+    return { startRow: pos.row, endRow: pos.row, startCol: pos.col, endCol: pos.col };
+}
+export function isSingleCell(range) {
+    return range.startRow === range.endRow && range.startCol === range.endCol;
+}
+//# sourceMappingURL=selection.js.map

package/dist/lib/selection.js.map

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

package/dist/lib/tsv.d.ts

@@ -0,0 +1,31 @@
+/**
+ * TSV (tab-separated values) round-trip for spreadsheet clipboard interop.
+ *
+ * Excel/Sheets/Airtable all read and write TSV on the system clipboard for
+ * cell-range copy/paste. This is the single most important "feels like
+ * Excel" behaviour in the package — getting the grammar exactly right is
+ * what lets a range copied here paste cleanly into a real spreadsheet, and
+ * vice versa:
+ *
+ *  - Cells are separated by \t, rows by \n on output. Real spreadsheet
+ *    software (Excel on Windows in particular) emits \r\n between rows; the
+ *    parser accepts \n, \r\n and bare \r so paste-from-Excel works too.
+ *  - A cell whose value contains a tab, a newline/CR, or a double quote is
+ *    wrapped in double quotes with interior quotes doubled (the same
+ *    RFC-4180-style escaping Excel/Sheets use for TSV, not just CSV).
+ *  - A cell that needs no escaping is emitted bare. This matters: Excel does
+ *    NOT quote plain cells, and quoting every cell unconditionally breaks
+ *    round-trips with real spreadsheet software (a leading `"` is
+ *    significant there).
+ */
+export declare function needsQuoting(value: string): boolean;
+export declare function quoteCell(value: string): string;
+export declare function serializeTsv(rows: readonly (readonly string[])[]): string;
+/**
+ * Hand-rolled state machine rather than a split() — a naive `text.split('\n')`
+ * followed by `line.split('\t')` corrupts any cell containing an embedded
+ * tab or newline inside quotes, which is exactly the case #1 requirement
+ * calls out ("values containing tabs/newlines/quotes").
+ */
+export declare function parseTsv(text: string): string[][];
+//# sourceMappingURL=tsv.d.ts.map

package/dist/lib/tsv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsv.d.ts","sourceRoot":"","sources":["../../src/lib/tsv.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG/C;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,GAAG,MAAM,CAEzE;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,CAiFjD"}