@toclocoinc/lattice-grid 1.68.0 → 1.68.1

package/modules/layout.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.68.0, layout module
+ * Lattice Grid 1.68.1, layout module
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */
@@ -54,12 +54,12 @@ Object.defineProperty(__exports,"frameBatched",{enumerable:true,get:function(){r
 Object.defineProperty(__exports,"settleDebounce",{enumerable:true,get:function(){return settleDebounce;}});
 Object.defineProperty(__exports,"whenIdle",{enumerable:true,get:function(){return whenIdle;}});
 Object.defineProperty(__exports,"uid",{enumerable:true,get:function(){return uid;}});
-const STAMPED_VERSION="1.68.0";
+const STAMPED_VERSION="1.68.1";
 async function resolveVersion(){
 if(STAMPED_VERSION!=='0.0.0-source')return STAMPED_VERSION;
 return STAMPED_VERSION;
 }
-const VERSION="1.68.0";
+const VERSION="1.68.1";
 const warned=new Set();
 const WARNED_LIMIT=2000;
 function rememberWarned(key){

package/modules/mock-socket.d.ts

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.68.0, mock-socket module type declarations
+ * Lattice Grid 1.68.1, mock-socket module type declarations
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */
@@ -15,6 +15,11 @@ interface FeedChange { op: 'upsert' | 'delete'; row: FeedRow }
  * `kind`, exactly as against a real feed that framed its messages the same way.
  */
 interface FeedMessage {
+  /**
+   * Whether this message opens the feed with a full set of rows
+   * (`'snapshot'`, which the feed yields first) or carries changes to apply
+   * to what is already there (`'delta'`, every message after it).
+   */
   kind: 'snapshot' | 'delta';
   /** Present on a snapshot: the full opening set of rows. */
   rows?: FeedRow[];

package/modules/mock-socket.esm.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.68.0, mock-socket module
+ * Lattice Grid 1.68.1, mock-socket module
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */

package/modules/mock-socket.min.cjs

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.68.0, mock-socket module
+ * Lattice Grid 1.68.1, mock-socket module
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */

package/modules/mock-socket.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.68.0, mock-socket module
+ * Lattice Grid 1.68.1, mock-socket module
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */

package/modules/react.d.ts

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.68.0, react module type declarations
+ * Lattice Grid 1.68.1, react module type declarations
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */
@@ -37,6 +37,10 @@ export type LatticeGridEventProps = {
 
 /** The live instance a `<LatticeGrid>` ref exposes; `null` before mount. */
 export interface LatticeGridHandle {
+  /**
+   * The live grid the component built, or null before the mount effect has run and after
+   * it has been destroyed.
+   */
   readonly grid: Grid | null;
 }
 
@@ -115,6 +119,10 @@ export function createLatticeGrid<Row = unknown>(deps: {
 
 /** The live instance a viewer component's ref exposes; `null` before mount. */
 export interface LatticeViewerHandle<Instance = unknown> {
+  /**
+   * The live viewer the component built — the board, panel, chart, plan, layout or strip
+   * — or null before mount.
+   */
   readonly instance: Instance | null;
 }
 
@@ -185,7 +193,12 @@ export type LatticeLayoutProps = Record<string, unknown> & LatticeViewerCommonPr
 
 /** One tab of a `<LatticeTabs>`; `content` makes it React's rather than the module's. */
 export interface LatticeTabSpec {
+  /**
+   * The tab's identity, used to select it, to name its slot and to derive another tab
+   * from it. Required, non-empty and unique; a duplicate or missing id is refused.
+   */
   id: string;
+  /** The text on the tab button. Defaults to the id. */
   label?: string;
   /** A React element, or a function returning one, rendered through a portal. */
   content?: unknown | (() => unknown);

package/modules/react.esm.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.68.0, react module
+ * Lattice Grid 1.68.1, react module
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */
@@ -52,12 +52,12 @@ Object.defineProperty(__exports,"frameBatched",{enumerable:true,get:function(){r
 Object.defineProperty(__exports,"settleDebounce",{enumerable:true,get:function(){return settleDebounce;}});
 Object.defineProperty(__exports,"whenIdle",{enumerable:true,get:function(){return whenIdle;}});
 Object.defineProperty(__exports,"uid",{enumerable:true,get:function(){return uid;}});
-const STAMPED_VERSION="1.68.0";
+const STAMPED_VERSION="1.68.1";
 async function resolveVersion(){
 if(STAMPED_VERSION!=='0.0.0-source')return STAMPED_VERSION;
 return STAMPED_VERSION;
 }
-const VERSION="1.68.0";
+const VERSION="1.68.1";
 const warned=new Set();
 const WARNED_LIMIT=2000;
 function rememberWarned(key){

package/modules/react.min.cjs

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.68.0, react module
+ * Lattice Grid 1.68.1, react module
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */
@@ -54,12 +54,12 @@ Object.defineProperty(__exports,"frameBatched",{enumerable:true,get:function(){r
 Object.defineProperty(__exports,"settleDebounce",{enumerable:true,get:function(){return settleDebounce;}});
 Object.defineProperty(__exports,"whenIdle",{enumerable:true,get:function(){return whenIdle;}});
 Object.defineProperty(__exports,"uid",{enumerable:true,get:function(){return uid;}});
-const STAMPED_VERSION="1.68.0";
+const STAMPED_VERSION="1.68.1";
 async function resolveVersion(){
 if(STAMPED_VERSION!=='0.0.0-source')return STAMPED_VERSION;
 return STAMPED_VERSION;
 }
-const VERSION="1.68.0";
+const VERSION="1.68.1";
 const warned=new Set();
 const WARNED_LIMIT=2000;
 function rememberWarned(key){

package/modules/react.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.68.0, react module
+ * Lattice Grid 1.68.1, react module
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */
@@ -54,12 +54,12 @@ Object.defineProperty(__exports,"frameBatched",{enumerable:true,get:function(){r
 Object.defineProperty(__exports,"settleDebounce",{enumerable:true,get:function(){return settleDebounce;}});
 Object.defineProperty(__exports,"whenIdle",{enumerable:true,get:function(){return whenIdle;}});
 Object.defineProperty(__exports,"uid",{enumerable:true,get:function(){return uid;}});
-const STAMPED_VERSION="1.68.0";
+const STAMPED_VERSION="1.68.1";
 async function resolveVersion(){
 if(STAMPED_VERSION!=='0.0.0-source')return STAMPED_VERSION;
 return STAMPED_VERSION;
 }
-const VERSION="1.68.0";
+const VERSION="1.68.1";
 const warned=new Set();
 const WARNED_LIMIT=2000;
 function rememberWarned(key){

package/modules/svelte.d.ts

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

package/modules/svelte.esm.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.68.0, svelte module
+ * Lattice Grid 1.68.1, svelte module
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */
@@ -52,12 +52,12 @@ Object.defineProperty(__exports,"frameBatched",{enumerable:true,get:function(){r
 Object.defineProperty(__exports,"settleDebounce",{enumerable:true,get:function(){return settleDebounce;}});
 Object.defineProperty(__exports,"whenIdle",{enumerable:true,get:function(){return whenIdle;}});
 Object.defineProperty(__exports,"uid",{enumerable:true,get:function(){return uid;}});
-const STAMPED_VERSION="1.68.0";
+const STAMPED_VERSION="1.68.1";
 async function resolveVersion(){
 if(STAMPED_VERSION!=='0.0.0-source')return STAMPED_VERSION;
 return STAMPED_VERSION;
 }
-const VERSION="1.68.0";
+const VERSION="1.68.1";
 const warned=new Set();
 const WARNED_LIMIT=2000;
 function rememberWarned(key){

package/modules/svelte.min.cjs

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.68.0, svelte module
+ * Lattice Grid 1.68.1, svelte module
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */
@@ -54,12 +54,12 @@ Object.defineProperty(__exports,"frameBatched",{enumerable:true,get:function(){r
 Object.defineProperty(__exports,"settleDebounce",{enumerable:true,get:function(){return settleDebounce;}});
 Object.defineProperty(__exports,"whenIdle",{enumerable:true,get:function(){return whenIdle;}});
 Object.defineProperty(__exports,"uid",{enumerable:true,get:function(){return uid;}});
-const STAMPED_VERSION="1.68.0";
+const STAMPED_VERSION="1.68.1";
 async function resolveVersion(){
 if(STAMPED_VERSION!=='0.0.0-source')return STAMPED_VERSION;
 return STAMPED_VERSION;
 }
-const VERSION="1.68.0";
+const VERSION="1.68.1";
 const warned=new Set();
 const WARNED_LIMIT=2000;
 function rememberWarned(key){

package/modules/svelte.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.68.0, svelte module
+ * Lattice Grid 1.68.1, svelte module
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */
@@ -54,12 +54,12 @@ Object.defineProperty(__exports,"frameBatched",{enumerable:true,get:function(){r
 Object.defineProperty(__exports,"settleDebounce",{enumerable:true,get:function(){return settleDebounce;}});
 Object.defineProperty(__exports,"whenIdle",{enumerable:true,get:function(){return whenIdle;}});
 Object.defineProperty(__exports,"uid",{enumerable:true,get:function(){return uid;}});
-const STAMPED_VERSION="1.68.0";
+const STAMPED_VERSION="1.68.1";
 async function resolveVersion(){
 if(STAMPED_VERSION!=='0.0.0-source')return STAMPED_VERSION;
 return STAMPED_VERSION;
 }
-const VERSION="1.68.0";
+const VERSION="1.68.1";
 const warned=new Set();
 const WARNED_LIMIT=2000;
 function rememberWarned(key){

package/modules/tabs.d.ts

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.68.0, tabs module type declarations
+ * Lattice Grid 1.68.1, tabs module type declarations
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */
@@ -41,6 +41,7 @@ interface TabDescriptor {
   where?: (row: unknown) => boolean;
   /** Group-by forwarded to the derived source. */
   group?: unknown;
+  /** An alias for `group`, forwarded verbatim to the derived source. */
   groupBy?: unknown;
   /** Time-bucketing forwarded to the derived source. */
   bucket?: unknown;
@@ -72,12 +73,23 @@ interface TabDescriptor {
 
 /** The payload every tab-change event carries. */
 interface TabChangeEvent {
+  /** The tab being switched to. */
   id: string;
+  /** The tab being left, or null for the first activation. */
   previousId: string | null;
+  /**
+   * Who caused the switch: `user` for a click or keypress, `api` for `activate()`, `init`
+   * for the opening tab. Defaults to `user`.
+   */
   origin?: 'api' | 'user' | 'init';
+  /**
+   * Why the switch was refused — the reason given to `preventDefault`, `prevented` when
+   * none was, or `error` when a handler threw.
+   */
   reason?: string | null;
   /** Cancel the switch (only meaningful on `beforeTabChange`). */
   preventDefault?: (reason?: string) => void;
+  /** True once a handler has cancelled the switch. */
   defaultPrevented?: boolean;
 }
 
@@ -95,8 +107,18 @@ interface TabsConfig {
   ariaLabel?: string;
   /** An explicit message-catalogue override; otherwise a mounted tab's own `grid.messages` is used. */
   messages?: { t(key: string, params?: Record<string, unknown>): string };
+  /** Called after the active tab has changed, alongside the `tab:changed` event. */
   onTabChange?: (event: TabChangeEvent) => void;
+  /**
+   * Called before the switch. Return `false`, call `preventDefault(reason)`, or throw, to
+   * stay where you are; return a promise and the switch waits for it. Alongside the
+   * `beforeTabChange` event.
+   */
   onBeforeTabChange?: (event: TabChangeEvent) => boolean | void | Promise<boolean>;
+  /**
+   * Called when a switch was refused, with the reason on the payload. Alongside
+   * `tabChange:cancelled`.
+   */
   onTabChangeCancelled?: (event: TabChangeEvent) => void;
 }
 
@@ -106,6 +128,7 @@ interface TabsConfig {
  * alive, hidden, until `destroy()`.
  */
 interface Tabs {
+  /** The element the strip was mounted on. */
   readonly el: HTMLElement;
   /** The currently active tab id. */
   readonly activeId: string;
@@ -117,7 +140,13 @@ interface Tabs {
   isMounted(id: string): boolean;
   /** Switch the active tab, gated by `beforeTabChange`. */
   activate(id: string, opts?: { origin?: 'api' | 'user' }): boolean | Promise<boolean>;
+  /**
+   * Subscribe to `beforeTabChange`, `tab:changed` or `tabChange:cancelled`; returns a
+   * function that unsubscribes. Any other name is warned about once, because it names a
+   * binding that could never fire.
+   */
   on(name: 'beforeTabChange' | 'tab:changed' | 'tabChange:cancelled' | string, fn: (event: TabChangeEvent) => void): () => void;
+  /** Remove a handler registered with `on`. */
   off(name: string, fn: (event: TabChangeEvent) => void): void;
   /** Tear the whole strip down; destroys every mounted tab's grid. */
   destroy(): void;

package/modules/tabs.esm.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.68.0, tabs module
+ * Lattice Grid 1.68.1, tabs module
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */
@@ -52,12 +52,12 @@ Object.defineProperty(__exports,"frameBatched",{enumerable:true,get:function(){r
 Object.defineProperty(__exports,"settleDebounce",{enumerable:true,get:function(){return settleDebounce;}});
 Object.defineProperty(__exports,"whenIdle",{enumerable:true,get:function(){return whenIdle;}});
 Object.defineProperty(__exports,"uid",{enumerable:true,get:function(){return uid;}});
-const STAMPED_VERSION="1.68.0";
+const STAMPED_VERSION="1.68.1";
 async function resolveVersion(){
 if(STAMPED_VERSION!=='0.0.0-source')return STAMPED_VERSION;
 return STAMPED_VERSION;
 }
-const VERSION="1.68.0";
+const VERSION="1.68.1";
 const warned=new Set();
 const WARNED_LIMIT=2000;
 function rememberWarned(key){

package/modules/tabs.min.cjs

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.68.0, tabs module
+ * Lattice Grid 1.68.1, tabs module
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */
@@ -54,12 +54,12 @@ Object.defineProperty(__exports,"frameBatched",{enumerable:true,get:function(){r
 Object.defineProperty(__exports,"settleDebounce",{enumerable:true,get:function(){return settleDebounce;}});
 Object.defineProperty(__exports,"whenIdle",{enumerable:true,get:function(){return whenIdle;}});
 Object.defineProperty(__exports,"uid",{enumerable:true,get:function(){return uid;}});
-const STAMPED_VERSION="1.68.0";
+const STAMPED_VERSION="1.68.1";
 async function resolveVersion(){
 if(STAMPED_VERSION!=='0.0.0-source')return STAMPED_VERSION;
 return STAMPED_VERSION;
 }
-const VERSION="1.68.0";
+const VERSION="1.68.1";
 const warned=new Set();
 const WARNED_LIMIT=2000;
 function rememberWarned(key){

package/modules/tabs.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.68.0, tabs module
+ * Lattice Grid 1.68.1, tabs module
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */
@@ -54,12 +54,12 @@ Object.defineProperty(__exports,"frameBatched",{enumerable:true,get:function(){r
 Object.defineProperty(__exports,"settleDebounce",{enumerable:true,get:function(){return settleDebounce;}});
 Object.defineProperty(__exports,"whenIdle",{enumerable:true,get:function(){return whenIdle;}});
 Object.defineProperty(__exports,"uid",{enumerable:true,get:function(){return uid;}});
-const STAMPED_VERSION="1.68.0";
+const STAMPED_VERSION="1.68.1";
 async function resolveVersion(){
 if(STAMPED_VERSION!=='0.0.0-source')return STAMPED_VERSION;
 return STAMPED_VERSION;
 }
-const VERSION="1.68.0";
+const VERSION="1.68.1";
 const warned=new Set();
 const WARNED_LIMIT=2000;
 function rememberWarned(key){

package/modules/vue.d.ts

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.68.0, vue module type declarations
+ * Lattice Grid 1.68.1, vue module type declarations
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */
@@ -143,6 +143,7 @@ export type LatticeVueGridEmit = {
 
 /** What a `<LatticeGrid>` template ref exposes; `grid()` is null before mount. */
 export interface LatticeVueGridExposed {
+  /** The live grid the component built, or null before mount. */
   grid(): Grid | null;
 }
 
@@ -190,6 +191,7 @@ export type LatticeVueViewerCommonProps = LatticeVueHostProps & {
 
 /** What a viewer's template ref exposes; `instance()` is null before mount. */
 export interface LatticeVueViewerExposed<Instance = unknown> {
+  /** The live viewer the component built, or null before mount. */
   instance(): Instance | null;
 }
 
@@ -233,7 +235,12 @@ export type LatticeVueLayoutProps = Record<string, unknown> & LatticeVueViewerCo
 
 /** One tab of a `<LatticeTabs>`; a slot named for its `id` makes it Vue's. */
 export interface LatticeVueTabSpec {
+  /**
+   * The tab's identity, which also names the slot whose content Vue renders into the
+   * panel. Required, non-empty and unique.
+   */
   id: string;
+  /** The text on the tab button. Defaults to the id. */
   label?: string;
   [key: string]: unknown;
 }

package/modules/vue.esm.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.68.0, vue module
+ * Lattice Grid 1.68.1, vue module
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */
@@ -52,12 +52,12 @@ Object.defineProperty(__exports,"frameBatched",{enumerable:true,get:function(){r
 Object.defineProperty(__exports,"settleDebounce",{enumerable:true,get:function(){return settleDebounce;}});
 Object.defineProperty(__exports,"whenIdle",{enumerable:true,get:function(){return whenIdle;}});
 Object.defineProperty(__exports,"uid",{enumerable:true,get:function(){return uid;}});
-const STAMPED_VERSION="1.68.0";
+const STAMPED_VERSION="1.68.1";
 async function resolveVersion(){
 if(STAMPED_VERSION!=='0.0.0-source')return STAMPED_VERSION;
 return STAMPED_VERSION;
 }
-const VERSION="1.68.0";
+const VERSION="1.68.1";
 const warned=new Set();
 const WARNED_LIMIT=2000;
 function rememberWarned(key){

package/modules/vue.min.cjs

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.68.0, vue module
+ * Lattice Grid 1.68.1, vue module
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */
@@ -54,12 +54,12 @@ Object.defineProperty(__exports,"frameBatched",{enumerable:true,get:function(){r
 Object.defineProperty(__exports,"settleDebounce",{enumerable:true,get:function(){return settleDebounce;}});
 Object.defineProperty(__exports,"whenIdle",{enumerable:true,get:function(){return whenIdle;}});
 Object.defineProperty(__exports,"uid",{enumerable:true,get:function(){return uid;}});
-const STAMPED_VERSION="1.68.0";
+const STAMPED_VERSION="1.68.1";
 async function resolveVersion(){
 if(STAMPED_VERSION!=='0.0.0-source')return STAMPED_VERSION;
 return STAMPED_VERSION;
 }
-const VERSION="1.68.0";
+const VERSION="1.68.1";
 const warned=new Set();
 const WARNED_LIMIT=2000;
 function rememberWarned(key){

package/modules/vue.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.68.0, vue module
+ * Lattice Grid 1.68.1, vue module
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */
@@ -54,12 +54,12 @@ Object.defineProperty(__exports,"frameBatched",{enumerable:true,get:function(){r
 Object.defineProperty(__exports,"settleDebounce",{enumerable:true,get:function(){return settleDebounce;}});
 Object.defineProperty(__exports,"whenIdle",{enumerable:true,get:function(){return whenIdle;}});
 Object.defineProperty(__exports,"uid",{enumerable:true,get:function(){return uid;}});
-const STAMPED_VERSION="1.68.0";
+const STAMPED_VERSION="1.68.1";
 async function resolveVersion(){
 if(STAMPED_VERSION!=='0.0.0-source')return STAMPED_VERSION;
 return STAMPED_VERSION;
 }
-const VERSION="1.68.0";
+const VERSION="1.68.1";
 const warned=new Set();
 const WARNED_LIMIT=2000;
 function rememberWarned(key){