@voila.dev/motion 0.0.0-stage → 5.0.0

package/dist/frame/driver.js

@@ -0,0 +1,42 @@
+function clock() {
+  return typeof performance === "undefined" ? Date.now() : performance.now();
+}
+function browserDriver() {
+  let handle;
+  const hasAnimationFrame = typeof requestAnimationFrame === "function";
+  return {
+    request(tick) {
+      handle = hasAnimationFrame ? requestAnimationFrame(tick) : setTimeout(() => tick(clock()), 1e3 / 60);
+    },
+    cancel() {
+      if (handle === void 0) return;
+      if (hasAnimationFrame) cancelAnimationFrame(handle);
+      else clearTimeout(handle);
+      handle = void 0;
+    },
+    now: clock
+  };
+}
+let injected;
+let fallback;
+const driverListeners = /* @__PURE__ */ new Set();
+function frameDriver() {
+  if (injected) return injected;
+  fallback ??= browserDriver();
+  return fallback;
+}
+function setFrameDriver(driver) {
+  const previous = frameDriver();
+  injected = driver;
+  for (const listener of driverListeners) listener(previous);
+}
+function onFrameDriverChange(listener) {
+  driverListeners.add(listener);
+  return () => driverListeners.delete(listener);
+}
+export {
+  frameDriver,
+  onFrameDriverChange,
+  setFrameDriver
+};
+//# sourceMappingURL=driver.js.map

package/dist/frame/driver.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/frame/driver.ts"],
+  "sourcesContent": ["/** What ticks the frame loop: the browser's frames by default, a test clock when injected. */\nexport interface FrameDriver {\n\trequest(tick: (timestamp: number) => void): void;\n\tcancel(): void;\n\t/** Milliseconds, on the same clock as the timestamps handed to `tick`. */\n\tnow(): number;\n}\n\nfunction clock(): number {\n\treturn typeof performance === \"undefined\" ? Date.now() : performance.now();\n}\n\n/** Read lazily so importing on the server never touches the browser globals. */\nfunction browserDriver(): FrameDriver {\n\tlet handle: number | ReturnType<typeof setTimeout> | undefined;\n\tconst hasAnimationFrame = typeof requestAnimationFrame === \"function\";\n\treturn {\n\t\trequest(tick) {\n\t\t\thandle = hasAnimationFrame\n\t\t\t\t? requestAnimationFrame(tick)\n\t\t\t\t: setTimeout(() => tick(clock()), 1000 / 60);\n\t\t},\n\t\tcancel() {\n\t\t\tif (handle === undefined) return;\n\t\t\tif (hasAnimationFrame) cancelAnimationFrame(handle as number);\n\t\t\telse clearTimeout(handle);\n\t\t\thandle = undefined;\n\t\t},\n\t\tnow: clock,\n\t};\n}\n\nlet injected: FrameDriver | undefined;\nlet fallback: FrameDriver | undefined;\nconst driverListeners = new Set<(previous: FrameDriver) => void>();\n\nexport function frameDriver(): FrameDriver {\n\tif (injected) return injected;\n\tfallback ??= browserDriver();\n\treturn fallback;\n}\n\n/** `undefined` restores the browser's frames. */\nexport function setFrameDriver(driver: FrameDriver | undefined): void {\n\tconst previous = frameDriver();\n\tinjected = driver;\n\tfor (const listener of driverListeners) listener(previous);\n}\n\n/** The loop listens so a driver swapped mid-animation carries the pending frame over. */\nexport function onFrameDriverChange(\n\tlistener: (previous: FrameDriver) => void,\n): () => void {\n\tdriverListeners.add(listener);\n\treturn () => driverListeners.delete(listener);\n}\n"],
+  "mappings": "AAQA,SAAS,QAAgB;AACxB,SAAO,OAAO,gBAAgB,cAAc,KAAK,IAAI,IAAI,YAAY,IAAI;AAC1E;AAGA,SAAS,gBAA6B;AACrC,MAAI;AACJ,QAAM,oBAAoB,OAAO,0BAA0B;AAC3D,SAAO;AAAA,IACN,QAAQ,MAAM;AACb,eAAS,oBACN,sBAAsB,IAAI,IAC1B,WAAW,MAAM,KAAK,MAAM,CAAC,GAAG,MAAO,EAAE;AAAA,IAC7C;AAAA,IACA,SAAS;AACR,UAAI,WAAW,OAAW;AAC1B,UAAI,kBAAmB,sBAAqB,MAAgB;AAAA,UACvD,cAAa,MAAM;AACxB,eAAS;AAAA,IACV;AAAA,IACA,KAAK;AAAA,EACN;AACD;AAEA,IAAI;AACJ,IAAI;AACJ,MAAM,kBAAkB,oBAAI,IAAqC;AAE1D,SAAS,cAA2B;AAC1C,MAAI,SAAU,QAAO;AACrB,eAAa,cAAc;AAC3B,SAAO;AACR;AAGO,SAAS,eAAe,QAAuC;AACrE,QAAM,WAAW,YAAY;AAC7B,aAAW;AACX,aAAW,YAAY,gBAAiB,UAAS,QAAQ;AAC1D;AAGO,SAAS,oBACf,UACa;AACb,kBAAgB,IAAI,QAAQ;AAC5B,SAAO,MAAM,gBAAgB,OAAO,QAAQ;AAC7C;",
+  "names": []
+}

package/dist/frame/frame.d.ts

@@ -0,0 +1,20 @@
+export interface FrameData {
+    /** Milliseconds since the previous frame, clamped so a backgrounded tab does not teleport. */
+    readonly delta: number;
+    readonly timestamp: number;
+}
+export type FrameCallback = (data: FrameData) => void;
+type Schedule = (callback: FrameCallback, keepAlive?: boolean) => FrameCallback;
+export declare const frame: {
+    readonly read: Schedule;
+    readonly update: Schedule;
+    readonly render: Schedule;
+};
+export declare function cancelFrame(callback: FrameCallback): void;
+export declare function frameData(): FrameData;
+/** Milliseconds; inside a frame, that frame's timestamp, so every value read in it agrees. */
+export declare function now(): number;
+/** For tests: forget every callback and the frame clock. */
+export declare function resetFrameLoop(): void;
+export {};
+//# sourceMappingURL=frame.d.ts.map

package/dist/frame/frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.d.ts","sourceRoot":"","sources":["../../src/frame/frame.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,SAAS;IACzB,8FAA8F;IAC9F,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;AAEtD,KAAK,QAAQ,GAAG,CAAC,QAAQ,EAAE,aAAa,EAAE,SAAS,CAAC,EAAE,OAAO,KAAK,aAAa,CAAC;AAuDhF,eAAO,MAAM,KAAK,EAAE;IACnB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;CACwC,CAAC;AAEpE,wBAAgB,WAAW,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAIzD;AAED,wBAAgB,SAAS,IAAI,SAAS,CAErC;AAED,8FAA8F;AAC9F,wBAAgB,GAAG,IAAI,MAAM,CAE5B;AAED,4DAA4D;AAC5D,wBAAgB,cAAc,IAAI,IAAI,CAOrC"}

package/dist/frame/frame.js

@@ -0,0 +1,77 @@
+import { frameDriver, onFrameDriverChange } from "./driver.js";
+const PHASES = ["read", "update", "render"];
+const IDEAL_DELTA = 1e3 / 60;
+const MAX_DELTA = 40;
+let pending = PHASES.map(() => /* @__PURE__ */ new Set());
+let running;
+let keepAlive = /* @__PURE__ */ new Set();
+let scheduled = false;
+let inFrame = false;
+let data = { delta: IDEAL_DELTA, timestamp: 0 };
+let lastTimestamp;
+function request() {
+  if (scheduled) return;
+  scheduled = true;
+  frameDriver().request(tick);
+}
+function tick(timestamp) {
+  scheduled = false;
+  const delta = lastTimestamp === void 0 ? IDEAL_DELTA : Math.max(1, Math.min(timestamp - lastTimestamp, MAX_DELTA));
+  data = { delta, timestamp };
+  inFrame = true;
+  pending.forEach((_, index) => {
+    running = pending[index];
+    pending[index] = /* @__PURE__ */ new Set();
+    for (const callback of running) {
+      callback(data);
+      if (keepAlive.has(callback)) pending[index].add(callback);
+    }
+  });
+  running = void 0;
+  inFrame = false;
+  const idle = pending.every((set) => set.size === 0);
+  lastTimestamp = idle ? void 0 : timestamp;
+  if (!idle) request();
+}
+function schedule(phase) {
+  return (callback, alive = false) => {
+    if (alive) keepAlive.add(callback);
+    pending[phase].add(callback);
+    request();
+    return callback;
+  };
+}
+const frame = { read: schedule(0), update: schedule(1), render: schedule(2) };
+function cancelFrame(callback) {
+  keepAlive.delete(callback);
+  running?.delete(callback);
+  for (const set of pending) set.delete(callback);
+}
+function frameData() {
+  return data;
+}
+function now() {
+  return inFrame ? data.timestamp : frameDriver().now();
+}
+function resetFrameLoop() {
+  if (scheduled) frameDriver().cancel();
+  pending = PHASES.map(() => /* @__PURE__ */ new Set());
+  keepAlive = /* @__PURE__ */ new Set();
+  scheduled = false;
+  lastTimestamp = void 0;
+  data = { delta: IDEAL_DELTA, timestamp: 0 };
+}
+onFrameDriverChange((previous) => {
+  if (!scheduled) return;
+  previous.cancel();
+  scheduled = false;
+  request();
+});
+export {
+  cancelFrame,
+  frame,
+  frameData,
+  now,
+  resetFrameLoop
+};
+//# sourceMappingURL=frame.js.map

package/dist/frame/frame.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/frame/frame.ts"],
+  "sourcesContent": ["import { frameDriver, onFrameDriverChange } from \"#/frame/driver.ts\";\n\nexport interface FrameData {\n\t/** Milliseconds since the previous frame, clamped so a backgrounded tab does not teleport. */\n\treadonly delta: number;\n\treadonly timestamp: number;\n}\n\nexport type FrameCallback = (data: FrameData) => void;\n\ntype Schedule = (callback: FrameCallback, keepAlive?: boolean) => FrameCallback;\n\nconst PHASES = [\"read\", \"update\", \"render\"] as const;\nconst IDEAL_DELTA = 1000 / 60;\nconst MAX_DELTA = 40;\n\nlet pending = PHASES.map(() => new Set<FrameCallback>());\nlet running: Set<FrameCallback> | undefined;\nlet keepAlive = new Set<FrameCallback>();\nlet scheduled = false;\nlet inFrame = false;\nlet data: FrameData = { delta: IDEAL_DELTA, timestamp: 0 };\nlet lastTimestamp: number | undefined;\n\nfunction request(): void {\n\tif (scheduled) return;\n\tscheduled = true;\n\tframeDriver().request(tick);\n}\n\nfunction tick(timestamp: number): void {\n\tscheduled = false;\n\tconst delta =\n\t\tlastTimestamp === undefined\n\t\t\t? IDEAL_DELTA\n\t\t\t: Math.max(1, Math.min(timestamp - lastTimestamp, MAX_DELTA));\n\tdata = { delta, timestamp };\n\tinFrame = true;\n\t// Swapping each phase's set as it starts is what makes the scheduling rule\n\t// hold: a later phase's set is still the one that will run, an earlier or\n\t// the current phase's set is already the next frame's.\n\tpending.forEach((_, index) => {\n\t\trunning = pending[index];\n\t\tpending[index] = new Set();\n\t\tfor (const callback of running) {\n\t\t\tcallback(data);\n\t\t\tif (keepAlive.has(callback)) pending[index].add(callback);\n\t\t}\n\t});\n\trunning = undefined;\n\tinFrame = false;\n\tconst idle = pending.every((set) => set.size === 0);\n\tlastTimestamp = idle ? undefined : timestamp;\n\tif (!idle) request();\n}\n\nfunction schedule(phase: number): Schedule {\n\treturn (callback, alive = false) => {\n\t\tif (alive) keepAlive.add(callback);\n\t\tpending[phase].add(callback);\n\t\trequest();\n\t\treturn callback;\n\t};\n}\n\nexport const frame: {\n\treadonly read: Schedule;\n\treadonly update: Schedule;\n\treadonly render: Schedule;\n} = { read: schedule(0), update: schedule(1), render: schedule(2) };\n\nexport function cancelFrame(callback: FrameCallback): void {\n\tkeepAlive.delete(callback);\n\trunning?.delete(callback);\n\tfor (const set of pending) set.delete(callback);\n}\n\nexport function frameData(): FrameData {\n\treturn data;\n}\n\n/** Milliseconds; inside a frame, that frame's timestamp, so every value read in it agrees. */\nexport function now(): number {\n\treturn inFrame ? data.timestamp : frameDriver().now();\n}\n\n/** For tests: forget every callback and the frame clock. */\nexport function resetFrameLoop(): void {\n\tif (scheduled) frameDriver().cancel();\n\tpending = PHASES.map(() => new Set<FrameCallback>());\n\tkeepAlive = new Set();\n\tscheduled = false;\n\tlastTimestamp = undefined;\n\tdata = { delta: IDEAL_DELTA, timestamp: 0 };\n}\n\nonFrameDriverChange((previous) => {\n\tif (!scheduled) return;\n\tprevious.cancel();\n\tscheduled = false;\n\trequest();\n});\n"],
+  "mappings": "AAAA,SAAS,aAAa,2BAA2B;AAYjD,MAAM,SAAS,CAAC,QAAQ,UAAU,QAAQ;AAC1C,MAAM,cAAc,MAAO;AAC3B,MAAM,YAAY;AAElB,IAAI,UAAU,OAAO,IAAI,MAAM,oBAAI,IAAmB,CAAC;AACvD,IAAI;AACJ,IAAI,YAAY,oBAAI,IAAmB;AACvC,IAAI,YAAY;AAChB,IAAI,UAAU;AACd,IAAI,OAAkB,EAAE,OAAO,aAAa,WAAW,EAAE;AACzD,IAAI;AAEJ,SAAS,UAAgB;AACxB,MAAI,UAAW;AACf,cAAY;AACZ,cAAY,EAAE,QAAQ,IAAI;AAC3B;AAEA,SAAS,KAAK,WAAyB;AACtC,cAAY;AACZ,QAAM,QACL,kBAAkB,SACf,cACA,KAAK,IAAI,GAAG,KAAK,IAAI,YAAY,eAAe,SAAS,CAAC;AAC9D,SAAO,EAAE,OAAO,UAAU;AAC1B,YAAU;AAIV,UAAQ,QAAQ,CAAC,GAAG,UAAU;AAC7B,cAAU,QAAQ,KAAK;AACvB,YAAQ,KAAK,IAAI,oBAAI,IAAI;AACzB,eAAW,YAAY,SAAS;AAC/B,eAAS,IAAI;AACb,UAAI,UAAU,IAAI,QAAQ,EAAG,SAAQ,KAAK,EAAE,IAAI,QAAQ;AAAA,IACzD;AAAA,EACD,CAAC;AACD,YAAU;AACV,YAAU;AACV,QAAM,OAAO,QAAQ,MAAM,CAAC,QAAQ,IAAI,SAAS,CAAC;AAClD,kBAAgB,OAAO,SAAY;AACnC,MAAI,CAAC,KAAM,SAAQ;AACpB;AAEA,SAAS,SAAS,OAAyB;AAC1C,SAAO,CAAC,UAAU,QAAQ,UAAU;AACnC,QAAI,MAAO,WAAU,IAAI,QAAQ;AACjC,YAAQ,KAAK,EAAE,IAAI,QAAQ;AAC3B,YAAQ;AACR,WAAO;AAAA,EACR;AACD;AAEO,MAAM,QAIT,EAAE,MAAM,SAAS,CAAC,GAAG,QAAQ,SAAS,CAAC,GAAG,QAAQ,SAAS,CAAC,EAAE;AAE3D,SAAS,YAAY,UAA+B;AAC1D,YAAU,OAAO,QAAQ;AACzB,WAAS,OAAO,QAAQ;AACxB,aAAW,OAAO,QAAS,KAAI,OAAO,QAAQ;AAC/C;AAEO,SAAS,YAAuB;AACtC,SAAO;AACR;AAGO,SAAS,MAAc;AAC7B,SAAO,UAAU,KAAK,YAAY,YAAY,EAAE,IAAI;AACrD;AAGO,SAAS,iBAAuB;AACtC,MAAI,UAAW,aAAY,EAAE,OAAO;AACpC,YAAU,OAAO,IAAI,MAAM,oBAAI,IAAmB,CAAC;AACnD,cAAY,oBAAI,IAAI;AACpB,cAAY;AACZ,kBAAgB;AAChB,SAAO,EAAE,OAAO,aAAa,WAAW,EAAE;AAC3C;AAEA,oBAAoB,CAAC,aAAa;AACjC,MAAI,CAAC,UAAW;AAChB,WAAS,OAAO;AAChB,cAAY;AACZ,UAAQ;AACT,CAAC;",
+  "names": []
+}

package/dist/generators/inertia.d.ts

@@ -0,0 +1,20 @@
+import type { Generator } from "./types.js";
+export interface InertiaOptions {
+    readonly from: number;
+    /** Units per second, typically a gesture's release velocity. */
+    readonly velocity: number;
+    /** How far the throw carries: target = from + power × velocity. */
+    readonly power?: number;
+    /** Seconds; higher glides longer. */
+    readonly timeConstant?: number;
+    readonly min?: number;
+    readonly max?: number;
+    readonly bounceStiffness?: number;
+    readonly bounceDamping?: number;
+    readonly restDelta?: number;
+    /** Snap the natural resting point, e.g. to a grid. */
+    readonly modifyTarget?: (target: number) => number;
+}
+/** A throw decaying exponentially, handing over to a spring when it hits `min` or `max`. */
+export declare function inertia(options: InertiaOptions): Generator;
+//# sourceMappingURL=inertia.d.ts.map

package/dist/generators/inertia.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inertia.d.ts","sourceRoot":"","sources":["../../src/generators/inertia.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,uBAAuB,CAAC;AAEvE,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,mEAAmE;IACnE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,qCAAqC;IACrC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,sDAAsD;IACtD,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;CACnD;AAaD,4FAA4F;AAC5F,wBAAgB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,CAuD1D"}

package/dist/generators/inertia.js

@@ -0,0 +1,59 @@
+import { spring } from "./spring.js";
+function boundBeyond(value, min, max) {
+  if (min !== void 0 && value < min) {
+    return min;
+  }
+  if (max !== void 0 && value > max) {
+    return max;
+  }
+  return void 0;
+}
+function inertia(options) {
+  const { from, velocity, min, max } = options;
+  const timeConstant = options.timeConstant ?? 0.325;
+  const restDelta = options.restDelta ?? 0.5;
+  function bounce(start, startVelocity, bound2) {
+    return spring({
+      from: start,
+      to: bound2,
+      velocity: startVelocity,
+      stiffness: options.bounceStiffness ?? 500,
+      damping: options.bounceDamping ?? 10,
+      restDelta
+    });
+  }
+  const outside = boundBeyond(from, min, max);
+  if (outside !== void 0) {
+    return bounce(from, velocity, outside);
+  }
+  const ideal = from + (options.power ?? 0.8) * velocity;
+  const target = options.modifyTarget?.(ideal) ?? ideal;
+  const amplitude = target - from;
+  function decay(t) {
+    const remaining = amplitude * Math.exp(-t / timeConstant);
+    return {
+      value: target - remaining,
+      velocity: remaining / timeConstant,
+      done: false
+    };
+  }
+  const settle = Math.abs(amplitude) > restDelta ? timeConstant * Math.log(Math.abs(amplitude) / restDelta) : 0;
+  const bound = boundBeyond(target, min, max);
+  if (bound === void 0) {
+    return {
+      duration: settle,
+      at: (elapsed) => elapsed >= settle ? { value: target, velocity: 0, done: true } : decay(Math.max(0, elapsed))
+    };
+  }
+  const hit = -timeConstant * Math.log((target - bound) / amplitude);
+  const atHit = decay(hit);
+  const handover = bounce(bound, atHit.velocity, bound);
+  return {
+    duration: hit + handover.duration,
+    at: (elapsed) => elapsed < hit ? decay(Math.max(0, elapsed)) : handover.at(elapsed - hit)
+  };
+}
+export {
+  inertia
+};
+//# sourceMappingURL=inertia.js.map

package/dist/generators/inertia.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/generators/inertia.ts"],
+  "sourcesContent": ["import { spring } from \"#/generators/spring.ts\";\nimport type { Generator, GeneratorState } from \"#/generators/types.ts\";\n\nexport interface InertiaOptions {\n\treadonly from: number;\n\t/** Units per second, typically a gesture's release velocity. */\n\treadonly velocity: number;\n\t/** How far the throw carries: target = from + power \u00D7 velocity. */\n\treadonly power?: number;\n\t/** Seconds; higher glides longer. */\n\treadonly timeConstant?: number;\n\treadonly min?: number;\n\treadonly max?: number;\n\treadonly bounceStiffness?: number;\n\treadonly bounceDamping?: number;\n\treadonly restDelta?: number;\n\t/** Snap the natural resting point, e.g. to a grid. */\n\treadonly modifyTarget?: (target: number) => number;\n}\n\n/** The bound the value is past or heading past, if any. */\nfunction boundBeyond(value: number, min?: number, max?: number) {\n\tif (min !== undefined && value < min) {\n\t\treturn min;\n\t}\n\tif (max !== undefined && value > max) {\n\t\treturn max;\n\t}\n\treturn undefined;\n}\n\n/** A throw decaying exponentially, handing over to a spring when it hits `min` or `max`. */\nexport function inertia(options: InertiaOptions): Generator {\n\tconst { from, velocity, min, max } = options;\n\tconst timeConstant = options.timeConstant ?? 0.325;\n\tconst restDelta = options.restDelta ?? 0.5;\n\tfunction bounce(start: number, startVelocity: number, bound: number) {\n\t\treturn spring({\n\t\t\tfrom: start,\n\t\t\tto: bound,\n\t\t\tvelocity: startVelocity,\n\t\t\tstiffness: options.bounceStiffness ?? 500,\n\t\t\tdamping: options.bounceDamping ?? 10,\n\t\t\trestDelta,\n\t\t});\n\t}\n\n\tconst outside = boundBeyond(from, min, max);\n\tif (outside !== undefined) {\n\t\treturn bounce(from, velocity, outside);\n\t}\n\n\tconst ideal = from + (options.power ?? 0.8) * velocity;\n\tconst target = options.modifyTarget?.(ideal) ?? ideal;\n\tconst amplitude = target - from;\n\tfunction decay(t: number): GeneratorState {\n\t\tconst remaining = amplitude * Math.exp(-t / timeConstant);\n\t\treturn {\n\t\t\tvalue: target - remaining,\n\t\t\tvelocity: remaining / timeConstant,\n\t\t\tdone: false,\n\t\t};\n\t}\n\tconst settle =\n\t\tMath.abs(amplitude) > restDelta\n\t\t\t? timeConstant * Math.log(Math.abs(amplitude) / restDelta)\n\t\t\t: 0;\n\n\tconst bound = boundBeyond(target, min, max);\n\tif (bound === undefined) {\n\t\treturn {\n\t\t\tduration: settle,\n\t\t\tat: (elapsed) =>\n\t\t\t\telapsed >= settle\n\t\t\t\t\t? { value: target, velocity: 0, done: true }\n\t\t\t\t\t: decay(Math.max(0, elapsed)),\n\t\t};\n\t}\n\n\tconst hit = -timeConstant * Math.log((target - bound) / amplitude);\n\tconst atHit = decay(hit);\n\tconst handover = bounce(bound, atHit.velocity, bound);\n\treturn {\n\t\tduration: hit + handover.duration,\n\t\tat: (elapsed) =>\n\t\t\telapsed < hit ? decay(Math.max(0, elapsed)) : handover.at(elapsed - hit),\n\t};\n}\n"],
+  "mappings": "AAAA,SAAS,cAAc;AAqBvB,SAAS,YAAY,OAAe,KAAc,KAAc;AAC/D,MAAI,QAAQ,UAAa,QAAQ,KAAK;AACrC,WAAO;AAAA,EACR;AACA,MAAI,QAAQ,UAAa,QAAQ,KAAK;AACrC,WAAO;AAAA,EACR;AACA,SAAO;AACR;AAGO,SAAS,QAAQ,SAAoC;AAC3D,QAAM,EAAE,MAAM,UAAU,KAAK,IAAI,IAAI;AACrC,QAAM,eAAe,QAAQ,gBAAgB;AAC7C,QAAM,YAAY,QAAQ,aAAa;AACvC,WAAS,OAAO,OAAe,eAAuBA,QAAe;AACpE,WAAO,OAAO;AAAA,MACb,MAAM;AAAA,MACN,IAAIA;AAAA,MACJ,UAAU;AAAA,MACV,WAAW,QAAQ,mBAAmB;AAAA,MACtC,SAAS,QAAQ,iBAAiB;AAAA,MAClC;AAAA,IACD,CAAC;AAAA,EACF;AAEA,QAAM,UAAU,YAAY,MAAM,KAAK,GAAG;AAC1C,MAAI,YAAY,QAAW;AAC1B,WAAO,OAAO,MAAM,UAAU,OAAO;AAAA,EACtC;AAEA,QAAM,QAAQ,QAAQ,QAAQ,SAAS,OAAO;AAC9C,QAAM,SAAS,QAAQ,eAAe,KAAK,KAAK;AAChD,QAAM,YAAY,SAAS;AAC3B,WAAS,MAAM,GAA2B;AACzC,UAAM,YAAY,YAAY,KAAK,IAAI,CAAC,IAAI,YAAY;AACxD,WAAO;AAAA,MACN,OAAO,SAAS;AAAA,MAChB,UAAU,YAAY;AAAA,MACtB,MAAM;AAAA,IACP;AAAA,EACD;AACA,QAAM,SACL,KAAK,IAAI,SAAS,IAAI,YACnB,eAAe,KAAK,IAAI,KAAK,IAAI,SAAS,IAAI,SAAS,IACvD;AAEJ,QAAM,QAAQ,YAAY,QAAQ,KAAK,GAAG;AAC1C,MAAI,UAAU,QAAW;AACxB,WAAO;AAAA,MACN,UAAU;AAAA,MACV,IAAI,CAAC,YACJ,WAAW,SACR,EAAE,OAAO,QAAQ,UAAU,GAAG,MAAM,KAAK,IACzC,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC;AAAA,IAC/B;AAAA,EACD;AAEA,QAAM,MAAM,CAAC,eAAe,KAAK,KAAK,SAAS,SAAS,SAAS;AACjE,QAAM,QAAQ,MAAM,GAAG;AACvB,QAAM,WAAW,OAAO,OAAO,MAAM,UAAU,KAAK;AACpD,SAAO;AAAA,IACN,UAAU,MAAM,SAAS;AAAA,IACzB,IAAI,CAAC,YACJ,UAAU,MAAM,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,SAAS,GAAG,UAAU,GAAG;AAAA,EACzE;AACD;",
+  "names": ["bound"]
+}

package/dist/generators/spring.d.ts

@@ -0,0 +1,17 @@
+import type { Generator, SpringOptions } from "./types.js";
+export interface SpringPhysics {
+    readonly stiffness: number;
+    readonly damping: number;
+    readonly mass: number;
+}
+/**
+ * Duration and bounce to physics, SwiftUI's mapping: the undamped period is
+ * the perceived duration, and the damping ratio is `1 - bounce`.
+ */
+export declare function springPhysics(options?: SpringOptions): SpringPhysics;
+export declare function spring(options: SpringOptions & {
+    from: number;
+    to: number;
+    velocity?: number;
+}): Generator;
+//# sourceMappingURL=spring.d.ts.map

package/dist/generators/spring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spring.d.ts","sourceRoot":"","sources":["../../src/generators/spring.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,SAAS,EAET,aAAa,EACb,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACtB;AAMD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,aAAkB,GAAG,aAAa,CAgBxE;AAoDD,wBAAgB,MAAM,CACrB,OAAO,EAAE,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACtE,SAAS,CA0BX"}

package/dist/generators/spring.js

@@ -0,0 +1,87 @@
+const MAX_DURATION = 20;
+const SETTLE_STEP = 5e-3;
+function springPhysics(options = {}) {
+  const { stiffness, damping, mass } = options;
+  if (stiffness !== void 0 || damping !== void 0 || mass !== void 0) {
+    return {
+      stiffness: stiffness ?? 100,
+      damping: damping ?? 10,
+      mass: mass ?? 1
+    };
+  }
+  const duration = Math.max(options.duration ?? 0.3, 1e-3);
+  const bounce = Math.min(Math.max(options.bounce ?? 0, 0), 0.95);
+  return {
+    stiffness: (2 * Math.PI / duration) ** 2,
+    damping: 4 * Math.PI * (1 - bounce) / duration,
+    mass: 1
+  };
+}
+function oscillator(physics, x0, v0) {
+  const omega = Math.sqrt(physics.stiffness / physics.mass);
+  const zeta = physics.damping / (2 * Math.sqrt(physics.stiffness * physics.mass));
+  if (Math.abs(zeta - 1) < 1e-6) {
+    const c = v0 + omega * x0;
+    return (t) => {
+      const decay = Math.exp(-omega * t);
+      return [decay * (x0 + c * t), decay * (c - omega * (x0 + c * t))];
+    };
+  }
+  if (zeta < 1) {
+    const omegaD = omega * Math.sqrt(1 - zeta * zeta);
+    const b = (v0 + zeta * omega * x0) / omegaD;
+    return (t) => {
+      const decay = Math.exp(-zeta * omega * t);
+      const cos = Math.cos(omegaD * t);
+      const sin = Math.sin(omegaD * t);
+      const x = x0 * cos + b * sin;
+      return [
+        decay * x,
+        decay * (-zeta * omega * x + omegaD * (b * cos - x0 * sin))
+      ];
+    };
+  }
+  const root = omega * Math.sqrt(zeta * zeta - 1);
+  const r1 = -zeta * omega + root;
+  const r2 = -zeta * omega - root;
+  const c2 = (v0 - r1 * x0) / (r2 - r1);
+  const c1 = x0 - c2;
+  return (t) => {
+    const e1 = c1 * Math.exp(r1 * t);
+    const e2 = c2 * Math.exp(r2 * t);
+    return [e1 + e2, r1 * e1 + r2 * e2];
+  };
+}
+function restThresholds(options, span) {
+  const restDelta = options.restDelta ?? Math.max(span, 1) * 1e-3;
+  return { restDelta, restSpeed: options.restSpeed ?? restDelta * 10 };
+}
+function spring(options) {
+  const { from, to } = options;
+  const velocity = options.velocity ?? 0;
+  const displacement = oscillator(springPhysics(options), from - to, velocity);
+  const { restDelta, restSpeed } = restThresholds(options, Math.abs(to - from));
+  function atRest(t) {
+    const [x, v] = displacement(t);
+    return Math.abs(x) <= restDelta && Math.abs(v) <= restSpeed;
+  }
+  let duration = 0;
+  while (duration < MAX_DURATION && !atRest(duration)) {
+    duration += SETTLE_STEP;
+  }
+  return {
+    duration,
+    at(elapsed) {
+      if (elapsed >= duration) {
+        return { value: to, velocity: 0, done: true };
+      }
+      const [x, v] = displacement(Math.max(0, elapsed));
+      return { value: to + x, velocity: v, done: false };
+    }
+  };
+}
+export {
+  spring,
+  springPhysics
+};
+//# sourceMappingURL=spring.js.map

package/dist/generators/spring.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/generators/spring.ts"],
+  "sourcesContent": ["import type {\n\tGenerator,\n\tGeneratorState,\n\tSpringOptions,\n} from \"#/generators/types.ts\";\n\nexport interface SpringPhysics {\n\treadonly stiffness: number;\n\treadonly damping: number;\n\treadonly mass: number;\n}\n\n/** A spring that never settles would animate forever: stop looking after this. */\nconst MAX_DURATION = 20;\nconst SETTLE_STEP = 0.005;\n\n/**\n * Duration and bounce to physics, SwiftUI's mapping: the undamped period is\n * the perceived duration, and the damping ratio is `1 - bounce`.\n */\nexport function springPhysics(options: SpringOptions = {}): SpringPhysics {\n\tconst { stiffness, damping, mass } = options;\n\tif (stiffness !== undefined || damping !== undefined || mass !== undefined) {\n\t\treturn {\n\t\t\tstiffness: stiffness ?? 100,\n\t\t\tdamping: damping ?? 10,\n\t\t\tmass: mass ?? 1,\n\t\t};\n\t}\n\tconst duration = Math.max(options.duration ?? 0.3, 0.001);\n\tconst bounce = Math.min(Math.max(options.bounce ?? 0, 0), 0.95);\n\treturn {\n\t\tstiffness: ((2 * Math.PI) / duration) ** 2,\n\t\tdamping: (4 * Math.PI * (1 - bounce)) / duration,\n\t\tmass: 1,\n\t};\n}\n\ntype Displacement = (t: number) => readonly [number, number];\n\n/** The damped oscillator's closed form: displacement from the target and its velocity at `t`. */\nfunction oscillator(\n\tphysics: SpringPhysics,\n\tx0: number,\n\tv0: number,\n): Displacement {\n\tconst omega = Math.sqrt(physics.stiffness / physics.mass);\n\tconst zeta =\n\t\tphysics.damping / (2 * Math.sqrt(physics.stiffness * physics.mass));\n\tif (Math.abs(zeta - 1) < 1e-6) {\n\t\tconst c = v0 + omega * x0;\n\t\treturn (t) => {\n\t\t\tconst decay = Math.exp(-omega * t);\n\t\t\treturn [decay * (x0 + c * t), decay * (c - omega * (x0 + c * t))];\n\t\t};\n\t}\n\tif (zeta < 1) {\n\t\tconst omegaD = omega * Math.sqrt(1 - zeta * zeta);\n\t\tconst b = (v0 + zeta * omega * x0) / omegaD;\n\t\treturn (t) => {\n\t\t\tconst decay = Math.exp(-zeta * omega * t);\n\t\t\tconst cos = Math.cos(omegaD * t);\n\t\t\tconst sin = Math.sin(omegaD * t);\n\t\t\tconst x = x0 * cos + b * sin;\n\t\t\treturn [\n\t\t\t\tdecay * x,\n\t\t\t\tdecay * (-zeta * omega * x + omegaD * (b * cos - x0 * sin)),\n\t\t\t];\n\t\t};\n\t}\n\tconst root = omega * Math.sqrt(zeta * zeta - 1);\n\tconst r1 = -zeta * omega + root;\n\tconst r2 = -zeta * omega - root;\n\tconst c2 = (v0 - r1 * x0) / (r2 - r1);\n\tconst c1 = x0 - c2;\n\treturn (t) => {\n\t\tconst e1 = c1 * Math.exp(r1 * t);\n\t\tconst e2 = c2 * Math.exp(r2 * t);\n\t\treturn [e1 + e2, r1 * e1 + r2 * e2];\n\t};\n}\n\n/** Rest thresholds scale with the motion, so 0\u21921 and 0\u21921000 both settle to the eye. */\nfunction restThresholds(options: SpringOptions, span: number) {\n\tconst restDelta = options.restDelta ?? Math.max(span, 1) * 0.001;\n\treturn { restDelta, restSpeed: options.restSpeed ?? restDelta * 10 };\n}\n\nexport function spring(\n\toptions: SpringOptions & { from: number; to: number; velocity?: number },\n): Generator {\n\tconst { from, to } = options;\n\tconst velocity = options.velocity ?? 0;\n\tconst displacement = oscillator(springPhysics(options), from - to, velocity);\n\tconst { restDelta, restSpeed } = restThresholds(options, Math.abs(to - from));\n\n\tfunction atRest(t: number): boolean {\n\t\tconst [x, v] = displacement(t);\n\t\treturn Math.abs(x) <= restDelta && Math.abs(v) <= restSpeed;\n\t}\n\n\tlet duration = 0;\n\twhile (duration < MAX_DURATION && !atRest(duration)) {\n\t\tduration += SETTLE_STEP;\n\t}\n\n\treturn {\n\t\tduration,\n\t\tat(elapsed): GeneratorState {\n\t\t\tif (elapsed >= duration) {\n\t\t\t\treturn { value: to, velocity: 0, done: true };\n\t\t\t}\n\t\t\tconst [x, v] = displacement(Math.max(0, elapsed));\n\t\t\treturn { value: to + x, velocity: v, done: false };\n\t\t},\n\t};\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/generators/tween.d.ts

@@ -0,0 +1,15 @@
+import type { EasingDefinition } from "../easing/types.js";
+import type { Generator } from "./types.js";
+export interface TweenOptions {
+    readonly keyframes: readonly number[];
+    /** Seconds, default 0.3. */
+    readonly duration?: number;
+    /** One easing for every segment, or one per segment. */
+    readonly ease?: EasingDefinition | readonly EasingDefinition[];
+    /** Each keyframe's offset in 0..1, default evenly spaced. */
+    readonly times?: readonly number[];
+    /** A tween's shape is fixed by its easing; accepted so options pass through unchanged. */
+    readonly velocity?: number;
+}
+export declare function tween(options: TweenOptions): Generator;
+//# sourceMappingURL=tween.d.ts.map

package/dist/generators/tween.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tween.d.ts","sourceRoot":"","sources":["../../src/generators/tween.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,uBAAuB,CAAC;AAEvE,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,4BAA4B;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,wDAAwD;IACxD,QAAQ,CAAC,IAAI,CAAC,EAAE,gBAAgB,GAAG,SAAS,gBAAgB,EAAE,CAAC;IAC/D,6DAA6D;IAC7D,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,0FAA0F;IAC1F,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC3B;AAWD,wBAAgB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,SAAS,CAgDtD"}

package/dist/generators/tween.js

@@ -0,0 +1,51 @@
+import { easeOut, resolveEasing } from "../easing/named.js";
+const VELOCITY_WINDOW = 5e-3;
+function isEasingList(ease) {
+  return Array.isArray(ease) && typeof ease[0] !== "number";
+}
+function tween(options) {
+  const { keyframes } = options;
+  const duration = Math.max(0, options.duration ?? 0.3);
+  const last = keyframes.length - 1;
+  const times = options.times ?? keyframes.map((_unused, index) => last === 0 ? 0 : index / last);
+  const eases = Array.from({ length: Math.max(last, 1) }, (_unused, index) => {
+    const ease = options.ease;
+    if (ease === void 0) {
+      return easeOut;
+    }
+    return resolveEasing(
+      isEasingList(ease) ? ease[index] ?? ease[ease.length - 1] ?? "easeOut" : ease
+    );
+  });
+  function valueAt(elapsed) {
+    const progress = duration === 0 ? 1 : Math.min(1, Math.max(0, elapsed / duration));
+    let segment = 0;
+    while (segment < last - 1 && progress > (times[segment + 1] ?? 1)) {
+      segment += 1;
+    }
+    const start = times[segment] ?? 0;
+    const end = times[segment + 1] ?? 1;
+    const from = keyframes[segment] ?? 0;
+    const to = keyframes[segment + 1] ?? from;
+    const local = end === start ? 1 : (progress - start) / (end - start);
+    const eased = (eases[segment] ?? easeOut)(Math.min(1, Math.max(0, local)));
+    return from + (to - from) * eased;
+  }
+  return {
+    duration,
+    at(elapsed) {
+      if (elapsed >= duration) {
+        return { value: keyframes[last] ?? 0, velocity: 0, done: true };
+      }
+      const value = valueAt(elapsed);
+      const before = Math.max(0, elapsed - VELOCITY_WINDOW);
+      const after = before === elapsed ? elapsed + VELOCITY_WINDOW : elapsed;
+      const velocity = (valueAt(after) - valueAt(before)) / (after - before);
+      return { value, velocity, done: false };
+    }
+  };
+}
+export {
+  tween
+};
+//# sourceMappingURL=tween.js.map

package/dist/generators/tween.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/generators/tween.ts"],
+  "sourcesContent": ["import { easeOut, resolveEasing } from \"#/easing/named.ts\";\nimport type { EasingDefinition } from \"#/easing/types.ts\";\nimport type { Generator, GeneratorState } from \"#/generators/types.ts\";\n\nexport interface TweenOptions {\n\treadonly keyframes: readonly number[];\n\t/** Seconds, default 0.3. */\n\treadonly duration?: number;\n\t/** One easing for every segment, or one per segment. */\n\treadonly ease?: EasingDefinition | readonly EasingDefinition[];\n\t/** Each keyframe's offset in 0..1, default evenly spaced. */\n\treadonly times?: readonly number[];\n\t/** A tween's shape is fixed by its easing; accepted so options pass through unchanged. */\n\treadonly velocity?: number;\n}\n\n/** Window for the finite difference that reports velocity. */\nconst VELOCITY_WINDOW = 0.005;\n\nfunction isEasingList(\n\tease: TweenOptions[\"ease\"],\n): ease is readonly EasingDefinition[] {\n\treturn Array.isArray(ease) && typeof ease[0] !== \"number\";\n}\n\nexport function tween(options: TweenOptions): Generator {\n\tconst { keyframes } = options;\n\tconst duration = Math.max(0, options.duration ?? 0.3);\n\tconst last = keyframes.length - 1;\n\tconst times =\n\t\toptions.times ??\n\t\tkeyframes.map((_unused, index) => (last === 0 ? 0 : index / last));\n\tconst eases = Array.from({ length: Math.max(last, 1) }, (_unused, index) => {\n\t\tconst ease = options.ease;\n\t\tif (ease === undefined) {\n\t\t\treturn easeOut;\n\t\t}\n\t\treturn resolveEasing(\n\t\t\tisEasingList(ease)\n\t\t\t\t? (ease[index] ?? ease[ease.length - 1] ?? \"easeOut\")\n\t\t\t\t: ease,\n\t\t);\n\t});\n\n\tfunction valueAt(elapsed: number): number {\n\t\tconst progress =\n\t\t\tduration === 0 ? 1 : Math.min(1, Math.max(0, elapsed / duration));\n\t\tlet segment = 0;\n\t\twhile (segment < last - 1 && progress > (times[segment + 1] ?? 1)) {\n\t\t\tsegment += 1;\n\t\t}\n\t\tconst start = times[segment] ?? 0;\n\t\tconst end = times[segment + 1] ?? 1;\n\t\tconst from = keyframes[segment] ?? 0;\n\t\tconst to = keyframes[segment + 1] ?? from;\n\t\tconst local = end === start ? 1 : (progress - start) / (end - start);\n\t\tconst eased = (eases[segment] ?? easeOut)(Math.min(1, Math.max(0, local)));\n\t\treturn from + (to - from) * eased;\n\t}\n\n\treturn {\n\t\tduration,\n\t\tat(elapsed): GeneratorState {\n\t\t\tif (elapsed >= duration) {\n\t\t\t\treturn { value: keyframes[last] ?? 0, velocity: 0, done: true };\n\t\t\t}\n\t\t\tconst value = valueAt(elapsed);\n\t\t\tconst before = Math.max(0, elapsed - VELOCITY_WINDOW);\n\t\t\tconst after = before === elapsed ? elapsed + VELOCITY_WINDOW : elapsed;\n\t\t\tconst velocity = (valueAt(after) - valueAt(before)) / (after - before);\n\t\t\treturn { value, velocity, done: false };\n\t\t},\n\t};\n}\n"],
+  "mappings": "AAAA,SAAS,SAAS,qBAAqB;AAiBvC,MAAM,kBAAkB;AAExB,SAAS,aACR,MACsC;AACtC,SAAO,MAAM,QAAQ,IAAI,KAAK,OAAO,KAAK,CAAC,MAAM;AAClD;AAEO,SAAS,MAAM,SAAkC;AACvD,QAAM,EAAE,UAAU,IAAI;AACtB,QAAM,WAAW,KAAK,IAAI,GAAG,QAAQ,YAAY,GAAG;AACpD,QAAM,OAAO,UAAU,SAAS;AAChC,QAAM,QACL,QAAQ,SACR,UAAU,IAAI,CAAC,SAAS,UAAW,SAAS,IAAI,IAAI,QAAQ,IAAK;AAClE,QAAM,QAAQ,MAAM,KAAK,EAAE,QAAQ,KAAK,IAAI,MAAM,CAAC,EAAE,GAAG,CAAC,SAAS,UAAU;AAC3E,UAAM,OAAO,QAAQ;AACrB,QAAI,SAAS,QAAW;AACvB,aAAO;AAAA,IACR;AACA,WAAO;AAAA,MACN,aAAa,IAAI,IACb,KAAK,KAAK,KAAK,KAAK,KAAK,SAAS,CAAC,KAAK,YACzC;AAAA,IACJ;AAAA,EACD,CAAC;AAED,WAAS,QAAQ,SAAyB;AACzC,UAAM,WACL,aAAa,IAAI,IAAI,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,UAAU,QAAQ,CAAC;AACjE,QAAI,UAAU;AACd,WAAO,UAAU,OAAO,KAAK,YAAY,MAAM,UAAU,CAAC,KAAK,IAAI;AAClE,iBAAW;AAAA,IACZ;AACA,UAAM,QAAQ,MAAM,OAAO,KAAK;AAChC,UAAM,MAAM,MAAM,UAAU,CAAC,KAAK;AAClC,UAAM,OAAO,UAAU,OAAO,KAAK;AACnC,UAAM,KAAK,UAAU,UAAU,CAAC,KAAK;AACrC,UAAM,QAAQ,QAAQ,QAAQ,KAAK,WAAW,UAAU,MAAM;AAC9D,UAAM,SAAS,MAAM,OAAO,KAAK,SAAS,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,KAAK,CAAC,CAAC;AACzE,WAAO,QAAQ,KAAK,QAAQ;AAAA,EAC7B;AAEA,SAAO;AAAA,IACN;AAAA,IACA,GAAG,SAAyB;AAC3B,UAAI,WAAW,UAAU;AACxB,eAAO,EAAE,OAAO,UAAU,IAAI,KAAK,GAAG,UAAU,GAAG,MAAM,KAAK;AAAA,MAC/D;AACA,YAAM,QAAQ,QAAQ,OAAO;AAC7B,YAAM,SAAS,KAAK,IAAI,GAAG,UAAU,eAAe;AACpD,YAAM,QAAQ,WAAW,UAAU,UAAU,kBAAkB;AAC/D,YAAM,YAAY,QAAQ,KAAK,IAAI,QAAQ,MAAM,MAAM,QAAQ;AAC/D,aAAO,EAAE,OAAO,UAAU,MAAM,MAAM;AAAA,IACvC;AAAA,EACD;AACD;",
+  "names": []
+}

package/dist/generators/types.d.ts

@@ -0,0 +1,30 @@
+export interface GeneratorState {
+    readonly value: number;
+    /** Units per second. */
+    readonly velocity: number;
+    readonly done: boolean;
+}
+/** One number moving over time: a spring, a tween or a decay. */
+export interface Generator {
+    /** Seconds until it settles. */
+    readonly duration: number;
+    /** The state `elapsed` seconds after the start. */
+    at(elapsed: number): GeneratorState;
+}
+export interface SpringOptions {
+    /**
+     * Perceived duration in seconds, SwiftUI's model: how long the motion
+     * looks like it takes, not when the last sub-pixel wobble ends. Ignored
+     * when `stiffness`, `damping` or `mass` is given.
+     */
+    readonly duration?: number;
+    /** 0 never overshoots; towards 1, springier. */
+    readonly bounce?: number;
+    readonly stiffness?: number;
+    readonly damping?: number;
+    readonly mass?: number;
+    /** Below this speed (units per second) and `restDelta`, the spring is done. */
+    readonly restSpeed?: number;
+    readonly restDelta?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/generators/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/generators/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,wBAAwB;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACvB;AAED,iEAAiE;AACjE,MAAM,WAAW,SAAS;IACzB,gCAAgC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,mDAAmD;IACnD,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAAC;CACpC;AAED,MAAM,WAAW,aAAa;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,gDAAgD;IAChD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,+EAA+E;IAC/E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC5B"}

package/dist/generators/types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=types.js.map

package/dist/generators/types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+export { onReducedMotionChange, prefersReducedMotion, type ReducedMotionPolicy, reducedMotionPolicy, setReducedMotion, shouldReduceMotion, } from "./accessibility/reduced-motion.js";
+export { type Animate, animate, createAnimate } from "./animate/animate.js";
+export type { AnimationControls, AnimationOptions, AnimationState, DOMKeyframes, ElementTarget, Keyframes, ValueAnimationOptions, } from "./animate/types.js";
+export { cubicBezier } from "./easing/cubic-bezier.js";
+export { linearEasing } from "./easing/linear-css.js";
+export { anticipate, backIn, backInOut, backOut, circIn, circInOut, circOut, easeIn, easeInOut, easeOut, linear, resolveEasing, } from "./easing/named.js";
+export { type SpringEasing, springEasing } from "./easing/spring.js";
+export { steps } from "./easing/steps.js";
+export type { CubicBezier, Easing, EasingDefinition, EasingName, } from "./easing/types.js";
+export { cancelFrame, type FrameCallback, type FrameData, frame, frameData, } from "./frame/frame.js";
+export { type InertiaOptions, inertia } from "./generators/inertia.js";
+export { spring, springPhysics } from "./generators/spring.js";
+export { type TweenOptions, tween } from "./generators/tween.js";
+export type { Generator, GeneratorState, SpringOptions, } from "./generators/types.js";
+export { mixColor } from "./interpolate/color.js";
+export { type InterpolateOptions, interpolate, } from "./interpolate/interpolate.js";
+export { type Mixer, mix } from "./interpolate/mix.js";
+export { mixPath } from "./interpolate/path/morph.js";
+export type { Segment, SegmentOptions, SequenceAt, } from "./sequence/sequence.js";
+export { type StaggerOptions, stagger } from "./stagger/stagger.js";
+export { isMotionValue, type MotionValue, type MotionValueEvent, motionValue, } from "./value/motion-value.js";
+export { transformValue } from "./value/transform.js";
+export { type InViewOptions, inView, type OnViewEnd, type OnViewStart, } from "./view/in-view.js";
+export { resize, type Size } from "./view/resize.js";
+export { type OnScroll, type ScrollDrivable, type ScrollInfo, type ScrollOptions, scroll, } from "./view/scroll.js";
+//# 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,OAAO,EACN,qBAAqB,EACrB,oBAAoB,EACpB,KAAK,mBAAmB,EACxB,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,GAClB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,KAAK,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC5E,YAAY,EACX,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,aAAa,EACb,SAAS,EACT,qBAAqB,GACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EACN,UAAU,EACV,MAAM,EACN,SAAS,EACT,OAAO,EACP,MAAM,EACN,SAAS,EACT,OAAO,EACP,MAAM,EACN,SAAS,EACT,OAAO,EACP,MAAM,EACN,aAAa,GACb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,KAAK,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,YAAY,EACX,WAAW,EACX,MAAM,EACN,gBAAgB,EAChB,UAAU,GACV,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACN,WAAW,EACX,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,EACL,SAAS,GACT,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,KAAK,cAAc,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACjE,YAAY,EACX,SAAS,EACT,cAAc,EACd,aAAa,GACb,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EACN,KAAK,kBAAkB,EACvB,WAAW,GACX,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,KAAK,KAAK,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AACtD,YAAY,EACX,OAAO,EACP,cAAc,EACd,UAAU,GACV,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,KAAK,cAAc,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EACN,aAAa,EACb,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,WAAW,GACX,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EACN,KAAK,aAAa,EAClB,MAAM,EACN,KAAK,SAAS,EACd,KAAK,WAAW,GAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,MAAM,EAAE,KAAK,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EACN,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,MAAM,GACN,MAAM,kBAAkB,CAAC"}