@blockcast/mmt-render 0.1.0 → 0.3.0-main.1cd3cdea89da

package/dist/video/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/video/keyframe-gate.ts", "../../src/video/video-render-pipeline.ts", "../../src/pacing/frame-pacer.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", "/**\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"],
-  "mappings": "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",
+  "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", "/**\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   *   - the caller reports a standing backlog (see `observedDelayMs`)\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   * `observedDelayMs` is how far this frame is behind the producer's own clock,\n   * measured by the caller against a producer-supplied sending instant (for\n   * MMTP, the header send-wall timestamp). It is optional because the anchored\n   * rate below is blind to it: `#anchorWallMs` is the wall time of the FIRST\n   * frame read, so `aheadMs` measures consumption against the join instant and\n   * not against the producer. Once `aheadMs` reaches the threshold the loop\n   * consumes at exactly the source rate, and recovering latency present at join\n   * requires consuming FASTER than the source rate. So without this argument a\n   * consumer that joined a live stream mid-block keeps that join latency for the\n   * life of the subscription.\n   *\n   * A caller that can measure the real distance from the producer passes it and\n   * gets a drain: while the backlog exceeds the threshold there is nothing to\n   * pace against, so return 0 and let the transport set the rate. At the live\n   * edge the anchored-rate behavior below applies unchanged.\n   *\n   * Callers with no producer clock omit it and keep the pure ATSC3-style\n   * anchored pacing (see the class doc), where a first-frame anchor is correct\n   * because a broadcast push has no live edge to catch up to.\n   */\n  computeSleepMs(observedDelayMs?: number): number {\n    if (this.thresholdMs <= 0) return 0\n    if (!this.#anchored) return 0\n    if (this.#frameCount <= this.warmupFrames) return 0\n    // Only a finite measurement can license the drain. NaN/Infinity mean the\n    // caller could not measure the distance, which is not the same claim as\n    // \"the consumer is at the edge\", so fall through to anchored pacing.\n    if (observedDelayMs !== undefined && Number.isFinite(observedDelayMs) && observedDelayMs > this.thresholdMs) {\n      return 0\n    }\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"],
+  "mappings": "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",
   "names": []
 }

package/dist/video/keyframe-gate.js

@@ -1,38 +1,26 @@
-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);
-  }
+  #open = false;
   get isOpen() {
-    return __privateGet(this, _open);
+    return 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 (this.#open) return true;
     if (keyframe) {
-      __privateSet(this, _open, true);
+      this.#open = true;
       return true;
     }
     return false;
   }
   /** Re-close the gate. Next keyframe reopens it. */
   reset() {
-    __privateSet(this, _open, false);
+    this.#open = false;
   }
 };
-_open = new WeakMap();
 export {
   KeyframeGate
 };

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

@@ -2,6 +2,6 @@
   "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;",
+  "mappings": ";AAUO,IAAM,eAAN,MAAmB;AAAA,EACxB,QAAQ;AAAA,EAER,IAAI,SAAkB;AACpB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,UAA4B;AAChC,QAAI,KAAK,MAAO,QAAO;AACvB,QAAI,UAAU;AACZ,WAAK,QAAQ;AACb,aAAO;AAAA,IACT;AACA,WAAO;AAAA,EACT;AAAA;AAAA,EAGA,QAAc;AACZ,SAAK,QAAQ;AAAA,EACf;AACF;",
   "names": []
 }

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

@@ -1,30 +1,12 @@
-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 {
+  #frameCount = 0;
+  #anchorWallMs = 0;
+  #anchored = false;
   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");
     }
@@ -34,11 +16,11 @@ var FrameCountPacer = class {
   }
   /** 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);
+    if (!this.#anchored) {
+      this.#anchorWallMs = now();
+      this.#anchored = true;
     }
-    __privateWrapper(this, _frameCount)._++;
+    this.#frameCount++;
   }
   /**
    * Compute sleep ms before reading the next MoQ object.
@@ -46,41 +28,62 @@ var FrameCountPacer = class {
    *   - pacing is disabled (NullBlockMapper → threshold=0)
    *   - the anchor is not yet set
    *   - still in warmup
+   *   - the caller reports a standing backlog (see `observedDelayMs`)
    *   - decoder is not ahead of wall clock by more than threshold
    * Otherwise returns aheadMs - thresholdMs/2 (leaves half the threshold as headroom).
+   *
+   * `observedDelayMs` is how far this frame is behind the producer's own clock,
+   * measured by the caller against a producer-supplied sending instant (for
+   * MMTP, the header send-wall timestamp). It is optional because the anchored
+   * rate below is blind to it: `#anchorWallMs` is the wall time of the FIRST
+   * frame read, so `aheadMs` measures consumption against the join instant and
+   * not against the producer. Once `aheadMs` reaches the threshold the loop
+   * consumes at exactly the source rate, and recovering latency present at join
+   * requires consuming FASTER than the source rate. So without this argument a
+   * consumer that joined a live stream mid-block keeps that join latency for the
+   * life of the subscription.
+   *
+   * A caller that can measure the real distance from the producer passes it and
+   * gets a drain: while the backlog exceeds the threshold there is nothing to
+   * pace against, so return 0 and let the transport set the rate. At the live
+   * edge the anchored-rate behavior below applies unchanged.
+   *
+   * Callers with no producer clock omit it and keep the pure ATSC3-style
+   * anchored pacing (see the class doc), where a first-frame anchor is correct
+   * because a broadcast push has no live edge to catch up to.
    */
-  computeSleepMs() {
+  computeSleepMs(observedDelayMs) {
     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);
+    if (!this.#anchored) return 0;
+    if (this.#frameCount <= this.warmupFrames) return 0;
+    if (observedDelayMs !== void 0 && Number.isFinite(observedDelayMs) && observedDelayMs > this.thresholdMs) {
+      return 0;
+    }
+    const mediaMs = this.#frameCount * this.frameDurationMs;
+    const wallMs = now() - 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);
+    this.#frameCount = 0;
+    this.#anchorWallMs = 0;
+    this.#anchored = false;
   }
   get snapshot() {
-    const mediaMs = __privateGet(this, _frameCount) * this.frameDurationMs;
-    const wallMs = __privateGet(this, _anchored) ? now() - __privateGet(this, _anchorWallMs) : 0;
+    const mediaMs = this.#frameCount * this.frameDurationMs;
+    const wallMs = this.#anchored ? now() - this.#anchorWallMs : 0;
     return {
-      frameCount: __privateGet(this, _frameCount),
+      frameCount: this.#frameCount,
       mediaMs,
       wallMs,
       aheadMs: mediaMs - wallMs,
       thresholdMs: this.thresholdMs,
-      anchored: __privateGet(this, _anchored)
+      anchored: this.#anchored
     };
   }
 };
-_frameCount = new WeakMap();
-_anchorWallMs = new WeakMap();
-_anchored = new WeakMap();
 function now() {
   if (typeof performance !== "undefined" && typeof performance.now === "function") {
     return performance.now();
@@ -89,156 +92,143 @@ function now() {
 }
 
 // src/video/keyframe-gate.ts
-var _open;
 var KeyframeGate = class {
-  constructor() {
-    __privateAdd(this, _open, false);
-  }
+  #open = false;
   get isOpen() {
-    return __privateGet(this, _open);
+    return 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 (this.#open) return true;
     if (keyframe) {
-      __privateSet(this, _open, true);
+      this.#open = true;
       return true;
     }
     return false;
   }
   /** Re-close the gate. Next keyframe reopens it. */
   reset() {
-    __privateSet(this, _open, false);
+    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 {
+  #pacer;
+  #gate = new KeyframeGate();
+  #opts;
+  #decoder = null;
+  #pipeline = null;
+  #closed = false;
   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({
+    this.#opts = opts;
+    this.#pacer = new FrameCountPacer({
       frameDurationMs: 1e3 / opts.framerate,
       mapper: opts.mapper,
       warmupFrames: opts.warmupFrames ?? 3
-    }));
-    __privateMethod(this, _VideoRenderPipeline_instances, init_fn).call(this);
+    });
+    this.#init();
   }
   feedMoqObject(packet) {
-    __privateGet(this, _pipeline)?.feedMoqObject(packet);
+    this.#pipeline?.feedMoqObject(packet);
   }
   paceSleepMs() {
-    return __privateGet(this, _pacer).computeSleepMs();
+    return this.#pacer.computeSleepMs();
   }
   get pacerSnapshot() {
-    return __privateGet(this, _pacer).snapshot;
+    return this.#pacer.snapshot;
   }
   /** Request a fresh keyframe after a decoder error (or source switch). */
   reset() {
-    __privateGet(this, _gate).reset();
-    __privateGet(this, _pacer).reset();
+    this.#gate.reset();
+    this.#pacer.reset();
     try {
-      __privateGet(this, _decoder)?.reset();
+      this.#decoder?.reset();
     } catch {
     }
-    __privateMethod(this, _VideoRenderPipeline_instances, configureDecoder_fn).call(this);
+    this.#configureDecoder();
   }
   close() {
-    if (__privateGet(this, _closed)) return;
-    __privateSet(this, _closed, true);
+    if (this.#closed) return;
+    this.#closed = true;
     try {
-      __privateGet(this, _decoder)?.close();
+      this.#decoder?.close();
     } catch {
     }
     try {
-      __privateGet(this, _pipeline)?.dispose();
+      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();
+    this.#decoder = null;
+    this.#pipeline = null;
+  }
+  // ─── Private ─────────────────────────────────────────────────────
+  #init() {
+    this.#configureDecoder();
+    const pipeline = new MmtpDecodePipeline();
+    const reorderWindow = this.#opts.reorderWindow ?? deriveVideoReorderWindow(this.#opts.framerate, this.#opts.mapper);
+    pipeline.configure({
+      codec: this.#opts.codec,
+      packetId: this.#opts.packetId,
+      description: this.#opts.description,
+      reorderWindow,
+      framerate: this.#opts.framerate,
+      groupDurationMs: this.#opts.mapper.gopDurationMs,
+      reassemblyPolicy: this.#opts.reassemblyPolicy
+    });
+    if (this.#opts.fecClient) pipeline.setFecClient(this.#opts.fecClient);
+    pipeline.onFrame((codecData, meta) => {
+      if (this.#closed || !this.#decoder) return;
+      if (codecData.byteLength === 0) return;
+      if (!this.#gate.allow(meta.keyframe)) return;
+      this.#pacer.notifyFrame();
+      try {
+        this.#decoder.decode(new EncodedVideoChunk({
+          type: meta.keyframe ? "key" : "delta",
+          data: codecData,
+          timestamp: meta.timestamp
+        }));
+      } catch (err) {
+        this.#opts.onError?.(err);
+        this.reset();
+      }
+    });
+    this.#pipeline = pipeline;
+  }
+  #configureDecoder() {
     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();
+      this.#decoder?.close();
+    } catch {
     }
-  });
-  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);
+    const userMeta = { timestamp: 0, keyframe: false, packetId: 0 };
+    const decoder = new VideoDecoder({
+      output: (frame) => {
+        userMeta.timestamp = frame.timestamp;
+        this.#opts.onFrame(frame, userMeta);
+      },
+      error: (err) => {
+        this.#opts.onError?.(err);
+        this.#gate.reset();
+      }
+    });
+    const config = {
+      codec: this.#opts.codec,
+      codedWidth: this.#opts.width,
+      codedHeight: this.#opts.height,
+      ...this.#opts.description ? { description: this.#opts.description } : {},
+      ...this.#opts.hardwareAcceleration ? { hardwareAcceleration: this.#opts.hardwareAcceleration } : {}
+    };
+    decoder.configure(config);
+    this.#decoder = decoder;
+  }
 };
 export {
   VideoRenderPipeline,

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

@@ -1,7 +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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",
+  "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   *   - the caller reports a standing backlog (see `observedDelayMs`)\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   * `observedDelayMs` is how far this frame is behind the producer's own clock,\n   * measured by the caller against a producer-supplied sending instant (for\n   * MMTP, the header send-wall timestamp). It is optional because the anchored\n   * rate below is blind to it: `#anchorWallMs` is the wall time of the FIRST\n   * frame read, so `aheadMs` measures consumption against the join instant and\n   * not against the producer. Once `aheadMs` reaches the threshold the loop\n   * consumes at exactly the source rate, and recovering latency present at join\n   * requires consuming FASTER than the source rate. So without this argument a\n   * consumer that joined a live stream mid-block keeps that join latency for the\n   * life of the subscription.\n   *\n   * A caller that can measure the real distance from the producer passes it and\n   * gets a drain: while the backlog exceeds the threshold there is nothing to\n   * pace against, so return 0 and let the transport set the rate. At the live\n   * edge the anchored-rate behavior below applies unchanged.\n   *\n   * Callers with no producer clock omit it and keep the pure ATSC3-style\n   * anchored pacing (see the class doc), where a first-frame anchor is correct\n   * because a broadcast push has no live edge to catch up to.\n   */\n  computeSleepMs(observedDelayMs?: number): number {\n    if (this.thresholdMs <= 0) return 0\n    if (!this.#anchored) return 0\n    if (this.#frameCount <= this.warmupFrames) return 0\n    // Only a finite measurement can license the drain. NaN/Infinity mean the\n    // caller could not measure the distance, which is not the same claim as\n    // \"the consumer is at the edge\", so fall through to anchored pacing.\n    if (observedDelayMs !== undefined && Number.isFinite(observedDelayMs) && observedDelayMs > this.thresholdMs) {\n      return 0\n    }\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": []
 }