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

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 the Wardic contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,9 @@
-# Temporary Holding Version
+# @wardic/core
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Wardic's animation engine, on [Effect](https://effect.website): springs, tweens, inertia and keyframes, variants, the projection geometry behind layout animations, and the services an environment provides (a clock, a renderer, input, a probe).
+
+Most apps don't install it directly: they use a binding, [`@wardic/solid`](https://www.npmjs.com/package/@wardic/solid), which brings it. It's for building an environment or a binding of your own.
+
+- Docs: https://wardic.dev
+- Source: https://github.com/wardiclabs/wardic/tree/main/packages/core
+- Licence: MIT

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,145 @@
+# Third-party notices
+
+Wardic follows the API of [Motion](https://motion.dev) for React, and parts of its source are ported from Motion's: rewritten in Wardic's own style, keeping Motion's algorithms, formulas and constants so the results match. Motion is MIT licensed, and its notice follows.
+
+## Motion
+
+https://github.com/motiondivision/motion
+
+Ported from Motion's source:
+
+- `@wardic/core`:
+  - `Box` and `Projection`: the projection geometry (`motion-dom`'s `projection/geometry`: `models`, `delta-calc`, `delta-apply`, `applyTreeDeltas`);
+  - `Spring`: the solver for a spring's stiffness and damping from its duration and bounce (`findSpring`);
+  - `Velocity`: a gesture's velocity from its points (`getVelocity`);
+  - `Reorder`: moving an item, and the axis a list runs on (`moveItem`, `detectAxis`);
+  - `AutoScroll`: scrolling a container while an item is dragged near its edge (`autoScrollIfNeeded`).
+- `@wardic/dom`:
+  - the projection transform (`buildProjectionTransform`);
+  - the scroll offsets (`render/dom/scroll/offsets`).
+
+```
+The MIT License (MIT)
+
+Copyright (c) 2024 [Motion](https://motion.dev) B.V.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
+## Manrope
+
+https://github.com/googlefonts/manrope
+
+The docs site serves Manrope for its headings (`site/public/fonts/manrope-latin.woff2`, its variable weights 600 to 800, Latin only, with its licence beside it as `OFL.txt`), and Wardic's wordmark is "wardic" set in Manrope ExtraBold and outlined (`brand/`, and the docs header's logo, `site/src/components/logo-paths.ts`). Manrope is licensed under the SIL Open Font License, Version 1.1.
+
+```
+Copyright 2018 The Manrope Project Authors (https://github.com/googlefonts/manrope)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.
+```

package/dist/Announcer.d.ts

@@ -0,0 +1,24 @@
+/**
+ * The Announcer: how an Environment speaks a message to assistive technology, a screen reader, say.
+ * Core words what's said, as a Reorder group's announcements, and the Environment delivers it through
+ * its platform's own channel, as `@wardic/dom` does. Each announcement replaces the last.
+ *
+ * @example
+ * import * as Announcer from "@wardic/core/Announcer"
+ *
+ * const announcer = yield* Announcer.Announcer
+ * announcer.announce("Picked up Milk, position 2 of 5.")
+ */
+import * as Context from "effect/Context";
+import * as Layer from "effect/Layer";
+declare const Announcer_base: Context.ServiceClass<Announcer, "@wardic/core/Announcer", {
+    /** Speaks `message`, replacing the last announcement. */
+    readonly announce: (message: string) => void;
+}>;
+/** An Environment's channel to assistive technology. */
+export declare class Announcer extends Announcer_base {
+}
+/** An Announcer that says nothing, for an Environment with no assistive technology to reach, as the test Environment's. */
+export declare const layerSilent: Layer.Layer<Announcer>;
+export {};
+//# sourceMappingURL=Announcer.d.ts.map

package/dist/Announcer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Announcer.d.ts","sourceRoot":"","sources":["../src/Announcer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AACzC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;;IAInC,yDAAyD;uBACtC,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI;;AAH9C,wDAAwD;AACxD,qBAAa,SAAU,SAAQ,cAGD;CAAG;AAEjC,2HAA2H;AAC3H,eAAO,MAAM,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC,SAAS,CAAoD,CAAA"}

package/dist/Announcer.js

@@ -0,0 +1,23 @@
+/**
+ * The Announcer: how an Environment speaks a message to assistive technology, a screen reader, say.
+ * Core words what's said, as a Reorder group's announcements, and the Environment delivers it through
+ * its platform's own channel, as `@wardic/dom` does. Each announcement replaces the last.
+ *
+ * @example
+ * import * as Announcer from "@wardic/core/Announcer"
+ *
+ * const announcer = yield* Announcer.Announcer
+ * announcer.announce("Picked up Milk, position 2 of 5.")
+ */
+// An **Announcement** (ADR-0037); `@wardic/dom`'s `DomAnnouncer.layer`. A Context service, as
+// `ReducedMotion.PositionalKeys` is: core names the contract and no Environment's syntax (ADR-0036). A
+// plain call: an announcement answers a key just pressed, on no frame's path. Tier 2 (ADR-0008): for
+// Environment and binding authors.
+import * as Context from "effect/Context";
+import * as Layer from "effect/Layer";
+/** An Environment's channel to assistive technology. */
+export class Announcer extends Context.Service()("@wardic/core/Announcer") {
+}
+/** An Announcer that says nothing, for an Environment with no assistive technology to reach, as the test Environment's. */
+export const layerSilent = Layer.succeed(Announcer, { announce: () => { } });
+//# sourceMappingURL=Announcer.js.map

package/dist/Announcer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Announcer.js","sourceRoot":"","sources":["../src/Announcer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,8FAA8F;AAC9F,uGAAuG;AACvG,qGAAqG;AACrG,mCAAmC;AACnC,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AACzC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AAErC,wDAAwD;AACxD,MAAM,OAAO,SAAU,SAAQ,OAAO,CAAC,OAAO,EAG1C,CAAC,wBAAwB,CAAC;CAAG;AAEjC,2HAA2H;AAC3H,MAAM,CAAC,MAAM,WAAW,GAA2B,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC,CAAA"}

package/dist/Arc.d.ts

@@ -0,0 +1,43 @@
+import type * as Point from "./Point.ts";
+/** A point along a path: `x` and `y`, and, for a path that turns the element, `rotate` in degrees. */
+export interface PathPoint extends Point.Point {
+    readonly rotate?: number | undefined;
+}
+/**
+ * A path for `x` and `y`: given where they start and end, the point at each progress `t`, 0 at the start
+ * and 1 at the end. `make` makes one; any function of this shape is one.
+ *
+ * @example
+ * // A hop: a straight line that lifts 40 px at its middle.
+ * const hop: Arc.Path = (from, to) => (t) => ({
+ *   x: from.x + (to.x - from.x) * t,
+ *   y: from.y + (to.y - from.y) * t - Math.sin(Math.PI * t) * 40,
+ * })
+ */
+export type Path = (from: Point.Point, to: Point.Point) => (t: number) => PathPoint;
+/** An arc's options, Motion's `arc`'s. */
+export interface Options {
+    /**
+     * How far the arc bulges off the straight line, as a share of the distance it travels: `1` peaks
+     * at the whole distance. Default `0.5`.
+     */
+    readonly strength?: number | undefined;
+    /** Where along the way (0–1) the arc is at its highest. Default `0.5`. */
+    readonly peak?: number | undefined;
+    /**
+     * The side it bulges to, turning with the direction of travel: `"cw"` or `"ccw"`. Left out, it
+     * keeps to one side of the screen across the paths one arc makes.
+     */
+    readonly direction?: "cw" | "ccw" | undefined;
+    /** Whether it turns the element to follow the curve: `true` all the way, a number 0–1 that share of it. */
+    readonly rotate?: boolean | number | undefined;
+}
+/**
+ * A curved path, Motion's `arc()`. Make one and keep it: with no `direction`, it remembers the side of
+ * the screen it bulged to, and keeps to it when the direction of travel turns.
+ *
+ * @example
+ * const path = Arc.make({ strength: 0.4, rotate: true }) // a binding's transition={{ path }}
+ */
+export declare const make: (options?: Options) => Path;
+//# sourceMappingURL=Arc.d.ts.map

package/dist/Arc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Arc.d.ts","sourceRoot":"","sources":["../src/Arc.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,KAAK,KAAK,MAAM,YAAY,CAAA;AAExC,sGAAsG;AACtG,MAAM,WAAW,SAAU,SAAQ,KAAK,CAAC,KAAK;IAC5C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACrC;AAED;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,EAAE,EAAE,KAAK,CAAC,KAAK,KAAK,CAAC,CAAC,EAAE,MAAM,KAAK,SAAS,CAAA;AAEnF,0CAA0C;AAC1C,MAAM,WAAW,OAAO;IACtB;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACtC,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAClC;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,GAAG,KAAK,GAAG,SAAS,CAAA;IAC7C,2GAA2G;IAC3G,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAA;CAC/C;AAuDD;;;;;;GAMG;AAEH,eAAO,MAAM,IAAI,aAAa,OAAO,KAAQ,IAiC5C,CAAA"}

package/dist/Arc.js

@@ -0,0 +1,98 @@
+/**
+ * Curved paths between two points, for a transition's `path`: `x` and `y` travel along the curve
+ * together, rather than each on a straight line. `make` makes Motion's `arc()`, a curve that bulges off
+ * the straight line between them; any function of `Path`'s shape is a path too.
+ *
+ * @example
+ * import * as Arc from "@wardic/core/Arc"
+ *
+ * const at = Arc.make({ strength: 0.3 })({ x: 0, y: 0 }, { x: 200, y: 80 })
+ * at(0.5) // the curve's middle: { x, y }
+ */
+// #438: an arc is a quadratic Bézier.
+import * as Bool from "effect/Boolean";
+import { identity } from "effect/Function";
+import * as Match from "effect/Match";
+import * as Predicate from "effect/Predicate";
+import * as UndefinedOr from "effect/UndefinedOr";
+/** `value` wrapped into `[min, max)`, motion-utils' `wrap`. */
+const wrap = (min, max, value) => {
+    const range = max - min;
+    return ((((value - min) % range) + range) % range) + min;
+};
+/** A quadratic Bézier's coordinate at `t`. */
+const bezierAt = (t, origin, control, target) => {
+    const inv = 1 - t;
+    return inv * inv * origin + 2 * inv * t * control + t * t * target;
+};
+/** The angle (degrees) of a quadratic Bézier's tangent at `t`. */
+const tangentAt = (t, from, control, to) => {
+    const dx = 2 * (1 - t) * (control.x - from.x) + 2 * t * (to.x - control.x);
+    const dy = 2 * (1 - t) * (control.y - from.y) + 2 * t * (to.y - control.y);
+    return Math.atan2(dy, dx) * (180 / Math.PI);
+};
+/** The arc's control point: `peak` along the straight line, `strength` of its length off it, to its left. */
+const controlOf = (from, to, strength, peak) => {
+    const dx = to.x - from.x;
+    const dy = to.y - from.y;
+    const distance = Math.sqrt(dx * dx + dy * dy);
+    if (distance === 0)
+        return from;
+    const height = strength * distance;
+    return { x: from.x + dx * peak - (dy / distance) * height, y: from.y + dy * peak + (dx / distance) * height };
+};
+/** How much of the tangent an arc turns the element by. */
+const rotationOf = (rotate) => Match.value(rotate).pipe(Match.when(true, () => 1), Match.when(Match.number, (share) => share), Match.orElse(() => 0));
+/**
+ * An arc's signed strength for a move from its `dx` and `dy`, chosen once, at `make`, by its
+ * `direction`: a fixed side, or the screen side that keeps the dominant axis's travel turning the same way.
+ */
+// #618 (H1): `make`'s path built this matcher at every flight's start.
+const signedOf = (direction, strength) => Match.value(direction).pipe(Match.when("cw", () => () => -strength), Match.when("ccw", () => () => strength), Match.orElse(() => (dx, dy) => Bool.match(Bool.match(Math.abs(dx) >= Math.abs(dy), { onTrue: () => dx, onFalse: () => dy }) < 0, {
+    onTrue: () => -strength,
+    onFalse: () => strength,
+})));
+/**
+ * A curved path, Motion's `arc()`. Make one and keep it: with no `direction`, it remembers the side of
+ * the screen it bulged to, and keeps to it when the direction of travel turns.
+ *
+ * @example
+ * const path = Arc.make({ strength: 0.4, rotate: true }) // a binding's transition={{ path }}
+ */
+// #438.
+export const make = (options = {}) => {
+    const strength = UndefinedOr.match(options.strength, { onUndefined: () => 0.5, onDefined: identity });
+    const peak = UndefinedOr.match(options.peak, { onUndefined: () => 0.5, onDefined: identity });
+    const direction = options.direction;
+    const signedFor = signedOf(direction, strength);
+    const rotation = rotationOf(options.rotate);
+    // With no direction: the side of the screen the last arc bulged to, across the paths this one makes.
+    let lastSide;
+    return (from, to) => {
+        const dx = to.x - from.x;
+        const dy = to.y - from.y;
+        const signed = signedFor(dx, dy);
+        let control = controlOf(from, to, signed, peak);
+        if (Predicate.isUndefined(direction)) {
+            // Which side of the straight line it bulges to, across the dominant axis.
+            const side = Math.sign(Bool.match(Math.abs(dx) < Math.abs(dy), { onTrue: () => control.x - (from.x + dx * peak), onFalse: () => control.y - (from.y + dy * peak) }));
+            // The other side from the last arc's: turned back onto it.
+            const turned = Bool.and(Bool.and(Predicate.isNotUndefined(lastSide), side !== 0), side !== lastSide);
+            if (turned)
+                control = controlOf(from, to, -signed, peak);
+            if (Bool.and(side !== 0, Bool.not(turned)))
+                lastSide = side;
+        }
+        if (rotation === 0)
+            return (t) => ({ x: bezierAt(t, from.x, control.x, to.x), y: bezierAt(t, from.y, control.y, to.y) });
+        // The turn is measured from the straight turn between the tangents at the ends, so it's 0 at both.
+        const start = tangentAt(0, from, control, to);
+        const turn = wrap(-180, 180, tangentAt(1, from, control, to) - start);
+        return (t) => ({
+            x: bezierAt(t, from.x, control.x, to.x),
+            y: bezierAt(t, from.y, control.y, to.y),
+            rotate: wrap(-180, 180, tangentAt(t, from, control, to) - (start + turn * t)) * rotation,
+        });
+    };
+};
+//# sourceMappingURL=Arc.js.map

package/dist/Arc.js.map

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

package/dist/AutoScroll.d.ts

@@ -0,0 +1,45 @@
+import * as Option from "effect/Option";
+import type * as Point from "./Point.ts";
+import type * as Reorder from "./Reorder.ts";
+/** How near a scroller's visible edge, in px, the pointer starts it scrolling: 50, as Motion's. */
+export declare const THRESHOLD = 50;
+/** The most a scroller scrolls in one update, in px, with the pointer at its edge: 25, as Motion's. */
+export declare const MAX_SPEED = 25;
+/** The edge a scroller is scrolling toward, between one `step` and the next. */
+export interface State {
+    /** The edge: `"start"` at the top or left, `"end"` at the bottom or right. */
+    readonly edge: "start" | "end";
+    /**
+     * The scroll range when it started toward that edge: it never scrolls past it, so content that grows
+     * while it scrolls doesn't keep it scrolling.
+     */
+    readonly limit: number;
+}
+/**
+ * One update on one axis: how far to scroll, negative toward the start, and the state for the next.
+ * `pointer`, `start` and `end` are in the viewport's px: the pointer, and the scroller's visible edges,
+ * held within the viewport. Within `THRESHOLD` of an edge it scrolls `MAX_SPEED` × (1 − distance ÷
+ * `THRESHOLD`)² toward it.
+ * - **It starts** only while the pointer moves toward that edge (`velocity`), and reads `maxScroll()`
+ *   then, the only time it's read.
+ * - **It keeps on** while the pointer stays near the edge, and stops at the end at the range it read.
+ *   `scroll` is how far the scroller is scrolled.
+ * - **Away from both edges** there's no state.
+ */
+export declare const step: (state: Option.Option<State>, input: {
+    readonly pointer: number;
+    readonly start: number;
+    readonly end: number;
+    readonly velocity: number;
+    readonly scroll: number;
+    readonly maxScroll: () => number;
+}) => {
+    readonly amount: number;
+    readonly state: Option.Option<State>;
+};
+/**
+ * The axis Auto-scroll follows: a one-axis group's own, and in a grid the one the pointer moves faster
+ * on, `y` on a tie, as Motion's.
+ */
+export declare const axis: (axis: Reorder.Axis, velocity: Point.Point) => "x" | "y";
+//# sourceMappingURL=AutoScroll.d.ts.map

package/dist/AutoScroll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AutoScroll.d.ts","sourceRoot":"","sources":["../src/AutoScroll.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,KAAK,KAAK,MAAM,YAAY,CAAA;AACxC,OAAO,KAAK,KAAK,OAAO,MAAM,cAAc,CAAA;AAE5C,mGAAmG;AAEnG,eAAO,MAAM,SAAS,KAAK,CAAA;AAE3B,uGAAuG;AAEvG,eAAO,MAAM,SAAS,KAAK,CAAA;AAE3B,gFAAgF;AAChF,MAAM,WAAW,KAAK;IACpB,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,KAAK,CAAA;IAC9B;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED;;;;;;;;;;GAUG;AAGH,eAAO,MAAM,IAAI,UACR,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,SACpB;IACL,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,MAAM,CAAA;CACjC,KACA;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;CAqBjE,CAAA;AAyBD;;;GAGG;AAEH,eAAO,MAAM,IAAI,SAAU,OAAO,CAAC,IAAI,YAAY,KAAK,CAAC,KAAK,KAAG,GAAG,GAAG,GAMpE,CAAA"}

package/dist/AutoScroll.js

@@ -0,0 +1,82 @@
+/**
+ * Auto-scroll for a Reorder group, as Motion's: while an item is dragged near a scroller's edge, the
+ * scroller scrolls toward it, faster the nearer. This is its math, one update on one axis at a time; the
+ * binding measures the scroller, calls `step` at each move of the drag, and scrolls by what it says.
+ *
+ * @example
+ * import * as AutoScroll from "@wardic/core/AutoScroll"
+ *
+ * let state = Option.none<AutoScroll.State>()
+ * // At each move of the drag:
+ * const next = AutoScroll.step(state, {
+ *   pointer: point.y,
+ *   start: visible.top,
+ *   end: visible.bottom,
+ *   velocity: velocity.y,
+ *   scroll: offset,
+ *   maxScroll: () => range,
+ * })
+ * scrollBy(next.amount)
+ * state = next.state
+ */
+// ADR-0020: Motion's `autoScrollIfNeeded`, ported (Reorder/utils/auto-scroll.ts @ 16c6122). Effect-free
+// and DOM-free. Tier 2 (ADR-0008): for binding and Environment authors.
+import * as Bool from "effect/Boolean";
+import * as Match from "effect/Match";
+import * as Option from "effect/Option";
+/** How near a scroller's visible edge, in px, the pointer starts it scrolling: 50, as Motion's. */
+// Motion's `threshold` (Reorder/utils/auto-scroll.ts:1 @ 16c6122).
+export const THRESHOLD = 50;
+/** The most a scroller scrolls in one update, in px, with the pointer at its edge: 25, as Motion's. */
+// Motion's `maxSpeed` (Reorder/utils/auto-scroll.ts:2 @ 16c6122).
+export const MAX_SPEED = 25;
+/**
+ * One update on one axis: how far to scroll, negative toward the start, and the state for the next.
+ * `pointer`, `start` and `end` are in the viewport's px: the pointer, and the scroller's visible edges,
+ * held within the viewport. Within `THRESHOLD` of an edge it scrolls `MAX_SPEED` × (1 − distance ÷
+ * `THRESHOLD`)² toward it.
+ * - **It starts** only while the pointer moves toward that edge (`velocity`), and reads `maxScroll()`
+ *   then, the only time it's read.
+ * - **It keeps on** while the pointer stays near the edge, and stops at the end at the range it read.
+ *   `scroll` is how far the scroller is scrolled.
+ * - **Away from both edges** there's no state.
+ */
+// Motion's algorithm, as a pure step:
+// https://github.com/motiondivision/motion/blob/16c61222c4166bbef5ff6ab0051192faa79fa8c8/packages/framer-motion/src/components/Reorder/utils/auto-scroll.ts
+export const step = (state, input) => {
+    /** A step that scrolls `amount` toward `next`'s edge, stopping at its limit. */
+    const scrollWithin = (next, amount) => Bool.match(Bool.and(amount > 0, input.scroll >= next.limit), {
+        onTrue: () => ({ amount: 0, state: Option.some(next) }),
+        onFalse: () => ({ amount, state: Option.some(next) }),
+    });
+    return Option.match(nearEdge(input.pointer - input.start, input.end - input.pointer), {
+        onNone: () => ({ amount: 0, state: Option.none() }),
+        onSome: ([edge, amount]) => Option.match(Option.filter(state, (current) => current.edge === edge), {
+            onSome: (current) => scrollWithin(current, amount),
+            // A start at an edge, or a switch to the other one, needs motion toward it; the limit
+            // is read once, at the start.
+            onNone: () => Bool.match(movingToward(edge, input.velocity), {
+                onTrue: () => scrollWithin({ edge, limit: input.maxScroll() }, amount),
+                onFalse: () => ({ amount: 0, state }),
+            }),
+        }),
+    });
+};
+/** Scroll toward an edge within the threshold: faster the nearer, as the square of the closeness. */
+const toward = (distance) => {
+    const intensity = 1 - distance / THRESHOLD;
+    return MAX_SPEED * intensity * intensity;
+};
+/** The edge the pointer is within {@link THRESHOLD} of, the start first, and the scroll toward it. */
+const nearEdge = (fromStart, fromEnd) => Option.map(Option.liftPredicate(fromStart, isNear), (d) => ["start", -toward(d)]).pipe(Option.orElse(() => Option.map(Option.liftPredicate(fromEnd, isNear), (d) => ["end", toward(d)])));
+/** Nearer an edge than {@link THRESHOLD}. */
+const isNear = (distance) => distance < THRESHOLD;
+/** A pointer moving toward `edge`. */
+const movingToward = (edge, velocity) => Match.value(edge).pipe(Match.when("start", () => velocity < 0), Match.when("end", () => velocity > 0), Match.exhaustive);
+/**
+ * The axis Auto-scroll follows: a one-axis group's own, and in a grid the one the pointer moves faster
+ * on, `y` on a tie, as Motion's.
+ */
+// Motion's `>` (Reorder/Item.tsx @ 16c6122).
+export const axis = (axis, velocity) => Match.value(axis).pipe(Match.when("xy", () => Bool.match(Math.abs(velocity.x) > Math.abs(velocity.y), { onTrue: () => "x", onFalse: () => "y" })), Match.orElse((single) => single));
+//# sourceMappingURL=AutoScroll.js.map

package/dist/AutoScroll.js.map

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

package/dist/BaseValue.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Where a key starts, and where it returns: an element's Base value for a key is the first of its base
+ * target (its `animate`, else an inherited variant, else its `initial`), its `initial`, its own `style`,
+ * the values it started at, and its Own value, which its Environment reads off it. `of` finds it, and
+ * `start` finds where a key with no value yet starts. Pure, and shared by every binding and Environment.
+ *
+ * @example
+ * import * as BaseValue from "@wardic/core/BaseValue"
+ *
+ * BaseValue.of("opacity", { base: {}, initial: { opacity: 0 }, style: () => Option.none(), own: readOwn })
+ * // Option.some({ value: 0, source: "initial" }): where opacity returns once nothing sets it
+ */
+import * as Option from "effect/Option";
+import type * as Values from "./Values.ts";
+/**
+ * Each transform key's identity: the value that leaves an element untransformed, 1 for a scale and 0 for
+ * a translation, rotation or skew. A transform key's Own value is its identity, as Motion's is. These are
+ * the keys an Environment builds one `transform` from.
+ */
+export declare const TRANSFORM_IDENTITY: Readonly<Record<string, number>>;
+/** A transform key's identity (see {@link TRANSFORM_IDENTITY}), or `None` for any other key, prototype names included. */
+export declare const transformIdentity: (key: string) => Option.Option<number>;
+/** Which link of the chain a Base value came from. */
+export type BaseSource = "base" | "initial" | "style" | "started" | "own";
+/** A Base value and the link it came from. */
+export interface BaseValue {
+    readonly value: number | string;
+    readonly source: BaseSource;
+}
+/** A per-key lookup: a value, or `None` for none. */
+export type ValueLookup = (key: string) => Option.Option<number | string>;
+/**
+ * The links of a key's chain, in order.
+ *
+ * - `base`: the base of the element's Override stack: its own `animate`, else an inherited variant,
+ *   else its `initial`.
+ * - `initial`: the element's `initial` values, an inherited `initial` among them.
+ * - `style`: the element's user style for the key, coerced to the key's shape; a surface
+ *   with no style link passes `() => Option.none()`.
+ * - `started`: the values an element with `initial={false}` started at, its `animate` at mount, as
+ *   Motion's `baseTarget`; such an element passes an empty `initial`. Optional: left out, no value.
+ * - `own`: the element's Own value, read by its Environment; asked only when every earlier
+ *   link misses.
+ */
+export interface BaseSources {
+    readonly base: Values.Values;
+    readonly initial: Values.Values;
+    readonly style: ValueLookup;
+    readonly started?: Values.Values | undefined;
+    readonly own: ValueLookup;
+}
+/**
+ * A key's Base value: where it returns once no layer sets it. The first link that has the
+ * key wins: `base`, then `initial`, then `style`, then `started`, then `own`. A later link
+ * is never asked once one hits. `None` means no link has it, so the key doesn't return (it
+ * stays where it is).
+ */
+export declare const of: (key: string, sources: BaseSources) => Option.Option<BaseValue>;
+/**
+ * Where a key with no value yet starts: its `style` value, else its Own value. `None` when neither has
+ * one: start the key at its target, with no motion, as Motion does.
+ */
+export declare const start: (key: string, sources: Pick<BaseSources, "style" | "own">) => Option.Option<BaseValue>;
+//# sourceMappingURL=BaseValue.d.ts.map

package/dist/BaseValue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseValue.d.ts","sourceRoot":"","sources":["../src/BaseValue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,KAAK,KAAK,MAAM,MAAM,aAAa,CAAA;AAE1C;;;;GAIG;AAIH,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAkB9D,CAAA;AAEF,0HAA0H;AAC1H,eAAO,MAAM,iBAAiB,QAAS,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAqC,CAAA;AAEzG,sDAAsD;AACtD,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,KAAK,CAAA;AAEzE,8CAA8C;AAC9C,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;IAC/B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;CAC5B;AAED,qDAAqD;AACrD,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,CAAA;AAEzE;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAA;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAA;IAC/B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,SAAS,CAAA;IAC5C,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAA;CAC1B;AAMD;;;;;GAKG;AACH,eAAO,MAAM,EAAE,QAAS,MAAM,WAAW,WAAW,KAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAW3E,CAAA;AAEH;;;GAGG;AAGH,eAAO,MAAM,KAAK,QAAS,MAAM,WAAW,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,KAAK,CAAC,KAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAGrG,CAAA"}