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

package/dist/Style.js

@@ -0,0 +1,17 @@
+/**
+ * An element's style as a binding builds it: its starting style, what it's drawn with before any
+ * animation runs, from its `initial` (or its `animate`, with `initial: false`); how an app's own style and
+ * Wardic's are layered (`over`, `without`); and a drag element's default style. A server render draws the
+ * starting style, so an element is drawn where it starts before any code runs.
+ *
+ * @example
+ * import * as Style from "@wardic/dom/Style"
+ *
+ * const start = Style.resolveInitial({ initial: { opacity: 0, y: 8 }, animate: { opacity: 1, y: 0 } })
+ * Style.starting(undefined, start) // { style: { transform: "translateY(8px)", opacity: 0 }, attrs: {} }
+ */
+// `@wardic/dom/Style` (#132, ADR-0041): the **Starting style**, the merges of an app's style with
+// Wardic's, and a drag element's defaults (ADR-0019, ADR-0021, ADR-0034).
+export { startingStyle as starting, resolveInitial, keyframesOf, splitValues, toValues, valuesAt, over, without, heldTouches, } from "./internal/starting-style.js";
+export { dragDefaultStyle as dragDefaults, DRAG_DEFAULT_ATTRIBUTES, reorderTouchAction, } from "./internal/drag-defaults.js";
+//# sourceMappingURL=Style.js.map

package/dist/Style.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Style.js","sourceRoot":"","sources":["../src/Style.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,kGAAkG;AAClG,0EAA0E;AAC1E,OAAO,EACL,aAAa,IAAI,QAAQ,EACzB,cAAc,EAEd,WAAW,EACX,WAAW,EAIX,QAAQ,EACR,QAAQ,EAGR,IAAI,EACJ,OAAO,EACP,WAAW,GACZ,MAAM,8BAA8B,CAAA;AACrC,OAAO,EACL,gBAAgB,IAAI,YAAY,EAEhC,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,6BAA6B,CAAA"}

package/dist/Svg.d.ts

@@ -0,0 +1,13 @@
+/**
+ * SVG: which elements are SVG's, and a style patch split into the CSS an SVG element takes and the
+ * attributes it takes instead. An `<svg>` root is styled as HTML is; an element inside it takes most keys
+ * as attributes, and a transform about its own centre, as an HTML element's is.
+ *
+ * @example
+ * import * as Svg from "@wardic/dom/Svg"
+ *
+ * Svg.splitPatchForTag("circle", { r: 10, opacity: 0.5, transform: "scale(2)" })
+ * // style: transform, transform-box and transform-origin; attrs: { r: "10", opacity: "0.5" }
+ */
+export { isSvgRoot as isRoot, isSvgInner as isInner, isSvgInnerTag as isInnerTag, setSvgAttrs as setAttrs, splitPatch, splitPatchForTag, type SplitPatch, } from "./internal/svg.ts";
+//# sourceMappingURL=Svg.d.ts.map

package/dist/Svg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Svg.d.ts","sourceRoot":"","sources":["../src/Svg.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,SAAS,IAAI,MAAM,EACnB,UAAU,IAAI,OAAO,EACrB,aAAa,IAAI,UAAU,EAC3B,WAAW,IAAI,QAAQ,EACvB,UAAU,EACV,gBAAgB,EAChB,KAAK,UAAU,GAChB,MAAM,mBAAmB,CAAA"}

package/dist/Svg.js

@@ -0,0 +1,14 @@
+/**
+ * SVG: which elements are SVG's, and a style patch split into the CSS an SVG element takes and the
+ * attributes it takes instead. An `<svg>` root is styled as HTML is; an element inside it takes most keys
+ * as attributes, and a transform about its own centre, as an HTML element's is.
+ *
+ * @example
+ * import * as Svg from "@wardic/dom/Svg"
+ *
+ * Svg.splitPatchForTag("circle", { r: 10, opacity: 0.5, transform: "scale(2)" })
+ * // style: transform, transform-box and transform-origin; attrs: { r: "10", opacity: "0.5" }
+ */
+// `@wardic/dom/Svg` (#132, ADR-0041): ADR-0014.
+export { isSvgRoot as isRoot, isSvgInner as isInner, isSvgInnerTag as isInnerTag, setSvgAttrs as setAttrs, splitPatch, splitPatchForTag, } from "./internal/svg.js";
+//# sourceMappingURL=Svg.js.map

package/dist/Svg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Svg.js","sourceRoot":"","sources":["../src/Svg.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,gDAAgD;AAChD,OAAO,EACL,SAAS,IAAI,MAAM,EACnB,UAAU,IAAI,OAAO,EACrB,aAAa,IAAI,UAAU,EAC3B,WAAW,IAAI,QAAQ,EACvB,UAAU,EACV,gBAAgB,GAEjB,MAAM,mBAAmB,CAAA"}

package/dist/Variables.d.ts

@@ -0,0 +1,13 @@
+/**
+ * CSS variables in animated values: a value that's wholly a `var()` is resolved against an element, so
+ * `var(--accent)` animates from or to the colour it stands for. `values` is the Key rule a binding adds
+ * for an element's own animations.
+ *
+ * @example
+ * import * as Variables from "@wardic/dom/Variables"
+ *
+ * Variables.isValue("var(--gap)") // true
+ * Variables.resolve(element, "var(--gap)") // what `--gap` computes to on `element`
+ */
+export { isVariableValue as isValue, resolveVariable as resolve, variableValues as values, } from "./internal/variables.ts";
+//# sourceMappingURL=Variables.d.ts.map

package/dist/Variables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Variables.d.ts","sourceRoot":"","sources":["../src/Variables.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,eAAe,IAAI,OAAO,EAC1B,eAAe,IAAI,OAAO,EAC1B,cAAc,IAAI,MAAM,GACzB,MAAM,yBAAyB,CAAA"}

package/dist/Variables.js

@@ -0,0 +1,14 @@
+/**
+ * CSS variables in animated values: a value that's wholly a `var()` is resolved against an element, so
+ * `var(--accent)` animates from or to the colour it stands for. `values` is the Key rule a binding adds
+ * for an element's own animations.
+ *
+ * @example
+ * import * as Variables from "@wardic/dom/Variables"
+ *
+ * Variables.isValue("var(--gap)") // true
+ * Variables.resolve(element, "var(--gap)") // what `--gap` computes to on `element`
+ */
+// `@wardic/dom/Variables` (#132, ADR-0041): #55, ADR-0035.
+export { isVariableValue as isValue, resolveVariable as resolve, variableValues as values, } from "./internal/variables.js";
+//# sourceMappingURL=Variables.js.map

package/dist/Variables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Variables.js","sourceRoot":"","sources":["../src/Variables.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,2DAA2D;AAC3D,OAAO,EACL,eAAe,IAAI,OAAO,EAC1B,eAAe,IAAI,OAAO,EAC1B,cAAc,IAAI,MAAM,GACzB,MAAM,yBAAyB,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,72 @@
+/**
+ * `@wardic/dom`: the browser Environment, and the framework-free pieces a binding builds on. It's for
+ * binding authors, Wardic's own and any other, and it's Effect-typed.
+ *
+ * - **An app** imports {@link DomLive}, the composed Environment it hands its binding, and
+ *   {@link CheckFrames}, to check its Frames in development.
+ * - **A binding** imports each module by its subpath, as a namespace
+ *   (`import * as FlushGate from "@wardic/dom/FlushGate"`), and the root re-exports each one:
+ *   - the DOM's implementations of core's services, each with its `layer` (Effect's platform
+ *     convention: `DomRenderer`, `DomInput`, `DomProbe`, `DomClock`, `DomAnnouncer`,
+ *     `DomInterpolators`, `DomPositionalKeys`, `DomDefaultTransition`), and `DomKeyRules`, the Key
+ *     rules `DomInterpolators.layer` installs, which has none of its own;
+ *   - dom's own concepts, by the glossary's names: `FlushGate`, `ProjectionSystem`,
+ *     `ReorderController`, `Style`, `Svg`, `Color`, `Variables`, `ScrollOffset`, `Appear`, `OwnValues`
+ *     and `Report`.
+ *
+ * Everything under `internal/` is dom's own and not exported.
+ */
+import type * as Clock from "@wardic/core/Clock";
+import * as FrameLoop from "@wardic/core/FrameLoop";
+import type * as InterpolatorRegistry from "@wardic/core/InterpolatorRegistry";
+import type * as Announcer from "@wardic/core/Announcer";
+import type * as DefaultTransition from "@wardic/core/DefaultTransition";
+import type * as ReducedMotion from "@wardic/core/ReducedMotion";
+import type * as Probe from "@wardic/core/Probe";
+import type * as RefreshFrameSource from "@wardic/core/RefreshFrameSource";
+import type * as Renderer from "@wardic/core/Renderer";
+import * as Layer from "effect/Layer";
+import { AtomRegistry } from "effect/reactivity";
+export declare const VERSION = "1.0.0-rc.2";
+export * as DomClock from "./DomClock.ts";
+export * as DomInput from "./DomInput.ts";
+export * as DomProbe from "./DomProbe.ts";
+export * as DomRenderer from "./DomRenderer.ts";
+export * as DomAnnouncer from "./DomAnnouncer.ts";
+export * as DomInterpolators from "./DomInterpolators.ts";
+export * as DomPositionalKeys from "./DomPositionalKeys.ts";
+export * as DomDefaultTransition from "./DomDefaultTransition.ts";
+export * as DomKeyRules from "./DomKeyRules.ts";
+export * as FlushGate from "./FlushGate.ts";
+export * as ProjectionSystem from "./ProjectionSystem.ts";
+export * as DomProjectionSystem from "./DomProjectionSystem.ts";
+export * as ReorderController from "./ReorderController.ts";
+export * as Style from "./Style.ts";
+export * as Svg from "./Svg.ts";
+export * as Color from "./Color.ts";
+export * as Variables from "./Variables.ts";
+export * as ScrollOffset from "./ScrollOffset.ts";
+export * as Appear from "./Appear.ts";
+export * as OwnValues from "./OwnValues.ts";
+export * as Report from "./Report.ts";
+/**
+ * Core's development check for Frames that aren't finite (`FrameLoop.CheckFrames`), here for an app,
+ * which installs `@wardic/dom` and not `@wardic/core`. Off by default; merged beside {@link DomLive} as
+ * `Layer.succeed(CheckFrames, true)`, it fails an animation whose Frame holds a NaN or an Infinity,
+ * naming its key and value, where the page would drop it without a word. It checks every Frame, so
+ * it's for development: see https://wardic.dev/guides/observability.
+ */
+export { CheckFrames } from "@wardic/core/FrameLoop";
+/**
+ * The browser Environment, composed: the DOM's services, core's interpolators with the DOM's Key
+ * rules, and the Frame loop over the DOM's Clock, needing nothing else. Hand it to `WardicProvider`'s
+ * `env` to run the engine on the page.
+ *
+ * It has no input: a binding's gestures build `DomInput.layer` with the first one an app uses, so an
+ * app with none ships no input code.
+ *
+ * Client-only: a server render builds no runtime, and building DomLive on a server fails with an
+ * error naming the service and the missing global: see https://wardic.dev/guides/server-rendering.
+ */
+export declare const DomLive: Layer.Layer<Clock.Clock | RefreshFrameSource.RefreshFrameSource | FrameLoop.FrameLoop | Renderer.Renderer | Probe.Probe | InterpolatorRegistry.InterpolatorRegistry | ReducedMotion.PositionalKeys | DefaultTransition.DefaultTransition | Announcer.Announcer | AtomRegistry.AtomRegistry>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,KAAK,KAAK,MAAM,oBAAoB,CAAA;AAChD,OAAO,KAAK,SAAS,MAAM,wBAAwB,CAAA;AACnD,OAAO,KAAK,KAAK,oBAAoB,MAAM,mCAAmC,CAAA;AAC9E,OAAO,KAAK,KAAK,SAAS,MAAM,wBAAwB,CAAA;AACxD,OAAO,KAAK,KAAK,iBAAiB,MAAM,gCAAgC,CAAA;AACxE,OAAO,KAAK,KAAK,aAAa,MAAM,4BAA4B,CAAA;AAChE,OAAO,KAAK,KAAK,KAAK,MAAM,oBAAoB,CAAA;AAChD,OAAO,KAAK,KAAK,kBAAkB,MAAM,iCAAiC,CAAA;AAC1E,OAAO,KAAK,KAAK,QAAQ,MAAM,uBAAuB,CAAA;AACtD,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAShD,eAAO,MAAM,OAAO,eAAe,CAAA;AAEnC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAC/C,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,gBAAgB,MAAM,uBAAuB,CAAA;AACzD,OAAO,KAAK,iBAAiB,MAAM,wBAAwB,CAAA;AAC3D,OAAO,KAAK,oBAAoB,MAAM,2BAA2B,CAAA;AACjE,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAC/C,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,gBAAgB,MAAM,uBAAuB,CAAA;AACzD,OAAO,KAAK,mBAAmB,MAAM,0BAA0B,CAAA;AAC/D,OAAO,KAAK,iBAAiB,MAAM,wBAAwB,CAAA;AAC3D,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAC/B,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAEpD;;;;;;;;;;GAUG;AAOH,eAAO,MAAM,OAAO,EAAE,KAAK,CAAC,KAAK,CAC7B,KAAK,CAAC,KAAK,GACX,kBAAkB,CAAC,kBAAkB,GACrC,SAAS,CAAC,SAAS,GACnB,QAAQ,CAAC,QAAQ,GACjB,KAAK,CAAC,KAAK,GACX,oBAAoB,CAAC,oBAAoB,GACzC,aAAa,CAAC,cAAc,GAC5B,iBAAiB,CAAC,iBAAiB,GACnC,SAAS,CAAC,SAAS,GACnB,YAAY,CAAC,YAAY,CAM5B,CAAA"}

package/dist/index.js

@@ -0,0 +1,60 @@
+import * as FrameLoop from "@wardic/core/FrameLoop";
+import * as Layer from "effect/Layer";
+import { AtomRegistry } from "effect/reactivity";
+import * as DomAnnouncer from "./DomAnnouncer.js";
+import * as DomClock from "./DomClock.js";
+import * as DomDefaultTransition from "./DomDefaultTransition.js";
+import * as DomInterpolators from "./DomInterpolators.js";
+import * as DomPositionalKeys from "./DomPositionalKeys.js";
+import * as DomProbe from "./DomProbe.js";
+import * as DomRenderer from "./DomRenderer.js";
+export const VERSION = "1.0.0-rc.2";
+export * as DomClock from "./DomClock.js";
+export * as DomInput from "./DomInput.js";
+export * as DomProbe from "./DomProbe.js";
+export * as DomRenderer from "./DomRenderer.js";
+export * as DomAnnouncer from "./DomAnnouncer.js";
+export * as DomInterpolators from "./DomInterpolators.js";
+export * as DomPositionalKeys from "./DomPositionalKeys.js";
+export * as DomDefaultTransition from "./DomDefaultTransition.js";
+export * as DomKeyRules from "./DomKeyRules.js";
+export * as FlushGate from "./FlushGate.js";
+export * as ProjectionSystem from "./ProjectionSystem.js";
+export * as DomProjectionSystem from "./DomProjectionSystem.js";
+export * as ReorderController from "./ReorderController.js";
+export * as Style from "./Style.js";
+export * as Svg from "./Svg.js";
+export * as Color from "./Color.js";
+export * as Variables from "./Variables.js";
+export * as ScrollOffset from "./ScrollOffset.js";
+export * as Appear from "./Appear.js";
+export * as OwnValues from "./OwnValues.js";
+export * as Report from "./Report.js";
+/**
+ * Core's development check for Frames that aren't finite (`FrameLoop.CheckFrames`), here for an app,
+ * which installs `@wardic/dom` and not `@wardic/core`. Off by default; merged beside {@link DomLive} as
+ * `Layer.succeed(CheckFrames, true)`, it fails an animation whose Frame holds a NaN or an Infinity,
+ * naming its key and value, where the page would drop it without a word. It checks every Frame, so
+ * it's for development: see https://wardic.dev/guides/observability.
+ */
+// ADR-0030 decision 7; re-exported here for an app (#586).
+export { CheckFrames } from "@wardic/core/FrameLoop";
+/**
+ * The browser Environment, composed: the DOM's services, core's interpolators with the DOM's Key
+ * rules, and the Frame loop over the DOM's Clock, needing nothing else. Hand it to `WardicProvider`'s
+ * `env` to run the engine on the page.
+ *
+ * It has no input: a binding's gestures build `DomInput.layer` with the first one an app uses, so an
+ * app with none ships no input code.
+ *
+ * Client-only: a server render builds no runtime, and building DomLive on a server fails with an
+ * error naming the service and the missing global: see https://wardic.dev/guides/server-rendering.
+ */
+// Key rules: ADR-0035. Frame loop: ADR-0027. `DomClock.layer` also provides the `RefreshFrameSource`
+// the flush gate requests its flushes from (ADR-0031). `DomProbe.layer` writes the `viewport` and
+// `prefersReducedMotion` Atoms through the Environment's `AtomRegistry`, and consumers read them
+// through the same registry, so `AtomRegistry` is provided to the Layers with `Layer.provideMerge` and
+// kept in the output, as the headless `testLayer` (packages/test) does: R = never. No InputSource:
+// #511, ADR-0067 decision 14. Client-only: ADR-0021, decision 7.
+export const DomLive = FrameLoop.layer.pipe(Layer.provideMerge(Layer.mergeAll(DomClock.layer, DomRenderer.layer, DomProbe.layer, DomInterpolators.layer, DomPositionalKeys.layer, DomDefaultTransition.layer, DomAnnouncer.layer)), Layer.provideMerge(AtomRegistry.layer));
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,SAAS,MAAM,wBAAwB,CAAA;AAQnD,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,oBAAoB,MAAM,2BAA2B,CAAA;AACjE,OAAO,KAAK,gBAAgB,MAAM,uBAAuB,CAAA;AACzD,OAAO,KAAK,iBAAiB,MAAM,wBAAwB,CAAA;AAC3D,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAE/C,MAAM,CAAC,MAAM,OAAO,GAAG,YAAY,CAAA;AAEnC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAC/C,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,gBAAgB,MAAM,uBAAuB,CAAA;AACzD,OAAO,KAAK,iBAAiB,MAAM,wBAAwB,CAAA;AAC3D,OAAO,KAAK,oBAAoB,MAAM,2BAA2B,CAAA;AACjE,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAC/C,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,gBAAgB,MAAM,uBAAuB,CAAA;AACzD,OAAO,KAAK,mBAAmB,MAAM,0BAA0B,CAAA;AAC/D,OAAO,KAAK,iBAAiB,MAAM,wBAAwB,CAAA;AAC3D,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAC/B,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC;;;;;;GAMG;AACH,2DAA2D;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAEpD;;;;;;;;;;GAUG;AACH,qGAAqG;AACrG,kGAAkG;AAClG,iGAAiG;AACjG,uGAAuG;AACvG,mGAAmG;AACnG,iEAAiE;AACjE,MAAM,CAAC,MAAM,OAAO,GAWhB,SAAS,CAAC,KAAK,CAAC,IAAI,CACtB,KAAK,CAAC,YAAY,CAChB,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,CAAC,KAAK,EAAE,oBAAoB,CAAC,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,CACnK,EACD,KAAK,CAAC,YAAY,CAAC,YAAY,CAAC,KAAK,CAAC,CACvC,CAAA"}

package/dist/internal/announcer.d.ts

@@ -0,0 +1,50 @@
+/**
+ * The DOM's **Announcement** channel (ADR-0037): `AnnouncerDomLive`, core's `Announcer.Announcer` as
+ * one visually hidden live region per document, `aria-live="assertive"` and `aria-atomic`, shared by
+ * every Reorder group on the page. Assertive, because each announcement answers a key just pressed;
+ * the caller thins a held arrow's repeats to the last. Each announcement replaces the last, and one
+ * that repeats the last (an arrow at an end re-announcing the position) gets a trailing no-break
+ * space, so a screen reader sees a change and speaks it again.
+ *
+ * A screen reader watches a live region from when it's in the page, so the region has to be there
+ * before the first announcement: {@link prepareAnnouncer} adds it (a Reorder group's controller calls
+ * it when its element attaches), and an announcement adds it too if nothing did.
+ *
+ * {@link instructionsId} gives the id of a hidden element holding a group's instructions, one per
+ * distinct text per document, for its items' `aria-describedby`. {@link instructionsIdOf} gives the
+ * id alone, and {@link showInstructions} adds its element.
+ *
+ * Client-only (ADR-0021, decision 7): building the layer on a server fails with the client-only error.
+ *
+ * Tier 2 (ADR-0008): for DOM binding authors.
+ */
+import * as Announcer from "@wardic/core/Announcer";
+import * as Layer from "effect/Layer";
+/** The attribute that marks the live region, for a test or a stylesheet to find it. */
+export declare const ANNOUNCER_ATTRIBUTE = "data-wardic-announcer";
+/**
+ * The live document `node` is in: its own when that has a window, else the page's. A Solid ref
+ * runs while a new element still belongs to its template's inert document (no window, no body),
+ * before it's inserted.
+ */
+export declare const documentOf: (node: Node) => Document;
+/** Adds `doc`'s live region now, before its first announcement, so a screen reader is already watching it. */
+export declare const prepareAnnouncer: (doc: Document) => void;
+/**
+ * Speaks `message` in `doc`'s live region, replacing the last. A repeat of the last gets a trailing
+ * no-break space, so it's read out again.
+ */
+export declare const announceIn: (doc: Document, message: string) => void;
+/**
+ * The id of `doc`'s hidden element holding `text`, one per distinct text, for the `aria-describedby` of
+ * every item that shows it. Given here, with no element added: a binding works it out as it renders, and
+ * adds the element with `showInstructions` in an effect.
+ */
+export declare const instructionsIdOf: (doc: Document, text: string) => string;
+/** Adds `doc`'s hidden element holding `text`, under `instructionsIdOf`'s id, unless it's there already. */
+export declare const showInstructions: (doc: Document, text: string) => void;
+/** `instructionsIdOf`, with its element added now: added again if it was removed. */
+export declare const instructionsId: (doc: Document, text: string) => string;
+/** Core's `Announcer`, speaking in the page's `document`'s live region. */
+export declare const AnnouncerDomLive: Layer.Layer<Announcer.Announcer>;
+//# sourceMappingURL=announcer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"announcer.d.ts","sourceRoot":"","sources":["../../src/internal/announcer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,SAAS,MAAM,wBAAwB,CAAA;AAGnD,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AAKrC,uFAAuF;AACvF,eAAO,MAAM,mBAAmB,0BAA0B,CAAA;AA6B1D;;;;GAIG;AACH,eAAO,MAAM,UAAU,SAAU,IAAI,KAAG,QAIvC,CAAA;AAED,8GAA8G;AAC9G,eAAO,MAAM,gBAAgB,QAAS,QAAQ,KAAG,IAEhD,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,UAAU,QAAS,QAAQ,WAAW,MAAM,KAAG,IAG3D,CAAA;AAQD;;;;GAIG;AAEH,eAAO,MAAM,gBAAgB,QAAS,QAAQ,QAAQ,MAAM,KAAG,MAW9D,CAAA;AAED,4GAA4G;AAC5G,eAAO,MAAM,gBAAgB,QAAS,QAAQ,QAAQ,MAAM,KAAG,IAQ9D,CAAA;AAED,qFAAqF;AACrF,eAAO,MAAM,cAAc,QAAS,QAAQ,QAAQ,MAAM,KAAG,MAG5D,CAAA;AAED,2EAA2E;AAC3E,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,SAAS,CAK7D,CAAA"}

package/dist/internal/announcer.js

@@ -0,0 +1,115 @@
+/**
+ * The DOM's **Announcement** channel (ADR-0037): `AnnouncerDomLive`, core's `Announcer.Announcer` as
+ * one visually hidden live region per document, `aria-live="assertive"` and `aria-atomic`, shared by
+ * every Reorder group on the page. Assertive, because each announcement answers a key just pressed;
+ * the caller thins a held arrow's repeats to the last. Each announcement replaces the last, and one
+ * that repeats the last (an arrow at an end re-announcing the position) gets a trailing no-break
+ * space, so a screen reader sees a change and speaks it again.
+ *
+ * A screen reader watches a live region from when it's in the page, so the region has to be there
+ * before the first announcement: {@link prepareAnnouncer} adds it (a Reorder group's controller calls
+ * it when its element attaches), and an announcement adds it too if nothing did.
+ *
+ * {@link instructionsId} gives the id of a hidden element holding a group's instructions, one per
+ * distinct text per document, for its items' `aria-describedby`. {@link instructionsIdOf} gives the
+ * id alone, and {@link showInstructions} adds its element.
+ *
+ * Client-only (ADR-0021, decision 7): building the layer on a server fails with the client-only error.
+ *
+ * Tier 2 (ADR-0008): for DOM binding authors.
+ */
+import * as Announcer from "@wardic/core/Announcer";
+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 { requireGlobal } from "./require-global.js";
+/** The attribute that marks the live region, for a test or a stylesheet to find it. */
+export const ANNOUNCER_ATTRIBUTE = "data-wardic-announcer";
+/** Hidden from sight, not from assistive technology: the usual visually hidden rule. */
+const VISUALLY_HIDDEN = "position:absolute;width:1px;height:1px;margin:-1px;padding:0;border:0;overflow:hidden;clip:rect(0 0 0 0);clip-path:inset(50%);white-space:nowrap";
+/** Each document's live region, once added. */
+// Module state (#460, Q7): each document's live region, held weakly by the document.
+const regions = new WeakMap();
+/** `doc`'s live region, added to its body when it has none. */
+const regionOf = (doc) => Option.getOrElse(Option.filter(Option.fromUndefinedOr(regions.get(doc)), (region) => region.isConnected), () => addRegion(doc));
+/** Add `doc`'s live region to its body. */
+const addRegion = (doc) => {
+    const region = doc.createElement("div");
+    region.setAttribute(ANNOUNCER_ATTRIBUTE, "");
+    region.setAttribute("aria-live", "assertive");
+    region.setAttribute("aria-atomic", "true");
+    region.setAttribute("style", VISUALLY_HIDDEN);
+    doc.body.appendChild(region);
+    regions.set(doc, region);
+    return region;
+};
+/**
+ * The live document `node` is in: its own when that has a window, else the page's. A Solid ref
+ * runs while a new element still belongs to its template's inert document (no window, no body),
+ * before it's inserted.
+ */
+export const documentOf = (node) => {
+    const doc = node.ownerDocument;
+    if (doc === null || doc.defaultView === null)
+        return document;
+    return doc;
+};
+/** Adds `doc`'s live region now, before its first announcement, so a screen reader is already watching it. */
+export const prepareAnnouncer = (doc) => {
+    regionOf(doc);
+};
+/**
+ * Speaks `message` in `doc`'s live region, replacing the last. A repeat of the last gets a trailing
+ * no-break space, so it's read out again.
+ */
+export const announceIn = (doc, message) => {
+    const region = regionOf(doc);
+    region.textContent = Bool.match(region.textContent === message, { onTrue: () => `${message}\u00A0`, onFalse: () => message });
+};
+/** Each document's instructions ids, by text. */
+// Module state (#460, Q7): each document's instructions, held weakly by the document.
+const instructions = new WeakMap();
+// Module state (#460, Q7): an id counter; an id need only be unique in its document.
+let nextInstructions = 1;
+/**
+ * The id of `doc`'s hidden element holding `text`, one per distinct text, for the `aria-describedby` of
+ * every item that shows it. Given here, with no element added: a binding works it out as it renders, and
+ * adds the element with `showInstructions` in an effect.
+ */
+// #320.
+export const instructionsIdOf = (doc, text) => {
+    const byText = Option.getOrElse(Option.fromUndefinedOr(instructions.get(doc)), () => {
+        const added = new Map();
+        instructions.set(doc, added);
+        return added;
+    });
+    return Option.getOrElse(Option.fromUndefinedOr(byText.get(text)), () => {
+        const id = `wardic-instructions-${nextInstructions++}`;
+        byText.set(text, id);
+        return id;
+    });
+};
+/** Adds `doc`'s hidden element holding `text`, under `instructionsIdOf`'s id, unless it's there already. */
+export const showInstructions = (doc, text) => {
+    const id = instructionsIdOf(doc, text);
+    if (Predicate.isNotNull(doc.getElementById(id)))
+        return;
+    const el = doc.createElement("div");
+    el.id = id;
+    el.hidden = true;
+    el.textContent = text;
+    doc.body.appendChild(el);
+};
+/** `instructionsIdOf`, with its element added now: added again if it was removed. */
+export const instructionsId = (doc, text) => {
+    showInstructions(doc, text);
+    return instructionsIdOf(doc, text);
+};
+/** Core's `Announcer`, speaking in the page's `document`'s live region. */
+export const AnnouncerDomLive = Layer.effect(Announcer.Announcer)(Effect.gen(function* () {
+    yield* requireGlobal("DomAnnouncer.layer", "document");
+    return Announcer.Announcer.of({ announce: (message) => announceIn(document, message) });
+}));
+//# sourceMappingURL=announcer.js.map

package/dist/internal/announcer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"announcer.js","sourceRoot":"","sources":["../../src/internal/announcer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,SAAS,MAAM,wBAAwB,CAAA;AACnD,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAA;AACtC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,SAAS,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAEnD,uFAAuF;AACvF,MAAM,CAAC,MAAM,mBAAmB,GAAG,uBAAuB,CAAA;AAE1D,wFAAwF;AACxF,MAAM,eAAe,GACnB,kJAAkJ,CAAA;AAEpJ,+CAA+C;AAC/C,qFAAqF;AACrF,MAAM,OAAO,GAAG,IAAI,OAAO,EAAyB,CAAA;AAEpD,+DAA+D;AAC/D,MAAM,QAAQ,GAAG,CAAC,GAAa,EAAe,EAAE,CAC9C,MAAM,CAAC,SAAS,CACd,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,EACvF,GAAG,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CACrB,CAAA;AAEH,2CAA2C;AAC3C,MAAM,SAAS,GAAG,CAAC,GAAa,EAAe,EAAE;IAC/C,MAAM,MAAM,GAAG,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,CAAA;IACvC,MAAM,CAAC,YAAY,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAA;IAC5C,MAAM,CAAC,YAAY,CAAC,WAAW,EAAE,WAAW,CAAC,CAAA;IAC7C,MAAM,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAA;IAC1C,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,eAAe,CAAC,CAAA;IAC7C,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;IAC5B,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;IACxB,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAU,EAAY,EAAE;IACjD,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,CAAA;IAC9B,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,CAAC,WAAW,KAAK,IAAI;QAAE,OAAO,QAAQ,CAAA;IAC7D,OAAO,GAAG,CAAA;AACZ,CAAC,CAAA;AAED,8GAA8G;AAC9G,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,GAAa,EAAQ,EAAE;IACtD,QAAQ,CAAC,GAAG,CAAC,CAAA;AACf,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,GAAa,EAAE,OAAe,EAAQ,EAAE;IACjE,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAA;IAC5B,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,KAAK,OAAO,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAA;AAC/H,CAAC,CAAA;AAED,iDAAiD;AACjD,sFAAsF;AACtF,MAAM,YAAY,GAAG,IAAI,OAAO,EAAiC,CAAA;AACjE,qFAAqF;AACrF,IAAI,gBAAgB,GAAG,CAAC,CAAA;AAExB;;;;GAIG;AACH,QAAQ;AACR,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,GAAa,EAAE,IAAY,EAAU,EAAE;IACtE,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,eAAe,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE;QAClF,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAA;QACvC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QAC5B,OAAO,KAAK,CAAA;IACd,CAAC,CAAC,CAAA;IACF,OAAO,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE;QACrE,MAAM,EAAE,GAAG,uBAAuB,gBAAgB,EAAE,EAAE,CAAA;QACtD,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;QACpB,OAAO,EAAE,CAAA;IACX,CAAC,CAAC,CAAA;AACJ,CAAC,CAAA;AAED,4GAA4G;AAC5G,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,GAAa,EAAE,IAAY,EAAQ,EAAE;IACpE,MAAM,EAAE,GAAG,gBAAgB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IACtC,IAAI,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;QAAE,OAAM;IACvD,MAAM,EAAE,GAAG,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,CAAA;IACnC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAA;IACV,EAAE,CAAC,MAAM,GAAG,IAAI,CAAA;IAChB,EAAE,CAAC,WAAW,GAAG,IAAI,CAAA;IACrB,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAA;AAC1B,CAAC,CAAA;AAED,qFAAqF;AACrF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,GAAa,EAAE,IAAY,EAAU,EAAE;IACpE,gBAAgB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAC3B,OAAO,gBAAgB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;AACpC,CAAC,CAAA;AAED,2EAA2E;AAC3E,MAAM,CAAC,MAAM,gBAAgB,GAAqC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,CACjG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,KAAK,CAAC,CAAC,aAAa,CAAC,oBAAoB,EAAE,UAAU,CAAC,CAAA;IACtD,OAAO,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC,CAAA;AACzF,CAAC,CAAC,CACH,CAAA"}

package/dist/internal/appear.d.ts

@@ -0,0 +1,169 @@
+import type * as Frame from "@wardic/core/Frame";
+import * as Machine from "@wardic/core/Machine";
+import type * as Values from "@wardic/core/Values";
+import type { LazyArg } from "effect/Function";
+import * as Option from "effect/Option";
+import * as Result from "effect/Result";
+import { type TransformTemplate } from "./renderer.ts";
+/** An element's mount animation, as its binding describes it. */
+export interface Spec {
+    /**
+     * What built the animation, as one string the binding writes the same on the server and the
+     * client: its starting values, its targets, its transition, whether motion is reduced. The rule's
+     * name is its hash, so a client tells a Handoff it can continue from one it can't (decision 6).
+     */
+    readonly key: string;
+    /** The element's tag, so an SVG element's keys go to its attributes; `undefined` for an HTML element. */
+    readonly tag: string | undefined;
+    /**
+     * The animation's values from its start (for an `infinite` one, one cycle of it), built only when
+     * the rule isn't cached: a server render calls it once per spec per process.
+     */
+    readonly machine: LazyArg<Machine.Machine<Frame.Frame<Values.Values>>>;
+    /** Played over and over: an infinite repeat, `machine` one cycle of it. */
+    readonly infinite?: boolean | undefined;
+    /** A layout node: drawn through its projection at rest, as the client draws it, its own move on top. */
+    readonly projected?: boolean | undefined;
+    /**
+     * The element's transform template: each stop's transform drawn through it, as the client draws it. A
+     * function's text can't name a rule, so a templated spec's rule is named by its stops, and sampled for
+     * each element that has one, never cached.
+     */
+    readonly template?: TransformTemplate | undefined;
+}
+/** A spec's `@keyframes` rule. */
+export interface Keyframes {
+    /** The rule's name: `wardic-` and the spec's hash. */
+    readonly name: string;
+    /**
+     * Seconds the rule plays, a multiple of 1/60 s: to the first Frame from which every one is within
+     * tolerance of the settled one.
+     */
+    readonly duration: number;
+    /** Seconds to the Frame the spec settles at, which a client waits for: at or past `duration`. */
+    readonly settled: number;
+    /** Whether it plays over and over. */
+    readonly infinite: boolean;
+    /** The time of each stop kept, in seconds from the start. */
+    readonly times: ReadonlyArray<number>;
+    /** The rule, `@keyframes <name>{…}`. */
+    readonly css: string;
+    /**
+     * The SVG geometry properties its stops write (`cx`, `r`…), which some browsers don't draw from CSS: an
+     * element playing it is defined under `@supports` for each, so a browser without them keeps it at its
+     * starting style. Empty for most rules.
+     */
+    readonly supports: ReadonlyArray<string>;
+}
+/** Where an element's timing is decided: a spec, and the delay it starts after. */
+export interface Play {
+    /** The element's mount animation. */
+    readonly spec: Spec;
+    /** Seconds before it starts: its orchestration's, and any delay on the whole element. */
+    readonly delay: number;
+}
+/** The prefix every Appear rule's name starts with. */
+export declare const PREFIX = "wardic-";
+/** The longest mount animation sampled, in seconds; a longer one keeps its Starting style. */
+export declare const MAX_SECONDS = 60;
+/** The rule's name for a spec: its key, tag, repeat and projection, hashed. */
+export declare const nameOf: (spec: Pick<Spec, "key" | "tag" | "infinite" | "projected">) => string;
+/**
+ * The stops kept (decision 9), as indices into `frames`, and where the rule ends.
+ *
+ * - **It ends** at the first Frame from which every one is within tolerance of the settled Frame,
+ *   drawn as the settled Frame: a tween stepped in 1/60 s settles a frame after it arrives, when
+ *   its steps' sum crosses its duration.
+ * - **The stops kept** are the first, the end, and each one a straight line from the last kept can't
+ *   reach past, within every key's tolerances.
+ * - **A jump** (`jumps`, kept stops): a Frame the one before it can't be drawn into, as `jumpAt`
+ *   tells. The rule holds the Frame before it to halfway between them, then steps, so a display
+ *   frame near either draws that Frame, not a value on a line through values the engine never draws.
+ */
+export declare const thin: (frames: ReadonlyArray<Values.Values>, tag?: string | undefined) => {
+    readonly kept: ReadonlyArray<number>;
+    readonly end: number;
+    readonly jumps: ReadonlyArray<number>;
+};
+/**
+ * A spec's rule, or why it has none, for a debug log. Sampled once a spec and cached across requests by
+ * its name, since a spec's rule changes only once the page registers every colour space
+ * (`Color.registerSpaces`): a wide-gamut colour blends as written before, in sRGB after. Its name stays,
+ * so a client matches it whatever it had registered. A templated spec's is sampled each time: its name
+ * comes from its stops.
+ */
+export declare const keyframes: (spec: Spec) => Result.Result<Keyframes, string>;
+/**
+ * An element's `animation` value for a play of `rule`: its name, length, delay and repeat, filling
+ * forwards. Not backwards: through its delay the element shows its inline starting style, which is the
+ * rule's first stop for a rule that moves from it.
+ */
+export declare const animationOf: (rule: Keyframes, delay: number) => string;
+/** One element's place in a sheet. */
+export interface Slot {
+    /** The element's inline `animation`: `var(--wardic-aN)`, which the sheet defines once `define` is called. */
+    readonly animation: string;
+    /**
+     * The element's timing: `play`, and under `prefers-reduced-motion: reduce` `reduced` when given
+     * (a provider's `"user"`). Undefined until called, and left so when either spec has no rule: the
+     * element keeps its Starting style. The reason comes back for the debug log.
+     *
+     * Defined under `@supports` for the geometry properties its rules write and `supports`: a binding
+     * passes the ones every element it orchestrates with writes, so a browser without them keeps the whole
+     * group at its starting style, not half of it.
+     */
+    readonly define: (play: Play, reduced?: Play | undefined, supports?: ReadonlyArray<string>) => Result.Result<void, string>;
+}
+/** One render's Appear rules: a slot per element, and the `<style>` text for the head and each late chunk. */
+export interface Sheet {
+    /** A slot for the next element. */
+    readonly slot: () => Slot;
+    /**
+     * The CSS since the last call: each rule this render hasn't written yet, and the custom property of
+     * each slot defined since, the reduced ones under the media query. Called once for the head, and again
+     * for each chunk a stream sends after its shell, with only what that chunk adds.
+     */
+    readonly css: () => string;
+}
+/** A sheet for one render: a slot per element, and the CSS for the head. */
+export declare const sheet: () => Sheet;
+/**
+ * The attribute a late chunk's `<style>` carries: a chunk a stream sends after its shell brings its own
+ * rules, in a node its client doesn't render.
+ */
+export declare const CHUNK_ATTRIBUTE = "data-wardic-appear-chunk";
+/**
+ * A late chunk's `<style>` for `css`, as server text; "" for none. With a `nonce`, the one the page's
+ * Content Security Policy gives inline styles, it carries it.
+ */
+export declare const chunkStyle: (css: string, nonce?: string) => string;
+/**
+ * Moves each late chunk's Appear rules into the head: its `<style data-wardic-appear-chunk>`'s text into a
+ * head `<style>`, then the node out, before the chunk hydrates, since a hydrating client expects no node it
+ * doesn't render. The text goes first, so the rule a running animation plays is never missing. Chunks
+ * already in the document move at once; while it's still loading, a stream still coming, a
+ * `MutationObserver` moves each as it lands, until `DOMContentLoaded`. Every call moves what's there; one
+ * observer a document.
+ */
+export declare const adoptChunks: (doc: Document) => void;
+/** The element's Appear animation: its `wardic-…` CSS animation, running, or finished and filling. */
+export declare const find: (element: Element) => Option.Option<Animation>;
+/** Whether `animation` is `spec`'s: the rule the server sampled from the same spec. */
+export declare const matches: (animation: Animation, spec: Pick<Spec, "key" | "tag" | "infinite" | "projected">) => boolean;
+/** How far `animation` has got, in seconds since it started (its delay included): 0 before it has. */
+export declare const elapsedOf: (animation: Animation) => number;
+/** The delay `animation` started after, in seconds: what its element's `animation-delay` holds. */
+export declare const delayOf: (animation: Animation) => number;
+/**
+ * Whether `element`'s Appear animation is running, not yet handed over: its inline style still names its
+ * slot, which `release` removes. A layout measure asks it of each node, so a running animation's
+ * transform, which beats the inline one, stays out of the box it reads.
+ */
+export declare const pending: (element: ElementCSSInlineStyle) => boolean;
+/**
+ * The handover's last step: the element's inline `animation` removed, in the task that writes the
+ * engine's first frame, so no paint falls between. While it ran, its value beat the inline style the
+ * engine writes; removing it ends the CSS animation at that task's style update.
+ */
+export declare const release: (element: ElementCSSInlineStyle) => void;
+//# sourceMappingURL=appear.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"appear.d.ts","sourceRoot":"","sources":["../../src/internal/appear.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,KAAK,KAAK,MAAM,oBAAoB,CAAA;AAChD,OAAO,KAAK,OAAO,MAAM,sBAAsB,CAAA;AAE/C,OAAO,KAAK,KAAK,MAAM,MAAM,qBAAqB,CAAA;AAGlD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAIvC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAGvC,OAAO,EAAsC,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAG1F,iEAAiE;AACjE,MAAM,WAAW,IAAI;IACnB;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,yGAAyG;IAEzG,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;IAChC;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;IACtE,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACvC,wGAAwG;IAExG,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACxC;;;;OAIG;IAEH,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAA;CAClD;AAED,kCAAkC;AAClC,MAAM,WAAW,SAAS;IACxB,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,iGAAiG;IAEjG,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,sCAAsC;IACtC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,6DAA6D;IAC7D,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IACrC,wCAAwC;IACxC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB;;;;OAIG;IAEH,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;CACzC;AAED,mFAAmF;AACnF,MAAM,WAAW,IAAI;IACnB,qCAAqC;IACrC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;IACnB,yFAAyF;IACzF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED,uDAAuD;AACvD,eAAO,MAAM,MAAM,YAAY,CAAA;AAE/B,8FAA8F;AAC9F,eAAO,MAAM,WAAW,KAAK,CAAA;AAuB7B,+EAA+E;AAE/E,eAAO,MAAM,MAAM,SAAU,IAAI,CAAC,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,UAAU,GAAG,WAAW,CAAC,KAAG,MAQnF,CAAA;AAmKD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,IAAI,WACP,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,QAC9B,MAAM,GAAG,SAAS,KACvB;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;CAiBrG,CAAA;AAuKD;;;;;;GAMG;AAEH,eAAO,MAAM,SAAS,SAAU,IAAI,KAAG,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAUrE,CAAA;AAED;;;;GAIG;AAGH,eAAO,MAAM,WAAW,SAAU,SAAS,SAAS,MAAM,KAAG,MAGhD,CAAA;AAIb,sCAAsC;AACtC,MAAM,WAAW,IAAI;IACnB,6GAA6G;IAC7G,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B;;;;;;;;OAQG;IAEH,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,IAAI,GAAG,SAAS,EAAE,QAAQ,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;CAC3H;AAED,8GAA8G;AAC9G,MAAM,WAAW,KAAK;IACpB,mCAAmC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,CAAA;IACzB;;;;OAIG;IAEH,QAAQ,CAAC,GAAG,EAAE,MAAM,MAAM,CAAA;CAC3B;AAoBD,4EAA4E;AAC5E,eAAO,MAAM,KAAK,QAAO,KA+CxB,CAAA;AAID;;;GAGG;AAEH,eAAO,MAAM,eAAe,6BAA6B,CAAA;AAEzD;;;GAGG;AAEH,eAAO,MAAM,UAAU,QAAS,MAAM,UAAU,MAAM,KAAG,MAIxD,CAAA;AASD;;;;;;;GAOG;AAGH,eAAO,MAAM,WAAW,QAAS,QAAQ,KAAG,IAkB3C,CAAA;AAQD,sGAAsG;AAEtG,eAAO,MAAM,IAAI,YAAa,OAAO,KAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAI3D,CAAA;AAEJ,uFAAuF;AACvF,eAAO,MAAM,OAAO,cAAe,SAAS,QAAQ,IAAI,CAAC,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,UAAU,GAAG,WAAW,CAAC,KAAG,OAC/B,CAAA;AAE5E,sGAAsG;AACtG,eAAO,MAAM,SAAS,cAAe,SAAS,KAAG,MAI7C,CAAA;AAEJ,mGAAmG;AACnG,eAAO,MAAM,OAAO,cAAe,SAAS,KAAG,MAI3C,CAAA;AAKJ;;;;GAIG;AAEH,eAAO,MAAM,OAAO,YAAa,qBAAqB,KAAG,OAA8E,CAAA;AAEvI;;;;GAIG;AAEH,eAAO,MAAM,OAAO,YAAa,qBAAqB,KAAG,IAExD,CAAA"}