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

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

@@ -0,0 +1,264 @@
+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.js";
+/** 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/browser/unstable/v2/live-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-value.js","names":["LiveValue","Arr","Bool","Effect","Option","Predicate","Atom","AtomRegistry","Rec","Scope","UndefinedOr","isServer","createEffect","createMemo","createSignal","onCleanup","untrack","atomOf","followAccessorOf","followOptionsOf","numberOf","readLive","serverFollowOf","serverRegistryOf","unitOf","willChangeOf","withUnit","eachFrameOf","OwnerScope","withServerInterpolators","followAtom","CLIENT_ONLY","CLIENT_ONLY_DEFERRED","onSettledClientOnly","useWardicRuntime","useWardicSkipAnimations","readOnServer","source","mirrorOf","accessor","registry","atom","make","mount","value","set","sourceAtomOf","match","onUndefined","onDefined","CLOSE_FAILED","liveOf","runtime","live","scope","open","close","out","runSync","pipe","provide","createTransform","fnOrInput","output","options","fn","isFunction","onTrue","onFalse","interpolatorOf","isUndefined","derived","get","refresh","input","mapping","interpolate","createFollowValue","skipped","transition","initial","isString","follow","map","createSpring","type","createVelocity","SERVER_ZERO","velocity","createTime","time","createWillChange","SERVER_AUTO","createAnimationFrame","callback","SCROLL_KEYS","NOT_YET","container","none","target","SERVER_SCROLL","scrollX","scrollY","scrollXProgress","scrollYProgress","elementOf","fromUndefinedOr","some","createScroll","outs","fromIterableWith","key","forEach","settled","setSettled","or","isNone","undefined","values","scroll","getOrUndefined","element","offset","axis","stops","subscribe","v","immediate","stop"],"sources":["../../../../src/unstable/v2/live-value.ts"],"sourcesContent":[null],"mappings":"AA0BA,OAAO,KAAKA,SAAS,MAAM,wBAAwB;AAEnD,OAAO,KAAKC,GAAG,MAAM,cAAc;AACnC,OAAO,KAAKC,IAAI,MAAM,gBAAgB;AACtC,OAAO,KAAKC,MAAM,MAAM,eAAe;AACvC,OAAO,KAAKC,MAAM,MAAM,eAAe;AACvC,OAAO,KAAKC,SAAS,MAAM,kBAAkB;AAC7C,SAASC,IAAI,EAAEC,YAAY,QAAQ,mBAAmB;AACtD,OAAO,KAAKC,GAAG,MAAM,eAAe;AACpC,OAAO,KAAKC,KAAK,MAAM,cAAc;AACrC,OAAO,KAAKC,WAAW,MAAM,oBAAoB;AACjD,SAASC,QAAQ,QAAQ,cAAc;AACvC,SAAwBC,YAAY,EAAEC,UAAU,EAAEC,YAAY,EAAEC,SAAS,EAAEC,OAAO,QAAQ,UAAU;AACpG,SACEC,MAAM,EAENC,gBAAgB,EAChBC,eAAe,EAGfC,QAAQ,EACRC,QAAQ,EACRC,cAAc,EACdC,gBAAgB,EAEhBC,MAAM,EAENC,YAAY,EACZC,QAAQ,QACH,qBAAqB;AAE5B,SAASC,WAAW,QAAQ,0BAA0B;AACtD,OAAO,KAAKC,UAAU,MAAM,sBAAsB;AAClD,SAASC,uBAAuB,QAAQ,+BAA+B;AACvE,SAASC,UAAU,QAAQ,aAAa;AACxC,SAASC,WAAW,EAAEC,oBAAoB,EAAEC,mBAAmB,QAAQ,uBAAuB;AAC9F,SAASC,gBAAgB,EAAEC,uBAAuB,QAAQ,eAAgB;AAE1E;AACA,MAAMC,YAAY,GAAOC,MAAqB,IAAQhB,QAAQ,CAACgB,MAAM,EAAEd,gBAAgB,EAAEP,OAAO,CAAM;AAEtG;AACA,MAAMsB,QAAQ,GAAGA,CAAIC,QAAqB,EAAEC,QAAmC,KAAsB;EACnG,MAAMC,IAAI,GAAGnC,IAAI,CAACoC,IAAI,CAAC1B,OAAO,CAACuB,QAAQ,CAAC,CAAC;EACzCxB,SAAS,CAACyB,QAAQ,CAACG,KAAK,CAACF,IAAI,CAAC,CAAC;EAC/B7B,YAAY,CACV2B,QAAQ,EACPK,KAAK,IAAI;IACRJ,QAAQ,CAACK,GAAG,CAACJ,IAAI,EAAEG,KAAK,CAAC;EAC3B,CAAC,EACDZ,oBAAoB,CACrB;EACD,OAAOS,IAAI;AACb,CAAC;AAED;AACA,MAAMK,YAAY,GAAGA,CAAIT,MAAqB,EAAEG,QAAmC,KACjF9B,WAAW,CAACqC,KAAK,CAAC9B,MAAM,CAACoB,MAAM,CAA6B,EAAE;EAC5DW,WAAW,EAAEA,CAAA,KAAMV,QAAQ,CAACD,MAAqB,EAAEG,QAAQ,CAAC;EAC5DS,SAAS,EAAGR,IAAI,IAAKA;CACtB,CAAC;AAEJ;AACA,MAAMS,YAAY,GAAG,sCAAsC;AAE3D;AACA,MAAMC,MAAM,GAAGA,CAAOC,OAAsB,EAAEC,IAA2C,KAAiB;EACxG,MAAMC,KAAK,GAAG1B,UAAU,CAAC2B,IAAI,CAACH,OAAO,CAAC;EACtCrC,SAAS,CAAC,MAAMa,UAAU,CAAC4B,KAAK,CAACJ,OAAO,EAAEE,KAAK,EAAEJ,YAAY,CAAC,CAAC;EAC/D,MAAMO,GAAG,GAAGL,OAAO,CAACM,OAAO,CAAEL,IAAyE,CAACM,IAAI,CAAClD,KAAK,CAACmD,OAAO,CAACN,KAAK,CAAC,CAAC,CAAC;EAClI,OAAOxB,UAAU,CAACsB,OAAO,CAACM,OAAO,CAACnD,YAAY,CAACA,YAAY,CAAC,EAAEkD,GAAG,CAAC;AACpE,CAAC;AAyBD,OAAM,SAAUI,eAAeA,CAC7BxB,MAA2B,EAC3ByB,SAA4D,EAC5DC,MAA+B,EAC/BC,OAA6C;EAE7C,MAAMC,EAAE,GAAG/D,IAAI,CAAC6C,KAAK,CAAC1C,SAAS,CAAC6D,UAAU,CAACJ,SAAS,CAAC,EAAE;IACrDK,MAAM,EAAEA,CAAA,KAAML,SAAoC;IAClDM,OAAO,EAAEA,CAAA,KAAMC,cAAc,CAACP,SAAkC,EAAEC,MAAgC,EAAEC,OAAO;GAC5G,CAAC;EACF,IAAIrD,QAAQ,EAAE,OAAO,MAAMsD,EAAE,CAAC7B,YAAY,CAACC,MAAM,CAAC,CAAC;EACnD,MAAMI,IAAI,GAAGxB,MAAM,CAACoB,MAAM,CAAC;EAC3B;EACA,IAAIhC,SAAS,CAACiE,WAAW,CAAC7B,IAAI,CAAC,EAAE,OAAO5B,UAAU,CAAC,MAAMoD,EAAE,CAAE5B,MAA4B,EAAE,CAAC,EAAEN,WAAW,CAAC;EAC1G;EACA;EACA,MAAMS,QAAQ,GAAGN,gBAAgB,EAAE,CAACwB,OAAO,CAACnD,YAAY,CAACA,YAAY,CAAC;EACtE,MAAMgE,OAAO,GAAGjE,IAAI,CAACoC,IAAI,CAAE8B,GAAG,IAAKxD,OAAO,CAAC,MAAMiD,EAAE,CAACO,GAAG,CAAC/B,IAAI,CAAC,CAAC,CAAC,CAAC;EAChE;EACA;EACA7B,YAAY,CACV,MAAMqD,EAAE,CAACzB,QAAQ,CAACgC,GAAG,CAAC/B,IAAI,CAAC,CAAC,EAC5B,MAAK;IACHD,QAAQ,CAACiC,OAAO,CAACF,OAAO,CAAC;EAC3B,CAAC,EACDvC,oBAAoB,CACrB;EACD,OAAOF,UAAU,CAACU,QAAQ,EAAE+B,OAAO,CAAC;AACtC;AAEA;;;;AAIA,MAAMF,cAAc,GAAGA,CACrBK,KAA4B,EAC5BX,MAAwB,EACxBC,OAAkD,KAC5B;EACtB;EACA;EACA,MAAMW,OAAO,GAAG3E,SAAS,CAAC4E,WAAW,CAACF,KAAK,EAAEX,MAAwC,EAAEC,OAAiD,CAIvI;EACD,IAAIrD,QAAQ,EAAE,OAAOR,MAAM,CAACuD,OAAO,CAAC7B,uBAAuB,CAAC8C,OAAO,CAAC,CAAC;EACrE,OAAOzC,gBAAgB,EAAE,CAACwB,OAAO,CAACiB,OAAO,CAAC;AAC5C,CAAC;AAoBD,OAAM,SAAUE,iBAAiBA,CAACxC,MAAmC,EAAE2B,OAAO,GAAuB,EAAE;EACrG,IAAIrD,QAAQ,EAAE,OAAOW,cAAc,CAAC,MAAMc,YAAY,CAACC,MAAM,CAAC,CAAC;EAC/D,MAAMe,OAAO,GAAGlB,gBAAgB,EAAE;EAClC;EACA,MAAM4C,OAAO,GAAG3C,uBAAuB,EAAE;EACzC,MAAM4C,UAAU,GAAG5D,eAAe,CAAC6C,OAAO,CAAC;EAC3C,MAAMxB,QAAQ,GAAGY,OAAO,CAACM,OAAO,CAACnD,YAAY,CAACA,YAAY,CAAC;EAC3D,MAAMkC,IAAI,GAAGK,YAAY,CAACT,MAAM,EAAEG,QAAQ,CAAC;EAC3C,MAAMwC,OAAO,GAAGxC,QAAQ,CAACgC,GAAG,CAAC/B,IAAI,CAAC;EAClC;EACA,OAAOvB,gBAAgB,CACrBkC,OAAO,EACPlD,IAAI,CAAC6C,KAAK,CAAC1C,SAAS,CAAC4E,QAAQ,CAACD,OAAO,CAAC,EAAE;IACtCZ,OAAO,EAAEA,CAAA,KAAMjB,MAAM,CAACC,OAAO,EAAEpD,SAAS,CAACkF,MAAM,CAACzC,IAAyB,EAAEsC,UAAU,EAAED,OAAO,CAAC,CAAC;IAChG;IACAX,MAAM,EAAEA,CAAA,KACNhB,MAAM,CACJC,OAAO,EACPjD,MAAM,CAACgF,GAAG,CAACnF,SAAS,CAACkF,MAAM,CAAC5E,IAAI,CAAC6E,GAAG,CAAC1C,IAAI,EAAErB,QAAQ,CAAC,EAAE2D,UAAU,EAAED,OAAO,CAAC,EAAEpD,QAAQ,CAACF,MAAM,CAACwD,OAAiB,CAAC,CAAC,CAAC;GAErH,CAAC,CACH;AACH;AAoBA,OAAM,SAAUI,YAAYA,CAAC/C,MAAmC,EAAE2B,OAAO,GAA4B,EAAE;EACrG,OAAOa,iBAAiB,CAACxC,MAA4B,EAAE;IAAE,GAAG2B,OAAO;IAAEqB,IAAI,EAAE;EAAQ,CAAE,CAAC;AACxF;AAEA;;;;;;;;;;AAUA,OAAO,MAAMC,cAAc,GAAIjD,MAA0B,IAAsB;EAC7E,IAAI1B,QAAQ,EAAE,OAAO4E,WAAW;EAChC,MAAMnC,OAAO,GAAGlB,gBAAgB,EAAE;EAClC,OAAOiB,MAAM,CAACC,OAAO,EAAEpD,SAAS,CAACwF,QAAQ,CAAC1C,YAAY,CAACT,MAAM,EAAEe,OAAO,CAACM,OAAO,CAACnD,YAAY,CAACA,YAAY,CAAC,CAAC,CAAC,CAAC;AAC9G,CAAC;AAED;;;;;;;;;AASA,OAAO,MAAMkF,UAAU,GAAGA,CAAA,KAAuB;EAC/C,IAAI9E,QAAQ,EAAE,OAAO4E,WAAW;EAChC,OAAOpC,MAAM,CAACjB,gBAAgB,EAAE,EAAElC,SAAS,CAAC0F,IAAI,EAAE,CAAC;AACrD,CAAC;AAED,MAAMH,WAAW,GAAqBA,CAAA,KAAM,CAAC;AAE7C;;;;;;;;;;;AAWA;AACA,OAAO,MAAMI,gBAAgB,GAAGA,CAAA,KAA2B;EACzD,IAAIhF,QAAQ,EAAE,OAAOiF,WAAW;EAChC,MAAMpD,QAAQ,GAAGN,gBAAgB,EAAE,CAACwB,OAAO,CAACnD,YAAY,CAACA,YAAY,CAAC;EACtE,OAAOkB,YAAY,CAACe,QAAQ,EAAEzB,SAAS,EAAG0B,IAAI,IAAKX,UAAU,CAACU,QAAQ,EAAEC,IAAI,CAAC,CAAC;AAChF,CAAC;AAED,MAAMmD,WAAW,GAAyBA,CAAA,KAAM,MAAM;AAEtD;;;;;;;;;;;;;AAaA;AACA;AACA,OAAO,MAAMC,oBAAoB,GAAIC,QAA+C,IAAU;EAC5F,IAAInF,QAAQ,EAAE;EACd,MAAMyC,OAAO,GAAGlB,gBAAgB,EAAE;EAClC,MAAMoB,KAAK,GAAG1B,UAAU,CAAC2B,IAAI,CAACH,OAAO,CAAC;EACtCrC,SAAS,CAAC,MAAMa,UAAU,CAAC4B,KAAK,CAACJ,OAAO,EAAEE,KAAK,EAAEJ,YAAY,CAAC,CAAC;EAC/DE,OAAO,CAACM,OAAO,CAAC/B,WAAW,CAACyB,OAAO,EAAE0C,QAAQ,CAAC,CAACnC,IAAI,CAAClD,KAAK,CAACmD,OAAO,CAACN,KAAK,CAAC,CAAC,CAAC;AAC5E,CAAC;AAkCD,MAAMyC,WAAW,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,iBAAiB,EAAE,iBAAiB,CAAU;AACzF;AACA,MAAMC,OAAO,GAAG;EAAEC,SAAS,EAAE7F,MAAM,CAAC8F,IAAI,EAAE;EAAEC,MAAM,EAAE/F,MAAM,CAAC8F,IAAI;AAAE,CAAW;AAC5E,MAAME,aAAa,GAAiB;EAAEC,OAAO,EAAEd,WAAW;EAAEe,OAAO,EAAEf,WAAW;EAAEgB,eAAe,EAAEhB,WAAW;EAAEiB,eAAe,EAAEjB;AAAW,CAAE;AAE9I;AACA,MAAMkB,SAAS,GAAIpE,MAAiC,IAClDnC,IAAI,CAAC6C,KAAK,CAAC1C,SAAS,CAAC6D,UAAU,CAAC7B,MAAM,CAAC,EAAE;EACvC8B,MAAM,EAAEA,CAAA,KAAM/D,MAAM,CAACsG,eAAe,CAAErE,MAAwC,EAAE,CAAC;EACjF+B,OAAO,EAAEA,CAAA,KAAMhE,MAAM,CAACuG,IAAI,CAACtE,MAA6B;CACzD,CAAC;AAEJ;;;;;;;;;;;;;;;AAeA;AACA;AACA,OAAO,MAAMuE,YAAY,GAAGA,CAAC5C,OAAO,GAAkB,EAAE,KAAkB;EACxE,IAAIrD,QAAQ,EAAE,OAAOyF,aAAa;EAClC,MAAMhD,OAAO,GAAGlB,gBAAgB,EAAE;EAClC,MAAMM,QAAQ,GAAGY,OAAO,CAACM,OAAO,CAACnD,YAAY,CAACA,YAAY,CAAC;EAC3D;EACA,MAAMsG,IAAI,GAAGrG,GAAG,CAACsG,gBAAgB,CAACf,WAAW,EAAGgB,GAAG,IAAK,CAACA,GAAG,EAAEzG,IAAI,CAACoC,IAAI,CAAC,CAAC,CAAC,CAAU,CAAC;EACrFzC,GAAG,CAAC+G,OAAO,CAACjB,WAAW,EAAGgB,GAAG,IAAKhG,SAAS,CAACyB,QAAQ,CAACG,KAAK,CAACkE,IAAI,CAACE,GAAG,CAAC,CAAC,CAAC,CAAC;EACvE;EACA;EACA,MAAM,CAACE,OAAO,EAAEC,UAAU,CAAC,GAAGpG,YAAY,CAAC,KAAK,CAAC;EACjDmB,mBAAmB,CAAC,MAAK;IACvBiF,UAAU,CAAC,IAAI,CAAC;EAClB,CAAC,CAAC;EACFtG,YAAY,CACV,MACEV,IAAI,CAAC6C,KAAK,CAACkE,OAAO,EAAE,EAAE;IACpB9C,MAAM,EAAEA,CAAA,MAAO;MAAE8B,SAAS,EAAEQ,SAAS,CAACzC,OAAO,CAACiC,SAAS,CAAC;MAAEE,MAAM,EAAEM,SAAS,CAACzC,OAAO,CAACmC,MAAM;IAAC,CAAE,CAAC;IAC9F/B,OAAO,EAAEA,CAAA,KAAM4B;GAChB,CAAC,EACJ,CAAC;IAAEC,SAAS;IAAEE;EAAM,CAAE,KAAI;IACxB;IACA,IAAIjG,IAAI,CAACiH,EAAE,CAAC/G,MAAM,CAACgH,MAAM,CAACnB,SAAS,CAAC,EAAE7F,MAAM,CAACgH,MAAM,CAACjB,MAAM,CAAC,CAAC,EAAE,OAAOkB,SAAS;IAC9E,MAAM/D,KAAK,GAAG1B,UAAU,CAAC2B,IAAI,CAACH,OAAO,CAAC;IACtC,MAAMkE,MAAM,GAAGlE,OAAO,CAACM,OAAO,CAC5B1D,SAAS,CAACuH,MAAM,CAAC;MACf,GAAG7G,WAAW,CAACqC,KAAK,CAAC3C,MAAM,CAACoH,cAAc,CAACvB,SAAS,CAAC,EAAE;QAAEjD,WAAW,EAAEA,CAAA,MAAO,EAAE,CAAC;QAAEC,SAAS,EAAGwE,OAAO,KAAM;UAAExB,SAAS,EAAEwB;QAAO,CAAE;MAAC,CAAE,CAAC;MACrI,GAAG/G,WAAW,CAACqC,KAAK,CAAC3C,MAAM,CAACoH,cAAc,CAACrB,MAAM,CAAC,EAAE;QAAEnD,WAAW,EAAEA,CAAA,MAAO,EAAE,CAAC;QAAEC,SAAS,EAAGwE,OAAO,KAAM;UAAEtB,MAAM,EAAEsB;QAAO,CAAE;MAAC,CAAE,CAAC;MAC/H,GAAG/G,WAAW,CAACqC,KAAK,CAACiB,OAAO,CAAC0D,MAAM,EAAE;QAAE1E,WAAW,EAAEA,CAAA,MAAO,EAAE,CAAC;QAAEC,SAAS,EAAGyE,MAAM,KAAM;UAAEA;QAAM,CAAE;MAAC,CAAE,CAAC;MACtG,GAAGhH,WAAW,CAACqC,KAAK,CAACiB,OAAO,CAAC2D,IAAI,EAAE;QAAE3E,WAAW,EAAEA,CAAA,MAAO,EAAE,CAAC;QAAEC,SAAS,EAAG0E,IAAI,KAAM;UAAEA;QAAI,CAAE;MAAC,CAAE;KAChG,CAAC,CAAChE,IAAI,CAAClD,KAAK,CAACmD,OAAO,CAACN,KAAK,CAAC,CAAC,CAC9B;IACD;IACA,MAAMsE,KAAK,GAAG3H,GAAG,CAACkF,GAAG,CAACY,WAAW,EAAGgB,GAAG,IAAKvE,QAAQ,CAACqF,SAAS,CAACP,MAAM,CAACP,GAAG,CAAC,EAAGe,CAAC,IAAKtF,QAAQ,CAACK,GAAG,CAACgE,IAAI,CAACE,GAAG,CAAC,EAAEe,CAAC,CAAC,EAAE;MAAEC,SAAS,EAAE;IAAI,CAAE,CAAC,CAAC;IACpI,OAAO,MAAK;MACV9H,GAAG,CAAC+G,OAAO,CAACY,KAAK,EAAGI,IAAI,IAAKA,IAAI,EAAE,CAAC;MACpCpG,UAAU,CAAC4B,KAAK,CAACJ,OAAO,EAAEE,KAAK,EAAEJ,YAAY,CAAC;IAChD,CAAC;EACH,CAAC,EACDnB,WAAW,CACZ;EACD,OAAOvB,GAAG,CAAC2E,GAAG,CAAC0B,IAAI,EAAGpE,IAAI,IAAKX,UAAU,CAACU,QAAQ,EAAEC,IAAI,CAAC,CAA4B;AACvF,CAAC","ignoreList":[]}

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

@@ -0,0 +1,146 @@
+/**
+ * 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/browser/unstable/v2/presence-handle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presence-handle.js","names":["constUndefined","Predicate","isServer","createSignal","onCleanup","eachOf","serverWhen","Waiters","whenOf","HEAR","Symbol","GONE","makePresenceHandle","exiting","setExiting","written","waiters","hearers","Set","events","exitStart","tell","forEach","hearer","on","exitComplete","handle","source","Object","defineProperties","value","next","name","wait","each","when","add","dispose","createPresence","SERVER_PRESENCE","Promise","asyncIterator","resolve","undefined","done","serverPresenceHandle","hasRef","ref","isFunction"],"sources":["../../../../src/unstable/v2/presence-handle.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,142 @@
+/**
+ * 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.js";
+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/browser/unstable/v2/presence-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presence-hooks.js","names":["isServer","constUndefined","Predicate","UndefinedOr","createSignal","usePresenceContext","eachOf","Waiters","GONE","isElement","value","hasProperty","watchOf","holds","onLeave","onGone","present","setPresent","element","map","presence","watch","leave","custom","release","gone","attach","at","usePresence","SERVER_EXIT","waiters","done","tell","dispose","hold","Object","defineProperties","isPresent","next","name","wait","each","safeToRemove","useIsPresent","undefined","usePresenceData","p","data","Promise","Symbol","asyncIterator","resolve"],"sources":["../../../../src/unstable/v2/presence-hooks.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}