@clipkit/runtime 1.0.0

package/dist/encoder/exporter.js

@@ -0,0 +1,341 @@
+import { Muxer, ArrayBufferTarget } from "mp4-muxer";
+import { encodeAudioBuffer, pickAudioCodec } from "../audio/encoder.js";
+/**
+ * Heights for each named resolution tier. Source aspect ratio drives
+ * the width.
+ */
+const RESOLUTION_HEIGHTS = {
+    '480p': 480,
+    '720p': 720,
+    '1080p': 1080,
+    '1440p': 1440,
+    '4k': 2160,
+};
+/**
+ * Default video bitrates per resolution tier. Tuned for landing-page /
+ * UI motion graphics with lots of text — slightly conservative on the
+ * low end, generous at 4K where chroma sampling shows blockiness fast.
+ */
+const RESOLUTION_BITRATES = {
+    '480p': 1_500_000,
+    '720p': 4_000_000,
+    '1080p': 8_000_000,
+    '1440p': 16_000_000,
+    '4k': 35_000_000,
+};
+/**
+ * H.264 codec strings per resolution tier. The level field caps the
+ * pixel area the encoder will accept — Level 4.2 (default elsewhere)
+ * tops out at 1080p, so 1440p / 4K must move up to Level 5.1, which
+ * covers up to 4K30. High Profile (640) gives noticeably better
+ * compression than Baseline (420) at the same bitrate.
+ */
+const RESOLUTION_CODECS = {
+    '480p': 'avc1.42E01F', // Baseline @ Level 3.1 (covers 854×480)
+    '720p': 'avc1.42E01F', // Baseline @ Level 3.1
+    '1080p': 'avc1.42002A', // Baseline @ Level 4.2
+    '1440p': 'avc1.640033', // High @ Level 5.1
+    '4k': 'avc1.640033', // High @ Level 5.1
+};
+/**
+ * Encoder pacing + stall guards for the export path.
+ *
+ * BACKPRESSURE_LIMIT — max frames allowed in the VideoEncoder queue before the
+ * render loop pauses for it to drain. Bounds memory and stops frame submission
+ * from racing ahead of a slow (software) encoder.
+ *
+ * FLUSH_TIMEOUT_MS — ceiling on encoder.flush(). With backpressure the queue is
+ * tiny by the time we flush, so a flush that exceeds this is a genuine stall;
+ * we reject it so the failure is visible instead of an infinite "100%" hang.
+ */
+const BACKPRESSURE_LIMIT = 8;
+const FLUSH_TIMEOUT_MS = 120_000;
+/**
+ * Resolve a RenderResolution + Source dimensions into the concrete
+ * physical canvas size, pixel ratio, and a sensible default bitrate.
+ */
+export function resolveRenderResolution(resolution, sourceWidth, sourceHeight) {
+    if (resolution === 'source') {
+        // Pick a codec based on the source's actual height, not a fixed
+        // tier — a 4K source authored natively still needs Level 5.1.
+        const codec = sourceHeight > 1080 ? 'avc1.640033' : 'avc1.42002A';
+        return {
+            physicalWidth: sourceWidth,
+            physicalHeight: sourceHeight,
+            pixelRatio: 1,
+            defaultBitrate: 5_000_000,
+            defaultCodec: codec,
+        };
+    }
+    const targetHeight = RESOLUTION_HEIGHTS[resolution];
+    const pixelRatio = targetHeight / sourceHeight;
+    return {
+        physicalWidth: Math.round(sourceWidth * pixelRatio),
+        physicalHeight: targetHeight,
+        pixelRatio,
+        defaultBitrate: RESOLUTION_BITRATES[resolution],
+        defaultCodec: RESOLUTION_CODECS[resolution],
+    };
+}
+/**
+ * H.264 (and ffmpeg's yuv420p) require EVEN frame dimensions. A named
+ * resolution tier derives width from the source aspect ratio, which can land
+ * odd — e.g. a 16:9 source at 480p gives 1920×(480/1080) = 853. Floor each
+ * encode dimension to the nearest even pixel so every tier / aspect ratio
+ * encodes cleanly. Export-only: the live preview backend is never resized
+ * through this.
+ */
+function toEvenDimension(n) {
+    const floored = Math.max(2, Math.floor(n));
+    return floored % 2 === 0 ? floored : floored - 1;
+}
+export class ClipkitExporter {
+    canvas;
+    renderer;
+    encoder = null;
+    muxer = null;
+    tempCanvas;
+    tempCtx;
+    constructor(canvas, renderer) {
+        this.canvas = canvas;
+        this.renderer = renderer;
+        this.tempCanvas = document.createElement("canvas");
+        this.tempCtx = this.tempCanvas.getContext("2d");
+    }
+    async export(source, options = {}) {
+        const { codec = "avc1.42002A", // H.264 Baseline Profile Level 4.2 (supports 1080p)
+        bitrate = 5_000_000, framerate = source.frame_rate || 30, onProgress, } = options;
+        // Apply schema-aware defaults — Source dimensions are optional in the
+        // schema but mandatory for encoding.
+        const sourceWidth = source.width ?? 1920;
+        const sourceHeight = source.height ?? 1080;
+        const duration = typeof source.duration === "number" ? source.duration : 10;
+        // Output dimensions come from the runtime canvas — the runtime is
+        // expected to have resize()'d the backend to the right pixel ratio
+        // before calling export(). Falls back to source dims if not. Clamped to
+        // even (H.264 requires it) — the backend canvas may be odd at some tiers.
+        const width = toEvenDimension(this.canvas.width || sourceWidth);
+        const height = toEvenDimension(this.canvas.height || sourceHeight);
+        console.log("[clipkit] Starting export:", { codec, bitrate, framerate, sourceWidth, sourceHeight, width, height, duration, hasAudio: !!options.audio });
+        this.tempCanvas.width = width;
+        this.tempCanvas.height = height;
+        const totalFrames = Math.ceil(duration * framerate);
+        // Motion blur — exact sub-frame supersampling (PROTOCOL.md §3.x).
+        // N renders per output frame across a shutter window centered on the
+        // frame time, averaged per 8-bit channel in float (single rounding).
+        // samples=1 or no motion_blur block → the plain single-render path.
+        const mb = source.motion_blur;
+        const mbSamples = mb
+            ? Math.max(1, Math.min(32, Math.round(typeof mb.samples === "number" ? mb.samples : 8)))
+            : 1;
+        const mbShutter = mb && typeof mb.shutter === "number"
+            ? Math.min(1, Math.max(0, mb.shutter))
+            : 0.5;
+        const blurOn = mbSamples > 1 && mbShutter > 0;
+        const mbAccum = blurOn ? new Float32Array(width * height * 4) : null;
+        console.log("[clipkit] Encoding", totalFrames, "frames at", framerate, "fps", blurOn ? `(motion blur: ${mbSamples} samples, shutter ${mbShutter})` : "");
+        const target = new ArrayBufferTarget();
+        // Negotiate an audio codec this environment can actually encode. Chromium
+        // on Linux (the render container) has NO AAC encoder, so AAC throws
+        // "Unsupported codec type" mid-export; pickAudioCodec falls back to Opus
+        // there (MP4 muxes both). null → no audio encoder at all: render silently
+        // instead of crashing.
+        let audioPick = null;
+        if (options.audio) {
+            audioPick = await pickAudioCodec(options.audio.buffer.sampleRate, options.audio.buffer.numberOfChannels, options.audio.bitrate);
+            if (!audioPick) {
+                console.warn("[clipkit] No supported audio encoder — rendering without audio.");
+            }
+        }
+        const muxerConfig = {
+            target,
+            video: {
+                codec: "avc",
+                width,
+                height,
+            },
+            fastStart: "in-memory",
+        };
+        // Add the audio track only when we have a working encoder for it.
+        if (options.audio && audioPick) {
+            muxerConfig.audio = {
+                codec: audioPick.muxer,
+                sampleRate: options.audio.buffer.sampleRate,
+                numberOfChannels: options.audio.buffer.numberOfChannels,
+            };
+        }
+        this.muxer = new Muxer(muxerConfig);
+        // Encode audio first (it's fast — single pass over the pre-mixed buffer).
+        // Audio chunks reach the muxer before video chunks; mp4-muxer handles
+        // interleaving on finalize. Non-fatal: an audio failure must never sink the
+        // whole render — drop audio and keep the video.
+        if (options.audio && audioPick) {
+            console.log("[clipkit] Encoding audio:", {
+                codec: audioPick.muxer,
+                sampleRate: options.audio.buffer.sampleRate,
+                channels: options.audio.buffer.numberOfChannels,
+                duration: options.audio.buffer.duration.toFixed(2) + "s",
+            });
+            try {
+                await encodeAudioBuffer(options.audio.buffer, this.muxer, {
+                    bitrate: options.audio.bitrate,
+                    codec: audioPick.encoder,
+                });
+                console.log("[clipkit] Audio encoded");
+            }
+            catch (e) {
+                console.warn("[clipkit] Audio encode failed — continuing without audio:", e instanceof Error ? e.message : String(e));
+            }
+        }
+        // Progress is driven from the encoder OUTPUT (frames actually encoded), not
+        // from submission. Submission races ahead of a slow software encoder — which
+        // is exactly why the bar used to hit 100% while flush() was still draining.
+        // Now 100% means every frame is truly encoded + muxed.
+        let encodedChunks = 0;
+        // Latch encoder faults. The WebCodecs error callback fires asynchronously and
+        // does not reliably reject the pending flush() across browsers, so we capture
+        // it and throw at the next checkpoint — turning a silent hang into a visible,
+        // catchable failure.
+        let encoderError = null;
+        this.encoder = new VideoEncoder({
+            output: (chunk, metadata) => {
+                this.muxer?.addVideoChunk(chunk, metadata);
+                encodedChunks++;
+                if (onProgress)
+                    onProgress(Math.min(1, encodedChunks / totalFrames));
+                if (encodedChunks % 30 === 0 || encodedChunks === totalFrames) {
+                    console.log(`[clipkit] Encoded ${encodedChunks}/${totalFrames}`);
+                }
+            },
+            error: (error) => {
+                encoderError = error instanceof Error ? error : new Error(String(error));
+                console.error("[clipkit] VideoEncoder error:", encoderError.message);
+            },
+        });
+        this.encoder.configure({
+            codec,
+            width,
+            height,
+            bitrate,
+        });
+        // Render and encode each frame
+        for (let frameIndex = 0; frameIndex < totalFrames; frameIndex++) {
+            const currentTime = frameIndex * (1 / framerate);
+            if (blurOn && mbAccum) {
+                mbAccum.fill(0);
+                for (let k = 0; k < mbSamples; k++) {
+                    const tk = Math.min(Math.max(currentTime + ((k + 0.5) / mbSamples - 0.5) * (mbShutter / framerate), 0), duration);
+                    await this.renderer.renderAsync(source, tk);
+                    await this.renderer.gpuFinish(); // drain GPU before read-back (hardware-GL capture race)
+                    this.tempCtx.drawImage(this.canvas, 0, 0, width, height);
+                    const sample = this.tempCtx.getImageData(0, 0, width, height).data;
+                    for (let i = 0; i < sample.length; i++)
+                        mbAccum[i] += sample[i];
+                }
+                const out = this.tempCtx.createImageData(width, height);
+                const od = out.data;
+                const inv = 1 / mbSamples;
+                for (let i = 0; i < od.length; i++)
+                    od[i] = Math.round(mbAccum[i] * inv);
+                this.tempCtx.putImageData(out, 0, 0);
+            }
+            else {
+                await this.renderer.renderAsync(source, currentTime);
+                await this.renderer.gpuFinish(); // drain GPU before read-back (hardware-GL capture race)
+                this.tempCtx.drawImage(this.canvas, 0, 0, width, height);
+            }
+            const videoFrame = new VideoFrame(this.tempCanvas, {
+                timestamp: (frameIndex * 1_000_000) / framerate, // microseconds
+                duration: 1_000_000 / framerate,
+            });
+            // Backpressure — never let submission race more than a few frames ahead of
+            // the (often software) encoder. Without this a heavy comp queues hundreds
+            // of VideoFrames faster than they drain: memory climbs and flush() can take
+            // (or appear to take) forever. 'dequeue' is the modern drain signal; race a
+            // short macrotask timer so we never wedge if it isn't delivered.
+            while (this.encoder.encodeQueueSize > BACKPRESSURE_LIMIT) {
+                if (encoderError)
+                    throw encoderError;
+                await new Promise((resolve) => {
+                    const enc = this.encoder;
+                    let settled = false;
+                    const finish = () => {
+                        if (settled)
+                            return;
+                        settled = true;
+                        enc.removeEventListener("dequeue", finish);
+                        resolve();
+                    };
+                    enc.addEventListener("dequeue", finish, { once: true });
+                    setTimeout(finish, 50);
+                });
+            }
+            if (encoderError)
+                throw encoderError;
+            // Encode frame
+            const keyFrame = frameIndex % 30 === 0; // Keyframe every 30 frames
+            this.encoder.encode(videoFrame, { keyFrame });
+            // Close frame to free memory. Progress comes from the encoder OUTPUT
+            // callback (chunks actually encoded), not from submission here.
+            videoFrame.close();
+        }
+        // Watchdog around flush — a wedged software encoder can leave flush() pending
+        // forever, which is what hung the export at "100%" with no error and no
+        // download. With backpressure the queue is small here, so a flush that blows
+        // past this ceiling is a real stall: reject so the UI surfaces an error
+        // instead of an infinite spinner. Ceiling is generous — legit heavy comps are
+        // fine; an actual hang is not.
+        if (encoderError)
+            throw encoderError;
+        await Promise.race([
+            this.encoder.flush(),
+            new Promise((_, reject) => setTimeout(() => reject(new Error(`Export stalled: encoder.flush did not resolve within ${FLUSH_TIMEOUT_MS / 1000}s`)), FLUSH_TIMEOUT_MS)),
+        ]);
+        if (encoderError)
+            throw encoderError;
+        console.log("[clipkit] Encoding complete");
+        this.muxer.finalize();
+        const { buffer } = target;
+        if (!buffer || buffer.byteLength === 0) {
+            throw new Error("Muxer produced no output");
+        }
+        console.log("[clipkit] Muxer finalized, size:", (buffer.byteLength / 1024 / 1024).toFixed(2), "MB");
+        const mp4Blob = new Blob([buffer], { type: "video/mp4" });
+        // Cleanup
+        this.encoder.close();
+        this.encoder = null;
+        this.muxer = null;
+        console.log("[clipkit] Export complete, size:", (mp4Blob.size / 1024 / 1024).toFixed(2), "MB");
+        return mp4Blob;
+    }
+    /**
+     * Render each frame and hand its PNG bytes (base64, with alpha) to `onFrame`.
+     * No encoder/muxer — this feeds the transparent export path (ProRes 4444 /
+     * VP9-alpha), which assembles the PNGs with a server-side ffmpeg. `alpha`
+     * relies on the renderer having been told to clear transparent (the runtime
+     * arranges that). Returns the frame count.
+     */
+    async exportFrames(source, options) {
+        const framerate = options.framerate ?? source.frame_rate ?? 30;
+        const duration = typeof source.duration === "number" ? source.duration : 10;
+        // Even dims for the downstream ffmpeg encode (yuv420p), same as export().
+        const width = toEvenDimension(this.canvas.width || (source.width ?? 1920));
+        const height = toEvenDimension(this.canvas.height || (source.height ?? 1080));
+        this.tempCanvas.width = width;
+        this.tempCanvas.height = height;
+        const totalFrames = Math.ceil(duration * framerate);
+        for (let i = 0; i < totalFrames; i++) {
+            await this.renderer.renderAsync(source, i / framerate);
+            await this.renderer.gpuFinish(); // drain GPU before read-back (hardware-GL capture race)
+            // Transparent output must not composite onto the previous frame.
+            if (options.alpha)
+                this.tempCtx.clearRect(0, 0, width, height);
+            this.tempCtx.drawImage(this.canvas, 0, 0, width, height);
+            const dataUrl = this.tempCanvas.toDataURL("image/png");
+            await options.onFrame(i, dataUrl.slice(dataUrl.indexOf(",") + 1));
+            options.onProgress?.((i + 1) / totalFrames);
+        }
+        return totalFrames;
+    }
+}
+//# sourceMappingURL=exporter.js.map

package/dist/encoder/exporter.js.map

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

package/dist/encoder/index.d.ts

@@ -0,0 +1,3 @@
+export { ClipkitExporter } from './exporter.js';
+export type { ExportOptions } from './exporter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/encoder/index.d.ts.map

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

package/dist/encoder/index.js

@@ -0,0 +1,2 @@
+export { ClipkitExporter } from './exporter.js';
+//# sourceMappingURL=index.js.map

package/dist/encoder/index.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { ClipkitRuntime } from './runtime.js';
+export { setLogger, getLogger, type Logger } from './logger.js';
+export { projectElementQuad, unprojectToPlane, elementDepthZ, type Pt, } from './compositor/project.js';
+export { mapToMediaTime, trimWindow, rateOf, timeRemapOf, trimDurationOf, type MediaTiming, } from './assets/media-time.js';
+export { fadeBreakpoints, fadeGainAt, type FadePoint } from './audio/fades.js';
+export { createMasterLimiter } from './audio/limiter.js';
+export { applyEasing } from './animation/easings.js';
+export { compileExpr, evalExpr, isExpr, type ExprScope } from './animation/expr.js';
+export { ClipkitExporter, resolveRenderResolution, type ExportOptions, type FrameProducer, type RenderResolution, } from './encoder/exporter.js';
+export type { Source, Element } from '@clipkit/protocol';
+export { chunkCaptionWords, activeCaptionChunk, type CaptionChunk } from './text/caption-chunk.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":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAIhE,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,KAAK,EAAE,GACR,MAAM,yBAAyB,CAAC;AAIjC,OAAO,EACL,cAAc,EACd,UAAU,EACV,MAAM,EACN,WAAW,EACX,cAAc,EACd,KAAK,WAAW,GACjB,MAAM,wBAAwB,CAAC;AAIhC,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAI/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAIzD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGpF,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,gBAAgB,GACtB,MAAM,uBAAuB,CAAC;AAK/B,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAKzD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,27 @@
+// @clipkit/runtime — public surface.
+export { ClipkitRuntime } from './runtime.js';
+export { setLogger, getLogger } from './logger.js';
+// Pure projection helpers for editor camera-view gizmos (§item 6) —
+// render-consistent (reuse the compositor's camera + resolve + matrix).
+export { projectElementQuad, unprojectToPlane, elementDepthZ, } from './compositor/project.js';
+// Composition-time → media-time mapping, shared with the playback
+// engine (video pump sync + audio scheduling for video tracks).
+export { mapToMediaTime, trimWindow, rateOf, timeRemapOf, trimDurationOf, } from './assets/media-time.js';
+// Audio fade envelope, shared with the playback engine's scheduler so
+// preview and export gains are identical.
+export { fadeBreakpoints, fadeGainAt } from './audio/fades.js';
+// Master output limiter, shared with the playback engine's scheduler so the
+// preview master bus and the export master bus apply identical clip protection.
+export { createMasterLimiter } from './audio/limiter.js';
+// The normative easing evaluator — shared with the editors' curve
+// display so the drawn curve IS the curve that renders.
+export { applyEasing } from './animation/easings.js';
+// Tier-A expression evaluator (editors/tools use compileExpr for live validity).
+export { compileExpr, evalExpr, isExpr } from './animation/expr.js';
+// Encoder (still callable directly for advanced use).
+export { ClipkitExporter, resolveRenderResolution, } from './encoder/exporter.js';
+// Caption windowing — split a caption's words into chunks (max_length) and pick
+// the chunk active at time t. Shared with the editor timeline so its chunk
+// blocks match what the renderer shows.
+export { chunkCaptionWords, activeCaptionChunk } from './text/caption-chunk.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,qCAAqC;AAErC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,SAAS,EAAe,MAAM,aAAa,CAAC;AAEhE,oEAAoE;AACpE,wEAAwE;AACxE,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,GAEd,MAAM,yBAAyB,CAAC;AAEjC,kEAAkE;AAClE,gEAAgE;AAChE,OAAO,EACL,cAAc,EACd,UAAU,EACV,MAAM,EACN,WAAW,EACX,cAAc,GAEf,MAAM,wBAAwB,CAAC;AAEhC,sEAAsE;AACtE,0CAA0C;AAC1C,OAAO,EAAE,eAAe,EAAE,UAAU,EAAkB,MAAM,kBAAkB,CAAC;AAE/E,4EAA4E;AAC5E,gFAAgF;AAChF,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,kEAAkE;AAClE,wDAAwD;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,iFAAiF;AACjF,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAkB,MAAM,qBAAqB,CAAC;AAEpF,sDAAsD;AACtD,OAAO,EACL,eAAe,EACf,uBAAuB,GAIxB,MAAM,uBAAuB,CAAC;AAO/B,gFAAgF;AAChF,2EAA2E;AAC3E,wCAAwC;AACxC,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAqB,MAAM,yBAAyB,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,13 @@
+export interface Logger {
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+}
+/**
+ * Replace the runtime's logger. Pass `'console'` to log to the browser console
+ * (default), `'silent'` to suppress everything, or a custom Logger object.
+ */
+export declare function setLogger(logger: Logger | 'console' | 'silent'): void;
+export declare function getLogger(): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACjD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CAClD;AAkBD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,IAAI,CAIrE;AAED,wBAAgB,SAAS,IAAI,MAAM,CAElC"}

package/dist/logger.js

@@ -0,0 +1,32 @@
+// Pluggable logger. The runtime prefixes its console output with `[clipkit]`
+// (formerly `[v0]` in the upstream prototype). Consumers can swap in their
+// own logger, silence everything, or route through their existing observability.
+const silentLogger = {
+    debug: () => { },
+    info: () => { },
+    warn: () => { },
+    error: () => { },
+};
+const consoleLogger = {
+    debug: (m, ...a) => console.debug(`[clipkit] ${m}`, ...a),
+    info: (m, ...a) => console.info(`[clipkit] ${m}`, ...a),
+    warn: (m, ...a) => console.warn(`[clipkit] ${m}`, ...a),
+    error: (m, ...a) => console.error(`[clipkit] ${m}`, ...a),
+};
+let activeLogger = consoleLogger;
+/**
+ * Replace the runtime's logger. Pass `'console'` to log to the browser console
+ * (default), `'silent'` to suppress everything, or a custom Logger object.
+ */
+export function setLogger(logger) {
+    if (logger === 'console')
+        activeLogger = consoleLogger;
+    else if (logger === 'silent')
+        activeLogger = silentLogger;
+    else
+        activeLogger = logger;
+}
+export function getLogger() {
+    return activeLogger;
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,2EAA2E;AAC3E,iFAAiF;AASjF,MAAM,YAAY,GAAW;IAC3B,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;IACf,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;CAChB,CAAC;AAEF,MAAM,aAAa,GAAW;IAC5B,KAAK,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IACzD,IAAI,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IACvD,IAAI,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IACvD,KAAK,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;CAC1D,CAAC;AAEF,IAAI,YAAY,GAAW,aAAa,CAAC;AAEzC;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,MAAqC;IAC7D,IAAI,MAAM,KAAK,SAAS;QAAE,YAAY,GAAG,aAAa,CAAC;SAClD,IAAI,MAAM,KAAK,QAAQ;QAAE,YAAY,GAAG,YAAY,CAAC;;QACrD,YAAY,GAAG,MAAM,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,YAAY,CAAC;AACtB,CAAC"}