@toolbox-web/grid 0.1.1 → 0.2.2

package/README.md

@@ -83,55 +83,38 @@ When the same property is set via multiple methods, higher precedence wins:
 
 ## Features
 
-### Core Capabilities
-
-| Feature             | Description                                                                       |
-| ------------------- | --------------------------------------------------------------------------------- |
-| Virtualization      | Row and column virtualization for datasets with 100k+ rows                        |
-| Keyboard Navigation | Full keyboard support including arrow keys, Tab, Enter, Home/End, PageUp/PageDown |
-| Accessibility       | ARIA attributes and screen reader support                                         |
-| Theming             | CSS custom properties with 4 built-in themes                                      |
-| Column Inference    | Automatic column type detection from data                                         |
-
-### Editing
-
-| Feature         | Description                                           |
-| --------------- | ----------------------------------------------------- |
-| Inline Editing  | Cell and row editing modes with configurable triggers |
-| Undo/Redo       | Edit history with Ctrl+Z / Ctrl+Y                     |
-| Clipboard       | Copy/paste with configurable delimiters               |
-| Change Tracking | Track modified rows with commit/reset lifecycle       |
-
-### Data Operations
-
-| Feature          | Description                                                            |
-| ---------------- | ---------------------------------------------------------------------- |
-| Sorting          | Single and multi-column sorting                                        |
-| Filtering        | Text, number, date, set, and boolean filters                           |
-| Aggregations     | Built-in aggregators (sum, avg, count, min, max) plus custom functions |
-| Row Grouping     | Hierarchical grouping with nested aggregations                         |
-| Tree Data        | Nested data structures with expand/collapse                            |
-| Pivot Tables     | Data transformation with row/column groups                             |
-| Server-Side Data | Lazy loading with block caching                                        |
-
-### Column Features
-
-| Feature       | Description                                  |
-| ------------- | -------------------------------------------- |
-| Pinning       | Sticky columns on left or right edges        |
-| Resizing      | Drag-to-resize with auto-sizing              |
-| Reordering    | Drag-and-drop repositioning                  |
-| Visibility    | Show/hide columns programmatically or via UI |
-| Header Groups | Multi-level column headers                   |
-
-### Selection & Export
-
-| Feature         | Description                        |
-| --------------- | ---------------------------------- |
-| Selection Modes | Cell, row, or range selection      |
-| Context Menus   | Configurable right-click menus     |
-| Master/Detail   | Expandable detail rows             |
-| Export          | CSV, Excel (XML), and JSON formats |
+<table>
+<tr><th colspan="2">Core Capabilities</th></tr>
+<tr><td>Virtualization</td><td>Row and column virtualization for datasets with 100k+ rows</td></tr>
+<tr><td>Keyboard Navigation</td><td>Full keyboard support including arrow keys, Tab, Enter, Home/End, PageUp/PageDown</td></tr>
+<tr><td>Accessibility</td><td>ARIA attributes and screen reader support</td></tr>
+<tr><td>Theming</td><td>CSS custom properties with 6 built-in themes</td></tr>
+<tr><td>Column Inference</td><td>Automatic column type detection from data</td></tr>
+<tr><th colspan="2">Editing</th></tr>
+<tr><td>Inline Editing</td><td>Cell and row editing modes with configurable triggers</td></tr>
+<tr><td>Undo/Redo</td><td>Edit history with Ctrl+Z / Ctrl+Y</td></tr>
+<tr><td>Clipboard</td><td>Copy/paste with configurable delimiters</td></tr>
+<tr><td>Change Tracking</td><td>Track modified rows with commit/reset lifecycle</td></tr>
+<tr><th colspan="2">Data Operations</th></tr>
+<tr><td>Sorting</td><td>Single and multi-column sorting</td></tr>
+<tr><td>Filtering</td><td>Text, number, date, set, and boolean filters</td></tr>
+<tr><td>Aggregations</td><td>Built-in aggregators (sum, avg, count, min, max) plus custom functions</td></tr>
+<tr><td>Row Grouping</td><td>Hierarchical grouping with nested aggregations</td></tr>
+<tr><td>Tree Data</td><td>Nested data structures with expand/collapse</td></tr>
+<tr><td>Pivot Tables</td><td>Data transformation with row/column groups</td></tr>
+<tr><td>Server-Side Data</td><td>Lazy loading with block caching</td></tr>
+<tr><th colspan="2">Column Features</th></tr>
+<tr><td>Pinning</td><td>Sticky columns on left or right edges</td></tr>
+<tr><td>Resizing</td><td>Drag-to-resize with auto-sizing</td></tr>
+<tr><td>Reordering</td><td>Drag-and-drop repositioning</td></tr>
+<tr><td>Visibility</td><td>Show/hide columns programmatically or via UI</td></tr>
+<tr><td>Header Groups</td><td>Multi-level column headers</td></tr>
+<tr><th colspan="2">Selection & Export</th></tr>
+<tr><td>Selection Modes</td><td>Cell, row, or range selection</td></tr>
+<tr><td>Context Menus</td><td>Configurable right-click menus</td></tr>
+<tr><td>Master/Detail</td><td>Expandable detail rows</td></tr>
+<tr><td>Export</td><td>CSV, Excel (XML), and JSON formats</td></tr>
+</table>
 
 ---
 
@@ -148,6 +131,7 @@ When the same property is set via multiple methods, higher precedence wins:
 | Property     | Type                    | Description                                        |
 | ------------ | ----------------------- | -------------------------------------------------- |
 | `rows`       | `T[]`                   | Data array                                         |
+| `sourceRows` | `T[]` (readonly)        | Original unfiltered/unprocessed rows               |
 | `columns`    | `ColumnConfig[]`        | Column definitions (→ `gridConfig.columns`)        |
 | `gridConfig` | `GridConfig`            | Full configuration object (single source of truth) |
 | `fitMode`    | `'stretch' \| 'fixed'`  | Column sizing behavior (→ `gridConfig.fitMode`)    |
@@ -164,18 +148,25 @@ When the same property is set via multiple methods, higher precedence wins:
 | `beginBulkEdit(rowIndex)`          | `Promise<void>`       | Start row editing                      |
 | `commitActiveRowEdit()`            | `Promise<void>`       | Commit current edit                    |
 | `setColumnVisible(field, visible)` | `boolean`             | Set column visibility                  |
+| `setColumnOrder(order)`            | `void`                | Reorder columns by field array         |
 | `getAllColumns()`                  | `ColumnInfo[]`        | Get all columns with visibility status |
+| `getPlugin(PluginClass)`           | `P \| undefined`      | Get plugin instance by class           |
+| `getPluginByName(name)`            | `Plugin \| undefined` | Get plugin instance by name            |
 
 ### Events
 
-| Event               | Detail                   | Description               |
-| ------------------- | ------------------------ | ------------------------- |
-| `cell-commit`       | `CellCommitDetail`       | Cell value committed      |
-| `row-commit`        | `RowCommitDetail`        | Row edit committed        |
-| `sort-change`       | `SortChangeDetail`       | Sort state changed        |
-| `column-resize`     | `ColumnResizeDetail`     | Column resized            |
-| `column-visibility` | `ColumnVisibilityDetail` | Column visibility changed |
-| `activate-cell`     | `ActivateCellDetail`     | Cell activated            |
+| Event                   | Detail                      | Description                   |
+| ----------------------- | --------------------------- | ----------------------------- |
+| `cell-commit`           | `CellCommitDetail`          | Cell value committed          |
+| `row-commit`            | `RowCommitDetail`           | Row edit committed            |
+| `changed-rows-reset`    | `ChangedRowsResetDetail`    | Change tracking cleared       |
+| `sort-change`           | `SortChangeDetail`          | Sort state changed            |
+| `column-resize`         | `ColumnResizeDetail`        | Column resized                |
+| `column-state-change`   | `ColumnState`               | Column state changed          |
+| `activate-cell`         | `ActivateCellDetail`        | Cell activated                |
+| `group-toggle`          | `GroupToggleDetail`         | Row group expanded/collapsed  |
+| `mount-external-view`   | `ExternalMountViewDetail`   | External view mount request   |
+| `mount-external-editor` | `ExternalMountEditorDetail` | External editor mount request |
 
 Import event names from the `DGEvents` constant:
 
@@ -215,7 +206,7 @@ Some column properties are added via [TypeScript module augmentation](#typescrip
 | `filterType`  | `filtering`       | Filter type              |
 | `reorderable` | `reorder`         | Enable column reordering |
 
-See [Storybook](https://your-storybook-url) for complete configuration examples.
+See [Storybook](https://oysteinamundsen.github.io/toolbox/) for complete configuration examples.
 
 ---
 
@@ -287,7 +278,7 @@ Apply a built-in theme:
 @import '@toolbox-web/grid/themes/dg-theme-standard.css';
 ```
 
-Available themes: `standard`, `contrast`, `vibrant`, `large`
+Available themes: `standard`, `contrast`, `vibrant`, `large`, `bootstrap`, `material`
 
 ### Custom Theming
 

package/all.d.ts

@@ -1985,56 +1985,10 @@ export declare class ContextMenuPlugin extends BaseGridPlugin_2<ContextMenuConfi
 
 export declare type DataGridCustomEvent<K extends keyof DataGridEventMap<any>, TRow = any> = CustomEvent<DataGridEventMap<TRow>[K]>;
 
-/**
- * High-performance data grid web component.
- * During migration, uses tbw-grid tag to avoid conflicts with existing datagrid.
- * Will be renamed back to data-grid when migration is complete.
- *
- * ## Configuration Architecture
- *
- * The grid follows a **single source of truth** pattern where all configuration
- * converges into `#effectiveConfig`. Users can set configuration via multiple inputs:
- *
- * **Input Sources (precedence low → high):**
- * 1. `gridConfig` property - base configuration object
- * 2. Light DOM elements:
- *    - `<tbw-grid-column>` → `effectiveConfig.columns`
- *    - `<tbw-grid-header title="...">` → `effectiveConfig.shell.header.title`
- *    - `<tbw-grid-header-content>` → `effectiveConfig.shell.header.content`
- * 3. `columns` property → merged into `effectiveConfig.columns`
- * 4. `fitMode` property → merged into `effectiveConfig.fitMode`
- * 5. `editOn` property → merged into `effectiveConfig.editOn`
- * 6. Column inference from first row (if no columns defined)
- *
- * **Derived State:**
- * - `_columns` - processed columns from `effectiveConfig.columns` after plugin hooks
- * - `_rows` - processed rows after plugin hooks (grouping, filtering, etc.)
- *
- * The `#mergeEffectiveConfig()` method is the single place where all inputs converge.
- * All rendering and logic should read from `effectiveConfig` or derived state.
- *
- * @element tbw-grid
- *
- * @csspart container - The main grid container
- * @csspart header - The header row container
- * @csspart body - The body/rows container
- *
- * @fires cell-commit - Fired when a cell value is committed
- * @fires row-commit - Fired when a bulk row edit session commits
- * @fires changed-rows-reset - Fired after resetChangedRows() unless silent
- * @fires mount-external-view - Fired to request mounting of an external view renderer
- * @fires mount-external-editor - Fired to request mounting of an external editor renderer
- * @fires sort-change - Fired when sort state changes for a column
- * @fires column-resize - Fired after a column resize drag completes
- * @fires activate-cell - Fired when a cell activation intent occurs
- * @fires group-toggle - Fired when a group row is toggled
- *
- * @cssprop --tbw-color-bg - Background color
- * @cssprop --tbw-color-fg - Foreground/text color
- */
 export declare class DataGridElement<T = any> extends HTMLElement implements InternalGrid<T> {
     #private;
     static readonly tagName = "tbw-grid";
+    static readonly version: string;
     _rows: T[];
     get _columns(): ColumnInternal<T>[];
     set _columns(value: ColumnInternal<T>[]);
@@ -2983,6 +2937,10 @@ export declare interface GridElement {
     rows: any[];
     columns: ColumnConfig[];
     gridConfig: any;
+    /** Current focused row index */
+    focusRow: number;
+    /** Current focused column index */
+    focusCol: number;
     /** AbortSignal that is aborted when the grid disconnects from the DOM */
     disconnectSignal: AbortSignal;
     requestRender(): void;
@@ -2998,6 +2956,10 @@ declare interface GridElement_2 {
     rows: any[];
     columns: ColumnConfig_2[];
     gridConfig: any;
+    /** Current focused row index */
+    focusRow: number;
+    /** Current focused column index */
+    focusCol: number;
     /** AbortSignal that is aborted when the grid disconnects from the DOM */
     disconnectSignal: AbortSignal;
     requestRender(): void;