@toclocoinc/lattice-grid 1.68.0 → 1.68.1

package/modules/kpi.d.ts

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.68.0, kpi module type declarations
+ * Lattice Grid 1.68.1, kpi module type declarations
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */
@@ -20,21 +20,47 @@ type KPIFormat =
  * below it critical; `lowerIsBetter` mirrors it. Colour is a host concern.
  */
 interface KPIThresholds {
+  /**
+   * The cut point between good and warning. With the default `higherIsBetter`, a value at
+   * or above it is good.
+   */
   warn: number;
+  /**
+   * The cut point between warning and critical. With `higherIsBetter`, a value at or
+   * above it (but below `warn`) is a warning and anything below it is critical.
+   */
   critical: number;
+  /**
+   * Which way is good. `higherIsBetter` (the default) grades upwards from the cut points;
+   * `lowerIsBetter` mirrors them, so a small value is the healthy one.
+   */
   direction?: 'higherIsBetter' | 'lowerIsBetter';
 }
 
 /** An explicit band: the `status` of the first band whose half-open `[min, max)` contains the value. */
 interface KPIBand {
+  /** The lower bound, inclusive. Omitted, the band reaches down without limit. */
   min?: number;
+  /** The upper bound, exclusive. Omitted, the band reaches up without limit. */
   max?: number;
+  /**
+   * The status a value inside this band reports. The first matching band in the list
+   * wins, so order them from the narrowest.
+   */
   status: 'good' | 'warn' | 'critical';
 }
 
 /** An optional sparkline series: the `y` field plotted in order of the `x` field (or insertion). */
 interface KPISparkline {
+  /**
+   * The field the points are ordered by. Omitted, the rows are plotted in the order the
+   * panel holds them.
+   */
   x?: string;
+  /**
+   * The value plotted — a field name or a function of the row. Anything that is not a
+   * finite number is dropped, and a series with no finite points renders no sparkline.
+   */
   y: string | ((row: KPIRow) => unknown);
 }
 
@@ -165,18 +191,37 @@ interface KPINodeModel {
   key: string;
   /** The tile id, or null on a synthesised level. */
   id: string | null;
+  /**
+   * What the node is called: the tile's own label, or the path segment a synthesised
+   * level came from.
+   */
   label: string;
   /** Depth, 0 at the top level. */
   level: number;
   /** Its place among its siblings, from 1, and how many there are. */
   posinset: number;
+  /**
+   * How many siblings the node sits among — the other half of the screen-reader's "3 of
+   * 7".
+   */
   setsize: number;
+  /** Whether the node has anything beneath it. A leaf is never expandable. */
   hasChildren: boolean;
+  /**
+   * Whether the branch is currently open. Always false for a leaf; a collapsed branch's
+   * children are not rendered, because its worst status is already on the node that is.
+   */
   expanded: boolean;
+  /** The node's children, in order, each a full node model. */
   children: KPINodeModel[];
   /** The node's own tile, or null on a synthesised level. */
   tile: KPITileModel | null;
+  /**
+   * The node's own reading, from its tile. Null on a synthesised level — no value is
+   * invented for a branch from its children.
+   */
   value: unknown;
+  /** The node's reading as text, formatted by its tile. Null on a synthesised level. */
   formatted: string | null;
   /** The node's own status. */
   status: 'good' | 'warn' | 'critical' | 'unknown' | null;
@@ -190,11 +235,21 @@ interface KPINodeModel {
 
 /** A computed tile, as it appears in the model. */
 interface KPITileModel {
+  /** The tile's identity — its configured `id`, else its label, else its index. */
   id: string;
+  /** The tile's accessible name, as configured. */
   label: string;
   /** `'stat'` for an aggregate tile, `'clock'` for a clock tile. */
   kind: 'stat' | 'clock';
+  /**
+   * How the value was reduced: `sum`, `avg`, `min`, `max`, `count`, `countDistinct` or
+   * `custom`.
+   */
   aggregation: string;
+  /**
+   * The row field the aggregation read. Undefined for a `count` or custom tile that names
+   * none, and on a clock tile.
+   */
   field?: string;
   /** For a clock tile, the read instant as epoch milliseconds. */
   value: unknown;
@@ -216,27 +271,64 @@ interface KPITileModel {
    * normally. `null` means the tile has no thresholds or bands configured.
    */
   status: 'good' | 'warn' | 'critical' | 'unknown' | null;
+  /**
+   * The tile's target, as configured. It also extends the meter's scale when it falls
+   * outside the bands. Undefined on a clock tile.
+   */
   target?: number;
+  /** The comparison value the movement line is measured from, as configured. */
   baseline?: number;
+  /** `value − baseline`. Null when the tile has no baseline or measured no number. */
   delta: number | null;
+  /**
+   * The delta as a fraction of the baseline. Null when there is no delta, and when the
+   * baseline is zero — a percentage of nothing is not reported as infinity.
+   */
   deltaPercent: number | null;
+  /**
+   * The delta rendered with the tile's own number format. Undefined when there is no
+   * delta.
+   */
   deltaFormatted?: string;
   /** What the movement line prints; see `KPIStatTile.delta`. Always present once `baseline` is. */
   deltaMode?: 'absolute' | 'relative' | 'both';
+  /**
+   * How many of the panel's rows this tile's filter admitted — its own membership, which
+   * may be 0 while the panel holds rows. Always 0 on a clock tile.
+   */
   count: number;
+  /**
+   * The tile's trend series, as the finite numbers it plots, in `x` order. Null when the
+   * tile declares no sparkline and when no row yielded a finite value.
+   */
   sparkline: number[] | null;
 }
 
 /** The payload every tile event carries. */
 interface KPIEvent {
+  /** The tile model the event is about. */
   tile: KPITileModel;
+  /** That tile's id, for a host that only needs to switch on it. */
   id: string;
+  /**
+   * The DOM event behind this one — a click, double-click, context-menu gesture or the
+   * Enter/Space keypress that stands in for a click.
+   */
   originalEvent?: unknown;
 }
 
 /** KPI panel configuration. */
 interface KPIConfig {
+  /**
+   * The rows the tiles reduce over. Use this or `grid`; passing both leaves the panel on
+   * the array.
+   */
   rows?: KPIRow[];
+  /**
+   * A Lattice grid to follow instead of `rows`: the panel reads the grid's displayed rows
+   * and re-reads them whenever the grid settles, so it never disagrees with the table
+   * beneath it. On a bound panel `rows.apply` and `setRows` are ignored with a warning.
+   */
   grid?: unknown;
   /**
    * Row identity (a field or fn, returning a string or number); default
@@ -253,9 +345,20 @@ interface KPIConfig {
    * confident zero. Ignored on a panel over a plain `rows` array.
    */
   fields?: string[];
+  /** The tiles to show, in display order: aggregate stat tiles, or clock tiles. */
   tiles?: KPITile[];
+  /**
+   * How many tile columns to aim for. Tiles shrink to fit rather than overflow the host,
+   * so a narrow panel settles on fewer. Unset, the layout fits as many as the width
+   * allows.
+   */
   columns?: number;
+  /** The panel's accessible name. Unset, the panel carries none. */
   ariaLabel?: string;
+  /**
+   * The placeholder printed where a tile has no number — an unknown tile, or one whose
+   * aggregation returned nothing. Defaults to an em dash.
+   */
   nullText?: string;
   /**
    * The default locale a clock tile formats in when the tile itself declares
@@ -276,17 +379,41 @@ interface KPIConfig {
    * the shape; a key it does not carry falls back to English.
    */
   messages?: { t(key: string, params?: Record<string, unknown>): string };
+  /**
+   * Called when a tile is clicked (or activated from the keyboard), with the same payload
+   * as the `tile:click` event. Both fire.
+   */
   onTileClick?: (event: KPIEvent) => void;
+  /** Called when a tile is double-clicked, alongside the `tile:dblclick` event. */
   onTileDblClick?: (event: KPIEvent) => void;
+  /** Called on a tile's context-menu gesture, alongside the `tile:contextmenu` event. */
   onTileContextMenu?: (event: KPIEvent) => void;
+  /**
+   * Called when a branch of a hierarchical panel opens or closes, with the node's key,
+   * its new state and the node model. Alongside the `node:toggle` event.
+   */
   onNodeToggle?: (event: { key: string; expanded: boolean; node?: KPINodeModel }) => void;
+  /**
+   * Called after every recompute, with the freshly built model — the hook for mirroring
+   * the panel's numbers somewhere else. Alongside the `change` event.
+   */
   onChange?: (event: { model: { tiles: KPITileModel[]; nodes?: KPINodeModel[] } }) => void;
 }
 
 /** The keyed-diff consumer surface a KPI panel shares with a grid, so a Data Router routes to it directly. */
 interface KPIRows {
+  /**
+   * Apply a keyed diff: `add` and `update` upsert a row by its key, `remove` drops one.
+   * Only the rows in the diff touch each tile's running total, so a live feed costs
+   * nothing per unchanged row. Ignored with a warning on a grid-bound panel.
+   */
   apply(change: { add?: KPIRow[]; update?: KPIRow[]; remove?: unknown[] }): void;
+  /** Visit every row the panel holds, with its key. */
   forEach(fn: (row: KPIRow, key: unknown) => void): void;
+  /**
+   * How many rows the panel holds. This is the panel's emptiness test: with none, every
+   * stat tile reports `unknown` rather than a healthy zero.
+   */
   readonly count: number;
 }
 
@@ -297,14 +424,25 @@ interface KPIRows {
  * updating each tile incrementally from the routed delta.
  */
 interface KPI {
+  /** The element the panel renders into, or null for a headless panel. */
   readonly el: unknown | null;
   /** The resolved row identity; see `KPIConfig.rowKey`. */
   readonly rowKey: string | ((row: KPIRow) => string | number);
   /** Whether the panel renders as a hierarchy rather than a flat tile grid. */
   readonly tree: boolean;
+  /**
+   * The keyed-diff consumer surface, the same shape a grid exposes — this is what makes a
+   * panel a Data Router target.
+   */
   rows: KPIRows;
+  /** Every tile model, in configured order. */
   tiles(): KPITileModel[];
+  /** One tile model by id, or undefined when no tile has that id. */
   tile(id: string): KPITileModel | undefined;
+  /**
+   * A tile's computed value. Null for an unknown id, and for a tile that measured
+   * nothing.
+   */
   value(id: string): unknown;
   /** The top-level nodes of the hierarchy. Empty on a flat panel. */
   nodes(): KPINodeModel[];
@@ -312,15 +450,47 @@ interface KPI {
   node(key: string): KPINodeModel | undefined;
   /** The nodes on screen: the roots, plus the children of every open branch. */
   visibleNodes(): KPINodeModel[];
+  /**
+   * Open a branch of a hierarchical panel by node key, re-render, and fire `node:toggle`.
+   * A key that is already open changes nothing.
+   */
   expand(key: string): KPI;
+  /** Close a branch by node key, re-render, and fire `node:toggle`. */
   collapse(key: string): KPI;
+  /** Flip a branch between open and closed, firing `node:toggle` on the change. */
   toggle(key: string): KPI;
+  /**
+   * Replace the source rows and recompute, and make that array the source again so a
+   * later `refresh()` re-reads it. Ignored with a warning on a grid-bound panel.
+   */
   setRows(rows: KPIRow[]): KPI;
+  /**
+   * Recompute every tile and re-render. A bound panel re-reads the grid now rather than
+   * at the end of the turn; a configured panel re-reads its array; once rows have arrived
+   * through `rows.apply` nothing is re-read, so a routed feed is never thrown away.
+   */
   refresh(): KPI;
+  /**
+   * The restorable state: the rows the panel holds, and — on a hierarchical panel only —
+   * which branches are open.
+   */
   getState(): object;
+  /**
+   * Restore a snapshot from `getState`. A snapshot without `expanded` leaves the
+   * expansion alone rather than collapsing the rail.
+   */
   setState(snapshot: object): KPI;
+  /**
+   * Register an event handler; returns a function that removes it. An unrecognised event
+   * name is warned about once.
+   */
   on(name: string, fn: (event: KPIEvent) => void): () => void;
+  /** Remove a handler registered with `on`. */
   off(name: string, fn: (event: KPIEvent) => void): void;
+  /**
+   * Drop every listener, stop following the bound grid, stop any clock tile ticking, and
+   * empty the element (removing only the class the panel added).
+   */
   destroy(): void;
 }
 

package/modules/kpi.esm.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.68.0, kpi module
+ * Lattice Grid 1.68.1, kpi 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){
@@ -5596,7 +5596,7 @@ const columns=this.#columnList();
 const parts=[];
 const hidden=this.#ctx.columnHidden;
 for(const column of columns){
-if(column.filter&&column.filter.enabled===false)continue;
+if(column.quickFilter===false)continue;
 if(isFunction(hidden)&&hidden(column.id))continue;
 const custom=column.value&&isFunction(column.value.quickFilterText)
 ?column.value.quickFilterText({value:undefined,data,row:null,column,colId:column.id,grid:null,context:this.#state('context',null)})

package/modules/kpi.min.cjs

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.68.0, kpi module
+ * Lattice Grid 1.68.1, kpi 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){
@@ -5598,7 +5598,7 @@ const columns=this.#columnList();
 const parts=[];
 const hidden=this.#ctx.columnHidden;
 for(const column of columns){
-if(column.filter&&column.filter.enabled===false)continue;
+if(column.quickFilter===false)continue;
 if(isFunction(hidden)&&hidden(column.id))continue;
 const custom=column.value&&isFunction(column.value.quickFilterText)
 ?column.value.quickFilterText({value:undefined,data,row:null,column,colId:column.id,grid:null,context:this.#state('context',null)})

package/modules/kpi.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.68.0, kpi module
+ * Lattice Grid 1.68.1, kpi 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){
@@ -5598,7 +5598,7 @@ const columns=this.#columnList();
 const parts=[];
 const hidden=this.#ctx.columnHidden;
 for(const column of columns){
-if(column.filter&&column.filter.enabled===false)continue;
+if(column.quickFilter===false)continue;
 if(isFunction(hidden)&&hidden(column.id))continue;
 const custom=column.value&&isFunction(column.value.quickFilterText)
 ?column.value.quickFilterText({value:undefined,data,row:null,column,colId:column.id,grid:null,context:this.#state('context',null)})

package/modules/layout.d.ts

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.68.0, layout module type declarations
+ * Lattice Grid 1.68.1, layout module type declarations
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */
@@ -70,38 +70,82 @@ interface LayoutWindow {
  * read correctly and round-trip wrongly, so it is reported as it is.
  */
 interface LayoutInteractive {
+  /**
+   * Whether dragging a window to another cell is currently allowed for the layout as a
+   * whole. Undefined means nothing has been locked or unlocked, so each window's own flag
+   * decides.
+   */
   movable: boolean | undefined;
+  /**
+   * Whether dragging a window's edge is currently allowed for the layout as a whole, on
+   * the same terms as `movable`.
+   */
   resizable: boolean | undefined;
+  /**
+   * Whether the close control is currently allowed for the layout as a whole, on the same
+   * terms as `movable`.
+   */
   closable: boolean | undefined;
 }
 
 /** The plain, JSON-safe arrangement `getLayout()` returns and `setLayout()` takes. */
 interface LayoutSnapshot {
+  /**
+   * How many cell columns the layout had when the snapshot was taken. Informational on
+   * the way back in: `setLayout` reads only `windows`, and clamps each placement to the
+   * layout it is restored into.
+   */
   columns: number;
+  /** How many cell rows the layout had when the snapshot was taken; informational too. */
   rows: number;
+  /**
+   * Each window's id and its cell placement. Position and size only: titles, content and
+   * capabilities stay with the configuration.
+   */
   windows: { id: string; xPos: number; yPos: number; xSize: number; ySize: number }[];
 }
 
 /** A cell placement, as carried on the move and resize events. */
 interface LayoutPlacement {
+  /** The window's left-hand column, counted from 1. */
   xPos: number;
+  /** The window's top row, counted from 1. */
   yPos: number;
+  /** How many columns wide the window is; at least 1, and never more than the layout has. */
   xSize: number;
+  /** How many rows tall the window is; at least 1. */
   ySize: number;
 }
 
 /** The payload of `window:moved`, `beforeWindowMove`, `beforeWindowResize`. */
 interface LayoutMoveEvent {
+  /** Which window moved or was asked to move. */
   id: string;
+  /**
+   * Where the window was before the gesture. A move that would change nothing is not
+   * reported at all.
+   */
   from: LayoutPlacement;
   /** Where the window was asked to go. */
   to: LayoutPlacement;
   /** Where it actually ended up, which under `compact: 'vertical'` may differ. */
   landed?: LayoutPlacement;
+  /**
+   * Who caused it: `user` for a drag, `api` for a call, `init` for the opening
+   * arrangement. Defaults to `user`.
+   */
   origin?: 'api' | 'user' | 'init';
+  /**
+   * Why it was cancelled — whatever was passed to `preventDefault`, `prevented` when
+   * nothing was, or `error` when a handler threw. Null while nothing has cancelled it.
+   */
   reason?: string | null;
   /** Cancel the action (only meaningful on a `before*` event). */
   preventDefault?: (reason?: string) => void;
+  /**
+   * True once a handler has cancelled the action. Read it in a later handler to see that
+   * an earlier one already refused.
+   */
   defaultPrevented?: boolean;
 }
 
@@ -111,32 +155,65 @@ interface LayoutMoveEvent {
  * changes size, including on the opening frame; never with a zero box.
  */
 interface LayoutResizeEvent {
+  /** Which window changed size. */
   id: string;
+  /**
+   * The id of the window's content container, so a host can find the element it mounted
+   * into. Defaults to the window id plus `-body`.
+   */
   payloadId: string;
   /** The payload container itself, so a host can act on it directly. */
   payload: HTMLElement;
+  /**
+   * The content box's width in CSS pixels, measured — not a cell count. A change under a
+   * pixel is not reported.
+   */
   width: number;
+  /** The content box's height in CSS pixels, on the same terms as `width`. */
   height: number;
+  /** The window's left-hand column at the time of the measurement. */
   xPos: number;
+  /** The window's top row at the time of the measurement. */
   yPos: number;
+  /** How many columns wide the window now is. */
   xSize: number;
+  /** How many rows tall the window now is. */
   ySize: number;
 }
 
 /** The payload of `window:closed` and `beforeWindowClose`. */
 interface LayoutCloseEvent {
+  /** Which window was closed, or is about to be. */
   id: string;
+  /**
+   * The id of its content container — the handle for tearing down whatever was mounted
+   * inside.
+   */
   payloadId: string;
   /** The payload container, handed back so the host can destroy what it mounted. */
   payload?: HTMLElement;
+  /** Who caused it: `user` for the close control, `api` for a call. Defaults to `user`. */
   origin?: 'api' | 'user';
+  /**
+   * Why the close was refused — the reason given to `preventDefault`, `prevented` when
+   * none was, or `error` when a handler threw.
+   */
   reason?: string | null;
+  /**
+   * Refuse the close, optionally saying why. Only `beforeWindowClose` is cancellable; by
+   * `window:closed` the window has gone.
+   */
   preventDefault?: (reason?: string) => void;
+  /** True once a handler has refused the close. */
   defaultPrevented?: boolean;
 }
 
 /** The payload of `layout:changed`: the whole arrangement, plus what moved it. */
 interface LayoutChangedEvent extends LayoutSnapshot {
+  /**
+   * What moved the arrangement: `move`, `resize`, `close`, `add`, `minimise`, `restore`,
+   * `setLayout` or `init`.
+   */
   cause: string;
 }
 
@@ -196,15 +273,44 @@ interface LayoutConfig {
   ariaLabel?: string;
   /** A message catalogue, e.g. `grid.messages`; built-in English seeds otherwise. */
   messages?: { t(key: string, params?: Record<string, unknown>): string };
+  /** Called after a window has moved, alongside the `window:moved` event. */
   onWindowMoved?: (event: LayoutMoveEvent) => void;
+  /**
+   * Called when a window's measured content box changes, alongside `window:resized` —
+   * including on the opening frame.
+   */
   onWindowResized?: (event: LayoutResizeEvent) => void;
+  /**
+   * Called after a window has closed, with its content container handed back so the host
+   * can destroy what it mounted. Alongside `window:closed`.
+   */
   onWindowClosed?: (event: LayoutCloseEvent) => void;
+  /**
+   * Called whenever the arrangement settles, with the whole snapshot and what caused it —
+   * the hook for persisting a dashboard. Alongside `layout:changed`.
+   */
   onLayoutChanged?: (event: LayoutChangedEvent) => void;
+  /**
+   * Called before a move is applied. Return `false`, call `preventDefault(reason)`, or
+   * throw, to refuse it; return a promise and the move waits for it. Alongside the
+   * `beforeWindowMove` event.
+   */
   onBeforeWindowMove?: (event: LayoutMoveEvent) => boolean | void | Promise<boolean>;
+  /** Called before a resize is applied, on the same terms as `onBeforeWindowMove`. */
   onBeforeWindowResize?: (event: LayoutMoveEvent) => boolean | void | Promise<boolean>;
+  /**
+   * Called before a window closes, on the same terms as `onBeforeWindowMove`. This is
+   * where an unsaved-changes prompt belongs.
+   */
   onBeforeWindowClose?: (event: LayoutCloseEvent) => boolean | void | Promise<boolean>;
+  /**
+   * Called when a move was refused, with the reason on the payload. Alongside
+   * `windowMove:cancelled`.
+   */
   onWindowMoveCancelled?: (event: LayoutMoveEvent) => void;
+  /** Called when a resize was refused. Alongside `windowResize:cancelled`. */
   onWindowResizeCancelled?: (event: LayoutMoveEvent) => void;
+  /** Called when a close was refused. Alongside `windowClose:cancelled`. */
   onWindowCloseCancelled?: (event: LayoutCloseEvent) => void;
 }
 
@@ -219,6 +325,10 @@ interface LayoutConfig {
  * cannot know what one is.
  */
 interface Layout {
+  /**
+   * The element the layout was mounted on. It carries the layout's host class, which is
+   * also how a second `createLayout` on the same element is refused.
+   */
   readonly el: HTMLElement;
   /** The window ids, in mount order. */
   windows(): string[];
@@ -315,6 +425,11 @@ interface Layout {
   getInteractive(): LayoutInteractive;
   /** Re-measure every window and emit `window:resized` for those that changed. */
   refresh(): number;
+  /**
+   * Subscribe to a layout event, or to `'*'` for every past-tense one; returns a function
+   * that unsubscribes. Only an explicit `before…` subscription can cancel an action — the
+   * `'*'` stream never gates.
+   */
   on(
     name: 'window:moved' | 'window:resized' | 'window:closed' | 'layout:changed'
       | 'beforeWindowMove' | 'beforeWindowResize' | 'beforeWindowClose'
@@ -322,6 +437,7 @@ interface Layout {
       | '*' | string,
     fn: (event: any) => unknown,
   ): () => void;
+  /** Remove a handler registered with `on`. */
   off(name: string, fn: (event: any) => unknown): void;
   /** Tear the layout down; whatever the host mounted in a payload is the host's to destroy. */
   destroy(): void;

package/modules/layout.esm.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
  */
@@ -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/layout.min.cjs

@@ -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){