@toclocoinc/lattice-grid 1.67.0 → 1.68.1

package/modules/tabs.d.ts

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.67.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.67.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.67.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.67.0";
+const VERSION="1.68.1";
 const warned=new Set();
 const WARNED_LIMIT=2000;
 function rememberWarned(key){
@@ -499,7 +499,7 @@ const style=doc.createElement('style');
 style.id=`${NS}-styles`;
 style.setAttribute('id',`${NS}-styles`);
 style.textContent=`
-.${NS}{display:flex;flex-direction:column;height:100%;
+:where(.${NS}){display:flex;flex-direction:column;height:100%;
   font-family:var(--${NS}-font-family,var(--lattice-font-family,var(--lat-chrome-font-family,system-ui,-apple-system,"Segoe UI",Roboto,Helvetica,Arial,sans-serif)));
   font-size:var(--${NS}-font-size,var(--lattice-font-size,var(--lat-chrome-font-size,13px)));
   line-height:var(--${NS}-line-height,var(--lattice-line-height,var(--lat-chrome-line-height,1.4)))}
@@ -512,12 +512,12 @@ style.textContent=`
   padding:var(--${NS}-pad-y,5px) var(--${NS}-pad-x,12px);cursor:pointer;color:var(--${NS}-muted,#586069)}
 .${NS} .${NS}__tab + .${NS}__tab{border-left:1px solid var(--${NS}-separator,#e7eaee)}
 .${NS} .${NS}__tab:hover{background:var(--${NS}-hover,#ebeef1)}
-.${NS} .${NS}__tab:focus-visible{outline:2px solid var(--${NS}-focus,#2563eb);outline-offset:var(--${NS}-focus-offset,-4px)}
+:where(.${NS} .${NS}__tab:focus-visible){outline:2px solid var(--${NS}-focus,#2563eb);outline-offset:var(--${NS}-focus-offset,-4px)}
 .${NS} .${NS}__tab[aria-selected="true"]{background:var(--${NS}-bg,#fff);color:var(--${NS}-active,#14171a);font-weight:600;
   margin-bottom:-1px;padding-bottom:calc(var(--${NS}-pad-y,5px) + 1px);
   box-shadow:inset 0 calc(-1 * var(--${NS}-accent-width,2px)) 0 0 var(--${NS}-accent,#1a6bc7)}
-.${NS} .${NS}__icon{flex:none;display:inline-flex;align-items:center;justify-content:center;line-height:1}
-.${NS} .${NS}__label{min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
+:where(.${NS} .${NS}__icon){flex:none;display:inline-flex;align-items:center;justify-content:center;line-height:1}
+:where(.${NS} .${NS}__label){min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
 .${NS} .${NS}__badge{flex:none;display:inline-flex;align-items:center;justify-content:center;
   min-width:var(--${NS}-badge-size,1.5em);padding:0 var(--${NS}-badge-pad,0.4em);
   border-radius:var(--${NS}-badge-radius,999px);font-size:var(--${NS}-badge-font-size,0.85em);
@@ -528,19 +528,18 @@ style.textContent=`
 .${NS} .${NS}__badge[data-tone="bad"]{background:var(--${NS}-badge-bad-bg,#fbe0e0);color:var(--${NS}-badge-bad-fg,#8a1c1c)}
 .${NS} .${NS}__badge[data-tone="unknown"]{background:none;color:var(--${NS}-badge-unknown-fg,#586069);
   box-shadow:inset 0 0 0 1px var(--${NS}-badge-unknown-edge,#c3c9d0)}
-.${NS}__unit{position:absolute;width:1px;height:1px;overflow:hidden;clip:rect(0 0 0 0);white-space:nowrap}
-.${NS}__panels{position:relative;flex:1 1 auto;min-height:0}
-.${NS}__panel{position:absolute;inset:0}
-.${NS}__panel[hidden]{display:none}
-.${NS}__body{position:absolute;inset:0}
-.${NS}__live{position:absolute;width:1px;height:1px;overflow:hidden;clip:rect(0 0 0 0);white-space:nowrap}
+:where(.${NS}__unit){position:absolute;width:1px;height:1px;overflow:hidden;clip:rect(0 0 0 0);white-space:nowrap}
+:where(.${NS}__panels){position:relative;flex:1 1 auto;min-height:0}
+:where(.${NS}__panel){position:absolute;inset:0}
+:where(.${NS}__panel[hidden]){display:none}
+:where(.${NS}__body){position:absolute;inset:0}
+:where(.${NS}__live){position:absolute;width:1px;height:1px;overflow:hidden;clip:rect(0 0 0 0);white-space:nowrap}
 `;
 (doc.head||doc.documentElement).appendChild(style);
 }
 function renderShell(state){
 const{doc,el,order}=state;
 injectStyles(doc);
-el.classList.add(NS);
 const root=doc.createElement('div');
 root.className=NS;
 const list=doc.createElement('div');

package/modules/tabs.min.cjs

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.67.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.67.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.67.0";
+const VERSION="1.68.1";
 const warned=new Set();
 const WARNED_LIMIT=2000;
 function rememberWarned(key){
@@ -501,7 +501,7 @@ const style=doc.createElement('style');
 style.id=`${NS}-styles`;
 style.setAttribute('id',`${NS}-styles`);
 style.textContent=`
-.${NS}{display:flex;flex-direction:column;height:100%;
+:where(.${NS}){display:flex;flex-direction:column;height:100%;
   font-family:var(--${NS}-font-family,var(--lattice-font-family,var(--lat-chrome-font-family,system-ui,-apple-system,"Segoe UI",Roboto,Helvetica,Arial,sans-serif)));
   font-size:var(--${NS}-font-size,var(--lattice-font-size,var(--lat-chrome-font-size,13px)));
   line-height:var(--${NS}-line-height,var(--lattice-line-height,var(--lat-chrome-line-height,1.4)))}
@@ -514,12 +514,12 @@ style.textContent=`
   padding:var(--${NS}-pad-y,5px) var(--${NS}-pad-x,12px);cursor:pointer;color:var(--${NS}-muted,#586069)}
 .${NS} .${NS}__tab + .${NS}__tab{border-left:1px solid var(--${NS}-separator,#e7eaee)}
 .${NS} .${NS}__tab:hover{background:var(--${NS}-hover,#ebeef1)}
-.${NS} .${NS}__tab:focus-visible{outline:2px solid var(--${NS}-focus,#2563eb);outline-offset:var(--${NS}-focus-offset,-4px)}
+:where(.${NS} .${NS}__tab:focus-visible){outline:2px solid var(--${NS}-focus,#2563eb);outline-offset:var(--${NS}-focus-offset,-4px)}
 .${NS} .${NS}__tab[aria-selected="true"]{background:var(--${NS}-bg,#fff);color:var(--${NS}-active,#14171a);font-weight:600;
   margin-bottom:-1px;padding-bottom:calc(var(--${NS}-pad-y,5px) + 1px);
   box-shadow:inset 0 calc(-1 * var(--${NS}-accent-width,2px)) 0 0 var(--${NS}-accent,#1a6bc7)}
-.${NS} .${NS}__icon{flex:none;display:inline-flex;align-items:center;justify-content:center;line-height:1}
-.${NS} .${NS}__label{min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
+:where(.${NS} .${NS}__icon){flex:none;display:inline-flex;align-items:center;justify-content:center;line-height:1}
+:where(.${NS} .${NS}__label){min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
 .${NS} .${NS}__badge{flex:none;display:inline-flex;align-items:center;justify-content:center;
   min-width:var(--${NS}-badge-size,1.5em);padding:0 var(--${NS}-badge-pad,0.4em);
   border-radius:var(--${NS}-badge-radius,999px);font-size:var(--${NS}-badge-font-size,0.85em);
@@ -530,19 +530,18 @@ style.textContent=`
 .${NS} .${NS}__badge[data-tone="bad"]{background:var(--${NS}-badge-bad-bg,#fbe0e0);color:var(--${NS}-badge-bad-fg,#8a1c1c)}
 .${NS} .${NS}__badge[data-tone="unknown"]{background:none;color:var(--${NS}-badge-unknown-fg,#586069);
   box-shadow:inset 0 0 0 1px var(--${NS}-badge-unknown-edge,#c3c9d0)}
-.${NS}__unit{position:absolute;width:1px;height:1px;overflow:hidden;clip:rect(0 0 0 0);white-space:nowrap}
-.${NS}__panels{position:relative;flex:1 1 auto;min-height:0}
-.${NS}__panel{position:absolute;inset:0}
-.${NS}__panel[hidden]{display:none}
-.${NS}__body{position:absolute;inset:0}
-.${NS}__live{position:absolute;width:1px;height:1px;overflow:hidden;clip:rect(0 0 0 0);white-space:nowrap}
+:where(.${NS}__unit){position:absolute;width:1px;height:1px;overflow:hidden;clip:rect(0 0 0 0);white-space:nowrap}
+:where(.${NS}__panels){position:relative;flex:1 1 auto;min-height:0}
+:where(.${NS}__panel){position:absolute;inset:0}
+:where(.${NS}__panel[hidden]){display:none}
+:where(.${NS}__body){position:absolute;inset:0}
+:where(.${NS}__live){position:absolute;width:1px;height:1px;overflow:hidden;clip:rect(0 0 0 0);white-space:nowrap}
 `;
 (doc.head||doc.documentElement).appendChild(style);
 }
 function renderShell(state){
 const{doc,el,order}=state;
 injectStyles(doc);
-el.classList.add(NS);
 const root=doc.createElement('div');
 root.className=NS;
 const list=doc.createElement('div');

package/modules/tabs.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.67.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.67.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.67.0";
+const VERSION="1.68.1";
 const warned=new Set();
 const WARNED_LIMIT=2000;
 function rememberWarned(key){
@@ -501,7 +501,7 @@ const style=doc.createElement('style');
 style.id=`${NS}-styles`;
 style.setAttribute('id',`${NS}-styles`);
 style.textContent=`
-.${NS}{display:flex;flex-direction:column;height:100%;
+:where(.${NS}){display:flex;flex-direction:column;height:100%;
   font-family:var(--${NS}-font-family,var(--lattice-font-family,var(--lat-chrome-font-family,system-ui,-apple-system,"Segoe UI",Roboto,Helvetica,Arial,sans-serif)));
   font-size:var(--${NS}-font-size,var(--lattice-font-size,var(--lat-chrome-font-size,13px)));
   line-height:var(--${NS}-line-height,var(--lattice-line-height,var(--lat-chrome-line-height,1.4)))}
@@ -514,12 +514,12 @@ style.textContent=`
   padding:var(--${NS}-pad-y,5px) var(--${NS}-pad-x,12px);cursor:pointer;color:var(--${NS}-muted,#586069)}
 .${NS} .${NS}__tab + .${NS}__tab{border-left:1px solid var(--${NS}-separator,#e7eaee)}
 .${NS} .${NS}__tab:hover{background:var(--${NS}-hover,#ebeef1)}
-.${NS} .${NS}__tab:focus-visible{outline:2px solid var(--${NS}-focus,#2563eb);outline-offset:var(--${NS}-focus-offset,-4px)}
+:where(.${NS} .${NS}__tab:focus-visible){outline:2px solid var(--${NS}-focus,#2563eb);outline-offset:var(--${NS}-focus-offset,-4px)}
 .${NS} .${NS}__tab[aria-selected="true"]{background:var(--${NS}-bg,#fff);color:var(--${NS}-active,#14171a);font-weight:600;
   margin-bottom:-1px;padding-bottom:calc(var(--${NS}-pad-y,5px) + 1px);
   box-shadow:inset 0 calc(-1 * var(--${NS}-accent-width,2px)) 0 0 var(--${NS}-accent,#1a6bc7)}
-.${NS} .${NS}__icon{flex:none;display:inline-flex;align-items:center;justify-content:center;line-height:1}
-.${NS} .${NS}__label{min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
+:where(.${NS} .${NS}__icon){flex:none;display:inline-flex;align-items:center;justify-content:center;line-height:1}
+:where(.${NS} .${NS}__label){min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
 .${NS} .${NS}__badge{flex:none;display:inline-flex;align-items:center;justify-content:center;
   min-width:var(--${NS}-badge-size,1.5em);padding:0 var(--${NS}-badge-pad,0.4em);
   border-radius:var(--${NS}-badge-radius,999px);font-size:var(--${NS}-badge-font-size,0.85em);
@@ -530,19 +530,18 @@ style.textContent=`
 .${NS} .${NS}__badge[data-tone="bad"]{background:var(--${NS}-badge-bad-bg,#fbe0e0);color:var(--${NS}-badge-bad-fg,#8a1c1c)}
 .${NS} .${NS}__badge[data-tone="unknown"]{background:none;color:var(--${NS}-badge-unknown-fg,#586069);
   box-shadow:inset 0 0 0 1px var(--${NS}-badge-unknown-edge,#c3c9d0)}
-.${NS}__unit{position:absolute;width:1px;height:1px;overflow:hidden;clip:rect(0 0 0 0);white-space:nowrap}
-.${NS}__panels{position:relative;flex:1 1 auto;min-height:0}
-.${NS}__panel{position:absolute;inset:0}
-.${NS}__panel[hidden]{display:none}
-.${NS}__body{position:absolute;inset:0}
-.${NS}__live{position:absolute;width:1px;height:1px;overflow:hidden;clip:rect(0 0 0 0);white-space:nowrap}
+:where(.${NS}__unit){position:absolute;width:1px;height:1px;overflow:hidden;clip:rect(0 0 0 0);white-space:nowrap}
+:where(.${NS}__panels){position:relative;flex:1 1 auto;min-height:0}
+:where(.${NS}__panel){position:absolute;inset:0}
+:where(.${NS}__panel[hidden]){display:none}
+:where(.${NS}__body){position:absolute;inset:0}
+:where(.${NS}__live){position:absolute;width:1px;height:1px;overflow:hidden;clip:rect(0 0 0 0);white-space:nowrap}
 `;
 (doc.head||doc.documentElement).appendChild(style);
 }
 function renderShell(state){
 const{doc,el,order}=state;
 injectStyles(doc);
-el.classList.add(NS);
 const root=doc.createElement('div');
 root.className=NS;
 const list=doc.createElement('div');

package/modules/vue.d.ts

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.67.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.67.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.67.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.67.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.67.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.67.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.67.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.67.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.67.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.67.0";
+const VERSION="1.68.1";
 const warned=new Set();
 const WARNED_LIMIT=2000;
 function rememberWarned(key){

package/modules/webcomponent.d.ts

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.67.0, webcomponent module type declarations
+ * Lattice Grid 1.68.1, webcomponent module type declarations
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */
@@ -70,12 +70,34 @@ export interface LatticeViewerEventDetail<Instance = unknown> { instance: Instan
 export interface LatticeGridElement<Row = any> extends HTMLElement {
   /** Every attribute in the table above is also a property of the same name. */
   theme: string | undefined;
+  /**
+   * The row height and padding as a named step, rather than pixel by pixel. The `density`
+   * attribute.
+   */
   density: string | undefined;
+  /** The locale the grid formats and sorts in. The `locale` attribute. */
   locale: string | undefined;
+  /**
+   * Which field identifies a row. As an attribute it can only be a field name; the
+   * composite and function forms are properties.
+   */
   rowKey: string | undefined;
+  /** Row height in pixels. The `row-height` attribute, parsed as a number. */
   rowHeight: number | undefined;
+  /**
+   * Header height in pixels. The `header-height` attribute, parsed as a number; unset,
+   * the header follows the density token.
+   */
   headerHeight: number | undefined;
+  /**
+   * Let the grid grow to its rows rather than capping its height. The `auto-height`
+   * attribute is a bare boolean — present is true.
+   */
   autoHeight: boolean | undefined;
+  /**
+   * What the reader may select: `single`, `multiple` or `none`. The `selection`
+   * attribute; the full selection config goes through `config`.
+   */
   selection: string | undefined;
   /** The live grid, or null while the element is disconnected. */
   readonly grid: Grid | null;
@@ -122,64 +144,150 @@ export interface LatticeViewerElement<Instance = unknown> extends HTMLElement {
  * empty; give it `rows` for a standalone panel.
  */
 export interface LatticeKPIElement<Row = any> extends LatticeViewerElement {
+  /** The panel's tiles. A structure, so it is a property rather than an attribute. */
   tiles: unknown[];
+  /** Rows for a standalone panel. Set them and the element stops waiting for a grid. */
   rows: Row[];
+  /** How many tile columns to aim for. */
   columns: number | undefined;
+  /** Which field identifies a row, for the panel's own keyed store. */
   rowKey: string | undefined;
+  /** The default locale a clock tile formats in. */
   locale: string | undefined;
+  /**
+   * Passed to the panel as `theme`, which the panel does not read — it mirrors the
+   * theme of the grid it is mounted beside, and otherwise follows the page's tokens.
+   */
   theme: string | undefined;
+  /**
+   * Passed to the panel as `density`, which the panel does not read — density is
+   * mirrored from the grid the panel belongs to.
+   */
   density: string | undefined;
+  /**
+   * Passed to the panel as `format`, which the panel does not read — formatting is
+   * per tile (`tiles: [{ format }]`).
+   */
   format: unknown;
 }
 
 /** `<lattice-chart>`. Always drawn from a grid, so it waits for one. */
 export interface LatticeChartElement extends LatticeViewerElement {
+  /**
+   * A geomap's geometry: a loaded pack, `{ pack: id }`, GeoJSON, or a map of code to path
+   * data. A structure, so it is a property.
+   */
   shapes: unknown;
+  /** The column that splits the measure into one series per distinct value. */
   series: unknown;
+  /**
+   * Passed to the chart as `data`, which the chart does not read — a chart draws the
+   * grid's own filtered rows. Use the grid's rows, or the chart spec's `rows`, through
+   * `config`.
+   */
   data: unknown;
+  /**
+   * Passed to the chart as `formatting`, which the chart does not read — a chart formats
+   * through the grid's own formatting and each column's type.
+   */
   formatting: unknown;
+  /** Which chart to draw. The `type` attribute. */
   type: string | undefined;
+  /** The category column. */
   x: string | undefined;
+  /** The measure column, or several for a multi-measure chart. */
   y: string | string[] | undefined;
+  /** The measure a markermap writes beside each dot and colours it by. */
   value: string | undefined;
+  /** The row-label column, for the types that name their rows. */
   label: string | undefined;
+  /** The longitude column, in degrees east, for the maps that place a row by where it is. */
   lon: string | undefined;
+  /** The latitude column, in degrees north. */
   lat: string | undefined;
+  /** Print the value beside each mark. The `labels` attribute is a bare boolean. */
   labels: boolean | undefined;
+  /**
+   * Passed to the chart as `stacked`, which the chart does not read — its own option is
+   * `stack`, reachable through `config`.
+   */
   stacked: boolean | undefined;
+  /**
+   * Passed to the chart as `horizontal`, which the chart does not read — orientation
+   * follows the chart type (`horizontalBar` and the row-named types draw along y).
+   */
   horizontal: boolean | undefined;
+  /** The colour scheme by name. */
   scheme: string | undefined;
 }
 
 /** `<lattice-kanban>`. Grid-bound like the KPI panel; give it `rows` to stand alone. */
 export interface LatticeKanbanElement<Row = any> extends LatticeViewerElement {
+  /** Rows for a standalone board. Set them and the element stops waiting for a grid. */
   rows: Row[];
+  /** The board's column definitions. */
   columns: unknown[];
+  /** The card template's field mapping — title, subtitle, labels, assignee and the rest. */
   card: unknown;
+  /**
+   * Passed to the board as `facets`, which the board does not read — filter it with
+   * `filter`, `quickFilter`, `setSprint` or `setEpic` instead.
+   */
   facets: unknown;
+  /** Which field identifies a card. */
   rowKey: string | undefined;
+  /** The row property that puts a card in a column. */
   columnProperty: string | undefined;
+  /**
+   * Passed to the board as `titleProperty`, which the board does not read — map the
+   * card's headline through `card` (`card: { title: 'name' }`).
+   */
   titleProperty: string | undefined;
+  /**
+   * Draw the two-dimensional swimlane layout. The `swimlanes` attribute is a bare
+   * boolean; name the lane property through `swimlane-property`.
+   */
   swimlanes: boolean | undefined;
 }
 
 /** `<lattice-gantt>`. */
 export interface LatticeGanttElement extends LatticeViewerElement {
+  /** The plan's tasks. A structure, so it is a property. */
   tasks: unknown[];
+  /** The links between tasks. */
   dependencies: unknown[];
+  /** The resource capacities, for over-allocation and levelling. */
   resources: unknown;
+  /** The working-time calendar: the `weekends` preset, or explicit workdays and holidays. */
   calendar: unknown;
+  /** The table panel's columns, for the split view. */
   columns: unknown;
+  /** Which field identifies a task. */
   rowKey: string | undefined;
+  /**
+   * Passed to the plan as `scale`, which it does not read — the timeline's zoom is a
+   * render option, set through `config: { render: { zoom } }`.
+   */
   scale: string | undefined;
+  /**
+   * Cascade an edit down the dependency chain rather than only recomputing. A bare
+   * boolean attribute.
+   */
   autoSchedule: boolean | undefined;
 }
 
 /** `<lattice-layout>`. */
 export interface LatticeLayoutElement extends LatticeViewerElement {
+  /**
+   * The windows to place, each with its content and its cell. A structure, so it is a
+   * property.
+   */
   windows: unknown[];
+  /** How many columns the grid of windows has. */
   columns: number | undefined;
+  /** How many rows the grid of windows has. */
   rows: number | undefined;
+  /** Which way windows collapse into the space a closed one left. */
   compact: string | undefined;
 }
 
@@ -189,6 +297,10 @@ export interface LatticeLayoutElement extends LatticeViewerElement {
  * left to the module.
  */
 export interface LatticeTabsElement extends LatticeViewerElement {
+  /**
+   * The tab descriptors. A tab's content comes from a `<template data-tab="‹id›">` child
+   * when there is one.
+   */
   tabs: unknown[];
 }