foldkit 0.86.0 → 0.87.0

package/dist/devTools/overlay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"overlay.d.ts","sourceRoot":"","sources":["../../src/devTools/overlay.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,MAAM,EAGN,OAAO,EAGP,MAAM,EAUP,MAAM,QAAQ,CAAA;AAEf,OAAO,KAAK,OAAO,MAAM,qBAAqB,CAAA;AAW9C,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAQ3E,OAAO,EAAE,KAAK,aAAa,EAA+B,MAAM,YAAY,CAAA;AAqO5E,eAAO,MAAM,MAAM;;EAA0C,CAAA;AAC7D,eAAO,MAAM,YAAY;;;;;;EAGxB,CAAA;AACD,eAAO,MAAM,aAAa;;;;;;EAGzB,CAAA;AACD,eAAO,MAAM,MAAM;;EAA4C,CAAA;AAC/D,eAAO,MAAM,KAAK;;EAA0C,CAAA;AAC5D,eAAO,MAAM,UAAU;;EAA6C,CAAA;AACpE,eAAO,MAAM,YAAY;;EAAiD,CAAA;AAC1E,eAAO,MAAM,WAAW;;EAA+C,CAAA;AAs9CvE,eAAO,MAAM,aAAa,GACxB,OAAO,aAAa,EACpB,UAAU,gBAAgB,EAC1B,MAAM,YAAY,EAClB,aAAa,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,sCAoDhC,CAAA"}
+{"version":3,"file":"overlay.d.ts","sourceRoot":"","sources":["../../src/devTools/overlay.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,MAAM,EAGN,OAAO,EAGP,MAAM,EAUP,MAAM,QAAQ,CAAA;AAEf,OAAO,KAAK,OAAO,MAAM,qBAAqB,CAAA;AAY9C,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAO3E,OAAO,EAAE,KAAK,aAAa,EAA+B,MAAM,YAAY,CAAA;AAqO5E,eAAO,MAAM,MAAM;;EAA0C,CAAA;AAC7D,eAAO,MAAM,YAAY;;;;;;EAGxB,CAAA;AACD,eAAO,MAAM,aAAa;;;;;;EAGzB,CAAA;AACD,eAAO,MAAM,MAAM;;EAA4C,CAAA;AAC/D,eAAO,MAAM,KAAK;;EAA0C,CAAA;AAC5D,eAAO,MAAM,UAAU;;EAA6C,CAAA;AACpE,eAAO,MAAM,YAAY;;EAAiD,CAAA;AAC1E,eAAO,MAAM,WAAW;;EAA+C,CAAA;AAs9CvE,eAAO,MAAM,aAAa,GACxB,OAAO,aAAa,EACpB,UAAU,gBAAgB,EAC1B,MAAM,YAAY,EAClB,aAAa,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,sCAoDhC,CAAA"}

package/dist/devTools/overlay.js

@@ -1,13 +1,13 @@
 import { clsx } from 'clsx';
 import { Array as Array_, Effect, Equal, Function, HashSet, Match as M, Number as Number_, Option, Order, Predicate, Queue, Record, Schema as S, Stream, String as String_, SubscriptionRef, pipe, } from 'effect';
 import * as Command from '../command/index.js';
+import { lockScroll, unlockScroll } from '../dom/scrollLock.js';
 import { OptionExt } from '../effectExtensions/index.js';
 import { createKeyedLazy, createLazy, html, } from '../html/index.js';
 import { m } from '../message/index.js';
 import { makeProgram } from '../runtime/runtime.js';
 import { makeSubscriptions } from '../runtime/subscription.js';
 import { evo } from '../struct/index.js';
-import { lockScroll, unlockScroll } from '../task/scrollLock.js';
 import * as Listbox from '../ui/listbox/public.js';
 import * as Tabs from '../ui/tabs/public.js';
 import { overlayStyles } from './overlay-styles.js';

package/dist/{task → dom}/dom.d.ts

@@ -4,7 +4,7 @@ import { ElementNotFound } from './error.js';
  * Focuses an element matching the given selector after the next render has
  * committed.
  *
- * Use `Task.focus` inside a Command for focus that's caused by a Message
+ * Use `Dom.focus` inside a Command for focus that's caused by a Message
  * dispatching: a dialog opening, an input becoming the active step in a
  * form, returning focus to a trigger button after a popover closes,
  * keyboard navigation across a stable layout. The Command fires from
@@ -20,14 +20,14 @@ import { ElementNotFound } from './error.js';
  *
  * @example
  * ```typescript
- * Task.focus('#email-input').pipe(Effect.ignore, Effect.as(CompletedFocusInput()))
+ * Dom.focus('#email-input').pipe(Effect.ignore, Effect.as(CompletedFocusInput()))
  * ```
  */
 export declare const focus: (selector: string) => Effect.Effect<void, ElementNotFound>;
 /**
  * Opens a dialog element using `show()` with high z-index, focus trapping,
  * and Escape key handling. Uses `show()` instead of `showModal()` so that
- * DevTools (and any other high-z-index overlay) remains interactive — the
+ * DevTools (and any other high-z-index overlay) remains interactive. The
  * Dialog component provides its own backdrop, scroll locking, and transitions.
  * Fails with `ElementNotFound` if the selector does not match an `HTMLDialogElement`.
  *
@@ -35,8 +35,8 @@ export declare const focus: (selector: string) => Effect.Effect<void, ElementNot
  *
  * @example
  * ```typescript
- * Task.showModal('#my-dialog').pipe(Effect.ignore, Effect.as(CompletedShowDialog()))
- * Task.showModal('#my-dialog', { focusSelector: '#search-input' }).pipe(Effect.ignore, Effect.as(CompletedShowDialog()))
+ * Dom.showModal('#my-dialog').pipe(Effect.ignore, Effect.as(CompletedShowDialog()))
+ * Dom.showModal('#my-dialog', { focusSelector: '#search-input' }).pipe(Effect.ignore, Effect.as(CompletedShowDialog()))
  * ```
  */
 export declare const showModal: (selector: string, options?: Readonly<{
@@ -49,7 +49,7 @@ export declare const showModal: (selector: string, options?: Readonly<{
  *
  * @example
  * ```typescript
- * Task.closeModal('#my-dialog').pipe(Effect.ignore, Effect.as(CompletedCloseDialog()))
+ * Dom.closeModal('#my-dialog').pipe(Effect.ignore, Effect.as(CompletedCloseDialog()))
  * ```
  */
 export declare const closeModal: (selector: string) => Effect.Effect<void, ElementNotFound>;
@@ -59,7 +59,7 @@ export declare const closeModal: (selector: string) => Effect.Effect<void, Eleme
  *
  * @example
  * ```typescript
- * Task.clickElement('#menu-item-2').pipe(Effect.ignore, Effect.as(CompletedClickItem()))
+ * Dom.clickElement('#menu-item-2').pipe(Effect.ignore, Effect.as(CompletedClickItem()))
  * ```
  */
 export declare const clickElement: (selector: string) => Effect.Effect<void, ElementNotFound>;
@@ -69,11 +69,11 @@ export declare const clickElement: (selector: string) => Effect.Effect<void, Ele
  *
  * @example
  * ```typescript
- * Task.scrollIntoView('#active-item').pipe(Effect.ignore, Effect.as(CompletedScrollIntoView()))
+ * Dom.scrollIntoView('#active-item').pipe(Effect.ignore, Effect.as(CompletedScrollIntoView()))
  * ```
  */
 export declare const scrollIntoView: (selector: string) => Effect.Effect<void, ElementNotFound>;
-/** Direction for focus advancement — forward or backward in tab order. */
+/** Direction for focus advancement: forward or backward in tab order. */
 export type FocusDirection = 'Next' | 'Previous';
 /**
  * Focuses the next or previous focusable element in the document relative to the element matching the given selector.
@@ -81,7 +81,7 @@ export type FocusDirection = 'Next' | 'Previous';
  *
  * @example
  * ```typescript
- * Task.advanceFocus('#menu-button', 'Next').pipe(Effect.ignore, Effect.as(CompletedAdvanceFocus()))
+ * Dom.advanceFocus('#menu-button', 'Next').pipe(Effect.ignore, Effect.as(CompletedAdvanceFocus()))
  * ```
  */
 export declare const advanceFocus: (selector: string, direction: FocusDirection) => Effect.Effect<void, ElementNotFound>;

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

@@ -0,0 +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;AA6B5C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,KAAK,GAAI,UAAU,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,CAKxE,CAAA;AAEJ;;;;;;;;;;;;;;GAcG;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,CAgDlC,CAAA;AAuBJ;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU,GACrB,UAAU,MAAM,KACf,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,CAclC,CAAA;AAEJ;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,GACvB,UAAU,MAAM,KACf,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,CAKlC,CAAA;AAEJ;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,GACzB,UAAU,MAAM,KACf,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,CAKlC,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/{task → dom}/dom.js

@@ -1,6 +1,6 @@
 import { Array, Effect, Equal, Function, Match as M, Number, Option, } from 'effect';
+import { afterCommit } from '../render/render.js';
 import { ElementNotFound } from './error.js';
-import { afterRender } from './timing.js';
 const BASE_DIALOG_Z_INDEX = 2147483600;
 let openDialogCount = 0;
 const dialogCleanups = new WeakMap();
@@ -22,7 +22,7 @@ const queryHTMLElement = (selector) => Effect.suspend(() => {
  * Focuses an element matching the given selector after the next render has
  * committed.
  *
- * Use `Task.focus` inside a Command for focus that's caused by a Message
+ * Use `Dom.focus` inside a Command for focus that's caused by a Message
  * dispatching: a dialog opening, an input becoming the active step in a
  * form, returning focus to a trigger button after a popover closes,
  * keyboard navigation across a stable layout. The Command fires from
@@ -38,18 +38,18 @@ const queryHTMLElement = (selector) => Effect.suspend(() => {
  *
  * @example
  * ```typescript
- * Task.focus('#email-input').pipe(Effect.ignore, Effect.as(CompletedFocusInput()))
+ * Dom.focus('#email-input').pipe(Effect.ignore, Effect.as(CompletedFocusInput()))
  * ```
  */
 export const focus = (selector) => Effect.gen(function* () {
-    yield* afterRender;
+    yield* afterCommit;
     const element = yield* queryHTMLElement(selector);
     element.focus();
 });
 /**
  * Opens a dialog element using `show()` with high z-index, focus trapping,
  * and Escape key handling. Uses `show()` instead of `showModal()` so that
- * DevTools (and any other high-z-index overlay) remains interactive — the
+ * DevTools (and any other high-z-index overlay) remains interactive. The
  * Dialog component provides its own backdrop, scroll locking, and transitions.
  * Fails with `ElementNotFound` if the selector does not match an `HTMLDialogElement`.
  *
@@ -57,12 +57,12 @@ export const focus = (selector) => Effect.gen(function* () {
  *
  * @example
  * ```typescript
- * Task.showModal('#my-dialog').pipe(Effect.ignore, Effect.as(CompletedShowDialog()))
- * Task.showModal('#my-dialog', { focusSelector: '#search-input' }).pipe(Effect.ignore, Effect.as(CompletedShowDialog()))
+ * Dom.showModal('#my-dialog').pipe(Effect.ignore, Effect.as(CompletedShowDialog()))
+ * Dom.showModal('#my-dialog', { focusSelector: '#search-input' }).pipe(Effect.ignore, Effect.as(CompletedShowDialog()))
  * ```
  */
 export const showModal = (selector, options) => Effect.gen(function* () {
-    yield* afterRender;
+    yield* afterCommit;
     const element = document.querySelector(selector);
     if (!(element instanceof HTMLDialogElement)) {
         return yield* Effect.fail(new ElementNotFound({ selector }));
@@ -117,7 +117,7 @@ const trapFocusWithinDialog = (event, dialog) => {
  *
  * @example
  * ```typescript
- * Task.closeModal('#my-dialog').pipe(Effect.ignore, Effect.as(CompletedCloseDialog()))
+ * Dom.closeModal('#my-dialog').pipe(Effect.ignore, Effect.as(CompletedCloseDialog()))
  * ```
  */
 export const closeModal = (selector) => Effect.suspend(() => {
@@ -140,11 +140,11 @@ export const closeModal = (selector) => Effect.suspend(() => {
  *
  * @example
  * ```typescript
- * Task.clickElement('#menu-item-2').pipe(Effect.ignore, Effect.as(CompletedClickItem()))
+ * Dom.clickElement('#menu-item-2').pipe(Effect.ignore, Effect.as(CompletedClickItem()))
  * ```
  */
 export const clickElement = (selector) => Effect.gen(function* () {
-    yield* afterRender;
+    yield* afterCommit;
     const element = yield* queryHTMLElement(selector);
     element.click();
 });
@@ -154,11 +154,11 @@ export const clickElement = (selector) => Effect.gen(function* () {
  *
  * @example
  * ```typescript
- * Task.scrollIntoView('#active-item').pipe(Effect.ignore, Effect.as(CompletedScrollIntoView()))
+ * Dom.scrollIntoView('#active-item').pipe(Effect.ignore, Effect.as(CompletedScrollIntoView()))
  * ```
  */
 export const scrollIntoView = (selector) => Effect.gen(function* () {
-    yield* afterRender;
+    yield* afterCommit;
     const element = yield* queryHTMLElement(selector);
     element.scrollIntoView({ block: 'nearest' });
 });
@@ -168,11 +168,11 @@ export const scrollIntoView = (selector) => Effect.gen(function* () {
  *
  * @example
  * ```typescript
- * Task.advanceFocus('#menu-button', 'Next').pipe(Effect.ignore, Effect.as(CompletedAdvanceFocus()))
+ * Dom.advanceFocus('#menu-button', 'Next').pipe(Effect.ignore, Effect.as(CompletedAdvanceFocus()))
  * ```
  */
 export const advanceFocus = (selector, direction) => Effect.gen(function* () {
-    yield* afterRender;
+    yield* afterCommit;
     const reference = yield* queryHTMLElement(selector);
     const focusableElements = Array.fromIterable(document.querySelectorAll(FOCUSABLE_SELECTOR));
     const referenceElementIndex = Array.findFirstIndex(focusableElements, Equal.equals(reference));

package/dist/{task → dom}/elementMovement.d.ts

@@ -12,7 +12,7 @@ import { Effect } from 'effect';
  *
  * @example
  * ```typescript
- * Task.detectElementMovement('#menu-button').pipe(
+ * Dom.detectElementMovement('#menu-button').pipe(
  *   Effect.as(DetectedButtonMovement()),
  * )
  * ```

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

@@ -0,0 +1 @@
+{"version":3,"file":"elementMovement.d.ts","sourceRoot":"","sources":["../../src/dom/elementMovement.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAM/B;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,qBAAqB,GAAI,UAAU,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAmCvE,CAAA"}

package/dist/{task → dom}/elementMovement.js

@@ -1,5 +1,5 @@
 import { Effect } from 'effect';
-import { afterRender } from './timing.js';
+import { afterCommit } from '../render/render.js';
 const rectToPosition = (rect) => `${rect.x},${rect.y}`;
 /**
  * Detects if the element matching the given selector moves in the viewport.
@@ -14,13 +14,13 @@ const rectToPosition = (rect) => `${rect.x},${rect.y}`;
  *
  * @example
  * ```typescript
- * Task.detectElementMovement('#menu-button').pipe(
+ * Dom.detectElementMovement('#menu-button').pipe(
  *   Effect.as(DetectedButtonMovement()),
  * )
  * ```
  */
 export const detectElementMovement = (selector) => Effect.gen(function* () {
-    yield* afterRender;
+    yield* afterCommit;
     return yield* Effect.callback((resume, signal) => {
         const element = document.querySelector(selector);
         if (!(element instanceof HTMLElement)) {

package/dist/{task → dom}/error.d.ts

@@ -6,13 +6,5 @@ export declare class ElementNotFound extends ElementNotFound_base<{
     readonly selector: string;
 }> {
 }
-declare const TimeZoneError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
-    readonly _tag: "TimeZoneError";
-} & Readonly<A>;
-/** Error indicating that the given timezone ID is invalid. */
-export declare class TimeZoneError extends TimeZoneError_base<{
-    readonly zoneId: string;
-}> {
-}
 export {};
 //# sourceMappingURL=error.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/dom/error.ts"],"names":[],"mappings":";;;AAEA,qFAAqF;AACrF,qBAAa,eAAgB,SAAQ,qBAAoC;IACvE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B,CAAC;CAAG"}

package/dist/{task → dom}/error.js

@@ -2,6 +2,3 @@ import { Data } from 'effect';
 /** Error indicating that a DOM element matching the given selector was not found. */
 export class ElementNotFound extends Data.TaggedError('ElementNotFound') {
 }
-/** Error indicating that the given timezone ID is invalid. */
-export class TimeZoneError extends Data.TaggedError('TimeZoneError') {
-}

package/dist/dom/index.d.ts

@@ -0,0 +1,8 @@
+export { ElementNotFound } from './error.js';
+export { advanceFocus, clickElement, closeModal, focus, scrollIntoView, showModal, } from './dom.js';
+export type { FocusDirection } from './dom.js';
+export { detectElementMovement } from './elementMovement.js';
+export { inertOthers, restoreInert } from './inert.js';
+export { lockScroll, unlockScroll } from './scrollLock.js';
+export { waitForAnimationSettled } from './waitForAnimation.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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,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"}

package/dist/dom/index.js

@@ -0,0 +1,6 @@
+export { ElementNotFound } from './error.js';
+export { advanceFocus, clickElement, closeModal, focus, scrollIntoView, showModal, } from './dom.js';
+export { detectElementMovement } from './elementMovement.js';
+export { inertOthers, restoreInert } from './inert.js';
+export { lockScroll, unlockScroll } from './scrollLock.js';
+export { waitForAnimationSettled } from './waitForAnimation.js';

package/dist/{task → dom}/inert.d.ts

@@ -7,7 +7,7 @@ import { Effect } from 'effect';
  *
  * @example
  * ```typescript
- * Task.inertOthers('my-menu', ['#menu-button', '#menu-items']).pipe(
+ * Dom.inertOthers('my-menu', ['#menu-button', '#menu-items']).pipe(
  *   Effect.as(CompletedSetupInert()),
  * )
  * ```
@@ -15,11 +15,12 @@ import { Effect } from 'effect';
 export declare const inertOthers: (id: string, allowedSelectors: ReadonlyArray<string>) => Effect.Effect<void>;
 /**
  * Restores all elements previously marked inert by `inertOthers` for the
- * given ID. Safe to call without a preceding `inertOthers` — acts as a no-op.
+ * given ID. Safe to call without a preceding `inertOthers`. Acts as a no-op
+ * in that case.
  *
  * @example
  * ```typescript
- * Task.restoreInert('my-menu').pipe(Effect.as(CompletedTeardownInert()))
+ * Dom.restoreInert('my-menu').pipe(Effect.as(CompletedTeardownInert()))
  * ```
  */
 export declare const restoreInert: (id: string) => Effect.Effect<void>;

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

@@ -0,0 +1 @@
+{"version":3,"file":"inert.d.ts","sourceRoot":"","sources":["../../src/dom/inert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,MAAM,EAA2C,MAAM,QAAQ,CAAA;AAuF/E;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,WAAW,GACtB,IAAI,MAAM,EACV,kBAAkB,aAAa,CAAC,MAAM,CAAC,KACtC,MAAM,CAAC,MAAM,CAAC,IAAI,CAajB,CAAA;AAEJ;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY,GAAI,IAAI,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAQxD,CAAA"}

package/dist/{task → dom}/inert.js

@@ -56,7 +56,7 @@ const inertableSiblings = (parent, allowedElements) => pipe(parent.children, Arr
  *
  * @example
  * ```typescript
- * Task.inertOthers('my-menu', ['#menu-button', '#menu-items']).pipe(
+ * Dom.inertOthers('my-menu', ['#menu-button', '#menu-items']).pipe(
  *   Effect.as(CompletedSetupInert()),
  * )
  * ```
@@ -68,11 +68,12 @@ export const inertOthers = (id, allowedSelectors) => Effect.sync(() => {
 });
 /**
  * Restores all elements previously marked inert by `inertOthers` for the
- * given ID. Safe to call without a preceding `inertOthers` — acts as a no-op.
+ * given ID. Safe to call without a preceding `inertOthers`. Acts as a no-op
+ * in that case.
  *
  * @example
  * ```typescript
- * Task.restoreInert('my-menu').pipe(Effect.as(CompletedTeardownInert()))
+ * Dom.restoreInert('my-menu').pipe(Effect.as(CompletedTeardownInert()))
  * ```
  */
 export const restoreInert = (id) => Effect.sync(() => {

package/dist/dom/public.d.ts

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

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

@@ -0,0 +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,SAAS,EACT,YAAY,EACZ,uBAAuB,GACxB,MAAM,YAAY,CAAA;AACnB,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA"}

package/dist/dom/public.js

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

package/dist/{task → dom}/scrollLock.d.ts

@@ -4,12 +4,12 @@ import { Effect } from 'effect';
  * Compensates for scrollbar width with padding to prevent layout shift.
  * On iOS Safari, intercepts `touchmove` events to prevent page scroll
  * while allowing scrolling within overflow containers.
- * Uses reference counting so nested locks are safe — the page only unlocks
+ * Uses reference counting so nested locks are safe. The page only unlocks
  * when every lock has been released.
  *
  * @example
  * ```typescript
- * Task.lockScroll.pipe(Effect.as(CompletedLockScroll()))
+ * Dom.lockScroll.pipe(Effect.as(CompletedLockScroll()))
  * ```
  */
 export declare const lockScroll: Effect.Effect<void>;
@@ -20,7 +20,7 @@ export declare const lockScroll: Effect.Effect<void>;
  *
  * @example
  * ```typescript
- * Task.unlockScroll.pipe(Effect.as(CompletedUnlockScroll()))
+ * Dom.unlockScroll.pipe(Effect.as(CompletedUnlockScroll()))
  * ```
  */
 export declare const unlockScroll: Effect.Effect<void>;

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

@@ -0,0 +1 @@
+{"version":3,"file":"scrollLock.d.ts","sourceRoot":"","sources":["../../src/dom/scrollLock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAU,MAAM,QAAQ,CAAA;AA6CvC;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAwBzC,CAAA;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAW3C,CAAA"}

package/dist/{task → dom}/scrollLock.js

@@ -41,12 +41,12 @@ const handleTouchMove = (event) => {
  * Compensates for scrollbar width with padding to prevent layout shift.
  * On iOS Safari, intercepts `touchmove` events to prevent page scroll
  * while allowing scrolling within overflow containers.
- * Uses reference counting so nested locks are safe — the page only unlocks
+ * Uses reference counting so nested locks are safe. The page only unlocks
  * when every lock has been released.
  *
  * @example
  * ```typescript
- * Task.lockScroll.pipe(Effect.as(CompletedLockScroll()))
+ * Dom.lockScroll.pipe(Effect.as(CompletedLockScroll()))
  * ```
  */
 export const lockScroll = Effect.sync(() => {
@@ -73,7 +73,7 @@ export const lockScroll = Effect.sync(() => {
  *
  * @example
  * ```typescript
- * Task.unlockScroll.pipe(Effect.as(CompletedUnlockScroll()))
+ * Dom.unlockScroll.pipe(Effect.as(CompletedUnlockScroll()))
  * ```
  */
 export const unlockScroll = Effect.sync(() => {

package/dist/dom/waitForAnimation.d.ts

@@ -0,0 +1,17 @@
+import { Effect } from 'effect';
+/**
+ * Waits for all CSS animations on the element matching the selector to settle.
+ * Covers both CSS transitions and CSS keyframe animations via the Web Animations
+ * API. Falls back to completing immediately if the element is missing or has no
+ * active animations.
+ *
+ * Leave animations must be finite. `animation-iteration-count: infinite` will
+ * keep the underlying `.finished` promise pending and hang the caller.
+ *
+ * @example
+ * ```typescript
+ * Dom.waitForAnimationSettled('#menu-items').pipe(Effect.as(EndedAnimation()))
+ * ```
+ */
+export declare const waitForAnimationSettled: (selector: string) => Effect.Effect<void>;
+//# sourceMappingURL=waitForAnimation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"waitForAnimation.d.ts","sourceRoot":"","sources":["../../src/dom/waitForAnimation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE/B;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,uBAAuB,GAClC,UAAU,MAAM,KACf,MAAM,CAAC,MAAM,CAAC,IAAI,CAYjB,CAAA"}

package/dist/dom/waitForAnimation.js

@@ -0,0 +1,23 @@
+import { Effect } from 'effect';
+/**
+ * Waits for all CSS animations on the element matching the selector to settle.
+ * Covers both CSS transitions and CSS keyframe animations via the Web Animations
+ * API. Falls back to completing immediately if the element is missing or has no
+ * active animations.
+ *
+ * Leave animations must be finite. `animation-iteration-count: infinite` will
+ * keep the underlying `.finished` promise pending and hang the caller.
+ *
+ * @example
+ * ```typescript
+ * Dom.waitForAnimationSettled('#menu-items').pipe(Effect.as(EndedAnimation()))
+ * ```
+ */
+export const waitForAnimationSettled = (selector) => Effect.callback(resume => {
+    requestAnimationFrame(async () => {
+        const element = document.querySelector(selector);
+        const animations = element instanceof HTMLElement ? element.getAnimations() : [];
+        await Promise.allSettled(animations.map(({ finished }) => finished));
+        resume(Effect.void);
+    });
+});

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export * as Calendar from './calendar/public.js';
 export * as Command from './command/public.js';
+export * as Dom from './dom/public.js';
 export * as ManagedResource from './managedResource/public.js';
 export * as FieldValidation from './fieldValidation/public.js';
 export * as File from './file/public.js';
@@ -7,12 +8,12 @@ export * as Html from './html/public.js';
 export * as Message from './message/public.js';
 export * as Mount from './mount/public.js';
 export * as Navigation from './navigation/public.js';
+export * as Render from './render/public.js';
 export * as Route from './route/public.js';
 export * as Runtime from './runtime/public.js';
 export * as Schema from './schema/public.js';
 export * as Struct from './struct/public.js';
 export * as Subscription from './subscription/public.js';
-export * as Task from './task/public.js';
 export * as Scene from './test/scene.js';
 export * as Story from './test/story.js';
 export * as Ui from './ui/index.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,sBAAsB,CAAA;AAChD,OAAO,KAAK,OAAO,MAAM,qBAAqB,CAAA;AAC9C,OAAO,KAAK,eAAe,MAAM,6BAA6B,CAAA;AAC9D,OAAO,KAAK,eAAe,MAAM,6BAA6B,CAAA;AAC9D,OAAO,KAAK,IAAI,MAAM,kBAAkB,CAAA;AACxC,OAAO,KAAK,IAAI,MAAM,kBAAkB,CAAA;AACxC,OAAO,KAAK,OAAO,MAAM,qBAAqB,CAAA;AAC9C,OAAO,KAAK,KAAK,MAAM,mBAAmB,CAAA;AAC1C,OAAO,KAAK,UAAU,MAAM,wBAAwB,CAAA;AACpD,OAAO,KAAK,KAAK,MAAM,mBAAmB,CAAA;AAC1C,OAAO,KAAK,OAAO,MAAM,qBAAqB,CAAA;AAC9C,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAA;AAC5C,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAA;AAC5C,OAAO,KAAK,YAAY,MAAM,0BAA0B,CAAA;AACxD,OAAO,KAAK,IAAI,MAAM,kBAAkB,CAAA;AACxC,OAAO,KAAK,KAAK,MAAM,iBAAiB,CAAA;AACxC,OAAO,KAAK,KAAK,MAAM,iBAAiB,CAAA;AACxC,OAAO,KAAK,EAAE,MAAM,eAAe,CAAA;AACnC,OAAO,KAAK,GAAG,MAAM,iBAAiB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,sBAAsB,CAAA;AAChD,OAAO,KAAK,OAAO,MAAM,qBAAqB,CAAA;AAC9C,OAAO,KAAK,GAAG,MAAM,iBAAiB,CAAA;AACtC,OAAO,KAAK,eAAe,MAAM,6BAA6B,CAAA;AAC9D,OAAO,KAAK,eAAe,MAAM,6BAA6B,CAAA;AAC9D,OAAO,KAAK,IAAI,MAAM,kBAAkB,CAAA;AACxC,OAAO,KAAK,IAAI,MAAM,kBAAkB,CAAA;AACxC,OAAO,KAAK,OAAO,MAAM,qBAAqB,CAAA;AAC9C,OAAO,KAAK,KAAK,MAAM,mBAAmB,CAAA;AAC1C,OAAO,KAAK,UAAU,MAAM,wBAAwB,CAAA;AACpD,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAA;AAC5C,OAAO,KAAK,KAAK,MAAM,mBAAmB,CAAA;AAC1C,OAAO,KAAK,OAAO,MAAM,qBAAqB,CAAA;AAC9C,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAA;AAC5C,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAA;AAC5C,OAAO,KAAK,YAAY,MAAM,0BAA0B,CAAA;AACxD,OAAO,KAAK,KAAK,MAAM,iBAAiB,CAAA;AACxC,OAAO,KAAK,KAAK,MAAM,iBAAiB,CAAA;AACxC,OAAO,KAAK,EAAE,MAAM,eAAe,CAAA;AACnC,OAAO,KAAK,GAAG,MAAM,iBAAiB,CAAA"}

package/dist/index.js

@@ -1,5 +1,6 @@
 export * as Calendar from './calendar/public.js';
 export * as Command from './command/public.js';
+export * as Dom from './dom/public.js';
 export * as ManagedResource from './managedResource/public.js';
 export * as FieldValidation from './fieldValidation/public.js';
 export * as File from './file/public.js';
@@ -7,12 +8,12 @@ export * as Html from './html/public.js';
 export * as Message from './message/public.js';
 export * as Mount from './mount/public.js';
 export * as Navigation from './navigation/public.js';
+export * as Render from './render/public.js';
 export * as Route from './route/public.js';
 export * as Runtime from './runtime/public.js';
 export * as Schema from './schema/public.js';
 export * as Struct from './struct/public.js';
 export * as Subscription from './subscription/public.js';
-export * as Task from './task/public.js';
 export * as Scene from './test/scene.js';
 export * as Story from './test/story.js';
 export * as Ui from './ui/index.js';

package/dist/render/index.d.ts

@@ -0,0 +1,2 @@
+export { afterCommit, afterPaint } from './render.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/render/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA"}

package/dist/render/index.js

@@ -0,0 +1 @@
+export { afterCommit, afterPaint } from './render.js';

package/dist/render/public.d.ts

@@ -0,0 +1,2 @@
+export { afterCommit, afterPaint } from './index.js';
+//# sourceMappingURL=public.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../src/render/public.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA"}

package/dist/render/public.js

@@ -0,0 +1 @@
+export { afterCommit, afterPaint } from './index.js';

package/dist/render/render.d.ts

@@ -0,0 +1,40 @@
+import { Effect } from 'effect';
+/**
+ * Completes after the runtime's next render commits. The runtime batches
+ * renders to `requestAnimationFrame`, so a Command, Subscription, or other
+ * Effect that runs immediately after a dirtying Message would otherwise
+ * query the DOM before the matching VDOM patch has applied. Yield this
+ * before any DOM read or write whose target was just brought into existence
+ * (or moved, or had its attributes changed) by the same Message.
+ *
+ * The `Dom` helpers (`focus`, `clickElement`, `scrollIntoView`, etc.)
+ * already gate themselves with this internally; reach for `afterCommit`
+ * directly when building custom Commands or DOM-observing Subscriptions
+ * that need the same guarantee.
+ *
+ * @example
+ * ```typescript
+ * Effect.gen(function* () {
+ *   yield* Render.afterCommit
+ *   const element = document.getElementById(id)
+ *   // element reflects the post-Message DOM
+ * })
+ * ```
+ */
+export declare const afterCommit: Effect.Effect<void>;
+/**
+ * Completes after the prior state has been painted to the screen. Waits two
+ * animation frames: the first lets the runtime commit the latest model to
+ * the DOM and the browser paint it, the second resumes once that paint is
+ * visible. Use this for CSS transition orchestration where the from-state
+ * must be displayed before the to-state changes are applied, otherwise the
+ * browser collapses both states into a single frame and the transition does
+ * not play.
+ *
+ * @example
+ * ```typescript
+ * Render.afterPaint.pipe(Effect.as(TransitionFrameAdvanced()))
+ * ```
+ */
+export declare const afterPaint: Effect.Effect<void>;
+//# sourceMappingURL=render.d.ts.map

package/dist/render/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/render/render.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE/B;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAK3C,CAAA;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAMzC,CAAA"}

package/dist/render/render.js

@@ -0,0 +1,48 @@
+import { Effect } from 'effect';
+/**
+ * Completes after the runtime's next render commits. The runtime batches
+ * renders to `requestAnimationFrame`, so a Command, Subscription, or other
+ * Effect that runs immediately after a dirtying Message would otherwise
+ * query the DOM before the matching VDOM patch has applied. Yield this
+ * before any DOM read or write whose target was just brought into existence
+ * (or moved, or had its attributes changed) by the same Message.
+ *
+ * The `Dom` helpers (`focus`, `clickElement`, `scrollIntoView`, etc.)
+ * already gate themselves with this internally; reach for `afterCommit`
+ * directly when building custom Commands or DOM-observing Subscriptions
+ * that need the same guarantee.
+ *
+ * @example
+ * ```typescript
+ * Effect.gen(function* () {
+ *   yield* Render.afterCommit
+ *   const element = document.getElementById(id)
+ *   // element reflects the post-Message DOM
+ * })
+ * ```
+ */
+export const afterCommit = Effect.callback(resume => {
+    const handle = requestAnimationFrame(() => resume(Effect.void));
+    return Effect.sync(() => cancelAnimationFrame(handle));
+});
+/**
+ * Completes after the prior state has been painted to the screen. Waits two
+ * animation frames: the first lets the runtime commit the latest model to
+ * the DOM and the browser paint it, the second resumes once that paint is
+ * visible. Use this for CSS transition orchestration where the from-state
+ * must be displayed before the to-state changes are applied, otherwise the
+ * browser collapses both states into a single frame and the transition does
+ * not play.
+ *
+ * @example
+ * ```typescript
+ * Render.afterPaint.pipe(Effect.as(TransitionFrameAdvanced()))
+ * ```
+ */
+export const afterPaint = Effect.callback(resume => {
+    requestAnimationFrame(() => {
+        requestAnimationFrame(() => {
+            resume(Effect.void);
+        });
+    });
+});

package/dist/ui/animation/update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/ui/animation/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,MAAM,EAAE,MAAM,QAAQ,CAAA;AAEnD,OAAO,KAAK,OAAO,MAAM,wBAAwB,CAAA;AAGjD,OAAO,EAGL,KAAK,OAAO,EACZ,KAAK,KAAK,EACV,KAAK,UAAU,EAGhB,MAAM,aAAa,CAAA;AAMpB,KAAK,YAAY,GAAG,SAAS;IAC3B,KAAK;IACL,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC;CAC1B,CAAA;AAGD,kEAAkE;AAClE,eAAO,MAAM,YAAY;;EAGxB,CAAA;AACD,sHAAsH;AACtH,eAAO,MAAM,uBAAuB;;EAGnC,CAAA;AAED,oGAAoG;AACpG,eAAO,MAAM,MAAM,GAAI,OAAO,KAAK,EAAE,SAAS,OAAO,KAAG,YAiFvD,CAAA;AAED,2NAA2N;AAC3N,eAAO,MAAM,mBAAmB,GAAI,OAAO,KAAK,KAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAKvE,CAAA"}
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/ui/animation/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,MAAM,EAAE,MAAM,QAAQ,CAAA;AAEnD,OAAO,KAAK,OAAO,MAAM,wBAAwB,CAAA;AAIjD,OAAO,EAGL,KAAK,OAAO,EACZ,KAAK,KAAK,EACV,KAAK,UAAU,EAGhB,MAAM,aAAa,CAAA;AAMpB,KAAK,YAAY,GAAG,SAAS;IAC3B,KAAK;IACL,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC;CAC1B,CAAA;AAGD,kEAAkE;AAClE,eAAO,MAAM,YAAY;;EAGxB,CAAA;AACD,sHAAsH;AACtH,eAAO,MAAM,uBAAuB;;EAGnC,CAAA;AAED,oGAAoG;AACpG,eAAO,MAAM,MAAM,GAAI,OAAO,KAAK,EAAE,SAAS,OAAO,KAAG,YAiFvD,CAAA;AAED,2NAA2N;AAC3N,eAAO,MAAM,mBAAmB,GAAI,OAAO,KAAK,KAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAKvE,CAAA"}