@toclocoinc/lattice-grid 1.12.0 → 1.12.2

package/README.md

@@ -4,7 +4,7 @@
 dependencies, no build step required. Optional adapters for React, Vue, Svelte
 and Web Components ship alongside it.
 
-Version 1.12.0 · [latticegrid.dev](https://www.latticegrid.dev) · TOCLOCO Inc
+Version 1.12.2 · [latticegrid.dev](https://www.latticegrid.dev) · TOCLOCO Inc
 
 ---
 

package/docs/API.html

@@ -2334,6 +2334,15 @@ grid.licence.state();      <span class="cmt">// 'licensed' | 'localhost' | 'tria
       spread pulls that chart's own limits wider with it: it rescales to accommodate the very thing
       that has gone wrong. Drawn one above the other, they are the standard I-MR pair.
     </p>
+    <p class="section-note">
+      <strong>Bind it to the readings, not to a summary of them.</strong> A whisker is computed from
+      the values the chart can see behind each mark. Bound to a grid whose rows are already one per
+      mark, a summary or a derived panel, the chart sees a single value per category and there is no
+      spread to draw: the readings that produced each average are upstream and no longer reachable.
+      Bind the chart to the rows the summary was computed from, or carry a margin yourself and use
+      <code>error: { of: 'margin' }</code>. A chart asked for whiskers it cannot compute says so once
+      rather than drawing nothing in silence.
+    </p>
     <p class="section-note">
       <strong>Uncertainty on a chart.</strong> <code>error: true</code> draws a whisker on each mark,
       computed from the readings behind it. Four bars side by side invite a comparison the numbers
@@ -2805,7 +2814,7 @@ const chart = createChart({
           <tr><td class="name">footnote</td><td class="type">string</td><td class="desc">A note under the plot, a source, a caveat, a unit.</td></tr>
           <tr><td class="name">emptyText</td><td class="type">string</td><td class="desc">What to show when the binding produces nothing. Said rather than left blank, because an empty plot and a broken one look identical.</td></tr>
           <tr><td class="name">fit</td><td class="type">boolean | 'line'</td><td class="desc">A least-squares line through a scatter or bubble chart, one per series. <code>true</code> draws it with its R&sup2;; <code>'line'</code> draws the line alone. Only where the x axis is numeric: on a band scale a slope would be a slope through the order the categories happened to be listed in.</td></tr>
-          <tr><td class="name">error</td><td class="type">boolean | object</td><td class="desc">Whiskers showing the uncertainty in each mark, computed from the readings behind it. <code>{ of }</code> takes a symmetric margin from a column instead; <code>{ confidence }</code> sets the level. A mark with one reading gets none.</td></tr>
+          <tr><td class="name">error</td><td class="type">boolean | object</td><td class="desc">Whiskers showing the uncertainty in each mark, computed from the readings the chart can see behind it. <code>{ of }</code> takes a symmetric margin from a column instead; <code>{ confidence }</code> sets the level. A mark the chart sees only one value for gets none, and the chart says so.</td></tr>
           <tr><td class="name">stack</td><td class="type">boolean</td><td class="desc">Stack the series rather than drawing them side by side.</td></tr>
           <tr><td class="name">curve</td><td class="type">boolean</td><td class="desc">Overlay a kernel density curve on a histogram, which shows which features are in the data and which are in the binning.</td></tr>
           <tr><td class="name">diverging</td><td class="type">boolean</td><td class="desc">Colour a heatmap outward from zero rather than along a single ramp.</td></tr>
@@ -5651,7 +5660,7 @@ createGrid(el, {
 <!-- END GENERATED TYPE REFERENCE -->
 
     <footer>
-      Lattice Grid 1.12.0 · Copyright © 2026 TOCLOCO Inc. All rights reserved.
+      Lattice Grid 1.12.2 · 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/lattice-grid.d.ts

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

package/lattice-grid.esm.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.12.0, core + DOM renderer
+ * Lattice Grid 1.12.2, core + DOM renderer
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */

package/lattice-grid.min.cjs

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.12.0, core + DOM renderer
+ * Lattice Grid 1.12.2, core + DOM renderer
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */

package/lattice-grid.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.12.0, core + DOM renderer
+ * Lattice Grid 1.12.2, core + DOM renderer
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */

package/modules/charts.esm.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.12.0, charts module
+ * Lattice Grid 1.12.2, charts module
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */
@@ -394,6 +394,7 @@ return`
 .${NS}__qq-line{stroke:var(--lattice-foreground-muted,#5b6570);stroke-width:1;stroke-dasharray:4 3;fill:none}
 .${NS}__ecdf{stroke-width:1.5;fill:none}
 .${NS}__control-line{stroke-width:1.25;fill:none}
+.${NS}__error-bar{stroke:var(--lattice-foreground,#1a1a1a);stroke-width:1.5;fill:none;stroke-linecap:round}
 .${NS}__control-centre{stroke:var(--lattice-foreground-muted,#5b6570);stroke-width:1;fill:none}
 .${NS}__control-limit{stroke:var(--lattice-foreground-muted,#5b6570);stroke-width:1;stroke-dasharray:6 3;fill:none}
 .${NS}__spec-limit{stroke:var(--lattice-danger,#a4262c);stroke-width:1;stroke-dasharray:2 3;fill:none}
@@ -1727,9 +1728,13 @@ const pool=new Pool(group);
 const conf=Number.isFinite(Number(options.confidence))?Number(options.confidence):0.95;
 const cap=4;
 let drawn=0;
+let marks=0;
+let single=0;
 for(const sery of series){
 for(const point of sery.points){
 if(point.y===null||point.y===undefined)continue;
+marks++;
+if(Array.isArray(point.values)&&point.values.length===1)single++;
 let lower=null;
 let upper=null;
 if(options.of!==undefined&&Number.isFinite(Number(point[options.of]))){
@@ -1752,6 +1757,7 @@ d:path([
 'M',x-cap,bottom,'L',x+cap,bottom,
 ]),
 fill:'none',
+stroke:'currentColor',
 'data-lower':lower,
 'data-upper':upper,
 });
@@ -1759,7 +1765,7 @@ drawn++;
 }
 }
 pool.finish();
-return drawn;
+return{drawn,marks,single};
 }
 function drawCartesian(ctx){
 const scheme=ctx.scheme||resolveScheme();
@@ -1939,8 +1945,9 @@ size:type_.small,
 showR2:ctx.fit!=='line',
 });
 }
+let errorBars=null;
 if(ctx.error){
-drawErrorBars({
+errorBars=drawErrorBars({
 group:ctx.groups.overlay,
 series:visible,
 xScale,
@@ -1965,7 +1972,7 @@ drawReferenceLines({
 group:ctx.groups.overlay,plot,scale:yScale,lines:ctx.reference,
 });
 }
-return{xScale,yScale,series:visible,horizontal,percent,plot};
+return{xScale,yScale,series:visible,horizontal,percent,plot,errorBars};
 }
 function nearestCategory(opts){
 const{bound,xScale,at}=opts;
@@ -5781,6 +5788,7 @@ class Chart{
 #hidden=new Set();
 #drawn=null;
 #warnedLabels=false;
+#warnedError=false;
 #bound=null;
 #frame=0;
 #observer=null;
@@ -6376,6 +6384,22 @@ this.#drawLegend(bound.series.length>1
 :[]);
 }
 }
+const bars=this.#drawn&&this.#drawn.errorBars;
+if(this.#spec.error&&bars&&!bars.drawn&&bars.marks&&!this.#warnedError){
+this.#warnedError=true;
+const view=this.#doc&&this.#doc.defaultView;
+const out=(view&&view.console)
+||(typeof globalThis!=='undefined'?globalThis.console:null);
+if(out&&typeof out.warn==='function'){
+out.warn(bars.single===bars.marks
+?'[lattice] error bars were requested but every mark has a single reading behind it, so '
++'there is no spread to compute. A chart bound to a summary or derived grid sees one '
++'row per mark: bind it to the rows the summary was computed from, or supply a margin '
++'column with `error: { of: "column" }`.'
+:'[lattice] error bars were requested but no mark had enough readings to compute an '
++'interval.');
+}
+}
 if(this.#drawn)this.#drawn.plot=this.#drawn.plot||plotOf(this.#drawn,width,height);
 if(this.#spec.selection)this.#emphasise();
 this.#watermark();

package/modules/devtools.esm.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.12.0, devtools module
+ * Lattice Grid 1.12.2, devtools module
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */

package/modules/dhtmlx-compat.esm.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.12.0, dhtmlx-compat module
+ * Lattice Grid 1.12.2, dhtmlx-compat module
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */

package/modules/htmx.esm.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.12.0, htmx module
+ * Lattice Grid 1.12.2, htmx module
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */

package/modules/htmx.min.cjs

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.12.0, htmx module
+ * Lattice Grid 1.12.2, htmx module
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */

package/modules/htmx.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.12.0, htmx module
+ * Lattice Grid 1.12.2, htmx module
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */

package/modules/react.esm.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.12.0, react module
+ * Lattice Grid 1.12.2, react module
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */

package/modules/svelte.esm.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.12.0, svelte module
+ * Lattice Grid 1.12.2, svelte module
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */

package/modules/vue.esm.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.12.0, vue module
+ * Lattice Grid 1.12.2, vue module
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */

package/modules/webcomponent.esm.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.12.0, webcomponent module
+ * Lattice Grid 1.12.2, webcomponent module
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toclocoinc/lattice-grid",
-  "version": "1.12.0",
+  "version": "1.12.2",
   "description": "Lattice Grid — high performance JavaScript data grid. TOCLOCO Inc.",
   "license": "SEE LICENSE IN LICENSE",
   "author": "TOCLOCO Inc",