foldkit 0.166.0 → 0.167.0

package/dist/command/index.d.ts

@@ -215,10 +215,10 @@ export declare const mapMessage: {
 /** Lifts every Command in a list through `f`, transforming the result
  *  Message type from `FromMessage` to `ToMessage`. When `commands` is
  *  `undefined`, it returns an empty array. `Update.foldChild`,
- *  `Update.foldChildStep`, `Update.foldChildInit`, and `Update.foldChildInits`
- *  handle this mapping for application Submodels. Use `mapMessages` for a
- *  standalone batch of Commands or when route-gated initialization includes
- *  only the active child's Commands:
+ *  `Update.foldChildStep`, `Update.foldChildInit`, `Update.foldChildInits`,
+ *  and `Update.foldChildAt` handle this mapping for application Submodels.
+ *  Use `mapMessages` for a standalone batch of Commands or when route-gated
+ *  initialization includes only the active child's Commands:
  *
  *  ```ts
  *  const commands = Command.mapMessages(

package/dist/command/index.js

@@ -133,10 +133,10 @@ export const mapMessage = Function.dual(2, (command, f) => {
 /** Lifts every Command in a list through `f`, transforming the result
  *  Message type from `FromMessage` to `ToMessage`. When `commands` is
  *  `undefined`, it returns an empty array. `Update.foldChild`,
- *  `Update.foldChildStep`, `Update.foldChildInit`, and `Update.foldChildInits`
- *  handle this mapping for application Submodels. Use `mapMessages` for a
- *  standalone batch of Commands or when route-gated initialization includes
- *  only the active child's Commands:
+ *  `Update.foldChildStep`, `Update.foldChildInit`, `Update.foldChildInits`,
+ *  and `Update.foldChildAt` handle this mapping for application Submodels.
+ *  Use `mapMessages` for a standalone batch of Commands or when route-gated
+ *  initialization includes only the active child's Commands:
  *
  *  ```ts
  *  const commands = Command.mapMessages(

package/dist/dom/index.d.ts

@@ -4,5 +4,11 @@ export type { FocusDirection } from './dom.js';
 export { detectElementMovement } from './elementMovement.js';
 export { inertOthers, restoreInert } from './inert.js';
 export { lockScroll, unlockScroll } from './scrollLock.js';
+export { streamFromEvent, streamFromEventFilterMap, streamFromEventFilterMapPreventDefault, } from './streamFromEvent.js';
+export type { StreamFromEventConfig, StreamFromEventFilterMapConfig, StreamFromEventFilterMapPreventDefaultConfig, TypedEventTarget, } from './streamFromEvent.js';
+export { streamFromKeyBindings } from './streamFromKeyBindings.js';
+export type { KeyBinding, KeySequence, StreamFromKeyBindingsConfig, WhileTyping, } from './streamFromKeyBindings.js';
+export { streamFromMediaQuery } from './streamFromMediaQuery.js';
+export type { StreamFromMediaQueryConfig } from './streamFromMediaQuery.js';
 export { waitForAnimationSettled } from './waitForAnimation.js';
 //# sourceMappingURL=index.d.ts.map

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,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"}
+{"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,EACL,eAAe,EACf,wBAAwB,EACxB,sCAAsC,GACvC,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EACV,qBAAqB,EACrB,8BAA8B,EAC9B,4CAA4C,EAC5C,gBAAgB,GACjB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAClE,YAAY,EACV,UAAU,EACV,WAAW,EACX,2BAA2B,EAC3B,WAAW,GACZ,MAAM,4BAA4B,CAAA;AACnC,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAChE,YAAY,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAA;AAC3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/dom/index.js

@@ -3,4 +3,7 @@ export { advanceFocus, clickElement, closeDialog, focus, releaseDialogResources,
 export { detectElementMovement } from './elementMovement.js';
 export { inertOthers, restoreInert } from './inert.js';
 export { lockScroll, unlockScroll } from './scrollLock.js';
+export { streamFromEvent, streamFromEventFilterMap, streamFromEventFilterMapPreventDefault, } from './streamFromEvent.js';
+export { streamFromKeyBindings } from './streamFromKeyBindings.js';
+export { streamFromMediaQuery } from './streamFromMediaQuery.js';
 export { waitForAnimationSettled } from './waitForAnimation.js';

package/dist/dom/public.d.ts

@@ -1,3 +1,3 @@
-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';
+export { ElementNotFound, advanceFocus, clickElement, closeDialog, detectElementMovement, focus, inertOthers, lockScroll, releaseDialogResources, restoreInert, scrollIntoView, scrollIntoViewAfterPaint, scrollIntoViewIfNotVisible, showDialog, streamFromEvent, streamFromEventFilterMap, streamFromEventFilterMapPreventDefault, streamFromKeyBindings, streamFromMediaQuery, unlockScroll, waitForAnimationSettled, } from './index.js';
+export type { FocusDirection, KeyBinding, KeySequence, StreamFromEventConfig, StreamFromEventFilterMapConfig, StreamFromEventFilterMapPreventDefaultConfig, StreamFromKeyBindingsConfig, StreamFromMediaQueryConfig, TypedEventTarget, WhileTyping, } 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,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"}
+{"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,eAAe,EACf,wBAAwB,EACxB,sCAAsC,EACtC,qBAAqB,EACrB,oBAAoB,EACpB,YAAY,EACZ,uBAAuB,GACxB,MAAM,YAAY,CAAA;AACnB,YAAY,EACV,cAAc,EACd,UAAU,EACV,WAAW,EACX,qBAAqB,EACrB,8BAA8B,EAC9B,4CAA4C,EAC5C,2BAA2B,EAC3B,0BAA0B,EAC1B,gBAAgB,EAChB,WAAW,GACZ,MAAM,YAAY,CAAA"}

package/dist/dom/public.js

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

package/dist/{subscription/fromEvent.d.ts → dom/streamFromEvent.d.ts}

@@ -1,7 +1,7 @@
 import { Option, Stream } from 'effect';
 declare const EventMapMarker: unique symbol;
 /**
- * An `EventTarget` that declares the events it dispatches, so the `fromEvent`
+ * An `EventTarget` that declares the events it dispatches, so the `streamFromEvent`
  * helpers can resolve an event name to its event type the way they do for
  * `window`, `document`, and the DOM interfaces lib.dom declares event maps
  * for.
@@ -15,7 +15,7 @@ declare const EventMapMarker: unique symbol;
  *
  * @example
  * ```ts
- * const slowWarningTarget: Subscription.TypedEventTarget<{
+ * const slowWarningTarget: Dom.TypedEventTarget<{
  *   'foldkit:slow-warning': CustomEvent<SlowWarningReport>
  * }> = new EventTarget()
  * ```
@@ -42,10 +42,10 @@ type PreventDefaultEventListenerOptions = Omit<AddEventListenerOptions, 'passive
     passive?: false;
 }>;
 /**
- * Configuration for the `fromEvent` Stream helper.
+ * Configuration for the `streamFromEvent` Stream helper.
  *
  * `target` is read inside the acquire Effect, never before it, so the
- * resolved `EventTarget` is captured at the moment the Subscription's scope
+ * resolved `EventTarget` is captured at the moment the Stream's scope
  * opens. Pass a thunk when the target may not exist until the scope opens, or
  * pass the `EventTarget` directly for always-present globals like `window` or
  * `document`.
@@ -60,23 +60,23 @@ type PreventDefaultEventListenerOptions = Omit<AddEventListenerOptions, 'passive
  * unless the listener is passive. Some browsers default wheel and touch
  * listeners on global targets to passive, where `preventDefault()` is
  * ignored. Pass `options: { passive: false }` explicitly when cancelling
- * those events, or reach for `fromEventFilterMapPreventDefault`, which does
+ * those events, or reach for `streamFromEventFilterMapPreventDefault`, which does
  * so for you.
  *
  * The output type is inferred from the mapper; `Subscription.make` checks
  * that the final Stream emits the application's Message type.
  */
-export type FromEventConfig<Target extends EventTarget, Type extends EventTypeOf<Target>, Output> = Readonly<{
+export type StreamFromEventConfig<Target extends EventTarget, Type extends EventTypeOf<Target>, Output> = Readonly<{
     target: Target | (() => Target);
     type: Type;
     mapEvent: (event: EventOf<Target, Type>) => Output;
     options?: AddEventListenerOptions;
 }>;
 /**
- * Configuration for the `fromEventFilterMap` Stream helper.
+ * Configuration for the `streamFromEventFilterMap` Stream helper.
  *
  * `target` is read inside the acquire Effect, never before it, so the
- * resolved `EventTarget` is captured at the moment the Subscription's scope
+ * resolved `EventTarget` is captured at the moment the Stream's scope
  * opens. Pass a thunk when the target may not exist until the scope opens, or
  * pass the `EventTarget` directly for always-present globals like `window` or
  * `document`.
@@ -92,22 +92,22 @@ export type FromEventConfig<Target extends EventTarget, Type extends EventTypeOf
  * passive. Some browsers default wheel and touch listeners on global targets
  * to passive, where `preventDefault()` is ignored. Pass
  * `options: { passive: false }` explicitly when cancelling those events, or
- * reach for `fromEventFilterMapPreventDefault`, which does so for you.
+ * reach for `streamFromEventFilterMapPreventDefault`, which does so for you.
  *
  * The output type is inferred from the mapper; `Subscription.make` checks
  * that the final Stream emits the application's Message type.
  */
-export type FromEventFilterMapConfig<Target extends EventTarget, Type extends EventTypeOf<Target>, Output> = Readonly<{
+export type StreamFromEventFilterMapConfig<Target extends EventTarget, Type extends EventTypeOf<Target>, Output> = Readonly<{
     target: Target | (() => Target);
     type: Type;
     filterMapEvent: (event: EventOf<Target, Type>) => Option.Option<Output>;
     options?: AddEventListenerOptions;
 }>;
 /**
- * Configuration for the `fromEventFilterMapPreventDefault` Stream helper.
+ * Configuration for the `streamFromEventFilterMapPreventDefault` Stream helper.
  *
  * `target` is read inside the acquire Effect, never before it, so the
- * resolved `EventTarget` is captured at the moment the Subscription's scope
+ * resolved `EventTarget` is captured at the moment the Stream's scope
  * opens. Pass a thunk when the target may not exist until the scope opens, or
  * pass the `EventTarget` directly for always-present globals like `window` or
  * `document`.
@@ -130,7 +130,7 @@ export type FromEventFilterMapConfig<Target extends EventTarget, Type extends Ev
  * The output type is inferred from the mapper; `Subscription.make` checks
  * that the final Stream emits the application's Message type.
  */
-export type FromEventFilterMapPreventDefaultConfig<Target extends EventTarget, Type extends EventTypeOf<Target>, Output> = Readonly<{
+export type StreamFromEventFilterMapPreventDefaultConfig<Target extends EventTarget, Type extends EventTypeOf<Target>, Output> = Readonly<{
     target: Target | (() => Target);
     type: Type;
     filterMapEvent: (event: EventOf<Target, Type>) => Option.Option<Output>;
@@ -141,7 +141,7 @@ export type FromEventFilterMapPreventDefaultConfig<Target extends EventTarget, T
  * mapper chooses to keep, registering the listener when the Stream's scope
  * opens and removing it when the scope closes.
  *
- * This is the filtered variant of `fromEvent`. Its `filterMapEvent` returns
+ * This is the filtered variant of `streamFromEvent`. Its `filterMapEvent` returns
  * `Option.some(value)` to emit and `Option.none()` to ignore the event, so a
  * single listener can react to some dispatches while passing on the rest. A
  * mapper that never emits produces a `Stream<never>`.
@@ -154,7 +154,7 @@ export type FromEventFilterMapPreventDefaultConfig<Target extends EventTarget, T
  * which ignores `preventDefault()`. Some browsers default wheel and touch
  * listeners on global targets to passive. Pass
  * `options: { passive: false }` explicitly when cancelling those events, or
- * reach for `fromEventFilterMapPreventDefault`, which does so for you.
+ * reach for `streamFromEventFilterMapPreventDefault`, which does so for you.
  *
  * The target, the event name, and the event the mapper receives are one fact:
  * `type` is constrained to the names the target declares, and the mapper's
@@ -169,8 +169,8 @@ export type FromEventFilterMapPreventDefaultConfig<Target extends EventTarget, T
  * listener never leaks on interruption.
  *
  * This is a Stream, not a Subscription entry. Wrap it with
- * `Subscription.persistent` for a listener whose lifetime spans the whole
- * Subscriptions record, or plug it into a `Subscription.make` entry's
+ * `Subscription.persistentEntry` for a listener with no local Model dependencies,
+ * or plug it into a `Subscription.make` entry's
  * `dependenciesToStream` (typically behind `Stream.when`) to gate it on a
  * Model condition. The mapper's output type is inferred (even a raw Event is
  * accepted here); `Subscription.make` checks the final Stream against the
@@ -185,7 +185,7 @@ export type FromEventFilterMapPreventDefaultConfig<Target extends EventTarget, T
  *       modelToDependencies: model => ({ isListening: model.isListening }),
  *       dependenciesToStream: ({ isListening }) =>
  *         Stream.when(
- *           Subscription.fromEventFilterMap({
+ *           Dom.streamFromEventFilterMap({
  *             target: window,
  *             type: 'keydown',
  *             filterMapEvent: event =>
@@ -200,7 +200,7 @@ export type FromEventFilterMapPreventDefaultConfig<Target extends EventTarget, T
  * }))
  * ```
  */
-export declare const fromEventFilterMap: <Target extends EventTarget, Type extends EventTypeOf<Target>, Output>(config: FromEventFilterMapConfig<Target, Type, Output>) => Stream.Stream<Output>;
+export declare const streamFromEventFilterMap: <Target extends EventTarget, Type extends EventTypeOf<Target>, Output>(config: StreamFromEventFilterMapConfig<Target, Type, Output>) => Stream.Stream<Output>;
 /**
  * Build a Stream that emits a value for every dispatch of a DOM event,
  * registering the listener when the Stream's scope opens and removing it when
@@ -219,17 +219,17 @@ export declare const fromEventFilterMap: <Target extends EventTarget, Type exten
  * listener never leaks on interruption.
  *
  * This is a Stream, not a Subscription entry. Wrap it with
- * `Subscription.persistent` for a listener whose lifetime spans the whole
- * Subscriptions record, or plug it into a `Subscription.make` entry's
+ * `Subscription.persistentEntry` for a listener with no local Model dependencies,
+ * or plug it into a `Subscription.make` entry's
  * `dependenciesToStream` (typically behind `Stream.when`) to gate it on a
  * Model condition. The mapper's output type is inferred (even a raw Event is
  * accepted here); `Subscription.make` checks the final Stream against the
  * application's Message type.
  *
  * For a listener that reacts to only some events, reach for
- * `fromEventFilterMap`, whose mapper returns `Option<Output>`. For a
+ * `streamFromEventFilterMap`, whose mapper returns `Option<Output>`. For a
  * listener that also cancels the default action of the events it handles,
- * reach for `fromEventFilterMapPreventDefault`.
+ * reach for `streamFromEventFilterMapPreventDefault`.
  *
  * @example
  * ```typescript
@@ -240,7 +240,7 @@ export declare const fromEventFilterMap: <Target extends EventTarget, Type exten
  *       modelToDependencies: model => ({ isListening: model.isListening }),
  *       dependenciesToStream: ({ isListening }) =>
  *         Stream.when(
- *           Subscription.fromEvent({
+ *           Dom.streamFromEvent({
  *             target: window,
  *             type: 'keydown',
  *             mapEvent: event => Message.PressedKey({ key: event.key }),
@@ -252,14 +252,14 @@ export declare const fromEventFilterMap: <Target extends EventTarget, Type exten
  * }))
  * ```
  */
-export declare const fromEvent: <Target extends EventTarget, Type extends EventTypeOf<Target>, Output>(config: FromEventConfig<Target, Type, Output>) => Stream.Stream<Output>;
+export declare const streamFromEvent: <Target extends EventTarget, Type extends EventTypeOf<Target>, Output>(config: StreamFromEventConfig<Target, Type, Output>) => Stream.Stream<Output>;
 /**
  * Build a Stream that emits a value for the dispatches of a DOM event the
  * mapper marks handled, calling `event.preventDefault()` on each of them,
  * registering the listener when the Stream's scope opens and removing it when
  * the scope closes.
  *
- * This is the cancelling variant of `fromEventFilterMap`, mirroring
+ * This is the cancelling variant of `streamFromEventFilterMap`, mirroring
  * `h.OnKeyDownPreventDefault` from `foldkit/html`. Its `filterMapEvent` returns
  * `Option.some(value)` to mark a dispatch handled. The helper evaluates the
  * mapper, calls `event.preventDefault()`, and queues the value before the
@@ -284,8 +284,8 @@ export declare const fromEvent: <Target extends EventTarget, Type extends EventT
  * listener never leaks on interruption.
  *
  * This is a Stream, not a Subscription entry. Wrap it with
- * `Subscription.persistent` for a listener whose lifetime spans the whole
- * Subscriptions record, or plug it into a `Subscription.make` entry's
+ * `Subscription.persistentEntry` for a listener with no local Model dependencies,
+ * or plug it into a `Subscription.make` entry's
  * `dependenciesToStream` (typically behind `Stream.when`) to gate it on a
  * Model condition. The mapper's output type is inferred (even a raw Event is
  * accepted here); `Subscription.make` checks the final Stream against the
@@ -300,7 +300,7 @@ export declare const fromEvent: <Target extends EventTarget, Type extends EventT
  *       modelToDependencies: model => ({ isModalOpen: model.isModalOpen }),
  *       dependenciesToStream: ({ isModalOpen }) =>
  *         Stream.when(
- *           Subscription.fromEventFilterMapPreventDefault({
+ *           Dom.streamFromEventFilterMapPreventDefault({
  *             target: window,
  *             type: 'wheel',
  *             filterMapEvent: () => Option.some(Message.SuppressedWheelScroll()),
@@ -312,6 +312,6 @@ export declare const fromEvent: <Target extends EventTarget, Type extends EventT
  * }))
  * ```
  */
-export declare const fromEventFilterMapPreventDefault: <Target extends EventTarget, Type extends EventTypeOf<Target>, Output>(config: FromEventFilterMapPreventDefaultConfig<Target, Type, Output>) => Stream.Stream<Output>;
+export declare const streamFromEventFilterMapPreventDefault: <Target extends EventTarget, Type extends EventTypeOf<Target>, Output>(config: StreamFromEventFilterMapPreventDefaultConfig<Target, Type, Output>) => Stream.Stream<Output>;
 export {};
-//# sourceMappingURL=fromEvent.d.ts.map
+//# sourceMappingURL=streamFromEvent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"streamFromEvent.d.ts","sourceRoot":"","sources":["../../src/dom/streamFromEvent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,MAAM,EAAS,MAAM,EAAE,MAAM,QAAQ,CAAA;AAEtD,OAAO,CAAC,MAAM,cAAc,EAAE,OAAO,MAAM,CAAA;AAE3C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,gBAAgB,CAC/B,QAAQ,SAAS;IAAE,QAAQ,EAAE,IAAI,IAAI,MAAM,QAAQ,GAAG,KAAK;CAAE,CAC7D,SAAQ,WAAW;IACnB,QAAQ,CAAC,CAAC,cAAc,CAAC,CAAC,EAAE,QAAQ,CAAA;CACrC;AAED,KAAK,iBAAiB,GAAG,OAAO,cAAc,CAAA;AAI9C,KAAK,gBAAgB,CAAC,MAAM,IAAI,iBAAiB,SAAS,MAAM,MAAM,GAClE,WAAW,CAAC,MAAM,CAAC,iBAAiB,GAAG,MAAM,MAAM,CAAC,CAAC,GACrD,KAAK,CAAA;AAET,KAAK,gBAAgB,CAAC,OAAO,IAC3B,WAAW,CAAC,OAAO,CAAC,SAAS,CAC3B,KAAK,EAAE,MAAM,SAAS,EACtB,GAAG,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,KAC5B,OAAO,GACR,SAAS,SAAS,KAAK,GACrB,SAAS,GACT,KAAK,GACP,KAAK,CAAA;AAEX,KAAK,oBAAoB,CAAC,MAAM,IAAI;IAClC,QAAQ,EACN,GAAG,IAAI,MAAM,MAAM,IAAI,GAAG,SAAS,KAAK,MAAM,IAAI,EAAE,GAChD,CAAC,gBAAgB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAC7C,KAAK,GACL,IAAI,GACN,KAAK,GACR,gBAAgB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;CACjC,CAAA;AAED,KAAK,gBAAgB,CAAC,IAAI,EAAE,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,MAAM,QAAQ,CAAC,GAAG,QAAQ,CAAA;AAI7E,KAAK,iBAAiB,CAAC,MAAM,IAAI,MAAM,SAAS,gBAAgB,GAC5D,wBAAwB,GACxB,MAAM,SAAS,gBAAgB,GAC7B,wBAAwB,GACxB,MAAM,SAAS,eAAe,GAC5B,uBAAuB,GACvB,MAAM,SAAS,mBAAmB,GAChC,2BAA2B,GAC3B,MAAM,SAAS,WAAW,GACxB,mBAAmB,GACnB,MAAM,SAAS,aAAa,GAC1B,qBAAqB,GACrB,MAAM,SAAS,aAAa,GAC1B,qBAAqB,GACrB,MAAM,SAAS,UAAU,GACvB,kBAAkB,GAClB,MAAM,SAAS,OAAO,GACpB,eAAe,GAAG,2BAA2B,GAC7C,KAAK,CAAA;AAEzB,KAAK,gBAAgB,CAAC,MAAM,IAAI,MAAM,SAAS,MAAM,GACjD,cAAc,GACd,MAAM,SAAS,QAAQ,GACrB,gBAAgB,GAChB,MAAM,SAAS,cAAc,GAC3B,sBAAsB,GACtB,MAAM,SAAS,yBAAyB,GACtC,iCAAiC,GACjC,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GACzC,oBAAoB,CAAC,MAAM,CAAC,GAC5B,iBAAiB,CAAC,MAAM,CAAC,CAAA;AAErC,KAAK,gBAAgB,CAAC,MAAM,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GACtE,CAAC,MAAM,gBAAgB,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAC9C,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,GAC/B,gBAAgB,CAAC,MAAM,CAAC,GAC1B,CAAC,MAAM,gBAAgB,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAC9C,gBAAgB,CAAC,MAAM,CAAC,GACxB,gBAAgB,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAA;AAE1E,KAAK,UAAU,CAAC,MAAM,IAAI,MAAM,SAAS,OAAO,GAC5C,gBAAgB,CAAC,MAAM,CAAC,GACxB,KAAK,CAAA;AAET,KAAK,WAAW,CAAC,MAAM,IAAI,MAAM,UAAU,CAAC,MAAM,CAAC,GAAG,MAAM,CAAA;AAE5D,KAAK,OAAO,CACV,MAAM,EACN,IAAI,SAAS,WAAW,CAAC,MAAM,CAAC,IAC9B,IAAI,SAAS,MAAM,UAAU,CAAC,MAAM,CAAC,GACrC,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,QAAQ,SAAS,KAAK,GAC3D,QAAQ,GACR,KAAK,GACP,KAAK,CAAA;AAET,KAAK,kCAAkC,GAAG,IAAI,CAC5C,uBAAuB,EACvB,SAAS,CACV,GACC,QAAQ,CAAC;IAAE,OAAO,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC,CAAA;AAE/B;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,MAAM,qBAAqB,CAC/B,MAAM,SAAS,WAAW,EAC1B,IAAI,SAAS,WAAW,CAAC,MAAM,CAAC,EAChC,MAAM,IACJ,QAAQ,CAAC;IACX,MAAM,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAA;IAC/B,IAAI,EAAE,IAAI,CAAA;IACV,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,MAAM,CAAA;IAClD,OAAO,CAAC,EAAE,uBAAuB,CAAA;CAClC,CAAC,CAAA;AAEF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,MAAM,8BAA8B,CACxC,MAAM,SAAS,WAAW,EAC1B,IAAI,SAAS,WAAW,CAAC,MAAM,CAAC,EAChC,MAAM,IACJ,QAAQ,CAAC;IACX,MAAM,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAA;IAC/B,IAAI,EAAE,IAAI,CAAA;IACV,cAAc,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACvE,OAAO,CAAC,EAAE,uBAAuB,CAAA;CAClC,CAAC,CAAA;AAuCF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,MAAM,4CAA4C,CACtD,MAAM,SAAS,WAAW,EAC1B,IAAI,SAAS,WAAW,CAAC,MAAM,CAAC,EAChC,MAAM,IACJ,QAAQ,CAAC;IACX,MAAM,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAA;IAC/B,IAAI,EAAE,IAAI,CAAA;IACV,cAAc,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACvE,OAAO,CAAC,EAAE,kCAAkC,CAAA;CAC7C,CAAC,CAAA;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AACH,eAAO,MAAM,wBAAwB,GACnC,MAAM,SAAS,WAAW,EAC1B,IAAI,SAAS,WAAW,CAAC,MAAM,CAAC,EAChC,MAAM,UAEE,8BAA8B,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,KAC3D,MAAM,CAAC,MAAM,CAAC,MAAM,CAAkD,CAAA;AAEzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,eAAO,MAAM,eAAe,GAC1B,MAAM,SAAS,WAAW,EAC1B,IAAI,SAAS,WAAW,CAAC,MAAM,CAAC,EAChC,MAAM,UAEE,qBAAqB,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,KAClD,MAAM,CAAC,MAAM,CAAC,MAAM,CAInB,CAAA;AAEJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACH,eAAO,MAAM,sCAAsC,GACjD,MAAM,SAAS,WAAW,EAC1B,IAAI,SAAS,WAAW,CAAC,MAAM,CAAC,EAChC,MAAM,UAEE,4CAA4C,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,KACzE,MAAM,CAAC,MAAM,CAAC,MAAM,CA4BtB,CAAA"}

package/dist/{subscription/fromEvent.js → dom/streamFromEvent.js}

@@ -19,7 +19,7 @@ const listen = (config) => Stream.callback(queue => Effect.acquireRelease(Effect
  * mapper chooses to keep, registering the listener when the Stream's scope
  * opens and removing it when the scope closes.
  *
- * This is the filtered variant of `fromEvent`. Its `filterMapEvent` returns
+ * This is the filtered variant of `streamFromEvent`. Its `filterMapEvent` returns
  * `Option.some(value)` to emit and `Option.none()` to ignore the event, so a
  * single listener can react to some dispatches while passing on the rest. A
  * mapper that never emits produces a `Stream<never>`.
@@ -32,7 +32,7 @@ const listen = (config) => Stream.callback(queue => Effect.acquireRelease(Effect
  * which ignores `preventDefault()`. Some browsers default wheel and touch
  * listeners on global targets to passive. Pass
  * `options: { passive: false }` explicitly when cancelling those events, or
- * reach for `fromEventFilterMapPreventDefault`, which does so for you.
+ * reach for `streamFromEventFilterMapPreventDefault`, which does so for you.
  *
  * The target, the event name, and the event the mapper receives are one fact:
  * `type` is constrained to the names the target declares, and the mapper's
@@ -47,8 +47,8 @@ const listen = (config) => Stream.callback(queue => Effect.acquireRelease(Effect
  * listener never leaks on interruption.
  *
  * This is a Stream, not a Subscription entry. Wrap it with
- * `Subscription.persistent` for a listener whose lifetime spans the whole
- * Subscriptions record, or plug it into a `Subscription.make` entry's
+ * `Subscription.persistentEntry` for a listener with no local Model dependencies,
+ * or plug it into a `Subscription.make` entry's
  * `dependenciesToStream` (typically behind `Stream.when`) to gate it on a
  * Model condition. The mapper's output type is inferred (even a raw Event is
  * accepted here); `Subscription.make` checks the final Stream against the
@@ -63,7 +63,7 @@ const listen = (config) => Stream.callback(queue => Effect.acquireRelease(Effect
  *       modelToDependencies: model => ({ isListening: model.isListening }),
  *       dependenciesToStream: ({ isListening }) =>
  *         Stream.when(
- *           Subscription.fromEventFilterMap({
+ *           Dom.streamFromEventFilterMap({
  *             target: window,
  *             type: 'keydown',
  *             filterMapEvent: event =>
@@ -78,7 +78,7 @@ const listen = (config) => Stream.callback(queue => Effect.acquireRelease(Effect
  * }))
  * ```
  */
-export const fromEventFilterMap = (config) => listen(config);
+export const streamFromEventFilterMap = (config) => listen(config);
 /**
  * Build a Stream that emits a value for every dispatch of a DOM event,
  * registering the listener when the Stream's scope opens and removing it when
@@ -97,17 +97,17 @@ export const fromEventFilterMap = (config) => listen(config);
  * listener never leaks on interruption.
  *
  * This is a Stream, not a Subscription entry. Wrap it with
- * `Subscription.persistent` for a listener whose lifetime spans the whole
- * Subscriptions record, or plug it into a `Subscription.make` entry's
+ * `Subscription.persistentEntry` for a listener with no local Model dependencies,
+ * or plug it into a `Subscription.make` entry's
  * `dependenciesToStream` (typically behind `Stream.when`) to gate it on a
  * Model condition. The mapper's output type is inferred (even a raw Event is
  * accepted here); `Subscription.make` checks the final Stream against the
  * application's Message type.
  *
  * For a listener that reacts to only some events, reach for
- * `fromEventFilterMap`, whose mapper returns `Option<Output>`. For a
+ * `streamFromEventFilterMap`, whose mapper returns `Option<Output>`. For a
  * listener that also cancels the default action of the events it handles,
- * reach for `fromEventFilterMapPreventDefault`.
+ * reach for `streamFromEventFilterMapPreventDefault`.
  *
  * @example
  * ```typescript
@@ -118,7 +118,7 @@ export const fromEventFilterMap = (config) => listen(config);
  *       modelToDependencies: model => ({ isListening: model.isListening }),
  *       dependenciesToStream: ({ isListening }) =>
  *         Stream.when(
- *           Subscription.fromEvent({
+ *           Dom.streamFromEvent({
  *             target: window,
  *             type: 'keydown',
  *             mapEvent: event => Message.PressedKey({ key: event.key }),
@@ -130,7 +130,7 @@ export const fromEventFilterMap = (config) => listen(config);
  * }))
  * ```
  */
-export const fromEvent = (config) => listen({
+export const streamFromEvent = (config) => listen({
     ...config,
     filterMapEvent: event => Option.some(config.mapEvent(event)),
 });
@@ -140,7 +140,7 @@ export const fromEvent = (config) => listen({
  * registering the listener when the Stream's scope opens and removing it when
  * the scope closes.
  *
- * This is the cancelling variant of `fromEventFilterMap`, mirroring
+ * This is the cancelling variant of `streamFromEventFilterMap`, mirroring
  * `h.OnKeyDownPreventDefault` from `foldkit/html`. Its `filterMapEvent` returns
  * `Option.some(value)` to mark a dispatch handled. The helper evaluates the
  * mapper, calls `event.preventDefault()`, and queues the value before the
@@ -165,8 +165,8 @@ export const fromEvent = (config) => listen({
  * listener never leaks on interruption.
  *
  * This is a Stream, not a Subscription entry. Wrap it with
- * `Subscription.persistent` for a listener whose lifetime spans the whole
- * Subscriptions record, or plug it into a `Subscription.make` entry's
+ * `Subscription.persistentEntry` for a listener with no local Model dependencies,
+ * or plug it into a `Subscription.make` entry's
  * `dependenciesToStream` (typically behind `Stream.when`) to gate it on a
  * Model condition. The mapper's output type is inferred (even a raw Event is
  * accepted here); `Subscription.make` checks the final Stream against the
@@ -181,7 +181,7 @@ export const fromEvent = (config) => listen({
  *       modelToDependencies: model => ({ isModalOpen: model.isModalOpen }),
  *       dependenciesToStream: ({ isModalOpen }) =>
  *         Stream.when(
- *           Subscription.fromEventFilterMapPreventDefault({
+ *           Dom.streamFromEventFilterMapPreventDefault({
  *             target: window,
  *             type: 'wheel',
  *             filterMapEvent: () => Option.some(Message.SuppressedWheelScroll()),
@@ -193,20 +193,20 @@ export const fromEvent = (config) => listen({
  * }))
  * ```
  */
-export const fromEventFilterMapPreventDefault = (config) => {
+export const streamFromEventFilterMapPreventDefault = (config) => {
     const options = config.options;
     if (options?.passive === true) {
-        throw new Error(`Foldkit: \`Subscription.fromEventFilterMapPreventDefault\` was passed ` +
+        throw new Error(`Foldkit: \`Dom.streamFromEventFilterMapPreventDefault\` was passed ` +
             `\`options: { passive: true }\` for a "${config.type}" listener. ` +
             `The helper exists to call \`event.preventDefault()\` on every ` +
             `dispatch the mapper marks handled, and a passive listener promises ` +
             `the browser the exact opposite: \`preventDefault()\` inside it is ` +
             `ignored and logs a console warning. Drop the \`passive\` option ` +
             `(the helper registers the listener with \`passive: false\` for ` +
-            `you), or use \`Subscription.fromEventFilterMap\` for a listener ` +
+            `you), or use \`Dom.streamFromEventFilterMap\` for a listener ` +
             `that only observes.`);
     }
-    return fromEventFilterMap({
+    return streamFromEventFilterMap({
         ...config,
         options: { ...options, passive: false },
         filterMapEvent: event => {

package/dist/{subscription/keyBindings.d.ts → dom/streamFromKeyBindings.d.ts}

@@ -11,7 +11,7 @@ type BindingBase<Output> = Readonly<{
     preventDefault?: boolean;
 }>;
 /**
- * One entry in a {@link keyBindings} binding table.
+ * One entry in a {@link streamFromKeyBindings} binding table.
  *
  * A string describes one key press, such as `'/'`, `'Escape'`, or `'Mod+K'`.
  * An array describes a sequence of at least two presses, such as
@@ -25,8 +25,8 @@ export type KeyBinding<Output> = BindingBase<Output> & (Readonly<{
     whenRepeated?: never;
 }>);
 type ModKey = 'Control' | 'Meta';
-/** Configuration for the {@link keyBindings} Stream helper. */
-export type KeyBindingsConfig<Output> = Readonly<{
+/** Configuration for the {@link streamFromKeyBindings} Stream helper. */
+export type StreamFromKeyBindingsConfig<Output> = Readonly<{
     bindings: ReadonlyArray<KeyBinding<Output>>;
     target?: EventTarget | (() => EventTarget);
     modKey?: ModKey;
@@ -63,7 +63,7 @@ export type KeyBindingsConfig<Output> = Readonly<{
  * are rejected when the Stream is created.
  *
  * This helper returns a Stream, not a complete Subscription entry. Use
- * `Subscription.persistent` for a fixed table. When availability depends on
+ * `Subscription.persistentEntry` for a fixed table. When availability depends on
  * the Model that owns the entry, build it inside `dependenciesToStream` and
  * derive each binding's `isEnabled` from the dependency record. A dependency
  * change opens a new Stream scope and resets any sequence in progress. If a
@@ -83,7 +83,7 @@ export type KeyBindingsConfig<Output> = Readonly<{
  *         isPaletteOpen: model.paletteState._tag === 'Open',
  *       }),
  *       dependenciesToStream: ({ isPaletteOpen }) =>
- *         Subscription.keyBindings<Message>({
+ *         Dom.streamFromKeyBindings<Message>({
  *           bindings: [
  *             {
  *               keys: 'Escape',
@@ -107,6 +107,6 @@ export type KeyBindingsConfig<Output> = Readonly<{
  * }))
  * ```
  */
-export declare const keyBindings: <Output>(config: KeyBindingsConfig<Output>) => Stream.Stream<Output>;
+export declare const streamFromKeyBindings: <Output>(config: StreamFromKeyBindingsConfig<Output>) => Stream.Stream<Output>;
 export {};
-//# sourceMappingURL=keyBindings.d.ts.map
+//# sourceMappingURL=streamFromKeyBindings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"streamFromKeyBindings.d.ts","sourceRoot":"","sources":["../../src/dom/streamFromKeyBindings.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,QAAQ,EAOR,MAAM,EAGP,MAAM,QAAQ,CAAA;AAEf,oFAAoF;AACpF,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,OAAO,CAAA;AAE9C,mEAAmE;AACnE,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,QAAQ,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;AAE/E,KAAK,WAAW,CAAC,MAAM,IAAI,QAAQ,CAAC;IAClC,IAAI,EAAE,WAAW,CAAA;IACjB,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,MAAM,CAAA;IAC1C,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB,CAAC,CAAA;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,CAAC,MAAM,IAAI,WAAW,CAAC,MAAM,CAAC,GAClD,CACI,QAAQ,CAAC;IACP,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAA;CAClC,CAAC,GACF,QAAQ,CAAC;IACP,IAAI,EAAE,QAAQ,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;IAClD,YAAY,CAAC,EAAE,KAAK,CAAA;CACrB,CAAC,CACL,CAAA;AAEH,KAAK,MAAM,GAAG,SAAS,GAAG,MAAM,CAAA;AAEhC,yEAAyE;AACzE,MAAM,MAAM,2BAA2B,CAAC,MAAM,IAAI,QAAQ,CAAC;IACzD,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAA;IAC3C,MAAM,CAAC,EAAE,WAAW,GAAG,CAAC,MAAM,WAAW,CAAC,CAAA;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,eAAe,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAA;CACjC,CAAC,CAAA;AAwzBF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0EG;AACH,eAAO,MAAM,qBAAqB,GAAI,MAAM,UAClC,2BAA2B,CAAC,MAAM,CAAC,KAC1C,MAAM,CAAC,MAAM,CAAC,MAAM,CACuC,CAAA"}