@toolbox-web/grid-react 0.12.2 → 0.13.0

package/README.md

@@ -695,11 +695,11 @@ import type {
   // Deprecated aliases
   ReactGridConfig,
   ReactColumnConfig,
-  // Context types
-  CellRenderContext,
-  ColumnEditorContext,
-  DetailPanelContext,
-  ToolPanelContext,
+  // Context types (React-specific wrappers)
+  GridCellContext,
+  GridEditorContext,
+  GridDetailContext,
+  GridToolPanelContext,
   DataGridRef,
   DataGridProps,
   // Feature props
@@ -760,28 +760,28 @@ import type {
 
 ### GridColumn Props
 
-| Prop        | Type                                          | Description             |
-| ----------- | --------------------------------------------- | ----------------------- |
-| `field`     | `string`                                      | Field key in row object |
-| `header`    | `string`                                      | Column header text      |
-| `type`      | `'string' \| 'number' \| 'date' \| 'boolean'` | Data type               |
-| `editable`  | `boolean`                                     | Enable editing          |
-| `sortable`  | `boolean`                                     | Enable sorting          |
-| `resizable` | `boolean`                                     | Enable column resizing  |
-| `width`     | `string \| number`                            | Column width            |
-| `children`  | `(ctx: CellRenderContext) => ReactNode`       | Custom renderer         |
-| `editor`    | `(ctx: ColumnEditorContext) => ReactNode`     | Custom editor           |
+| Prop        | Type                                                    | Description                                             |
+| ----------- | ------------------------------------------------------- | ------------------------------------------------------- |
+| `field`     | `string`                                                | Field key in row object                                 |
+| `header`    | `string`                                                | Column header text                                      |
+| `type`      | `'string' \| 'number' \| 'date' \| 'boolean'`           | Data type                                               |
+| `editable`  | `boolean`                                               | Enable editing                                          |
+| `sortable`  | `boolean`                                               | Enable sorting                                          |
+| `resizable` | `boolean`                                               | Enable column resizing                                  |
+| `width`     | `string \| number`                                      | Column width                                            |
+| `children`  | `(ctx: CellRenderContext<TRow, TValue>) => ReactNode`   | Custom renderer (context type from `@toolbox-web/grid`) |
+| `editor`    | `(ctx: ColumnEditorContext<TRow, TValue>) => ReactNode` | Custom editor (context type from `@toolbox-web/grid`)   |
 
 ### DataGridRef Methods
 
 | Method                    | Description                 |
-| ------------------------- | --------------------------- | -------------------- |
+| ------------------------- | --------------------------- |
 | `getConfig()`             | Get effective configuration |
 | `ready()`                 | Wait for grid ready         |
 | `forceLayout()`           | Force layout recalculation  |
 | `toggleGroup(key)`        | Toggle group expansion      |
 | `registerStyles(id, css)` | Register custom styles      |
-| `unregisterStyles(id)`    | `void`                      | Remove custom styles |
+| `unregisterStyles(id)`    | Remove custom styles        |
 
 ### ReactGridAdapter
 

package/features/selection.d.ts

@@ -5,7 +5,7 @@ import { CellRange, SelectionResult } from '@toolbox-web/grid/plugins/selection'
  * Uses React context to access the grid ref - works reliably regardless of
  * when the grid mounts or conditional rendering.
  */
-export interface SelectionMethods {
+export interface SelectionMethods<TRow = unknown> {
     /**
      * Select all rows (row mode) or all cells (range mode).
      */
@@ -27,6 +27,16 @@ export interface SelectionMethods {
      * Set selection ranges programmatically.
      */
     setRanges: (ranges: CellRange[]) => void;
+    /**
+     * Get actual row objects for the current selection.
+     * Works in all selection modes (row, cell, range) — resolves indices
+     * against the grid's processed (sorted/filtered) rows.
+     *
+     * This is the recommended way to get selected rows. Unlike manual
+     * index mapping, it correctly resolves rows even when the grid is
+     * sorted or filtered.
+     */
+    getSelectedRows: () => TRow[];
 }
 /**
  * Hook for programmatic selection control.
@@ -52,5 +62,5 @@ export interface SelectionMethods {
  * }
  * ```
  */
-export declare function useGridSelection<TRow = unknown>(): SelectionMethods;
+export declare function useGridSelection<TRow = unknown>(): SelectionMethods<TRow>;
 //# sourceMappingURL=selection.d.ts.map

package/features/selection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"selection.d.ts","sourceRoot":"","sources":["../../../../libs/grid-react/src/features/selection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAGH,OAAO,EAAmB,KAAK,SAAS,EAAE,KAAK,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAc5G;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,SAAS,EAAE,MAAM,IAAI,CAAC;IAEtB;;OAEG;IACH,cAAc,EAAE,MAAM,IAAI,CAAC;IAE3B;;;OAGG;IACH,YAAY,EAAE,MAAM,eAAe,GAAG,IAAI,CAAC;IAE3C;;OAEG;IACH,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IAEtD;;OAEG;IACH,SAAS,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,IAAI,CAAC;CAC1C;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,GAAG,OAAO,KAAK,gBAAgB,CAkEnE"}
+{"version":3,"file":"selection.d.ts","sourceRoot":"","sources":["../../../../libs/grid-react/src/features/selection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAGH,OAAO,EAAmB,KAAK,SAAS,EAAE,KAAK,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAc5G;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB,CAAC,IAAI,GAAG,OAAO;IAC9C;;OAEG;IACH,SAAS,EAAE,MAAM,IAAI,CAAC;IAEtB;;OAEG;IACH,cAAc,EAAE,MAAM,IAAI,CAAC;IAE3B;;;OAGG;IACH,YAAY,EAAE,MAAM,eAAe,GAAG,IAAI,CAAC;IAE3C;;OAEG;IACH,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IAEtD;;OAEG;IACH,SAAS,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,IAAI,CAAC;IAEzC;;;;;;;;OAQG;IACH,eAAe,EAAE,MAAM,IAAI,EAAE,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,GAAG,OAAO,KAAK,gBAAgB,CAAC,IAAI,CAAC,CAuEzE"}

package/features/selection.js

@@ -1,11 +1,11 @@
 import { SelectionPlugin as i } from "@toolbox-web/grid/plugins/selection";
-import { useContext as w, useCallback as o } from "react";
-import { G as S } from "../chunks/data-grid-CGvHh_mp.js";
-import { r as C } from "../chunks/feature-registry-Y3KvnN54.js";
-C("selection", (e) => e === "cell" || e === "row" || e === "range" ? new i({ mode: e }) : new i(e ?? void 0));
-function P() {
-  const e = w(S), t = o(() => e?.current?.getPlugin(i), [e]), g = o(() => {
-    const n = t();
+import { useContext as S, useCallback as o } from "react";
+import { G as C } from "../chunks/data-grid-CGvHh_mp.js";
+import { r as R } from "../chunks/feature-registry-Y3KvnN54.js";
+R("selection", (t) => t === "cell" || t === "row" || t === "range" ? new i({ mode: t }) : new i(t ?? void 0));
+function b() {
+  const t = S(C), e = o(() => t?.current?.getPlugin(i), [t]), g = o(() => {
+    const n = e();
     if (!n) {
       console.warn(
         `[tbw-grid:selection] SelectionPlugin not found.
@@ -15,7 +15,7 @@ function P() {
       );
       return;
     }
-    const r = e?.current, u = n.config?.mode;
+    const r = t?.current, u = n.config?.mode;
     if (u === "row") {
       const s = r?.rows?.length ?? 0, l = /* @__PURE__ */ new Set();
       for (let c = 0; c < s; c++) l.add(c);
@@ -24,25 +24,26 @@ function P() {
       const s = r?.rows?.length ?? 0, l = r?._columns?.length ?? 0;
       s > 0 && l > 0 && n.setRanges([{ from: { row: 0, col: 0 }, to: { row: s - 1, col: l - 1 } }]);
     }
-  }, [t, e]), d = o(() => {
-    t()?.clearSelection();
-  }, [t]), a = o(() => t()?.getSelection() ?? null, [t]), m = o(
-    (n, r) => t()?.isCellSelected(n, r) ?? !1,
-    [t]
-  ), f = o(
+  }, [e, t]), d = o(() => {
+    e()?.clearSelection();
+  }, [e]), a = o(() => e()?.getSelection() ?? null, [e]), w = o(
+    (n, r) => e()?.isCellSelected(n, r) ?? !1,
+    [e]
+  ), m = o(
     (n) => {
-      t()?.setRanges(n);
+      e()?.setRanges(n);
     },
-    [t]
-  );
+    [e]
+  ), f = o(() => e()?.getSelectedRows() ?? [], [e]);
   return {
     selectAll: g,
     clearSelection: d,
     getSelection: a,
-    isCellSelected: m,
-    setRanges: f
+    isCellSelected: w,
+    setRanges: m,
+    getSelectedRows: f
   };
 }
 export {
-  P as useGridSelection
+  b as useGridSelection
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toolbox-web/grid-react",
-  "version": "0.12.2",
+  "version": "0.13.0",
   "description": "React adapter for @toolbox-web/grid data grid component",
   "type": "module",
   "main": "./index.js",