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

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

@@ -0,0 +1,89 @@
+/**
+ * `<AnimatePresence>` on Solid 2 (#209, ADR-0007): exit-before-unmount for its children (many since
+ * #277, ADR-0048), and `mode="wait"`, as the Solid 1 binding's. Its work (each retained node, its parent-driven exit,
+ * the twins it hands back) is Solid-free, in `presence-controller.ts`. What's Solid 2's:
+ *
+ * - **The children are resolved with `children()`** under the presence's context, so each child's
+ *   ward registers its exit record with it.
+ * - **An effect tells the controller which elements are present,** in its apply: after Solid 2's
+ *   flush has applied the change, the leaving nodes removed. The controller puts them back before
+ *   the flush ends, so no paint shows them gone.
+ * - **Once settled** (`onSettledClientOnly`), the first render has ended, for `initial={false}` (#134).
+ *
+ * @module
+ */
+import { type JSX } from "@solidjs/web";
+import { type PresenceMode } from "../../presence-controller.ts";
+import type { PresenceContextValue } from "../../presence-record.ts";
+import { type Presence } from "./presence-handle.ts";
+/**
+ * The nearest `<AnimatePresence>`'s registrar, `null` outside one: Solid 2 takes an `undefined`
+ * default for none and then throws in `useContext`.
+ */
+export declare const PresenceContext: import("solid-js").Context<PresenceContextValue | null>;
+/** The nearest `<AnimatePresence>`'s registrar, `undefined` outside one. */
+export declare const usePresenceContext: () => PresenceContextValue | undefined;
+/** {@link AnimatePresence}'s props. */
+export interface AnimatePresenceProps {
+    readonly children?: JSX.Element;
+    /**
+     * `false`: the child present at this presence's first render starts at its `animate`, with no
+     * enter animation (it and every Wardic element under it, as Motion's); a child that enters later
+     * animates in from its `initial`. Exits are unchanged.
+     */
+    readonly initial?: boolean;
+    /**
+     * Its exits, heard: a `createPresence()` handle, or a callback handed the
+     * presence's own handle. Optional: left out, no handle is made. Read once.
+     */
+    readonly ref?: ((presence: Presence) => void) | undefined;
+    /**
+     * How a child enters while another exits, Motion's `mode`: `"sync"` (the default),
+     * at once, beside the leaver; `"popLayout"`, at once, the leaver popped out of the flow where it was
+     * (`position: absolute`, its size kept), so the children after it take their places, a `layout`
+     * one animating there; `"wait"`, once every leaver has animated out and been removed. A
+     * waiting child is built at once, as Solid builds it, so its own code (its effects included) runs
+     * then, off the page; its Wardic elements start once it's on the page.
+     */
+    readonly mode?: PresenceMode | undefined;
+    /**
+     * What a leaving child's dynamic `exit` resolves with (Motion's `custom`), over the
+     * child's own `custom`: a child that has left can't take new props, so the presence hands it the
+     * latest. Read as each child leaves.
+     */
+    readonly custom?: any;
+    /**
+     * Where `mode="popLayout"` pins a leaver (Motion's): by its inline start (`"left"`,
+     * the default) or end (`"right"`), which a right-to-left layout flips, as Motion's does, and by its
+     * `"top"` (the default) or `"bottom"`. Each edge keeps its distance from its container's while the
+     * leaver exits, so one pinned by the bottom right stays in that corner as the container resizes.
+     * Read as each leaver pops.
+     */
+    readonly anchorX?: "left" | "right" | undefined;
+    readonly anchorY?: "top" | "bottom" | undefined;
+    /**
+     * Whether its children's going and coming moves the `layout` elements around them (Motion's
+     * prop): `true` (the default) tells the projection when a child enters, a leaver pops or a leaver is
+     * removed, so a `layout` sibling animates into or out of the space; `false` tells it nothing, and a
+     * sibling animates only when something else measures it. Read at each change.
+     */
+    readonly presenceAffectsLayout?: boolean | undefined;
+    /**
+     * Motion's `propagate`: inside another presence's child, when that child
+     * leaves, this presence's children all leave too, each running its exit, and that child goes once
+     * they've all gone. Without it (the default), its children go with that child, as they are. Read
+     * once.
+     */
+    readonly propagate?: boolean;
+}
+/**
+ * Wraps its children (a conditional one, `<Show>`, or a `<For>`'s) and animates each one's exit
+ * before it's removed: each that leaves exits in its place, and one that comes back mid-exit
+ * is a new node, entering beside the leaver, or, with the leaver's `key` on its Wardic element,
+ * taking over from where the leaver is.
+ * A leaving child runs its own `exit` if it's a `wardic.*` element or an element with a ward on
+ * it, and the exits of the Wardic elements inside it either way, staying until they've ended; a
+ * plain child with nothing inside it to wait for goes at once. Inside a `<WardicProvider>`.
+ */
+export declare function AnimatePresence(props: AnimatePresenceProps): JSX.Element;
+//# sourceMappingURL=presence.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"presence.d.ts","sourceRoot":"","sources":["../../../../src/unstable/v2/presence.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAY,KAAK,GAAG,EAAE,MAAM,cAAc,CAAA;AAMjD,OAAO,EAAgB,KAAK,YAAY,EAAe,MAAM,8BAA8B,CAAA;AAC3F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AAGpE,OAAO,EAA8B,KAAK,QAAQ,EAAwB,MAAM,sBAAsB,CAAA;AAEtG;;;GAGG;AACH,eAAO,MAAM,eAAe,yDAAmD,CAAA;AAE/E,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,QAAO,oBAAoB,GAAG,SAAqF,CAAA;AAElJ,uCAAuC;AACvC,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,OAAO,CAAA;IAC/B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;IAC1B;;;OAGG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC,GAAG,SAAS,CAAA;IACzD;;;;;;;OAOG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,GAAG,SAAS,CAAA;IACxC;;;;OAIG;IAEH,QAAQ,CAAC,MAAM,CAAC,EAAE,GAAG,CAAA;IACrB;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAA;IAC/C,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,SAAS,CAAA;IAC/C;;;;;OAKG;IACH,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACpD;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAC7B;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,GAAG,CAAC,OAAO,CA2DxE"}

package/dist/solid/unstable/v2/presence.jsx

@@ -0,0 +1,107 @@
+/**
+ * `<AnimatePresence>` on Solid 2 (#209, ADR-0007): exit-before-unmount for its children (many since
+ * #277, ADR-0048), and `mode="wait"`, as the Solid 1 binding's. Its work (each retained node, its parent-driven exit,
+ * the twins it hands back) is Solid-free, in `presence-controller.ts`. What's Solid 2's:
+ *
+ * - **The children are resolved with `children()`** under the presence's context, so each child's
+ *   ward registers its exit record with it.
+ * - **An effect tells the controller which elements are present,** in its apply: after Solid 2's
+ *   flush has applied the change, the leaving nodes removed. The controller puts them back before
+ *   the flush ends, so no paint shows them gone.
+ * - **Once settled** (`onSettledClientOnly`), the first render has ended, for `initial={false}` (#134).
+ *
+ * @module
+ */
+import { isServer } from "@solidjs/web";
+import * as Bool from "effect/Boolean";
+import { constUndefined } from "effect/Function";
+import * as Option from "effect/Option";
+import * as UndefinedOr from "effect/UndefinedOr";
+import { children, createContext, createEffect, createMemo, createSignal, onCleanup, untrack, useContext } from "solid-js";
+import { makePresence, propagateTo } from "../../presence-controller.js";
+import { useBuiltProjection, useWardicDefaultTransition, useWardicPositionalKeys, useWardicReducedMotion, useWardicRenderer, useWardicRuntime } from "./provider.jsx";
+import { CLIENT_ONLY, onSettledClientOnly } from "./solid-reactivity.js";
+import { hasRef, makePresenceHandle, serverPresenceHandle } from "./presence-handle.js";
+/**
+ * The nearest `<AnimatePresence>`'s registrar, `null` outside one: Solid 2 takes an `undefined`
+ * default for none and then throws in `useContext`.
+ */
+export const PresenceContext = createContext(null);
+/** The nearest `<AnimatePresence>`'s registrar, `undefined` outside one. */
+export const usePresenceContext = () => Option.getOrUndefined(Option.fromNullishOr(useContext(PresenceContext)));
+/**
+ * Wraps its children (a conditional one, `<Show>`, or a `<For>`'s) and animates each one's exit
+ * before it's removed: each that leaves exits in its place, and one that comes back mid-exit
+ * is a new node, entering beside the leaver, or, with the leaver's `key` on its Wardic element,
+ * taking over from where the leaver is.
+ * A leaving child runs its own `exit` if it's a `wardic.*` element or an element with a ward on
+ * it, and the exits of the Wardic elements inside it either way, staying until they've ended; a
+ * plain child with nothing inside it to wait for goes at once. Inside a `<WardicProvider>`.
+ */
+export function AnimatePresence(props) {
+    // A server render has no exit to drive: the same boundaries, a context that registers nothing.
+    // eslint-disable-next-line solid/components-return-once -- `isServer` is a constant: the component takes one path for its life
+    if (isServer)
+        return serverPresence(props);
+    // Its own handle, made only when `ref` is given (#257): its exits are told to it, and it's handed to `ref`.
+    const ref = untrack(() => props.ref);
+    const own = Bool.match(hasRef(ref), { onTrue: makePresenceHandle, onFalse: constUndefined });
+    // `mode="wait"`'s held children may go on the page (#277): the children are rendered again.
+    const [released, release] = createSignal(undefined, { equals: false });
+    // The presence above, if any (#277's PR 5c): read before this one provides its own.
+    const parent = usePresenceContext();
+    const presence = makePresence({
+        runtime: useWardicRuntime(),
+        renderer: useWardicRenderer(),
+        projection: useBuiltProjection(),
+        reducedMotion: useWardicReducedMotion(),
+        positionalKeys: useWardicPositionalKeys(),
+        defaultTransition: useWardicDefaultTransition(),
+        initial: () => untrack(() => props.initial),
+        events: UndefinedOr.map(own, (handle) => handle.events),
+        mode: () => props.mode,
+        custom: () => untrack(() => props.custom),
+        anchorX: () => untrack(() => props.anchorX),
+        anchorY: () => untrack(() => props.anchorY),
+        presenceAffectsLayout: () => untrack(() => props.presenceAffectsLayout),
+        release: () => release(undefined),
+    });
+    UndefinedOr.map(own, (handle) => ref(handle.handle));
+    onSettledClientOnly(presence.mounted);
+    // `propagate` (#277's PR 5c): with a presence above, its teardown waits to hear whether this one's
+    // child left. Read before this presence provides its own context.
+    onCleanup(propagateTo(parent, untrack(() => props.propagate) === true, presence));
+    // Resolved under the context, so the child's ward sees it.
+    const Tracker = () => {
+        const resolved = children(() => props.children);
+        // What goes on the page (#277): every child, but under `mode="wait"` one entering is held off it
+        // while a child exits. The controller is told what went on.
+        const shown = createMemo(() => {
+            released();
+            return presence.shown(resolved());
+        }, CLIENT_ONLY);
+        createEffect(shown, (current) => {
+            presence.present(current);
+        }, CLIENT_ONLY);
+        return shown;
+    };
+    // Its `custom`, reactive, for `usePresenceData` (#277's PR 5b).
+    const context = { ...presence.context, data: () => props.custom };
+    return (<PresenceContext value={context}>
+      <Tracker />
+    </PresenceContext>);
+}
+/** {@link AnimatePresence} during a server render: the client's boundaries, nothing to track. */
+const serverPresence = (props) => {
+    // A `ref` is handed the server's handle, on which nothing exits (#257).
+    const ref = untrack(() => props.ref);
+    if (hasRef(ref))
+        ref(serverPresenceHandle());
+    // A server renders once: every child is set up with the first render (#134).
+    const context = { register: () => () => { }, blocksInitial: () => untrack(() => props.initial) === false, data: () => props.custom };
+    const Tracker = () => children(() => props.children);
+    return (<PresenceContext value={context}>
+      <Tracker />
+    </PresenceContext>);
+};
+//# sourceMappingURL=presence.jsx.map

package/dist/solid/unstable/v2/presence.jsx.map

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

package/dist/solid/unstable/v2/press-sensor.d.ts

@@ -0,0 +1,13 @@
+import { type Sensor } from "./sensors.ts";
+/**
+ * `true` while the element it's given to as a `ref` is pressed, by a pointer held down on it or by
+ * Enter or Space while it has focus, `false` once it's released or the press is cancelled. An element
+ * that takes no focus of itself is given `tabindex="0"`, so a keyboard can press it.
+ *
+ * @example
+ * const pressed = createPress()
+ * <button ref={pressed}>{pressed() ? "Holding" : "Press and hold"}</button>
+ * @see https://wardic.dev/reference/solid/gestures/create-press
+ */
+export declare const createPress: () => Sensor<boolean>;
+//# sourceMappingURL=press-sensor.d.ts.map

package/dist/solid/unstable/v2/press-sensor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"press-sensor.d.ts","sourceRoot":"","sources":["../../../../src/unstable/v2/press-sensor.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,KAAK,MAAM,EAAiB,MAAM,cAAc,CAAA;AAKzD;;;;;;;;;GASG;AAEH,eAAO,MAAM,WAAW,QAAO,MAAM,CAAC,OAAO,CAG5C,CAAA"}

package/dist/solid/unstable/v2/press-sensor.js

@@ -0,0 +1,23 @@
+import { press } from "../../features/press.js";
+import { PressGesture } from "../../features/keys.js";
+import { serviceOf } from "../../gesture-features.js";
+import { useBrought } from "./provider.jsx";
+import { watchSensorOf } from "./sensors.js";
+/** What it brings (ADR-0067 decision 12): its gesture's Feature, whatever its section has (#511). */
+const PRESS = [press];
+/**
+ * `true` while the element it's given to as a `ref` is pressed, by a pointer held down on it or by
+ * Enter or Space while it has focus, `false` once it's released or the press is cancelled. An element
+ * that takes no focus of itself is given `tabindex="0"`, so a keyboard can press it.
+ *
+ * @example
+ * const pressed = createPress()
+ * <button ref={pressed}>{pressed() ? "Holding" : "Press and hold"}</button>
+ * @see https://wardic.dev/reference/solid/gestures/create-press
+ */
+// The core press watch; a Keyboard press (#427).
+export const createPress = () => {
+    const services = useBrought(PRESS);
+    return watchSensorOf((target, { on, onDefect }) => serviceOf(services(), PressGesture).watch(target, { on: (press) => on(press.phase === "start"), onDefect }), false);
+};
+//# sourceMappingURL=press-sensor.js.map

package/dist/solid/unstable/v2/press-sensor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"press-sensor.js","sourceRoot":"","sources":["../../../../src/unstable/v2/press-sensor.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAA;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAC3C,OAAO,EAAe,aAAa,EAAE,MAAM,cAAc,CAAA;AAEzD,qGAAqG;AACrG,MAAM,KAAK,GAA2B,CAAC,KAAK,CAAC,CAAA;AAE7C;;;;;;;;;GASG;AACH,iDAAiD;AACjD,MAAM,CAAC,MAAM,WAAW,GAAG,GAAoB,EAAE;IAC/C,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,CAAA;IAClC,OAAO,aAAa,CAAU,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,YAAY,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,CAAC,CAAA;AACjL,CAAC,CAAA"}

package/dist/solid/unstable/v2/provider.d.ts

@@ -0,0 +1,239 @@
+import * as Effect from "effect/Effect";
+import * as Fiber from "effect/Fiber";
+import type * as DefaultTransition from "@wardic/core/DefaultTransition";
+import type * as ReducedMotion from "@wardic/core/ReducedMotion";
+import type * as Renderer from "@wardic/core/Renderer";
+import type * as FlushGate from "@wardic/dom/FlushGate";
+import type * as ProjectionSystem from "@wardic/dom/ProjectionSystem";
+import { type HeadTag, type JSX } from "@solidjs/web";
+import * as Context from "effect/Context";
+import { type Feature, type FeatureRegistry, type FeatureSection, type FeaturesProp } from "../../feature.ts";
+import { type ServerAppear } from "../../appear.ts";
+import { type WardicContextValue, type WardicEnv, type WardicRuntime, type WardicServices } from "../../runtime.ts";
+import { type InstantTransition } from "../../instant.ts";
+import type { WardicScaleCorrector } from "../../config.ts";
+/**
+ * Puts Wardic in your app: every Wardic element sits under one. Give it the Environment, `DomLive` in
+ * a browser, and the Features your elements use.
+ *
+ * @example
+ * <WardicProvider env={DomLive} features={[domAnimation]}>
+ *   <App />
+ * </WardicProvider>
+ * @see https://wardic.dev/reference/solid/provider/wardic-provider
+ */
+export declare function WardicProvider(props: {
+    /** The Environment Wardic runs in: `DomLive` in a browser, from `@wardic/dom`. Read once. */
+    readonly env: WardicEnv;
+    /**
+     * How animations honour the visitor's reduced-motion setting: `"user"` follows it (the default),
+     * `"always"` reduces motion, `"never"` doesn't. Under it, what moves or resizes jumps to where it's
+     * going, and the rest, such as opacity, still animates. A `WardicConfig` sets it for a subtree.
+     */
+    readonly reducedMotion?: ReducedMotion.Config | undefined;
+    /**
+     * On a server-rendered page, entrances play from the first paint, before the JavaScript has loaded
+     * (the default, `true`). `false` makes them wait for the JavaScript; `"explain"` plays them, and
+     * logs on the server why each element that can't play waits.
+     */
+    readonly appear?: boolean | "explain" | undefined;
+    /**
+     * The nonce your page's Content Security Policy gives inline styles: the `<style>` a server render
+     * writes for its entrances carries it, a streamed chunk's too. Motion's `MotionConfig` `nonce`.
+     */
+    readonly nonce?: string | undefined;
+    /**
+     * Your own corrections of a value a layout animation's scale would distort, by the key each corrects:
+     * Motion's `addScaleCorrector`, given here. Read once.
+     */
+    readonly scaleCorrectors?: Readonly<Record<string, WardicScaleCorrector>> | undefined;
+    /**
+     * The Features every `w.*` element under it has: at once (`[domAnimation]`), or loaded with a
+     * function (`() => import("./features").then((m) => m.drag)`). Read once.
+     */
+    readonly features?: FeaturesProp | undefined;
+    /** In development, a `wardic.*` element under it throws, so every element ships only its Features. */
+    readonly strict?: boolean | undefined;
+    readonly children?: JSX.Element;
+}): JSX.Element;
+/**
+ * The section an element is in (#511): the nearest `LazyWardic`'s, else its provider's own; outside a
+ * provider, none. Internal.
+ */
+export declare function useFeatureSection(): FeatureSection;
+/**
+ * Gives the `w.*` elements in its section more Features, beside their provider's: at once
+ * (`features={[drag]}`), or loaded with a function, which runs as the section renders, so a page loads
+ * a Feature only when it needs it. Motion's `LazyMotion`.
+ *
+ * @example
+ * <LazyWardic features={() => import("./drag-feature").then((m) => m.drag)}>
+ *   <w.div drag />
+ * </LazyWardic>
+ * @see https://wardic.dev/reference/solid/provider/lazy-wardic
+ */
+export declare function LazyWardic(props: {
+    /** Its Features: one, a list, or a function that loads them. Read once. */
+    readonly features: FeaturesProp;
+    /** In development, a `wardic.*` element under it throws. Read once. */
+    readonly strict?: boolean | undefined;
+    readonly children?: JSX.Element;
+}): JSX.Element;
+/**
+ * The Features an element has (#511): its section's, and those it brings, a Complete element's every
+ * one (`brings`), built at once. A Complete element under a `strict` section is an error in
+ * development. Internal.
+ */
+export declare function useElementFeatures(brings: ReadonlyArray<Feature> | undefined, complete: boolean): FeatureSection;
+/** The provider's Features (#511). Internal. */
+export declare function useFeatureRegistry(): FeatureRegistry;
+/**
+ * The services of `features`, which a hook or component brings (#511, decision 12) whatever its
+ * section has: built the first time they're read, on the client. `features` is a list the caller keeps,
+ * so its provider joins it once. Internal.
+ */
+export declare function useBrought(features: ReadonlyArray<Feature>): () => Context.Context<never>;
+/**
+ * The head tags for an Appear `<style>` whose CSS `css` gives, in `useHead`'s function form: read
+ * when the server writes the head, and once, so a second read can't find it written already. No
+ * tag when there's none to write. With a `nonce` (#618, P1), the tag carries it. Internal: the
+ * provider's, and a late chunk's (`ward.tsx`).
+ */
+export declare const appearStyle: (css: () => string, nonce: string | undefined) => (() => Array<HeadTag>);
+/** A server render's Appear animations; `undefined` on the client, or with `appear={false}`. Internal. */
+export declare function useWardicAppear(): ServerAppear | undefined;
+/**
+ * The nearest `WardicProvider`'s Effect runtime, for running Effect code on Wardic's services: its
+ * clock, frame loop, renderer, probe and the rest. Throws outside a provider. During a server render
+ * it isn't built: hold it, but run on it only once the element has mounted.
+ *
+ * @example
+ * const runtime = useWardicRuntime()
+ * onSettled(() => {
+ *   runtime.runFork(Effect.log("mounted"))
+ * })
+ * @see https://wardic.dev/reference/solid/advanced/runtime
+ */
+export declare function useWardicRuntime(): WardicRuntime;
+/**
+ * The nearest `WardicProvider`'s flush gate: what a binding registers its elements with, and writes
+ * their values into, committed once a frame. For building an element of your own on Wardic's
+ * rendering. Throws outside a provider; during a server render it's an inert gate that does nothing.
+ *
+ * @see https://wardic.dev/reference/solid/advanced/flush-gate
+ */
+export declare function useWardicGate(): FlushGate.Shape;
+/** The Environment's Renderer (ADR-0003), read once by the provider: what an element and a presence project and commit through. Internal. */
+export declare function useWardicRenderer(): Renderer.Renderer["Service"];
+/** The Environment's Positional keys (ADR-0036): which keys reduced motion Snaps. Internal. */
+export declare function useWardicPositionalKeys(): ReducedMotion.PositionalKeys["Service"];
+/** The Environment's Default transition (ADR-0051): what a key with no transition of its own runs on. Internal. */
+export declare function useWardicDefaultTransition(): DefaultTransition.DefaultTransition["Service"];
+/**
+ * Whether reduced motion applies now (ADR-0029): the nearest `WardicConfig`'s `reducedMotion` (#434),
+ * else the provider's, and the user's preference; always `false` during a server render. Internal.
+ */
+export declare function useWardicReducedMotion(): () => boolean;
+/**
+ * Whether the elements here skip their animations now (#468): the nearest `WardicConfig`'s
+ * `skipAnimations`, or the provider's Instant change while one runs (#443). Read when each starts.
+ * Internal.
+ */
+export declare function useWardicSkipAnimations(): () => boolean;
+/**
+ * Makes a layout change land at once: `start(fn)` runs `fn`, and every layout element goes straight
+ * to its new box, a running layout animation ending there too. The change's other animations run as
+ * ever. `start()` with no function does the same for a change made later in the task. Motion's
+ * `useInstantLayoutTransition`. On a server it runs `fn`.
+ *
+ * @example
+ * const start = createInstantLayoutTransition()
+ * start(() => setOrder(sorted()))
+ * @see https://wardic.dev/reference/solid/layout/create-instant-layout-transition
+ */
+export declare function createInstantLayoutTransition(): (fn?: () => void) => void;
+/**
+ * Makes a change land at once, with no animation: `start(fn)` runs `fn`, and its layout change and
+ * every animation that starts until two frames after the call land where they're going. A later call
+ * extends it, and `start.end()` ends it now. For a change that shouldn't animate: a reset, a jump to
+ * a route. Motion's `useInstantTransition`.
+ *
+ * @example
+ * const start = createInstantTransition()
+ * <button onClick={() => start(() => setOpen(all))}>Open all</button>
+ * @see https://wardic.dev/reference/solid/layout/create-instant-transition
+ */
+export declare function createInstantTransition(): InstantTransition;
+/**
+ * Starts layout animations afresh: `reset()` ends every running layout animation where the layout puts
+ * its element, lets go of every leaving `layoutId` element, and has the next measure take every box as
+ * it is, animating none. For a change that replaces the page wholesale. Motion's `useResetProjection`.
+ * On a server it does nothing.
+ *
+ * @example
+ * const reset = createResetProjection()
+ * const openWorkspace = (id: string) => {
+ *   reset()
+ *   setWorkspace(id)
+ * }
+ * @see https://wardic.dev/reference/solid/layout/create-reset-projection
+ */
+export declare function createResetProjection(): () => void;
+/**
+ * The reduced-motion setting that applies here (#443): the nearest `WardicConfig`'s `reducedMotion`,
+ * else the provider's, else `"user"`, each tracked (#584). Internal.
+ */
+export declare function useWardicReducedMotionSetting(): () => ReducedMotion.Config;
+/**
+ * `read` of the nearest provider's context value, named `name` in the error outside one: for a hook in
+ * a module of its own (#548), such as `useWardicProjection`, which brings `layout`.
+ */
+export declare const fromWardicContext: <A>(name: string, read: (value: WardicContextValue) => A) => A;
+/**
+ * The provider's projection system once its `layout` Feature is built (#511), read as it's needed;
+ * `undefined` until then, and during a server render. For what brings no `layout` and works with the
+ * layout elements that are there: an element registering its values, a presence. Internal.
+ */
+export declare function useBuiltProjection(): () => ProjectionSystem.Shape | undefined;
+/**
+ * `useAnimateLayout()`'s function: `animateLayout(fn)` runs `fn` at once, a throw from it thrown here,
+ * and animates the layout change it makes. Its promise resolves with what `fn` returns once every
+ * layout animation the change started has ended, however each ended; calls in one task resolve
+ * together. It rejects with an `AbortError` if the provider goes first. On a server, `fn` just runs.
+ */
+export type AnimateLayout = <A>(fn: () => A) => Promise<Awaited<A>>;
+/**
+ * Animates a layout change you make: `animateLayout(fn)` runs `fn`, and every layout element animates
+ * from where it was at the call to where the change puts it. For a change nothing else sees, such as a
+ * keyed `<For>` reordered or a plain element's class changed. A write Solid holds, inside an `action`
+ * or beside a write that starts async work, animates once it lands. Its promise resolves with what
+ * `fn` returns once the animations it started have ended. Only what `fn` changes synchronously
+ * animates. Throws outside a `WardicProvider`.
+ *
+ * @example
+ * const animateLayout = useAnimateLayout()
+ * const shuffle = () => animateLayout(() => setItems(shuffled(items())))
+ * @see https://wardic.dev/reference/solid/layout/use-animate-layout
+ */
+export declare function useAnimateLayout(): AnimateLayout;
+/**
+ * Runs `effect` on `runtime`, and interrupts it as the current owner is cleaned up, its Scope closed
+ * with it. Returns its fiber. A failure is logged and reported to the Environment's error reporters;
+ * an interruption is neither. On a server it starts nothing, and while hydrating it starts once its owner has settled.
+ * Call it within a Solid owner.
+ *
+ * @example
+ * runScoped(runtime, Stream.runForEach(ticks, (t) => Effect.sync(() => setTick(t))))
+ * @see https://wardic.dev/reference/solid/advanced/runtime
+ */
+export declare function runScoped<A, E>(runtime: WardicRuntime, effect: Effect.Effect<A, E, WardicServices>): Fiber.Fiber<A, E>;
+/**
+ * Runs the Effect `effectThunk` makes on the provider's runtime, as `runScoped` does, until the
+ * current owner is cleaned up. The thunk is called once; not on a server. Returns its fiber.
+ *
+ * @example
+ * useWardicFiber(() => Stream.runForEach(ticks, (t) => Effect.sync(() => setTick(t))))
+ * @see https://wardic.dev/reference/solid/advanced/runtime
+ */
+export declare function useWardicFiber<A, E>(effectThunk: () => Effect.Effect<A, E, WardicServices>): Fiber.Fiber<A, E>;
+//# sourceMappingURL=provider.d.ts.map

package/dist/solid/unstable/v2/provider.d.ts.map

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