@flighthq/spritesheet 0.1.0

package/dist/spritesheetPlayer.js

@@ -0,0 +1,269 @@
+import { clearSignal, createSignal, emitSignal } from '@flighthq/signals';
+export function acquireSpritesheetPlayer() {
+    if (playerPool.length > 0) {
+        const p = playerPool.pop();
+        // Reset to a clean idle state (signals are already disconnected by releaseSpritesheetPlayer).
+        p.animation = null;
+        p.complete = true;
+        p.elapsed = 0;
+        p.frameIndex = 0;
+        p.paused = false;
+        p.queue.length = 0;
+        p.speed = 1;
+        return p;
+    }
+    return createSpritesheetPlayer();
+}
+export function cloneSpritesheetPlayer(player) {
+    return {
+        animation: player.animation,
+        complete: player.complete,
+        elapsed: player.elapsed,
+        frameIndex: player.frameIndex,
+        onComplete: createSignal(),
+        onLoop: createSignal(),
+        paused: player.paused,
+        queue: [...player.queue],
+        speed: player.speed,
+    };
+}
+export function createSpritesheetPlayer(obj) {
+    return {
+        animation: obj?.animation ?? null,
+        complete: obj?.complete ?? true,
+        elapsed: obj?.elapsed ?? 0,
+        frameIndex: obj?.frameIndex ?? 0,
+        onComplete: obj?.onComplete ?? createSignal(),
+        onLoop: obj?.onLoop ?? createSignal(),
+        paused: obj?.paused ?? false,
+        queue: obj?.queue ?? [],
+        speed: obj?.speed ?? 1,
+    };
+}
+export function disposeSpritesheetPlayer(player) {
+    clearSignal(player.onComplete);
+    clearSignal(player.onLoop);
+    player.animation = null;
+    player.complete = true;
+    player.queue.length = 0;
+}
+export function getSpritesheetPlayerFrame(player, spritesheet) {
+    const { animation, frameIndex } = player;
+    if (animation === null || animation.frames.length === 0)
+        return null;
+    const spriteFrameIndex = animation.frames[frameIndex];
+    return spritesheet.frames[spriteFrameIndex] ?? null;
+}
+// Returns the `SpritesheetFrame` for a neighbor frame offset relative to the current playback head,
+// without mutating the player. Positive `frameOffset` looks ahead; negative looks behind.
+// The offset wraps within the animation's frame list. Returns null when no animation is set or
+// the animation has no frames.
+// Primary use: onion-skin preview in editors (show neighboring frames without advancing the head).
+export function getSpritesheetPlayerFrameAt(player, spritesheet, frameOffset) {
+    const { animation, frameIndex } = player;
+    if (animation === null || animation.frames.length === 0)
+        return null;
+    const n = animation.frames.length;
+    // Wrap the offset within [0, n) using positive modulo.
+    const targetIndex = (((frameIndex + frameOffset) % n) + n) % n;
+    const spriteFrameIndex = animation.frames[targetIndex];
+    return spritesheet.frames[spriteFrameIndex] ?? null;
+}
+export function pauseSpritesheetPlayer(player) {
+    player.paused = true;
+}
+export function playSpritesheetAnimation(player, animation, restart = true) {
+    if (!restart && animation === player.animation)
+        return;
+    player.animation = animation;
+    player.complete = animation === null;
+    player.elapsed = 0;
+    player.frameIndex = 0;
+    player.queue.length = 0;
+}
+export function queueSpritesheetAnimation(player, animation) {
+    player.queue.push(animation);
+}
+// Returns a player acquired from the pool to the pool for reuse.
+// Disconnects all signals before returning — the next acquire starts with fresh signal state.
+// Every `acquireSpritesheetPlayer` call must have a matching `releaseSpritesheetPlayer`.
+export function releaseSpritesheetPlayer(player) {
+    clearSignal(player.onComplete);
+    clearSignal(player.onLoop);
+    player.animation = null;
+    player.complete = true;
+    player.elapsed = 0;
+    player.frameIndex = 0;
+    player.paused = false;
+    player.queue.length = 0;
+    player.speed = 1;
+    playerPool.push(player);
+}
+export function resumeSpritesheetPlayer(player) {
+    player.paused = false;
+}
+export function seekSpritesheetPlayerToFrame(player, frameIndex) {
+    const { animation } = player;
+    if (animation === null || animation.frames.length === 0)
+        return;
+    const clamped = Math.max(0, Math.min(frameIndex, animation.frames.length - 1));
+    player.frameIndex = clamped;
+    // Sync elapsed to the start of the target virtual frame index that maps to this display frame.
+    // For simplicity, seek to the first virtual index that produces this display frame.
+    player.elapsed = resolveVirtualIndexStartTime(animation, clamped);
+}
+export function seekSpritesheetPlayerToTime(player, time) {
+    const { animation } = player;
+    if (animation === null || animation.frames.length === 0)
+        return;
+    const totalTime = resolveAnimationTotalTime(animation);
+    player.elapsed = Math.max(0, Math.min(time, totalTime));
+    player.frameIndex = resolveFrameIndexFromElapsed(animation, player.elapsed);
+}
+export function stopSpritesheetPlayer(player) {
+    player.elapsed = 0;
+    player.frameIndex = 0;
+    player.complete = true;
+    player.queue.length = 0;
+}
+export function updateSpritesheetPlayer(player, deltaTime) {
+    const { animation } = player;
+    if (animation === null || player.complete || player.paused || animation.frames.length === 0)
+        return false;
+    const { loop } = animation;
+    const totalTime = resolveAnimationTotalTime(animation);
+    const prevLoopCount = Math.floor(player.elapsed / totalTime);
+    player.elapsed += deltaTime * player.speed;
+    if (!loop && player.elapsed >= totalTime) {
+        if (player.queue.length > 0) {
+            const next = player.queue.shift();
+            player.animation = next;
+            player.elapsed = 0;
+            player.frameIndex = 0;
+            return true;
+        }
+        player.elapsed = totalTime;
+        // On completion, show the last virtual frame in the direction sequence.
+        const lastVi = resolveVirtualFrameCount(animation) - 1;
+        player.frameIndex = resolveVirtualIndexToDisplayIndex(animation, lastVi);
+        player.complete = true;
+        emitSignal(player.onComplete);
+        return true;
+    }
+    if (Math.floor(player.elapsed / totalTime) > prevLoopCount)
+        emitSignal(player.onLoop);
+    const timeInLoop = player.elapsed % totalTime;
+    const vi = resolveVirtualIndexFromTime(animation, timeInLoop);
+    player.frameIndex = resolveVirtualIndexToDisplayIndex(animation, vi);
+    return true;
+}
+// Returns a cached cumulative-duration array for variable-timing animations.
+// The array has virtualCount+1 entries: [0, d0, d0+d1, ..., total].
+function getCumulativeDurations(animation) {
+    const cached = cumulativeDurationsCache.get(animation);
+    if (cached !== undefined)
+        return cached;
+    const { frames, frameDuration, frameDurations } = animation;
+    const n = frames.length;
+    const virtualCount = resolveVirtualFrameCount(animation);
+    const arr = new Float64Array(virtualCount + 1);
+    let t = 0;
+    for (let vi = 0; vi < virtualCount; vi++) {
+        arr[vi] = t;
+        // Map virtual index to the forward frame index for the duration lookup.
+        const fi = vi < n ? vi : 2 * (n - 1) - vi;
+        t += frameDurations[fi] ?? frameDuration;
+    }
+    arr[virtualCount] = t || 1;
+    cumulativeDurationsCache.set(animation, arr);
+    return arr;
+}
+// Computes the total duration of one full virtual loop of the animation (ms).
+// For variable-duration animations, delegates to the cached cumulative array (O(1) after warm-up).
+function resolveAnimationTotalTime(animation) {
+    const { frameDuration, frameDurations } = animation;
+    if (frameDurations !== null) {
+        // Use the precomputed cumulative array: total is the last entry.
+        const arr = getCumulativeDurations(animation);
+        return arr[arr.length - 1];
+    }
+    const virtualCount = resolveVirtualFrameCount(animation);
+    return virtualCount * frameDuration || 1;
+}
+// Resolves a display frame index from elapsed time (used by seekSpritesheetPlayerToTime).
+function resolveFrameIndexFromElapsed(animation, elapsed) {
+    const totalTime = resolveAnimationTotalTime(animation);
+    const timeInLoop = elapsed % totalTime;
+    const vi = resolveVirtualIndexFromTime(animation, timeInLoop);
+    return resolveVirtualIndexToDisplayIndex(animation, vi);
+}
+// Returns the virtual frame count for an animation. Pingpong directions double the frame count
+// minus two endpoints: [0,1,2] → virtual [0,1,2,1] = 4 virtual frames (2*3-2=4).
+function resolveVirtualFrameCount(animation) {
+    const n = animation.frames.length;
+    const isPingpong = animation.direction === 'pingpong' || animation.direction === 'pingpong_reverse';
+    if (isPingpong && n > 1)
+        return 2 * n - 2;
+    return n;
+}
+// Given time within a single loop, returns the virtual frame index (direction-agnostic step count).
+// For variable-duration animations, uses the precomputed cumulative array for O(log n) binary search.
+function resolveVirtualIndexFromTime(animation, timeInLoop) {
+    const { frameDuration, frameDurations } = animation;
+    const virtualCount = resolveVirtualFrameCount(animation);
+    if (frameDurations !== null) {
+        // Binary search in the precomputed cumulative array.
+        const arr = getCumulativeDurations(animation);
+        let lo = 0;
+        let hi = virtualCount - 1;
+        while (lo < hi) {
+            const mid = (lo + hi + 1) >> 1;
+            if (arr[mid] <= timeInLoop) {
+                lo = mid;
+            }
+            else {
+                hi = mid - 1;
+            }
+        }
+        return lo;
+    }
+    return Math.min(Math.floor(timeInLoop / frameDuration), virtualCount - 1);
+}
+// Returns the elapsed time at the start of the given virtual frame index (for seeking).
+// Uses the precomputed cumulative array when available.
+function resolveVirtualIndexStartTime(animation, virtualIndex) {
+    const { frameDuration, frameDurations } = animation;
+    if (frameDurations !== null) {
+        const arr = getCumulativeDurations(animation);
+        return arr[virtualIndex];
+    }
+    return virtualIndex * frameDuration;
+}
+// Given a virtual frame index (0..virtualCount-1), returns the display frame index
+// (0..frames.length-1) accounting for direction.
+function resolveVirtualIndexToDisplayIndex(animation, virtualIndex) {
+    const { direction, frames } = animation;
+    const last = frames.length - 1;
+    switch (direction) {
+        case 'forward':
+            return virtualIndex;
+        case 'reverse':
+            return last - virtualIndex;
+        case 'pingpong':
+            // Virtual: [0,1,...,last, last-1,...,1] — forward then backward (no endpoint repeat).
+            return virtualIndex <= last ? virtualIndex : 2 * last - virtualIndex;
+        case 'pingpong_reverse':
+            // Virtual: [last,...,0, 1,...,last-1] — reverse then forward.
+            return virtualIndex <= last ? last - virtualIndex : virtualIndex - last;
+        default:
+            return virtualIndex;
+    }
+}
+// Pool for short-lived players — use acquire/release as paired brackets.
+const playerPool = [];
+// Cached cumulative virtual-frame start times per animation instance.
+// Key: SpritesheetAnimation entity. Value: Float64Array of length (virtualCount + 1) where
+// entry[i] = start time of virtual frame i, entry[virtualCount] = total loop time.
+// Built lazily on first access for variable-duration animations; uniform animations never need it.
+const cumulativeDurationsCache = new WeakMap();
+//# sourceMappingURL=spritesheetPlayer.js.map

package/dist/spritesheetPlayer.js.map

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

package/dist/spritesheetTimelineSource.d.ts

@@ -0,0 +1,3 @@
+import type { Spritesheet, SpritesheetAnimation, TimelineSource } from '@flighthq/types';
+export declare function createSpritesheetTimelineSource(spritesheet: Readonly<Spritesheet>, animation: Readonly<SpritesheetAnimation>): TimelineSource;
+//# sourceMappingURL=spritesheetTimelineSource.d.ts.map

package/dist/spritesheetTimelineSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spritesheetTimelineSource.d.ts","sourceRoot":"","sources":["../src/spritesheetTimelineSource.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAyB,WAAW,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAUhH,wBAAgB,+BAA+B,CAC7C,WAAW,EAAE,QAAQ,CAAC,WAAW,CAAC,EAClC,SAAS,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GACxC,cAAc,CA0BhB"}

package/dist/spritesheetTimelineSource.js

@@ -0,0 +1,38 @@
+import { createBitmap } from '@flighthq/displayobject';
+import { addNodeChild, invalidateNodeLocalTransform } from '@flighthq/node';
+// Exposes a spritesheet animation as a TimelineSource so a MovieClip can play it (the spritesheet side of
+// the timeline frame-source contract — `@flighthq/timeline` consumes `TimelineSource`, this produces one,
+// and neither depends on the other beyond the shared interface in `@flighthq/types`). Each frame swaps
+// the displayed atlas region and offset on a bitmap the source lazily creates as a child of the target
+// the first time it constructs onto that target; tracking the bitmap per target keeps the source
+// shareable across many MovieClips.
+//
+// Bind it with `setMovieClipSource(clip, createSpritesheetTimelineSource(sheet, anim))`, then `playMovieClip`.
+export function createSpritesheetTimelineSource(spritesheet, animation) {
+    const bitmaps = new WeakMap();
+    return {
+        totalFrames: animation.frames.length,
+        labels: [],
+        frameRate: 1000 / animation.frameDuration,
+        constructFrame(target, frame) {
+            const atlas = spritesheet.atlas;
+            if (atlas === null)
+                return;
+            let bitmap = bitmaps.get(target);
+            if (bitmap === undefined) {
+                bitmap = createBitmap();
+                bitmap.data.image = atlas.image;
+                addNodeChild(target, bitmap);
+                bitmaps.set(target, bitmap);
+            }
+            const sheetFrame = spritesheet.frames[animation.frames[frame - 1]];
+            if (sheetFrame === undefined)
+                return;
+            bitmap.data.sourceRectangle = atlas.regions[sheetFrame.id];
+            bitmap.x = sheetFrame.offsetX - animation.originX;
+            bitmap.y = sheetFrame.offsetY - animation.originY;
+            invalidateNodeLocalTransform(bitmap);
+        },
+    };
+}
+//# sourceMappingURL=spritesheetTimelineSource.js.map

package/dist/spritesheetTimelineSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spritesheetTimelineSource.js","sourceRoot":"","sources":["../src/spritesheetTimelineSource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,4BAA4B,EAAE,MAAM,gBAAgB,CAAC;AAG5E,0GAA0G;AAC1G,0GAA0G;AAC1G,uGAAuG;AACvG,uGAAuG;AACvG,iGAAiG;AACjG,oCAAoC;AACpC,EAAE;AACF,+GAA+G;AAC/G,MAAM,UAAU,+BAA+B,CAC7C,WAAkC,EAClC,SAAyC;IAEzC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAyB,CAAC;IACrD,OAAO;QACL,WAAW,EAAE,SAAS,CAAC,MAAM,CAAC,MAAM;QACpC,MAAM,EAAE,EAAE;QACV,SAAS,EAAE,IAAI,GAAG,SAAS,CAAC,aAAa;QACzC,cAAc,CAAC,MAAqB,EAAE,KAAa;YACjD,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC;YAChC,IAAI,KAAK,KAAK,IAAI;gBAAE,OAAO;YAE3B,IAAI,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACjC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,MAAM,GAAG,YAAY,EAAE,CAAC;gBACxB,MAAM,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;gBAChC,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBAC7B,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC9B,CAAC;YAED,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;YACnE,IAAI,UAAU,KAAK,SAAS;gBAAE,OAAO;YACrC,MAAM,CAAC,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;YAC3D,MAAM,CAAC,CAAC,GAAG,UAAU,CAAC,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC;YAClD,MAAM,CAAC,CAAC,GAAG,UAAU,CAAC,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC;YAClD,4BAA4B,CAAC,MAAM,CAAC,CAAC;QACvC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/spritesheetValidation.d.ts

@@ -0,0 +1,5 @@
+import type { Spritesheet, SpritesheetValidationDiagnostic } from '@flighthq/types';
+import type { SpritesheetData } from './spritesheetData';
+export declare function validateSpritesheet(spritesheet: Readonly<Spritesheet>): SpritesheetValidationDiagnostic[] | null;
+export declare function validateSpritesheetData(data: Readonly<SpritesheetData>): SpritesheetValidationDiagnostic[] | null;
+//# sourceMappingURL=spritesheetValidation.d.ts.map

package/dist/spritesheetValidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spritesheetValidation.d.ts","sourceRoot":"","sources":["../src/spritesheetValidation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,+BAA+B,EAAE,MAAM,iBAAiB,CAAC;AAEpF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAOzD,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,+BAA+B,EAAE,GAAG,IAAI,CAwChH;AAQD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,QAAQ,CAAC,eAAe,CAAC,GAAG,+BAA+B,EAAE,GAAG,IAAI,CA0CjH"}

package/dist/spritesheetValidation.js

@@ -0,0 +1,97 @@
+// Validates a runtime `Spritesheet` for structural integrity:
+// - Frames referencing atlas region IDs that do not exist in the atlas.
+// - Animations referencing frame indices outside the sheet's frame array bounds.
+// - Animations with zero frames.
+// Returns null when the spritesheet is valid, or an array of diagnostics when issues are found.
+export function validateSpritesheet(spritesheet) {
+    const diagnostics = [];
+    const { atlas, animations, frames } = spritesheet;
+    // Check frame → atlas region resolution.
+    if (atlas !== null) {
+        const regionIds = new Set(atlas.regions.map((r) => r.id));
+        for (let fi = 0; fi < frames.length; fi++) {
+            if (!regionIds.has(frames[fi].id)) {
+                diagnostics.push({
+                    animationName: null,
+                    frameIndex: fi,
+                    message: `Frame ${fi} references atlas region id ${frames[fi].id} which does not exist in the atlas.`,
+                    severity: 'error',
+                });
+            }
+        }
+    }
+    // Check animation → frame index resolution.
+    for (const [animName, anim] of Object.entries(animations)) {
+        if (anim.frames.length === 0) {
+            diagnostics.push({
+                animationName: animName,
+                frameIndex: null,
+                message: `Animation "${animName}" has no frames.`,
+                severity: 'warning',
+            });
+        }
+        for (let ai = 0; ai < anim.frames.length; ai++) {
+            const frameRef = anim.frames[ai];
+            if (frameRef < 0 || frameRef >= frames.length) {
+                diagnostics.push({
+                    animationName: animName,
+                    frameIndex: ai,
+                    message: `Animation "${animName}" references frame index ${frameRef} which is out of range (sheet has ${frames.length} frames).`,
+                    severity: 'error',
+                });
+            }
+        }
+    }
+    return diagnostics.length > 0 ? diagnostics : null;
+}
+// Validates a `SpritesheetData` descriptor for structural integrity:
+// - Frames with empty names (warning — not an error, positional fallback is used at hydration).
+// - Animations referencing frame names not found in the frame list.
+// - Animations with zero frame names (warning — all frames are used as fallback, which may be intentional).
+// - Per-frame duration arrays whose length does not match the frame name count.
+// Returns null when valid, or an array of diagnostics when issues are found.
+export function validateSpritesheetData(data) {
+    const diagnostics = [];
+    const { animations, frames } = data;
+    // Build a set of all frame names for fast lookup (skip empty names).
+    const frameNameSet = new Set();
+    for (const fd of frames) {
+        if (fd.name !== '') {
+            frameNameSet.add(fd.name);
+        }
+    }
+    for (const ad of animations) {
+        if (ad.frameNames.length === 0) {
+            diagnostics.push({
+                animationName: ad.name,
+                frameIndex: null,
+                message: `Animation "${ad.name}" has no frameNames — all sheet frames will be used as the frame list.`,
+                severity: 'warning',
+            });
+        }
+        else {
+            for (let ai = 0; ai < ad.frameNames.length; ai++) {
+                const fname = ad.frameNames[ai];
+                if (!frameNameSet.has(fname)) {
+                    diagnostics.push({
+                        animationName: ad.name,
+                        frameIndex: ai,
+                        message: `Animation "${ad.name}" references frame name "${fname}" which is not present in the data frame list.`,
+                        severity: 'error',
+                    });
+                }
+            }
+            // Check per-frame duration array length matches frame name count.
+            if (ad.frameDurations !== null && ad.frameDurations.length !== ad.frameNames.length) {
+                diagnostics.push({
+                    animationName: ad.name,
+                    frameIndex: null,
+                    message: `Animation "${ad.name}" has ${ad.frameDurations.length} frameDurations but ${ad.frameNames.length} frameNames — lengths should match.`,
+                    severity: 'warning',
+                });
+            }
+        }
+    }
+    return diagnostics.length > 0 ? diagnostics : null;
+}
+//# sourceMappingURL=spritesheetValidation.js.map

package/dist/spritesheetValidation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spritesheetValidation.js","sourceRoot":"","sources":["../src/spritesheetValidation.ts"],"names":[],"mappings":"AAIA,8DAA8D;AAC9D,wEAAwE;AACxE,iFAAiF;AACjF,iCAAiC;AACjC,gGAAgG;AAChG,MAAM,UAAU,mBAAmB,CAAC,WAAkC;IACpE,MAAM,WAAW,GAAsC,EAAE,CAAC;IAC1D,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,WAAW,CAAC;IAClD,yCAAyC;IACzC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC1D,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC;YAC1C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;gBAClC,WAAW,CAAC,IAAI,CAAC;oBACf,aAAa,EAAE,IAAI;oBACnB,UAAU,EAAE,EAAE;oBACd,OAAO,EAAE,SAAS,EAAE,+BAA+B,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,qCAAqC;oBACrG,QAAQ,EAAE,OAAO;iBAClB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IACD,4CAA4C;IAC5C,KAAK,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QAC1D,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,WAAW,CAAC,IAAI,CAAC;gBACf,aAAa,EAAE,QAAQ;gBACvB,UAAU,EAAE,IAAI;gBAChB,OAAO,EAAE,cAAc,QAAQ,kBAAkB;gBACjD,QAAQ,EAAE,SAAS;aACpB,CAAC,CAAC;QACL,CAAC;QACD,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC;YAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACjC,IAAI,QAAQ,GAAG,CAAC,IAAI,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBAC9C,WAAW,CAAC,IAAI,CAAC;oBACf,aAAa,EAAE,QAAQ;oBACvB,UAAU,EAAE,EAAE;oBACd,OAAO,EAAE,cAAc,QAAQ,4BAA4B,QAAQ,qCAAqC,MAAM,CAAC,MAAM,WAAW;oBAChI,QAAQ,EAAE,OAAO;iBAClB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;AACrD,CAAC;AAED,qEAAqE;AACrE,gGAAgG;AAChG,oEAAoE;AACpE,4GAA4G;AAC5G,gFAAgF;AAChF,6EAA6E;AAC7E,MAAM,UAAU,uBAAuB,CAAC,IAA+B;IACrE,MAAM,WAAW,GAAsC,EAAE,CAAC;IAC1D,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACpC,qEAAqE;IACrE,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IACvC,KAAK,MAAM,EAAE,IAAI,MAAM,EAAE,CAAC;QACxB,IAAI,EAAE,CAAC,IAAI,KAAK,EAAE,EAAE,CAAC;YACnB,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IACD,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;QAC5B,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,WAAW,CAAC,IAAI,CAAC;gBACf,aAAa,EAAE,EAAE,CAAC,IAAI;gBACtB,UAAU,EAAE,IAAI;gBAChB,OAAO,EAAE,cAAc,EAAE,CAAC,IAAI,wEAAwE;gBACtG,QAAQ,EAAE,SAAS;aACpB,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC;gBACjD,MAAM,KAAK,GAAG,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;gBAChC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC7B,WAAW,CAAC,IAAI,CAAC;wBACf,aAAa,EAAE,EAAE,CAAC,IAAI;wBACtB,UAAU,EAAE,EAAE;wBACd,OAAO,EAAE,cAAc,EAAE,CAAC,IAAI,4BAA4B,KAAK,gDAAgD;wBAC/G,QAAQ,EAAE,OAAO;qBAClB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YACD,kEAAkE;YAClE,IAAI,EAAE,CAAC,cAAc,KAAK,IAAI,IAAI,EAAE,CAAC,cAAc,CAAC,MAAM,KAAK,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;gBACpF,WAAW,CAAC,IAAI,CAAC;oBACf,aAAa,EAAE,EAAE,CAAC,IAAI;oBACtB,UAAU,EAAE,IAAI;oBAChB,OAAO,EAAE,cAAc,EAAE,CAAC,IAAI,SAAS,EAAE,CAAC,cAAc,CAAC,MAAM,uBAAuB,EAAE,CAAC,UAAU,CAAC,MAAM,qCAAqC;oBAC/I,QAAQ,EAAE,SAAS;iBACpB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;AACrD,CAAC"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@flighthq/spritesheet",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/**/*.test.ts",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.js.map",
+    "!dist/**/*.test.d.ts.map"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean",
+    "test": "vitest run --config vitest.config.ts",
+    "test:watch": "vitest --watch --config vitest.config.ts",
+    "prepack": "npm run clean && npm run clean:dist && npm run build",
+    "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
+  },
+  "dependencies": {
+    "@flighthq/displayobject": "0.1.0",
+    "@flighthq/entity": "0.1.0",
+    "@flighthq/geometry": "0.1.0",
+    "@flighthq/image": "0.1.0",
+    "@flighthq/node": "0.1.0",
+    "@flighthq/signals": "0.1.0",
+    "@flighthq/textureatlas": "0.1.0",
+    "@flighthq/tileset": "0.1.0",
+    "@flighthq/types": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "description": "Spritesheet frame animation playback",
+  "sideEffects": false
+}

package/src/spritesheet.test.ts

@@ -0,0 +1,61 @@
+import { cloneSpritesheet, createSpritesheet, getSpritesheetAnimation } from './spritesheet';
+import { createSpritesheetAnimation } from './spritesheetAnimation';
+import { createSpritesheetFrame } from './spritesheetFrame';
+
+describe('cloneSpritesheet', () => {
+  it('returns a distinct entity with copies of all frames', () => {
+    const sheet = createSpritesheet();
+    const frame = createSpritesheetFrame({ id: 1, offsetX: 5, offsetY: 10, pivotX: 2, pivotY: 3, rotated: true });
+    sheet.frames.push(frame);
+    sheet.animations['walk'] = createSpritesheetAnimation();
+
+    const clone = cloneSpritesheet(sheet);
+
+    expect(clone).not.toBe(sheet);
+    expect(clone.frames).not.toBe(sheet.frames);
+    expect(clone.frames[0]).not.toBe(sheet.frames[0]);
+    expect(clone.frames[0].id).toBe(1);
+    expect(clone.frames[0].pivotX).toBe(2);
+    expect(clone.frames[0].rotated).toBe(true);
+    expect(clone.animations['walk']).toBe(sheet.animations['walk']);
+    expect(clone.atlas).toBe(sheet.atlas);
+  });
+});
+
+describe('createSpritesheet', () => {
+  it('initializes with null atlas, empty animations and frames', () => {
+    const sheet = createSpritesheet();
+    expect(sheet.atlas).toBeNull();
+    expect(sheet.frames).toHaveLength(0);
+    expect(Object.keys(sheet.animations)).toHaveLength(0);
+  });
+
+  it('uses provided animations and frames directly', () => {
+    const animations = { idle: createSpritesheetAnimation() };
+    const frames = [createSpritesheetFrame({ id: 0 })];
+    const sheet = createSpritesheet({ animations, frames });
+    expect(sheet.animations).toBe(animations);
+    expect(sheet.frames).toBe(frames);
+  });
+});
+
+describe('getSpritesheetAnimation', () => {
+  it('returns null when no animations exist', () => {
+    const sheet = createSpritesheet();
+    expect(getSpritesheetAnimation(sheet, 'walk')).toBeNull();
+  });
+
+  it('returns null when label does not match', () => {
+    const sheet = createSpritesheet();
+    sheet.animations['idle'] = createSpritesheetAnimation();
+    expect(getSpritesheetAnimation(sheet, 'walk')).toBeNull();
+  });
+
+  it('returns the matching animation by label', () => {
+    const sheet = createSpritesheet();
+    const walk = createSpritesheetAnimation();
+    sheet.animations['idle'] = createSpritesheetAnimation();
+    sheet.animations['walk'] = walk;
+    expect(getSpritesheetAnimation(sheet, 'walk')).toBe(walk);
+  });
+});