@clipkit/runtime 1.0.0

package/dist/assets/cache.d.ts

@@ -0,0 +1,18 @@
+export declare class AssetCache<T> {
+    private store;
+    private inFlight;
+    /**
+     * Get an asset, loading it if not cached. Concurrent calls for the same
+     * key share a single in-flight Promise.
+     */
+    getOrLoad(key: string, load: () => Promise<T>): Promise<T>;
+    has(key: string): boolean;
+    get(key: string): T | undefined;
+    /** Set a value synchronously (for assets that are generated, not loaded). */
+    set(key: string, value: T): void;
+    delete(key: string): T | undefined;
+    clear(): void;
+    get size(): number;
+    entries(): IterableIterator<[string, T]>;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/assets/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/assets/cache.ts"],"names":[],"mappings":"AAGA,qBAAa,UAAU,CAAC,CAAC;IACvB,OAAO,CAAC,KAAK,CAAwB;IACrC,OAAO,CAAC,QAAQ,CAAiC;IAEjD;;;OAGG;IACG,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAoBhE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAI/B,6EAA6E;IAC7E,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAIhC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAMlC,KAAK,IAAI,IAAI;IAKb,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,OAAO,IAAI,gBAAgB,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;CAGzC"}

package/dist/assets/cache.js

@@ -0,0 +1,56 @@
+// Keyed asset cache. Simple wrapper around a Map so consumers don't have
+// to deal with the get-or-load pattern themselves.
+export class AssetCache {
+    store = new Map();
+    inFlight = new Map();
+    /**
+     * Get an asset, loading it if not cached. Concurrent calls for the same
+     * key share a single in-flight Promise.
+     */
+    async getOrLoad(key, load) {
+        const cached = this.store.get(key);
+        if (cached !== undefined)
+            return cached;
+        const pending = this.inFlight.get(key);
+        if (pending)
+            return pending;
+        const promise = load()
+            .then((value) => {
+            this.store.set(key, value);
+            this.inFlight.delete(key);
+            return value;
+        })
+            .catch((err) => {
+            this.inFlight.delete(key);
+            throw err;
+        });
+        this.inFlight.set(key, promise);
+        return promise;
+    }
+    has(key) {
+        return this.store.has(key);
+    }
+    get(key) {
+        return this.store.get(key);
+    }
+    /** Set a value synchronously (for assets that are generated, not loaded). */
+    set(key, value) {
+        this.store.set(key, value);
+    }
+    delete(key) {
+        const v = this.store.get(key);
+        this.store.delete(key);
+        return v;
+    }
+    clear() {
+        this.store.clear();
+        this.inFlight.clear();
+    }
+    get size() {
+        return this.store.size;
+    }
+    entries() {
+        return this.store.entries();
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/assets/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/assets/cache.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,mDAAmD;AAEnD,MAAM,OAAO,UAAU;IACb,KAAK,GAAG,IAAI,GAAG,EAAa,CAAC;IAC7B,QAAQ,GAAG,IAAI,GAAG,EAAsB,CAAC;IAEjD;;;OAGG;IACH,KAAK,CAAC,SAAS,CAAC,GAAW,EAAE,IAAsB;QACjD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC;QACxC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,OAAO;YAAE,OAAO,OAAO,CAAC;QAE5B,MAAM,OAAO,GAAG,IAAI,EAAE;aACnB,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;YACd,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAC3B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC1B,OAAO,KAAK,CAAC;QACf,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACb,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC1B,MAAM,GAAG,CAAC;QACZ,CAAC,CAAC,CAAC;QACL,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAChC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,6EAA6E;IAC7E,GAAG,CAAC,GAAW,EAAE,KAAQ;QACvB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,MAAM,CAAC,GAAW;QAChB,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACvB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;IAC9B,CAAC;CACF"}

package/dist/assets/fonts.d.ts

@@ -0,0 +1,20 @@
+import type { FontFace as ProtocolFontFace } from '@clipkit/protocol';
+/**
+ * Ensure a font face is loaded so the canvas-text rasterizer can use it.
+ * Generic CSS families (sans-serif, monospace, etc.) skip the load — the
+ * browser always has them available.
+ *
+ * Quietly succeeds when the FontFace API is unavailable (non-browser
+ * environments). Logs a warning and resolves when the font fails to load
+ * — text will fall back to the browser's default font, visibly wrong
+ * but at least not blank.
+ */
+export declare function loadFont(family: string, weight?: string | number, style?: 'normal' | 'italic'): Promise<void>;
+/**
+ * Wait for ALL currently-pending fonts in the document to finish loading.
+ * Call this once after the page has declared its @font-face rules but
+ * before generating font atlases.
+ */
+export declare function fontsReady(): Promise<void>;
+export declare function registerSourceFonts(fonts: ProtocolFontFace[]): Promise<void>;
+//# sourceMappingURL=fonts.d.ts.map

package/dist/assets/fonts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fonts.d.ts","sourceRoot":"","sources":["../../src/assets/fonts.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,IAAI,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAgCtE;;;;;;;;;GASG;AACH,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAAM,GAAG,MAAiB,EAClC,KAAK,GAAE,QAAQ,GAAG,QAAmB,GACpC,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAED;;;;GAIG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAIhD;AAWD,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAsClF"}

package/dist/assets/fonts.js

@@ -0,0 +1,127 @@
+// Font loading. The previous runtime silently rendered with a fallback
+// font when the requested family wasn't loaded, which caused empty-looking
+// or wrong-looking text. We make font loading explicit here: callers
+// request a font, and the promise resolves when the font is available
+// (or rejects loudly if not).
+import { getLogger } from '../logger.js';
+/**
+ * Get the current global FontFaceSet — `document.fonts` on the main
+ * thread, `self.fonts` inside a (Dedicated/Shared) Worker. The playback
+ * pipeline runs ClipkitRuntime inside a worker via OffscreenCanvas, so
+ * skipping when only `document` is checked would silently disable
+ * font handling for live playback.
+ */
+function getFontFaceSet() {
+    if (typeof document !== 'undefined' && document.fonts)
+        return document.fonts;
+    if (typeof self !== 'undefined') {
+        const s = self;
+        if (s.fonts)
+            return s.fonts;
+    }
+    return null;
+}
+const KNOWN_GENERIC_FAMILIES = new Set([
+    'serif',
+    'sans-serif',
+    'monospace',
+    'cursive',
+    'fantasy',
+    'system-ui',
+    'ui-serif',
+    'ui-sans-serif',
+    'ui-monospace',
+    'ui-rounded',
+]);
+/**
+ * Ensure a font face is loaded so the canvas-text rasterizer can use it.
+ * Generic CSS families (sans-serif, monospace, etc.) skip the load — the
+ * browser always has them available.
+ *
+ * Quietly succeeds when the FontFace API is unavailable (non-browser
+ * environments). Logs a warning and resolves when the font fails to load
+ * — text will fall back to the browser's default font, visibly wrong
+ * but at least not blank.
+ */
+export async function loadFont(family, weight = 'normal', style = 'normal') {
+    const fontSet = getFontFaceSet();
+    if (!fontSet)
+        return;
+    // font_family is often a full CSS stack ("Geist, ui-sans-serif, sans-serif").
+    // Resolve the first CONCRETE family: quoting the whole stack as one name never
+    // matches (it only warns), and a leading generic means the browser already has
+    // it — nothing to load.
+    const target = family
+        .split(',')
+        .map((s) => s.trim().replace(/^["']|["']$/g, ''))
+        .find((f) => f && !KNOWN_GENERIC_FAMILIES.has(f.toLowerCase()));
+    if (!target)
+        return;
+    const spec = `${style} ${weight} 16px "${target}"`;
+    try {
+        const faces = await fontSet.load(spec);
+        if (faces.length === 0) {
+            getLogger().warn(`Font "${target}" (${weight} ${style}) was requested but no matching FontFace was found. ` +
+                `Declare it in the Source's fonts[] (family + src), or add the @font-face to the page. ` +
+                `Text will render with the browser default.`);
+        }
+    }
+    catch (err) {
+        getLogger().warn(`Loading font "${target}" failed:`, err instanceof Error ? err.message : String(err));
+    }
+}
+/**
+ * Wait for ALL currently-pending fonts in the document to finish loading.
+ * Call this once after the page has declared its @font-face rules but
+ * before generating font atlases.
+ */
+export async function fontsReady() {
+    const fontSet = getFontFaceSet();
+    if (!fontSet)
+        return;
+    await fontSet.ready;
+}
+/**
+ * Register Source-declared @font-face entries into the host document so
+ * the canvas-text path renders with the exact font the snapshot saw.
+ *
+ * Idempotent per (family, weight, style, src) tuple: a face already added
+ * by an earlier preload() (or by the host page) is skipped — the
+ * FontFaceSet doesn't dedupe these for us.
+ */
+const registeredFontKeys = new Set();
+export async function registerSourceFonts(fonts) {
+    const fontSet = getFontFaceSet();
+    if (!fontSet)
+        return;
+    if (typeof FontFace === 'undefined')
+        return;
+    const loads = [];
+    for (const f of fonts) {
+        const weight = f.weight === undefined ? 'normal' : String(f.weight);
+        const style = f.style ?? 'normal';
+        const key = `${f.family}|${weight}|${style}|${f.src}`;
+        if (registeredFontKeys.has(key))
+            continue;
+        registeredFontKeys.add(key);
+        try {
+            const face = new FontFace(f.family, `url(${f.src})`, {
+                weight,
+                style,
+                // Subsetted webfonts ship one file per script with identical
+                // family/weight/style; without the range every subset matches
+                // every codepoint and the winner may lack the needed glyphs.
+                ...(f.unicode_range ? { unicodeRange: f.unicode_range } : {}),
+            });
+            fontSet.add(face);
+            loads.push(face.load().catch((err) => {
+                getLogger().warn(`Failed to load Source font "${f.family}" (${weight} ${style}) from ${f.src}:`, err instanceof Error ? err.message : String(err));
+            }));
+        }
+        catch (err) {
+            getLogger().warn(`Failed to register Source font "${f.family}" (${weight} ${style}):`, err instanceof Error ? err.message : String(err));
+        }
+    }
+    await Promise.all(loads);
+}
+//# sourceMappingURL=fonts.js.map

package/dist/assets/fonts.js.map

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

package/dist/assets/loader.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Load an image URL and decode it into an ImageBitmap. ImageBitmaps are
+ * preferred over HTMLImageElement here because they can be uploaded to
+ * GPU textures without re-decoding.
+ */
+export declare function loadImage(url: string): Promise<ImageBitmap>;
+/**
+ * Load a video URL into an HTMLVideoElement. Resolves once the video has
+ * enough data to seek and sample frames (`loadeddata`). Caller can then
+ * `video.currentTime = t` and read frames.
+ */
+export declare function loadVideo(url: string): Promise<HTMLVideoElement>;
+/**
+ * Seek a video to the given time and resolve once the new frame is ready
+ * to be sampled. Necessary for deterministic frame-by-frame export.
+ */
+export declare function seekVideo(video: HTMLVideoElement, time: number): Promise<void>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/assets/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/assets/loader.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAwBjE;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA0BtE;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAc9E"}

package/dist/assets/loader.js

@@ -0,0 +1,87 @@
+// URL → asset loaders.
+//
+// All functions throw on failure; callers can wrap in try/catch or let the
+// error propagate through the scene's preload step. The runtime's public
+// API has a single preload() boundary; once that resolves, render() can
+// be called synchronously without worrying about async loads.
+/**
+ * Load an image URL and decode it into an ImageBitmap. ImageBitmaps are
+ * preferred over HTMLImageElement here because they can be uploaded to
+ * GPU textures without re-decoding.
+ */
+export async function loadImage(url) {
+    // 10s fetch timeout. Without this a single stalled CDN (hotlink-
+    // protected images on URL-snapshotted pages especially) hangs the
+    // entire Promise.all in runtime.preload() and the worker never
+    // resolves "ready".
+    const ac = new AbortController();
+    const timer = setTimeout(() => ac.abort(), 10000);
+    let response;
+    try {
+        response = await fetch(url, { mode: 'cors', signal: ac.signal });
+    }
+    finally {
+        clearTimeout(timer);
+    }
+    if (!response.ok) {
+        throw new Error(`Failed to fetch image ${url}: HTTP ${response.status}`);
+    }
+    const blob = await response.blob();
+    // imageOrientation: 'from-image' respects EXIF orientation; colorSpaceConversion: 'none'
+    // skips browser color-space tweaks that can shift colors slightly.
+    return createImageBitmap(blob, {
+        imageOrientation: 'from-image',
+        premultiplyAlpha: 'none', // we premultiply on the GPU during upload
+        colorSpaceConversion: 'none',
+    });
+}
+/**
+ * Load a video URL into an HTMLVideoElement. Resolves once the video has
+ * enough data to seek and sample frames (`loadeddata`). Caller can then
+ * `video.currentTime = t` and read frames.
+ */
+export async function loadVideo(url) {
+    const video = document.createElement('video');
+    video.crossOrigin = 'anonymous';
+    video.muted = true; // required for autoplay-on-seek in some browsers
+    video.playsInline = true;
+    video.preload = 'auto';
+    video.src = url;
+    await new Promise((resolve, reject) => {
+        const onLoaded = () => {
+            cleanup();
+            resolve();
+        };
+        const onError = () => {
+            cleanup();
+            reject(new Error(`Failed to load video ${url}`));
+        };
+        const cleanup = () => {
+            video.removeEventListener('loadeddata', onLoaded);
+            video.removeEventListener('error', onError);
+        };
+        video.addEventListener('loadeddata', onLoaded);
+        video.addEventListener('error', onError);
+    });
+    return video;
+}
+/**
+ * Seek a video to the given time and resolve once the new frame is ready
+ * to be sampled. Necessary for deterministic frame-by-frame export.
+ */
+export function seekVideo(video, time) {
+    return new Promise((resolve) => {
+        const target = Math.max(0, Math.min(video.duration || Number.POSITIVE_INFINITY, time));
+        if (Math.abs(video.currentTime - target) < 1e-4) {
+            resolve();
+            return;
+        }
+        const onSeeked = () => {
+            video.removeEventListener('seeked', onSeeked);
+            resolve();
+        };
+        video.addEventListener('seeked', onSeeked);
+        video.currentTime = target;
+    });
+}
+//# sourceMappingURL=loader.js.map

package/dist/assets/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/assets/loader.ts"],"names":[],"mappings":"AAAA,uBAAuB;AACvB,EAAE;AACF,2EAA2E;AAC3E,yEAAyE;AACzE,wEAAwE;AACxE,8DAA8D;AAE9D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAW;IACzC,iEAAiE;IACjE,kEAAkE;IAClE,+DAA+D;IAC/D,oBAAoB;IACpB,MAAM,EAAE,GAAG,IAAI,eAAe,EAAE,CAAC;IACjC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,KAAK,CAAC,CAAC;IAClD,IAAI,QAAkB,CAAC;IACvB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;IACnE,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,yBAAyB,GAAG,UAAU,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3E,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACnC,yFAAyF;IACzF,mEAAmE;IACnE,OAAO,iBAAiB,CAAC,IAAI,EAAE;QAC7B,gBAAgB,EAAE,YAAY;QAC9B,gBAAgB,EAAE,MAAM,EAAE,0CAA0C;QACpE,oBAAoB,EAAE,MAAM;KAC7B,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAW;IACzC,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAC9C,KAAK,CAAC,WAAW,GAAG,WAAW,CAAC;IAChC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,iDAAiD;IACrE,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC;IACvB,KAAK,CAAC,GAAG,GAAG,GAAG,CAAC;IAEhB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC1C,MAAM,QAAQ,GAAG,GAAG,EAAE;YACpB,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;QACF,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,OAAO,EAAE,CAAC;YACV,MAAM,CAAC,IAAI,KAAK,CAAC,wBAAwB,GAAG,EAAE,CAAC,CAAC,CAAC;QACnD,CAAC,CAAC;QACF,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,KAAK,CAAC,mBAAmB,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;YAClD,KAAK,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC9C,CAAC,CAAC;QACF,KAAK,CAAC,gBAAgB,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QAC/C,KAAK,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,KAAuB,EAAE,IAAY;IAC7D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,IAAI,MAAM,CAAC,iBAAiB,EAAE,IAAI,CAAC,CAAC,CAAC;QACvF,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,GAAG,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;YAChD,OAAO,EAAE,CAAC;YACV,OAAO;QACT,CAAC;QACD,MAAM,QAAQ,GAAG,GAAG,EAAE;YACpB,KAAK,CAAC,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YAC9C,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;QACF,KAAK,CAAC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC3C,KAAK,CAAC,WAAW,GAAG,MAAM,CAAC;IAC7B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/assets/lut.d.ts

@@ -0,0 +1,5 @@
+export declare function loadCube(url: string): Promise<{
+    bitmap: ImageBitmap;
+    size: number;
+}>;
+//# sourceMappingURL=lut.d.ts.map

package/dist/assets/lut.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lut.d.ts","sourceRoot":"","sources":["../../src/assets/lut.ts"],"names":[],"mappings":"AAWA,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CA0D1F"}

package/dist/assets/lut.js

@@ -0,0 +1,77 @@
+// .cube 3D LUT loader (§4.7 `lut`) — fetch + parse + pack the lattice
+// into an N²×N RGBA bitmap: N slices laid along x (slice index = blue
+// level), u = red, v = green within a slice. The stylize shader does
+// manual trilinear sampling over this atlas (two bilinear taps mixed
+// across the blue axis), so the texture must use linear filtering —
+// the backend's default.
+//
+// v1 scope: LUT_3D_SIZE only (1D LUTs rejected), default 0..1 domain.
+// Values are clamped to [0, 1] and quantized to 8-bit, matching the
+// pipeline's working precision.
+export async function loadCube(url) {
+    // 10s fetch timeout (mirrors loadImage) so a dead LUT URL can't dangle.
+    const ac = new AbortController();
+    const timer = setTimeout(() => ac.abort(), 10000);
+    let res;
+    try {
+        res = await fetch(url, { signal: ac.signal });
+    }
+    finally {
+        clearTimeout(timer);
+    }
+    if (!res.ok)
+        throw new Error(`fetch failed: ${res.status}`);
+    const text = await res.text();
+    let n = 0;
+    const values = [];
+    for (const rawLine of text.split(/\r?\n/)) {
+        const line = rawLine.trim();
+        if (!line || line.startsWith('#'))
+            continue;
+        const up = line.toUpperCase();
+        if (up.startsWith('TITLE'))
+            continue;
+        if (up.startsWith('DOMAIN_MIN') || up.startsWith('DOMAIN_MAX')) {
+            const expect = up.startsWith('DOMAIN_MIN') ? 0 : 1;
+            const nums = line.split(/\s+/).slice(1).map(Number);
+            if (nums.some((v) => v !== expect))
+                throw new Error('non-default DOMAIN not supported');
+            continue;
+        }
+        if (up.startsWith('LUT_1D_SIZE'))
+            throw new Error('1D LUTs not supported');
+        if (up.startsWith('LUT_3D_SIZE')) {
+            n = parseInt(line.split(/\s+/)[1] ?? '0', 10);
+            continue;
+        }
+        const parts = line.split(/\s+/);
+        if (parts.length >= 3) {
+            const r = Number(parts[0]);
+            const g = Number(parts[1]);
+            const b = Number(parts[2]);
+            if (Number.isFinite(r) && Number.isFinite(g) && Number.isFinite(b))
+                values.push(r, g, b);
+        }
+    }
+    if (!Number.isInteger(n) || n < 2 || n > 256)
+        throw new Error('missing or invalid LUT_3D_SIZE');
+    if (values.length < n * n * n * 3)
+        throw new Error('truncated LUT data');
+    // .cube data order: red fastest, then green, then blue.
+    const data = new Uint8ClampedArray(n * n * n * 4);
+    let i = 0;
+    for (let b = 0; b < n; b++) {
+        for (let g = 0; g < n; g++) {
+            for (let r = 0; r < n; r++) {
+                const o = (g * n * n + (b * n + r)) * 4;
+                data[o] = Math.round(Math.min(1, Math.max(0, values[i++])) * 255);
+                data[o + 1] = Math.round(Math.min(1, Math.max(0, values[i++])) * 255);
+                data[o + 2] = Math.round(Math.min(1, Math.max(0, values[i++])) * 255);
+                data[o + 3] = 255;
+            }
+        }
+    }
+    const bitmap = await createImageBitmap(new ImageData(data, n * n, n));
+    return { bitmap, size: n };
+}
+//# sourceMappingURL=lut.js.map

package/dist/assets/lut.js.map

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

package/dist/assets/media-time.d.ts

@@ -0,0 +1,31 @@
+import type { Keyframe } from '@clipkit/protocol';
+export interface MediaTiming {
+    /** Composition time the element becomes active, seconds. */
+    elementStart: number;
+    /** trim_start, seconds into the media. */
+    trimStart: number;
+    /** trim_duration, seconds of media after trimStart. null = to media end. */
+    trimDuration: number | null;
+    /** playback_rate. 1 = realtime. */
+    rate: number;
+    loop: boolean;
+    /** time_remap keyframes (element-local time → media seconds), or null. */
+    timeRemap?: Keyframe[] | null;
+}
+/** The playable media window [start, start+length] after trims. */
+export declare function trimWindow(timing: Pick<MediaTiming, 'trimStart' | 'trimDuration'>, mediaDuration: number): {
+    start: number;
+    length: number;
+};
+/**
+ * Media time for a composition time. Returns a value inside the trim
+ * window (wrapping when looping, clamping otherwise).
+ */
+export declare function mapToMediaTime(compositionTime: number, timing: MediaTiming, mediaDuration: number): number;
+/** Coerce a schema time_remap value (keyframe array or absent). */
+export declare function timeRemapOf(value: unknown): Keyframe[] | null;
+/** Coerce a schema playback_rate value (static number only). */
+export declare function rateOf(value: unknown): number;
+/** Coerce a schema trim_duration value. */
+export declare function trimDurationOf(value: unknown): number | null;
+//# sourceMappingURL=media-time.d.ts.map

package/dist/assets/media-time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-time.d.ts","sourceRoot":"","sources":["../../src/assets/media-time.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAGlD,MAAM,WAAW,WAAW;IAC1B,4DAA4D;IAC5D,YAAY,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,0EAA0E;IAC1E,SAAS,CAAC,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;CAC/B;AAED,mEAAmE;AACnE,wBAAgB,UAAU,CACxB,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,WAAW,GAAG,cAAc,CAAC,EACvD,aAAa,EAAE,MAAM,GACpB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAQnC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,WAAW,EACnB,aAAa,EAAE,MAAM,GACpB,MAAM,CAYR;AAED,mEAAmE;AACnE,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,EAAE,GAAG,IAAI,CAE7D;AAED,gEAAgE;AAChE,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAG7C;AAED,2CAA2C;AAC3C,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAG5D"}

package/dist/assets/media-time.js

@@ -0,0 +1,65 @@
+// Composition-time → media-time mapping for video (and video-audio)
+// elements. ONE implementation shared by:
+//   - runtime.prepareVideoFrames (WebCodecs decode path)
+//   - runtime.renderAsync (element-backed export seeks)
+//   - the playback engine's fallback <video> pump
+//   - the audio scheduler / offline mixer (video audio tracks)
+//
+// Semantics:
+//   - `trim_start` offsets into the media.
+//   - `trim_duration` caps the playable media window (clamped to what
+//     the media actually has after trim_start).
+//   - `playback_rate` multiplies media consumption per timeline second.
+//     Static number only — keyframed rates would make this an integral.
+//   - `loop` wraps WITHIN the trim window; otherwise the last frame
+//     holds (clamp just inside the window's end).
+//   - `time_remap` (§5.3.2), when present, REPLACES all of the above:
+//     the keyframe curve maps element-local time directly to media
+//     time (clamped to the media), making speed ramps, freeze frames,
+//     and reverse playback plain data.
+import { interpolateKeyframes } from '../animation/keyframes.js';
+/** The playable media window [start, start+length] after trims. */
+export function trimWindow(timing, mediaDuration) {
+    const start = Math.max(0, timing.trimStart);
+    const available = Math.max(0, mediaDuration - start);
+    const length = timing.trimDuration != null
+        ? Math.max(0, Math.min(timing.trimDuration, available))
+        : available;
+    return { start, length };
+}
+/**
+ * Media time for a composition time. Returns a value inside the trim
+ * window (wrapping when looping, clamping otherwise).
+ */
+export function mapToMediaTime(compositionTime, timing, mediaDuration) {
+    // time_remap replaces the trim/rate/loop mapping entirely (§5.3.2).
+    if (timing.timeRemap && timing.timeRemap.length > 0) {
+        const local = Math.max(0, compositionTime - timing.elementStart);
+        const t = interpolateKeyframes(timing.timeRemap, local);
+        return Math.max(0, Math.min(t, Math.max(0, mediaDuration - 1e-4)));
+    }
+    const { start, length } = trimWindow(timing, mediaDuration);
+    if (length <= 0)
+        return start;
+    const consumed = Math.max(0, compositionTime - timing.elementStart) * timing.rate;
+    if (timing.loop)
+        return start + (consumed % length);
+    return start + Math.min(consumed, length - 1e-4);
+}
+/** Coerce a schema time_remap value (keyframe array or absent). */
+export function timeRemapOf(value) {
+    return Array.isArray(value) && value.length > 0 ? value : null;
+}
+/** Coerce a schema playback_rate value (static number only). */
+export function rateOf(value) {
+    if (typeof value === 'number' && Number.isFinite(value) && value > 0)
+        return value;
+    return 1;
+}
+/** Coerce a schema trim_duration value. */
+export function trimDurationOf(value) {
+    if (typeof value === 'number' && Number.isFinite(value) && value >= 0)
+        return value;
+    return null;
+}
+//# sourceMappingURL=media-time.js.map

package/dist/assets/media-time.js.map

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

package/dist/assets/mp4-frame-source.d.ts

@@ -0,0 +1,44 @@
+export declare class Mp4FrameSource {
+    #private;
+    readonly width: number;
+    readonly height: number;
+    /** Media duration in seconds. */
+    readonly duration: number;
+    /** Samples in decode order, with composition times. */
+    private samples;
+    /** Indices of keyframes within `samples`, ascending. */
+    private keyIndices;
+    /** Decoder-output timestamp → sample index (composition order lookup). */
+    private tsToIndex;
+    private config;
+    private decoder;
+    /** Next sample index (decode order) to feed the decoder. */
+    private nextFeedIndex;
+    /** True after an end-of-stream flush — next decode needs a reset. */
+    private flushed;
+    /** Decoded frames, keyed by sample index. Evicted + closed as the window moves. */
+    private cache;
+    /** Cache window [lo, hi] — outputs outside it are closed on arrival. */
+    private windowLo;
+    private windowHi;
+    /** Previous request's target — direction detection for the window shape. */
+    private lastTarget;
+    /** Pending getFrame waiters, keyed by sample index. */
+    private waiters;
+    /** Serializes getFrame calls. */
+    private opChain;
+    private disposed;
+    static isSupported(): boolean;
+    private constructor();
+    /** Fetch + demux + verify the codec is decodable. Throws on any failure. */
+    static load(url: string): Promise<Mp4FrameSource>;
+    /**
+     * The decoded frame covering media time `t` (seconds). The RETURNED
+     * FRAME IS OWNED BY THE SOURCE — upload it, don't close it; it's
+     * closed when the cache window moves past it. Returns null after
+     * dispose or on decode failure.
+     */
+    getFrame(t: number): Promise<VideoFrame | null>;
+    dispose(): void;
+}
+//# sourceMappingURL=mp4-frame-source.d.ts.map

package/dist/assets/mp4-frame-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mp4-frame-source.d.ts","sourceRoot":"","sources":["../../src/assets/mp4-frame-source.ts"],"names":[],"mappings":"AA0DA,qBAAa,cAAc;;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,iCAAiC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,uDAAuD;IACvD,OAAO,CAAC,OAAO,CAAc;IAC7B,wDAAwD;IACxD,OAAO,CAAC,UAAU,CAAW;IAC7B,0EAA0E;IAC1E,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,MAAM,CAAqB;IAEnC,OAAO,CAAC,OAAO,CAA6B;IAC5C,4DAA4D;IAC5D,OAAO,CAAC,aAAa,CAA4B;IACjD,qEAAqE;IACrE,OAAO,CAAC,OAAO,CAAS;IACxB,mFAAmF;IACnF,OAAO,CAAC,KAAK,CAAiC;IAC9C,wEAAwE;IACxE,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,QAAQ,CAA4B;IAC5C,4EAA4E;IAC5E,OAAO,CAAC,UAAU,CAAM;IACxB,uDAAuD;IACvD,OAAO,CAAC,OAAO,CAA4D;IAC3E,iCAAiC;IACjC,OAAO,CAAC,OAAO,CAAuC;IACtD,OAAO,CAAC,QAAQ,CAAS;IAEzB,MAAM,CAAC,WAAW,IAAI,OAAO;IAI7B,OAAO;IAwBP,4EAA4E;WAC/D,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAoFvD;;;;;OAKG;IACH,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAkL/C,OAAO,IAAI,IAAI;CAShB"}