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

package/dist/internal/auto-scroll.js

@@ -0,0 +1,124 @@
+/**
+ * The DOM's **Auto-scroll** (ADR-0020, grill decision 16): Motion's
+ * (Reorder/utils/auto-scroll.ts at 16c61222c4166bbef5ff6ab0051192faa79fa8c8,
+ * https://github.com/motiondivision/motion/blob/16c61222c4166bbef5ff6ab0051192faa79fa8c8/packages/framer-motion/src/components/Reorder/utils/auto-scroll.ts)
+ * over core's pure `AutoScroll.step`. While a **Reorder group**'s item is dragged near
+ * the visible edge of the group's scroller, moving toward it, each drag update scrolls
+ * the scroller; the scroll then moves the held pointer (a synthetic move), whose update
+ * scrolls again, so it keeps scrolling while the pointer holds still in the zone.
+ */
+import * as AutoScroll from "@wardic/core/AutoScroll";
+import * as Arr from "effect/Array";
+import * as Bool from "effect/Boolean";
+import * as Equal from "effect/Equal";
+import { constVoid } from "effect/Function";
+import * as Match from "effect/Match";
+import * as Option from "effect/Option";
+import * as UndefinedOr from "effect/UndefinedOr";
+import { heldScrollShift } from "./input.js";
+/** The overflow values Motion's auto-scroll scrolls (auto-scroll.ts:4). */
+const SCROLLS = new Set(["auto", "scroll"]);
+const ZERO = { x: 0, y: 0 };
+/**
+ * The nearest ancestor of `group` that scrolls on `axis` (`overflow` `auto | scroll`),
+ * or the document once the walk reaches `body` (Motion's `findScrollableAncestor`).
+ */
+const findScroller = (group, axis) => {
+    const doc = group.ownerDocument;
+    const from = (cur) => Option.flatMap(Option.fromNullOr(cur), (el) => Bool.match(el === doc.body || el === doc.documentElement, {
+        onTrue: () => Option.map(Option.fromNullOr(doc.defaultView), (win) => ({ kind: "document", win })),
+        onFalse: () => {
+            const style = getComputedStyle(el);
+            return Bool.match(SCROLLS.has({ x: style.overflowX, y: style.overflowY }[axis]), {
+                onTrue: () => Option.some({ kind: "element", el }),
+                onFalse: () => from(el.parentElement),
+            });
+        },
+    }));
+    return from(group.parentElement);
+};
+/** `scroller`'s extent on `axis`: an element's visible edges are clamped to the viewport, as Motion's `getScrollAmount`. */
+const viewOf = (scroller, axis) => Match.value(scroller).pipe(Match.when({ kind: "document" }, ({ win }) => {
+    const root = win.document.documentElement;
+    return {
+        start: 0,
+        end: { x: win.innerWidth, y: win.innerHeight }[axis],
+        scroll: { x: win.scrollX, y: win.scrollY }[axis],
+        maxScroll: { x: () => root.scrollWidth - win.innerWidth, y: () => root.scrollHeight - win.innerHeight }[axis],
+    };
+}), Match.when({ kind: "element" }, ({ el }) => {
+    const rect = el.getBoundingClientRect();
+    const win = Option.fromNullOr(el.ownerDocument.defaultView);
+    const viewport = {
+        x: Option.match(win, { onNone: () => rect.right, onSome: (w) => w.innerWidth }),
+        y: Option.match(win, { onNone: () => rect.bottom, onSome: (w) => w.innerHeight }),
+    };
+    return {
+        start: Math.max(0, { x: rect.left, y: rect.top }[axis]),
+        end: Math.min(viewport[axis], { x: rect.right, y: rect.bottom }[axis]),
+        scroll: { x: el.scrollLeft, y: el.scrollTop }[axis],
+        maxScroll: { x: () => el.scrollWidth - el.clientWidth, y: () => el.scrollHeight - el.clientHeight }[axis],
+    };
+}), Match.exhaustive);
+/** Scroll `scroller` by `amount` on `axis`. */
+const scrollBy = (scroller, axis, amount) => Match.value(scroller).pipe(Match.when({ kind: "document" }, ({ win }) => win.scrollBy({ x: { left: amount }, y: { top: amount } }[axis])), Match.when({ kind: "element" }, ({ el }) => Match.value(axis).pipe(Match.when("x", () => {
+    el.scrollLeft += amount;
+}), Match.orElse(() => {
+    el.scrollTop += amount;
+}))), Match.exhaustive);
+const edgeOf = (state) => state.edge;
+/**
+ * Build the **Auto-scroll** for `group` (the Reorder group's element). The scroller on
+ * each axis is found once per gesture, at its first update. Each update reads the
+ * scroller's visible edges (clamped to the viewport, as Motion's `getScrollAmount`), runs
+ * core's `AutoScroll.step`, and scrolls by its amount. `debug` receives `auto-scroll
+ * start` and `auto-scroll stop` { axis, edge } when an edge starts and ends scrolling.
+ */
+export const makeAutoScroller = (group, debug) => {
+    const log = UndefinedOr.match(debug, { onUndefined: () => constVoid, onDefined: (d) => d });
+    // Each axis's scroller, found at the gesture's first update (`None` when there is none).
+    const scrollers = new Map();
+    const states = new Map();
+    const setState = (axis, next) => {
+        const prev = Option.fromUndefinedOr(states.get(axis));
+        const edgeChanged = Bool.not(Equal.equals(Option.map(prev, edgeOf), Option.map(next, edgeOf)));
+        if (edgeChanged && Option.isSome(prev))
+            log("auto-scroll stop", { axis, edge: prev.value.edge });
+        Option.match(next, {
+            onNone: () => states.delete(axis),
+            onSome: (state) => states.set(axis, state),
+        });
+        if (edgeChanged && Option.isSome(next))
+            log("auto-scroll start", { axis, edge: next.value.edge });
+    };
+    return {
+        update: (pointer, axis, velocity, item) => {
+            const scroller = Option.getOrElse(Option.fromUndefinedOr(scrollers.get(axis)), () => {
+                const found = findScroller(group, axis);
+                scrollers.set(axis, found);
+                return found;
+            });
+            if (Option.isNone(scroller))
+                return;
+            const shift = UndefinedOr.match(item, { onUndefined: () => ZERO, onDefined: heldScrollShift });
+            const view = viewOf(scroller.value, axis);
+            const step = AutoScroll.step(Option.fromUndefinedOr(states.get(axis)), {
+                pointer: pointer[axis] - shift[axis],
+                start: view.start,
+                end: view.end,
+                velocity,
+                scroll: view.scroll,
+                maxScroll: view.maxScroll,
+            });
+            setState(axis, step.state);
+            if (step.amount === 0)
+                return;
+            scrollBy(scroller.value, axis, step.amount);
+        },
+        reset: () => {
+            Arr.forEach(Arr.fromIterable(states.keys()), (axis) => setState(axis, Option.none()));
+            scrollers.clear();
+        },
+    };
+};
+//# sourceMappingURL=auto-scroll.js.map

package/dist/internal/auto-scroll.js.map

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

package/dist/internal/clock.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `ClockDomLive` — the browser realization of `Clock` and of the Environment's
+ * `RefreshFrameSource` (ADR-0031): `requestAnimationFrame`, whose callbacks are the browser's
+ * Refresh frames, as the member, and core's shared `Clock.layer` built from it. The flush gate
+ * requests its flushes from the same member, so the Clock and the gate share the browser's
+ * frames. Everything else — the ref-counted Refresh frame loop, the `dt` computation and the
+ * `wardic.clock` span — lives in core, so every Environment's Clock behaves the same (ADR-0004).
+ */
+import * as Clock from "@wardic/core/Clock";
+import * as RefreshFrameSource from "@wardic/core/RefreshFrameSource";
+import * as Layer from "effect/Layer";
+/**
+ * Core's `Clock` and the Environment's `RefreshFrameSource`, from one `requestAnimationFrame`, needing
+ * nothing: the frame loop runs in the Layer's own scope. It reads `requestAnimationFrame` when the Layer
+ * is built, not when `@wardic/dom` is imported, so a test that stubs it first drives this Clock. Building
+ * it on a server fails, with an error that says it's client-only.
+ */
+export declare const ClockDomLive: Layer.Layer<Clock.Clock | RefreshFrameSource.RefreshFrameSource>;
+//# sourceMappingURL=clock.d.ts.map

package/dist/internal/clock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.d.ts","sourceRoot":"","sources":["../../src/internal/clock.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,KAAK,MAAM,oBAAoB,CAAA;AAC3C,OAAO,KAAK,kBAAkB,MAAM,iCAAiC,CAAA;AAErE,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AAwBrC;;;;;GAKG;AAEH,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,kBAAkB,CAAC,kBAAkB,CAEzF,CAAA"}

package/dist/internal/clock.js

@@ -0,0 +1,39 @@
+/**
+ * `ClockDomLive` — the browser realization of `Clock` and of the Environment's
+ * `RefreshFrameSource` (ADR-0031): `requestAnimationFrame`, whose callbacks are the browser's
+ * Refresh frames, as the member, and core's shared `Clock.layer` built from it. The flush gate
+ * requests its flushes from the same member, so the Clock and the gate share the browser's
+ * frames. Everything else — the ref-counted Refresh frame loop, the `dt` computation and the
+ * `wardic.clock` span — lives in core, so every Environment's Clock behaves the same (ADR-0004).
+ */
+import * as Clock from "@wardic/core/Clock";
+import * as RefreshFrameSource from "@wardic/core/RefreshFrameSource";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Predicate from "effect/Predicate";
+import { requireGlobal } from "./require-global.js";
+/**
+ * The browser's Refresh frames: `requestAnimationFrame` itself, so the Clock and the gate make
+ * the browser's own calls, in the order they make them (ADR-0031, decision 7). `cancelFrame`
+ * wraps `cancelAnimationFrame` for the member's `unknown` handle; it runs only on a cancel. Both
+ * are read when the Layer builds, after the client-only check.
+ */
+const frames = Layer.effect(RefreshFrameSource.RefreshFrameSource)(requireGlobal("DomClock.layer", "requestAnimationFrame").pipe(Effect.map(() => {
+    const cancel = cancelAnimationFrame;
+    return {
+        requestFrame: requestAnimationFrame,
+        cancelFrame: (handle) => {
+            if (Predicate.isNumber(handle))
+                cancel(handle);
+        },
+    };
+})));
+/**
+ * Core's `Clock` and the Environment's `RefreshFrameSource`, from one `requestAnimationFrame`, needing
+ * nothing: the frame loop runs in the Layer's own scope. It reads `requestAnimationFrame` when the Layer
+ * is built, not when `@wardic/dom` is imported, so a test that stubs it first drives this Clock. Building
+ * it on a server fails, with an error that says it's client-only.
+ */
+// ADR-0021, decision 7: the client-only error.
+export const ClockDomLive = Clock.layer.pipe(Layer.provideMerge(frames));
+//# sourceMappingURL=clock.js.map

package/dist/internal/clock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.js","sourceRoot":"","sources":["../../src/internal/clock.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,KAAK,MAAM,oBAAoB,CAAA;AAC3C,OAAO,KAAK,kBAAkB,MAAM,iCAAiC,CAAA;AACrE,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,SAAS,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAEnD;;;;;GAKG;AACH,MAAM,MAAM,GAAuD,KAAK,CAAC,MAAM,CAAC,kBAAkB,CAAC,kBAAkB,CAAC,CACpH,aAAa,CAAC,gBAAgB,EAAE,uBAAuB,CAAC,CAAC,IAAI,CAC3D,MAAM,CAAC,GAAG,CAAC,GAA6B,EAAE;IACxC,MAAM,MAAM,GAAG,oBAAoB,CAAA;IACnC,OAAO;QACL,YAAY,EAAE,qBAAqB;QACnC,WAAW,EAAE,CAAC,MAAe,EAAE,EAAE;YAC/B,IAAI,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAAE,MAAM,CAAC,MAAM,CAAC,CAAA;QAChD,CAAC;KACF,CAAA;AACH,CAAC,CAAC,CACH,CACF,CAAA;AAED;;;;;GAKG;AACH,+CAA+C;AAC/C,MAAM,CAAC,MAAM,YAAY,GAAqE,KAAK,CAAC,KAAK,CAAC,IAAI,CAC5G,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAC3B,CAAA"}

package/dist/internal/colors.d.ts

@@ -0,0 +1,45 @@
+import type * as Interpolator from "@wardic/core/Interpolator";
+import * as Option from "effect/Option";
+/** A colour as culori holds it: its colour space (`mode`) and its channels. */
+export type Color = {
+    readonly mode: string;
+    readonly [channel: string]: number | string | undefined;
+};
+/** A colour string read: a culori colour, or `None` for any other value. A string is a colour when culori reads it, trimmed. */
+export declare const parseColor: (value: unknown) => Option.Option<Color>;
+/**
+ * A colour written as `rgb(…)` or `rgba(…)`, as culori's `formatRgb` writes it, so `"#fff"` reads and
+ * writes back as `"rgb(255, 255, 255)"`: what a blend's every frame writes.
+ */
+export declare const formatColor: (color: Color) => string;
+/**
+ * Registers every CSS colour space beyond sRGB's syntaxes: `lab()`, `lch()`, `oklab()`, `oklch()`,
+ * `hwb()`, and `color()`'s `display-p3`, `rec2020`, `a98-rgb`, `prophoto-rgb`, `srgb-linear`, `xyz`,
+ * `xyz-d50` and `xyz-d65`. From then on such a string is a colour everywhere on the page; before, it
+ * isn't one, and a `lab()` value's numbers blend as written. Calling it again does nothing new.
+ */
+export declare const registerSpaces: () => void;
+/**
+ * Whether the spaces `registerSpaces` registers are registered on the page: by it, or by culori's own
+ * bundle, which registers every space as it loads.
+ */
+export declare const spacesRegistered: () => boolean;
+/**
+ * Blends colours in the colour space `mode`: `"rgb"` by default, sRGB, as the browser's own animations
+ * blend. `"oklch"` or `"lab"` blend perceptually, once `registerSpaces` has registered them. A string is
+ * a colour when culori reads it, trimmed, so a keyword like `"auto"` isn't, and named colours and the
+ * modern forms culori knows are. Past the end of a blend a colour holds at its target.
+ *
+ * @example
+ * Color.registerSpaces()
+ * yield* registry.register(Color.interpolator("oklch")) // colours now blend in OKLCH
+ */
+export declare const color: (mode?: string) => Interpolator.Entry<Color, string>;
+/**
+ * A colour inside a longer value: a hex, or an `rgb()`, `rgba()`, `hsl()` or `hsla()`, as Motion's colour
+ * token is. A named colour, `red`, isn't one: it stays part of the text around the tokens.
+ */
+export declare const COLOR_TOKEN: RegExp;
+/** The DOM's colours: CSS's colour syntax, blended in sRGB, as the browser's own animations blend. Its registry's colour kind. */
+export declare const cssColor: Interpolator.Entry<Color, string>;
+//# sourceMappingURL=colors.d.ts.map

package/dist/internal/colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../src/internal/colors.ts"],"names":[],"mappings":"AAqCA,OAAO,KAAK,KAAK,YAAY,MAAM,2BAA2B,CAAA;AAK9D,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAKvC,+EAA+E;AAE/E,MAAM,MAAM,KAAK,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;CAAE,CAAA;AAgBtG,gIAAgI;AAGhI,eAAO,MAAM,UAAU,UAAW,OAAO,KAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAG9D,CAAA;AAED;;;GAGG;AAEH,eAAO,MAAM,WAAW,UAAW,KAAK,KAAG,MAA0B,CAAA;AAmBrE;;;;;GAKG;AAGH,eAAO,MAAM,cAAc,QAAO,IAIjC,CAAA;AAED;;;GAGG;AAEH,eAAO,MAAM,gBAAgB,QAAO,OAAqD,CAAA;AAsGzF;;;;;;;;;GASG;AAQH,eAAO,MAAM,KAAK,qBAAmB,YAAY,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAWnE,CAAA;AAEF;;;GAGG;AAEH,eAAO,MAAM,WAAW,QAAgH,CAAA;AAExI,kIAAkI;AAElI,eAAO,MAAM,QAAQ,EAAE,YAAY,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAgB,CAAA"}

package/dist/internal/colors.js

@@ -0,0 +1,193 @@
+/**
+ * The DOM Environment's colours (ADR-0036; ADR-0026 for the Interpolator's shape): CSS Color syntax,
+ * parsed through culori, and blended in sRGB by Wardic's own lerp and format, which write culori's
+ * strings (ADR-0026 *Amendment (#156)*). Core names no colour syntax; `@wardic/dom` registers its
+ * colour Interpolator in its registry (`interpolators.ts`) and names a colour inside a complex value
+ * as a kind of token (`COLOR_TOKEN`, #61).
+ *
+ * Read through `culori/fn`, which registers no colour space by itself (#511, ADR-0067 decision 5):
+ * sRGB's syntaxes, a hex, `rgb()`, `hsl()` and the colour names, are registered here, and every other
+ * CSS colour space (`oklch()`, `lab()`, `color(display-p3 …)`, `hwb()` …) by {@link registerSpaces},
+ * which the bindings' `colors` Feature calls. culori keeps its spaces in one registry for the page, so
+ * a space registered once is read everywhere from then on.
+ *
+ * @module
+ */
+/// <reference path="./culori.d.ts" />
+import { formatRgb, getMode, interpolate as culoriInterpolate, modeA98, modeHsl, modeHwb, modeLab, modeLch, modeLrgb, modeOklab, modeOklch, modeP3, modeProphoto, modeRec2020, modeRgb, modeXyz50, modeXyz65, parse as culoriParse, useMode, } from "culori/fn";
+import * as Scalar from "@wardic/core/Scalar";
+import * as Arr from "effect/Array";
+import * as Bool from "effect/Boolean";
+import { identity } from "effect/Function";
+import * as Option from "effect/Option";
+import * as Predicate from "effect/Predicate";
+import * as Str from "effect/String";
+import * as UndefinedOr from "effect/UndefinedOr";
+/** A culori colour: an object tagged with its colour space. */
+const isColor = (value) => Predicate.hasProperty(value, "mode");
+/**
+ * culori's `parse`, with a throw read as no colour. It throws on a CSS function holding a length,
+ * `blur(4px)`, `inset(10px)`, `drop-shadow(0px 0px 4px red)`, and the throw escaped the colour's
+ * decode at `resolve`, so the leg failed (#154).
+ */
+const culoriParseOption = Option.liftThrowable(culoriParse);
+/** Parse a colour string, trimmed, or `None` when culori rejects it (`"auto"`, `"#zzz"`) or throws on it (`"blur(4px)"`). */
+const parseColorString = (input) => Option.filter(Option.flatMap(culoriParseOption(Str.trim(input)), Option.fromUndefinedOr), isColor);
+/** A colour string read: a culori colour, or `None` for any other value. A string is a colour when culori reads it, trimmed. */
+// ADR-0026; CONTEXT.md's "color string". `Color.parse`, and the colour Interpolator's `parse` (plain
+// functions since #511, where they were a Schema codec, `ColorString`).
+export const parseColor = (value) => {
+    if (!Predicate.isString(value))
+        return Option.none();
+    return parseColorString(value);
+};
+/**
+ * A colour written as `rgb(…)` or `rgba(…)`, as culori's `formatRgb` writes it, so `"#fff"` reads and
+ * writes back as `"rgb(255, 255, 255)"`: what a blend's every frame writes.
+ */
+// `Color.format`, and the colour Interpolator's `format`.
+export const formatColor = (color) => formatRgb(color);
+// --- sRGB, Wardic's own (#156, ADR-0026 *Amendment (#156)*) ------------------------------------
+//
+// culori's `formatRgb(interpolate([from, to], "rgb")(t))`, string for string, without a colour
+// object per frame. Its path, at culori 4.0.2: `t` clamped to [0, 1]; at `t <= 0` the start as
+// converted; a channel one end lacks (CSS `none`) takes the other end's; an alpha one end lacks is
+// 1 when the other has one (`fixupAlpha`); each channel lerped `a + t * (b - a)` (`Scalar.lerp`'s
+// `a + (b - a) * t`, the same bits: multiplication commutes); then each channel byte is
+// `round(clamp(v || 0) * 255)`, and `rgb()` is written when alpha is absent or exactly 1, else
+// `rgba()` with alpha clamped and rounded to two places, so 0.999 writes `rgba(…, 1)`. A seeded
+// differential test against culori pins it (`colors.node.test.ts`).
+// sRGB's syntaxes, read by every app (#511): `rgb`'s parsers take a hex, `rgb()` and `rgba()`, the
+// colour names and `transparent`; `hsl`'s take `hsl()` and `hsla()`. Registered once, when this module
+// loads, as culori's own bundle registers its spaces.
+const toRgb = useMode(modeRgb);
+useMode(modeHsl);
+/**
+ * Registers every CSS colour space beyond sRGB's syntaxes: `lab()`, `lch()`, `oklab()`, `oklch()`,
+ * `hwb()`, and `color()`'s `display-p3`, `rec2020`, `a98-rgb`, `prophoto-rgb`, `srgb-linear`, `xyz`,
+ * `xyz-d50` and `xyz-d65`. From then on such a string is a colour everywhere on the page; before, it
+ * isn't one, and a `lab()` value's numbers blend as written. Calling it again does nothing new.
+ */
+// #511, ADR-0067 decision 5: the spaces culori's `culori/css` registers but for its non-CSS `hsv`, `lab65`
+// and `lch65`. The `colors` Feature's.
+export const registerSpaces = () => {
+    Arr.forEach(CSS_SPACES, (mode) => {
+        useMode(mode);
+    });
+};
+/**
+ * Whether the spaces `registerSpaces` registers are registered on the page: by it, or by culori's own
+ * bundle, which registers every space as it loads.
+ */
+// Asked of culori's registry, the page's.
+export const spacesRegistered = () => Predicate.isNotUndefined(getMode("oklch"));
+const CSS_SPACES = [modeA98, modeHwb, modeLab, modeLch, modeLrgb, modeOklab, modeOklch, modeP3, modeProphoto, modeRec2020, modeXyz50, modeXyz65];
+/**
+ * One channel of a pair, as culori's piecewise interpolator reads it: both ends, or the end that
+ * has it, twice. One neither end has is 0 on both: culori leaves it out, and its format writes 0.
+ */
+const channelPair = (a, b) => UndefinedOr.match(a, {
+    onUndefined: () => UndefinedOr.match(b, { onUndefined: () => [0, 0], onDefined: (y) => [y, y] }),
+    onDefined: (x) => UndefinedOr.match(b, { onUndefined: () => [x, x], onDefined: (y) => [x, y] }),
+});
+/** An alpha one end lacks is 1, culori's `fixupAlpha`; with neither, 1 on both writes `rgb()`, as culori does. */
+const alphaOf = (alpha) => UndefinedOr.match(alpha, { onUndefined: () => 1, onDefined: identity });
+/** A channel's value at 0–1, as culori's format reads it: NaN as 0, then clamped. Per frame: an early return. */
+const unitOf = (value) => {
+    if (Number.isNaN(value))
+        return 0;
+    return Math.max(0, Math.min(1, value));
+};
+/** A channel as a byte, as culori's `formatRgb` writes it. */
+const byteOf = (value) => Math.round(unitOf(value) * 255);
+/** An alpha as culori's `formatRgb` writes it: clamped, two decimal places. */
+const alphaText = (alpha) => Math.round(unitOf(alpha) * 100) / 100;
+/** Four channels as culori's `formatRgb` writes them. Per frame: an early return. */
+const formatChannels = (r, g, b, alpha) => {
+    if (alpha === 1)
+        return `rgb(${byteOf(r)}, ${byteOf(g)}, ${byteOf(b)})`;
+    return `rgba(${byteOf(r)}, ${byteOf(g)}, ${byteOf(b)}, ${alphaText(alpha)})`;
+};
+/**
+ * Two colours' blend in sRGB, on the per-frame path (ADR-0025): `t` clamped as culori clamps it,
+ * the start as written at `t <= 0`, and the four lerps formatted. Nothing allocated but the string.
+ */
+const blendChannels = (atStart, from, to) => (t) => {
+    const at = Math.min(Math.max(0, t), 1);
+    if (at <= 0)
+        return atStart;
+    return formatChannels(Scalar.lerp(from.r, to.r, at), Scalar.lerp(from.g, to.g, at), Scalar.lerp(from.b, to.b, at), Scalar.lerp(from.alpha, to.alpha, at));
+};
+/**
+ * Two ends with the same channels: every `t` past 0 writes one string, since `a + t * (a - a)` is
+ * `a` (#156). Per frame: an early return.
+ */
+const holdChannels = (atStart, same) => (t) => {
+    if (t <= 0)
+        return atStart;
+    return same;
+};
+/** Two channels that are the same on both ends. */
+const isSame = ([a, b]) => a === b;
+/**
+ * Two colours' sRGB blend, resolved once when a stream is built: each end converted to sRGB by
+ * culori, its channels paired as culori pairs them, and the start's own string for `t <= 0`, by
+ * culori's `formatRgb` itself. Two ends with the same channels hold one string.
+ */
+const srgb = (from, to) => {
+    const a = toRgb(from);
+    const b = toRgb(to);
+    const pairs = [
+        channelPair(a.r, b.r),
+        channelPair(a.g, b.g),
+        channelPair(a.b, b.b),
+        [alphaOf(a.alpha), alphaOf(b.alpha)],
+    ];
+    const [[fr, tr], [fg, tg], [fb, tb], [fa, ta]] = pairs;
+    const atStart = formatRgb(a);
+    return Bool.match(Arr.every(pairs, isSame), {
+        onTrue: () => holdChannels(atStart, formatChannels(fr, fg, fb, fa)),
+        onFalse: () => blendChannels(atStart, { r: fr, g: fg, b: fb, alpha: fa }, { r: tr, g: tg, b: tb, alpha: ta }),
+    });
+};
+/** Two colours' blend through culori in `mode`: `interpolate` once, then a colour object and `formatRgb` per frame. */
+const throughCulori = (mode, from, to) => {
+    const at = culoriInterpolate([from, to], mode);
+    return (t) => formatRgb(at(t));
+};
+/**
+ * Blends colours in the colour space `mode`: `"rgb"` by default, sRGB, as the browser's own animations
+ * blend. `"oklch"` or `"lab"` blend perceptually, once `registerSpaces` has registered them. A string is
+ * a colour when culori reads it, trimmed, so a keyword like `"auto"` isn't, and named colours and the
+ * modern forms culori knows are. Past the end of a blend a colour holds at its target.
+ *
+ * @example
+ * Color.registerSpaces()
+ * yield* registry.register(Color.interpolator("oklch")) // colours now blend in OKLCH
+ */
+// ADR-0026. A factory, so an app can register the space it prefers over the one `parseColor` and
+// `formatColor` use; the DOM's registry uses `"rgb"` (`cssColor`). `blend` resolves the pair once, when a
+// stream is built, and the frame writes the string `format` (`formatRgb`) would:
+// - `"rgb"` blends with Wardic's own lerp and format (#156, ADR-0026 *Amendment (#156)*), the strings
+//   culori writes, with no colour object per frame; two ends of the same colour write one string.
+// - Any other mode goes through culori's interpolator, which returns a new colour object on each call.
+// Either clamps `t` to [0, 1], as culori does (ADR-0024, decision 5).
+export const color = (mode = "rgb") => ({
+    name: `color(${mode})`,
+    parse: parseColor,
+    format: formatColor,
+    blend: (from, to) => Option.some(Bool.match(mode === "rgb", {
+        onTrue: () => srgb(from, to),
+        onFalse: () => throughCulori(mode, from, to),
+    })),
+});
+/**
+ * A colour inside a longer value: a hex, or an `rgb()`, `rgba()`, `hsl()` or `hsla()`, as Motion's colour
+ * token is. A named colour, `red`, isn't one: it stays part of the text around the tokens.
+ */
+// Motion's motion-dom value/types/utils/color-regex.ts at 16c6122; #61.
+export const COLOR_TOKEN = /#[\da-f]{3,8}|(?:rgb|hsl)a?\((?:-?[\d.]+%?[,\s]+){2}-?[\d.]+%?\s*(?:[,/]\s*)?(?:\b\d+(?:\.\d+)?|\.\d+)?%?\)/;
+/** The DOM's colours: CSS's colour syntax, blended in sRGB, as the browser's own animations blend. Its registry's colour kind. */
+// ADR-0024: as WAAPI blends.
+export const cssColor = color("rgb");
+//# sourceMappingURL=colors.js.map

package/dist/internal/colors.js.map

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

package/dist/internal/complex.d.ts

@@ -0,0 +1,24 @@
+/**
+ * The DOM Environment's complex values (ADR-0035 *Amendment (#158)*, ADR-0036): core's complex tier,
+ * given CSS's `var()` as a span of text (#158) and a colour as a kind of token (#61, #160). Core
+ * names neither.
+ *
+ * @module
+ */
+import * as Interpolator from "@wardic/core/Interpolator";
+/**
+ * A reference to a custom property, `var(--name)`, with a fallback one bracket level deep (Motion's
+ * var token, motion-dom value/types/complex/index.ts `complexRegex` at 16c6122). Inside a complex
+ * value it's text: the digits in its name (`--gray-500`) are never numbers (#158).
+ */
+export declare const VARIABLE_REFERENCE: RegExp;
+/**
+ * Core's complex Interpolator with the DOM's syntax:
+ * - a `var()` is text (#158): a lone `var()` isn't a complex value, and two blend only with the same
+ *   count of `var()`s, the target's written as it stands;
+ * - a colour is a token (#61, #160) that blends through `cssColor`, in sRGB, so a shadow's colour
+ *   fades: two blend only with the same count of colours, the n-th with the n-th, and a lone colour
+ *   is `cssColor`'s, not a complex value.
+ */
+export declare const cssComplex: Interpolator.Entry<Interpolator.Complex, string>;
+//# sourceMappingURL=complex.d.ts.map

package/dist/internal/complex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"complex.d.ts","sourceRoot":"","sources":["../../src/internal/complex.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,YAAY,MAAM,2BAA2B,CAAA;AAGzD;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,QAA2F,CAAA;AAE1H;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,EAAE,YAAY,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAGtE,CAAA"}

package/dist/internal/complex.js

@@ -0,0 +1,28 @@
+/**
+ * The DOM Environment's complex values (ADR-0035 *Amendment (#158)*, ADR-0036): core's complex tier,
+ * given CSS's `var()` as a span of text (#158) and a colour as a kind of token (#61, #160). Core
+ * names neither.
+ *
+ * @module
+ */
+import * as Interpolator from "@wardic/core/Interpolator";
+import { COLOR_TOKEN, cssColor } from "./colors.js";
+/**
+ * A reference to a custom property, `var(--name)`, with a fallback one bracket level deep (Motion's
+ * var token, motion-dom value/types/complex/index.ts `complexRegex` at 16c6122). Inside a complex
+ * value it's text: the digits in its name (`--gray-500`) are never numbers (#158).
+ */
+export const VARIABLE_REFERENCE = /var\s*\(\s*--(?:[\w-]+\s*|[\w-]+\s*,(?:\s*[^)(\s]|\s*\((?:[^)(]|\([^)(]*\))*\))+\s*)\)/;
+/**
+ * Core's complex Interpolator with the DOM's syntax:
+ * - a `var()` is text (#158): a lone `var()` isn't a complex value, and two blend only with the same
+ *   count of `var()`s, the target's written as it stands;
+ * - a colour is a token (#61, #160) that blends through `cssColor`, in sRGB, so a shadow's colour
+ *   fades: two blend only with the same count of colours, the n-th with the n-th, and a lone colour
+ *   is `cssColor`'s, not a complex value.
+ */
+export const cssComplex = Interpolator.complexWith({
+    text: [VARIABLE_REFERENCE],
+    tokens: [{ pattern: COLOR_TOKEN, entry: cssColor }],
+});
+//# sourceMappingURL=complex.js.map

package/dist/internal/complex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"complex.js","sourceRoot":"","sources":["../../src/internal/complex.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,YAAY,MAAM,2BAA2B,CAAA;AACzD,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAEnD;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,wFAAwF,CAAA;AAE1H;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,UAAU,GAAqD,YAAY,CAAC,WAAW,CAAC;IACnG,IAAI,EAAE,CAAC,kBAAkB,CAAC;IAC1B,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;CACpD,CAAC,CAAA"}

package/dist/internal/content-watch.d.ts

@@ -0,0 +1,20 @@
+/** Observing and letting go of boxes on one observer, each counted by the reasons it's watched for. */
+export interface Watched {
+    readonly observe: (box: Element) => void;
+    readonly unobserve: (box: Element) => void;
+}
+/** {@link Watched} over `observer`, every box observed with `options`. */
+export declare const counted: (observer: ResizeObserver, options?: ResizeObserverOptions) => Watched;
+/**
+ * Watch `parent`'s direct children on `watched`, kept current by a `MutationObserver` on its child list.
+ * `onChildren` runs after each change to the list, its children watched by then. Returns the stop; the
+ * observer's own disconnect lets go of the boxes.
+ */
+export declare const watchChildren: (parent: Element, watched: Watched, onChildren: () => void) => (() => void);
+/**
+ * Watch the page's content on `watched`: the body and its direct children (a body sized to the window
+ * doesn't grow with what overflows it), as {@link watchChildren} watches a container's. None with no
+ * body (a server, a document not parsed that far). Returns the stop.
+ */
+export declare const watchPage: (watched: Watched, onChildren: () => void) => (() => void);
+//# sourceMappingURL=content-watch.d.ts.map

package/dist/internal/content-watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-watch.d.ts","sourceRoot":"","sources":["../../src/internal/content-watch.ts"],"names":[],"mappings":"AAiBA,uGAAuG;AACvG,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAA;IACxC,QAAQ,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAA;CAC3C;AAED,0EAA0E;AAC1E,eAAO,MAAM,OAAO,aAAc,cAAc,YAAY,qBAAqB,KAAG,OAoBnF,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa,WAAY,OAAO,WAAW,OAAO,cAAc,MAAM,IAAI,KAAG,CAAC,MAAM,IAAI,CAepG,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,SAAS,YAAa,OAAO,cAAc,MAAM,IAAI,KAAG,CAAC,MAAM,IAAI,CAU7E,CAAA"}

package/dist/internal/content-watch.js

@@ -0,0 +1,76 @@
+/**
+ * Watching a container's content for size changes: its direct children on a `ResizeObserver`, each
+ * observed now and as it's added, and let go as it's removed. A deep change counts once it resizes
+ * the direct child it sits in.
+ *
+ * - `Probe.scroll` watches a container's (the page's: the body's), so its range follows its content
+ *   (#239, ADR-0043 *Amendment (#239)*).
+ * - The Projection system watches the page's, so a node that content elsewhere moved is measured again
+ *   (#261, ADR-0018 *Amendment (#261)*).
+ *
+ * The observer is shared by count: a box watched for two reasons (a scroll target that is also a
+ * child, a layout node that is also a page box) stays watched until both let go.
+ */
+import * as Arr from "effect/Array";
+import { constVoid } from "effect/Function";
+import * as Option from "effect/Option";
+/** {@link Watched} over `observer`, every box observed with `options`. */
+export const counted = (observer, options) => {
+    const counts = new Map();
+    const countOf = (box) => Option.getOrElse(Option.fromUndefinedOr(counts.get(box)), () => 0);
+    return {
+        observe: (box) => {
+            const count = countOf(box);
+            counts.set(box, count + 1);
+            if (count === 0)
+                observer.observe(box, options);
+        },
+        unobserve: (box) => {
+            const count = countOf(box);
+            if (count === 0)
+                return;
+            if (count > 1) {
+                counts.set(box, count - 1);
+                return;
+            }
+            counts.delete(box);
+            observer.unobserve(box);
+        },
+    };
+};
+/**
+ * Watch `parent`'s direct children on `watched`, kept current by a `MutationObserver` on its child list.
+ * `onChildren` runs after each change to the list, its children watched by then. Returns the stop; the
+ * observer's own disconnect lets go of the boxes.
+ */
+export const watchChildren = (parent, watched, onChildren) => {
+    Arr.forEach(Array.from(parent.children), watched.observe);
+    const children = new MutationObserver((records) => {
+        Arr.forEach(records, (record) => {
+            Arr.forEach(Array.from(record.addedNodes), (node) => {
+                if (node instanceof Element)
+                    watched.observe(node);
+            });
+            Arr.forEach(Array.from(record.removedNodes), (node) => {
+                if (node instanceof Element)
+                    watched.unobserve(node);
+            });
+        });
+        onChildren();
+    });
+    children.observe(parent, { childList: true });
+    return () => children.disconnect();
+};
+/**
+ * Watch the page's content on `watched`: the body and its direct children (a body sized to the window
+ * doesn't grow with what overflows it), as {@link watchChildren} watches a container's. None with no
+ * body (a server, a document not parsed that far). Returns the stop.
+ */
+export const watchPage = (watched, onChildren) => Option.match(Option.flatMap(Option.fromUndefinedOr(globalThis.document), (page) => Option.fromNullOr(page.body)), {
+    onNone: () => constVoid,
+    onSome: (body) => {
+        watched.observe(body);
+        return watchChildren(body, watched, onChildren);
+    },
+});
+//# sourceMappingURL=content-watch.js.map