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

package/dist/solid/bridge.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Reactive bridges (ADR-0006): the two adapters that turn Effect-side reactive
+ * sources into Solid `Accessor`s the JSX layer can read.
+ *
+ * - {@link streamToSignal} bridges a core frame/recognizer `Stream` into a Solid
+ *   signal: a fiber forked on the provider runtime runs `Stream.runForEach`,
+ *   pushing each emission into the signal. The fiber is scoped to the consuming
+ *   component's `onCleanup` (via {@link runScoped}), so unmount interrupts it,
+ *   tears down its Scope, and drops the ref-count on the Shared sources it
+ *   subscribed to — exactly the per-element fiber lifecycle ADR-0006 prescribes.
+ * - {@link fromAtom} bridges an Effect `Atom` (reactive service inputs like
+ *   `Probe.prefersReducedMotion` / `Probe.viewport`) into a Solid signal via the
+ *   provider runtime's `AtomRegistry`: it reads the atom's current value for the
+ *   initial signal, subscribes to push updates, and unsubscribes on `onCleanup`.
+ *
+ * Both MUST be called within a Solid owner (component body / `createRoot`) —
+ * they register `onCleanup` and read the runtime from context.
+ */
+import type * as InputFeed from "@wardic/core/InputFeed";
+import * as Effect from "effect/Effect";
+import type * as Scope from "effect/Scope";
+import * as Stream from "effect/Stream";
+import { type Atom } from "effect/reactivity";
+import { type Accessor } from "solid-js";
+import type { WardicServices } from "./runtime.ts";
+/**
+ * A core `Stream` as an accessor: `initial` until its first value, then its latest, the stream run on
+ * the provider's runtime until the owner is cleaned up. Call it where you'd make a signal.
+ *
+ * @example
+ * const point = streamToSignal(pointerMoves, { x: 0, y: 0 })
+ * @see https://wardic.dev/reference/solid/advanced/bridges
+ */
+export declare const streamToSignal: <A>(stream: Stream.Stream<A, never, WardicServices>, initial: A) => Accessor<A>;
+/**
+ * A gesture watch's values as a Solid `Accessor` (#318, ADR-0055): `initial` until the first, the
+ * watch run with {@link runWatch} (a Scope of its own, closed with the owner; a handler's throw
+ * reported). Must be called within a Solid owner under a `WardicProvider`.
+ */
+export declare const watchToSignal: <A>(watchOf: (handlers: InputFeed.Handlers<A>) => Effect.Effect<void, never, Scope.Scope | WardicServices>, initial: A) => Accessor<A>;
+/**
+ * An Effect `Atom` as an accessor: read through the provider's `AtomRegistry`, and followed until the
+ * owner is cleaned up. For a server render, give `serverValue`: the server renders it, and a hydrating
+ * page keeps it until mount, then follows the atom.
+ *
+ * @example
+ * const visible = fromAtom(probe.pageVisible, { serverValue: true })
+ * @see https://wardic.dev/reference/solid/advanced/bridges
+ */
+export declare const fromAtom: <A>(atom: Atom.Atom<A>, options?: {
+    readonly serverValue?: A;
+}) => Accessor<A>;
+//# sourceMappingURL=bridge.d.ts.map

package/dist/solid/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../src/bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,KAAK,SAAS,MAAM,wBAAwB,CAAA;AACxD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,KAAK,KAAK,KAAK,MAAM,cAAc,CAAA;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,EAAgB,KAAK,IAAI,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,EAAE,KAAK,QAAQ,EAA0C,MAAM,UAAU,CAAA;AAEhF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAGlD;;;;;;;GAOG;AAGH,eAAO,MAAM,cAAc,GAAI,CAAC,UACtB,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,WACtC,CAAC,KACT,QAAQ,CAAC,CAAC,CAQZ,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,WACpB,CAAC,QAAQ,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,GAAG,cAAc,CAAC,WAC7F,CAAC,KACT,QAAQ,CAAC,CAAC,CAIZ,CAAA;AAED;;;;;;;;GAQG;AAGH,eAAO,MAAM,QAAQ,GAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY;IAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,CAAA;CAAE,KAAG,QAAQ,CAAC,CAAC,CAoBlG,CAAA"}

package/dist/solid/bridge.js

@@ -0,0 +1,66 @@
+import * as Effect from "effect/Effect";
+import * as Predicate from "effect/Predicate";
+import * as Stream from "effect/Stream";
+import { AtomRegistry } from "effect/reactivity";
+import { createSignal, from, onCleanup, onMount } from "solid-js";
+import { runScoped, runWatch, useWardicRuntime } from "./provider.jsx";
+import { isHydrating, isServer } from "./server.js";
+/**
+ * A core `Stream` as an accessor: `initial` until its first value, then its latest, the stream run on
+ * the provider's runtime until the owner is cleaned up. Call it where you'd make a signal.
+ *
+ * @example
+ * const point = streamToSignal(pointerMoves, { x: 0, y: 0 })
+ * @see https://wardic.dev/reference/solid/advanced/bridges
+ */
+// `Stream.runForEach` through `runScoped`; `set(() => v)`, so an object or function value is stored as
+// it is. The stream's `R` is the provider runtime's services.
+export const streamToSignal = (stream, initial) => {
+    const [get, set] = createSignal(initial);
+    const runtime = useWardicRuntime();
+    runScoped(runtime, Stream.runForEach(stream, (v) => Effect.sync(() => set(() => v))));
+    return get;
+};
+/**
+ * A gesture watch's values as a Solid `Accessor` (#318, ADR-0055): `initial` until the first, the
+ * watch run with {@link runWatch} (a Scope of its own, closed with the owner; a handler's throw
+ * reported). Must be called within a Solid owner under a `WardicProvider`.
+ */
+export const watchToSignal = (watchOf, initial) => {
+    const [get, set] = createSignal(initial);
+    runWatch(useWardicRuntime(), (onDefect) => watchOf({ on: (value) => set(() => value), onDefect }));
+    return get;
+};
+/**
+ * An Effect `Atom` as an accessor: read through the provider's `AtomRegistry`, and followed until the
+ * owner is cleaned up. For a server render, give `serverValue`: the server renders it, and a hydrating
+ * page keeps it until mount, then follows the atom.
+ *
+ * @example
+ * const visible = fromAtom(probe.pageVisible, { serverValue: true })
+ * @see https://wardic.dev/reference/solid/advanced/bridges
+ */
+// Solid's `from`, seeded with the atom's value; `set(() => v)`, so an object or function value is stored
+// as it is. A server builds no registry (ADR-0021); the Hydration hold is decision 8.
+export const fromAtom = (atom, options) => {
+    const runtime = useWardicRuntime();
+    const held = Predicate.isNotUndefined(options) && "serverValue" in options;
+    if (held && isServer) {
+        const serverValue = options.serverValue;
+        return () => serverValue;
+    }
+    if (held && isHydrating()) {
+        const [value, setValue] = createSignal(options.serverValue);
+        onMount(() => {
+            const registry = runtime.runSync(AtomRegistry.AtomRegistry);
+            setValue(() => registry.get(atom));
+            onCleanup(registry.subscribe(atom, (v) => setValue(() => v)));
+        });
+        return value;
+    }
+    // A `Context.Service` key is itself an `Effect<Shape, never, Identifier>`,
+    // so running it on the provider runtime yields the registry instance.
+    const registry = runtime.runSync(AtomRegistry.AtomRegistry);
+    return from((set) => registry.subscribe(atom, (v) => set(() => v)), registry.get(atom));
+};
+//# sourceMappingURL=bridge.js.map

package/dist/solid/bridge.js.map

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

package/dist/solid/complete.d.ts

@@ -0,0 +1,31 @@
+/**
+ * The **Complete element**'s own code (#511, ADR-0067; #548): what tells the spine it brings every
+ * Feature, and `createWard`, the Complete ward. In a module of its own, apart from the spine every
+ * element shares, so an app whose pages use the Slim element (`w.*`) ships no Feature from here, even
+ * when one of them uses a Complete element (ADR-0067, *Amendment (#548)*).
+ *
+ * @module
+ */
+import type { Accessor } from "solid-js";
+import type { WardConfig, WardicVariantLabels } from "./config.ts";
+import { type SpineInternals, type Ward } from "./create-ward.tsx";
+import type { InferredMotion, TargetKey } from "./ward-keys.ts";
+/**
+ * Makes a ward: Wardic's motion for an element of your own. Spread what it returns on the element,
+ * `{...card()}`, or `{...card({ ref, style })}` to keep your own. `config` is the motion props, or an
+ * accessor of them for a config that changes. `card.value(key)` reads what the element shows. This
+ * one has every Feature; `w.createWard` has its section's.
+ *
+ * @example
+ * const card = createWard({ initial: { opacity: 0 }, animate: { opacity: 1 } })
+ * <article {...card()} />
+ * @see https://wardic.dev/reference/solid/elements/ward
+ */
+export declare function createWard<K extends TargetKey = never, N extends string = never, LI extends WardicVariantLabels = never, LA extends WardicVariantLabels = never, D extends boolean | "x" | "y" = never>(config: InferredMotion<WardConfig, K, N, LI, LA, D> | Accessor<InferredMotion<WardConfig, K, N, LI, LA, D>>): Ward;
+/**
+ * What a **Complete element** tells the spine (#511, ADR-0067): it brings every Feature. Its forms'
+ * (`createWard`, `wardic.*`, `wardic.create`, `use:wardic`) alone: a Slim element's never name it, so
+ * its app ships no Feature it doesn't choose.
+ */
+export declare const COMPLETE: SpineInternals;
+//# sourceMappingURL=complete.d.ts.map

package/dist/solid/complete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"complete.d.ts","sourceRoot":"","sources":["../../src/complete.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAClE,OAAO,EAAkB,KAAK,cAAc,EAAE,KAAK,IAAI,EAAE,MAAM,mBAAmB,CAAA;AAElF,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE/D;;;;;;;;;;GAUG;AAKH,wBAAgB,UAAU,CACxB,CAAC,SAAS,SAAS,GAAG,KAAK,EAC3B,CAAC,SAAS,MAAM,GAAG,KAAK,EACxB,EAAE,SAAS,mBAAmB,GAAG,KAAK,EACtC,EAAE,SAAS,mBAAmB,GAAG,KAAK,EACtC,CAAC,SAAS,OAAO,GAAG,GAAG,GAAG,GAAG,GAAG,KAAK,EACrC,MAAM,EAAE,cAAc,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,GAAG,QAAQ,CAAC,cAAc,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAEnH;AAED;;;;GAIG;AACH,eAAO,MAAM,QAAQ,EAAE,cAAgD,CAAA"}

package/dist/solid/complete.js

@@ -0,0 +1,27 @@
+import { createWardWith } from "./create-ward.jsx";
+import { ALL } from "./features/all.js";
+/**
+ * Makes a ward: Wardic's motion for an element of your own. Spread what it returns on the element,
+ * `{...card()}`, or `{...card({ ref, style })}` to keep your own. `config` is the motion props, or an
+ * accessor of them for a config that changes. `card.value(key)` reads what the element shows. This
+ * one has every Feature; `w.createWard` has its section's.
+ *
+ * @example
+ * const card = createWard({ initial: { opacity: 0 }, animate: { opacity: 1 } })
+ * <article {...card()} />
+ * @see https://wardic.dev/reference/solid/elements/ward
+ */
+// One element's motion binding (ADR-0042), owning computations under the current owner. An accessor
+// config is read reactively (a change Retargets, velocity kept); `initial` once at setup (ADR-0003).
+// Its keys are inferred from its targets (#305, InferredMotion), so `transition` takes entries for
+// them. A Complete element (#511).
+export function createWard(config) {
+    return createWardWith(config, COMPLETE);
+}
+/**
+ * What a **Complete element** tells the spine (#511, ADR-0067): it brings every Feature. Its forms'
+ * (`createWard`, `wardic.*`, `wardic.create`, `use:wardic`) alone: a Slim element's never name it, so
+ * its app ships no Feature it doesn't choose.
+ */
+export const COMPLETE = { brings: ALL, complete: true };
+//# sourceMappingURL=complete.js.map

package/dist/solid/complete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"complete.js","sourceRoot":"","sources":["../../src/complete.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,cAAc,EAAkC,MAAM,mBAAmB,CAAA;AAClF,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAA;AAGvC;;;;;;;;;;GAUG;AACH,oGAAoG;AACpG,qGAAqG;AACrG,mGAAmG;AACnG,mCAAmC;AACnC,MAAM,UAAU,UAAU,CAMxB,MAA2G;IAC3G,OAAO,cAAc,CAAC,MAA2C,EAAE,QAAQ,CAAC,CAAA;AAC9E,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAmB,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA"}