@toclocoinc/lattice-grid 1.101.7 → 1.101.8

package/CHANGELOG.md

@@ -9,6 +9,12 @@ and what it means for a grid already in production.
 
 ## [Unreleased]
 
+## [1.101.8] - 2026-10-15
+
+### Fixed
+
+- An optional single-select combo can be emptied by the person using it: clearing the text and pressing Enter, Tab or clicking away sets the value to null and fires one change, while text that matches no option still restores the label. `clearable: true` on a combo or select item shows a clear control while a value is held, which empties the item the same way (a select reports its empty value as the empty string, as before) (BACKLOG-0002393).
+
 ## [1.101.7] - 2026-10-14
 
 ### Fixed

package/README.md

@@ -7,7 +7,7 @@ tiles and map views, all reading the same rows, filters and theme. Vanilla
 JavaScript, no runtime dependencies, no build step; adapters for React, Vue,
 Svelte, Web Components and htmx, Angular compiled inside the package.
 
-Version 1.101.7 · [latticegrid.dev](https://www.latticegrid.dev) · TOCLOCO Inc
+Version 1.101.8 · [latticegrid.dev](https://www.latticegrid.dev) · TOCLOCO Inc
 
 ---
 

package/angular/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.101.7",
+  "version": "1.101.8",
   "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.101.7</p>
+    <p class="rail__sub">API reference · v1.101.8</p>
     <nav>
       <div class="rail__group">
         <span class="rail__label">Start</span>
@@ -584,7 +584,7 @@
     </header>
 
     <p class="chips">
-      <span class="chip">Version 1.101.7</span>
+      <span class="chip">Version 1.101.8</span>
       <span class="chip">Zero dependencies</span>
       <span class="chip"><a href="api-detail.html">Developer guide &rarr;</a></span>
     </p>
@@ -3506,7 +3506,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.101.7'</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.101.8'</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>
@@ -16539,7 +16539,7 @@ return [fruitRows, kept, cleared, fruitChanges, colourRows, keptColour].join('|'
       </table>
     </div>
     <h4 id="combo-live-example">Dynamic values, chips, icons, avatars, templates and a dependent item, executed</h4>
-    <pre data-run="js" data-expect="n0,zz9|T:Alpha|true|true|S:User|NYC|0|n1|p|true" data-covers="export:createCombo config:ComboConfig.load config:ComboConfig.options config:ComboConfig.multiple config:ComboConfig.value config:ComboConfig.resolveLabels config:ComboConfig.newOptions config:ComboConfig.optionTemplate config:ComboConfig.selectedTemplate config:ComboConfig.selectAll config:ComboConfig.debounce config:ComboConfig.pageSize config:ComboConfig.maxHeight config:ComboConfig.chipPlacement config:ComboConfig.dependsOn method:combo.getValue method:combo.setValue method:combo.reload method:combo.clear method:combo.open method:combo.close method:combo.focus method:combo.blur method:combo.setDisabled method:combo.setReadOnly method:combo.destroy"><code>const { createTestDom } = await import('../packages/dom/src/renderer/testdom.js');
+    <pre data-run="js" data-expect="n0,zz9|T:Alpha|true|true|S:User|NYC|0|n1|p|true" data-covers="export:createCombo config:ComboConfig.load config:ComboConfig.options config:ComboConfig.multiple config:ComboConfig.value config:ComboConfig.resolveLabels config:ComboConfig.newOptions config:ComboConfig.optionTemplate config:ComboConfig.selectedTemplate config:ComboConfig.selectAll config:ComboConfig.debounce config:ComboConfig.pageSize config:ComboConfig.maxHeight config:ComboConfig.chipPlacement config:ComboConfig.clearable config:ComboConfig.dependsOn method:combo.getValue method:combo.setValue method:combo.reload method:combo.clear method:combo.open method:combo.close method:combo.focus method:combo.blur method:combo.setDisabled method:combo.setReadOnly method:combo.destroy"><code>const { createTestDom } = await import('../packages/dom/src/renderer/testdom.js');
 const { createCombo, createForm } = await import('../packages/modules/form/index.js');
 
 const { document, root } = createTestDom();
@@ -16572,6 +16572,7 @@ root.appendChild(sizedHost);
 const sized = createCombo(sizedHost, {
   options: [{ value: 'a', label: 'Alpha' }, { value: 'b', label: 'Beta' }],
   optionTemplate: (opt) =&gt; 'T:' + opt.label,
+  clearable: true,                                  <span class="cmt">// a clear control shows while a value is held and empties it with one change (BACKLOG-0002393)</span>
 });
 const sizedPopup = sized.root.querySelector('.lat-combo__popup');   <span class="cmt">// captured before open: the popup moves into the shared layer host while open (BACKLOG-0002291)</span>
 sized.open();
@@ -32601,7 +32602,7 @@ return `next ${p.mean.toFixed(1)}; r2 ${f.r2.toFixed(1)}; band ${p.upper - p.low
           <tr><td class="name">customColors</td><td class="type">string[]</td><td class="desc">A `color` item's custom-colours row to start with — extended, newest first and deduplicated to at most ten, by every colour picked in the picker view (BACKLOG-0002252). <small>(optional)</small></td></tr>
           <tr><td class="name">pickerOnly</td><td class="type">boolean</td><td class="desc">Remove a `color` item's palette view, leaving only the picker (BACKLOG-0002252). <small>(optional)</small></td></tr>
           <tr><td class="name">editable</td><td class="type">boolean</td><td class="desc">Let a `color` item's text part be typed into (default true); `false` makes it read-only, so only the popover sets the value (BACKLOG-0002252). <small>(optional)</small></td></tr>
-          <tr><td class="name">clearable</td><td class="type">boolean</td><td class="desc">Show a `color` item's clear control, setting the value to `null` (BACKLOG-0002252), or a `daterange` item's clear control, setting the value to a null/null pair (BACKLOG-0002255). <small>(optional)</small></td></tr>
+          <tr><td class="name">clearable</td><td class="type">boolean</td><td class="desc">Show a clear control: on a `color` item it sets the value to `null` (BACKLOG-0002252); on a `daterange` item a null/null pair (BACKLOG-0002255); on a single-select `combo` it empties the value to `null`, and on a `select` item to its empty value `''`, with one `change` (BACKLOG-0002393). An optional single-select combo is also emptied when its text is cleared and Enter is pressed or focus leaves. <small>(optional)</small></td></tr>
           <tr><td class="name">[key: string]</td><td class="type">unknown</td><td class="desc">Extra per-control options, kept for later controls.</td></tr>
         </tbody>
       </table>
@@ -32746,6 +32747,7 @@ return `next ${p.mean.toFixed(1)}; r2 ${f.r2.toFixed(1)}; band ${p.upper - p.low
           <tr><td class="name">pageSize</td><td class="type">number</td><td class="desc">The page size handed to `load`. Default 20. <small>(optional)</small></td></tr>
           <tr><td class="name">maxHeight</td><td class="type">number</td><td class="desc">The chip area max height, in pixels. <small>(optional)</small></td></tr>
           <tr><td class="name">chipPlacement</td><td class="type">'inside' | 'above' | 'below'</td><td class="desc">Where multi-select chips sit: 'inside' (default), 'above' or 'below' the control. <small>(optional)</small></td></tr>
+          <tr><td class="name">clearable</td><td class="type">boolean</td><td class="desc">Show a clear control on a single-select combo while it holds a value; it empties the value to `null` with one `change` (BACKLOG-0002393). <small>(optional)</small></td></tr>
           <tr><td class="name">dependsOn</td><td class="type">string[]</td><td class="desc">Parent item names that clear and reload this combo when they change. <small>(optional)</small></td></tr>
         </tbody>
       </table>
@@ -38866,7 +38868,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.101.7 · Copyright © 2026 TOCLOCO Inc. All rights reserved.
+      Lattice Grid 1.101.8 · 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/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.101.7</title>
+<title>Adapters API Reference — Lattice Grid 1.101.8</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.101.7</title>
+<title>AI API Reference — Lattice Grid 1.101.8</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.101.7</title>
+<title>Alarms API Reference — Lattice Grid 1.101.8</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/calendar.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>Calendar API Reference — Lattice Grid 1.101.7</title>
+<title>Calendar API Reference — Lattice Grid 1.101.8</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.101.7</title>
+<title>Charts API Reference — Lattice Grid 1.101.8</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.101.7</title>
+<title>Dashboard API Reference — Lattice Grid 1.101.8</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.101.7</title>
+<title>Data router API Reference — Lattice Grid 1.101.8</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.101.7</title>
+<title>deck.gl API Reference — Lattice Grid 1.101.8</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/designer.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>Designer API Reference — Lattice Grid 1.101.7</title>
+<title>Designer API Reference — Lattice Grid 1.101.8</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/form.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>Form API Reference — Lattice Grid 1.101.7</title>
+<title>Form API Reference — Lattice Grid 1.101.8</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an
@@ -1000,7 +1000,7 @@ return [fruitRows, kept, cleared, fruitChanges, colourRows, keptColour].join('|'
       </table>
     </div>
     <h4 id="combo-live-example">Dynamic values, chips, icons, avatars, templates and a dependent item, executed</h4>
-    <pre data-run="js" data-expect="n0,zz9|T:Alpha|true|true|S:User|NYC|0|n1|p|true" data-covers="export:createCombo config:ComboConfig.load config:ComboConfig.options config:ComboConfig.multiple config:ComboConfig.value config:ComboConfig.resolveLabels config:ComboConfig.newOptions config:ComboConfig.optionTemplate config:ComboConfig.selectedTemplate config:ComboConfig.selectAll config:ComboConfig.debounce config:ComboConfig.pageSize config:ComboConfig.maxHeight config:ComboConfig.chipPlacement config:ComboConfig.dependsOn method:combo.getValue method:combo.setValue method:combo.reload method:combo.clear method:combo.open method:combo.close method:combo.focus method:combo.blur method:combo.setDisabled method:combo.setReadOnly method:combo.destroy"><code>const { createTestDom } = await import('../packages/dom/src/renderer/testdom.js');
+    <pre data-run="js" data-expect="n0,zz9|T:Alpha|true|true|S:User|NYC|0|n1|p|true" data-covers="export:createCombo config:ComboConfig.load config:ComboConfig.options config:ComboConfig.multiple config:ComboConfig.value config:ComboConfig.resolveLabels config:ComboConfig.newOptions config:ComboConfig.optionTemplate config:ComboConfig.selectedTemplate config:ComboConfig.selectAll config:ComboConfig.debounce config:ComboConfig.pageSize config:ComboConfig.maxHeight config:ComboConfig.chipPlacement config:ComboConfig.clearable config:ComboConfig.dependsOn method:combo.getValue method:combo.setValue method:combo.reload method:combo.clear method:combo.open method:combo.close method:combo.focus method:combo.blur method:combo.setDisabled method:combo.setReadOnly method:combo.destroy"><code>const { createTestDom } = await import('../packages/dom/src/renderer/testdom.js');
 const { createCombo, createForm } = await import('../packages/modules/form/index.js');
 
 const { document, root } = createTestDom();
@@ -1033,6 +1033,7 @@ root.appendChild(sizedHost);
 const sized = createCombo(sizedHost, {
   options: [{ value: 'a', label: 'Alpha' }, { value: 'b', label: 'Beta' }],
   optionTemplate: (opt) =&gt; 'T:' + opt.label,
+  clearable: true,                                  <span class="cmt">// a clear control shows while a value is held and empties it with one change (BACKLOG-0002393)</span>
 });
 const sizedPopup = sized.root.querySelector('.lat-combo__popup');   <span class="cmt">// captured before open: the popup moves into the shared layer host while open (BACKLOG-0002291)</span>
 sized.open();
@@ -2534,7 +2535,7 @@ shell.destroy();
           <tr><td class="name">customColors</td><td class="type">string[]</td><td class="desc">A `color` item's custom-colours row to start with — extended, newest first and deduplicated to at most ten, by every colour picked in the picker view (BACKLOG-0002252). <small>(optional)</small></td></tr>
           <tr><td class="name">pickerOnly</td><td class="type">boolean</td><td class="desc">Remove a `color` item's palette view, leaving only the picker (BACKLOG-0002252). <small>(optional)</small></td></tr>
           <tr><td class="name">editable</td><td class="type">boolean</td><td class="desc">Let a `color` item's text part be typed into (default true); `false` makes it read-only, so only the popover sets the value (BACKLOG-0002252). <small>(optional)</small></td></tr>
-          <tr><td class="name">clearable</td><td class="type">boolean</td><td class="desc">Show a `color` item's clear control, setting the value to `null` (BACKLOG-0002252), or a `daterange` item's clear control, setting the value to a null/null pair (BACKLOG-0002255). <small>(optional)</small></td></tr>
+          <tr><td class="name">clearable</td><td class="type">boolean</td><td class="desc">Show a clear control: on a `color` item it sets the value to `null` (BACKLOG-0002252); on a `daterange` item a null/null pair (BACKLOG-0002255); on a single-select `combo` it empties the value to `null`, and on a `select` item to its empty value `''`, with one `change` (BACKLOG-0002393). An optional single-select combo is also emptied when its text is cleared and Enter is pressed or focus leaves. <small>(optional)</small></td></tr>
           <tr><td class="name">[key: string]</td><td class="type">unknown</td><td class="desc">Extra per-control options, kept for later controls.</td></tr>
         </tbody>
       </table>
@@ -2679,6 +2680,7 @@ shell.destroy();
           <tr><td class="name">pageSize</td><td class="type">number</td><td class="desc">The page size handed to `load`. Default 20. <small>(optional)</small></td></tr>
           <tr><td class="name">maxHeight</td><td class="type">number</td><td class="desc">The chip area max height, in pixels. <small>(optional)</small></td></tr>
           <tr><td class="name">chipPlacement</td><td class="type">'inside' | 'above' | 'below'</td><td class="desc">Where multi-select chips sit: 'inside' (default), 'above' or 'below' the control. <small>(optional)</small></td></tr>
+          <tr><td class="name">clearable</td><td class="type">boolean</td><td class="desc">Show a clear control on a single-select combo while it holds a value; it empties the value to `null` with one `change` (BACKLOG-0002393). <small>(optional)</small></td></tr>
           <tr><td class="name">dependsOn</td><td class="type">string[]</td><td class="desc">Parent item names that clear and reload this combo when they change. <small>(optional)</small></td></tr>
         </tbody>
       </table>

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.101.7</title>
+<title>Gantt API Reference — Lattice Grid 1.101.8</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.101.7</title>
+<title>Geometry API Reference — Lattice Grid 1.101.8</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.101.7</title>
+<title>Grid API Reference — Lattice Grid 1.101.8</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an
@@ -1912,7 +1912,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.101.7'</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.101.8'</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.101.7</title>
+<title>API Reference — Lattice Grid 1.101.8</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an
@@ -455,7 +455,7 @@
           <tr><td class="name"><a href="tabs.html">The tabbed grid</a></td><td class="desc"><code>createTabs</code>: a tab strip where each tab holds a grid, a board, a KPI strip or a Gantt, and the tablist keyboard model.</td><td class="type">1</td><td class="type">7</td><td class="type">57</td></tr>
           <tr><td class="name"><a href="layout.html">The dashboard layout</a></td><td class="desc"><code>createLayout</code>: windows a reader moves, resizes and closes, the arrangement saved as plain JSON, locking, and the cancellable gestures.</td><td class="type">1</td><td class="type">15</td><td class="type">133</td></tr>
           <tr><td class="name"><a href="shell.html">The shell module</a></td><td class="desc"><code>createShell</code>: cells nested as rows and columns to any depth, sized by flexbox so the DOM is complete and measured the moment the factory returns.</td><td class="type">1</td><td class="type">25</td><td class="type">153</td></tr>
-          <tr><td class="name"><a href="form.html">The form module</a></td><td class="desc"><code>createForm</code>: named items laid out in nested rows and columns, themed by the grid's own density tokens, so the DOM is complete and measured the moment the factory returns.</td><td class="type">1</td><td class="type">40</td><td class="type">382</td></tr>
+          <tr><td class="name"><a href="form.html">The form module</a></td><td class="desc"><code>createForm</code>: named items laid out in nested rows and columns, themed by the grid's own density tokens, so the DOM is complete and measured the moment the factory returns.</td><td class="type">1</td><td class="type">40</td><td class="type">383</td></tr>
           <tr><td class="name"><a href="dashboard.html">Dashboard composition</a></td><td class="desc"><code>createDashboard</code>: a dashboard described as a JSON spec &mdash; a layout, grid, chart, KPI, map and html panels, a source per panel, links between them &mdash; built into the wired page, handed back by <code>spec()</code>, and proposed by the AI.</td><td class="type">1</td><td class="type">15</td><td class="type">81</td></tr>
           <tr><td class="name"><a href="designer.html">The Designer</a></td><td class="desc"><code>createDesigner</code>: a dashboard designer whose state is the dashboard spec extended with pages, in edit and view mode, with JSON state in and out.</td><td class="type">1</td><td class="type">63</td><td class="type">406</td></tr>
           <tr><td class="name"><a href="ai.html">The AI narrative and insights layer</a></td><td class="desc">The narrative module: summaries, insights and risk text over what the grid already holds. The <code>grid.ai</code> intent layer is on the grid page.</td><td class="type">1</td><td class="type">17</td><td class="type">124</td></tr>

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.101.7</title>
+<title>Kanban API Reference — Lattice Grid 1.101.8</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.101.7</title>
+<title>KPI API Reference — Lattice Grid 1.101.8</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.101.7</title>
+<title>Layout API Reference — Lattice Grid 1.101.8</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.101.7</title>
+<title>Leaflet API Reference — Lattice Grid 1.101.8</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.101.7</title>
+<title>List API Reference — Lattice Grid 1.101.8</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/mapview.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>Map view API Reference — Lattice Grid 1.101.7</title>
+<title>Map view API Reference — Lattice Grid 1.101.8</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.101.7</title>
+<title>Mock socket API Reference — Lattice Grid 1.101.8</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.101.7</title>
+<title>Presets API Reference — Lattice Grid 1.101.8</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/scheduler.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>Scheduler API Reference — Lattice Grid 1.101.7</title>
+<title>Scheduler API Reference — Lattice Grid 1.101.8</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/shell.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>Shell API Reference — Lattice Grid 1.101.7</title>
+<title>Shell API Reference — Lattice Grid 1.101.8</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.101.7</title>
+<title>Tabs API Reference — Lattice Grid 1.101.8</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.101.7</title>
+<title>Types API Reference — Lattice Grid 1.101.8</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.101.7</p>
+    <p class="rail__sub">Developer guide · v1.101.8</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.101.7</span>
+        <span class="chip">Version 1.101.8</span>
           <span class="chip">Zero dependencies</span>
         <span class="chip">No build step</span>
       </p>
@@ -1886,7 +1886,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.101.7'</span>
+      <pre><code>grid.getVersion();          <span class="cmt">// '1.101.8'</span>
 LatticeGrid.getVersion();   <span class="cmt">// the same, when you have no grid to hand</span></code></pre>
     </div>
     <p class="lead-in">
@@ -13388,7 +13388,7 @@ grid.licence.state();   <span class="cmt">// 'licensed' | 'localhost' | 'trial'<
 
     <footer>
       <p>
-        Lattice Grid 1.101.7 · Copyright © 2026 TOCLOCO Inc. All rights reserved.
+        Lattice Grid 1.101.8 · 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.101.7",
+  "version": "1.101.8",
   "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.101.7, type declarations
+ * Lattice Grid 1.101.8, type declarations
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */