@tscaps/engine 0.1.1 → 0.3.0

package/dist/modules/video/mediabunny/audio/PassthroughAudioTrackBridge.js

@@ -41,12 +41,18 @@ export class PassthroughAudioTrackBridge {
         // discarded — the output writer rejects negative timestamps.
         if (packet.timestamp < 0)
             return;
+        const timeMap = this.config.timeMap;
+        if (timeMap.isSkipped(packet.timestamp))
+            return;
+        const outputPacket = timeMap.isEmpty()
+            ? packet
+            : packet.clone({ timestamp: timeMap.toOutputTime(packet.timestamp) });
         if (this.firstPacketPending && this.decoderConfig) {
-            await this.source.add(packet, { decoderConfig: this.decoderConfig });
+            await this.source.add(outputPacket, { decoderConfig: this.decoderConfig });
             this.firstPacketPending = false;
             return;
         }
-        await this.source.add(packet);
+        await this.source.add(outputPacket);
     }
 }
 //# sourceMappingURL=PassthroughAudioTrackBridge.js.map

package/dist/modules/video/mediabunny/audio/PassthroughAudioTrackBridge.js.map

@@ -1 +1 @@
-{"version":3,"file":"PassthroughAudioTrackBridge.js","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/audio/PassthroughAudioTrackBridge.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,iBAAiB,GAKlB,MAAM,YAAY,CAAC;AAQpB;;;;;;;GAOG;AACH,MAAM,OAAO,2BAA2B;IAQT;IANZ,MAAM,CAA2B;IACjC,IAAI,CAAoB;IACjC,UAAU,GAAyB,IAAI,CAAC;IACxC,aAAa,GAA8B,IAAI,CAAC;IAChD,kBAAkB,GAAG,IAAI,CAAC;IAElC,YAA6B,MAAyC;QAAzC,WAAM,GAAN,MAAM,CAAmC;QACpE,IAAI,CAAC,MAAM,GAAG,IAAI,wBAAwB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACzD,IAAI,CAAC,IAAI,GAAG,IAAI,iBAAiB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAc;QAC3B,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClC,IAAI,CAAC,UAAU,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;QACnD,IAAI,CAAC,aAAa,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC;IACvE,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,cAAsB;QACpC,OAAO,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,IAAI,cAAc,EAAE,CAAC;YACtE,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACjC,IAAI,CAAC,UAAU,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM;QACV,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC;YACvB,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACjC,IAAI,CAAC,UAAU,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,IAAI,CAAC,MAAqB;QACtC,qEAAqE;QACrE,6DAA6D;QAC7D,IAAI,MAAM,CAAC,SAAS,GAAG,CAAC;YAAE,OAAO;QACjC,IAAI,IAAI,CAAC,kBAAkB,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YAClD,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;YACrE,IAAI,CAAC,kBAAkB,GAAG,KAAK,CAAC;YAChC,OAAO;QACT,CAAC;QACD,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;CACF"}
+{"version":3,"file":"PassthroughAudioTrackBridge.js","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/audio/PassthroughAudioTrackBridge.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,iBAAiB,GAKlB,MAAM,YAAY,CAAC;AAUpB;;;;;;;GAOG;AACH,MAAM,OAAO,2BAA2B;IAQT;IANZ,MAAM,CAA2B;IACjC,IAAI,CAAoB;IACjC,UAAU,GAAyB,IAAI,CAAC;IACxC,aAAa,GAA8B,IAAI,CAAC;IAChD,kBAAkB,GAAG,IAAI,CAAC;IAElC,YAA6B,MAAyC;QAAzC,WAAM,GAAN,MAAM,CAAmC;QACpE,IAAI,CAAC,MAAM,GAAG,IAAI,wBAAwB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACzD,IAAI,CAAC,IAAI,GAAG,IAAI,iBAAiB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAc;QAC3B,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClC,IAAI,CAAC,UAAU,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;QACnD,IAAI,CAAC,aAAa,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC;IACvE,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,cAAsB;QACpC,OAAO,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,IAAI,cAAc,EAAE,CAAC;YACtE,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACjC,IAAI,CAAC,UAAU,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM;QACV,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC;YACvB,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACjC,IAAI,CAAC,UAAU,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,IAAI,CAAC,MAAqB;QACtC,qEAAqE;QACrE,6DAA6D;QAC7D,IAAI,MAAM,CAAC,SAAS,GAAG,CAAC;YAAE,OAAO;QACjC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;QACpC,IAAI,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC;YAAE,OAAO;QAChD,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,EAAE;YACpC,CAAC,CAAC,MAAM;YACR,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACxE,IAAI,IAAI,CAAC,kBAAkB,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YAClD,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,EAAE,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;YAC3E,IAAI,CAAC,kBAAkB,GAAG,KAAK,CAAC;YAChC,OAAO;QACT,CAAC;QACD,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACtC,CAAC;CACF"}

package/dist/modules/video/mediabunny/audio/TranscodeAudioTrackBridge.d.ts

@@ -1,9 +1,11 @@
 import { type AudioCodec, type InputAudioTrack, type Output } from 'mediabunny';
 import type { AudioTrackBridge } from '../../../video/mediabunny/audio/AudioTrackBridge';
+import type { RenderTimeMap } from '../../../video/RenderTimeMap';
 export interface TranscodeAudioTrackBridgeConfig {
     inputTrack: InputAudioTrack;
     /** Target codec to encode into. Must be supported by the output container. */
     codec: AudioCodec;
+    timeMap: RenderTimeMap;
 }
 /**
  * Decodes the input audio track and re-encodes it into the requested
@@ -13,6 +15,7 @@ export interface TranscodeAudioTrackBridgeConfig {
 export declare class TranscodeAudioTrackBridge implements AudioTrackBridge {
     private readonly source;
     private readonly sink;
+    private readonly timeMap;
     private iterator;
     private nextSample;
     constructor(config: TranscodeAudioTrackBridgeConfig);

package/dist/modules/video/mediabunny/audio/TranscodeAudioTrackBridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TranscodeAudioTrackBridge.d.ts","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/audio/TranscodeAudioTrackBridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,UAAU,EAEf,KAAK,eAAe,EACpB,KAAK,MAAM,EACZ,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kDAAkD,CAAC;AAEzF,MAAM,WAAW,+BAA+B;IAC9C,UAAU,EAAE,eAAe,CAAC;IAC5B,8EAA8E;IAC9E,KAAK,EAAE,UAAU,CAAC;CACnB;AAED;;;;GAIG;AACH,qBAAa,yBAA0B,YAAW,gBAAgB;IAEhE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAkB;IACvC,OAAO,CAAC,QAAQ,CAA2C;IAC3D,OAAO,CAAC,UAAU,CAA4B;gBAElC,MAAM,EAAE,+BAA+B;IAK7C,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMvC,SAAS,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOhD,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;YAOf,IAAI;YAYJ,OAAO;CAKtB"}
+{"version":3,"file":"TranscodeAudioTrackBridge.d.ts","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/audio/TranscodeAudioTrackBridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,UAAU,EAEf,KAAK,eAAe,EACpB,KAAK,MAAM,EACZ,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kDAAkD,CAAC;AACzF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE,MAAM,WAAW,+BAA+B;IAC9C,UAAU,EAAE,eAAe,CAAC;IAC5B,8EAA8E;IAC9E,KAAK,EAAE,UAAU,CAAC;IAClB,OAAO,EAAE,aAAa,CAAC;CACxB;AAED;;;;GAIG;AACH,qBAAa,yBAA0B,YAAW,gBAAgB;IAEhE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAkB;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAA2C;IAC3D,OAAO,CAAC,UAAU,CAA4B;gBAElC,MAAM,EAAE,+BAA+B;IAM7C,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMvC,SAAS,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOhD,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;YAOf,IAAI;YAeJ,OAAO;CAKtB"}

package/dist/modules/video/mediabunny/audio/TranscodeAudioTrackBridge.js

@@ -7,11 +7,13 @@ import { AudioSampleSink, AudioSampleSource, QUALITY_HIGH, } from 'mediabunny';
 export class TranscodeAudioTrackBridge {
     source;
     sink;
+    timeMap;
     iterator = null;
     nextSample = null;
     constructor(config) {
         this.source = new AudioSampleSource({ codec: config.codec, bitrate: QUALITY_HIGH });
         this.sink = new AudioSampleSink(config.inputTrack);
+        this.timeMap = config.timeMap;
     }
     async attachTo(output) {
         output.addAudioTrack(this.source);
@@ -34,9 +36,14 @@ export class TranscodeAudioTrackBridge {
         try {
             // Samples before t=0 (container offsets) are discarded because the
             // muxer rejects negative timestamps.
-            if (sample.timestamp >= 0) {
-                await this.source.add(sample);
+            if (sample.timestamp < 0)
+                return;
+            if (this.timeMap.isSkipped(sample.timestamp))
+                return;
+            if (!this.timeMap.isEmpty()) {
+                sample.setTimestamp(this.timeMap.toOutputTime(sample.timestamp));
             }
+            await this.source.add(sample);
         }
         finally {
             sample.close();

package/dist/modules/video/mediabunny/audio/TranscodeAudioTrackBridge.js.map

@@ -1 +1 @@
-{"version":3,"file":"TranscodeAudioTrackBridge.js","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/audio/TranscodeAudioTrackBridge.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,YAAY,GAKb,MAAM,YAAY,CAAC;AASpB;;;;GAIG;AACH,MAAM,OAAO,yBAAyB;IAEnB,MAAM,CAAoB;IAC1B,IAAI,CAAkB;IAC/B,QAAQ,GAAsC,IAAI,CAAC;IACnD,UAAU,GAAuB,IAAI,CAAC;IAE9C,YAAY,MAAuC;QACjD,IAAI,CAAC,MAAM,GAAG,IAAI,iBAAiB,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC;QACpF,IAAI,CAAC,IAAI,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAc;QAC3B,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;QAC5D,IAAI,CAAC,UAAU,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,cAAsB;QACpC,OAAO,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,IAAI,cAAc,EAAE,CAAC;YACtE,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACjC,IAAI,CAAC,UAAU,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACzC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM;QACV,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC;YACvB,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACjC,IAAI,CAAC,UAAU,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACzC,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,IAAI,CAAC,MAAmB;QACpC,IAAI,CAAC;YACH,mEAAmE;YACnE,qCAAqC;YACrC,IAAI,MAAM,CAAC,SAAS,IAAI,CAAC,EAAE,CAAC;gBAC1B,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,OAAO;QACnB,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAChC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnD,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;IACvC,CAAC;CACF"}
+{"version":3,"file":"TranscodeAudioTrackBridge.js","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/audio/TranscodeAudioTrackBridge.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,YAAY,GAKb,MAAM,YAAY,CAAC;AAWpB;;;;GAIG;AACH,MAAM,OAAO,yBAAyB;IAEnB,MAAM,CAAoB;IAC1B,IAAI,CAAkB;IACtB,OAAO,CAAgB;IAChC,QAAQ,GAAsC,IAAI,CAAC;IACnD,UAAU,GAAuB,IAAI,CAAC;IAE9C,YAAY,MAAuC;QACjD,IAAI,CAAC,MAAM,GAAG,IAAI,iBAAiB,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC;QACpF,IAAI,CAAC,IAAI,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACnD,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAc;QAC3B,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;QAC5D,IAAI,CAAC,UAAU,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,cAAsB;QACpC,OAAO,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,IAAI,cAAc,EAAE,CAAC;YACtE,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACjC,IAAI,CAAC,UAAU,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACzC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM;QACV,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC;YACvB,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACjC,IAAI,CAAC,UAAU,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACzC,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,IAAI,CAAC,MAAmB;QACpC,IAAI,CAAC;YACH,mEAAmE;YACnE,qCAAqC;YACrC,IAAI,MAAM,CAAC,SAAS,GAAG,CAAC;gBAAE,OAAO;YACjC,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC;gBAAE,OAAO;YACrD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;gBAC5B,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;YACnE,CAAC;YACD,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC;gBAAS,CAAC;YACT,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,OAAO;QACnB,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAChC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnD,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;IACvC,CAAC;CACF"}

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

@@ -20,6 +20,13 @@ export interface VideoCodecResolution {
     latencyMode: 'quality' | 'realtime';
     /** Optional hint about the content being encoded, e.g. `'text'` for high-contrast overlays. */
     contentHint?: string;
+    /**
+     * Distance, in seconds, between forced key frames. When omitted, the
+     * encoder picks its default cadence. A short interval trades file
+     * size for random-access granularity — useful for outputs that will
+     * be scrubbed heavily (e.g. preview proxies).
+     */
+    keyFrameInterval?: number;
 }
 /**
  * Resolves codec, bitrate and encoder knobs for a render.

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

@@ -1 +1 @@
-{"version":3,"file":"CodecPolicy.d.ts","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/codec/CodecPolicy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,MAAM,WAAW,2BAA2B;IAC1C,mDAAmD;IACnD,eAAe,EAAE,UAAU,EAAE,CAAC;IAC9B,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,GAAG,EAAE,MAAM,CAAC;IACZ,wDAAwD;IACxD,OAAO,EAAE,aAAa,GAAG,SAAS,CAAC;CACpC;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,UAAU,CAAC;IAClB,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,UAAU,GAAG,UAAU,CAAC;IACrC,WAAW,EAAE,SAAS,GAAG,UAAU,CAAC;IACpC,+FAA+F;IAC/F,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,YAAY,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACnF"}
+{"version":3,"file":"CodecPolicy.d.ts","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/codec/CodecPolicy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,MAAM,WAAW,2BAA2B;IAC1C,mDAAmD;IACnD,eAAe,EAAE,UAAU,EAAE,CAAC;IAC9B,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,GAAG,EAAE,MAAM,CAAC;IACZ,wDAAwD;IACxD,OAAO,EAAE,aAAa,GAAG,SAAS,CAAC;CACpC;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,UAAU,CAAC;IAClB,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,UAAU,GAAG,UAAU,CAAC;IACrC,WAAW,EAAE,SAAS,GAAG,UAAU,CAAC;IACpC,+FAA+F;IAC/F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,YAAY,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACnF"}

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

@@ -1,4 +1,4 @@
-import type { VideoFrameSource, VideoFrameRegion } from '../../../rendering/VideoFrameSource';
+import type { VideoFrameSource, VideoFrameRegion } from '../../../rendering/types/VideoFrameSource';
 import type { DecodedVideoFrame } from '../../../video/mediabunny/frame/VideoFrameDecoder';
 /**
  * Single-slot `VideoFrameSource`. {@link setCurrent} stores one
@@ -19,7 +19,9 @@ export declare class CurrentFrameVideoSource implements VideoFrameSource {
     setCurrent(timestamp: number, frame: DecodedVideoFrame): void;
     getFrameAt(timeSeconds: number, jpegQuality: number, region?: VideoFrameRegion): Promise<string>;
     private encode;
+    private cropTo;
+    private encodeJpeg;
+    private createCanvas;
     private clipToCanvas;
-    private blobToDataUrl;
 }
 //# sourceMappingURL=CurrentFrameVideoSource.d.ts.map

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

@@ -1 +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"}
+{"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,2CAA2C,CAAC;AACpG,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,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA2B;IAC/C,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;IAatG,OAAO,CAAC,MAAM;IAQd,OAAO,CAAC,MAAM;IA4Bd,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,YAAY;CAOrB"}

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

@@ -13,10 +13,10 @@ export class CurrentFrameVideoSource {
     ctx;
     currentTimestamp = null;
     constructor(width, height) {
-        this.canvas = new OffscreenCanvas(width, height);
+        this.canvas = this.createCanvas(width, height);
         const ctx = this.canvas.getContext('2d');
         if (!ctx) {
-            throw new Error('OffscreenCanvas 2D context is not available in this environment.');
+            throw new Error('Canvas 2D context is not available in this environment.');
         }
         this.ctx = ctx;
     }
@@ -36,24 +36,42 @@ export class CurrentFrameVideoSource {
             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));
+        return profiler.time('CurrentFrameVideoSource.encode', () => this.encode(region, jpegQuality));
     }
     encode(region, jpegQuality) {
-        if (!region) {
-            return this.canvas.convertToBlob({ type: 'image/jpeg', quality: jpegQuality });
+        const clipped = region ? this.clipToCanvas(region) : null;
+        if (!clipped || clipped.width === 0 || clipped.height === 0) {
+            return this.encodeJpeg(this.canvas, 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');
+        return this.encodeJpeg(this.cropTo(clipped), jpegQuality);
+    }
+    cropTo(clipped) {
+        const cropCanvas = this.createCanvas(clipped.width, clipped.height);
+        const cropCtx = profiler.time('CurrentFrameVideoSource.cropCanvasContext', () => cropCanvas.getContext('2d'));
         if (!cropCtx) {
-            throw new Error('OffscreenCanvas 2D context is not available for cropping.');
+            throw new Error('Canvas 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 });
+        profiler.time('CurrentFrameVideoSource.cropDraw', () => cropCtx.drawImage(this.canvas, clipped.x, clipped.y, clipped.width, clipped.height, 0, 0, clipped.width, clipped.height));
+        return cropCanvas;
+    }
+    // Chosen for predictability over raw speed. `toDataURL` encodes inline;
+    // `OffscreenCanvas.convertToBlob` defers to the browser's async image
+    // scheduler, which was measured taking ~1s per call instead of the usual
+    // few ms, under a load that could not be pinned down or reproduced.
+    // Output is byte-identical between the two on Chrome and Firefox, and the
+    // async overhead is per-call rather than per-pixel, so the two only differ
+    // meaningfully at small crop sizes. The tradeoff accepted here is that
+    // encoding inline blocks the main thread for the whole encode, and that a
+    // DOM canvas rules out ever running this step in a Worker.
+    // Benchmarked in experiments/jpeg-encode-apis/.
+    encodeJpeg(canvas, jpegQuality) {
+        return profiler.time('CurrentFrameVideoSource.encodeJpeg', () => canvas.toDataURL('image/jpeg', jpegQuality));
+    }
+    createCanvas(width, height) {
+        const canvas = document.createElement('canvas');
+        canvas.width = width;
+        canvas.height = height;
+        return canvas;
     }
     clipToCanvas(region) {
         const x = Math.max(0, Math.floor(region.x));
@@ -62,13 +80,5 @@ export class CurrentFrameVideoSource {
         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

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

@@ -4,8 +4,9 @@ import type { OverlayFrame } from '../../../rendering/OverlayFrameRenderer';
 /**
  * The inputs the compositor needs to produce one output frame: the
  * decoded source frame, the per-timestamp caption layer, the
- * frame-invariant overlay, and the target dimensions. Layer order is
- * the compositor's call, not the request's.
+ * frame-invariant overlay, an optional top actor-cutout layer, and
+ * the target dimensions. Layer order is the compositor's call, not
+ * the request's.
  */
 export interface FrameCompositionRequest {
     /** Decoded source frame for this output frame. */
@@ -14,6 +15,12 @@ export interface FrameCompositionRequest {
     readonly captions: SubtitleFrame | null;
     /** Frame-invariant decoration. `null` when no overlay was supplied. */
     readonly overlay: OverlayFrame | null;
+    /**
+     * Per-timestamp top layer painted after the captions — used by
+     * effects that must occlude the captions (e.g. text-behind-actor).
+     * `null` when no top layer applies to this frame.
+     */
+    readonly topLayer: OverlayFrame | null;
     /** Width in pixels of the composition target. */
     readonly width: number;
     /** Height in pixels of the composition target. */

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

@@ -1 +1 @@
-{"version":3,"file":"FrameCompositor.d.ts","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/frame/FrameCompositor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mDAAmD,CAAC;AAC3F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAC;AAC9E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAE5E;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,kDAAkD;IAClD,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAClC,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;IACxC,uEAAuE;IACvE,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IACtC,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,CACL,MAAM,EAAE,iCAAiC,GAAG,wBAAwB,EACpE,OAAO,EAAE,uBAAuB,GAC/B,IAAI,CAAC;CACT"}
+{"version":3,"file":"FrameCompositor.d.ts","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/frame/FrameCompositor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mDAAmD,CAAC;AAC3F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAC;AAC9E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAE5E;;;;;;GAMG;AACH,MAAM,WAAW,uBAAuB;IACtC,kDAAkD;IAClD,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAClC,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;IACxC,uEAAuE;IACvE,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IACtC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IACvC,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,CACL,MAAM,EAAE,iCAAiC,GAAG,wBAAwB,EACpE,OAAO,EAAE,uBAAuB,GAC/B,IAAI,CAAC;CACT"}

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

@@ -1,8 +1,11 @@
 import type { FrameCompositionRequest, FrameCompositor } from '../../../video/mediabunny/frame/FrameCompositor';
 /**
  * Paints the source frame at the base, then the frame-invariant
- * overlay on top of it, then the per-timestamp subtitle layer on top
- * of both — captions stay readable through any overlay decoration.
+ * overlay on top of it, then the per-timestamp subtitle layer, then
+ * the optional top layer used by effects that need to occlude the
+ * captions (e.g. text-behind-actor). Captions stay readable through
+ * any overlay decoration; the top layer, when supplied, paints on top
+ * of the captions.
  */
 export declare class LayeredFrameCompositor implements FrameCompositor {
     compose(target: OffscreenCanvasRenderingContext2D | CanvasRenderingContext2D, request: FrameCompositionRequest): void;

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

@@ -1 +1 @@
-{"version":3,"file":"LayeredFrameCompositor.d.ts","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/frame/LayeredFrameCompositor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,eAAe,EAChB,MAAM,iDAAiD,CAAC;AAEzD;;;;GAIG;AACH,qBAAa,sBAAuB,YAAW,eAAe;IAE5D,OAAO,CACL,MAAM,EAAE,iCAAiC,GAAG,wBAAwB,EACpE,OAAO,EAAE,uBAAuB,GAC/B,IAAI;CASR"}
+{"version":3,"file":"LayeredFrameCompositor.d.ts","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/frame/LayeredFrameCompositor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,eAAe,EAChB,MAAM,iDAAiD,CAAC;AAEzD;;;;;;;GAOG;AACH,qBAAa,sBAAuB,YAAW,eAAe;IAE5D,OAAO,CACL,MAAM,EAAE,iCAAiC,GAAG,wBAAwB,EACpE,OAAO,EAAE,uBAAuB,GAC/B,IAAI;CAYR"}

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

@@ -1,7 +1,10 @@
 /**
  * Paints the source frame at the base, then the frame-invariant
- * overlay on top of it, then the per-timestamp subtitle layer on top
- * of both — captions stay readable through any overlay decoration.
+ * overlay on top of it, then the per-timestamp subtitle layer, then
+ * the optional top layer used by effects that need to occlude the
+ * captions (e.g. text-behind-actor). Captions stay readable through
+ * any overlay decoration; the top layer, when supplied, paints on top
+ * of the captions.
  */
 export class LayeredFrameCompositor {
     compose(target, request) {
@@ -12,6 +15,9 @@ export class LayeredFrameCompositor {
         if (request.captions) {
             request.captions.draw(target, 0, 0, request.width, request.height);
         }
+        if (request.topLayer) {
+            request.topLayer.draw(target, 0, 0, request.width, request.height);
+        }
     }
 }
 //# sourceMappingURL=LayeredFrameCompositor.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"LayeredFrameCompositor.js","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/frame/LayeredFrameCompositor.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,MAAM,OAAO,sBAAsB;IAEjC,OAAO,CACL,MAAoE,EACpE,OAAgC;QAEhC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAChE,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"LayeredFrameCompositor.js","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/frame/LayeredFrameCompositor.ts"],"names":[],"mappings":"AAKA;;;;;;;GAOG;AACH,MAAM,OAAO,sBAAsB;IAEjC,OAAO,CACL,MAAoE,EACpE,OAAgC;QAEhC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAChE,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACrE,CAAC;QACD,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;CACF"}

package/dist/modules/video/mediabunny/painter/CaptionsOverlayFramePainter.d.ts

@@ -0,0 +1,35 @@
+import type { Document } from '../../../document/Document';
+import type { OverlayFrameRenderer } from '../../../rendering/OverlayFrameRenderer';
+import type { SubtitleStyle } from '../../../rendering/SubtitleFrameRenderer';
+import type { DecodedVideoFrame } from '../../../video/mediabunny/frame/VideoFrameDecoder';
+import type { FrameCompositor } from '../../../video/mediabunny/frame/FrameCompositor';
+import type { SubtitleLayerSource } from '../../../video/mediabunny/caption/SubtitleLayerSource';
+import type { TopLayerSource } from '../../../video/mediabunny/painter/TopLayerSource';
+import type { PaintFrame } from '../../../video/mediabunny/encoder/VideoTrackEncoder';
+import type { FramePainter } from '../../../video/mediabunny/painter/FramePainter';
+/**
+ * Paints each output frame as the source frame composited with a
+ * per-timestamp caption raster and a frame-invariant overlay. The
+ * caption strategy (batched, video-frame-bound, mixed) lives entirely
+ * behind the {@link SubtitleLayerSource} injected in the constructor.
+ *
+ * Single-use: one open/close cycle per instance. Build a fresh one for
+ * each transcode run through the factory.
+ */
+export declare class CaptionsOverlayFramePainter implements FramePainter {
+    private readonly subtitleLayer;
+    private readonly overlayRenderer;
+    private readonly frameCompositor;
+    private readonly document;
+    private readonly styles;
+    private readonly overlayHtml;
+    private readonly topLayer;
+    private width;
+    private height;
+    private overlay;
+    constructor(subtitleLayer: SubtitleLayerSource, overlayRenderer: OverlayFrameRenderer, frameCompositor: FrameCompositor, document: Document, styles: Readonly<Record<string, SubtitleStyle>>, overlayHtml: string | undefined, topLayer: TopLayerSource | null);
+    begin(width: number, height: number, fps: number): Promise<void>;
+    paint(frame: DecodedVideoFrame, _outputTimestamp: number): Promise<PaintFrame>;
+    end(): void;
+}
+//# sourceMappingURL=CaptionsOverlayFramePainter.d.ts.map

package/dist/modules/video/mediabunny/painter/CaptionsOverlayFramePainter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CaptionsOverlayFramePainter.d.ts","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/painter/CaptionsOverlayFramePainter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EAAgB,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAClG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAC;AAC9E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mDAAmD,CAAC;AAC3F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iDAAiD,CAAC;AACvF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uDAAuD,CAAC;AACjG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kDAAkD,CAAC;AACvF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qDAAqD,CAAC;AACtF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gDAAgD,CAAC;AAUnF;;;;;;;;GAQG;AACH,qBAAa,2BAA4B,YAAW,YAAY;IAO5D,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAX3B,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,OAAO,CAA6B;gBAGzB,aAAa,EAAE,mBAAmB,EAClC,eAAe,EAAE,oBAAoB,EACrC,eAAe,EAAE,eAAe,EAChC,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,EAC/C,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,QAAQ,EAAE,cAAc,GAAG,IAAI;IAG5C,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAahE,KAAK,CAAC,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAepF,GAAG,IAAI,IAAI;CAKZ"}

package/dist/modules/video/mediabunny/painter/CaptionsOverlayFramePainter.js

@@ -0,0 +1,69 @@
+/**
+ * Caption ticks step at the source's frame rate up to this cap. Past
+ * it, per-letter or per-word animations gain nothing from extra renders
+ * (the eye doesn't resolve sub-30fps differences in caption motion) and
+ * the per-batch subtitle decode dominates the render budget.
+ */
+const CAPTION_FPS_CAP = 30;
+/**
+ * Paints each output frame as the source frame composited with a
+ * per-timestamp caption raster and a frame-invariant overlay. The
+ * caption strategy (batched, video-frame-bound, mixed) lives entirely
+ * behind the {@link SubtitleLayerSource} injected in the constructor.
+ *
+ * Single-use: one open/close cycle per instance. Build a fresh one for
+ * each transcode run through the factory.
+ */
+export class CaptionsOverlayFramePainter {
+    subtitleLayer;
+    overlayRenderer;
+    frameCompositor;
+    document;
+    styles;
+    overlayHtml;
+    topLayer;
+    width = 0;
+    height = 0;
+    overlay = null;
+    constructor(subtitleLayer, overlayRenderer, frameCompositor, document, styles, overlayHtml, topLayer) {
+        this.subtitleLayer = subtitleLayer;
+        this.overlayRenderer = overlayRenderer;
+        this.frameCompositor = frameCompositor;
+        this.document = document;
+        this.styles = styles;
+        this.overlayHtml = overlayHtml;
+        this.topLayer = topLayer;
+    }
+    async begin(width, height, fps) {
+        this.width = width;
+        this.height = height;
+        const captionInterval = 1 / Math.min(fps, CAPTION_FPS_CAP);
+        await this.subtitleLayer.open(this.document, this.styles, width, height, captionInterval);
+        if (this.overlayHtml !== undefined) {
+            this.overlay = await this.overlayRenderer.render(this.overlayHtml, width, height);
+        }
+        if (this.topLayer !== null) {
+            await this.topLayer.open(width, height);
+        }
+    }
+    async paint(frame, _outputTimestamp) {
+        const captions = await this.subtitleLayer.frameAt(frame.timestamp, frame);
+        const topLayer = this.topLayer === null ? null : await this.topLayer.frameAt(frame.timestamp, frame);
+        return (ctx) => {
+            this.frameCompositor.compose(ctx, {
+                frame,
+                captions,
+                overlay: this.overlay,
+                topLayer,
+                width: this.width,
+                height: this.height,
+            });
+        };
+    }
+    end() {
+        this.subtitleLayer.close();
+        this.topLayer?.close();
+        this.overlay = null;
+    }
+}
+//# sourceMappingURL=CaptionsOverlayFramePainter.js.map

package/dist/modules/video/mediabunny/painter/CaptionsOverlayFramePainter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CaptionsOverlayFramePainter.js","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/painter/CaptionsOverlayFramePainter.ts"],"names":[],"mappings":"AAUA;;;;;GAKG;AACH,MAAM,eAAe,GAAG,EAAE,CAAC;AAE3B;;;;;;;;GAQG;AACH,MAAM,OAAO,2BAA2B;IAOnB;IACA;IACA;IACA;IACA;IACA;IACA;IAXX,KAAK,GAAG,CAAC,CAAC;IACV,MAAM,GAAG,CAAC,CAAC;IACX,OAAO,GAAwB,IAAI,CAAC;IAE5C,YACmB,aAAkC,EAClC,eAAqC,EACrC,eAAgC,EAChC,QAAkB,EAClB,MAA+C,EAC/C,WAA+B,EAC/B,QAA+B;QAN/B,kBAAa,GAAb,aAAa,CAAqB;QAClC,oBAAe,GAAf,eAAe,CAAsB;QACrC,oBAAe,GAAf,eAAe,CAAiB;QAChC,aAAQ,GAAR,QAAQ,CAAU;QAClB,WAAM,GAAN,MAAM,CAAyC;QAC/C,gBAAW,GAAX,WAAW,CAAoB;QAC/B,aAAQ,GAAR,QAAQ,CAAuB;IAC/C,CAAC;IAEJ,KAAK,CAAC,KAAK,CAAC,KAAa,EAAE,MAAc,EAAE,GAAW;QACpD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,MAAM,eAAe,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;QAC3D,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC;QAC1F,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YACnC,IAAI,CAAC,OAAO,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QACpF,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YAC3B,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAAwB,EAAE,gBAAwB;QAC5D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAC1E,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACrG,OAAO,CAAC,GAAG,EAAE,EAAE;YACb,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,GAAG,EAAE;gBAChC,KAAK;gBACL,QAAQ;gBACR,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,QAAQ;gBACR,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC,CAAC;QACL,CAAC,CAAC;IACJ,CAAC;IAED,GAAG;QACD,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;QAC3B,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACtB,CAAC;CACF"}

package/dist/modules/video/mediabunny/painter/CaptionsOverlayFramePainterFactory.d.ts

@@ -0,0 +1,23 @@
+import type { Document } from '../../../document/Document';
+import type { OverlayFrameRenderer } from '../../../rendering/OverlayFrameRenderer';
+import type { SubtitleStyle } from '../../../rendering/SubtitleFrameRenderer';
+import type { FrameCompositor } from '../../../video/mediabunny/frame/FrameCompositor';
+import type { SubtitleLayerSource } from '../../../video/mediabunny/caption/SubtitleLayerSource';
+import type { TopLayerSource } from '../../../video/mediabunny/painter/TopLayerSource';
+import { CaptionsOverlayFramePainter } from '../../../video/mediabunny/painter/CaptionsOverlayFramePainter';
+/**
+ * Builds a fresh {@link CaptionsOverlayFramePainter} bound to a
+ * specific document, style set, (optional) overlay HTML, and an
+ * (optional) top-layer source. The factory owns the shared,
+ * engine-wide dependencies (subtitle source, overlay renderer,
+ * compositor); each call to {@link create} returns a single-use
+ * painter for one transcode run.
+ */
+export declare class CaptionsOverlayFramePainterFactory {
+    private readonly subtitleLayer;
+    private readonly overlayRenderer;
+    private readonly frameCompositor;
+    constructor(subtitleLayer: SubtitleLayerSource, overlayRenderer: OverlayFrameRenderer, frameCompositor: FrameCompositor);
+    create(document: Document, styles: Readonly<Record<string, SubtitleStyle>>, overlayHtml: string | undefined, topLayer?: TopLayerSource | null): CaptionsOverlayFramePainter;
+}
+//# sourceMappingURL=CaptionsOverlayFramePainterFactory.d.ts.map

package/dist/modules/video/mediabunny/painter/CaptionsOverlayFramePainterFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CaptionsOverlayFramePainterFactory.d.ts","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/painter/CaptionsOverlayFramePainterFactory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AACpF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAC;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iDAAiD,CAAC;AACvF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uDAAuD,CAAC;AACjG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kDAAkD,CAAC;AACvF,OAAO,EAAE,2BAA2B,EAAE,MAAM,+DAA+D,CAAC;AAE5G;;;;;;;GAOG;AACH,qBAAa,kCAAkC;IAG3C,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,eAAe;gBAFf,aAAa,EAAE,mBAAmB,EAClC,eAAe,EAAE,oBAAoB,EACrC,eAAe,EAAE,eAAe;IAGnD,MAAM,CACJ,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,EAC/C,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,QAAQ,GAAE,cAAc,GAAG,IAAW,GACrC,2BAA2B;CAW/B"}

package/dist/modules/video/mediabunny/painter/CaptionsOverlayFramePainterFactory.js

@@ -0,0 +1,23 @@
+import { CaptionsOverlayFramePainter } from '../../../video/mediabunny/painter/CaptionsOverlayFramePainter';
+/**
+ * Builds a fresh {@link CaptionsOverlayFramePainter} bound to a
+ * specific document, style set, (optional) overlay HTML, and an
+ * (optional) top-layer source. The factory owns the shared,
+ * engine-wide dependencies (subtitle source, overlay renderer,
+ * compositor); each call to {@link create} returns a single-use
+ * painter for one transcode run.
+ */
+export class CaptionsOverlayFramePainterFactory {
+    subtitleLayer;
+    overlayRenderer;
+    frameCompositor;
+    constructor(subtitleLayer, overlayRenderer, frameCompositor) {
+        this.subtitleLayer = subtitleLayer;
+        this.overlayRenderer = overlayRenderer;
+        this.frameCompositor = frameCompositor;
+    }
+    create(document, styles, overlayHtml, topLayer = null) {
+        return new CaptionsOverlayFramePainter(this.subtitleLayer, this.overlayRenderer, this.frameCompositor, document, styles, overlayHtml, topLayer);
+    }
+}
+//# sourceMappingURL=CaptionsOverlayFramePainterFactory.js.map

package/dist/modules/video/mediabunny/painter/CaptionsOverlayFramePainterFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CaptionsOverlayFramePainterFactory.js","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/painter/CaptionsOverlayFramePainterFactory.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,2BAA2B,EAAE,MAAM,+DAA+D,CAAC;AAE5G;;;;;;;GAOG;AACH,MAAM,OAAO,kCAAkC;IAG1B;IACA;IACA;IAHnB,YACmB,aAAkC,EAClC,eAAqC,EACrC,eAAgC;QAFhC,kBAAa,GAAb,aAAa,CAAqB;QAClC,oBAAe,GAAf,eAAe,CAAsB;QACrC,oBAAe,GAAf,eAAe,CAAiB;IAChD,CAAC;IAEJ,MAAM,CACJ,QAAkB,EAClB,MAA+C,EAC/C,WAA+B,EAC/B,WAAkC,IAAI;QAEtC,OAAO,IAAI,2BAA2B,CACpC,IAAI,CAAC,aAAa,EAClB,IAAI,CAAC,eAAe,EACpB,IAAI,CAAC,eAAe,EACpB,QAAQ,EACR,MAAM,EACN,WAAW,EACX,QAAQ,CACT,CAAC;IACJ,CAAC;CACF"}

package/dist/modules/video/mediabunny/painter/FramePainter.d.ts

@@ -0,0 +1,46 @@
+import type { DecodedVideoFrame } from '../../../video/mediabunny/frame/VideoFrameDecoder';
+import type { PaintFrame } from '../../../video/mediabunny/encoder/VideoTrackEncoder';
+/**
+ * Owns the pixel work for a single transcode run: what to draw into
+ * every output frame's canvas. The transcode coordinator owns the
+ * encode loop and decides *when* each frame runs; the painter decides
+ * *what* the frame looks like.
+ *
+ * Lifecycle is per-run: {@link begin} once at the start with the
+ * resolved output dimensions and source frame rate, {@link paint} for
+ * each decoded frame in monotonically advancing source-time order, and
+ * {@link end} once at the end (called on both success and failure).
+ * Instances are single-use unless the concrete class documents
+ * otherwise.
+ *
+ * The two-step {@link paint} contract exists because
+ * {@link VideoTrackEncoder.encode} takes a synchronous paint callback:
+ * any per-frame work that has to be awaited (e.g. rasterizing a
+ * caption layer) happens inside {@link paint}, and the returned
+ * closure runs synchronously against the encoder's canvas.
+ */
+export interface FramePainter {
+    /**
+     * Opens per-run resources (e.g. caption source, overlay raster) for
+     * a run at the given output pixel dimensions. `fps` is the source
+     * frame rate the coordinator resolved — implementations may cap or
+     * quantize it as they see fit.
+     */
+    begin(width: number, height: number, fps: number): Promise<void>;
+    /**
+     * Resolves any per-frame state asynchronously and returns the
+     * synchronous paint step the encoder will run. `outputTimestamp` is
+     * the frame's presentation time on the output timeline (already
+     * mapped through any skip ranges by the caller); `frame.timestamp`
+     * carries the source-timeline time and stays authoritative for any
+     * lookup against source-aligned data (captions, per-source overlays).
+     */
+    paint(frame: DecodedVideoFrame, outputTimestamp: number): Promise<PaintFrame>;
+    /**
+     * Releases the per-run resources opened by {@link begin}. Called on
+     * both success and failure paths of the enclosing run. Idempotent:
+     * safe to call before or after {@link begin} succeeds.
+     */
+    end(): void;
+}
+//# sourceMappingURL=FramePainter.d.ts.map

package/dist/modules/video/mediabunny/painter/FramePainter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FramePainter.d.ts","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/painter/FramePainter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mDAAmD,CAAC;AAC3F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qDAAqD,CAAC;AAEtF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;OAKG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjE;;;;;;;OAOG;IACH,KAAK,CAAC,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAE9E;;;;OAIG;IACH,GAAG,IAAI,IAAI,CAAC;CACb"}

package/dist/modules/video/mediabunny/painter/FramePainter.js

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

package/dist/modules/video/mediabunny/painter/FramePainter.js.map

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

package/dist/modules/video/mediabunny/painter/TopLayerSource.d.ts

@@ -0,0 +1,24 @@
+import type { OverlayFrame } from '../../../rendering/OverlayFrameRenderer';
+import type { DecodedVideoFrame } from '../../../video/mediabunny/frame/VideoFrameDecoder';
+/**
+ * Produces one on-top raster per video frame — the layer the
+ * compositor paints above the caption layer. Consumers use it to
+ * occlude the captions with an effect (a person cutout, a
+ * frame-locked decoration) whose pixels depend on the source frame.
+ *
+ * Lifecycle mirrors {@link SubtitleLayerSource}: {@link open} prepares
+ * the source for a render at the given output dimensions,
+ * {@link frameAt} services each video frame in monotonically advancing
+ * `time` order, and {@link close} releases resources. Open/close pairs
+ * may repeat against the same instance, but a source cannot serve two
+ * renders concurrently.
+ *
+ * `frameAt` returns `null` when this frame has no on-top layer to
+ * paint; the compositor then skips the layer entirely for that frame.
+ */
+export interface TopLayerSource {
+    open(width: number, height: number): Promise<void>;
+    frameAt(time: number, videoFrame: DecodedVideoFrame): Promise<OverlayFrame | null>;
+    close(): void;
+}
+//# sourceMappingURL=TopLayerSource.d.ts.map

package/dist/modules/video/mediabunny/painter/TopLayerSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TopLayerSource.d.ts","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/painter/TopLayerSource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAC5E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mDAAmD,CAAC;AAE3F;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnD,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAEnF,KAAK,IAAI,IAAI,CAAC;CACf"}

package/dist/modules/video/mediabunny/painter/TopLayerSource.js

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