@toclocoinc/lattice-grid 1.68.2 → 1.69.0

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.68.2 · [latticegrid.dev](https://www.latticegrid.dev) · TOCLOCO Inc
+Version 1.69.0 · [latticegrid.dev](https://www.latticegrid.dev) · TOCLOCO Inc
 
 ---
 

package/angular/package.json

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

package/docs/API.html

@@ -363,7 +363,7 @@
 <div class="shell">
   <aside class="rail">
     <p class="rail__brand">Lattice Grid</p>
-    <p class="rail__sub">API reference · v1.68.2</p>
+    <p class="rail__sub">API reference · v1.69.0</p>
     <nav>
       <div class="rail__group">
         <span class="rail__label">Start</span>
@@ -529,7 +529,7 @@
     </header>
 
     <p class="chips">
-      <span class="chip">Version 1.68.2</span>
+      <span class="chip">Version 1.69.0</span>
       <span class="chip">Zero dependencies</span>
       <span class="chip"><a href="api-detail.html">Developer guide &rarr;</a></span>
     </p>
@@ -2033,7 +2033,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.68.2'</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.69.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>
@@ -10519,6 +10519,7 @@ return `next ${p.mean.toFixed(1)}; r2 ${f.r2.toFixed(1)}; band ${p.upper - p.low
           <tr><td class="name">edit</td><td class="type">EditConfig | boolean</td><td class="desc">Editing, and how a change is committed and validated. <small>(optional)</small></td></tr>
           <tr><td class="name">pagination</td><td class="type">PaginationConfig | boolean</td><td class="desc">Page the rows rather than scrolling them. <small>(optional)</small></td></tr>
           <tr><td class="name">locale</td><td class="type">string</td><td class="desc">The BCP-47 locale everything the grid formats and collates uses — numbers, dates, text ordering, and the message catalogue. Falls back to the page's own `&lt;html lang&gt;` and then to `en-GB`. <small>(optional)</small></td></tr>
+          <tr><td class="name">messages</td><td class="type">Record&lt;string, string | Record&lt;string, string&gt;&gt;</td><td class="desc">A partial message catalogue laid over the one `locale` resolves — every string the grid renders or announces. Supply a bundled catalogue (`FR_FR`, `AR`, …) or your own object; overrides merge over the default rather than replacing it, so translating part of the interface leaves the remainder in English rather than showing raw keys. Every valid key is listed in `MESSAGE_KEYS`; a key that is not is ignored with a warning. <small>(optional)</small></td></tr>
           <tr><td class="name">direction</td><td class="type">'ltr' | 'rtl' | 'auto'</td><td class="desc">Writing direction. An explicit `'ltr'` or `'rtl'` always wins. Omit it, or say `'auto'`, to settle it from the mount or the nearest ancestor carrying a `dir="ltr"`/`dir="rtl"` attribute, and only then from `locale`: `ar`, `he`, `fa` and the rest resolve to `rtl`. A page-level `dir="ltr"` therefore wins over an RTL locale — a host that wants RTL inside an LTR page sets `direction: 'rtl'` explicitly. In a right-to-left grid the logical alignments `start`/`end` mirror while the physical `left`/`right` do not (see {@link Align}). <small>(optional)</small></td></tr>
           <tr><td class="name">timeZone</td><td class="type">string</td><td class="desc">IANA zone every date column formats in, e.g. 'Europe/London' or 'UTC'. Omit to use each viewer's own zone. A column's own `format.timeZone` wins. <small>(optional)</small></td></tr>
           <tr><td class="name">theme</td><td class="type">Theme</td><td class="desc">The visual theme. <small>(optional)</small></td></tr>
@@ -19002,7 +19003,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.68.2 · Copyright © 2026 TOCLOCO Inc. All rights reserved.
+      Lattice Grid 1.69.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/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.68.2</p>
+    <p class="rail__sub">Developer guide · v1.69.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.68.2</span>
+        <span class="chip">Version 1.69.0</span>
           <span class="chip">Zero dependencies</span>
         <span class="chip">No build step</span>
       </p>
@@ -588,6 +588,7 @@ createGrid(element, { locale: 'fr-FR', messages: FR_FR });</code></pre>
 
     <h3>Keys seeded in English, awaiting translation</h3>
     <p>A key added after a catalogue was written ships in British English only until a translator supplies it; <code>Messages</code> merges every catalogue over the default, so the grid says it in English rather than showing the key. The shipped catalogues do not carry an English copy under the guise of a translation, and the build's completeness test lists exactly which keys are in this state. As of 1.55 the most recent additions are the strings that had shipped as template literals, untranslated in every locale (BACKLOG-0001106): the presence live region and roster note, <code>a11y.presence.refused</code>, <code>presence.someoneElse</code> and <code>presence.hidden</code>; the comment panel's changed-since note, <code>comments.valueMoved</code>; the facet band's accessible name, <code>facets.filter</code>; the heading tooltip that names a reduction, <code>header.totalOf</code>; the audit-mode tooltip, <code>diff.before</code> and <code>diff.empty</code>; the kanban list names, <code>kanban.columnCards</code> and <code>kanban.laneCards</code>, both plural objects selected by <code>count</code>; and the gantt lag label, <code>gantt.lag</code> and <code>gantt.lead</code>. Supply any of them in <code>messages</code> to translate it today.</p>
+    <p>The rest of that text followed in 1.69 (BACKLOG-0001172): the gantt's pointer tooltip, <code>gantt.tip.range</code>, <code>gantt.tip.duration</code> and <code>gantt.tip.slack</code> — plain strings rather than plural objects, because the day unit is an abbreviation that does not inflect; the comment panel's own labels, <code>comments.resolve</code>, <code>comments.reopen</code>, <code>comments.loading</code>, <code>comments.empty</code>, <code>comments.unknownAuthor</code>, <code>comments.edited</code> (which takes the already-rendered time as <code>{time}</code>, so the marker need not come last) and <code>comments.cellTitle</code>; the accessible name of each entry in the presence roster, <code>presence.peer</code>, <code>presence.peerIdle</code> and <code>presence.peerHidden</code>; and the reduction named in a column heading, which now reads the same <code>total.*</code> keys the tool panel does, with <code>total.custom</code> for a reduction supplied as a function and <code>total.passRate</code> and <code>total.failureCount</code> for the two capability reductions that had no key at all.</p>
     <p>The kanban board and the gantt view are modules and do not import the catalogue. A board bound to a grid, or a plan created with one, borrows that grid's <code>messages</code>; otherwise pass <code>messages</code> — a grid's own, or any object with <code>t(key, params)</code> — to <code>createKanban</code> or to <code>gantt.mount</code>. With neither they render the English.</p>
 
     <div class="why">
@@ -1492,7 +1493,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.68.2'</span>
+      <pre><code>grid.getVersion();          <span class="cmt">// '1.69.0'</span>
 LatticeGrid.getVersion();   <span class="cmt">// the same, when you have no grid to hand</span></code></pre>
     </div>
     <p class="lead-in">
@@ -9783,7 +9784,7 @@ grid.licence.state();   <span class="cmt">// 'licensed' | 'localhost' | 'trial'<
 
     <footer>
       <p>
-        Lattice Grid 1.68.2 · Copyright © 2026 TOCLOCO Inc. All rights reserved.
+        Lattice Grid 1.69.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/lattice-grid.d.ts

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.68.2, type declarations
+ * Lattice Grid 1.69.0, type declarations
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */
@@ -3410,6 +3410,15 @@ export interface GridConfig {
    * own `<html lang>` and then to `en-GB`.
    */
   locale?: string;
+  /**
+   * A partial message catalogue laid over the one `locale` resolves — every
+   * string the grid renders or announces. Supply a bundled catalogue (`FR_FR`,
+   * `AR`, …) or your own object; overrides merge over the default rather than
+   * replacing it, so translating part of the interface leaves the remainder in
+   * English rather than showing raw keys. Every valid key is listed in
+   * `MESSAGE_KEYS`; a key that is not is ignored with a warning.
+   */
+  messages?: Record<string, string | Record<string, string>>;
   /**
    * Writing direction. An explicit `'ltr'` or `'rtl'` always wins. Omit it, or
    * say `'auto'`, to settle it from the mount or the nearest ancestor