@toclocoinc/lattice-grid 1.65.0 → 1.67.0

package/README.md

@@ -2,10 +2,10 @@
 
 **A high-performance data grid for the browser.** Vanilla JavaScript, no runtime
 dependencies, no build step required. Optional adapters for React, Vue, Svelte
-and Web Components ship alongside it, and Angular has a compiled package of its
-own, `@toclocoinc/lattice-grid-angular`.
+and Web Components ship alongside it, and Angular has compiled components of its
+own at `@toclocoinc/lattice-grid/angular` — inside this package, not beside it.
 
-Version 1.65.0 · [latticegrid.dev](https://www.latticegrid.dev) · TOCLOCO Inc
+Version 1.67.0 · [latticegrid.dev](https://www.latticegrid.dev) · TOCLOCO Inc
 
 ---
 
@@ -21,6 +21,7 @@ runtime, not a CDN, not a font, not an icon sprite.
 | `lattice-grid.esm.min.js` | The same, as an ES module. |
 | `lattice-grid.min.css` | The theme. Required. |
 | `lattice-grid.d.ts` | TypeScript declarations. |
+| `angular/` | The Angular components, compiled ahead of time: `@toclocoinc/lattice-grid/angular`. |
 | `docs/API.html` | The complete API reference. |
 | `docs/api-detail.html` | The developer guide: what each part does, and why. |
 
@@ -332,7 +333,8 @@ shown; append `.js` for the UMD build or `.cjs` for CommonJS.
 | react | `@toclocoinc/lattice-grid/modules/react` | `modules/react.min.js` | `LatticeGridReact` | React adapter. |
 | vue | `@toclocoinc/lattice-grid/modules/vue` | `modules/vue.min.js` | `LatticeGridVue` | Vue adapter. |
 | svelte | `@toclocoinc/lattice-grid/modules/svelte` | `modules/svelte.min.js` | `LatticeGridSvelte` | Svelte adapter. |
-| angular | `@toclocoinc/lattice-grid/modules/angular` | `modules/angular.min.js` | `LatticeGridAngular` | Angular adapter. |
+| angular (compiled) | `@toclocoinc/lattice-grid/angular` | — | — | **Angular components, compiled ahead of time**: one standalone component per viewer, plus the Data Router as a service. A partial-Ivy library your build's Angular Linker handles like any other; no JIT compiler in the page. `@angular/core` and `@angular/common` are optional peers, so a non-Angular install pulls in nothing. |
+| angular (deprecated) | `@toclocoinc/lattice-grid/modules/angular` | `modules/angular.min.js` | `LatticeGridAngular` | The old run-time adapter for the grid alone. Needs Angular's JIT compiler, which a production build does not ship; use `@toclocoinc/lattice-grid/angular` instead. |
 | webcomponent | `@toclocoinc/lattice-grid/modules/webcomponent` | `modules/webcomponent.min.js` | `LatticeGrid` (extends it) | `<lattice-grid>` as a self-contained custom element. |
 | htmx | `@toclocoinc/lattice-grid/modules/htmx` | `modules/htmx.min.js` | `LatticeGridHtmx` | htmx integration that survives DOM swaps and hydrates from a server-rendered `<table>`. |
 

package/angular/LICENSE

@@ -0,0 +1,111 @@
+Lattice Grid
+Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
+
+Lattice Grid is commercial software. It is not open source, and no part of it
+is placed in the public domain.
+
+--------------------------------------------------------------------------
+1. ONE PRODUCT
+--------------------------------------------------------------------------
+
+There is one Lattice Grid and every copy is feature-identical. There is no
+community edition, no professional edition, and no feature that a licence key
+unlocks. Every capability the documentation describes is present and working in
+every copy, licensed or not.
+
+A licence key removes the trial watermark. That is the whole of what it does.
+
+--------------------------------------------------------------------------
+2. WHAT YOU MAY DO WITHOUT A KEY
+--------------------------------------------------------------------------
+
+You may download, install, evaluate, develop against and test Lattice Grid
+without a licence key and without charge, for as long as you like.
+
+On localhost and other loopback hosts -- localhost, *.localhost, 127.0.0.0/8
+and ::1 -- no watermark is shown and no key is required. Development needs no
+paperwork.
+
+--------------------------------------------------------------------------
+3. SERVING ON OTHER HOSTS, AND WHAT A KEY REMOVES
+--------------------------------------------------------------------------
+
+You may serve Lattice Grid from any host -- including production, staging,
+internal tools, intranets and private networks -- without a licence key and
+without charge. On any host other than a loopback host (section 2), the grid
+renders in full and displays a trial watermark. Nothing is disabled, degraded
+or withheld: every capability works, watermarked, for as long as you like.
+
+A valid licence key issued by TOCLOCO Inc removes that watermark. Removing the
+watermark is the only thing a key does (section 1), so you need one when, and
+only when, you want the watermark gone -- typically for a production or
+customer-facing deployment. Serving watermarked, without a key, is permitted
+rather than a breach.
+
+Keys are issued per deployment rather than per developer or per seat. A key
+names the domains it covers, and one key covers every developer, every build and
+every user on them.
+
+--------------------------------------------------------------------------
+4. GRANT
+--------------------------------------------------------------------------
+
+Subject to your compliance with these terms and to payment of the applicable
+fees, TOCLOCO Inc grants you a non-exclusive, non-transferable, non-
+sublicensable licence to use Lattice Grid, and to reproduce and distribute it
+as an incorporated component of your own applications, for the term and on the
+domains stated in your licence key.
+
+--------------------------------------------------------------------------
+5. RESTRICTIONS
+--------------------------------------------------------------------------
+
+You may not:
+
+  (a) remove, disable, obscure or circumvent the licence check, the console
+      warning or the trial watermark, or use a key on a deployment it does not
+      name;
+
+  (b) reverse engineer, decompile or disassemble the software, or attempt to
+      derive its source code, except to the extent that this restriction is
+      expressly prohibited by applicable law;
+
+  (c) redistribute, resell, sublicense or make the software available as a
+      standalone product, a component library, a developer tool or a competing
+      grid, whether or not for a fee. Distribution as part of your own
+      application under section 4 is permitted; distribution of Lattice Grid
+      itself is not;
+
+  (d) remove or alter any copyright or attribution notice.
+
+--------------------------------------------------------------------------
+6. DEPENDENCIES
+--------------------------------------------------------------------------
+
+Lattice Grid has no runtime dependencies and incorporates no third-party code.
+Nothing in this distribution is subject to a third-party open source licence,
+and adopting it introduces no transitive licence obligations.
+
+--------------------------------------------------------------------------
+7. WARRANTY
+--------------------------------------------------------------------------
+
+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.
+
+--------------------------------------------------------------------------
+8. LIABILITY
+--------------------------------------------------------------------------
+
+IN NO EVENT SHALL TOCLOCO INC 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.
+
+--------------------------------------------------------------------------
+9. TERMS
+--------------------------------------------------------------------------
+
+For licence terms, pricing and key issuance, contact TOCLOCO Inc or visit
+https://www.latticegrid.dev.

package/angular/README.md

@@ -0,0 +1,78 @@
+# Angular components
+
+**Standalone Angular components for [Lattice Grid](https://www.latticegrid.dev), compiled ahead of time.** One component per viewer — the grid, KPI panel, charts, kanban board, Gantt plan, dashboard layout and tab strip — plus the data router as a service. No JIT compiler in your bundle: this is a partial-Ivy library your build's Angular Linker handles exactly like any other Angular package you install.
+
+They ship **inside** the grid package, at `@toclocoinc/lattice-grid/angular` — which is the directory you are reading this in. There is nothing else to install and no second version number to keep in step. `@angular/core` and `@angular/common` are optional peer dependencies of the package, so a project that is not an Angular one installs nothing extra and is not warned about them.
+
+Requires Angular 17 or later.
+
+```sh
+npm install @toclocoinc/lattice-grid
+```
+
+## A dashboard in one component
+
+```ts
+import { Component, viewChild } from '@angular/core';
+import { bootstrapApplication } from '@angular/platform-browser';
+import { createGrid } from '@toclocoinc/lattice-grid';
+import { createKPI } from '@toclocoinc/lattice-grid/modules/kpi';
+import { createChart } from '@toclocoinc/lattice-grid/modules/charts';
+import {
+  LatticeGridComponent, LatticeKpiComponent, LatticeChartComponent, provideLattice,
+} from '@toclocoinc/lattice-grid/angular';
+
+@Component({
+  selector: 'app-dashboard',
+  imports: [LatticeGridComponent, LatticeKpiComponent, LatticeChartComponent],
+  template: `
+    <lattice-grid #grid name="quakes" [config]="config" [quickFilter]="search()"
+                  (cell-changed)="save($event)" />
+    <lattice-kpi  gridName="quakes" [config]="{ tiles }" />
+    <lattice-chart gridName="quakes" [config]="{ type: 'bar', x: 'region', y: 'count' }" />
+  `,
+})
+export class Dashboard {
+  // The live grid — the same object createGrid returns.
+  grid = viewChild<LatticeGridComponent>('grid');
+}
+
+// Each factory is injected, not imported by the library: an application that
+// shows a grid downloads the grid, and never the board or the charts.
+bootstrapApplication(Dashboard, {
+  providers: [provideLattice({ createGrid, createKPI, createChart })],
+});
+```
+
+Give the grid element a height; the grid fills it.
+
+## What is in the package
+
+| Export | Element | What it is |
+|---|---|---|
+| `LatticeGridComponent` | `<lattice-grid>` | The grid. `[config]` is every configuration key; `[sort]`, `[filters]`, `[quickFilter]` and `[selectedKeys]` are applied through the matching API; `[rowUpdates]` and `[predicates]` drive a live feed. Every grid event is an output under its kebab-case name, and `(grid-ready)` hands you the instance. |
+| `LatticeGridDirective` | `[latticeGrid]` | The same component on an element your template already owns: `<div [latticeGrid]="config" class="tall"></div>`. |
+| `LatticeKpiComponent` | `<lattice-kpi>` | The KPI panel. Grid-bound by default — `[gridName]` picks the published grid — or give it `[rows]` for a panel with no grid. |
+| `LatticeChartComponent` | `<lattice-chart>` | A chart over a grid. A changed spec key goes to `chart.update()`; the chart redraws rather than being rebuilt. `(click)`, `(hover)` and `(leave)` carry the datum under the pointer. |
+| `LatticeKanbanComponent` | `<lattice-kanban>` | The board. `[rows]`, `[quickFilter]`, `[sprint]`, `[epic]`, `[loading]` and `[error]` are live inputs. |
+| `LatticeGanttComponent` | `<lattice-gantt>` | The plan. `[tasks]` and `[dependencies]` are live inputs. |
+| `LatticeLayoutComponent` | `<lattice-layout>` | The dashboard layout; its events arrive as `(layout-changed)`, `(window-moved)` and the rest. |
+| `LatticeTabsComponent`, `LatticeTabDirective` | `<lattice-tabs>`, `<ng-template latticeTab="id">` | The tab strip with Angular-rendered tab content, so a tab's grid is a real `<lattice-grid>` with inputs, a reference and your injectors above it. |
+| `LatticeGridRegistry` | `inject(LatticeGridRegistry)` | Where `<lattice-grid name="…">` publishes itself and grid-bound viewers find it, as a signal per name. |
+| `provideLattice` | `provideLattice({ …factories })` | The factories the components build through. |
+| `provideLatticeRouter`, `LatticeRouter` | `providers: [provideLatticeRouter(cfg)]` | The data router as a service, created with the first routed grid under it and destroyed with the component that provides it. |
+
+## How it behaves inside Angular
+
+- **Created once, updated in place, destroyed with the component.** An input change is applied through the instance's own API; nothing is rebuilt. `ngOnDestroy` destroys the instance and leaves no listeners or timers behind.
+- **Zone or zoneless, unconfigured.** The grid is created outside `NgZone`, because it installs its own scroll, wheel and pointer listeners. An event that reaches an output you have bound re-enters the zone; an output nobody bound costs nothing. The grid paints on its own schedule, so measure a cell in a grid event rather than in `ngAfterViewInit`.
+- **`OnPush` is safe everywhere.** No component asks its parent to re-render.
+- **Browser only.** The grid is a DOM object; under server-side rendering the components render their empty host and the grid is created on hydration.
+
+The full reference — every input, output and configuration key — is in this package's `docs/API.html`, under *Frameworks › Angular*, and at [latticegrid.dev/docs](https://www.latticegrid.dev/docs/).
+
+## Licence
+
+Lattice Grid is commercial software; these components are covered by the grid's own licence (`LICENSE`, beside this file and at the package root — the same document). The grid renders in full with no key on localhost, and carries a trial watermark on any other host until a domain licence is installed.
+
+Copyright © 2026 TOCLOCO Inc. All rights reserved.