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

package/dist/solid/unstable/v2/lifecycle.js

@@ -0,0 +1,457 @@
+/**
+ * A ward's animation lifecycle on Solid 2 (#257, ADR-0046): its Retargets' starts and landings,
+ * handed over as async values in place of Solid 1's `onAnimationStart` / `onAnimationComplete`.
+ *
+ * - `settled()`: the last landing, `undefined` before the first. It's ready from its first read (#257
+ *   PR 2's Q1, B): a Retarget in flight makes it pending, so `isPending(() => card.settled())` is
+ *   "animating", and a read keeps the last landing meanwhile. Pending at its first read, a read with
+ *   no `<Loading>` above it would defer the root's mount, the ward's own with it, and the landing it
+ *   waits for would never come.
+ * - `next("settled")`: a promise of the next landing after the call. It rejects with a `DOMException`
+ *   named `"AbortError"` once the ward is disposed, as Web Animations' `finished` does on a cancel.
+ * - **A failed animation** (#257 item 4), one a leg's failure keeps from landing: `next("settled")`
+ *   rejects with the failure's error, `each("settled")` throws it, and `settled()` throws it at each
+ *   read, so a read of it in JSX goes to the reader's `<Errored>`. The next Retarget clears it,
+ *   pending, and its landing is read again. It's logged and reported apart (ADR-0030), whoever reads it.
+ *
+ * - `tapped()` (#427, ADR-0056): the last tap, as `settled()` is the last landing: `undefined`
+ *   before the first, pending while a press is held, from a pointer or a key, so
+ *   `isPending(() => card.tapped())` is "pressed". A tap resolves it; a cancel, or a press a drag took
+ *   over, keeps the last tap. Its first read asks for the press, as `next("tap")` does.
+ *
+ * One object a ward, the spine's hooks itself. Nothing Solid is made until `settled` is first read,
+ * and nothing is allocated for a start or a landing until someone asks: until then they're counts
+ * and references.
+ *
+ * @module
+ */
+import * as Bool from "effect/Boolean";
+import * as Predicate from "effect/Predicate";
+import { constUndefined, identity } from "effect/Function";
+import * as UndefinedOr from "effect/UndefinedOr";
+import { createMemo, createSignal, runWithOwner } from "solid-js";
+import { dragInfoOf, pointInfoOf, pointOfSample, pressInfoOf } from "../../gesture-info.js";
+import { definitionOf } from "../../spine.js";
+import { CLIENT_ONLY } from "./solid-reactivity.js";
+import { eachOf, Waiters, whenOf } from "./waiters.js";
+/** A Retarget's failure (#257 item 4), as `settled()`'s memo holds it: `read` throws its error. */
+class Failure {
+    error;
+    constructor(error) {
+        this.error = error;
+    }
+}
+/** The `AbortError`'s message for a `next` the ward's disposal cut off. */
+const GONE = "The ward was disposed before its next event.";
+/** The gesture whose recognizer an event needs: `next("tap")` needs the press one running. */
+const GESTURE_OF = {
+    hoverStart: "hover",
+    hover: "hover",
+    hoverEnd: "hover",
+    pressStart: "press",
+    tap: "press",
+    tapCancel: "press",
+    panSessionStart: "pan",
+    panStart: "pan",
+    pan: "pan",
+    panEnd: "pan",
+    viewportEnter: "inView",
+    viewportLeave: "inView",
+};
+/** Each press phase's event: a press a drag took over has none (Motion tells neither). */
+const PRESS_EVENT = {
+    start: "pressStart",
+    tap: "tap",
+    cancel: "tapCancel",
+    dragged: undefined,
+};
+/** Each drag phase's event: its end; its start, which `drag` hears too, is told on its own. */
+const DRAG_EVENT = {
+    start: "dragStart",
+    move: undefined,
+    end: "dragEnd",
+};
+/** Each pan phase's event past its session's start: as {@link DRAG_EVENT}, `pan` its every move. */
+const PAN_EVENT = {
+    start: "panStart",
+    move: undefined,
+    end: "panEnd",
+};
+/**
+ * A ward's lifecycle, made under its `owner`. It's the spine's {@link AnimationHooks}; the ward
+ * hands over {@link Lifecycle.read} as `settled` and {@link Lifecycle.wait} as `next`, and calls
+ * {@link Lifecycle.dispose} in its own cleanup. A landing's gestures are the layers its Retarget's
+ * resolution was made with.
+ */
+export class Lifecycle {
+    // The Retargets started and the last one landed, counted, and the one in flight.
+    starts = 0;
+    landed = 0;
+    flying = undefined;
+    // The last landing, built when it's asked for: its resolution and the variant before it.
+    landedResolution = undefined;
+    landedPrevious = undefined;
+    last = undefined;
+    // Made at the first read: the setter of the count it tracks, its memo, and its pending read's resolver.
+    setCount = undefined;
+    memo = undefined;
+    waiting = undefined;
+    // The last Retarget's failure, until the next starts (#257 item 4).
+    failure = undefined;
+    // `tapped()` (#427): the presses started and ended, counted; the last tap's press and element, kept
+    // as references until it's asked for, and its info, built then; and, made at the first read, the
+    // setter of the count it tracks, its memo, and its pending read's resolver.
+    pressStarts = 0;
+    pressEnds = 0;
+    tapPress = undefined;
+    tapElement = undefined;
+    lastTap = undefined;
+    setPresses = undefined;
+    tapMemo = undefined;
+    tapWaiting = undefined;
+    // The `next(name)` calls waiting, made at the first; and whether the ward is gone.
+    events = undefined;
+    disposed = false;
+    // The gestures a `next` has asked for, whose recognizers the ward runs from then on.
+    hover = false;
+    press = false;
+    pan = false;
+    inView = false;
+    owner;
+    want;
+    /** `want` starts a gesture's recognizer on the mounted element the first time a `next` needs it. */
+    constructor(owner, want) {
+        this.owner = owner;
+        this.want = want;
+    }
+    /** Whether a `next` has asked for the hover events, so the ward runs its recognizer. */
+    get wantsHover() {
+        return this.hover;
+    }
+    /** Whether a `next` has asked for the press events. */
+    get wantsPress() {
+        return this.press;
+    }
+    /** Whether a `next` has asked for the pan events (#273). */
+    get wantsPan() {
+        return this.pan;
+    }
+    /** Whether a `next` has asked for the viewport events (#273). */
+    get wantsInView() {
+        return this.inView;
+    }
+    started(resolution) {
+        this.starts++;
+        this.flying = resolution;
+        this.failure = undefined;
+        // From a microtask, as at the first read (#315): a Retarget starts in Solid's flush, the mount's
+        // among them, where `render` still watches for a pending read reaching its root. A `<Loading>`
+        // already showing its content doesn't catch one, so a plain `settled()` read under it was
+        // reported as an async read outside any boundary, though the mount wasn't held.
+        if (Predicate.isNotUndefined(this.setCount))
+            queueMicrotask(this.tellStarts);
+    }
+    /** `settled()`'s count set to the starts now: its read pends while one is in flight. */
+    tellStarts = () => {
+        UndefinedOr.map(this.setCount, (set) => set(this.starts));
+    };
+    settled(resolution, previous) {
+        // A landing told after a later Retarget started (a settle waits for the gate's flush) is stale.
+        if (resolution !== this.flying)
+            return;
+        this.landed = this.starts;
+        this.landedResolution = resolution;
+        this.landedPrevious = previous;
+        this.last = undefined;
+        // In the landing's own flush, not a start's microtask after: the count equals the landings, so
+        // `settled()` reads the landing, never pending (SE6, a Retarget with nothing to animate).
+        this.tellStarts();
+        const resolve = this.waiting;
+        if (Bool.and(Predicate.isUndefined(resolve), Predicate.isUndefined(this.events)))
+            return;
+        this.waiting = undefined;
+        if (Predicate.isNotUndefined(resolve))
+            resolve(this.lastLanding());
+        this.tell("settled", this.landing);
+    }
+    /**
+     * The Retarget in flight can't land: a leg failed (#257 item 4). It's no longer in flight;
+     * `settled()` reads as errored until the next starts, and the waits for `settled` are rejected.
+     */
+    failed(resolution, error) {
+        if (resolution !== this.flying)
+            return;
+        this.flying = undefined;
+        this.landed = this.starts;
+        const failure = new Failure(error);
+        this.failure = failure;
+        const resolve = this.waiting;
+        this.waiting = undefined;
+        if (Predicate.isNotUndefined(resolve))
+            resolve(failure);
+        UndefinedOr.map(this.events, (events) => events.fail("settled", error));
+    }
+    /** A hover's start or end on `element` (#257): its start is the first `hover` too (#397). */
+    hovered(edge, element) {
+        if (Predicate.isUndefined(this.events))
+            return;
+        const info = () => ({ ...pointInfoOf(edge.event), element });
+        if (edge.active) {
+            this.tell("hoverStart", info);
+            this.tell("hover", info);
+            return;
+        }
+        this.tell("hoverEnd", info);
+    }
+    /** A move of the pointer over `element` while it's hovered (#397). */
+    hoverMoved(event, element) {
+        if (Predicate.isUndefined(this.events))
+            return;
+        this.tell("hover", () => ({ ...pointInfoOf(event), element }));
+    }
+    /** A press's start or end (#257): a press a drag took over tells nothing. */
+    pressed(press, element) {
+        this.pressNow(press, element);
+        if (Predicate.isUndefined(this.events))
+            return;
+        const name = PRESS_EVENT[press.phase];
+        if (Predicate.isUndefined(name))
+            return;
+        this.tell(name, () => ({ ...pressInfoOf(press, element), element }));
+    }
+    /**
+     * A drag's sample (#257, #273): its start, each move (its start among them) and its end are told;
+     * a direction-locked one's (`locked`) lock first, at its start. An end its controls cancelled
+     * (#431) isn't, as Motion's `cancel` tells no `onDragEnd`.
+     */
+    dragged(sample, locked, element) {
+        if (sample.cancelled === true)
+            return;
+        if (Bool.and(locked, sample.phase === "start"))
+            this.tell("directionLock", () => sample.axis);
+        this.moved(DRAG_EVENT[sample.phase], "drag", sample, element);
+    }
+    /** A pan's sample (#273): its session's start, then as a drag's. */
+    panned(sample, element) {
+        if (Predicate.isUndefined(this.events))
+            return;
+        if (sample.phase === "session") {
+            this.tell("panSessionStart", () => ({ ...pointOfSample(sample), element }));
+            return;
+        }
+        this.moved(PAN_EVENT[sample.phase], "pan", sample, element);
+    }
+    /** The drag's release came to rest on its own (#273). */
+    released() {
+        this.tell("dragTransitionEnd", constUndefined);
+    }
+    /** A layout animation's start (#257): the projection calls it after its first frame is painted. */
+    layoutStarted() {
+        this.tell("layoutStart", constUndefined);
+    }
+    /** A layout animation's landing (#257). */
+    layoutCompleted() {
+        this.tell("layoutComplete", constUndefined);
+    }
+    /** An in-view edge (#273): the element entered or left the view. */
+    viewed(edge) {
+        this.tell(Bool.match(edge.active, { onTrue: () => "viewportEnter", onFalse: () => "viewportLeave" }), constUndefined);
+    }
+    /** A drag's or a pan's sample past a pan's session's start: its start's or end's event (`named`), then `every` at its start and each move. */
+    moved(named, every, sample, element) {
+        if (Predicate.isUndefined(this.events))
+            return;
+        const info = () => ({ ...dragInfoOf(sample), element });
+        if (Predicate.isNotUndefined(named))
+            this.tell(named, info);
+        if (sample.phase !== "end")
+            this.tell(every, info);
+    }
+    /** Resolve the `next(name)` calls waiting, with `value()`, made once there are any. */
+    tell(name, value) {
+        UndefinedOr.map(this.events, (events) => events.tell(name, value));
+    }
+    /**
+     * A press for `tapped()` (#427): its start counted, and pending from there; its end counted, a tap's
+     * kept as references, and the pending read resolved with the last tap. Once `tapped()` has been read,
+     * its memo pends at each press's start, read or not, so a tap's info is built here, at the tap: a
+     * keyboard press's centre is measured at the key. Before, nothing is allocated for a tap.
+     */
+    pressNow(press, element) {
+        if (press.phase === "start") {
+            this.pressStarts++;
+            this.tellPresses();
+            return;
+        }
+        this.pressEnds = this.pressStarts;
+        if (press.phase === "tap") {
+            this.tapPress = press;
+            this.tapElement = element;
+            this.lastTap = undefined;
+        }
+        this.tellPresses();
+        const resolve = this.tapWaiting;
+        if (Predicate.isUndefined(resolve))
+            return;
+        this.tapWaiting = undefined;
+        resolve(this.lastTapNow());
+    }
+    /** `tapped()`'s count set to the presses started: its read pends while one is held. */
+    tellPresses = () => {
+        UndefinedOr.map(this.setPresses, (set) => set(this.pressStarts));
+    };
+    /** The last tap's info, built from its references the first time it's asked for. */
+    lastTapNow() {
+        if (Bool.or(Predicate.isNotUndefined(this.lastTap), Predicate.isUndefined(this.tapPress)))
+            return this.lastTap;
+        const element = this.tapElement;
+        this.lastTap = { ...pressInfoOf(this.tapPress, element), element };
+        return this.lastTap;
+    }
+    /**
+     * `tapped()` (#427): the last tap, made reactive at the first read, which also asks for the press,
+     * as `next("tap")` does, so the ward runs its recognizer.
+     */
+    tapped() {
+        if (Predicate.isUndefined(this.tapMemo)) {
+            this.tapMemo = runWithOwner(this.owner, () => this.makeTapMemo());
+            this.wanted("press");
+        }
+        return this.tapMemo();
+    }
+    // The count of presses it tracks starts at the ended count, so its first read is never pending. A
+    // press held at that read is set from a microtask, as `settled()`'s Retarget in flight is.
+    makeTapMemo() {
+        const [count, set] = createSignal(this.pressEnds);
+        this.setPresses = set;
+        const memo = createMemo(() => {
+            if (count() === this.pressEnds)
+                return this.lastTapNow();
+            return new Promise((resolve) => {
+                this.tapWaiting = resolve;
+            });
+        }, CLIENT_ONLY);
+        if (this.pressStarts !== this.pressEnds)
+            queueMicrotask(this.tellPresses);
+        return memo;
+    }
+    /** The last landing, for {@link tell}. */
+    landing = () => this.lastLanding();
+    /**
+     * `settled()`: the last landing, made reactive at the first read. A failure (#257 item 4) is
+     * thrown here, in the reader, so the reader's `<Errored>` catches it: the memo is the ward's, owned
+     * outside any boundary the reader is in, so it holds the failure as a value rather than erroring.
+     */
+    read() {
+        if (Predicate.isUndefined(this.memo))
+            this.memo = runWithOwner(this.owner, () => this.makeMemo());
+        const value = this.memo();
+        if (value instanceof Failure)
+            throw value.error;
+        return value;
+    }
+    /**
+     * `next(name)`: a promise of the next `name` after the call. A gesture's event starts that
+     * gesture's recognizer, if the ward doesn't run it already.
+     */
+    wait(name) {
+        const waited = this.eventsNow().wait(name);
+        const gesture = GESTURE_OF[name];
+        if (Bool.and(Predicate.isNotUndefined(gesture), Bool.not(this.disposed)))
+            this.wanted(gesture);
+        return waited;
+    }
+    /**
+     * Hear every `name` from the call on (#355, `when`), until the returned stop or the ward's end. A
+     * gesture's event starts that gesture's recognizer, as a {@link wait} does.
+     */
+    listen = (name, listener) => {
+        const stop = this.eventsNow().listen(name, listener);
+        const gesture = GESTURE_OF[name];
+        if (Bool.and(Predicate.isNotUndefined(gesture), Bool.not(this.disposed)))
+            this.wanted(gesture);
+        return stop;
+    };
+    /** `when(name)` (#355): every `name`, as a memo for an effect: see `whenOf`. */
+    when(name) {
+        return whenOf(this, name);
+    }
+    /**
+     * `each(name)`: every `name` from the call on, as an async iterable (#257): each step is a
+     * {@link wait}, so one that comes while the loop's body runs is missed, as a `next` asked later
+     * would miss it. It ends, rather than rejecting, once the ward is disposed.
+     */
+    each(name) {
+        return eachOf(this, name);
+    }
+    /** The waits and listeners, made at the first: gone at once if the ward is. */
+    eventsNow() {
+        if (Predicate.isUndefined(this.events)) {
+            this.events = new Waiters(GONE);
+            if (this.disposed)
+                this.events.dispose();
+        }
+        return this.events;
+    }
+    /** The ward is gone: every `next` waiting is rejected, and any asked later at once. */
+    dispose() {
+        this.disposed = true;
+        UndefinedOr.map(this.events, (events) => events.dispose());
+    }
+    /** A gesture a `next` needs: its recognizer is started the first time. */
+    wanted(gesture) {
+        if (gesture === "hover") {
+            if (this.hover)
+                return;
+            this.hover = true;
+        }
+        if (gesture === "press") {
+            if (this.press)
+                return;
+            this.press = true;
+        }
+        if (gesture === "pan") {
+            if (this.pan)
+                return;
+            this.pan = true;
+        }
+        if (gesture === "inView") {
+            if (this.inView)
+                return;
+            this.inView = true;
+        }
+        this.want(gesture);
+    }
+    lastLanding() {
+        const resolution = this.landedResolution;
+        if (Bool.or(Predicate.isNotUndefined(this.last), Predicate.isUndefined(resolution)))
+            return this.last;
+        const landing = resolution;
+        const active = landing.active;
+        this.last = {
+            definition: definitionOf(landing, this.landedPrevious),
+            target: landing.resolved,
+            gestures: { hover: active.hovered, tap: active.pressed, drag: active.dragged, inView: active.inView, focus: active.focused },
+        };
+        return this.last;
+    }
+    // The count of starts it tracks starts at the landed count, so its first read is never pending. A
+    // Retarget in flight at that read is set from a microtask: a change in flight from there
+    // (`isPending`), which a write in the read's own flush wouldn't be (Solid applies it there).
+    makeMemo() {
+        const [count, set] = createSignal(this.landed);
+        this.setCount = set;
+        const memo = createMemo(() => {
+            // At rest: the last landing, or a failure told before this run (#257 item 4).
+            if (count() === this.landed)
+                return UndefinedOr.match(this.failure, { onUndefined: () => this.lastLanding(), onDefined: identity });
+            return new Promise((resolve) => {
+                this.waiting = resolve;
+            });
+        }, CLIENT_ONLY);
+        if (this.starts !== this.landed)
+            queueMicrotask(this.tellStarts);
+        return memo;
+    }
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/solid/unstable/v2/lifecycle.js.map

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

package/dist/solid/unstable/v2/live-value.d.ts

@@ -0,0 +1,146 @@
+import * as LiveValue from "@wardic/core/LiveValue";
+import type * as ScrollOffset from "@wardic/dom/ScrollOffset";
+import { type Accessor } from "solid-js";
+import { type FollowAccessor, type FollowValueOptions, type LiveSource, type SpringAccessor, type WillChange } from "../../live-style.ts";
+/**
+ * A value mapped from another: through a function, `createTransform(x, (x) => x * 2)`, or through
+ * ranges, `createTransform(x, input, output)`: a source at `input[i]` gives `output[i]`, and one between
+ * two stops blends their outputs, numbers, units and colours alike. `input` is as long as `output`,
+ * ascending or descending; outside it the ends hold, unless `clamp: false`. `ease` eases each stretch,
+ * one for all or one each, and a `mixer`, `(from, to) => (t) => value`, blends outputs of any type. A signal read inside `fn` is tracked too: its change maps again.
+ * Motion's `useTransform`.
+ *
+ * @example
+ * const card = w.ward({ drag: "x" })
+ * const opacity = createTransform(card.read("x"), [-150, 0, 150], [0, 1, 0])
+ * <w.div wardRef={card} style={{ opacity }} />
+ * @see https://wardic.dev/reference/solid/live-values/create-transform
+ */
+export declare function createTransform<A, B>(source: LiveSource<A>, fn: (a: A) => B): Accessor<B>;
+export declare function createTransform<O extends number | string>(source: LiveSource<number>, input: ReadonlyArray<number>, output: ReadonlyArray<O>, options?: LiveValue.TransformOptions<O>): Accessor<O>;
+export declare function createTransform<O>(source: LiveSource<number>, input: ReadonlyArray<number>, output: ReadonlyArray<O>, options: LiveValue.MixedTransformOptions<O>): Accessor<O>;
+/**
+ * A value that follows `source` on a transition, in seconds: from each change of `source`, it animates
+ * there, then rests. No `type` is a spring, 100 / 10 / 1 unless it's set by time; `type: "tween"` is
+ * 0.3 s `easeInOut`; `type: "inertia"` glides. A change mid-way: a spring steers to it, keeping its
+ * speed; a tween starts again from where it is; an inertia glides again from there. `delay` waits at
+ * every change, so a source that never rests moves it once it does. A string with a unit, `"10px"`,
+ * is followed as its number. `jump(value)` puts it somewhere at once. Motion's `useFollowValue`.
+ *
+ * @example
+ * const [x, setX] = createSignal(0)
+ * const eased = createFollowValue(x, { type: "tween", duration: 0.4, ease: "easeOut" })
+ * <w.div style={{ x: eased }} />
+ * @see https://wardic.dev/reference/solid/live-values/create-follow-value
+ */
+export declare function createFollowValue(source: LiveSource<number>, options?: FollowValueOptions): FollowAccessor<number>;
+export declare function createFollowValue(source: LiveSource<string>, options?: FollowValueOptions): FollowAccessor<string>;
+/**
+ * A value that follows `source` on a spring: from each change, it springs there, a change mid-way
+ * keeping its speed. `stiffness`, `damping` and `mass`, 100 / 10 / 1 by default, or a `visualDuration`
+ * and `bounce`. A string with a unit, `"10px"`, is followed as its number. `jump(value)` puts it
+ * somewhere at once, and `skipInitialAnimation` makes the source's first change a jump. On a source that's both derived and
+ * set, Solid 2's `createSignal(fn)`, a write springs there, and the next change of what it derives from
+ * springs on to that.
+ * Motion's `useSpring`.
+ *
+ * @example
+ * const [x, setX] = createSignal(0)
+ * const followX = createSpring(x, { stiffness: 300, damping: 30 })
+ * <w.div style={{ x: followX }} />
+ * @see https://wardic.dev/reference/solid/live-values/create-spring
+ */
+export declare function createSpring(source: LiveSource<number>, options?: LiveValue.SpringOptions): SpringAccessor<number>;
+export declare function createSpring(source: LiveSource<string>, options?: LiveValue.SpringOptions): SpringAccessor<string>;
+/**
+ * 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 declare const createVelocity: (source: LiveSource<number>) => Accessor<number>;
+/**
+ * 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 declare const createTime: () => Accessor<number>;
+/**
+ * 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
+ */
+export declare const createWillChange: () => Accessor<WillChange>;
+/**
+ * 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
+ */
+export declare const createAnimationFrame: (callback: (time: number, delta: number) => void) => void;
+/** An element, or an accessor of one, such as `() => box` for a ref: read once it's there. */
+export type ElementSource = Element | Accessor<Element | undefined>;
+/** `createScroll`'s options, as Motion's `useScroll`'s. */
+export interface ScrollOptions {
+    /** The scrolling element, as an accessor of its ref: `() => box`. The page's scroll when left out. */
+    readonly container?: ElementSource;
+    /** An element whose way through the container the progress reads, between the `offset`s. */
+    readonly target?: ElementSource;
+    /**
+     * Where the progress runs, as Motion's: each stop pairs an edge of the target with an edge of the
+     * container, `["start end", "end start"]`, 0 at the first and 1 at the last. An edge is `start`,
+     * `center` or `end`, a fraction, or a length. With a target, `["start start", "end end"]` by default.
+     */
+    readonly offset?: ScrollOffset.ScrollOffset;
+    /** The axis `target` and `offset` read: `"y"` (the default) or `"x"`. */
+    readonly axis?: "x" | "y";
+}
+/** `createScroll`'s values, Motion's four, each an accessor. */
+export interface ScrollValues {
+    /** How far it's scrolled across, in pixels. */
+    readonly scrollX: Accessor<number>;
+    /** How far it's scrolled down, in pixels. */
+    readonly scrollY: Accessor<number>;
+    /** Its progress across, from 0 to 1: through its range, or, with a `target` or `offset`, through theirs. */
+    readonly scrollXProgress: Accessor<number>;
+    /** Its progress down, from 0 to 1: through its range, or, with a `target` or `offset`, through theirs. */
+    readonly scrollYProgress: Accessor<number>;
+}
+/**
+ * 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
+ */
+export declare const createScroll: (options?: ScrollOptions) => ScrollValues;
+//# sourceMappingURL=live-value.d.ts.map

package/dist/solid/unstable/v2/live-value.d.ts.map

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