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

package/dist/internal/key-rules.js

@@ -0,0 +1,244 @@
+/**
+ * The DOM Environment's **Key rules** (CONTEXT.md; ADR-0035): how a CSS property's pair blends,
+ * by the property's name, which core's `InterpolatorRegistry` asks before blending a pair by value.
+ * Core holds none. Both rules take a key by its CSS name or in camelCase (`box-shadow`, `boxShadow`):
+ * `WardicValues` types keys as CSS names, and camelCase works as well.
+ *
+ * - **`visibility`** (ADR-0024, decision 4): `display` and `visibility` turning to `none` or
+ *   `hidden` show their start until the run's last Frame (Motion's `mixVisibility`), keyed on the
+ *   Frame's `done`, so a spring crossing its target can't flicker them.
+ * - **`animatableNone`** (ADR-0015, *Amendment (#61)*): an empty end (`"none"`, `0`, `"0"`, a zero
+ *   with a unit) facing a complex value or a lone colour stands for that value at zero, numbers 0
+ *   and colours transparent (Motion's `getAnimatableNone`). A filter puts each function at its
+ *   identity and a mask keeps its colours opaque. A plain length isn't a template: `none` isn't 0
+ *   for `max-height`. A shadow list (`box-shadow`, `text-shadow`) blends shadow by shadow: a length
+ *   missing from the start's shadow counts as 0, and a missing shadow grows from its zero. Either
+ *   way the run's last Frame writes the target as given, so a shadow, filter or fill animated to
+ *   `none` rests at `none`, with no stacking context, containing block or painted fill left.
+ *
+ * Each rule declines synchronously, allocating nothing, for a key it can't take: the registry asks
+ * every rule for every key of every leg it builds. The blends they hand back are on the per-frame
+ * path (ADR-0025): statement `if`s, and a counted loop for a shadow list.
+ *
+ * @module
+ */
+import * as Interpolator from "@wardic/core/Interpolator";
+import * as InterpolatorRegistry from "@wardic/core/InterpolatorRegistry";
+import * as Arr from "effect/Array";
+import * as Bool from "effect/Boolean";
+import * as Effect from "effect/Effect";
+import { pipe } from "effect/Function";
+import * as Match from "effect/Match";
+import * as Option from "effect/Option";
+import * as Predicate from "effect/Predicate";
+import * as Str from "effect/String";
+import { cssColor, formatColor, parseColor } from "./colors.js";
+import { cssComplex } from "./complex.js";
+import { dashCase } from "./svg.js";
+// The DOM's own Interpolators' `parse` and `format` (ADR-0036; plain functions since #511): a
+// template's colours are tokens and its `var()`s text, as the DOM's registry reads them, so a zero
+// keeps a variable's name as written (#160).
+const decodeComplex = cssComplex.parse;
+const encodeComplex = cssComplex.format;
+const decodeColor = parseColor;
+const encodeColor = formatColor;
+/** The keys whose empty end takes each filter function's identity (Motion's `filter` type, and the backdrop it leaves out). */
+const FILTER_KEYS = new Set(["filter", "-webkit-filter", "backdrop-filter", "-webkit-backdrop-filter"]);
+/** The keys whose empty end keeps its colours opaque (Motion's `mask` type, and the images it leaves out). */
+const MASK_KEYS = new Set(["mask", "-webkit-mask", "mask-image", "-webkit-mask-image"]);
+/** The keys matched shadow by shadow. */
+const SHADOW_KEYS = new Set(["box-shadow", "text-shadow"]);
+/** Whether `key`, written either way, is in `keys`. */
+const isOneOf = (keys) => (key) => keys.has(dashCase(key));
+// Built once (#460): `mayApply` asks of every key, each leg.
+const isFilterKey = isOneOf(FILTER_KEYS);
+const isMaskKey = isOneOf(MASK_KEYS);
+const isShadowKey = isOneOf(SHADOW_KEYS);
+/** The filter functions whose identity is 1 (or 100%); every other is at its identity at 0 (Motion's `maxDefaults`). */
+const IDENTITY_ONE = new Set(["brightness", "contrast", "saturate", "opacity"]);
+/** The words an empty end can be. */
+const EMPTY_WORDS = new Set(["none", "0"]);
+/** A zero with a unit: `"0px"`, `"0%"`, `"0deg"` (Motion's `isZeroValueString`). */
+const ZERO_WITH_UNIT_RE = /^0[^.\s]+$/;
+/** An empty string end: `"none"`, `"0"`, or a zero with a unit. */
+const isEmptyWord = Predicate.mapInput(Predicate.or((word) => EMPTY_WORDS.has(word), (word) => ZERO_WITH_UNIT_RE.test(word)), Str.trim);
+/** The number 0. */
+const isZero = (value) => value === 0;
+/** An empty end (Motion's `isNone`): the number 0, `"none"`, `"0"`, or a zero with a unit. */
+const isEmptyEnd = Predicate.or(isZero, (value) => Predicate.isString(value) && isEmptyWord(value));
+/** The first number in a filter function's arguments. */
+const FIRST_NUMBER_RE = /-?\d*\.?\d+(?:e[-+]?\d+)?/i;
+const transparent = (color) => ({ ...color, alpha: 0 });
+const opaque = (color) => ({ ...color, alpha: 1 });
+/** A number written straight after a `/`: a `calc()` divisor, kept, since a 0 there is NaN (Motion's `convertToZero`). */
+const isDivisor = (partBefore) => Str.endsWith("/")(Str.trim(partBefore));
+/** A colour token of the DOM's complex tier. */
+const isColorToken = (token) => token.kind === cssColor.name;
+/** A complex value at zero: every number 0 (but a divisor), every colour turned. */
+const zeroComplex = (complex, turn) => encodeComplex({
+    parts: complex.parts,
+    tokens: Arr.map(complex.tokens, (token, i) => Match.value(token).pipe(Match.when(Predicate.isNumber, (n) => Bool.match(isDivisor(complex.parts[i]), { onTrue: () => n, onFalse: () => 0 })), Match.when(isColorToken, (color) => ({ kind: color.kind, value: turn(color.value) })), Match.orElse((token) => token))),
+});
+/** A value at zero, as a complex value or a lone colour; `None` when it's neither. */
+const zeroOf = (value, turn) => Option.orElse(Option.map(decodeComplex(value), (complex) => zeroComplex(complex, turn)), () => Option.map(decodeColor(value), (color) => encodeColor(turn(color))));
+/** How many numbers a complex value holds outside its colours: what complex matching counts. 0 for one that isn't. */
+const numberCountOf = (value) => Option.match(decodeComplex(value), {
+    onNone: () => 0,
+    onSome: (complex) => Arr.filter(complex.tokens, Predicate.isNumber).length,
+});
+/** A top-level comma: one not inside a bracket (a shadow's colour, `rgba(…)`, holds commas). One level deep, as shadows are. */
+const TOP_LEVEL_COMMA_RE = /,(?![^(]*\))/;
+/** A filter's functions, each with what's in its brackets, one bracket level deep (`drop-shadow(0px 0px 4px rgb(…))`). */
+const FILTER_FUNCTION_RE = /[a-z-]+\((?:[^()]|\([^()]*\))*\)/gi;
+/** A shadow list's shadows, trimmed. */
+const shadowsOf = (value) => Arr.filter(Arr.map(value.split(TOP_LEVEL_COMMA_RE), Str.trim), Str.isNonEmpty);
+/** A filter's functions. */
+const filterFunctionsOf = (value) => Option.getOrElse(Str.match(FILTER_FUNCTION_RE)(value), () => []);
+/**
+ * One filter function at its identity (Motion's `applyDefaultFilter`): its first number becomes 1
+ * (or 100) for `brightness`, `contrast`, `saturate` and `opacity`, 0 for the rest, keeping its unit.
+ * A `drop-shadow()` grows from a transparent zero, as a shadow does (#61; Motion keeps it as is).
+ * One with no number (`url(#f)`) stays as it is.
+ */
+const filterFunctionAtIdentity = (fn) => {
+    const name = Str.trim(fn.slice(0, Math.max(0, fn.indexOf("("))));
+    const args = fn.slice(fn.indexOf("(") + 1, fn.lastIndexOf(")"));
+    return Bool.match(name === "drop-shadow", {
+        onTrue: () => Option.getOrElse(zeroOf(fn, transparent), () => fn),
+        onFalse: () => Option.match(Option.fromNullishOr(FIRST_NUMBER_RE.exec(args)), {
+            onNone: () => fn,
+            onSome: ([number]) => {
+                const unit = Str.replace(number, "")(args);
+                const one = Bool.match(Str.isEmpty(unit), { onTrue: () => 1, onFalse: () => 100 });
+                const identity = Bool.match(IDENTITY_ONE.has(name), { onTrue: () => one, onFalse: () => 0 });
+                return `${name}(${identity}${unit})`;
+            },
+        }),
+    });
+};
+/** A filter at its identity: each top-level function at its own (Motion's `filter.getAnimatableNone`). */
+const filterAtIdentity = (value) => Option.map(decodeComplex(value), () => Arr.join(Arr.map(filterFunctionsOf(value), filterFunctionAtIdentity), " "));
+/** What `key`'s empty end stands for, facing `template` (CONTEXT.md's Animatable none); `None` when `template` can't be one. */
+const noneOf = (key, template) => Bool.match(isFilterKey(key), {
+    onTrue: () => filterAtIdentity(template),
+    onFalse: () => zeroOf(template, Bool.match(isMaskKey(key), { onTrue: () => opaque, onFalse: () => transparent })),
+});
+/** `auto`, which carries nothing to grow from. */
+const isAuto = (s) => Str.trim(s) === "auto";
+/** An end a template can come from: a string other than an empty end or `auto`. */
+const templateOf = (value) => Option.filter(Option.liftPredicate(value, Predicate.isString), Predicate.not(Predicate.or(isEmptyWord, isAuto)));
+/** `from` empty and `to` a template: the pair from `to`'s Animatable none. */
+const fromNone = (key, from, to) => pipe(Option.liftPredicate(from, isEmptyEnd), Option.flatMap(() => templateOf(to)), Option.flatMap((template) => noneOf(key, template)), Option.map((none) => ({ pairs: [[none, to]] })));
+/** `to` empty and `from` a template: the pair to `from`'s Animatable none, landing on `to` as given. */
+const toNone = (key, from, to) => pipe(Option.liftPredicate(to, isEmptyEnd), Option.flatMap(() => templateOf(from)), Option.flatMap((template) => noneOf(key, template)), Option.map((none) => ({ pairs: [[from, none]] })));
+/**
+ * One shadow's pair: a shadow missing from one end is the other's Animatable none, and a start
+ * with fewer numbers than its target takes 0s for the missing lengths, appended (CSS's default
+ * for an omitted blur or spread). Matching is kind by kind in order, so where they go in the text
+ * doesn't matter.
+ */
+const shadowPair = (from, to) => {
+    const a = Option.getOrElse(from, () => Option.getOrElse(Option.flatMap(to, (t) => zeroOf(t, transparent)), () => "none"));
+    const b = Option.getOrElse(to, () => Option.getOrElse(Option.flatMap(from, (f) => zeroOf(f, transparent)), () => "none"));
+    const missing = Math.max(0, numberCountOf(b) - numberCountOf(a));
+    return [a + Str.repeat(missing)(" 0px"), b];
+};
+/** One pair, `from` → `to` as given: matching shadow by shadow changed nothing. */
+const isAsGiven = (from, to) => (pairs) => Arr.match(pairs, {
+    onEmpty: () => false,
+    onNonEmpty: ([[a, b], ...rest]) => Bool.and(rest.length === 0, Bool.and(a === from, b === to)),
+});
+/**
+ * A shadow list's pairs, shadow by shadow (#61): `None` unless both ends are strings and matching
+ * them shadow by shadow changes anything (more than one shadow, or a start short of numbers).
+ */
+const shadows = (key, from, to) => pipe(Option.liftPredicate(key, isShadowKey), Option.flatMap(() => Option.all([Option.liftPredicate(from, Predicate.isString), Option.liftPredicate(to, Predicate.isString)])), Option.map(([a, b]) => {
+    const as = shadowsOf(a);
+    const bs = shadowsOf(b);
+    return Arr.makeBy(Math.max(as.length, bs.length), (i) => shadowPair(Arr.get(as, i), Arr.get(bs, i)));
+}), Option.filter(Predicate.not(isAsGiven(from, to))), Option.map((pairs) => ({ pairs })));
+/** An end a template can come from, checked cheaply: a string other than an empty end or `auto`. */
+const isTemplateEnd = (value) => Predicate.isString(value) && !isEmptyWord(value) && !isAuto(value);
+/**
+ * Whether any rule here can apply: an empty end facing a template, or a shadow key between two
+ * strings. Checked first, allocating nothing, so a pair no rule applies to (`opacity` from `0`,
+ * `pointer-events` to `none`) never reaches the `Option` chains below: their calls at stream
+ * build, through library functions the frame path shares, cost Node's `animateValues` about 5%
+ * per frame when it ran after other workloads (#61's bench). Per key, each leg: statements (#460).
+ */
+const mayApply = (key, from, to) => {
+    if (isEmptyEnd(from) && isTemplateEnd(to))
+        return true;
+    if (isEmptyEnd(to) && isTemplateEnd(from))
+        return true;
+    return isShadowKey(key) && Predicate.isString(from) && Predicate.isString(to);
+};
+/**
+ * `key`'s pairs (#61): from or to its Animatable none when one end is empty, or shadow by shadow
+ * for a shadow list. `None` when neither applies: the rule declines.
+ */
+const prepare = (key, from, to) => {
+    if (!mayApply(key, from, to))
+        return Option.none();
+    return pipe(fromNone(key, from, to), Option.orElse(() => toNone(key, from, to)), Option.orElse(() => shadows(key, from, to)));
+};
+/** A hiding pair's blend: its start until the run's last Frame, then its target. Per frame: a statement `if`. */
+const holdUntilDone = (from, to) => (_t, done) => {
+    if (done)
+        return to;
+    return from;
+};
+/**
+ * One pair's blend that writes its target as given on the run's last Frame (#61): a pair from or to
+ * its Animatable none rests at `"none"` itself, not its zero. Per frame: a statement `if`.
+ */
+const landOn = (blend, to) => (t, done) => {
+    if (done)
+        return to;
+    return blend(t);
+};
+/**
+ * A shadow list's blend (#61): each shadow's blend, joined with `", "`, and its target as given on
+ * the run's last Frame. Per frame: a counted loop building the string.
+ */
+const joinShadows = (blends, to) => (t, done) => {
+    if (done)
+        return to;
+    let out = String(blends[0](t));
+    for (let i = 1; i < blends.length; i++)
+        out += ", " + String(blends[i](t));
+    return out;
+};
+// --- The rules ------------------------------------------------------------------------------------
+/** The keys whose turn to `none` or `hidden` waits for the run's last Frame (ADR-0024, decision 4). */
+const VISIBILITY_KEYS = new Set(["display", "visibility"]);
+const INVISIBLE = new Set(["none", "hidden"]);
+/** A `none` or `hidden` value: what a `display` or `visibility` key turns to when it hides. */
+const isInvisible = (value) => Predicate.isString(value) && INVISIBLE.has(Str.trim(value));
+/** A pair that hides: from a visible value to `none` or `hidden`. */
+const hides = (from, to) => Bool.and(isInvisible(to), !isInvisible(from));
+/** `display` and `visibility`, turning to `none` or `hidden`, show their start until the run's last Frame. */
+export const visibility = {
+    name: "visibility",
+    blend: (key, from, to) => {
+        if (!VISIBILITY_KEYS.has(key))
+            return Option.none();
+        if (!hides(from, to))
+            return Option.none();
+        return Option.some(Effect.succeed(holdUntilDone(from, to)));
+    },
+};
+/**
+ * An empty end facing a complex value or a colour grows from, or goes back to, its Animatable none,
+ * and a shadow list blends shadow by shadow; the run's last Frame writes the target as given.
+ */
+export const animatableNone = {
+    name: "animatable none",
+    blend: (key, from, to, resolve) => Option.map(prepare(key, from, to), (prepared) => Effect.map(Effect.forEach(prepared.pairs, ([a, b]) => resolve(a, b)), (blends) => Bool.match(blends.length > 1, {
+        onTrue: () => joinShadows(blends, to),
+        onFalse: () => landOn(blends[0], to),
+    }))),
+};
+/** The DOM's Key rules, in the order they're asked. */
+export const keyRules = [visibility, animatableNone];
+//# sourceMappingURL=key-rules.js.map

package/dist/internal/key-rules.js.map

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

package/dist/internal/measure.d.ts

@@ -0,0 +1,150 @@
+/**
+ * The DOM reads the Projection system takes at measure time (ADR-0005 / ADR-0009 /
+ * ADR-0012). Two box readers: {@link readLayoutBox} is the raw rect the projection
+ * pass uses (it owns the transform reset at pass level), {@link measureLayoutBox}
+ * a self-resetting single-element read for a lone caller. No framework or Effect dependency — pure DOM — so
+ * this lives in `@wardic/dom` alongside the Projection system that consumes it (a
+ * binding imports it from here).
+ *
+ * It's the surface of the port the engine would move into `@wardic/core` behind (#16, parked
+ * until a non-DOM Environment exists): a DOM read the engine newly needs is added here, named,
+ * rather than written inline in `projection.ts`, measure-time or not: the tree's `contains` too
+ * (#618). #16 maps the reads that file made inline before this rule.
+ */
+import * as Drag from "@wardic/core/Drag";
+import type * as Point from "@wardic/core/Point";
+import type * as Probe from "@wardic/core/Probe";
+import * as Option from "effect/Option";
+/**
+ * Read `el`'s box AS IT CURRENTLY RENDERS — a raw `getBoundingClientRect`, no
+ * transform reset. The projection measure pass uses this because it resets the
+ * whole tree's transforms in its own WRITE phase first, so by the time it reads,
+ * nothing is transformed (see `runMeasurePass`). A lone caller wants
+ * {@link measureLayoutBox} instead.
+ */
+export declare const readLayoutBox: (el: HTMLElement) => Probe.Bounds;
+/**
+ * Measures `el`'s box where the layout puts it: its own `transform` is cleared for the read and put
+ * back, so an animation running on it doesn't move the reading. Its ancestors' transforms still
+ * count. The box is in the viewport: `x`, `y`, `width`, `height`, and its edges.
+ *
+ * @example
+ * const box = measureLayoutBox(card)
+ * @see https://wardic.dev/reference/solid/layout/measure-layout-box
+ */
+export declare const measureLayoutBox: (el: HTMLElement) => Probe.Bounds;
+/**
+ * The bounds on `element`'s x/y that keep it inside `container` (Motion's element `dragConstraints`):
+ * `element` measured without its own transform (its layout box, as Motion's projection measures it),
+ * `container` as it renders. With `mapPoint` (Motion's `transformPagePoint`), each box's corners are
+ * mapped through it first, as Motion's `measurePageBox` maps them: a container inside a zoomed parent
+ * bounds the element in its own pixels.
+ */
+export declare const dragBoundsWithin: (element: HTMLElement, container: Element, mapPoint?: (point: Point.Point) => Point.Point) => Drag.Bounds;
+/** A box's size, in CSS px. */
+export interface BoxSize {
+    readonly width: number;
+    readonly height: number;
+}
+/**
+ * A page box's size as it renders (#261, ADR-0018 *Amendment (#261)*): a raw `getBoundingClientRect`,
+ * so a transformed one reads as painted, which the observer's border box doesn't (its echo then reads
+ * as a change, and costs one refresh).
+ */
+export declare const readBoxSize: (el: Element) => BoxSize;
+/** Whether `el` takes space in its parent's flow (#261): it isn't absolutely or fixed positioned. */
+export declare const takesFlowSpace: (el: Element) => boolean;
+/** An element's scroll offset (ADR-0012, Motion's `measureScroll`). */
+export declare const measureScroll: (el: HTMLElement) => Point.Point;
+/**
+ * Whether `el` is a scroll ROOT (ADR-0012, Motion's `checkIsScrollRoot`): a
+ * `position: fixed` element establishes a viewport-relative frame, so its subtree
+ * doesn't fold in page (or outer-container) scroll.
+ */
+export declare const isScrollRoot: (el: HTMLElement) => boolean;
+/** The properties that move an element on screen without moving its layout (ADR-0012, *Amendment (#136)*). */
+declare const TRANSFORM_PROPERTIES: readonly ["transform", "translate", "scale", "rotate"];
+type TransformProperty = (typeof TRANSFORM_PROPERTIES)[number];
+/** What the Measure pass needs from an element's style to hold its transform. */
+export interface TransformStyle {
+    /** The transform properties that aren't `none`. Empty: nothing moves it. */
+    readonly moved: ReadonlyArray<TransformProperty>;
+    /** Whether a CSS transition is declared on one of them. */
+    readonly transitioned: boolean;
+}
+/**
+ * {@link TransformStyle} from an element's computed style. `getComputedStyle` returns a
+ * live declaration, so a caller that keeps one per element reads the current values each
+ * time without calling it again.
+ */
+export declare const transformStyleFrom: (style: CSSStyleDeclaration) => TransformStyle;
+/**
+ * Whether a CSS transition is running on one of `el`'s transform properties. Holding it
+ * would cancel or restart that transition, so the pass leaves it as it is: its offset
+ * stays in the box (the documented limit).
+ */
+export declare const transitionRunning: (el: Element) => boolean;
+/** An element the pass can hold: one with an inline style. */
+export type Holdable = Element & ElementCSSInlineStyle;
+/** Whether `el` has an inline style the pass can hold its transform through. */
+export declare const isHoldable: (el: Element) => el is Holdable;
+/** An element held at its transform's identity for a read, and what to put back. */
+export interface TransformHold {
+    readonly element: Holdable;
+    /** Each held property's own inline value and priority (`""` for none). */
+    readonly saved: ReadonlyArray<readonly [TransformProperty, string, string]>;
+    /** The inline `transition-property` and priority, when the hold turned transitions off. */
+    readonly transition: Option.Option<readonly [string, string]>;
+}
+/**
+ * Hold `el`'s transform properties at their identity (ADR-0012, *Amendment (#136)*):
+ * inline and `!important`, so a stylesheet rule, a CSS animation and a Web Animation
+ * all give way. An element with a transition declared on one of them also gets
+ * `transition-property: none` for the hold, so it starts none.
+ */
+export declare const holdTransform: (el: Holdable, style: TransformStyle) => TransformHold;
+/**
+ * Put back what {@link holdTransform} replaced. The elements whose transitions it turned
+ * off get their transform back first, then a style read, then their transition, so the
+ * return from identity starts no transition either.
+ */
+export declare const releaseTransforms: (holds: ReadonlyArray<TransformHold>) => void;
+/** A `position: sticky` element held at its static place for a read (#578), and what to put back. */
+export interface StickyHold {
+    readonly element: Holdable;
+    /** Each held property's own inline value and priority (`""` for none). */
+    readonly saved: ReadonlyArray<readonly [string, string, string]>;
+}
+/**
+ * Hold a `position: sticky` element at its static place (ADR-0012, *Amendment (#578)*):
+ * `position: relative` with every inset `auto`, inline and `!important`, so it's offset by
+ * nothing and still positioned, the containing block of what's absolute inside it. Neither
+ * the flow around it nor the scroll moves: a sticky element's offset takes no space.
+ */
+export declare const holdUnstuck: (el: Holdable) => StickyHold;
+/** Put back what {@link holdUnstuck} replaced. */
+export declare const releaseUnstuck: (holds: ReadonlyArray<StickyHold>) => void;
+/**
+ * The document's scroll offset (the page/window scroll, ADR-0012, Motion's
+ * `DocumentProjectionNode` root). Folded into every box unless it sits in a scroll
+ * root. SSR-safe (returns origin when there is no document).
+ */
+export declare const measureDocumentScroll: () => Point.Point;
+export { readScrollStyle, scrollersOf, scrollStyleFrom, type ScrollStyle } from "./scrollers.ts";
+/** Whether `inner` is `outer` or inside it, in the DOM's tree: the engine's one question of the tree (#618). */
+export declare const contains: (outer: Node, inner: Node) => boolean;
+/** `el`'s computed opacity, as a number: a Crossfade's fade from where its leaver is drawn (#618). */
+export declare const readOpacity: (el: Element) => number;
+/** A scale corrector's key and the CSS property it reads (#443). */
+export interface CorrectedKey {
+    readonly key: string;
+    readonly cssKey: string;
+}
+/** The computed values of `keys` on `el` (#443), by key: an empty one, or `none`, left out. One style read. */
+export declare const readCustomBases: (el: Element, keys: ReadonlyArray<CorrectedKey>) => Readonly<Record<string, string>>;
+/**
+ * Each of `els`' offsets from its static place (#578): its box as it's drawn, less its box held
+ * unstuck. All held at once, so it costs one layout for them all, then one more after the release.
+ */
+export declare const readStickyShifts: (els: Iterable<HTMLElement>) => Map<Element, Point.Point>;
+//# sourceMappingURL=measure.d.ts.map

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

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