@vysmo/easings 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Maesto LLC
+
+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

@@ -0,0 +1,368 @@
+# @vysmo/easings
+
+22 easing families (linear, power1–4, sine, circ, expo, smooth, back, elastic, bounce, steps, bezier, spring, rough, wiggle, slow, anticipate, expoScale, gravity, breathe) + composition modifiers (chain, reverse, mirror, yoyo, blend, slice). Pure math, zero deps. CSS export via `toCSSLinear` / `toCSSBezier`; reduced-motion helpers; GSAP-style string parser.
+
+[Live curves explorer](https://vysmo.com/easings) · [Source](https://github.com/vysmodev)
+
+## Install
+
+```bash
+pnpm add @vysmo/easings
+```
+
+## Quick start
+
+In JavaScript — pass any easing as the `ease` option:
+
+```ts
+import { animate } from "@vysmo/animations";
+import { power2Out } from "@vysmo/easings";
+
+animate({
+  from: 0,
+  to: 1,
+  duration: 600,
+  ease: power2Out,
+  onUpdate: (v) => element.style.opacity = String(v),
+});
+```
+
+In CSS — bake any easing into a `linear()` string:
+
+```ts
+import { toCSSLinear } from "@vysmo/easings/css";
+import { spring } from "@vysmo/easings";
+
+const ease = spring.with({ stiffness: 220, damping: 18 });
+
+document.documentElement.style.setProperty(
+  "--ease-pop",
+  toCSSLinear(ease, 32),
+);
+```
+
+Every export is just a `(t: number) => number` (an `EasingFn`). Use with `animate()`, your own rAF loop, baked to CSS, or anything that takes an easing function. Parametric easings like `spring.with({ ... })` and `bezier(0.25, 0.1, 0.25, 1)` return the same shape — see the catalog below for every option.
+
+## Catalog
+
+<!-- catalog:start -->
+
+Every shipped easing with its variants and parameters. The catalog mirrors the playground at [vysmo.com/easings/docs#catalog](https://vysmo.com/easings/docs#catalog). Categorisation tracks the authoring shape — Core (constant curves), Parametric (curves with `.with({ ... })`), Builder (factory functions).
+
+### Core
+
+#### `linear`
+
+No easing — constant velocity.
+
+**Export:** `linear`
+
+#### `power1`
+
+Quadratic (t²). Mildest power curve.
+
+**Variants:** `power1In` · `power1Out` · `power1InOut`
+
+#### `power2 (cubic)`
+
+Cubic (t³). Workhorse default — CSS's ease is close to power2.out.
+
+**Variants:** `power2In` · `power2Out` · `power2InOut`
+
+#### `power3 (quart)`
+
+Quartic (t⁴). More pronounced easing.
+
+**Variants:** `power3In` · `power3Out` · `power3InOut`
+
+#### `power4 (quint)`
+
+Quintic (t⁵). Dramatic acceleration.
+
+**Variants:** `power4In` · `power4Out` · `power4InOut`
+
+#### `sine`
+
+Sinusoidal (cos/sin-based). Soft and natural.
+
+**Variants:** `sineIn` · `sineOut` · `sineInOut`
+
+#### `circ`
+
+Circular arc. Sharp at one end, flat at the other.
+
+**Variants:** `circIn` · `circOut` · `circInOut`
+
+#### `expo`
+
+Exponential (2^). Extreme — near-zero until the last moments, or vice versa.
+
+**Variants:** `expoIn` · `expoOut` · `expoInOut`
+
+#### `smooth`
+
+Hermite smoothstep (3t² - 2t³). Zero velocity at both endpoints — smoother joins than power2.inOut for chained animations.
+
+**Variants:** `smoothIn` · `smoothOut` · `smoothInOut`
+
+### Parametric
+
+#### `back`
+
+Overshoots the target then returns. Classic 'pull-back' motion.
+
+**Variants:** `backIn` · `backOut` · `backInOut`
+
+| Prop | Type | Default | Values |
+|---|---|---|---|
+| `overshoot` | number | `1.70158` | 0 – 5, step 0.01 |
+
+#### `elastic`
+
+Spring-like oscillation. Two knobs: amplitude (peak height) and period (frequency).
+
+**Variants:** `elasticIn` · `elasticOut` · `elasticInOut`
+
+| Prop | Type | Default | Values |
+|---|---|---|---|
+| `amplitude` | number | `1` | 0.1 – 5, step 0.01 |
+| `period` | number | `0.3` | 0.05 – 1, step 0.01 |
+
+#### `bounce`
+
+Ball-drop pattern. Four decaying bounces.
+
+**Variants:** `bounceIn` · `bounceOut` · `bounceInOut`
+
+#### `steps`
+
+Discrete staircase. CSS-compatible step positions.
+
+**Export:** `steps`
+
+| Prop | Type | Default | Values |
+|---|---|---|---|
+| `count` | number | `5` | 1 – 30, step 1 |
+| `position` | enum | `end` | `end` · `start` · `none` |
+
+### Builder
+
+#### `bezier`
+
+CSS cubic-bezier. Paste a cubic-bezier() value from CSS or design tools.
+
+**Export:** `bezier`
+
+| Prop | Type | Default | Values |
+|---|---|---|---|
+| `p1x` | number | `0.42` | 0 – 1, step 0.01 |
+| `p1y` | number | `0` | -2 – 2, step 0.01 |
+| `p2x` | number | `0.58` | 0 – 1, step 0.01 |
+| `p2y` | number | `1` | -2 – 2, step 0.01 |
+
+#### `spring`
+
+Physics-based spring. Stiffness × damping × mass = feel.
+
+**Export:** `spring`
+
+| Prop | Type | Default | Values |
+|---|---|---|---|
+| `stiffness` | number | `170` | 10 – 1000, step 5 |
+| `damping` | number | `26` | 1 – 100, step 1 |
+| `mass` | number | `1` | 0.1 – 10, step 0.1 |
+| `velocity` | number | `0` | -20 – 20, step 0.5 |
+
+#### `rough`
+
+Jittery noise layered on a base curve. Great for gritty / handheld feel.
+
+**Export:** `rough`
+
+| Prop | Type | Default | Values |
+|---|---|---|---|
+| `strength` | number | `0.15` | 0 – 0.5, step 0.01 |
+| `points` | number | `20` | 5 – 60, step 1 |
+| `taper` | enum | `both` | `none` · `in` · `out` · `both` |
+| `seed` | number | `42` | 1 – 999, step 1 |
+
+#### `wiggle`
+
+Oscillates between -1 and 1 across [0, 1]. For shake / vibration effects.
+
+**Export:** `wiggle`
+
+| Prop | Type | Default | Values |
+|---|---|---|---|
+| `wiggles` | number | `10` | 1 – 30, step 1 |
+| `type` | enum | `easeOut` | `easeOut` · `easeInOut` · `anticipate` · `uniform` |
+
+#### `slow`
+
+Linear middle section flanked by power-eased edges. For slow-motion feel.
+
+**Export:** `slow`
+
+| Prop | Type | Default | Values |
+|---|---|---|---|
+| `linearRatio` | number | `0.7` | 0 – 1, step 0.01 |
+| `power` | number | `0.7` | 0 – 5, step 0.1 |
+
+#### `anticipate`
+
+Character-animation wind-up: dips backward (in), overshoots past target (out), or both (inOut). Framer Motion style.
+
+**Variants:** `anticipateIn` · `anticipateOut` · `anticipateInOut`
+
+| Prop | Type | Default | Values |
+|---|---|---|---|
+| `overshoot` | number | `1.525` | 0 – 5, step 0.01 |
+
+#### `expoScale`
+
+Maps [0, 1] for scale animations crossing large ratios (e.g. 0.1→100) so motion feels even.
+
+**Export:** `expoScale`
+
+| Prop | Type | Default | Values |
+|---|---|---|---|
+| `startScale` | number | `1` | 0.01 – 100, step 0.1 |
+| `endScale` | number | `100` | 0.01 – 1000, step 1 |
+
+#### `gravity`
+
+Continuously parameterised power-in. weight=0 floats (linear), weight=1 ≈ Earth fall (power2.in), higher = leaden. One knob instead of picking between named power curves.
+
+**Export:** `gravity`
+
+| Prop | Type | Default | Values |
+|---|---|---|---|
+| `weight` | number | `1` | 0 – 3, step 0.05 |
+
+#### `breathe`
+
+Continuous oscillation in [0, 1]. cycles=0.5 = single inhale (0 → 1). cycles=1 = inhale + exhale. For idle / ambient animations on opacity, scale, anything in [0, 1].
+
+**Export:** `breathe`
+
+| Prop | Type | Default | Values |
+|---|---|---|---|
+| `cycles` | number | `1` | 0.5 – 8, step 0.5 |
+
+<!-- catalog:end -->
+
+Spring presets shipped: `gentleSpring`, `wobblySpring`, `stiffSpring`, `slowSpring`, `molassesSpring` — all built on `spring.with(...)`. The power family also exposes GSAP-compatible aliases: `quadIn/Out/InOut`, `cubicIn/Out/InOut`, `quartIn/Out/InOut`, `quintIn/Out/InOut`.
+
+## Composition modifiers
+
+```ts
+import {
+  reverse, mirror, yoyo, chain, blend, slice,
+  power2Out, sineInOut, bounceOut,
+} from "@vysmo/easings";
+
+reverse(power2Out);                  // play it backwards
+mirror(power2Out);                   // half forward, half reversed
+yoyo(sineInOut);                     // out then back — one full oscillation
+blend(power2Out, sineInOut, 0.5);    // 50/50 mix at every t
+slice(power2Out, 0.2, 0.8);          // use only the middle 60% of the curve
+
+// chain takes an array of segments; each segment owns its own ease + duration.
+chain([
+  { ease: power2Out, duration: 0.4 },
+  { ease: sineInOut, duration: 0.4 },
+  { ease: bounceOut, duration: 0.2 },
+]);
+```
+
+All modifiers return a fresh `EasingFn` — composable, side-effect-free.
+
+## CSS export
+
+```ts
+import { toCSSLinear, toCSSBezier, toCSSKeyframes, spring } from "@vysmo/easings";
+
+// CSS `linear()` function — sample any EasingFn into a CSS-compatible curve.
+// Second arg is the sample count (positional; default 40).
+const css = toCSSLinear(spring.with({ stiffness: 100, damping: 10 }), 24);
+// → "linear(0, 0.0123 4.17%, …)"
+
+// Cubic-bezier control points → CSS cubic-bezier() exactly.
+toCSSBezier(0.25, 0.1, 0.25, 1);
+// → "cubic-bezier(0.25, 0.1, 0.25, 1)"
+
+// Sample as @keyframes percentages for full-fidelity CSS animations.
+// Signature: (name, property, valueForProgress, ease, samples?)
+toCSSKeyframes(
+  "pop",
+  "transform",
+  (p) => `scale(${1 + p * 0.5})`,
+  spring.with({ stiffness: 200 }),
+);
+```
+
+## Reduced-motion helpers
+
+```ts
+import { prefersReducedMotion, respectReducedMotion, power2Out, linear } from "@vysmo/easings";
+
+const ease = respectReducedMotion(power2Out, linear);
+// → returns linear when prefers-reduced-motion is set, power2Out otherwise
+
+if (prefersReducedMotion()) { /* skip the animation entirely */ }
+```
+
+## GSAP-style string parser
+
+```ts
+import { parseEasing } from "@vysmo/easings/parse";
+
+parseEasing("power2.out");                       // → power2Out
+parseEasing("back.out(2)");                       // → backOut.with({ overshoot: 2 })
+parseEasing("elastic.out(1.2, 0.4)");             // → elasticOut.with({ amplitude, period })
+parseEasing("steps(5, start)");                   // → steps(5, "start")
+parseEasing("cubic-bezier(0.42, 0, 0.58, 1)");    // → bezier(0.42, 0, 0.58, 1)
+```
+
+Useful when easings come from data (presets, JSON, AI agents, etc.) rather than source code.
+
+## Defining your own
+
+```ts
+import { defineEasing, defineParametricEasing } from "@vysmo/easings";
+
+// Simple curve
+export const easeWithDefaults = defineEasing("my-ease", (t) => 1 - Math.pow(1 - t, 5));
+
+// Parametric (callable with defaults; .with(...) returns a tuned variant)
+export const customSpring = defineParametricEasing(
+  "my-spring",
+  { stiffness: 100 },
+  ({ stiffness }) => (t) => 1 - Math.pow(1 - t, stiffness / 50),
+);
+```
+
+Endpoints are clamped exact (t ≤ 0 → 0, t ≥ 1 → 1) by default. Disable for `steps("start")`-style curves with `{ exactEndpoints: false }`.
+
+## Subpath imports
+
+Tree-shake what you ship by importing from subpaths:
+
+```ts
+import { parseEasing } from "@vysmo/easings/parse";
+import { toCSSLinear } from "@vysmo/easings/css";
+import { prefersReducedMotion } from "@vysmo/easings/reduced-motion";
+```
+
+`/parse` pulls in the registry; `/css` pulls in the CSS converters; `/reduced-motion` pulls in the media-query helper. The main entry tree-shakes cleanly when you only import a curve or two.
+
+## Characteristics
+
+- **Pure math.** No DOM, no rAF, no global state. Runs in Node, browser, web workers, deno, bun.
+- **Zero runtime dependencies.**
+- **Tree-shakable.** Importing one curve ships ~0.2 KB gzipped.
+- **Endpoint-correct.** All catalog curves clear `f(0) === 0` and `f(1) === 1`. Property-tested across the catalog.
+
+## License
+
+MIT.

package/dist/builders/anticipate.d.ts

@@ -0,0 +1,20 @@
+export type AnticipateParams = {
+    /** Depth of the backward dip before the forward motion. Default 1.525 (Framer Motion default). */
+    overshoot: number;
+};
+/**
+ * Character-animation-style anticipation: wind-up before the forward motion.
+ *
+ * - `anticipateIn` (formerly just `anticipate`): dip at start, smooth arrival.
+ * - `anticipateOut`: smooth departure, overshoot dip near the end.
+ * - `anticipateInOut`: dip at start AND overshoot near the end (wind-up + follow-through).
+ *
+ * The second half of `anticipateIn` uses a power-n ease where n matches the
+ * first-half slope at t=0.5, giving C¹ continuity regardless of overshoot.
+ */
+export declare const anticipateIn: import("../types.js").ParametricEasing<AnticipateParams>;
+export declare const anticipateOut: import("../types.js").ParametricEasing<AnticipateParams>;
+export declare const anticipateInOut: import("../types.js").ParametricEasing<AnticipateParams>;
+/** Alias for `anticipateIn` (Framer Motion's default shape). */
+export declare const anticipate: import("../types.js").ParametricEasing<AnticipateParams>;
+//# sourceMappingURL=anticipate.d.ts.map

package/dist/builders/anticipate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anticipate.d.ts","sourceRoot":"","sources":["../../src/builders/anticipate.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,kGAAkG;IAClG,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAyCF;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY,0DAAuE,CAAC;AACjG,eAAO,MAAM,aAAa,0DAAyE,CAAC;AACpG,eAAO,MAAM,eAAe,0DAI3B,CAAC;AAEF,gEAAgE;AAChE,eAAO,MAAM,UAAU,0DAAe,CAAC"}

package/dist/builders/anticipate.js

@@ -0,0 +1,52 @@
+import { defineParametricEasing } from "../define.js";
+const DEFAULTS = { overshoot: 1.525 };
+function anticipateInBuild({ overshoot: s }) {
+    const n = Math.max(1, s + 3);
+    return (t) => {
+        if (t < 0.5) {
+            const p = t * 2;
+            return 0.5 * (p * p * ((s + 1) * p - s));
+        }
+        const p = t * 2 - 1;
+        return 0.5 + 0.5 * (1 - (1 - p) ** n);
+    };
+}
+function anticipateOutBuild({ overshoot: s }) {
+    const n = Math.max(1, s + 3);
+    return (t) => {
+        if (t < 0.5) {
+            const p = t * 2;
+            return 0.5 * (p ** n);
+        }
+        const u = 1 - t;
+        const p = u * 2;
+        return 1 - 0.5 * (p * p * ((s + 1) * p - s));
+    };
+}
+function anticipateInOutBuild({ overshoot: s }) {
+    return (t) => {
+        if (t < 0.5) {
+            const p = t * 2;
+            return 0.5 * (p * p * ((s + 1) * p - s));
+        }
+        const u = 1 - t;
+        const p = u * 2;
+        return 1 - 0.5 * (p * p * ((s + 1) * p - s));
+    };
+}
+/**
+ * Character-animation-style anticipation: wind-up before the forward motion.
+ *
+ * - `anticipateIn` (formerly just `anticipate`): dip at start, smooth arrival.
+ * - `anticipateOut`: smooth departure, overshoot dip near the end.
+ * - `anticipateInOut`: dip at start AND overshoot near the end (wind-up + follow-through).
+ *
+ * The second half of `anticipateIn` uses a power-n ease where n matches the
+ * first-half slope at t=0.5, giving C¹ continuity regardless of overshoot.
+ */
+export const anticipateIn = defineParametricEasing("anticipate.in", DEFAULTS, anticipateInBuild);
+export const anticipateOut = defineParametricEasing("anticipate.out", DEFAULTS, anticipateOutBuild);
+export const anticipateInOut = defineParametricEasing("anticipate.inOut", DEFAULTS, anticipateInOutBuild);
+/** Alias for `anticipateIn` (Framer Motion's default shape). */
+export const anticipate = anticipateIn;
+//# sourceMappingURL=anticipate.js.map

package/dist/builders/anticipate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anticipate.js","sourceRoot":"","sources":["../../src/builders/anticipate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAOtD,MAAM,QAAQ,GAAqB,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;AAExD,SAAS,iBAAiB,CAAC,EAAE,SAAS,EAAE,CAAC,EAAoB;IAC3D,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7B,OAAO,CAAC,CAAS,EAAE,EAAE;QACnB,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;YACZ,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAChB,OAAO,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC3C,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpB,OAAO,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACxC,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,EAAE,SAAS,EAAE,CAAC,EAAoB;IAC5D,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7B,OAAO,CAAC,CAAS,EAAE,EAAE;QACnB,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;YACZ,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAChB,OAAO,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACxB,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChB,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAAC,EAAE,SAAS,EAAE,CAAC,EAAoB;IAC9D,OAAO,CAAC,CAAS,EAAE,EAAE;QACnB,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;YACZ,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAChB,OAAO,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC3C,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChB,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,sBAAsB,CAAC,eAAe,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CAAC;AACjG,MAAM,CAAC,MAAM,aAAa,GAAG,sBAAsB,CAAC,gBAAgB,EAAE,QAAQ,EAAE,kBAAkB,CAAC,CAAC;AACpG,MAAM,CAAC,MAAM,eAAe,GAAG,sBAAsB,CACnD,kBAAkB,EAClB,QAAQ,EACR,oBAAoB,CACrB,CAAC;AAEF,gEAAgE;AAChE,MAAM,CAAC,MAAM,UAAU,GAAG,YAAY,CAAC"}

package/dist/builders/bezier.d.ts

@@ -0,0 +1,7 @@
+import type { EasingFn } from "../types.js";
+export declare function bezier(p1x: number, p1y: number, p2x: number, p2y: number): EasingFn;
+export declare const bezierEase: EasingFn;
+export declare const bezierEaseIn: EasingFn;
+export declare const bezierEaseOut: EasingFn;
+export declare const bezierEaseInOut: EasingFn;
+//# sourceMappingURL=bezier.d.ts.map

package/dist/builders/bezier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bezier.d.ts","sourceRoot":"","sources":["../../src/builders/bezier.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAgD5C,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,QAAQ,CAgBnF;AAED,eAAO,MAAM,UAAU,UAA6B,CAAC;AACrD,eAAO,MAAM,YAAY,UAAwB,CAAC;AAClD,eAAO,MAAM,aAAa,UAAwB,CAAC;AACnD,eAAO,MAAM,eAAe,UAA2B,CAAC"}

package/dist/builders/bezier.js

@@ -0,0 +1,69 @@
+import { defineEasing } from "../define.js";
+const NEWTON_ITERATIONS = 8;
+const NEWTON_MIN_SLOPE = 1e-6;
+const SUBDIVISION_PRECISION = 1e-7;
+const SUBDIVISION_MAX_ITERATIONS = 32;
+function a(c1, c2) {
+    return 1 - 3 * c2 + 3 * c1;
+}
+function b(c1, c2) {
+    return 3 * c2 - 6 * c1;
+}
+function c(c1) {
+    return 3 * c1;
+}
+function sampleCurve(t, A, B, C) {
+    return ((A * t + B) * t + C) * t;
+}
+function sampleDerivative(t, A, B, C) {
+    return (3 * A * t + 2 * B) * t + C;
+}
+function solveCurveX(x, ax, bx, cx) {
+    let t = x;
+    for (let i = 0; i < NEWTON_ITERATIONS; i++) {
+        const slope = sampleDerivative(t, ax, bx, cx);
+        if (Math.abs(slope) < NEWTON_MIN_SLOPE)
+            break;
+        const currentX = sampleCurve(t, ax, bx, cx) - x;
+        t -= currentX / slope;
+    }
+    let lo = 0;
+    let hi = 1;
+    t = x;
+    if (t < lo)
+        return lo;
+    if (t > hi)
+        return hi;
+    for (let i = 0; i < SUBDIVISION_MAX_ITERATIONS; i++) {
+        const currentX = sampleCurve(t, ax, bx, cx);
+        if (Math.abs(currentX - x) < SUBDIVISION_PRECISION)
+            return t;
+        if (currentX < x)
+            lo = t;
+        else
+            hi = t;
+        t = (lo + hi) / 2;
+    }
+    return t;
+}
+export function bezier(p1x, p1y, p2x, p2y) {
+    if (p1x < 0 || p1x > 1 || p2x < 0 || p2x > 1) {
+        throw new RangeError(`bezier: control point x coordinates must be in [0, 1]; got p1x=${p1x}, p2x=${p2x}`);
+    }
+    const ax = a(p1x, p2x);
+    const bx = b(p1x, p2x);
+    const cx = c(p1x);
+    const ay = a(p1y, p2y);
+    const by = b(p1y, p2y);
+    const cy = c(p1y);
+    const linear = p1x === p1y && p2x === p2y;
+    const name = `bezier(${p1x}, ${p1y}, ${p2x}, ${p2y})`;
+    if (linear)
+        return defineEasing(name, (t) => t);
+    return defineEasing(name, (t) => sampleCurve(solveCurveX(t, ax, bx, cx), ay, by, cy));
+}
+export const bezierEase = bezier(0.25, 0.1, 0.25, 1);
+export const bezierEaseIn = bezier(0.42, 0, 1, 1);
+export const bezierEaseOut = bezier(0, 0, 0.58, 1);
+export const bezierEaseInOut = bezier(0.42, 0, 0.58, 1);
+//# sourceMappingURL=bezier.js.map

package/dist/builders/bezier.js.map

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

package/dist/builders/breathe.d.ts

@@ -0,0 +1,11 @@
+export type BreatheParams = {
+    /**
+     * Number of in-out breath cycles across [0, 1]. 0.5 = single inhale
+     * (0 → 1). 1 = inhale + exhale (0 → 1 → 0). 2 = two full cycles. The
+     * curve oscillates in [0, 1] so it maps cleanly to opacity / scale /
+     * any normalised animatable.
+     */
+    cycles: number;
+};
+export declare const breathe: import("../types.js").ParametricEasing<BreatheParams>;
+//# sourceMappingURL=breathe.d.ts.map

package/dist/builders/breathe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"breathe.d.ts","sourceRoot":"","sources":["../../src/builders/breathe.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,aAAa,GAAG;IAC1B;;;;;OAKG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAYF,eAAO,MAAM,OAAO,uDAQnB,CAAC"}

package/dist/builders/breathe.js

@@ -0,0 +1,14 @@
+import { defineParametricEasing } from "../define.js";
+const DEFAULTS = { cycles: 1 };
+const TAU = Math.PI * 2;
+// (1 - cos(τ·c·t)) / 2 — cosine wave shifted into [0, 1]. Distinct from
+// `wiggle` (which oscillates [-1, 1] for shake/vibration); breathe
+// stays positive and is intended for idle/ambient animations.
+//
+// exactEndpoints: false — for cycles ≠ 0.5n, the natural curve doesn't
+// land at 1 at t=1, and clamping defeats the rhythmic intent.
+export const breathe = defineParametricEasing("breathe", DEFAULTS, ({ cycles }) => {
+    const c = Math.max(0, cycles);
+    return (t) => (1 - Math.cos(TAU * c * t)) / 2;
+}, { exactEndpoints: false });
+//# sourceMappingURL=breathe.js.map

package/dist/builders/breathe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"breathe.js","sourceRoot":"","sources":["../../src/builders/breathe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAYtD,MAAM,QAAQ,GAAkB,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;AAE9C,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;AAExB,wEAAwE;AACxE,mEAAmE;AACnE,8DAA8D;AAC9D,EAAE;AACF,uEAAuE;AACvE,8DAA8D;AAC9D,MAAM,CAAC,MAAM,OAAO,GAAG,sBAAsB,CAC3C,SAAS,EACT,QAAQ,EACR,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;IACb,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC9B,OAAO,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAChD,CAAC,EACD,EAAE,cAAc,EAAE,KAAK,EAAE,CAC1B,CAAC"}

package/dist/builders/custom.d.ts

@@ -0,0 +1,13 @@
+import type { EasingFn } from "../types.js";
+export type CustomPoint = readonly [x: number, y: number];
+/**
+ * Build an easing from a sequence of (x, y) control points, interpolated
+ * linearly between them. Use for hand-drawn curves, exported visualiser
+ * data, or any non-analytic easing shape.
+ *
+ * Points must be in ascending x order with x in [0, 1]. Endpoints are
+ * clamped to (0, 0) and (1, 1) by the framework — provide those points
+ * explicitly if you want to see the un-clamped curve.
+ */
+export declare function custom(points: ReadonlyArray<CustomPoint>): EasingFn;
+//# sourceMappingURL=custom.d.ts.map

package/dist/builders/custom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom.d.ts","sourceRoot":"","sources":["../../src/builders/custom.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,MAAM,WAAW,GAAG,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;AAE1D;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,WAAW,CAAC,GAAG,QAAQ,CA4BnE"}

package/dist/builders/custom.js

@@ -0,0 +1,40 @@
+import { defineEasing } from "../define.js";
+/**
+ * Build an easing from a sequence of (x, y) control points, interpolated
+ * linearly between them. Use for hand-drawn curves, exported visualiser
+ * data, or any non-analytic easing shape.
+ *
+ * Points must be in ascending x order with x in [0, 1]. Endpoints are
+ * clamped to (0, 0) and (1, 1) by the framework — provide those points
+ * explicitly if you want to see the un-clamped curve.
+ */
+export function custom(points) {
+    if (points.length < 2) {
+        throw new RangeError(`custom: at least 2 points required; got ${points.length}`);
+    }
+    for (let i = 1; i < points.length; i++) {
+        const prev = points[i - 1];
+        const curr = points[i];
+        if (curr[0] < prev[0]) {
+            throw new RangeError(`custom: points must be sorted by ascending x; got ${prev[0]} then ${curr[0]} at index ${i}`);
+        }
+    }
+    const name = `custom(${points.length} points)`;
+    return defineEasing(name, (t) => {
+        if (t <= points[0][0])
+            return points[0][1];
+        for (let i = 1; i < points.length; i++) {
+            const [x1, y1] = points[i];
+            if (t <= x1) {
+                const [x0, y0] = points[i - 1];
+                const span = x1 - x0;
+                if (span === 0)
+                    return y1;
+                const u = (t - x0) / span;
+                return y0 + (y1 - y0) * u;
+            }
+        }
+        return points[points.length - 1][1];
+    });
+}
+//# sourceMappingURL=custom.js.map

package/dist/builders/custom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom.js","sourceRoot":"","sources":["../../src/builders/custom.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAK5C;;;;;;;;GAQG;AACH,MAAM,UAAU,MAAM,CAAC,MAAkC;IACvD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,UAAU,CAAC,2CAA2C,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACnF,CAAC;IACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;QACxB,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,UAAU,CAClB,qDAAqD,IAAI,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,CAC7F,CAAC;QACJ,CAAC;IACH,CAAC;IACD,MAAM,IAAI,GAAG,UAAU,MAAM,CAAC,MAAM,UAAU,CAAC;IAC/C,OAAO,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE;QAC9B,IAAI,CAAC,IAAI,MAAM,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC;YAAE,OAAO,MAAM,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC;QAC7C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;YAC5B,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;gBACZ,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;gBAChC,MAAM,IAAI,GAAG,EAAE,GAAG,EAAE,CAAC;gBACrB,IAAI,IAAI,KAAK,CAAC;oBAAE,OAAO,EAAE,CAAC;gBAC1B,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC;gBAC1B,OAAO,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC"}