@toolbox-web/grid 0.6.0 → 1.0.0

package/lib/plugins/reorder/types.d.ts

@@ -21,11 +21,6 @@ export interface ReorderConfig {
      * @default 200
      */
     animationDuration?: number;
-    /**
-     * @deprecated Use `animation` instead. Will be removed in next major version.
-     * Use View Transitions API for smooth column movement.
-     */
-    viewTransition?: boolean;
 }
 /** Internal state managed by the reorder plugin */
 export interface ReorderState {

package/lib/plugins/reorder/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/plugins/reorder/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,2CAA2C;AAC3C,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvD,mDAAmD;AACnD,MAAM,WAAW,aAAa;IAC5B;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAE7B;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,mDAAmD;AACnD,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,UAAU,EAAE,OAAO,CAAC;IACpB,qDAAqD;IACrD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,+CAA+C;IAC/C,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,4BAA4B;IAC5B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,mCAAmC;IACnC,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,kDAAkD;AAClD,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/plugins/reorder/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,2CAA2C;AAC3C,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvD,mDAAmD;AACnD,MAAM,WAAW,aAAa;IAC5B;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAE7B;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,mDAAmD;AACnD,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,UAAU,EAAE,OAAO,CAAC;IACpB,qDAAqD;IACrD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,+CAA+C;IAC/C,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,4BAA4B;IAC5B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,mCAAmC;IACnC,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,kDAAkD;AAClD,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB"}

package/lib/plugins/selection/SelectionPlugin.d.ts

@@ -3,15 +3,89 @@ import { CellRange, SelectionConfig, SelectionResult } from './types';
 /**
  * Selection Plugin for tbw-grid
  *
- * @example
+ * Adds cell, row, and range selection capabilities to the grid with full keyboard support.
+ * Whether you need simple cell highlighting or complex multi-range selections, this plugin has you covered.
+ *
+ * ## Installation
+ *
+ * ```ts
+ * import { SelectionPlugin } from '@toolbox-web/grid/plugins/selection';
+ * ```
+ *
+ * ## Selection Modes
+ *
+ * Configure the plugin with one of three modes via {@link SelectionConfig}:
+ *
+ * - **`'cell'`** - Single cell selection (default). Click cells to select individually.
+ * - **`'row'`** - Full row selection. Click anywhere in a row to select the entire row.
+ * - **`'range'`** - Rectangular selection. Click and drag or Shift+Click to select ranges.
+ *
+ * ## Keyboard Shortcuts
+ *
+ * | Shortcut | Action |
+ * |----------|--------|
+ * | `Arrow Keys` | Move selection |
+ * | `Shift + Arrow` | Extend selection (range mode) |
+ * | `Ctrl/Cmd + Click` | Toggle selection (multi-select) |
+ * | `Shift + Click` | Extend to clicked cell/row |
+ * | `Ctrl/Cmd + A` | Select all (range mode) |
+ * | `Escape` | Clear selection |
+ *
+ * ## CSS Custom Properties
+ *
+ * | Property | Description |
+ * |----------|-------------|
+ * | `--tbw-focus-background` | Focused row background |
+ * | `--tbw-range-selection-bg` | Range selection fill |
+ * | `--tbw-range-border-color` | Range selection border |
+ *
+ * @example Basic row selection
  * ```ts
- * new SelectionPlugin({ mode: 'range' })
+ * grid.gridConfig = {
+ *   columns: [...],
+ *   plugins: [new SelectionPlugin({ mode: 'row' })],
+ * };
+ * ```
+ *
+ * @example Range selection with event handling
+ * ```ts
+ * grid.gridConfig = {
+ *   plugins: [new SelectionPlugin({ mode: 'range' })],
+ * };
+ *
+ * grid.addEventListener('selection-change', (e) => {
+ *   const { mode, ranges } = e.detail;
+ *   console.log(`Selected ${ranges.length} ranges in ${mode} mode`);
+ * });
  * ```
+ *
+ * @example Programmatic selection control
+ * ```ts
+ * const plugin = grid.getPlugin(SelectionPlugin);
+ *
+ * // Get current selection
+ * const selection = plugin.getSelection();
+ * console.log(selection.ranges);
+ *
+ * // Set selection programmatically
+ * plugin.setRanges([{ from: { row: 0, col: 0 }, to: { row: 5, col: 3 } }]);
+ *
+ * // Clear all selection
+ * plugin.clearSelection();
+ * ```
+ *
+ * @see {@link SelectionMode} for detailed mode descriptions
+ * @see {@link SelectionConfig} for configuration options
+ * @see {@link SelectionResult} for the selection result structure
+ * @see [Live Demos](?path=/docs/grid-plugins-selection--docs) for interactive examples
  */
 export declare class SelectionPlugin extends BaseGridPlugin<SelectionConfig> {
     #private;
+    /** @internal */
     readonly name = "selection";
+    /** @internal */
     readonly styles: string;
+    /** @internal */
     protected get defaultConfig(): Partial<SelectionConfig>;
     /** Row selection state (row mode) */
     private selected;
@@ -26,16 +100,24 @@ export declare class SelectionPlugin extends BaseGridPlugin<SelectionConfig> {
     private pendingKeyboardUpdate;
     /** Cell selection state (cell mode) */
     private selectedCell;
+    /** @internal */
     detach(): void;
+    /** @internal */
     onCellClick(event: CellClickEvent): boolean;
+    /** @internal */
     onKeyDown(event: KeyboardEvent): boolean;
+    /** @internal */
     onCellMouseDown(event: CellMouseEvent): boolean | void;
+    /** @internal */
     onCellMouseMove(event: CellMouseEvent): boolean | void;
+    /** @internal */
     onCellMouseUp(_event: CellMouseEvent): boolean | void;
+    /** @internal */
     afterRender(): void;
     /**
      * Called after scroll-triggered row rendering.
      * Reapplies selection classes to recycled DOM elements.
+     * @internal
      */
     onScrollRender(): void;
     /**
@@ -54,24 +136,6 @@ export declare class SelectionPlugin extends BaseGridPlugin<SelectionConfig> {
      * ```
      */
     getSelection(): SelectionResult;
-    /**
-     * Get the selected cell (cell mode only).
-     * @deprecated Use `getSelection()` instead for a unified API across all modes.
-     */
-    getSelectedCell(): {
-        row: number;
-        col: number;
-    } | null;
-    /**
-     * Get all selected row indices (row mode).
-     * @deprecated Use `getSelection().ranges` instead - each range represents a full row.
-     */
-    getSelectedRows(): number[];
-    /**
-     * Get all selected cell ranges in public format.
-     * @deprecated Use `getSelection().ranges` instead.
-     */
-    getRanges(): CellRange[];
     /**
      * Get all selected cells across all ranges.
      */

package/lib/plugins/selection/SelectionPlugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SelectionPlugin.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/plugins/selection/SelectionPlugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAU/F,OAAO,KAAK,EACV,SAAS,EAGT,eAAe,EAEf,eAAe,EAChB,MAAM,SAAS,CAAC;AAyCjB;;;;;;;GAOG;AACH,qBAAa,eAAgB,SAAQ,cAAc,CAAC,eAAe,CAAC;;IAClE,QAAQ,CAAC,IAAI,eAAe;IAC5B,SAAkB,MAAM,SAAU;IAElC,cAAuB,aAAa,IAAI,OAAO,CAAC,eAAe,CAAC,CAI/D;IAGD,qCAAqC;IACrC,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,MAAM,CAAuB;IAErC,yCAAyC;IACzC,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,WAAW,CAAkC;IACrD,OAAO,CAAC,UAAU,CAA6C;IAC/D,OAAO,CAAC,UAAU,CAAS;IAE3B,oEAAoE;IACpE,OAAO,CAAC,qBAAqB,CAAsC;IAEnE,uCAAuC;IACvC,OAAO,CAAC,YAAY,CAA6C;IAMxD,MAAM,IAAI,IAAI;IAcd,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO;IAqF3C,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO;IA4FxC,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,GAAG,IAAI;IAyCtD,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,GAAG,IAAI;IA+BtD,aAAa,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,GAAG,IAAI;IAuFrD,WAAW,IAAI,IAAI;IA0C5B;;;OAGG;IACM,cAAc,IAAI,IAAI;IAQ/B;;;;;;;;;;;;;;OAcG;IACH,YAAY,IAAI,eAAe;IAQ/B;;;OAGG;IACH,eAAe,IAAI;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAQtD;;;OAGG;IACH,eAAe,IAAI,MAAM,EAAE;IAQ3B;;;OAGG;IACH,SAAS,IAAI,SAAS,EAAE;IAIxB;;OAEG;IACH,gBAAgB,IAAI,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAIvD;;OAEG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;IAIjD;;OAEG;IACH,cAAc,IAAI,IAAI;IAWtB;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI;CAgCrC"}
+{"version":3,"file":"SelectionPlugin.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/plugins/selection/SelectionPlugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAU/F,OAAO,KAAK,EACV,SAAS,EAGT,eAAe,EAEf,eAAe,EAChB,MAAM,SAAS,CAAC;AAyCjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8EG;AACH,qBAAa,eAAgB,SAAQ,cAAc,CAAC,eAAe,CAAC;;IAClE,gBAAgB;IAChB,QAAQ,CAAC,IAAI,eAAe;IAC5B,gBAAgB;IAChB,SAAkB,MAAM,SAAU;IAElC,gBAAgB;IAChB,cAAuB,aAAa,IAAI,OAAO,CAAC,eAAe,CAAC,CAI/D;IAGD,qCAAqC;IACrC,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,MAAM,CAAuB;IAErC,yCAAyC;IACzC,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,WAAW,CAAkC;IACrD,OAAO,CAAC,UAAU,CAA6C;IAC/D,OAAO,CAAC,UAAU,CAAS;IAE3B,oEAAoE;IACpE,OAAO,CAAC,qBAAqB,CAAsC;IAEnE,uCAAuC;IACvC,OAAO,CAAC,YAAY,CAA6C;IAMjE,gBAAgB;IACP,MAAM,IAAI,IAAI;IAcvB,gBAAgB;IACP,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO;IAqFpD,gBAAgB;IACP,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO;IA4FjD,gBAAgB;IACP,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,GAAG,IAAI;IAyC/D,gBAAgB;IACP,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,GAAG,IAAI;IA+B/D,gBAAgB;IACP,aAAa,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,GAAG,IAAI;IAuF9D,gBAAgB;IACP,WAAW,IAAI,IAAI;IA0C5B;;;;OAIG;IACM,cAAc,IAAI,IAAI;IAQ/B;;;;;;;;;;;;;;OAcG;IACH,YAAY,IAAI,eAAe;IAQ/B;;OAEG;IACH,gBAAgB,IAAI,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAIvD;;OAEG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;IAIjD;;OAEG;IACH,cAAc,IAAI,IAAI;IAWtB;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI;CAgCrC"}

package/lib/plugins/selection/index.d.ts

@@ -1,8 +1,9 @@
 /**
  * Selection Plugin Entry Point
  * Re-exports plugin class and types for tree-shakeable imports.
+ *
+ * @module Plugins/Selection
  */
-export { computeSelectionDiff, handleRowClick, selectAll } from './row-selection';
 export { SelectionPlugin } from './SelectionPlugin';
 export type { CellRange, SelectionChangeDetail, SelectionConfig, SelectionMode, SelectionResult } from './types';
 //# sourceMappingURL=index.d.ts.map

package/lib/plugins/selection/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/plugins/selection/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAClF,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,SAAS,EAAE,qBAAqB,EAAE,eAAe,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/plugins/selection/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,SAAS,EAAE,qBAAqB,EAAE,eAAe,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC"}

package/lib/plugins/selection/index.js

@@ -1,32 +1,3 @@
-function x(r, e, t, s) {
-  const n = new Set(r.selected);
-  let o = r.anchor;
-  if (t === "single")
-    n.clear(), n.add(e), o = e;
-  else if (t === "multiple") {
-    const i = s.ctrlKey || s.metaKey;
-    if (s.shiftKey && r.anchor !== null) {
-      const c = Math.min(r.anchor, e), a = Math.max(r.anchor, e);
-      for (let d = c; d <= a; d++)
-        n.add(d);
-    } else i ? (n.has(e) ? n.delete(e) : n.add(e), o = e) : (n.clear(), n.add(e), o = e);
-  }
-  return { selected: n, lastSelected: e, anchor: o };
-}
-function _(r) {
-  const e = /* @__PURE__ */ new Set();
-  for (let t = 0; t < r; t++)
-    e.add(t);
-  return e;
-}
-function D(r, e) {
-  const t = [], s = [];
-  for (const n of e)
-    r.has(n) || t.push(n);
-  for (const n of r)
-    e.has(n) || s.push(n);
-  return { added: t, removed: s };
-}
 function b(r) {
   if (!r) return -1;
   const e = r.getAttribute("data-row");
@@ -35,9 +6,9 @@ function b(r) {
   if (!t) return -1;
   const s = t.parentElement;
   if (!s) return -1;
-  const n = s.querySelectorAll(":scope > .data-grid-row");
-  for (let o = 0; o < n.length; o++)
-    if (n[o] === t) return o;
+  const o = s.querySelectorAll(":scope > .data-grid-row");
+  for (let n = 0; n < o.length; n++)
+    if (o[n] === t) return n;
   return -1;
 }
 function w(r) {
@@ -53,7 +24,7 @@ const p = {
   dragHandle: "⋮⋮",
   toolPanel: "☰"
 };
-class y {
+class A {
   /**
    * Plugin dependencies - declare other plugins this one requires.
    *
@@ -229,23 +200,6 @@ class y {
   get gridElement() {
     return this.grid;
   }
-  /**
-   * Get the render root of the grid for DOM queries.
-   * @deprecated Use `gridElement` instead. This getter exists only for backward compatibility.
-   *
-   * With Shadow DOM removed, the grid element itself is the render root.
-   * All new code should use `this.gridElement` for DOM queries.
-   *
-   * @example
-   * // OLD (deprecated)
-   * const rows = this.shadowRoot?.querySelector('.rows');
-   *
-   * // NEW (preferred)
-   * const rows = this.gridElement.querySelector('.rows');
-   */
-  get shadowRoot() {
-    return this.gridElement;
-  }
   /**
    * Get the disconnect signal for event listener cleanup.
    * This signal is aborted when the grid disconnects from the DOM.
@@ -359,7 +313,7 @@ function g(r) {
     endCol: Math.max(r.startCol, r.endCol)
   };
 }
-function A(r) {
+function y(r) {
   const e = g(r);
   return {
     from: { row: e.startRow, col: e.startCol },
@@ -367,26 +321,26 @@ function A(r) {
   };
 }
 function R(r) {
-  return r.map(A);
+  return r.map(y);
 }
-function v(r, e, t) {
+function I(r, e, t) {
   const s = g(t);
   return r >= s.startRow && r <= s.endRow && e >= s.startCol && e <= s.endCol;
 }
 function m(r, e, t) {
-  return t.some((s) => v(r, e, s));
+  return t.some((s) => I(r, e, s));
 }
-function S(r) {
+function v(r) {
   const e = [], t = g(r);
   for (let s = t.startRow; s <= t.endRow; s++)
-    for (let n = t.startCol; n <= t.endCol; n++)
-      e.push({ row: s, col: n });
+    for (let o = t.startCol; o <= t.endCol; o++)
+      e.push({ row: s, col: o });
   return e;
 }
 function E(r) {
   const e = /* @__PURE__ */ new Map();
   for (const t of r)
-    for (const s of S(t))
+    for (const s of v(t))
       e.set(`${s.row},${s.col}`, s);
   return [...e.values()];
 }
@@ -398,8 +352,8 @@ function u(r, e) {
     endCol: e.col
   };
 }
-const I = "@layer tbw-plugins{tbw-grid.selecting .data-grid-row>.cell{-webkit-user-select:none;user-select:none}tbw-grid[data-has-focus] .data-grid-row.row-focus{background-color:var(--tbw-focus-background, rgba(from var(--tbw-color-accent) r g b / 12%))}tbw-grid[data-selection-mode=row] .cell-focus{outline:none}tbw-grid .data-grid-row>.cell.selected{background-color:var(--tbw-range-selection-bg)}tbw-grid .data-grid-row>.cell.selected.top{border-top:2px solid var(--tbw-range-border-color)}tbw-grid .data-grid-row>.cell.selected.bottom{border-bottom:2px solid var(--tbw-range-border-color)}tbw-grid .data-grid-row>.cell.selected.first{border-left:2px solid var(--tbw-range-border-color)}tbw-grid .data-grid-row>.cell.selected.last{border-right:2px solid var(--tbw-range-border-color)}tbw-grid .tbw-selection-summary{font-size:var(--tbw-font-size-sm, .8125rem);color:var(--tbw-color-fg-muted);white-space:nowrap}}";
-function K(r, e, t) {
+const x = "@layer tbw-plugins{tbw-grid.selecting .data-grid-row>.cell{-webkit-user-select:none;user-select:none}tbw-grid[data-has-focus] .data-grid-row.row-focus{background-color:var(--tbw-focus-background, rgba(from var(--tbw-color-accent) r g b / 12%))}tbw-grid[data-selection-mode=row] .cell-focus{outline:none}tbw-grid .data-grid-row>.cell.selected{background-color:var(--tbw-range-selection-bg)}tbw-grid .data-grid-row>.cell.selected.top{border-top:2px solid var(--tbw-range-border-color)}tbw-grid .data-grid-row>.cell.selected.bottom{border-bottom:2px solid var(--tbw-range-border-color)}tbw-grid .data-grid-row>.cell.selected.first{border-left:2px solid var(--tbw-range-border-color)}tbw-grid .data-grid-row>.cell.selected.last{border-right:2px solid var(--tbw-range-border-color)}tbw-grid .tbw-selection-summary{font-size:var(--tbw-font-size-sm, .8125rem);color:var(--tbw-color-fg-muted);white-space:nowrap}}";
+function q(r, e, t) {
   if (r === "cell" && e.selectedCell)
     return {
       mode: r,
@@ -411,17 +365,20 @@ function K(r, e, t) {
       ]
     };
   if (r === "row" && e.selected.size > 0) {
-    const s = [...e.selected].map((n) => ({
-      from: { row: n, col: 0 },
-      to: { row: n, col: t - 1 }
+    const s = [...e.selected].map((o) => ({
+      from: { row: o, col: 0 },
+      to: { row: o, col: t - 1 }
     }));
     return { mode: r, ranges: s };
   }
   return r === "range" && e.ranges.length > 0 ? { mode: r, ranges: R(e.ranges) } : { mode: r, ranges: [] };
 }
-class M extends y {
+class K extends A {
+  /** @internal */
   name = "selection";
-  styles = I;
+  /** @internal */
+  styles = x;
+  /** @internal */
   get defaultConfig() {
     return {
       mode: "cell"
@@ -443,21 +400,23 @@ class M extends y {
   selectedCell = null;
   // #endregion
   // #region Lifecycle
+  /** @internal */
   detach() {
     this.selected.clear(), this.ranges = [], this.activeRange = null, this.cellAnchor = null, this.isDragging = !1, this.selectedCell = null, this.pendingKeyboardUpdate = null;
   }
   // #endregion
   // #region Event Handlers
+  /** @internal */
   onCellClick(e) {
-    const { rowIndex: t, colIndex: s, originalEvent: n } = e, { mode: o } = this.config, i = this.columns[s], c = i && h(i);
-    if (o === "cell")
+    const { rowIndex: t, colIndex: s, originalEvent: o } = e, { mode: n } = this.config, i = this.columns[s], c = i && h(i);
+    if (n === "cell")
       return c || (this.selectedCell = { row: t, col: s }, this.emit("selection-change", this.#e()), this.requestAfterRender()), !1;
-    if (o === "row")
+    if (n === "row")
       return this.selected.clear(), this.selected.add(t), this.lastSelected = t, this.emit("selection-change", this.#e()), this.requestAfterRender(), !1;
-    if (o === "range") {
+    if (n === "range") {
       if (c)
         return !1;
-      const a = n.shiftKey, d = n.ctrlKey || n.metaKey;
+      const a = o.shiftKey, d = o.ctrlKey || o.metaKey;
       if (a && this.cellAnchor) {
         const l = u(this.cellAnchor, { row: t, col: s });
         d ? this.ranges.length > 0 ? this.ranges[this.ranges.length - 1] = l : this.ranges.push(l) : this.ranges = [l], this.activeRange = l;
@@ -482,11 +441,12 @@ class M extends y {
     }
     return !1;
   }
+  /** @internal */
   onKeyDown(e) {
-    const { mode: t } = this.config, n = ["ArrowUp", "ArrowDown", "ArrowLeft", "ArrowRight", "Tab", "Home", "End", "PageUp", "PageDown"].includes(e.key);
+    const { mode: t } = this.config, o = ["ArrowUp", "ArrowDown", "ArrowLeft", "ArrowRight", "Tab", "Home", "End", "PageUp", "PageDown"].includes(e.key);
     if (e.key === "Escape")
       return t === "cell" ? this.selectedCell = null : t === "row" ? (this.selected.clear(), this.anchor = null) : t === "range" && (this.ranges = [], this.activeRange = null, this.cellAnchor = null), this.emit("selection-change", this.#e()), this.requestAfterRender(), !0;
-    if (t === "cell" && n)
+    if (t === "cell" && o)
       return queueMicrotask(() => {
         this.selectedCell = { row: this.grid._focusRow, col: this.grid._focusCol }, this.emit("selection-change", this.#e()), this.requestAfterRender();
       }), !1;
@@ -494,17 +454,17 @@ class M extends y {
       return queueMicrotask(() => {
         this.selected.clear(), this.selected.add(this.grid._focusRow), this.lastSelected = this.grid._focusRow, this.emit("selection-change", this.#e()), this.requestAfterRender();
       }), !1;
-    if (t === "range" && n) {
-      const o = e.key === "Tab", i = e.shiftKey && !o;
+    if (t === "range" && o) {
+      const n = e.key === "Tab", i = e.shiftKey && !n;
       return i && !this.cellAnchor && (this.cellAnchor = { row: this.grid._focusRow, col: this.grid._focusCol }), this.pendingKeyboardUpdate = { shiftKey: i }, queueMicrotask(() => this.requestAfterRender()), !1;
     }
     if (t === "range" && e.key === "a" && (e.ctrlKey || e.metaKey)) {
-      const o = this.rows.length, i = this.columns.length;
-      if (o > 0 && i > 0) {
+      const n = this.rows.length, i = this.columns.length;
+      if (n > 0 && i > 0) {
         const c = {
           startRow: 0,
           startCol: 0,
-          endRow: o - 1,
+          endRow: n - 1,
           endCol: i - 1
         };
         return this.ranges = [c], this.activeRange = c, this.emit("selection-change", this.#e()), this.requestAfterRender(), !0;
@@ -512,33 +472,36 @@ class M extends y {
     }
     return !1;
   }
+  /** @internal */
   onCellMouseDown(e) {
     if (this.config.mode !== "range" || e.rowIndex === void 0 || e.colIndex === void 0 || e.rowIndex < 0) return;
     const t = this.columns[e.colIndex];
     if (t && h(t) || e.originalEvent.shiftKey && this.cellAnchor)
       return;
     this.isDragging = !0;
-    const s = e.rowIndex, n = e.colIndex;
-    this.cellAnchor = { row: s, col: n }, e.originalEvent.ctrlKey || e.originalEvent.metaKey || (this.ranges = []);
+    const s = e.rowIndex, o = e.colIndex;
+    this.cellAnchor = { row: s, col: o }, e.originalEvent.ctrlKey || e.originalEvent.metaKey || (this.ranges = []);
     const i = {
       startRow: s,
-      startCol: n,
+      startCol: o,
       endRow: s,
-      endCol: n
+      endCol: o
     };
     return this.ranges.push(i), this.activeRange = i, this.emit("selection-change", this.#e()), this.requestAfterRender(), !0;
   }
+  /** @internal */
   onCellMouseMove(e) {
     if (this.config.mode !== "range" || !this.isDragging || !this.cellAnchor || e.rowIndex === void 0 || e.colIndex === void 0 || e.rowIndex < 0) return;
     let t = e.colIndex;
     const s = this.columns[t];
     if (s && h(s)) {
-      const o = this.columns.findIndex((i) => !h(i));
-      o >= 0 && (t = o);
+      const n = this.columns.findIndex((i) => !h(i));
+      n >= 0 && (t = n);
     }
-    const n = u(this.cellAnchor, { row: e.rowIndex, col: t });
-    return this.ranges.length > 0 ? this.ranges[this.ranges.length - 1] = n : this.ranges.push(n), this.activeRange = n, this.emit("selection-change", this.#e()), this.requestAfterRender(), !0;
+    const o = u(this.cellAnchor, { row: e.rowIndex, col: t });
+    return this.ranges.length > 0 ? this.ranges[this.ranges.length - 1] = o : this.ranges.push(o), this.activeRange = o, this.emit("selection-change", this.#e()), this.requestAfterRender(), !0;
   }
+  /** @internal */
   onCellMouseUp(e) {
     if (this.config.mode === "range" && this.isDragging)
       return this.isDragging = !1, !0;
@@ -551,45 +514,46 @@ class M extends y {
     const e = this.gridElement;
     if (!e) return;
     const { mode: t } = this.config;
-    e.querySelectorAll(".cell").forEach((o) => {
-      o.classList.remove("selected", "top", "bottom", "first", "last");
+    e.querySelectorAll(".cell").forEach((n) => {
+      n.classList.remove("selected", "top", "bottom", "first", "last");
     });
-    const n = e.querySelectorAll(".data-grid-row");
-    if (n.forEach((o) => {
-      o.classList.remove("selected", "row-focus");
-    }), t === "row" && (w(e), n.forEach((o) => {
-      const i = o.querySelector(".cell[data-row]"), c = b(i);
-      c >= 0 && this.selected.has(c) && o.classList.add("selected", "row-focus");
+    const o = e.querySelectorAll(".data-grid-row");
+    if (o.forEach((n) => {
+      n.classList.remove("selected", "row-focus");
+    }), t === "row" && (w(e), o.forEach((n) => {
+      const i = n.querySelector(".cell[data-row]"), c = b(i);
+      c >= 0 && this.selected.has(c) && n.classList.add("selected", "row-focus");
     })), t === "range" && this.ranges.length > 0) {
       w(e);
-      const o = this.activeRange ? g(this.activeRange) : null, i = this.columns.findIndex((a) => !h(a));
+      const n = this.activeRange ? g(this.activeRange) : null, i = this.columns.findIndex((a) => !h(a));
       this.columns.length - 1, e.querySelectorAll(".cell[data-row][data-col]").forEach((a) => {
         const d = parseInt(a.getAttribute("data-row") ?? "-1", 10), l = parseInt(a.getAttribute("data-col") ?? "-1", 10);
         if (d >= 0 && l >= 0) {
           const f = this.columns[l];
           if (f && h(f))
             return;
-          if (m(d, l, this.ranges) && (a.classList.add("selected"), o)) {
-            d === o.startRow && a.classList.add("top"), d === o.endRow && a.classList.add("bottom");
-            const C = Math.max(o.startCol, i);
-            l === C && a.classList.add("first"), l === o.endCol && a.classList.add("last");
+          if (m(d, l, this.ranges) && (a.classList.add("selected"), n)) {
+            d === n.startRow && a.classList.add("top"), d === n.endRow && a.classList.add("bottom");
+            const C = Math.max(n.startCol, i);
+            l === C && a.classList.add("first"), l === n.endCol && a.classList.add("last");
           }
         }
       });
     }
   }
+  /** @internal */
   afterRender() {
     const e = this.gridElement;
     if (!e) return;
     const t = e.children[0], { mode: s } = this.config;
     if (this.pendingKeyboardUpdate && s === "range") {
-      const { shiftKey: n } = this.pendingKeyboardUpdate;
+      const { shiftKey: o } = this.pendingKeyboardUpdate;
       this.pendingKeyboardUpdate = null;
-      const o = this.grid._focusRow, i = this.grid._focusCol;
-      if (n && this.cellAnchor) {
-        const c = u(this.cellAnchor, { row: o, col: i });
+      const n = this.grid._focusRow, i = this.grid._focusCol;
+      if (o && this.cellAnchor) {
+        const c = u(this.cellAnchor, { row: n, col: i });
         this.ranges = [c], this.activeRange = c;
-      } else n || (this.ranges = [], this.activeRange = null, this.cellAnchor = { row: o, col: i });
+      } else o || (this.ranges = [], this.activeRange = null, this.cellAnchor = { row: n, col: i });
       this.emit("selection-change", this.#e());
     }
     this.grid.setAttribute("data-selection-mode", s), t && t.classList.toggle("selecting", this.isDragging), this.#t();
@@ -597,6 +561,7 @@ class M extends y {
   /**
    * Called after scroll-triggered row rendering.
    * Reapplies selection classes to recycled DOM elements.
+   * @internal
    */
   onScrollRender() {
     this.#t();
@@ -625,29 +590,6 @@ class M extends y {
       anchor: this.cellAnchor
     };
   }
-  /**
-   * Get the selected cell (cell mode only).
-   * @deprecated Use `getSelection()` instead for a unified API across all modes.
-   */
-  getSelectedCell() {
-    const { mode: e, ranges: t } = this.getSelection();
-    return e === "cell" && t.length > 0 ? t[0].from : null;
-  }
-  /**
-   * Get all selected row indices (row mode).
-   * @deprecated Use `getSelection().ranges` instead - each range represents a full row.
-   */
-  getSelectedRows() {
-    const { mode: e, ranges: t } = this.getSelection();
-    return e === "row" ? t.map((s) => s.from.row) : [];
-  }
-  /**
-   * Get all selected cell ranges in public format.
-   * @deprecated Use `getSelection().ranges` instead.
-   */
-  getRanges() {
-    return this.getSelection().ranges;
-  }
   /**
    * Get all selected cells across all ranges.
    */
@@ -683,7 +625,7 @@ class M extends y {
   // #endregion
   // #region Private Helpers
   #e() {
-    return K(
+    return q(
       this.config.mode,
       {
         selectedCell: this.selectedCell,
@@ -696,9 +638,6 @@ class M extends y {
   // #endregion
 }
 export {
-  M as SelectionPlugin,
-  D as computeSelectionDiff,
-  x as handleRowClick,
-  _ as selectAll
+  K as SelectionPlugin
 };
 //# sourceMappingURL=index.js.map