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

package/dist/Selection.js

@@ -0,0 +1,71 @@
+/** Provides current model data to Selection instances without holding a stale reference. */
+
+/**
+ * Immutable value object representing the current selection state of the grid.
+ * Mutations return new instances; Grid stores the result in React state.
+ *
+ * Composed from five sub-interfaces:
+ * - `SelectionQueries` — read-only inspection.
+ * - `SelectionTransforms` — immutable transforms with no external dependencies.
+ * - `ProgrammaticSelection` — programmatic write path (`Grid.setSelectedRanges`).
+ * - `MouseSelection` — mouse-driven gestures (click, shift-click, drag).
+ * - `KeyboardSelection` — keyboard-driven queries (Tab/Enter advance, cursor
+ *   landing after commit).
+ */
+
+/** Read-only inspection of a `Selection`. Every method is side-effect-free. */
+
+/**
+ * Optional capability implemented by selections that can project onto
+ * scrollbar tick marks. Ranges are returned sorted by start and merged so
+ * consumers can iterate directly without re-normalizing per frame.
+ */
+
+export function isTickRangeSelection(selection) {
+  return typeof selection.getColumnTickRanges === 'function' && typeof selection.getRowTickRanges === 'function';
+}
+
+/**
+ * Immutable transformations of a `Selection` that need no external context.
+ * Each method returns a new `Selection`; the receiver is never modified.
+ */
+
+/**
+ * Programmatic write path: install a caller-supplied set of ranges as the
+ * committed selection. Used by `Grid.setSelectedRanges`, `setFocusRow`, and
+ * `moveCursorInDirection`. Distinct from gesture-driven writes, which are
+ * being reworked in the `MouseSelection` / `KeyboardSelection` interfaces.
+ */
+
+/**
+ * Modifier-key-derived mode for a mouse gesture:
+ * - `replace` — plain click: clear the current selection and install a
+ *   single cell at the cursor.
+ * - `add` — ctrl/meta click: keep the current selection and add a single
+ *   cell at the cursor.
+ * - `extend` — shift click / drag: trim to the last range and extend it
+ *   from the gesture anchor to the cursor.
+ * - `maximize` — ctrl+shift click: keep all ranges, grow the last range
+ *   to include the cursor.
+ */
+
+/** Options for `MouseSelection.withGestureExtend`. */
+
+/** Options for `MouseSelection.commitGesture`. */
+
+/**
+ * Mouse-driven selection updates. Both `withGestureExtend` and
+ * `commitGesture` are called by `Grid`'s mouse handlers.
+ *
+ * A gesture starts on mouse-down, may extend across drag frames, and settles
+ * on mouse-up. Each drag frame calls `withGestureExtend` to update the
+ * transient overlay; `commitGesture` folds the overlay into the committed
+ * selection.
+ */
+
+/**
+ * Keyboard-driven selection queries. Grid's key handlers use these to advance
+ * the cursor within the current selection (Tab/Enter) and to place the cursor
+ * after a commit or programmatic install.
+ */
+//# sourceMappingURL=Selection.js.map

package/dist/Selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Selection.js","names":["isTickRangeSelection","selection","getColumnTickRanges","getRowTickRanges"],"sources":["../src/Selection.ts"],"sourcesContent":["import type GridRange from './GridRange';\nimport type { GridRangeIndex, SELECTION_DIRECTION } from './GridRange';\nimport type GridModel from './GridModel';\nimport type { VisibleIndex } from './GridMetrics';\nimport type { BoundedAxisRange } from './GridAxisRange';\n\n/** Provides current model data to Selection instances without holding a stale reference. */\nexport type GetModel = () => GridModel;\n\n/**\n * Immutable value object representing the current selection state of the grid.\n * Mutations return new instances; Grid stores the result in React state.\n *\n * Composed from five sub-interfaces:\n * - `SelectionQueries` — read-only inspection.\n * - `SelectionTransforms` — immutable transforms with no external dependencies.\n * - `ProgrammaticSelection` — programmatic write path (`Grid.setSelectedRanges`).\n * - `MouseSelection` — mouse-driven gestures (click, shift-click, drag).\n * - `KeyboardSelection` — keyboard-driven queries (Tab/Enter advance, cursor\n *   landing after commit).\n */\nexport interface Selection\n  extends SelectionQueries,\n    SelectionTransforms,\n    ProgrammaticSelection,\n    MouseSelection,\n    KeyboardSelection {}\n\n/** Read-only inspection of a `Selection`. Every method is side-effect-free. */\nexport interface SelectionQueries {\n  /** True when the selection contains no cells and no in-progress gesture. */\n  isEmpty: () => boolean;\n  /** True when `(column, row)` is part of the selection. */\n  isCellSelected: (column: VisibleIndex, row: VisibleIndex) => boolean;\n  /** True when the entire row is part of the selection. */\n  isRowSelected: (row: VisibleIndex) => boolean;\n  /** True when the entire column is part of the selection. */\n  isColumnSelected: (column: VisibleIndex) => boolean;\n  /** The focus cell's row, or `null` when there is no cursor set. */\n  readonly cursorRow: VisibleIndex | null;\n  /** The focus cell's column, or `null` when there is no cursor set. */\n  readonly cursorColumn: VisibleIndex | null;\n  /** Row of the last shift/drag endpoint, or `null` when unset. */\n  readonly selectionEndRow: VisibleIndex | null;\n  /** Column of the last shift/drag endpoint, or `null` when unset. */\n  readonly selectionEndColumn: VisibleIndex | null;\n  /** Brief human-readable summary of the selection. Used for a11y status. */\n  describe: () => string;\n}\n\n/**\n * Optional capability implemented by selections that can project onto\n * scrollbar tick marks. Ranges are returned sorted by start and merged so\n * consumers can iterate directly without re-normalizing per frame.\n */\nexport interface TickRangeSelection {\n  /**\n   * Sorted, non-overlapping column `[start, end]` pairs for scrollbar tick\n   * rendering.\n   */\n  getColumnTickRanges: () => readonly BoundedAxisRange[];\n  /**\n   * Sorted, non-overlapping row `[start, end]` pairs for scrollbar tick\n   * rendering.\n   */\n  getRowTickRanges: () => readonly BoundedAxisRange[];\n}\n\nexport function isTickRangeSelection(\n  selection: Selection\n): selection is Selection & TickRangeSelection {\n  return (\n    typeof (selection as Partial<TickRangeSelection>).getColumnTickRanges ===\n      'function' &&\n    typeof (selection as Partial<TickRangeSelection>).getRowTickRanges ===\n      'function'\n  );\n}\n\n/**\n * Immutable transformations of a `Selection` that need no external context.\n * Each method returns a new `Selection`; the receiver is never modified.\n */\nexport interface SelectionTransforms {\n  /** A fresh empty selection with no committed state, overlay, or anchor. */\n  clear: () => Selection;\n  /**\n   * A new selection keeping only the last committed range (for\n   * `RangedSelection`) or clearing committed keys (for `KeyedSelection`).\n   * Called by `Grid.trimSelectedRanges` immediately before shift-based\n   * extend so the anchor is preserved.\n   */\n  trimmed: () => Selection;\n  /** A new selection covering the entire grid. */\n  selectAll: () => Selection;\n  /** A new selection containing at most `maxRows` rows. */\n  truncate: (maxRows: number) => Selection;\n}\n\n/**\n * Programmatic write path: install a caller-supplied set of ranges as the\n * committed selection. Used by `Grid.setSelectedRanges`, `setFocusRow`, and\n * `moveCursorInDirection`. Distinct from gesture-driven writes, which are\n * being reworked in the `MouseSelection` / `KeyboardSelection` interfaces.\n */\nexport interface ProgrammaticSelection {\n  /**\n   * Replaces the committed selection with the given ranges and clears any\n   * transient overlay state. When `anchor` is provided, sets the gesture\n   * anchor (extend-from position for shift-click and keyboard extend) to\n   * the given cell; otherwise clears it.\n   */\n  withCommittedRanges: (\n    ranges: readonly GridRange[],\n    anchor?: { row: GridRangeIndex; column: GridRangeIndex }\n  ) => Selection;\n}\n\n/**\n * Modifier-key-derived mode for a mouse gesture:\n * - `replace` — plain click: clear the current selection and install a\n *   single cell at the cursor.\n * - `add` — ctrl/meta click: keep the current selection and add a single\n *   cell at the cursor.\n * - `extend` — shift click / drag: trim to the last range and extend it\n *   from the gesture anchor to the cursor.\n * - `maximize` — ctrl+shift click: keep all ranges, grow the last range\n *   to include the cursor.\n */\nexport type GestureMode = 'replace' | 'add' | 'extend' | 'maximize';\n\n/** Options for `MouseSelection.withGestureExtend`. */\nexport type GestureExtendOptions = {\n  /** How the current selection should be combined with the incoming cursor. */\n  mode: GestureMode;\n  /** Full-row selection mode (theme `autoSelectRow`). */\n  autoSelectRow: boolean;\n  /** Full-column selection mode (theme `autoSelectColumn`). */\n  autoSelectColumn: boolean;\n};\n\n/** Options for `MouseSelection.commitGesture`. */\nexport type CommitGestureOptions = {\n  /**\n   * When true, a single-row commit that repeats the previous single-row\n   * selection is treated as a deselect. Matches the `autoSelectRow` theme\n   * flag semantic.\n   */\n  autoSelectRow: boolean;\n  /**\n   * Post-commit cursor position. When `settled` is non-empty and this\n   * cursor falls outside it, `commitGesture` substitutes a landing cell\n   * from the pre-commit selection. When `settled` is empty, this cursor\n   * is preserved on the returned selection (matches Escape semantics).\n   * Omit for no-op commits that shouldn't touch cursor.\n   */\n  cursor?: { row: GridRangeIndex; column: GridRangeIndex };\n  /**\n   * When true (default), a commit whose settled ranges match the previous\n   * single-row / single-cell committed selection is treated as a deselect.\n   * This is the mouse click-to-deselect affordance. Keyboard callers pass\n   * `false` so arrowing onto an already-selected cell just moves the cursor\n   * instead of clearing the selection.\n   */\n  allowDeselect?: boolean;\n  /**\n   * When true (default), the commit finalizes the gesture: deselect check,\n   * hole-punch on overlap, and range consolidation all run. Pass `false`\n   * from mouse-down so those steps defer to mouse-up; between them the\n   * drag can grow the last range without eagerly fragmenting the prior\n   * selection.\n   */\n  settle?: boolean;\n};\n\n/**\n * Mouse-driven selection updates. Both `withGestureExtend` and\n * `commitGesture` are called by `Grid`'s mouse handlers.\n *\n * A gesture starts on mouse-down, may extend across drag frames, and settles\n * on mouse-up. Each drag frame calls `withGestureExtend` to update the\n * transient overlay; `commitGesture` folds the overlay into the committed\n * selection.\n */\nexport interface MouseSelection {\n  /**\n   * Applies a mouse gesture that moves the selection to `cursor` per `opts`.\n   * `mode` chooses replace / add / extend / maximize semantics based on the\n   * modifier keys the caller observed.\n   *\n   * Returns a transient overlay-updated selection. Caller controls when to\n   * `commitGesture` — mouse handlers commit on mouse-up only; a plain click\n   * commits immediately.\n   */\n  withGestureExtend: (\n    cursor: { row: GridRangeIndex; column: GridRangeIndex },\n    opts: GestureExtendOptions\n  ) => Selection;\n\n  /**\n   * Settles the current transient overlay into the committed selection.\n   * Handles consolidation, deselect-on-reclick, and subtract logic. Returns\n   * identity (`this`) when there is nothing to commit.\n   *\n   * `lastCommitted` is the selection state as it was BEFORE the current\n   * gesture began. Grid pins this in state at gesture-start so the\n   * deselect-on-reclick comparison stays stable across drag frames.\n   */\n  commitGesture: (\n    lastCommitted: Selection,\n    opts: CommitGestureOptions\n  ) => Selection;\n}\n\n/**\n * Keyboard-driven selection queries. Grid's key handlers use these to advance\n * the cursor within the current selection (Tab/Enter) and to place the cursor\n * after a commit or programmatic install.\n */\nexport interface KeyboardSelection {\n  /**\n   * Returns the next cursor cell in `direction` starting from `current`.\n   * When the selection is empty or has exactly one cell, walks the whole\n   * grid (wrapping at edges) so a lone Tab still moves the cursor.\n   * Otherwise cycles through the currently selected ranges.\n   */\n  getNextCursorInDirection: (\n    current: { row: GridRangeIndex; column: GridRangeIndex },\n    direction: SELECTION_DIRECTION\n  ) => { row: GridRangeIndex; column: GridRangeIndex } | null;\n\n  /**\n   * A new selection with the cursor set to `(column, row)`. Passing `null`\n   * for both clears the cursor. Non-cursor state (ranges, keys, anchor,\n   * selection endpoint) is preserved.\n   */\n  withCursor: (\n    row: VisibleIndex | null,\n    column: VisibleIndex | null\n  ) => Selection;\n\n  /**\n   * A new selection with the shift/drag endpoint set to `(column, row)`.\n   * Passing `null` for both clears the endpoint. Non-endpoint state\n   * (ranges, keys, anchor, cursor) is preserved.\n   */\n  withSelectionEnd: (\n    row: VisibleIndex | null,\n    column: VisibleIndex | null\n  ) => Selection;\n}\n"],"mappings":"AAMA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAQA;;AAsBA;AACA;AACA;AACA;AACA;;AAcA,OAAO,SAASA,oBAAoBA,CAClCC,SAAoB,EACyB;EAC7C,OACE,OAAQA,SAAS,CAAiCC,mBAAmB,KACnE,UAAU,IACZ,OAAQD,SAAS,CAAiCE,gBAAgB,KAChE,UAAU;AAEhB;;AAEA;AACA;AACA;AACA;;AAiBA;AACA;AACA;AACA;AACA;AACA;;AAcA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;;AAUA;;AAkCA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AA+BA;AACA;AACA;AACA;AACA","ignoreList":[]}

package/dist/index.d.ts

@@ -8,6 +8,9 @@ export * from './ExpandableGridModel';
 export * from './ExpandableColumnGridModel';
 export { default as Grid } from './Grid';
 export * from './Grid';
+export * from './GridA11yUtils';
+export { default as GridA11yFallback } from './GridA11yFallback';
+export * from './GridA11yFallback';
 export * from './GridMetricCalculator';
 export * from './GridMetrics';
 export { default as GridModel } from './GridModel';
@@ -30,6 +33,9 @@ export { default as ViewportDataGridModel } from './ViewportDataGridModel';
 export { default as MockDataBarGridModel } from './MockDataBarGridModel';
 export * from './key-handlers';
 export * from './mouse-handlers';
+export * from './Selection';
+export * from './GridSelectionUtils';
+export { RangedSelection, isRangedSelection, assertIsRangedSelection, selectionToRanges, } from './RangedSelection';
 export * from './errors';
 export * from './EventHandlerResult';
 export * from './ThemeContext';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC7D,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,QAAQ,CAAC;AACzC,cAAc,QAAQ,CAAC;AACvB,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,aAAa,CAAC;AACnD,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC3D,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,aAAa,CAAC;AAC9D,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACzE,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACzD,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACvE,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC7D,YAAY,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC7D,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,QAAQ,CAAC;AACzC,cAAc,QAAQ,CAAC;AACvB,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACjE,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,aAAa,CAAC;AACnD,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC3D,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,aAAa,CAAC;AAC9D,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACzE,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACzD,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACvE,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC7D,YAAY,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -8,6 +8,9 @@ export * from "./ExpandableGridModel.js";
 export * from "./ExpandableColumnGridModel.js";
 export { default as Grid } from "./Grid.js";
 export * from "./Grid.js";
+export * from "./GridA11yUtils.js";
+export { default as GridA11yFallback } from "./GridA11yFallback.js";
+export * from "./GridA11yFallback.js";
 export * from "./GridMetricCalculator.js";
 export * from "./GridMetrics.js";
 export { default as GridModel } from "./GridModel.js";
@@ -29,6 +32,9 @@ export { default as ViewportDataGridModel } from "./ViewportDataGridModel.js";
 export { default as MockDataBarGridModel } from "./MockDataBarGridModel.js";
 export * from "./key-handlers/index.js";
 export * from "./mouse-handlers/index.js";
+export * from "./Selection.js";
+export * from "./GridSelectionUtils.js";
+export { RangedSelection, isRangedSelection, assertIsRangedSelection, selectionToRanges } from "./RangedSelection.js";
 export * from "./errors/index.js";
 export * from "./EventHandlerResult.js";
 export * from "./ThemeContext.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["default","CellInputField","Grid","GridModel","GridTestUtils","GridTheme","KeyHandler","MockGridModel","MockTreeGridModel","memoizeClear","StaticDataGridModel","ViewportDataGridModel","MockDataBarGridModel","CellRenderer","TextCellRenderer","DataBarCellRenderer","GridColorUtils"],"sources":["../src/index.ts"],"sourcesContent":["export { default as CellInputField } from './CellInputField';\nexport * from './CellInputField';\nexport * from './GridRendererTypes';\nexport * from './ColumnHeaderGroup';\nexport * from './EditableGridModel';\nexport * from './DeletableGridModel';\nexport * from './ExpandableGridModel';\nexport * from './ExpandableColumnGridModel';\nexport { default as Grid } from './Grid';\nexport * from './Grid';\nexport * from './GridMetricCalculator';\nexport * from './GridMetrics';\nexport { default as GridModel } from './GridModel';\nexport * from './GridModel';\nexport * from './GridMouseHandler';\nexport * from './GridRange';\nexport * from './GridAxisRange';\nexport * from './GridRenderer';\nexport { default as GridTestUtils } from './GridTestUtils';\nexport * from './GridTheme';\nexport { default as GridTheme } from './GridTheme';\nexport type { GridTheme as GridThemeType } from './GridTheme';\nexport * from './GridUtils';\nexport { default as KeyHandler } from './KeyHandler';\nexport { default as MockGridModel } from './MockGridModel';\nexport { default as MockTreeGridModel } from './MockTreeGridModel';\nexport { default as memoizeClear } from './memoizeClear';\nexport { default as StaticDataGridModel } from './StaticDataGridModel';\nexport { default as ViewportDataGridModel } from './ViewportDataGridModel';\nexport { default as MockDataBarGridModel } from './MockDataBarGridModel';\nexport * from './key-handlers';\nexport * from './mouse-handlers';\nexport * from './errors';\nexport * from './EventHandlerResult';\nexport * from './ThemeContext';\nexport { default as CellRenderer } from './CellRenderer';\nexport type { CellRenderType } from './CellRenderer';\nexport { default as TextCellRenderer } from './TextCellRenderer';\nexport { default as DataBarCellRenderer } from './DataBarCellRenderer';\nexport * from './TokenBoxCellRenderer';\nexport * from './GridRendererTypes';\nexport * from './DataBarGridModel';\nexport { default as GridColorUtils } from './GridColorUtils';\nexport type { RGB, Oklab } from './GridColorUtils';\n"],"mappings":"SAASA,OAAO,IAAIC,cAAc;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,SAQzBD,OAAO,IAAIE,IAAI;AAAA;AAAA;AAAA;AAAA,SAIfF,OAAO,IAAIG,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,SAMpBH,OAAO,IAAII,aAAa;AAAA;AAAA,SAExBJ,OAAO,IAAIK,SAAS;AAAA;AAAA,SAGpBL,OAAO,IAAIM,UAAU;AAAA,SACrBN,OAAO,IAAIO,aAAa;AAAA,SACxBP,OAAO,IAAIQ,iBAAiB;AAAA,SAC5BR,OAAO,IAAIS,YAAY;AAAA,SACvBT,OAAO,IAAIU,mBAAmB;AAAA,SAC9BV,OAAO,IAAIW,qBAAqB;AAAA,SAChCX,OAAO,IAAIY,oBAAoB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,SAM/BZ,OAAO,IAAIa,YAAY;AAAA,SAEvBb,OAAO,IAAIc,gBAAgB;AAAA,SAC3Bd,OAAO,IAAIe,mBAAmB;AAAA;AAAA;AAAA;AAAA,SAI9Bf,OAAO,IAAIgB,cAAc","ignoreList":[]}
+{"version":3,"file":"index.js","names":["default","CellInputField","Grid","GridA11yFallback","GridModel","GridTestUtils","GridTheme","KeyHandler","MockGridModel","MockTreeGridModel","memoizeClear","StaticDataGridModel","ViewportDataGridModel","MockDataBarGridModel","RangedSelection","isRangedSelection","assertIsRangedSelection","selectionToRanges","CellRenderer","TextCellRenderer","DataBarCellRenderer","GridColorUtils"],"sources":["../src/index.ts"],"sourcesContent":["export { default as CellInputField } from './CellInputField';\nexport * from './CellInputField';\nexport * from './GridRendererTypes';\nexport * from './ColumnHeaderGroup';\nexport * from './EditableGridModel';\nexport * from './DeletableGridModel';\nexport * from './ExpandableGridModel';\nexport * from './ExpandableColumnGridModel';\nexport { default as Grid } from './Grid';\nexport * from './Grid';\nexport * from './GridA11yUtils';\nexport { default as GridA11yFallback } from './GridA11yFallback';\nexport * from './GridA11yFallback';\nexport * from './GridMetricCalculator';\nexport * from './GridMetrics';\nexport { default as GridModel } from './GridModel';\nexport * from './GridModel';\nexport * from './GridMouseHandler';\nexport * from './GridRange';\nexport * from './GridAxisRange';\nexport * from './GridRenderer';\nexport { default as GridTestUtils } from './GridTestUtils';\nexport * from './GridTheme';\nexport { default as GridTheme } from './GridTheme';\nexport type { GridTheme as GridThemeType } from './GridTheme';\nexport * from './GridUtils';\nexport { default as KeyHandler } from './KeyHandler';\nexport { default as MockGridModel } from './MockGridModel';\nexport { default as MockTreeGridModel } from './MockTreeGridModel';\nexport { default as memoizeClear } from './memoizeClear';\nexport { default as StaticDataGridModel } from './StaticDataGridModel';\nexport { default as ViewportDataGridModel } from './ViewportDataGridModel';\nexport { default as MockDataBarGridModel } from './MockDataBarGridModel';\nexport * from './key-handlers';\nexport * from './mouse-handlers';\nexport * from './Selection';\nexport * from './GridSelectionUtils';\nexport {\n  RangedSelection,\n  isRangedSelection,\n  assertIsRangedSelection,\n  selectionToRanges,\n} from './RangedSelection';\nexport * from './errors';\nexport * from './EventHandlerResult';\nexport * from './ThemeContext';\nexport { default as CellRenderer } from './CellRenderer';\nexport type { CellRenderType } from './CellRenderer';\nexport { default as TextCellRenderer } from './TextCellRenderer';\nexport { default as DataBarCellRenderer } from './DataBarCellRenderer';\nexport * from './TokenBoxCellRenderer';\nexport * from './GridRendererTypes';\nexport * from './DataBarGridModel';\nexport { default as GridColorUtils } from './GridColorUtils';\nexport type { RGB, Oklab } from './GridColorUtils';\n"],"mappings":"SAASA,OAAO,IAAIC,cAAc;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,SAQzBD,OAAO,IAAIE,IAAI;AAAA;AAAA;AAAA,SAGfF,OAAO,IAAIG,gBAAgB;AAAA;AAAA;AAAA;AAAA,SAI3BH,OAAO,IAAII,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,SAMpBJ,OAAO,IAAIK,aAAa;AAAA;AAAA,SAExBL,OAAO,IAAIM,SAAS;AAAA;AAAA,SAGpBN,OAAO,IAAIO,UAAU;AAAA,SACrBP,OAAO,IAAIQ,aAAa;AAAA,SACxBR,OAAO,IAAIS,iBAAiB;AAAA,SAC5BT,OAAO,IAAIU,YAAY;AAAA,SACvBV,OAAO,IAAIW,mBAAmB;AAAA,SAC9BX,OAAO,IAAIY,qBAAqB;AAAA,SAChCZ,OAAO,IAAIa,oBAAoB;AAAA;AAAA;AAAA;AAAA;AAAA,SAMtCC,eAAe,EACfC,iBAAiB,EACjBC,uBAAuB,EACvBC,iBAAiB;AAAA;AAAA;AAAA;AAAA,SAKVjB,OAAO,IAAIkB,YAAY;AAAA,SAEvBlB,OAAO,IAAImB,gBAAgB;AAAA,SAC3BnB,OAAO,IAAIoB,mBAAmB;AAAA;AAAA;AAAA;AAAA,SAI9BpB,OAAO,IAAIqB,cAAc","ignoreList":[]}

package/dist/key-handlers/EditKeyHandler.js

@@ -9,9 +9,9 @@ class EditKeyHandler extends KeyHandler {
       return false;
     }
     var model = grid.props.model;
-    var _grid$state = grid.state,
-      cursorColumn = _grid$state.cursorColumn,
-      cursorRow = _grid$state.cursorRow;
+    var _grid$state$selection = grid.state.selection,
+      cursorColumn = _grid$state$selection.cursorColumn,
+      cursorRow = _grid$state$selection.cursorRow;
     if (cursorColumn == null || cursorRow == null || !isEditableGridModel(model)) {
       return false;
     }

package/dist/key-handlers/EditKeyHandler.js.map

@@ -1 +1 @@
-{"version":3,"file":"EditKeyHandler.js","names":["GridUtils","GridRange","KeyHandler","isEditableGridModel","EditKeyHandler","onDown","event","grid","isModifierKeyDown","model","props","_grid$state","state","cursorColumn","cursorRow","modelColumn","modelRow","getModelColumn","getModelRow","_unused","isEditableRange","makeCell","key","length","cellInputRendererRegistry","restrictions","getColumnRestrictions","renderer","get","type","preservesExistingValue","startEditing","undefined","setValueForCell"],"sources":["../../src/key-handlers/EditKeyHandler.ts"],"sourcesContent":["/* eslint class-methods-use-this: \"off\" */\nimport GridUtils from '../GridUtils';\nimport type Grid from '../Grid';\nimport GridRange from '../GridRange';\nimport KeyHandler, { type GridKeyboardEvent } from '../KeyHandler';\nimport { isEditableGridModel } from '../EditableGridModel';\nimport { type EventHandlerResult } from '../EventHandlerResult';\n\nclass EditKeyHandler extends KeyHandler {\n  onDown(event: GridKeyboardEvent, grid: Grid): EventHandlerResult {\n    if (GridUtils.isModifierKeyDown(event)) {\n      return false;\n    }\n\n    const { model } = grid.props;\n    const { cursorColumn, cursorRow } = grid.state;\n    if (\n      cursorColumn == null ||\n      cursorRow == null ||\n      !isEditableGridModel(model)\n    ) {\n      return false;\n    }\n\n    let modelColumn: number;\n    let modelRow: number;\n    try {\n      modelColumn = grid.getModelColumn(cursorColumn);\n      modelRow = grid.getModelRow(cursorRow);\n    } catch {\n      return false;\n    }\n\n    if (!model.isEditableRange(GridRange.makeCell(modelColumn, modelRow))) {\n      return false;\n    }\n\n    if (event.key.length === 1) {\n      // If the renderer for this cell's restriction type preserves the existing\n      // value on keystroke (e.g. a dropdown), open the editor without replacing.\n      const { cellInputRendererRegistry } = grid.props;\n      const restrictions = model.getColumnRestrictions(modelColumn);\n      if (restrictions.length === 1) {\n        const renderer = cellInputRendererRegistry?.get(restrictions[0].type);\n        if (renderer?.preservesExistingValue === true) {\n          grid.startEditing(cursorColumn, cursorRow);\n          return true;\n        }\n      }\n      grid.startEditing(cursorColumn, cursorRow, true, [1, 1], event.key);\n      return true;\n    }\n\n    if (event.key === 'F2') {\n      grid.startEditing(cursorColumn, cursorRow);\n      return true;\n    }\n\n    if (event.key === 'Enter') {\n      grid.startEditing(cursorColumn, cursorRow);\n      return true;\n    }\n\n    if (event.key === 'Backspace') {\n      grid.startEditing(cursorColumn, cursorRow, true, undefined, '');\n      return true;\n    }\n\n    if (event.key === 'Delete') {\n      grid.setValueForCell(cursorColumn, cursorRow, '');\n      return true;\n    }\n    return false;\n  }\n}\n\nexport default EditKeyHandler;\n"],"mappings":"AAAA;AAAA,OACOA,SAAS;AAAA,OAETC,SAAS;AAAA,OACTC,UAAU;AAAA,SACRC,mBAAmB;AAG5B,MAAMC,cAAc,SAASF,UAAU,CAAC;EACtCG,MAAMA,CAACC,KAAwB,EAAEC,IAAU,EAAsB;IAC/D,IAAIP,SAAS,CAACQ,iBAAiB,CAACF,KAAK,CAAC,EAAE;MACtC,OAAO,KAAK;IACd;IAEA,IAAQG,KAAK,GAAKF,IAAI,CAACG,KAAK,CAApBD,KAAK;IACb,IAAAE,WAAA,GAAoCJ,IAAI,CAACK,KAAK;MAAtCC,YAAY,GAAAF,WAAA,CAAZE,YAAY;MAAEC,SAAS,GAAAH,WAAA,CAATG,SAAS;IAC/B,IACED,YAAY,IAAI,IAAI,IACpBC,SAAS,IAAI,IAAI,IACjB,CAACX,mBAAmB,CAACM,KAAK,CAAC,EAC3B;MACA,OAAO,KAAK;IACd;IAEA,IAAIM,WAAmB;IACvB,IAAIC,QAAgB;IACpB,IAAI;MACFD,WAAW,GAAGR,IAAI,CAACU,cAAc,CAACJ,YAAY,CAAC;MAC/CG,QAAQ,GAAGT,IAAI,CAACW,WAAW,CAACJ,SAAS,CAAC;IACxC,CAAC,CAAC,OAAAK,OAAA,EAAM;MACN,OAAO,KAAK;IACd;IAEA,IAAI,CAACV,KAAK,CAACW,eAAe,CAACnB,SAAS,CAACoB,QAAQ,CAACN,WAAW,EAAEC,QAAQ,CAAC,CAAC,EAAE;MACrE,OAAO,KAAK;IACd;IAEA,IAAIV,KAAK,CAACgB,GAAG,CAACC,MAAM,KAAK,CAAC,EAAE;MAC1B;MACA;MACA,IAAQC,yBAAyB,GAAKjB,IAAI,CAACG,KAAK,CAAxCc,yBAAyB;MACjC,IAAMC,YAAY,GAAGhB,KAAK,CAACiB,qBAAqB,CAACX,WAAW,CAAC;MAC7D,IAAIU,YAAY,CAACF,MAAM,KAAK,CAAC,EAAE;QAC7B,IAAMI,QAAQ,GAAGH,yBAAyB,aAAzBA,yBAAyB,uBAAzBA,yBAAyB,CAAEI,GAAG,CAACH,YAAY,CAAC,CAAC,CAAC,CAACI,IAAI,CAAC;QACrE,IAAI,CAAAF,QAAQ,aAARA,QAAQ,uBAARA,QAAQ,CAAEG,sBAAsB,MAAK,IAAI,EAAE;UAC7CvB,IAAI,CAACwB,YAAY,CAAClB,YAAY,EAAEC,SAAS,CAAC;UAC1C,OAAO,IAAI;QACb;MACF;MACAP,IAAI,CAACwB,YAAY,CAAClB,YAAY,EAAEC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAER,KAAK,CAACgB,GAAG,CAAC;MACnE,OAAO,IAAI;IACb;IAEA,IAAIhB,KAAK,CAACgB,GAAG,KAAK,IAAI,EAAE;MACtBf,IAAI,CAACwB,YAAY,CAAClB,YAAY,EAAEC,SAAS,CAAC;MAC1C,OAAO,IAAI;IACb;IAEA,IAAIR,KAAK,CAACgB,GAAG,KAAK,OAAO,EAAE;MACzBf,IAAI,CAACwB,YAAY,CAAClB,YAAY,EAAEC,SAAS,CAAC;MAC1C,OAAO,IAAI;IACb;IAEA,IAAIR,KAAK,CAACgB,GAAG,KAAK,WAAW,EAAE;MAC7Bf,IAAI,CAACwB,YAAY,CAAClB,YAAY,EAAEC,SAAS,EAAE,IAAI,EAAEkB,SAAS,EAAE,EAAE,CAAC;MAC/D,OAAO,IAAI;IACb;IAEA,IAAI1B,KAAK,CAACgB,GAAG,KAAK,QAAQ,EAAE;MAC1Bf,IAAI,CAAC0B,eAAe,CAACpB,YAAY,EAAEC,SAAS,EAAE,EAAE,CAAC;MACjD,OAAO,IAAI;IACb;IACA,OAAO,KAAK;EACd;AACF;AAEA,eAAeV,cAAc","ignoreList":[]}
+{"version":3,"file":"EditKeyHandler.js","names":["GridUtils","GridRange","KeyHandler","isEditableGridModel","EditKeyHandler","onDown","event","grid","isModifierKeyDown","model","props","_grid$state$selection","state","selection","cursorColumn","cursorRow","modelColumn","modelRow","getModelColumn","getModelRow","_unused","isEditableRange","makeCell","key","length","cellInputRendererRegistry","restrictions","getColumnRestrictions","renderer","get","type","preservesExistingValue","startEditing","undefined","setValueForCell"],"sources":["../../src/key-handlers/EditKeyHandler.ts"],"sourcesContent":["/* eslint class-methods-use-this: \"off\" */\nimport GridUtils from '../GridUtils';\nimport type Grid from '../Grid';\nimport GridRange from '../GridRange';\nimport KeyHandler, { type GridKeyboardEvent } from '../KeyHandler';\nimport { isEditableGridModel } from '../EditableGridModel';\nimport { type EventHandlerResult } from '../EventHandlerResult';\n\nclass EditKeyHandler extends KeyHandler {\n  onDown(event: GridKeyboardEvent, grid: Grid): EventHandlerResult {\n    if (GridUtils.isModifierKeyDown(event)) {\n      return false;\n    }\n\n    const { model } = grid.props;\n    const { cursorColumn, cursorRow } = grid.state.selection;\n    if (\n      cursorColumn == null ||\n      cursorRow == null ||\n      !isEditableGridModel(model)\n    ) {\n      return false;\n    }\n\n    let modelColumn: number;\n    let modelRow: number;\n    try {\n      modelColumn = grid.getModelColumn(cursorColumn);\n      modelRow = grid.getModelRow(cursorRow);\n    } catch {\n      return false;\n    }\n\n    if (!model.isEditableRange(GridRange.makeCell(modelColumn, modelRow))) {\n      return false;\n    }\n\n    if (event.key.length === 1) {\n      // If the renderer for this cell's restriction type preserves the existing\n      // value on keystroke (e.g. a dropdown), open the editor without replacing.\n      const { cellInputRendererRegistry } = grid.props;\n      const restrictions = model.getColumnRestrictions(modelColumn);\n      if (restrictions.length === 1) {\n        const renderer = cellInputRendererRegistry?.get(restrictions[0].type);\n        if (renderer?.preservesExistingValue === true) {\n          grid.startEditing(cursorColumn, cursorRow);\n          return true;\n        }\n      }\n      grid.startEditing(cursorColumn, cursorRow, true, [1, 1], event.key);\n      return true;\n    }\n\n    if (event.key === 'F2') {\n      grid.startEditing(cursorColumn, cursorRow);\n      return true;\n    }\n\n    if (event.key === 'Enter') {\n      grid.startEditing(cursorColumn, cursorRow);\n      return true;\n    }\n\n    if (event.key === 'Backspace') {\n      grid.startEditing(cursorColumn, cursorRow, true, undefined, '');\n      return true;\n    }\n\n    if (event.key === 'Delete') {\n      grid.setValueForCell(cursorColumn, cursorRow, '');\n      return true;\n    }\n    return false;\n  }\n}\n\nexport default EditKeyHandler;\n"],"mappings":"AAAA;AAAA,OACOA,SAAS;AAAA,OAETC,SAAS;AAAA,OACTC,UAAU;AAAA,SACRC,mBAAmB;AAG5B,MAAMC,cAAc,SAASF,UAAU,CAAC;EACtCG,MAAMA,CAACC,KAAwB,EAAEC,IAAU,EAAsB;IAC/D,IAAIP,SAAS,CAACQ,iBAAiB,CAACF,KAAK,CAAC,EAAE;MACtC,OAAO,KAAK;IACd;IAEA,IAAQG,KAAK,GAAKF,IAAI,CAACG,KAAK,CAApBD,KAAK;IACb,IAAAE,qBAAA,GAAoCJ,IAAI,CAACK,KAAK,CAACC,SAAS;MAAhDC,YAAY,GAAAH,qBAAA,CAAZG,YAAY;MAAEC,SAAS,GAAAJ,qBAAA,CAATI,SAAS;IAC/B,IACED,YAAY,IAAI,IAAI,IACpBC,SAAS,IAAI,IAAI,IACjB,CAACZ,mBAAmB,CAACM,KAAK,CAAC,EAC3B;MACA,OAAO,KAAK;IACd;IAEA,IAAIO,WAAmB;IACvB,IAAIC,QAAgB;IACpB,IAAI;MACFD,WAAW,GAAGT,IAAI,CAACW,cAAc,CAACJ,YAAY,CAAC;MAC/CG,QAAQ,GAAGV,IAAI,CAACY,WAAW,CAACJ,SAAS,CAAC;IACxC,CAAC,CAAC,OAAAK,OAAA,EAAM;MACN,OAAO,KAAK;IACd;IAEA,IAAI,CAACX,KAAK,CAACY,eAAe,CAACpB,SAAS,CAACqB,QAAQ,CAACN,WAAW,EAAEC,QAAQ,CAAC,CAAC,EAAE;MACrE,OAAO,KAAK;IACd;IAEA,IAAIX,KAAK,CAACiB,GAAG,CAACC,MAAM,KAAK,CAAC,EAAE;MAC1B;MACA;MACA,IAAQC,yBAAyB,GAAKlB,IAAI,CAACG,KAAK,CAAxCe,yBAAyB;MACjC,IAAMC,YAAY,GAAGjB,KAAK,CAACkB,qBAAqB,CAACX,WAAW,CAAC;MAC7D,IAAIU,YAAY,CAACF,MAAM,KAAK,CAAC,EAAE;QAC7B,IAAMI,QAAQ,GAAGH,yBAAyB,aAAzBA,yBAAyB,uBAAzBA,yBAAyB,CAAEI,GAAG,CAACH,YAAY,CAAC,CAAC,CAAC,CAACI,IAAI,CAAC;QACrE,IAAI,CAAAF,QAAQ,aAARA,QAAQ,uBAARA,QAAQ,CAAEG,sBAAsB,MAAK,IAAI,EAAE;UAC7CxB,IAAI,CAACyB,YAAY,CAAClB,YAAY,EAAEC,SAAS,CAAC;UAC1C,OAAO,IAAI;QACb;MACF;MACAR,IAAI,CAACyB,YAAY,CAAClB,YAAY,EAAEC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAET,KAAK,CAACiB,GAAG,CAAC;MACnE,OAAO,IAAI;IACb;IAEA,IAAIjB,KAAK,CAACiB,GAAG,KAAK,IAAI,EAAE;MACtBhB,IAAI,CAACyB,YAAY,CAAClB,YAAY,EAAEC,SAAS,CAAC;MAC1C,OAAO,IAAI;IACb;IAEA,IAAIT,KAAK,CAACiB,GAAG,KAAK,OAAO,EAAE;MACzBhB,IAAI,CAACyB,YAAY,CAAClB,YAAY,EAAEC,SAAS,CAAC;MAC1C,OAAO,IAAI;IACb;IAEA,IAAIT,KAAK,CAACiB,GAAG,KAAK,WAAW,EAAE;MAC7BhB,IAAI,CAACyB,YAAY,CAAClB,YAAY,EAAEC,SAAS,EAAE,IAAI,EAAEkB,SAAS,EAAE,EAAE,CAAC;MAC/D,OAAO,IAAI;IACb;IAEA,IAAI3B,KAAK,CAACiB,GAAG,KAAK,QAAQ,EAAE;MAC1BhB,IAAI,CAAC2B,eAAe,CAACpB,YAAY,EAAEC,SAAS,EAAE,EAAE,CAAC;MACjD,OAAO,IAAI;IACb;IACA,OAAO,KAAK;EACd;AACF;AAEA,eAAeX,cAAc","ignoreList":[]}

package/dist/key-handlers/SelectionKeyHandler.d.ts

@@ -4,6 +4,7 @@ import KeyHandler, { type GridKeyboardEvent } from '../KeyHandler';
 declare class SelectionKeyHandler extends KeyHandler {
     onDown(event: GridKeyboardEvent, grid: Grid): EventHandlerResult;
     handleArrowMove(deltaColumn: number, deltaRow: number, event: GridKeyboardEvent, grid: Grid): boolean;
+    handleRowEdge(targetColumn: number, event: GridKeyboardEvent, grid: Grid): boolean;
     handlePageUp(e: GridKeyboardEvent, grid: Grid): boolean;
     handlePageDown(e: GridKeyboardEvent, grid: Grid): boolean;
 }

package/dist/key-handlers/SelectionKeyHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SelectionKeyHandler.d.ts","sourceRoot":"","sources":["../../src/key-handlers/SelectionKeyHandler.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,IAAI,MAAM,SAAS,CAAC;AAGhC,OAAO,UAAU,EAAE,EAAE,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEnE,cAAM,mBAAoB,SAAQ,UAAU;IAC1C,MAAM,CAAC,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,IAAI,GAAG,kBAAkB;IAuHhE,eAAe,CACb,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,iBAAiB,EACxB,IAAI,EAAE,IAAI,GACT,OAAO;IAuEV,YAAY,CAAC,CAAC,EAAE,iBAAiB,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO;IAwCvD,cAAc,CAAC,CAAC,EAAE,iBAAiB,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO;CAyC1D;AAED,eAAe,mBAAmB,CAAC"}
+{"version":3,"file":"SelectionKeyHandler.d.ts","sourceRoot":"","sources":["../../src/key-handlers/SelectionKeyHandler.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,IAAI,MAAM,SAAS,CAAC;AAKhC,OAAO,UAAU,EAAE,EAAE,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEnE,cAAM,mBAAoB,SAAQ,UAAU;IAC1C,MAAM,CAAC,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,IAAI,GAAG,kBAAkB;IAkHhE,eAAe,CACb,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,iBAAiB,EACxB,IAAI,EAAE,IAAI,GACT,OAAO;IA+EV,aAAa,CACX,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,iBAAiB,EACxB,IAAI,EAAE,IAAI,GACT,OAAO;IAWV,YAAY,CAAC,CAAC,EAAE,iBAAiB,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO;IASvD,cAAc,CAAC,CAAC,EAAE,iBAAiB,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO;CAQ1D;AAED,eAAe,mBAAmB,CAAC"}

package/dist/key-handlers/SelectionKeyHandler.js

@@ -2,12 +2,15 @@
 import clamp from 'lodash.clamp';
 import GridRange from "../GridRange.js";
 import GridUtils from "../GridUtils.js";
+import { gestureModeFromModifiers } from "../GridSelectionUtils.js";
 import KeyHandler from "../KeyHandler.js";
 class SelectionKeyHandler extends KeyHandler {
   onDown(event, grid) {
+    var isShiftKey = event.shiftKey;
+    var isModifierKey = GridUtils.isModifierKeyDown(event);
     switch (event.key) {
       case 'a':
-        if (GridUtils.isModifierKeyDown(event)) {
+        if (isModifierKey) {
           grid.selectAll();
           return true;
         }
@@ -28,55 +31,65 @@ class SelectionKeyHandler extends KeyHandler {
        */
       case 'k':
       case 'K':
-        if (GridUtils.isModifierKeyDown(event)) return false;
+        if (isModifierKey) return false;
         return this.handlePageUp(event, grid);
       case 'j':
       case 'J':
-        if (GridUtils.isModifierKeyDown(event)) return false;
+        if (isModifierKey) return false;
         return this.handlePageDown(event, grid);
       case 'h':
       case 'H':
-        if (GridUtils.isModifierKeyDown(event)) return false;
-        if (!event.shiftKey) {
-          grid.clearSelectedRanges();
-        }
-        grid.moveCursorToPosition(0, grid.state.cursorRow, event.shiftKey);
-        return true;
+        if (isModifierKey) return false;
+        // In row-selection mode, column-edge movement is meaningless.
+        if (grid.props.theme.autoSelectRow === true) return true;
+        return this.handleRowEdge(0, event, grid);
       case 'l':
       case 'L':
-        {
-          if (GridUtils.isModifierKeyDown(event)) return false;
-          var model = grid.props.model;
-          var columnCount = model.columnCount;
-          if (!event.shiftKey) {
-            grid.clearSelectedRanges();
-          }
-          grid.moveCursorToPosition(columnCount - 1, grid.state.cursorRow, event.shiftKey);
-          return true;
-        }
+        if (isModifierKey) return false;
+        if (grid.props.theme.autoSelectRow === true) return true;
+        return this.handleRowEdge(grid.props.model.columnCount - 1, event, grid);
       case 'PageDown':
         return this.handlePageDown(event, grid);
       case 'PageUp':
         return this.handlePageUp(event, grid);
       case 'Home':
-        if (!event.shiftKey) {
-          grid.clearSelectedRanges();
-        }
-        grid.moveCursorToPosition(GridUtils.isModifierKeyDown(event) ? grid.state.cursorColumn : 0, GridUtils.isModifierKeyDown(event) ? 0 : grid.state.cursorRow, event.shiftKey, true, true);
-        return true;
       case 'End':
         {
-          var _model = grid.props.model;
-          var _columnCount = _model.columnCount,
-            rowCount = _model.rowCount;
-          if (!event.shiftKey) {
-            grid.clearSelectedRanges();
+          var model = grid.props.model;
+          var columnCount = model.columnCount,
+            rowCount = model.rowCount;
+          var _grid$state$selection = grid.state.selection,
+            cursorColumn = _grid$state$selection.cursorColumn,
+            cursorRow = _grid$state$selection.cursorRow;
+          var toEnd = event.key === 'End';
+          // In row-selection mode, plain / Shift Home/End would only move the
+          // cursor between columns and (via commit) toggle the row selection.
+          // Ctrl+Home/End still jumps to top/bottom row, which is meaningful.
+          if (grid.props.theme.autoSelectRow === true && !isModifierKey) {
+            return true;
+          }
+          // Ctrl/Meta pins the column and jumps to the row edge; without it
+          // Home/End jumps to the column edge on the current row.
+          var targetColumn;
+          var targetRow;
+          if (isModifierKey) {
+            targetColumn = cursorColumn;
+            targetRow = toEnd ? rowCount - 1 : 0;
+          } else {
+            targetColumn = toEnd ? columnCount - 1 : 0;
+            targetRow = cursorRow;
           }
-          grid.moveCursorToPosition(GridUtils.isModifierKeyDown(event) ? grid.state.cursorColumn : _columnCount - 1, GridUtils.isModifierKeyDown(event) ? rowCount - 1 : grid.state.cursorRow, event.shiftKey, true, true);
+          if (targetColumn == null || targetRow == null) return false;
+          // Shift extends via maximize (grow the last range's furthest edge)
+          // to preserve pre-refactor Shift+Home followed by Shift+End behavior.
+          grid.handleKeySelectAt({
+            column: targetColumn,
+            row: targetRow
+          }, isShiftKey ? 'maximize' : 'replace');
           return true;
         }
       case 'Escape':
-        if (grid.state.selectedRanges.length === 0) return false;
+        if (grid.state.selection.isEmpty()) return false;
         grid.clearSelectedRanges();
         // consume the event, and stop propagation only if there were selected ranges to clear
         return {
@@ -84,14 +97,14 @@ class SelectionKeyHandler extends KeyHandler {
           stopPropagation: true
         };
       case 'Enter':
-        if (grid.state.selectedRanges.length > 0) {
-          grid.moveCursorInDirection(event.shiftKey ? GridRange.SELECTION_DIRECTION.UP : GridRange.SELECTION_DIRECTION.DOWN);
+        if (!grid.state.selection.isEmpty()) {
+          grid.handleKeyAdvanceCursor(isShiftKey ? GridRange.SELECTION_DIRECTION.UP : GridRange.SELECTION_DIRECTION.DOWN);
           return true;
         }
         break;
       case 'Tab':
-        if (grid.state.selectedRanges.length > 0) {
-          grid.moveCursorInDirection(event.shiftKey ? GridRange.SELECTION_DIRECTION.LEFT : GridRange.SELECTION_DIRECTION.RIGHT);
+        if (!grid.state.selection.isEmpty()) {
+          grid.handleKeyAdvanceCursor(isShiftKey ? GridRange.SELECTION_DIRECTION.LEFT : GridRange.SELECTION_DIRECTION.RIGHT);
           return true;
         }
         break;
@@ -103,137 +116,130 @@ class SelectionKeyHandler extends KeyHandler {
   handleArrowMove(deltaColumn, deltaRow, event, grid) {
     var isShiftKey = event.shiftKey;
     var isModifierKey = GridUtils.isModifierKeyDown(event);
-    if (isShiftKey) {
-      grid.trimSelectedRanges();
-    } else {
-      grid.clearSelectedRanges();
-    }
-    var _grid$state = grid.state,
-      cursorRow = _grid$state.cursorRow,
-      cursorColumn = _grid$state.cursorColumn,
-      selectionEndColumn = _grid$state.selectionEndColumn,
-      selectionEndRow = _grid$state.selectionEndRow;
+    var _grid$state$selection2 = grid.state.selection,
+      cursorRow = _grid$state$selection2.cursorRow,
+      cursorColumn = _grid$state$selection2.cursorColumn,
+      selectionEndColumn = _grid$state$selection2.selectionEndColumn,
+      selectionEndRow = _grid$state$selection2.selectionEndRow;
     var column = isShiftKey ? selectionEndColumn : cursorColumn;
     var row = isShiftKey ? selectionEndRow : cursorRow;
+
+    // Ctrl+Arrow is an exception to the mode returned by gestureModeFromModifiers
+    // It jumps to the edge of the grid in the arrow direction, and replaces the selection.
     if (isModifierKey) {
-      var model = grid.props.model;
-      var columnCount = model.columnCount,
-        rowCount = model.rowCount;
-      var maximizePreviousRange = isModifierKey && isShiftKey;
+      var _model = grid.props.model;
+      var _columnCount = _model.columnCount,
+        _rowCount = _model.rowCount;
       var moveToColumn = null;
       var moveToRow = null;
       if (deltaColumn < 0) {
         moveToColumn = 0;
         moveToRow = row;
       } else if (deltaColumn > 0) {
-        moveToColumn = columnCount - 1;
+        moveToColumn = _columnCount - 1;
         moveToRow = row;
       } else if (deltaRow < 0) {
         moveToColumn = column;
         moveToRow = 0;
       } else if (deltaRow > 0) {
         moveToColumn = column;
-        moveToRow = rowCount - 1;
+        moveToRow = _rowCount - 1;
       }
       if (moveToColumn != null && moveToRow != null) {
-        grid.moveCursorToPosition(moveToColumn, moveToRow, isShiftKey, true, maximizePreviousRange);
+        grid.handleKeySelectAt({
+          column: moveToColumn,
+          row: moveToRow
+        }, isShiftKey ? 'maximize' : 'replace');
       }
-    } else {
-      if (!grid.metrics) throw new Error('grid.metrics are not set');
-      var theme = grid.props.theme;
-      var _theme$autoSelectRow = theme.autoSelectRow,
-        autoSelectRow = _theme$autoSelectRow === void 0 ? false : _theme$autoSelectRow,
-        _theme$autoSelectColu = theme.autoSelectColumn,
-        autoSelectColumn = _theme$autoSelectColu === void 0 ? false : _theme$autoSelectColu;
-      if (autoSelectRow && deltaColumn !== 0) {
-        var lastLeft = grid.metrics.lastLeft;
-        var left = grid.state.left;
-        left = clamp(left + deltaColumn, 0, lastLeft);
-        grid.moveCursorToPosition(left, cursorRow, isShiftKey, false);
-        grid.setViewState({
-          left
-        });
-      } else if (autoSelectColumn && deltaRow !== 0) {
-        var lastTop = grid.metrics.lastTop;
-        var top = grid.state.top;
-        top = clamp(top + deltaRow, 0, lastTop);
-        grid.moveCursorToPosition(top, cursorColumn, isShiftKey, false);
-        grid.setViewState({
-          top
-        });
-      } else {
-        grid.moveCursor(deltaColumn, deltaRow, isShiftKey);
+      return true;
+    }
+    if (!grid.metrics) throw new Error('grid.metrics are not set');
+
+    // Plain / Shift arrows: mode is derived from Shift alone here since `isModifierKey` was short-circuited above.
+    var mode = gestureModeFromModifiers({
+      isShiftKey,
+      isModifierKey: false
+    });
+    var theme = grid.props.theme;
+    var _theme$autoSelectRow = theme.autoSelectRow,
+      autoSelectRow = _theme$autoSelectRow === void 0 ? false : _theme$autoSelectRow,
+      _theme$autoSelectColu = theme.autoSelectColumn,
+      autoSelectColumn = _theme$autoSelectColu === void 0 ? false : _theme$autoSelectColu;
+    if (autoSelectRow && deltaColumn !== 0) {
+      var lastLeft = grid.metrics.lastLeft;
+      var left = clamp(grid.state.left + deltaColumn, 0, lastLeft);
+      if (cursorRow != null) {
+        grid.handleKeyMoveCursor(left, cursorRow);
       }
+      grid.setViewState({
+        left
+      });
+      return true;
+    }
+    if (autoSelectColumn && deltaRow !== 0) {
+      var lastTop = grid.metrics.lastTop;
+      var top = clamp(grid.state.top + deltaRow, 0, lastTop);
+      // Preserves the (arguably surprising) original behavior of using `top`
+      // as the column argument; kept identical to pre-refactor code paths.
+      grid.handleKeySelectAt({
+        column: top,
+        row: cursorColumn
+      }, mode, {
+        keepCursorInView: false
+      });
+      grid.setViewState({
+        top
+      });
+      return true;
+    }
+    if (row === null || column === null) {
+      var _grid$state = grid.state,
+        _left = _grid$state.left,
+        _top = _grid$state.top;
+      grid.handleKeySelectAt({
+        column: _left,
+        row: _top
+      }, mode);
+      return true;
     }
+    var model = grid.props.model;
+    var columnCount = model.columnCount,
+      rowCount = model.rowCount;
+    var targetColumn = clamp(column + deltaColumn, 0, columnCount - 1);
+    var targetRow = clamp(row + deltaRow, 0, rowCount - 1);
+    grid.handleKeySelectAt({
+      column: targetColumn,
+      row: targetRow
+    }, mode);
+    return true;
+  }
+  handleRowEdge(targetColumn, event, grid) {
+    var isShiftKey = event.shiftKey;
+    var cursorRow = grid.state.selection.cursorRow;
+    if (cursorRow == null) return false;
+    grid.handleKeySelectAt({
+      column: targetColumn,
+      row: cursorRow
+    }, gestureModeFromModifiers({
+      isShiftKey,
+      isModifierKey: false
+    }));
     return true;
   }
   handlePageUp(e, grid) {
-    var isShiftKey = e.shiftKey;
-    if (isShiftKey) {
-      grid.trimSelectedRanges();
-    } else {
-      grid.clearSelectedRanges();
-    }
-    var _grid$state2 = grid.state,
-      cursorColumn = _grid$state2.cursorColumn,
-      selectionEndRow = _grid$state2.selectionEndRow;
-    var row = selectionEndRow;
-    var column = cursorColumn;
-    if (row == null) {
-      return false;
-    }
-    var metricState = grid.getMetricState();
-    var metricCalculator = grid.metricCalculator;
-    var _metricCalculator$get = metricCalculator.getMetrics(metricState),
-      bottomVisible = _metricCalculator$get.bottomVisible,
-      topVisible = _metricCalculator$get.topVisible,
-      hasHorizontalBar = _metricCalculator$get.hasHorizontalBar;
-    var selectRangeEndPosition = row - (bottomVisible - topVisible);
-    selectRangeEndPosition -= hasHorizontalBar ? 0 : 1;
-
-    // Don't move beyond the top table row.
-    selectRangeEndPosition = Math.max(selectRangeEndPosition, 0);
-    var viewportPosition = Math.max(selectRangeEndPosition - (row - topVisible), 0);
-    grid.moveCursorToPosition(column, selectRangeEndPosition, isShiftKey, false);
-    grid.setViewState({
-      top: viewportPosition
+    var mode = gestureModeFromModifiers({
+      isShiftKey: e.shiftKey,
+      isModifierKey: false
     });
+    grid.handleKeyPageUp(mode);
     return true;
   }
   handlePageDown(e, grid) {
-    var isShiftKey = e.shiftKey;
-    if (isShiftKey) {
-      grid.trimSelectedRanges();
-    } else {
-      grid.clearSelectedRanges();
-    }
-    var _grid$state3 = grid.state,
-      selectionEndRow = _grid$state3.selectionEndRow,
-      cursorColumn = _grid$state3.cursorColumn;
-    var row = selectionEndRow;
-    var column = cursorColumn;
-    if (row === null) {
-      return false;
-    }
-    var metricState = grid.getMetricState();
-    var metricCalculator = grid.metricCalculator;
-    var _metricCalculator$get2 = metricCalculator.getMetrics(metricState),
-      bottomVisible = _metricCalculator$get2.bottomVisible,
-      topVisible = _metricCalculator$get2.topVisible,
-      hasHorizontalBar = _metricCalculator$get2.hasHorizontalBar,
-      rowCount = _metricCalculator$get2.rowCount,
-      lastTop = _metricCalculator$get2.lastTop;
-    var lastRowIndex = rowCount - 1;
-    var selectRangeEndPosition = bottomVisible - topVisible + row;
-    selectRangeEndPosition += hasHorizontalBar ? 0 : 1;
-
-    // Don't move beyond the bottom table row.
-    selectRangeEndPosition = Math.min(selectRangeEndPosition, lastRowIndex);
-    var viewportPosition = Math.min(lastTop, selectRangeEndPosition - (row - topVisible));
-    grid.moveCursorToPosition(column, selectRangeEndPosition, isShiftKey, false);
-    grid.setViewState({
-      top: viewportPosition
+    var mode = gestureModeFromModifiers({
+      isShiftKey: e.shiftKey,
+      isModifierKey: false
     });
+    grid.handleKeyPageDown(mode);
     return true;
   }
 }