@toclocoinc/lattice-grid 1.80.0 → 1.81.0

package/CHANGELOG.md

@@ -9,6 +9,12 @@ and what it means for a grid already in production.
 
 ## [Unreleased]
 
+## [1.81.0] - 2026-09-30
+
+### Changed
+
+- **The owner, looking at the live Material preset: "is this really what material ui looks like? — no."** A MUST-complete preset (BACKLOG-0001570) still left every grid at Lattice's own 28px compact row, a vertical rule on every header cell and a tinted header band — none of which a real MUI X DataGrid, Ant, Bootstrap or Fluent table draws; only colour, radius and font were ever a preset's to set. A new public MAY token, `--lattice-cell-border-width`, joins `docs/THEMING.md` for the vertical/inline-end rule a header or filter cell always draws — its default equals `--lattice-border-width`, so nothing changes until a preset overrides it, and an explicit `gridLines: 'vertical'|'both'` config still draws its own line regardless of what a preset sets it to. Each of the four shipped presets (`packages/modules/presets/*.css`) now also sets, light and dark: `--lattice-cell-border-width: 0` (all four systems are divider-only), `--lattice-row-height`/`--lattice-header-height` (Material 52px/56px, Ant 55px, Bootstrap ~41px, Fluent 44px), `--lattice-header-font-weight` (Bootstrap's own 700, a stock `<th>`'s browser-default bold, was previously unset), and a plain (untinted) header fill for Material, Bootstrap and Fluent, matching each system's own published table — Ant's was already correct. Bootstrap also gains `--lattice-selected-background`, from its own `$table-active-bg-factor` convention. The Material figures are checked against a real installed `@mui/x-data-grid`, not only cited: row height, header height, header weight and divider style each match within 1px in a real-Chrome side-by-side render (`test/preset-proportions-browser.test.js`). `node tools/theme-check.js` gains a report-only proportion count, shown in the gate line, of how many of these six tokens each shipped preset sets. (BACKLOG-0001582)
+
 ## [1.80.0] - 2026-09-30
 
 ### Added

package/README.md

@@ -5,7 +5,7 @@ dependencies, no build step required. Optional adapters for React, Vue, Svelte
 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.80.0 · [latticegrid.dev](https://www.latticegrid.dev) · TOCLOCO Inc
+Version 1.81.0 · [latticegrid.dev](https://www.latticegrid.dev) · TOCLOCO Inc
 
 ---
 

package/angular/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.80.0",
+  "version": "1.81.0",
   "type": "module",
   "sideEffects": false,
   "module": "./fesm2022/toclocoinc-lattice-grid-angular.mjs",

package/docs/API.html

@@ -382,7 +382,7 @@
 <div class="shell">
   <aside class="rail">
     <p class="rail__brand">Lattice Grid</p>
-    <p class="rail__sub">API reference · v1.80.0</p>
+    <p class="rail__sub">API reference · v1.81.0</p>
     <nav>
       <div class="rail__group">
         <span class="rail__label">Start</span>
@@ -564,7 +564,7 @@
     </header>
 
     <p class="chips">
-      <span class="chip">Version 1.80.0</span>
+      <span class="chip">Version 1.81.0</span>
       <span class="chip">Zero dependencies</span>
       <span class="chip"><a href="api-detail.html">Developer guide &rarr;</a></span>
     </p>
@@ -3137,7 +3137,7 @@ grid.destroy();
       <table>
         <thead><tr><th>Member</th><th>Returns</th><th>Description</th></tr></thead>
         <tbody>
-          <tr><td class="sig">getVersion()</td><td class="type">string</td><td class="desc">The version this grid came from, e.g. <code>'1.80.0'</code>. Also on the module as <code>getVersion()</code>, for when you have no grid to hand.</td></tr>
+          <tr><td class="sig">getVersion()</td><td class="type">string</td><td class="desc">The version this grid came from, e.g. <code>'1.81.0'</code>. Also on the module as <code>getVersion()</code>, for when you have no grid to hand.</td></tr>
           <tr><td class="sig">get(key)</td><td class="type">unknown</td><td class="desc">Read any configuration key.</td></tr>
           <tr><td class="sig">set(key, value)</td><td class="type">void</td><td class="desc">Write one key. Every key is live; nothing needs a rebuild.</td></tr>
           <tr><td class="sig">setAll(values)</td><td class="type">void</td><td class="desc">Write several in one pass. Emits one <code>config:changed</code> for the batch, not one per key.</td></tr>
@@ -24490,7 +24490,7 @@ return `next ${p.mean.toFixed(1)}; r2 ${f.r2.toFixed(1)}; band ${p.upper - p.low
 <!-- END GENERATED TYPE REFERENCE -->
 
     <footer>
-      Lattice Grid 1.80.0 · Copyright © 2026 TOCLOCO Inc. All rights reserved.
+      Lattice Grid 1.81.0 · Copyright © 2026 TOCLOCO Inc. All rights reserved.
       This document describes the behaviour of the shipped library. Where this guide and the code
       disagree, the code wins: please <a href="https://www.latticegrid.dev">tell us</a>.
     </footer>

package/docs/THEMING.md

@@ -28,11 +28,11 @@ finds:
 
 | | Count |
 |---|---:|
-| `--lattice-*` with a declared per-theme default | 128 |
+| `--lattice-*` with a declared per-theme default | 129 |
 | `--lattice-*` fallback-only, no built-in default, no JS setter — a real, undocumented escape hatch | 28 |
 | `--lattice-*` fallback-only, set by the grid’s own JS at runtime — read, don’t set | 10 |
 | `--lat-*` geometry helper, declared, state-class-driven | 5 |
-| **Public total (this page)** | **171** |
+| **Public total (this page)** | **172** |
 | `--lat-*` internal computed alias of `--lattice-scrollbar-size` (prefixed, but never a preset’s to set) | 2 |
 | `--lat-*` internal per-cell/per-instance data (a bar fill %, a swatch colour...) set inline by JS per cell, never a theme default (prefixed, but not a token) | 11 |
 | Internal, unprefixed component-local plumbing (`--bl`, `--br`, `--dimmed`, `--focused`, `--hovered`, ... — named, not enumerated here) | ~50 |
@@ -45,7 +45,8 @@ at the time (not the spike’s 132; no token was renamed either way — the
 spike’s "no renames needed" finding still held). BACKLOG-0001573 moved
 `--lattice-duration` from the fallback-only row above to a declared default,
 renamed it `--lattice-motion-duration`, and added `--lattice-motion-easing`
-beside it, for a net +1: **171**.
+beside it, for a net +1: **171**. BACKLOG-0001582 added
+`--lattice-cell-border-width`, for a net +1: **172**.
 
 ## Public vs internal
 
@@ -268,6 +269,7 @@ Legend: **MUST** — a preset claiming to match a design system sets this or the
 | Token | Light | Dark | High-contrast | Terminal | Affects | Marking |
 |---|---|---|---|---|---|---|
 | `--lattice-border-width` | `1px` | `1px` | `1px` | `1px` | the grid’s hairline border thickness | MAY |
+| `--lattice-cell-border-width` | `var(--lattice-border-width)` | `var(--lattice-border-width)` | `var(--lattice-border-width)` | `var(--lattice-border-width)` | the vertical/inline-end border a header or filter cell always draws, independent of `gridLines` (BACKLOG-0001582); a preset sets this to `0` for a divider-only look. An explicit `gridLines: 'vertical'\|'both'` config always wins for body cells — those read `--lattice-border-width` directly, so this token can never hide a host’s own request for vertical lines | MAY |
 | `--lattice-focus-offset` | `-2px` | `-2px` | `-2px` | `-2px` | the focus ring’s inset/outset offset | leave |
 | `--lattice-focus-width` | `2px` | `2px` | `3px` | `2px` | the focus ring’s thickness | MAY |
 | `--lattice-hscroll-sign` | `-1` | `-1` | `-1` | `-1` | internal RTL horizontal-scroll direction flip | leave |
@@ -389,6 +391,7 @@ The two fenced blocks below are what `test/theming-contract-doc.test.js` diffs a
 --lattice-border-color
 --lattice-border-strong
 --lattice-border-width
+--lattice-cell-border-width
 --lattice-cell-highlight
 --lattice-cell-padding-x
 --lattice-cell-padding-y

package/docs/api/adapters.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>Adapters API Reference — Lattice Grid 1.80.0</title>
+<title>Adapters API Reference — Lattice Grid 1.81.0</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/ai.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>AI API Reference — Lattice Grid 1.80.0</title>
+<title>AI API Reference — Lattice Grid 1.81.0</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/alarms.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>Alarms API Reference — Lattice Grid 1.80.0</title>
+<title>Alarms API Reference — Lattice Grid 1.81.0</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/charts.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>Charts API Reference — Lattice Grid 1.80.0</title>
+<title>Charts API Reference — Lattice Grid 1.81.0</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/dashboard.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>Dashboard API Reference — Lattice Grid 1.80.0</title>
+<title>Dashboard API Reference — Lattice Grid 1.81.0</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/data-router.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>Data router API Reference — Lattice Grid 1.80.0</title>
+<title>Data router API Reference — Lattice Grid 1.81.0</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/deckgl.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>deck.gl API Reference — Lattice Grid 1.80.0</title>
+<title>deck.gl API Reference — Lattice Grid 1.81.0</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/gantt.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>Gantt API Reference — Lattice Grid 1.80.0</title>
+<title>Gantt API Reference — Lattice Grid 1.81.0</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/geometry.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>Geometry API Reference — Lattice Grid 1.80.0</title>
+<title>Geometry API Reference — Lattice Grid 1.81.0</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/grid.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>Grid API Reference — Lattice Grid 1.80.0</title>
+<title>Grid API Reference — Lattice Grid 1.81.0</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an
@@ -1851,7 +1851,7 @@ grid.destroy();
       <table>
         <thead><tr><th>Member</th><th>Returns</th><th>Description</th></tr></thead>
         <tbody>
-          <tr><td class="sig">getVersion()</td><td class="type">string</td><td class="desc">The version this grid came from, e.g. <code>'1.80.0'</code>. Also on the module as <code>getVersion()</code>, for when you have no grid to hand.</td></tr>
+          <tr><td class="sig">getVersion()</td><td class="type">string</td><td class="desc">The version this grid came from, e.g. <code>'1.81.0'</code>. Also on the module as <code>getVersion()</code>, for when you have no grid to hand.</td></tr>
           <tr><td class="sig">get(key)</td><td class="type">unknown</td><td class="desc">Read any configuration key.</td></tr>
           <tr><td class="sig">set(key, value)</td><td class="type">void</td><td class="desc">Write one key. Every key is live; nothing needs a rebuild.</td></tr>
           <tr><td class="sig">setAll(values)</td><td class="type">void</td><td class="desc">Write several in one pass. Emits one <code>config:changed</code> for the batch, not one per key.</td></tr>

package/docs/api/index.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>API Reference — Lattice Grid 1.80.0</title>
+<title>API Reference — Lattice Grid 1.81.0</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/kanban.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>Kanban API Reference — Lattice Grid 1.80.0</title>
+<title>Kanban API Reference — Lattice Grid 1.81.0</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/kpi.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>KPI API Reference — Lattice Grid 1.80.0</title>
+<title>KPI API Reference — Lattice Grid 1.81.0</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/layout.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>Layout API Reference — Lattice Grid 1.80.0</title>
+<title>Layout API Reference — Lattice Grid 1.81.0</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/leaflet.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>Leaflet API Reference — Lattice Grid 1.80.0</title>
+<title>Leaflet API Reference — Lattice Grid 1.81.0</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/list.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>List API Reference — Lattice Grid 1.80.0</title>
+<title>List API Reference — Lattice Grid 1.81.0</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/mock-socket.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>Mock socket API Reference — Lattice Grid 1.80.0</title>
+<title>Mock socket API Reference — Lattice Grid 1.81.0</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/presets.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>Presets API Reference — Lattice Grid 1.80.0</title>
+<title>Presets API Reference — Lattice Grid 1.81.0</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/tabs.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>Tabs API Reference — Lattice Grid 1.80.0</title>
+<title>Tabs API Reference — Lattice Grid 1.81.0</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/types.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>Types API Reference — Lattice Grid 1.80.0</title>
+<title>Types API Reference — Lattice Grid 1.81.0</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api-detail.html

@@ -437,7 +437,7 @@
 <div class="shell">
   <aside class="rail">
     <p class="rail__brand">Lattice Grid</p>
-    <p class="rail__sub">Developer guide · v1.80.0</p>
+    <p class="rail__sub">Developer guide · v1.81.0</p>
     <nav>
       <div class="rail__group">
         <span class="rail__label">Start here</span>
@@ -554,7 +554,7 @@
         <a href="API.html">reference tables</a> are the shorter version for when you already know.
       </p>
       <p class="chips">
-        <span class="chip">Version 1.80.0</span>
+        <span class="chip">Version 1.81.0</span>
           <span class="chip">Zero dependencies</span>
         <span class="chip">No build step</span>
       </p>
@@ -1579,7 +1579,7 @@ off();                                       <span class="cmt">// every subscrip
     </p>
     <div class="example">
       <p class="example__label">Which version am I running?</p>
-      <pre><code>grid.getVersion();          <span class="cmt">// '1.80.0'</span>
+      <pre><code>grid.getVersion();          <span class="cmt">// '1.81.0'</span>
 LatticeGrid.getVersion();   <span class="cmt">// the same, when you have no grid to hand</span></code></pre>
     </div>
     <p class="lead-in">
@@ -11814,7 +11814,7 @@ grid.licence.state();   <span class="cmt">// 'licensed' | 'localhost' | 'trial'<
 
     <footer>
       <p>
-        Lattice Grid 1.80.0 · Copyright © 2026 TOCLOCO Inc. All rights reserved.
+        Lattice Grid 1.81.0 · Copyright © 2026 TOCLOCO Inc. All rights reserved.
         Written against the shipped source. Where this guide and the code disagree, the code wins,
         please <a href="https://www.latticegrid.dev">tell us</a>.
       </p>

package/docs/warnings.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.80.0",
+  "version": "1.81.0",
   "generated": "tools/build.js from docs/warnings/catalogue.json",
   "about": "Every developer-facing diagnostic Lattice Grid prints to the console, by the key it de-duplicates on. The key is the stable identifier: it is the `id` of every reported entry `grid.diagnostics.warnings()` hands back, what the devtools panel lists, and what to quote in a support conversation. A `*` in an id stands for a value filled in at runtime (a column id, a chart id, an event name), so `icon:*` is one entry covering every column the icon renderer refuses.",
   "fields": {

package/lattice-grid.d.ts

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.80.0, type declarations
+ * Lattice Grid 1.81.0, type declarations
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */