@toclocoinc/lattice-grid 1.71.0 → 1.71.3

package/docs/warnings.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.71.0",
+  "version": "1.71.3",
   "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": {
@@ -14,7 +14,7 @@
     "snippet": "the smallest configuration that fixes it, where configuration is the answer",
     "docs": "the section of the API reference that covers the feature"
   },
-  "count": 474,
+  "count": 475,
   "warnings": [
     {
       "id": "ai:actorbar:no-el",
@@ -4975,6 +4975,17 @@
       "fix": "Pass the router instance (`createRouter()`'s return, or the one an adapter exposes) and, optionally, the partition kind to publish under.",
       "snippet": "alarms.publish(router, 'alarms');\nrouter.attach(alarmGrid, 'alarms');",
       "docs": "api/alarms.html#ref-alarms-reference"
+    },
+    {
+      "id": "chart:scheme:array-and-map",
+      "module": "charts",
+      "severity": "warn",
+      "since": "1.71.2",
+      "message": "chart \"scheme\" was given as a name map together with a \"palette\" array; the two do not combine. Colours came from the map and the array was ignored. Pass one or the other.",
+      "meaning": "A `scheme` name map and an array `palette` are two different ways of choosing a chart's colours, and only one can be read. Given both, the map is treated as the caller's intent and the array is dropped, because a map names an explicit colour per category or series while an array only orders them — the more specific instruction wins.",
+      "fix": "Pass either a `scheme` name map (`{ [name]: colour }`) or a `palette` array, not both.",
+      "snippet": "createChart({ grid, container, type: 'donut', x: 'status', y: 'count', scheme: { Operational: 'green', Offline: 'red' } });",
+      "docs": "api/charts.html#chartsmodule"
     }
   ]
 }

package/lattice-grid.d.ts

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.71.0, type declarations
+ * Lattice Grid 1.71.3, type declarations
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */
@@ -11636,6 +11636,28 @@ declare global {
   /** The alarms module's script-tag global. */
   // eslint-disable-next-line no-var -- an ambient global is only a global as a var
   var LatticeGridAlarms: typeof import('lattice-grid/modules/alarms');
+  /**
+   * The five geometry packs' script-tag globals. Each is
+   * data-only and takes its own global rather than merging into
+   * `LatticeGrid`: all five export the same two names (`pack`, `default`), so
+   * a page loading more than one — say `geo-uk` beside `geo-europe-nuts` —
+   * reaches `LatticeGridGeoUk.pack` and `LatticeGridGeoEuropeNuts.pack`
+   * rather than the second overwriting the first on a shared object.
+   */
+  // eslint-disable-next-line no-var -- an ambient global is only a global as a var
+  var LatticeGridGeoWorld110m: typeof import('lattice-grid/modules/geo-world-110m');
+  /** The 1:50m world geometry pack's script-tag global. */
+  // eslint-disable-next-line no-var -- an ambient global is only a global as a var
+  var LatticeGridGeoWorld50m: typeof import('lattice-grid/modules/geo-world-50m');
+  /** The Europe NUTS geometry pack's script-tag global. */
+  // eslint-disable-next-line no-var -- an ambient global is only a global as a var
+  var LatticeGridGeoEuropeNuts: typeof import('lattice-grid/modules/geo-europe-nuts');
+  /** The UK geometry pack's script-tag global. */
+  // eslint-disable-next-line no-var -- an ambient global is only a global as a var
+  var LatticeGridGeoUk: typeof import('lattice-grid/modules/geo-uk');
+  /** The US states geometry pack's script-tag global. */
+  // eslint-disable-next-line no-var -- an ambient global is only a global as a var
+  var LatticeGridGeoUsStates: typeof import('lattice-grid/modules/geo-us-states');
 }
 
 /** The default British English catalogue. */
@@ -12078,16 +12100,40 @@ export interface ChartSpec {
   /** A heading above the plot, drawn in the figure's caption alongside any `subtitle`. */
   title?: string;
   /**
-   * A named scheme, or an array of colours. The built-in names are
-   * {@link ChartSchemeName} (`'default'`, `'bright'`, `'earth'`, `'mono'`);
-   * a name registered with `registerScheme` is a plain string alongside them.
+   * A named scheme, an array of colours, or a `{ [name]: colour }` map. The built-in names are {@link ChartSchemeName}
+   * (`'default'`, `'bright'`, `'earth'`, `'mono'`); a name registered with
+   * `registerScheme` is a plain string alongside them.
+   *
+   * The map is the form that survives a filter: a pie or donut keys it on the
+   * category (`x`) value, a chart with a `series` column keys it on the
+   * series value, and a single-series bar or column — no `series` — keys it
+   * on the `x` category instead. A name absent from the map falls back to the
+   * ordered scheme by its position among the *other unmapped* names, so
+   * `{ Operational: 'green' }` keeps every other category exactly as it was
+   * whichever ones a filter removes — an ordered array reassigns every colour
+   * after the gap. A map and an array `palette` do not combine; given both,
+   * the map wins and the array is ignored, once, with a warning.
    */
-  scheme?: ChartSchemeName | string | string[];
+  scheme?: ChartSchemeName | string | string[] | Record<string, string>;
   /**
    * Show the series legend. The object form places it, and `isolate` lets a click on a
-   * legend entry show that series alone.
+   * legend entry show that series alone. `values: true` appends each entry's own total —
+   * a category's for pie and donut, a series' for a series legend — formatted by the
+   * measure column, after the name and a thin space.
+   */
+  legend?: boolean | {
+    position?: 'top' | 'bottom' | 'left' | 'right'; isolate?: boolean; values?: boolean;
+  };
+  /**
+   * The figure a donut draws in its own hole; ignored by
+   * every other type, which has no hole to draw into. `value: 'total'` sums
+   * the slices actually drawn — a legend click that hides a category moves
+   * the figure with them — formatted by the measure column; a number is a
+   * caller's own figure, formatted the same way; a string is written through
+   * unchanged. `label` is a second line beneath it. Both are sized to fit the
+   * hole and are never drawn past its edge.
    */
-  legend?: boolean | { position?: 'top' | 'bottom' | 'left' | 'right'; isolate?: boolean };
+  centre?: { value: 'total' | number | string; label?: string };
   /**
    * Print the value beside each mark. `true` takes the defaults; the object form sets the
    * position, the format and the minimum gap. Only the chart types that support labels