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

package/dist/solid/element.jsx

@@ -0,0 +1,326 @@
+/**
+ * What every Wardic element's component form shares, for the Solid 1 binding (#511): `createWith`,
+ * which makes `wardic.create`'s component and `w.create`'s, a Complete element's or a Slim one's by the
+ * `kind` it's given, and the forms' proxy. `wardic.tsx` holds the Complete forms, `w.tsx` the Slim ones;
+ * this module names no Feature, so a Slim element's app ships none it doesn't choose (ADR-0067).
+ *
+ * `create(tag)` returns a Solid component that accepts the element's own props PLUS Wardic's motion
+ * props (`initial` / `animate` / `whileHover` / ...), wires them through {@link createWardWith}, and
+ * renders the underlying element with the user's props passed through. The flush gate commits each
+ * frame onto the element (ADR-0034). `create(Component)` is the same over the component, which
+ * forwards its `ref` to its root element (#253).
+ *
+ * Locked merge policy (Option A) — the merge now lives in `ward()`
+ * ({@link createWardWith}); this HOC just forwards the user's `ref` + `style` into it:
+ *   - Motion props are split off so none leak to the DOM (even ones not yet
+ *     wired by {@link createWardWith}).
+ *   - The user's `ref` AND Wardic's ref are both invoked (via `mergeRefs`).
+ *   - Wardic's keys win: the Starting style goes over the user's `style` until the first
+ *     commit; from then on the user's `style` is the fallback, without the keys the
+ *     gate holds, which Wardic writes onto the element (ADR-0034). A reactive user
+ *     `style` re-runs the spread's `style`; a frame never does.
+ *
+ * SSR-correct: {@link createWardWith} computes the Starting style synchronously, so the
+ * `<Dynamic>` renders with the merged Starting style on the very first render.
+ *
+ * REACTIVITY (component props): each motion prop is a plain VALUE, not an
+ * accessor. Solid's reactive prop getters already make a component prop tracked —
+ * reading `motion.animate` INSIDE {@link motionToConfig}'s config accessor
+ * subscribes to whatever signals back the prop. So write a TRACKED EXPRESSION as
+ * the value (`animate={open() ? { opacity: 1 } : { opacity: 0 }}`), NOT a function
+ * (`animate={() => expr}` is a type error — props are values, not accessors). A
+ * signal flip in that expression re-runs the config accessor and drives a Retarget.
+ */
+import { mergeRefs } from "@solid-primitives/refs";
+import * as Arr from "effect/Array";
+import * as Bool from "effect/Boolean";
+import * as Option from "effect/Option";
+import * as Predicate from "effect/Predicate";
+import * as Rec from "effect/Record";
+import * as UndefinedOr from "effect/UndefinedOr";
+import { $PROXY, children, createComponent, createEffect, createRenderEffect, sharedConfig, splitProps, untrack } from "solid-js";
+import { assign, Dynamic, getNextElement, insert, spread, SVGElements, use } from "solid-js/web";
+import { isServer } from "./server.js";
+import { GESTURE_KEYS } from "./gesture-callbacks.js";
+import { renderServerElement, serverAppearOfWard, createWardWith } from "./create-ward.jsx";
+import { changesContext } from "./variant-tree.js";
+import { MOTION_PROPS, motionToConfig } from "./motion-props.js";
+import { droppedKeysOf, markWardic, routingTagOf } from "./wardic-component.js";
+import { useWardicConfig } from "./wardic-config.jsx";
+import { isValidPropOf } from "./wardic-config-value.js";
+export { MOTION_PROPS, motionToConfig } from "./motion-props.js";
+/**
+ * A client element's config from its split-off motion props: their keys are fixed unless they're a
+ * proxy (over a reactive spread), so the gesture callbacks the element wasn't given are never read
+ * (#273).
+ */
+export const configOfMotion = (motion) => motionToConfig(motion, Bool.not($PROXY in motion));
+/**
+ * `create(tag | Component)` of a form (`wardic.create`, `w.create`): a Wardic component, a Complete
+ * element's or a Slim one's as `kind` says (#511).
+ *
+ * Both are an element with a Ward on it, made by {@link createWardWith} (#253, as the Solid 2
+ * binding's `create` is, ADR-0045): the Starting style in `style` until the gate's first frame
+ * is committed (so on a server and in the hydration render), then the user's style (over the drag
+ * defaults) without the keys the gate holds (ADR-0034).
+ *   - `create("div")` (element-string): renders `<Dynamic component={tag}>`.
+ *   - `create(Component)` (a component function): the wrapped component must forward `props.ref`
+ *     to its single root element, where the gate commits each frame; that is the only
+ *     requirement. It also gets `style` and `draggable`: one that applies `props.style` renders
+ *     its Starting style on a server, and one that doesn't still animates, the drag defaults
+ *     set on its element at mount (ADR-0021, decision 6). One that never forwards its ref is a
+ *     clear error once mounted (ADR-0008).
+ *
+ * `options` (#443, Motion's `motion.create` options): `forwardMotionProps` hands the motion props on
+ * to what it renders as well, and `type` says what its element is for its server render and Starting
+ * style ({@link WardicCreateOptions}).
+ */
+export function createWith(arg, options, kind) {
+    const forward = options.forwardMotionProps === true;
+    const made = Bool.match(Predicate.isString(arg), {
+        onTrue: () => wardComponent(arg, { ...kind, tag: routingTagOf(arg, options.type) }, forward),
+        onFalse: () => wardComponent(arg, { ...WRAPPED, ...kind, tag: routingTagOf(undefined, options.type) }, forward),
+    });
+    // Marked with what it wraps (#443): `isWardicComponent`, `unwrapWardicComponent`.
+    return markWardic(made, arg);
+}
+/** A form's `create`, its elements of `kind`. */
+export const createOf = (kind) => ((arg, options = {}) => createWith(arg, options, kind));
+/**
+ * A form's proxy (`wardic`, `w`): called, it's the form's directive; `create` and the form's
+ * `extras` are its properties, and `<form>.<tag>` is `create(tag)`, cached so `wardic.div ===
+ * wardic.div` (stable component identity across reads). Any non-string key is `undefined`.
+ */
+export const formOf = (directive, create, extras) => {
+    const cache = new Map();
+    return new Proxy(directive, {
+        get(_, prop) {
+            if (prop === "create")
+                return create;
+            if (Predicate.isString(prop)) {
+                if (Object.hasOwn(extras, prop))
+                    return extras[prop];
+                return Option.getOrElse(Option.fromUndefinedOr(cache.get(prop)), () => {
+                    const c = create(prop);
+                    cache.set(prop, c);
+                    return c;
+                });
+            }
+            return undefined;
+        },
+    });
+};
+/** What wraps a component tells {@link createWardWith}: its component may not pass `style` on. */
+const WRAPPED = { defaultsOnElement: true };
+/** The namespace an svg tag's element is made in, as Solid's `createDynamic` makes it. */
+const SVG_NAMESPACE = "http://www.w3.org/2000/svg";
+/**
+ * What `<Dynamic component={component}>` renders, for a form's tag or component, which never changes
+ * (#525). Still a component boundary, as `Dynamic` is, so the hydration keys land where the server's
+ * `Dynamic` puts them. Without `Dynamic`'s `splitProps`, which copied every prop to take `component`
+ * out, and without `createDynamic`'s two memos over a component that can't change.
+ */
+const fixedElement = (component) => {
+    if (Predicate.isFunction(component))
+        return (props) => untrack(() => component(props));
+    const tag = component;
+    const isSvg = SVGElements.has(tag);
+    return (props) => {
+        const el = tagElementOf(tag, isSvg, props);
+        spreadOnto(el, props, isSvg);
+        return el;
+    };
+};
+/** `tag`'s element: the server's while hydrating, else a new one, as `createDynamic` makes it. */
+const tagElementOf = (tag, isSvg, props) => {
+    if (Predicate.isNotNullish(sharedConfig.context))
+        return getNextElement();
+    if (isSvg)
+        return document.createElementNS(SVG_NAMESPACE, tag);
+    const is = untrack(() => props.is);
+    if (Predicate.isString(is))
+        return document.createElement(tag, { is });
+    return document.createElement(tag);
+};
+/**
+ * Solid's `spread` for props whose keys are fixed (#525): their children's effect only when they have
+ * children, and their ref called once, as JSX calls its own `ref`, where `spread` gives each a render
+ * effect an element. A proxy's keys can change (a reactive spread), so it takes Solid's `spread`.
+ */
+const spreadOnto = (el, props, isSvg) => {
+    if ($PROXY in props) {
+        spread(el, props, isSvg);
+        return;
+    }
+    if ("children" in props)
+        insert(el, () => props.children);
+    untrack(() => {
+        const ref = props.ref;
+        if (Predicate.isFunction(ref))
+            use(ref, el);
+    });
+    const prev = {};
+    createRenderEffect(() => assign(el, props, isSvg, true, prev, true));
+};
+/**
+ * `<form>.<tag>` and `<form>.create(Component)`: the element, or the wrapped component, with a
+ * Ward from {@link createWardWith} spread on it, its variant context's Provider around it when it
+ * changes what its children read (#50). `forward`: its motion props are handed on too (#443).
+ */
+const wardComponent = (component, internal, forward) => {
+    const Rendered = fixedElement(component);
+    // What an element that can never want a gesture runs with (#525): made once a form.
+    const gestureless = { ...internal, gestureless: true };
+    return (props) => {
+        // The nearest `WardicConfig`'s `isValidProp`, as the element is made (#443).
+        const isValidProp = isValidPropOf(useWardicConfig());
+        // A server render takes the lean path (ADR-0021, decision 4).
+        if (isServer)
+            return serverElement(component, internal, props, forward, isValidProp);
+        // 3-way split: motion props (consumed, and only handed on when forwarded, #443), then ref+style
+        // (merged), then everything else (rest) passes through to the element or component, but a tag's
+        // props a `WardicConfig`'s `isValidProp` keeps off it.
+        const [motion, refStyle, own] = splitProps(props, MOTION_PROPS, ["ref", "style"]);
+        const dropped = droppedKeysOf(() => Object.keys(own), isValidProp, Predicate.isString(component));
+        // Split again only when it keeps any off (most elements have no `isValidProp` above them).
+        const rest = Bool.match(Arr.isReadonlyArrayEmpty(dropped), {
+            onTrue: () => own,
+            onFalse: () => splitProps(own, dropped)[1],
+        });
+        const handedOn = Bool.match(forward, { onTrue: () => motion, onFalse: () => NO_PROPS });
+        // Reactive config accessor: motionToConfig reads each (reactive) prop getter
+        // inside the accessor, so a changed `animate` / `whileHover` / `transition`
+        // (a tracked expression) drives a Retarget. The tag lets an svg-inner element
+        // render its Starting style's attribute keys as attributes (ADR-0021).
+        const cfg = configOfMotion(motion);
+        // Its keys fixed (no reactive spread) and none of them a gesture's, it can never want one (#525).
+        let spineInternal = internal;
+        if (Bool.not($PROXY in motion)) {
+            if (Bool.not(Arr.some(GESTURE_KEYS, (key) => key in motion)))
+                spineInternal = gestureless;
+        }
+        const ward = createWardWith(cfg, spineInternal);
+        // Delegate the ref + style merge entirely to ward(): it invokes both the
+        // user's ref and ward's internal ref, and gives the element its `style`: the
+        // Starting style over the user's, then the user's without the keys the gate
+        // holds (ADR-0034).
+        //
+        // `style` is threaded as a LIVE GETTER, not a value read once at setup:
+        // `refStyle.style` is a reactive `splitProps` getter, so a reactive user
+        // `style` prop (e.g. `style={{ left: pos() }}` on a non-animated key) is
+        // tracked by ward()'s reactive style getter and re-merged on change. Reading
+        // it into a `const` here would freeze it at its initial value. `ref` is wired
+        // once at mount (refs don't change), so it stays a one-time read.
+        const forwarding = forwardingOf(component, refStyle.ref);
+        const ref = forwarding.ref;
+        const userProps = {
+            ...UndefinedOr.match(ref, { onUndefined: () => ({}), onDefined: (defined) => ({ ref: defined }) }),
+            get style() {
+                return refStyle.style;
+            },
+        };
+        // An element that changes what its children read renders its variant context's Provider
+        // around them (#50); any other renders none (`changesContext`, decided once, as on a server).
+        // The Ward's props, made once: a call spread in JSX compiles to a function source, which made
+        // `mergeProps` a proxy that the spread read every key through (#525). Their `style` is a getter.
+        const wardProps = ward(userProps);
+        const element = () => <Rendered {...handedOn} {...rest} {...wardProps}/>;
+        return Bool.match(changesContext(untrack(cfg)), {
+            onFalse: () => forwarding.render(element),
+            onTrue: () => <ward.Provider>{forwarding.render(element)}</ward.Provider>,
+        });
+    };
+};
+/** A tag's: the user's ref, and its element as it is. */
+const ownElement = (element) => element();
+/**
+ * The user's ref, and, for a wrapped component, the check that it forwards the Ward's (ADR-0008,
+ * narrowed by #414): one that renders an element and forwards its ref to none of what it renders
+ * leaves the gate no element to commit to, a clear error. One that renders nothing yet (a component
+ * library's part that shows only while open or selected) is waited on: its element is driven when it
+ * comes. Checked each time what it renders changes, inside the wrap's Provider (#50).
+ */
+const forwardingOf = (component, userRef) => {
+    if (Predicate.isString(component))
+        return { ref: userRef, render: ownElement };
+    let reached;
+    const ref = mergeRefs(userRef, (el) => {
+        reached = el;
+    });
+    const render = (element) => {
+        const rendered = children(element);
+        createEffect(() => {
+            const elements = Arr.filter(rendered.toArray(), isElement);
+            if (Arr.isArrayEmpty(elements))
+                return;
+            if (Arr.some(elements, (inside) => Predicate.isNotUndefined(reached) && inside.contains(reached)))
+                return;
+            const name = component.name || "anonymous component";
+            throw new Error(`wardic.create(${name}): the wrapped component rendered an element but did not forward its ref to it. ` +
+                "The component must forward props.ref to a single root DOM element " +
+                "(e.g. <div ref={props.ref}>...</div>). Element-only motion is wired through the ref.");
+        });
+        return rendered;
+    };
+    return { ref, render };
+};
+/** Whether a rendered node is an element. */
+const isElement = (node) => node instanceof Element;
+/** No props: what an element that doesn't forward its motion props hands on of them. */
+const NO_PROPS = {};
+/** The motion props, as a set for the server path's one pass. */
+const MOTION_KEYS = new Set(MOTION_PROPS);
+/**
+ * Set each of `values` on `out` as a plain data property. A key copied from the user's props
+ * may be a getter (a reactive prop like `cx={cx()}`), which an assignment can't overwrite;
+ * Wardic's value wins, as `mergeProps` makes it on the client.
+ */
+const override = (out, values) => Arr.forEach(Rec.keys(values), (key) => {
+    Object.defineProperty(out, key, { value: values[key], enumerable: true, configurable: true, writable: true });
+});
+/**
+ * Everything in `props` but `ref`, `style`, the motion props unless `forward`, and the keys `dropped`
+ * (#443), in one pass; getters stay getters.
+ */
+const passThrough = (props, forward, dropped) => {
+    const descriptors = Object.getOwnPropertyDescriptors(props);
+    const out = {};
+    const off = new Set(dropped);
+    Arr.forEach(Rec.keys(descriptors), (key) => {
+        if (key === "ref" || key === "style" || off.has(key))
+            return;
+        if (MOTION_KEYS.has(key) && !forward)
+            return;
+        Object.defineProperty(out, key, UndefinedOr.getOrThrow(descriptors[key]));
+    });
+    return out;
+};
+/**
+ * `wardic.<tag>` and `wardic.create(Component)` during a server render (ADR-0021, decisions 4 and
+ * 6): the element, or the component, with its Starting style and static attributes, built in one
+ * pass over the props. Solid's server `splitProps` and `mergeProps` cost most of a wrapped
+ * element's server time, and none of their reactivity matters there. The client's
+ * `createUniqueId` (inside `createWardWith`) and its `Dynamic` boundary are kept, so every
+ * hydration key lands where the client's render puts it.
+ */
+const serverElement = (component, internal, props, forward, isValidProp) => {
+    // A tag's props `isValidProp` keeps off it, as the client's (#443): of its own, the motion props, `ref` and `style` aside.
+    const ownKeys = () => Arr.filter(Object.keys(props), (key) => !MOTION_KEYS.has(key) && key !== "ref" && key !== "style");
+    const out = passThrough(props, forward, droppedKeysOf(ownKeys, isValidProp, Predicate.isString(component)));
+    const cfg = motionToConfig(props);
+    const ward = createWardWith(cfg, internal);
+    override(out, { ...ward({ style: props.style }), component });
+    // The client's nesting: the element's `ward.Provider` when it changes what its children read
+    // (#50), then the element; a late chunk's root then its chunk's style (#245).
+    const element = () => createComponent(Dynamic, out);
+    const render = () => Bool.match(changesContext(cfg()), {
+        onFalse: element,
+        onTrue: () => createComponent(ward.Provider, {
+            get children() {
+                return element();
+            },
+        }),
+    });
+    return renderServerElement(serverAppearOfWard(ward), render);
+};
+//# sourceMappingURL=element.jsx.map

package/dist/solid/element.jsx.map

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

package/dist/solid/feature-section.d.ts

@@ -0,0 +1,18 @@
+/**
+ * A section's **Features** (#511, ADR-0067), for the Solid 1 binding: the context each `LazyWardic`
+ * puts its section in (`feature.ts`'s `makeSection`), so a Slim element has its provider's Features
+ * and every `LazyWardic`'s between them (decision 2). A provider's own section isn't in it: the
+ * provider keeps it (`provider.tsx`), so a provider renders no second context, and every hydration
+ * key stays where it was.
+ *
+ * @module
+ */
+import type * as Cause from "effect/Cause";
+import { type FeatureRegistry, type FeatureSection, type FeaturesProp } from "./feature.ts";
+/** The nearest `LazyWardic`'s section, or `undefined` under none: its provider's then. */
+export declare const useLazySection: () => FeatureSection | undefined;
+/** The Provider a `LazyWardic`'s subtree renders under. */
+export declare const FeatureSectionProvider: import("solid-js").ContextProviderComponent<FeatureSection | undefined>;
+/** A section under `parent`, made under the current owner (`feature.ts`'s `makeSection`). */
+export declare const sectionUnder: (parent: FeatureSection, registry: FeatureRegistry, prop: FeaturesProp | undefined, strict: boolean, report: (cause: Cause.Cause<unknown>) => void) => FeatureSection;
+//# sourceMappingURL=feature-section.d.ts.map

package/dist/solid/feature-section.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-section.d.ts","sourceRoot":"","sources":["../../src/feature-section.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,KAAK,KAAK,MAAM,cAAc,CAAA;AAE1C,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,KAAK,YAAY,EAAiC,MAAM,cAAc,CAAA;AAM1H,0FAA0F;AAC1F,eAAO,MAAM,cAAc,QAAO,cAAc,GAAG,SAA8C,CAAA;AAEjG,2DAA2D;AAC3D,eAAO,MAAM,sBAAsB,yEAAiC,CAAA;AAIpE,6FAA6F;AAC7F,eAAO,MAAM,YAAY,WACf,cAAc,YACZ,eAAe,QACnB,YAAY,GAAG,SAAS,UACtB,OAAO,UACP,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,KAC5C,cAA2E,CAAA"}

package/dist/solid/feature-section.js

@@ -0,0 +1,13 @@
+import { createContext, onCleanup, useContext } from "solid-js";
+import { makeSection } from "./feature.js";
+import { isServer } from "./server.js";
+import { reactivity } from "./solid-reactivity.js";
+const FeatureSectionContext = createContext(undefined);
+/** The nearest `LazyWardic`'s section, or `undefined` under none: its provider's then. */
+export const useLazySection = () => useContext(FeatureSectionContext);
+/** The Provider a `LazyWardic`'s subtree renders under. */
+export const FeatureSectionProvider = FeatureSectionContext.Provider;
+const HOST = { reactivity, server: isServer, onCleanup };
+/** A section under `parent`, made under the current owner (`feature.ts`'s `makeSection`). */
+export const sectionUnder = (parent, registry, prop, strict, report) => makeSection(parent, registry, prop, strict, report, HOST);
+//# sourceMappingURL=feature-section.js.map

package/dist/solid/feature-section.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-section.js","sourceRoot":"","sources":["../../src/feature-section.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAC/D,OAAO,EAAgE,WAAW,EAAoB,MAAM,cAAc,CAAA;AAC1H,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAElD,MAAM,qBAAqB,GAAG,aAAa,CAA6B,SAAS,CAAC,CAAA;AAElF,0FAA0F;AAC1F,MAAM,CAAC,MAAM,cAAc,GAAG,GAA+B,EAAE,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAAA;AAEjG,2DAA2D;AAC3D,MAAM,CAAC,MAAM,sBAAsB,GAAG,qBAAqB,CAAC,QAAQ,CAAA;AAEpE,MAAM,IAAI,GAAgB,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAA;AAErE,6FAA6F;AAC7F,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,MAAsB,EACtB,QAAyB,EACzB,IAA8B,EAC9B,MAAe,EACf,MAA6C,EAC7B,EAAE,CAAC,WAAW,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,CAAA"}

package/dist/solid/feature.d.ts

@@ -0,0 +1,114 @@
+import * as Cause from "effect/Cause";
+import * as Context from "effect/Context";
+import * as Layer from "effect/Layer";
+import type * as ManagedRuntime from "effect/ManagedRuntime";
+import type { Reactivity } from "./reactivity.ts";
+import type { ProviderRuntime, ProviderServices, WardicServices } from "./runtime.ts";
+/**
+ * A **Feature**: its name, the key of the service its Layer gives (what an element looks up),
+ * and that Layer, built on the provider's runtime: its Environment, its flush gate and its projection
+ * options. `server` is what a server render, which builds no runtime, does with it: the
+ * `colors` Feature registers its colour spaces there too, as the render reads colours; the rest do
+ * nothing.
+ */
+export interface Feature<I = any, S = any> {
+    readonly name: string;
+    readonly key: Context.Key<I, S>;
+    readonly layer: Layer.Layer<I, never, ProviderServices>;
+    readonly server?: (() => void) | undefined;
+}
+/** Features as an app gives them: one, or a list, a preset's nested in it (`[domAnimation, layout]`). */
+export type Features = Feature | ReadonlyArray<Features>;
+/** Features loaded lazily: `() => import("./features.ts").then((m) => m.domMax)`. */
+export type FeatureLoad = () => Promise<Features>;
+/** Features given to a `WardicProvider` or a `LazyWardic`: at once, or loaded lazily. */
+export type FeaturesProp = Features | FeatureLoad;
+/** Features as one flat list, each once, in order. */
+export declare const flatten: (features: Features) => ReadonlyArray<Feature>;
+/** Whether a `features` prop loads lazily: a function, where Features are values. */
+export declare const isLoad: (prop: FeaturesProp) => prop is FeatureLoad;
+/** No Features. */
+export declare const NONE: Context.Context<never>;
+/**
+ * A section of the tree's Features (#511): a `WardicProvider`'s, a `LazyWardic`'s, or an element's,
+ * each its own joined with its parent's. Each binding makes its sections with its own signals.
+ */
+export interface FeatureSection {
+    /** The services of the Features it has now. Tracked: a lazy one arriving changes it. */
+    readonly services: () => Context.Context<never>;
+    /** Whether a lazy load of its own or a parent's is still on its way: no missing-Feature warning while one is. */
+    readonly pending: () => boolean;
+    /** Whether it, or a section above it, is `strict`: a Complete element under it is an error in development. */
+    readonly strict: boolean;
+}
+/** Outside every provider, and above each provider's own: no Features, nothing on its way, not strict. */
+export declare const ROOT: FeatureSection;
+/** What a section takes from its binding: its reactivity, whether it renders on a server, and its owner's cleanup. */
+export interface SectionHost {
+    readonly reactivity: Reactivity;
+    readonly server: boolean;
+    readonly onCleanup: (fn: () => void) => void;
+}
+/**
+ * A section under `parent` with `prop`'s Features (#511):
+ * - **Given at once**, they're built on first need, the first time an element in it asks (#51: a
+ *   provider with no element under it builds nothing); a server render runs their `server` part at
+ *   once, as its elements may read what it registers.
+ * - **Loaded lazily** (decision 8), the load starts now on the client and they're built as they
+ *   arrive, from then on; `pending` until it settles. A failed load is `report`ed, once. A server
+ *   render loads nothing: it renders as it would without them.
+ *
+ * Its services join its own and its parent's, joined again only when either changes.
+ */
+export declare const makeSection: (parent: FeatureSection, registry: FeatureRegistry, prop: FeaturesProp | undefined, strict: boolean, report: (cause: Cause.Cause<unknown>) => void, host: SectionHost) => FeatureSection;
+/**
+ * A provider's Features: each built once, on first need, and every list it's asked for joined once.
+ * `build` is synchronous; a Feature's Layer that can't build at once is a defect.
+ */
+export interface FeatureRegistry {
+    /** The services of `features`, each Feature built the first time it's asked for. */
+    readonly build: (features: ReadonlyArray<Feature>) => Context.Context<never>;
+    /** A section of exactly `features`, nothing on its way: one per list, a Complete element's (#511). */
+    readonly section: (features: ReadonlyArray<Feature>) => FeatureSection;
+    /**
+     * The services of every Feature built so far, whichever section asked: what a part of the provider
+     * that brings no Feature works with when one is there (the projection system, for a presence).
+     */
+    readonly built: () => Context.Context<never>;
+    /** Logs `message` at Warning the first time `feature` is named: development's word on a missing Feature. */
+    readonly warnOnce: (feature: string, message: string) => void;
+    /** Ends every Feature built, the provider's runtime after (a Feature's Layer may stand on it). */
+    readonly dispose: () => Promise<void>;
+}
+/**
+ * A client provider's Features (#511): built into `runtime`'s `MemoMap` in a Scope of their own, a child
+ * of the runtime's that closes before its Layers do, so a Feature ends before the Environment it stands
+ * on. A list asked for again (the Complete element's every Feature) is joined once.
+ */
+export declare const clientRegistry: (runtime: ProviderRuntime) => FeatureRegistry;
+/**
+ * A server render's Features (ADR-0021): none built, as no runtime is; each one's `server` run once,
+ * the first time it's asked for. Disposing disposes the unbuilt runtime, as on unmount.
+ */
+export declare const serverRegistry: (runtime: ManagedRuntime.ManagedRuntime<WardicServices, never>) => FeatureRegistry;
+/**
+ * The first of `values` that only the `colors` Feature would read as a colour (#511, decision 7): a
+ * string naming a wide-gamut space, while no space beyond sRGB's is registered on the page.
+ * `undefined` when there's none. Asked of the page, not of an element's Features: culori's spaces are
+ * the page's, so one registered by any provider is read by every element (`features/colors.ts`).
+ */
+export declare const unreadColorIn: (values: Readonly<Record<string, unknown>>) => string | undefined;
+/**
+ * Development's word on a Complete element under a `strict` section (#511, ADR-0067 decision 7,
+ * Motion's), naming the binding's `complete` forms and the `slim` ones to use.
+ */
+export declare const strictMessage: (complete: string, slim: string) => string;
+/** What development's word on a missing `layout` Feature names (#511): the props that need it. */
+export declare const LAYOUT_PROPS = "A layout prop (`layout`, `layoutId`, `layoutScroll` or `layoutRoot`)";
+/**
+ * Development's word on a missing Feature (#511, ADR-0067 decision 7): what needed it, its import from
+ * the binding's `entry`, and where to add it. Not a Complete element, which a `strict` section makes
+ * an error (#581).
+ */
+export declare const missingMessage: (feature: string, what: string, entry: string) => string;
+//# sourceMappingURL=feature.d.ts.map

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

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