@clipkit/playback 1.0.0

package/dist/worker.js

@@ -0,0 +1,336 @@
+// Frame-producer worker.
+//
+// Runs ClipkitRuntime against an internally-owned OffscreenCanvas.
+// Listens for protocol messages from the engine on the main thread,
+// produces VideoFrames, and transfers them back via postMessage's
+// transfer list (zero-copy).
+//
+// The worker is intentionally simple — no scheduling, no buffer logic,
+// no cancellation tracking. It's a pure "produce a frame at this time"
+// RPC service. All timing intelligence lives in the engine; stale-frame
+// filtering lives in the engine. See worker-protocol.ts.
+//
+// ─── WebGPU/WebGL2 best practices ───────────────────────────────────
+// - OffscreenCanvas is created here, never transferred in (the spec
+//   compliant way to run WebGPU/WebGL2 in a worker)
+// - VideoFrame is the cross-thread primitive; transfer list is zero-copy
+// - Backend negotiation (WebGPU → WebGL2 fallback) runs inside this
+//   worker, not on the main thread
+// - Device-loss handling: punted to Phase 5 (engine wiring) — needs
+//   coordination with the engine to re-init silently
+// - Visibility-aware production: punted to Phase 5 — the engine pauses
+//   produce calls when the document is hidden; the worker doesn't need
+//   to know
+import { ClipkitRuntime } from '@clipkit/runtime';
+let runtime = null;
+let canvas = null;
+let disposed = false;
+/**
+ * EMA of one blur sample's TRUE render cost in ms — drives the
+ * adaptive sample count for live-playback motion blur. CPU submit
+ * times lie (the GPU pipelines the work and a heavy scene can cost
+ * 20× what the submit suggests), so this is fed by periodic measured
+ * frames that drain the GPU via runtime.gpuFinish(). Seeded
+ * pessimistically; corrects within one measured frame.
+ */
+let liveSampleCostMs = 4;
+/** Blurred frames produced since the last true-cost measurement. */
+let blurFramesSinceMeasure = Infinity; // ∞ → measure the very first one
+/** Per-frame render budget for live blur (ms) — ~realtime at 30fps with headroom. */
+const LIVE_BLUR_BUDGET_MS = 22;
+/** Drain the pipeline and re-measure true cost every N blurred frames. */
+const BLUR_MEASURE_INTERVAL = 10;
+/**
+ * The source currently loaded into the runtime. Held so we can apply
+ * incremental patches (via `patchElements`) without round-tripping the
+ * whole source on every drag tick.
+ */
+let currentSource = null;
+function send(message, transfer = []) {
+    self.postMessage(message, transfer);
+}
+function sendError(err) {
+    const message = err instanceof Error ? `${err.name}: ${err.message}` : String(err);
+    send({ type: 'error', message });
+}
+async function handleInit(source, backend) {
+    const width = source.width ?? 1920;
+    const height = source.height ?? 1080;
+    canvas = new OffscreenCanvas(width, height);
+    runtime = new ClipkitRuntime(canvas);
+    const ok = await runtime.init({ backend });
+    if (!ok) {
+        send({
+            type: 'error',
+            message: `Runtime init failed for backend="${backend}". WebGPU and WebGL2 both unavailable in this worker.`,
+        });
+        runtime = null;
+        canvas = null;
+        return;
+    }
+    const api = runtime.api;
+    if (!api) {
+        send({ type: 'error', message: 'Runtime init reported success but api is null.' });
+        return;
+    }
+    currentSource = source;
+    runtime.load(source);
+    await runtime.preload();
+    reportVideoFallbacks(source);
+    send({
+        type: 'ready',
+        activeApi: api,
+        width,
+        height,
+        timeOrigin: performance.timeOrigin,
+    });
+}
+/**
+ * Tell the engine which video URLs the runtime could NOT self-decode
+ * (WebCodecs path failed) so it can pump frames from the main thread
+ * for just those. Empty list = all videos decode in-worker.
+ */
+function reportVideoFallbacks(source) {
+    if (!runtime)
+        return;
+    const urls = new Set();
+    collectVideoUrls(source.elements, urls);
+    const fallbacks = [];
+    for (const url of urls) {
+        if (!runtime.hasVideoAsset(url))
+            fallbacks.push(url);
+    }
+    send({ type: 'videoFallback', urls: fallbacks });
+}
+function collectVideoUrls(elements, out) {
+    for (const el of elements) {
+        if (el.type === 'video' && typeof el.source === 'string' && el.source) {
+            out.add(el.source);
+        }
+        else if (el.type === 'group') {
+            collectVideoUrls(el.elements, out);
+        }
+    }
+}
+async function handleSetSource(source) {
+    if (!runtime || !canvas)
+        return;
+    const w = source.width ?? canvas.width;
+    const h = source.height ?? canvas.height;
+    if (canvas.width !== w || canvas.height !== h) {
+        canvas.width = w;
+        canvas.height = h;
+    }
+    currentSource = source;
+    runtime.load(source);
+    await runtime.preload();
+    reportVideoFallbacks(source);
+}
+/**
+ * Apply patches to the current source in place, then re-load (without
+ * preload — assets unchanged). Skips the costly preload step that
+ * full setSource does. Used for live drag/resize dispatches.
+ */
+function handlePatchElements(patches) {
+    if (!runtime || !canvas || !currentSource)
+        return;
+    for (const { id, patch } of patches) {
+        const el = findById(currentSource.elements, id);
+        if (el)
+            Object.assign(el, patch);
+    }
+    runtime.load(currentSource);
+}
+function findById(elements, id) {
+    for (const el of elements) {
+        if (el.id === id)
+            return el;
+        if (el.type === 'group') {
+            const nested = findById(el.elements, id);
+            if (nested)
+                return nested;
+        }
+    }
+    return null;
+}
+async function handleProduce(time, sequenceId, quality) {
+    if (!runtime || !canvas)
+        return;
+    // Measure each sub-step so the main-thread HUD can show where the
+    // budget goes. `performance.mark` calls are wrapped in try/catch
+    // because not all browsers accept the `detail` argument; the
+    // numeric timings (sent in the frame message) work everywhere.
+    const t0 = performance.now();
+    try {
+        performance.mark('ck.worker.frame.start', { detail: { time } });
+    }
+    catch {
+        /* noop */
+    }
+    // Decode + upload the exact video frames this composition time needs
+    // (WebCodecs path). No-op for sources without frameSource-backed
+    // videos. Produce calls are serialized via produceChain below, so an
+    // await here can't interleave uploads between two frames.
+    await runtime.prepareVideoFrames(time);
+    const tPrep = performance.now();
+    let blurSamplesUsed = 0;
+    const mb = currentSource?.motion_blur;
+    const mbSamples = mb
+        ? Math.max(1, Math.min(32, Math.round(typeof mb.samples === 'number' ? mb.samples : 8)))
+        : 1;
+    if (quality === 'final') {
+        // Export-accurate frame: full supersampling. Falls back to a plain
+        // frame when the source has no motion_blur.
+        runtime.renderFinalFrame(time);
+    }
+    else if (mbSamples > 1) {
+        // Live playback: blurred with as many samples as the frame budget
+        // affords on this machine, so the effect the export will have is
+        // visible while playing — lighter on heavy scenes / slow hardware,
+        // near-full elsewhere, never at the cost of realtime.
+        const affordable = Math.max(2, Math.min(mbSamples, Math.floor(LIVE_BLUR_BUDGET_MS / Math.max(0.25, liveSampleCostMs))));
+        blurSamplesUsed = affordable;
+        if (blurFramesSinceMeasure >= BLUR_MEASURE_INTERVAL) {
+            // Measured frame: drain the GPU so the timing covers the real
+            // shader cost, not just the CPU submit. ~2/sec — the drain stall
+            // is the price of a budget that tracks scene weight (fractal
+            // noise ×16 samples saturated the GPU while submit times looked
+            // idle).
+            const t = performance.now();
+            runtime.renderFinalFrame(time, affordable);
+            await runtime.gpuFinish();
+            const costPerSample = (performance.now() - t) / affordable;
+            liveSampleCostMs = liveSampleCostMs * 0.5 + costPerSample * 0.5;
+            blurFramesSinceMeasure = 0;
+        }
+        else {
+            runtime.renderFinalFrame(time, affordable);
+            blurFramesSinceMeasure += 1;
+        }
+    }
+    else {
+        runtime.frame(time);
+    }
+    const t1 = performance.now();
+    try {
+        performance.mark('ck.worker.frame.end', { detail: { time } });
+        performance.mark('ck.worker.videoframe.start', { detail: { time } });
+    }
+    catch {
+        /* noop */
+    }
+    // Construct a VideoFrame from the OffscreenCanvas's current pixels.
+    // `timestamp` is in microseconds per the spec; we encode composition
+    // time so consumers can match frames to playhead positions.
+    const frame = new VideoFrame(canvas, {
+        timestamp: Math.round(time * 1_000_000),
+    });
+    const t2 = performance.now();
+    try {
+        performance.mark('ck.worker.videoframe.end', { detail: { time } });
+    }
+    catch {
+        /* noop */
+    }
+    const sentAt = performance.now();
+    send({
+        type: 'frame',
+        time,
+        sequenceId,
+        frame,
+        timings: {
+            frameMs: t1 - tPrep,
+            prepareMs: tPrep - t0,
+            blurSamples: blurSamplesUsed,
+            videoFrameMs: t2 - t1,
+            workerTotalMs: performance.now() - t0,
+            sentAt,
+        },
+    }, [frame]);
+}
+/**
+ * One export-quality still → ImageBitmap. Runs behind produceChain
+ * (the caller chains it) so video-frame uploads never interleave.
+ */
+async function handleStill(time, requestId, width) {
+    if (!runtime || !canvas) {
+        send({ type: 'stillError', requestId, message: 'worker not initialized' });
+        return;
+    }
+    try {
+        await runtime.prepareVideoFrames(time);
+        // Export-accurate: full motion-blur supersampling when configured.
+        runtime.renderFinalFrame(time);
+        const opts = {};
+        if (width && width > 0 && width < canvas.width) {
+            opts.resizeWidth = Math.round(width);
+            opts.resizeHeight = Math.round((canvas.height / canvas.width) * width);
+            opts.resizeQuality = 'high';
+        }
+        const bitmap = await createImageBitmap(canvas, opts);
+        send({ type: 'stillResult', requestId, time, bitmap }, [bitmap]);
+    }
+    catch (err) {
+        send({
+            type: 'stillError',
+            requestId,
+            message: err instanceof Error ? `${err.name}: ${err.message}` : String(err),
+        });
+    }
+}
+function handleDispose() {
+    if (disposed)
+        return;
+    disposed = true;
+    runtime?.dispose();
+    runtime = null;
+    canvas = null;
+    currentSource = null;
+}
+/**
+ * Serializes produce work. handleProduce awaits video decode, and
+ * `self.onmessage` fires per message regardless of pending awaits — two
+ * unserialized produces would interleave texture uploads and render
+ * frame A with frame B's video pixels.
+ */
+let produceChain = Promise.resolve();
+self.onmessage = async (event) => {
+    if (disposed)
+        return;
+    const msg = event.data;
+    try {
+        switch (msg.type) {
+            case 'init':
+                await handleInit(msg.source, msg.backend);
+                return;
+            case 'setSource':
+                await handleSetSource(msg.source);
+                return;
+            case 'patchElements':
+                handlePatchElements(msg.patches);
+                return;
+            case 'produce':
+                produceChain = produceChain
+                    .then(() => handleProduce(msg.time, msg.sequenceId, msg.quality))
+                    .catch(sendError);
+                return;
+            case 'still':
+                produceChain = produceChain
+                    .then(() => handleStill(msg.time, msg.requestId, msg.width))
+                    .catch(sendError);
+                return;
+            case 'videoFrame':
+                // Main-thread pump fallback (non-MP4 / no WebCodecs): upload
+                // into the texture the video renderer samples.
+                runtime?.pushExternalVideoFrame(msg.url, msg.bitmap);
+                return;
+            case 'dispose':
+                handleDispose();
+                return;
+        }
+    }
+    catch (err) {
+        sendError(err);
+    }
+};
+//# sourceMappingURL=worker.js.map

package/dist/worker.js.map

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

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@clipkit/playback",
+  "version": "1.0.0",
+  "description": "Clipkit playback engine — TransportClock, worker-based renderer, frame ring buffer, and WebAudio scheduling. Drives the playground, the editor SDK preview, and any embedded Clipkit player.",
+  "license": "Apache-2.0",
+  "repository": { "type": "git", "url": "git+https://github.com/clipkit-video/clipkit.git", "directory": "packages/playback" },
+  "homepage": "https://clipkit.dev",
+  "bugs": "https://github.com/clipkit-video/clipkit/issues",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@clipkit/runtime": "^1.0.0",
+    "@clipkit/protocol": "^1.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.3"
+  }
+}