foldkit 0.156.0 → 0.157.0

package/dist/mount/index.d.ts

@@ -11,15 +11,31 @@ declare const MountTracker_base: Context.ServiceClass<MountTracker, "@foldkit/Mo
  *  fire in their VNode-only environment. */
 export declare class MountTracker extends MountTracker_base {
 }
+/** The state of the DOM currently owned by the Foldkit renderer. `Live` means
+ *  it represents the current live Model. `Paused` means time travel has
+ *  installed a historical view while the live application continues running. */
+export declare const ViewState: Schema.Literals<readonly ["Live", "Paused"]>;
+/** The state of the DOM currently owned by the Foldkit renderer. */
+export type ViewState = typeof ViewState.Type;
+declare const MountRuntime_base: Context.ServiceClass<MountRuntime, "@foldkit/MountRuntime", {
+    readonly captureViewStateChanges: () => Stream.Stream<ViewState>;
+}>;
+/** @internal Runtime state used by `OnMount` to supply
+ *  `viewStateChanges`. */
+export declare class MountRuntime extends MountRuntime_base {
+}
 /** Type-level brand for MountDefinition values. */
 export declare const MountDefinitionTypeId: unique symbol;
 /** Type-level brand for MountDefinition values. */
 export type MountDefinitionTypeId = typeof MountDefinitionTypeId;
 /** A named, type-constrained per-element side effect, optionally carrying the
  *  args used to construct it. The runtime invokes `f` with the live `Element`
- *  when the element mounts, and dispatches each Message emitted by the
- *  returned Stream. The Stream's scope is tied to the element's lifetime: when
- *  the element unmounts, the runtime interrupts the fiber, which closes the
+ *  and required view-state Stream when the element mounts. A Mount acquired by
+ *  a live render keeps live dispatch, while one acquired by a historical
+ *  render uses no-op dispatch. When resume reuses a replay-created element,
+ *  the runtime releases its historical Mount before starting the live action.
+ *  Otherwise the Stream's scope is tied to the element's lifetime: when the
+ *  element unmounts, the runtime interrupts the fiber, which closes the
  *  Stream's scope and runs any registered `acquireRelease` finalizers.
  *
  *  Authors don't construct this shape directly. `Mount.define` builds it from
@@ -29,7 +45,7 @@ export type MountDefinitionTypeId = typeof MountDefinitionTypeId;
 export type MountAction<Message, E = never> = Readonly<{
     name: string;
     args?: Record<string, unknown>;
-    f: (element: Element) => Stream.Stream<Message, E>;
+    f: (element: Element, viewStateChanges: Stream.Stream<ViewState>) => Stream.Stream<Message, E>;
 }>;
 /** A Mount definition for a Mount with no declared args. Call as `Definition()` to produce a MountAction. */
 export interface MountDefinitionNoArgs<Name extends string, ResultMessage> {
@@ -37,7 +53,7 @@ export interface MountDefinitionNoArgs<Name extends string, ResultMessage> {
     readonly name: Name;
     (): Readonly<{
         name: Name;
-        f: (element: Element) => Stream.Stream<ResultMessage>;
+        f: (element: Element, viewStateChanges: Stream.Stream<ViewState>) => Stream.Stream<ResultMessage>;
     }>;
 }
 /** A Mount definition for a Mount with declared args. Call as `Definition(args)` to produce a MountAction. */
@@ -47,7 +63,7 @@ export interface MountDefinitionWithArgs<Name extends string, Fields extends Sch
     (args: Schema.Schema.Type<Schema.Struct<Fields>>): Readonly<{
         name: Name;
         args: Schema.Schema.Type<Schema.Struct<Fields>>;
-        f: (element: Element) => Stream.Stream<ResultMessage>;
+        f: (element: Element, viewStateChanges: Stream.Stream<ViewState>) => Stream.Stream<ResultMessage>;
     }>;
 }
 /** A Mount definition created with `Mount.define` or `Mount.defineStream`.
@@ -58,23 +74,58 @@ export type MountDefinition<Name extends string = string, ResultMessage = any> =
  *  element under that name, so an arg of the same name would shadow it. The
  *  literal is the type error a colliding declaration produces. */
 type ElementFieldIsReserved = 'Mount args cannot declare `element`: execute already receives the live element';
+/** @internal Rejects an args field named `viewStateChanges`. `execute`
+ *  receives the runtime-owned Stream under that name. */
+type ViewStateChangesFieldIsReserved = 'Mount args cannot declare `viewStateChanges`: execute already receives the view-state Stream';
+/** @internal Fields the runtime supplies to every Mount execution. */
+type ExecuteRuntimeInput = Readonly<{
+    element: Element;
+    viewStateChanges: Stream.Stream<ViewState>;
+}>;
+/** @internal Type-level rejection for args that collide with runtime fields. */
+type ReservedExecuteFields = Readonly<{
+    element?: ElementFieldIsReserved;
+    viewStateChanges?: ViewStateChangesFieldIsReserved;
+}>;
+/** A never-ending view-state Stream for renderers without time travel.
+ *  It emits `Live` immediately and never completes. Custom renderers and
+ *  low-level MountAction wrappers can pass it as the required second argument
+ *  to `MountAction.f` when the rendered view is always live. */
+export declare const liveViewStateChanges: Stream.Stream<ViewState>;
 /**
  * Defines a one-shot Mount. Every input is a named field: `args` declares the
  * args Schema, `messages` lists the Messages this Mount can produce, and
  * `execute` holds the work. `execute` receives the live `Element` as `element`
- * alongside the declared args, and returns an `Effect<Message>` that runs once
- * when the element mounts and produces exactly one Message.
+ * and the runtime's `viewStateChanges` Stream alongside the declared args, and
+ * returns an `Effect<Message>` that runs once when the element mounts and
+ * produces exactly one Message.
  *
  * `args` is optional. Omit it and the Definition is callable as `Definition()`;
  * declare it and the Definition is callable as `Definition(args)`. `execute`
- * keeps the same shape either way, because a Mount always has an element. An
- * args field named `element` is rejected where you declare it, since it would
- * collide with the element `execute` receives.
+ * keeps the same shape either way, because a Mount always has an element and a
+ * view-state Stream. Args fields named `element` or `viewStateChanges` are
+ * rejected where you declare them, since they would collide with the runtime
+ * fields `execute` receives.
  *
  * Constructing a MountAction never runs `execute`. The runtime calls it when
  * the element enters the DOM, so nothing the body does happens inside the pure
  * view that built the action.
  *
+ * `viewStateChanges` begins with the rendered view's `Live | Paused` state at
+ * the moment the Mount is acquired, followed by changes. This acquisition
+ * state stays available when `execute` performs asynchronous setup before
+ * consuming the Stream, so a Mount inserted by a historical render always
+ * observes `Paused` first. Time travel pauses the rendered view, not the live
+ * application. Use this Stream to make an imperative integration read-only
+ * while historical DOM is installed. A surviving live Mount stays acquired
+ * throughout pause and resume. Its live async work and external event sources
+ * also continue, so the integration must use the Stream to stop DOM-derived
+ * interaction while paused. Mounts acquired by a historical render cannot
+ * dispatch to the live Model. If the resumed live view owns the same element,
+ * Foldkit releases the replay acquisition before starting the live action. The
+ * Stream stays open for the Mount's lifetime. When time travel is unavailable,
+ * it emits only `Live`.
+ *
  * Cleanup composes via `Effect.acquireRelease` inside the Effect: registered
  * finalizers run when the element unmounts. The Mount's scope stays open
  * across the element's full lifetime, even after the Effect completes.
@@ -144,7 +195,7 @@ type ElementFieldIsReserved = 'Mount args cannot declare `element`: execute alre
  * @example With args
  * ```ts
  * const AnchorPopover = Mount.define('AnchorPopover', {
- *   args: { buttonId: S.String, anchor: AnchorConfig },
+ *   args: { buttonId: Schema.String, anchor: AnchorConfig },
  *   messages: [CompletedAnchorPopover],
  *   execute: ({ element, buttonId, anchor }) =>
  *     Effect.gen(function* () {
@@ -181,42 +232,50 @@ type ElementFieldIsReserved = 'Mount args cannot declare `element`: execute alre
  * and undoing it when the drag ends).)
  */
 export declare function define<const Name extends string, Fields extends Schema.Struct.Fields, const Messages extends readonly [Schema.Top, ...ReadonlyArray<Schema.Top>]>(name: Name, config: Readonly<{
-    args: Fields & Readonly<{
-        element?: ElementFieldIsReserved;
-    }>;
+    args: Fields & ReservedExecuteFields;
     messages: Messages;
-    execute: (input: Readonly<{
-        element: Element;
-    }> & Schema.Schema.Type<Schema.Struct<Fields>>) => Effect.Effect<Schema.Schema.Type<Messages[number]>, never, Scope.Scope>;
+    execute: (input: ExecuteRuntimeInput & Schema.Schema.Type<Schema.Struct<Fields>>) => Effect.Effect<Schema.Schema.Type<Messages[number]>, never, Scope.Scope>;
 }>): MountDefinitionWithArgs<Name, Fields, Schema.Schema.Type<Messages[number]>>;
 export declare function define<const Name extends string, const Messages extends readonly [Schema.Top, ...ReadonlyArray<Schema.Top>]>(name: Name, config: Readonly<{
     args?: never;
     messages: Messages;
-    execute: (input: Readonly<{
-        element: Element;
-    }>) => Effect.Effect<Schema.Schema.Type<Messages[number]>, never, Scope.Scope>;
+    execute: (input: ExecuteRuntimeInput) => Effect.Effect<Schema.Schema.Type<Messages[number]>, never, Scope.Scope>;
 }>): MountDefinitionNoArgs<Name, Schema.Schema.Type<Messages[number]>>;
 /**
  * Defines a streaming Mount. Every input is a named field, exactly as in
  * `Mount.define`: `args` declares the args Schema, `messages` lists the
  * Messages this Mount can produce, and `execute` holds the work. `execute`
- * receives the live `Element` as `element` alongside the declared args, and
- * returns a `Stream<Message>` whose lifetime is bound to the element's
- * lifetime: each emitted Message is dispatched, and the Stream's scope is
- * closed (running any registered `Effect.acquireRelease` finalizers) when the
- * element unmounts. Use this form when the Mount emits a continuum of events
- * from observers or listeners attached to the element.
+ * receives the live `Element` as `element` and the runtime's
+ * `viewStateChanges` Stream alongside the declared args, and returns a
+ * `Stream<Message>` whose lifetime is bound to the element's lifetime: each
+ * emitted Message is dispatched, and the Stream's scope is closed (running any
+ * registered `Effect.acquireRelease` finalizers) when the element unmounts.
+ * Use this form when the Mount emits a continuum of events from observers or
+ * listeners attached to the element.
  *
  * `args` is optional. Omit it and the Definition is callable as `Definition()`;
  * declare it and the Definition is callable as `Definition(args)`. `execute`
- * keeps the same shape either way, because a Mount always has an element. An
- * args field named `element` is rejected where you declare it, since it would
- * collide with the element `execute` receives.
+ * keeps the same shape either way, because a Mount always has an element and a
+ * view-state Stream. Args fields named `element` or `viewStateChanges` are
+ * rejected where you declare them, since they would collide with the runtime
+ * fields `execute` receives.
  *
  * Constructing a MountAction never runs `execute`. The runtime calls it when
  * the element enters the DOM, so nothing the body does happens inside the pure
  * view that built the action.
  *
+ * `viewStateChanges` has the same semantics as in `Mount.define`: it begins
+ * with the rendered view's state at acquisition even after asynchronous
+ * setup, keeps a surviving live Mount acquired, and returns to `Live` only
+ * after the latest live view has been patched back into the DOM. A live
+ * Mount's external sources continue while paused, so use the state to stop
+ * listeners from turning historical DOM interaction into Messages. A Mount
+ * acquired by a historical render cannot dispatch to the live Model. If the
+ * resumed live view owns the same element, Foldkit releases the replay
+ * acquisition before starting the live action. The state Stream stays open
+ * for the Mount's lifetime. When time travel is unavailable, it emits only
+ * `Live`.
+ *
  * At least one result Message schema is required. The Stream's emission
  * type is `Schema.Schema.Type<Messages[number]>`; without a declared
  * result, `execute` would have to return `Stream<never>`, leaving
@@ -303,20 +362,14 @@ export declare function define<const Name extends string, const Messages extends
  * the mental model.
  */
 export declare function defineStream<const Name extends string, Fields extends Schema.Struct.Fields, const Messages extends readonly [Schema.Top, ...ReadonlyArray<Schema.Top>]>(name: Name, config: Readonly<{
-    args: Fields & Readonly<{
-        element?: ElementFieldIsReserved;
-    }>;
+    args: Fields & ReservedExecuteFields;
     messages: Messages;
-    execute: (input: Readonly<{
-        element: Element;
-    }> & Schema.Schema.Type<Schema.Struct<Fields>>) => Stream.Stream<Schema.Schema.Type<Messages[number]>, never, never>;
+    execute: (input: ExecuteRuntimeInput & Schema.Schema.Type<Schema.Struct<Fields>>) => Stream.Stream<Schema.Schema.Type<Messages[number]>, never, never>;
 }>): MountDefinitionWithArgs<Name, Fields, Schema.Schema.Type<Messages[number]>>;
 export declare function defineStream<const Name extends string, const Messages extends readonly [Schema.Top, ...ReadonlyArray<Schema.Top>]>(name: Name, config: Readonly<{
     args?: never;
     messages: Messages;
-    execute: (input: Readonly<{
-        element: Element;
-    }>) => Stream.Stream<Schema.Schema.Type<Messages[number]>, never, never>;
+    execute: (input: ExecuteRuntimeInput) => Stream.Stream<Schema.Schema.Type<Messages[number]>, never, never>;
 }>): MountDefinitionNoArgs<Name, Schema.Schema.Type<Messages[number]>>;
 /** Lifts a `MountAction` from one Message universe to another by mapping its
  *  dispatched Messages through a transform. Used by Submodel components to

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mount/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mount/index.ts"],"names":[],"mappings":"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"}

package/dist/mount/index.js

@@ -1,4 +1,4 @@
-import { Context, Effect, Function, Predicate, Queue, Stream, } from 'effect';
+import { Context, Effect, Function, Predicate, Queue, Schema, Stream, } from 'effect';
 /** Effect service tag that observes Mount lifecycle events. The runtime
  *  provides an implementation that buffers events for DevTools history;
  *  the OnMount snabbdom hooks call `started` synchronously when an element
@@ -7,6 +7,14 @@ import { Context, Effect, Function, Predicate, Queue, Stream, } from 'effect';
  *  fire in their VNode-only environment. */
 export class MountTracker extends Context.Service()('@foldkit/MountTracker') {
 }
+/** The state of the DOM currently owned by the Foldkit renderer. `Live` means
+ *  it represents the current live Model. `Paused` means time travel has
+ *  installed a historical view while the live application continues running. */
+export const ViewState = Schema.Literals(['Live', 'Paused']);
+/** @internal Runtime state used by `OnMount` to supply
+ *  `viewStateChanges`. */
+export class MountRuntime extends Context.Service()('@foldkit/MountRuntime') {
+}
 /** Type-level brand for MountDefinition values. */
 /* eslint-disable-next-line @typescript-eslint/consistent-type-assertions */
 export const MountDefinitionTypeId = Symbol.for('foldkit/MountDefinition');
@@ -22,8 +30,13 @@ const brandAsDefinition = (definition, name) => {
         value: MountDefinitionTypeId,
     });
 };
-const wrapEffectAsStream = (toEffect) => (element) => Stream.callback(queue => Effect.gen(function* () {
-    const message = yield* toEffect(element);
+/** A never-ending view-state Stream for renderers without time travel.
+ *  It emits `Live` immediately and never completes. Custom renderers and
+ *  low-level MountAction wrappers can pass it as the required second argument
+ *  to `MountAction.f` when the rendered view is always live. */
+export const liveViewStateChanges = Stream.concat(Stream.make(ViewState.make('Live')), Stream.never);
+const wrapEffectAsStream = (toEffect) => (element, viewStateChanges) => Stream.callback(queue => Effect.gen(function* () {
+    const message = yield* toEffect(element, viewStateChanges);
     Queue.offerUnsafe(queue, message);
     return yield* Effect.never;
 }));
@@ -33,7 +46,7 @@ export function define(name, config) {
         const definition = (args) => ({
             name,
             args,
-            f: wrapEffectAsStream(element => config.execute({ ...args, element })),
+            f: wrapEffectAsStream((element, viewStateChanges) => config.execute({ ...args, element, viewStateChanges })),
         });
         brandAsDefinition(definition, name);
         return definition;
@@ -41,7 +54,7 @@ export function define(name, config) {
     else {
         const definition = () => ({
             name,
-            f: wrapEffectAsStream(element => config.execute({ element })),
+            f: wrapEffectAsStream((element, viewStateChanges) => config.execute({ element, viewStateChanges })),
         });
         brandAsDefinition(definition, name);
         return definition;
@@ -53,7 +66,11 @@ export function defineStream(name, config) {
         const definition = (args) => ({
             name,
             args,
-            f: (element) => config.execute({ ...args, element }),
+            f: (element, viewStateChanges) => config.execute({
+                ...args,
+                element,
+                viewStateChanges,
+            }),
         });
         brandAsDefinition(definition, name);
         return definition;
@@ -61,7 +78,10 @@ export function defineStream(name, config) {
     else {
         const definition = () => ({
             name,
-            f: (element) => config.execute({ element }),
+            f: (element, viewStateChanges) => config.execute({
+                element,
+                viewStateChanges,
+            }),
         });
         brandAsDefinition(definition, name);
         return definition;
@@ -73,5 +93,5 @@ export function defineStream(name, config) {
  *  consumer-supplied `toParentMessage` lift. Preserves `name` and `args`. */
 export const mapMessage = Function.dual(2, (action, f) => ({
     ...action,
-    f: (element) => action.f(element).pipe(Stream.map(f)),
+    f: (element, viewStateChanges) => action.f(element, viewStateChanges).pipe(Stream.map(f)),
 }));

package/dist/mount/public.d.ts

@@ -1,3 +1,3 @@
 export type { MountAction, MountDefinition, MountDefinitionNoArgs, MountDefinitionWithArgs, } from './index.js';
-export { MountDefinitionTypeId, MountTracker, define, defineStream, mapMessage, } from './index.js';
+export { MountDefinitionTypeId, MountTracker, ViewState, define, defineStream, liveViewStateChanges, mapMessage, } from './index.js';
 //# sourceMappingURL=public.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../src/mount/public.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,WAAW,EACX,eAAe,EACf,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,qBAAqB,EACrB,YAAY,EACZ,MAAM,EACN,YAAY,EACZ,UAAU,GACX,MAAM,YAAY,CAAA"}
+{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../src/mount/public.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,WAAW,EACX,eAAe,EACf,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,qBAAqB,EACrB,YAAY,EACZ,SAAS,EACT,MAAM,EACN,YAAY,EACZ,oBAAoB,EACpB,UAAU,GACX,MAAM,YAAY,CAAA"}

package/dist/mount/public.js

@@ -1 +1 @@
-export { MountDefinitionTypeId, MountTracker, define, defineStream, mapMessage, } from './index.js';
+export { MountDefinitionTypeId, MountTracker, ViewState, define, defineStream, liveViewStateChanges, mapMessage, } from './index.js';

package/dist/navigation/urlRequest.d.ts

@@ -1,18 +1,18 @@
-import { Schema as S } from 'effect';
+import { Schema } from 'effect';
 /** Union of `Internal` and `External` URL request types. */
 export declare const UrlRequest: import("../schema/index.js").TaggedUnion<{
     readonly Internal: {
-        url: S.Struct<{
-            readonly protocol: S.String;
-            readonly host: S.String;
-            readonly port: S.Option<S.String>;
-            readonly pathname: S.String;
-            readonly search: S.Option<S.String>;
-            readonly hash: S.Option<S.String>;
+        url: Schema.Struct<{
+            readonly protocol: Schema.String;
+            readonly host: Schema.String;
+            readonly port: Schema.Option<Schema.String>;
+            readonly pathname: Schema.String;
+            readonly search: Schema.Option<Schema.String>;
+            readonly hash: Schema.Option<Schema.String>;
         }>;
     };
     readonly External: {
-        href: S.String;
+        href: Schema.String;
     };
 }>;
 /** Union of `Internal` and `External` URL request types. */

package/dist/navigation/urlRequest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"urlRequest.d.ts","sourceRoot":"","sources":["../../src/navigation/urlRequest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC,EAAE,MAAM,QAAQ,CAAA;AAKpC,4DAA4D;AAC5D,eAAO,MAAM,UAAU;;QACT,GAAG;;;;;;;;;;QACH,IAAI;;EAChB,CAAA;AACF,4DAA4D;AAC5D,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC,IAAI,CAAA"}
+{"version":3,"file":"urlRequest.d.ts","sourceRoot":"","sources":["../../src/navigation/urlRequest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAK/B,4DAA4D;AAC5D,eAAO,MAAM,UAAU;;QACT,GAAG;;;;;;;;;;QACH,IAAI;;EAChB,CAAA;AACF,4DAA4D;AAC5D,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC,IAAI,CAAA"}

package/dist/navigation/urlRequest.js

@@ -1,8 +1,8 @@
-import { Schema as S } from 'effect';
+import { Schema } from 'effect';
 import { defineTaggedUnion } from '../schema/index.js';
 import { Url } from '../url/index.js';
 /** Union of `Internal` and `External` URL request types. */
 export const UrlRequest = defineTaggedUnion({
     Internal: { url: Url },
-    External: { href: S.String },
+    External: { href: Schema.String },
 });

package/dist/onUnmountModule.d.ts

@@ -0,0 +1,19 @@
+import { type Module, type VNodeData } from './snabbdom/index.js';
+/** Opens the replay-render window used to distinguish historical VNodes from
+ *  the live imperative lifecycle they temporarily replace. */
+export declare const beginReplayUnmountRender: () => void;
+/** Closes a successful replay-render window and discards live `OnUnmount`
+ *  callbacks deferred while installing the historical view. */
+export declare const endReplayUnmountRender: () => void;
+/** Records an `OnUnmount` callback and the render that owns it on a VNode. */
+export declare const attachOnUnmount: (data: VNodeData, dispatch: () => void) => void;
+/** Dispatches the live `OnUnmount` callbacks deferred by a replay patch that
+ *  failed and forced the runtime to discard the damaged DOM. Repeated destroy
+ *  calls for one element are deduplicated without conflating distinct elements
+ *  built from a shared VNode. */
+export declare const flushReplayUnmountsAfterPatchFailure: () => void;
+/** Snabbdom module that preserves a live element's `OnUnmount` ownership while
+ *  replay VNodes patch it in place, then routes teardown according to whether
+ *  the historical patch succeeded or required recovery. */
+export declare const onUnmountModule: Module;
+//# sourceMappingURL=onUnmountModule.d.ts.map

package/dist/onUnmountModule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onUnmountModule.d.ts","sourceRoot":"","sources":["../src/onUnmountModule.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,MAAM,EAEX,KAAK,SAAS,EAGf,MAAM,qBAAqB,CAAA;AAqB5B;8DAC8D;AAC9D,eAAO,MAAM,wBAAwB,QAAO,IAG3C,CAAA;AAED;+DAC+D;AAC/D,eAAO,MAAM,sBAAsB,QAAO,IAGzC,CAAA;AAED,8EAA8E;AAC9E,eAAO,MAAM,eAAe,SACpB,SAAS,YACL,MAAM,IAAI,KACnB,IAUF,CAAA;AAED;;;iCAGiC;AACjC,eAAO,MAAM,oCAAoC,QAAO,IAWvD,CAAA;AAED;;2DAE2D;AAC3D,eAAO,MAAM,eAAe,EAAE,MA0B7B,CAAA"}

package/dist/onUnmountModule.js

@@ -0,0 +1,80 @@
+import { VNodeDataMask, vnodeDataMaskKey, } from './snabbdom/index.js';
+const onUnmountDataKey = 'foldkitOnUnmount';
+let isReplayRenderActive = false;
+const pendingReplayUnmounts = new Map();
+const getOnUnmountData = (vnode) => vnode.data?.[onUnmountDataKey];
+const setOnUnmountData = (data, onUnmount) => {
+    data[onUnmountDataKey] = onUnmount;
+    data[vnodeDataMaskKey] =
+        (data[vnodeDataMaskKey] ?? 0) | VNodeDataMask.OnUnmount;
+};
+/** Opens the replay-render window used to distinguish historical VNodes from
+ *  the live imperative lifecycle they temporarily replace. */
+export const beginReplayUnmountRender = () => {
+    pendingReplayUnmounts.clear();
+    isReplayRenderActive = true;
+};
+/** Closes a successful replay-render window and discards live `OnUnmount`
+ *  callbacks deferred while installing the historical view. */
+export const endReplayUnmountRender = () => {
+    isReplayRenderActive = false;
+    pendingReplayUnmounts.clear();
+};
+/** Records an `OnUnmount` callback and the render that owns it on a VNode. */
+export const attachOnUnmount = (data, dispatch) => {
+    const owner = isReplayRenderActive ? 'Replay' : 'Live';
+    const existing = data[onUnmountDataKey];
+    setOnUnmountData(data, {
+        dispatches: existing?.owner === owner
+            ? [...existing.dispatches, dispatch]
+            : [dispatch],
+        owner,
+    });
+};
+/** Dispatches the live `OnUnmount` callbacks deferred by a replay patch that
+ *  failed and forced the runtime to discard the damaged DOM. Repeated destroy
+ *  calls for one element are deduplicated without conflating distinct elements
+ *  built from a shared VNode. */
+export const flushReplayUnmountsAfterPatchFailure = () => {
+    if (!isReplayRenderActive) {
+        return;
+    }
+    const unmountGroups = globalThis.Array.from(pendingReplayUnmounts.values());
+    pendingReplayUnmounts.clear();
+    for (const unmounts of unmountGroups) {
+        for (const dispatchUnmount of unmounts) {
+            dispatchUnmount();
+        }
+    }
+};
+/** Snabbdom module that preserves a live element's `OnUnmount` ownership while
+ *  replay VNodes patch it in place, then routes teardown according to whether
+ *  the historical patch succeeded or required recovery. */
+export const onUnmountModule = {
+    dataMask: VNodeDataMask.OnUnmount,
+    update: (oldVnode, vnode) => {
+        const previousOnUnmount = getOnUnmountData(oldVnode);
+        if (!isReplayRenderActive || previousOnUnmount?.owner !== 'Live') {
+            return;
+        }
+        const data = vnode.data === undefined ? {} : { ...vnode.data };
+        vnode.data = data;
+        setOnUnmountData(data, previousOnUnmount);
+    },
+    destroy: vnode => {
+        const onUnmount = getOnUnmountData(vnode);
+        if (onUnmount?.owner !== 'Live') {
+            return;
+        }
+        if (isReplayRenderActive) {
+            if (vnode.elm !== undefined) {
+                pendingReplayUnmounts.set(vnode.elm, onUnmount.dispatches);
+            }
+        }
+        else {
+            for (const dispatchUnmount of onUnmount.dispatches) {
+                dispatchUnmount();
+            }
+        }
+    },
+};

package/dist/port/port.d.ts

@@ -44,8 +44,8 @@ export type Ports = Readonly<{
  * @example
  * ```ts
  * export const ports = {
- *   inbound: { stepChanged: Port.inbound(S.Number) },
- *   outbound: { countChanged: Port.outbound(S.Number) },
+ *   inbound: { stepChanged: Port.inbound(Schema.Number) },
+ *   outbound: { countChanged: Port.outbound(Schema.Number) },
  * }
  * ```
  */
@@ -58,8 +58,8 @@ export declare const inbound: <Value, Encoded>(schema: Schema.Codec<Value, Encod
  * @example
  * ```ts
  * export const ports = {
- *   inbound: { stepChanged: Port.inbound(S.Number) },
- *   outbound: { countChanged: Port.outbound(S.Number) },
+ *   inbound: { stepChanged: Port.inbound(Schema.Number) },
+ *   outbound: { countChanged: Port.outbound(Schema.Number) },
  * }
  * ```
  */
@@ -126,7 +126,7 @@ export declare const subscription: <Value, Encoded, Message>(port: Inbound<Value
  *
  * ```ts
  * const ReportCount = Command.define('ReportCount', {
- *   args: { count: S.Number },
+ *   args: { count: Schema.Number },
  *   messages: [CompletedReportCount],
  *   execute: ({ count }) =>
  *     Port.emit(ports.outbound.countChanged, count).pipe(

package/dist/port/port.js

@@ -14,8 +14,8 @@ export const OutboundTypeId = Symbol.for('foldkit/Port/Outbound');
  * @example
  * ```ts
  * export const ports = {
- *   inbound: { stepChanged: Port.inbound(S.Number) },
- *   outbound: { countChanged: Port.outbound(S.Number) },
+ *   inbound: { stepChanged: Port.inbound(Schema.Number) },
+ *   outbound: { countChanged: Port.outbound(Schema.Number) },
  * }
  * ```
  */
@@ -31,8 +31,8 @@ export const inbound = (schema) => ({
  * @example
  * ```ts
  * export const ports = {
- *   inbound: { stepChanged: Port.inbound(S.Number) },
- *   outbound: { countChanged: Port.outbound(S.Number) },
+ *   inbound: { stepChanged: Port.inbound(Schema.Number) },
+ *   outbound: { countChanged: Port.outbound(Schema.Number) },
  * }
  * ```
  */
@@ -129,7 +129,7 @@ export const subscription = (port, toMessage) => persistent(Stream.map(stream(po
  *
  * ```ts
  * const ReportCount = Command.define('ReportCount', {
- *   args: { count: S.Number },
+ *   args: { count: Schema.Number },
  *   messages: [CompletedReportCount],
  *   execute: ({ count }) =>
  *     Port.emit(ports.outbound.countChanged, count).pipe(

package/dist/route/parser.d.ts

@@ -118,7 +118,7 @@ export declare const __isSingleSegment: (segment: string) => boolean;
  *
  * @example
  * ```ts
- * const UserId = S.String.pipe(S.brand('UserId'))
+ * const UserId = Schema.String.pipe(Schema.brand('UserId'))
  * pipe(literal('users'), slash(schemaSegment('userId', UserId)), mapTo(UserRoute))
  * // parses /users/abc into { _tag: 'UserRoute', userId: UserId.make('abc') }
  * ```
@@ -255,7 +255,7 @@ export declare const slash: {
  * ```ts
  * pipe(
  *   literal('search'),
- *   query(S.Struct({ q: S.String })),
+ *   query(Schema.Struct({ q: Schema.String })),
  *   mapTo(SearchRoute),
  * )
  * ```

package/dist/route/parser.js

@@ -122,7 +122,7 @@ const warnIfNotSingleSegment = (name, segment) => Effect.sync(() => {
  *
  * @example
  * ```ts
- * const UserId = S.String.pipe(S.brand('UserId'))
+ * const UserId = Schema.String.pipe(Schema.brand('UserId'))
  * pipe(literal('users'), slash(schemaSegment('userId', UserId)), mapTo(UserRoute))
  * // parses /users/abc into { _tag: 'UserRoute', userId: UserId.make('abc') }
  * ```
@@ -363,7 +363,7 @@ export const slash = (parserB) => (parserA) => ({
  * ```ts
  * pipe(
  *   literal('search'),
- *   query(S.Struct({ q: S.String })),
+ *   query(Schema.Struct({ q: Schema.String })),
  *   mapTo(SearchRoute),
  * )
  * ```