@toolbox-web/grid 1.23.4 → 1.24.0

package/README.md

@@ -38,7 +38,7 @@ import { createGrid, queryGrid } from '@toolbox-web/grid';
 // Create a new typed grid
 const grid = createGrid<Employee>({
   columns: [{ field: 'name' }],
-  plugins: [new SelectionPlugin()],
+  features: { selection: 'row' },
 });
 
 // Query an existing grid with proper typing
@@ -59,10 +59,13 @@ The grid supports multiple configuration methods, all converging into a **single
 **1. Via `gridConfig` (recommended for complex setups):**
 
 ```typescript
+import '@toolbox-web/grid/features/selection';
+import '@toolbox-web/grid/features/editing';
+
 grid.gridConfig = {
   columns: [{ field: 'name' }, { field: 'age', type: 'number' }],
   fitMode: 'stretch',
-  plugins: [new SelectionPlugin({ mode: 'row' })],
+  features: { selection: 'row', editing: true },
   shell: { header: { title: 'My Data Grid' } },
 };
 ```
@@ -420,7 +423,8 @@ See the [documentation](https://toolboxjs.com/) for complete configuration examp
 interface GridConfig {
   columns?: ColumnConfig[];
   fitMode?: 'stretch' | 'fixed';
-  plugins?: BaseGridPlugin[]; // Array of plugin class instances
+  features?: Partial<FeatureConfig>; // Declarative feature configuration (recommended)
+  plugins?: BaseGridPlugin[]; // Manual plugin instances (advanced)
   icons?: GridIcons; // Centralized icon configuration
   shell?: ShellConfig; // Optional header bar and tool panels
   getRowId?: (row: T) => string; // Custom row ID resolver
@@ -504,7 +508,32 @@ Framework adapters (`@toolbox-web/grid-react`, `@toolbox-web/grid-angular`) prov
 
 ### Plugin Configuration Example
 
-Plugins are class instances that you import and instantiate with their configuration:
+#### Feature Props (Recommended)
+
+The simplest way to enable plugins is via **feature props** on `gridConfig.features`. Import the feature side-effect modules, then set the config declaratively:
+
+```typescript
+import '@toolbox-web/grid/features/selection';
+import '@toolbox-web/grid/features/grouping-rows';
+import '@toolbox-web/grid/features/filtering';
+
+grid.gridConfig = {
+  features: {
+    selection: { mode: 'row', multiple: true },
+    groupingRows: { groupOn: (row) => row.category, fullWidth: false, aggregators: { total: 'sum' } },
+    filtering: { debounceMs: 200 },
+  },
+};
+```
+
+Each feature import registers a factory; the grid creates the plugin instances from your config. This pattern is **tree-shakeable** — only imported features are bundled.
+
+> [!TIP]
+> For prototyping, import all features at once: `import '@toolbox-web/grid/features';`
+
+#### Manual Plugin Instantiation (Advanced)
+
+For full control (e.g., custom plugin subclasses or mixed feature+plugin setups), pass class instances to `plugins`:
 
 ```typescript
 import { GroupingRowsPlugin } from '@toolbox-web/grid/plugins/grouping-rows';
@@ -629,8 +658,8 @@ The grid uses a plugin architecture for optional features. Each plugin has its o
 | Master-Detail         | Expandable detail rows         | [README](./src/lib/plugins/master-detail/README.md)         |
 | Pinned Columns        | Sticky columns                 | [README](./src/lib/plugins/pinned-columns/README.md)        |
 | Pinned Rows           | Footer aggregations            | [README](./src/lib/plugins/pinned-rows/README.md)           |
-| Reorder               | Column drag reordering         | [README](./src/lib/plugins/reorder/README.md)               |
-| Row Reorder           | Row drag reordering            | [README](./src/lib/plugins/row-reorder/README.md)           |
+| Reorder Columns       | Column drag reordering         | [README](./src/lib/plugins/reorder-columns/README.md)       |
+| Reorder Rows          | Row drag reordering            | [README](./src/lib/plugins/reorder-rows/README.md)          |
 | Visibility            | Column visibility UI           | [README](./src/lib/plugins/visibility/README.md)            |
 | Responsive            | Card layout for mobile         | [README](./src/lib/plugins/responsive/README.md)            |
 | Clipboard             | Copy/paste                     | [README](./src/lib/plugins/clipboard/README.md)             |

package/all.d.ts

@@ -17,9 +17,9 @@ export * from './lib/plugins/pinned-columns';
 export * from './lib/plugins/pinned-rows';
 export * from './lib/plugins/pivot';
 export * from './lib/plugins/print';
-export * from './lib/plugins/reorder';
+export * from './lib/plugins/reorder-columns';
+export * from './lib/plugins/reorder-rows';
 export * from './lib/plugins/responsive';
-export * from './lib/plugins/row-reorder';
 export * from './lib/plugins/selection';
 export * from './lib/plugins/server-side';
 export * from './lib/plugins/tree';

package/all.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"all.d.ts","sourceRoot":"","sources":["../../../libs/grid/src/all.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,iBAAiB,CAAC;AAGzB,cAAc,UAAU,CAAC;AAGzB,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGlD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClE,YAAY,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGnD,cAAc,yBAAyB,CAAC;AACxC,cAAc,qCAAqC,CAAC;AACpD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC"}
+{"version":3,"file":"all.d.ts","sourceRoot":"","sources":["../../../libs/grid/src/all.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,iBAAiB,CAAC;AAGzB,cAAc,UAAU,CAAC;AAGzB,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGlD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClE,YAAY,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGnD,cAAc,yBAAyB,CAAC;AACxC,cAAc,qCAAqC,CAAC;AACpD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC"}