@toclocoinc/lattice-grid 1.1.0

package/LICENSE

@@ -0,0 +1,116 @@
+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. WHAT REQUIRES A KEY
+--------------------------------------------------------------------------
+
+Serving Lattice Grid from any host other than a loopback host requires a valid
+licence key issued by TOCLOCO Inc. This includes production, staging, internal
+tools, intranets and private networks. A corporate intranet is a deployment
+like any other; .local, .internal and private IP ranges are not exempt.
+
+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.
+
+Without a valid key, the grid renders in full and displays a trial watermark.
+Nothing is disabled, degraded or withheld. That behaviour exists to protect
+your production screens from a licence lapsing at an inconvenient moment; it is
+a courtesy, not a grant of licence. Deploying to a non-loopback host without a
+valid key is a breach of these terms whether or not the software continues to
+work.
+
+--------------------------------------------------------------------------
+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, trademark or attribution notice; or
+
+  (e) use TOCLOCO trademarks other than to state factually that your product
+      incorporates Lattice Grid.
+
+--------------------------------------------------------------------------
+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.
+
+Lattice Grid and the Lattice Grid logo are trademarks of TOCLOCO Inc.

package/README.md

@@ -0,0 +1,161 @@
+# Lattice Grid
+
+**A high-performance data grid for the browser.** Vanilla JavaScript, no runtime
+dependencies, no framework wrapper, no build step required.
+
+Version 1.1.0 · [latticegrid.dev](https://www.latticegrid.dev) · TOCLOCO Inc
+
+---
+
+## What's here
+
+This repository is the distribution: the built library, its type declarations
+and the documentation. Everything is self-contained — nothing is fetched at
+runtime, not a CDN, not a font, not an icon sprite.
+
+| File | What it is |
+|---|---|
+| `lattice-grid.min.js` | The library, minified. UMD — works with a `<script>` tag. |
+| `lattice-grid.esm.min.js` | The same, as an ES module. |
+| `lattice-grid.min.css` | The theme. Required. |
+| `lattice-grid.d.ts` | TypeScript declarations. |
+| `lattice-grid.umd.js`, `lattice-grid.esm.js` | Unminified, for debugging. |
+| `docs/API.html` | The complete API reference. |
+| `docs/api-detail.html` | The developer guide — what each part does, and why. |
+
+---
+
+## Quick start
+
+### No build step
+
+The script-tag path is a first-class target, not an afterthought. Two files:
+
+```html
+<link rel="stylesheet" href="lattice-grid.min.css">
+<script src="lattice-grid.min.js"></script>
+
+<div id="grid" style="height: 600px"></div>
+
+<script>
+  const grid = LatticeGrid.createGrid(document.getElementById('grid'), {
+    columns: [
+      { field: 'circuitId', title: 'Circuit' },
+      { field: 'monthlyCharge', type: 'number', format: 'currency:GBP:2', total: 'sum' },
+      { field: 'installedOn', type: 'date', format: 'date:dd MMM yyyy' },
+    ],
+    rows,
+    rowKey: 'id',
+  });
+</script>
+```
+
+### With a bundler
+
+```js
+import { createGrid } from 'lattice-grid';
+import 'lattice-grid/css';
+
+const grid = createGrid(element, { columns, rows, rowKey: 'id' });
+```
+
+### TypeScript
+
+Declarations ship in the box and are wired up in `package.json`, so editors find
+them without configuration — autocomplete, inline documentation and type
+checking against the real API.
+
+```ts
+import type { Grid, GridConfig, ColumnDef } from 'lattice-grid';
+```
+
+The declarations are checked against the running product on every build, so what
+your editor tells you and what the grid does cannot drift apart.
+
+---
+
+## Full-screen mode
+
+A grid usually lives in whatever box the page layout gave it, and that box is
+usually too small for the job. The left rail's last button fills the browser
+window with the grid; clicking it again — or pressing <kbd>Esc</kbd> — puts it
+back exactly where it was.
+
+```js
+grid.maximise.toggle();
+grid.maximise.active();          // true while it fills the window
+
+createGrid(el, { maximise: false });   // remove the button entirely
+```
+
+It is a real escape, not a restyle: the element is moved out to `<body>` so no
+ancestor's `transform`, `overflow: hidden` or stacking context can clip or
+shrink it, and a placeholder holds its place so the page behind neither reflows
+nor loses its scroll position. Every displaced style is handed back exactly as
+it was found.
+
+---
+
+## Data types
+
+Seven built-in types — `text`, `number`, `boolean`, `date`, `dateString`,
+`object` and `lookup` — cover ordinary business data and are inferred from your
+rows automatically.
+
+Beyond those, Lattice Grid ships **20 technical field types** for the data that
+usually ends up in a text column because the grid had nowhere to put it. Each is
+a complete type, not a display format: it brings its own parser, comparator,
+editor, filter, alignment, clipboard behaviour and Excel mapping.
+
+| Group | Types | Notes |
+|---|---|---|
+| **Network** | `ipv4`, `ipv6`, `cidr` | Sort in address order, not lexically — `10.0.0.9` before `10.0.0.10`. |
+| **Time** | `time`, `datetime`, `duration` | Three things a single `date` type keeps being asked to be. |
+| **Radix** | `hex`, `hex8`, `hex16`, `hex32`, `binary`, `binary8`, `octal` | The stored value stays a plain number; the base is presentation and input only. |
+| **Units** | `bytes`, `megabytes`, `gigabytes`, `bitrate`, `gigabits` | Shows `10 GB`, accepts `10,000M` typed in, stores `10`. |
+| **Structured** | `json`, `secret` | `secret` is write-only: editable, never displayed, never exported. |
+
+Custom types are first-class too — `createRadixType` and `createUnitType` build
+new ones, and any type can `extend` another.
+
+---
+
+## Documentation
+
+- **[API reference](docs/API.html)** — every namespace, method, config key and event.
+- **[Developer guide](docs/api-detail.html)** — what each part does and why, with worked examples.
+
+---
+
+## Licensing
+
+**There is one Lattice Grid and every copy is feature-identical.** No community
+edition, no pro tier, no feature held back behind a key.
+
+- **Free to develop against.** On `localhost` and other loopback hosts, no key
+  is needed and no watermark is shown.
+- **Licensed to deploy.** On any other host, an unlicensed grid renders
+  everything and carries a small trial watermark.
+
+Nothing is ever disabled, degraded or withheld — the failure to avoid is a
+production screen breaking because a licence lapsed over a weekend. A key
+removes the watermark; that is the whole of what it does.
+
+Keys are issued per deployment rather than per developer or per seat, cover the
+domains you name including wildcards, and are checked locally with no licence
+server and no call home.
+
+Get a key at **[latticegrid.dev](https://www.latticegrid.dev)**. See
+[LICENSE](LICENSE) for terms.
+
+---
+
+## Requirements
+
+A current browser. Lattice Grid targets ES2022 and uses `ResizeObserver`; there
+is no IE11 build and no polyfill bundle.
+
+---
+
+Copyright © 2026 TOCLOCO Inc. All rights reserved.
+Lattice Grid and the Lattice Grid logo are trademarks of TOCLOCO Inc.