foldkit 0.118.0 → 0.120.0

package/dist/dom/dom.d.ts

@@ -48,31 +48,65 @@ export declare const focus: (selector: string, options?: Readonly<{
  *
  * Pass `focusSelector` to focus an element inside the dialog when it opens.
  *
- * Records the element that had focus when the dialog opened so `closeModal`
+ * Records the element that had focus when the dialog opened so `closeDialog`
  * can return focus there, the way `showModal()` would natively.
  *
  * @example
  * ```typescript
- * Dom.showModal('#my-dialog')
- * Dom.showModal('#my-dialog', { focusSelector: '#search-input' })
+ * Dom.showDialog('#my-dialog')
+ * Dom.showDialog('#my-dialog', { focusSelector: '#search-input' })
  * ```
  */
-export declare const showModal: (selector: string, options?: Readonly<{
+export declare const showDialog: (selector: string, options?: Readonly<{
     focusSelector?: string;
 }>) => Effect.Effect<void, ElementNotFound>;
 /**
  * Closes a dialog element using `.close()`.
- * Cleans up the keyboard handlers installed by `showModal` and restores focus to
+ * Cleans up the keyboard handlers installed by `showDialog` and restores focus to
  * the element that was focused before the dialog opened (the trigger, or the
  * dialog beneath it when closing a stacked dialog).
  * Fails with `ElementNotFound` if the selector does not match an `HTMLDialogElement`.
  *
  * @example
  * ```typescript
- * Dom.closeModal('#my-dialog')
+ * Dom.closeDialog('#my-dialog')
  * ```
  */
-export declare const closeModal: (selector: string) => Effect.Effect<void, ElementNotFound>;
+export declare const closeDialog: (selector: string) => Effect.Effect<void, ElementNotFound>;
+/**
+ * Releases the framework hygiene a dialog holds while open: the focus-trap
+ * keyboard handler, the recorded return focus, the dialog stack entry, the
+ * z-index counter, and one page scroll lock. Use this as a backstop for the
+ * case where a dialog's element is removed from the DOM without a purposeful
+ * close, the classic example being navigation away from a route-keyed subtree
+ * that contains the dialog. The normal close path (`closeDialog` plus the
+ * Dialog component's `unlockScroll` Command) already releases these, so this
+ * is the missing teardown when no close Message ever flows through `update`.
+ *
+ * Addressed by the dialog's id, not a selector, because the element is
+ * typically already gone from the DOM by the time this runs (that is the whole
+ * point of the backstop). The hygiene installed by `showDialog` is tracked by
+ * id so it can be reclaimed without a live element handle. The id must be
+ * non-empty and unique within the document, since it keys this cleanup
+ * accounting; a duplicate or empty id would release the wrong dialog's hygiene.
+ *
+ * Idempotent and exactly-once. It releases only when the dialog currently
+ * holds hygiene, then clears the per-dialog marker, so calling it after a
+ * normal close, or twice, is a no-op that never under-counts the shared
+ * scroll lock. Carries no application close semantics: the Dialog component
+ * owns the user-facing close (animation, `Closed` OutMessage, consumer
+ * Commands); this only reclaims framework resources.
+ *
+ * Resolves to `true` when it released resources, `false` when there was
+ * nothing to release. Never fails: an id with no held hygiene is a no-op,
+ * since the goal is reclaiming resources that may already be gone.
+ *
+ * @example
+ * ```typescript
+ * Dom.releaseDialogResources('my-dialog')
+ * ```
+ */
+export declare const releaseDialogResources: (id: string) => Effect.Effect<boolean>;
 /**
  * Programmatically clicks an element matching the given selector.
  * Fails with `ElementNotFound` if the selector does not match an `HTMLElement`.

package/dist/dom/dom.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../../src/dom/dom.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,MAAM,EAMP,MAAM,QAAQ,CAAA;AAGf,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAiC5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,eAAO,MAAM,KAAK,GAChB,UAAU,MAAM,EAChB,UAAU,QAAQ,CAAC;IAAE,aAAa,CAAC,EAAE,OAAO,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,KACvE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,CAQlC,CAAA;AAEJ;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,SAAS,GACpB,UAAU,MAAM,EAChB,UAAU,QAAQ,CAAC;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,KAC7C,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,CAsElC,CAAA;AAuBJ;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,UAAU,GACrB,UAAU,MAAM,KACf,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,CAyBlC,CAAA;AAEJ;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,GACvB,UAAU,MAAM,KACf,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,CAKlC,CAAA;AAEJ;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,cAAc,GACzB,UAAU,MAAM,EAChB,UAAU,QAAQ,CAAC;IAAE,KAAK,CAAC,EAAE,qBAAqB,CAAA;CAAE,CAAC,KACpD,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,CAKlC,CAAA;AAEJ;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,wBAAwB,GACnC,UAAU,MAAM,EAChB,UAAU,QAAQ,CAAC;IAAE,KAAK,CAAC,EAAE,qBAAqB,CAAA;CAAE,CAAC,KACpD,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,CAKlC,CAAA;AAcJ;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,0BAA0B,GACrC,UAAU,MAAM,EAChB,UAAU,QAAQ,CAAC;IACjB,KAAK,CAAC,EAAE,qBAAqB,CAAA;IAC7B,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAA;CAC1B,CAAC,KACD,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,CAuBlC,CAAA;AAEJ,yEAAyE;AACzE,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,UAAU,CAAA;AAEhD;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,GACvB,UAAU,MAAM,EAChB,WAAW,cAAc,KACxB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,CAiClC,CAAA"}
+{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../../src/dom/dom.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,MAAM,EAMP,MAAM,QAAQ,CAAA;AAGf,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AA4C5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,eAAO,MAAM,KAAK,GAChB,UAAU,MAAM,EAChB,UAAU,QAAQ,CAAC;IAAE,aAAa,CAAC,EAAE,OAAO,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,KACvE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,CAQlC,CAAA;AAEJ;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,UAAU,GACrB,UAAU,MAAM,EAChB,UAAU,QAAQ,CAAC;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,KAC7C,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,CAyElC,CAAA;AAuBJ;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,WAAW,GACtB,UAAU,MAAM,KACf,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,CASlC,CAAA;AAqBJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,sBAAsB,GAAI,IAAI,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAOrE,CAAA;AAEJ;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,GACvB,UAAU,MAAM,KACf,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,CAKlC,CAAA;AAEJ;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,cAAc,GACzB,UAAU,MAAM,EAChB,UAAU,QAAQ,CAAC;IAAE,KAAK,CAAC,EAAE,qBAAqB,CAAA;CAAE,CAAC,KACpD,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,CAKlC,CAAA;AAEJ;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,wBAAwB,GACnC,UAAU,MAAM,EAChB,UAAU,QAAQ,CAAC;IAAE,KAAK,CAAC,EAAE,qBAAqB,CAAA;CAAE,CAAC,KACpD,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,CAKlC,CAAA;AAcJ;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,0BAA0B,GACrC,UAAU,MAAM,EAChB,UAAU,QAAQ,CAAC;IACjB,KAAK,CAAC,EAAE,qBAAqB,CAAA;IAC7B,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAA;CAC1B,CAAC,KACD,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,CAuBlC,CAAA;AAEJ,yEAAyE;AACzE,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,UAAU,CAAA;AAEhD;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,GACvB,UAAU,MAAM,EAChB,WAAW,cAAc,KACxB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,CAiClC,CAAA"}

package/dist/dom/dom.js

@@ -1,10 +1,10 @@
 import { Array, Effect, Equal, Function, Match as M, Number, Option, } from 'effect';
 import { afterCommit, afterPaint } from '../render/render.js';
 import { ElementNotFound } from './error.js';
+import { unlockScroll } from './scrollLock.js';
 const BASE_DIALOG_Z_INDEX = 2147483600;
 let openDialogCount = 0;
-const dialogCleanups = new WeakMap();
-const dialogReturnFocus = new WeakMap();
+const dialogHygieneById = new Map();
 let openDialogStack = [];
 const FOCUSABLE_SELECTOR = Array.join([
     'a[href]:not([tabindex="-1"])',
@@ -72,37 +72,38 @@ export const focus = (selector, options) => Effect.gen(function* () {
  *
  * Pass `focusSelector` to focus an element inside the dialog when it opens.
  *
- * Records the element that had focus when the dialog opened so `closeModal`
+ * Records the element that had focus when the dialog opened so `closeDialog`
  * can return focus there, the way `showModal()` would natively.
  *
  * @example
  * ```typescript
- * Dom.showModal('#my-dialog')
- * Dom.showModal('#my-dialog', { focusSelector: '#search-input' })
+ * Dom.showDialog('#my-dialog')
+ * Dom.showDialog('#my-dialog', { focusSelector: '#search-input' })
  * ```
  */
-export const showModal = (selector, options) => Effect.gen(function* () {
+export const showDialog = (selector, options) => Effect.gen(function* () {
     yield* afterCommit;
     const element = document.querySelector(selector);
     if (!(element instanceof HTMLDialogElement)) {
         return yield* Effect.fail(new ElementNotFound({ selector }));
     }
+    const { id } = element;
     element.style.position = 'fixed';
     element.style.inset = '0';
     openDialogCount++;
     element.style.zIndex = String(BASE_DIALOG_Z_INDEX + openDialogCount);
     const previouslyFocused = document.activeElement;
-    if (previouslyFocused instanceof HTMLElement &&
-        previouslyFocused !== document.body) {
-        dialogReturnFocus.set(element, previouslyFocused);
-    }
+    const returnFocus = previouslyFocused instanceof HTMLElement &&
+        previouslyFocused !== document.body
+        ? previouslyFocused
+        : undefined;
     element.show();
-    openDialogStack = Array.append(Array.filter(openDialogStack, dialog => dialog !== element), element);
+    openDialogStack = Array.append(Array.filter(openDialogStack, dialog => dialog.element !== element), { id, element });
     const handleKeydown = (event) => {
         if (!element.open) {
             return;
         }
-        const isTopmost = Option.exists(Array.last(openDialogStack), topmost => topmost === element);
+        const isTopmost = Option.exists(Array.last(openDialogStack), topmost => topmost.element === element);
         if (!isTopmost) {
             return;
         }
@@ -117,7 +118,10 @@ export const showModal = (selector, options) => Effect.gen(function* () {
         }), M.orElse(Function.constVoid));
     };
     document.addEventListener('keydown', handleKeydown);
-    dialogCleanups.set(element, () => document.removeEventListener('keydown', handleKeydown));
+    dialogHygieneById.set(id, {
+        removeKeydownListener: () => document.removeEventListener('keydown', handleKeydown),
+        returnFocus,
+    });
     if (options?.focusSelector) {
         const focusTarget = element.querySelector(options.focusSelector);
         if (focusTarget instanceof HTMLElement) {
@@ -142,36 +146,80 @@ const trapFocusWithinDialog = (event, dialog) => {
 };
 /**
  * Closes a dialog element using `.close()`.
- * Cleans up the keyboard handlers installed by `showModal` and restores focus to
+ * Cleans up the keyboard handlers installed by `showDialog` and restores focus to
  * the element that was focused before the dialog opened (the trigger, or the
  * dialog beneath it when closing a stacked dialog).
  * Fails with `ElementNotFound` if the selector does not match an `HTMLDialogElement`.
  *
  * @example
  * ```typescript
- * Dom.closeModal('#my-dialog')
+ * Dom.closeDialog('#my-dialog')
  * ```
  */
-export const closeModal = (selector) => Effect.suspend(() => {
+export const closeDialog = (selector) => Effect.suspend(() => {
     const element = document.querySelector(selector);
     if (element instanceof HTMLDialogElement) {
         element.close();
-        openDialogStack = Array.filter(openDialogStack, dialog => dialog !== element);
-        openDialogCount = Math.max(0, openDialogCount - 1);
-        const cleanup = dialogCleanups.get(element);
-        if (cleanup) {
-            cleanup();
-            dialogCleanups.delete(element);
-        }
-        const returnFocus = dialogReturnFocus.get(element);
-        dialogReturnFocus.delete(element);
-        if (returnFocus !== undefined && document.contains(returnFocus)) {
-            returnFocus.focus();
-        }
+        releaseDialogHygieneById(element.id);
         return Effect.void;
     }
     return Effect.fail(new ElementNotFound({ selector }));
 });
+const releaseDialogHygieneById = (id) => {
+    const hygiene = dialogHygieneById.get(id);
+    if (hygiene === undefined) {
+        return false;
+    }
+    openDialogStack = Array.filter(openDialogStack, dialog => dialog.id !== id);
+    openDialogCount = Math.max(0, Number.decrement(openDialogCount));
+    hygiene.removeKeydownListener();
+    dialogHygieneById.delete(id);
+    const { returnFocus } = hygiene;
+    if (returnFocus !== undefined && document.contains(returnFocus)) {
+        returnFocus.focus();
+    }
+    return true;
+};
+/**
+ * Releases the framework hygiene a dialog holds while open: the focus-trap
+ * keyboard handler, the recorded return focus, the dialog stack entry, the
+ * z-index counter, and one page scroll lock. Use this as a backstop for the
+ * case where a dialog's element is removed from the DOM without a purposeful
+ * close, the classic example being navigation away from a route-keyed subtree
+ * that contains the dialog. The normal close path (`closeDialog` plus the
+ * Dialog component's `unlockScroll` Command) already releases these, so this
+ * is the missing teardown when no close Message ever flows through `update`.
+ *
+ * Addressed by the dialog's id, not a selector, because the element is
+ * typically already gone from the DOM by the time this runs (that is the whole
+ * point of the backstop). The hygiene installed by `showDialog` is tracked by
+ * id so it can be reclaimed without a live element handle. The id must be
+ * non-empty and unique within the document, since it keys this cleanup
+ * accounting; a duplicate or empty id would release the wrong dialog's hygiene.
+ *
+ * Idempotent and exactly-once. It releases only when the dialog currently
+ * holds hygiene, then clears the per-dialog marker, so calling it after a
+ * normal close, or twice, is a no-op that never under-counts the shared
+ * scroll lock. Carries no application close semantics: the Dialog component
+ * owns the user-facing close (animation, `Closed` OutMessage, consumer
+ * Commands); this only reclaims framework resources.
+ *
+ * Resolves to `true` when it released resources, `false` when there was
+ * nothing to release. Never fails: an id with no held hygiene is a no-op,
+ * since the goal is reclaiming resources that may already be gone.
+ *
+ * @example
+ * ```typescript
+ * Dom.releaseDialogResources('my-dialog')
+ * ```
+ */
+export const releaseDialogResources = (id) => Effect.suspend(() => {
+    const released = releaseDialogHygieneById(id);
+    if (released) {
+        return Effect.as(unlockScroll, true);
+    }
+    return Effect.succeed(false);
+});
 /**
  * Programmatically clicks an element matching the given selector.
  * Fails with `ElementNotFound` if the selector does not match an `HTMLElement`.

package/dist/dom/index.d.ts

@@ -1,5 +1,5 @@
 export { ElementNotFound } from './error.js';
-export { advanceFocus, clickElement, closeModal, focus, scrollIntoView, scrollIntoViewAfterPaint, scrollIntoViewIfNotVisible, showModal, } from './dom.js';
+export { advanceFocus, clickElement, closeDialog, focus, releaseDialogResources, scrollIntoView, scrollIntoViewAfterPaint, scrollIntoViewIfNotVisible, showDialog, } from './dom.js';
 export type { FocusDirection } from './dom.js';
 export { detectElementMovement } from './elementMovement.js';
 export { inertOthers, restoreInert } from './inert.js';

package/dist/dom/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dom/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAC5C,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,KAAK,EACL,cAAc,EACd,wBAAwB,EACxB,0BAA0B,EAC1B,SAAS,GACV,MAAM,UAAU,CAAA;AACjB,YAAY,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACtD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dom/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAC5C,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,KAAK,EACL,sBAAsB,EACtB,cAAc,EACd,wBAAwB,EACxB,0BAA0B,EAC1B,UAAU,GACX,MAAM,UAAU,CAAA;AACjB,YAAY,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACtD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/dom/index.js

@@ -1,5 +1,5 @@
 export { ElementNotFound } from './error.js';
-export { advanceFocus, clickElement, closeModal, focus, scrollIntoView, scrollIntoViewAfterPaint, scrollIntoViewIfNotVisible, showModal, } from './dom.js';
+export { advanceFocus, clickElement, closeDialog, focus, releaseDialogResources, scrollIntoView, scrollIntoViewAfterPaint, scrollIntoViewIfNotVisible, showDialog, } from './dom.js';
 export { detectElementMovement } from './elementMovement.js';
 export { inertOthers, restoreInert } from './inert.js';
 export { lockScroll, unlockScroll } from './scrollLock.js';

package/dist/dom/public.d.ts

@@ -1,3 +1,3 @@
-export { ElementNotFound, advanceFocus, clickElement, closeModal, detectElementMovement, focus, inertOthers, lockScroll, restoreInert, scrollIntoView, scrollIntoViewAfterPaint, scrollIntoViewIfNotVisible, showModal, unlockScroll, waitForAnimationSettled, } from './index.js';
+export { ElementNotFound, advanceFocus, clickElement, closeDialog, detectElementMovement, focus, inertOthers, lockScroll, releaseDialogResources, restoreInert, scrollIntoView, scrollIntoViewAfterPaint, scrollIntoViewIfNotVisible, showDialog, unlockScroll, waitForAnimationSettled, } from './index.js';
 export type { FocusDirection } from './index.js';
 //# sourceMappingURL=public.d.ts.map

package/dist/dom/public.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../src/dom/public.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,qBAAqB,EACrB,KAAK,EACL,WAAW,EACX,UAAU,EACV,YAAY,EACZ,cAAc,EACd,wBAAwB,EACxB,0BAA0B,EAC1B,SAAS,EACT,YAAY,EACZ,uBAAuB,GACxB,MAAM,YAAY,CAAA;AACnB,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA"}
+{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../src/dom/public.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,qBAAqB,EACrB,KAAK,EACL,WAAW,EACX,UAAU,EACV,sBAAsB,EACtB,YAAY,EACZ,cAAc,EACd,wBAAwB,EACxB,0BAA0B,EAC1B,UAAU,EACV,YAAY,EACZ,uBAAuB,GACxB,MAAM,YAAY,CAAA;AACnB,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA"}

package/dist/dom/public.js

@@ -1 +1 @@
-export { ElementNotFound, advanceFocus, clickElement, closeModal, detectElementMovement, focus, inertOthers, lockScroll, restoreInert, scrollIntoView, scrollIntoViewAfterPaint, scrollIntoViewIfNotVisible, showModal, unlockScroll, waitForAnimationSettled, } from './index.js';
+export { ElementNotFound, advanceFocus, clickElement, closeDialog, detectElementMovement, focus, inertOthers, lockScroll, releaseDialogResources, restoreInert, scrollIntoView, scrollIntoViewAfterPaint, scrollIntoViewIfNotVisible, showDialog, unlockScroll, waitForAnimationSettled, } from './index.js';

package/dist/html/boundary.d.ts

@@ -91,6 +91,20 @@ export declare const markSeenForLazyHit: (registry: BoundaryRegistry, trackedIds
  *  rather than letting events from a destroyed boundary silently
  *  misroute. */
 export declare const deregisterBoundaryWrap: (registry: BoundaryRegistry, boundaryId: BoundaryId) => void;
+/** Resolves a message through `boundaryId`'s wrapping chain immediately,
+ *  applying every `toParentMessage` from innermost to outermost against the
+ *  wraps present right now, and returns a thunk that dispatches the fully
+ *  wrapped message via `outerDispatch`. Unlike {@link getOrCreateBoundaryDispatch},
+ *  which defers the chain lookup to fire time, this snapshots the chain at call
+ *  time so the resulting thunk survives the boundary being deregistered.
+ *
+ *  Used by `OnUnmount`: its destroy hook fires during the patch that tears the
+ *  boundary down, after the Submodel's own destroy hook has already removed the
+ *  wrap, so a fire-time lookup would throw. Resolving eagerly while the chain is
+ *  still live and dispatching the precomputed root message at destroy time
+ *  avoids that race. Throws here (at resolve time, boundary alive) if a wrap is
+ *  somehow already missing, surfacing a real corruption rather than misrouting. */
+export declare const resolveBoundaryDispatchThunk: (registry: BoundaryRegistry, outerDispatch: DispatchSync, boundaryId: BoundaryId, message: unknown) => (() => void);
 export declare const getOrCreateBoundaryDispatch: (registry: BoundaryRegistry, outerDispatch: DispatchSync, boundaryId: BoundaryId) => DispatchSync;
 /** Called at the start of each top-level render. Clears the
  *  per-render duplicate-slotId tracking map so siblings inside the

package/dist/html/boundary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"boundary.d.ts","sourceRoot":"","sources":["../../src/html/boundary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAEzD,wDAAwD;AACxD,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC;IACpC,eAAe,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAA;CAC/C,CAAC,CAAA;AAEF;;;;eAIe;AACf,MAAM,MAAM,UAAU,GAAG,MAAM,CAAA;AAI/B,eAAO,MAAM,aAAa,EAAE,UAAe,CAAA;AAE3C,eAAO,MAAM,eAAe,GAC1B,QAAQ,UAAU,EAClB,SAAS,MAAM,KACd,UAUF,CAAA;AAKD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAwCa;AACb,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,UAAU,EAAE,cAAc,CAAC,CAAA;IAC/C,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAClC,YAAY,EACZ,GAAG,CAAC,UAAU,EAAE,YAAY,CAAC,CAC9B,CAAA;IACD,QAAQ,CAAC,cAAc,EAAE,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;IAChD,QAAQ,CAAC,iBAAiB,EAAE,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAA;IAI1D,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CACjC,CAAA;AAED,eAAO,MAAM,sBAAsB,QAAO,gBAMxC,CAAA;AAqBF,eAAO,MAAM,oBAAoB,GAC/B,UAAU,gBAAgB,EAC1B,YAAY,UAAU,EACtB,YAAY,cAAc,KACzB,IA6BF,CAAA;AAED;;;;wCAIwC;AACxC,eAAO,MAAM,iBAAiB,GAC5B,UAAU,gBAAgB,KACzB,GAAG,CAAC,UAAU,EAAE,MAAM,CAIxB,CAAA;AAED;;yCAEyC;AACzC,eAAO,MAAM,eAAe,GAAI,UAAU,gBAAgB,KAAG,IAQ5D,CAAA;AAED;;;;;;;4CAO4C;AAC5C,eAAO,MAAM,kBAAkB,GAC7B,UAAU,gBAAgB,EAC1B,YAAY,WAAW,CAAC,UAAU,EAAE,MAAM,CAAC,KAC1C,IAWF,CAAA;AAED;;;;;;;;;gBASgB;AAChB,eAAO,MAAM,sBAAsB,GACjC,UAAU,gBAAgB,EAC1B,YAAY,UAAU,KACrB,IAEF,CAAA;AA8CD,eAAO,MAAM,2BAA2B,GACtC,UAAU,gBAAgB,EAC1B,eAAe,YAAY,EAC3B,YAAY,UAAU,KACrB,YAkBF,CAAA;AAED;;;;;;;;;;iEAUiE;AACjE,eAAO,MAAM,WAAW,GAAI,UAAU,gBAAgB,KAAG,IAGxD,CAAA"}
+{"version":3,"file":"boundary.d.ts","sourceRoot":"","sources":["../../src/html/boundary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAEzD,wDAAwD;AACxD,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC;IACpC,eAAe,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAA;CAC/C,CAAC,CAAA;AAEF;;;;eAIe;AACf,MAAM,MAAM,UAAU,GAAG,MAAM,CAAA;AAI/B,eAAO,MAAM,aAAa,EAAE,UAAe,CAAA;AAE3C,eAAO,MAAM,eAAe,GAC1B,QAAQ,UAAU,EAClB,SAAS,MAAM,KACd,UAUF,CAAA;AAKD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAwCa;AACb,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,UAAU,EAAE,cAAc,CAAC,CAAA;IAC/C,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAClC,YAAY,EACZ,GAAG,CAAC,UAAU,EAAE,YAAY,CAAC,CAC9B,CAAA;IACD,QAAQ,CAAC,cAAc,EAAE,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;IAChD,QAAQ,CAAC,iBAAiB,EAAE,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAA;IAI1D,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CACjC,CAAA;AAED,eAAO,MAAM,sBAAsB,QAAO,gBAMxC,CAAA;AAqBF,eAAO,MAAM,oBAAoB,GAC/B,UAAU,gBAAgB,EAC1B,YAAY,UAAU,EACtB,YAAY,cAAc,KACzB,IA6BF,CAAA;AAED;;;;wCAIwC;AACxC,eAAO,MAAM,iBAAiB,GAC5B,UAAU,gBAAgB,KACzB,GAAG,CAAC,UAAU,EAAE,MAAM,CAIxB,CAAA;AAED;;yCAEyC;AACzC,eAAO,MAAM,eAAe,GAAI,UAAU,gBAAgB,KAAG,IAQ5D,CAAA;AAED;;;;;;;4CAO4C;AAC5C,eAAO,MAAM,kBAAkB,GAC7B,UAAU,gBAAgB,EAC1B,YAAY,WAAW,CAAC,UAAU,EAAE,MAAM,CAAC,KAC1C,IAWF,CAAA;AAED;;;;;;;;;gBASgB;AAChB,eAAO,MAAM,sBAAsB,GACjC,UAAU,gBAAgB,EAC1B,YAAY,UAAU,KACrB,IAEF,CAAA;AA8CD;;;;;;;;;;;;mFAYmF;AACnF,eAAO,MAAM,4BAA4B,GACvC,UAAU,gBAAgB,EAC1B,eAAe,YAAY,EAC3B,YAAY,UAAU,EACtB,SAAS,OAAO,KACf,CAAC,MAAM,IAAI,CAqBb,CAAA;AAED,eAAO,MAAM,2BAA2B,GACtC,UAAU,gBAAgB,EAC1B,eAAe,YAAY,EAC3B,YAAY,UAAU,KACrB,YAkBF,CAAA;AAED;;;;;;;;;;iEAUiE;AACjE,eAAO,MAAM,WAAW,GAAI,UAAU,gBAAgB,KAAG,IAGxD,CAAA"}

package/dist/html/boundary.js

@@ -150,6 +150,39 @@ const dispatchAcrossBoundary = (registry, outerDispatch, boundaryId, message) =>
     }
     outerDispatch(wrapped);
 };
+/** Resolves a message through `boundaryId`'s wrapping chain immediately,
+ *  applying every `toParentMessage` from innermost to outermost against the
+ *  wraps present right now, and returns a thunk that dispatches the fully
+ *  wrapped message via `outerDispatch`. Unlike {@link getOrCreateBoundaryDispatch},
+ *  which defers the chain lookup to fire time, this snapshots the chain at call
+ *  time so the resulting thunk survives the boundary being deregistered.
+ *
+ *  Used by `OnUnmount`: its destroy hook fires during the patch that tears the
+ *  boundary down, after the Submodel's own destroy hook has already removed the
+ *  wrap, so a fire-time lookup would throw. Resolving eagerly while the chain is
+ *  still live and dispatching the precomputed root message at destroy time
+ *  avoids that race. Throws here (at resolve time, boundary alive) if a wrap is
+ *  somehow already missing, surfacing a real corruption rather than misrouting. */
+export const resolveBoundaryDispatchThunk = (registry, outerDispatch, boundaryId, message) => {
+    if (boundaryId === ROOT_BOUNDARY) {
+        return () => outerDispatch(message);
+    }
+    let wrapped = message;
+    const parts = splitBoundary(boundaryId);
+    for (let depth = parts.length; depth > 0; depth--) {
+        const ancestorBoundary = parts.slice(0, depth).join(BOUNDARY_SEPARATOR);
+        const descriptor = registry.wraps.get(ancestorBoundary);
+        if (descriptor === undefined) {
+            throw new Error(`Foldkit: resolveBoundaryDispatchThunk missing wrap for ancestor ` +
+                `"${ancestorBoundary}" of boundary "${boundaryId}" while resolving an ` +
+                `OnUnmount message. The Submodel's wrap was absent from the registry ` +
+                `at resolve time, which should not happen during a live render.`);
+        }
+        wrapped = descriptor.toParentMessage(wrapped);
+    }
+    const rootMessage = wrapped;
+    return () => outerDispatch(rootMessage);
+};
 export const getOrCreateBoundaryDispatch = (registry, outerDispatch, boundaryId) => {
     if (boundaryId === ROOT_BOUNDARY) {
         return outerDispatch;

package/dist/html/childAttribute.d.ts

@@ -7,6 +7,11 @@ declare const BRAND = "__childAttribute";
  *  produced these; the runtime routes each handler through the
  *  originating Submodel's wrap chain at event-fire time.
  *
+ *  `resolveUnmount` snapshots the boundary's wrapping chain at the time the
+ *  group was published (child boundary alive) so `OnUnmount` can dispatch a
+ *  root message from a destroy hook that fires after the boundary has been
+ *  torn down.
+ *
  *  Created via {@link childAttributes}. Element constructors accept
  *  `ChildAttribute` alongside `Attribute<Message>` in their attribute
  *  arrays. */
@@ -14,6 +19,7 @@ export type ChildAttribute = Readonly<{
     readonly [BRAND]: true;
     readonly attribute: unknown;
     readonly dispatch: DispatchSync;
+    readonly resolveUnmount: (message: unknown) => () => void;
 }>;
 export declare const isChildAttribute: (value: unknown) => value is ChildAttribute;
 /** Captures the current boundary's dispatcher and wraps each attribute

package/dist/html/childAttribute.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"childAttribute.d.ts","sourceRoot":"","sources":["../../src/html/childAttribute.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAmB,MAAM,uBAAuB,CAAA;AAE1E,QAAA,MAAM,KAAK,qBAAqB,CAAA;AAEhC;;;;;;;;;cASc;AACd,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC;IACpC,QAAQ,CAAC,CAAC,KAAK,CAAC,EAAE,IAAI,CAAA;IACtB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAA;CAChC,CAAC,CAAA;AAEF,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,cACI,CAAA;AAE/D;;;;;;;;;;;;;;;;;;;;;;oCAsBoC;AACpC,eAAO,MAAM,eAAe,GAAI,SAAS,EACvC,YAAY,aAAa,CAAC,SAAS,CAAC,KACnC,aAAa,CAAC,cAAc,CAO9B,CAAA"}
+{"version":3,"file":"childAttribute.d.ts","sourceRoot":"","sources":["../../src/html/childAttribute.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,YAAY,EAGlB,MAAM,uBAAuB,CAAA;AAE9B,QAAA,MAAM,KAAK,qBAAqB,CAAA;AAEhC;;;;;;;;;;;;;;cAcc;AACd,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC;IACpC,QAAQ,CAAC,CAAC,KAAK,CAAC,EAAE,IAAI,CAAA;IACtB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAA;IAC/B,QAAQ,CAAC,cAAc,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,IAAI,CAAA;CAC1D,CAAC,CAAA;AAEF,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,cACI,CAAA;AAE/D;;;;;;;;;;;;;;;;;;;;;;oCAsBoC;AACpC,eAAO,MAAM,eAAe,GAAI,SAAS,EACvC,YAAY,aAAa,CAAC,SAAS,CAAC,KACnC,aAAa,CAAC,cAAc,CAS9B,CAAA"}

package/dist/html/childAttribute.js

@@ -1,4 +1,4 @@
-import { requireDispatch } from './runtimeSingleton.js';
+import { requireDispatch, requireUnmountResolver, } from './runtimeSingleton.js';
 const BRAND = '__childAttribute';
 export const isChildAttribute = (value) => typeof value === 'object' && value !== null && BRAND in value;
 /** Captures the current boundary's dispatcher and wraps each attribute
@@ -26,9 +26,11 @@ export const isChildAttribute = (value) => typeof value === 'object' && value !=
  *  Submodel's `toParentMessage`. */
 export const childAttributes = (attributes) => {
     const dispatch = requireDispatch();
+    const resolveUnmount = requireUnmountResolver();
     return attributes.map(attribute => ({
         [BRAND]: true,
         attribute,
         dispatch,
+        resolveUnmount,
     }));
 };