@toclocoinc/lattice-grid 1.68.1 → 1.68.2

package/modules/kpi.min.cjs

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.68.1, kpi module
+ * Lattice Grid 1.68.2, 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.1";
+const STAMPED_VERSION="1.68.2";
 async function resolveVersion(){
 if(STAMPED_VERSION!=='0.0.0-source')return STAMPED_VERSION;
 return STAMPED_VERSION;
 }
-const VERSION="1.68.1";
+const VERSION="1.68.2";
 const warned=new Set();
 const WARNED_LIMIT=2000;
 function rememberWarned(key){

package/modules/kpi.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.68.1, kpi module
+ * Lattice Grid 1.68.2, 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.1";
+const STAMPED_VERSION="1.68.2";
 async function resolveVersion(){
 if(STAMPED_VERSION!=='0.0.0-source')return STAMPED_VERSION;
 return STAMPED_VERSION;
 }
-const VERSION="1.68.1";
+const VERSION="1.68.2";
 const warned=new Set();
 const WARNED_LIMIT=2000;
 function rememberWarned(key){

package/modules/layout.d.ts

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.68.1, layout module type declarations
+ * Lattice Grid 1.68.2, layout module type declarations
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */
@@ -208,6 +208,134 @@ interface LayoutCloseEvent {
   defaultPrevented?: boolean;
 }
 
+/**
+ * `window:moved`: a window finished moving.
+ *
+ * The past-tense event, so there is no `preventDefault` on it — the move has
+ * happened, and `beforeWindowMove` ({@link LayoutMoveEvent}) is where it could
+ * have been stopped.
+ */
+interface LayoutWindowMovedEvent {
+  /** Which window moved. */
+  id: string;
+  /** Where it was before the gesture. */
+  from: LayoutPlacement;
+  /** Where it was asked to go. */
+  to: LayoutPlacement;
+  /** Where it actually ended up, which under `compact: 'vertical'` may differ from `to`. */
+  landed: LayoutPlacement;
+  /** Who caused it: `user` for a drag or a keyboard move, `api` for `setWindow`. */
+  origin: 'api' | 'user';
+}
+
+/**
+ * `window:closed`: a window was removed and its payload container handed back.
+ *
+ * The past-tense event: no `preventDefault`, because the window has gone. The
+ * container is **not** destroyed — whatever the host mounted in it is the
+ * host's to tear down.
+ */
+interface LayoutWindowClosedEvent {
+  /** Which window closed. */
+  id: string;
+  /** The id of its content container. */
+  payloadId: string;
+  /** The container itself, handed back so the host can destroy what it mounted. */
+  payload: HTMLElement;
+  /** Who caused it: `user` for the close control, `api` for a call. */
+  origin: 'api' | 'user';
+}
+
+/**
+ * `windowMove:cancelled` and `windowResize:cancelled`: a `before…` handler
+ * refused the gesture. A notification, so it carries no `preventDefault`.
+ */
+interface LayoutMoveCancelledEvent {
+  /** Which window did not move. */
+  id: string;
+  /** Where it is, and stays. */
+  from: LayoutPlacement;
+  /** Where it would have gone. */
+  to: LayoutPlacement;
+  /** Who asked for the gesture that was refused: `user` for a drag or keyboard move, `api` for `setWindow`. */
+  origin: 'api' | 'user';
+  /** The reason given to `preventDefault`, or `'prevented'`. */
+  reason: string;
+}
+
+/**
+ * `windowClose:cancelled`: a `beforeWindowClose` handler refused the close. A
+ * notification, so it carries no `preventDefault`.
+ */
+interface LayoutCloseCancelledEvent {
+  /** Which window stayed open. */
+  id: string;
+  /** The id of its content container. */
+  payloadId: string;
+  /** Who asked for the close that was refused. */
+  origin: 'api' | 'user';
+  /** The reason given to `preventDefault`, or `'prevented'`. */
+  reason: string;
+}
+
+/**
+ * The events a dashboard layout raises.
+ *
+ * The layout's own, not a grid's: `grid.on` takes {@link EventName} and knows
+ * nothing about these. Each has a matching `on…` config callback (`onWindowMoved`,
+ * `onBeforeWindowClose`, …) and both routes fire.
+ *
+ * The three `before…` events are cancellable: call `preventDefault(reason?)` on
+ * the payload, or return a Promise to hold the gesture until it settles; a veto
+ * fires the matching `…:cancelled` carrying the reason. Subscribing to `'*'`
+ * receives every past-tense event and never gates.
+ */
+type LayoutEventName =
+  /** A window finished moving, with where it was asked to go and where it actually landed. */
+  | 'window:moved'
+  /** A window's payload container changed size, measured in CSS pixels — including on the opening frame. */
+  | 'window:resized'
+  /** A window was closed and its payload container handed back. */
+  | 'window:closed'
+  /** The arrangement settled after an add, close, move, resize, minimise, restore or `setLayout`. */
+  | 'layout:changed'
+  /** A window is about to move; cancellable. */
+  | 'beforeWindowMove'
+  /** A window is about to be resized by a drag or a call; cancellable. */
+  | 'beforeWindowResize'
+  /** A window is about to be closed; cancellable. */
+  | 'beforeWindowClose'
+  /** A `beforeWindowMove` handler refused the move. */
+  | 'windowMove:cancelled'
+  /** A `beforeWindowResize` handler refused the resize. */
+  | 'windowResize:cancelled'
+  /** A `beforeWindowClose` handler refused the close. */
+  | 'windowClose:cancelled';
+
+/** What a handler receives, per layout event. */
+interface LayoutEventPayloads {
+  /** Which window moved, from where, to where, and where it landed. */
+  'window:moved': LayoutWindowMovedEvent;
+  /** The measured content box of the window's payload container. */
+  'window:resized': LayoutResizeEvent;
+  /** The window that closed, and the container handed back. */
+  'window:closed': LayoutWindowClosedEvent;
+  /** The arrangement, and what settled it. */
+  'layout:changed': LayoutChangedEvent;
+  /** The move about to be applied, with `preventDefault` to stop it. */
+  beforeWindowMove: LayoutMoveEvent;
+  /** The resize about to be applied, with `preventDefault` to stop it. */
+  beforeWindowResize: LayoutMoveEvent;
+  /** The close about to happen, with `preventDefault` to refuse it. */
+  beforeWindowClose: LayoutCloseEvent;
+  /** The move that was refused, and why. */
+  'windowMove:cancelled': LayoutMoveCancelledEvent;
+  /** The resize that was refused, and why. */
+  'windowResize:cancelled': LayoutMoveCancelledEvent;
+  /** The close that was refused, and why. */
+  'windowClose:cancelled': LayoutCloseCancelledEvent;
+}
+
 /** The payload of `layout:changed`: the whole arrangement, plus what moved it. */
 interface LayoutChangedEvent extends LayoutSnapshot {
   /**
@@ -428,17 +556,15 @@ interface Layout {
   /**
    * 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.
+   * `'*'` stream never gates. What each event carries is {@link LayoutEventPayloads}; the
+   * handler is declared with the widest of them, so narrow on the name inside it.
    */
   on(
-    name: 'window:moved' | 'window:resized' | 'window:closed' | 'layout:changed'
-      | 'beforeWindowMove' | 'beforeWindowResize' | 'beforeWindowClose'
-      | 'windowMove:cancelled' | 'windowResize:cancelled' | 'windowClose:cancelled'
-      | '*' | string,
-    fn: (event: any) => unknown,
+    name: LayoutEventName | '*',
+    fn: (event: LayoutEventPayloads[LayoutEventName]) => unknown,
   ): () => void;
   /** Remove a handler registered with `on`. */
-  off(name: string, fn: (event: any) => unknown): void;
+  off(name: LayoutEventName | '*', fn: (event: LayoutEventPayloads[LayoutEventName]) => 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.1, layout module
+ * Lattice Grid 1.68.2, 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.1";
+const STAMPED_VERSION="1.68.2";
 async function resolveVersion(){
 if(STAMPED_VERSION!=='0.0.0-source')return STAMPED_VERSION;
 return STAMPED_VERSION;
 }
-const VERSION="1.68.1";
+const VERSION="1.68.2";
 const warned=new Set();
 const WARNED_LIMIT=2000;
 function rememberWarned(key){

package/modules/layout.min.cjs

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.68.1, layout module
+ * Lattice Grid 1.68.2, 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.1";
+const STAMPED_VERSION="1.68.2";
 async function resolveVersion(){
 if(STAMPED_VERSION!=='0.0.0-source')return STAMPED_VERSION;
 return STAMPED_VERSION;
 }
-const VERSION="1.68.1";
+const VERSION="1.68.2";
 const warned=new Set();
 const WARNED_LIMIT=2000;
 function rememberWarned(key){

package/modules/layout.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.68.1, layout module
+ * Lattice Grid 1.68.2, 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.1";
+const STAMPED_VERSION="1.68.2";
 async function resolveVersion(){
 if(STAMPED_VERSION!=='0.0.0-source')return STAMPED_VERSION;
 return STAMPED_VERSION;
 }
-const VERSION="1.68.1";
+const VERSION="1.68.2";
 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.1, mock-socket module type declarations
+ * Lattice Grid 1.68.2, mock-socket module type declarations
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */

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

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.68.1, mock-socket module
+ * Lattice Grid 1.68.2, 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.1, mock-socket module
+ * Lattice Grid 1.68.2, 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.1, mock-socket module
+ * Lattice Grid 1.68.2, 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.1, react module type declarations
+ * Lattice Grid 1.68.2, react module type declarations
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */
@@ -202,6 +202,10 @@ export interface LatticeTabSpec {
   label?: string;
   /** A React element, or a function returning one, rendered through a portal. */
   content?: unknown | (() => unknown);
+  /**
+   * Any other prop the host wants to carry on the tab. Passed through untouched, so a
+   * React host can key its own state off the same object the grid holds.
+   */
   [key: string]: unknown;
 }
 

package/modules/react.esm.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.68.1, react module
+ * Lattice Grid 1.68.2, 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.1";
+const STAMPED_VERSION="1.68.2";
 async function resolveVersion(){
 if(STAMPED_VERSION!=='0.0.0-source')return STAMPED_VERSION;
 return STAMPED_VERSION;
 }
-const VERSION="1.68.1";
+const VERSION="1.68.2";
 const warned=new Set();
 const WARNED_LIMIT=2000;
 function rememberWarned(key){

package/modules/react.min.cjs

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.68.1, react module
+ * Lattice Grid 1.68.2, 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.1";
+const STAMPED_VERSION="1.68.2";
 async function resolveVersion(){
 if(STAMPED_VERSION!=='0.0.0-source')return STAMPED_VERSION;
 return STAMPED_VERSION;
 }
-const VERSION="1.68.1";
+const VERSION="1.68.2";
 const warned=new Set();
 const WARNED_LIMIT=2000;
 function rememberWarned(key){

package/modules/react.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.68.1, react module
+ * Lattice Grid 1.68.2, 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.1";
+const STAMPED_VERSION="1.68.2";
 async function resolveVersion(){
 if(STAMPED_VERSION!=='0.0.0-source')return STAMPED_VERSION;
 return STAMPED_VERSION;
 }
-const VERSION="1.68.1";
+const VERSION="1.68.2";
 const warned=new Set();
 const WARNED_LIMIT=2000;
 function rememberWarned(key){

package/modules/svelte.d.ts

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.68.1, svelte module type declarations
+ * Lattice Grid 1.68.2, 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.1, svelte module
+ * Lattice Grid 1.68.2, 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.1";
+const STAMPED_VERSION="1.68.2";
 async function resolveVersion(){
 if(STAMPED_VERSION!=='0.0.0-source')return STAMPED_VERSION;
 return STAMPED_VERSION;
 }
-const VERSION="1.68.1";
+const VERSION="1.68.2";
 const warned=new Set();
 const WARNED_LIMIT=2000;
 function rememberWarned(key){

package/modules/svelte.min.cjs

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.68.1, svelte module
+ * Lattice Grid 1.68.2, 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.1";
+const STAMPED_VERSION="1.68.2";
 async function resolveVersion(){
 if(STAMPED_VERSION!=='0.0.0-source')return STAMPED_VERSION;
 return STAMPED_VERSION;
 }
-const VERSION="1.68.1";
+const VERSION="1.68.2";
 const warned=new Set();
 const WARNED_LIMIT=2000;
 function rememberWarned(key){

package/modules/svelte.min.js

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.68.1, svelte module
+ * Lattice Grid 1.68.2, 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.1";
+const STAMPED_VERSION="1.68.2";
 async function resolveVersion(){
 if(STAMPED_VERSION!=='0.0.0-source')return STAMPED_VERSION;
 return STAMPED_VERSION;
 }
-const VERSION="1.68.1";
+const VERSION="1.68.2";
 const warned=new Set();
 const WARNED_LIMIT=2000;
 function rememberWarned(key){

package/modules/tabs.d.ts

@@ -1,5 +1,5 @@
 /*!
- * Lattice Grid 1.68.1, tabs module type declarations
+ * Lattice Grid 1.68.2, tabs module type declarations
  * Copyright (c) 2026 TOCLOCO Inc. All rights reserved.
  * https://latticegrid.dev
  */
@@ -71,26 +71,101 @@ interface TabDescriptor {
   badgeTone?: 'good' | 'warn' | 'bad' | 'unknown' | ((count: number | null, tab: { id: string; label: string; from: string | null }) => 'good' | 'warn' | 'bad' | 'unknown' | null);
 }
 
-/** The payload every tab-change event carries. */
+/**
+ * `beforeTabChange`: a switch is about to be applied, and may be refused.
+ *
+ * Delivered through `packages/modules/shared/emitter.js`'s `emitBefore`, which
+ * builds the event from the module's action context plus `type`, the resolved
+ * `origin` and the veto surface — so every member below is always present on
+ * this event. A handler refuses the switch by calling `preventDefault(reason?)`
+ * or by returning a Promise that resolves `false`; the active tab then does not
+ * change and `tabChange:cancelled` fires carrying the reason.
+ */
 interface TabChangeEvent {
+  /** Which event this is: `beforeTabChange`. */
+  type: string;
   /** The tab being switched to. */
   id: string;
-  /** The tab being left, or null for the first activation. */
+  /** The tab being left, or null when no tab was active. */
   previousId: string | null;
   /**
-   * Who caused the switch: `user` for a click or keypress, `api` for `activate()`, `init`
-   * for the opening tab. Defaults to `user`.
+   * Who asked for the switch: `user` for a click or a keypress, `api` for
+   * `activate()`. The opening tab is activated silently, so it raises no
+   * `beforeTabChange` at all.
    */
-  origin?: 'api' | 'user' | 'init';
+  origin: 'api' | 'user';
+  /** The reason given to `preventDefault`, or null while nothing has refused the switch. */
+  reason: string | null;
+  /** True once a handler has refused the switch. */
+  defaultPrevented: boolean;
+  /** Refuse the switch; the optional reason is carried on `tabChange:cancelled`. */
+  preventDefault(reason?: string): void;
+}
+
+/**
+ * `tab:changed`: the switch happened — the target panel is revealed, its grid
+ * materialised on first activation, the badges refreshed and `aria-selected`
+ * moved. A notification, so it carries no `preventDefault`.
+ */
+interface TabChangedEvent {
+  /** Which event this is: `tab:changed`. */
+  type: string;
+  /** The tab now active. */
+  id: string;
   /**
-   * Why the switch was refused — the reason given to `preventDefault`, `prevented` when
-   * none was, or `error` when a handler threw.
+   * The tab that was left, or null for the mount-time activation — which
+   * happens while the strip is being built, before a handler can subscribe.
    */
-  reason?: string | null;
-  /** Cancel the switch (only meaningful on `beforeTabChange`). */
-  preventDefault?: (reason?: string) => void;
-  /** True once a handler has cancelled the switch. */
-  defaultPrevented?: boolean;
+  previousId: string | null;
+}
+
+/**
+ * `tabChange:cancelled`: a `beforeTabChange` handler refused the switch, so the
+ * active tab did not change. A notification, so it carries no `preventDefault`.
+ */
+interface TabChangeCancelledEvent {
+  /** Which event this is: `tabChange:cancelled`. */
+  type: string;
+  /** The tab that was not switched to. */
+  id: string;
+  /** The tab that is still active, or null when none was. */
+  previousId: string | null;
+  /** Who asked for the switch that was refused. */
+  origin: 'api' | 'user';
+  /** The reason given to `preventDefault`, or `'prevented'` when none was. */
+  reason: string;
+}
+
+/**
+ * The events a tabbed grid raises.
+ *
+ * The strip's own, not a grid's: `grid.on` takes {@link EventName} and knows
+ * nothing about these, and each tab's grid keeps raising its own events itself.
+ * `on()` warns once on any other name, because a binding to an event that can
+ * never fire is a silent no-op. Each event also has a config callback
+ * (`onBeforeTabChange`, `onTabChange`, `onTabChangeCancelled`); both routes
+ * fire.
+ *
+ * Only `beforeTabChange` is cancellable — it is the one that runs before
+ * anything moves. `tab:changed` and `tabChange:cancelled` report a decision
+ * already taken and carry no `preventDefault`.
+ */
+type TabsEventName =
+  /** A switch is about to be applied; cancellable. */
+  | 'beforeTabChange'
+  /** The active tab changed: its panel is showing and its grid is mounted. */
+  | 'tab:changed'
+  /** A `beforeTabChange` handler refused the switch; the active tab did not change. */
+  | 'tabChange:cancelled';
+
+/** What a handler receives, per tabs event. */
+interface TabsEventPayloads {
+  /** The switch about to happen, with `preventDefault` to refuse it. */
+  beforeTabChange: TabChangeEvent;
+  /** The tab now active, and the one it replaced. */
+  'tab:changed': TabChangedEvent;
+  /** The switch that was refused, and why. */
+  'tabChange:cancelled': TabChangeCancelledEvent;
 }
 
 /** Tabbed-grid configuration. */
@@ -108,7 +183,7 @@ interface TabsConfig {
   /** 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;
+  onTabChange?: (event: TabChangedEvent) => 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
@@ -119,7 +194,7 @@ interface TabsConfig {
    * Called when a switch was refused, with the reason on the payload. Alongside
    * `tabChange:cancelled`.
    */
-  onTabChangeCancelled?: (event: TabChangeEvent) => void;
+  onTabChangeCancelled?: (event: TabChangeCancelledEvent) => void;
 }
 
 /**
@@ -141,13 +216,14 @@ interface Tabs {
   /** 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.
+   * Register an event handler; returns a function that removes it. Any other name is
+   * warned about once, because it names a binding that could never fire. What each event
+   * carries is {@link TabsEventPayloads}; the handler is declared with the widest of
+   * them, so narrow on the name inside it.
    */
-  on(name: 'beforeTabChange' | 'tab:changed' | 'tabChange:cancelled' | string, fn: (event: TabChangeEvent) => void): () => void;
+  on(name: TabsEventName, fn: (event: TabsEventPayloads[TabsEventName]) => void): () => void;
   /** Remove a handler registered with `on`. */
-  off(name: string, fn: (event: TabChangeEvent) => void): void;
+  off(name: TabsEventName, fn: (event: TabsEventPayloads[TabsEventName]) => 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.1, tabs module
+ * Lattice Grid 1.68.2, 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.1";
+const STAMPED_VERSION="1.68.2";
 async function resolveVersion(){
 if(STAMPED_VERSION!=='0.0.0-source')return STAMPED_VERSION;
 return STAMPED_VERSION;
 }
-const VERSION="1.68.1";
+const VERSION="1.68.2";
 const warned=new Set();
 const WARNED_LIMIT=2000;
 function rememberWarned(key){