shellfie-cli 2.0.1 → 2.0.2

package/dist/frame-animator.d.ts

@@ -0,0 +1,21 @@
+import type { Frame } from './frame-capture';
+import { type shellfieOptions } from 'shellfie';
+export interface FrameAnimationOptions {
+    fps: number;
+    loop: boolean;
+    maxDuration: number;
+    maxSizeKB: number;
+    shellfieOptions: shellfieOptions;
+}
+/**
+ * Generates an animated SVG from multiple frames.
+ * Uses SMIL visibility toggling for efficient frame switching.
+ * Aggressively deduplicates content at multiple levels:
+ * 1. Consecutive identical frames are merged
+ * 2. Individual text lines are stored once and referenced via <use>
+ * 3. Glyph patterns are shared across frames
+ *
+ * Enforces size and duration limits by progressively reducing frames.
+ */
+export declare function generateFrameAnimatedSvg(frames: Frame[], options: FrameAnimationOptions): Promise<string>;
+//# sourceMappingURL=frame-animator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frame-animator.d.ts","sourceRoot":"","sources":["../src/frame-animator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC;AAE/D,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,eAAe,CAAC;CAClC;AAED;;;;;;;;;GASG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,KAAK,EAAE,EACf,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,MAAM,CAAC,CA8BjB"}

package/dist/frame-animator.js

@@ -0,0 +1,254 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateFrameAnimatedSvg = generateFrameAnimatedSvg;
+const shellfie_1 = require("shellfie");
+/**
+ * Generates an animated SVG from multiple frames.
+ * Uses SMIL visibility toggling for efficient frame switching.
+ * Aggressively deduplicates content at multiple levels:
+ * 1. Consecutive identical frames are merged
+ * 2. Individual text lines are stored once and referenced via <use>
+ * 3. Glyph patterns are shared across frames
+ *
+ * Enforces size and duration limits by progressively reducing frames.
+ */
+async function generateFrameAnimatedSvg(frames, options) {
+    if (frames.length === 0) {
+        throw new Error('No frames to animate');
+    }
+    if (frames.length === 1) {
+        return (0, shellfie_1.shellfieAsync)(frames[0].content, options.shellfieOptions);
+    }
+    // Apply duration limit first - cap frames based on max duration
+    const maxFramesByDuration = Math.floor(options.maxDuration * options.fps);
+    let cappedFrames = frames.slice(0, maxFramesByDuration);
+    // Try generating with current frame count, reduce if size exceeds limit
+    let result = await generateWithFrames(cappedFrames, options);
+    // If size exceeds limit, progressively reduce frames
+    const maxSizeBytes = options.maxSizeKB * 1024;
+    let attempts = 0;
+    const maxAttempts = 5;
+    while (result.length > maxSizeBytes && cappedFrames.length > 2 && attempts < maxAttempts) {
+        // Reduce frame count by sampling (keep every Nth frame)
+        const reductionFactor = Math.ceil(cappedFrames.length / Math.max(2, cappedFrames.length * 0.6));
+        cappedFrames = sampleFrames(cappedFrames, reductionFactor);
+        result = await generateWithFrames(cappedFrames, options);
+        attempts++;
+    }
+    return result;
+}
+/**
+ * Samples frames by keeping every Nth frame, always keeping first and last.
+ */
+function sampleFrames(frames, step) {
+    if (frames.length <= 2 || step <= 1)
+        return frames;
+    const sampled = [frames[0]];
+    for (let i = step; i < frames.length - 1; i += step) {
+        sampled.push(frames[i]);
+    }
+    sampled.push(frames[frames.length - 1]);
+    // Re-index the frames
+    return sampled.map((frame, index) => ({
+        ...frame,
+        index,
+        timestamp: index * (1000 / 10), // Approximate timing
+    }));
+}
+/**
+ * Internal function to generate animated SVG from frames.
+ */
+async function generateWithFrames(frames, options) {
+    // Deduplicate identical consecutive frames
+    const deduplicatedFrames = deduplicateConsecutiveFrames(frames);
+    // Generate SVG only for unique frames
+    const uniqueFrameSvgs = await Promise.all(deduplicatedFrames.uniqueFrames.map(frame => (0, shellfie_1.shellfieAsync)(frame.content, options.shellfieOptions)));
+    // Extract and deduplicate content at line level
+    const { lineLibrary, glyphLibrary, frameLineRefs, frameGlyphRefs } = buildContentLibrary(uniqueFrameSvgs);
+    // Build animated SVG with shared content library
+    const baseSvg = uniqueFrameSvgs[0];
+    return injectFrameAnimationsWithLibrary(baseSvg, lineLibrary, glyphLibrary, frameLineRefs, frameGlyphRefs, deduplicatedFrames.frameDurations, options.fps, options.loop);
+}
+/**
+ * Builds a shared library of unique lines and glyphs across all frames.
+ * Returns references for each frame to reconstruct content.
+ */
+function buildContentLibrary(frameSvgs) {
+    const lineLibrary = new Map();
+    const glyphLibrary = new Map();
+    const frameLineRefs = [];
+    const frameGlyphRefs = [];
+    let lineCounter = 0;
+    let glyphCounter = 0;
+    for (const svg of frameSvgs) {
+        const textContent = extractTextContent(svg);
+        const glyphContent = extractGlyphsContent(svg);
+        // Parse individual text elements (lines)
+        const lineRefs = [];
+        const textElements = textContent.match(/<text[^>]*>[\s\S]*?<\/text>/g) || [];
+        for (const textEl of textElements) {
+            if (!lineLibrary.has(textEl)) {
+                const lineId = `L${lineCounter++}`;
+                lineLibrary.set(textEl, lineId);
+            }
+            lineRefs.push(lineLibrary.get(textEl));
+        }
+        frameLineRefs.push(lineRefs);
+        // Parse individual glyph elements
+        const glyphRefs = [];
+        // Match rect, path, or other glyph elements
+        const glyphElements = glyphContent.match(/<(?:rect|path|line|polygon)[^>]*\/?>/g) || [];
+        for (const glyphEl of glyphElements) {
+            if (!glyphLibrary.has(glyphEl)) {
+                const glyphId = `G${glyphCounter++}`;
+                glyphLibrary.set(glyphEl, glyphId);
+            }
+            glyphRefs.push(glyphLibrary.get(glyphEl));
+        }
+        frameGlyphRefs.push(glyphRefs);
+    }
+    return { lineLibrary, glyphLibrary, frameLineRefs, frameGlyphRefs };
+}
+/**
+ * Deduplicates identical consecutive frames.
+ * Returns unique frames and their durations.
+ */
+function deduplicateConsecutiveFrames(frames) {
+    if (frames.length === 0) {
+        return { uniqueFrames: [], frameDurations: [] };
+    }
+    const uniqueFrames = [frames[0]];
+    const frameDurations = [1];
+    for (let i = 1; i < frames.length; i++) {
+        const current = frames[i];
+        const lastUnique = uniqueFrames[uniqueFrames.length - 1];
+        if (current.content === lastUnique.content) {
+            // Same content - extend duration of last unique frame
+            frameDurations[frameDurations.length - 1]++;
+        }
+        else {
+            // Different content - add new unique frame
+            uniqueFrames.push(current);
+            frameDurations.push(1);
+        }
+    }
+    return { uniqueFrames, frameDurations };
+}
+/**
+ * Extracts the text content group from an SVG.
+ * Sanitizes any remaining control characters that are invalid in XML.
+ */
+function extractTextContent(svg) {
+    // Extract everything inside <g class="text">...</g>
+    const match = svg.match(/<g class="text">([\s\S]*?)<\/g>/);
+    if (!match)
+        return '';
+    // Remove any control characters (ASCII 0-31 except tab, newline, carriage return)
+    // These are invalid in XML and can cause parsing errors
+    const content = match[1];
+    const sanitized = content.replace(/[\x00-\x08\x0B\x0C\x0E-\x1F]/g, '');
+    return sanitized;
+}
+/**
+ * Extracts the glyphs content group from an SVG.
+ */
+function extractGlyphsContent(svg) {
+    // Extract everything inside <g class="glyphs">...</g>
+    const match = svg.match(/<g class="glyphs">([\s\S]*?)<\/g>/);
+    return match ? match[1] : '';
+}
+/**
+ * Injects frame animation using a shared content library.
+ * Content is defined once in <defs> and referenced via <use>.
+ * This dramatically reduces file size for animations with repeated content.
+ */
+function injectFrameAnimationsWithLibrary(baseSvg, lineLibrary, glyphLibrary, frameLineRefs, frameGlyphRefs, frameDurations, fps, loop) {
+    const baseFrameDuration = 1 / fps;
+    const totalFrameUnits = frameDurations.reduce((sum, d) => sum + d, 0);
+    const totalDuration = totalFrameUnits * baseFrameDuration;
+    // Build the content library in <defs>
+    let defsContent = '\n  <!-- Shared content library -->\n';
+    // Add all unique lines to defs
+    for (const [content, id] of lineLibrary) {
+        // Wrap in a group with id for referencing
+        defsContent += `  <g id="${id}">${content}</g>\n`;
+    }
+    // Add all unique glyphs to defs
+    for (const [content, id] of glyphLibrary) {
+        defsContent += `  <g id="${id}">${content}</g>\n`;
+    }
+    // Calculate start times for each frame
+    const startTimes = [];
+    let currentTime = 0;
+    for (const duration of frameDurations) {
+        startTimes.push(currentTime);
+        currentTime += duration * baseFrameDuration;
+    }
+    // Build frame groups that reference the shared content via <use>
+    // Use simpler SMIL: animate visibility with keyTimes for precise control
+    const frameGroups = frameLineRefs.map((lineRefs, index) => {
+        const glyphRefs = frameGlyphRefs[index] || [];
+        const startTime = startTimes[index];
+        const duration = frameDurations[index] * baseFrameDuration;
+        const isFirstFrame = index === 0;
+        const isLastFrame = index === frameLineRefs.length - 1;
+        // Build <use> references for glyphs and lines
+        const glyphUses = glyphRefs.map(id => `<use href="#${id}"/>`).join('');
+        const lineUses = lineRefs.map(id => `<use href="#${id}"/>`).join('');
+        // Simple SMIL: show at startTime, hide at startTime + duration
+        // First frame starts visible, others start hidden
+        const initialVisibility = isFirstFrame ? 'visible' : 'hidden';
+        let smilTags = '';
+        if (loop) {
+            // For looping: use animate with values and keyTimes
+            const showStart = startTime / totalDuration;
+            const showEnd = (startTime + duration) / totalDuration;
+            smilTags = `
+    <animate attributeName="visibility" values="hidden;visible;hidden" keyTimes="0;${showStart.toFixed(4)};${showEnd.toFixed(4)}" dur="${totalDuration.toFixed(3)}s" repeatCount="indefinite" calcMode="discrete"/>`;
+        }
+        else if (isLastFrame) {
+            // Last frame: show and keep visible
+            if (isFirstFrame) {
+                // Single frame - just stay visible
+                smilTags = '';
+            }
+            else {
+                smilTags = `
+    <set attributeName="visibility" to="visible" begin="${startTime.toFixed(3)}s" fill="freeze"/>`;
+            }
+        }
+        else if (isFirstFrame) {
+            // First frame: start visible, hide when next frame starts
+            smilTags = `
+    <set attributeName="visibility" to="hidden" begin="${(startTime + duration).toFixed(3)}s" fill="freeze"/>`;
+        }
+        else {
+            // Middle frames: show at start, hide at end
+            smilTags = `
+    <set attributeName="visibility" to="visible" begin="${startTime.toFixed(3)}s" fill="freeze"/>
+    <set attributeName="visibility" to="hidden" begin="${(startTime + duration).toFixed(3)}s" fill="freeze"/>`;
+        }
+        return `
+  <g class="frame" id="frame-${index}" visibility="${initialVisibility}">
+    ${glyphUses}${lineUses}${smilTags}
+  </g>`;
+    }).join('');
+    // Insert defs content and replace frame groups
+    let animatedSvg = baseSvg;
+    // Add library to defs
+    const defsMatch = animatedSvg.match(/<defs>/);
+    if (defsMatch) {
+        animatedSvg = animatedSvg.replace(/<defs>/, `<defs>${defsContent}`);
+    }
+    else {
+        // Create defs section
+        animatedSvg = animatedSvg.replace(/<svg([^>]*)>/, `<svg$1>\n<defs>${defsContent}</defs>`);
+    }
+    // Remove glyphs group (content is now in defs)
+    animatedSvg = animatedSvg.replace(/<g class="glyphs">[\s\S]*?<\/g>\s*/g, '');
+    // Replace the text content with frame groups
+    animatedSvg = animatedSvg.replace(/<g class="text">[\s\S]*?<\/g>/, `<g class="animation">${frameGroups}
+  </g>`);
+    return animatedSvg;
+}
+//# sourceMappingURL=frame-animator.js.map

package/dist/frame-animator.js.map

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

package/dist/frame-capture.d.ts

@@ -0,0 +1,16 @@
+export interface CaptureOptions {
+    mode: 'clear' | 'time';
+    fps: number;
+    maxFrames: number;
+}
+export interface Frame {
+    content: string;
+    timestamp: number;
+    index: number;
+}
+/**
+ * Captures frames from terminal animation input.
+ * Supports two modes: clear-screen detection and time-based buffering.
+ */
+export declare function captureFrames(input: string, options: CaptureOptions): Frame[];
+//# sourceMappingURL=frame-capture.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frame-capture.d.ts","sourceRoot":"","sources":["../src/frame-capture.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,KAAK;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,cAAc,GACtB,KAAK,EAAE,CAMT"}

package/dist/frame-capture.js

@@ -0,0 +1,162 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.captureFrames = captureFrames;
+/**
+ * Captures frames from terminal animation input.
+ * Supports two modes: clear-screen detection and time-based buffering.
+ */
+function captureFrames(input, options) {
+    if (options.mode === 'clear') {
+        return captureByClearScreen(input, options);
+    }
+    else {
+        return captureByTime(input, options);
+    }
+}
+/**
+ * Strips common cursor control sequences that shouldn't be rendered.
+ */
+function stripCursorControls(text) {
+    return text
+        .replace(/\x1B\[\?25l/g, '') // Hide cursor
+        .replace(/\x1B\[\?25h/g, '') // Show cursor
+        .replace(/\x1B\[H/g, '') // Move cursor to home
+        .replace(/\x1B\[\d+;\d+H/g, '') // Move cursor to position
+        .replace(/\x1B\[K/g, '') // Clear line from cursor
+        .replace(/\x1B\[J/g, ''); // Clear screen from cursor
+}
+/**
+ * Checks if content has any visible text (not just whitespace/control chars).
+ */
+function hasVisibleContent(text) {
+    const stripped = stripCursorControls(text).trim();
+    return stripped.length > 0;
+}
+/**
+ * Captures frames by detecting clear screen commands.
+ * Each clear command marks the boundary between frames.
+ */
+function captureByClearScreen(input, options) {
+    const CLEAR_PATTERNS = [
+        '\x1Bc', // Full reset (used by chartscii)
+        '\x1B[2J', // Clear entire screen (ESC[2J)
+        '\x1B[H\x1B[2J', // Move to home + clear
+        '\x1Bc', // Alternative reset
+    ];
+    const frames = [];
+    let remainingInput = input;
+    // Try to split by each clear pattern
+    for (const pattern of CLEAR_PATTERNS) {
+        if (remainingInput.includes(pattern)) {
+            const parts = remainingInput.split(pattern);
+            // First part is before any clear (skip it)
+            // Subsequent parts are frames
+            for (let i = 1; i < parts.length && frames.length < options.maxFrames; i++) {
+                const stripped = stripCursorControls(parts[i]);
+                const content = stripped.trim();
+                // Only include frames with actual visible content
+                if (content && hasVisibleContent(content)) {
+                    frames.push({
+                        content,
+                        timestamp: frames.length * (1000 / options.fps),
+                        index: frames.length,
+                    });
+                }
+            }
+            // If we found frames with this pattern, stop trying other patterns
+            if (frames.length > 0) {
+                break;
+            }
+        }
+    }
+    // If no frames were captured (no clear commands found), treat entire input as single frame
+    if (frames.length === 0) {
+        const stripped = stripCursorControls(input);
+        const content = stripped.trim();
+        if (content && hasVisibleContent(content)) {
+            frames.push({
+                content,
+                timestamp: 0,
+                index: 0,
+            });
+        }
+    }
+    return frames;
+}
+/**
+ * Captures frames based on time intervals.
+ * Simulates terminal state at regular intervals by replaying the input stream.
+ *
+ * This works by:
+ * 1. Parsing the input for timing information (escape sequences, delays, etc.)
+ * 2. Building a virtual terminal buffer
+ * 3. Snapshotting the buffer at regular intervals (based on fps)
+ *
+ * For inputs without timing info, it distributes content evenly across frames.
+ */
+function captureByTime(input, options) {
+    const intervalMs = 1000 / options.fps; // e.g., 100ms for 10fps
+    // Try to detect if input has timing markers or clear sequences
+    const clearPattern = /\x1Bc|\x1B\[2J|\x1B\[H\x1B\[2J/g;
+    const hasClearSequences = clearPattern.test(input);
+    if (hasClearSequences) {
+        // If we have clear sequences, use them as frame boundaries with timestamps
+        return captureByTimeWithClearMarkers(input, options, intervalMs);
+    }
+    // No clear sequences - this is static content (like lolcat output)
+    // Return as a single frame instead of progressive reveal
+    const stripped = stripCursorControls(input);
+    const content = stripped.trim();
+    if (content && hasVisibleContent(content)) {
+        return [{
+                content,
+                timestamp: 0,
+                index: 0,
+            }];
+    }
+    return [];
+}
+/**
+ * Captures frames using clear sequences as boundaries, but assigns proper timestamps.
+ */
+function captureByTimeWithClearMarkers(input, options, intervalMs) {
+    const CLEAR_PATTERNS = [
+        '\x1Bc', // Full reset
+        '\x1B[2J', // Clear entire screen
+        '\x1B\[H\x1B\[2J', // Move to home + clear
+    ];
+    const frames = [];
+    let remainingInput = input;
+    for (const pattern of CLEAR_PATTERNS) {
+        if (remainingInput.includes(pattern)) {
+            const parts = remainingInput.split(pattern);
+            for (let i = 1; i < parts.length && frames.length < options.maxFrames; i++) {
+                const stripped = stripCursorControls(parts[i]);
+                const content = stripped.trim();
+                if (content && hasVisibleContent(content)) {
+                    frames.push({
+                        content,
+                        timestamp: frames.length * intervalMs,
+                        index: frames.length,
+                    });
+                }
+            }
+            if (frames.length > 0)
+                break;
+        }
+    }
+    // Fallback: treat entire input as single frame
+    if (frames.length === 0) {
+        const stripped = stripCursorControls(input);
+        const content = stripped.trim();
+        if (content && hasVisibleContent(content)) {
+            frames.push({
+                content,
+                timestamp: 0,
+                index: 0,
+            });
+        }
+    }
+    return frames;
+}
+//# sourceMappingURL=frame-capture.js.map

package/dist/frame-capture.js.map

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

package/dist/svg-animator-v2.d.ts

@@ -0,0 +1,23 @@
+/**
+ * SVG Animator V2
+ * Combines pre-rendered terminal SVGs into animated SVG
+ */
+import type { TerminalFrame } from './dvd-executor-v2';
+export interface AnimationOptions {
+    fps?: number;
+    loop?: boolean;
+    pauseAtEnd?: number;
+}
+/**
+ * Create animated SVG from frames
+ */
+export declare function createAnimatedSVG(frames: TerminalFrame[], options?: AnimationOptions): Promise<string>;
+/**
+ * Get animation metadata
+ */
+export declare function getAnimationMetadata(frames: TerminalFrame[]): {
+    duration: number;
+    frameCount: number;
+    fps: number;
+};
+//# sourceMappingURL=svg-animator-v2.d.ts.map

package/dist/svg-animator-v2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg-animator-v2.d.ts","sourceRoot":"","sources":["../src/svg-animator-v2.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAyED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,aAAa,EAAE,EACvB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,MAAM,CAAC,CAqDjB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;CACb,CAUA"}

package/dist/svg-animator-v2.js

@@ -0,0 +1,134 @@
+"use strict";
+/**
+ * SVG Animator V2
+ * Combines pre-rendered terminal SVGs into animated SVG
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAnimatedSVG = createAnimatedSVG;
+exports.getAnimationMetadata = getAnimationMetadata;
+/**
+ * Extract SVG body content (everything inside <svg>)
+ */
+function extractSVGBody(svg, frameId) {
+    const contentMatch = svg.match(/<svg[^>]*>([\s\S]*)<\/svg>/);
+    if (!contentMatch)
+        return '';
+    let content = contentMatch[1];
+    // Make IDs unique
+    content = content
+        .replace(/id="([^"]*)"/g, `id="$1-${frameId}"`)
+        .replace(/url\(#([^)]*)\)/g, `url(#$1-${frameId})`)
+        .replace(/class="([^"]*)"/g, `class="$1 ${frameId}"`);
+    return content;
+}
+/**
+ * Get SVG dimensions from first frame
+ */
+function getSVGDimensions(svg) {
+    const widthMatch = svg.match(/width="(\d+)"/);
+    const heightMatch = svg.match(/height="(\d+)"/);
+    return {
+        width: widthMatch ? parseInt(widthMatch[1], 10) : 800,
+        height: heightMatch ? parseInt(heightMatch[1], 10) : 600,
+    };
+}
+/**
+ * Create CSS keyframes for animation
+ */
+function createKeyframes(frames) {
+    if (frames.length === 0)
+        return '';
+    const totalDuration = frames[frames.length - 1].timestamp;
+    let css = '';
+    frames.forEach((frame, i) => {
+        const startPercent = i === 0 ? 0 : (frames[i - 1].timestamp / totalDuration) * 100;
+        const endPercent = (frame.timestamp / totalDuration) * 100;
+        const nextPercent = i < frames.length - 1
+            ? (frames[i + 1].timestamp / totalDuration) * 100
+            : 100;
+        css += `
+    @keyframes frame-${i}-anim {
+      0% { opacity: 0; }
+      ${startPercent.toFixed(2)}% { opacity: 0; }
+      ${endPercent.toFixed(2)}% { opacity: 1; }
+      ${nextPercent.toFixed(2)}% { opacity: 1; }
+      ${(nextPercent + 0.01).toFixed(2)}% { opacity: 0; }
+      100% { opacity: 0; }
+    }`;
+    });
+    // First frame special case
+    const firstEnd = (frames[1]?.timestamp / totalDuration) * 100 || 100;
+    css = `
+    @keyframes frame-0-anim {
+      0% { opacity: 1; }
+      ${firstEnd.toFixed(2)}% { opacity: 1; }
+      ${(firstEnd + 0.01).toFixed(2)}% { opacity: 0; }
+      100% { opacity: 0; }
+    }` + css.substring(css.indexOf('@keyframes frame-1-anim'));
+    return css;
+}
+/**
+ * Create animated SVG from frames
+ */
+async function createAnimatedSVG(frames, options = {}) {
+    if (frames.length === 0) {
+        throw new Error('No frames to animate');
+    }
+    // Get dimensions from first frame
+    const { width, height } = getSVGDimensions(frames[0].svg);
+    // Calculate duration
+    const totalDuration = frames[frames.length - 1].timestamp;
+    const pauseAtEnd = options.pauseAtEnd || 1000;
+    const animationDuration = ((totalDuration + pauseAtEnd) / 1000).toFixed(2);
+    const animationIterationCount = options.loop !== false ? 'infinite' : '1';
+    // Create keyframes
+    const keyframes = createKeyframes(frames);
+    // Extract frame contents
+    const frameBodies = frames.map((frame, i) => ({
+        id: `frame-${i}`,
+        content: extractSVGBody(frame.svg, `f${i}`),
+    }));
+    // Build animated SVG
+    const svg = `<svg width="${width}" height="${height}" xmlns="http://www.w3.org/2000/svg">
+  <style>
+    ${keyframes}
+
+    .frame {
+      animation-duration: ${animationDuration}s;
+      animation-timing-function: step-end;
+      animation-iteration-count: ${animationIterationCount};
+      animation-fill-mode: forwards;
+    }
+
+    ${frames.map((_, i) => `
+    .frame-${i} {
+      animation-name: frame-${i}-anim;
+    }`).join('')}
+  </style>
+
+  <defs>
+    ${frameBodies.map((frame) => `
+    <g id="${frame.id}">
+      ${frame.content}
+    </g>`).join('')}
+  </defs>
+
+  ${frameBodies.map((frame, i) => `
+  <use href="#${frame.id}" class="frame frame-${i}" />`).join('')}
+</svg>`;
+    return svg;
+}
+/**
+ * Get animation metadata
+ */
+function getAnimationMetadata(frames) {
+    const duration = frames.length > 0 ? frames[frames.length - 1].timestamp : 0;
+    const frameCount = frames.length;
+    const fps = frameCount > 1 ? frameCount / (duration / 1000) : 0;
+    return {
+        duration,
+        frameCount,
+        fps: Math.round(fps * 10) / 10,
+    };
+}
+//# sourceMappingURL=svg-animator-v2.js.map

package/dist/svg-animator-v2.js.map

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