@wardic/solid 0.0.0-stage → 1.0.0-rc.1

package/dist/solid/unstable/v2/live-value.js

@@ -0,0 +1,235 @@
+import * as LiveValue from "@wardic/core/LiveValue";
+import * as Arr from "effect/Array";
+import * as Bool from "effect/Boolean";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import * as Predicate from "effect/Predicate";
+import { Atom, AtomRegistry } from "effect/reactivity";
+import * as Rec from "effect/Record";
+import * as Scope from "effect/Scope";
+import * as UndefinedOr from "effect/UndefinedOr";
+import { isServer } from "@solidjs/web";
+import { createEffect, createMemo, createSignal, onCleanup, untrack } from "solid-js";
+import { atomOf, followAccessorOf, followOptionsOf, numberOf, readLive, serverFollowOf, serverRegistryOf, unitOf, willChangeOf, withUnit, } from "../../live-style.js";
+import { eachFrameOf } from "../../animation-frame.js";
+import * as OwnerScope from "../../owner-scope.js";
+import { withServerInterpolators } from "../../server-interpolators.js";
+import { followAtom } from "./bridge.js";
+import { CLIENT_ONLY, CLIENT_ONLY_DEFERRED, onSettledClientOnly } from "./solid-reactivity.js";
+import { useWardicRuntime, useWardicSkipAnimations } from "./provider.jsx";
+/** A Live value read now on a server: an Atom through a server's own registry, an accessor called. */
+const readOnServer = (source) => readLive(source, serverRegistryOf, untrack);
+/** An accessor as an Atom, set at each of its changes (at Solid's flush), held in `registry` until its owner's disposal. */
+const mirrorOf = (accessor, registry) => {
+    const atom = Atom.make(untrack(accessor));
+    onCleanup(registry.mount(atom));
+    createEffect(accessor, (value) => {
+        registry.set(atom, value);
+    }, CLIENT_ONLY_DEFERRED);
+    return atom;
+};
+/** `source`'s Atom: its own, the one it carries, or, for a plain accessor, a mirror of it. */
+const sourceAtomOf = (source, registry) => UndefinedOr.match(atomOf(source), {
+    onUndefined: () => mirrorOf(source, registry),
+    onDefined: (atom) => atom,
+});
+/** What a helper's Scope reports when one of its finalizers fails as its owner goes. */
+const CLOSE_FAILED = "wardic.liveValue: a finalizer failed";
+/** A helper's Atom, made on the provider's runtime in a Scope its owner's disposal closes, as an accessor carrying it. */
+const liveOf = (runtime, live) => {
+    const scope = OwnerScope.open(runtime);
+    onCleanup(() => OwnerScope.close(runtime, scope, CLOSE_FAILED));
+    const out = runtime.runSync(live.pipe(Scope.provide(scope)));
+    return followAtom(runtime.runSync(AtomRegistry.AtomRegistry), out);
+};
+export function createTransform(source, fnOrInput, output, options) {
+    const fn = Bool.match(Predicate.isFunction(fnOrInput), {
+        onTrue: () => fnOrInput,
+        onFalse: () => interpolatorOf(fnOrInput, output, options),
+    });
+    if (isServer)
+        return () => fn(readOnServer(source));
+    const atom = atomOf(source);
+    // A plain accessor: mapped in a memo, as Solid maps it.
+    if (Predicate.isUndefined(atom))
+        return createMemo(() => fn(source()), CLIENT_ONLY);
+    // On an Atom: derived on it, so it's set where its source is. What `fn` reads of Solid besides its
+    // source is tracked here, and a change of it re-derives the Atom.
+    const registry = useWardicRuntime().runSync(AtomRegistry.AtomRegistry);
+    const derived = Atom.make((get) => untrack(() => fn(get(atom))));
+    // A change of what `fn` reads of Solid derives it again: the registry's own refresh, where a counter
+    // Atom it read was bumped (#618, L2).
+    createEffect(() => fn(registry.get(atom)), () => {
+        registry.refresh(derived);
+    }, CLIENT_ONLY_DEFERRED);
+    return followAtom(registry, derived);
+}
+/**
+ * The ranges' mapping, resolved once: through the provider's `InterpolatorRegistry` on a client, the
+ * DOM's on a server, which builds no runtime (ADR-0021).
+ */
+const interpolatorOf = (input, output, options) => {
+    // Typed at `createTransform`'s overloads: numbers and strings through the registry, any type through a
+    // `mixer` (#440). Here one mapping serves both.
+    const mapping = LiveValue.interpolate(input, output, options);
+    if (isServer)
+        return Effect.runSync(withServerInterpolators(mapping));
+    return useWardicRuntime().runSync(mapping);
+};
+export function createFollowValue(source, options = {}) {
+    if (isServer)
+        return serverFollowOf(() => readOnServer(source));
+    const runtime = useWardicRuntime();
+    // Its nearest WardicConfig's `skipAnimations` (#468): each change lands at once while it's on.
+    const skipped = useWardicSkipAnimations();
+    const transition = followOptionsOf(options);
+    const registry = runtime.runSync(AtomRegistry.AtomRegistry);
+    const atom = sourceAtomOf(source, registry);
+    const initial = registry.get(atom);
+    // A string's accessor or a number's, as its source started.
+    return followAccessorOf(runtime, Bool.match(Predicate.isString(initial), {
+        onFalse: () => liveOf(runtime, LiveValue.follow(atom, transition, skipped)),
+        // A unit string: its number followed, shown with the unit it started with (Motion's).
+        onTrue: () => liveOf(runtime, Effect.map(LiveValue.follow(Atom.map(atom, numberOf), transition, skipped), withUnit(unitOf(initial)))),
+    }));
+}
+export function createSpring(source, options = {}) {
+    return createFollowValue(source, { ...options, type: "spring" });
+}
+/**
+ * How fast `source` is changing, in its units a second: 0 to begin with, then each frame while it
+ * moves, and 0 once it stops. A velocity is a value too: `createVelocity(createVelocity(x))` is its
+ * acceleration. Motion's `useVelocity`.
+ *
+ * @example
+ * const { scrollY } = createScroll()
+ * const skewY = createTransform(createVelocity(scrollY), [-1000, 1000], [-8, 8])
+ * @see https://wardic.dev/reference/solid/live-values/create-velocity
+ */
+export const createVelocity = (source) => {
+    if (isServer)
+        return SERVER_ZERO;
+    const runtime = useWardicRuntime();
+    return liveOf(runtime, LiveValue.velocity(sourceAtomOf(source, runtime.runSync(AtomRegistry.AtomRegistry))));
+};
+/**
+ * The milliseconds since it was made, wall time, set every frame while its owner lives: for something
+ * that turns forever. It keeps Wardic's frames running while it lives. Motion's `useTime`.
+ *
+ * @example
+ * const rotate = createTransform(createTime(), (ms) => (ms / 1000) * 90)
+ * <w.div style={{ rotate }} />
+ * @see https://wardic.dev/reference/solid/live-values/create-time
+ */
+export const createTime = () => {
+    if (isServer)
+        return SERVER_ZERO;
+    return liveOf(useWardicRuntime(), LiveValue.time());
+};
+const SERVER_ZERO = () => 0;
+/**
+ * A `will-change` for an element's `style`: `"auto"` until the element first animates a transform key,
+ * `opacity`, `clipPath`, `filter` or `backgroundColor`, or is dragged; then `"transform"`, for good, so
+ * the browser keeps it on a layer of its own from its first move on. A key already at its target and a
+ * layout animation don't count. `"auto"` on a server. Motion's `useWillChange`.
+ *
+ * @example
+ * const willChange = createWillChange()
+ * <w.div whileHover={{ scale: 1.1 }} style={{ "will-change": willChange }} />
+ * @see https://wardic.dev/reference/solid/live-values/create-will-change
+ */
+// #443.
+export const createWillChange = () => {
+    if (isServer)
+        return SERVER_AUTO;
+    const registry = useWardicRuntime().runSync(AtomRegistry.AtomRegistry);
+    return willChangeOf(registry, onCleanup, (atom) => followAtom(registry, atom));
+};
+const SERVER_AUTO = () => "auto";
+/**
+ * Calls `callback` every frame while its owner lives, with the frame's `time` and `delta` in
+ * milliseconds: for what a frame draws itself, such as a canvas or a 3D scene. `time` is 0 at the
+ * first frame, then wall time since, a hidden tab's minutes included; `delta` is the frame's own, held
+ * to 1–40 ms, so the first frame back from a hidden tab steps 40 ms. A throw is logged, and the next
+ * frame calls it again. Nothing runs on a server. Motion's `useAnimationFrame`.
+ *
+ * @example
+ * createAnimationFrame((time) => {
+ *   cube.style.transform = `rotateY(${time / 10}deg)`
+ * })
+ * @see https://wardic.dev/reference/solid/live-values/create-animation-frame
+ */
+// #443. It keeps the Clock ticking every frame. A throw is logged at the first of a run of throws, as
+// `onUpdate`'s.
+export const createAnimationFrame = (callback) => {
+    if (isServer)
+        return;
+    const runtime = useWardicRuntime();
+    const scope = OwnerScope.open(runtime);
+    onCleanup(() => OwnerScope.close(runtime, scope, CLOSE_FAILED));
+    runtime.runSync(eachFrameOf(runtime, callback).pipe(Scope.provide(scope)));
+};
+const SCROLL_KEYS = ["scrollX", "scrollY", "scrollXProgress", "scrollYProgress"];
+/** `createScroll`'s elements before the render has settled: none yet. */
+const NOT_YET = { container: Option.none(), target: Option.none() };
+const SERVER_SCROLL = { scrollX: SERVER_ZERO, scrollY: SERVER_ZERO, scrollXProgress: SERVER_ZERO, scrollYProgress: SERVER_ZERO };
+/** An element source read now: `None` for an accessor whose ref hasn't arrived. */
+const elementOf = (source) => Bool.match(Predicate.isFunction(source), {
+    onTrue: () => Option.fromUndefinedOr(source()),
+    onFalse: () => Option.some(source),
+});
+/**
+ * A scroll as values: `scrollX` and `scrollY`, how far it's scrolled, in pixels, and `scrollXProgress`
+ * and `scrollYProgress`, from 0 to 1 through its range. The page's, or a `container`'s. With a
+ * `target`, the progress is the target's way through, between two `offset`s, on `axis`. Each is set in
+ * the scroll's own event, so a value derived from one paints in the frame that shows the scroll. A
+ * `container` or `target` given as an accessor of a ref reads 0s until the ref is there. 0s on a
+ * server. Motion's `useScroll`.
+ *
+ * @example
+ * let box!: HTMLDivElement
+ * const { scrollYProgress } = createScroll({ container: () => box })
+ * <div ref={box}>…</div>
+ * <w.div style={{ scaleX: scrollYProgress }} />
+ * @see https://wardic.dev/reference/solid/live-values/create-scroll
+ */
+// #234. An accessor `container` or `target` is read in an effect, and a change of either follows the
+// new one. Each value carries one Atom for its life.
+export const createScroll = (options = {}) => {
+    if (isServer)
+        return SERVER_SCROLL;
+    const runtime = useWardicRuntime();
+    const registry = runtime.runSync(AtomRegistry.AtomRegistry);
+    // Its own four Atoms, set from the scroll of the elements there now.
+    const outs = Rec.fromIterableWith(SCROLL_KEYS, (key) => [key, Atom.make(0)]);
+    Arr.forEach(SCROLL_KEYS, (key) => onCleanup(registry.mount(outs[key])));
+    // Its elements are read once the render has settled: a ref given as `() => box` is set during the
+    // render, after this effect's first compute, and isn't a signal, so nothing would read it again.
+    const [settled, setSettled] = createSignal(false);
+    onSettledClientOnly(() => {
+        setSettled(true);
+    });
+    createEffect(() => Bool.match(settled(), {
+        onTrue: () => ({ container: elementOf(options.container), target: elementOf(options.target) }),
+        onFalse: () => NOT_YET,
+    }), ({ container, target }) => {
+        // A ref not there yet: the values hold until it is.
+        if (Bool.or(Option.isNone(container), Option.isNone(target)))
+            return undefined;
+        const scope = OwnerScope.open(runtime);
+        const values = runtime.runSync(LiveValue.scroll({
+            ...UndefinedOr.match(Option.getOrUndefined(container), { onUndefined: () => ({}), onDefined: (element) => ({ container: element }) }),
+            ...UndefinedOr.match(Option.getOrUndefined(target), { onUndefined: () => ({}), onDefined: (element) => ({ target: element }) }),
+            ...UndefinedOr.match(options.offset, { onUndefined: () => ({}), onDefined: (offset) => ({ offset }) }),
+            ...UndefinedOr.match(options.axis, { onUndefined: () => ({}), onDefined: (axis) => ({ axis }) }),
+        }).pipe(Scope.provide(scope)));
+        // Each derived Atom is read at once: it tracks the scroll only once it's been read.
+        const stops = Arr.map(SCROLL_KEYS, (key) => registry.subscribe(values[key], (v) => registry.set(outs[key], v), { immediate: true }));
+        return () => {
+            Arr.forEach(stops, (stop) => stop());
+            OwnerScope.close(runtime, scope, CLOSE_FAILED);
+        };
+    }, CLIENT_ONLY);
+    return Rec.map(outs, (atom) => followAtom(registry, atom));
+};
+//# sourceMappingURL=live-value.js.map

package/dist/solid/unstable/v2/live-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-value.js","sourceRoot":"","sources":["../../../../src/unstable/v2/live-value.ts"],"names":[],"mappings":"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"}

package/dist/solid/unstable/v2/presence-handle.d.ts

@@ -0,0 +1,55 @@
+import { type Accessor } from "solid-js";
+import type { PresenceEvents as ControllerEvents } from "../../presence-controller.ts";
+/** What a presence handle's `next(name)` waits for. */
+export interface PresenceEvents {
+    /** A child left, and its exit started. */
+    readonly exitStart: undefined;
+    /**
+     * Every exiting child has animated out and been removed (Motion's `onExitComplete`): not when the
+     * last one ended because a child came back mid-exit, nor when the presence itself went.
+     */
+    readonly exitComplete: undefined;
+}
+/** A presence handle's event names. */
+export type PresenceEvent = keyof PresenceEvents;
+/** An `<AnimatePresence>`'s exits, heard: see the module. */
+export interface Presence {
+    /** Given to `<AnimatePresence ref>`: called with that presence's own handle, whose exits it hears from then on. */
+    (source: Presence): void;
+    /** Whether a child is exiting: `true` from an exit's start until no exiting child is left. */
+    readonly exiting: Accessor<boolean>;
+    /** A promise of the next `name` after the call. */
+    readonly next: <E extends PresenceEvent>(name: E) => Promise<PresenceEvents[E]>;
+    /** Every `name` from the call on, for `for await`; it ends when the handle's owner is disposed. */
+    readonly each: <E extends PresenceEvent>(name: E) => AsyncIterable<PresenceEvents[E]>;
+    /**
+     * Every `name`, as a memo for an effect: pending until the first, so the effect runs at each
+     * one, on any page. `createEffect(presence.when("exitComplete"), () => trigger.focus())`.
+     */
+    readonly when: <E extends PresenceEvent>(name: E) => Accessor<PresenceEvents[E]>;
+}
+/**
+ * A handle, under the current owner, and the events that drive it: what an `<AnimatePresence>`
+ * tells its controller's exits to, and what a handle given it hears through.
+ */
+export declare const makePresenceHandle: () => {
+    readonly handle: Presence;
+    readonly events: ControllerEvents;
+};
+/**
+ * Hears an `<AnimatePresence>`'s exits, given to its `ref`: `exiting()` is whether a child is
+ * leaving, and `next("exitComplete")` resolves once every leaving child has gone. Solid 2's form of
+ * Motion's `onExitComplete`.
+ *
+ * @example
+ * const presence = createPresence()
+ * <AnimatePresence ref={presence}>…</AnimatePresence>
+ * await presence.next("exitComplete")
+ * @see https://wardic.dev/reference/solid/presence/create-presence
+ */
+export declare const createPresence: () => Presence;
+/** A server's `<AnimatePresence ref>`: handed the server's handle. Internal. */
+export declare const serverPresenceHandle: () => Presence;
+/** Whether `ref` was given. Internal. */
+export declare const hasRef: (ref: ((presence: Presence) => void) | undefined) => ref is (presence: Presence) => void;
+//# sourceMappingURL=presence-handle.d.ts.map

package/dist/solid/unstable/v2/presence-handle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presence-handle.d.ts","sourceRoot":"","sources":["../../../../src/unstable/v2/presence-handle.ts"],"names":[],"mappings":"AA+BA,OAAO,EAAE,KAAK,QAAQ,EAA2B,MAAM,UAAU,CAAA;AACjE,OAAO,KAAK,EAAE,cAAc,IAAI,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAGtF,uDAAuD;AACvD,MAAM,WAAW,cAAc;IAC7B,0CAA0C;IAC1C,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B;;;OAGG;IACH,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAA;CACjC;AAED,uCAAuC;AACvC,MAAM,MAAM,aAAa,GAAG,MAAM,cAAc,CAAA;AAEhD,6DAA6D;AAC7D,MAAM,WAAW,QAAQ;IACvB,mHAAmH;IACnH,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI,CAAA;IACxB,8FAA8F;IAC9F,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;IACnC,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,SAAS,aAAa,EAAE,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAA;IAC/E,mGAAmG;IACnG,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,SAAS,aAAa,EAAE,IAAI,EAAE,CAAC,KAAK,aAAa,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAA;IACrF;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,SAAS,aAAa,EAAE,IAAI,EAAE,CAAC,KAAK,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAA;CACjF;AAYD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,QAAO;IAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAA;CA8CnG,CAAA;AAED;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,cAAc,QAAO,QAGjC,CAAA;AAWD,gFAAgF;AAChF,eAAO,MAAM,oBAAoB,QAAO,QAA2B,CAAA;AAEnE,yCAAyC;AACzC,eAAO,MAAM,MAAM,QAAS,CAAC,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC,GAAG,SAAS,KAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAiC,CAAA"}

package/dist/solid/unstable/v2/presence-handle.js

@@ -0,0 +1,119 @@
+/**
+ * A presence handle on Solid 2 (#257, ADR-0046): an `<AnimatePresence>`'s exits, heard where Solid 1
+ * has Motion's `onExitComplete`. A ward can't hand them over: it's disposed the moment its exit
+ * starts. The presence outlives its child, so the handle is the presence's.
+ *
+ * ```tsx
+ * const presence = createPresence()
+ * <AnimatePresence ref={presence}>…</AnimatePresence>
+ * <button disabled={presence.exiting()} onClick={async () => {
+ *   setOpen(false)
+ *   await presence.next("exitComplete")
+ *   await api.save()
+ * }}>Close and save</button>
+ * ```
+ *
+ * - `exiting()`: whether a child is exiting, a plain reactive boolean.
+ * - `next("exitStart")`: a child left and its exit started. `next("exitComplete")`: every exiting
+ *   child has animated out and been removed. An exit a re-entry interrupts doesn't complete: a
+ *   waiting `next("exitComplete")` waits on for one that does. Both resolve with `undefined`.
+ * - `each(name)`: every one, for `for await` (`waiters.ts`).
+ * - `when(name)`: every one, as a memo for an effect (#355).
+ * - `createPresence()`'s owner disposed: waiting calls reject with an `AbortError`, and an `each` ends.
+ *
+ * `ref` also takes a plain callback, `ref={(p) => (presence = p)}`: it's handed the presence's own
+ * handle. A `createPresence()` handle given to `ref` is called with that same handle, and hears it.
+ *
+ * @module
+ */
+import { constUndefined } from "effect/Function";
+import * as Predicate from "effect/Predicate";
+import { isServer } from "@solidjs/web";
+import { createSignal, onCleanup } from "solid-js";
+import { eachOf, serverWhen, Waiters, whenOf } from "./waiters.js";
+/** A handle's own hearing: what another handle given its source calls. Internal. */
+const HEAR = Symbol("wardic.presence.hear");
+/** The `AbortError`'s message for a `next` the handle's owner cut off. */
+const GONE = "The presence handle was disposed before its next event.";
+/**
+ * A handle, under the current owner, and the events that drive it: what an `<AnimatePresence>`
+ * tells its controller's exits to, and what a handle given it hears through.
+ */
+export const makePresenceHandle = () => {
+    const [exiting, setExiting] = createSignal(false);
+    // The last value written: Solid 2 reads a write from its next flush, so the signal can't say.
+    let written = false;
+    const waiters = new Waiters(GONE);
+    // The handles hearing this one (`createPresence()`'s, given to the presence's `ref`).
+    const hearers = new Set();
+    const events = {
+        exitStart: () => {
+            waiters.tell("exitStart", constUndefined);
+            hearers.forEach((hearer) => hearer.exitStart());
+        },
+        exiting: (on) => {
+            // Only a change is written: a hearer joining syncs to where this one is, in the presence's
+            // body, where nothing exits yet, and a write there is one Solid refuses.
+            if (written !== on) {
+                written = on;
+                setExiting(on);
+            }
+            hearers.forEach((hearer) => hearer.exiting(on));
+        },
+        exitComplete: () => {
+            waiters.tell("exitComplete", constUndefined);
+            hearers.forEach((hearer) => hearer.exitComplete());
+        },
+    };
+    const handle = ((source) => {
+        ;
+        source[HEAR](events);
+    });
+    Object.defineProperties(handle, {
+        exiting: { value: exiting },
+        next: { value: (name) => waiters.wait(name) },
+        each: { value: (name) => eachOf(waiters, name) },
+        when: { value: (name) => whenOf(waiters, name) },
+        [HEAR]: {
+            value: (hearer) => {
+                hearers.add(hearer);
+                // It starts from where this presence is now.
+                hearer.exiting(written);
+            },
+        },
+    });
+    // Its waits end with its owner. Its hearers stay: a presence's teardown, after, still tells them
+    // its exits are off.
+    onCleanup(() => waiters.dispose());
+    return { handle, events };
+};
+/**
+ * Hears an `<AnimatePresence>`'s exits, given to its `ref`: `exiting()` is whether a child is
+ * leaving, and `next("exitComplete")` resolves once every leaving child has gone. Solid 2's form of
+ * Motion's `onExitComplete`.
+ *
+ * @example
+ * const presence = createPresence()
+ * <AnimatePresence ref={presence}>…</AnimatePresence>
+ * await presence.next("exitComplete")
+ * @see https://wardic.dev/reference/solid/presence/create-presence
+ */
+// On a server nothing exits: exiting() is false, next never settles, and each ends at once.
+export const createPresence = () => {
+    if (isServer)
+        return SERVER_PRESENCE;
+    return makePresenceHandle().handle;
+};
+/** A server's handle: nothing exits there. */
+const SERVER_PRESENCE = Object.defineProperties((() => { }), {
+    exiting: { value: () => false },
+    next: { value: () => new Promise(constUndefined) },
+    each: { value: () => ({ [Symbol.asyncIterator]: () => ({ next: () => Promise.resolve({ value: undefined, done: true }) }) }) },
+    when: { value: serverWhen },
+    [HEAR]: { value: () => { } },
+});
+/** A server's `<AnimatePresence ref>`: handed the server's handle. Internal. */
+export const serverPresenceHandle = () => SERVER_PRESENCE;
+/** Whether `ref` was given. Internal. */
+export const hasRef = (ref) => Predicate.isFunction(ref);
+//# sourceMappingURL=presence-handle.js.map

package/dist/solid/unstable/v2/presence-handle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presence-handle.js","sourceRoot":"","sources":["../../../../src/unstable/v2/presence-handle.ts"],"names":[],"mappings":"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"}

package/dist/solid/unstable/v2/presence-hooks.d.ts

@@ -0,0 +1,51 @@
+import { type Accessor } from "solid-js";
+/** What a `usePresence` handle waits for. */
+export interface PresenceLeaveEvents {
+    /** Its child left: the presence's `custom`. */
+    readonly leave: any;
+}
+/** A `usePresence` handle, your own exit: see the module. */
+export interface PresenceExit {
+    /** Given to `ref`: the element whose child it holds. */
+    (element: Element): void;
+    /** Whether its child is present: `false` from its leave on. */
+    readonly isPresent: Accessor<boolean>;
+    /** A promise of its child's leave, with the presence's `custom`: rejected if the child or the presence goes some other way. */
+    readonly next: <E extends keyof PresenceLeaveEvents>(name: E) => Promise<PresenceLeaveEvents[E]>;
+    /** Each leave from the call on, for `for await`. */
+    readonly each: <E extends keyof PresenceLeaveEvents>(name: E) => AsyncIterable<PresenceLeaveEvents[E]>;
+    /** Let its child go: once it's left; before, nothing. */
+    readonly safeToRemove: () => void;
+}
+/** `useIsPresent`'s sensor: read for whether its child is present, given to `ref` for its element. */
+export interface IsPresent {
+    (): boolean;
+    (element: Element): void;
+}
+/**
+ * Holds a child of `<AnimatePresence>` on the page as it leaves, until you call `safeToRemove()`: for
+ * an exit of your own, such as a Web Animation. Give it to `ref` on an element in the child. Its
+ * `next("leave")` resolves as the child leaves; `isPresent()` is `false` from then on. Motion's
+ * `usePresence`.
+ *
+ * @example
+ * const exit = usePresence()
+ * void exit.next("leave").then(() => setTimeout(exit.safeToRemove, 300))
+ * <div ref={exit} />
+ * @see https://wardic.dev/reference/solid/presence/use-presence
+ */
+export declare const usePresence: () => PresenceExit;
+/**
+ * Whether a child of `<AnimatePresence>` is still present: `false` from its leave on, while its exit
+ * plays. Give it to `ref` on an element in the child, and call it to read. Outside a presence, always
+ * `true`. Motion's `useIsPresent`.
+ *
+ * @example
+ * const present = useIsPresent()
+ * <button ref={present} disabled={!present()}>Save</button>
+ * @see https://wardic.dev/reference/solid/presence/use-is-present
+ */
+export declare const useIsPresent: () => IsPresent;
+/** Motion's `usePresenceData`: the nearest presence's `custom`, `undefined` outside one. */
+export declare const usePresenceData: <T = any>() => Accessor<T | undefined>;
+//# sourceMappingURL=presence-hooks.d.ts.map

package/dist/solid/unstable/v2/presence-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presence-hooks.d.ts","sourceRoot":"","sources":["../../../../src/unstable/v2/presence-hooks.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,KAAK,QAAQ,EAAgB,MAAM,UAAU,CAAA;AAItD,6CAA6C;AAC7C,MAAM,WAAW,mBAAmB;IAClC,+CAA+C;IAE/C,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAA;CACpB;AAED,6DAA6D;AAE7D,MAAM,WAAW,YAAY;IAC3B,wDAAwD;IACxD,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;IACxB,+DAA+D;IAC/D,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;IACrC,+HAA+H;IAC/H,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,SAAS,MAAM,mBAAmB,EAAE,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAA;IAChG,oDAAoD;IACpD,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,SAAS,MAAM,mBAAmB,EAAE,IAAI,EAAE,CAAC,KAAK,aAAa,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAA;IACtG,yDAAyD;IACzD,QAAQ,CAAC,YAAY,EAAE,MAAM,IAAI,CAAA;CAClC;AAED,sGAAsG;AACtG,MAAM,WAAW,SAAS;IACxB,IAAI,OAAO,CAAA;IACX,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;CACzB;AAmCD;;;;;;;;;;;GAWG;AAGH,eAAO,MAAM,WAAW,QAAO,YAsB9B,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY,QAAO,SAW/B,CAAA;AAED,4FAA4F;AAE5F,eAAO,MAAM,eAAe,GAAI,CAAC,GAAG,GAAG,OAAM,QAAQ,CAAC,CAAC,GAAG,SAAS,CAGlE,CAAA"}

package/dist/solid/unstable/v2/presence-hooks.js

@@ -0,0 +1,115 @@
+/**
+ * Motion's presence hooks on Solid 2 (#277's PR 5b, ADR-0048), in the shape #257 settled on: async
+ * values, no callbacks. Each is given to `ref`, which ties it to the child that holds its element.
+ *
+ * - `usePresence()` holds the leaving child until `safeToRemove()`; `next("leave")` resolves as it
+ *   leaves, once its node is back in place, with the presence's `custom`. The child's own code is
+ *   disposed by then: what runs after the `await` is plain work that ends by calling `safeToRemove()`.
+ * - `useIsPresent()` is a sensor: `true`, `false` from its child's leave on, for what still runs on
+ *   the retained node.
+ * - `usePresenceData()` is the presence's `custom`.
+ *
+ * @module
+ */
+import { isServer } from "@solidjs/web";
+import { constUndefined } from "effect/Function";
+import * as Predicate from "effect/Predicate";
+import * as UndefinedOr from "effect/UndefinedOr";
+import { createSignal } from "solid-js";
+import { usePresenceContext } from "./presence.jsx";
+import { eachOf, Waiters } from "./waiters.js";
+/** The `AbortError`'s message for a `next("leave")` its child or presence cut off. */
+const GONE = "The child went before it left its presence.";
+/** Whether a call is Solid applying the handle as a ref. */
+const isElement = (value) => Predicate.hasProperty(value, "nodeType");
+/** A registration with the nearest presence, `isPresent` turning `false` at its child's leave. */
+const watchOf = (holds, onLeave, onGone) => {
+    const [present, setPresent] = createSignal(true);
+    let element;
+    UndefinedOr.map(usePresenceContext(), (presence) => UndefinedOr.map(presence.watch, (watch) => watch({
+        element: () => element,
+        holds,
+        leave: (custom, release) => {
+            setPresent(false);
+            onLeave(custom, release);
+        },
+        gone: onGone,
+    })));
+    return {
+        present,
+        attach: (at) => {
+            element = at;
+        },
+    };
+};
+/**
+ * Holds a child of `<AnimatePresence>` on the page as it leaves, until you call `safeToRemove()`: for
+ * an exit of your own, such as a Web Animation. Give it to `ref` on an element in the child. Its
+ * `next("leave")` resolves as the child leaves; `isPresent()` is `false` from then on. Motion's
+ * `usePresence`.
+ *
+ * @example
+ * const exit = usePresence()
+ * void exit.next("leave").then(() => setTimeout(exit.safeToRemove, 300))
+ * <div ref={exit} />
+ * @see https://wardic.dev/reference/solid/presence/use-presence
+ */
+// The child's own code is disposed by the time it leaves: what runs after the await is plain work that
+// ends with safeToRemove(). Outside a presence it's always present, and next("leave") never settles.
+export const usePresence = () => {
+    if (isServer)
+        return SERVER_EXIT;
+    const waiters = new Waiters(GONE);
+    let release = () => { };
+    const { present, attach } = watchOf(true, (custom, done) => {
+        release = done;
+        waiters.tell("leave", () => custom);
+    }, () => waiters.dispose());
+    const hold = ((element) => {
+        attach(element);
+    });
+    Object.defineProperties(hold, {
+        isPresent: { value: present },
+        next: { value: (name) => waiters.wait(name) },
+        each: { value: (name) => eachOf(waiters, name) },
+        safeToRemove: { value: () => release() },
+    });
+    return hold;
+};
+/**
+ * Whether a child of `<AnimatePresence>` is still present: `false` from its leave on, while its exit
+ * plays. Give it to `ref` on an element in the child, and call it to read. Outside a presence, always
+ * `true`. Motion's `useIsPresent`.
+ *
+ * @example
+ * const present = useIsPresent()
+ * <button ref={present} disabled={!present()}>Save</button>
+ * @see https://wardic.dev/reference/solid/presence/use-is-present
+ */
+export const useIsPresent = () => {
+    if (isServer)
+        return (() => true);
+    const { present, attach } = watchOf(false, () => { }, () => { });
+    // eslint-disable-next-line solid/reactivity -- the sensor: a ref Solid calls with its element, and an accessor its caller reads where it tracks
+    return ((element) => {
+        if (isElement(element)) {
+            attach(element);
+            return undefined;
+        }
+        return present();
+    });
+};
+/** Motion's `usePresenceData`: the nearest presence's `custom`, `undefined` outside one. */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export const usePresenceData = () => {
+    const presence = usePresenceContext();
+    return () => UndefinedOr.map(UndefinedOr.map(presence, (p) => p.data), (data) => data());
+};
+/** A server's hold: nothing leaves there. */
+const SERVER_EXIT = Object.defineProperties((() => { }), {
+    isPresent: { value: () => true },
+    next: { value: () => new Promise(constUndefined) },
+    each: { value: () => ({ [Symbol.asyncIterator]: () => ({ next: () => Promise.resolve({ value: undefined, done: true }) }) }) },
+    safeToRemove: { value: () => { } },
+});
+//# sourceMappingURL=presence-hooks.js.map

package/dist/solid/unstable/v2/presence-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presence-hooks.js","sourceRoot":"","sources":["../../../../src/unstable/v2/presence-hooks.ts"],"names":[],"mappings":"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"}