@warkypublic/svelix 0.1.42 → 0.1.43

package/dist/components/Gridler/components/Gridler.svelte

@@ -157,6 +157,29 @@
     cancelEdit();
   }
 
+  function getSelectionRowData(sel: Selection): Record<string, unknown>[] | undefined {
+    if (!getRowData) return undefined;
+    if (sel.type === "cell") {
+      const d = getRowData(sel.item[1]);
+      return d ? [d] : undefined;
+    }
+    if (sel.type === "row") {
+      const items = sel.rows.map(getRowData).filter((r): r is Record<string, unknown> => r !== undefined);
+      return items.length > 0 ? items : undefined;
+    }
+    if (sel.type === "range") {
+      const minRow = Math.min(sel.start[1], sel.end[1]);
+      const maxRow = Math.max(sel.start[1], sel.end[1]);
+      const items: Record<string, unknown>[] = [];
+      for (let i = minRow; i <= maxRow; i++) {
+        const d = getRowData(i);
+        if (d) items.push(d);
+      }
+      return items.length > 0 ? items : undefined;
+    }
+    return undefined;
+  }
+
   // ── Row toggle (checkbox / number markers) ────────────────────────────────────
 
   function handleRowToggle(row: number) {
@@ -173,7 +196,7 @@
     }
     currentSelection = newSel;
     canvasComponent?.setCurrentSelection(newSel);
-    onSelectionChange?.(newSel);
+    onSelectionChange?.(newSel, getSelectionRowData(newSel));
   }
 
   // ── Clipboard ────────────────────────────────────────────────────────────────
@@ -295,7 +318,7 @@
         };
         currentSelection = newSel;
         canvasComponent?.setCurrentSelection(newSel);
-        onSelectionChange?.(newSel);
+        onSelectionChange?.(newSel, getSelectionRowData(newSel));
         canvasComponent?.setAnnouncement("All cells selected");
       }
       e.preventDefault();
@@ -386,7 +409,7 @@
       const newSel: Selection = { type: "cell", item: newFocusedCell };
       currentSelection = newSel;
       canvasComponent?.setCurrentSelection(newSel);
-      onSelectionChange?.(newSel);
+      onSelectionChange?.(newSel, getSelectionRowData(newSel));
       canvasComponent?.setAnnouncement(
         `Row ${newRow + 1}, column ${columns[newCol]?.title ?? newCol + 1}`,
       );
@@ -445,7 +468,7 @@
   onVisibleRangeChange={handleVisibleRangeChange}
   onSelectionChange={(sel) => {
     currentSelection = sel;
-    onSelectionChange?.(sel);
+    onSelectionChange?.(sel, getSelectionRowData(sel));
     onGridEvent?.("selection_changed");
   }}
   onCellDblClick={(item, cell) => {

package/dist/components/Gridler/components/GridlerFull.svelte

@@ -758,7 +758,7 @@
     }
     internalSelectedItems = items;
     if (items.length > 0) onSelectedItemsChange?.(items);
-    onSelectionChange?.(sel);
+    onSelectionChange?.(sel, items.length > 0 ? items : undefined);
   }
 
   // ── Settings change event ─────────────────────────────────────────────────

package/dist/components/Gridler/types.d.ts

@@ -155,8 +155,8 @@ export interface GridlerProps extends GridCommonProps<Record<string, unknown>> {
     theme?: Partial<GridlerTheme>;
     /** Controlled selection state. */
     selection?: Selection;
-    /** Called when the internal selection changes. */
-    onSelectionChange?: (selection: Selection) => void;
+    /** Called when the internal selection changes. Row data for all selected rows is provided where available. */
+    onSelectionChange?: (selection: Selection, rowData?: Record<string, unknown>[]) => void;
     /** Called when the visible row/column range changes (e.g. on scroll). */
     onVisibleRangeChange?: (range: VisibleRange) => void;
     /** When true, all cells are read-only. Also settable via settings.readonly. */

package/llm/IMPLEMENTATION_PLAN.md

@@ -41,6 +41,7 @@ This file now tracks the implemented state of the project rather than the origin
 ### Data and explorer components
 - `Gridler`
 - `GridlerFull`
+  - `onSelectionChange(selection, rowData?)` — second arg carries resolved row data for all selected rows (cell, row, range types)
 - `SvarkGrid`
 - `VTree`
 - shared generic grid types and supporting utilities

package/llm/gridler-events.md

@@ -39,7 +39,7 @@ onGridEvent?: (
 | `sort_changed` | Sort order applied or cleared | — | — | — | `{ sortOrder: GridColumnSortOrder }` |
 | `filter_changed` | Filter applied or cleared | — | — | — | `{ filters: GridColumnFilters }` |
 | `search_changed` | Search input value changed | — | — | — | `{ searchValue: string }` |
-| `selection_changed` | Cell, row, range, or column selection changes | — | — | — | — |
+| `selection_changed` | Cell, row, range, or column selection changes | — | — | — | — | (use `onSelectionChange` for the selection object + row data) |
 | `column_moved` | Column dragged to new position | — | — | — | `{ from: number, to: number }` |
 | `column_resized` | Column edge dragged to new width | — | moved column | — | `{ width: number }` |
 | `data_changed` | Cell edited and committed (local mode only) | updated row | edited column | — | `{ data: Row[] }` full new dataset |
@@ -47,6 +47,55 @@ onGridEvent?: (
 
 ---
 
+## `onSelectionChange`
+
+Fired on every selection change — mouse clicks, arrow-key navigation, Ctrl+A, row-marker toggles.
+
+```ts
+onSelectionChange?: (
+  selection: Selection,
+  rowData?: Record<string, unknown>[],  // resolved row data for all selected rows
+) => void
+```
+
+### `Selection` type
+
+```ts
+type Selection =
+  | { type: "none" }
+  | { type: "cell";   item: [col, row] }
+  | { type: "range";  start: [col, row]; end: [col, row] }
+  | { type: "row";    rows: number[] }
+  | { type: "column"; columns: number[] }
+```
+
+### `rowData` population
+
+| Selection type | `rowData` |
+|---|---|
+| `cell` | single-element array with the row's data |
+| `row` | array of data for each selected row |
+| `range` | array of data for every row from `start[1]` to `end[1]` |
+| `column` / `none` | `undefined` |
+
+`rowData` is `undefined` when no row data can be resolved (column/none selections, or when `getRowData`/`data` is not provided).
+
+### Usage
+
+```svelte
+<GridlerFull
+  {columns}
+  {data}
+  onSelectionChange={(sel, rowData) => {
+    if (sel.type === 'cell') {
+      console.log('Selected row:', rowData?.[0]);
+    }
+  }}
+/>
+```
+
+---
+
 ## `onCellEvent`
 
 ```ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warkypublic/svelix",
-  "version": "0.1.42",
+  "version": "0.1.43",
   "description": "Svelte 5 component library with Skeleton UI and Tailwind CSS",
   "license": "Apache-2.0",
   "exports": {