fraxel 0.1.0-alpha.1

package/dist/animation/easing.d.ts

@@ -0,0 +1,29 @@
+/**
+ * An easing function that maps progress `t` (0 to 1) to an eased value.
+ */
+export type EasingFn = (t: number) => number;
+/** Linear interpolation — no easing. */
+export declare const linear: EasingFn;
+/** Accelerating from zero velocity. */
+export declare const easeInQuad: EasingFn;
+/** Decelerating to zero velocity. */
+export declare const easeOutQuad: EasingFn;
+/** Accelerating then decelerating. */
+export declare const easeInOutQuad: EasingFn;
+/** Cubic acceleration. */
+export declare const easeInCubic: EasingFn;
+/** Cubic deceleration. */
+export declare const easeOutCubic: EasingFn;
+/** Cubic acceleration then deceleration. */
+export declare const easeInOutCubic: EasingFn;
+/** Overshoot then settle — dramatic entrance. */
+export declare const easeBackOut: EasingFn;
+/** Overshoot in both directions — bouncy. */
+export declare const easeBackInOut: EasingFn;
+/** Bounce effect at the end. */
+export declare const easeOutBounce: EasingFn;
+/** Bounce effect at the start. */
+export declare const easeInBounce: EasingFn;
+/** Elastic effect — spring-like overshoot. */
+export declare const easeOutElastic: EasingFn;
+//# sourceMappingURL=easing.d.ts.map

package/dist/animation/easing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"easing.d.ts","sourceRoot":"","sources":["../../src/animation/easing.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAA;AAE5C,wCAAwC;AACxC,eAAO,MAAM,MAAM,EAAE,QAAmB,CAAA;AAExC,uCAAuC;AACvC,eAAO,MAAM,UAAU,EAAE,QAAuB,CAAA;AAEhD,qCAAqC;AACrC,eAAO,MAAM,WAAW,EAAE,QAA6B,CAAA;AAEvD,sCAAsC;AACtC,eAAO,MAAM,aAAa,EAAE,QAA8D,CAAA;AAE1F,0BAA0B;AAC1B,eAAO,MAAM,WAAW,EAAE,QAA2B,CAAA;AAErD,0BAA0B;AAC1B,eAAO,MAAM,YAAY,EAAE,QAAiC,CAAA;AAE5D,4CAA4C;AAC5C,eAAO,MAAM,cAAc,EAAE,QACsC,CAAA;AAEnE,iDAAiD;AACjD,eAAO,MAAM,WAAW,EAAE,QAGzB,CAAA;AAED,6CAA6C;AAC7C,eAAO,MAAM,aAAa,EAAE,QAI3B,CAAA;AAED,gCAAgC;AAChC,eAAO,MAAM,aAAa,EAAE,QAU3B,CAAA;AAED,kCAAkC;AAClC,eAAO,MAAM,YAAY,EAAE,QAA0C,CAAA;AAErE,8CAA8C;AAC9C,eAAO,MAAM,cAAc,EAAE,QAG5B,CAAA"}

package/dist/animation/easing.js

@@ -0,0 +1,50 @@
+/** Linear interpolation — no easing. */
+export const linear = (t) => t;
+/** Accelerating from zero velocity. */
+export const easeInQuad = (t) => t * t;
+/** Decelerating to zero velocity. */
+export const easeOutQuad = (t) => t * (2 - t);
+/** Accelerating then decelerating. */
+export const easeInOutQuad = (t) => (t < 0.5 ? 2 * t * t : -1 + (4 - 2 * t) * t);
+/** Cubic acceleration. */
+export const easeInCubic = (t) => t * t * t;
+/** Cubic deceleration. */
+export const easeOutCubic = (t) => --t * t * t + 1;
+/** Cubic acceleration then deceleration. */
+export const easeInOutCubic = (t) => t < 0.5 ? 4 * t * t * t : (t - 1) * (2 * t - 2) * (2 * t - 2) + 1;
+/** Overshoot then settle — dramatic entrance. */
+export const easeBackOut = (t) => {
+    const c = 1.70158;
+    return 1 + --t * t * ((c + 1) * t + c);
+};
+/** Overshoot in both directions — bouncy. */
+export const easeBackInOut = (t) => {
+    const c = 1.70158 * 1.525;
+    if ((t *= 2) < 1)
+        return 0.5 * (t * t * ((c + 1) * t - c));
+    return 0.5 * ((t -= 2) * t * ((c + 1) * t + c) + 2);
+};
+/** Bounce effect at the end. */
+export const easeOutBounce = (t) => {
+    if (t < 1 / 2.75) {
+        return 7.5625 * t * t;
+    }
+    else if (t < 2 / 2.75) {
+        return 7.5625 * (t -= 1.5 / 2.75) * t + 0.75;
+    }
+    else if (t < 2.5 / 2.75) {
+        return 7.5625 * (t -= 2.25 / 2.75) * t + 0.9375;
+    }
+    else {
+        return 7.5625 * (t -= 2.625 / 2.75) * t + 0.984375;
+    }
+};
+/** Bounce effect at the start. */
+export const easeInBounce = (t) => 1 - easeOutBounce(1 - t);
+/** Elastic effect — spring-like overshoot. */
+export const easeOutElastic = (t) => {
+    if (t === 0 || t === 1)
+        return t;
+    return Math.pow(2, -10 * t) * Math.sin((t - 0.1) * 5 * Math.PI) + 1;
+};
+//# sourceMappingURL=easing.js.map

package/dist/animation/easing.js.map

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

package/dist/animation/index.d.ts

@@ -0,0 +1,7 @@
+export * from './easing.js';
+export * from './multiple.js';
+export * from './properties.js';
+export * from './sequences.js';
+export * from './sprite-sheet.js';
+export * from './tween.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/animation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/animation/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,mBAAmB,CAAA;AACjC,cAAc,YAAY,CAAA"}

package/dist/animation/index.js

@@ -0,0 +1,7 @@
+export * from './easing.js';
+export * from './multiple.js';
+export * from './properties.js';
+export * from './sequences.js';
+export * from './sprite-sheet.js';
+export * from './tween.js';
+//# sourceMappingURL=index.js.map

package/dist/animation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/animation/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,mBAAmB,CAAA;AACjC,cAAc,YAAY,CAAA"}

package/dist/animation/multiple.d.ts

@@ -0,0 +1,26 @@
+import type { AnimationKeyframe } from '../nodes/animation-player.js';
+/**
+ * The **`multiKF`** function returns a keyframe using multiple keyframes.
+ * @param kfs The keyframes
+ * @returns A keyframe
+ *
+ * @example
+ * ```ts
+ * animPlayer
+ *   .add('idle', {
+ *     fps: 4,
+ *     keyframes: [
+ *       multiKF([ // In the same frame `multiKF` executes both keyframes.
+ *         () => sprite.textureId = 'idle',
+ *         () => sprite.margin.x = 0,
+ *       ]),
+ *       () => sprite.margin.x = 16,
+ *       () => sprite.margin.x = 32,
+ *       () => sprite.margin.x = 48,
+ *     ],
+ *     loop: true,
+ *   })
+ * ```
+ */
+export declare function multiKF(kfs: AnimationKeyframe[]): AnimationKeyframe;
+//# sourceMappingURL=multiple.d.ts.map

package/dist/animation/multiple.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multiple.d.ts","sourceRoot":"","sources":["../../src/animation/multiple.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAErE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,iBAAiB,EAAE,GAAG,iBAAiB,CAEnE"}

package/dist/animation/multiple.js

@@ -0,0 +1,27 @@
+/**
+ * The **`multiKF`** function returns a keyframe using multiple keyframes.
+ * @param kfs The keyframes
+ * @returns A keyframe
+ *
+ * @example
+ * ```ts
+ * animPlayer
+ *   .add('idle', {
+ *     fps: 4,
+ *     keyframes: [
+ *       multiKF([ // In the same frame `multiKF` executes both keyframes.
+ *         () => sprite.textureId = 'idle',
+ *         () => sprite.margin.x = 0,
+ *       ]),
+ *       () => sprite.margin.x = 16,
+ *       () => sprite.margin.x = 32,
+ *       () => sprite.margin.x = 48,
+ *     ],
+ *     loop: true,
+ *   })
+ * ```
+ */
+export function multiKF(kfs) {
+    return (time) => kfs.forEach((kf) => kf(time));
+}
+//# sourceMappingURL=multiple.js.map

package/dist/animation/multiple.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multiple.js","sourceRoot":"","sources":["../../src/animation/multiple.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,OAAO,CAAC,GAAwB;IAC9C,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAA;AAChD,CAAC"}

package/dist/animation/properties.d.ts

@@ -0,0 +1,30 @@
+import type { AnimationKeyframe } from '../nodes/animation-player.js';
+import type { Node } from '../nodes/_node.js';
+/**
+ * The **`kfFromProp`** function returns a keyframe that sets a property in a `Node`.
+ * @param node A instance of `Node`
+ * @param property A key
+ * @param value A value
+ * @returns A keyframe
+ *
+ * @example
+ * ```ts
+ * animPlayer
+ *   .add('idle', {
+ *     fps: 4,
+ *     keyframes: [
+ *       multiKF([
+ *         kfFromProp(sprite, 'textureId', 'idle'),
+ *         // () => sprite.margin.x = 0,
+ *         kfFromProp(sprite, 'margin', new Vector2(0, 0)),
+ *       ]),
+ *       kfFromProp(sprite, 'margin', new Vector2(16, 0)),
+ *       kfFromProp(sprite, 'margin', new Vector2(32, 0)),
+ *       kfFromProp(sprite, 'margin', new Vector2(48, 0)),
+ *     ],
+ *     loop: true,
+ *   })
+ * ```
+ */
+export declare function kfFromProp<T extends Node, K extends keyof T>(node: T, property: K, value: T[K]): AnimationKeyframe;
+//# sourceMappingURL=properties.d.ts.map

package/dist/animation/properties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"properties.d.ts","sourceRoot":"","sources":["../../src/animation/properties.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AACrE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAA;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,SAAS,MAAM,CAAC,EAC1D,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,CAAC,EACX,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,GACV,iBAAiB,CAInB"}

package/dist/animation/properties.js

@@ -0,0 +1,32 @@
+/**
+ * The **`kfFromProp`** function returns a keyframe that sets a property in a `Node`.
+ * @param node A instance of `Node`
+ * @param property A key
+ * @param value A value
+ * @returns A keyframe
+ *
+ * @example
+ * ```ts
+ * animPlayer
+ *   .add('idle', {
+ *     fps: 4,
+ *     keyframes: [
+ *       multiKF([
+ *         kfFromProp(sprite, 'textureId', 'idle'),
+ *         // () => sprite.margin.x = 0,
+ *         kfFromProp(sprite, 'margin', new Vector2(0, 0)),
+ *       ]),
+ *       kfFromProp(sprite, 'margin', new Vector2(16, 0)),
+ *       kfFromProp(sprite, 'margin', new Vector2(32, 0)),
+ *       kfFromProp(sprite, 'margin', new Vector2(48, 0)),
+ *     ],
+ *     loop: true,
+ *   })
+ * ```
+ */
+export function kfFromProp(node, property, value) {
+    return () => {
+        node[property] = value;
+    };
+}
+//# sourceMappingURL=properties.js.map

package/dist/animation/properties.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"properties.js","sourceRoot":"","sources":["../../src/animation/properties.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,UAAU,CACxB,IAAO,EACP,QAAW,EACX,KAAW;IAEX,OAAO,GAAG,EAAE;QACV,IAAI,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAA;IACxB,CAAC,CAAA;AACH,CAAC"}

package/dist/animation/sequences.d.ts

@@ -0,0 +1,30 @@
+import type { TweenController } from './tween.js';
+/**
+ * Executes tweens sequentially — each tween starts after the previous one completes.
+ *
+ * @example
+ * ```ts
+ * import { tween, sequence } from 'dinix/animation'
+ *
+ * sequence([
+ *   tween({ target: sprite, prop: 'opacity', from: 0, to: 1, duration: 0.5 }),
+ *   tween({ target: sprite, prop: 'position', from: 0, to: 100, duration: 1 }),
+ * ])
+ * ```
+ */
+export declare function sequence(tweens: TweenController[]): void;
+/**
+ * Executes tweens in parallel — all tweens start simultaneously.
+ *
+ * @example
+ * ```ts
+ * import { tween, parallel } from 'dinix/animation'
+ *
+ * parallel([
+ *   tween({ target: sprite, prop: 'opacity', from: 0, to: 1, duration: 0.5 }),
+ *   tween({ target: sprite, prop: 'position', from: 0, to: 100, duration: 1 }),
+ * ])
+ * ```
+ */
+export declare function parallel(tweens: TweenController[]): void;
+//# sourceMappingURL=sequences.d.ts.map

package/dist/animation/sequences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequences.d.ts","sourceRoot":"","sources":["../../src/animation/sequences.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,IAAI,CAoBxD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,IAAI,CAIxD"}

package/dist/animation/sequences.js

@@ -0,0 +1,50 @@
+/**
+ * Executes tweens sequentially — each tween starts after the previous one completes.
+ *
+ * @example
+ * ```ts
+ * import { tween, sequence } from 'dinix/animation'
+ *
+ * sequence([
+ *   tween({ target: sprite, prop: 'opacity', from: 0, to: 1, duration: 0.5 }),
+ *   tween({ target: sprite, prop: 'position', from: 0, to: 100, duration: 1 }),
+ * ])
+ * ```
+ */
+export function sequence(tweens) {
+    if (tweens.length === 0)
+        return;
+    for (let i = tweens.length - 1; i > 0; i--) {
+        const current = tweens[i];
+        const prev = tweens[i - 1];
+        current.pause();
+        const check = () => {
+            if (prev.isPlaying) {
+                requestAnimationFrame(check);
+                return;
+            }
+            current.resume();
+        };
+        requestAnimationFrame(check);
+    }
+    tweens[0].resume();
+}
+/**
+ * Executes tweens in parallel — all tweens start simultaneously.
+ *
+ * @example
+ * ```ts
+ * import { tween, parallel } from 'dinix/animation'
+ *
+ * parallel([
+ *   tween({ target: sprite, prop: 'opacity', from: 0, to: 1, duration: 0.5 }),
+ *   tween({ target: sprite, prop: 'position', from: 0, to: 100, duration: 1 }),
+ * ])
+ * ```
+ */
+export function parallel(tweens) {
+    for (const t of tweens) {
+        t.resume();
+    }
+}
+//# sourceMappingURL=sequences.js.map

package/dist/animation/sequences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequences.js","sourceRoot":"","sources":["../../src/animation/sequences.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAyB;IAChD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAM;IAE/B,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAE,CAAA;QAC1B,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAE,CAAA;QAE3B,OAAO,CAAC,KAAK,EAAE,CAAA;QAEf,MAAM,KAAK,GAAG,GAAG,EAAE;YACjB,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBACnB,qBAAqB,CAAC,KAAK,CAAC,CAAA;gBAC5B,OAAM;YACR,CAAC;YACD,OAAO,CAAC,MAAM,EAAE,CAAA;QAClB,CAAC,CAAA;QACD,qBAAqB,CAAC,KAAK,CAAC,CAAA;IAC9B,CAAC;IAED,MAAM,CAAC,CAAC,CAAE,CAAC,MAAM,EAAE,CAAA;AACrB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAyB;IAChD,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,CAAC,CAAC,MAAM,EAAE,CAAA;IACZ,CAAC;AACH,CAAC"}

package/dist/animation/sprite-sheet.d.ts

@@ -0,0 +1,81 @@
+import type { NodeReference } from '../hooks/use-node.js';
+import type { Animation, AnimationKeyframe } from '../nodes/animation-player.js';
+import type { PrimaryNode } from '../nodes/index.js';
+import { Sprite } from '../nodes/node2d/sprite.js';
+/**
+ * The **`keyframesFromSheet`** function generates keyframes from a sprite sheet texture.
+ * It automatically calculates frame dimensions and margins based on the grid layout.
+ *
+ * @param sprite A sprite instance of `Sprite`
+ * @param textureId A texture id. If it is null, the sprite texture will not change.
+ * @param columns Count of sprites in horizontal.
+ * @param rows Count of sprites in vertical.
+ * @param range Optional `[from, to]` tuple (0-indexed, inclusive) to select a subset of frames from the sheet.
+ * @returns A keyframes array
+ *
+ * @example
+ * ```ts
+ * // Full sprite sheet (all frames)
+ * const allFrames = keyframesFromSheet(sprite, texture, 4, 2)
+ *
+ * // Only frames 0-3 (first row of a 4x2 sheet)
+ * const walkFrames = keyframesFromSheet(sprite, texture, 4, 2, [0, 3])
+ *
+ * // Only frames 4-7 (second row of a 4x2 sheet)
+ * const runFrames = keyframesFromSheet(sprite, texture, 4, 2, [4, 7])
+ * ```
+ */
+export declare function keyframesFromSheet(sprite: Sprite, textureId: symbol | null | undefined, columns?: number, rows?: number, range?: [number, number]): AnimationKeyframe[];
+/**
+ * Options for creating an animation from a sprite sheet.
+ */
+export interface SpriteSheetAnimationOptions {
+    /** Number of columns in the sprite sheet grid. @default 1 */
+    columns?: number;
+    /** Number of rows in the sprite sheet grid. @default 1 */
+    rows?: number;
+    /** Optional `[from, to]` tuple (0-indexed, inclusive) to select a subset of frames. */
+    range?: [number, number];
+    /** Total duration of the animation in seconds. FPS is calculated as `(columns * rows) / duration`. */
+    duration: number;
+    /** Whether the animation should loop. @default undefined */
+    loop?: boolean;
+}
+/**
+ * The **`animationFromSheet`** function creates a complete `Animation` object from a sprite sheet.
+ * It combines `keyframesFromSheet` with automatic FPS calculation based on the total frame count
+ * and desired duration.
+ *
+ * @param sprite A `Sprite` instance or a `NodeReference` to a sprite node
+ * @param textureId A texture id. If `null`, the sprite texture will not change. If `undefined`, uses the sprite's current texture.
+ * @param options Animation options including grid dimensions, duration, and loop settings
+ * @returns A complete `Animation` object ready for `AnimationPlayer`
+ *
+ * @example
+ * ```tsx
+ * // Basic usage — 4-column sprite sheet, 1 second animation
+ * const idle = animationFromSheet(sprite, IDLE_TEXTURE, {
+ *   columns: 4,
+ *   duration: 1,
+ *   loop: true,
+ * })
+ *
+ * // With range — only first 3 frames
+ * const walk = animationFromSheet(sprite, WALK_TEXTURE, {
+ *   columns: 4,
+ *   rows: 2,
+ *   range: [0, 2],
+ *   duration: 0.75,
+ *   loop: true,
+ * })
+ *
+ * // Using a NodeReference (deferred)
+ * const sprite = useNode(PrimaryNode.Sprite)
+ * const anim = animationFromSheet(sprite, TEXTURE, {
+ *   columns: 4,
+ *   duration: 1,
+ * })
+ * ```
+ */
+export declare function animationFromSheet(sprite: Sprite | NodeReference<PrimaryNode.Sprite>, textureId: symbol | null | undefined, options: SpriteSheetAnimationOptions): Animation;
+//# sourceMappingURL=sprite-sheet.d.ts.map

package/dist/animation/sprite-sheet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sprite-sheet.d.ts","sourceRoot":"","sources":["../../src/animation/sprite-sheet.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEzD,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAChF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAA;AAIlD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,OAAO,GAAE,MAAU,EACnB,IAAI,GAAE,MAAU,EAChB,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GACvB,iBAAiB,EAAE,CA8BrB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,uFAAuF;IACvF,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACxB,sGAAsG;IACtG,QAAQ,EAAE,MAAM,CAAA;IAChB,4DAA4D;IAC5D,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC,WAAW,CAAC,MAAM,CAAC,EAClD,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,OAAO,EAAE,2BAA2B,GACnC,SAAS,CAmBX"}

package/dist/animation/sprite-sheet.js

@@ -0,0 +1,103 @@
+import { getTexture } from '../assets/texture.js';
+import { Vector2 } from '../math/vector2.js';
+import { Sprite } from '../nodes/node2d/sprite.js';
+import { multiKF } from './multiple.js';
+import { kfFromProp } from './properties.js';
+/**
+ * The **`keyframesFromSheet`** function generates keyframes from a sprite sheet texture.
+ * It automatically calculates frame dimensions and margins based on the grid layout.
+ *
+ * @param sprite A sprite instance of `Sprite`
+ * @param textureId A texture id. If it is null, the sprite texture will not change.
+ * @param columns Count of sprites in horizontal.
+ * @param rows Count of sprites in vertical.
+ * @param range Optional `[from, to]` tuple (0-indexed, inclusive) to select a subset of frames from the sheet.
+ * @returns A keyframes array
+ *
+ * @example
+ * ```ts
+ * // Full sprite sheet (all frames)
+ * const allFrames = keyframesFromSheet(sprite, texture, 4, 2)
+ *
+ * // Only frames 0-3 (first row of a 4x2 sheet)
+ * const walkFrames = keyframesFromSheet(sprite, texture, 4, 2, [0, 3])
+ *
+ * // Only frames 4-7 (second row of a 4x2 sheet)
+ * const runFrames = keyframesFromSheet(sprite, texture, 4, 2, [4, 7])
+ * ```
+ */
+export function keyframesFromSheet(sprite, textureId, columns = 1, rows = 1, range) {
+    const texture = textureId ? getTexture(textureId) : sprite.getTexture();
+    const spriteWidth = texture?.width ?? 0;
+    const spriteHeight = texture?.height ?? 0;
+    const sizeX = spriteWidth / columns;
+    const sizeY = spriteHeight / rows;
+    const count = columns * rows;
+    const from = Math.min(range?.[0] ?? 0, count - 1);
+    const to = Math.max(range?.[1] ?? count - 1, from);
+    sprite.sourceSize = new Vector2(sizeX, sizeY);
+    const kfs = Array.from({ length: to - from + 1 }, (_, i) => {
+        const index = i + from;
+        const x = index % columns;
+        const y = Math.floor(index / columns);
+        return kfFromProp(sprite, 'margin', new Vector2(x * sizeX, y * sizeY));
+    });
+    return [
+        multiKF([
+            ...(textureId ? [kfFromProp(sprite, 'textureId', textureId)] : []),
+            ...(kfs[0] ? [kfs[0]] : []),
+        ]),
+        ...kfs.slice(1),
+    ];
+}
+/**
+ * The **`animationFromSheet`** function creates a complete `Animation` object from a sprite sheet.
+ * It combines `keyframesFromSheet` with automatic FPS calculation based on the total frame count
+ * and desired duration.
+ *
+ * @param sprite A `Sprite` instance or a `NodeReference` to a sprite node
+ * @param textureId A texture id. If `null`, the sprite texture will not change. If `undefined`, uses the sprite's current texture.
+ * @param options Animation options including grid dimensions, duration, and loop settings
+ * @returns A complete `Animation` object ready for `AnimationPlayer`
+ *
+ * @example
+ * ```tsx
+ * // Basic usage — 4-column sprite sheet, 1 second animation
+ * const idle = animationFromSheet(sprite, IDLE_TEXTURE, {
+ *   columns: 4,
+ *   duration: 1,
+ *   loop: true,
+ * })
+ *
+ * // With range — only first 3 frames
+ * const walk = animationFromSheet(sprite, WALK_TEXTURE, {
+ *   columns: 4,
+ *   rows: 2,
+ *   range: [0, 2],
+ *   duration: 0.75,
+ *   loop: true,
+ * })
+ *
+ * // Using a NodeReference (deferred)
+ * const sprite = useNode(PrimaryNode.Sprite)
+ * const anim = animationFromSheet(sprite, TEXTURE, {
+ *   columns: 4,
+ *   duration: 1,
+ * })
+ * ```
+ */
+export function animationFromSheet(sprite, textureId, options) {
+    const node = sprite instanceof Sprite ? sprite : sprite.signal();
+    if (node == null)
+        return {
+            keyframes: [],
+            fps: 1,
+            loop: false,
+        };
+    return {
+        keyframes: keyframesFromSheet(node, textureId ?? null, options.columns, options.rows, options.range),
+        fps: ((options.columns ?? 1) * (options.rows ?? 1)) / options.duration,
+        loop: options.loop,
+    };
+}
+//# sourceMappingURL=sprite-sheet.js.map

package/dist/animation/sprite-sheet.js.map

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

package/dist/animation/tween.d.ts

@@ -0,0 +1,78 @@
+import type { EasingFn } from './easing.js';
+/**
+ * Options for creating a tween.
+ */
+export interface TweenOptions<T> {
+    /** The object whose property will be interpolated. */
+    target: T;
+    /** The property name to interpolate. */
+    prop: keyof T;
+    /** Start value. */
+    from: number;
+    /** End value. */
+    to: number;
+    /** Duration in seconds. */
+    duration: number;
+    /** Easing function (default: linear). */
+    easing?: EasingFn;
+    /** Called every frame with the current interpolated value. */
+    onUpdate?: (value: number) => void;
+    /** Called when the tween completes. */
+    onComplete?: () => void;
+}
+/**
+ * Controls a running tween.
+ */
+export interface TweenController {
+    /** Whether the tween is currently playing. */
+    readonly isPlaying: boolean;
+    /** Current progress from 0 to 1. */
+    readonly progress: number;
+    /** Pauses the tween. */
+    pause(): void;
+    /** Resumes the tween. */
+    resume(): void;
+    /** Stops the tween and resets progress. */
+    stop(): void;
+}
+/**
+ * Creates a tween that interpolates a numeric property on a target object.
+ *
+ * @example
+ * ```ts
+ * import { tween, easeOutQuad } from 'dinix/animation'
+ *
+ * const controller = tween({
+ *   target: sprite,
+ *   prop: 'opacity',
+ *   from: 0,
+ *   to: 1,
+ *   duration: 0.5,
+ *   easing: easeOutQuad,
+ *   onComplete: () => console.log('fade in done'),
+ * })
+ *
+ * // Later:
+ * controller.pause()
+ * controller.resume()
+ * ```
+ */
+export declare function tween<T>(options: TweenOptions<T>): TweenController;
+/**
+ * Creates a tween that updates a callback with interpolated values.
+ * Useful for animating values without a target object.
+ *
+ * @example
+ * ```ts
+ * import { tweenValue } from 'dinix/animation'
+ *
+ * tweenValue({
+ *   from: 0,
+ *   to: 100,
+ *   duration: 1,
+ *   onUpdate: (value) => console.log(value),
+ * })
+ * ```
+ */
+export declare function tweenValue(options: Omit<TweenOptions<Record<string, number>>, 'target' | 'prop'>): TweenController;
+//# sourceMappingURL=tween.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tween.d.ts","sourceRoot":"","sources":["../../src/animation/tween.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAG3C;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,sDAAsD;IACtD,MAAM,EAAE,CAAC,CAAA;IACT,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC,CAAA;IACb,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,iBAAiB;IACjB,EAAE,EAAE,MAAM,CAAA;IACV,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAA;IAChB,yCAAyC;IACzC,MAAM,CAAC,EAAE,QAAQ,CAAA;IACjB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,IAAI,CAAA;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,oCAAoC;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,wBAAwB;IACxB,KAAK,IAAI,IAAI,CAAA;IACb,yBAAyB;IACzB,MAAM,IAAI,IAAI,CAAA;IACd,2CAA2C;IAC3C,IAAI,IAAI,IAAI,CAAA;CACb;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,eAAe,CAyDlE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC,GACrE,eAAe,CAWjB"}