@mappoh/nova 0.1.16

package/dist/canvas/noise.js

@@ -0,0 +1,241 @@
+/**
+ * Nova Engine — Noise Generation
+ *
+ * Simplex noise for generative backgrounds, terrain, and organic effects.
+ * Pure TypeScript implementation — no external dependencies.
+ */
+// Simplex noise lookup tables
+const grad3 = [
+    [1, 1, 0], [-1, 1, 0], [1, -1, 0], [-1, -1, 0],
+    [1, 0, 1], [-1, 0, 1], [1, 0, -1], [-1, 0, -1],
+    [0, 1, 1], [0, -1, 1], [0, 1, -1], [0, -1, -1],
+];
+const F2 = 0.5 * (Math.sqrt(3) - 1);
+const G2 = (3 - Math.sqrt(3)) / 6;
+const F3 = 1 / 3;
+const G3 = 1 / 6;
+function buildPermTable(seed) {
+    const perm = new Uint8Array(512);
+    const source = new Uint8Array(256);
+    for (let i = 0; i < 256; i++)
+        source[i] = i;
+    // Seed-based shuffle (xorshift)
+    let s = seed;
+    for (let i = 255; i > 0; i--) {
+        s = (s ^ (s << 13)) >>> 0;
+        s = (s ^ (s >> 17)) >>> 0;
+        s = (s ^ (s << 5)) >>> 0;
+        const j = (s >>> 0) % (i + 1);
+        [source[i], source[j]] = [source[j], source[i]];
+    }
+    for (let i = 0; i < 512; i++)
+        perm[i] = source[i & 255];
+    return perm;
+}
+function dot2(g, x, y) {
+    return g[0] * x + g[1] * y;
+}
+function dot3(g, x, y, z) {
+    return g[0] * x + g[1] * y + g[2] * z;
+}
+/** Create a noise generator instance. */
+export function createNoise(options = {}) {
+    const seed = options.seed ?? (Math.random() * 2147483647) >>> 0;
+    const perm = buildPermTable(seed);
+    const permMod12 = new Uint8Array(512);
+    for (let i = 0; i < 512; i++)
+        permMod12[i] = perm[i] % 12;
+    function noise2D(xin, yin) {
+        const s = (xin + yin) * F2;
+        const i = Math.floor(xin + s);
+        const j = Math.floor(yin + s);
+        const t = (i + j) * G2;
+        const x0 = xin - (i - t);
+        const y0 = yin - (j - t);
+        let i1, j1;
+        if (x0 > y0) {
+            i1 = 1;
+            j1 = 0;
+        }
+        else {
+            i1 = 0;
+            j1 = 1;
+        }
+        const x1 = x0 - i1 + G2;
+        const y1 = y0 - j1 + G2;
+        const x2 = x0 - 1 + 2 * G2;
+        const y2 = y0 - 1 + 2 * G2;
+        const ii = i & 255;
+        const jj = j & 255;
+        let n0 = 0, n1 = 0, n2 = 0;
+        let t0 = 0.5 - x0 * x0 - y0 * y0;
+        if (t0 >= 0) {
+            t0 *= t0;
+            n0 = t0 * t0 * dot2(grad3[permMod12[ii + perm[jj]]], x0, y0);
+        }
+        let t1 = 0.5 - x1 * x1 - y1 * y1;
+        if (t1 >= 0) {
+            t1 *= t1;
+            n1 = t1 * t1 * dot2(grad3[permMod12[ii + i1 + perm[jj + j1]]], x1, y1);
+        }
+        let t2 = 0.5 - x2 * x2 - y2 * y2;
+        if (t2 >= 0) {
+            t2 *= t2;
+            n2 = t2 * t2 * dot2(grad3[permMod12[ii + 1 + perm[jj + 1]]], x2, y2);
+        }
+        return 70 * (n0 + n1 + n2);
+    }
+    function noise3D(xin, yin, zin) {
+        const s = (xin + yin + zin) * F3;
+        const i = Math.floor(xin + s);
+        const j = Math.floor(yin + s);
+        const k = Math.floor(zin + s);
+        const t = (i + j + k) * G3;
+        const x0 = xin - (i - t);
+        const y0 = yin - (j - t);
+        const z0 = zin - (k - t);
+        let i1, j1, k1;
+        let i2, j2, k2;
+        if (x0 >= y0) {
+            if (y0 >= z0) {
+                i1 = 1;
+                j1 = 0;
+                k1 = 0;
+                i2 = 1;
+                j2 = 1;
+                k2 = 0;
+            }
+            else if (x0 >= z0) {
+                i1 = 1;
+                j1 = 0;
+                k1 = 0;
+                i2 = 1;
+                j2 = 0;
+                k2 = 1;
+            }
+            else {
+                i1 = 0;
+                j1 = 0;
+                k1 = 1;
+                i2 = 1;
+                j2 = 0;
+                k2 = 1;
+            }
+        }
+        else {
+            if (y0 < z0) {
+                i1 = 0;
+                j1 = 0;
+                k1 = 1;
+                i2 = 0;
+                j2 = 1;
+                k2 = 1;
+            }
+            else if (x0 < z0) {
+                i1 = 0;
+                j1 = 1;
+                k1 = 0;
+                i2 = 0;
+                j2 = 1;
+                k2 = 1;
+            }
+            else {
+                i1 = 0;
+                j1 = 1;
+                k1 = 0;
+                i2 = 1;
+                j2 = 1;
+                k2 = 0;
+            }
+        }
+        const x1 = x0 - i1 + G3, y1 = y0 - j1 + G3, z1 = z0 - k1 + G3;
+        const x2 = x0 - i2 + 2 * G3, y2 = y0 - j2 + 2 * G3, z2 = z0 - k2 + 2 * G3;
+        const x3 = x0 - 1 + 3 * G3, y3 = y0 - 1 + 3 * G3, z3 = z0 - 1 + 3 * G3;
+        const ii = i & 255, jj = j & 255, kk = k & 255;
+        let n0 = 0, n1 = 0, n2 = 0, n3 = 0;
+        let t0 = 0.6 - x0 * x0 - y0 * y0 - z0 * z0;
+        if (t0 >= 0) {
+            t0 *= t0;
+            n0 = t0 * t0 * dot3(grad3[permMod12[ii + perm[jj + perm[kk]]]], x0, y0, z0);
+        }
+        let t1 = 0.6 - x1 * x1 - y1 * y1 - z1 * z1;
+        if (t1 >= 0) {
+            t1 *= t1;
+            n1 = t1 * t1 * dot3(grad3[permMod12[ii + i1 + perm[jj + j1 + perm[kk + k1]]]], x1, y1, z1);
+        }
+        let t2 = 0.6 - x2 * x2 - y2 * y2 - z2 * z2;
+        if (t2 >= 0) {
+            t2 *= t2;
+            n2 = t2 * t2 * dot3(grad3[permMod12[ii + i2 + perm[jj + j2 + perm[kk + k2]]]], x2, y2, z2);
+        }
+        let t3 = 0.6 - x3 * x3 - y3 * y3 - z3 * z3;
+        if (t3 >= 0) {
+            t3 *= t3;
+            n3 = t3 * t3 * dot3(grad3[permMod12[ii + 1 + perm[jj + 1 + perm[kk + 1]]]], x3, y3, z3);
+        }
+        return 32 * (n0 + n1 + n2 + n3);
+    }
+    function fbm2D(x, y, octaves = 6, lacunarity = 2, gain = 0.5) {
+        let sum = 0, amp = 1, freq = 1, max = 0;
+        for (let i = 0; i < octaves; i++) {
+            sum += noise2D(x * freq, y * freq) * amp;
+            max += amp;
+            amp *= gain;
+            freq *= lacunarity;
+        }
+        return sum / max;
+    }
+    return { noise2D, noise3D, fbm2D };
+}
+/**
+ * Render noise to a canvas as a greyscale or colored image.
+ * Returns a cleanup function (stops animation if animated).
+ */
+export function renderNoise(canvas, options = {}) {
+    const { scale = 0.005, octaves = 4, seed, colorize, animate = false, speed = 0.001, } = options;
+    const el = typeof canvas === 'string'
+        ? document.querySelector(canvas)
+        : canvas;
+    const ctx = el.getContext('2d');
+    const noise = createNoise({ seed });
+    let rafId = 0;
+    let time = 0;
+    function render() {
+        const w = el.width;
+        const h = el.height;
+        const imgData = ctx.createImageData(w, h);
+        const data = imgData.data;
+        for (let y = 0; y < h; y++) {
+            for (let x = 0; x < w; x++) {
+                const v = noise.fbm2D(x * scale + time, y * scale + time, octaves);
+                const normalized = (v + 1) * 0.5; // 0..1
+                const idx = (y * w + x) * 4;
+                if (colorize) {
+                    const [r, g, b, a] = colorize(normalized);
+                    data[idx] = r;
+                    data[idx + 1] = g;
+                    data[idx + 2] = b;
+                    data[idx + 3] = a;
+                }
+                else {
+                    const c = Math.floor(normalized * 255);
+                    data[idx] = c;
+                    data[idx + 1] = c;
+                    data[idx + 2] = c;
+                    data[idx + 3] = 255;
+                }
+            }
+        }
+        ctx.putImageData(imgData, 0, 0);
+        if (animate) {
+            time += speed;
+            rafId = requestAnimationFrame(render);
+        }
+    }
+    render();
+    return () => {
+        if (rafId)
+            cancelAnimationFrame(rafId);
+    };
+}
+//# sourceMappingURL=noise.js.map

package/dist/canvas/noise.js.map

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

package/dist/canvas/particles.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Nova Engine — Particle System
+ *
+ * Configurable canvas-based particle effects with gravity, wind,
+ * emitters, and optional connections between particles.
+ */
+export interface ParticleOptions {
+    /** Number of particles. Default: 80 */
+    count?: number;
+    /** Min particle radius. Default: 1 */
+    minRadius?: number;
+    /** Max particle radius. Default: 3 */
+    maxRadius?: number;
+    /** Particle color. Default: 'rgba(255,255,255,0.6)' */
+    color?: string;
+    /** Particle speed multiplier. Default: 1 */
+    speed?: number;
+    /** Gravity force (positive = down). Default: 0 */
+    gravity?: number;
+    /** Wind force (positive = right). Default: 0 */
+    wind?: number;
+    /** Draw lines between nearby particles. Default: false */
+    connect?: boolean;
+    /** Max distance for connections in px. Default: 120 */
+    connectDistance?: number;
+    /** Connection line color. Default: 'rgba(255,255,255,0.1)' */
+    connectColor?: string;
+    /** Mouse attraction radius in px. Default: 0 (disabled) */
+    mouseAttract?: number;
+    /** Mouse attraction force. Default: 0.02 */
+    mouseForce?: number;
+    /** Particle shape. Default: 'circle' */
+    shape?: 'circle' | 'square';
+    /** Particles fade in/out at edges. Default: true */
+    fadeEdges?: boolean;
+    /** Background color. Default: 'transparent' */
+    background?: string;
+}
+/**
+ * Create a particle system on a canvas element.
+ * Returns a cleanup function.
+ */
+export declare function particles(canvas: string | HTMLCanvasElement, options?: ParticleOptions): () => void;
+//# sourceMappingURL=particles.d.ts.map

package/dist/canvas/particles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"particles.d.ts","sourceRoot":"","sources":["../../src/canvas/particles.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uDAAuD;IACvD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,KAAK,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC5B,oDAAoD;IACpD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AASD;;;GAGG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,MAAM,GAAG,iBAAiB,EAClC,OAAO,GAAE,eAAoB,GAC5B,MAAM,IAAI,CA6JZ"}

package/dist/canvas/particles.js

@@ -0,0 +1,138 @@
+/**
+ * Nova Engine — Particle System
+ *
+ * Configurable canvas-based particle effects with gravity, wind,
+ * emitters, and optional connections between particles.
+ */
+/**
+ * Create a particle system on a canvas element.
+ * Returns a cleanup function.
+ */
+export function particles(canvas, options = {}) {
+    const { count = 80, minRadius = 1, maxRadius = 3, color = 'rgba(255,255,255,0.6)', speed = 1, gravity = 0, wind = 0, connect = false, connectDistance = 120, connectColor = 'rgba(255,255,255,0.1)', mouseAttract = 0, mouseForce = 0.02, shape = 'circle', fadeEdges = true, background = 'transparent', } = options;
+    const el = typeof canvas === 'string'
+        ? document.querySelector(canvas)
+        : canvas;
+    const ctx = el.getContext('2d');
+    let w = el.offsetWidth;
+    let h = el.offsetHeight;
+    let dpr = window.devicePixelRatio || 1;
+    let mouseX = -9999, mouseY = -9999;
+    let rafId = 0;
+    function resize() {
+        w = el.offsetWidth;
+        h = el.offsetHeight;
+        dpr = window.devicePixelRatio || 1;
+        el.width = w * dpr;
+        el.height = h * dpr;
+        ctx.scale(dpr, dpr);
+    }
+    resize();
+    function rand(min, max) {
+        return min + Math.random() * (max - min);
+    }
+    const items = [];
+    for (let i = 0; i < count; i++) {
+        items.push({
+            x: rand(0, w),
+            y: rand(0, h),
+            vx: rand(-0.5, 0.5) * speed,
+            vy: rand(-0.5, 0.5) * speed,
+            r: rand(minRadius, maxRadius),
+            opacity: rand(0.3, 1),
+        });
+    }
+    function draw() {
+        ctx.clearRect(0, 0, w, h);
+        if (background !== 'transparent') {
+            ctx.fillStyle = background;
+            ctx.fillRect(0, 0, w, h);
+        }
+        // Update & draw particles
+        for (const p of items) {
+            p.vy += gravity * 0.01;
+            p.vx += wind * 0.01;
+            // Mouse attraction
+            if (mouseAttract > 0) {
+                const dx = mouseX - p.x;
+                const dy = mouseY - p.y;
+                const dist = Math.sqrt(dx * dx + dy * dy);
+                if (dist < mouseAttract && dist > 0) {
+                    p.vx += (dx / dist) * mouseForce;
+                    p.vy += (dy / dist) * mouseForce;
+                }
+            }
+            p.x += p.vx;
+            p.y += p.vy;
+            // Wrap around edges
+            if (p.x < -p.r)
+                p.x = w + p.r;
+            if (p.x > w + p.r)
+                p.x = -p.r;
+            if (p.y < -p.r)
+                p.y = h + p.r;
+            if (p.y > h + p.r)
+                p.y = -p.r;
+            // Edge fade
+            let alpha = p.opacity;
+            if (fadeEdges) {
+                const edgeDist = Math.min(p.x, p.y, w - p.x, h - p.y);
+                if (edgeDist < 40)
+                    alpha *= edgeDist / 40;
+            }
+            ctx.globalAlpha = alpha;
+            ctx.fillStyle = color;
+            if (shape === 'square') {
+                ctx.fillRect(p.x - p.r, p.y - p.r, p.r * 2, p.r * 2);
+            }
+            else {
+                ctx.beginPath();
+                ctx.arc(p.x, p.y, p.r, 0, Math.PI * 2);
+                ctx.fill();
+            }
+        }
+        // Connections
+        if (connect) {
+            ctx.lineWidth = 0.5;
+            for (let i = 0; i < items.length; i++) {
+                for (let j = i + 1; j < items.length; j++) {
+                    const dx = items[i].x - items[j].x;
+                    const dy = items[i].y - items[j].y;
+                    const dist = Math.sqrt(dx * dx + dy * dy);
+                    if (dist < connectDistance) {
+                        ctx.globalAlpha = 1 - dist / connectDistance;
+                        ctx.strokeStyle = connectColor;
+                        ctx.beginPath();
+                        ctx.moveTo(items[i].x, items[i].y);
+                        ctx.lineTo(items[j].x, items[j].y);
+                        ctx.stroke();
+                    }
+                }
+            }
+        }
+        ctx.globalAlpha = 1;
+        rafId = requestAnimationFrame(draw);
+    }
+    function onMouse(e) {
+        const rect = el.getBoundingClientRect();
+        mouseX = e.clientX - rect.left;
+        mouseY = e.clientY - rect.top;
+    }
+    function onMouseLeave() {
+        mouseX = -9999;
+        mouseY = -9999;
+    }
+    window.addEventListener('resize', resize);
+    if (mouseAttract > 0) {
+        el.addEventListener('mousemove', onMouse);
+        el.addEventListener('mouseleave', onMouseLeave);
+    }
+    rafId = requestAnimationFrame(draw);
+    return () => {
+        cancelAnimationFrame(rafId);
+        window.removeEventListener('resize', resize);
+        el.removeEventListener('mousemove', onMouse);
+        el.removeEventListener('mouseleave', onMouseLeave);
+    };
+}
+//# sourceMappingURL=particles.js.map

package/dist/canvas/particles.js.map

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

package/dist/canvas/sequence.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Nova Engine — Canvas Image Sequence
+ *
+ * Scroll-driven image sequence playback, inspired by Proto.xyz / Apple-style
+ * scroll-linked animations. Preloads a sequence of images and renders them
+ * to a canvas, with the current frame determined by scroll position.
+ */
+export interface SequenceOptions {
+    /** Container element — the canvas will be created inside this */
+    container: HTMLElement;
+    /** Array of image URLs in order */
+    images: string[];
+    /** Scroll container. Default: window */
+    scrollContainer?: HTMLElement | Window;
+    /** Scroll start position (0-1 of page). Default: 0 */
+    scrollStart?: number;
+    /** Scroll end position (0-1 of page). Default: 1 */
+    scrollEnd?: number;
+    /** Whether to make canvas cover the container. Default: true */
+    cover?: boolean;
+    /** Whether container should be sticky. Default: false (user manages layout) */
+    sticky?: boolean;
+    /** Object-fit for images. Default: 'cover' */
+    fit?: 'cover' | 'contain' | 'fill';
+    /** Callback when all images are loaded */
+    onLoad?: () => void;
+    /** Callback with current frame index */
+    onFrame?: (index: number) => void;
+}
+export interface SequenceInstance {
+    /** Current frame index */
+    readonly currentFrame: number;
+    /** Total frames loaded */
+    readonly totalFrames: number;
+    /** Loading progress 0-1 */
+    readonly progress: number;
+    /** Jump to a specific frame */
+    setFrame(index: number): void;
+    /** Destroy and clean up */
+    destroy(): void;
+}
+export declare function createSequence(options: SequenceOptions): SequenceInstance;
+//# sourceMappingURL=sequence.d.ts.map

package/dist/canvas/sequence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequence.d.ts","sourceRoot":"","sources":["../../src/canvas/sequence.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,eAAe;IAC9B,iEAAiE;IACjE,SAAS,EAAE,WAAW,CAAC;IACvB,mCAAmC;IACnC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,wCAAwC;IACxC,eAAe,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IACvC,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,+EAA+E;IAC/E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,8CAA8C;IAC9C,GAAG,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACnC,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,wCAAwC;IACxC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,gBAAgB;IAC/B,0BAA0B;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,0BAA0B;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,2BAA2B;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,+BAA+B;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,2BAA2B;IAC3B,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,gBAAgB,CA2KzE"}

package/dist/canvas/sequence.js

@@ -0,0 +1,162 @@
+/**
+ * Nova Engine — Canvas Image Sequence
+ *
+ * Scroll-driven image sequence playback, inspired by Proto.xyz / Apple-style
+ * scroll-linked animations. Preloads a sequence of images and renders them
+ * to a canvas, with the current frame determined by scroll position.
+ */
+export function createSequence(options) {
+    const { container, images, scrollContainer = window, scrollStart = 0, scrollEnd = 1, cover = true, sticky = false, fit = 'cover', onLoad, onFrame, } = options;
+    const canvas = document.createElement('canvas');
+    const ctx = canvas.getContext('2d');
+    const loadedImages = [];
+    let currentFrame = 0;
+    let loadedCount = 0;
+    let destroyed = false;
+    let rafId = 0;
+    // Style canvas
+    canvas.style.display = 'block';
+    if (cover) {
+        canvas.style.width = '100%';
+        canvas.style.height = '100%';
+        canvas.style.position = 'absolute';
+        canvas.style.top = '0';
+        canvas.style.left = '0';
+    }
+    if (sticky) {
+        container.style.position = 'sticky';
+        container.style.top = '0';
+    }
+    container.appendChild(canvas);
+    // Resize observer
+    const resize = () => {
+        const rect = container.getBoundingClientRect();
+        const dpr = window.devicePixelRatio || 1;
+        canvas.width = rect.width * dpr;
+        canvas.height = rect.height * dpr;
+        ctx.setTransform(dpr, 0, 0, dpr, 0, 0);
+        drawFrame(currentFrame);
+    };
+    const resizeObserver = new ResizeObserver(resize);
+    resizeObserver.observe(container);
+    resize();
+    // Preload images
+    for (let i = 0; i < images.length; i++) {
+        const img = new Image();
+        img.crossOrigin = 'anonymous';
+        loadedImages[i] = img;
+        img.onload = () => {
+            loadedCount++;
+            if (loadedCount === images.length) {
+                onLoad?.();
+                drawFrame(currentFrame);
+            }
+        };
+        img.src = images[i];
+    }
+    // Draw a specific frame
+    function drawFrame(index) {
+        if (destroyed)
+            return;
+        const img = loadedImages[index];
+        if (!img?.complete || !img.naturalWidth)
+            return;
+        const cw = canvas.width / (window.devicePixelRatio || 1);
+        const ch = canvas.height / (window.devicePixelRatio || 1);
+        ctx.clearRect(0, 0, cw, ch);
+        if (fit === 'fill') {
+            ctx.drawImage(img, 0, 0, cw, ch);
+        }
+        else {
+            const imgRatio = img.naturalWidth / img.naturalHeight;
+            const canvasRatio = cw / ch;
+            let sw, sh, sx, sy;
+            if (fit === 'cover') {
+                if (imgRatio > canvasRatio) {
+                    sh = img.naturalHeight;
+                    sw = sh * canvasRatio;
+                    sx = (img.naturalWidth - sw) / 2;
+                    sy = 0;
+                }
+                else {
+                    sw = img.naturalWidth;
+                    sh = sw / canvasRatio;
+                    sx = 0;
+                    sy = (img.naturalHeight - sh) / 2;
+                }
+            }
+            else {
+                // contain
+                if (imgRatio > canvasRatio) {
+                    const drawW = cw;
+                    const drawH = cw / imgRatio;
+                    ctx.drawImage(img, 0, (ch - drawH) / 2, drawW, drawH);
+                    return;
+                }
+                else {
+                    const drawH = ch;
+                    const drawW = ch * imgRatio;
+                    ctx.drawImage(img, (cw - drawW) / 2, 0, drawW, drawH);
+                    return;
+                }
+            }
+            ctx.drawImage(img, sx, sy, sw, sh, 0, 0, cw, ch);
+        }
+    }
+    // Scroll handler
+    function getScrollProgress() {
+        const scrollEl = scrollContainer === window
+            ? document.documentElement
+            : scrollContainer;
+        const scrollTop = scrollContainer === window
+            ? window.scrollY
+            : scrollEl.scrollTop;
+        const scrollHeight = scrollEl.scrollHeight - scrollEl.clientHeight;
+        if (scrollHeight <= 0)
+            return 0;
+        const rawProgress = scrollTop / scrollHeight;
+        const range = scrollEnd - scrollStart;
+        if (range <= 0)
+            return 0;
+        return Math.max(0, Math.min(1, (rawProgress - scrollStart) / range));
+    }
+    function onScroll() {
+        if (destroyed)
+            return;
+        rafId = requestAnimationFrame(() => {
+            const progress = getScrollProgress();
+            const frame = Math.min(Math.floor(progress * images.length), images.length - 1);
+            if (frame !== currentFrame) {
+                currentFrame = frame;
+                drawFrame(currentFrame);
+                onFrame?.(currentFrame);
+            }
+        });
+    }
+    scrollContainer.addEventListener('scroll', onScroll, { passive: true });
+    // Initial frame
+    onScroll();
+    return {
+        get currentFrame() { return currentFrame; },
+        get totalFrames() { return images.length; },
+        get progress() { return loadedCount / images.length; },
+        setFrame(index) {
+            const clamped = Math.max(0, Math.min(index, images.length - 1));
+            currentFrame = clamped;
+            drawFrame(currentFrame);
+            onFrame?.(currentFrame);
+        },
+        destroy() {
+            destroyed = true;
+            cancelAnimationFrame(rafId);
+            scrollContainer.removeEventListener('scroll', onScroll);
+            resizeObserver.disconnect();
+            canvas.remove();
+            if (sticky) {
+                container.style.position = '';
+                container.style.top = '';
+            }
+        },
+    };
+}
+//# sourceMappingURL=sequence.js.map