@clipkit/renderer 1.0.0

package/dist/harness/embedded.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedded.js","sourceRoot":"","sources":["../../src/harness/embedded.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,iEAAiE;AAEjE,MAAM,CAAC,MAAM,UAAU,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA29DzB,CAAC"}

package/dist/harness/harness.d.ts

@@ -0,0 +1,23 @@
+import { type RenderResolution } from '@clipkit/runtime';
+import type { Source } from '@clipkit/protocol';
+interface HarnessOptions {
+    backend?: 'auto' | 'webgpu' | 'webgl2';
+    resolution?: RenderResolution;
+    bitrate?: number;
+}
+interface StillOptions {
+    time?: number;
+    backend?: 'auto' | 'webgpu' | 'webgl2';
+}
+declare global {
+    interface Window {
+        __clipkitReportProgress?: (frame: number, total: number) => Promise<void>;
+        __clipkitReportError?: (message: string) => Promise<void>;
+        __clipkitReportResult?: (base64Mp4: string) => Promise<void>;
+        __clipkitStillReady?: () => Promise<void>;
+        runHarness: (source: Source, options?: HarnessOptions) => Promise<void>;
+        renderStill: (source: Source, options?: StillOptions) => Promise<void>;
+    }
+}
+export {};
+//# sourceMappingURL=harness.d.ts.map

package/dist/harness/harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../../src/harness/harness.ts"],"names":[],"mappings":"AAeA,OAAO,EAAkB,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,UAAU,cAAc;IACtB,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACvC,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,YAAY;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;CACxC;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,uBAAuB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QAC1E,oBAAoB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QAC1D,qBAAqB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7D,mBAAmB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QAC1C,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QACxE,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KACxE;CACF"}

package/dist/harness/harness.js

@@ -0,0 +1,93 @@
+// Browser-side harness — runs inside the headless Chrome that Playwright
+// drives. Bundled into a single self-contained script at build time
+// (scripts/build-harness.mjs) and embedded as a string in ./embedded.ts,
+// which the renderer injects into the page via addScriptTag.
+//
+// It talks to Node through Playwright-exposed functions (wired in ../render.ts
+// and ../still.ts):
+//   __clipkitReportProgress(frame, total) — optional, per-frame
+//   __clipkitReportError(message)         — fatal
+//   __clipkitReportResult(base64Mp4)      — runHarness success
+//   __clipkitStillReady()                 — renderStill: canvas is ready to screenshot
+//
+// All it does is instantiate @clipkit/runtime and render the Source. The engine
+// is the runtime; this is glue.
+import { ClipkitRuntime } from '@clipkit/runtime';
+// Render the full composition to an MP4 via the runtime's WebCodecs exporter.
+window.runHarness = async function runHarness(source, options = {}) {
+    try {
+        const width = source.width ?? 1920;
+        const height = source.height ?? 1080;
+        const canvas = document.createElement('canvas');
+        canvas.width = width;
+        canvas.height = height;
+        canvas.style.cssText = 'position:fixed; top:0; left:0;';
+        document.body.appendChild(canvas);
+        const runtime = new ClipkitRuntime(canvas);
+        const ok = await runtime.init({ backend: options.backend ?? 'auto' });
+        if (!ok) {
+            throw new Error(`runtime.init() failed (backend preference: ${options.backend ?? 'auto'}). ` +
+                `Try forcing backend 'webgl2'.`);
+        }
+        runtime.load(source);
+        await runtime.preload();
+        const fps = source.frame_rate ?? 30;
+        const duration = typeof source.duration === 'number' ? source.duration : 10;
+        const totalFrames = Math.max(1, Math.ceil(duration * fps));
+        const blob = await runtime.export({
+            framerate: fps,
+            renderResolution: options.resolution,
+            ...(options.bitrate ? { bitrate: options.bitrate } : {}),
+            onProgress: (progress01) => {
+                const frame = Math.round(progress01 * totalFrames);
+                window.__clipkitReportProgress?.(frame, totalFrames).catch(() => { });
+            },
+        });
+        const base64 = arrayBufferToBase64(await blob.arrayBuffer());
+        await window.__clipkitReportResult?.(base64);
+    }
+    catch (err) {
+        const message = err instanceof Error ? (err.stack ?? err.message) : String(err);
+        await window.__clipkitReportError?.(message);
+    }
+};
+// Render one frame at `time` and leave it on a full-size canvas, then signal
+// readiness so Node can screenshot it (works regardless of preserveDrawingBuffer).
+window.renderStill = async function renderStill(source, options = {}) {
+    try {
+        const width = source.width ?? 1920;
+        const height = source.height ?? 1080;
+        const canvas = document.createElement('canvas');
+        canvas.id = '__clipkit_still';
+        canvas.width = width;
+        canvas.height = height;
+        canvas.style.cssText = `position:fixed; top:0; left:0; width:${width}px; height:${height}px;`;
+        document.body.appendChild(canvas);
+        const runtime = new ClipkitRuntime(canvas);
+        const ok = await runtime.init({ backend: options.backend ?? 'auto' });
+        if (!ok) {
+            throw new Error(`runtime.init() failed (backend preference: ${options.backend ?? 'auto'}).`);
+        }
+        runtime.load(source);
+        await runtime.preload();
+        await runtime.renderAsync(source, options.time ?? 0);
+        await runtime.gpuFinish();
+        await window.__clipkitStillReady?.();
+    }
+    catch (err) {
+        const message = err instanceof Error ? (err.stack ?? err.message) : String(err);
+        await window.__clipkitReportError?.(message);
+    }
+};
+// btoa overflows on multi-MB buffers; chunk it.
+function arrayBufferToBase64(buffer) {
+    const bytes = new Uint8Array(buffer);
+    const CHUNK = 0x8000; // 32 KB
+    let out = '';
+    for (let i = 0; i < bytes.length; i += CHUNK) {
+        const chunk = bytes.subarray(i, Math.min(i + CHUNK, bytes.length));
+        out += String.fromCharCode.apply(null, Array.from(chunk));
+    }
+    return btoa(out);
+}
+//# sourceMappingURL=harness.js.map

package/dist/harness/harness.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { render } from './render.js';
+export { renderStill } from './still.js';
+export type { RenderOptions, RenderResult, RenderResolution } from './types.js';
+export type { StillOptions } from './still.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAChF,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { render } from './render.js';
+export { renderStill } from './still.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/render.d.ts

@@ -0,0 +1,14 @@
+import type { RenderOptions, RenderResult } from './types.js';
+/**
+ * Render a ClipKit `Source` to an MP4 buffer using local headless Chrome.
+ *
+ * Requires Google Chrome (or Chromium) installed on the machine.
+ *
+ * ```ts
+ * import { render } from '@clipkit/renderer';
+ * const { buffer } = await render({ source });
+ * await writeFile('out.mp4', buffer);
+ * ```
+ */
+export declare function render(options: RenderOptions): Promise<RenderResult>;
+//# sourceMappingURL=render.d.ts.map

package/dist/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AA6B9D;;;;;;;;;;GAUG;AACH,wBAAsB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CA8G1E"}

package/dist/render.js

@@ -0,0 +1,148 @@
+// @clipkit/renderer — render a ClipKit Source to MP4 on your own machine.
+//
+// Drives Playwright + a bundled in-page harness: launches headless Chrome,
+// loads @clipkit/runtime, renders the composition, and returns the runtime's
+// own WebCodecs MP4. No server, no ffmpeg, no GPU-container recipe — just
+// JSON → MP4, locally. (The hosted/cloud rendering pipeline is separate.)
+import { createServer } from 'node:http';
+import { chromium } from 'playwright';
+import { HARNESS_JS } from './harness/embedded.js';
+const DEFAULT_TIMEOUT_MS = 5 * 60 * 1000; // 5 minutes
+const HARNESS_HTML = `<!doctype html><html><body></body></html>`;
+// WebCodecs' VideoEncoder (used by the runtime's MP4 exporter) is gated to
+// secure contexts. about:blank isn't one; http://127.0.0.1 is. So we serve the
+// harness page from a throwaway localhost server for the render's lifetime.
+async function startHarnessServer() {
+    const server = createServer((_req, res) => {
+        res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+        res.end(HARNESS_HTML);
+    });
+    await new Promise((resolve) => server.listen(0, '127.0.0.1', resolve));
+    const port = server.address().port;
+    return {
+        url: `http://127.0.0.1:${port}/`,
+        close: () => new Promise((resolve) => server.close(() => resolve())),
+    };
+}
+// On GPU-less Linux / CI, pin ANGLE's SwiftShader software path so WebGL2 works
+// headless. On macOS / Windows, plain headless uses the system GPU. We always
+// use *system* Chrome (channel: 'chrome') because Playwright's bundled chromium
+// is the headless_shell variant and ships without WebCodecs.
+const ON_LINUX = process.platform === 'linux';
+const SOFTWARE_GL = ['--enable-unsafe-webgpu', '--use-angle=swiftshader'];
+const BASE_FLAGS = ['--no-sandbox', '--disable-dev-shm-usage'];
+/**
+ * Render a ClipKit `Source` to an MP4 buffer using local headless Chrome.
+ *
+ * Requires Google Chrome (or Chromium) installed on the machine.
+ *
+ * ```ts
+ * import { render } from '@clipkit/renderer';
+ * const { buffer } = await render({ source });
+ * await writeFile('out.mp4', buffer);
+ * ```
+ */
+export async function render(options) {
+    const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const width = options.source.width ?? 1920;
+    const height = options.source.height ?? 1080;
+    const launchOpts = ON_LINUX
+        ? {
+            // New-headless is the full browser (needed for WebCodecs); pass it
+            // explicitly with headless:false so Playwright doesn't add legacy --headless.
+            headless: false,
+            args: options.showBrowser
+                ? [...SOFTWARE_GL, ...BASE_FLAGS]
+                : [...SOFTWARE_GL, ...BASE_FLAGS, '--headless=new'],
+            channel: 'chrome',
+        }
+        : {
+            headless: !options.showBrowser,
+            args: BASE_FLAGS,
+            channel: 'chrome',
+        };
+    let browser = null;
+    let harnessServer = null;
+    try {
+        harnessServer = await startHarnessServer();
+        browser = await chromium.launch(launchOpts);
+        const context = await browser.newContext({ viewport: { width, height } });
+        const page = await context.newPage();
+        if (options.onLog) {
+            page.on('console', (m) => options.onLog(`[page:${m.type()}] ${m.text()}`));
+        }
+        let resolveResult;
+        let rejectResult;
+        const resultPromise = new Promise((resolve, reject) => {
+            resolveResult = resolve;
+            rejectResult = reject;
+        });
+        await page.exposeFunction('__clipkitReportProgress', (frame, total) => {
+            options.onProgress?.(frame, total);
+        });
+        await page.exposeFunction('__clipkitReportError', (message) => {
+            rejectResult(new Error(`render harness error:\n${message}`));
+        });
+        await page.exposeFunction('__clipkitReportResult', (base64Mp4) => {
+            try {
+                resolveResult(Buffer.from(base64Mp4, 'base64'));
+            }
+            catch (err) {
+                rejectResult(err instanceof Error ? err : new Error(String(err)));
+            }
+        });
+        page.on('pageerror', (err) => rejectResult(new Error(`page error: ${err.message}`)));
+        page.on('crash', () => rejectResult(new Error('chromium tab crashed during render')));
+        // localhost = secure context, so WebCodecs is available.
+        await page.goto(harnessServer.url, { waitUntil: 'domcontentloaded' });
+        await page.addScriptTag({ content: HARNESS_JS });
+        page
+            .evaluate(([sourceJson, backend, resolution, bitrate]) => {
+            const src = JSON.parse(sourceJson);
+            const w = window;
+            const opts = { backend };
+            if (resolution)
+                opts.resolution = resolution;
+            if (bitrate)
+                opts.bitrate = bitrate;
+            return w.runHarness(src, opts);
+        }, [
+            JSON.stringify(options.source),
+            options.backend ?? 'auto',
+            options.resolution ?? '',
+            options.bitrate ?? 0,
+        ])
+            .catch((err) => {
+            // Browser close during a long render races with page.evaluate; the real
+            // error is already on resultPromise. Swallow the cascade.
+            void err;
+        });
+        let timer;
+        const timeoutPromise = new Promise((_, reject) => {
+            timer = setTimeout(() => reject(new Error(`render timed out after ${timeoutMs} ms`)), timeoutMs);
+        });
+        try {
+            const buffer = await Promise.race([resultPromise, timeoutPromise]);
+            return {
+                buffer,
+                ext: 'mp4',
+                mime: 'video/mp4',
+                width,
+                height,
+                durationSec: typeof options.source.duration === 'number' ? options.source.duration : 0,
+                frameRate: options.source.frame_rate ?? 30,
+            };
+        }
+        finally {
+            if (timer)
+                clearTimeout(timer);
+        }
+    }
+    finally {
+        if (browser)
+            await browser.close().catch(() => { });
+        if (harnessServer)
+            await harnessServer.close().catch(() => { });
+    }
+}
+//# sourceMappingURL=render.js.map

package/dist/render.js.map

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

package/dist/still.d.ts

@@ -0,0 +1,21 @@
+import type { Source } from '@clipkit/protocol';
+export interface StillOptions {
+    /** The Source to render. */
+    source: Source;
+    /** Composition time in seconds to capture. Default 0. */
+    time?: number;
+    /** Runtime backend preference. Default 'auto'. */
+    backend?: 'auto' | 'webgpu' | 'webgl2';
+    /**
+     * Directory served at the harness origin's root, so the Source can reference
+     * sidecar assets (e.g. local fonts) by absolute path. Path traversal 404s.
+     */
+    staticRoot?: string;
+    /** Hard timeout in milliseconds. Default 60s. */
+    timeoutMs?: number;
+    /** Show the Chrome window instead of headless (debugging). */
+    showBrowser?: boolean;
+}
+/** Render one frame of `source` at `time` seconds; resolves to PNG bytes. */
+export declare function renderStill(options: StillOptions): Promise<Buffer>;
+//# sourceMappingURL=still.d.ts.map

package/dist/still.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"still.d.ts","sourceRoot":"","sources":["../src/still.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAwBhD,MAAM,WAAW,YAAY;IAC3B,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACvC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAiCD,6EAA6E;AAC7E,wBAAsB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAwExE"}

package/dist/still.js

@@ -0,0 +1,119 @@
+// Single-frame render — returns a PNG Buffer of the composition at one time.
+// Uses a Playwright element screenshot of the harness canvas (no WebCodecs, so
+// it works regardless of preserveDrawingBuffer).
+import { createServer } from 'node:http';
+import { createReadStream, existsSync, statSync } from 'node:fs';
+import { extname, join, normalize, resolve, sep } from 'node:path';
+import { chromium } from 'playwright';
+import { HARNESS_JS } from './harness/embedded.js';
+const DEFAULT_TIMEOUT_MS = 60 * 1000;
+const HARNESS_HTML = `<!doctype html><html><body></body></html>`;
+const ON_LINUX = process.platform === 'linux';
+const SOFTWARE_GL = ['--enable-unsafe-webgpu', '--use-angle=swiftshader'];
+const BASE_FLAGS = ['--no-sandbox', '--disable-dev-shm-usage'];
+const CHROMIUM_FLAGS = ON_LINUX ? [...SOFTWARE_GL, ...BASE_FLAGS] : BASE_FLAGS;
+const MIME = {
+    '.woff2': 'font/woff2',
+    '.woff': 'font/woff',
+    '.ttf': 'font/ttf',
+    '.otf': 'font/otf',
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.webp': 'image/webp',
+    '.svg': 'image/svg+xml',
+    '.json': 'application/json',
+};
+async function startStillServer(staticRoot) {
+    const root = staticRoot ? resolve(staticRoot) : null;
+    const server = createServer((req, res) => {
+        const urlPath = decodeURIComponent((req.url ?? '/').split('?')[0]);
+        if (urlPath === '/' || !root) {
+            res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+            res.end(HARNESS_HTML);
+            return;
+        }
+        const filePath = normalize(join(root, urlPath));
+        if (!filePath.startsWith(root + sep) || !existsSync(filePath) || !statSync(filePath).isFile()) {
+            res.writeHead(404);
+            res.end();
+            return;
+        }
+        res.writeHead(200, {
+            'Content-Type': MIME[extname(filePath).toLowerCase()] ?? 'application/octet-stream',
+            'Access-Control-Allow-Origin': '*',
+        });
+        createReadStream(filePath).pipe(res);
+    });
+    await new Promise((resolve) => server.listen(0, '127.0.0.1', resolve));
+    const port = server.address().port;
+    return {
+        url: `http://127.0.0.1:${port}/`,
+        close: () => new Promise((resolve) => server.close(() => resolve())),
+    };
+}
+/** Render one frame of `source` at `time` seconds; resolves to PNG bytes. */
+export async function renderStill(options) {
+    const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const launchOpts = {
+        headless: !options.showBrowser,
+        args: CHROMIUM_FLAGS,
+        channel: 'chrome',
+    };
+    let browser = null;
+    let server = null;
+    try {
+        server = await startStillServer(options.staticRoot);
+        browser = await chromium.launch(launchOpts);
+        const context = await browser.newContext({
+            viewport: {
+                width: options.source.width ?? 1920,
+                height: options.source.height ?? 1080,
+            },
+            deviceScaleFactor: 1,
+        });
+        const page = await context.newPage();
+        let resolveReady;
+        let rejectReady;
+        const readyPromise = new Promise((resolve, reject) => {
+            resolveReady = resolve;
+            rejectReady = reject;
+        });
+        await page.exposeFunction('__clipkitStillReady', () => resolveReady());
+        await page.exposeFunction('__clipkitReportError', (message) => {
+            rejectReady(new Error(`render harness error:\n${message}`));
+        });
+        page.on('pageerror', (err) => rejectReady(new Error(`page error: ${err.message}`)));
+        page.on('crash', () => rejectReady(new Error('chromium tab crashed during still render')));
+        await page.goto(server.url, { waitUntil: 'domcontentloaded' });
+        await page.addScriptTag({ content: HARNESS_JS });
+        page
+            .evaluate(([sourceJson, time, backend]) => {
+            const src = JSON.parse(sourceJson);
+            return window.renderStill(src, { time, backend });
+        }, [JSON.stringify(options.source), options.time ?? 0, options.backend ?? 'auto'])
+            .catch(() => {
+            // Errors surface via __clipkitReportError / pageerror; the evaluate
+            // rejection here is the browser-close race.
+        });
+        let timer;
+        const timeoutPromise = new Promise((_, reject) => {
+            timer = setTimeout(() => reject(new Error(`still render timed out after ${timeoutMs} ms`)), timeoutMs);
+        });
+        try {
+            await Promise.race([readyPromise, timeoutPromise]);
+        }
+        finally {
+            if (timer)
+                clearTimeout(timer);
+        }
+        return await page.locator('#__clipkit_still').screenshot({ type: 'png' });
+    }
+    finally {
+        if (browser)
+            await browser.close().catch(() => { });
+        if (server)
+            await server.close().catch(() => { });
+    }
+}
+//# sourceMappingURL=still.js.map

package/dist/still.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,40 @@
+import type { Source } from '@clipkit/protocol';
+export type RenderResolution = 'source' | '480p' | '720p' | '1080p' | '1440p' | '4k';
+export interface RenderOptions {
+    /** The ClipKit Source to render. */
+    source: Source;
+    /**
+     * Runtime backend. Default 'auto' lets the runtime negotiate
+     * WebGPU → WebGL2. Force 'webgl2' for the most portable software path.
+     */
+    backend?: 'auto' | 'webgpu' | 'webgl2';
+    /**
+     * Output resolution. Default 'source' (no scaling — matches the Source's
+     * dimensions). Named tiers anchor on height and keep the Source's aspect.
+     */
+    resolution?: RenderResolution;
+    /** Override the auto-selected video bitrate (bits/second). */
+    bitrate?: number;
+    /** Called per frame during encode. `frame` is the latest; `total` the expected count. */
+    onProgress?: (frame: number, total: number) => void;
+    /** Called with each in-page console line (debugging). */
+    onLog?: (line: string) => void;
+    /** Hard timeout in ms. The render fails if no result arrives in time. Default 5 min. */
+    timeoutMs?: number;
+    /** Show the Chrome window instead of running headless (debugging). */
+    showBrowser?: boolean;
+}
+export interface RenderResult {
+    /** Encoded MP4 (H.264) bytes. */
+    buffer: Buffer;
+    /** Output file extension — always 'mp4'. */
+    ext: 'mp4';
+    /** Content-type. */
+    mime: 'video/mp4';
+    /** Composition width / height / duration / fps (echoed from the Source). */
+    width: number;
+    height: number;
+    durationSec: number;
+    frameRate: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,IAAI,CAAC;AAErF,MAAM,WAAW,aAAa;IAC5B,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACvC;;;OAGG;IACH,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yFAAyF;IACzF,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACpD,yDAAyD;IACzD,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,wFAAwF;IACxF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,GAAG,EAAE,KAAK,CAAC;IACX,oBAAoB;IACpB,IAAI,EAAE,WAAW,CAAC;IAClB,4EAA4E;IAC5E,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/types.js

@@ -0,0 +1,3 @@
+// Public types for @clipkit/renderer.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,sCAAsC"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@clipkit/renderer",
+  "version": "1.0.0",
+  "description": "Render a ClipKit Source to MP4 locally — headless Chrome + WebCodecs, driven by Playwright. The Node-side renderer for @clipkit/runtime.",
+  "license": "Apache-2.0",
+  "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:harness": "node ./scripts/build-harness.mjs",
+    "prebuild": "npm run build:harness",
+    "predev": "npm run build:harness",
+    "pretypecheck": "npm run build:harness",
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist src/harness/embedded.ts"
+  },
+  "keywords": [
+    "clipkit",
+    "video",
+    "renderer",
+    "mp4",
+    "webcodecs",
+    "headless",
+    "playwright"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/clipkit-video/clipkit.git",
+    "directory": "packages/renderer"
+  },
+  "homepage": "https://clipkit.dev",
+  "bugs": "https://github.com/clipkit-video/clipkit/issues",
+  "dependencies": {
+    "@clipkit/protocol": "^1.0.0",
+    "@clipkit/runtime": "^1.0.0",
+    "playwright": "^1.49.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "esbuild": "^0.24.0",
+    "typescript": "^5.7.3"
+  }
+}