@tscaps/engine 0.1.1

package/dist/modules/video/mediabunny/codec/DefaultCodecPolicy.d.ts

@@ -0,0 +1,59 @@
+import type { CodecPolicy, VideoCodecResolution, VideoCodecResolutionRequest } from '../../../video/mediabunny/codec/CodecPolicy';
+/**
+ * Resolves the video codec and encoder knobs for a render using a tiered
+ * approach: a baseline bitrate driven by output resolution, scaled by the
+ * codec's relative encoding efficiency, then scaled again by the chosen
+ * quality preset.
+ */
+export declare class DefaultCodecPolicy implements CodecPolicy {
+    /**
+     * Linear scale applied to the base bitrate per quality preset. `high` is
+     * the reference (1.0); the other values are deliberate, not derived from
+     * a benchmark. They exist to give the caller a coarse knob to trade off
+     * file size against fidelity.
+     */
+    private static readonly QUALITY_FACTORS;
+    /**
+     * Relative bitrate needed by each codec to reach an equivalent perceptual
+     * quality, with AVC/H.264 as the 1.0 reference.
+     *
+     * Numbers mirror mediabunny's own internal `codecEfficiencyFactors`
+     * table (see `mediabunny/dist/modules/src/encode.js`), which in turn
+     * follows widely-cited industry benchmarks: HEVC and VP9 deliver roughly
+     * 40-50% bitrate savings over AVC (Bossen et al., HEVC Performance
+     * Comparison, JCTVC-L1003), and AV1 around 30% over HEVC according to
+     * Google's and Netflix's AV1 testing.
+     */
+    private static readonly CODEC_EFFICIENCY;
+    resolveVideo(request: VideoCodecResolutionRequest): Promise<VideoCodecResolution>;
+    private computeBitrate;
+    /**
+     * Baseline AVC bitrate in bits per second for the 30 fps SDR reference
+     * of the given pixel area. Tiers track YouTube's recommended upload
+     * bitrates for SDR 30 fps content, with a small headroom bump since
+     * burned subtitles need extra bits to preserve text legibility:
+     *
+     *   YouTube recommendation:        ours:
+     *     720p   ~5 Mbps                6 Mbps
+     *     1080p  ~8 Mbps                12 Mbps
+     *     1440p  ~16 Mbps               18 Mbps
+     *     2160p  ~35-45 Mbps            40 Mbps
+     *
+     * Source: https://support.google.com/youtube/answer/1722171
+     * (Recommended upload encoding settings → Bitrate.)
+     */
+    private baselineBitrate;
+    /**
+     * Linear scale that turns the 30 fps baseline into the matching budget
+     * for the actual frame rate. YouTube's tables show ~×1.5 between 30 fps
+     * and 60 fps SDR at every resolution; the mapping below reproduces that
+     * ratio and degrades gracefully past 60 fps.
+     *
+     *   fps ≤ 30: ×1.0
+     *   fps = 45: ×1.25
+     *   fps = 60: ×1.5
+     *   fps = 120: ×2.5
+     */
+    private fpsFactor;
+}
+//# sourceMappingURL=DefaultCodecPolicy.d.ts.map

package/dist/modules/video/mediabunny/codec/DefaultCodecPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultCodecPolicy.d.ts","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/codec/DefaultCodecPolicy.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,WAAW,EACX,oBAAoB,EACpB,2BAA2B,EAC5B,MAAM,6CAA6C,CAAC;AAErD;;;;;GAKG;AACH,qBAAa,kBAAmB,YAAW,WAAW;IAEpD;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAKrC;IAEF;;;;;;;;;;OAUG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAMtC;IAEI,YAAY,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAyBvF,OAAO,CAAC,cAAc;IActB;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,eAAe;IAQvB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,SAAS;CAIlB"}

package/dist/modules/video/mediabunny/codec/DefaultCodecPolicy.js

@@ -0,0 +1,110 @@
+import { getFirstEncodableVideoCodec } from 'mediabunny';
+/**
+ * Resolves the video codec and encoder knobs for a render using a tiered
+ * approach: a baseline bitrate driven by output resolution, scaled by the
+ * codec's relative encoding efficiency, then scaled again by the chosen
+ * quality preset.
+ */
+export class DefaultCodecPolicy {
+    /**
+     * Linear scale applied to the base bitrate per quality preset. `high` is
+     * the reference (1.0); the other values are deliberate, not derived from
+     * a benchmark. They exist to give the caller a coarse knob to trade off
+     * file size against fidelity.
+     */
+    static QUALITY_FACTORS = {
+        low: 0.5,
+        medium: 0.75,
+        high: 1.0,
+        'very-high': 1.5,
+    };
+    /**
+     * Relative bitrate needed by each codec to reach an equivalent perceptual
+     * quality, with AVC/H.264 as the 1.0 reference.
+     *
+     * Numbers mirror mediabunny's own internal `codecEfficiencyFactors`
+     * table (see `mediabunny/dist/modules/src/encode.js`), which in turn
+     * follows widely-cited industry benchmarks: HEVC and VP9 deliver roughly
+     * 40-50% bitrate savings over AVC (Bossen et al., HEVC Performance
+     * Comparison, JCTVC-L1003), and AV1 around 30% over HEVC according to
+     * Google's and Netflix's AV1 testing.
+     */
+    static CODEC_EFFICIENCY = {
+        avc: 1.0,
+        hevc: 0.6,
+        vp9: 0.6,
+        av1: 0.4,
+        vp8: 1.2,
+    };
+    async resolveVideo(request) {
+        const codec = await getFirstEncodableVideoCodec(request.supportedCodecs, {
+            width: request.width,
+            height: request.height,
+        });
+        if (!codec) {
+            throw new Error('No video encoder available in this browser for the selected output format. ' +
+                'Try a different format or use a more recent version of Chrome, Firefox or Safari.');
+        }
+        const bitrate = this.computeBitrate(codec, request.width, request.height, request.fps, request.quality);
+        return {
+            codec,
+            bitrate,
+            bitrateMode: 'variable',
+            latencyMode: 'quality',
+            // High-contrast text overlays benefit from the encoder spending more
+            // bits on edge regions. Encoders that don't recognize this hint
+            // (currently Firefox and Safari for most codecs) ignore it harmlessly.
+            // See https://w3c.github.io/mst-content-hint/#video-content-hints
+            contentHint: 'text',
+        };
+    }
+    computeBitrate(codec, width, height, fps, quality) {
+        const baseline = this.baselineBitrate(width, height);
+        const codecFactor = DefaultCodecPolicy.CODEC_EFFICIENCY[codec] ?? 1.0;
+        const qualityFactor = DefaultCodecPolicy.QUALITY_FACTORS[quality ?? 'high'];
+        const fpsFactor = this.fpsFactor(fps);
+        return Math.round(baseline * codecFactor * qualityFactor * fpsFactor);
+    }
+    /**
+     * Baseline AVC bitrate in bits per second for the 30 fps SDR reference
+     * of the given pixel area. Tiers track YouTube's recommended upload
+     * bitrates for SDR 30 fps content, with a small headroom bump since
+     * burned subtitles need extra bits to preserve text legibility:
+     *
+     *   YouTube recommendation:        ours:
+     *     720p   ~5 Mbps                6 Mbps
+     *     1080p  ~8 Mbps                12 Mbps
+     *     1440p  ~16 Mbps               18 Mbps
+     *     2160p  ~35-45 Mbps            40 Mbps
+     *
+     * Source: https://support.google.com/youtube/answer/1722171
+     * (Recommended upload encoding settings → Bitrate.)
+     */
+    baselineBitrate(width, height) {
+        const pixels = width * height;
+        if (pixels <= 1280 * 720)
+            return 6_000_000;
+        if (pixels <= 1920 * 1080)
+            return 12_000_000;
+        if (pixels <= 2560 * 1440)
+            return 18_000_000;
+        return 40_000_000;
+    }
+    /**
+     * Linear scale that turns the 30 fps baseline into the matching budget
+     * for the actual frame rate. YouTube's tables show ~×1.5 between 30 fps
+     * and 60 fps SDR at every resolution; the mapping below reproduces that
+     * ratio and degrades gracefully past 60 fps.
+     *
+     *   fps ≤ 30: ×1.0
+     *   fps = 45: ×1.25
+     *   fps = 60: ×1.5
+     *   fps = 120: ×2.5
+     */
+    fpsFactor(fps) {
+        if (!Number.isFinite(fps) || fps <= 30)
+            return 1;
+        return 1 + (fps - 30) / 60;
+    }
+}
+//# sourceMappingURL=DefaultCodecPolicy.js.map

package/dist/modules/video/mediabunny/codec/DefaultCodecPolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultCodecPolicy.js","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/codec/DefaultCodecPolicy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAmB,MAAM,YAAY,CAAC;AAQ1E;;;;;GAKG;AACH,MAAM,OAAO,kBAAkB;IAE7B;;;;;OAKG;IACK,MAAM,CAAU,eAAe,GAAkC;QACvE,GAAG,EAAE,GAAG;QACR,MAAM,EAAE,IAAI;QACZ,IAAI,EAAE,GAAG;QACT,WAAW,EAAE,GAAG;KACjB,CAAC;IAEF;;;;;;;;;;OAUG;IACK,MAAM,CAAU,gBAAgB,GAA2B;QACjE,GAAG,EAAE,GAAG;QACR,IAAI,EAAE,GAAG;QACT,GAAG,EAAE,GAAG;QACR,GAAG,EAAE,GAAG;QACR,GAAG,EAAE,GAAG;KACT,CAAC;IAEF,KAAK,CAAC,YAAY,CAAC,OAAoC;QACrD,MAAM,KAAK,GAAG,MAAM,2BAA2B,CAAC,OAAO,CAAC,eAAe,EAAE;YACvE,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CACb,6EAA6E;gBAC3E,mFAAmF,CACtF,CAAC;QACJ,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QACxG,OAAO;YACL,KAAK;YACL,OAAO;YACP,WAAW,EAAE,UAAU;YACvB,WAAW,EAAE,SAAS;YACtB,qEAAqE;YACrE,gEAAgE;YAChE,uEAAuE;YACvE,kEAAkE;YAClE,WAAW,EAAE,MAAM;SACpB,CAAC;IACJ,CAAC;IAEO,cAAc,CACpB,KAAiB,EACjB,KAAa,EACb,MAAc,EACd,GAAW,EACX,OAAkC;QAElC,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACrD,MAAM,WAAW,GAAG,kBAAkB,CAAC,gBAAgB,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC;QACtE,MAAM,aAAa,GAAG,kBAAkB,CAAC,eAAe,CAAC,OAAO,IAAI,MAAM,CAAC,CAAC;QAC5E,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACtC,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,WAAW,GAAG,aAAa,GAAG,SAAS,CAAC,CAAC;IACxE,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACK,eAAe,CAAC,KAAa,EAAE,MAAc;QACnD,MAAM,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;QAC9B,IAAI,MAAM,IAAI,IAAI,GAAG,GAAG;YAAE,OAAO,SAAS,CAAC;QAC3C,IAAI,MAAM,IAAI,IAAI,GAAG,IAAI;YAAE,OAAO,UAAU,CAAC;QAC7C,IAAI,MAAM,IAAI,IAAI,GAAG,IAAI;YAAE,OAAO,UAAU,CAAC;QAC7C,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;;;;;;;;;OAUG;IACK,SAAS,CAAC,GAAW;QAC3B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,EAAE;YAAE,OAAO,CAAC,CAAC;QACjD,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;IAC7B,CAAC"}

package/dist/modules/video/mediabunny/encoder/MediaBunnyCanvasVideoTrackEncoder.d.ts

@@ -0,0 +1,27 @@
+import { type Output, type VideoEncodingConfig } from 'mediabunny';
+import type { PaintFrame, VideoTrackEncoder } from '../../../video/mediabunny/encoder/VideoTrackEncoder';
+export interface MediaBunnyCanvasVideoTrackEncoderConfig {
+    width: number;
+    height: number;
+    encoderConfig: VideoEncodingConfig;
+}
+/**
+ * Owns an {@link OffscreenCanvas} sized to the output, a high-quality 2D
+ * context, and a {@link CanvasSource} that snapshots the canvas on each
+ * {@link encode} call and pushes the result into the output's encoder
+ * pipeline.
+ *
+ * Hides the canvas: callers paint through the {@link PaintFrame} callback
+ * passed to `encode`, never against the underlying surface directly.
+ */
+export declare class MediaBunnyCanvasVideoTrackEncoder implements VideoTrackEncoder {
+    readonly width: number;
+    readonly height: number;
+    private readonly canvas;
+    private readonly context;
+    private readonly canvasSource;
+    constructor(config: MediaBunnyCanvasVideoTrackEncoderConfig);
+    attachTo(output: Output): void;
+    encode(timestamp: number, duration: number, paint: PaintFrame): Promise<void>;
+}
+//# sourceMappingURL=MediaBunnyCanvasVideoTrackEncoder.d.ts.map

package/dist/modules/video/mediabunny/encoder/MediaBunnyCanvasVideoTrackEncoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MediaBunnyCanvasVideoTrackEncoder.d.ts","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/encoder/MediaBunnyCanvasVideoTrackEncoder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,MAAM,EAAE,KAAK,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,KAAK,EACV,UAAU,EACV,iBAAiB,EAClB,MAAM,qDAAqD,CAAC;AAE7D,MAAM,WAAW,uCAAuC;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,mBAAmB,CAAC;CACpC;AAED;;;;;;;;GAQG;AACH,qBAAa,iCAAkC,YAAW,iBAAiB;IAEzE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;IAC5D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;gBAEhC,MAAM,EAAE,uCAAuC;IAoB3D,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIxB,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;CAIpF"}

package/dist/modules/video/mediabunny/encoder/MediaBunnyCanvasVideoTrackEncoder.js

@@ -0,0 +1,44 @@
+import { CanvasSource } from 'mediabunny';
+/**
+ * Owns an {@link OffscreenCanvas} sized to the output, a high-quality 2D
+ * context, and a {@link CanvasSource} that snapshots the canvas on each
+ * {@link encode} call and pushes the result into the output's encoder
+ * pipeline.
+ *
+ * Hides the canvas: callers paint through the {@link PaintFrame} callback
+ * passed to `encode`, never against the underlying surface directly.
+ */
+export class MediaBunnyCanvasVideoTrackEncoder {
+    width;
+    height;
+    canvas;
+    context;
+    canvasSource;
+    constructor(config) {
+        this.width = config.width;
+        this.height = config.height;
+        this.canvas = new OffscreenCanvas(config.width, config.height);
+        // alpha:false — the compositor paints an opaque source frame first;
+        // imageSmoothingEnabled:false — compositor always draws at native
+        // size, so smoothing is a pure no-op cost.
+        const ctx = this.canvas.getContext('2d', {
+            alpha: false,
+            desynchronized: false,
+            willReadFrequently: false,
+        });
+        if (!ctx) {
+            throw new Error('Unable to acquire a 2D context on the offscreen canvas');
+        }
+        ctx.imageSmoothingEnabled = false;
+        this.context = ctx;
+        this.canvasSource = new CanvasSource(this.canvas, config.encoderConfig);
+    }
+    attachTo(output) {
+        output.addVideoTrack(this.canvasSource);
+    }
+    async encode(timestamp, duration, paint) {
+        paint(this.context);
+        await this.canvasSource.add(timestamp, duration);
+    }
+}
+//# sourceMappingURL=MediaBunnyCanvasVideoTrackEncoder.js.map

package/dist/modules/video/mediabunny/encoder/MediaBunnyCanvasVideoTrackEncoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MediaBunnyCanvasVideoTrackEncoder.js","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/encoder/MediaBunnyCanvasVideoTrackEncoder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAyC,MAAM,YAAY,CAAC;AAYjF;;;;;;;;GAQG;AACH,MAAM,OAAO,iCAAiC;IAEnC,KAAK,CAAS;IACd,MAAM,CAAS;IAEP,MAAM,CAAkB;IACxB,OAAO,CAAoC;IAC3C,YAAY,CAAe;IAE5C,YAAY,MAA+C;QACzD,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAC/D,oEAAoE;QACpE,kEAAkE;QAClE,2CAA2C;QAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE;YACvC,KAAK,EAAE,KAAK;YACZ,cAAc,EAAE,KAAK;YACrB,kBAAkB,EAAE,KAAK;SAC1B,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC5E,CAAC;QACD,GAAG,CAAC,qBAAqB,GAAG,KAAK,CAAC;QAClC,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC;QACnB,IAAI,CAAC,YAAY,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC;IAC1E,CAAC;IAED,QAAQ,CAAC,MAAc;QACrB,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,SAAiB,EAAE,QAAgB,EAAE,KAAiB;QACjE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,MAAM,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACnD,CAAC;CACF"}

package/dist/modules/video/mediabunny/encoder/MediaBunnyCanvasVideoTrackEncoderFactory.d.ts

@@ -0,0 +1,10 @@
+import type { VideoTrackEncoder } from '../../../video/mediabunny/encoder/VideoTrackEncoder';
+import type { VideoTrackEncoderFactory, VideoTrackEncoderFactoryRequest } from '../../../video/mediabunny/encoder/VideoTrackEncoderFactory';
+/**
+ * Produces canvas-backed encoders that wrap mediabunny's
+ * {@link CanvasSource}.
+ */
+export declare class MediaBunnyCanvasVideoTrackEncoderFactory implements VideoTrackEncoderFactory {
+    create(request: VideoTrackEncoderFactoryRequest): VideoTrackEncoder;
+}
+//# sourceMappingURL=MediaBunnyCanvasVideoTrackEncoderFactory.d.ts.map

package/dist/modules/video/mediabunny/encoder/MediaBunnyCanvasVideoTrackEncoderFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MediaBunnyCanvasVideoTrackEncoderFactory.d.ts","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/encoder/MediaBunnyCanvasVideoTrackEncoderFactory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qDAAqD,CAAC;AAC7F,OAAO,KAAK,EACV,wBAAwB,EACxB,+BAA+B,EAChC,MAAM,4DAA4D,CAAC;AAEpE;;;GAGG;AACH,qBAAa,wCAAyC,YAAW,wBAAwB;IAEvF,MAAM,CAAC,OAAO,EAAE,+BAA+B,GAAG,iBAAiB;CAOpE"}

package/dist/modules/video/mediabunny/encoder/MediaBunnyCanvasVideoTrackEncoderFactory.js

@@ -0,0 +1,15 @@
+import { MediaBunnyCanvasVideoTrackEncoder } from '../../../video/mediabunny/encoder/MediaBunnyCanvasVideoTrackEncoder';
+/**
+ * Produces canvas-backed encoders that wrap mediabunny's
+ * {@link CanvasSource}.
+ */
+export class MediaBunnyCanvasVideoTrackEncoderFactory {
+    create(request) {
+        return new MediaBunnyCanvasVideoTrackEncoder({
+            width: request.width,
+            height: request.height,
+            encoderConfig: request.encoderConfig,
+        });
+    }
+}
+//# sourceMappingURL=MediaBunnyCanvasVideoTrackEncoderFactory.js.map

package/dist/modules/video/mediabunny/encoder/MediaBunnyCanvasVideoTrackEncoderFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MediaBunnyCanvasVideoTrackEncoderFactory.js","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/encoder/MediaBunnyCanvasVideoTrackEncoderFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iCAAiC,EAAE,MAAM,qEAAqE,CAAC;AAOxH;;;GAGG;AACH,MAAM,OAAO,wCAAwC;IAEnD,MAAM,CAAC,OAAwC;QAC7C,OAAO,IAAI,iCAAiC,CAAC;YAC3C,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,aAAa,EAAE,OAAO,CAAC,aAAa;SACrC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/modules/video/mediabunny/encoder/VideoTrackEncoder.d.ts

@@ -0,0 +1,29 @@
+import type { Output } from 'mediabunny';
+/** Callback the encoder runs against its own 2D context on every frame. */
+export type PaintFrame = (target: OffscreenCanvasRenderingContext2D) => void;
+/**
+ * Encodes successive frames into a mediabunny {@link Output}. The
+ * encoder owns its underlying surface and never exposes it; callers
+ * describe what to paint via the {@link PaintFrame} callback passed
+ * to {@link encode}.
+ *
+ * Output dimensions are fixed at construction time.
+ */
+export interface VideoTrackEncoder {
+    readonly width: number;
+    readonly height: number;
+    /**
+     * Wires the encoder's source into the output. Must be called once
+     * before the output is started.
+     */
+    attachTo(output: Output): void;
+    /**
+     * Runs `paint` against the encoder's internal surface, snapshots the
+     * result, and queues it for encoding at the given presentation
+     * timestamp and duration (both in seconds). The returned promise
+     * resolves once the encoder is ready to receive the next frame —
+     * await it to honor backpressure.
+     */
+    encode(timestamp: number, duration: number, paint: PaintFrame): Promise<void>;
+}
+//# sourceMappingURL=VideoTrackEncoder.d.ts.map

package/dist/modules/video/mediabunny/encoder/VideoTrackEncoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VideoTrackEncoder.d.ts","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/encoder/VideoTrackEncoder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,2EAA2E;AAC3E,MAAM,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,iCAAiC,KAAK,IAAI,CAAC;AAE7E;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B;;;;;;OAMG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/E"}

package/dist/modules/video/mediabunny/encoder/VideoTrackEncoder.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=VideoTrackEncoder.js.map

package/dist/modules/video/mediabunny/encoder/VideoTrackEncoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VideoTrackEncoder.js","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/encoder/VideoTrackEncoder.ts"],"names":[],"mappings":""}

package/dist/modules/video/mediabunny/encoder/VideoTrackEncoderFactory.d.ts

@@ -0,0 +1,16 @@
+import type { VideoEncodingConfig } from 'mediabunny';
+import type { VideoTrackEncoder } from '../../../video/mediabunny/encoder/VideoTrackEncoder';
+export interface VideoTrackEncoderFactoryRequest {
+    width: number;
+    height: number;
+    encoderConfig: VideoEncodingConfig;
+}
+/**
+ * Builds a {@link VideoTrackEncoder} sized to the requested output. The
+ * renderer asks the factory for a fresh encoder per render, once the
+ * input dimensions and resolved codec config are known.
+ */
+export interface VideoTrackEncoderFactory {
+    create(request: VideoTrackEncoderFactoryRequest): VideoTrackEncoder;
+}
+//# sourceMappingURL=VideoTrackEncoderFactory.d.ts.map

package/dist/modules/video/mediabunny/encoder/VideoTrackEncoderFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VideoTrackEncoderFactory.d.ts","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/encoder/VideoTrackEncoderFactory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qDAAqD,CAAC;AAE7F,MAAM,WAAW,+BAA+B;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,mBAAmB,CAAC;CACpC;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,OAAO,EAAE,+BAA+B,GAAG,iBAAiB,CAAC;CACrE"}

package/dist/modules/video/mediabunny/encoder/VideoTrackEncoderFactory.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=VideoTrackEncoderFactory.js.map

package/dist/modules/video/mediabunny/encoder/VideoTrackEncoderFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VideoTrackEncoderFactory.js","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/encoder/VideoTrackEncoderFactory.ts"],"names":[],"mappings":""}

package/dist/modules/video/mediabunny/frame/CurrentFrameVideoSource.d.ts

@@ -0,0 +1,25 @@
+import type { VideoFrameSource, VideoFrameRegion } from '../../../rendering/VideoFrameSource';
+import type { DecodedVideoFrame } from '../../../video/mediabunny/frame/VideoFrameDecoder';
+/**
+ * Single-slot `VideoFrameSource`. {@link setCurrent} stores one
+ * decoded frame at a timestamp; {@link getFrameAt} serves only that
+ * frame and only at that same timestamp. Querying any other
+ * timestamp throws.
+ */
+export declare class CurrentFrameVideoSource implements VideoFrameSource {
+    private static readonly TIMESTAMP_TOLERANCE_S;
+    private readonly canvas;
+    private readonly ctx;
+    private currentTimestamp;
+    constructor(width: number, height: number);
+    /**
+     * Stores `frame` as the only frame `getFrameAt` will serve until
+     * the next `setCurrent`, keyed on `timestamp`.
+     */
+    setCurrent(timestamp: number, frame: DecodedVideoFrame): void;
+    getFrameAt(timeSeconds: number, jpegQuality: number, region?: VideoFrameRegion): Promise<string>;
+    private encode;
+    private clipToCanvas;
+    private blobToDataUrl;
+}
+//# sourceMappingURL=CurrentFrameVideoSource.d.ts.map

package/dist/modules/video/mediabunny/frame/CurrentFrameVideoSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CurrentFrameVideoSource.d.ts","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/frame/CurrentFrameVideoSource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAC9F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mDAAmD,CAAC;AAG3F;;;;;GAKG;AACH,qBAAa,uBAAwB,YAAW,gBAAgB;IAI9D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAQ;IAErD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAoC;IACxD,OAAO,CAAC,gBAAgB,CAAuB;gBAEnC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IASzC;;;OAGG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,IAAI;IAOvD,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBtG,OAAO,CAAC,MAAM;IAqBd,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,aAAa;CAQtB"}

package/dist/modules/video/mediabunny/frame/CurrentFrameVideoSource.js

@@ -0,0 +1,74 @@
+import { profiler } from '../../../profiling/Profiler';
+/**
+ * Single-slot `VideoFrameSource`. {@link setCurrent} stores one
+ * decoded frame at a timestamp; {@link getFrameAt} serves only that
+ * frame and only at that same timestamp. Querying any other
+ * timestamp throws.
+ */
+export class CurrentFrameVideoSource {
+    // Any mismatch beyond IEEE-754 noise is a coordination bug between
+    // the producer and the subtitle renderer.
+    static TIMESTAMP_TOLERANCE_S = 1e-6;
+    canvas;
+    ctx;
+    currentTimestamp = null;
+    constructor(width, height) {
+        this.canvas = new OffscreenCanvas(width, height);
+        const ctx = this.canvas.getContext('2d');
+        if (!ctx) {
+            throw new Error('OffscreenCanvas 2D context is not available in this environment.');
+        }
+        this.ctx = ctx;
+    }
+    /**
+     * Stores `frame` as the only frame `getFrameAt` will serve until
+     * the next `setCurrent`, keyed on `timestamp`.
+     */
+    setCurrent(timestamp, frame) {
+        this.currentTimestamp = timestamp;
+        profiler.time('CurrentFrameVideoSource.draw', () => frame.draw(this.ctx, 0, 0, this.canvas.width, this.canvas.height));
+    }
+    async getFrameAt(timeSeconds, jpegQuality, region) {
+        if (this.currentTimestamp === null) {
+            throw new Error('CurrentFrameVideoSource.getFrameAt called before any setCurrent.');
+        }
+        if (Math.abs(this.currentTimestamp - timeSeconds) > CurrentFrameVideoSource.TIMESTAMP_TOLERANCE_S) {
+            throw new Error(`CurrentFrameVideoSource: requested timestamp ${timeSeconds}, ` +
+                `but the current slot holds ${this.currentTimestamp}.`);
+        }
+        const blob = await profiler.time('CurrentFrameVideoSource.convertToBlob', () => this.encode(region, jpegQuality));
+        return profiler.time('CurrentFrameVideoSource.blobToDataUrl', () => this.blobToDataUrl(blob));
+    }
+    encode(region, jpegQuality) {
+        if (!region) {
+            return this.canvas.convertToBlob({ type: 'image/jpeg', quality: jpegQuality });
+        }
+        const clipped = this.clipToCanvas(region);
+        if (clipped.width === 0 || clipped.height === 0) {
+            return this.canvas.convertToBlob({ type: 'image/jpeg', quality: jpegQuality });
+        }
+        const cropCanvas = new OffscreenCanvas(clipped.width, clipped.height);
+        const cropCtx = cropCanvas.getContext('2d');
+        if (!cropCtx) {
+            throw new Error('OffscreenCanvas 2D context is not available for cropping.');
+        }
+        cropCtx.drawImage(this.canvas, clipped.x, clipped.y, clipped.width, clipped.height, 0, 0, clipped.width, clipped.height);
+        return cropCanvas.convertToBlob({ type: 'image/jpeg', quality: jpegQuality });
+    }
+    clipToCanvas(region) {
+        const x = Math.max(0, Math.floor(region.x));
+        const y = Math.max(0, Math.floor(region.y));
+        const right = Math.min(this.canvas.width, Math.ceil(region.x + region.width));
+        const bottom = Math.min(this.canvas.height, Math.ceil(region.y + region.height));
+        return { x, y, width: Math.max(0, right - x), height: Math.max(0, bottom - y) };
+    }
+    blobToDataUrl(blob) {
+        return new Promise((resolve, reject) => {
+            const reader = new FileReader();
+            reader.onload = () => resolve(reader.result);
+            reader.onerror = () => reject(reader.error ?? new Error('FileReader failed to encode the frame.'));
+            reader.readAsDataURL(blob);
+        });
+    }
+}
+//# sourceMappingURL=CurrentFrameVideoSource.js.map

package/dist/modules/video/mediabunny/frame/CurrentFrameVideoSource.js.map

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

package/dist/modules/video/mediabunny/frame/CustomWebCodecsVideoFrameDecoder.d.ts

@@ -0,0 +1,26 @@
+import { type InputVideoTrack } from 'mediabunny';
+import type { DecodedVideoFrame, VideoFrameDecoder } from '../../../video/mediabunny/frame/VideoFrameDecoder';
+/**
+ * Drives a WebCodecs {@link VideoDecoder} directly off mediabunny's
+ * {@link EncodedPacketSink}. Going through `VideoSampleSink` introduces
+ * a per-frame serialization that dominates render time on Firefox
+ * (where WebCodecs has noticeably higher per-call latency than
+ * Chromium); feeding the decoder ourselves lets the pipeline stay
+ * saturated while frames are reordered internally for presentation.
+ *
+ * Packets are fed in decode order; frames are yielded in presentation
+ * order — the WebCodecs `VideoDecoder` handles B-frame reordering on
+ * the output side.
+ */
+export declare class CustomWebCodecsVideoFrameDecoder implements VideoFrameDecoder {
+    private readonly track;
+    private closed;
+    private decoder;
+    constructor(track: InputVideoTrack);
+    samples(): AsyncIterable<DecodedVideoFrame>;
+    close(): void;
+    private iterate;
+    private waitForDequeue;
+    private wrap;
+}
+//# sourceMappingURL=CustomWebCodecsVideoFrameDecoder.d.ts.map

package/dist/modules/video/mediabunny/frame/CustomWebCodecsVideoFrameDecoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CustomWebCodecsVideoFrameDecoder.d.ts","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/frame/CustomWebCodecsVideoFrameDecoder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,mDAAmD,CAAC;AAc9G;;;;;;;;;;;GAWG;AACH,qBAAa,gCAAiC,YAAW,iBAAiB;IAK5D,OAAO,CAAC,QAAQ,CAAC,KAAK;IAHlC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAA6B;gBAEf,KAAK,EAAE,eAAe;IAEnD,OAAO,IAAI,aAAa,CAAC,iBAAiB,CAAC;IAM3C,KAAK,IAAI,IAAI;IAQb,OAAO,CAAC,OAAO;IA+Ef,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,IAAI;CAQb"}