foldkit 0.85.0 → 0.86.0

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

@@ -1 +1 @@
-{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../../src/task/dom.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,MAAM,EAMP,MAAM,QAAQ,CAAA;AAEf,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAsC5C;;;;;;;;;;;;;;;;;;;;;;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,0EAA0E;AAC1E,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/task/dom.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,MAAM,EAMP,MAAM,QAAQ,CAAA;AAEf,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AA8B5C;;;;;;;;;;;;;;;;;;;;;;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,0EAA0E;AAC1E,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.js

@@ -1,5 +1,6 @@
 import { Array, Effect, Equal, Function, Match as M, Number, Option, } from 'effect';
 import { ElementNotFound } from './error.js';
+import { afterRender } from './timing.js';
 const BASE_DIALOG_Z_INDEX = 2147483600;
 let openDialogCount = 0;
 const dialogCleanups = new WeakMap();
@@ -11,14 +12,6 @@ const FOCUSABLE_SELECTOR = Array.join([
     'textarea:not([disabled]):not([tabindex="-1"])',
     '[tabindex]:not([tabindex="-1"])',
 ], ', ');
-// NOTE: DOM tasks await one rAF before walking the tree. The runtime defers
-// renders to the next animation frame and forks Commands on the microtask
-// queue, so without this wait a Task that runs immediately after a dirtying
-// Message would query the DOM before the matching VDOM patch has committed.
-const awaitNextFrame = Effect.callback(resume => {
-    const handle = requestAnimationFrame(() => resume(Effect.void));
-    return Effect.sync(() => cancelAnimationFrame(handle));
-});
 const queryHTMLElement = (selector) => Effect.suspend(() => {
     const element = document.querySelector(selector);
     return element instanceof HTMLElement
@@ -49,7 +42,7 @@ const queryHTMLElement = (selector) => Effect.suspend(() => {
  * ```
  */
 export const focus = (selector) => Effect.gen(function* () {
-    yield* awaitNextFrame;
+    yield* afterRender;
     const element = yield* queryHTMLElement(selector);
     element.focus();
 });
@@ -69,7 +62,7 @@ export const focus = (selector) => Effect.gen(function* () {
  * ```
  */
 export const showModal = (selector, options) => Effect.gen(function* () {
-    yield* awaitNextFrame;
+    yield* afterRender;
     const element = document.querySelector(selector);
     if (!(element instanceof HTMLDialogElement)) {
         return yield* Effect.fail(new ElementNotFound({ selector }));
@@ -151,7 +144,7 @@ export const closeModal = (selector) => Effect.suspend(() => {
  * ```
  */
 export const clickElement = (selector) => Effect.gen(function* () {
-    yield* awaitNextFrame;
+    yield* afterRender;
     const element = yield* queryHTMLElement(selector);
     element.click();
 });
@@ -165,7 +158,7 @@ export const clickElement = (selector) => Effect.gen(function* () {
  * ```
  */
 export const scrollIntoView = (selector) => Effect.gen(function* () {
-    yield* awaitNextFrame;
+    yield* afterRender;
     const element = yield* queryHTMLElement(selector);
     element.scrollIntoView({ block: 'nearest' });
 });
@@ -179,7 +172,7 @@ export const scrollIntoView = (selector) => Effect.gen(function* () {
  * ```
  */
 export const advanceFocus = (selector, direction) => Effect.gen(function* () {
-    yield* awaitNextFrame;
+    yield* afterRender;
     const reference = yield* queryHTMLElement(selector);
     const focusableElements = Array.fromIterable(document.querySelectorAll(FOCUSABLE_SELECTOR));
     const referenceElementIndex = Array.findFirstIndex(focusableElements, Equal.equals(reference));

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

@@ -1 +1 @@
-{"version":3,"file":"elementMovement.d.ts","sourceRoot":"","sources":["../../src/task/elementMovement.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAI/B;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,qBAAqB,GAAI,UAAU,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAqCvE,CAAA"}
+{"version":3,"file":"elementMovement.d.ts","sourceRoot":"","sources":["../../src/task/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/elementMovement.js

@@ -1,4 +1,5 @@
 import { Effect } from 'effect';
+import { afterRender } from './timing.js';
 const rectToPosition = (rect) => `${rect.x},${rect.y}`;
 /**
  * Detects if the element matching the given selector moves in the viewport.
@@ -18,11 +19,9 @@ const rectToPosition = (rect) => `${rect.x},${rect.y}`;
  * )
  * ```
  */
-export const detectElementMovement = (selector) => Effect.callback((resume, signal) => {
-    requestAnimationFrame(() => {
-        if (signal.aborted) {
-            return;
-        }
+export const detectElementMovement = (selector) => Effect.gen(function* () {
+    yield* afterRender;
+    return yield* Effect.callback((resume, signal) => {
         const element = document.querySelector(selector);
         if (!(element instanceof HTMLElement)) {
             return resume(Effect.void);

package/dist/task/index.d.ts

@@ -3,7 +3,7 @@ export { getTime, getTimeZone, getZonedTime, getZonedTimeIn } from './time.js';
 export { advanceFocus, focus, showModal, closeModal, clickElement, scrollIntoView, } from './dom.js';
 export type { FocusDirection } from './dom.js';
 export { detectElementMovement } from './elementMovement.js';
-export { delay, nextFrame, waitForAnimationSettled } from './timing.js';
+export { afterRender, delay, nextFrame, waitForAnimationSettled, } from './timing.js';
 export { randomInt, uuid } from './random.js';
 export { lockScroll, unlockScroll } from './scrollLock.js';
 export { inertOthers, restoreInert } from './inert.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/task/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC3D,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAC9E,OAAO,EACL,YAAY,EACZ,KAAK,EACL,SAAS,EACT,UAAU,EACV,YAAY,EACZ,cAAc,GACf,MAAM,UAAU,CAAA;AACjB,YAAY,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AACvE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC1D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/task/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC3D,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAC9E,OAAO,EACL,YAAY,EACZ,KAAK,EACL,SAAS,EACT,UAAU,EACV,YAAY,EACZ,cAAc,GACf,MAAM,UAAU,CAAA;AACjB,YAAY,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,EACL,WAAW,EACX,KAAK,EACL,SAAS,EACT,uBAAuB,GACxB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC1D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA"}

package/dist/task/index.js

@@ -2,7 +2,7 @@ export { ElementNotFound, TimeZoneError } from './error.js';
 export { getTime, getTimeZone, getZonedTime, getZonedTimeIn } from './time.js';
 export { advanceFocus, focus, showModal, closeModal, clickElement, scrollIntoView, } from './dom.js';
 export { detectElementMovement } from './elementMovement.js';
-export { delay, nextFrame, waitForAnimationSettled } from './timing.js';
+export { afterRender, delay, nextFrame, waitForAnimationSettled, } from './timing.js';
 export { randomInt, uuid } from './random.js';
 export { lockScroll, unlockScroll } from './scrollLock.js';
 export { inertOthers, restoreInert } from './inert.js';

package/dist/task/public.d.ts

@@ -1,2 +1,2 @@
-export { ElementNotFound, TimeZoneError, getTime, getTimeZone, getZonedTime, getZonedTimeIn, focus, showModal, closeModal, clickElement, delay, scrollIntoView, randomInt, uuid, nextFrame, waitForAnimationSettled, } from './index.js';
+export { ElementNotFound, TimeZoneError, afterRender, clickElement, closeModal, delay, focus, getTime, getTimeZone, getZonedTime, getZonedTimeIn, nextFrame, randomInt, scrollIntoView, showModal, uuid, waitForAnimationSettled, } from './index.js';
 //# sourceMappingURL=public.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../src/task/public.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,aAAa,EACb,OAAO,EACP,WAAW,EACX,YAAY,EACZ,cAAc,EACd,KAAK,EACL,SAAS,EACT,UAAU,EACV,YAAY,EACZ,KAAK,EACL,cAAc,EACd,SAAS,EACT,IAAI,EACJ,SAAS,EACT,uBAAuB,GACxB,MAAM,YAAY,CAAA"}
+{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../src/task/public.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,aAAa,EACb,WAAW,EACX,YAAY,EACZ,UAAU,EACV,KAAK,EACL,KAAK,EACL,OAAO,EACP,WAAW,EACX,YAAY,EACZ,cAAc,EACd,SAAS,EACT,SAAS,EACT,cAAc,EACd,SAAS,EACT,IAAI,EACJ,uBAAuB,GACxB,MAAM,YAAY,CAAA"}

package/dist/task/public.js

@@ -1 +1 @@
-export { ElementNotFound, TimeZoneError, getTime, getTimeZone, getZonedTime, getZonedTimeIn, focus, showModal, closeModal, clickElement, delay, scrollIntoView, randomInt, uuid, nextFrame, waitForAnimationSettled, } from './index.js';
+export { ElementNotFound, TimeZoneError, afterRender, clickElement, closeModal, delay, focus, getTime, getTimeZone, getZonedTime, getZonedTimeIn, nextFrame, randomInt, scrollIntoView, showModal, uuid, waitForAnimationSettled, } from './index.js';

package/dist/task/timing.d.ts

@@ -9,6 +9,29 @@ import { Duration, Effect } from 'effect';
  * ```
  */
 export declare const delay: (duration: Duration.Input) => Effect.Effect<void>;
+/**
+ * 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 Task DOM helpers (`focus`, `clickElement`, `scrollIntoView`, etc.)
+ * already gate themselves with this internally; reach for `afterRender`
+ * directly when building custom Commands or DOM-observing Subscriptions
+ * that need the same guarantee.
+ *
+ * @example
+ * ```typescript
+ * Effect.gen(function* () {
+ *   yield* Task.afterRender
+ *   const element = document.getElementById(id)
+ *   // element reflects the post-Message DOM
+ * })
+ * ```
+ */
+export declare const afterRender: Effect.Effect<void>;
 /**
  * Completes after two animation frames, ensuring the browser has painted
  * the current state before proceeding. Used for CSS transition orchestration —

package/dist/task/timing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"timing.d.ts","sourceRoot":"","sources":["../../src/task/timing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAEzC;;;;;;;;GAQG;AACH,eAAO,MAAM,KAAK,GAAI,UAAU,QAAQ,CAAC,KAAK,KAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAC3C,CAAA;AAExB;;;;;;;;;;GAUG;AACH,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAMxC,CAAA;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,uBAAuB,GAClC,UAAU,MAAM,KACf,MAAM,CAAC,MAAM,CAAC,IAAI,CAYjB,CAAA"}
+{"version":3,"file":"timing.d.ts","sourceRoot":"","sources":["../../src/task/timing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAEzC;;;;;;;;GAQG;AACH,eAAO,MAAM,KAAK,GAAI,UAAU,QAAQ,CAAC,KAAK,KAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAC3C,CAAA;AAExB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAK3C,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAMxC,CAAA;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,uBAAuB,GAClC,UAAU,MAAM,KACf,MAAM,CAAC,MAAM,CAAC,IAAI,CAYjB,CAAA"}

package/dist/task/timing.js

@@ -9,6 +9,32 @@ import { Effect } from 'effect';
  * ```
  */
 export const delay = (duration) => Effect.sleep(duration);
+/**
+ * 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 Task DOM helpers (`focus`, `clickElement`, `scrollIntoView`, etc.)
+ * already gate themselves with this internally; reach for `afterRender`
+ * directly when building custom Commands or DOM-observing Subscriptions
+ * that need the same guarantee.
+ *
+ * @example
+ * ```typescript
+ * Effect.gen(function* () {
+ *   yield* Task.afterRender
+ *   const element = document.getElementById(id)
+ *   // element reflects the post-Message DOM
+ * })
+ * ```
+ */
+export const afterRender = Effect.callback(resume => {
+    const handle = requestAnimationFrame(() => resume(Effect.void));
+    return Effect.sync(() => cancelAnimationFrame(handle));
+});
 /**
  * Completes after two animation frames, ensuring the browser has painted
  * the current state before proceeding. Used for CSS transition orchestration —

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "foldkit",
-  "version": "0.85.0",
+  "version": "0.86.0",
   "description": "A TypeScript frontend framework, built on Effect and architected like Elm",
   "type": "module",
   "main": "./dist/index.js",