@blockcast/mmt-render 0.1.0-main.0c300647d0a5

package/dist/video/keyframe-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyframe-gate.d.ts","sourceRoot":"","sources":["../../src/video/keyframe-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,qBAAa,YAAY;;IAGvB,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED;;;OAGG;IACH,KAAK,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO;IASjC,mDAAmD;IACnD,KAAK,IAAI,IAAI;CAGd"}

package/dist/video/keyframe-gate.js

@@ -0,0 +1,39 @@
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
+var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
+
+// src/video/keyframe-gate.ts
+var _open;
+var KeyframeGate = class {
+  constructor() {
+    __privateAdd(this, _open, false);
+  }
+  get isOpen() {
+    return __privateGet(this, _open);
+  }
+  /**
+   * Decide whether to pass a frame through.
+   * Opens permanently once the first keyframe is seen.
+   */
+  allow(keyframe) {
+    if (__privateGet(this, _open)) return true;
+    if (keyframe) {
+      __privateSet(this, _open, true);
+      return true;
+    }
+    return false;
+  }
+  /** Re-close the gate. Next keyframe reopens it. */
+  reset() {
+    __privateSet(this, _open, false);
+  }
+};
+_open = new WeakMap();
+export {
+  KeyframeGate
+};
+//# sourceMappingURL=keyframe-gate.js.map

package/dist/video/keyframe-gate.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/video/keyframe-gate.ts"],
+  "sourcesContent": ["/**\n * KeyframeGate \u2014 drops delta frames until a keyframe arrives.\n *\n * Required when subscribing mid-stream: the relay may deliver P/B frames\n * from the middle of a GOP before the first IDR. Feeding those into\n * VideoDecoder before an init yields \"key frame required\" errors.\n *\n * Call reset() to re-arm the gate after a decoder error (requestKeyframe).\n */\n\nexport class KeyframeGate {\n  #open = false\n\n  get isOpen(): boolean {\n    return this.#open\n  }\n\n  /**\n   * Decide whether to pass a frame through.\n   * Opens permanently once the first keyframe is seen.\n   */\n  allow(keyframe: boolean): boolean {\n    if (this.#open) return true\n    if (keyframe) {\n      this.#open = true\n      return true\n    }\n    return false\n  }\n\n  /** Re-close the gate. Next keyframe reopens it. */\n  reset(): void {\n    this.#open = false\n  }\n}\n"],
+  "mappings": ";;;;;;;;;AAAA;AAUO,IAAM,eAAN,MAAmB;AAAA,EAAnB;AACL,8BAAQ;AAAA;AAAA,EAER,IAAI,SAAkB;AACpB,WAAO,mBAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,UAA4B;AAChC,QAAI,mBAAK,OAAO,QAAO;AACvB,QAAI,UAAU;AACZ,yBAAK,OAAQ;AACb,aAAO;AAAA,IACT;AACA,WAAO;AAAA,EACT;AAAA;AAAA,EAGA,QAAc;AACZ,uBAAK,OAAQ;AAAA,EACf;AACF;AAvBE;",
+  "names": []
+}

package/dist/video/video-render-pipeline.d.ts

@@ -0,0 +1,60 @@
+/**
+ * VideoRenderPipeline — end-to-end video render for MoQ/MMT players.
+ *
+ * Pipeline: MoQ object → MmtpDecodePipeline → keyframe gate → WebCodecs
+ *           VideoDecoder → consumer's onFrame(VideoFrame).
+ *
+ * Replaces:
+ *   - moqtail's `decodeQueueSize > 10 drop-deltas` hack in webcodecs-backend.ts
+ *   - hang-mmt-fec's "reorderWindow = 0 // TODO" in video/decoder.ts
+ *
+ * Pacing uses FrameCountPacer (anchor on first decoded picture, frame count ×
+ * 1/fps) with threshold = mapper.pacingThresholdMs. Reorder window comes from
+ * mapper.d (groups per FEC block), which is the natural bound for out-of-order
+ * delivery within a block after converting catalog groups to frame count.
+ */
+import { type PipelineFecClient } from '@blockcast/mmt-container/mmtp-decode-pipeline';
+import type { MfuReassemblyPolicy } from '@blockcast/mmt-container/mfu-reassembly-policy';
+import type { FecBlockMapper } from '@blockcast/mmt-fec';
+export interface VideoFrameMeta {
+    timestamp: number;
+    keyframe: boolean;
+    packetId: number;
+}
+export type VideoFrameCallback = (frame: VideoFrame, meta: VideoFrameMeta) => void;
+export declare function deriveVideoReorderWindow(framerate: number, mapper: Pick<FecBlockMapper, 'd' | 'gopDurationMs'>): number;
+export interface VideoRenderPipelineOpts {
+    codec: string;
+    /** MMTP packet_id for this video track — from catalog. */
+    packetId?: number;
+    description?: Uint8Array;
+    width: number;
+    height: number;
+    /** Frames per second (used for pacing + default reorder window). */
+    framerate: number;
+    mapper: FecBlockMapper;
+    fecClient?: PipelineFecClient;
+    /** Reliable MoQ is clock-free; datagram deadlines come from catalog/in-band timing. */
+    reassemblyPolicy: MfuReassemblyPolicy;
+    /** Receives VideoFrames ready to render. */
+    onFrame: VideoFrameCallback;
+    /** Called on decoder errors. */
+    onError?: (err: unknown) => void;
+    /** Reorder window in frames. Defaults to one catalog-derived FEC block. */
+    reorderWindow?: number;
+    /** Warmup frames before pacing engages. Default 3 (absorbs decoder init jitter). */
+    warmupFrames?: number;
+    /** Optional decoder hardware acceleration hint. */
+    hardwareAcceleration?: HardwareAcceleration;
+}
+export declare class VideoRenderPipeline {
+    #private;
+    constructor(opts: VideoRenderPipelineOpts);
+    feedMoqObject(packet: Uint8Array): void;
+    paceSleepMs(): number;
+    get pacerSnapshot(): import("../pacing/frame-pacer.js").PacerSnapshot;
+    /** Request a fresh keyframe after a decoder error (or source switch). */
+    reset(): void;
+    close(): void;
+}
+//# sourceMappingURL=video-render-pipeline.d.ts.map

package/dist/video/video-render-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-render-pipeline.d.ts","sourceRoot":"","sources":["../../src/video/video-render-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAsB,KAAK,iBAAiB,EAAE,MAAM,+CAA+C,CAAA;AAC1G,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gDAAgD,CAAA;AACzF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAIxD,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,OAAO,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,KAAK,IAAI,CAAA;AAElF,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,GAAG,GAAG,eAAe,CAAC,GAClD,MAAM,CAGR;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAA;IACb,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,UAAU,CAAA;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,oEAAoE;IACpE,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,cAAc,CAAA;IACtB,SAAS,CAAC,EAAE,iBAAiB,CAAA;IAC7B,uFAAuF;IACvF,gBAAgB,EAAE,mBAAmB,CAAA;IACrC,4CAA4C;IAC5C,OAAO,EAAE,kBAAkB,CAAA;IAC3B,gCAAgC;IAChC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAA;IAChC,2EAA2E;IAC3E,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,oFAAoF;IACpF,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,mDAAmD;IACnD,oBAAoB,CAAC,EAAE,oBAAoB,CAAA;CAC5C;AAED,qBAAa,mBAAmB;;gBASlB,IAAI,EAAE,uBAAuB;IAWzC,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAIvC,WAAW,IAAI,MAAM;IAIrB,IAAI,aAAa,qDAEhB;IAED,yEAAyE;IACzE,KAAK,IAAI,IAAI;IAQb,KAAK,IAAI,IAAI;CA0Ed"}

package/dist/video/video-render-pipeline.js

@@ -0,0 +1,247 @@
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
+var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
+var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "access private method"), method);
+var __privateWrapper = (obj, member, setter, getter) => ({
+  set _(value) {
+    __privateSet(obj, member, value, setter);
+  },
+  get _() {
+    return __privateGet(obj, member, getter);
+  }
+});
+
+// src/video/video-render-pipeline.ts
+import { MmtpDecodePipeline } from "@blockcast/mmt-container/mmtp-decode-pipeline";
+
+// src/pacing/frame-pacer.ts
+var _frameCount, _anchorWallMs, _anchored;
+var FrameCountPacer = class {
+  constructor(opts) {
+    __privateAdd(this, _frameCount, 0);
+    __privateAdd(this, _anchorWallMs, 0);
+    __privateAdd(this, _anchored, false);
+    if (!(opts.frameDurationMs > 0)) {
+      throw new Error("frameDurationMs must be > 0");
+    }
+    this.frameDurationMs = opts.frameDurationMs;
+    this.thresholdMs = opts.mapper.pacingThresholdMs;
+    this.warmupFrames = Math.max(0, opts.warmupFrames ?? 0);
+  }
+  /** Call on every emitted decoded frame (AU or picture). Anchors on first call. */
+  notifyFrame() {
+    if (!__privateGet(this, _anchored)) {
+      __privateSet(this, _anchorWallMs, now());
+      __privateSet(this, _anchored, true);
+    }
+    __privateWrapper(this, _frameCount)._++;
+  }
+  /**
+   * Compute sleep ms before reading the next MoQ object.
+   * Returns 0 when:
+   *   - pacing is disabled (NullBlockMapper → threshold=0)
+   *   - the anchor is not yet set
+   *   - still in warmup
+   *   - decoder is not ahead of wall clock by more than threshold
+   * Otherwise returns aheadMs - thresholdMs/2 (leaves half the threshold as headroom).
+   */
+  computeSleepMs() {
+    if (this.thresholdMs <= 0) return 0;
+    if (!__privateGet(this, _anchored)) return 0;
+    if (__privateGet(this, _frameCount) <= this.warmupFrames) return 0;
+    const mediaMs = __privateGet(this, _frameCount) * this.frameDurationMs;
+    const wallMs = now() - __privateGet(this, _anchorWallMs);
+    const aheadMs = mediaMs - wallMs;
+    if (aheadMs <= this.thresholdMs) return 0;
+    return aheadMs - this.thresholdMs / 2;
+  }
+  /** Reset anchor + counter. Call on source switch (MoQ ↔ multicast). */
+  reset() {
+    __privateSet(this, _frameCount, 0);
+    __privateSet(this, _anchorWallMs, 0);
+    __privateSet(this, _anchored, false);
+  }
+  get snapshot() {
+    const mediaMs = __privateGet(this, _frameCount) * this.frameDurationMs;
+    const wallMs = __privateGet(this, _anchored) ? now() - __privateGet(this, _anchorWallMs) : 0;
+    return {
+      frameCount: __privateGet(this, _frameCount),
+      mediaMs,
+      wallMs,
+      aheadMs: mediaMs - wallMs,
+      thresholdMs: this.thresholdMs,
+      anchored: __privateGet(this, _anchored)
+    };
+  }
+};
+_frameCount = new WeakMap();
+_anchorWallMs = new WeakMap();
+_anchored = new WeakMap();
+function now() {
+  if (typeof performance !== "undefined" && typeof performance.now === "function") {
+    return performance.now();
+  }
+  return Date.now();
+}
+
+// src/video/keyframe-gate.ts
+var _open;
+var KeyframeGate = class {
+  constructor() {
+    __privateAdd(this, _open, false);
+  }
+  get isOpen() {
+    return __privateGet(this, _open);
+  }
+  /**
+   * Decide whether to pass a frame through.
+   * Opens permanently once the first keyframe is seen.
+   */
+  allow(keyframe) {
+    if (__privateGet(this, _open)) return true;
+    if (keyframe) {
+      __privateSet(this, _open, true);
+      return true;
+    }
+    return false;
+  }
+  /** Re-close the gate. Next keyframe reopens it. */
+  reset() {
+    __privateSet(this, _open, false);
+  }
+};
+_open = new WeakMap();
+
+// src/video/video-render-pipeline.ts
+function deriveVideoReorderWindow(framerate, mapper) {
+  const framesPerGroup = Math.ceil(framerate * mapper.gopDurationMs / 1e3);
+  return mapper.d * framesPerGroup;
+}
+var _pacer, _gate, _opts, _decoder, _pipeline, _closed, _VideoRenderPipeline_instances, init_fn, configureDecoder_fn;
+var VideoRenderPipeline = class {
+  constructor(opts) {
+    __privateAdd(this, _VideoRenderPipeline_instances);
+    __privateAdd(this, _pacer);
+    __privateAdd(this, _gate, new KeyframeGate());
+    __privateAdd(this, _opts);
+    __privateAdd(this, _decoder, null);
+    __privateAdd(this, _pipeline, null);
+    __privateAdd(this, _closed, false);
+    if (!(opts.framerate > 0)) throw new Error("framerate must be > 0");
+    __privateSet(this, _opts, opts);
+    __privateSet(this, _pacer, new FrameCountPacer({
+      frameDurationMs: 1e3 / opts.framerate,
+      mapper: opts.mapper,
+      warmupFrames: opts.warmupFrames ?? 3
+    }));
+    __privateMethod(this, _VideoRenderPipeline_instances, init_fn).call(this);
+  }
+  feedMoqObject(packet) {
+    __privateGet(this, _pipeline)?.feedMoqObject(packet);
+  }
+  paceSleepMs() {
+    return __privateGet(this, _pacer).computeSleepMs();
+  }
+  get pacerSnapshot() {
+    return __privateGet(this, _pacer).snapshot;
+  }
+  /** Request a fresh keyframe after a decoder error (or source switch). */
+  reset() {
+    __privateGet(this, _gate).reset();
+    __privateGet(this, _pacer).reset();
+    try {
+      __privateGet(this, _decoder)?.reset();
+    } catch {
+    }
+    __privateMethod(this, _VideoRenderPipeline_instances, configureDecoder_fn).call(this);
+  }
+  close() {
+    if (__privateGet(this, _closed)) return;
+    __privateSet(this, _closed, true);
+    try {
+      __privateGet(this, _decoder)?.close();
+    } catch {
+    }
+    try {
+      __privateGet(this, _pipeline)?.dispose();
+    } catch {
+    }
+    __privateSet(this, _decoder, null);
+    __privateSet(this, _pipeline, null);
+  }
+};
+_pacer = new WeakMap();
+_gate = new WeakMap();
+_opts = new WeakMap();
+_decoder = new WeakMap();
+_pipeline = new WeakMap();
+_closed = new WeakMap();
+_VideoRenderPipeline_instances = new WeakSet();
+// ─── Private ─────────────────────────────────────────────────────
+init_fn = function() {
+  __privateMethod(this, _VideoRenderPipeline_instances, configureDecoder_fn).call(this);
+  const pipeline = new MmtpDecodePipeline();
+  const reorderWindow = __privateGet(this, _opts).reorderWindow ?? deriveVideoReorderWindow(__privateGet(this, _opts).framerate, __privateGet(this, _opts).mapper);
+  pipeline.configure({
+    codec: __privateGet(this, _opts).codec,
+    packetId: __privateGet(this, _opts).packetId,
+    description: __privateGet(this, _opts).description,
+    reorderWindow,
+    framerate: __privateGet(this, _opts).framerate,
+    groupDurationMs: __privateGet(this, _opts).mapper.gopDurationMs,
+    reassemblyPolicy: __privateGet(this, _opts).reassemblyPolicy
+  });
+  if (__privateGet(this, _opts).fecClient) pipeline.setFecClient(__privateGet(this, _opts).fecClient);
+  pipeline.onFrame((codecData, meta) => {
+    if (__privateGet(this, _closed) || !__privateGet(this, _decoder)) return;
+    if (codecData.byteLength === 0) return;
+    if (!__privateGet(this, _gate).allow(meta.keyframe)) return;
+    __privateGet(this, _pacer).notifyFrame();
+    try {
+      __privateGet(this, _decoder).decode(new EncodedVideoChunk({
+        type: meta.keyframe ? "key" : "delta",
+        data: codecData,
+        timestamp: meta.timestamp
+      }));
+    } catch (err) {
+      __privateGet(this, _opts).onError?.(err);
+      this.reset();
+    }
+  });
+  __privateSet(this, _pipeline, pipeline);
+};
+configureDecoder_fn = function() {
+  try {
+    __privateGet(this, _decoder)?.close();
+  } catch {
+  }
+  const userMeta = { timestamp: 0, keyframe: false, packetId: 0 };
+  const decoder = new VideoDecoder({
+    output: (frame) => {
+      userMeta.timestamp = frame.timestamp;
+      __privateGet(this, _opts).onFrame(frame, userMeta);
+    },
+    error: (err) => {
+      __privateGet(this, _opts).onError?.(err);
+      __privateGet(this, _gate).reset();
+    }
+  });
+  const config = {
+    codec: __privateGet(this, _opts).codec,
+    codedWidth: __privateGet(this, _opts).width,
+    codedHeight: __privateGet(this, _opts).height,
+    ...__privateGet(this, _opts).description ? { description: __privateGet(this, _opts).description } : {},
+    ...__privateGet(this, _opts).hardwareAcceleration ? { hardwareAcceleration: __privateGet(this, _opts).hardwareAcceleration } : {}
+  };
+  decoder.configure(config);
+  __privateSet(this, _decoder, decoder);
+};
+export {
+  VideoRenderPipeline,
+  deriveVideoReorderWindow
+};
+//# sourceMappingURL=video-render-pipeline.js.map

package/dist/video/video-render-pipeline.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/video/video-render-pipeline.ts", "../../src/pacing/frame-pacer.ts", "../../src/video/keyframe-gate.ts"],
+  "sourcesContent": ["/**\n * VideoRenderPipeline \u2014 end-to-end video render for MoQ/MMT players.\n *\n * Pipeline: MoQ object \u2192 MmtpDecodePipeline \u2192 keyframe gate \u2192 WebCodecs\n *           VideoDecoder \u2192 consumer's onFrame(VideoFrame).\n *\n * Replaces:\n *   - moqtail's `decodeQueueSize > 10 drop-deltas` hack in webcodecs-backend.ts\n *   - hang-mmt-fec's \"reorderWindow = 0 // TODO\" in video/decoder.ts\n *\n * Pacing uses FrameCountPacer (anchor on first decoded picture, frame count \u00D7\n * 1/fps) with threshold = mapper.pacingThresholdMs. Reorder window comes from\n * mapper.d (groups per FEC block), which is the natural bound for out-of-order\n * delivery within a block after converting catalog groups to frame count.\n */\n\nimport { MmtpDecodePipeline, type PipelineFecClient } from '@blockcast/mmt-container/mmtp-decode-pipeline'\nimport type { MfuReassemblyPolicy } from '@blockcast/mmt-container/mfu-reassembly-policy'\nimport type { FecBlockMapper } from '@blockcast/mmt-fec'\nimport { FrameCountPacer } from '../pacing/frame-pacer.js'\nimport { KeyframeGate } from './keyframe-gate.js'\n\nexport interface VideoFrameMeta {\n  timestamp: number\n  keyframe: boolean\n  packetId: number\n}\n\nexport type VideoFrameCallback = (frame: VideoFrame, meta: VideoFrameMeta) => void\n\nexport function deriveVideoReorderWindow(\n  framerate: number,\n  mapper: Pick<FecBlockMapper, 'd' | 'gopDurationMs'>,\n): number {\n  const framesPerGroup = Math.ceil(framerate * mapper.gopDurationMs / 1000)\n  return mapper.d * framesPerGroup\n}\n\nexport interface VideoRenderPipelineOpts {\n  codec: string\n  /** MMTP packet_id for this video track \u2014 from catalog. */\n  packetId?: number\n  description?: Uint8Array\n  width: number\n  height: number\n  /** Frames per second (used for pacing + default reorder window). */\n  framerate: number\n  mapper: FecBlockMapper\n  fecClient?: PipelineFecClient\n  /** Reliable MoQ is clock-free; datagram deadlines come from catalog/in-band timing. */\n  reassemblyPolicy: MfuReassemblyPolicy\n  /** Receives VideoFrames ready to render. */\n  onFrame: VideoFrameCallback\n  /** Called on decoder errors. */\n  onError?: (err: unknown) => void\n  /** Reorder window in frames. Defaults to one catalog-derived FEC block. */\n  reorderWindow?: number\n  /** Warmup frames before pacing engages. Default 3 (absorbs decoder init jitter). */\n  warmupFrames?: number\n  /** Optional decoder hardware acceleration hint. */\n  hardwareAcceleration?: HardwareAcceleration\n}\n\nexport class VideoRenderPipeline {\n  readonly #pacer: FrameCountPacer\n  readonly #gate = new KeyframeGate()\n  readonly #opts: VideoRenderPipelineOpts\n\n  #decoder: VideoDecoder | null = null\n  #pipeline: MmtpDecodePipeline | null = null\n  #closed = false\n\n  constructor(opts: VideoRenderPipelineOpts) {\n    if (!(opts.framerate > 0)) throw new Error('framerate must be > 0')\n    this.#opts = opts\n    this.#pacer = new FrameCountPacer({\n      frameDurationMs: 1000 / opts.framerate,\n      mapper: opts.mapper,\n      warmupFrames: opts.warmupFrames ?? 3,\n    })\n    this.#init()\n  }\n\n  feedMoqObject(packet: Uint8Array): void {\n    this.#pipeline?.feedMoqObject(packet)\n  }\n\n  paceSleepMs(): number {\n    return this.#pacer.computeSleepMs()\n  }\n\n  get pacerSnapshot() {\n    return this.#pacer.snapshot\n  }\n\n  /** Request a fresh keyframe after a decoder error (or source switch). */\n  reset(): void {\n    this.#gate.reset()\n    this.#pacer.reset()\n    try { this.#decoder?.reset() } catch { /* may be closed */ }\n    // Re-configure so the decoder is ready for the next keyframe.\n    this.#configureDecoder()\n  }\n\n  close(): void {\n    if (this.#closed) return\n    this.#closed = true\n    try { this.#decoder?.close() } catch { /* noop */ }\n    try { this.#pipeline?.dispose() } catch { /* noop */ }\n    this.#decoder = null\n    this.#pipeline = null\n  }\n\n  // \u2500\u2500\u2500 Private \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  #init(): void {\n    this.#configureDecoder()\n\n    const pipeline = new MmtpDecodePipeline()\n    const reorderWindow = this.#opts.reorderWindow\n      ?? deriveVideoReorderWindow(this.#opts.framerate, this.#opts.mapper)\n    pipeline.configure({\n      codec: this.#opts.codec,\n      packetId: this.#opts.packetId,\n      description: this.#opts.description,\n      reorderWindow,\n      framerate: this.#opts.framerate,\n      groupDurationMs: this.#opts.mapper.gopDurationMs,\n      reassemblyPolicy: this.#opts.reassemblyPolicy,\n    })\n    if (this.#opts.fecClient) pipeline.setFecClient(this.#opts.fecClient)\n\n    pipeline.onFrame((codecData, meta) => {\n      if (this.#closed || !this.#decoder) return\n      if (codecData.byteLength === 0) return\n      if (!this.#gate.allow(meta.keyframe)) return\n\n      this.#pacer.notifyFrame()\n      try {\n        this.#decoder.decode(new EncodedVideoChunk({\n          type: meta.keyframe ? 'key' : 'delta',\n          data: codecData,\n          timestamp: meta.timestamp,\n        }))\n      } catch (err) {\n        this.#opts.onError?.(err)\n        this.reset()\n      }\n    })\n    this.#pipeline = pipeline\n  }\n\n  #configureDecoder(): void {\n    try { this.#decoder?.close() } catch { /* noop */ }\n\n    const userMeta: VideoFrameMeta = { timestamp: 0, keyframe: false, packetId: 0 }\n    const decoder = new VideoDecoder({\n      output: (frame) => {\n        // WebCodecs VideoFrame doesn't carry our frame meta; the consumer\n        // rematches via frame.timestamp if needed.\n        userMeta.timestamp = frame.timestamp\n        this.#opts.onFrame(frame, userMeta)\n      },\n      error: (err) => {\n        this.#opts.onError?.(err)\n        this.#gate.reset()\n      },\n    })\n    const config: VideoDecoderConfig = {\n      codec: this.#opts.codec,\n      codedWidth: this.#opts.width,\n      codedHeight: this.#opts.height,\n      ...(this.#opts.description ? { description: this.#opts.description } : {}),\n      ...(this.#opts.hardwareAcceleration ? { hardwareAcceleration: this.#opts.hardwareAcceleration } : {}),\n    }\n    decoder.configure(config)\n    this.#decoder = decoder\n  }\n}\n", "/**\n * FrameCountPacer \u2014 media-agnostic wall-clock pacer for MMT A/V decode loops.\n *\n * Why not use MPU timestamps? Under FEC interleaving, encoders pack multiple\n * Access Units (AUs) per MMTP MPU with a single mpu_timestamp. The observed\n * timestamp delta between MPUs is a fraction of the real per-AU duration\n * (e.g. 10.22ms between MPUs for 21.33ms AAC frames at D=2 interleave).\n * Pacing on that delta sees \"media \u2248 wall\" and never sleeps, letting burst\n * relay delivery saturate the decoder / ring buffer.\n *\n * The Sony libatsc3 pattern (atsc3_mmt_context_mfu_depacketizer) solves this\n * by anchoring wall-clock time to the first received AU and counting AUs:\n *   media_elapsed_ms = au_count \u00D7 nominal_au_duration_ms\n * The MPU timestamp is used elsewhere as an absolute-time anchor, never as\n * an incremental clock.\n *\n * The sleep threshold comes from the catalog's FEC interleaveDepthMs (via\n * FecBlockMapper.pacingThresholdMs). When no FEC is configured, a\n * NullBlockMapper yields threshold=0 and this pacer never sleeps.\n *\n * One pacer instance = one track (e.g. audio, video) on one player.\n */\n\nimport type { FecBlockMapper } from '@blockcast/mmt-fec'\n\nexport interface FrameCountPacerOpts {\n  /** Required: AU duration (audio) or picture interval (video), in ms. */\n  frameDurationMs: number\n  /** FEC mapper from @blockcast/mmt-fec. NullBlockMapper disables pacing. */\n  mapper: FecBlockMapper\n  /**\n   * Number of frames to let through before pacing starts. Lets startup\n   * burst drain populate the ring buffer / decoder queue. Default 0.\n   */\n  warmupFrames?: number\n}\n\nexport interface PacerSnapshot {\n  /** Frames observed (from notifyFrame). */\n  frameCount: number\n  /** Computed media time: frameCount \u00D7 frameDurationMs. */\n  mediaMs: number\n  /** Wall-clock time since anchor. */\n  wallMs: number\n  /** mediaMs - wallMs. Positive \u2192 decoder ahead of realtime. */\n  aheadMs: number\n  /** Pacing threshold (ms) from the FEC mapper. */\n  thresholdMs: number\n  /** Has the first frame been observed (wall anchor set)? */\n  anchored: boolean\n}\n\nexport class FrameCountPacer {\n  readonly frameDurationMs: number\n  readonly thresholdMs: number\n  readonly warmupFrames: number\n\n  #frameCount = 0\n  #anchorWallMs = 0\n  #anchored = false\n\n  constructor(opts: FrameCountPacerOpts) {\n    if (!(opts.frameDurationMs > 0)) {\n      throw new Error('frameDurationMs must be > 0')\n    }\n    this.frameDurationMs = opts.frameDurationMs\n    this.thresholdMs = opts.mapper.pacingThresholdMs\n    this.warmupFrames = Math.max(0, opts.warmupFrames ?? 0)\n  }\n\n  /** Call on every emitted decoded frame (AU or picture). Anchors on first call. */\n  notifyFrame(): void {\n    if (!this.#anchored) {\n      this.#anchorWallMs = now()\n      this.#anchored = true\n    }\n    this.#frameCount++\n  }\n\n  /**\n   * Compute sleep ms before reading the next MoQ object.\n   * Returns 0 when:\n   *   - pacing is disabled (NullBlockMapper \u2192 threshold=0)\n   *   - the anchor is not yet set\n   *   - still in warmup\n   *   - decoder is not ahead of wall clock by more than threshold\n   * Otherwise returns aheadMs - thresholdMs/2 (leaves half the threshold as headroom).\n   */\n  computeSleepMs(): number {\n    if (this.thresholdMs <= 0) return 0\n    if (!this.#anchored) return 0\n    if (this.#frameCount <= this.warmupFrames) return 0\n\n    const mediaMs = this.#frameCount * this.frameDurationMs\n    const wallMs = now() - this.#anchorWallMs\n    const aheadMs = mediaMs - wallMs\n    if (aheadMs <= this.thresholdMs) return 0\n    return aheadMs - this.thresholdMs / 2\n  }\n\n  /** Reset anchor + counter. Call on source switch (MoQ \u2194 multicast). */\n  reset(): void {\n    this.#frameCount = 0\n    this.#anchorWallMs = 0\n    this.#anchored = false\n  }\n\n  get snapshot(): PacerSnapshot {\n    const mediaMs = this.#frameCount * this.frameDurationMs\n    const wallMs = this.#anchored ? now() - this.#anchorWallMs : 0\n    return {\n      frameCount: this.#frameCount,\n      mediaMs,\n      wallMs,\n      aheadMs: mediaMs - wallMs,\n      thresholdMs: this.thresholdMs,\n      anchored: this.#anchored,\n    }\n  }\n}\n\nfunction now(): number {\n  // performance.now() is available in main thread, workers, and AudioWorklet.\n  // Fall back to Date.now() for exotic runtimes (shouldn't happen in browsers).\n  if (typeof performance !== 'undefined' && typeof performance.now === 'function') {\n    return performance.now()\n  }\n  return Date.now()\n}\n", "/**\n * KeyframeGate \u2014 drops delta frames until a keyframe arrives.\n *\n * Required when subscribing mid-stream: the relay may deliver P/B frames\n * from the middle of a GOP before the first IDR. Feeding those into\n * VideoDecoder before an init yields \"key frame required\" errors.\n *\n * Call reset() to re-arm the gate after a decoder error (requestKeyframe).\n */\n\nexport class KeyframeGate {\n  #open = false\n\n  get isOpen(): boolean {\n    return this.#open\n  }\n\n  /**\n   * Decide whether to pass a frame through.\n   * Opens permanently once the first keyframe is seen.\n   */\n  allow(keyframe: boolean): boolean {\n    if (this.#open) return true\n    if (keyframe) {\n      this.#open = true\n      return true\n    }\n    return false\n  }\n\n  /** Re-close the gate. Next keyframe reopens it. */\n  reset(): void {\n    this.#open = false\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}