npm - @gridstorm/angular - Versions diffs - 0.1.2 → 0.1.3 - Mend

@gridstorm/angular 0.1.2 → 0.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (11) hide show

package/LICENSE.md +21 -0
package/README.md +203 -203
package/dist/index.cjs +11 -1
package/dist/index.cjs.map +1 -1
package/dist/index.d.cts +2 -0
package/dist/index.d.ts +2 -0
package/dist/index.js +11 -1
package/dist/index.js.map +1 -1
package/package.json +7 -7
package/src/__tests__/angular-adapter.test.ts +379 -0
package/src/gridstorm.component.ts +10 -1

package/LICENSE.md ADDED Viewed

@@ -0,0 +1,21 @@
+MIT License
+Copyright (c) 2026 GridStorm Contributors
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md CHANGED Viewed

@@ -1,203 +1,203 @@
-# @gridstorm/angular
-Angular adapter for [GridStorm](https://grid-data-analytics-explorer.vercel.app/) -- a high-performance, headless data grid engine.
-Provides a standalone Angular component (`<gridstorm>`) that wraps the GridStorm core engine and DOM renderer. Requires Angular 16+ (standalone component support).
-## Installation
-```bash
-npm install @gridstorm/angular @gridstorm/core @gridstorm/dom-renderer
-# or
-pnpm add @gridstorm/angular @gridstorm/core @gridstorm/dom-renderer
-```
-## Quick Start
-Import the standalone component directly in your Angular component:
-```typescript
-import { Component } from '@angular/core';
-import { GridStormComponent } from '@gridstorm/angular';
-import { sortingPlugin } from '@gridstorm/plugin-sorting';
-import type { GridApi, ColumnDef } from '@gridstorm/angular';
-@Component({
-  selector: 'app-employees',
-  standalone: true,
-  imports: [GridStormComponent],
-  template: `
-    <gridstorm
-      [columns]="columns"
-      [rowData]="rowData"
-      [plugins]="plugins"
-      [rowHeight]="40"
-      [theme]="'dark'"
-      [density]="'normal'"
-      (gridReady)="onGridReady($event)"
-      (selectionChanged)="onSelectionChanged($event)"
-      style="height: 600px; width: 100%;"
-    ></gridstorm>
-  `,
-})
-export class EmployeesComponent {
-  columns: ColumnDef[] = [
-    { field: 'name', headerName: 'Name', sortable: true },
-    { field: 'department', headerName: 'Department', sortable: true },
-    { field: 'salary', headerName: 'Salary', width: 120 },
-  ];
-  rowData = [
-    { name: 'Alice', department: 'Engineering', salary: 95000 },
-    { name: 'Bob', department: 'Marketing', salary: 72000 },
-    { name: 'Charlie', department: 'Engineering', salary: 110000 },
-  ];
-  plugins = [sortingPlugin()];
-  private gridApi: GridApi | null = null;
-  onGridReady(api: GridApi) {
-    this.gridApi = api;
-  }
-  onSelectionChanged(event: any) {
-    console.log('Selection changed:', event);
-  }
-}
-```
-## Inputs
-| Input               | Type                        | Default    | Description                                     |
-| ------------------- | --------------------------- | ---------- | ----------------------------------------------- |
-| `columns`           | `ColumnDef[]`               | `[]`       | Column definitions                                 |
-| `rowData`           | `any[]`                     | `[]`       | Row data array                                     |
-| `plugins`           | `GridPlugin[]`              | `[]`       | Plugins to install                                 |
-| `getRowId`          | `(params) => string`        | `undefined`| Custom row ID generator                         |
-| `rowHeight`         | `number`                    | `40`       | Row height in pixels                            |
-| `theme`             | `string`                    | `'light'`  | Theme name (`'light'`, `'dark'`, or custom)     |
-| `density`           | `string`                    | `'normal'` | Density mode (`'compact'`, `'normal'`, etc.)    |
-| `defaultColDef`     | `Partial<ColumnDef>`        | `undefined`| Default column config applied to all columns    |
-| `paginationPageSize`| `number`                    | `undefined`| Rows per page (when pagination enabled)         |
-| `headerHeight`      | `number`                    | `undefined`| Header row height in pixels                     |
-| `domLayout`         | `'normal' \| 'autoHeight'`  | `undefined`| DOM layout mode                                 |
-| `rowSelection`      | `'single' \| 'multiple'`    | `undefined`| Row selection mode                              |
-| `pagination`        | `boolean`                   | `undefined`| Enable client-side pagination                   |
-| `ariaLabel`         | `string`                    | `undefined`| ARIA label for accessibility                    |
-## Outputs
-| Output              | Payload                     | Description                                     |
-| ------------------- | --------------------------- | ----------------------------------------------- |
-| `gridReady`         | `GridApi`                   | Grid initialized, API is ready                  |
-| `rowDataChanged`    | `{ rowData: any[] }`        | Row data was replaced                           |
-| `selectionChanged`  | `{ selectedNodes, source }` | Row selection changed                           |
-| `sortChanged`       | `{ sortModel }`             | Sort model changed                              |
-| `filterChanged`     | `{ filterModel }`           | Filter model changed                            |
-| `cellValueChanged`  | `{ node, colId, ... }`      | Cell value edited                               |
-| `cellClicked`       | `{ node, colId, value }`    | Cell was clicked                                |
-| `cellDoubleClicked` | `{ node, colId, value }`    | Cell was double-clicked                         |
-| `rowClicked`        | `{ node, event }`           | Row was clicked                                 |
-| `paginationChanged` | `{ currentPage, ... }`      | Pagination state changed                        |
-| `columnResized`     | `{ column, ... }`           | Column was resized                              |
-## GridStormService
-An injectable service for managing multiple grid instances across your application:
-```typescript
-import { Component, OnDestroy } from '@angular/core';
-import { GridStormComponent, GridStormService } from '@gridstorm/angular';
-import type { GridApi } from '@gridstorm/angular';
-@Component({
-  selector: 'app-dashboard',
-  standalone: true,
-  imports: [GridStormComponent],
-  template: `
-    <gridstorm
-      [columns]="columns"
-      [rowData]="rowData"
-      (gridReady)="onGridReady($event)"
-    ></gridstorm>
-  `,
-})
-export class DashboardComponent implements OnDestroy {
-  // ... columns, rowData ...
-  constructor(private gridService: GridStormService) {}
-  onGridReady(api: GridApi) {
-    this.gridService.registerApi('dashboard-grid', api);
-  }
-  ngOnDestroy() {
-    this.gridService.removeApi('dashboard-grid');
-  }
-}
-```
-Access from another component:
-```typescript
-export class ToolbarComponent {
-  constructor(private gridService: GridStormService) {}
-  exportSelected() {
-    const api = this.gridService.getApi('dashboard-grid');
-    if (api) {
-      const rows = api.getSelectedRows();
-      // ... export logic
-    }
-  }
-}
-```
-## Build Notes
-This package ships TypeScript source files alongside the tsup-compiled output. Since Angular decorators require the Angular compiler for AOT (ahead-of-time) compilation in production builds, there are two integration approaches:
-### Development / JIT Mode
-Import directly from the package -- the compiled ESM/CJS output works with Angular's JIT compiler:
-```typescript
-import { GridStormComponent, GridStormService } from '@gridstorm/angular';
-```
-### Production / AOT Builds
-For production AOT builds, you may need to use `ngPackagr` or include the source files in your Angular project's compilation. The raw `.ts` source files are included in the published package under `src/` for this purpose.
-## Theming
-Apply the `@gridstorm/theme-default` stylesheet and use the `theme` and `density` inputs:
-```typescript
-// In your angular.json styles array:
-// "node_modules/@gridstorm/theme-default/dist/index.css"
-@Component({
-  template: `
-    <gridstorm
-      [columns]="columns"
-      [rowData]="rowData"
-      [theme]="currentTheme"
-      [density]="currentDensity"
-    ></gridstorm>
-  `,
-})
-export class ThemedGridComponent {
-  currentTheme = 'dark';
-  currentDensity = 'compact';
-  toggleTheme() {
-    this.currentTheme = this.currentTheme === 'light' ? 'dark' : 'light';
-  }
-}
-```
-## License
-MIT
+# @gridstorm/angular
+Angular adapter for [GridStorm](https://grid-data-analytics-explorer.vercel.app/) -- a high-performance, headless data grid engine.
+Provides a standalone Angular component (`<gridstorm>`) that wraps the GridStorm core engine and DOM renderer. Requires Angular 16+ (standalone component support).
+## Installation
+```bash
+npm install @gridstorm/angular @gridstorm/core @gridstorm/dom-renderer
+# or
+pnpm add @gridstorm/angular @gridstorm/core @gridstorm/dom-renderer
+```
+## Quick Start
+Import the standalone component directly in your Angular component:
+```typescript
+import { Component } from '@angular/core';
+import { GridStormComponent } from '@gridstorm/angular';
+import { sortingPlugin } from '@gridstorm/plugin-sorting';
+import type { GridApi, ColumnDef } from '@gridstorm/angular';
+@Component({
+  selector: 'app-employees',
+  standalone: true,
+  imports: [GridStormComponent],
+  template: `
+    <gridstorm
+      [columns]="columns"
+      [rowData]="rowData"
+      [plugins]="plugins"
+      [rowHeight]="40"
+      [theme]="'dark'"
+      [density]="'normal'"
+      (gridReady)="onGridReady($event)"
+      (selectionChanged)="onSelectionChanged($event)"
+      style="height: 600px; width: 100%;"
+    ></gridstorm>
+  `,
+})
+export class EmployeesComponent {
+  columns: ColumnDef[] = [
+    { field: 'name', headerName: 'Name', sortable: true },
+    { field: 'department', headerName: 'Department', sortable: true },
+    { field: 'salary', headerName: 'Salary', width: 120 },
+  ];
+  rowData = [
+    { name: 'Alice', department: 'Engineering', salary: 95000 },
+    { name: 'Bob', department: 'Marketing', salary: 72000 },
+    { name: 'Charlie', department: 'Engineering', salary: 110000 },
+  ];
+  plugins = [sortingPlugin()];
+  private gridApi: GridApi | null = null;
+  onGridReady(api: GridApi) {
+    this.gridApi = api;
+  }
+  onSelectionChanged(event: any) {
+    console.log('Selection changed:', event);
+  }
+}
+```
+## Inputs
+| Input               | Type                        | Default    | Description                                     |
+| ------------------- | --------------------------- | ---------- | ----------------------------------------------- |
+| `columns`           | `ColumnDef[]`               | `[]`       | Column definitions                                 |
+| `rowData`           | `any[]`                     | `[]`       | Row data array                                     |
+| `plugins`           | `GridPlugin[]`              | `[]`       | Plugins to install                                 |
+| `getRowId`          | `(params) => string`        | `undefined`| Custom row ID generator                         |
+| `rowHeight`         | `number`                    | `40`       | Row height in pixels                            |
+| `theme`             | `string`                    | `'light'`  | Theme name (`'light'`, `'dark'`, or custom)     |
+| `density`           | `string`                    | `'normal'` | Density mode (`'compact'`, `'normal'`, etc.)    |
+| `defaultColDef`     | `Partial<ColumnDef>`        | `undefined`| Default column config applied to all columns    |
+| `paginationPageSize`| `number`                    | `undefined`| Rows per page (when pagination enabled)         |
+| `headerHeight`      | `number`                    | `undefined`| Header row height in pixels                     |
+| `domLayout`         | `'normal' \| 'autoHeight'`  | `undefined`| DOM layout mode                                 |
+| `rowSelection`      | `'single' \| 'multiple'`    | `undefined`| Row selection mode                              |
+| `pagination`        | `boolean`                   | `undefined`| Enable client-side pagination                   |
+| `ariaLabel`         | `string`                    | `undefined`| ARIA label for accessibility                    |
+## Outputs
+| Output              | Payload                     | Description                                     |
+| ------------------- | --------------------------- | ----------------------------------------------- |
+| `gridReady`         | `GridApi`                   | Grid initialized, API is ready                  |
+| `rowDataChanged`    | `{ rowData: any[] }`        | Row data was replaced                           |
+| `selectionChanged`  | `{ selectedNodes, source }` | Row selection changed                           |
+| `sortChanged`       | `{ sortModel }`             | Sort model changed                              |
+| `filterChanged`     | `{ filterModel }`           | Filter model changed                            |
+| `cellValueChanged`  | `{ node, colId, ... }`      | Cell value edited                               |
+| `cellClicked`       | `{ node, colId, value }`    | Cell was clicked                                |
+| `cellDoubleClicked` | `{ node, colId, value }`    | Cell was double-clicked                         |
+| `rowClicked`        | `{ node, event }`           | Row was clicked                                 |
+| `paginationChanged` | `{ currentPage, ... }`      | Pagination state changed                        |
+| `columnResized`     | `{ column, ... }`           | Column was resized                              |
+## GridStormService
+An injectable service for managing multiple grid instances across your application:
+```typescript
+import { Component, OnDestroy } from '@angular/core';
+import { GridStormComponent, GridStormService } from '@gridstorm/angular';
+import type { GridApi } from '@gridstorm/angular';
+@Component({
+  selector: 'app-dashboard',
+  standalone: true,
+  imports: [GridStormComponent],
+  template: `
+    <gridstorm
+      [columns]="columns"
+      [rowData]="rowData"
+      (gridReady)="onGridReady($event)"
+    ></gridstorm>
+  `,
+})
+export class DashboardComponent implements OnDestroy {
+  // ... columns, rowData ...
+  constructor(private gridService: GridStormService) {}
+  onGridReady(api: GridApi) {
+    this.gridService.registerApi('dashboard-grid', api);
+  }
+  ngOnDestroy() {
+    this.gridService.removeApi('dashboard-grid');
+  }
+}
+```
+Access from another component:
+```typescript
+export class ToolbarComponent {
+  constructor(private gridService: GridStormService) {}
+  exportSelected() {
+    const api = this.gridService.getApi('dashboard-grid');
+    if (api) {
+      const rows = api.getSelectedRows();
+      // ... export logic
+    }
+  }
+}
+```
+## Build Notes
+This package ships TypeScript source files alongside the tsup-compiled output. Since Angular decorators require the Angular compiler for AOT (ahead-of-time) compilation in production builds, there are two integration approaches:
+### Development / JIT Mode
+Import directly from the package -- the compiled ESM/CJS output works with Angular's JIT compiler:
+```typescript
+import { GridStormComponent, GridStormService } from '@gridstorm/angular';
+```
+### Production / AOT Builds
+For production AOT builds, you may need to use `ngPackagr` or include the source files in your Angular project's compilation. The raw `.ts` source files are included in the published package under `src/` for this purpose.
+## Theming
+Apply the `@gridstorm/theme-default` stylesheet and use the `theme` and `density` inputs:
+```typescript
+// In your angular.json styles array:
+// "node_modules/@gridstorm/theme-default/dist/index.css"
+@Component({
+  template: `
+    <gridstorm
+      [columns]="columns"
+      [rowData]="rowData"
+      [theme]="currentTheme"
+      [density]="currentDensity"
+    ></gridstorm>
+  `,
+})
+export class ThemedGridComponent {
+  currentTheme = 'dark';
+  currentDensity = 'compact';
+  toggleTheme() {
+    this.currentTheme = this.currentTheme === 'light' ? 'dark' : 'light';
+  }
+}
+```
+## License
+MIT

package/dist/index.cjs CHANGED Viewed

@@ -33,6 +33,7 @@ exports.GridStormComponent = class GridStormComponent {
     this.rowClicked = new core.EventEmitter();
     this.paginationChanged = new core.EventEmitter();
     this.columnResized = new core.EventEmitter();
+    this.gridError = new core.EventEmitter();
     // ── Internal state ──
     this.engine = null;
     this.renderer = null;
@@ -40,7 +41,13 @@ exports.GridStormComponent = class GridStormComponent {
   }
   // ── Lifecycle ──
   ngOnInit() {
-    this.initGrid();
+    try {
+      this.initGrid();
+    } catch (err) {
+      const error = err instanceof Error ? err : new Error(String(err));
+      console.error("[GridStorm Angular] Initialization error:", error);
+      this.gridError.emit(error);
+    }
   }
   ngOnChanges(changes) {
     if (!this.engine) return;
@@ -208,6 +215,9 @@ __decorateClass([
 __decorateClass([
   core.Output()
 ], exports.GridStormComponent.prototype, "columnResized", 2);
+__decorateClass([
+  core.Output()
+], exports.GridStormComponent.prototype, "gridError", 2);
 __decorateClass([
   core.ViewChild("gridContainer", { static: true })
 ], exports.GridStormComponent.prototype, "gridContainerRef", 2);

package/dist/index.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/gridstorm.component.ts","../src/gridstorm.service.ts"],"names":["GridStormComponent","EventEmitter","createGrid","DomRenderer","Input","Output","ViewChild","Component","GridStormService","Injectable"],"mappings":"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","file":"index.cjs","sourcesContent":["// ─── GridStorm Angular Component ───\n// Standalone Angular component wrapping the headless core engine + DOM renderer.\n// Uses ElementRef + ViewChild to mount the DomRenderer into the template container.\n\nimport {\n Component,\n Input,\n Output,\n EventEmitter,\n ElementRef,\n OnInit,\n OnDestroy,\n OnChanges,\n SimpleChanges,\n ViewChild,\n} from '@angular/core';\nimport { createGrid } from '@gridstorm/core';\nimport { DomRenderer } from '@gridstorm/dom-renderer';\nimport type { GridConfig, GridApi, GridEngine, ColumnDef, GridPlugin } from '@gridstorm/core';\n\n@Component({\n selector: 'gridstorm',\n standalone: true,\n template: `\n <div\n #gridContainer\n class=\"gridstorm-wrapper\"\n [attr.data-theme]=\"theme\"\n [attr.data-density]=\"density\"\n style=\"width:100%;height:100%\"\n ></div>\n `,\n})\nexport class GridStormComponent implements OnInit, OnDestroy, OnChanges {\n // ── Inputs ──\n\n /** Column definitions describing each column's structure and behavior. /\n @Input() columns: ColumnDef[] = [];\n\n /* Client-side row data array. /\n @Input() rowData: any[] = [];\n\n /* Array of plugins to install during grid initialization. /\n @Input() plugins: GridPlugin[] = [];\n\n /* Callback to generate a unique string ID for each row. /\n @Input() getRowId?: (params: any) => string;\n\n /* Height of each data row in pixels. /\n @Input() rowHeight = 40;\n\n /* Theme identifier: 'light', 'dark', or custom theme name. /\n @Input() theme = 'light';\n\n /* Density mode: 'compact', 'normal', or 'comfortable'. /\n @Input() density = 'normal';\n\n /* Default column definition applied to all columns as fallback. /\n @Input() defaultColDef?: Partial<ColumnDef>;\n\n /* Number of rows per page when pagination is enabled. /\n @Input() paginationPageSize?: number;\n\n /* Height of the header row in pixels. /\n @Input() headerHeight?: number;\n\n /* Controls how the grid's DOM height is determined. /\n @Input() domLayout?: 'normal' \| 'autoHeight' \| 'print';\n\n /* Row selection mode: 'single', 'multiple', or false (disabled). /\n @Input() rowSelection?: 'single' \| 'multiple' \| false;\n\n /* When true, enables client-side pagination. /\n @Input() pagination?: boolean;\n\n /* ARIA label for the grid root element (screen reader accessibility). /\n @Input() ariaLabel?: string;\n\n // ── Outputs ──\n\n /* Emitted when the grid engine is fully initialized and the API is ready. /\n @Output() gridReady = new EventEmitter<GridApi>();\n\n /* Emitted when row data changes. /\n @Output() rowDataChanged = new EventEmitter<any>();\n\n /* Emitted when the selection state changes. /\n @Output() selectionChanged = new EventEmitter<any>();\n\n /* Emitted when the sort model changes. /\n @Output() sortChanged = new EventEmitter<any>();\n\n /* Emitted when the filter model changes. /\n @Output() filterChanged = new EventEmitter<any>();\n\n /* Emitted when a cell value is changed through editing. /\n @Output() cellValueChanged = new EventEmitter<any>();\n\n /* Emitted when a cell is clicked. /\n @Output() cellClicked = new EventEmitter<any>();\n\n /* Emitted when a cell is double-clicked. /\n @Output() cellDoubleClicked = new EventEmitter<any>();\n\n /* Emitted when a row is clicked. /\n @Output() rowClicked = new EventEmitter<any>();\n\n /* Emitted when pagination state changes. /\n @Output() paginationChanged = new EventEmitter<any>();\n\n /* Emitted when a column is resized. /\n @Output() columnResized = new EventEmitter<any>();\n\n // ── Template reference ──\n\n @ViewChild('gridContainer', { static: true })\n private gridContainerRef!: ElementRef<HTMLElement>;\n\n // ── Internal state ──\n\n private engine: GridEngine \| null = null;\n private renderer: DomRenderer \| null = null;\n private eventUnsubscribers: Array<() => void> = [];\n\n // ── Lifecycle ──\n\n ngOnInit(): void {\n this.initGrid();\n }\n\n ngOnChanges(changes: SimpleChanges): void {\n if (!this.engine) return;\n\n // Sync rowData changes to the engine\n if (changes['rowData'] && !changes['rowData'].firstChange) {\n this.engine.api.setRowData(this.rowData);\n }\n\n // Sync column definition changes to the engine\n if (changes['columns'] && !changes['columns'].firstChange) {\n this.engine.api.setColumnDefs(this.columns);\n }\n\n // Sync pagination page size\n if (changes['paginationPageSize'] && !changes['paginationPageSize'].firstChange) {\n if (this.paginationPageSize != null) {\n this.engine.api.setGridOption('paginationPageSize', this.paginationPageSize);\n }\n }\n }\n\n ngOnDestroy(): void {\n this.destroyGrid();\n }\n\n // ── Public API ──\n\n /\n Returns the underlying GridApi instance, or null if the grid\n * has not been initialized yet.\n /\n getApi(): GridApi \| null {\n return this.engine?.api ?? null;\n }\n\n /\n Returns the underlying GridEngine instance, or null if the grid\n * has not been initialized yet.\n /\n getEngine(): GridEngine \| null {\n return this.engine;\n }\n\n // ── Initialization ──\n\n private initGrid(): void {\n const container = this.gridContainerRef.nativeElement;\n if (!container) return;\n\n // Build core config from inputs\n const config: GridConfig = {\n columns: this.columns,\n rowData: this.rowData,\n plugins: this.plugins,\n getRowId: this.getRowId,\n rowHeight: this.rowHeight,\n headerHeight: this.headerHeight,\n defaultColDef: this.defaultColDef,\n domLayout: this.domLayout,\n rowSelection: this.rowSelection,\n pagination: this.pagination,\n paginationPageSize: this.paginationPageSize,\n ariaLabel: this.ariaLabel,\n theme: this.theme,\n };\n\n // Create the headless grid engine\n this.engine = createGrid(config);\n\n // Create and mount the DOM renderer\n this.renderer = new DomRenderer({\n container,\n engine: this.engine,\n });\n this.renderer.mount();\n\n // Wire up event bridge: core events -> Angular EventEmitters\n this.setupEventBridge();\n\n // Emit gridReady\n this.gridReady.emit(this.engine.api);\n }\n\n private setupEventBridge(): void {\n if (!this.engine) return;\n\n const eb = this.engine.eventBus;\n\n this.eventUnsubscribers = [\n eb.on('rowData:changed', (e) => this.rowDataChanged.emit(e)),\n eb.on('selection:changed', (e) => this.selectionChanged.emit(e)),\n eb.on('column:sort:changed', (e) => this.sortChanged.emit(e)),\n eb.on('filter:changed', (e) => this.filterChanged.emit(e)),\n eb.on('cell:valueChanged', (e) => this.cellValueChanged.emit(e)),\n eb.on('cell:clicked', (e) => this.cellClicked.emit(e)),\n eb.on('cell:doubleClicked', (e) => this.cellDoubleClicked.emit(e)),\n eb.on('row:clicked', (e) => this.rowClicked.emit(e)),\n eb.on('pagination:changed', (e) => this.paginationChanged.emit(e)),\n eb.on('column:resized', (e) => this.columnResized.emit(e)),\n ];\n }\n\n private destroyGrid(): void {\n // Unsubscribe from all core events\n for (const unsub of this.eventUnsubscribers) {\n unsub();\n }\n this.eventUnsubscribers = [];\n\n // Destroy the DOM renderer\n if (this.renderer) {\n this.renderer.destroy();\n this.renderer = null;\n }\n\n // Destroy the grid engine\n if (this.engine) {\n this.engine.destroy();\n this.engine = null;\n }\n }\n}\n","// ─── GridStorm Service ───\n// Injectable service for managing multiple GridStorm instances.\n// Allows Angular components to access grid APIs by a unique identifier,\n// useful in applications with multiple grids or cross-component communication.\n\nimport { Injectable } from '@angular/core';\nimport type { GridApi } from '@gridstorm/core';\n\n/\n Service for registering and retrieving GridStorm API instances.\n \n Use this service when you have multiple grids in your application\n * and need to access their APIs from different components or services.\n \n @example\n * ```typescript\n * // In a component that hosts the grid:\n * constructor(private gridService: GridStormService) {}\n \n onGridReady(api: GridApi) {\n * this.gridService.registerApi('employees', api);\n * }\n \n // In another component that needs to interact with the grid:\n * constructor(private gridService: GridStormService) {}\n \n exportData() {\n * const api = this.gridService.getApi('employees');\n * if (api) {\n * const rows = api.getSelectedRows();\n * // ... do something with rows\n * }\n * }\n * ```\n /\n@Injectable({ providedIn: 'root' })\nexport class GridStormService {\n private apiMap = new Map<string, GridApi>();\n\n /\n Registers a GridApi instance under a unique identifier.\n \n Call this from the `(gridReady)` output handler of the `<gridstorm>` component.\n * If an API with the same ID already exists, it will be replaced.\n \n @param id - A unique string identifier for this grid instance.\n * @param api - The GridApi instance to register.\n /\n registerApi(id: string, api: GridApi): void {\n this.apiMap.set(id, api);\n }\n\n /\n Retrieves a previously registered GridApi by its identifier.\n \n @param id - The unique identifier used during registration.\n * @returns The GridApi instance, or `undefined` if not found.\n /\n getApi(id: string): GridApi \| undefined {\n return this.apiMap.get(id);\n }\n\n /\n Removes a registered GridApi by its identifier.\n \n Call this when a grid component is destroyed to prevent memory leaks.\n \n @param id - The unique identifier of the API to remove.\n /\n removeApi(id: string): void {\n this.apiMap.delete(id);\n }\n\n /\n Returns all registered grid API identifiers.\n \n @returns An array of registered grid IDs.\n /\n getRegisteredIds(): string[] {\n return Array.from(this.apiMap.keys());\n }\n\n /\n Checks whether a grid API is registered under the given identifier.\n \n @param id - The unique identifier to check.\n * @returns `true` if an API is registered with that ID.\n /\n hasApi(id: string): boolean {\n return this.apiMap.has(id);\n }\n\n /\n Removes all registered grid APIs.\n \n Useful during application teardown or testing.\n */\n clear(): void {\n this.apiMap.clear();\n }\n}\n"]}
1	+ {"version":3,"sources":["../src/gridstorm.component.ts","../src/gridstorm.service.ts"],"names":["GridStormComponent","EventEmitter","createGrid","DomRenderer","Input","Output","ViewChild","Component","GridStormService","Injectable"],"mappings":";;;;;;;;;;;;;;;;AAiCaA,6BAAN,wBAAA,CAAiE;AAAA,EAAjE,WAAA,GAAA;AAII,IAAA,IAAA,CAAA,OAAA,GAAuB,EAAC;AAGxB,IAAA,IAAA,CAAA,OAAA,GAAiB,EAAC;AAGlB,IAAA,IAAA,CAAA,OAAA,GAAwB,EAAC;AAMzB,IAAA,IAAA,CAAA,SAAA,GAAY,EAAA;AAGZ,IAAA,IAAA,CAAA,KAAA,GAAQ,OAAA;AAGR,IAAA,IAAA,CAAA,OAAA,GAAU,QAAA;AA0BT,IAAA,IAAA,CAAA,SAAA,GAAY,IAAIC,iBAAA,EAAsB;AAGtC,IAAA,IAAA,CAAA,cAAA,GAAiB,IAAIA,iBAAA,EAAkB;AAGvC,IAAA,IAAA,CAAA,gBAAA,GAAmB,IAAIA,iBAAA,EAAkB;AAGzC,IAAA,IAAA,CAAA,WAAA,GAAc,IAAIA,iBAAA,EAAkB;AAGpC,IAAA,IAAA,CAAA,aAAA,GAAgB,IAAIA,iBAAA,EAAkB;AAGtC,IAAA,IAAA,CAAA,gBAAA,GAAmB,IAAIA,iBAAA,EAAkB;AAGzC,IAAA,IAAA,CAAA,WAAA,GAAc,IAAIA,iBAAA,EAAkB;AAGpC,IAAA,IAAA,CAAA,iBAAA,GAAoB,IAAIA,iBAAA,EAAkB;AAG1C,IAAA,IAAA,CAAA,UAAA,GAAa,IAAIA,iBAAA,EAAkB;AAGnC,IAAA,IAAA,CAAA,iBAAA,GAAoB,IAAIA,iBAAA,EAAkB;AAG1C,IAAA,IAAA,CAAA,aAAA,GAAgB,IAAIA,iBAAA,EAAkB;AAGtC,IAAA,IAAA,CAAA,SAAA,GAAY,IAAIA,iBAAA,EAAoB;AAS9C;AAAA,IAAA,IAAA,CAAQ,MAAA,GAA4B,IAAA;AACpC,IAAA,IAAA,CAAQ,QAAA,GAA+B,IAAA;AACvC,IAAA,IAAA,CAAQ,qBAAwC,EAAC;AAAA,EAAA;AAAA;AAAA,EAIjD,QAAA,GAAiB;AACf,IAAA,IAAI;AACF,MAAA,IAAA,CAAK,QAAA,EAAS;AAAA,IAChB,SAAS,GAAA,EAAK;AACZ,MAAA,MAAM,KAAA,GAAQ,eAAe,KAAA,GAAQ,GAAA,GAAM,IAAI,KAAA,CAAM,MAAA,CAAO,GAAG,CAAC,CAAA;AAChE,MAAA,OAAA,CAAQ,KAAA,CAAM,6CAA6C,KAAK,CAAA;AAChE,MAAA,IAAA,CAAK,SAAA,CAAU,KAAK,KAAK,CAAA;AAAA,IAC3B;AAAA,EACF;AAAA,EAEA,YAAY,OAAA,EAA8B;AACxC,IAAA,IAAI,CAAC,KAAK,MAAA,EAAQ;AAGlB,IAAA,IAAI,QAAQ,SAAS,CAAA,IAAK,CAAC,OAAA,CAAQ,SAAS,EAAE,WAAA,EAAa;AACzD,MAAA,IAAA,CAAK,MAAA,CAAO,GAAA,CAAI,UAAA,CAAW,IAAA,CAAK,OAAO,CAAA;AAAA,IACzC;AAGA,IAAA,IAAI,QAAQ,SAAS,CAAA,IAAK,CAAC,OAAA,CAAQ,SAAS,EAAE,WAAA,EAAa;AACzD,MAAA,IAAA,CAAK,MAAA,CAAO,GAAA,CAAI,aAAA,CAAc,IAAA,CAAK,OAAO,CAAA;AAAA,IAC5C;AAGA,IAAA,IAAI,QAAQ,oBAAoB,CAAA,IAAK,CAAC,OAAA,CAAQ,oBAAoB,EAAE,WAAA,EAAa;AAC/E,MAAA,IAAI,IAAA,CAAK,sBAAsB,IAAA,EAAM;AACnC,QAAA,IAAA,CAAK,MAAA,CAAO,GAAA,CAAI,aAAA,CAAc,oBAAA,EAAsB,KAAK,kBAAkB,CAAA;AAAA,MAC7E;AAAA,IACF;AAAA,EACF;AAAA,EAEA,WAAA,GAAoB;AAClB,IAAA,IAAA,CAAK,WAAA,EAAY;AAAA,EACnB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAA,GAAyB;AACvB,IAAA,OAAO,IAAA,CAAK,QAAQ,GAAA,IAAO,IAAA;AAAA,EAC7B;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,SAAA,GAA+B;AAC7B,IAAA,OAAO,IAAA,CAAK,MAAA;AAAA,EACd;AAAA;AAAA,EAIQ,QAAA,GAAiB;AACvB,IAAA,MAAM,SAAA,GAAY,KAAK,gBAAA,CAAiB,aAAA;AACxC,IAAA,IAAI,CAAC,SAAA,EAAW;AAGhB,IAAA,MAAM,MAAA,GAAqB;AAAA,MACzB,SAAS,IAAA,CAAK,OAAA;AAAA,MACd,SAAS,IAAA,CAAK,OAAA;AAAA,MACd,SAAS,IAAA,CAAK,OAAA;AAAA,MACd,UAAU,IAAA,CAAK,QAAA;AAAA,MACf,WAAW,IAAA,CAAK,SAAA;AAAA,MAChB,cAAc,IAAA,CAAK,YAAA;AAAA,MACnB,eAAe,IAAA,CAAK,aAAA;AAAA,MACpB,WAAW,IAAA,CAAK,SAAA;AAAA,MAChB,cAAc,IAAA,CAAK,YAAA;AAAA,MACnB,YAAY,IAAA,CAAK,UAAA;AAAA,MACjB,oBAAoB,IAAA,CAAK,kBAAA;AAAA,MACzB,WAAW,IAAA,CAAK,SAAA;AAAA,MAChB,OAAO,IAAA,CAAK;AAAA,KACd;AAGA,IAAA,IAAA,CAAK,MAAA,GAASC,kBAAW,MAAM,CAAA;AAG/B,IAAA,IAAA,CAAK,QAAA,GAAW,IAAIC,uBAAA,CAAY;AAAA,MAC9B,SAAA;AAAA,MACA,QAAQ,IAAA,CAAK;AAAA,KACd,CAAA;AACD,IAAA,IAAA,CAAK,SAAS,KAAA,EAAM;AAGpB,IAAA,IAAA,CAAK,gBAAA,EAAiB;AAGtB,IAAA,IAAA,CAAK,SAAA,CAAU,IAAA,CAAK,IAAA,CAAK,MAAA,CAAO,GAAG,CAAA;AAAA,EACrC;AAAA,EAEQ,gBAAA,GAAyB;AAC/B,IAAA,IAAI,CAAC,KAAK,MAAA,EAAQ;AAElB,IAAA,MAAM,EAAA,GAAK,KAAK,MAAA,CAAO,QAAA;AAEvB,IAAA,IAAA,CAAK,kBAAA,GAAqB;AAAA,MACxB,EAAA,CAAG,GAAG,iBAAA,EAAmB,CAAC,MAAM,IAAA,CAAK,cAAA,CAAe,IAAA,CAAK,CAAC,CAAC,CAAA;AAAA,MAC3D,EAAA,CAAG,GAAG,mBAAA,EAAqB,CAAC,MAAM,IAAA,CAAK,gBAAA,CAAiB,IAAA,CAAK,CAAC,CAAC,CAAA;AAAA,MAC/D,EAAA,CAAG,GAAG,qBAAA,EAAuB,CAAC,MAAM,IAAA,CAAK,WAAA,CAAY,IAAA,CAAK,CAAC,CAAC,CAAA;AAAA,MAC5D,EAAA,CAAG,GAAG,gBAAA,EAAkB,CAAC,MAAM,IAAA,CAAK,aAAA,CAAc,IAAA,CAAK,CAAC,CAAC,CAAA;AAAA,MACzD,EAAA,CAAG,GAAG,mBAAA,EAAqB,CAAC,MAAM,IAAA,CAAK,gBAAA,CAAiB,IAAA,CAAK,CAAC,CAAC,CAAA;AAAA,MAC/D,EAAA,CAAG,GAAG,cAAA,EAAgB,CAAC,MAAM,IAAA,CAAK,WAAA,CAAY,IAAA,CAAK,CAAC,CAAC,CAAA;AAAA,MACrD,EAAA,CAAG,GAAG,oBAAA,EAAsB,CAAC,MAAM,IAAA,CAAK,iBAAA,CAAkB,IAAA,CAAK,CAAC,CAAC,CAAA;AAAA,MACjE,EAAA,CAAG,GAAG,aAAA,EAAe,CAAC,MAAM,IAAA,CAAK,UAAA,CAAW,IAAA,CAAK,CAAC,CAAC,CAAA;AAAA,MACnD,EAAA,CAAG,GAAG,oBAAA,EAAsB,CAAC,MAAM,IAAA,CAAK,iBAAA,CAAkB,IAAA,CAAK,CAAC,CAAC,CAAA;AAAA,MACjE,EAAA,CAAG,GAAG,gBAAA,EAAkB,CAAC,MAAM,IAAA,CAAK,aAAA,CAAc,IAAA,CAAK,CAAC,CAAC;AAAA,KAC3D;AAAA,EACF;AAAA,EAEQ,WAAA,GAAoB;AAE1B,IAAA,KAAA,MAAW,KAAA,IAAS,KAAK,kBAAA,EAAoB;AAC3C,MAAA,KAAA,EAAM;AAAA,IACR;AACA,IAAA,IAAA,CAAK,qBAAqB,EAAC;AAG3B,IAAA,IAAI,KAAK,QAAA,EAAU;AACjB,MAAA,IAAA,CAAK,SAAS,OAAA,EAAQ;AACtB,MAAA,IAAA,CAAK,QAAA,GAAW,IAAA;AAAA,IAClB;AAGA,IAAA,IAAI,KAAK,MAAA,EAAQ;AACf,MAAA,IAAA,CAAK,OAAO,OAAA,EAAQ;AACpB,MAAA,IAAA,CAAK,MAAA,GAAS,IAAA;AAAA,IAChB;AAAA,EACF;AACF;AA/NW,eAAA,CAAA;AAAA,EAARC,UAAA;AAAM,CAAA,EAJIJ,0BAAA,CAIF,SAAA,EAAA,SAAA,EAAA,CAAA,CAAA;AAGA,eAAA,CAAA;AAAA,EAARI,UAAA;AAAM,CAAA,EAPIJ,0BAAA,CAOF,SAAA,EAAA,SAAA,EAAA,CAAA,CAAA;AAGA,eAAA,CAAA;AAAA,EAARI,UAAA;AAAM,CAAA,EAVIJ,0BAAA,CAUF,SAAA,EAAA,SAAA,EAAA,CAAA,CAAA;AAGA,eAAA,CAAA;AAAA,EAARI,UAAA;AAAM,CAAA,EAbIJ,0BAAA,CAaF,SAAA,EAAA,UAAA,EAAA,CAAA,CAAA;AAGA,eAAA,CAAA;AAAA,EAARI,UAAA;AAAM,CAAA,EAhBIJ,0BAAA,CAgBF,SAAA,EAAA,WAAA,EAAA,CAAA,CAAA;AAGA,eAAA,CAAA;AAAA,EAARI,UAAA;AAAM,CAAA,EAnBIJ,0BAAA,CAmBF,SAAA,EAAA,OAAA,EAAA,CAAA,CAAA;AAGA,eAAA,CAAA;AAAA,EAARI,UAAA;AAAM,CAAA,EAtBIJ,0BAAA,CAsBF,SAAA,EAAA,SAAA,EAAA,CAAA,CAAA;AAGA,eAAA,CAAA;AAAA,EAARI,UAAA;AAAM,CAAA,EAzBIJ,0BAAA,CAyBF,SAAA,EAAA,eAAA,EAAA,CAAA,CAAA;AAGA,eAAA,CAAA;AAAA,EAARI,UAAA;AAAM,CAAA,EA5BIJ,0BAAA,CA4BF,SAAA,EAAA,oBAAA,EAAA,CAAA,CAAA;AAGA,eAAA,CAAA;AAAA,EAARI,UAAA;AAAM,CAAA,EA/BIJ,0BAAA,CA+BF,SAAA,EAAA,cAAA,EAAA,CAAA,CAAA;AAGA,eAAA,CAAA;AAAA,EAARI,UAAA;AAAM,CAAA,EAlCIJ,0BAAA,CAkCF,SAAA,EAAA,WAAA,EAAA,CAAA,CAAA;AAGA,eAAA,CAAA;AAAA,EAARI,UAAA;AAAM,CAAA,EArCIJ,0BAAA,CAqCF,SAAA,EAAA,cAAA,EAAA,CAAA,CAAA;AAGA,eAAA,CAAA;AAAA,EAARI,UAAA;AAAM,CAAA,EAxCIJ,0BAAA,CAwCF,SAAA,EAAA,YAAA,EAAA,CAAA,CAAA;AAGA,eAAA,CAAA;AAAA,EAARI,UAAA;AAAM,CAAA,EA3CIJ,0BAAA,CA2CF,SAAA,EAAA,WAAA,EAAA,CAAA,CAAA;AAKC,eAAA,CAAA;AAAA,EAATK,WAAA;AAAO,CAAA,EAhDGL,0BAAA,CAgDD,SAAA,EAAA,WAAA,EAAA,CAAA,CAAA;AAGA,eAAA,CAAA;AAAA,EAATK,WAAA;AAAO,CAAA,EAnDGL,0BAAA,CAmDD,SAAA,EAAA,gBAAA,EAAA,CAAA,CAAA;AAGA,eAAA,CAAA;AAAA,EAATK,WAAA;AAAO,CAAA,EAtDGL,0BAAA,CAsDD,SAAA,EAAA,kBAAA,EAAA,CAAA,CAAA;AAGA,eAAA,CAAA;AAAA,EAATK,WAAA;AAAO,CAAA,EAzDGL,0BAAA,CAyDD,SAAA,EAAA,aAAA,EAAA,CAAA,CAAA;AAGA,eAAA,CAAA;AAAA,EAATK,WAAA;AAAO,CAAA,EA5DGL,0BAAA,CA4DD,SAAA,EAAA,eAAA,EAAA,CAAA,CAAA;AAGA,eAAA,CAAA;AAAA,EAATK,WAAA;AAAO,CAAA,EA/DGL,0BAAA,CA+DD,SAAA,EAAA,kBAAA,EAAA,CAAA,CAAA;AAGA,eAAA,CAAA;AAAA,EAATK,WAAA;AAAO,CAAA,EAlEGL,0BAAA,CAkED,SAAA,EAAA,aAAA,EAAA,CAAA,CAAA;AAGA,eAAA,CAAA;AAAA,EAATK,WAAA;AAAO,CAAA,EArEGL,0BAAA,CAqED,SAAA,EAAA,mBAAA,EAAA,CAAA,CAAA;AAGA,eAAA,CAAA;AAAA,EAATK,WAAA;AAAO,CAAA,EAxEGL,0BAAA,CAwED,SAAA,EAAA,YAAA,EAAA,CAAA,CAAA;AAGA,eAAA,CAAA;AAAA,EAATK,WAAA;AAAO,CAAA,EA3EGL,0BAAA,CA2ED,SAAA,EAAA,mBAAA,EAAA,CAAA,CAAA;AAGA,eAAA,CAAA;AAAA,EAATK,WAAA;AAAO,CAAA,EA9EGL,0BAAA,CA8ED,SAAA,EAAA,eAAA,EAAA,CAAA,CAAA;AAGA,eAAA,CAAA;AAAA,EAATK,WAAA;AAAO,CAAA,EAjFGL,0BAAA,CAiFD,SAAA,EAAA,WAAA,EAAA,CAAA,CAAA;AAKF,eAAA,CAAA;AAAA,EADPM,cAAA,CAAU,eAAA,EAAiB,EAAE,MAAA,EAAQ,MAAM;AAAA,CAAA,EArFjCN,0BAAA,CAsFH,SAAA,EAAA,kBAAA,EAAA,CAAA,CAAA;AAtFGA,0BAAA,GAAN,eAAA,CAAA;AAAA,EAbNO,cAAA,CAAU;AAAA,IACT,QAAA,EAAU,WAAA;AAAA,IACV,UAAA,EAAY,IAAA;AAAA,IACZ,QAAA,EAAU;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAAA;AAAA,GASX;AAAA,CAAA,EACYP,0BAAA,CAAA;ACGAQ,2BAAN,sBAAA,CAAuB;AAAA,EAAvB,WAAA,GAAA;AACL,IAAA,IAAA,CAAQ,MAAA,uBAAa,GAAA,EAAqB;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAW1C,WAAA,CAAY,IAAY,GAAA,EAAoB;AAC1C,IAAA,IAAA,CAAK,MAAA,CAAO,GAAA,CAAI,EAAA,EAAI,GAAG,CAAA;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,OAAO,EAAA,EAAiC;AACtC,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,GAAA,CAAI,EAAE,CAAA;AAAA,EAC3B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,UAAU,EAAA,EAAkB;AAC1B,IAAA,IAAA,CAAK,MAAA,CAAO,OAAO,EAAE,CAAA;AAAA,EACvB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,gBAAA,GAA6B;AAC3B,IAAA,OAAO,KAAA,CAAM,IAAA,CAAK,IAAA,CAAK,MAAA,CAAO,MAAM,CAAA;AAAA,EACtC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,OAAO,EAAA,EAAqB;AAC1B,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,GAAA,CAAI,EAAE,CAAA;AAAA,EAC3B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,KAAA,GAAc;AACZ,IAAA,IAAA,CAAK,OAAO,KAAA,EAAM;AAAA,EACpB;AACF;AAhEaA,wBAAA,GAAN,eAAA,CAAA;AAAA,EADNC,eAAA,CAAW,EAAE,UAAA,EAAY,MAAA,EAAQ;AAAA,CAAA,EACrBD,wBAAA,CAAA","file":"index.cjs","sourcesContent":["// ─── GridStorm Angular Component ───\r\n// Standalone Angular component wrapping the headless core engine + DOM renderer.\r\n// Uses ElementRef + ViewChild to mount the DomRenderer into the template container.\r\n\r\nimport {\r\n Component,\r\n Input,\r\n Output,\r\n EventEmitter,\r\n ElementRef,\r\n OnInit,\r\n OnDestroy,\r\n OnChanges,\r\n SimpleChanges,\r\n ViewChild,\r\n} from '@angular/core';\r\nimport { createGrid } from '@gridstorm/core';\r\nimport { DomRenderer } from '@gridstorm/dom-renderer';\r\nimport type { GridConfig, GridApi, GridEngine, ColumnDef, GridPlugin } from '@gridstorm/core';\r\n\r\n@Component({\r\n selector: 'gridstorm',\r\n standalone: true,\r\n template: `\r\n <div\r\n #gridContainer\r\n class=\"gridstorm-wrapper\"\r\n [attr.data-theme]=\"theme\"\r\n [attr.data-density]=\"density\"\r\n style=\"width:100%;height:100%\"\r\n ></div>\r\n `,\r\n})\r\nexport class GridStormComponent implements OnInit, OnDestroy, OnChanges {\r\n // ── Inputs ──\r\n\r\n /** Column definitions describing each column's structure and behavior. /\r\n @Input() columns: ColumnDef[] = [];\r\n\r\n /* Client-side row data array. /\r\n @Input() rowData: any[] = [];\r\n\r\n /* Array of plugins to install during grid initialization. /\r\n @Input() plugins: GridPlugin[] = [];\r\n\r\n /* Callback to generate a unique string ID for each row. /\r\n @Input() getRowId?: (params: any) => string;\r\n\r\n /* Height of each data row in pixels. /\r\n @Input() rowHeight = 40;\r\n\r\n /* Theme identifier: 'light', 'dark', or custom theme name. /\r\n @Input() theme = 'light';\r\n\r\n /* Density mode: 'compact', 'normal', or 'comfortable'. /\r\n @Input() density = 'normal';\r\n\r\n /* Default column definition applied to all columns as fallback. /\r\n @Input() defaultColDef?: Partial<ColumnDef>;\r\n\r\n /* Number of rows per page when pagination is enabled. /\r\n @Input() paginationPageSize?: number;\r\n\r\n /* Height of the header row in pixels. /\r\n @Input() headerHeight?: number;\r\n\r\n /* Controls how the grid's DOM height is determined. /\r\n @Input() domLayout?: 'normal' \| 'autoHeight' \| 'print';\r\n\r\n /* Row selection mode: 'single', 'multiple', or false (disabled). /\r\n @Input() rowSelection?: 'single' \| 'multiple' \| false;\r\n\r\n /* When true, enables client-side pagination. /\r\n @Input() pagination?: boolean;\r\n\r\n /* ARIA label for the grid root element (screen reader accessibility). /\r\n @Input() ariaLabel?: string;\r\n\r\n // ── Outputs ──\r\n\r\n /* Emitted when the grid engine is fully initialized and the API is ready. /\r\n @Output() gridReady = new EventEmitter<GridApi>();\r\n\r\n /* Emitted when row data changes. /\r\n @Output() rowDataChanged = new EventEmitter<any>();\r\n\r\n /* Emitted when the selection state changes. /\r\n @Output() selectionChanged = new EventEmitter<any>();\r\n\r\n /* Emitted when the sort model changes. /\r\n @Output() sortChanged = new EventEmitter<any>();\r\n\r\n /* Emitted when the filter model changes. /\r\n @Output() filterChanged = new EventEmitter<any>();\r\n\r\n /* Emitted when a cell value is changed through editing. /\r\n @Output() cellValueChanged = new EventEmitter<any>();\r\n\r\n /* Emitted when a cell is clicked. /\r\n @Output() cellClicked = new EventEmitter<any>();\r\n\r\n /* Emitted when a cell is double-clicked. /\r\n @Output() cellDoubleClicked = new EventEmitter<any>();\r\n\r\n /* Emitted when a row is clicked. /\r\n @Output() rowClicked = new EventEmitter<any>();\r\n\r\n /* Emitted when pagination state changes. /\r\n @Output() paginationChanged = new EventEmitter<any>();\r\n\r\n /* Emitted when a column is resized. /\r\n @Output() columnResized = new EventEmitter<any>();\r\n\r\n /* Emitted when an error occurs during grid initialization or operation. /\r\n @Output() gridError = new EventEmitter<Error>();\r\n\r\n // ── Template reference ──\r\n\r\n @ViewChild('gridContainer', { static: true })\r\n private gridContainerRef!: ElementRef<HTMLElement>;\r\n\r\n // ── Internal state ──\r\n\r\n private engine: GridEngine \| null = null;\r\n private renderer: DomRenderer \| null = null;\r\n private eventUnsubscribers: Array<() => void> = [];\r\n\r\n // ── Lifecycle ──\r\n\r\n ngOnInit(): void {\r\n try {\r\n this.initGrid();\r\n } catch (err) {\r\n const error = err instanceof Error ? err : new Error(String(err));\r\n console.error('[GridStorm Angular] Initialization error:', error);\r\n this.gridError.emit(error);\r\n }\r\n }\r\n\r\n ngOnChanges(changes: SimpleChanges): void {\r\n if (!this.engine) return;\r\n\r\n // Sync rowData changes to the engine\r\n if (changes['rowData'] && !changes['rowData'].firstChange) {\r\n this.engine.api.setRowData(this.rowData);\r\n }\r\n\r\n // Sync column definition changes to the engine\r\n if (changes['columns'] && !changes['columns'].firstChange) {\r\n this.engine.api.setColumnDefs(this.columns);\r\n }\r\n\r\n // Sync pagination page size\r\n if (changes['paginationPageSize'] && !changes['paginationPageSize'].firstChange) {\r\n if (this.paginationPageSize != null) {\r\n this.engine.api.setGridOption('paginationPageSize', this.paginationPageSize);\r\n }\r\n }\r\n }\r\n\r\n ngOnDestroy(): void {\r\n this.destroyGrid();\r\n }\r\n\r\n // ── Public API ──\r\n\r\n /\r\n Returns the underlying GridApi instance, or null if the grid\r\n * has not been initialized yet.\r\n /\r\n getApi(): GridApi \| null {\r\n return this.engine?.api ?? null;\r\n }\r\n\r\n /\r\n Returns the underlying GridEngine instance, or null if the grid\r\n * has not been initialized yet.\r\n /\r\n getEngine(): GridEngine \| null {\r\n return this.engine;\r\n }\r\n\r\n // ── Initialization ──\r\n\r\n private initGrid(): void {\r\n const container = this.gridContainerRef.nativeElement;\r\n if (!container) return;\r\n\r\n // Build core config from inputs\r\n const config: GridConfig = {\r\n columns: this.columns,\r\n rowData: this.rowData,\r\n plugins: this.plugins,\r\n getRowId: this.getRowId,\r\n rowHeight: this.rowHeight,\r\n headerHeight: this.headerHeight,\r\n defaultColDef: this.defaultColDef,\r\n domLayout: this.domLayout,\r\n rowSelection: this.rowSelection,\r\n pagination: this.pagination,\r\n paginationPageSize: this.paginationPageSize,\r\n ariaLabel: this.ariaLabel,\r\n theme: this.theme,\r\n };\r\n\r\n // Create the headless grid engine\r\n this.engine = createGrid(config);\r\n\r\n // Create and mount the DOM renderer\r\n this.renderer = new DomRenderer({\r\n container,\r\n engine: this.engine,\r\n });\r\n this.renderer.mount();\r\n\r\n // Wire up event bridge: core events -> Angular EventEmitters\r\n this.setupEventBridge();\r\n\r\n // Emit gridReady\r\n this.gridReady.emit(this.engine.api);\r\n }\r\n\r\n private setupEventBridge(): void {\r\n if (!this.engine) return;\r\n\r\n const eb = this.engine.eventBus;\r\n\r\n this.eventUnsubscribers = [\r\n eb.on('rowData:changed', (e) => this.rowDataChanged.emit(e)),\r\n eb.on('selection:changed', (e) => this.selectionChanged.emit(e)),\r\n eb.on('column:sort:changed', (e) => this.sortChanged.emit(e)),\r\n eb.on('filter:changed', (e) => this.filterChanged.emit(e)),\r\n eb.on('cell:valueChanged', (e) => this.cellValueChanged.emit(e)),\r\n eb.on('cell:clicked', (e) => this.cellClicked.emit(e)),\r\n eb.on('cell:doubleClicked', (e) => this.cellDoubleClicked.emit(e)),\r\n eb.on('row:clicked', (e) => this.rowClicked.emit(e)),\r\n eb.on('pagination:changed', (e) => this.paginationChanged.emit(e)),\r\n eb.on('column:resized', (e) => this.columnResized.emit(e)),\r\n ];\r\n }\r\n\r\n private destroyGrid(): void {\r\n // Unsubscribe from all core events\r\n for (const unsub of this.eventUnsubscribers) {\r\n unsub();\r\n }\r\n this.eventUnsubscribers = [];\r\n\r\n // Destroy the DOM renderer\r\n if (this.renderer) {\r\n this.renderer.destroy();\r\n this.renderer = null;\r\n }\r\n\r\n // Destroy the grid engine\r\n if (this.engine) {\r\n this.engine.destroy();\r\n this.engine = null;\r\n }\r\n }\r\n}\r\n","// ─── GridStorm Service ───\r\n// Injectable service for managing multiple GridStorm instances.\r\n// Allows Angular components to access grid APIs by a unique identifier,\r\n// useful in applications with multiple grids or cross-component communication.\r\n\r\nimport { Injectable } from '@angular/core';\r\nimport type { GridApi } from '@gridstorm/core';\r\n\r\n/\r\n Service for registering and retrieving GridStorm API instances.\r\n \r\n Use this service when you have multiple grids in your application\r\n * and need to access their APIs from different components or services.\r\n \r\n @example\r\n * ```typescript\r\n * // In a component that hosts the grid:\r\n * constructor(private gridService: GridStormService) {}\r\n \r\n onGridReady(api: GridApi) {\r\n * this.gridService.registerApi('employees', api);\r\n * }\r\n \r\n // In another component that needs to interact with the grid:\r\n * constructor(private gridService: GridStormService) {}\r\n \r\n exportData() {\r\n * const api = this.gridService.getApi('employees');\r\n * if (api) {\r\n * const rows = api.getSelectedRows();\r\n * // ... do something with rows\r\n * }\r\n * }\r\n * ```\r\n /\r\n@Injectable({ providedIn: 'root' })\r\nexport class GridStormService {\r\n private apiMap = new Map<string, GridApi>();\r\n\r\n /\r\n Registers a GridApi instance under a unique identifier.\r\n \r\n Call this from the `(gridReady)` output handler of the `<gridstorm>` component.\r\n * If an API with the same ID already exists, it will be replaced.\r\n \r\n @param id - A unique string identifier for this grid instance.\r\n * @param api - The GridApi instance to register.\r\n /\r\n registerApi(id: string, api: GridApi): void {\r\n this.apiMap.set(id, api);\r\n }\r\n\r\n /\r\n Retrieves a previously registered GridApi by its identifier.\r\n \r\n @param id - The unique identifier used during registration.\r\n * @returns The GridApi instance, or `undefined` if not found.\r\n /\r\n getApi(id: string): GridApi \| undefined {\r\n return this.apiMap.get(id);\r\n }\r\n\r\n /\r\n Removes a registered GridApi by its identifier.\r\n \r\n Call this when a grid component is destroyed to prevent memory leaks.\r\n \r\n @param id - The unique identifier of the API to remove.\r\n /\r\n removeApi(id: string): void {\r\n this.apiMap.delete(id);\r\n }\r\n\r\n /\r\n Returns all registered grid API identifiers.\r\n \r\n @returns An array of registered grid IDs.\r\n /\r\n getRegisteredIds(): string[] {\r\n return Array.from(this.apiMap.keys());\r\n }\r\n\r\n /\r\n Checks whether a grid API is registered under the given identifier.\r\n \r\n @param id - The unique identifier to check.\r\n * @returns `true` if an API is registered with that ID.\r\n /\r\n hasApi(id: string): boolean {\r\n return this.apiMap.has(id);\r\n }\r\n\r\n /\r\n Removes all registered grid APIs.\r\n \r\n Useful during application teardown or testing.\r\n */\r\n clear(): void {\r\n this.apiMap.clear();\r\n }\r\n}\r\n"]}

package/dist/index.d.cts CHANGED Viewed

@@ -53,6 +53,8 @@ declare class GridStormComponent implements OnInit, OnDestroy, OnChanges {
     paginationChanged: EventEmitter<any>;
     /** Emitted when a column is resized. */
     columnResized: EventEmitter<any>;
+    /** Emitted when an error occurs during grid initialization or operation. */
+    gridError: EventEmitter<Error>;
     private gridContainerRef;
     private engine;
     private renderer;

package/dist/index.d.ts CHANGED Viewed

@@ -53,6 +53,8 @@ declare class GridStormComponent implements OnInit, OnDestroy, OnChanges {
     paginationChanged: EventEmitter<any>;
     /** Emitted when a column is resized. */
     columnResized: EventEmitter<any>;
+    /** Emitted when an error occurs during grid initialization or operation. */
+    gridError: EventEmitter<Error>;
     private gridContainerRef;
     private engine;
     private renderer;

package/dist/index.js CHANGED Viewed

@@ -31,6 +31,7 @@ var GridStormComponent = class {
     this.rowClicked = new EventEmitter();
     this.paginationChanged = new EventEmitter();
     this.columnResized = new EventEmitter();
+    this.gridError = new EventEmitter();
     // ── Internal state ──
     this.engine = null;
     this.renderer = null;
@@ -38,7 +39,13 @@ var GridStormComponent = class {
   }
   // ── Lifecycle ──
   ngOnInit() {
-    this.initGrid();
+    try {
+      this.initGrid();
+    } catch (err) {
+      const error = err instanceof Error ? err : new Error(String(err));
+      console.error("[GridStorm Angular] Initialization error:", error);
+      this.gridError.emit(error);
+    }
   }
   ngOnChanges(changes) {
     if (!this.engine) return;
@@ -206,6 +213,9 @@ __decorateClass([
 __decorateClass([
   Output()
 ], GridStormComponent.prototype, "columnResized", 2);
+__decorateClass([
+  Output()
+], GridStormComponent.prototype, "gridError", 2);
 __decorateClass([
   ViewChild("gridContainer", { static: true })
 ], GridStormComponent.prototype, "gridContainerRef", 2);

package/dist/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/gridstorm.component.ts","../src/gridstorm.service.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["// ─── GridStorm Angular Component ───\n// Standalone Angular component wrapping the headless core engine + DOM renderer.\n// Uses ElementRef + ViewChild to mount the DomRenderer into the template container.\n\nimport {\n Component,\n Input,\n Output,\n EventEmitter,\n ElementRef,\n OnInit,\n OnDestroy,\n OnChanges,\n SimpleChanges,\n ViewChild,\n} from '@angular/core';\nimport { createGrid } from '@gridstorm/core';\nimport { DomRenderer } from '@gridstorm/dom-renderer';\nimport type { GridConfig, GridApi, GridEngine, ColumnDef, GridPlugin } from '@gridstorm/core';\n\n@Component({\n selector: 'gridstorm',\n standalone: true,\n template: `\n <div\n #gridContainer\n class=\"gridstorm-wrapper\"\n [attr.data-theme]=\"theme\"\n [attr.data-density]=\"density\"\n style=\"width:100%;height:100%\"\n ></div>\n `,\n})\nexport class GridStormComponent implements OnInit, OnDestroy, OnChanges {\n // ── Inputs ──\n\n /** Column definitions describing each column's structure and behavior. /\n @Input() columns: ColumnDef[] = [];\n\n /* Client-side row data array. /\n @Input() rowData: any[] = [];\n\n /* Array of plugins to install during grid initialization. /\n @Input() plugins: GridPlugin[] = [];\n\n /* Callback to generate a unique string ID for each row. /\n @Input() getRowId?: (params: any) => string;\n\n /* Height of each data row in pixels. /\n @Input() rowHeight = 40;\n\n /* Theme identifier: 'light', 'dark', or custom theme name. /\n @Input() theme = 'light';\n\n /* Density mode: 'compact', 'normal', or 'comfortable'. /\n @Input() density = 'normal';\n\n /* Default column definition applied to all columns as fallback. /\n @Input() defaultColDef?: Partial<ColumnDef>;\n\n /* Number of rows per page when pagination is enabled. /\n @Input() paginationPageSize?: number;\n\n /* Height of the header row in pixels. /\n @Input() headerHeight?: number;\n\n /* Controls how the grid's DOM height is determined. /\n @Input() domLayout?: 'normal' \| 'autoHeight' \| 'print';\n\n /* Row selection mode: 'single', 'multiple', or false (disabled). /\n @Input() rowSelection?: 'single' \| 'multiple' \| false;\n\n /* When true, enables client-side pagination. /\n @Input() pagination?: boolean;\n\n /* ARIA label for the grid root element (screen reader accessibility). /\n @Input() ariaLabel?: string;\n\n // ── Outputs ──\n\n /* Emitted when the grid engine is fully initialized and the API is ready. /\n @Output() gridReady = new EventEmitter<GridApi>();\n\n /* Emitted when row data changes. /\n @Output() rowDataChanged = new EventEmitter<any>();\n\n /* Emitted when the selection state changes. /\n @Output() selectionChanged = new EventEmitter<any>();\n\n /* Emitted when the sort model changes. /\n @Output() sortChanged = new EventEmitter<any>();\n\n /* Emitted when the filter model changes. /\n @Output() filterChanged = new EventEmitter<any>();\n\n /* Emitted when a cell value is changed through editing. /\n @Output() cellValueChanged = new EventEmitter<any>();\n\n /* Emitted when a cell is clicked. /\n @Output() cellClicked = new EventEmitter<any>();\n\n /* Emitted when a cell is double-clicked. /\n @Output() cellDoubleClicked = new EventEmitter<any>();\n\n /* Emitted when a row is clicked. /\n @Output() rowClicked = new EventEmitter<any>();\n\n /* Emitted when pagination state changes. /\n @Output() paginationChanged = new EventEmitter<any>();\n\n /* Emitted when a column is resized. /\n @Output() columnResized = new EventEmitter<any>();\n\n // ── Template reference ──\n\n @ViewChild('gridContainer', { static: true })\n private gridContainerRef!: ElementRef<HTMLElement>;\n\n // ── Internal state ──\n\n private engine: GridEngine \| null = null;\n private renderer: DomRenderer \| null = null;\n private eventUnsubscribers: Array<() => void> = [];\n\n // ── Lifecycle ──\n\n ngOnInit(): void {\n this.initGrid();\n }\n\n ngOnChanges(changes: SimpleChanges): void {\n if (!this.engine) return;\n\n // Sync rowData changes to the engine\n if (changes['rowData'] && !changes['rowData'].firstChange) {\n this.engine.api.setRowData(this.rowData);\n }\n\n // Sync column definition changes to the engine\n if (changes['columns'] && !changes['columns'].firstChange) {\n this.engine.api.setColumnDefs(this.columns);\n }\n\n // Sync pagination page size\n if (changes['paginationPageSize'] && !changes['paginationPageSize'].firstChange) {\n if (this.paginationPageSize != null) {\n this.engine.api.setGridOption('paginationPageSize', this.paginationPageSize);\n }\n }\n }\n\n ngOnDestroy(): void {\n this.destroyGrid();\n }\n\n // ── Public API ──\n\n /\n Returns the underlying GridApi instance, or null if the grid\n * has not been initialized yet.\n /\n getApi(): GridApi \| null {\n return this.engine?.api ?? null;\n }\n\n /\n Returns the underlying GridEngine instance, or null if the grid\n * has not been initialized yet.\n /\n getEngine(): GridEngine \| null {\n return this.engine;\n }\n\n // ── Initialization ──\n\n private initGrid(): void {\n const container = this.gridContainerRef.nativeElement;\n if (!container) return;\n\n // Build core config from inputs\n const config: GridConfig = {\n columns: this.columns,\n rowData: this.rowData,\n plugins: this.plugins,\n getRowId: this.getRowId,\n rowHeight: this.rowHeight,\n headerHeight: this.headerHeight,\n defaultColDef: this.defaultColDef,\n domLayout: this.domLayout,\n rowSelection: this.rowSelection,\n pagination: this.pagination,\n paginationPageSize: this.paginationPageSize,\n ariaLabel: this.ariaLabel,\n theme: this.theme,\n };\n\n // Create the headless grid engine\n this.engine = createGrid(config);\n\n // Create and mount the DOM renderer\n this.renderer = new DomRenderer({\n container,\n engine: this.engine,\n });\n this.renderer.mount();\n\n // Wire up event bridge: core events -> Angular EventEmitters\n this.setupEventBridge();\n\n // Emit gridReady\n this.gridReady.emit(this.engine.api);\n }\n\n private setupEventBridge(): void {\n if (!this.engine) return;\n\n const eb = this.engine.eventBus;\n\n this.eventUnsubscribers = [\n eb.on('rowData:changed', (e) => this.rowDataChanged.emit(e)),\n eb.on('selection:changed', (e) => this.selectionChanged.emit(e)),\n eb.on('column:sort:changed', (e) => this.sortChanged.emit(e)),\n eb.on('filter:changed', (e) => this.filterChanged.emit(e)),\n eb.on('cell:valueChanged', (e) => this.cellValueChanged.emit(e)),\n eb.on('cell:clicked', (e) => this.cellClicked.emit(e)),\n eb.on('cell:doubleClicked', (e) => this.cellDoubleClicked.emit(e)),\n eb.on('row:clicked', (e) => this.rowClicked.emit(e)),\n eb.on('pagination:changed', (e) => this.paginationChanged.emit(e)),\n eb.on('column:resized', (e) => this.columnResized.emit(e)),\n ];\n }\n\n private destroyGrid(): void {\n // Unsubscribe from all core events\n for (const unsub of this.eventUnsubscribers) {\n unsub();\n }\n this.eventUnsubscribers = [];\n\n // Destroy the DOM renderer\n if (this.renderer) {\n this.renderer.destroy();\n this.renderer = null;\n }\n\n // Destroy the grid engine\n if (this.engine) {\n this.engine.destroy();\n this.engine = null;\n }\n }\n}\n","// ─── GridStorm Service ───\n// Injectable service for managing multiple GridStorm instances.\n// Allows Angular components to access grid APIs by a unique identifier,\n// useful in applications with multiple grids or cross-component communication.\n\nimport { Injectable } from '@angular/core';\nimport type { GridApi } from '@gridstorm/core';\n\n/\n Service for registering and retrieving GridStorm API instances.\n \n Use this service when you have multiple grids in your application\n * and need to access their APIs from different components or services.\n \n @example\n * ```typescript\n * // In a component that hosts the grid:\n * constructor(private gridService: GridStormService) {}\n \n onGridReady(api: GridApi) {\n * this.gridService.registerApi('employees', api);\n * }\n \n // In another component that needs to interact with the grid:\n * constructor(private gridService: GridStormService) {}\n \n exportData() {\n * const api = this.gridService.getApi('employees');\n * if (api) {\n * const rows = api.getSelectedRows();\n * // ... do something with rows\n * }\n * }\n * ```\n /\n@Injectable({ providedIn: 'root' })\nexport class GridStormService {\n private apiMap = new Map<string, GridApi>();\n\n /\n Registers a GridApi instance under a unique identifier.\n \n Call this from the `(gridReady)` output handler of the `<gridstorm>` component.\n * If an API with the same ID already exists, it will be replaced.\n \n @param id - A unique string identifier for this grid instance.\n * @param api - The GridApi instance to register.\n /\n registerApi(id: string, api: GridApi): void {\n this.apiMap.set(id, api);\n }\n\n /\n Retrieves a previously registered GridApi by its identifier.\n \n @param id - The unique identifier used during registration.\n * @returns The GridApi instance, or `undefined` if not found.\n /\n getApi(id: string): GridApi \| undefined {\n return this.apiMap.get(id);\n }\n\n /\n Removes a registered GridApi by its identifier.\n \n Call this when a grid component is destroyed to prevent memory leaks.\n \n @param id - The unique identifier of the API to remove.\n /\n removeApi(id: string): void {\n this.apiMap.delete(id);\n }\n\n /\n Returns all registered grid API identifiers.\n \n @returns An array of registered grid IDs.\n /\n getRegisteredIds(): string[] {\n return Array.from(this.apiMap.keys());\n }\n\n /\n Checks whether a grid API is registered under the given identifier.\n \n @param id - The unique identifier to check.\n * @returns `true` if an API is registered with that ID.\n /\n hasApi(id: string): boolean {\n return this.apiMap.has(id);\n }\n\n /\n Removes all registered grid APIs.\n \n Useful during application teardown or testing.\n */\n clear(): void {\n this.apiMap.clear();\n }\n}\n"]}
1	+ {"version":3,"sources":["../src/gridstorm.component.ts","../src/gridstorm.service.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["// ─── GridStorm Angular Component ───\r\n// Standalone Angular component wrapping the headless core engine + DOM renderer.\r\n// Uses ElementRef + ViewChild to mount the DomRenderer into the template container.\r\n\r\nimport {\r\n Component,\r\n Input,\r\n Output,\r\n EventEmitter,\r\n ElementRef,\r\n OnInit,\r\n OnDestroy,\r\n OnChanges,\r\n SimpleChanges,\r\n ViewChild,\r\n} from '@angular/core';\r\nimport { createGrid } from '@gridstorm/core';\r\nimport { DomRenderer } from '@gridstorm/dom-renderer';\r\nimport type { GridConfig, GridApi, GridEngine, ColumnDef, GridPlugin } from '@gridstorm/core';\r\n\r\n@Component({\r\n selector: 'gridstorm',\r\n standalone: true,\r\n template: `\r\n <div\r\n #gridContainer\r\n class=\"gridstorm-wrapper\"\r\n [attr.data-theme]=\"theme\"\r\n [attr.data-density]=\"density\"\r\n style=\"width:100%;height:100%\"\r\n ></div>\r\n `,\r\n})\r\nexport class GridStormComponent implements OnInit, OnDestroy, OnChanges {\r\n // ── Inputs ──\r\n\r\n /** Column definitions describing each column's structure and behavior. /\r\n @Input() columns: ColumnDef[] = [];\r\n\r\n /* Client-side row data array. /\r\n @Input() rowData: any[] = [];\r\n\r\n /* Array of plugins to install during grid initialization. /\r\n @Input() plugins: GridPlugin[] = [];\r\n\r\n /* Callback to generate a unique string ID for each row. /\r\n @Input() getRowId?: (params: any) => string;\r\n\r\n /* Height of each data row in pixels. /\r\n @Input() rowHeight = 40;\r\n\r\n /* Theme identifier: 'light', 'dark', or custom theme name. /\r\n @Input() theme = 'light';\r\n\r\n /* Density mode: 'compact', 'normal', or 'comfortable'. /\r\n @Input() density = 'normal';\r\n\r\n /* Default column definition applied to all columns as fallback. /\r\n @Input() defaultColDef?: Partial<ColumnDef>;\r\n\r\n /* Number of rows per page when pagination is enabled. /\r\n @Input() paginationPageSize?: number;\r\n\r\n /* Height of the header row in pixels. /\r\n @Input() headerHeight?: number;\r\n\r\n /* Controls how the grid's DOM height is determined. /\r\n @Input() domLayout?: 'normal' \| 'autoHeight' \| 'print';\r\n\r\n /* Row selection mode: 'single', 'multiple', or false (disabled). /\r\n @Input() rowSelection?: 'single' \| 'multiple' \| false;\r\n\r\n /* When true, enables client-side pagination. /\r\n @Input() pagination?: boolean;\r\n\r\n /* ARIA label for the grid root element (screen reader accessibility). /\r\n @Input() ariaLabel?: string;\r\n\r\n // ── Outputs ──\r\n\r\n /* Emitted when the grid engine is fully initialized and the API is ready. /\r\n @Output() gridReady = new EventEmitter<GridApi>();\r\n\r\n /* Emitted when row data changes. /\r\n @Output() rowDataChanged = new EventEmitter<any>();\r\n\r\n /* Emitted when the selection state changes. /\r\n @Output() selectionChanged = new EventEmitter<any>();\r\n\r\n /* Emitted when the sort model changes. /\r\n @Output() sortChanged = new EventEmitter<any>();\r\n\r\n /* Emitted when the filter model changes. /\r\n @Output() filterChanged = new EventEmitter<any>();\r\n\r\n /* Emitted when a cell value is changed through editing. /\r\n @Output() cellValueChanged = new EventEmitter<any>();\r\n\r\n /* Emitted when a cell is clicked. /\r\n @Output() cellClicked = new EventEmitter<any>();\r\n\r\n /* Emitted when a cell is double-clicked. /\r\n @Output() cellDoubleClicked = new EventEmitter<any>();\r\n\r\n /* Emitted when a row is clicked. /\r\n @Output() rowClicked = new EventEmitter<any>();\r\n\r\n /* Emitted when pagination state changes. /\r\n @Output() paginationChanged = new EventEmitter<any>();\r\n\r\n /* Emitted when a column is resized. /\r\n @Output() columnResized = new EventEmitter<any>();\r\n\r\n /* Emitted when an error occurs during grid initialization or operation. /\r\n @Output() gridError = new EventEmitter<Error>();\r\n\r\n // ── Template reference ──\r\n\r\n @ViewChild('gridContainer', { static: true })\r\n private gridContainerRef!: ElementRef<HTMLElement>;\r\n\r\n // ── Internal state ──\r\n\r\n private engine: GridEngine \| null = null;\r\n private renderer: DomRenderer \| null = null;\r\n private eventUnsubscribers: Array<() => void> = [];\r\n\r\n // ── Lifecycle ──\r\n\r\n ngOnInit(): void {\r\n try {\r\n this.initGrid();\r\n } catch (err) {\r\n const error = err instanceof Error ? err : new Error(String(err));\r\n console.error('[GridStorm Angular] Initialization error:', error);\r\n this.gridError.emit(error);\r\n }\r\n }\r\n\r\n ngOnChanges(changes: SimpleChanges): void {\r\n if (!this.engine) return;\r\n\r\n // Sync rowData changes to the engine\r\n if (changes['rowData'] && !changes['rowData'].firstChange) {\r\n this.engine.api.setRowData(this.rowData);\r\n }\r\n\r\n // Sync column definition changes to the engine\r\n if (changes['columns'] && !changes['columns'].firstChange) {\r\n this.engine.api.setColumnDefs(this.columns);\r\n }\r\n\r\n // Sync pagination page size\r\n if (changes['paginationPageSize'] && !changes['paginationPageSize'].firstChange) {\r\n if (this.paginationPageSize != null) {\r\n this.engine.api.setGridOption('paginationPageSize', this.paginationPageSize);\r\n }\r\n }\r\n }\r\n\r\n ngOnDestroy(): void {\r\n this.destroyGrid();\r\n }\r\n\r\n // ── Public API ──\r\n\r\n /\r\n Returns the underlying GridApi instance, or null if the grid\r\n * has not been initialized yet.\r\n /\r\n getApi(): GridApi \| null {\r\n return this.engine?.api ?? null;\r\n }\r\n\r\n /\r\n Returns the underlying GridEngine instance, or null if the grid\r\n * has not been initialized yet.\r\n /\r\n getEngine(): GridEngine \| null {\r\n return this.engine;\r\n }\r\n\r\n // ── Initialization ──\r\n\r\n private initGrid(): void {\r\n const container = this.gridContainerRef.nativeElement;\r\n if (!container) return;\r\n\r\n // Build core config from inputs\r\n const config: GridConfig = {\r\n columns: this.columns,\r\n rowData: this.rowData,\r\n plugins: this.plugins,\r\n getRowId: this.getRowId,\r\n rowHeight: this.rowHeight,\r\n headerHeight: this.headerHeight,\r\n defaultColDef: this.defaultColDef,\r\n domLayout: this.domLayout,\r\n rowSelection: this.rowSelection,\r\n pagination: this.pagination,\r\n paginationPageSize: this.paginationPageSize,\r\n ariaLabel: this.ariaLabel,\r\n theme: this.theme,\r\n };\r\n\r\n // Create the headless grid engine\r\n this.engine = createGrid(config);\r\n\r\n // Create and mount the DOM renderer\r\n this.renderer = new DomRenderer({\r\n container,\r\n engine: this.engine,\r\n });\r\n this.renderer.mount();\r\n\r\n // Wire up event bridge: core events -> Angular EventEmitters\r\n this.setupEventBridge();\r\n\r\n // Emit gridReady\r\n this.gridReady.emit(this.engine.api);\r\n }\r\n\r\n private setupEventBridge(): void {\r\n if (!this.engine) return;\r\n\r\n const eb = this.engine.eventBus;\r\n\r\n this.eventUnsubscribers = [\r\n eb.on('rowData:changed', (e) => this.rowDataChanged.emit(e)),\r\n eb.on('selection:changed', (e) => this.selectionChanged.emit(e)),\r\n eb.on('column:sort:changed', (e) => this.sortChanged.emit(e)),\r\n eb.on('filter:changed', (e) => this.filterChanged.emit(e)),\r\n eb.on('cell:valueChanged', (e) => this.cellValueChanged.emit(e)),\r\n eb.on('cell:clicked', (e) => this.cellClicked.emit(e)),\r\n eb.on('cell:doubleClicked', (e) => this.cellDoubleClicked.emit(e)),\r\n eb.on('row:clicked', (e) => this.rowClicked.emit(e)),\r\n eb.on('pagination:changed', (e) => this.paginationChanged.emit(e)),\r\n eb.on('column:resized', (e) => this.columnResized.emit(e)),\r\n ];\r\n }\r\n\r\n private destroyGrid(): void {\r\n // Unsubscribe from all core events\r\n for (const unsub of this.eventUnsubscribers) {\r\n unsub();\r\n }\r\n this.eventUnsubscribers = [];\r\n\r\n // Destroy the DOM renderer\r\n if (this.renderer) {\r\n this.renderer.destroy();\r\n this.renderer = null;\r\n }\r\n\r\n // Destroy the grid engine\r\n if (this.engine) {\r\n this.engine.destroy();\r\n this.engine = null;\r\n }\r\n }\r\n}\r\n","// ─── GridStorm Service ───\r\n// Injectable service for managing multiple GridStorm instances.\r\n// Allows Angular components to access grid APIs by a unique identifier,\r\n// useful in applications with multiple grids or cross-component communication.\r\n\r\nimport { Injectable } from '@angular/core';\r\nimport type { GridApi } from '@gridstorm/core';\r\n\r\n/\r\n Service for registering and retrieving GridStorm API instances.\r\n \r\n Use this service when you have multiple grids in your application\r\n * and need to access their APIs from different components or services.\r\n \r\n @example\r\n * ```typescript\r\n * // In a component that hosts the grid:\r\n * constructor(private gridService: GridStormService) {}\r\n \r\n onGridReady(api: GridApi) {\r\n * this.gridService.registerApi('employees', api);\r\n * }\r\n \r\n // In another component that needs to interact with the grid:\r\n * constructor(private gridService: GridStormService) {}\r\n \r\n exportData() {\r\n * const api = this.gridService.getApi('employees');\r\n * if (api) {\r\n * const rows = api.getSelectedRows();\r\n * // ... do something with rows\r\n * }\r\n * }\r\n * ```\r\n /\r\n@Injectable({ providedIn: 'root' })\r\nexport class GridStormService {\r\n private apiMap = new Map<string, GridApi>();\r\n\r\n /\r\n Registers a GridApi instance under a unique identifier.\r\n \r\n Call this from the `(gridReady)` output handler of the `<gridstorm>` component.\r\n * If an API with the same ID already exists, it will be replaced.\r\n \r\n @param id - A unique string identifier for this grid instance.\r\n * @param api - The GridApi instance to register.\r\n /\r\n registerApi(id: string, api: GridApi): void {\r\n this.apiMap.set(id, api);\r\n }\r\n\r\n /\r\n Retrieves a previously registered GridApi by its identifier.\r\n \r\n @param id - The unique identifier used during registration.\r\n * @returns The GridApi instance, or `undefined` if not found.\r\n /\r\n getApi(id: string): GridApi \| undefined {\r\n return this.apiMap.get(id);\r\n }\r\n\r\n /\r\n Removes a registered GridApi by its identifier.\r\n \r\n Call this when a grid component is destroyed to prevent memory leaks.\r\n \r\n @param id - The unique identifier of the API to remove.\r\n /\r\n removeApi(id: string): void {\r\n this.apiMap.delete(id);\r\n }\r\n\r\n /\r\n Returns all registered grid API identifiers.\r\n \r\n @returns An array of registered grid IDs.\r\n /\r\n getRegisteredIds(): string[] {\r\n return Array.from(this.apiMap.keys());\r\n }\r\n\r\n /\r\n Checks whether a grid API is registered under the given identifier.\r\n \r\n @param id - The unique identifier to check.\r\n * @returns `true` if an API is registered with that ID.\r\n /\r\n hasApi(id: string): boolean {\r\n return this.apiMap.has(id);\r\n }\r\n\r\n /\r\n Removes all registered grid APIs.\r\n \r\n Useful during application teardown or testing.\r\n */\r\n clear(): void {\r\n this.apiMap.clear();\r\n }\r\n}\r\n"]}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@gridstorm/angular",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "GridStorm Angular adapter — standalone component for Angular 16+",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -35,12 +35,12 @@
     "@gridstorm/dom-renderer": "workspace:*"
   },
   "peerDependencies": {
-    "@angular/core": ">=16.0.0",
-    "@angular/common": ">=16.0.0"
+    "@angular/core": ">=21.2.6",
+    "@angular/common": ">=21.2.6"
   },
   "devDependencies": {
-    "@angular/core": ">=16.0.0",
-    "@angular/common": ">=16.0.0",
+    "@angular/core": ">=21.2.6",
+    "@angular/common": ">=21.2.6",
     "tsup": "^8.2.0",
     "typescript": "^5.5.0"
   },
@@ -65,10 +65,10 @@
   "bugs": {
     "url": "https://github.com/007krcs/grid-data/issues"
   },
-  "homepage": "https://grid-data-analytics-explorer.vercel.app/",
+  "homepage": "https://gridstorm.tekivex.com",
   "author": {
     "name": "GridStorm",
-    "url": "https://grid-data-analytics-explorer.vercel.app/"
+    "url": "https://gridstorm.tekivex.com/"
   },
   "funding": {
     "type": "github",

package/src/__tests__/angular-adapter.test.ts ADDED Viewed

@@ -0,0 +1,379 @@
+import { describe, it, expect } from 'vitest';
+import { GridStormComponent } from '../gridstorm.component';
+import { GridStormService } from '../gridstorm.service';
+import type { GridStormInputs, GridStormOutputs, GridRegistration } from '../types';
+// ─── GridStormComponent Structure ───
+describe('GridStormComponent', () => {
+  it('can be instantiated', () => {
+    const component = new GridStormComponent();
+    expect(component).toBeDefined();
+    expect(component).toBeInstanceOf(GridStormComponent);
+  });
+  it('has default values for columns and rowData inputs', () => {
+    const component = new GridStormComponent();
+    expect(component.columns).toEqual([]);
+    expect(component.rowData).toEqual([]);
+  });
+  it('has default values for plugins', () => {
+    const component = new GridStormComponent();
+    expect(component.plugins).toEqual([]);
+  });
+  it('has default rowHeight of 40', () => {
+    const component = new GridStormComponent();
+    expect(component.rowHeight).toBe(40);
+  });
+  it('has default theme of light', () => {
+    const component = new GridStormComponent();
+    expect(component.theme).toBe('light');
+  });
+  it('has default density of normal', () => {
+    const component = new GridStormComponent();
+    expect(component.density).toBe('normal');
+  });
+  it('has optional inputs that default to undefined', () => {
+    const component = new GridStormComponent();
+    expect(component.getRowId).toBeUndefined();
+    expect(component.defaultColDef).toBeUndefined();
+    expect(component.paginationPageSize).toBeUndefined();
+    expect(component.headerHeight).toBeUndefined();
+    expect(component.domLayout).toBeUndefined();
+    expect(component.rowSelection).toBeUndefined();
+    expect(component.pagination).toBeUndefined();
+    expect(component.ariaLabel).toBeUndefined();
+  });
+  it('allows setting input properties', () => {
+    const component = new GridStormComponent();
+    const testColumns = [{ field: 'name' }, { field: 'age' }];
+    const testData = [{ name: 'Alice', age: 30 }];
+    component.columns = testColumns as any;
+    component.rowData = testData;
+    component.rowHeight = 50;
+    component.theme = 'dark';
+    component.density = 'compact';
+    expect(component.columns).toBe(testColumns);
+    expect(component.rowData).toBe(testData);
+    expect(component.rowHeight).toBe(50);
+    expect(component.theme).toBe('dark');
+    expect(component.density).toBe('compact');
+  });
+  it('has EventEmitter outputs', () => {
+    const component = new GridStormComponent();
+    // All output EventEmitters should be defined and have an emit method
+    expect(component.gridReady).toBeDefined();
+    expect(typeof component.gridReady.emit).toBe('function');
+    expect(component.rowDataChanged).toBeDefined();
+    expect(typeof component.rowDataChanged.emit).toBe('function');
+    expect(component.selectionChanged).toBeDefined();
+    expect(typeof component.selectionChanged.emit).toBe('function');
+    expect(component.sortChanged).toBeDefined();
+    expect(typeof component.sortChanged.emit).toBe('function');
+    expect(component.filterChanged).toBeDefined();
+    expect(typeof component.filterChanged.emit).toBe('function');
+    expect(component.cellValueChanged).toBeDefined();
+    expect(typeof component.cellValueChanged.emit).toBe('function');
+    expect(component.cellClicked).toBeDefined();
+    expect(typeof component.cellClicked.emit).toBe('function');
+    expect(component.cellDoubleClicked).toBeDefined();
+    expect(typeof component.cellDoubleClicked.emit).toBe('function');
+    expect(component.rowClicked).toBeDefined();
+    expect(typeof component.rowClicked.emit).toBe('function');
+    expect(component.paginationChanged).toBeDefined();
+    expect(typeof component.paginationChanged.emit).toBe('function');
+    expect(component.columnResized).toBeDefined();
+    expect(typeof component.columnResized.emit).toBe('function');
+  });
+  it('has getApi method that returns null before initialization', () => {
+    const component = new GridStormComponent();
+    expect(component.getApi()).toBeNull();
+  });
+  it('has getEngine method that returns null before initialization', () => {
+    const component = new GridStormComponent();
+    expect(component.getEngine()).toBeNull();
+  });
+  it('has lifecycle methods defined', () => {
+    const component = new GridStormComponent();
+    expect(typeof component.ngOnInit).toBe('function');
+    expect(typeof component.ngOnDestroy).toBe('function');
+    expect(typeof component.ngOnChanges).toBe('function');
+  });
+  it('ngOnChanges is safe to call before engine is initialized', () => {
+    const component = new GridStormComponent();
+    // Should not throw when engine is null
+    expect(() => {
+      component.ngOnChanges({
+        rowData: {
+          currentValue: [{ id: 1 }],
+          previousValue: [],
+          firstChange: false,
+          isFirstChange: () => false,
+        },
+      });
+    }).not.toThrow();
+  });
+  it('ngOnChanges ignores first change events', () => {
+    const component = new GridStormComponent();
+    // Should not throw even with firstChange=true
+    expect(() => {
+      component.ngOnChanges({
+        rowData: {
+          currentValue: [{ id: 1 }],
+          previousValue: undefined,
+          firstChange: true,
+          isFirstChange: () => true,
+        },
+      });
+    }).not.toThrow();
+  });
+});
+// ─── GridStormService ───
+describe('GridStormService', () => {
+  it('can be instantiated', () => {
+    const service = new GridStormService();
+    expect(service).toBeDefined();
+    expect(service).toBeInstanceOf(GridStormService);
+  });
+  it('starts with no registered APIs', () => {
+    const service = new GridStormService();
+    expect(service.getRegisteredIds()).toEqual([]);
+  });
+  it('registers and retrieves an API by id', () => {
+    const service = new GridStormService();
+    const mockApi = { getSelectedRows: () => [] } as any;
+    service.registerApi('employees', mockApi);
+    expect(service.getApi('employees')).toBe(mockApi);
+  });
+  it('returns undefined for unregistered ids', () => {
+    const service = new GridStormService();
+    expect(service.getApi('nonexistent')).toBeUndefined();
+  });
+  it('reports whether an API is registered via hasApi', () => {
+    const service = new GridStormService();
+    const mockApi = {} as any;
+    expect(service.hasApi('grid1')).toBe(false);
+    service.registerApi('grid1', mockApi);
+    expect(service.hasApi('grid1')).toBe(true);
+  });
+  it('removes a registered API', () => {
+    const service = new GridStormService();
+    const mockApi = {} as any;
+    service.registerApi('grid1', mockApi);
+    expect(service.hasApi('grid1')).toBe(true);
+    service.removeApi('grid1');
+    expect(service.hasApi('grid1')).toBe(false);
+    expect(service.getApi('grid1')).toBeUndefined();
+  });
+  it('removeApi is safe to call with unregistered id', () => {
+    const service = new GridStormService();
+    expect(() => service.removeApi('nonexistent')).not.toThrow();
+  });
+  it('lists all registered IDs', () => {
+    const service = new GridStormService();
+    const mockApi1 = {} as any;
+    const mockApi2 = {} as any;
+    service.registerApi('grid-a', mockApi1);
+    service.registerApi('grid-b', mockApi2);
+    const ids = service.getRegisteredIds();
+    expect(ids).toContain('grid-a');
+    expect(ids).toContain('grid-b');
+    expect(ids).toHaveLength(2);
+  });
+  it('replaces an existing API when registering with the same id', () => {
+    const service = new GridStormService();
+    const mockApi1 = { version: 1 } as any;
+    const mockApi2 = { version: 2 } as any;
+    service.registerApi('grid', mockApi1);
+    expect(service.getApi('grid')).toBe(mockApi1);
+    service.registerApi('grid', mockApi2);
+    expect(service.getApi('grid')).toBe(mockApi2);
+    // Should still only be one entry
+    expect(service.getRegisteredIds()).toHaveLength(1);
+  });
+  it('clears all registered APIs', () => {
+    const service = new GridStormService();
+    service.registerApi('a', {} as any);
+    service.registerApi('b', {} as any);
+    service.registerApi('c', {} as any);
+    expect(service.getRegisteredIds()).toHaveLength(3);
+    service.clear();
+    expect(service.getRegisteredIds()).toHaveLength(0);
+    expect(service.getApi('a')).toBeUndefined();
+  });
+  it('clear is safe to call when no APIs are registered', () => {
+    const service = new GridStormService();
+    expect(() => service.clear()).not.toThrow();
+    expect(service.getRegisteredIds()).toEqual([]);
+  });
+});
+// ─── Exported Types ───
+describe('exported types', () => {
+  it('GridStormInputs type is usable', () => {
+    // Verify the type compiles and can be used in a type annotation
+    const inputs: GridStormInputs = {
+      columns: [],
+      rowData: [],
+      plugins: [],
+      rowHeight: 40,
+      theme: 'light',
+      density: 'normal',
+    };
+    expect(inputs.columns).toEqual([]);
+    expect(inputs.rowHeight).toBe(40);
+    expect(inputs.theme).toBe('light');
+  });
+  it('GridStormInputs supports optional properties', () => {
+    const inputs: GridStormInputs = {
+      columns: [],
+      rowData: [],
+      plugins: [],
+      rowHeight: 40,
+      theme: 'light',
+      density: 'normal',
+      pagination: true,
+      paginationPageSize: 25,
+      headerHeight: 48,
+      domLayout: 'autoHeight',
+      rowSelection: 'multiple',
+      ariaLabel: 'Data grid',
+    };
+    expect(inputs.pagination).toBe(true);
+    expect(inputs.paginationPageSize).toBe(25);
+    expect(inputs.domLayout).toBe('autoHeight');
+    expect(inputs.rowSelection).toBe('multiple');
+  });
+  it('GridStormOutputs type is usable', () => {
+    const outputs: Partial<GridStormOutputs> = {
+      rowDataChanged: { rowData: [{ id: 1 }] },
+      selectionChanged: { selectedNodes: [], source: 'api' },
+      sortChanged: { sortModel: [] },
+      filterChanged: { filterModel: {} },
+      cellValueChanged: { node: null, colId: 'name', oldValue: 'a', newValue: 'b' },
+    };
+    expect(outputs.rowDataChanged?.rowData).toHaveLength(1);
+    expect(outputs.selectionChanged?.source).toBe('api');
+  });
+  it('GridRegistration type is usable', () => {
+    const reg: GridRegistration = {
+      id: 'my-grid',
+      api: {} as any,
+    };
+    expect(reg.id).toBe('my-grid');
+    expect(reg.api).toBeDefined();
+  });
+});
+// ─── Event Emission Mapping ───
+describe('event emission mapping', () => {
+  it('component has all expected event outputs for the documented core events', () => {
+    const component = new GridStormComponent();
+    // These correspond to the core event bus events bridged in setupEventBridge
+    const expectedOutputs = [
+      'gridReady',
+      'rowDataChanged',
+      'selectionChanged',
+      'sortChanged',
+      'filterChanged',
+      'cellValueChanged',
+      'cellClicked',
+      'cellDoubleClicked',
+      'rowClicked',
+      'paginationChanged',
+      'columnResized',
+    ];
+    for (const outputName of expectedOutputs) {
+      const emitter = (component as any)[outputName];
+      expect(emitter).toBeDefined();
+      expect(typeof emitter.emit).toBe('function');
+      expect(typeof emitter.subscribe).toBe('function');
+    }
+  });
+  it('EventEmitters can be subscribed to and receive values', () => {
+    const component = new GridStormComponent();
+    const received: any[] = [];
+    component.cellClicked.subscribe((val: any) => received.push(val));
+    component.cellClicked.emit({ rowIndex: 0, colId: 'name' });
+    expect(received).toHaveLength(1);
+    expect(received[0]).toEqual({ rowIndex: 0, colId: 'name' });
+  });
+});
+// ─── Cleanup on Destroy ───
+describe('cleanup on destroy', () => {
+  it('ngOnDestroy does not throw when called before initialization', () => {
+    const component = new GridStormComponent();
+    // Engine and renderer are null, should handle gracefully
+    expect(() => component.ngOnDestroy()).not.toThrow();
+  });
+  it('getApi returns null after destroy is called', () => {
+    const component = new GridStormComponent();
+    // Even without initialization, calling destroy then getApi should be safe
+    component.ngOnDestroy();
+    expect(component.getApi()).toBeNull();
+  });
+  it('getEngine returns null after destroy is called', () => {
+    const component = new GridStormComponent();
+    component.ngOnDestroy();
+    expect(component.getEngine()).toBeNull();
+  });
+});

package/src/gridstorm.component.ts CHANGED Viewed

@@ -111,6 +111,9 @@ export class GridStormComponent implements OnInit, OnDestroy, OnChanges {
   /** Emitted when a column is resized. */
   @Output() columnResized = new EventEmitter<any>();
+  /** Emitted when an error occurs during grid initialization or operation. */
+  @Output() gridError = new EventEmitter<Error>();
   // ── Template reference ──
   @ViewChild('gridContainer', { static: true })
@@ -125,7 +128,13 @@ export class GridStormComponent implements OnInit, OnDestroy, OnChanges {
   // ── Lifecycle ──
   ngOnInit(): void {
-    this.initGrid();
+    try {
+      this.initGrid();
+    } catch (err) {
+      const error = err instanceof Error ? err : new Error(String(err));
+      console.error('[GridStorm Angular] Initialization error:', error);
+      this.gridError.emit(error);
+    }
   }
   ngOnChanges(changes: SimpleChanges): void {