anim-engine 0.3.1 → 0.3.2

package/README.md

@@ -681,7 +681,7 @@ requestAnimationFrame(gameLoop);
 | `SmoothDampOptions`        | `to`, `smoothTimeMs`, `maxSpeed?`, `precision?`, `onUpdate`, `onEnded`                                                  |
 | `LerpOptions`              | `to`, `smoothTimeMs`, `precision?`, `onUpdate`, `onEnded`                                                               |
 | `RgbaTuple`                | `readonly [number, number, number, number]`                                                                             |
-| `TickerControls`           | `start`, `stop`, `update`, `add`, `remove`                                                                              |
+| `Ticker`                   | `start`, `stop`, `update`, `add`, `remove`                                                                              |
 
 ## License
 

package/dist/animation/create-animation.d.ts

@@ -1,24 +1,2 @@
-import { Animation, DynamicValue, EaseFunction, EaseName } from '../shared/types';
-export type SingleTweenOptions = {
-    from: DynamicValue;
-    to: DynamicValue;
-    durationMs: DynamicValue;
-    ease?: EaseName | EaseFunction;
-    onStarted?: () => void;
-    onUpdate?: (value: number, velocity: number) => void;
-    onEnded?: () => void;
-};
-export type Keyframe = {
-    value: DynamicValue;
-    ease?: EaseName | EaseFunction;
-    gap?: DynamicValue;
-};
-export type KeyframeAnimationOptions = {
-    keyframes: Keyframe[];
-    onStarted?: () => void;
-    onUpdate?: (value: number, velocity: number) => void;
-    onProgress?: (progress: number) => void;
-    onEnded?: () => void;
-};
-export type AnimationOptions = SingleTweenOptions | KeyframeAnimationOptions;
+import { AnimationOptions, Animation } from '../domain';
 export declare const createAnimation: (options: AnimationOptions) => Animation;

package/dist/animation/create-animation.js

@@ -1,9 +1,8 @@
-import { easingFunctions } from "../easing/easing.js";
-import { getTicker } from "../ticker/get-ticker.js";
+import { resolveEasing } from "../domain/easing.js";
+import { getTicker } from "../domain/ticker.js";
+import { resolveValue } from "../domain/resolve-value.js";
 import { createKeyframeRunner, createTweenRunner } from "./runner.js";
 //#region src/animation/create-animation.ts
-var resolveEasing = (ease) => typeof ease === "function" ? ease : easingFunctions[ease];
-var resolveValue = (v) => typeof v === "function" ? v() : v;
 var isKeyframeMode = (options) => {
 	return "keyframes" in options && Array.isArray(options.keyframes);
 };
@@ -11,23 +10,20 @@ var createAnimation = (options) => {
 	if (isKeyframeMode(options)) return createKeyframeAnimation(options);
 	return createSingleTween(options);
 };
-var createSingleTween = (options) => {
-	const easeName = options.ease ?? "inOutSine";
-	const { onStarted, onUpdate, onEnded } = options;
-	const rawFrom = options.from;
-	const rawTo = options.to;
-	const rawDurationMs = options.durationMs;
+var createSingleTween = ({ onStarted, onUpdate, onProgress, onEnded, from: rawFrom, to: rawTo, durationMs: rawDurationMs, ease: easeName = "inOutSine" }) => {
 	let cachedDurationMs = resolveValue(rawDurationMs);
 	let status = "stopped";
+	const hasDynamicProperty = typeof rawFrom === "function" || typeof rawTo === "function" || typeof rawDurationMs === "function";
 	let resolvePromise;
 	const ticker = getTicker();
-	let runner;
-	const finish = () => {
+	const handleEnded = () => {
 		status = "stopped";
 		ticker.remove(runner);
-		resolvePromise?.(controls);
+		resolvePromise?.();
+		onEnded?.();
 		resolvePromise = void 0;
 	};
+	let runner;
 	const buildRunner = () => {
 		const from = resolveValue(rawFrom);
 		const to = resolveValue(rawTo);
@@ -39,15 +35,14 @@ var createSingleTween = (options) => {
 			easeFn: resolveEasing(easeName),
 			onStarted,
 			onUpdate,
-			onEnded,
-			onComplete: finish
+			onProgress,
+			onEnded: handleEnded
 		});
 	};
-	const hasDynamic = typeof rawFrom === "function" || typeof rawTo === "function" || typeof rawDurationMs === "function";
 	runner = buildRunner();
 	const play = () => {
 		if (status === "dead") throw new Error("Cannot play a dead animation");
-		if (hasDynamic) runner = buildRunner();
+		if (hasDynamicProperty) runner = buildRunner();
 		else runner.reset();
 		const promise = new Promise((resolve) => {
 			resolvePromise = resolve;
@@ -70,7 +65,7 @@ var createSingleTween = (options) => {
 	const stop = () => {
 		status = "stopped";
 		ticker.remove(runner);
-		resolvePromise?.(controls);
+		resolvePromise?.();
 		resolvePromise = void 0;
 	};
 	const skipToEnd = () => {
@@ -78,7 +73,7 @@ var createSingleTween = (options) => {
 		if (status === "playing" || status === "paused") onEnded?.();
 		status = "stopped";
 		ticker.remove(runner);
-		resolvePromise?.(controls);
+		resolvePromise?.();
 		resolvePromise = void 0;
 	};
 	const kill = () => {
@@ -86,7 +81,11 @@ var createSingleTween = (options) => {
 		ticker.remove(runner);
 		resolvePromise = void 0;
 	};
-	const controls = {
+	const setProgress = (value) => {
+		if (status === "playing") pause();
+		runner.evaluate(Math.max(0, Math.min(1, value)));
+	};
+	return {
 		play,
 		pause,
 		resume,
@@ -102,10 +101,7 @@ var createSingleTween = (options) => {
 		get progress() {
 			return runner.progress;
 		},
-		setProgress(value) {
-			if (status === "playing") pause();
-			runner.evaluate(Math.max(0, Math.min(1, value)));
-		},
+		setProgress,
 		get status() {
 			return status;
 		},
@@ -113,10 +109,8 @@ var createSingleTween = (options) => {
 			return cachedDurationMs;
 		}
 	};
-	return controls;
 };
-var createKeyframeAnimation = (options) => {
-	const { keyframes: rawKeyframes, onStarted, onUpdate, onProgress, onEnded } = options;
+var createKeyframeAnimation = ({ keyframes: rawKeyframes, onStarted, onUpdate, onProgress, onEnded }) => {
 	const resolveKeyframeGaps = () => {
 		let total = 0;
 		for (let i = 1; i < rawKeyframes.length; i++) total += resolveValue(rawKeyframes[i].gap ?? 0);
@@ -125,14 +119,16 @@ var createKeyframeAnimation = (options) => {
 	let cachedDurationMs = resolveKeyframeGaps();
 	let status = "stopped";
 	let resolvePromise;
+	const hasDynamicProperty = rawKeyframes.some((kf) => typeof kf.value === "function" || typeof kf.gap === "function");
 	const ticker = getTicker();
-	let runner;
-	const finish = () => {
+	const handleEnded = () => {
 		status = "stopped";
 		ticker.remove(runner);
-		resolvePromise?.(controls);
+		resolvePromise?.();
+		onEnded?.();
 		resolvePromise = void 0;
 	};
+	let runner;
 	const buildRunner = () => {
 		return createKeyframeRunner({
 			keyframes: rawKeyframes.map((kf, i) => ({
@@ -143,15 +139,13 @@ var createKeyframeAnimation = (options) => {
 			onStarted,
 			onUpdate,
 			onProgress,
-			onEnded,
-			onComplete: finish
+			onEnded: handleEnded
 		});
 	};
-	const hasDynamic = rawKeyframes.some((kf) => typeof kf.value === "function" || typeof kf.gap === "function");
 	runner = buildRunner();
 	const play = () => {
 		if (status === "dead") throw new Error("Cannot play a dead animation");
-		if (hasDynamic) {
+		if (hasDynamicProperty) {
 			runner = buildRunner();
 			cachedDurationMs = resolveKeyframeGaps();
 		} else runner.reset();
@@ -176,7 +170,7 @@ var createKeyframeAnimation = (options) => {
 	const stop = () => {
 		status = "stopped";
 		ticker.remove(runner);
-		resolvePromise?.(controls);
+		resolvePromise?.();
 		resolvePromise = void 0;
 	};
 	const skipToEnd = () => {
@@ -184,7 +178,7 @@ var createKeyframeAnimation = (options) => {
 		if (status === "playing" || status === "paused") onEnded?.();
 		status = "stopped";
 		ticker.remove(runner);
-		resolvePromise?.(controls);
+		resolvePromise?.();
 		resolvePromise = void 0;
 	};
 	const kill = () => {
@@ -192,7 +186,11 @@ var createKeyframeAnimation = (options) => {
 		ticker.remove(runner);
 		resolvePromise = void 0;
 	};
-	const controls = {
+	const setProgress = (value) => {
+		if (status === "playing") pause();
+		runner.evaluate(Math.max(0, Math.min(1, value)));
+	};
+	return {
 		play,
 		pause,
 		resume,
@@ -208,10 +206,7 @@ var createKeyframeAnimation = (options) => {
 		get progress() {
 			return runner.progress;
 		},
-		setProgress(value) {
-			if (status === "playing") pause();
-			runner.evaluate(Math.max(0, Math.min(1, value)));
-		},
+		setProgress,
 		get status() {
 			return status;
 		},
@@ -219,7 +214,6 @@ var createKeyframeAnimation = (options) => {
 			return cachedDurationMs;
 		}
 	};
-	return controls;
 };
 //#endregion
 export { createAnimation };

package/dist/animation/create-single-tween.d.ts

@@ -0,0 +1,39 @@
+import { EaseName, AnimationStatus, DynamicValue, EaseFunction } from '../domain';
+export type SingleTweenOptions = {
+    from: DynamicValue;
+    to: DynamicValue;
+    durationMs: DynamicValue;
+    ease?: EaseName | EaseFunction;
+    onStarted?: () => void;
+    onUpdate?: (value: number, velocity: number) => void;
+    onProgress?: (progress: number) => void;
+    onEnded?: () => void;
+};
+export type Keyframe = {
+    value: DynamicValue;
+    ease?: EaseName | EaseFunction;
+    gap?: DynamicValue;
+};
+export type KeyframeAnimationOptions = {
+    keyframes: Keyframe[];
+    onStarted?: () => void;
+    onUpdate?: (value: number, velocity: number) => void;
+    onProgress?: (progress: number) => void;
+    onEnded?: () => void;
+};
+export type AnimationOptions = SingleTweenOptions | KeyframeAnimationOptions;
+export type Animation = {
+    play: () => Promise<void>;
+    pause: () => void;
+    resume: () => void;
+    stop: () => void;
+    skipToEnd: () => void;
+    kill: () => void;
+    currentValue: number;
+    velocity: number;
+    progress: number;
+    setProgress: (value: number) => void;
+    status: AnimationStatus;
+    durationMs: number;
+};
+export declare const createSingleTween: ({ onStarted, onUpdate, onProgress, onEnded, from: rawFrom, to: rawTo, durationMs: rawDurationMs, ease: easeName, }: SingleTweenOptions) => Animation;

package/dist/animation/runner.d.ts

@@ -1,4 +1,4 @@
-import { EaseFunction } from '../shared/types';
+import { EaseFunction } from '../domain';
 export type Runner = {
     (deltaMs: number): boolean;
     evaluate: (progress: number) => number;
@@ -7,8 +7,6 @@ export type Runner = {
     velocity: number;
     progress: number;
     onStarted: (() => void) | undefined;
-    onUpdate: ((value: number, velocity: number) => void) | undefined;
-    onProgress: ((progress: number) => void) | undefined;
     onEnded: (() => void) | undefined;
 };
 export type TweenRunnerConfig = {
@@ -18,10 +16,10 @@ export type TweenRunnerConfig = {
     easeFn: EaseFunction;
     onStarted?: () => void;
     onUpdate?: (value: number, velocity: number) => void;
-    onEnded?: () => void;
-    onComplete?: () => void;
+    onProgress?: (progress: number) => void;
+    onEnded: () => void;
 };
-export declare const createTweenRunner: (config: TweenRunnerConfig) => Runner;
+export declare const createTweenRunner: ({ from, to, durationMs, easeFn, onStarted, onUpdate, onProgress, onEnded, }: TweenRunnerConfig) => Runner;
 export type KeyframeRunnerConfig = {
     keyframes: {
         value: number;
@@ -32,6 +30,5 @@ export type KeyframeRunnerConfig = {
     onUpdate?: (value: number, velocity: number) => void;
     onProgress?: (progress: number) => void;
     onEnded?: () => void;
-    onComplete?: () => void;
 };
-export declare const createKeyframeRunner: (config: KeyframeRunnerConfig) => Runner;
+export declare const createKeyframeRunner: ({ keyframes, onStarted, onUpdate, onProgress, onEnded, }: KeyframeRunnerConfig) => Runner;

package/dist/animation/runner.js

@@ -1,12 +1,7 @@
 import { updateTween } from "./update.js";
 //#region src/animation/runner.ts
-var noop = () => {};
-var createTweenRunner = (config) => {
-	const { from, to, durationMs, easeFn } = config;
-	const onStarted = config.onStarted;
-	const onUpdate = config.onUpdate ?? noop;
-	const onEnded = config.onEnded;
-	const onComplete = config.onComplete;
+var noOp = () => {};
+var createTweenRunner = ({ from, to, durationMs, easeFn, onStarted, onUpdate = noOp, onProgress = noOp, onEnded }) => {
 	const state = {
 		progress: 0,
 		currentValue: from,
@@ -16,10 +11,8 @@ var createTweenRunner = (config) => {
 	const step = (deltaMs) => {
 		const completed = updateTween(state, deltaMs, durationMs, easeFn, from, to);
 		onUpdate(state.currentValue, state.velocity);
-		if (completed) {
-			onEnded?.();
-			onComplete?.();
-		}
+		onProgress(state.progress);
+		if (completed) onEnded();
 		return completed;
 	};
 	const evaluate = (progress) => {
@@ -57,18 +50,11 @@ var createTweenRunner = (config) => {
 		configurable: true
 	});
 	runner.onStarted = onStarted;
-	runner.onUpdate = config.onUpdate;
-	runner.onProgress = void 0;
 	runner.onEnded = onEnded;
 	return runner;
 };
-var createKeyframeRunner = (config) => {
-	const { keyframes } = config;
-	const onStarted = config.onStarted;
-	const onUpdate = config.onUpdate ?? noop;
-	const onProgress = config.onProgress ?? noop;
-	const onEnded = config.onEnded;
-	const onComplete = config.onComplete;
+var createKeyframeRunner = ({ keyframes, onStarted, onUpdate = noOp, onProgress = noOp, onEnded }) => {
+	if (keyframes.length < 2) throw new Error("Keyframe animation must have at least 2 keyframes");
 	const segments = [];
 	for (let i = 0; i < keyframes.length - 1; i++) {
 		const cur = keyframes[i];
@@ -92,44 +78,7 @@ var createKeyframeRunner = (config) => {
 	let segmentElapsed = 0;
 	let segmentProgress = 0;
 	let runner;
-	if (segments.length === 0) {
-		const complete = () => {
-			onEnded?.();
-			onComplete?.();
-		};
-		const step = (_deltaMs) => {
-			onUpdate(currentValue, 0);
-			onProgress(1);
-			complete();
-			return true;
-		};
-		const evaluate = (prog) => {
-			onUpdate(currentValue, 0);
-			onProgress(Math.max(0, Math.min(1, prog)));
-			return currentValue;
-		};
-		runner = step;
-		runner.evaluate = evaluate;
-		runner.reset = () => {};
-		Object.defineProperty(runner, "currentValue", {
-			get: () => currentValue,
-			configurable: true
-		});
-		Object.defineProperty(runner, "velocity", {
-			get: () => 0,
-			configurable: true
-		});
-		Object.defineProperty(runner, "progress", {
-			get: () => 1,
-			configurable: true
-		});
-		runner.onStarted = onStarted;
-		runner.onUpdate = config.onUpdate;
-		runner.onProgress = config.onProgress;
-		runner.onEnded = onEnded;
-		return runner;
-	}
-	const step = (deltaMs) => {
+	const update = (deltaMs) => {
 		const segment = segments[currentSegmentIndex];
 		segmentElapsed += deltaMs;
 		segmentProgress += deltaMs / segment.durationMs;
@@ -155,7 +104,6 @@ var createKeyframeRunner = (config) => {
 			onProgress(globalProgress);
 		} else {
 			onEnded?.();
-			onComplete?.();
 			return true;
 		}
 		return false;
@@ -195,7 +143,7 @@ var createKeyframeRunner = (config) => {
 		segmentElapsed = 0;
 		segmentProgress = 0;
 	};
-	runner = step;
+	runner = update;
 	runner.evaluate = evaluate;
 	runner.reset = reset;
 	Object.defineProperty(runner, "currentValue", {
@@ -211,8 +159,6 @@ var createKeyframeRunner = (config) => {
 		configurable: true
 	});
 	runner.onStarted = onStarted;
-	runner.onUpdate = config.onUpdate;
-	runner.onProgress = config.onProgress;
 	runner.onEnded = onEnded;
 	return runner;
 };

package/dist/animation/update.d.ts

@@ -1,4 +1,4 @@
-import { EaseFunction } from '../shared/types';
+import { EaseFunction } from '../domain';
 export type TweenState = {
     progress: number;
     currentValue: number;

package/dist/domain/animation.d.ts

@@ -0,0 +1,40 @@
+import { EaseFunction, EaseName } from './easing';
+import { DynamicValue } from './resolve-value';
+export type AnimationStatus = "playing" | "paused" | "stopped" | "dead";
+export type SingleTweenOptions = {
+    from: DynamicValue;
+    to: DynamicValue;
+    durationMs: DynamicValue;
+    ease?: EaseName | EaseFunction;
+    onStarted?: () => void;
+    onUpdate?: (value: number, velocity: number) => void;
+    onProgress?: (progress: number) => void;
+    onEnded?: () => void;
+};
+export type Keyframe = {
+    value: DynamicValue;
+    ease?: EaseName | EaseFunction;
+    gap?: DynamicValue;
+};
+export type KeyframeAnimationOptions = {
+    keyframes: Keyframe[];
+    onStarted?: () => void;
+    onUpdate?: (value: number, velocity: number) => void;
+    onProgress?: (progress: number) => void;
+    onEnded?: () => void;
+};
+export type AnimationOptions = SingleTweenOptions | KeyframeAnimationOptions;
+export type Animation = {
+    play: () => Promise<void>;
+    pause: () => void;
+    resume: () => void;
+    stop: () => void;
+    skipToEnd: () => void;
+    kill: () => void;
+    currentValue: number;
+    velocity: number;
+    progress: number;
+    setProgress: (value: number) => void;
+    status: AnimationStatus;
+    durationMs: number;
+};

package/dist/domain/easing.d.ts

@@ -0,0 +1,18 @@
+export type EaseFunction = (t: number) => number;
+export declare const resolveEasing: (ease: EaseName | EaseFunction) => EaseFunction;
+/** All 31 named easing identifiers, ordered by type. */
+export declare const EASE_NAMES: readonly ["linear", "inQuad", "outQuad", "inOutQuad", "inCubic", "outCubic", "inOutCubic", "inQuart", "outQuart", "inOutQuart", "inQuint", "outQuint", "inOutQuint", "inSine", "outSine", "inOutSine", "inExpo", "outExpo", "inOutExpo", "inCirc", "outCirc", "inOutCirc", "inBack", "outBack", "inOutBack", "inElastic", "outElastic", "inOutElastic", "inBounce", "outBounce", "inOutBounce"];
+export type EaseName = (typeof EASE_NAMES)[number];
+export declare const EASING_FUNCTIONS: Record<EaseName, EaseFunction>;
+/**
+ * Cubic bezier easing. Builds a pre-computed lookup table at construction time
+ * for O(log n) binary search at runtime — no Newton iteration, no allocation
+ * per frame.
+ *
+ * @param p1x - First control point x coordinate.
+ * @param p1y - First control point y coordinate.
+ * @param p2x - Second control point x coordinate.
+ * @param p2y - Second control point y coordinate.
+ * @returns An EaseFunction suitable for use with animate() or createTimeline().
+ */
+export declare const cubicBezier: (p1x: number, p1y: number, p2x: number, p2y: number) => EaseFunction;

package/dist/{easing → domain}/easing.js

@@ -1,4 +1,5 @@
-//#region src/easing/easing.ts
+//#region src/domain/easing.ts
+var resolveEasing = (ease) => typeof ease === "function" ? ease : EASING_FUNCTIONS[ease];
 var pow = Math.pow;
 var sqrt = Math.sqrt;
 var sin = Math.sin;
@@ -51,7 +52,7 @@ var EASE_NAMES = [
 	"outBounce",
 	"inOutBounce"
 ];
-var easingFunctions = {
+var EASING_FUNCTIONS = {
 	linear: (x) => x,
 	inQuad: (x) => x * x,
 	outQuad: (x) => 1 - (1 - x) * (1 - x),
@@ -151,4 +152,4 @@ var cubicBezier = (p1x, p1y, p2x, p2y) => {
 	};
 };
 //#endregion
-export { EASE_NAMES, cubicBezier, easingFunctions };
+export { EASE_NAMES, EASING_FUNCTIONS, cubicBezier, resolveEasing };

package/dist/domain/index.d.ts

@@ -0,0 +1,10 @@
+export type { AnimationStatus } from './animation';
+export type { InterpolationStatus, Interpolation } from './interpolation';
+export type { EaseName, EaseFunction } from './easing';
+export { EASE_NAMES, cubicBezier, EASING_FUNCTIONS, resolveEasing } from './easing';
+export { getTicker } from './ticker';
+export type { Ticker, TickHandler } from './ticker';
+export { resolveValue } from './resolve-value';
+export type { DynamicValue } from './resolve-value';
+export type { Animation, AnimationOptions, SingleTweenOptions, KeyframeAnimationOptions, Keyframe, } from './animation';
+export type { TimelineLayer, Timeline } from './timeline';

package/dist/domain/interpolation.d.ts

@@ -0,0 +1,10 @@
+export type InterpolationStatus = "active" | "inactive" | "dead";
+export type Interpolation = {
+    start: () => void;
+    stop: () => void;
+    kill: () => void;
+    setCurrentValue: (value: number) => void;
+    currentValue: number;
+    velocity: number;
+    status: InterpolationStatus;
+};

package/dist/domain/resolve-value.d.ts

@@ -0,0 +1,2 @@
+export type DynamicValue = number | (() => number);
+export declare const resolveValue: (value: DynamicValue) => number;

package/dist/domain/resolve-value.js

@@ -0,0 +1,4 @@
+//#region src/domain/resolve-value.ts
+var resolveValue = (value) => typeof value === "function" ? value() : value;
+//#endregion
+export { resolveValue };

package/dist/{ticker → domain}/ticker.d.ts

@@ -1,11 +1,13 @@
 export type TickHandler = (deltaMs: number) => void;
-export type TickerControls = {
+export type Ticker = {
     start: () => void;
     stop: () => void;
     update: (deltaMs: number) => void;
     add: (handler: TickHandler) => void;
     remove: (handler: TickHandler) => void;
 };
+/** Returns the default ticker singleton. Created lazily on first access. */
+export declare const getTicker: () => Ticker;
 /**
  * Create a ticker that drives active animations.
  *
@@ -19,4 +21,4 @@ export type TickerControls = {
  * Uses a flat array with undefined-tombstone removal for safe concurrent
  * modification during iteration. Compacted after each frame.
  */
-export declare const createTicker: () => TickerControls;
+export declare const createTicker: () => Ticker;

package/dist/{ticker → domain}/ticker.js

@@ -1,4 +1,10 @@
-//#region src/ticker/ticker.ts
+//#region src/domain/ticker.ts
+var singleton;
+/** Returns the default ticker singleton. Created lazily on first access. */
+var getTicker = () => {
+	if (!singleton) singleton = createTicker();
+	return singleton;
+};
 /**
 * Create a ticker that drives active animations.
 *
@@ -71,4 +77,4 @@ var createTicker = () => {
 	};
 };
 //#endregion
-export { createTicker };
+export { createTicker, getTicker };

package/dist/domain/timeline.d.ts

@@ -0,0 +1,21 @@
+import { DynamicValue } from '../domain';
+import { KeyframeAnimationOptions, AnimationStatus } from './animation';
+export type TimelineLayer = {
+    animation: KeyframeAnimationOptions;
+    at: DynamicValue;
+} | {
+    animation: KeyframeAnimationOptions;
+    gap: number;
+};
+export type Timeline = {
+    play: () => Promise<void>;
+    pause: () => void;
+    resume: () => void;
+    stop: () => void;
+    skipToEnd: () => void;
+    kill: () => void;
+    setProgress: (value: number) => void;
+    progress: number;
+    status: AnimationStatus;
+    durationMs: number;
+};

package/dist/index.d.ts

@@ -5,13 +5,9 @@ export { createSmoothDamp } from './smooth-damp/create-smooth-damp';
 export { createLerp } from './lerp/create-lerp';
 export { createSmoothClamp } from './smooth-clamp/smooth-clamp';
 export { lerpOklab, hexToRgba } from './color/lerp-oklab';
-export { getTicker } from './ticker/get-ticker';
-export { EASE_NAMES, cubicBezier } from './easing/easing';
-export type { Keyframe, AnimationOptions, KeyframeAnimationOptions, } from './animation/create-animation';
-export type { Animation, Interpolation, EaseName, AnimationStatus, InterpolationStatus, DynamicValue, } from './shared/types';
+export { getTicker, EASE_NAMES, cubicBezier } from './domain';
+export type { EaseName, Interpolation, AnimationStatus, InterpolationStatus, DynamicValue, Animation, Keyframe, AnimationOptions, KeyframeAnimationOptions, TimelineLayer, Timeline, Ticker, } from './domain';
 export type { SpringOptions } from './spring/create-spring';
 export type { SmoothDampOptions } from './smooth-damp/create-smooth-damp';
 export type { LerpOptions } from './lerp/create-lerp';
-export type { TimelineLayer, Timeline } from './timeline/create-timeline';
 export type { RgbaTuple } from './color/lerp-oklab';
-export type { TickerControls } from './ticker/ticker';

package/dist/index.js

@@ -1,5 +1,5 @@
-import { EASE_NAMES, cubicBezier } from "./easing/easing.js";
-import { getTicker } from "./ticker/get-ticker.js";
+import { EASE_NAMES, cubicBezier } from "./domain/easing.js";
+import { getTicker } from "./domain/ticker.js";
 import { createAnimation } from "./animation/create-animation.js";
 import { createTimeline } from "./timeline/create-timeline.js";
 import { createSpring } from "./spring/create-spring.js";

package/dist/lerp/create-lerp.d.ts

@@ -1,4 +1,4 @@
-import { Interpolation, DynamicValue } from '../shared/types';
+import { Interpolation, DynamicValue } from '../domain';
 export type LerpOptions = {
     to: () => number;
     smoothTimeMs: DynamicValue;

package/dist/lerp/create-lerp.js

@@ -1,4 +1,5 @@
-import { getTicker } from "../ticker/get-ticker.js";
+import { getTicker } from "../domain/ticker.js";
+import { resolveValue } from "../domain/resolve-value.js";
 import { lerpStep } from "./step.js";
 //#region src/lerp/create-lerp.ts
 var createLerp = (options) => {
@@ -10,9 +11,22 @@ var createLerp = (options) => {
 	let currentVelocity = 0;
 	let active = true;
 	const ticker = getTicker();
-	const resolveValue = (v) => typeof v === "function" ? v() : v;
 	state.current = options.to();
 	previousValue = state.current;
+	const update = (deltaMs) => {
+		if (!active) return;
+		const target = options.to();
+		const smoothTimeMs = resolveValue(options.smoothTimeMs);
+		lerpStep(state, target, smoothTimeMs, deltaMs);
+		currentVelocity = (state.current - previousValue) / (deltaMs / 1e3);
+		previousValue = state.current;
+		onUpdate?.(state.current, currentVelocity);
+		if (onEnded && Math.abs(state.current - target) < precision && Math.abs(currentVelocity) < precision) {
+			state.current = target;
+			currentVelocity = 0;
+			onEnded();
+		}
+	};
 	ticker.add(update);
 	const start = () => {
 		if (active) return;
@@ -27,20 +41,6 @@ var createLerp = (options) => {
 		active = false;
 		ticker.remove(update);
 	};
-	function update(deltaMs) {
-		if (!active) return;
-		const target = options.to();
-		const smoothTimeMs = resolveValue(options.smoothTimeMs);
-		lerpStep(state, target, smoothTimeMs, deltaMs);
-		currentVelocity = (state.current - previousValue) / (deltaMs / 1e3);
-		previousValue = state.current;
-		onUpdate?.(state.current, currentVelocity);
-		if (onEnded && Math.abs(state.current - target) < precision && Math.abs(currentVelocity) < precision) {
-			state.current = target;
-			currentVelocity = 0;
-			onEnded();
-		}
-	}
 	return {
 		start,
 		stop,

package/dist/smooth-damp/create-smooth-damp.d.ts

@@ -1,4 +1,4 @@
-import { Interpolation, DynamicValue } from '../shared/types';
+import { Interpolation, DynamicValue } from '../domain';
 export type SmoothDampOptions = {
     to: () => number;
     smoothTimeMs: DynamicValue;

package/dist/smooth-damp/create-smooth-damp.js

@@ -1,4 +1,5 @@
-import { getTicker } from "../ticker/get-ticker.js";
+import { getTicker } from "../domain/ticker.js";
+import { resolveValue } from "../domain/resolve-value.js";
 import { smoothDampStep } from "./step.js";
 //#region src/smooth-damp/create-smooth-damp.ts
 var createSmoothDamp = (options) => {
@@ -11,7 +12,6 @@ var createSmoothDamp = (options) => {
 	};
 	let active = true;
 	const ticker = getTicker();
-	const resolveValue = (v) => typeof v === "function" ? v() : v;
 	state.current = options.to();
 	ticker.add(update);
 	const start = () => {

package/dist/spring/create-spring.d.ts

@@ -1,4 +1,4 @@
-import { Interpolation, DynamicValue } from '../shared/types';
+import { Interpolation, DynamicValue } from '../domain';
 export type SpringOptions = {
     to: () => number;
     stiffness?: DynamicValue;

package/dist/spring/create-spring.js

@@ -1,11 +1,11 @@
-import { getTicker } from "../ticker/get-ticker.js";
+import { getTicker } from "../domain/ticker.js";
+import { resolveValue } from "../domain/resolve-value.js";
 import { verletStep } from "./verlet.js";
 //#region src/spring/create-spring.ts
 var createSpring = (options) => {
 	const precision = options.precision ?? .01;
 	const onUpdate = options.onUpdate;
 	const onEnded = options.onEnded;
-	const resolveValue = (v) => typeof v === "function" ? v() : v;
 	const rawTo = options.to;
 	const rawStiffness = options.stiffness ?? 180;
 	const rawDamping = options.damping ?? 12;

package/dist/timeline/create-timeline.d.ts

@@ -1,24 +1,4 @@
-import { KeyframeAnimationOptions } from '../animation/create-animation';
-import { AnimationStatus, DynamicValue } from '../shared/types';
-export type TimelineLayer = {
-    animation: KeyframeAnimationOptions;
-    at: DynamicValue;
-} | {
-    animation: KeyframeAnimationOptions;
-    gap: number;
-};
-export type Timeline = {
-    play: () => Promise<Timeline>;
-    pause: () => void;
-    resume: () => void;
-    stop: () => void;
-    skipToEnd: () => void;
-    kill: () => void;
-    setProgress: (value: number) => void;
-    progress: number;
-    status: AnimationStatus;
-    durationMs: number;
-};
+import { TimelineLayer, Timeline } from '../domain';
 export declare const createTimeline: (layers: TimelineLayer[], options?: {
     onStarted?: () => void;
     onProgress?: (progress: number) => void;

package/dist/timeline/create-timeline.js

@@ -1,10 +1,9 @@
-import { easingFunctions } from "../easing/easing.js";
-import { getTicker } from "../ticker/get-ticker.js";
+import { resolveEasing } from "../domain/easing.js";
+import { getTicker } from "../domain/ticker.js";
+import { resolveValue } from "../domain/resolve-value.js";
 import { createKeyframeRunner } from "../animation/runner.js";
 //#region src/timeline/create-timeline.ts
 var noop = () => {};
-var resolveValue = (v) => typeof v === "function" ? v() : v;
-var resolveEasing = (ease) => typeof ease === "function" ? ease : easingFunctions[ease];
 var buildFromConfigs = (rawLayers) => {
 	const activeLayers = [];
 	let previousEndAt = 0;
@@ -55,7 +54,7 @@ var createTimeline = (layers, options) => {
 		timelineStatus = "stopped";
 		ticker.remove(update);
 		onEnded?.();
-		resolvePromise?.(timeline);
+		resolvePromise?.();
 		resolvePromise = void 0;
 	};
 	const update = (deltaMs) => {
@@ -105,7 +104,7 @@ var createTimeline = (layers, options) => {
 		if (timelineStatus !== "playing" && timelineStatus !== "paused") return;
 		timelineStatus = "stopped";
 		ticker.remove(update);
-		resolvePromise?.(timeline);
+		resolvePromise?.();
 		resolvePromise = void 0;
 	};
 	const skipToEnd = () => {
@@ -116,7 +115,7 @@ var createTimeline = (layers, options) => {
 		timelineStatus = "stopped";
 		ticker.remove(update);
 		onEnded?.();
-		resolvePromise?.(timeline);
+		resolvePromise?.();
 		resolvePromise = void 0;
 	};
 	const kill = () => {
@@ -140,7 +139,7 @@ var createTimeline = (layers, options) => {
 		}
 		remainingLayers = activeLayers.filter((l) => !l.ended).length;
 	};
-	const timeline = {
+	return {
 		play,
 		pause,
 		resume,
@@ -158,7 +157,6 @@ var createTimeline = (layers, options) => {
 			return totalDurationMs;
 		}
 	};
-	return timeline;
 };
 //#endregion
 export { createTimeline };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "anim-engine",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "private": false,
   "description": "JavaScript library for animating numbers",
   "license": "MIT",
@@ -22,7 +22,7 @@
     "build": "npm run lint && npm run test && tsc && vite build",
     "preview": "vite preview",
     "check:types": "tsc --noEmit",
-    "lint": "oxlint -c .oxlintrc.json src/",
+    "lint": "oxlint",
     "test": "vitest run",
     "test:watch": "vitest",
     "storybook": "storybook dev -p 6006",
@@ -42,6 +42,7 @@
     "gsap": "3.15.0",
     "oxfmt": "0.57.0",
     "oxlint": "1.72.0",
+    "oxlint-tsgolint": "^0.24.0",
     "storybook": "10.4.6",
     "typescript": "6.0.3",
     "vite": "8.1.3",

package/dist/easing/easing.d.ts

@@ -1,16 +0,0 @@
-import { EaseName, EaseFunction } from '../shared/types';
-/** All 31 named easing identifiers, ordered by type. */
-export declare const EASE_NAMES: EaseName[];
-export declare const easingFunctions: Record<EaseName, EaseFunction>;
-/**
- * Cubic bezier easing. Builds a pre-computed lookup table at construction time
- * for O(log n) binary search at runtime — no Newton iteration, no allocation
- * per frame.
- *
- * @param p1x - First control point x coordinate.
- * @param p1y - First control point y coordinate.
- * @param p2x - Second control point x coordinate.
- * @param p2y - Second control point y coordinate.
- * @returns An EaseFunction suitable for use with animate() or createTimeline().
- */
-export declare const cubicBezier: (p1x: number, p1y: number, p2x: number, p2y: number) => EaseFunction;

package/dist/shared/internal.d.ts

@@ -1,4 +0,0 @@
-/** An object that can be driven by the ticker. */
-export type Updateable = {
-    update(deltaMs: number): void;
-};

package/dist/shared/types.d.ts

@@ -1,28 +0,0 @@
-export type EaseName = "linear" | "inQuad" | "outQuad" | "inOutQuad" | "inCubic" | "outCubic" | "inOutCubic" | "inQuart" | "outQuart" | "inOutQuart" | "inQuint" | "outQuint" | "inOutQuint" | "inSine" | "outSine" | "inOutSine" | "inExpo" | "outExpo" | "inOutExpo" | "inCirc" | "outCirc" | "inOutCirc" | "inBack" | "outBack" | "inOutBack" | "inElastic" | "outElastic" | "inOutElastic" | "inBounce" | "outBounce" | "inOutBounce";
-export type EaseFunction = (t: number) => number;
-export type AnimationStatus = "playing" | "paused" | "stopped" | "dead";
-export type InterpolationStatus = "active" | "inactive" | "dead";
-export type DynamicValue = number | (() => number);
-export type Animation = {
-    play: () => Promise<Animation>;
-    pause: () => void;
-    resume: () => void;
-    stop: () => void;
-    skipToEnd: () => void;
-    kill: () => void;
-    currentValue: number;
-    velocity: number;
-    progress: number;
-    setProgress: (value: number) => void;
-    status: AnimationStatus;
-    durationMs: number;
-};
-export type Interpolation = {
-    start: () => void;
-    stop: () => void;
-    kill: () => void;
-    setCurrentValue: (value: number) => void;
-    currentValue: number;
-    velocity: number;
-    status: InterpolationStatus;
-};

package/dist/ticker/get-ticker.d.ts

@@ -1,5 +0,0 @@
-import { TickerControls } from './ticker';
-/** Returns the default ticker singleton. Created lazily on first access. */
-export declare const getTicker: () => TickerControls;
-/** Creates a new independent ticker instance (for testing or multi-loop setups). */
-export { createTicker } from './ticker';

package/dist/ticker/get-ticker.js

@@ -1,10 +0,0 @@
-import { createTicker } from "./ticker.js";
-//#region src/ticker/get-ticker.ts
-var singleton;
-/** Returns the default ticker singleton. Created lazily on first access. */
-var getTicker = () => {
-	if (!singleton) singleton = createTicker();
-	return singleton;
-};
-//#endregion
-export { getTicker };