@deephaven/grid 1.27.5-alpha-nodehttp2-config3.276eddc.0 → 1.29.0

package/dist/GridRendererTypes.d.ts

@@ -2,12 +2,12 @@ import type React from 'react';
 import { type VisibleIndex, type Coordinate } from './GridMetrics';
 import type GridMetrics from './GridMetrics';
 import type GridModel from './GridModel';
-import type GridRange from './GridRange';
 import { type GridTheme } from './GridTheme';
 import { type DraggingColumn } from './mouse-handlers/GridColumnMoveMouseHandler';
 import { type GridSeparator } from './mouse-handlers/GridSeparatorMouseHandler';
 import type { CellInputFieldProps } from './CellInputField';
 import type { ColumnRestriction } from './GridModel';
+import type { GestureMode, Selection } from './Selection';
 export declare const DEFAULT_FONT_WIDTH = 10;
 /**
  * Props passed to a cell input renderer, combining the base CellInputField
@@ -54,9 +54,7 @@ export type GridRenderState = {
     metrics: GridMetrics;
     mouseX: Coordinate | null;
     mouseY: Coordinate | null;
-    cursorColumn: VisibleIndex | null;
-    cursorRow: VisibleIndex | null;
-    selectedRanges: readonly GridRange[];
+    selection: Selection;
     draggingColumn: DraggingColumn | null;
     draggingColumnSeparator: GridSeparator | null;
     draggingRow: VisibleIndex | null;
@@ -66,5 +64,6 @@ export type GridRenderState = {
     isDraggingHorizontalScrollBar: boolean;
     isDraggingVerticalScrollBar: boolean;
     isDragging: boolean;
+    gestureMode: GestureMode | null;
 };
 //# sourceMappingURL=GridRendererTypes.d.ts.map

package/dist/GridRendererTypes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GridRendererTypes.d.ts","sourceRoot":"","sources":["../src/GridRendererTypes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,KAAK,WAAW,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,6CAA6C,CAAC;AAClF,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,4CAA4C,CAAC;AAChF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGrD,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,mBAAmB,GAAG;IACjD,YAAY,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAC5C,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CACjC,KAAK,EAAE,cAAc,KAClB,KAAK,CAAC,SAAS,CAAC,GAAG;IACtB;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GAAG,WAAW,CACjD,MAAM,EACN,mBAAmB,CACpB,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;AAEzE,MAAM,MAAM,WAAW,GAAG;IAExB,MAAM,EAAE,YAAY,CAAC;IACrB,GAAG,EAAE,YAAY,CAAC;IAGlB,cAAc,CAAC,EAAE,6BAA6B,CAAC;IAG/C,KAAK,EAAE,MAAM,CAAC;IAGd,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAE5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IAGf,OAAO,EAAE,wBAAwB,CAAC;IAGlC,KAAK,EAAE,SAAS,CAAC;IAGjB,KAAK,EAAE,SAAS,CAAC;IAGjB,OAAO,EAAE,WAAW,CAAC;IAGrB,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IAG1B,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,SAAS,EAAE,YAAY,GAAG,IAAI,CAAC;IAG/B,cAAc,EAAE,SAAS,SAAS,EAAE,CAAC;IAGrC,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;IACtC,uBAAuB,EAAE,aAAa,GAAG,IAAI,CAAC;IAC9C,WAAW,EAAE,YAAY,GAAG,IAAI,CAAC;IACjC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,oBAAoB,EAAE,aAAa,GAAG,IAAI,CAAC;IAG3C,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,6BAA6B,EAAE,OAAO,CAAC;IACvC,2BAA2B,EAAE,OAAO,CAAC;IACrC,UAAU,EAAE,OAAO,CAAC;CACrB,CAAC"}
+{"version":3,"file":"GridRendererTypes.d.ts","sourceRoot":"","sources":["../src/GridRendererTypes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,KAAK,WAAW,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,6CAA6C,CAAC;AAClF,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,4CAA4C,CAAC;AAChF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG1D,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,mBAAmB,GAAG;IACjD,YAAY,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAC5C,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CACjC,KAAK,EAAE,cAAc,KAClB,KAAK,CAAC,SAAS,CAAC,GAAG;IACtB;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GAAG,WAAW,CACjD,MAAM,EACN,mBAAmB,CACpB,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;AAEzE,MAAM,MAAM,WAAW,GAAG;IAExB,MAAM,EAAE,YAAY,CAAC;IACrB,GAAG,EAAE,YAAY,CAAC;IAGlB,cAAc,CAAC,EAAE,6BAA6B,CAAC;IAG/C,KAAK,EAAE,MAAM,CAAC;IAGd,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAE5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IAGf,OAAO,EAAE,wBAAwB,CAAC;IAGlC,KAAK,EAAE,SAAS,CAAC;IAGjB,KAAK,EAAE,SAAS,CAAC;IAGjB,OAAO,EAAE,WAAW,CAAC;IAGrB,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IAG1B,SAAS,EAAE,SAAS,CAAC;IAGrB,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;IACtC,uBAAuB,EAAE,aAAa,GAAG,IAAI,CAAC;IAC9C,WAAW,EAAE,YAAY,GAAG,IAAI,CAAC;IACjC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,oBAAoB,EAAE,aAAa,GAAG,IAAI,CAAC;IAG3C,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,6BAA6B,EAAE,OAAO,CAAC;IACvC,2BAA2B,EAAE,OAAO,CAAC;IACrC,UAAU,EAAE,OAAO,CAAC;IAIpB,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;CACjC,CAAC"}

package/dist/GridRendererTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"GridRendererTypes.js","names":["DEFAULT_FONT_WIDTH"],"sources":["../src/GridRendererTypes.ts"],"sourcesContent":["import type React from 'react';\nimport { type VisibleIndex, type Coordinate } from './GridMetrics';\nimport type GridMetrics from './GridMetrics';\nimport type GridModel from './GridModel';\nimport type GridRange from './GridRange';\nimport { type GridTheme } from './GridTheme';\nimport { type DraggingColumn } from './mouse-handlers/GridColumnMoveMouseHandler';\nimport { type GridSeparator } from './mouse-handlers/GridSeparatorMouseHandler';\nimport type { CellInputFieldProps } from './CellInputField';\nimport type { ColumnRestriction } from './GridModel';\n\n// Default font width in pixels if it cannot be retrieved from the context\nexport const DEFAULT_FONT_WIDTH = 10;\n\n/**\n * Props passed to a cell input renderer, combining the base CellInputField\n * props with the restrictions that apply to the cell being edited.\n */\nexport type CellInputProps = CellInputFieldProps & {\n  restrictions: readonly ColumnRestriction[];\n};\n\n/**\n * A renderer for a single cell input field based on column restriction type.\n *\n * Set `preservesExistingValue = true` on the function to signal that\n * keystroke-initiated edits should open the editor with the existing cell\n * value rather than replacing it with the typed character.\n */\nexport type CellInputRendererFn = ((\n  props: CellInputProps\n) => React.ReactNode) & {\n  /**\n   * When true, keystroke-initiated edits preserve the existing cell value\n   * instead of replacing it with the typed character. Intended for renderers\n   * like dropdowns where the typed character has no meaning as a new value.\n   */\n  preservesExistingValue?: boolean;\n};\n\n/**\n * A map from column restriction type string to a cell input renderer function.\n * Grid looks up restrictions[0].type in this registry and falls back to\n * CellInputField when there is no match.\n */\nexport type CellInputRendererRegistry = ReadonlyMap<\n  string,\n  CellInputRendererFn\n>;\n\nexport type EditingCellTextSelectionRange = [start: number, end: number];\n\nexport type EditingCell = {\n  // Index of the editing cell\n  column: VisibleIndex;\n  row: VisibleIndex;\n\n  // Selection within the text\n  selectionRange?: EditingCellTextSelectionRange;\n\n  // The value to use for the edit\n  value: string;\n\n  // Whether the selection was triggered with a quick edit action (e.g. Start typing with the cell in focus)\n  isQuickEdit?: boolean;\n};\n\nexport type GridRenderState = {\n  // Width and height of the total canvas area\n  width: number;\n  height: number;\n\n  // The canvas context\n  context: CanvasRenderingContext2D;\n\n  // The grid theme\n  theme: GridTheme;\n\n  // The model used by the grid\n  model: GridModel;\n\n  // The grid metrics\n  metrics: GridMetrics;\n\n  // Location of the mouse on the grid\n  mouseX: Coordinate | null;\n  mouseY: Coordinate | null;\n\n  // Where the keyboard cursor is located\n  cursorColumn: VisibleIndex | null;\n  cursorRow: VisibleIndex | null;\n\n  // Currently selected ranges\n  selectedRanges: readonly GridRange[];\n\n  // Currently dragged column/row information\n  draggingColumn: DraggingColumn | null;\n  draggingColumnSeparator: GridSeparator | null;\n  draggingRow: VisibleIndex | null;\n  draggingRowOffset: number | null;\n  draggingRowSeparator: GridSeparator | null;\n\n  // The currently editing cell\n  editingCell: EditingCell | null;\n  isDraggingHorizontalScrollBar: boolean;\n  isDraggingVerticalScrollBar: boolean;\n  isDragging: boolean;\n};\n"],"mappings":"AAWA;AACA,OAAO,IAAMA,kBAAkB,GAAG,EAAE;;AAEpC;AACA;AACA;AACA;;AAKA;AACA;AACA;AACA;AACA;AACA;AACA;;AAYA;AACA;AACA;AACA;AACA","ignoreList":[]}
+{"version":3,"file":"GridRendererTypes.js","names":["DEFAULT_FONT_WIDTH"],"sources":["../src/GridRendererTypes.ts"],"sourcesContent":["import type React from 'react';\nimport { type VisibleIndex, type Coordinate } from './GridMetrics';\nimport type GridMetrics from './GridMetrics';\nimport type GridModel from './GridModel';\nimport { type GridTheme } from './GridTheme';\nimport { type DraggingColumn } from './mouse-handlers/GridColumnMoveMouseHandler';\nimport { type GridSeparator } from './mouse-handlers/GridSeparatorMouseHandler';\nimport type { CellInputFieldProps } from './CellInputField';\nimport type { ColumnRestriction } from './GridModel';\nimport type { GestureMode, Selection } from './Selection';\n\n// Default font width in pixels if it cannot be retrieved from the context\nexport const DEFAULT_FONT_WIDTH = 10;\n\n/**\n * Props passed to a cell input renderer, combining the base CellInputField\n * props with the restrictions that apply to the cell being edited.\n */\nexport type CellInputProps = CellInputFieldProps & {\n  restrictions: readonly ColumnRestriction[];\n};\n\n/**\n * A renderer for a single cell input field based on column restriction type.\n *\n * Set `preservesExistingValue = true` on the function to signal that\n * keystroke-initiated edits should open the editor with the existing cell\n * value rather than replacing it with the typed character.\n */\nexport type CellInputRendererFn = ((\n  props: CellInputProps\n) => React.ReactNode) & {\n  /**\n   * When true, keystroke-initiated edits preserve the existing cell value\n   * instead of replacing it with the typed character. Intended for renderers\n   * like dropdowns where the typed character has no meaning as a new value.\n   */\n  preservesExistingValue?: boolean;\n};\n\n/**\n * A map from column restriction type string to a cell input renderer function.\n * Grid looks up restrictions[0].type in this registry and falls back to\n * CellInputField when there is no match.\n */\nexport type CellInputRendererRegistry = ReadonlyMap<\n  string,\n  CellInputRendererFn\n>;\n\nexport type EditingCellTextSelectionRange = [start: number, end: number];\n\nexport type EditingCell = {\n  // Index of the editing cell\n  column: VisibleIndex;\n  row: VisibleIndex;\n\n  // Selection within the text\n  selectionRange?: EditingCellTextSelectionRange;\n\n  // The value to use for the edit\n  value: string;\n\n  // Whether the selection was triggered with a quick edit action (e.g. Start typing with the cell in focus)\n  isQuickEdit?: boolean;\n};\n\nexport type GridRenderState = {\n  // Width and height of the total canvas area\n  width: number;\n  height: number;\n\n  // The canvas context\n  context: CanvasRenderingContext2D;\n\n  // The grid theme\n  theme: GridTheme;\n\n  // The model used by the grid\n  model: GridModel;\n\n  // The grid metrics\n  metrics: GridMetrics;\n\n  // Location of the mouse on the grid\n  mouseX: Coordinate | null;\n  mouseY: Coordinate | null;\n\n  // Current selection. Owns the cursor and shift/drag endpoint.\n  selection: Selection;\n\n  // Currently dragged column/row information\n  draggingColumn: DraggingColumn | null;\n  draggingColumnSeparator: GridSeparator | null;\n  draggingRow: VisibleIndex | null;\n  draggingRowOffset: number | null;\n  draggingRowSeparator: GridSeparator | null;\n\n  // The currently editing cell\n  editingCell: EditingCell | null;\n  isDraggingHorizontalScrollBar: boolean;\n  isDraggingVerticalScrollBar: boolean;\n  isDragging: boolean;\n\n  // Modifier-derived mode of the in-flight mouse gesture; `null` when no\n  // gesture is active. Drives the drag-overlay stroke on additive gestures.\n  gestureMode: GestureMode | null;\n};\n"],"mappings":"AAWA;AACA,OAAO,IAAMA,kBAAkB,GAAG,EAAE;;AAEpC;AACA;AACA;AACA;;AAKA;AACA;AACA;AACA;AACA;AACA;AACA;;AAYA;AACA;AACA;AACA;AACA","ignoreList":[]}

package/dist/GridSelectionUtils.d.ts

@@ -0,0 +1,98 @@
+import GridRange, { type GridRangeIndex, type SELECTION_DIRECTION } from './GridRange';
+import type { CommitGestureOptions, GestureExtendOptions, GestureMode, Selection } from './Selection';
+/**
+ * Maps modifier-key state on a mouse event to the appropriate `GestureMode`.
+ * The four modifier combinations partition the gesture space:
+ * - shift + ctrl/meta → `maximize`
+ * - shift alone       → `extend`
+ * - ctrl/meta alone   → `add`
+ * - no modifiers      → `replace`
+ */
+export declare function gestureModeFromModifiers(modifiers: {
+    isShiftKey: boolean;
+    isModifierKey: boolean;
+}): GestureMode;
+/**
+ * Shape describing how a mouse gesture should mutate the selection's ranges.
+ * Consumed by each `Selection` implementation's `withGestureExtend` to install
+ * the transient overlay.
+ */
+export type GestureExtendResult = {
+    /** The new range list to install as the transient overlay. */
+    newRanges: readonly GridRange[];
+    /**
+     * True when the caller should drop any previously-committed selection state
+     * (relevant to `KeyedSelection.selectedKeys`; ignored by `RangedSelection`).
+     */
+    isReplacing: boolean;
+    /**
+     * True when the caller should trim to the last committed range before
+     * installing the new ranges. Applies to `extend` mode.
+     */
+    trimBefore: boolean;
+    /**
+     * True when the caller should reset the gesture anchor to `cursor` after
+     * installing. False preserves the existing anchor.
+     */
+    resetAnchor: boolean;
+};
+/**
+ * Compute the geometry for a mouse gesture. Given the current active ranges,
+ * gesture anchor, cursor position, and mode, returns the new overlay ranges
+ * plus the flags describing how the caller should install them.
+ *
+ * This is the shared arithmetic used by both `RangedSelection` and
+ * `KeyedSelection` for their `withGestureExtend` implementations.
+ */
+export declare function computeGestureExtend(activeRanges: readonly GridRange[], anchor: {
+    row: GridRangeIndex;
+    column: GridRangeIndex;
+} | null, cursor: {
+    row: GridRangeIndex;
+    column: GridRangeIndex;
+}, opts: GestureExtendOptions): GestureExtendResult;
+/**
+ * Returns the next cursor cell in `direction` walking through `ranges`.
+ * Falls back to walking the full grid when the ranges are empty or contain
+ * exactly one cell — matches Tab/Enter behavior for single-cell selections.
+ * Shared by `RangedSelection` and `KeyedSelection` implementations of
+ * `getNextCursorInDirection`.
+ */
+export declare function nextCursorInRanges(ranges: readonly GridRange[], current: {
+    row: GridRangeIndex;
+    column: GridRangeIndex;
+}, direction: SELECTION_DIRECTION, bounds: {
+    columnCount: number;
+    rowCount: number;
+}): {
+    row: GridRangeIndex;
+    column: GridRangeIndex;
+} | null;
+/**
+ * Returns the first cell of `ranges` bounded to `[columnCount, rowCount]`.
+ * Shared by `RangedSelection` and `KeyedSelection` implementations of
+ * `getCursorLandingCell`.
+ */
+export declare function cursorLandingCellForRanges(ranges: readonly GridRange[], bounds: {
+    columnCount: number;
+    rowCount: number;
+}): {
+    row: GridRangeIndex;
+    column: GridRangeIndex;
+} | null;
+/**
+ * Returns `settled` with the post-commit cursor placed. Uses `opts.cursor`
+ * as the target; substitutes `landing` when the target falls outside a
+ * non-empty settled selection; preserves the target when settled is empty
+ * (matches Escape's "cursor survives clear" semantics).
+ *
+ * Callers pass `landing` precomputed from the pre-commit selection so this
+ * helper doesn't need to reach back into the caller's overlay state.
+ * Returns `settled` unchanged when the cursor is already correct so
+ * mouseUp no-ops preserve reference equality.
+ */
+export declare function withCommittedCursor<S extends Selection>(settled: S, landing: {
+    row: GridRangeIndex;
+    column: GridRangeIndex;
+} | null, opts: CommitGestureOptions): S;
+//# sourceMappingURL=GridSelectionUtils.d.ts.map

package/dist/GridSelectionUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GridSelectionUtils.d.ts","sourceRoot":"","sources":["../src/GridSelectionUtils.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,EAAE,EAChB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACzB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACV,oBAAoB,EACpB,oBAAoB,EACpB,WAAW,EACX,SAAS,EACV,MAAM,aAAa,CAAC;AAErB;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE;IAClD,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,OAAO,CAAC;CACxB,GAAG,WAAW,CAMd;AAED;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,8DAA8D;IAC9D,SAAS,EAAE,SAAS,SAAS,EAAE,CAAC;IAChC;;;OAGG;IACH,WAAW,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,UAAU,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,SAAS,SAAS,EAAE,EAClC,MAAM,EAAE;IAAE,GAAG,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,cAAc,CAAA;CAAE,GAAG,IAAI,EAC9D,MAAM,EAAE;IAAE,GAAG,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,cAAc,CAAA;CAAE,EACvD,IAAI,EAAE,oBAAoB,GACzB,mBAAmB,CAmHrB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,SAAS,EAAE,EAC5B,OAAO,EAAE;IAAE,GAAG,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,cAAc,CAAA;CAAE,EACxD,SAAS,EAAE,mBAAmB,EAC9B,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,GAAG,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,cAAc,CAAA;CAAE,GAAG,IAAI,CAuBxD;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,SAAS,EAAE,EAC5B,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,GAAG,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,cAAc,CAAA;CAAE,GAAG,IAAI,CAKxD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,SAAS,EACrD,OAAO,EAAE,CAAC,EACV,OAAO,EAAE;IAAE,GAAG,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,cAAc,CAAA;CAAE,GAAG,IAAI,EAC/D,IAAI,EAAE,oBAAoB,GACzB,CAAC,CA4BH"}

package/dist/GridSelectionUtils.js

@@ -0,0 +1,180 @@
+import GridRange from "./GridRange.js";
+/**
+ * Maps modifier-key state on a mouse event to the appropriate `GestureMode`.
+ * The four modifier combinations partition the gesture space:
+ * - shift + ctrl/meta → `maximize`
+ * - shift alone       → `extend`
+ * - ctrl/meta alone   → `add`
+ * - no modifiers      → `replace`
+ */
+export function gestureModeFromModifiers(modifiers) {
+  var isShiftKey = modifiers.isShiftKey,
+    isModifierKey = modifiers.isModifierKey;
+  if (isShiftKey && isModifierKey) return 'maximize';
+  if (isShiftKey) return 'extend';
+  if (isModifierKey) return 'add';
+  return 'replace';
+}
+
+/**
+ * Shape describing how a mouse gesture should mutate the selection's ranges.
+ * Consumed by each `Selection` implementation's `withGestureExtend` to install
+ * the transient overlay.
+ */
+
+/**
+ * Compute the geometry for a mouse gesture. Given the current active ranges,
+ * gesture anchor, cursor position, and mode, returns the new overlay ranges
+ * plus the flags describing how the caller should install them.
+ *
+ * This is the shared arithmetic used by both `RangedSelection` and
+ * `KeyedSelection` for their `withGestureExtend` implementations.
+ */
+export function computeGestureExtend(activeRanges, anchor, cursor, opts) {
+  var _anchor$row, _anchor$column;
+  var mode = opts.mode,
+    autoSelectRow = opts.autoSelectRow,
+    autoSelectColumn = opts.autoSelectColumn;
+  var row = cursor.row,
+    column = cursor.column;
+  var singleCellColumn = autoSelectRow ? null : column;
+  var singleCellRow = autoSelectColumn ? null : row;
+  var singleCell = GridRange.makeNormalized(singleCellColumn, singleCellRow, singleCellColumn, singleCellRow);
+  if (mode === 'replace') {
+    return {
+      newRanges: [singleCell],
+      isReplacing: true,
+      trimBefore: false,
+      resetAnchor: true
+    };
+  }
+  if (mode === 'add') {
+    return {
+      newRanges: [...activeRanges, singleCell],
+      isReplacing: false,
+      trimBefore: false,
+      resetAnchor: true
+    };
+  }
+
+  // extend or maximize — both extend an existing range from anchor/last-range.
+  var trimBefore = mode === 'extend';
+  var isReplacing = mode === 'extend';
+  var rangesBeforeExtend = trimBefore && activeRanges.length > 0 ? [activeRanges[activeRanges.length - 1]] : activeRanges;
+  var anchorRow = (_anchor$row = anchor === null || anchor === void 0 ? void 0 : anchor.row) !== null && _anchor$row !== void 0 ? _anchor$row : null;
+  var anchorColumn = (_anchor$column = anchor === null || anchor === void 0 ? void 0 : anchor.column) !== null && _anchor$column !== void 0 ? _anchor$column : null;
+
+  // Nothing to extend from → fall through to replace-with-cell semantics.
+  if (rangesBeforeExtend.length === 0 && anchor == null) {
+    return {
+      newRanges: [singleCell],
+      isReplacing: true,
+      trimBefore: false,
+      resetAnchor: true
+    };
+  }
+  var lastRange = rangesBeforeExtend.length > 0 ? rangesBeforeExtend[rangesBeforeExtend.length - 1] : GridRange.makeNormalized(anchorColumn, anchorRow, anchorColumn, anchorRow);
+  var left = null;
+  var top = null;
+  var right = null;
+  var bottom = null;
+  if (mode === 'maximize') {
+    var _lastRange$startColum, _lastRange$startRow, _lastRange$endColumn, _lastRange$endRow;
+    left = autoSelectRow ? null : Math.min(column !== null && column !== void 0 ? column : 0, (_lastRange$startColum = lastRange.startColumn) !== null && _lastRange$startColum !== void 0 ? _lastRange$startColum : 0);
+    top = autoSelectColumn ? null : Math.min(row !== null && row !== void 0 ? row : 0, (_lastRange$startRow = lastRange.startRow) !== null && _lastRange$startRow !== void 0 ? _lastRange$startRow : 0);
+    right = autoSelectRow ? null : Math.max(column !== null && column !== void 0 ? column : 0, (_lastRange$endColumn = lastRange.endColumn) !== null && _lastRange$endColumn !== void 0 ? _lastRange$endColumn : 0);
+    bottom = autoSelectColumn ? null : Math.max(row !== null && row !== void 0 ? row : 0, (_lastRange$endRow = lastRange.endRow) !== null && _lastRange$endRow !== void 0 ? _lastRange$endRow : 0);
+  } else {
+    // extend — anchor to cursor, replacing the last range.
+    left = lastRange.startColumn;
+    top = lastRange.startRow;
+    if (anchorColumn != null || anchorRow != null) {
+      if (!autoSelectRow) left = anchorColumn;
+      if (!autoSelectColumn) top = anchorRow;
+    }
+    right = autoSelectRow ? null : column;
+    bottom = autoSelectColumn ? null : row;
+  }
+  var extended = GridRange.makeNormalized(left, top, right, bottom);
+  if (lastRange.equals(extended)) {
+    return {
+      newRanges: rangesBeforeExtend,
+      isReplacing,
+      trimBefore,
+      resetAnchor: false
+    };
+  }
+  var newRanges = [...rangesBeforeExtend];
+  if (newRanges.length > 0) {
+    newRanges[newRanges.length - 1] = extended;
+  } else {
+    newRanges.push(extended);
+  }
+  return {
+    newRanges,
+    isReplacing,
+    trimBefore,
+    resetAnchor: false
+  };
+}
+
+/**
+ * Returns the next cursor cell in `direction` walking through `ranges`.
+ * Falls back to walking the full grid when the ranges are empty or contain
+ * exactly one cell — matches Tab/Enter behavior for single-cell selections.
+ * Shared by `RangedSelection` and `KeyedSelection` implementations of
+ * `getNextCursorInDirection`.
+ */
+export function nextCursorInRanges(ranges, current, direction, bounds) {
+  var activeRanges = ranges.length > 0 ? ranges : [GridRange.makeCell(current.column, current.row)];
+  if (activeRanges.length === 1 && GridRange.cellCount(activeRanges) === 1) {
+    var _gridRange$nextCell;
+    var gridRange = new GridRange(0, 0, bounds.columnCount - 1, bounds.rowCount - 1);
+    return (_gridRange$nextCell = gridRange.nextCell(current.column, current.row, direction)) !== null && _gridRange$nextCell !== void 0 ? _gridRange$nextCell : gridRange.startCell(direction);
+  }
+  return GridRange.nextCell(GridRange.boundedRanges(activeRanges, bounds.columnCount, bounds.rowCount), current.column, current.row, direction);
+}
+
+/**
+ * Returns the first cell of `ranges` bounded to `[columnCount, rowCount]`.
+ * Shared by `RangedSelection` and `KeyedSelection` implementations of
+ * `getCursorLandingCell`.
+ */
+export function cursorLandingCellForRanges(ranges, bounds) {
+  if (ranges.length === 0) return null;
+  return GridRange.nextCell(GridRange.boundedRanges(ranges, bounds.columnCount, bounds.rowCount));
+}
+
+/**
+ * Returns `settled` with the post-commit cursor placed. Uses `opts.cursor`
+ * as the target; substitutes `landing` when the target falls outside a
+ * non-empty settled selection; preserves the target when settled is empty
+ * (matches Escape's "cursor survives clear" semantics).
+ *
+ * Callers pass `landing` precomputed from the pre-commit selection so this
+ * helper doesn't need to reach back into the caller's overlay state.
+ * Returns `settled` unchanged when the cursor is already correct so
+ * mouseUp no-ops preserve reference equality.
+ */
+export function withCommittedCursor(settled, landing, opts) {
+  var target = opts.cursor;
+  if (target === undefined) return settled;
+  var desiredRow;
+  var desiredColumn;
+  if (settled.isEmpty()) {
+    desiredRow = target.row;
+    desiredColumn = target.column;
+  } else if (target.row != null && target.column != null && settled.isCellSelected(target.column, target.row)) {
+    desiredRow = target.row;
+    desiredColumn = target.column;
+  } else {
+    var _landing$row, _landing$column;
+    desiredRow = (_landing$row = landing === null || landing === void 0 ? void 0 : landing.row) !== null && _landing$row !== void 0 ? _landing$row : null;
+    desiredColumn = (_landing$column = landing === null || landing === void 0 ? void 0 : landing.column) !== null && _landing$column !== void 0 ? _landing$column : null;
+  }
+  if (settled.cursorRow === desiredRow && settled.cursorColumn === desiredColumn) {
+    return settled;
+  }
+  return settled.withCursor(desiredRow, desiredColumn);
+}
+//# sourceMappingURL=GridSelectionUtils.js.map

package/dist/GridSelectionUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GridSelectionUtils.js","names":["GridRange","gestureModeFromModifiers","modifiers","isShiftKey","isModifierKey","computeGestureExtend","activeRanges","anchor","cursor","opts","_anchor$row","_anchor$column","mode","autoSelectRow","autoSelectColumn","row","column","singleCellColumn","singleCellRow","singleCell","makeNormalized","newRanges","isReplacing","trimBefore","resetAnchor","rangesBeforeExtend","length","anchorRow","anchorColumn","lastRange","left","top","right","bottom","_lastRange$startColum","_lastRange$startRow","_lastRange$endColumn","_lastRange$endRow","Math","min","startColumn","startRow","max","endColumn","endRow","extended","equals","push","nextCursorInRanges","ranges","current","direction","bounds","makeCell","cellCount","_gridRange$nextCell","gridRange","columnCount","rowCount","nextCell","startCell","boundedRanges","cursorLandingCellForRanges","withCommittedCursor","settled","landing","target","undefined","desiredRow","desiredColumn","isEmpty","isCellSelected","_landing$row","_landing$column","cursorRow","cursorColumn","withCursor"],"sources":["../src/GridSelectionUtils.ts"],"sourcesContent":["import GridRange, {\n  type GridRangeIndex,\n  type SELECTION_DIRECTION,\n} from './GridRange';\nimport type {\n  CommitGestureOptions,\n  GestureExtendOptions,\n  GestureMode,\n  Selection,\n} from './Selection';\n\n/**\n * Maps modifier-key state on a mouse event to the appropriate `GestureMode`.\n * The four modifier combinations partition the gesture space:\n * - shift + ctrl/meta → `maximize`\n * - shift alone       → `extend`\n * - ctrl/meta alone   → `add`\n * - no modifiers      → `replace`\n */\nexport function gestureModeFromModifiers(modifiers: {\n  isShiftKey: boolean;\n  isModifierKey: boolean;\n}): GestureMode {\n  const { isShiftKey, isModifierKey } = modifiers;\n  if (isShiftKey && isModifierKey) return 'maximize';\n  if (isShiftKey) return 'extend';\n  if (isModifierKey) return 'add';\n  return 'replace';\n}\n\n/**\n * Shape describing how a mouse gesture should mutate the selection's ranges.\n * Consumed by each `Selection` implementation's `withGestureExtend` to install\n * the transient overlay.\n */\nexport type GestureExtendResult = {\n  /** The new range list to install as the transient overlay. */\n  newRanges: readonly GridRange[];\n  /**\n   * True when the caller should drop any previously-committed selection state\n   * (relevant to `KeyedSelection.selectedKeys`; ignored by `RangedSelection`).\n   */\n  isReplacing: boolean;\n  /**\n   * True when the caller should trim to the last committed range before\n   * installing the new ranges. Applies to `extend` mode.\n   */\n  trimBefore: boolean;\n  /**\n   * True when the caller should reset the gesture anchor to `cursor` after\n   * installing. False preserves the existing anchor.\n   */\n  resetAnchor: boolean;\n};\n\n/**\n * Compute the geometry for a mouse gesture. Given the current active ranges,\n * gesture anchor, cursor position, and mode, returns the new overlay ranges\n * plus the flags describing how the caller should install them.\n *\n * This is the shared arithmetic used by both `RangedSelection` and\n * `KeyedSelection` for their `withGestureExtend` implementations.\n */\nexport function computeGestureExtend(\n  activeRanges: readonly GridRange[],\n  anchor: { row: GridRangeIndex; column: GridRangeIndex } | null,\n  cursor: { row: GridRangeIndex; column: GridRangeIndex },\n  opts: GestureExtendOptions\n): GestureExtendResult {\n  const { mode, autoSelectRow, autoSelectColumn } = opts;\n  const { row, column } = cursor;\n\n  const singleCellColumn = autoSelectRow ? null : column;\n  const singleCellRow = autoSelectColumn ? null : row;\n  const singleCell = GridRange.makeNormalized(\n    singleCellColumn,\n    singleCellRow,\n    singleCellColumn,\n    singleCellRow\n  );\n\n  if (mode === 'replace') {\n    return {\n      newRanges: [singleCell],\n      isReplacing: true,\n      trimBefore: false,\n      resetAnchor: true,\n    };\n  }\n\n  if (mode === 'add') {\n    return {\n      newRanges: [...activeRanges, singleCell],\n      isReplacing: false,\n      trimBefore: false,\n      resetAnchor: true,\n    };\n  }\n\n  // extend or maximize — both extend an existing range from anchor/last-range.\n  const trimBefore = mode === 'extend';\n  const isReplacing = mode === 'extend';\n\n  const rangesBeforeExtend =\n    trimBefore && activeRanges.length > 0\n      ? [activeRanges[activeRanges.length - 1]]\n      : activeRanges;\n\n  const anchorRow = anchor?.row ?? null;\n  const anchorColumn = anchor?.column ?? null;\n\n  // Nothing to extend from → fall through to replace-with-cell semantics.\n  if (rangesBeforeExtend.length === 0 && anchor == null) {\n    return {\n      newRanges: [singleCell],\n      isReplacing: true,\n      trimBefore: false,\n      resetAnchor: true,\n    };\n  }\n\n  const lastRange =\n    rangesBeforeExtend.length > 0\n      ? rangesBeforeExtend[rangesBeforeExtend.length - 1]\n      : GridRange.makeNormalized(\n          anchorColumn,\n          anchorRow,\n          anchorColumn,\n          anchorRow\n        );\n\n  let left: GridRangeIndex = null;\n  let top: GridRangeIndex = null;\n  let right: GridRangeIndex = null;\n  let bottom: GridRangeIndex = null;\n\n  if (mode === 'maximize') {\n    left = autoSelectRow\n      ? null\n      : Math.min(column ?? 0, lastRange.startColumn ?? 0);\n    top = autoSelectColumn ? null : Math.min(row ?? 0, lastRange.startRow ?? 0);\n    right = autoSelectRow\n      ? null\n      : Math.max(column ?? 0, lastRange.endColumn ?? 0);\n    bottom = autoSelectColumn\n      ? null\n      : Math.max(row ?? 0, lastRange.endRow ?? 0);\n  } else {\n    // extend — anchor to cursor, replacing the last range.\n    left = lastRange.startColumn;\n    top = lastRange.startRow;\n    if (anchorColumn != null || anchorRow != null) {\n      if (!autoSelectRow) left = anchorColumn;\n      if (!autoSelectColumn) top = anchorRow;\n    }\n    right = autoSelectRow ? null : column;\n    bottom = autoSelectColumn ? null : row;\n  }\n\n  const extended = GridRange.makeNormalized(left, top, right, bottom);\n\n  if (lastRange.equals(extended)) {\n    return {\n      newRanges: rangesBeforeExtend,\n      isReplacing,\n      trimBefore,\n      resetAnchor: false,\n    };\n  }\n\n  const newRanges = [...rangesBeforeExtend];\n  if (newRanges.length > 0) {\n    newRanges[newRanges.length - 1] = extended;\n  } else {\n    newRanges.push(extended);\n  }\n\n  return {\n    newRanges,\n    isReplacing,\n    trimBefore,\n    resetAnchor: false,\n  };\n}\n\n/**\n * Returns the next cursor cell in `direction` walking through `ranges`.\n * Falls back to walking the full grid when the ranges are empty or contain\n * exactly one cell — matches Tab/Enter behavior for single-cell selections.\n * Shared by `RangedSelection` and `KeyedSelection` implementations of\n * `getNextCursorInDirection`.\n */\nexport function nextCursorInRanges(\n  ranges: readonly GridRange[],\n  current: { row: GridRangeIndex; column: GridRangeIndex },\n  direction: SELECTION_DIRECTION,\n  bounds: { columnCount: number; rowCount: number }\n): { row: GridRangeIndex; column: GridRangeIndex } | null {\n  const activeRanges =\n    ranges.length > 0\n      ? ranges\n      : [GridRange.makeCell(current.column, current.row)];\n  if (activeRanges.length === 1 && GridRange.cellCount(activeRanges) === 1) {\n    const gridRange = new GridRange(\n      0,\n      0,\n      bounds.columnCount - 1,\n      bounds.rowCount - 1\n    );\n    return (\n      gridRange.nextCell(current.column, current.row, direction) ??\n      gridRange.startCell(direction)\n    );\n  }\n  return GridRange.nextCell(\n    GridRange.boundedRanges(activeRanges, bounds.columnCount, bounds.rowCount),\n    current.column,\n    current.row,\n    direction\n  );\n}\n\n/**\n * Returns the first cell of `ranges` bounded to `[columnCount, rowCount]`.\n * Shared by `RangedSelection` and `KeyedSelection` implementations of\n * `getCursorLandingCell`.\n */\nexport function cursorLandingCellForRanges(\n  ranges: readonly GridRange[],\n  bounds: { columnCount: number; rowCount: number }\n): { row: GridRangeIndex; column: GridRangeIndex } | null {\n  if (ranges.length === 0) return null;\n  return GridRange.nextCell(\n    GridRange.boundedRanges(ranges, bounds.columnCount, bounds.rowCount)\n  );\n}\n\n/**\n * Returns `settled` with the post-commit cursor placed. Uses `opts.cursor`\n * as the target; substitutes `landing` when the target falls outside a\n * non-empty settled selection; preserves the target when settled is empty\n * (matches Escape's \"cursor survives clear\" semantics).\n *\n * Callers pass `landing` precomputed from the pre-commit selection so this\n * helper doesn't need to reach back into the caller's overlay state.\n * Returns `settled` unchanged when the cursor is already correct so\n * mouseUp no-ops preserve reference equality.\n */\nexport function withCommittedCursor<S extends Selection>(\n  settled: S,\n  landing: { row: GridRangeIndex; column: GridRangeIndex } | null,\n  opts: CommitGestureOptions\n): S {\n  const target = opts.cursor;\n  if (target === undefined) return settled;\n\n  let desiredRow: GridRangeIndex;\n  let desiredColumn: GridRangeIndex;\n  if (settled.isEmpty()) {\n    desiredRow = target.row;\n    desiredColumn = target.column;\n  } else if (\n    target.row != null &&\n    target.column != null &&\n    settled.isCellSelected(target.column, target.row)\n  ) {\n    desiredRow = target.row;\n    desiredColumn = target.column;\n  } else {\n    desiredRow = landing?.row ?? null;\n    desiredColumn = landing?.column ?? null;\n  }\n\n  if (\n    settled.cursorRow === desiredRow &&\n    settled.cursorColumn === desiredColumn\n  ) {\n    return settled;\n  }\n  return settled.withCursor(desiredRow, desiredColumn) as S;\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/RangedSelection.d.ts

@@ -0,0 +1,120 @@
+import GridRange, { type GridRangeIndex, type SELECTION_DIRECTION } from './GridRange';
+import type { VisibleIndex } from './GridMetrics';
+import { type BoundedAxisRange } from './GridAxisRange';
+import type { CommitGestureOptions, GestureExtendOptions, GetModel, Selection, TickRangeSelection } from './Selection';
+/**
+ * Immutable `Selection` for standard (row-indexed) grids. Each entry in
+ * `ranges` describes a rectangle of cells; consumers iterate/consolidate
+ * as needed.
+ */
+export declare class RangedSelection implements Selection, TickRangeSelection {
+    /** Committed selection rectangles; may be empty for a cleared selection. */
+    readonly ranges: readonly GridRange[];
+    /**
+     * Deferred lookup for the current `GridModel`. Passed as a closure
+     * (not a direct reference) so this Selection always reads the model
+     * currently on `Grid.props.model` — surviving prop swaps without
+     * holding a stale reference.
+     */
+    private readonly getModel;
+    /** Anchor row for shift-click / keyboard extend; null when no anchor is set. */
+    private readonly gestureStartRow;
+    /** Anchor column for shift-click / keyboard extend; null when no anchor is set. */
+    private readonly gestureStartColumn;
+    /** Focus row; null when no cursor is set. */
+    readonly cursorRow: VisibleIndex | null;
+    /** Focus column; null when no cursor is set. */
+    readonly cursorColumn: VisibleIndex | null;
+    /** Last shift/drag endpoint row; null when unset. */
+    readonly selectionEndRow: VisibleIndex | null;
+    /** Last shift/drag endpoint column; null when unset. */
+    readonly selectionEndColumn: VisibleIndex | null;
+    static empty(getModel: GetModel): RangedSelection;
+    constructor(
+    /** Committed selection rectangles; may be empty for a cleared selection. */
+    ranges: readonly GridRange[], 
+    /**
+     * Deferred lookup for the current `GridModel`. Passed as a closure
+     * (not a direct reference) so this Selection always reads the model
+     * currently on `Grid.props.model` — surviving prop swaps without
+     * holding a stale reference.
+     */
+    getModel: GetModel, 
+    /** Anchor row for shift-click / keyboard extend; null when no anchor is set. */
+    gestureStartRow?: GridRangeIndex, 
+    /** Anchor column for shift-click / keyboard extend; null when no anchor is set. */
+    gestureStartColumn?: GridRangeIndex, 
+    /** Focus row; null when no cursor is set. */
+    cursorRow?: VisibleIndex | null, 
+    /** Focus column; null when no cursor is set. */
+    cursorColumn?: VisibleIndex | null, 
+    /** Last shift/drag endpoint row; null when unset. */
+    selectionEndRow?: VisibleIndex | null, 
+    /** Last shift/drag endpoint column; null when unset. */
+    selectionEndColumn?: VisibleIndex | null);
+    /**
+     * Returns a copy with the given fields overridden. Unspecified fields
+     * carry through from `this`, so mutations that only touch ranges /
+     * anchor keep cursor + endpoint intact without extra bookkeeping at
+     * every call site.
+     */
+    private copyWith;
+    isEmpty(): boolean;
+    describe(): string;
+    isCellSelected(column: VisibleIndex, row: VisibleIndex): boolean;
+    isRowSelected(row: VisibleIndex): boolean;
+    isColumnSelected(column: VisibleIndex): boolean;
+    /**
+     * Checks if all ranges are within the bounds of the grid model.
+     * @returns True if all ranges are within bounds, false otherwise.
+     */
+    isInBounds(): boolean;
+    toRanges(): readonly GridRange[];
+    getColumnTickRanges(): readonly BoundedAxisRange[];
+    getRowTickRanges(): readonly BoundedAxisRange[];
+    private cachedColumnTickRanges;
+    private cachedRowTickRanges;
+    withCommittedRanges(ranges: readonly GridRange[], anchor?: {
+        row: GridRangeIndex;
+        column: GridRangeIndex;
+    }): RangedSelection;
+    /**
+     * Sets the gesture anchor (extend-from position for shift-click and
+     * keyboard extend) to the given cell. Passing `null` for both clears it.
+     */
+    private withGestureAnchor;
+    /**
+     * The current `{row, column}` of the gesture anchor, or `null` if none is set.
+     */
+    private getGestureAnchor;
+    selectAll(): RangedSelection;
+    getNextCursorInDirection(current: {
+        row: GridRangeIndex;
+        column: GridRangeIndex;
+    }, direction: SELECTION_DIRECTION): {
+        row: GridRangeIndex;
+        column: GridRangeIndex;
+    } | null;
+    private getCursorLandingCell;
+    withCursor(row: VisibleIndex | null, column: VisibleIndex | null): RangedSelection;
+    withSelectionEnd(row: VisibleIndex | null, column: VisibleIndex | null): RangedSelection;
+    withGestureExtend(cursor: {
+        row: GridRangeIndex;
+        column: GridRangeIndex;
+    }, opts: GestureExtendOptions): RangedSelection;
+    commitGesture(lastCommitted: Selection, opts: CommitGestureOptions): RangedSelection;
+    clear(): RangedSelection;
+    trimmed(): RangedSelection;
+    truncate(maxRows: number): RangedSelection;
+}
+export declare function isRangedSelection(selection: Selection): selection is RangedSelection;
+export declare function assertIsRangedSelection(selection: Selection): asserts selection is RangedSelection;
+/**
+ * Returns `selection.toRanges()` when `selection` is a `RangedSelection`,
+ * otherwise `EMPTY_ARRAY`. Handy for consumers that only care about the
+ * range-form projection of a selection (e.g. legacy `selectedRanges`
+ * callbacks) and want a stable empty array for keyed / null selections.
+ */
+export declare function selectionToRanges(selection: Selection | null | undefined): readonly GridRange[];
+export default RangedSelection;
+//# sourceMappingURL=RangedSelection.d.ts.map

package/dist/RangedSelection.d.ts.map

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