@blockcast/mmt-render 0.1.0

package/dist/pacing/index.js

@@ -0,0 +1,166 @@
+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 __privateWrapper = (obj, member, setter, getter) => ({
+  set _(value) {
+    __privateSet(obj, member, value, setter);
+  },
+  get _() {
+    return __privateGet(obj, member, getter);
+  }
+});
+
+// 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/pacing/interleave-timing.ts
+var InterleaveTiming = class {
+  constructor(opts) {
+    if (!(opts.frameDurationUs > 0)) {
+      throw new Error("frameDurationUs must be > 0");
+    }
+    if (!Number.isFinite(opts.anchorMpuUs)) {
+      throw new Error("anchorMpuUs must be finite");
+    }
+    this.mapper = opts.mapper;
+    this.frameDurationUs = opts.frameDurationUs;
+    this.anchorMpuUs = opts.anchorMpuUs;
+  }
+  /**
+   * Presentation time (µs) for an AU at MoQ coords (group_id, object_id).
+   * Per draft §8.3 + Sony anchor.
+   */
+  presentationUs(groupId, objectId) {
+    const coords = this.mapper.derive(groupId, objectId);
+    return this.anchorMpuUs + coords.ssId * this.frameDurationUs;
+  }
+  /**
+   * Presentation time (µs) for an AU identified by its flat SS_ID
+   * (multicast FEC Payload ID path).
+   */
+  presentationUsFromSsId(ssId) {
+    return this.anchorMpuUs + ssId * this.frameDurationUs;
+  }
+  /**
+   * Inverse: which (group_id, object_id) AU is scheduled at the given
+   * wall offset (µs) from anchor? Clamps to ssId≥0.
+   */
+  frameAtOffset(offsetUs) {
+    const rawSsId = Math.max(0, Math.floor(offsetUs / this.frameDurationUs));
+    const { sbn, esi } = this.mapper.fromSsId(rawSsId);
+    const spg = this.mapper.symbolsPerGroup;
+    const groupInBlock = Math.floor(esi / spg);
+    const objectId = esi - groupInBlock * spg;
+    const groupId = sbn * this.mapper.d + groupInBlock;
+    return { groupId, objectId, ssId: rawSsId };
+  }
+  /**
+   * Block start/end in microseconds. Source blocks span `D × GOP_duration`
+   * of wall time; this returns the anchored wall range [startUs, endUs).
+   */
+  blockTimeRangeUs(sbn) {
+    const firstSsId = sbn * this.mapper.k;
+    const lastSsId = (sbn + 1) * this.mapper.k;
+    return {
+      startUs: this.anchorMpuUs + firstSsId * this.frameDurationUs,
+      endUs: this.anchorMpuUs + lastSsId * this.frameDurationUs
+    };
+  }
+};
+
+// src/pacing/au-duration.ts
+function auDurationMsFromCodec(codec, sampleRate) {
+  if (!(sampleRate > 0)) throw new Error("sampleRate must be > 0");
+  if (codec.startsWith("opus") || codec.startsWith("Opus")) {
+    return 960 / sampleRate * 1e3;
+  }
+  if (codec.startsWith("mp4a") || codec.startsWith("AAC") || codec.startsWith("aac")) {
+    return 1024 / sampleRate * 1e3;
+  }
+  if (codec.startsWith("flac") || codec.startsWith("fLaC")) {
+    return 4096 / sampleRate * 1e3;
+  }
+  throw new Error(`unknown audio codec for AU duration derivation: ${codec}`);
+}
+function pictureDurationMs(framerate) {
+  if (!(framerate > 0)) throw new Error("framerate must be > 0");
+  return 1e3 / framerate;
+}
+export {
+  FrameCountPacer,
+  InterleaveTiming,
+  auDurationMsFromCodec,
+  pictureDurationMs
+};
+//# sourceMappingURL=index.js.map

package/dist/pacing/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/pacing/frame-pacer.ts", "../../src/pacing/interleave-timing.ts", "../../src/pacing/au-duration.ts"],
+  "sourcesContent": ["/**\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 * InterleaveTiming \u2014 per-AU presentation-time reconstruction.\n *\n * When encoders pack multiple AUs per MMTP MPU with a single mpu_timestamp\n * (normal for FEC-interleaved audio, and for video with multi-picture MPUs),\n * the raw mpu_timestamp is ambiguous for per-AU scheduling. The FEC block\n * math (draft-ramadan-moq-fec-00 \u00A78.3) combined with the Sony libatsc3\n * pattern recovers correct per-AU time:\n *\n *   au_index_in_block = groupInBlock \u00D7 symbolsPerGroup + objectId\n *   ssId              = sbn \u00D7 K + au_index_in_block\n *   presentationUs    = anchorMpuUs + ssId \u00D7 frameDurationUs\n *\n * The anchor (anchorMpuUs) is the mpu_timestamp of the first observed AU.\n * Every downstream per-AU time is then deterministic from FEC coordinates\n * + codec frame duration \u2014 identical whether the AU arrives via MoQ unicast\n * (group_id/object_id) or multicast UDP (SS_ID from FEC Payload ID).\n *\n * Consumers: CMAF segment assembler (block boundary \u2192 segment cut points),\n * debug overlays, cross-path FEC combining, sync diagnostics.\n */\n\nimport type { FecBlockMapper } from '@blockcast/mmt-fec'\n\nexport interface InterleaveTimingOpts {\n  /** Track's FEC mapper (provides K, D, symbolsPerGroup). */\n  mapper: FecBlockMapper\n  /** Nominal AU duration in microseconds. */\n  frameDurationUs: number\n  /** Wall-time anchor: the mpu_timestamp of the first observed AU (\u00B5s). */\n  anchorMpuUs: number\n}\n\nexport class InterleaveTiming {\n  readonly mapper: FecBlockMapper\n  readonly frameDurationUs: number\n  readonly anchorMpuUs: number\n\n  constructor(opts: InterleaveTimingOpts) {\n    if (!(opts.frameDurationUs > 0)) {\n      throw new Error('frameDurationUs must be > 0')\n    }\n    if (!Number.isFinite(opts.anchorMpuUs)) {\n      throw new Error('anchorMpuUs must be finite')\n    }\n    this.mapper = opts.mapper\n    this.frameDurationUs = opts.frameDurationUs\n    this.anchorMpuUs = opts.anchorMpuUs\n  }\n\n  /**\n   * Presentation time (\u00B5s) for an AU at MoQ coords (group_id, object_id).\n   * Per draft \u00A78.3 + Sony anchor.\n   */\n  presentationUs(groupId: number, objectId: number): number {\n    const coords = this.mapper.derive(groupId, objectId)\n    return this.anchorMpuUs + coords.ssId * this.frameDurationUs\n  }\n\n  /**\n   * Presentation time (\u00B5s) for an AU identified by its flat SS_ID\n   * (multicast FEC Payload ID path).\n   */\n  presentationUsFromSsId(ssId: number): number {\n    return this.anchorMpuUs + ssId * this.frameDurationUs\n  }\n\n  /**\n   * Inverse: which (group_id, object_id) AU is scheduled at the given\n   * wall offset (\u00B5s) from anchor? Clamps to ssId\u22650.\n   */\n  frameAtOffset(offsetUs: number): { groupId: number; objectId: number; ssId: number } {\n    const rawSsId = Math.max(0, Math.floor(offsetUs / this.frameDurationUs))\n    const { sbn, esi } = this.mapper.fromSsId(rawSsId)\n    // Invert \u00A78.3: esi = groupInBlock * symbolsPerGroup + objectId\n    const spg = this.mapper.symbolsPerGroup\n    const groupInBlock = Math.floor(esi / spg)\n    const objectId = esi - groupInBlock * spg\n    const groupId = sbn * this.mapper.d + groupInBlock\n    return { groupId, objectId, ssId: rawSsId }\n  }\n\n  /**\n   * Block start/end in microseconds. Source blocks span `D \u00D7 GOP_duration`\n   * of wall time; this returns the anchored wall range [startUs, endUs).\n   */\n  blockTimeRangeUs(sbn: number): { startUs: number; endUs: number } {\n    const firstSsId = sbn * this.mapper.k\n    const lastSsId = (sbn + 1) * this.mapper.k\n    return {\n      startUs: this.anchorMpuUs + firstSsId * this.frameDurationUs,\n      endUs: this.anchorMpuUs + lastSsId * this.frameDurationUs,\n    }\n  }\n}\n", "/**\n * Nominal Access Unit duration helpers for common audio + video codecs.\n *\n * Kept in the pacing subpath (no mmt-container dep) so lean consumers like\n * moqtail's player.ts can import the pacer + AU duration without pulling\n * in the full audio-render-pipeline (which depends on @blockcast/mmt-container).\n */\n\n/**\n * Nominal AU duration in ms for common audio codecs at the given sample rate.\n * AAC-LC: 1024 samples. Opus (default 20ms): 960 samples @ 48kHz.\n * Throws for unknown codecs so callers supply correct timing.\n */\nexport function auDurationMsFromCodec(codec: string, sampleRate: number): number {\n  if (!(sampleRate > 0)) throw new Error('sampleRate must be > 0')\n  if (codec.startsWith('opus') || codec.startsWith('Opus')) {\n    return (960 / sampleRate) * 1000\n  }\n  if (codec.startsWith('mp4a') || codec.startsWith('AAC') || codec.startsWith('aac')) {\n    return (1024 / sampleRate) * 1000\n  }\n  if (codec.startsWith('flac') || codec.startsWith('fLaC')) {\n    return (4096 / sampleRate) * 1000\n  }\n  throw new Error(`unknown audio codec for AU duration derivation: ${codec}`)\n}\n\n/**\n * Nominal picture duration in ms from framerate.\n */\nexport function pictureDurationMs(framerate: number): number {\n  if (!(framerate > 0)) throw new Error('framerate must be > 0')\n  return 1000 / framerate\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/pacing/interleave-timing.d.ts

@@ -0,0 +1,64 @@
+/**
+ * InterleaveTiming — per-AU presentation-time reconstruction.
+ *
+ * When encoders pack multiple AUs per MMTP MPU with a single mpu_timestamp
+ * (normal for FEC-interleaved audio, and for video with multi-picture MPUs),
+ * the raw mpu_timestamp is ambiguous for per-AU scheduling. The FEC block
+ * math (draft-ramadan-moq-fec-00 §8.3) combined with the Sony libatsc3
+ * pattern recovers correct per-AU time:
+ *
+ *   au_index_in_block = groupInBlock × symbolsPerGroup + objectId
+ *   ssId              = sbn × K + au_index_in_block
+ *   presentationUs    = anchorMpuUs + ssId × frameDurationUs
+ *
+ * The anchor (anchorMpuUs) is the mpu_timestamp of the first observed AU.
+ * Every downstream per-AU time is then deterministic from FEC coordinates
+ * + codec frame duration — identical whether the AU arrives via MoQ unicast
+ * (group_id/object_id) or multicast UDP (SS_ID from FEC Payload ID).
+ *
+ * Consumers: CMAF segment assembler (block boundary → segment cut points),
+ * debug overlays, cross-path FEC combining, sync diagnostics.
+ */
+import type { FecBlockMapper } from '@blockcast/mmt-fec';
+export interface InterleaveTimingOpts {
+    /** Track's FEC mapper (provides K, D, symbolsPerGroup). */
+    mapper: FecBlockMapper;
+    /** Nominal AU duration in microseconds. */
+    frameDurationUs: number;
+    /** Wall-time anchor: the mpu_timestamp of the first observed AU (µs). */
+    anchorMpuUs: number;
+}
+export declare class InterleaveTiming {
+    readonly mapper: FecBlockMapper;
+    readonly frameDurationUs: number;
+    readonly anchorMpuUs: number;
+    constructor(opts: InterleaveTimingOpts);
+    /**
+     * Presentation time (µs) for an AU at MoQ coords (group_id, object_id).
+     * Per draft §8.3 + Sony anchor.
+     */
+    presentationUs(groupId: number, objectId: number): number;
+    /**
+     * Presentation time (µs) for an AU identified by its flat SS_ID
+     * (multicast FEC Payload ID path).
+     */
+    presentationUsFromSsId(ssId: number): number;
+    /**
+     * Inverse: which (group_id, object_id) AU is scheduled at the given
+     * wall offset (µs) from anchor? Clamps to ssId≥0.
+     */
+    frameAtOffset(offsetUs: number): {
+        groupId: number;
+        objectId: number;
+        ssId: number;
+    };
+    /**
+     * Block start/end in microseconds. Source blocks span `D × GOP_duration`
+     * of wall time; this returns the anchored wall range [startUs, endUs).
+     */
+    blockTimeRangeUs(sbn: number): {
+        startUs: number;
+        endUs: number;
+    };
+}
+//# sourceMappingURL=interleave-timing.d.ts.map

package/dist/pacing/interleave-timing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interleave-timing.d.ts","sourceRoot":"","sources":["../../src/pacing/interleave-timing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAExD,MAAM,WAAW,oBAAoB;IACnC,2DAA2D;IAC3D,MAAM,EAAE,cAAc,CAAA;IACtB,2CAA2C;IAC3C,eAAe,EAAE,MAAM,CAAA;IACvB,yEAAyE;IACzE,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,qBAAa,gBAAgB;IAC3B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;gBAEhB,IAAI,EAAE,oBAAoB;IAYtC;;;OAGG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAKzD;;;OAGG;IACH,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI5C;;;OAGG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IAWpF;;;OAGG;IACH,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;CAQlE"}

package/dist/pacing/interleave-timing.js

@@ -0,0 +1,58 @@
+// src/pacing/interleave-timing.ts
+var InterleaveTiming = class {
+  constructor(opts) {
+    if (!(opts.frameDurationUs > 0)) {
+      throw new Error("frameDurationUs must be > 0");
+    }
+    if (!Number.isFinite(opts.anchorMpuUs)) {
+      throw new Error("anchorMpuUs must be finite");
+    }
+    this.mapper = opts.mapper;
+    this.frameDurationUs = opts.frameDurationUs;
+    this.anchorMpuUs = opts.anchorMpuUs;
+  }
+  /**
+   * Presentation time (µs) for an AU at MoQ coords (group_id, object_id).
+   * Per draft §8.3 + Sony anchor.
+   */
+  presentationUs(groupId, objectId) {
+    const coords = this.mapper.derive(groupId, objectId);
+    return this.anchorMpuUs + coords.ssId * this.frameDurationUs;
+  }
+  /**
+   * Presentation time (µs) for an AU identified by its flat SS_ID
+   * (multicast FEC Payload ID path).
+   */
+  presentationUsFromSsId(ssId) {
+    return this.anchorMpuUs + ssId * this.frameDurationUs;
+  }
+  /**
+   * Inverse: which (group_id, object_id) AU is scheduled at the given
+   * wall offset (µs) from anchor? Clamps to ssId≥0.
+   */
+  frameAtOffset(offsetUs) {
+    const rawSsId = Math.max(0, Math.floor(offsetUs / this.frameDurationUs));
+    const { sbn, esi } = this.mapper.fromSsId(rawSsId);
+    const spg = this.mapper.symbolsPerGroup;
+    const groupInBlock = Math.floor(esi / spg);
+    const objectId = esi - groupInBlock * spg;
+    const groupId = sbn * this.mapper.d + groupInBlock;
+    return { groupId, objectId, ssId: rawSsId };
+  }
+  /**
+   * Block start/end in microseconds. Source blocks span `D × GOP_duration`
+   * of wall time; this returns the anchored wall range [startUs, endUs).
+   */
+  blockTimeRangeUs(sbn) {
+    const firstSsId = sbn * this.mapper.k;
+    const lastSsId = (sbn + 1) * this.mapper.k;
+    return {
+      startUs: this.anchorMpuUs + firstSsId * this.frameDurationUs,
+      endUs: this.anchorMpuUs + lastSsId * this.frameDurationUs
+    };
+  }
+};
+export {
+  InterleaveTiming
+};
+//# sourceMappingURL=interleave-timing.js.map

package/dist/pacing/interleave-timing.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/pacing/interleave-timing.ts"],
+  "sourcesContent": ["/**\n * InterleaveTiming \u2014 per-AU presentation-time reconstruction.\n *\n * When encoders pack multiple AUs per MMTP MPU with a single mpu_timestamp\n * (normal for FEC-interleaved audio, and for video with multi-picture MPUs),\n * the raw mpu_timestamp is ambiguous for per-AU scheduling. The FEC block\n * math (draft-ramadan-moq-fec-00 \u00A78.3) combined with the Sony libatsc3\n * pattern recovers correct per-AU time:\n *\n *   au_index_in_block = groupInBlock \u00D7 symbolsPerGroup + objectId\n *   ssId              = sbn \u00D7 K + au_index_in_block\n *   presentationUs    = anchorMpuUs + ssId \u00D7 frameDurationUs\n *\n * The anchor (anchorMpuUs) is the mpu_timestamp of the first observed AU.\n * Every downstream per-AU time is then deterministic from FEC coordinates\n * + codec frame duration \u2014 identical whether the AU arrives via MoQ unicast\n * (group_id/object_id) or multicast UDP (SS_ID from FEC Payload ID).\n *\n * Consumers: CMAF segment assembler (block boundary \u2192 segment cut points),\n * debug overlays, cross-path FEC combining, sync diagnostics.\n */\n\nimport type { FecBlockMapper } from '@blockcast/mmt-fec'\n\nexport interface InterleaveTimingOpts {\n  /** Track's FEC mapper (provides K, D, symbolsPerGroup). */\n  mapper: FecBlockMapper\n  /** Nominal AU duration in microseconds. */\n  frameDurationUs: number\n  /** Wall-time anchor: the mpu_timestamp of the first observed AU (\u00B5s). */\n  anchorMpuUs: number\n}\n\nexport class InterleaveTiming {\n  readonly mapper: FecBlockMapper\n  readonly frameDurationUs: number\n  readonly anchorMpuUs: number\n\n  constructor(opts: InterleaveTimingOpts) {\n    if (!(opts.frameDurationUs > 0)) {\n      throw new Error('frameDurationUs must be > 0')\n    }\n    if (!Number.isFinite(opts.anchorMpuUs)) {\n      throw new Error('anchorMpuUs must be finite')\n    }\n    this.mapper = opts.mapper\n    this.frameDurationUs = opts.frameDurationUs\n    this.anchorMpuUs = opts.anchorMpuUs\n  }\n\n  /**\n   * Presentation time (\u00B5s) for an AU at MoQ coords (group_id, object_id).\n   * Per draft \u00A78.3 + Sony anchor.\n   */\n  presentationUs(groupId: number, objectId: number): number {\n    const coords = this.mapper.derive(groupId, objectId)\n    return this.anchorMpuUs + coords.ssId * this.frameDurationUs\n  }\n\n  /**\n   * Presentation time (\u00B5s) for an AU identified by its flat SS_ID\n   * (multicast FEC Payload ID path).\n   */\n  presentationUsFromSsId(ssId: number): number {\n    return this.anchorMpuUs + ssId * this.frameDurationUs\n  }\n\n  /**\n   * Inverse: which (group_id, object_id) AU is scheduled at the given\n   * wall offset (\u00B5s) from anchor? Clamps to ssId\u22650.\n   */\n  frameAtOffset(offsetUs: number): { groupId: number; objectId: number; ssId: number } {\n    const rawSsId = Math.max(0, Math.floor(offsetUs / this.frameDurationUs))\n    const { sbn, esi } = this.mapper.fromSsId(rawSsId)\n    // Invert \u00A78.3: esi = groupInBlock * symbolsPerGroup + objectId\n    const spg = this.mapper.symbolsPerGroup\n    const groupInBlock = Math.floor(esi / spg)\n    const objectId = esi - groupInBlock * spg\n    const groupId = sbn * this.mapper.d + groupInBlock\n    return { groupId, objectId, ssId: rawSsId }\n  }\n\n  /**\n   * Block start/end in microseconds. Source blocks span `D \u00D7 GOP_duration`\n   * of wall time; this returns the anchored wall range [startUs, endUs).\n   */\n  blockTimeRangeUs(sbn: number): { startUs: number; endUs: number } {\n    const firstSsId = sbn * this.mapper.k\n    const lastSsId = (sbn + 1) * this.mapper.k\n    return {\n      startUs: this.anchorMpuUs + firstSsId * this.frameDurationUs,\n      endUs: this.anchorMpuUs + lastSsId * this.frameDurationUs,\n    }\n  }\n}\n"],
+  "mappings": ";AAiCO,IAAM,mBAAN,MAAuB;AAAA,EAK5B,YAAY,MAA4B;AACtC,QAAI,EAAE,KAAK,kBAAkB,IAAI;AAC/B,YAAM,IAAI,MAAM,6BAA6B;AAAA,IAC/C;AACA,QAAI,CAAC,OAAO,SAAS,KAAK,WAAW,GAAG;AACtC,YAAM,IAAI,MAAM,4BAA4B;AAAA,IAC9C;AACA,SAAK,SAAS,KAAK;AACnB,SAAK,kBAAkB,KAAK;AAC5B,SAAK,cAAc,KAAK;AAAA,EAC1B;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,eAAe,SAAiB,UAA0B;AACxD,UAAM,SAAS,KAAK,OAAO,OAAO,SAAS,QAAQ;AACnD,WAAO,KAAK,cAAc,OAAO,OAAO,KAAK;AAAA,EAC/C;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,uBAAuB,MAAsB;AAC3C,WAAO,KAAK,cAAc,OAAO,KAAK;AAAA,EACxC;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,cAAc,UAAuE;AACnF,UAAM,UAAU,KAAK,IAAI,GAAG,KAAK,MAAM,WAAW,KAAK,eAAe,CAAC;AACvE,UAAM,EAAE,KAAK,IAAI,IAAI,KAAK,OAAO,SAAS,OAAO;AAEjD,UAAM,MAAM,KAAK,OAAO;AACxB,UAAM,eAAe,KAAK,MAAM,MAAM,GAAG;AACzC,UAAM,WAAW,MAAM,eAAe;AACtC,UAAM,UAAU,MAAM,KAAK,OAAO,IAAI;AACtC,WAAO,EAAE,SAAS,UAAU,MAAM,QAAQ;AAAA,EAC5C;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,iBAAiB,KAAiD;AAChE,UAAM,YAAY,MAAM,KAAK,OAAO;AACpC,UAAM,YAAY,MAAM,KAAK,KAAK,OAAO;AACzC,WAAO;AAAA,MACL,SAAS,KAAK,cAAc,YAAY,KAAK;AAAA,MAC7C,OAAO,KAAK,cAAc,WAAW,KAAK;AAAA,IAC5C;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/video/index.d.ts

@@ -0,0 +1,4 @@
+export { KeyframeGate } from './keyframe-gate.js';
+export { VideoRenderPipeline } from './video-render-pipeline.js';
+export type { VideoRenderPipelineOpts, VideoFrameMeta, VideoFrameCallback, } from './video-render-pipeline.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/video/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAChE,YAAY,EACV,uBAAuB,EACvB,cAAc,EACd,kBAAkB,GACnB,MAAM,4BAA4B,CAAA"}

package/dist/video/index.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/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
+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/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 {
+  KeyframeGate,
+  VideoRenderPipeline
+};
+//# sourceMappingURL=index.js.map

package/dist/video/index.js.map

@@ -0,0 +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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",
+  "names": []
+}

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

@@ -0,0 +1,21 @@
+/**
+ * KeyframeGate — drops delta frames until a keyframe arrives.
+ *
+ * Required when subscribing mid-stream: the relay may deliver P/B frames
+ * from the middle of a GOP before the first IDR. Feeding those into
+ * VideoDecoder before an init yields "key frame required" errors.
+ *
+ * Call reset() to re-arm the gate after a decoder error (requestKeyframe).
+ */
+export declare class KeyframeGate {
+    #private;
+    get isOpen(): boolean;
+    /**
+     * Decide whether to pass a frame through.
+     * Opens permanently once the first keyframe is seen.
+     */
+    allow(keyframe: boolean): boolean;
+    /** Re-close the gate. Next keyframe reopens it. */
+    reset(): void;
+}
+//# sourceMappingURL=keyframe-gate.d.ts.map