@codellyson/framely 0.1.0

package/dist/noise.js

@@ -0,0 +1,228 @@
+/**
+ * Noise Utilities
+ *
+ * Deterministic noise and random functions for reproducible animations.
+ * All functions are pure — same inputs always produce same outputs.
+ */
+/**
+ * Generate a seeded pseudo-random number between 0 and 1.
+ *
+ * Uses a hash-based approach for single-call determinism (no state).
+ *
+ * @param {number} seed - Any number (typically frame number or index)
+ * @returns {number} Pseudo-random value in [0, 1)
+ */
+export function random(seed) {
+    // Mulberry32 — fast, good distribution, 32-bit state
+    let t = (seed + 0x6d2b79f5) | 0;
+    t = Math.imul(t ^ (t >>> 15), t | 1);
+    t ^= t + Math.imul(t ^ (t >>> 7), t | 61);
+    return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+}
+/**
+ * Generate a seeded random number within a range.
+ *
+ * @param {number} seed - Seed value
+ * @param {number} min - Minimum value (inclusive)
+ * @param {number} max - Maximum value (exclusive)
+ * @returns {number} Random value in [min, max)
+ */
+export function randomRange(seed, min, max) {
+    return min + random(seed) * (max - min);
+}
+/**
+ * Generate a seeded random integer within a range.
+ *
+ * @param {number} seed - Seed value
+ * @param {number} min - Minimum value (inclusive)
+ * @param {number} max - Maximum value (inclusive)
+ * @returns {number} Random integer in [min, max]
+ */
+export function randomInt(seed, min, max) {
+    return Math.floor(min + random(seed) * (max - min + 1));
+}
+// ─── Permutation table for Perlin noise ──────────────────────────────────────
+function buildPermutation(seed) {
+    const perm = new Uint8Array(512);
+    const base = new Uint8Array(256);
+    for (let i = 0; i < 256; i++) {
+        base[i] = i;
+    }
+    // Fisher-Yates shuffle with seeded random
+    for (let i = 255; i > 0; i--) {
+        const j = Math.floor(random(seed + i) * (i + 1));
+        const tmp = base[i];
+        base[i] = base[j];
+        base[j] = tmp;
+    }
+    // Double the table to avoid index wrapping
+    for (let i = 0; i < 256; i++) {
+        perm[i] = base[i];
+        perm[i + 256] = base[i];
+    }
+    return perm;
+}
+// ─── Gradient vectors for 2D and 3D Perlin noise ────────────────────────────
+const GRAD2 = [
+    [1, 0], [-1, 0], [0, 1], [0, -1],
+    [1, 1], [-1, 1], [1, -1], [-1, -1],
+];
+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],
+];
+function fade(t) {
+    // Improved Perlin fade: 6t^5 - 15t^4 + 10t^3
+    return t * t * t * (t * (t * 6 - 15) + 10);
+}
+function lerp(a, b, t) {
+    return a + t * (b - a);
+}
+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;
+}
+// ─── Cache for permutation tables ────────────────────────────────────────────
+const permCache = new Map();
+function getPermutation(seed) {
+    if (!permCache.has(seed)) {
+        // Limit cache size
+        if (permCache.size > 32) {
+            const firstKey = permCache.keys().next().value;
+            if (firstKey !== undefined) {
+                permCache.delete(firstKey);
+            }
+        }
+        permCache.set(seed, buildPermutation(seed));
+    }
+    return permCache.get(seed);
+}
+/**
+ * 2D Perlin noise.
+ *
+ * Returns a smooth, continuous noise value for the given coordinates.
+ * Same inputs always produce the same output.
+ *
+ * @param {number} x - X coordinate
+ * @param {number} y - Y coordinate
+ * @param {object} [options]
+ * @param {number} [options.seed=0] - Seed for the permutation table
+ * @param {number} [options.frequency=1] - Scales the input coordinates
+ * @param {number} [options.amplitude=1] - Scales the output value
+ * @returns {number} Noise value in [-amplitude, amplitude]
+ */
+export function noise2D(x, y, options = {}) {
+    const { seed = 0, frequency = 1, amplitude = 1 } = options;
+    const perm = getPermutation(seed);
+    x *= frequency;
+    y *= frequency;
+    // Grid cell coordinates
+    const xi = Math.floor(x) & 255;
+    const yi = Math.floor(y) & 255;
+    // Relative position within cell
+    const xf = x - Math.floor(x);
+    const yf = y - Math.floor(y);
+    // Fade curves
+    const u = fade(xf);
+    const v = fade(yf);
+    // Hash the 4 corners
+    const aa = perm[perm[xi] + yi];
+    const ab = perm[perm[xi] + yi + 1];
+    const ba = perm[perm[xi + 1] + yi];
+    const bb = perm[perm[xi + 1] + yi + 1];
+    // Gradient dot products
+    const g00 = dot2(GRAD2[aa % 8], xf, yf);
+    const g10 = dot2(GRAD2[ba % 8], xf - 1, yf);
+    const g01 = dot2(GRAD2[ab % 8], xf, yf - 1);
+    const g11 = dot2(GRAD2[bb % 8], xf - 1, yf - 1);
+    // Bilinear interpolation
+    const x1 = lerp(g00, g10, u);
+    const x2 = lerp(g01, g11, u);
+    const result = lerp(x1, x2, v);
+    return result * amplitude;
+}
+/**
+ * 3D Perlin noise.
+ *
+ * Useful for animated noise: use (x, y, frame * speed) as coordinates.
+ *
+ * @param {number} x - X coordinate
+ * @param {number} y - Y coordinate
+ * @param {number} z - Z coordinate (often frame * speed)
+ * @param {object} [options]
+ * @param {number} [options.seed=0] - Seed for the permutation table
+ * @param {number} [options.frequency=1] - Scales the input coordinates
+ * @param {number} [options.amplitude=1] - Scales the output value
+ * @returns {number} Noise value in [-amplitude, amplitude]
+ */
+export function noise3D(x, y, z, options = {}) {
+    const { seed = 0, frequency = 1, amplitude = 1 } = options;
+    const perm = getPermutation(seed);
+    x *= frequency;
+    y *= frequency;
+    z *= frequency;
+    const xi = Math.floor(x) & 255;
+    const yi = Math.floor(y) & 255;
+    const zi = Math.floor(z) & 255;
+    const xf = x - Math.floor(x);
+    const yf = y - Math.floor(y);
+    const zf = z - Math.floor(z);
+    const u = fade(xf);
+    const v = fade(yf);
+    const w = fade(zf);
+    // Hash the 8 corners
+    const a = perm[xi] + yi;
+    const aa = perm[a] + zi;
+    const ab = perm[a + 1] + zi;
+    const b = perm[xi + 1] + yi;
+    const ba = perm[b] + zi;
+    const bb = perm[b + 1] + zi;
+    const g000 = dot3(GRAD3[perm[aa] % 12], xf, yf, zf);
+    const g100 = dot3(GRAD3[perm[ba] % 12], xf - 1, yf, zf);
+    const g010 = dot3(GRAD3[perm[ab] % 12], xf, yf - 1, zf);
+    const g110 = dot3(GRAD3[perm[bb] % 12], xf - 1, yf - 1, zf);
+    const g001 = dot3(GRAD3[perm[aa + 1] % 12], xf, yf, zf - 1);
+    const g101 = dot3(GRAD3[perm[ba + 1] % 12], xf - 1, yf, zf - 1);
+    const g011 = dot3(GRAD3[perm[ab + 1] % 12], xf, yf - 1, zf - 1);
+    const g111 = dot3(GRAD3[perm[bb + 1] % 12], xf - 1, yf - 1, zf - 1);
+    // Trilinear interpolation
+    const x1 = lerp(g000, g100, u);
+    const x2 = lerp(g010, g110, u);
+    const y1 = lerp(x1, x2, v);
+    const x3 = lerp(g001, g101, u);
+    const x4 = lerp(g011, g111, u);
+    const y2 = lerp(x3, x4, v);
+    const result = lerp(y1, y2, w);
+    return result * amplitude;
+}
+/**
+ * Fractal Brownian Motion (fBm) — layered 2D noise for natural textures.
+ *
+ * @param {number} x - X coordinate
+ * @param {number} y - Y coordinate
+ * @param {object} [options]
+ * @param {number} [options.seed=0] - Seed
+ * @param {number} [options.octaves=4] - Number of noise layers
+ * @param {number} [options.frequency=1] - Base frequency
+ * @param {number} [options.amplitude=1] - Base amplitude
+ * @param {number} [options.lacunarity=2] - Frequency multiplier per octave
+ * @param {number} [options.persistence=0.5] - Amplitude multiplier per octave
+ * @returns {number} Noise value
+ */
+export function fbm2D(x, y, options = {}) {
+    const { seed = 0, octaves = 4, frequency = 1, amplitude = 1, lacunarity = 2, persistence = 0.5, } = options;
+    let value = 0;
+    let freq = frequency;
+    let amp = amplitude;
+    for (let i = 0; i < octaves; i++) {
+        value += noise2D(x, y, { seed: seed + i * 1000, frequency: freq, amplitude: amp });
+        freq *= lacunarity;
+        amp *= persistence;
+    }
+    return value;
+}
+export default { random, randomRange, randomInt, noise2D, noise3D, fbm2D };
+//# sourceMappingURL=noise.js.map

package/dist/noise.js.map

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

package/dist/preload.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Asset Preloading Utilities
+ *
+ * These functions help ensure assets are loaded before they're needed,
+ * preventing flickering or missing content in rendered frames.
+ *
+ * For rendering, assets are typically loaded via the Img/Video/Audio
+ * components which use delayRender. These preload functions are useful
+ * for the Player/preview mode to ensure smooth playback.
+ */
+/**
+ * Resource type hint for the browser prefetch mechanism.
+ */
+type PrefetchAs = 'image' | 'video' | 'audio' | 'font' | 'script' | 'style';
+/**
+ * Supported asset types for bulk preloading.
+ */
+type PreloadAssetType = 'image' | 'video' | 'audio' | 'font';
+/**
+ * Descriptor for a single asset to preload via {@link preloadAll}.
+ */
+interface PreloadAsset {
+    /** The type of asset to preload. */
+    type: PreloadAssetType;
+    /** The URL of the asset. */
+    src: string;
+    /** Extra options – for fonts this should include `fontFamily`. */
+    options?: FontFaceOptions & {
+        fontFamily?: string;
+    };
+}
+/**
+ * Options forwarded to the `FontFace` constructor.
+ */
+interface FontFaceOptions {
+    weight?: string;
+    style?: string;
+    display?: string;
+    unicodeRange?: string;
+    [key: string]: unknown;
+}
+/**
+ * Union of all element / object types that the preload helpers can resolve to.
+ */
+type PreloadResult = HTMLImageElement | HTMLVideoElement | HTMLAudioElement | FontFace;
+/**
+ * Preload an image and return a promise that resolves when loaded.
+ *
+ * @param {string} src - Image URL
+ * @param {number} [timeoutMs=30000] - Timeout in milliseconds
+ * @returns {Promise<HTMLImageElement>} Resolves with the loaded image
+ *
+ * Usage:
+ *   await preloadImage('/images/hero.png');
+ *   // Image is now cached and will display immediately
+ */
+export declare function preloadImage(src: string, timeoutMs?: number): Promise<HTMLImageElement>;
+/**
+ * Preload a video and return a promise that resolves when loadable.
+ *
+ * Note: This doesn't fully load the video, just enough metadata to start playing.
+ *
+ * @param {string} src - Video URL
+ * @param {number} [timeoutMs=30000] - Timeout in milliseconds
+ * @returns {Promise<HTMLVideoElement>} Resolves with the video element
+ *
+ * Usage:
+ *   await preloadVideo('/videos/intro.mp4');
+ */
+export declare function preloadVideo(src: string, timeoutMs?: number): Promise<HTMLVideoElement>;
+/**
+ * Preload an audio file and return a promise that resolves when loadable.
+ *
+ * @param {string} src - Audio URL
+ * @param {number} [timeoutMs=30000] - Timeout in milliseconds
+ * @returns {Promise<HTMLAudioElement>} Resolves with the audio element
+ *
+ * Usage:
+ *   await preloadAudio('/audio/background.mp3');
+ */
+export declare function preloadAudio(src: string, timeoutMs?: number): Promise<HTMLAudioElement>;
+/**
+ * Preload a font and return a promise that resolves when loaded.
+ *
+ * @param {string} src - Font URL
+ * @param {string} fontFamily - Font family name to register
+ * @param {object} [options] - FontFace options (weight, style, etc.)
+ * @param {number} [timeoutMs=30000] - Timeout in milliseconds
+ * @returns {Promise<FontFace>} Resolves with the loaded FontFace
+ *
+ * Usage:
+ *   await preloadFont('/fonts/custom.woff2', 'CustomFont', { weight: '400' });
+ *   // Now you can use font-family: 'CustomFont' in CSS
+ */
+export declare function preloadFont(src: string, fontFamily: string, options?: FontFaceDescriptors, timeoutMs?: number): Promise<FontFace>;
+/**
+ * Generic prefetch function that uses link[rel=prefetch].
+ *
+ * This tells the browser to fetch the resource in the background
+ * during idle time. Good for assets that will be needed soon but
+ * not immediately.
+ *
+ * @param {string} src - Resource URL
+ * @param {string} [as] - Resource type (image, video, audio, font, script, style)
+ * @returns {HTMLLinkElement} The created link element
+ *
+ * Usage:
+ *   prefetch('/images/next-slide.png', 'image');
+ */
+export declare function prefetch(src: string, as?: PrefetchAs): HTMLLinkElement;
+/**
+ * Preload multiple assets in parallel.
+ *
+ * @param {Array<{ type: 'image'|'video'|'audio'|'font', src: string, options?: object }>} assets
+ * @param {number} [timeoutMs=30000] - Timeout for each asset
+ * @returns {Promise<Array>} Resolves when all assets are loaded
+ *
+ * Usage:
+ *   await preloadAll([
+ *     { type: 'image', src: '/images/hero.png' },
+ *     { type: 'video', src: '/videos/intro.mp4' },
+ *     { type: 'font', src: '/fonts/custom.woff2', options: { fontFamily: 'Custom' } },
+ *   ]);
+ */
+export declare function preloadAll(assets: PreloadAsset[], timeoutMs?: number): Promise<PreloadResult[]>;
+/**
+ * Resolve a callback when the asset at the given URL is loaded.
+ * Alternative API for those who prefer callbacks over promises.
+ *
+ * @param {string} src - Asset URL
+ * @param {function} onLoad - Called when loaded
+ * @param {function} [onError] - Called on error
+ */
+export declare function resolveWhenLoaded(src: string, onLoad: (img: HTMLImageElement) => void, onError?: (err: Error) => void): void;
+declare const _default: {
+    preloadImage: typeof preloadImage;
+    preloadVideo: typeof preloadVideo;
+    preloadAudio: typeof preloadAudio;
+    preloadFont: typeof preloadFont;
+    prefetch: typeof prefetch;
+    preloadAll: typeof preloadAll;
+    resolveWhenLoaded: typeof resolveWhenLoaded;
+};
+export default _default;
+//# sourceMappingURL=preload.d.ts.map

package/dist/preload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preload.d.ts","sourceRoot":"","sources":["../src/preload.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;GAEG;AACH,KAAK,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE5E;;GAEG;AACH,KAAK,gBAAgB,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;AAE7D;;GAEG;AACH,UAAU,YAAY;IACpB,oCAAoC;IACpC,IAAI,EAAE,gBAAgB,CAAC;IACvB,4BAA4B;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,kEAAkE;IAClE,OAAO,CAAC,EAAE,eAAe,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACrD;AAED;;GAEG;AACH,UAAU,eAAe;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,KAAK,aAAa,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,QAAQ,CAAC;AAEvF;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,GAAE,MAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAoB9F;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,GAAE,MAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA+B9F;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,GAAE,MAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA+B9F;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,mBAAwB,EACjC,SAAS,GAAE,MAAc,GACxB,OAAO,CAAC,QAAQ,CAAC,CAmBnB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,UAAU,GAAG,eAAe,CAYtE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,SAAS,GAAE,MAAc,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAsBtG;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,CAAC,GAAG,EAAE,gBAAgB,KAAK,IAAI,EACvC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,GAC7B,IAAI,CAKN;;;;;;;;;;AAED,wBAQE"}

package/dist/preload.js

@@ -0,0 +1,225 @@
+/**
+ * Asset Preloading Utilities
+ *
+ * These functions help ensure assets are loaded before they're needed,
+ * preventing flickering or missing content in rendered frames.
+ *
+ * For rendering, assets are typically loaded via the Img/Video/Audio
+ * components which use delayRender. These preload functions are useful
+ * for the Player/preview mode to ensure smooth playback.
+ */
+/**
+ * Preload an image and return a promise that resolves when loaded.
+ *
+ * @param {string} src - Image URL
+ * @param {number} [timeoutMs=30000] - Timeout in milliseconds
+ * @returns {Promise<HTMLImageElement>} Resolves with the loaded image
+ *
+ * Usage:
+ *   await preloadImage('/images/hero.png');
+ *   // Image is now cached and will display immediately
+ */
+export function preloadImage(src, timeoutMs = 30000) {
+    return new Promise((resolve, reject) => {
+        const img = new Image();
+        const timeoutId = setTimeout(() => {
+            reject(new Error(`Image preload timed out: ${src}`));
+        }, timeoutMs);
+        img.onload = () => {
+            clearTimeout(timeoutId);
+            resolve(img);
+        };
+        img.onerror = () => {
+            clearTimeout(timeoutId);
+            reject(new Error(`Failed to preload image: ${src}`));
+        };
+        img.src = src;
+    });
+}
+/**
+ * Preload a video and return a promise that resolves when loadable.
+ *
+ * Note: This doesn't fully load the video, just enough metadata to start playing.
+ *
+ * @param {string} src - Video URL
+ * @param {number} [timeoutMs=30000] - Timeout in milliseconds
+ * @returns {Promise<HTMLVideoElement>} Resolves with the video element
+ *
+ * Usage:
+ *   await preloadVideo('/videos/intro.mp4');
+ */
+export function preloadVideo(src, timeoutMs = 30000) {
+    return new Promise((resolve, reject) => {
+        const video = document.createElement('video');
+        video.preload = 'auto';
+        const timeoutId = setTimeout(() => {
+            reject(new Error(`Video preload timed out: ${src}`));
+        }, timeoutMs);
+        const cleanup = () => {
+            clearTimeout(timeoutId);
+            video.removeEventListener('canplaythrough', onCanPlay);
+            video.removeEventListener('error', onError);
+        };
+        const onCanPlay = () => {
+            cleanup();
+            resolve(video);
+        };
+        const onError = () => {
+            cleanup();
+            reject(new Error(`Failed to preload video: ${src}`));
+        };
+        video.addEventListener('canplaythrough', onCanPlay);
+        video.addEventListener('error', onError);
+        video.src = src;
+        video.load();
+    });
+}
+/**
+ * Preload an audio file and return a promise that resolves when loadable.
+ *
+ * @param {string} src - Audio URL
+ * @param {number} [timeoutMs=30000] - Timeout in milliseconds
+ * @returns {Promise<HTMLAudioElement>} Resolves with the audio element
+ *
+ * Usage:
+ *   await preloadAudio('/audio/background.mp3');
+ */
+export function preloadAudio(src, timeoutMs = 30000) {
+    return new Promise((resolve, reject) => {
+        const audio = new Audio();
+        audio.preload = 'auto';
+        const timeoutId = setTimeout(() => {
+            reject(new Error(`Audio preload timed out: ${src}`));
+        }, timeoutMs);
+        const cleanup = () => {
+            clearTimeout(timeoutId);
+            audio.removeEventListener('canplaythrough', onCanPlay);
+            audio.removeEventListener('error', onError);
+        };
+        const onCanPlay = () => {
+            cleanup();
+            resolve(audio);
+        };
+        const onError = () => {
+            cleanup();
+            reject(new Error(`Failed to preload audio: ${src}`));
+        };
+        audio.addEventListener('canplaythrough', onCanPlay);
+        audio.addEventListener('error', onError);
+        audio.src = src;
+        audio.load();
+    });
+}
+/**
+ * Preload a font and return a promise that resolves when loaded.
+ *
+ * @param {string} src - Font URL
+ * @param {string} fontFamily - Font family name to register
+ * @param {object} [options] - FontFace options (weight, style, etc.)
+ * @param {number} [timeoutMs=30000] - Timeout in milliseconds
+ * @returns {Promise<FontFace>} Resolves with the loaded FontFace
+ *
+ * Usage:
+ *   await preloadFont('/fonts/custom.woff2', 'CustomFont', { weight: '400' });
+ *   // Now you can use font-family: 'CustomFont' in CSS
+ */
+export function preloadFont(src, fontFamily, options = {}, timeoutMs = 30000) {
+    return new Promise((resolve, reject) => {
+        const timeoutId = setTimeout(() => {
+            reject(new Error(`Font preload timed out: ${src}`));
+        }, timeoutMs);
+        const fontFace = new FontFace(fontFamily, `url(${src})`, options);
+        fontFace.load()
+            .then((loadedFace) => {
+            clearTimeout(timeoutId);
+            document.fonts.add(loadedFace);
+            resolve(loadedFace);
+        })
+            .catch((err) => {
+            clearTimeout(timeoutId);
+            reject(new Error(`Failed to preload font: ${src} - ${err.message}`));
+        });
+    });
+}
+/**
+ * Generic prefetch function that uses link[rel=prefetch].
+ *
+ * This tells the browser to fetch the resource in the background
+ * during idle time. Good for assets that will be needed soon but
+ * not immediately.
+ *
+ * @param {string} src - Resource URL
+ * @param {string} [as] - Resource type (image, video, audio, font, script, style)
+ * @returns {HTMLLinkElement} The created link element
+ *
+ * Usage:
+ *   prefetch('/images/next-slide.png', 'image');
+ */
+export function prefetch(src, as) {
+    // Check if already prefetched
+    const existing = document.querySelector(`link[rel="prefetch"][href="${src}"]`);
+    if (existing)
+        return existing;
+    const link = document.createElement('link');
+    link.rel = 'prefetch';
+    link.href = src;
+    if (as)
+        link.as = as;
+    document.head.appendChild(link);
+    return link;
+}
+/**
+ * Preload multiple assets in parallel.
+ *
+ * @param {Array<{ type: 'image'|'video'|'audio'|'font', src: string, options?: object }>} assets
+ * @param {number} [timeoutMs=30000] - Timeout for each asset
+ * @returns {Promise<Array>} Resolves when all assets are loaded
+ *
+ * Usage:
+ *   await preloadAll([
+ *     { type: 'image', src: '/images/hero.png' },
+ *     { type: 'video', src: '/videos/intro.mp4' },
+ *     { type: 'font', src: '/fonts/custom.woff2', options: { fontFamily: 'Custom' } },
+ *   ]);
+ */
+export function preloadAll(assets, timeoutMs = 30000) {
+    const promises = assets.map((asset) => {
+        switch (asset.type) {
+            case 'image':
+                return preloadImage(asset.src, timeoutMs);
+            case 'video':
+                return preloadVideo(asset.src, timeoutMs);
+            case 'audio':
+                return preloadAudio(asset.src, timeoutMs);
+            case 'font':
+                return preloadFont(asset.src, asset.options?.fontFamily || 'PreloadedFont', asset.options, timeoutMs);
+            default:
+                return Promise.reject(new Error(`Unknown asset type: ${asset.type}`));
+        }
+    });
+    return Promise.all(promises);
+}
+/**
+ * Resolve a callback when the asset at the given URL is loaded.
+ * Alternative API for those who prefer callbacks over promises.
+ *
+ * @param {string} src - Asset URL
+ * @param {function} onLoad - Called when loaded
+ * @param {function} [onError] - Called on error
+ */
+export function resolveWhenLoaded(src, onLoad, onError) {
+    const img = new Image();
+    img.onload = () => onLoad(img);
+    img.onerror = () => onError?.(new Error(`Failed to load: ${src}`));
+    img.src = src;
+}
+export default {
+    preloadImage,
+    preloadVideo,
+    preloadAudio,
+    preloadFont,
+    prefetch,
+    preloadAll,
+    resolveWhenLoaded,
+};
+//# sourceMappingURL=preload.js.map

package/dist/preload.js.map

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