@agility-workbench/angular-grid 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Himanshu M
+
+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

@@ -0,0 +1,103 @@
+# @agility-workbench/angular-grid
+
+Angular bindings for [`@agility-workbench/grid`](https://www.npmjs.com/package/@agility-workbench/grid) —
+a high-performance data grid. Provides the standalone `<awb-grid>` component and re-exports the
+full core API, so you can import everything you need from one place. Supports Angular 20.3
+through 22 (zone-based and zoneless applications) on Node 20.19+.
+
+## Installation
+
+```bash
+npm install @agility-workbench/angular-grid
+```
+
+`@agility-workbench/grid` is installed automatically as a dependency; `@angular/core` (20.3–22,
+each major verified against the packed artifact) is a peer dependency your app provides.
+
+## Quick start
+
+```ts
+import { Component } from "@angular/core";
+import {
+  AwbGrid,
+  ColumnType,
+  type IGridAPI,
+  type NgColDef,
+} from "@agility-workbench/angular-grid";
+
+@Component({
+  selector: "app-example",
+  standalone: true,
+  imports: [AwbGrid],
+  template: `
+    <div style="height: 400px">
+      <awb-grid
+        [rowData]="rowData"
+        [columnDefs]="columnDefs"
+        rowIdKey="id"
+        [rowNumbers]="true"
+        (gridReady)="onGridReady($event)"
+      />
+    </div>
+  `,
+})
+export class ExampleComponent {
+  columnDefs: NgColDef[] = [
+    { key: "name", label: "Name", type: ColumnType.STRING },
+    { key: "price", label: "Price", type: ColumnType.NUMBER },
+  ];
+
+  rowData = [
+    { id: "1", name: "Widget", price: 9.99 },
+    { id: "2", name: "Gadget", price: 14.5 },
+  ];
+
+  onGridReady(api: IGridAPI): void {
+    // Imperative API: sorting, selection, editing, exports, view state, …
+  }
+}
+```
+
+The grid fills its host element — give `<awb-grid>` (or a wrapper) a height. The component is
+also available via template reference: `<awb-grid #grid="awbGrid" />` → `grid.api`.
+
+## Styling
+
+Nothing to do — the grid delivers its own stylesheet when it attaches, once per document, and
+once per shadow root for grids inside one.
+
+Under a strict Content Security Policy without `style-src 'unsafe-inline'`, pass a nonce via the
+`styleNonce` input (page-global, so use the same value for every grid). To load the stylesheet
+yourself instead — via `angular.json` styles or a global import of
+`@agility-workbench/grid/styles.css` — set `suppressStyleInjection` on each grid, so the two
+copies do not fight in the cascade.
+
+## Angular components in the grid
+
+Column definitions accept Angular component classes wherever the core accepts a class component —
+`cellRenderer`, `cellEditor`, `tooltipComponent`, `headerTooltip`, and `actionFrameComponent`.
+A component receives its params either through an input named `params` or by implementing
+`awbInit(params)` (plus optional `awbRefresh(params)`):
+
+```ts
+import { Component, input } from "@angular/core";
+import type { CellRendererParams } from "@agility-workbench/angular-grid";
+
+@Component({
+  standalone: true,
+  template: `<strong>{{ params()?.value }}</strong>`,
+})
+export class BoldCell {
+  readonly params = input<CellRendererParams>();
+}
+
+const columnDefs: NgColDef[] = [{ key: "name", label: "Name", cellRenderer: BoldCell }];
+```
+
+Cell editors implement `ICellEditorNgComp` (`getValue()` plus optional `focus`, `isParsed`,
+`isCancelBeforeStart`). Menu items returned from `getColumnMenuItems` / `bodyContextMenu` may use
+`TemplateRef`s for their `left`/`right` slots (`NgMenuItem`).
+
+## License
+
+MIT