foldkit 0.18.0 → 0.19.0

package/dist/runtime/runtime.js

@@ -23,11 +23,11 @@ const makeRuntime = ({ Model, Flags: _Flags, flags: flags_, init, update, view,
     const [initModel, initCommands] = Predicate.isNotUndefined(hmrModel)
         ? pipe(hmrModel, Schema.decodeUnknownEither(Model), Either.match({
             onLeft: () => init(flags, Option.getOrUndefined(currentUrl)),
-            onRight: (restoredModel) => [restoredModel, []],
+            onRight: restoredModel => [restoredModel, []],
         }))
         : init(flags, Option.getOrUndefined(currentUrl));
     const modelSubscriptionRef = yield* SubscriptionRef.make(initModel);
-    yield* Effect.forEach(initCommands, (command) => Effect.forkDaemon(command.pipe(Effect.flatMap(enqueueMessage))));
+    yield* Effect.forEach(initCommands, command => Effect.forkDaemon(command.pipe(Effect.flatMap(enqueueMessage))));
     if (browserConfig) {
         addNavigationEventListeners(messageQueue, browserConfig);
     }
@@ -43,7 +43,7 @@ const makeRuntime = ({ Model, Flags: _Flags, flags: flags_, init, update, view,
             yield* SubscriptionRef.set(modelSubscriptionRef, nextModel);
             preserveModel(nextModel);
         }
-        yield* Effect.forEach(commands, (command) => Effect.forkDaemon(command.pipe(Effect.flatMap(enqueueMessage))));
+        yield* Effect.forEach(commands, command => Effect.forkDaemon(command.pipe(Effect.flatMap(enqueueMessage))));
     });
     const runProcessMessage = (messageEffect) => (runtime) => {
         try {
@@ -69,7 +69,7 @@ const makeRuntime = ({ Model, Flags: _Flags, flags: flags_, init, update, view,
     const dispatchAsync = (message) => 
     /* eslint-disable-next-line @typescript-eslint/consistent-type-assertions */
     enqueueMessage(message);
-    const render = (model) => view(model).pipe(Effect.flatMap((nextVNodeNullish) => Effect.gen(function* () {
+    const render = (model) => view(model).pipe(Effect.flatMap(nextVNodeNullish => Effect.gen(function* () {
         const maybeCurrentVNode = yield* Ref.get(maybeCurrentVNodeRef);
         const patchedVNode = yield* Effect.sync(() => patchVNode(maybeCurrentVNode, nextVNodeNullish, container));
         yield* Ref.set(maybeCurrentVNodeRef, Option.some(patchedVNode));
@@ -93,7 +93,7 @@ const makeRuntime = ({ Model, Flags: _Flags, flags: flags_, init, update, view,
     yield* pipe(Effect.forever(Effect.gen(function* () {
         const message = yield* Queue.take(messageQueue);
         yield* processMessage(message);
-    })), Effect.catchAllCause((cause) => Effect.sync(() => {
+    })), Effect.catchAllCause(cause => Effect.sync(() => {
         const squashed = Cause.squash(cause);
         const appError = squashed instanceof Error ? squashed : new Error(String(squashed));
         renderErrorView(appError, errorView, container, maybeCurrentVNodeRef);
@@ -105,7 +105,7 @@ const patchVNode = (maybeCurrentVNode, nextVNodeNullish, container) => {
         : h('#text', {}, '');
     return Option.match(maybeCurrentVNode, {
         onNone: () => patch(toVNode(container), nextVNode),
-        onSome: (currentVNode) => patch(currentVNode, nextVNode),
+        onSome: currentVNode => patch(currentVNode, nextVNode),
     });
 };
 const renderErrorView = (appError, errorView, container, maybeCurrentVNodeRef) => {
@@ -140,7 +140,7 @@ export function makeElement(config) {
             ...baseConfig,
             Flags: config.Flags,
             flags: config.flags,
-            init: (flags) => config.init(flags),
+            init: flags => config.init(flags),
         });
     }
     else {
@@ -188,7 +188,7 @@ const preserveModel = (model) => {
 /** Starts a Foldkit runtime, with HMR support for development. */
 export const run = (foldkitRuntime) => {
     if (import.meta.hot) {
-        import.meta.hot.on('foldkit:restore-model', (model) => {
+        import.meta.hot.on('foldkit:restore-model', model => {
             BrowserRuntime.runMain(foldkitRuntime(model));
         });
         import.meta.hot.send('foldkit:request-model');

package/dist/schema/index.d.ts

@@ -6,19 +6,47 @@ export type CallableTaggedStruct<Tag extends string, Fields extends S.Struct.Fie
     readonly _tag: S.tag<Tag>;
 } & Fields>>);
 /**
- * A wrapper around Effect Schema.taggedStruct that returns a callable schema.
+ * Wraps `Schema.TaggedStruct` to create a message variant you can call directly as a constructor.
+ * Use `m` for message types — enabling `ClickedReset()` instead of `ClickedReset.make()`.
  *
- * Abbreviated as `ts` because it's used so frequently throughout Foldkit applications.
+ * @example
+ * ```typescript
+ * const ClickedReset = m('ClickedReset')
+ * ClickedReset() // { _tag: 'ClickedReset' }
+ *
+ * const ChangedCount = m('ChangedCount', { count: S.Number })
+ * ChangedCount({ count: 1 }) // { _tag: 'ChangedCount', count: 1 }
+ * ```
+ */
+export declare function m<Tag extends string>(tag: Tag): CallableTaggedStruct<Tag, {}>;
+export declare function m<Tag extends string, Fields extends S.Struct.Fields>(tag: Tag, fields: Fields): CallableTaggedStruct<Tag, Fields>;
+/**
+ * Wraps `Schema.TaggedStruct` to create a route variant you can call directly as a constructor.
+ * Use `r` for route types — enabling `Home()` instead of `Home.make()`.
+ *
+ * @example
+ * ```typescript
+ * const Home = r('Home')
+ * Home() // { _tag: 'Home' }
+ *
+ * const UserProfile = r('UserProfile', { id: S.String })
+ * UserProfile({ id: 'abc' }) // { _tag: 'UserProfile', id: 'abc' }
+ * ```
+ */
+export declare function r<Tag extends string>(tag: Tag): CallableTaggedStruct<Tag, {}>;
+export declare function r<Tag extends string, Fields extends S.Struct.Fields>(tag: Tag, fields: Fields): CallableTaggedStruct<Tag, Fields>;
+/**
+ * Wraps `Schema.TaggedStruct` to create a callable tagged struct you can call directly as a constructor.
+ * Use `ts` for non-message, non-route tagged structs — enabling `Loading()`
+ * instead of `Loading.make()`.
  *
  * @example
  * ```typescript
- * // Simple tag — callable with no args
- * const Reset = ts('Reset')
- * Reset() // { _tag: 'Reset' }
+ * const Loading = ts('Loading')
+ * Loading() // { _tag: 'Loading' }
  *
- * // Tag with fields — callable with fields
- * const SetCount = ts('SetCount', { count: S.Number })
- * SetCount({ count: 1 }) // { _tag: 'SetCount', count: 1 }
+ * const Ok = ts('Ok', { data: S.String })
+ * Ok({ data: 'hello' }) // { _tag: 'Ok', data: 'hello' }
  * ```
  */
 export declare function ts<Tag extends string>(tag: Tag): CallableTaggedStruct<Tag, {}>;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC,EAAE,MAAM,QAAQ,CAAA;AAEpC,qIAAqI;AACrI,MAAM,MAAM,oBAAoB,CAC9B,GAAG,SAAS,MAAM,EAClB,MAAM,SAAS,CAAC,CAAC,MAAM,CAAC,MAAM,IAC5B,CAAC,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,GAC7B,CAAC,MAAM,MAAM,SAAS,KAAK,GACvB,CACE,KAAK,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,KAC9D,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;IAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;CAAE,GAAG,MAAM,CAAC,CAAC,GACtE,CACE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,KACtD,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;IAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;CAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;AAe7E;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,EAAE,CAAC,GAAG,SAAS,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,oBAAoB,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;AAC/E,wBAAgB,EAAE,CAAC,GAAG,SAAS,MAAM,EAAE,MAAM,SAAS,CAAC,CAAC,MAAM,CAAC,MAAM,EACnE,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,MAAM,GACb,oBAAoB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC,EAAE,MAAM,QAAQ,CAAA;AAEpC,qIAAqI;AACrI,MAAM,MAAM,oBAAoB,CAC9B,GAAG,SAAS,MAAM,EAClB,MAAM,SAAS,CAAC,CAAC,MAAM,CAAC,MAAM,IAC5B,CAAC,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,GAC7B,CAAC,MAAM,MAAM,SAAS,KAAK,GACvB,CACE,KAAK,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,KAC9D,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;IAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;CAAE,GAAG,MAAM,CAAC,CAAC,GACtE,CACE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,KACtD,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;IAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;CAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;AAe7E;;;;;;;;;;;;GAYG;AACH,wBAAgB,CAAC,CAAC,GAAG,SAAS,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,oBAAoB,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;AAC9E,wBAAgB,CAAC,CAAC,GAAG,SAAS,MAAM,EAAE,MAAM,SAAS,CAAC,CAAC,MAAM,CAAC,MAAM,EAClE,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,MAAM,GACb,oBAAoB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;AAKpC;;;;;;;;;;;;GAYG;AACH,wBAAgB,CAAC,CAAC,GAAG,SAAS,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,oBAAoB,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;AAC9E,wBAAgB,CAAC,CAAC,GAAG,SAAS,MAAM,EAAE,MAAM,SAAS,CAAC,CAAC,MAAM,CAAC,MAAM,EAClE,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,MAAM,GACb,oBAAoB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;AAKpC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,EAAE,CAAC,GAAG,SAAS,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,oBAAoB,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;AAC/E,wBAAgB,EAAE,CAAC,GAAG,SAAS,MAAM,EAAE,MAAM,SAAS,CAAC,CAAC,MAAM,CAAC,MAAM,EACnE,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,MAAM,GACb,oBAAoB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA"}

package/dist/schema/index.js

@@ -9,6 +9,12 @@ new Proxy(schema, {
         return Reflect.get(target, property, receiver);
     },
 });
+export function m(tag, fields = {}) {
+    return makeCallable(S.TaggedStruct(tag, fields));
+}
+export function r(tag, fields = {}) {
+    return makeCallable(S.TaggedStruct(tag, fields));
+}
 export function ts(tag, fields = {}) {
     return makeCallable(S.TaggedStruct(tag, fields));
 }

package/dist/task/dom.d.ts

@@ -0,0 +1,59 @@
+import { Effect } from 'effect';
+/**
+ * Creates a command that focuses an element by selector and passes the result to a message constructor.
+ * Passes true if the element was found and focused, false otherwise.
+ * Uses requestAnimationFrame to ensure the DOM tree is updated and nodes exist before attempting to focus.
+ * This follows the same approach as Elm's Browser.Dom.focus.
+ *
+ * @example
+ * ```typescript
+ * Task.focus('#email-input', success => InputFocused({ success }))
+ * ```
+ */
+export declare const focus: <Message>(selector: string, f: (success: boolean) => Message) => Effect.Effect<Message>;
+/**
+ * Creates a command that opens a dialog element as a modal using `showModal()`.
+ * Passes true if the element was found and opened, false otherwise.
+ * Uses requestAnimationFrame to ensure the DOM tree is updated and nodes exist before attempting to show.
+ *
+ * @example
+ * ```typescript
+ * Task.showModal('#my-dialog', success => ModalOpened({ success }))
+ * ```
+ */
+export declare const showModal: <Message>(selector: string, f: (success: boolean) => Message) => Effect.Effect<Message>;
+/**
+ * Creates a command that closes a dialog element using `.close()`.
+ * Passes true if the element was found and closed, false otherwise.
+ * Uses requestAnimationFrame to ensure the DOM tree is updated and nodes exist before attempting to close.
+ *
+ * @example
+ * ```typescript
+ * Task.closeModal('#my-dialog', success => ModalClosed({ success }))
+ * ```
+ */
+export declare const closeModal: <Message>(selector: string, f: (success: boolean) => Message) => Effect.Effect<Message>;
+/**
+ * Creates a command that programmatically clicks an element by selector and passes the result to a message constructor.
+ * Passes true if the element was found and clicked, false otherwise.
+ * Uses requestAnimationFrame to ensure the DOM tree is updated and nodes exist before attempting to click.
+ *
+ * @example
+ * ```typescript
+ * Task.clickElement('#menu-item-2', success => ItemClicked({ success }))
+ * ```
+ */
+export declare const clickElement: <Message>(selector: string, f: (success: boolean) => Message) => Effect.Effect<Message>;
+/**
+ * Creates a command that scrolls an element into view by selector and passes the result to a message constructor.
+ * Passes true if the element was found and scrolled, false otherwise.
+ * Uses requestAnimationFrame to ensure the DOM tree is updated and nodes exist before attempting to scroll.
+ * Uses `{ block: 'nearest' }` to avoid unnecessary scrolling when the element is already visible.
+ *
+ * @example
+ * ```typescript
+ * Task.scrollIntoView('#active-item', success => ItemScrolled({ success }))
+ * ```
+ */
+export declare const scrollIntoView: <Message>(selector: string, f: (success: boolean) => Message) => Effect.Effect<Message>;
+//# sourceMappingURL=dom.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../../src/task/dom.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE/B;;;;;;;;;;GAUG;AACH,eAAO,MAAM,KAAK,GAAI,OAAO,EAC3B,UAAU,MAAM,EAChB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,KAC/B,MAAM,CAAC,MAAM,CAAC,OAAO,CAWpB,CAAA;AAEJ;;;;;;;;;GASG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,EAC/B,UAAU,MAAM,EAChB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,KAC/B,MAAM,CAAC,MAAM,CAAC,OAAO,CAWpB,CAAA;AAEJ;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU,GAAI,OAAO,EAChC,UAAU,MAAM,EAChB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,KAC/B,MAAM,CAAC,MAAM,CAAC,OAAO,CAWpB,CAAA;AAEJ;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,EAClC,UAAU,MAAM,EAChB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,KAC/B,MAAM,CAAC,MAAM,CAAC,OAAO,CAWpB,CAAA;AAEJ;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,EACpC,UAAU,MAAM,EAChB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,KAC/B,MAAM,CAAC,MAAM,CAAC,OAAO,CAWpB,CAAA"}

package/dist/task/dom.js

@@ -0,0 +1,113 @@
+import { Effect } from 'effect';
+/**
+ * Creates a command that focuses an element by selector and passes the result to a message constructor.
+ * Passes true if the element was found and focused, false otherwise.
+ * Uses requestAnimationFrame to ensure the DOM tree is updated and nodes exist before attempting to focus.
+ * This follows the same approach as Elm's Browser.Dom.focus.
+ *
+ * @example
+ * ```typescript
+ * Task.focus('#email-input', success => InputFocused({ success }))
+ * ```
+ */
+export const focus = (selector, f) => Effect.async(resume => {
+    requestAnimationFrame(() => {
+        const element = document.querySelector(selector);
+        if (element instanceof HTMLElement) {
+            element.focus();
+            resume(Effect.succeed(f(true)));
+        }
+        else {
+            resume(Effect.succeed(f(false)));
+        }
+    });
+});
+/**
+ * Creates a command that opens a dialog element as a modal using `showModal()`.
+ * Passes true if the element was found and opened, false otherwise.
+ * Uses requestAnimationFrame to ensure the DOM tree is updated and nodes exist before attempting to show.
+ *
+ * @example
+ * ```typescript
+ * Task.showModal('#my-dialog', success => ModalOpened({ success }))
+ * ```
+ */
+export const showModal = (selector, f) => Effect.async(resume => {
+    requestAnimationFrame(() => {
+        const element = document.querySelector(selector);
+        if (element instanceof HTMLDialogElement) {
+            element.showModal();
+            resume(Effect.succeed(f(true)));
+        }
+        else {
+            resume(Effect.succeed(f(false)));
+        }
+    });
+});
+/**
+ * Creates a command that closes a dialog element using `.close()`.
+ * Passes true if the element was found and closed, false otherwise.
+ * Uses requestAnimationFrame to ensure the DOM tree is updated and nodes exist before attempting to close.
+ *
+ * @example
+ * ```typescript
+ * Task.closeModal('#my-dialog', success => ModalClosed({ success }))
+ * ```
+ */
+export const closeModal = (selector, f) => Effect.async(resume => {
+    requestAnimationFrame(() => {
+        const element = document.querySelector(selector);
+        if (element instanceof HTMLDialogElement) {
+            element.close();
+            resume(Effect.succeed(f(true)));
+        }
+        else {
+            resume(Effect.succeed(f(false)));
+        }
+    });
+});
+/**
+ * Creates a command that programmatically clicks an element by selector and passes the result to a message constructor.
+ * Passes true if the element was found and clicked, false otherwise.
+ * Uses requestAnimationFrame to ensure the DOM tree is updated and nodes exist before attempting to click.
+ *
+ * @example
+ * ```typescript
+ * Task.clickElement('#menu-item-2', success => ItemClicked({ success }))
+ * ```
+ */
+export const clickElement = (selector, f) => Effect.async(resume => {
+    requestAnimationFrame(() => {
+        const element = document.querySelector(selector);
+        if (element instanceof HTMLElement) {
+            element.click();
+            resume(Effect.succeed(f(true)));
+        }
+        else {
+            resume(Effect.succeed(f(false)));
+        }
+    });
+});
+/**
+ * Creates a command that scrolls an element into view by selector and passes the result to a message constructor.
+ * Passes true if the element was found and scrolled, false otherwise.
+ * Uses requestAnimationFrame to ensure the DOM tree is updated and nodes exist before attempting to scroll.
+ * Uses `{ block: 'nearest' }` to avoid unnecessary scrolling when the element is already visible.
+ *
+ * @example
+ * ```typescript
+ * Task.scrollIntoView('#active-item', success => ItemScrolled({ success }))
+ * ```
+ */
+export const scrollIntoView = (selector, f) => Effect.async(resume => {
+    requestAnimationFrame(() => {
+        const element = document.querySelector(selector);
+        if (element instanceof HTMLElement) {
+            element.scrollIntoView({ block: 'nearest' });
+            resume(Effect.succeed(f(true)));
+        }
+        else {
+            resume(Effect.succeed(f(false)));
+        }
+    });
+});

package/dist/task/index.d.ts

@@ -1,109 +1,7 @@
-import { DateTime, Duration, Effect } from 'effect';
-/**
- * Creates a command that gets the current UTC time and passes it to a message constructor.
- * This is similar to Elm's `Task.perform` with `Time.now`.
- *
- * @example
- * ```typescript
- * Task.getTime(utc => GotTime({ utc }))
- * ```
- */
-export declare const getTime: <Message>(f: (utc: DateTime.Utc) => Message) => Effect.Effect<Message>;
-/**
- * Creates a command that gets the system timezone and passes it to a message constructor.
- * This is similar to Elm's `Task.perform` with `Time.here`.
- *
- * @example
- * ```typescript
- * Task.getTimeZone(zone => GotTimeZone({ zone }))
- * ```
- */
-export declare const getTimeZone: <Message>(f: (zone: DateTime.TimeZone) => Message) => Effect.Effect<Message>;
-/**
- * Creates a command that gets the current time in the system timezone and passes it to a message constructor.
- * This combines both time and timezone in a single task.
- *
- * @example
- * ```typescript
- * Task.getZonedTime(zoned => GotTime({ zoned }))
- * ```
- */
-export declare const getZonedTime: <Message>(f: (zoned: DateTime.Zoned) => Message) => Effect.Effect<Message>;
-/**
- * Creates a command that gets the current time in a specific timezone and passes it to a message constructor.
- * If the timezone is invalid, the effect will fail with an error string.
- *
- * @example
- * ```typescript
- * Task.getZonedTimeIn('America/New_York', zoned => GotNYTime({ zoned }))
- * ```
- */
-export declare const getZonedTimeIn: <Message>(zoneId: string, f: (zoned: DateTime.Zoned) => Message) => Effect.Effect<Message, string>;
-/**
- * Creates a command that focuses an element by selector and passes the result to a message constructor.
- * Passes true if the element was found and focused, false otherwise.
- * Uses requestAnimationFrame to ensure the DOM tree is updated and nodes exist before attempting to focus.
- * This follows the same approach as Elm's Browser.Dom.focus.
- *
- * @example
- * ```typescript
- * Task.focus('#email-input', success => InputFocused({ success }))
- * ```
- */
-export declare const focus: <Message>(selector: string, f: (success: boolean) => Message) => Effect.Effect<Message>;
-/**
- * Creates a command that opens a dialog element as a modal using `showModal()`.
- * Passes true if the element was found and opened, false otherwise.
- * Uses requestAnimationFrame to ensure the DOM tree is updated and nodes exist before attempting to show.
- *
- * @example
- * ```typescript
- * Task.showModal('#my-dialog', success => ModalOpened({ success }))
- * ```
- */
-export declare const showModal: <Message>(selector: string, f: (success: boolean) => Message) => Effect.Effect<Message>;
-/**
- * Creates a command that closes a dialog element using `.close()`.
- * Passes true if the element was found and closed, false otherwise.
- * Uses requestAnimationFrame to ensure the DOM tree is updated and nodes exist before attempting to close.
- *
- * @example
- * ```typescript
- * Task.closeModal('#my-dialog', success => ModalClosed({ success }))
- * ```
- */
-export declare const closeModal: <Message>(selector: string, f: (success: boolean) => Message) => Effect.Effect<Message>;
-/**
- * Creates a command that resolves to a message after a delay.
- * Useful for debouncing, such as clearing a typeahead search query.
- *
- * @example
- * ```typescript
- * Task.delay(350, () => SearchCleared({ version: model.searchVersion }))
- * Task.delay(Duration.seconds(1), () => TimedOut())
- * ```
- */
-export declare const delay: <Message>(duration: Duration.DurationInput, f: () => Message) => Effect.Effect<Message>;
-/**
- * Creates a command that generates a random integer between min (inclusive) and max (exclusive)
- * and passes it to a message constructor.
- *
- * @example
- * ```typescript
- * Task.randomInt(0, 100, value => GotRandom({ value }))
- * ```
- */
-/**
- * Creates a command that scrolls an element into view by selector and passes the result to a message constructor.
- * Passes true if the element was found and scrolled, false otherwise.
- * Uses requestAnimationFrame to ensure the DOM tree is updated and nodes exist before attempting to scroll.
- * Uses `{ block: 'nearest' }` to avoid unnecessary scrolling when the element is already visible.
- *
- * @example
- * ```typescript
- * Task.scrollIntoView('#active-item', success => ItemScrolled({ success }))
- * ```
- */
-export declare const scrollIntoView: <Message>(selector: string, f: (success: boolean) => Message) => Effect.Effect<Message>;
-export declare const randomInt: <Message>(min: number, max: number, f: (value: number) => Message) => Effect.Effect<Message>;
+export { getTime, getTimeZone, getZonedTime, getZonedTimeIn } from './time';
+export { focus, showModal, closeModal, clickElement, scrollIntoView, } from './dom';
+export { delay, nextFrame, waitForTransitions } from './timing';
+export { randomInt } from './random';
+export { lockScroll, unlockScroll } from './scrollLock';
+export { inertOthers, restoreInert } from './inert';
 //# sourceMappingURL=index.d.ts.map

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,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAU,MAAM,QAAQ,CAAA;AAE3D;;;;;;;;GAQG;AACH,eAAO,MAAM,OAAO,GAAI,OAAO,EAC7B,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,GAAG,KAAK,OAAO,KAChC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAgC,CAAA;AAExD;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,EACjC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,QAAQ,KAAK,OAAO,KACtC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAmD,CAAA;AAE3E;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,EAClC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,KAAK,OAAO,KACpC,MAAM,CAAC,MAAM,CAAC,OAAO,CAMpB,CAAA;AAEJ;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,EACpC,QAAQ,MAAM,EACd,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,KAAK,OAAO,KACpC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAS5B,CAAA;AAEJ;;;;;;;;;;GAUG;AACH,eAAO,MAAM,KAAK,GAAI,OAAO,EAC3B,UAAU,MAAM,EAChB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,KAC/B,MAAM,CAAC,MAAM,CAAC,OAAO,CAWpB,CAAA;AAEJ;;;;;;;;;GASG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,EAC/B,UAAU,MAAM,EAChB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,KAC/B,MAAM,CAAC,MAAM,CAAC,OAAO,CAWpB,CAAA;AAEJ;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU,GAAI,OAAO,EAChC,UAAU,MAAM,EAChB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,KAC/B,MAAM,CAAC,MAAM,CAAC,OAAO,CAWpB,CAAA;AAEJ;;;;;;;;;GASG;AACH,eAAO,MAAM,KAAK,GAAI,OAAO,EAC3B,UAAU,QAAQ,CAAC,aAAa,EAChC,GAAG,MAAM,OAAO,KACf,MAAM,CAAC,MAAM,CAAC,OAAO,CAIpB,CAAA;AAEJ;;;;;;;;GAQG;AACH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,EACpC,UAAU,MAAM,EAChB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,KAC/B,MAAM,CAAC,MAAM,CAAC,OAAO,CAWpB,CAAA;AAEJ,eAAO,MAAM,SAAS,GAAI,OAAO,EAC/B,KAAK,MAAM,EACX,KAAK,MAAM,EACX,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,KAC5B,MAAM,CAAC,MAAM,CAAC,OAAO,CAC6C,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/task/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAA;AAC3E,OAAO,EACL,KAAK,EACL,SAAS,EACT,UAAU,EACV,YAAY,EACZ,cAAc,GACf,MAAM,OAAO,CAAA;AACd,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AACpC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AACvD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA"}

package/dist/task/index.js

@@ -1,168 +1,6 @@
-import { DateTime, Effect, Option } from 'effect';
-/**
- * Creates a command that gets the current UTC time and passes it to a message constructor.
- * This is similar to Elm's `Task.perform` with `Time.now`.
- *
- * @example
- * ```typescript
- * Task.getTime(utc => GotTime({ utc }))
- * ```
- */
-export const getTime = (f) => Effect.map(DateTime.now, f);
-/**
- * Creates a command that gets the system timezone and passes it to a message constructor.
- * This is similar to Elm's `Task.perform` with `Time.here`.
- *
- * @example
- * ```typescript
- * Task.getTimeZone(zone => GotTimeZone({ zone }))
- * ```
- */
-export const getTimeZone = (f) => Effect.sync(() => f(DateTime.zoneMakeLocal()));
-/**
- * Creates a command that gets the current time in the system timezone and passes it to a message constructor.
- * This combines both time and timezone in a single task.
- *
- * @example
- * ```typescript
- * Task.getZonedTime(zoned => GotTime({ zoned }))
- * ```
- */
-export const getZonedTime = (f) => Effect.gen(function* () {
-    const utc = yield* DateTime.now;
-    const zone = DateTime.zoneMakeLocal();
-    const zoned = DateTime.setZone(utc, zone);
-    return f(zoned);
-});
-/**
- * Creates a command that gets the current time in a specific timezone and passes it to a message constructor.
- * If the timezone is invalid, the effect will fail with an error string.
- *
- * @example
- * ```typescript
- * Task.getZonedTimeIn('America/New_York', zoned => GotNYTime({ zoned }))
- * ```
- */
-export const getZonedTimeIn = (zoneId, f) => Effect.gen(function* () {
-    const utc = yield* DateTime.now;
-    const maybeZone = DateTime.zoneMakeNamed(zoneId);
-    if (Option.isNone(maybeZone)) {
-        return yield* Effect.fail(`Invalid timezone: ${zoneId}`);
-    }
-    const zoned = DateTime.setZone(utc, maybeZone.value);
-    return f(zoned);
-});
-/**
- * Creates a command that focuses an element by selector and passes the result to a message constructor.
- * Passes true if the element was found and focused, false otherwise.
- * Uses requestAnimationFrame to ensure the DOM tree is updated and nodes exist before attempting to focus.
- * This follows the same approach as Elm's Browser.Dom.focus.
- *
- * @example
- * ```typescript
- * Task.focus('#email-input', success => InputFocused({ success }))
- * ```
- */
-export const focus = (selector, f) => Effect.async((resume) => {
-    requestAnimationFrame(() => {
-        const element = document.querySelector(selector);
-        if (element instanceof HTMLElement) {
-            element.focus();
-            resume(Effect.succeed(f(true)));
-        }
-        else {
-            resume(Effect.succeed(f(false)));
-        }
-    });
-});
-/**
- * Creates a command that opens a dialog element as a modal using `showModal()`.
- * Passes true if the element was found and opened, false otherwise.
- * Uses requestAnimationFrame to ensure the DOM tree is updated and nodes exist before attempting to show.
- *
- * @example
- * ```typescript
- * Task.showModal('#my-dialog', success => ModalOpened({ success }))
- * ```
- */
-export const showModal = (selector, f) => Effect.async((resume) => {
-    requestAnimationFrame(() => {
-        const element = document.querySelector(selector);
-        if (element instanceof HTMLDialogElement) {
-            element.showModal();
-            resume(Effect.succeed(f(true)));
-        }
-        else {
-            resume(Effect.succeed(f(false)));
-        }
-    });
-});
-/**
- * Creates a command that closes a dialog element using `.close()`.
- * Passes true if the element was found and closed, false otherwise.
- * Uses requestAnimationFrame to ensure the DOM tree is updated and nodes exist before attempting to close.
- *
- * @example
- * ```typescript
- * Task.closeModal('#my-dialog', success => ModalClosed({ success }))
- * ```
- */
-export const closeModal = (selector, f) => Effect.async((resume) => {
-    requestAnimationFrame(() => {
-        const element = document.querySelector(selector);
-        if (element instanceof HTMLDialogElement) {
-            element.close();
-            resume(Effect.succeed(f(true)));
-        }
-        else {
-            resume(Effect.succeed(f(false)));
-        }
-    });
-});
-/**
- * Creates a command that resolves to a message after a delay.
- * Useful for debouncing, such as clearing a typeahead search query.
- *
- * @example
- * ```typescript
- * Task.delay(350, () => SearchCleared({ version: model.searchVersion }))
- * Task.delay(Duration.seconds(1), () => TimedOut())
- * ```
- */
-export const delay = (duration, f) => Effect.gen(function* () {
-    yield* Effect.sleep(duration);
-    return f();
-});
-/**
- * Creates a command that generates a random integer between min (inclusive) and max (exclusive)
- * and passes it to a message constructor.
- *
- * @example
- * ```typescript
- * Task.randomInt(0, 100, value => GotRandom({ value }))
- * ```
- */
-/**
- * Creates a command that scrolls an element into view by selector and passes the result to a message constructor.
- * Passes true if the element was found and scrolled, false otherwise.
- * Uses requestAnimationFrame to ensure the DOM tree is updated and nodes exist before attempting to scroll.
- * Uses `{ block: 'nearest' }` to avoid unnecessary scrolling when the element is already visible.
- *
- * @example
- * ```typescript
- * Task.scrollIntoView('#active-item', success => ItemScrolled({ success }))
- * ```
- */
-export const scrollIntoView = (selector, f) => Effect.async((resume) => {
-    requestAnimationFrame(() => {
-        const element = document.querySelector(selector);
-        if (element instanceof HTMLElement) {
-            element.scrollIntoView({ block: 'nearest' });
-            resume(Effect.succeed(f(true)));
-        }
-        else {
-            resume(Effect.succeed(f(false)));
-        }
-    });
-});
-export const randomInt = (min, max, f) => Effect.sync(() => f(Math.floor(Math.random() * (max - min)) + min));
+export { getTime, getTimeZone, getZonedTime, getZonedTimeIn } from './time';
+export { focus, showModal, closeModal, clickElement, scrollIntoView, } from './dom';
+export { delay, nextFrame, waitForTransitions } from './timing';
+export { randomInt } from './random';
+export { lockScroll, unlockScroll } from './scrollLock';
+export { inertOthers, restoreInert } from './inert';

package/dist/task/inert.d.ts

@@ -0,0 +1,25 @@
+import { Effect } from 'effect';
+/**
+ * Creates a command that marks all DOM elements outside the given selectors as
+ * `inert` and `aria-hidden="true"`. Walks each allowed element up to
+ * `document.body`, marking siblings that don't contain an allowed element.
+ * Uses reference counting so nested calls are safe.
+ *
+ * @example
+ * ```typescript
+ * Task.inertOthers('my-menu', ['#menu-button', '#menu-items'], () => NoOp())
+ * ```
+ */
+export declare const inertOthers: <Message>(id: string, allowedSelectors: ReadonlyArray<string>, f: () => Message) => Effect.Effect<Message>;
+/**
+ * Creates a command that restores all elements previously marked inert by
+ * `inertOthers` for the given ID. Safe to call without a preceding
+ * `inertOthers` — acts as a no-op in that case.
+ *
+ * @example
+ * ```typescript
+ * Task.restoreInert('my-menu', () => NoOp())
+ * ```
+ */
+export declare const restoreInert: <Message>(id: string, f: () => Message) => Effect.Effect<Message>;
+//# sourceMappingURL=inert.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inert.d.ts","sourceRoot":"","sources":["../../src/task/inert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,MAAM,EAAmC,MAAM,QAAQ,CAAA;AAoFvE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,EACjC,IAAI,MAAM,EACV,kBAAkB,aAAa,CAAC,MAAM,CAAC,EACvC,GAAG,MAAM,OAAO,KACf,MAAM,CAAC,MAAM,CAAC,OAAO,CAepB,CAAA;AAEJ;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,EAClC,IAAI,MAAM,EACV,GAAG,MAAM,OAAO,KACf,MAAM,CAAC,MAAM,CAAC,OAAO,CAUpB,CAAA"}