@kouji-ui/core 0.9.0 → 0.9.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kouji-ui/core",
-  "version": "0.9.0",
+  "version": "0.9.2",
   "description": "Headless Angular UI primitives — signal-driven directives with WCAG 2.1 AAA semantics, no CDK, and a handful of opt-in global stylesheets.",
   "license": "MIT",
   "repository": {

package/types/kouji-ui-core.d.ts

@@ -1215,7 +1215,10 @@ interface KjOverlayTriggerLike {
  * must not inherit the dialog's scroll lock, scrim or `alertdialog` role.
  * A panel whose controller is on its host chain (a builder-launched body,
  * or the root pattern where one directive provides controller and
- * strategies for the whole subtree) reads them from that chain as before.
+ * strategies for the whole subtree) reads them from that chain, minus any
+ * strategy instance an enclosing overlay is already running: a select inside
+ * a service-launched dialog finds the dialog's scrim, focus trap and scroll
+ * lock up the chain, and must not adopt them.
  *
  * A portalled panel whose scope provides a backdrop strategy also gets a
  * real `<kj-backdrop>` scrim (created next to the panel, moved into the
@@ -1264,7 +1267,10 @@ declare class KjOverlayPanel {
     readonly kjFor: _angular_core.InputSignal<KjOverlayTriggerLike | null>;
     /** Whether the bound controller lives outside this panel's host chain — see the class docs. */
     private readonly scoped;
-    /** The tokens that apply to this panel. */
+    /**
+     * The tokens that apply to this panel. Inherited ones exclude strategies an
+     * enclosing overlay already runs (see {@link withoutForeign}).
+     */
     private readonly tokens;
     readonly role: _angular_core.Signal<KjPanelRole>;
     readonly isModal: _angular_core.Signal<boolean>;
@@ -1549,7 +1555,9 @@ declare function releaseInert(el: Element): void;
  * Makes everything behind a modal `panel` inert: every child of `<body>`
  * outside the overlay container (except script/style nodes and live
  * regions), plus every overlay wrapper opened before the panel's own — a
- * dialog stacked on a dialog freezes the one below. A body child that
+ * dialog stacked on a dialog freezes the one below. The container itself is
+ * never inerted, even for a panel mounted outside it, so overlays the modal
+ * opens afterwards (dropdowns, pickers) stay usable. A body child that
  * contains the panel (an inline-mounted modal) is left alone, because
  * inerting it would inert the panel itself.
  *
@@ -12386,11 +12394,20 @@ declare class KjTableKeyboardNav implements KjTableKeyboardNavContext {
     private readonly cells;
     /** Id of the cell the user focused last; survives the cell leaving the DOM. */
     private readonly activeId;
+    /** Tab stop resolved after the last render (see {@link tabStopId}). */
+    private readonly resolvedStopId;
     /**
      * Id of the cell that owns `tabindex="0"`: the last focused cell while it
      * is rendered, else the first rendered cell in DOM order.
+     *
+     * Every cell reads this, so it must not touch the `cells` query: each
+     * stamped cell view dirties the query, and a per-cell read would re-collect
+     * it and re-sort the DOM once per cell — O(n²) for an n-cell body. It is
+     * resolved once per render instead, after the cells are in the DOM. Until
+     * then (and on the server) no cell is a Tab stop.
      */
     readonly tabStopId: _angular_core.Signal<string | null>;
+    constructor();
     /** Record `cellId` as the last focused cell. @param cellId TanStack `cell.id`. */
     setActive(cellId: string): void;
     onKeyDown(event: KeyboardEvent): void;