@toolbox-web/grid-angular 0.5.0 → 0.6.0

package/lib/feature-registry.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Feature Registry for @toolbox-web/grid-angular
+ *
+ * This module provides a synchronous registry for plugin factories.
+ * Features are registered via side-effect imports, enabling tree-shaking
+ * while maintaining the clean input-based API.
+ *
+ * @example
+ * ```typescript
+ * // Import features you need (side-effect imports)
+ * import '@toolbox-web/grid-angular/features/selection';
+ * import '@toolbox-web/grid-angular/features/filtering';
+ *
+ * // Inputs work automatically - no async loading, no HTTP requests
+ * <tbw-grid [selection]="'range'" [filtering]="{ debounceMs: 200 }" />
+ * ```
+ */
+/**
+ * Feature names supported by the Grid directive.
+ */
+export type FeatureName = 'selection' | 'editing' | 'clipboard' | 'contextMenu' | 'sorting' | 'filtering' | 'reorder' | 'visibility' | 'pinnedColumns' | 'groupingColumns' | 'columnVirtualization' | 'rowReorder' | 'groupingRows' | 'pinnedRows' | 'tree' | 'masterDetail' | 'responsive' | 'undoRedo' | 'export' | 'print' | 'pivot' | 'serverSide';
+/**
+ * Plugin factory function type.
+ * Takes configuration and returns a plugin instance.
+ */
+export type PluginFactory<TConfig = unknown> = (config: TConfig) => unknown;
+/**
+ * Register a feature's plugin factory.
+ * Called by side-effect feature imports.
+ *
+ * @param name - The feature name (matches the input name on Grid directive)
+ * @param factory - Function that creates the plugin instance
+ *
+ * @example
+ * ```ts
+ * // features/selection.ts
+ * import { SelectionPlugin } from '@toolbox-web/grid/plugins/selection';
+ * import { registerFeature } from '../lib/feature-registry';
+ *
+ * registerFeature('selection', (config) => new SelectionPlugin(config));
+ * ```
+ */
+export declare function registerFeature<TConfig = unknown>(name: FeatureName, factory: PluginFactory<TConfig>): void;
+/**
+ * Check if a feature is registered.
+ */
+export declare function isFeatureRegistered(name: FeatureName): boolean;
+/**
+ * Get a registered feature's factory.
+ * Returns undefined if not registered.
+ */
+export declare function getFeatureFactory(name: FeatureName): PluginFactory | undefined;
+/**
+ * Get all registered feature names.
+ * Useful for debugging.
+ */
+export declare function getRegisteredFeatures(): FeatureName[];
+/**
+ * Create a plugin instance for a feature.
+ * Shows a helpful warning if the feature is not registered.
+ *
+ * @param name - Feature name
+ * @param config - Plugin configuration
+ * @returns Plugin instance or undefined if not registered
+ */
+export declare function createPluginFromFeature<TConfig = unknown>(name: FeatureName, config: TConfig): unknown | undefined;
+/**
+ * Clear the registry. For testing only.
+ * @internal
+ */
+export declare function clearFeatureRegistry(): void;
+//# sourceMappingURL=feature-registry.d.ts.map

package/lib/feature-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-registry.d.ts","sourceRoot":"","sources":["../../../../libs/grid-angular/src/lib/feature-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB,WAAW,GACX,SAAS,GACT,WAAW,GACX,aAAa,GACb,SAAS,GACT,WAAW,GACX,SAAS,GACT,YAAY,GACZ,eAAe,GACf,iBAAiB,GACjB,sBAAsB,GACtB,YAAY,GACZ,cAAc,GACd,YAAY,GACZ,MAAM,GACN,cAAc,GACd,YAAY,GACZ,UAAU,GACV,QAAQ,GACR,OAAO,GACP,OAAO,GACP,YAAY,CAAC;AAEjB;;;GAGG;AACH,MAAM,MAAM,aAAa,CAAC,OAAO,GAAG,OAAO,IAAI,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC;AAuB5E;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAG,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,IAAI,CAK3G;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAE9D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,aAAa,GAAG,SAAS,CAE9E;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,WAAW,EAAE,CAErD;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,GAAG,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAqBlH;AASD;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAG3C"}

package/lib/grid-type-registry.d.ts

@@ -1,5 +1,5 @@
 import { EnvironmentProviders, InjectionToken, Type } from '@angular/core';
-import { TypeDefault } from '../../../../dist/libs/grid/index.d.ts';
+import { TypeDefault } from '@toolbox-web/grid';
 /**
  * Angular-specific type default configuration.
  * Uses Angular component types instead of function-based renderers/editors.

package/lib/inject-grid.d.ts

@@ -0,0 +1,109 @@
+import { Signal } from '@angular/core';
+import { ColumnConfig, DataGridElement, GridConfig } from '@toolbox-web/grid';
+/**
+ * Selection convenience methods returned from injectGrid.
+ */
+export interface SelectionMethods<TRow = unknown> {
+    /**
+     * Select all rows in the grid.
+     * Requires SelectionPlugin with mode: 'row'.
+     */
+    selectAll: () => void;
+    /**
+     * Clear all selection.
+     * Works with any SelectionPlugin mode.
+     */
+    clearSelection: () => void;
+    /**
+     * Get selected row indices.
+     * Returns Set of selected row indices.
+     */
+    getSelectedIndices: () => Set<number>;
+    /**
+     * Get selected rows data.
+     * Returns array of selected row objects.
+     */
+    getSelectedRows: () => TRow[];
+}
+/**
+ * Export convenience methods returned from injectGrid.
+ */
+export interface ExportMethods {
+    /**
+     * Export grid data to CSV file.
+     * Requires ExportPlugin to be loaded.
+     *
+     * @param filename - Optional filename (defaults to 'export.csv')
+     */
+    exportToCsv: (filename?: string) => void;
+    /**
+     * Export grid data to JSON file.
+     * Requires ExportPlugin to be loaded.
+     *
+     * @param filename - Optional filename (defaults to 'export.json')
+     */
+    exportToJson: (filename?: string) => void;
+}
+/**
+ * Return type for injectGrid function.
+ */
+export interface InjectGridReturn<TRow = unknown> extends SelectionMethods<TRow>, ExportMethods {
+    /** Direct access to the typed grid element */
+    element: Signal<DataGridElement<TRow> | null>;
+    /** Whether the grid is ready */
+    isReady: Signal<boolean>;
+    /** Current grid configuration */
+    config: Signal<GridConfig<TRow> | null>;
+    /** Get the effective configuration */
+    getConfig: () => Promise<GridConfig<TRow> | null>;
+    /** Force a layout recalculation */
+    forceLayout: () => Promise<void>;
+    /** Toggle a group row */
+    toggleGroup: (key: string) => Promise<void>;
+    /** Register custom styles */
+    registerStyles: (id: string, css: string) => void;
+    /** Unregister custom styles */
+    unregisterStyles: (id: string) => void;
+    /** Get current visible columns */
+    visibleColumns: Signal<ColumnConfig<TRow>[]>;
+}
+/**
+ * Angular inject function for programmatic access to a grid instance.
+ *
+ * This function should be called in the constructor or as a field initializer
+ * of an Angular component that contains a `<tbw-grid>` element.
+ *
+ * ## Usage
+ *
+ * ```typescript
+ * import { Component, CUSTOM_ELEMENTS_SCHEMA } from '@angular/core';
+ * import { Grid, injectGrid } from '@toolbox-web/grid-angular';
+ *
+ * @Component({
+ *   selector: 'app-my-grid',
+ *   imports: [Grid],
+ *   schemas: [CUSTOM_ELEMENTS_SCHEMA],
+ *   template: `
+ *     <button (click)="handleResize()">Force Layout</button>
+ *     <button (click)="handleExport()" [disabled]="!grid.isReady()">Export</button>
+ *     <tbw-grid [rows]="rows" [gridConfig]="config"></tbw-grid>
+ *   `
+ * })
+ * export class MyGridComponent {
+ *   grid = injectGrid<Employee>();
+ *
+ *   async handleResize() {
+ *     await this.grid.forceLayout();
+ *   }
+ *
+ *   async handleExport() {
+ *     const config = await this.grid.getConfig();
+ *     console.log('Exporting with columns:', config?.columns);
+ *   }
+ * }
+ * ```
+ *
+ * @returns Object with grid access methods and state signals
+ */
+export declare function injectGrid<TRow = unknown>(): InjectGridReturn<TRow>;
+//# sourceMappingURL=inject-grid.d.ts.map

package/lib/inject-grid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-grid.d.ts","sourceRoot":"","sources":["../../../../libs/grid-angular/src/lib/inject-grid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiD,KAAK,MAAM,EAAU,MAAM,eAAe,CAAC;AACnG,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEnF;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,IAAI,GAAG,OAAO;IAC9C;;;OAGG;IACH,SAAS,EAAE,MAAM,IAAI,CAAC;IAEtB;;;OAGG;IACH,cAAc,EAAE,MAAM,IAAI,CAAC;IAE3B;;;OAGG;IACH,kBAAkB,EAAE,MAAM,GAAG,CAAC,MAAM,CAAC,CAAC;IAEtC;;;OAGG;IACH,eAAe,EAAE,MAAM,IAAI,EAAE,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,WAAW,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAEzC;;;;;OAKG;IACH,YAAY,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,IAAI,GAAG,OAAO,CAAE,SAAQ,gBAAgB,CAAC,IAAI,CAAC,EAAE,aAAa;IAC7F,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IAC9C,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACzB,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IACxC,sCAAsC;IACtC,SAAS,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IAClD,mCAAmC;IACnC,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,yBAAyB;IACzB,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,6BAA6B;IAC7B,cAAc,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,+BAA+B;IAC/B,gBAAgB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,kCAAkC;IAClC,cAAc,EAAE,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;CAC9C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,UAAU,CAAC,IAAI,GAAG,OAAO,KAAK,gBAAgB,CAAC,IAAI,CAAC,CAgLnE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toolbox-web/grid-angular",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Angular adapter for @toolbox-web/grid data grid component",
   "type": "module",
   "main": "./index.js",
@@ -12,6 +12,16 @@
       "types": "./index.d.ts",
       "import": "./index.js",
       "default": "./index.js"
+    },
+    "./features": {
+      "types": "./features/index.d.ts",
+      "import": "./features/index.js",
+      "default": "./features/index.js"
+    },
+    "./features/*": {
+      "types": "./features/*.d.ts",
+      "import": "./features/*.js",
+      "default": "./features/*.js"
     }
   },
   "keywords": [