distark-render 1.0.5 → 1.0.7

package/dist/cli/verify.d.ts

@@ -0,0 +1,21 @@
+/**
+ * verify command - Math-based sanity checks on rig data (no rendering, no API calls)
+ *
+ * Usage:
+ *   distark-check verify <rig.json> [--checks all|bounds,visibility,proportions,zorder]
+ */
+interface CheckResult {
+    check: string;
+    status: 'passed' | 'failed' | 'warning';
+    detail?: string;
+}
+export interface VerifyReport {
+    input: string;
+    passed: string[];
+    failed: CheckResult[];
+    warnings: CheckResult[];
+    all_results: CheckResult[];
+}
+export declare function runVerify(args: string[]): Promise<void>;
+export {};
+//# sourceMappingURL=verify.d.ts.map

package/dist/cli/verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../cli/verify.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,UAAU,WAAW;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,WAAW,EAAE,WAAW,EAAE,CAAC;CAC9B;AAwID,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAqD7D"}

package/dist/cli/verify.js

@@ -0,0 +1,175 @@
+/**
+ * verify command - Math-based sanity checks on rig data (no rendering, no API calls)
+ *
+ * Usage:
+ *   distark-check verify <rig.json> [--checks all|bounds,visibility,proportions,zorder]
+ */
+import { readFile } from 'fs/promises';
+import { CharacterRigRenderer } from '../modules/renderRig.js';
+import { ImageLoader } from '../modules/imageLoad.js';
+function checkBounds(objects, width, height) {
+    const results = [];
+    for (const obj of objects) {
+        const left = obj.x - obj.width * obj.anchorX;
+        const top = obj.y - obj.height * obj.anchorY;
+        const right = left + obj.width;
+        const bottom = top + obj.height;
+        if (right < 0 || left > width || bottom < 0 || top > height) {
+            results.push({
+                check: 'bounds',
+                status: 'failed',
+                detail: `${obj.name} is completely offscreen (${Math.round(left)},${Math.round(top)} to ${Math.round(right)},${Math.round(bottom)})`,
+            });
+        }
+        else if (left < 0 || top < 0 || right > width || bottom > height) {
+            results.push({
+                check: 'bounds',
+                status: 'warning',
+                detail: `${obj.name} is partially offscreen (${Math.round(left)},${Math.round(top)} to ${Math.round(right)},${Math.round(bottom)})`,
+            });
+        }
+    }
+    if (results.length === 0) {
+        results.push({ check: 'bounds', status: 'passed' });
+    }
+    return results;
+}
+function checkVisibility(rigData, objects) {
+    const results = [];
+    const expectedParts = ['torso', 'head'];
+    for (const part of expectedParts) {
+        const visible = rigData.visibility?.[part] !== false;
+        const rendered = objects.some(o => o.name === part);
+        if (visible && !rendered) {
+            results.push({
+                check: 'visibility',
+                status: 'failed',
+                detail: `${part} should be visible but is not in render objects`,
+            });
+        }
+    }
+    // Check if imagePaths are defined for limbs (we don't load images in verify)
+    const limbParts = objects.filter(o => o.type === 'limb');
+    const missingPaths = [];
+    for (const limb of limbParts) {
+        const pathKey = limb.name;
+        const hasPath = rigData.imagePaths?.[pathKey];
+        if (!hasPath) {
+            missingPaths.push(limb.name);
+        }
+    }
+    if (missingPaths.length > 0) {
+        results.push({
+            check: 'visibility',
+            status: 'warning',
+            detail: `${missingPaths.length} limbs have no imagePath defined: ${missingPaths.join(', ')}`,
+        });
+    }
+    if (results.length === 0) {
+        results.push({ check: 'visibility', status: 'passed' });
+    }
+    return results;
+}
+function checkProportions(objects) {
+    const results = [];
+    const torso = objects.find(o => o.name === 'torso');
+    const head = objects.find(o => o.name === 'head');
+    if (torso && head) {
+        const headToTorsoRatio = (head.width * head.height) / (torso.width * torso.height);
+        if (headToTorsoRatio > 10) {
+            results.push({
+                check: 'proportions',
+                status: 'warning',
+                detail: `Head is very large relative to torso (ratio: ${headToTorsoRatio.toFixed(2)})`,
+            });
+        }
+        if (headToTorsoRatio < 0.01) {
+            results.push({
+                check: 'proportions',
+                status: 'warning',
+                detail: `Head is very small relative to torso (ratio: ${headToTorsoRatio.toFixed(2)})`,
+            });
+        }
+    }
+    for (const obj of objects) {
+        if (obj.width <= 0 || obj.height <= 0) {
+            results.push({
+                check: 'proportions',
+                status: 'failed',
+                detail: `${obj.name} has invalid dimensions: ${obj.width}x${obj.height}`,
+            });
+        }
+    }
+    if (results.length === 0) {
+        results.push({ check: 'proportions', status: 'passed' });
+    }
+    return results;
+}
+function checkZOrder(objects) {
+    const results = [];
+    const sorted = [...objects].sort((a, b) => a.zIndex - b.zIndex);
+    // Eyes/irises should render above head
+    const head = sorted.find(o => o.name === 'head');
+    const eyeParts = sorted.filter(o => o.type === 'eye' || o.type === 'iris' || o.type === 'eyelid');
+    if (head) {
+        for (const eye of eyeParts) {
+            if (eye.zIndex < head.zIndex) {
+                results.push({
+                    check: 'zorder',
+                    status: 'warning',
+                    detail: `${eye.name} (z:${eye.zIndex}) renders behind head (z:${head.zIndex})`,
+                });
+            }
+        }
+    }
+    if (results.length === 0) {
+        results.push({ check: 'zorder', status: 'passed' });
+    }
+    return results;
+}
+export async function runVerify(args) {
+    const inputFile = args.find(a => !a.startsWith('-')) || '';
+    if (!inputFile) {
+        console.error('Usage: distark-check verify <rig.json> [--checks all|bounds,visibility,proportions,zorder]');
+        process.exit(1);
+    }
+    const checksIdx = args.indexOf('--checks');
+    const checksStr = checksIdx !== -1 ? args[checksIdx + 1] : 'all';
+    const enabledChecks = checksStr === 'all'
+        ? ['bounds', 'visibility', 'proportions', 'zorder']
+        : checksStr.split(',');
+    const width = parseInt(args[args.indexOf('--width') + 1]) || 1000;
+    const height = parseInt(args[args.indexOf('--height') + 1]) || 1000;
+    const rigData = JSON.parse(await readFile(inputFile, 'utf-8'));
+    // Compute render data (no actual rendering needed)
+    const renderer = new CharacterRigRenderer(new ImageLoader());
+    const renderData = renderer.computeCharacterRigData(rigData, {
+        canvasWidth: width,
+        canvasHeight: height,
+    });
+    const allResults = [];
+    if (enabledChecks.includes('bounds')) {
+        allResults.push(...checkBounds(renderData.objects, width, height));
+    }
+    if (enabledChecks.includes('visibility')) {
+        allResults.push(...checkVisibility(rigData, renderData.objects));
+    }
+    if (enabledChecks.includes('proportions')) {
+        allResults.push(...checkProportions(renderData.objects));
+    }
+    if (enabledChecks.includes('zorder')) {
+        allResults.push(...checkZOrder(renderData.objects));
+    }
+    const report = {
+        input: inputFile,
+        passed: allResults.filter(r => r.status === 'passed').map(r => r.check),
+        failed: allResults.filter(r => r.status === 'failed'),
+        warnings: allResults.filter(r => r.status === 'warning'),
+        all_results: allResults,
+    };
+    console.log(JSON.stringify(report, null, 2));
+    if (report.failed.length > 0) {
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=verify.js.map

package/dist/cli/verify.js.map

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

package/dist/modules/animationDiff.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Animation Diff Utility
+ *
+ * Converts animation frames from full-state to diff-based format to reduce file size.
+ * Instead of storing complete frame data for each frame, only stores changes from the previous frame.
+ *
+ * Format (compact array):
+ * [
+ *   { ...complete first frame data... },           // Index 0: Base frame (full data)
+ *   { rotationValues: { head: 0.5 }, ... },        // Index 1: Only changed values
+ *   { selfRotationValues: { leftArm: 0.2 } },      // Index 2: Only changed values
+ *   ...
+ * ]
+ *
+ * Also supports legacy verbose format:
+ * {
+ *   version: "1.0",
+ *   baseFrame: { ...complete first frame data... },
+ *   diffs: [null, {...}, {...}, ...]
+ * }
+ */
+import type { RigData } from '../types.js';
+/**
+ * Frame data type - can be complete RigData or partial diff
+ */
+export type FrameData = Partial<RigData>;
+/**
+ * Diff-based animation format (compact array)
+ */
+export type DiffBasedAnimation = FrameData[];
+/**
+ * Legacy verbose format
+ */
+export interface VerboseDiffAnimation {
+    version: string;
+    baseFrame: FrameData;
+    diffs: (FrameData | null)[];
+}
+/**
+ * Animation data that can be in either format
+ */
+export type AnimationData = DiffBasedAnimation | VerboseDiffAnimation;
+/**
+ * Compression statistics
+ */
+export interface CompressionStats {
+    originalSize: number;
+    compressedSize: number;
+    savedBytes: number;
+    compressionRatio: string;
+}
+/**
+ * Convert full-state animation frames to diff-based format
+ * @param frames - Array of complete frame objects
+ * @returns Diff-based animation array [baseFrame, diff1, diff2, ...]
+ */
+export declare const createDiffBasedAnimation: (frames: FrameData[]) => DiffBasedAnimation;
+/**
+ * Convert diff-based animation back to full-state frames
+ * Supports both formats:
+ * - New format: [baseFrame, diff1, diff2, ...]
+ * - Old format: { baseFrame, diffs: [...] }
+ * @param diffBasedAnimation - Diff-based animation
+ * @returns Array of complete frame objects
+ */
+export declare const expandDiffBasedAnimation: (diffBasedAnimation: AnimationData) => FrameData[];
+/**
+ * Calculate compression ratio
+ * @param originalFrames - Original full-state frames
+ * @param diffBasedAnimation - Diff-based animation
+ * @returns Statistics about compression
+ */
+export declare const calculateCompressionStats: (originalFrames: FrameData[], diffBasedAnimation: DiffBasedAnimation) => CompressionStats;
+/**
+ * Validate that a diff-based animation can be properly expanded
+ * Supports both new array format and old object format
+ * @param diffBasedAnimation - Diff-based animation to validate
+ * @returns True if valid
+ */
+export declare const validateDiffBasedAnimation: (diffBasedAnimation: AnimationData) => boolean;
+/**
+ * Helper to check if animation data is in diff format
+ * Detects both new array format and old object format
+ * @param animationData - Animation data to check
+ * @returns True if in diff format
+ */
+export declare const isDiffBasedFormat: (animationData: any) => animationData is AnimationData;
+/**
+ * Smart loader that handles both formats
+ * @param animationData - Animation data in either format
+ * @returns Full-state frames array
+ */
+export declare const loadAnimation: (animationData: any) => FrameData[];
+/**
+ * Export animation in diff format with optional compression stats
+ * @param frames - Full-state frames
+ * @param showStats - Whether to log compression stats
+ * @returns Diff-based animation
+ */
+export declare const exportDiffAnimation: (frames: FrameData[], showStats?: boolean) => DiffBasedAnimation;
+//# sourceMappingURL=animationDiff.d.ts.map

package/dist/modules/animationDiff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animationDiff.d.ts","sourceRoot":"","sources":["../../modules/animationDiff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAEzC;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,SAAS,EAAE,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,SAAS,CAAC;IACrB,KAAK,EAAE,CAAC,SAAS,GAAG,IAAI,CAAC,EAAE,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,kBAAkB,GAAG,oBAAoB,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;CAC5B;AA6FD;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GAAI,QAAQ,SAAS,EAAE,KAAG,kBAiB9D,CAAC;AA+BF;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,GAAI,oBAAoB,aAAa,KAAG,SAAS,EAyCrF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,GAClC,gBAAgB,SAAS,EAAE,EAC3B,oBAAoB,kBAAkB,KACvC,gBAWF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,GAAI,oBAAoB,aAAa,KAAG,OAmB9E,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,eAAe,GAAG,KAAG,aAAa,IAAI,aAgDvE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,eAAe,GAAG,KAAG,SAAS,EAiB3D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,QAAQ,SAAS,EAAE,EAAE,YAAW,OAAc,KAAG,kBASpF,CAAC"}

package/dist/modules/animationDiff.js

@@ -0,0 +1,327 @@
+/**
+ * Animation Diff Utility
+ *
+ * Converts animation frames from full-state to diff-based format to reduce file size.
+ * Instead of storing complete frame data for each frame, only stores changes from the previous frame.
+ *
+ * Format (compact array):
+ * [
+ *   { ...complete first frame data... },           // Index 0: Base frame (full data)
+ *   { rotationValues: { head: 0.5 }, ... },        // Index 1: Only changed values
+ *   { selfRotationValues: { leftArm: 0.2 } },      // Index 2: Only changed values
+ *   ...
+ * ]
+ *
+ * Also supports legacy verbose format:
+ * {
+ *   version: "1.0",
+ *   baseFrame: { ...complete first frame data... },
+ *   diffs: [null, {...}, {...}, ...]
+ * }
+ */
+/**
+ * Deep comparison to check if two values are equal
+ */
+const isEqual = (a, b) => {
+    if (a === b)
+        return true;
+    if (a == null || b == null)
+        return false;
+    if (typeof a !== typeof b)
+        return false;
+    if (typeof a === 'object') {
+        const keysA = Object.keys(a);
+        const keysB = Object.keys(b);
+        if (keysA.length !== keysB.length)
+            return false;
+        return keysA.every(key => isEqual(a[key], b[key]));
+    }
+    return false;
+};
+/**
+ * Create a diff object containing only changed properties
+ * @param prevFrame - Previous frame data
+ * @param currentFrame - Current frame data
+ * @returns Diff object or null if no changes
+ */
+const createFrameDiff = (prevFrame, currentFrame) => {
+    if (!prevFrame || !currentFrame)
+        return currentFrame;
+    const diff = {};
+    let hasChanges = false;
+    // Properties that might change between frames
+    const diffableProps = [
+        'rotationValues',
+        'selfRotationValues',
+        'dimensionValues',
+        'pivotPoints',
+        'jointOffset',
+        'zIndexValues',
+        'eyes',
+        'mouth',
+        'visibility',
+        'imageScale',
+        'flipX',
+        'flipHead'
+    ];
+    diffableProps.forEach(prop => {
+        if (!currentFrame.hasOwnProperty(prop))
+            return;
+        const prevValue = prevFrame[prop];
+        const currentValue = currentFrame[prop];
+        // If the property doesn't exist in previous frame, include it entirely
+        if (!prevFrame.hasOwnProperty(prop)) {
+            diff[prop] = currentValue;
+            hasChanges = true;
+            return;
+        }
+        // For objects, diff at the property level
+        if (typeof currentValue === 'object' && !Array.isArray(currentValue) && currentValue !== null) {
+            const propDiff = {};
+            let hasPropChanges = false;
+            Object.keys(currentValue).forEach(key => {
+                const prevVal = prevValue?.[key];
+                const currVal = currentValue[key];
+                if (!isEqual(prevVal, currVal)) {
+                    propDiff[key] = currVal;
+                    hasPropChanges = true;
+                }
+            });
+            if (hasPropChanges) {
+                diff[prop] = propDiff;
+                hasChanges = true;
+            }
+        }
+        else {
+            // For non-objects, include if different
+            if (!isEqual(prevValue, currentValue)) {
+                diff[prop] = currentValue;
+                hasChanges = true;
+            }
+        }
+    });
+    return hasChanges ? diff : null;
+};
+/**
+ * Convert full-state animation frames to diff-based format
+ * @param frames - Array of complete frame objects
+ * @returns Diff-based animation array [baseFrame, diff1, diff2, ...]
+ */
+export const createDiffBasedAnimation = (frames) => {
+    if (!frames || frames.length === 0) {
+        return [];
+    }
+    // First element is the complete base frame
+    const result = [{ ...frames[0] }];
+    // Subsequent elements are diffs from the previous frame
+    for (let i = 1; i < frames.length; i++) {
+        const prevFrame = frames[i - 1];
+        const currentFrame = frames[i];
+        const diff = createFrameDiff(prevFrame, currentFrame);
+        result.push(diff || {}); // Use empty object if no changes
+    }
+    return result;
+};
+/**
+ * Apply a diff to a frame to get the next frame state
+ * @param baseFrame - Base frame to apply diff to
+ * @param diff - Diff object
+ * @returns Resulting frame
+ */
+const applyDiff = (baseFrame, diff) => {
+    if (!diff)
+        return { ...baseFrame };
+    const result = { ...baseFrame };
+    Object.keys(diff).forEach(prop => {
+        const diffValue = diff[prop];
+        // If the diff value is an object, merge it with the base
+        if (typeof diffValue === 'object' && !Array.isArray(diffValue) && diffValue !== null) {
+            result[prop] = {
+                ...result[prop],
+                ...diffValue
+            };
+        }
+        else {
+            // Otherwise, replace entirely
+            result[prop] = diffValue;
+        }
+    });
+    return result;
+};
+/**
+ * Convert diff-based animation back to full-state frames
+ * Supports both formats:
+ * - New format: [baseFrame, diff1, diff2, ...]
+ * - Old format: { baseFrame, diffs: [...] }
+ * @param diffBasedAnimation - Diff-based animation
+ * @returns Array of complete frame objects
+ */
+export const expandDiffBasedAnimation = (diffBasedAnimation) => {
+    if (!diffBasedAnimation) {
+        return [];
+    }
+    // Handle new compact array format: [baseFrame, diff1, diff2, ...]
+    if (Array.isArray(diffBasedAnimation)) {
+        if (diffBasedAnimation.length === 0)
+            return [];
+        const frames = [];
+        let currentFrame = { ...diffBasedAnimation[0] }; // First element is base frame
+        frames.push(currentFrame);
+        // Apply each subsequent diff
+        for (let i = 1; i < diffBasedAnimation.length; i++) {
+            currentFrame = applyDiff(currentFrame, diffBasedAnimation[i]);
+            frames.push({ ...currentFrame });
+        }
+        return frames;
+    }
+    // Handle old verbose format: { baseFrame, diffs: [...] }
+    const verboseFormat = diffBasedAnimation;
+    if (verboseFormat.baseFrame && verboseFormat.diffs) {
+        const { baseFrame, diffs } = verboseFormat;
+        const frames = [];
+        let currentFrame = { ...baseFrame };
+        frames.push(currentFrame);
+        // Apply each diff to reconstruct frames
+        for (let i = 1; i < diffs.length; i++) {
+            currentFrame = applyDiff(currentFrame, diffs[i]);
+            frames.push({ ...currentFrame });
+        }
+        return frames;
+    }
+    return [];
+};
+/**
+ * Calculate compression ratio
+ * @param originalFrames - Original full-state frames
+ * @param diffBasedAnimation - Diff-based animation
+ * @returns Statistics about compression
+ */
+export const calculateCompressionStats = (originalFrames, diffBasedAnimation) => {
+    const originalSize = JSON.stringify(originalFrames).length;
+    const compressedSize = JSON.stringify(diffBasedAnimation).length;
+    const ratio = ((1 - compressedSize / originalSize) * 100).toFixed(2);
+    return {
+        originalSize,
+        compressedSize,
+        savedBytes: originalSize - compressedSize,
+        compressionRatio: ratio + '%'
+    };
+};
+/**
+ * Validate that a diff-based animation can be properly expanded
+ * Supports both new array format and old object format
+ * @param diffBasedAnimation - Diff-based animation to validate
+ * @returns True if valid
+ */
+export const validateDiffBasedAnimation = (diffBasedAnimation) => {
+    if (!diffBasedAnimation)
+        return false;
+    // New compact array format: [baseFrame, diff1, diff2, ...]
+    if (Array.isArray(diffBasedAnimation)) {
+        if (diffBasedAnimation.length === 0)
+            return false;
+        // First element should be a complete frame (has rotationValues or other base properties)
+        if (!diffBasedAnimation[0] || typeof diffBasedAnimation[0] !== 'object')
+            return false;
+        return true;
+    }
+    // Old verbose format: { version, baseFrame, diffs }
+    const verboseFormat = diffBasedAnimation;
+    if (!verboseFormat.version)
+        return false;
+    if (!verboseFormat.baseFrame)
+        return false;
+    if (!Array.isArray(verboseFormat.diffs))
+        return false;
+    if (verboseFormat.diffs.length === 0)
+        return false;
+    return true;
+};
+/**
+ * Helper to check if animation data is in diff format
+ * Detects both new array format and old object format
+ * @param animationData - Animation data to check
+ * @returns True if in diff format
+ */
+export const isDiffBasedFormat = (animationData) => {
+    if (!animationData)
+        return false;
+    // New compact array format: [baseFrame, diff1, diff2, ...]
+    // Heuristic: If it's an array where first element has full frame data
+    // and second element (if exists) has partial data, it's likely diff format
+    if (Array.isArray(animationData)) {
+        if (animationData.length === 0)
+            return false;
+        const firstFrame = animationData[0];
+        if (!firstFrame || typeof firstFrame !== 'object')
+            return false;
+        // If first frame has rotationValues or other key properties, check if it's diff format
+        const hasKeyProperties = firstFrame.rotationValues ||
+            firstFrame.dimensionValues ||
+            firstFrame.imagePaths ||
+            firstFrame.rotation !== undefined ||
+            firstFrame.width !== undefined;
+        if (hasKeyProperties) {
+            // If there's a second element
+            if (animationData.length > 1) {
+                const secondFrame = animationData[1];
+                // If second frame has fewer top-level keys than first, likely a diff
+                const firstKeys = Object.keys(firstFrame).length;
+                const secondKeys = Object.keys(secondFrame).length;
+                // Diff format has fewer keys in subsequent frames (only changed properties)
+                if (secondKeys < firstKeys)
+                    return true;
+                // Also check if second frame is missing metadata that first frame has
+                if (firstFrame.imagePaths && !secondFrame.imagePaths)
+                    return true;
+                if (firstFrame.imageScale !== undefined && !secondFrame.hasOwnProperty('imageScale'))
+                    return true;
+                if (firstFrame.dimensionValues && !secondFrame.dimensionValues)
+                    return true;
+            }
+            // Single frame could be either format, default to full-state
+            return false;
+        }
+    }
+    // Old verbose format: { version, baseFrame, diffs }
+    return (animationData &&
+        typeof animationData === 'object' &&
+        'baseFrame' in animationData &&
+        'diffs' in animationData);
+};
+/**
+ * Smart loader that handles both formats
+ * @param animationData - Animation data in either format
+ * @returns Full-state frames array
+ */
+export const loadAnimation = (animationData) => {
+    if (!animationData)
+        return [];
+    // Check if it's diff-based format first
+    if (isDiffBasedFormat(animationData)) {
+        console.log('📊 Detected diff-based animation format, expanding...');
+        return expandDiffBasedAnimation(animationData);
+    }
+    // If it's already an array and not diff-based, assume it's full-state format
+    if (Array.isArray(animationData)) {
+        return animationData;
+    }
+    // Unknown format
+    console.warn('Unknown animation format');
+    return [];
+};
+/**
+ * Export animation in diff format with optional compression stats
+ * @param frames - Full-state frames
+ * @param showStats - Whether to log compression stats
+ * @returns Diff-based animation
+ */
+export const exportDiffAnimation = (frames, showStats = true) => {
+    const diffAnimation = createDiffBasedAnimation(frames);
+    if (showStats && frames.length > 0) {
+        const stats = calculateCompressionStats(frames, diffAnimation);
+        console.log('Animation Compression Stats:', stats);
+    }
+    return diffAnimation;
+};
+//# sourceMappingURL=animationDiff.js.map