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

package/dist/internal/own-values.d.ts

@@ -0,0 +1,35 @@
+import * as Option from "effect/Option";
+/** An element's own value for a key: the raw value read, a string, a transform key's identity, or `None`. */
+export type OwnValue = (key: string) => Option.Option<number | string>;
+/**
+ * A reader of `element`'s own values, each read once, the first time it's needed, and kept, a miss too,
+ * so a later CSS change doesn't move it, as Motion's. For each key:
+ * 1. a transform key: its identity, with no read;
+ * 2. on an SVG element inside an `<svg>`, a key it takes as an attribute: that attribute, if it has one;
+ * 3. else its computed style, a custom property by its own name.
+ *
+ * Making a reader reads nothing, and a read from an element not in the document isn't kept. Values read
+ * are raw strings: `valueLike` reads one in a target's shape.
+ */
+export declare const ownValues: (element: Element) => OwnValue;
+/**
+ * The app's `style` value for `key`: from an object style by the key, then by the key dash-cased; from a
+ * CSS-text style, parsed as `Style.over` parses it. `undefined`, `null` and an empty string are `None`. A
+ * transform key, `x`, `scale`, `rotate`, is Wardic's, as Motion's is: a binding draws it into `transform`.
+ * The value is as given, so a binding reads a live value, an Atom or an accessor, itself.
+ *
+ * @example
+ * OwnValues.styleValueOf({ opacity: 0.5 }, "opacity") // Some(0.5)
+ */
+export declare const styleValueOf: (style: object | string | undefined, key: string) => Option.Option<unknown>;
+/**
+ * `raw` in the shape of a key's target `like`, or `None` when it can't be:
+ * - **A number target** takes a finite number, or a plain number or a `px` string, parsed (`"0.5"` is
+ *   0.5, `"120px"` 120). Anything else misses, `auto`, `50%`, `1em`, a colour, so the key starts at its
+ *   target. On a key that places or sizes the box, a miss of another type, `auto` or `50%`, is a Measured
+ *   pair instead: both ends are measured in px, as Motion's are.
+ * - **A string target** takes a string as it is, or a finite number as a string, but not a length in a
+ *   unit other than the target's (`"120px"` for `"0%"`), which can't blend with it.
+ */
+export declare const valueLike: (raw: unknown, like: number | string) => Option.Option<number | string>;
+//# sourceMappingURL=own-values.d.ts.map

package/dist/internal/own-values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"own-values.d.ts","sourceRoot":"","sources":["../../src/internal/own-values.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAMvC,6GAA6G;AAC7G,MAAM,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,CAAA;AAEtE;;;;;;;;;GASG;AAGH,eAAO,MAAM,SAAS,YAAa,OAAO,KAAG,QA4B5C,CAAA;AAKD;;;;;;;;GAQG;AAEH,eAAO,MAAM,YAAY,UAAW,MAAM,GAAG,MAAM,GAAG,SAAS,OAAO,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAgBjG,CAAA;AAuBH;;;;;;;;GAQG;AAGH,eAAO,MAAM,SAAS,QAAS,OAAO,QAAQ,MAAM,GAAG,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,CAA+B,CAAA"}

package/dist/internal/own-values.js

@@ -0,0 +1,117 @@
+/**
+ * Base values in the DOM (ADR-0022): an element's Own value for a key, and the `style` link's
+ * lookup. A binding calls these and hands them to core's `BaseValue.of` / `BaseValue.start`, so a
+ * new binding writes no DOM code for them (the thin-bindings rule). Tier 2, for binding
+ * authors.
+ *
+ * Client-only: the read runs after mount, never during a server render (ADR-0021, "Nothing
+ * reads the DOM on a server"). `styleValueOf` and `valueLike` are pure.
+ *
+ * Observability: per element and cold (once per key), so quiet; the spine logs what it
+ * started from and returned to.
+ */
+import * as BaseValue from "@wardic/core/BaseValue";
+import * as Interpolator from "@wardic/core/Interpolator";
+import * as Bool from "effect/Boolean";
+import * as Match from "effect/Match";
+import * as MutableRef from "effect/MutableRef";
+import * as Option from "effect/Option";
+import * as Predicate from "effect/Predicate";
+import * as Str from "effect/String";
+import { parseCssText } from "./starting-style.js";
+import { dashCase, isSvgInner, svgAttrNameOf } from "./svg.js";
+/**
+ * A reader of `element`'s own values, each read once, the first time it's needed, and kept, a miss too,
+ * so a later CSS change doesn't move it, as Motion's. For each key:
+ * 1. a transform key: its identity, with no read;
+ * 2. on an SVG element inside an `<svg>`, a key it takes as an attribute: that attribute, if it has one;
+ * 3. else its computed style, a custom property by its own name.
+ *
+ * Making a reader reads nothing, and a read from an element not in the document isn't kept. Values read
+ * are raw strings: `valueLike` reads one in a target's shape.
+ */
+// Motion's C12. A transform key: Motion's projected branch, HTMLVisualElement.ts:51 at
+// 16c61222c4166bbef5ff6ab0051192faa79fa8c8. An attribute: ADR-0014's routing.
+export const ownValues = (element) => {
+    const cache = new Map();
+    // The element's computed style, read once, at the first key that needs it.
+    const computed = MutableRef.make(Option.none());
+    const computedStyle = () => Option.getOrElse(MutableRef.get(computed), () => {
+        const style = getComputedStyle(element);
+        MutableRef.set(computed, Option.some(style));
+        return style;
+    });
+    // On an svg-inner element, the attribute the key is written as, if it has one.
+    const attributeOf = (key) => Bool.match(isSvgInner(element), {
+        onTrue: () => Option.flatMap(svgAttrNameOf(key), (name) => nonEmpty(element.getAttribute(name))),
+        onFalse: () => Option.none(),
+    });
+    const read = (key) => Option.orElse(BaseValue.transformIdentity(key), () => Option.orElse(attributeOf(key), () => nonEmpty(computedStyle().getPropertyValue(dashCase(key)).trim())));
+    return (key) => Option.getOrElse(Option.fromUndefinedOr(cache.get(key)), () => {
+        const value = read(key);
+        // An element not in the document has an empty computed style: that miss isn't the
+        // element's, so it isn't kept, and the key is read again once the element is in.
+        if (element.isConnected)
+            cache.set(key, value);
+        return value;
+    });
+};
+/** A read string, `None` when there's none or it's empty. */
+const nonEmpty = (value) => Option.filter(Option.fromNullOr(value), Str.isNonEmpty);
+/**
+ * The app's `style` value for `key`: from an object style by the key, then by the key dash-cased; from a
+ * CSS-text style, parsed as `Style.over` parses it. `undefined`, `null` and an empty string are `None`. A
+ * transform key, `x`, `scale`, `rotate`, is Wardic's, as Motion's is: a binding draws it into `transform`.
+ * The value is as given, so a binding reads a live value, an Atom or an accessor, itself.
+ *
+ * @example
+ * OwnValues.styleValueOf({ opacity: 0.5 }, "opacity") // Some(0.5)
+ */
+// The `style` link of a Base value. #130, ADR-0043 decision 4: through the flush gate.
+export const styleValueOf = (style, key) => Option.flatMap(Option.fromNullishOr(style), (given) => {
+    const map = recordOf(given);
+    // A value at `k`: `undefined`, `null` and an empty string are misses.
+    const at = (k) => Option.filter(Option.flatMap(Option.liftPredicate(k, (name) => Object.hasOwn(map, name)), (name) => Option.fromNullishOr(map[name])), (value) => value !== "");
+    // A custom property by its own name only; any other key then dash-cased.
+    return Option.orElse(at(key), () => Option.flatMap(Option.liftPredicate(dashCase(key), (dashed) => Bool.not(key.startsWith("--")) && dashed !== key), at));
+});
+/** The last CSS text parsed, and its record. */
+// Module state (#460, Q7): a one-entry cache keyed by the text it parsed, read only: a Retarget asks
+// for each of a style's keys in a row, and parsed the whole text again for each (#618, F6).
+let last = { text: "", record: {} };
+/** `text` parsed, once for as long as it's the text asked for. */
+const parsedOnce = (text) => {
+    if (text === last.text)
+        return last.record;
+    last = { text, record: parseCssText(text) };
+    return last.record;
+};
+/** A style given as CSS text, parsed; a record as it is. */
+const recordOf = Match.type().pipe(Match.when(Predicate.isString, parsedOnce), Match.orElse((record) => record));
+/** A plain number, or a number in `px`. */
+const NUMERIC = /^\s*-?(\d+\.?\d*|\.\d+)(e[+-]?\d+)?(px)?\s*$/i;
+/**
+ * `raw` in the shape of a key's target `like`, or `None` when it can't be:
+ * - **A number target** takes a finite number, or a plain number or a `px` string, parsed (`"0.5"` is
+ *   0.5, `"120px"` 120). Anything else misses, `auto`, `50%`, `1em`, a colour, so the key starts at its
+ *   target. On a key that places or sizes the box, a miss of another type, `auto` or `50%`, is a Measured
+ *   pair instead: both ends are measured in px, as Motion's are.
+ * - **A string target** takes a string as it is, or a finite number as a string, but not a length in a
+ *   unit other than the target's (`"120px"` for `"0%"`), which can't blend with it.
+ */
+// A **Measured pair** (#430, `measured-pairs.ts`): its binding keeps the start. The unit interpolator dies
+// on a pair of two units, so it misses, as a numeric target misses `50%`.
+export const valueLike = (raw, like) => valueLikeOf({ raw, like });
+// The matchers are built once, at module load, not per call: a start reads every key's (#69).
+/** A plain number, or a number in `px`, as a numeric target takes it. */
+const isNumericString = (raw) => Predicate.isString(raw) && NUMERIC.test(raw);
+/** `raw` for a numeric target: a finite number, or a plain-number or `px` string, parsed. */
+const numericLike = Match.type().pipe(Match.when(Match.number, (n) => Option.liftPredicate(n, Number.isFinite)), Match.when(isNumericString, (s) => Option.some(Number.parseFloat(s))), Match.orElse(() => Option.none()));
+/** `raw` for a string target `like`: a string as is unless its unit clashes with the target's, or a finite number as a string. */
+const stringLike = Match.type().pipe(Match.when({ raw: Match.string }, ({ raw, like }) => Option.liftPredicate(raw, (given) => Bool.not(unitsClash(like, given)))), Match.when({ raw: Match.number }, ({ raw }) => Option.map(Option.liftPredicate(raw, Number.isFinite), String)), Match.orElse(() => Option.none()));
+const valueLikeOf = Match.type().pipe(Match.when({ like: Match.number }, ({ raw }) => numericLike(raw)), 
+// The rest have a string target.
+Match.orElse((pair) => stringLike(pair)));
+/** Whether `raw` is a length in another unit than `like`'s (both have a unit, and they differ). */
+const unitsClash = (like, raw) => Option.exists(Interpolator.unitOf(like), (want) => want !== "" && Option.exists(Interpolator.unitOf(raw), (got) => got !== "" && got !== want));
+//# sourceMappingURL=own-values.js.map

package/dist/internal/own-values.js.map

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

package/dist/internal/pass-ends.d.ts

@@ -0,0 +1,21 @@
+/**
+ * One Projection system's Measure-pass ends, for the Reorder controller (ADR-0020): the engine's Layer
+ * provides it beside the engine, and `ReorderController.make` requires it. Not exported from
+ * `@wardic/dom`, so there's no public push hook (ADR-0020 decision 2).
+ *
+ * @internal
+ */
+import * as Context from "effect/Context";
+declare const PassEnds_base: Context.ServiceClass<PassEnds, "@wardic/dom/PassEnds", {
+    /**
+     * Run `listener` at the end of every Measure pass: once per pass, after every round's boxes are
+     * stored (a blocked pass and one whose flush triggered more rounds included). A listener that
+     * throws is logged and doesn't stop the pass or the others.
+     */
+    readonly onPassEnd: (listener: () => void) => () => void;
+}>;
+/** `onPassEnd(listener)` runs `listener` at the end of every Measure pass, and returns the unsubscribe. */
+export declare class PassEnds extends PassEnds_base {
+}
+export {};
+//# sourceMappingURL=pass-ends.d.ts.map

package/dist/internal/pass-ends.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pass-ends.d.ts","sourceRoot":"","sources":["../../src/internal/pass-ends.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;;IAMrC;;;;OAIG;wBACiB,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI;;AAT5D,2GAA2G;AAC3G,qBAAa,QAAS,SAAQ,aAUH;CAAG"}

package/dist/internal/pass-ends.js

@@ -0,0 +1,14 @@
+/**
+ * One Projection system's Measure-pass ends, for the Reorder controller (ADR-0020): the engine's Layer
+ * provides it beside the engine, and `ReorderController.make` requires it. Not exported from
+ * `@wardic/dom`, so there's no public push hook (ADR-0020 decision 2).
+ *
+ * @internal
+ */
+// #618 (decision 12): the controller found the engine's listeners in a WeakMap keyed by the engine
+// object, so a wrapped or replaced ProjectionSystem in the context silently heard no pass end.
+import * as Context from "effect/Context";
+/** `onPassEnd(listener)` runs `listener` at the end of every Measure pass, and returns the unsubscribe. */
+export class PassEnds extends Context.Service()("@wardic/dom/PassEnds") {
+}
+//# sourceMappingURL=pass-ends.js.map

package/dist/internal/pass-ends.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pass-ends.js","sourceRoot":"","sources":["../../src/internal/pass-ends.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,mGAAmG;AACnG,+FAA+F;AAC/F,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AAEzC,2GAA2G;AAC3G,MAAM,OAAO,QAAS,SAAQ,OAAO,CAAC,OAAO,EAU1C,CAAC,sBAAsB,CAAC;CAAG"}

package/dist/internal/positional-keys.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The DOM Environment's Positional keys (CONTEXT.md; ADR-0029, ADR-0036): the transforms, and the
+ * box's position and size as CSS names them, `width`, `height`, `top`, `left`, `right` and `bottom`
+ * (Motion's `positionalKeys`). Reduced motion Snaps these. Core names only the transforms; these
+ * box keys are CSS's, so they're the DOM's. `DomLive` provides the Layer.
+ *
+ * @module
+ */
+import * as ReducedMotion from "@wardic/core/ReducedMotion";
+import * as Layer from "effect/Layer";
+import * as Predicate from "effect/Predicate";
+/** Whether reduced motion lands `key` at once: a transform, or a key that places or sizes the box. */
+export declare const isPositional: Predicate.Predicate<string>;
+/** The DOM Environment's `ReducedMotion.PositionalKeys`. */
+export declare const PositionalKeysDomLive: Layer.Layer<ReducedMotion.PositionalKeys>;
+//# sourceMappingURL=positional-keys.d.ts.map

package/dist/internal/positional-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"positional-keys.d.ts","sourceRoot":"","sources":["../../src/internal/positional-keys.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,aAAa,MAAM,4BAA4B,CAAA;AAC3D,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,SAAS,MAAM,kBAAkB,CAAA;AAS7C,sGAAsG;AACtG,eAAO,MAAM,YAAY,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,CAAqD,CAAA;AAE1G,4DAA4D;AAC5D,eAAO,MAAM,qBAAqB,EAAE,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC,cAAc,CAAiE,CAAA"}

package/dist/internal/positional-keys.js

@@ -0,0 +1,21 @@
+/**
+ * The DOM Environment's Positional keys (CONTEXT.md; ADR-0029, ADR-0036): the transforms, and the
+ * box's position and size as CSS names them, `width`, `height`, `top`, `left`, `right` and `bottom`
+ * (Motion's `positionalKeys`). Reduced motion Snaps these. Core names only the transforms; these
+ * box keys are CSS's, so they're the DOM's. `DomLive` provides the Layer.
+ *
+ * @module
+ */
+import * as ReducedMotion from "@wardic/core/ReducedMotion";
+import * as Layer from "effect/Layer";
+import * as Predicate from "effect/Predicate";
+import { dashCase } from "./svg.js";
+/** The box's position and size, as CSS properties. */
+const BOX_KEYS = new Set(["width", "height", "top", "left", "right", "bottom"]);
+/** A key of the box's position or size, written as a CSS name or in camelCase. */
+const isBoxKey = (key) => BOX_KEYS.has(dashCase(key));
+/** Whether reduced motion lands `key` at once: a transform, or a key that places or sizes the box. */
+export const isPositional = Predicate.or(ReducedMotion.isTransform, isBoxKey);
+/** The DOM Environment's `ReducedMotion.PositionalKeys`. */
+export const PositionalKeysDomLive = Layer.succeed(ReducedMotion.PositionalKeys, { isPositional });
+//# sourceMappingURL=positional-keys.js.map

package/dist/internal/positional-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"positional-keys.js","sourceRoot":"","sources":["../../src/internal/positional-keys.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,aAAa,MAAM,4BAA4B,CAAA;AAC3D,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,SAAS,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAEnC,sDAAsD;AACtD,MAAM,QAAQ,GAAwB,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAA;AAEpG,kFAAkF;AAClF,MAAM,QAAQ,GAAgC,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAA;AAElF,sGAAsG;AACtG,MAAM,CAAC,MAAM,YAAY,GAAgC,SAAS,CAAC,EAAE,CAAC,aAAa,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAA;AAE1G,4DAA4D;AAC5D,MAAM,CAAC,MAAM,qBAAqB,GAA8C,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,cAAc,EAAE,EAAE,YAAY,EAAE,CAAC,CAAA"}

package/dist/internal/probe.d.ts

@@ -0,0 +1,10 @@
+import * as Probe from "@wardic/core/Probe";
+import * as Layer from "effect/Layer";
+import { AtomRegistry } from "effect/reactivity";
+/**
+ * Core's `Probe` on the DOM. It needs the Environment's `AtomRegistry`, which it writes the viewport's
+ * size, the reduced-motion preference and whether the page is shown through, and readers read them from;
+ * `DomLive` provides it. Building it on a server fails, with an error that says it's client-only.
+ */
+export declare const ProbeDomLive: Layer.Layer<Probe.Probe, never, AtomRegistry.AtomRegistry>;
+//# sourceMappingURL=probe.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"probe.d.ts","sourceRoot":"","sources":["../../src/internal/probe.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,KAAK,MAAM,oBAAoB,CAAA;AAK3C,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AAMrC,OAAO,EAAQ,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAgItD;;;;GAIG;AAIH,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC,YAAY,CAE7E,CAAA"}

package/dist/internal/probe.js

@@ -0,0 +1,117 @@
+import * as Probe from "@wardic/core/Probe";
+import * as SharedSource from "@wardic/core/SharedSource";
+import * as Arr from "effect/Array";
+import * as Bool from "effect/Boolean";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Predicate from "effect/Predicate";
+import * as Queue from "effect/Queue";
+import * as Stream from "effect/Stream";
+import * as UndefinedOr from "effect/UndefinedOr";
+import { Atom, AtomRegistry } from "effect/reactivity";
+import { requireGlobal } from "./require-global.js";
+import { makeScroll } from "./scroll.js";
+/** Map a `DOMRect`-like value onto the engine's portable {@link Bounds}. */
+/** An `IntersectionObserver`'s init from the Probe's options: each left out when not given. */
+const observerInit = (options) => ({
+    ...UndefinedOr.match(options.root, { onUndefined: () => ({}), onDefined: (root) => ({ root }) }),
+    ...UndefinedOr.match(options.margin, { onUndefined: () => ({}), onDefined: (rootMargin) => ({ rootMargin }) }),
+    ...UndefinedOr.match(options.amount, { onUndefined: () => ({}), onDefined: (threshold) => ({ threshold }) }),
+});
+const toBounds = (r) => ({
+    x: r.x,
+    y: r.y,
+    width: r.width,
+    height: r.height,
+    top: r.top,
+    right: r.right,
+    bottom: r.bottom,
+    left: r.left,
+});
+/**
+ * Captures the Environment's {@link AtomRegistry} and adds the window's `resize` listener and
+ * the media query's `change` listener in the layer scope; each is the sole writer of its Atom.
+ * The `resize` listener writes `viewport` inside the event (ADR-0018, *Amendment (#45)*).
+ * `Layer.effect` runs `make` in the layer's own scope (it `Exclude`s `Scope`),
+ * which the shared helpers' `RcMap`s and the forked listeners need.
+ */
+const make = Effect.gen(function* () {
+    // Client-only (ADR-0021, decision 7): the viewport below reads `window`.
+    yield* requireGlobal("DomProbe.layer", "window");
+    // The shared Environment registry — the one consumers read these atoms from.
+    const registry = yield* AtomRegistry.AtomRegistry;
+    // --- viewport -----------------------------------------------------------
+    // `keepAlive` pins the node so the value the resize listener writes survives
+    // between reads (an idle node with no subscriber would be GC'd and re-init).
+    const viewport = Atom.keepAlive(Atom.make({ width: window.innerWidth, height: window.innerHeight }));
+    // The window's "resize" listener is the only writer of `viewport`, and it writes inside the
+    // event (ADR-0018, *Amendment (#45)*): a reader, the projection system's Resize block among
+    // them, sees the new size within the dispatch, not a scheduler hop later, before the frame's
+    // Measure pass. A forked Stream consumer would land a task after the event.
+    const writeViewport = () => registry.set(viewport, { width: window.innerWidth, height: window.innerHeight });
+    yield* Effect.acquireRelease(Effect.sync(() => window.addEventListener("resize", writeViewport)), () => Effect.sync(() => window.removeEventListener("resize", writeViewport)));
+    // --- prefersReducedMotion ----------------------------------------------
+    // Guard `matchMedia` (absent in some headless environments): default false.
+    const mql = Bool.match(Predicate.isFunction(window.matchMedia), {
+        onTrue: () => Option.some(window.matchMedia("(prefers-reduced-motion: reduce)")),
+        onFalse: () => Option.none(),
+    });
+    const prefersReducedMotion = Atom.keepAlive(Atom.make(Option.exists(mql, (query) => query.matches)));
+    if (Option.isSome(mql)) {
+        // The MediaQueryList's `change` listener is the Atom's only writer, and it writes inside the
+        // event, as `viewport`'s and `pageVisible`'s do: a reader sees the new preference before the next
+        // frame (#618, M8: a fiber over `Stream.fromEventListener` set it a task later).
+        const query = mql.value;
+        const writeReduced = (event) => registry.set(prefersReducedMotion, event.matches);
+        yield* Effect.acquireRelease(Effect.sync(() => query.addEventListener("change", writeReduced)), () => Effect.sync(() => query.removeEventListener("change", writeReduced)));
+    }
+    // --- pageVisible (#443) ---------------------------------------------------
+    // The document's `visibilitychange` listener is its only writer, and it writes inside the event,
+    // as `viewport`'s does: a reader sees the page hidden before the next frame.
+    const pageVisible = Atom.keepAlive(Atom.make(document.visibilityState !== "hidden"));
+    const writePageVisible = () => registry.set(pageVisible, document.visibilityState !== "hidden");
+    yield* Effect.acquireRelease(Effect.sync(() => document.addEventListener("visibilitychange", writePageVisible)), () => Effect.sync(() => document.removeEventListener("visibilitychange", writePageVisible)));
+    // --- observeResize ------------------------------------------------------
+    // One ResizeObserver per target, ref-counted via `SharedSource.byTarget`. The
+    // observer is constructed on the first subscriber; `Effect.addFinalizer`
+    // disconnects it when the last subscriber's scope closes.
+    const observeResize = yield* SharedSource.byTarget((target) => Effect.succeed(Stream.callback((queue) => Effect.gen(function* () {
+        const el = target;
+        const ro = new ResizeObserver(() => {
+            Queue.offerUnsafe(queue, toBounds(el.getBoundingClientRect()));
+        });
+        ro.observe(el);
+        yield* Effect.addFinalizer(() => Effect.sync(() => ro.disconnect()));
+    }))));
+    // --- observeIntersection ------------------------------------------------
+    // An Input feed (#318) with one IntersectionObserver per subscriber, against its options (#273,
+    // Motion's `viewport`): the root (the viewport when none), the margin (`rootMargin`) and the amount
+    // (`threshold`). Each report carries the entry.
+    const observeIntersection = (target, options = {}) => (emit) => {
+        const io = new IntersectionObserver((entries) => Arr.forEach(entries, (entry) => emit({ intersecting: entry.isIntersecting, raw: entry })), observerInit(options));
+        io.observe(target);
+        return () => io.disconnect();
+    };
+    return Probe.Probe.of({
+        // Hot path — intentionally unlogged/un-spanned.
+        measure: (target) => Effect.sync(() => toBounds(target.getBoundingClientRect())),
+        viewport,
+        prefersReducedMotion,
+        pageVisible,
+        // A container's scroll, set within its events (#234): `scroll.ts`.
+        scroll: yield* makeScroll(registry),
+        observeResize,
+        observeIntersection,
+    });
+});
+/**
+ * Core's `Probe` on the DOM. It needs the Environment's `AtomRegistry`, which it writes the viewport's
+ * size, the reduced-motion preference and whether the page is shown through, and readers read them from;
+ * `DomLive` provides it. Building it on a server fails, with an error that says it's client-only.
+ */
+// Built with `Layer.effect`, so `make` runs in the layer's scope: the shared helpers' `RcMap`s and the
+// forked listeners live for the layer's lifetime; `testLayer` provides the registry the same way.
+// ADR-0021, decision 7.
+export const ProbeDomLive = Layer.effect(Probe.Probe)(make);
+//# sourceMappingURL=probe.js.map

package/dist/internal/probe.js.map

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

package/dist/internal/projection-defaults.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Motion's default layout and drag transitions, apart from the Projection system: a binding's layout
+ * element code reads them on every page, and the engine, `projection.ts`, ships only where an app lays
+ * out.
+ */
+import type * as Machine from "@wardic/core/Machine";
+/**
+ * A layout animation's transition: a spring, its fields and its `delay`; or a tween, its `duration`,
+ * `ease` and `delay`. A repeat means nothing for a flight that lands once. A tween with no `duration` or
+ * `ease` takes the tween's own defaults, 0.3 s and linear (a binding fills Motion's `easeOut` first).
+ */
+export type LayoutTransition = ({
+    readonly type: "spring";
+} & Machine.SpringOptions) | ({
+    readonly type: "tween";
+} & Machine.TweenOptions);
+/**
+ * Motion's default layout transition (motion-dom 13.3.0, `defaultLayoutTransition`): a 0.45 s tween,
+ * eased `cubic-bezier(0.4, 0, 0.1, 1)`, so a layout animation lands on time.
+ */
+export declare const DEFAULT_LAYOUT_TRANSITION: LayoutTransition;
+/**
+ * A drag's release (Motion's `dragTransition`): the inertia a node's Release offset runs on, with both
+ * edges at its slot, so it springs back there on the bounce. Times in seconds. Its edges are the slot's,
+ * never its own.
+ */
+export type DragTransition = Omit<Machine.InertiaOptions, "min" | "max">;
+/**
+ * Motion's drag transition (framer-motion 13.4.0, `VisualElementDragControls.startAnimation`), with its
+ * default `dragElastic`: a 0.75 s time constant, power 0.8, the bounce 200 / 40, at rest within 1 px and
+ * 10 px/s. A node's Release offset runs on it when it's given none.
+ */
+export declare const DEFAULT_DRAG_TRANSITION: DragTransition;
+//# sourceMappingURL=projection-defaults.d.ts.map

package/dist/internal/projection-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection-defaults.d.ts","sourceRoot":"","sources":["../../src/internal/projection-defaults.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,KAAK,OAAO,MAAM,sBAAsB,CAAA;AAEpD;;;;GAIG;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAAG,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;AAE1I;;;GAGG;AAEH,eAAO,MAAM,yBAAyB,EAAE,gBAA4E,CAAA;AAEpH;;;;GAIG;AAEH,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,KAAK,GAAG,KAAK,CAAC,CAAA;AAExE;;;;GAIG;AAEH,eAAO,MAAM,uBAAuB,EAAE,cAOrC,CAAA"}

package/dist/internal/projection-defaults.js

@@ -0,0 +1,21 @@
+/**
+ * Motion's default layout transition (motion-dom 13.3.0, `defaultLayoutTransition`): a 0.45 s tween,
+ * eased `cubic-bezier(0.4, 0, 0.1, 1)`, so a layout animation lands on time.
+ */
+// ADR-0009 *Amendment (#171)*.
+export const DEFAULT_LAYOUT_TRANSITION = { type: "tween", duration: 0.45, ease: [0.4, 0, 0.1, 1] };
+/**
+ * Motion's drag transition (framer-motion 13.4.0, `VisualElementDragControls.startAnimation`), with its
+ * default `dragElastic`: a 0.75 s time constant, power 0.8, the bounce 200 / 40, at rest within 1 px and
+ * 10 px/s. A node's Release offset runs on it when it's given none.
+ */
+// ADR-0016, *Amendment (#140)*.
+export const DEFAULT_DRAG_TRANSITION = {
+    power: 0.8,
+    timeConstant: 0.75,
+    bounceStiffness: 200,
+    bounceDamping: 40,
+    restDelta: 1,
+    restSpeed: 10,
+};
+//# sourceMappingURL=projection-defaults.js.map

package/dist/internal/projection-defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection-defaults.js","sourceRoot":"","sources":["../../src/internal/projection-defaults.ts"],"names":[],"mappings":"AAgBA;;;GAGG;AACH,+BAA+B;AAC/B,MAAM,CAAC,MAAM,yBAAyB,GAAqB,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAA;AAUpH;;;;GAIG;AACH,gCAAgC;AAChC,MAAM,CAAC,MAAM,uBAAuB,GAAmB;IACrD,KAAK,EAAE,GAAG;IACV,YAAY,EAAE,IAAI;IAClB,eAAe,EAAE,GAAG;IACpB,aAAa,EAAE,EAAE;IACjB,SAAS,EAAE,CAAC;IACZ,SAAS,EAAE,EAAE;CACd,CAAA"}