@blockcast/mmt-render 0.1.0-main.0399efef1f07

package/dist/pacing/index.d.ts

@@ -0,0 +1,6 @@
+export { FrameCountPacer } from './frame-pacer.js';
+export type { FrameCountPacerOpts, PacerSnapshot } from './frame-pacer.js';
+export { InterleaveTiming } from './interleave-timing.js';
+export type { InterleaveTimingOpts } from './interleave-timing.js';
+export { auDurationMsFromCodec, pictureDurationMs } from './au-duration.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pacing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAClD,YAAY,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACzD,YAAY,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAClE,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/pacing/index.js

@@ -0,0 +1,190 @@
+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
+   *   - 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(observedDelayMs) {
+    if (this.thresholdMs <= 0) return 0;
+    if (!__privateGet(this, _anchored)) return 0;
+    if (__privateGet(this, _frameCount) <= this.warmupFrames) return 0;
+    if (observedDelayMs !== void 0 && Number.isFinite(observedDelayMs) && observedDelayMs > this.thresholdMs) {
+      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   *   - 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 * 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,271 @@
+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
+   *   - 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(observedDelayMs) {
+    if (this.thresholdMs <= 0) return 0;
+    if (!__privateGet(this, _anchored)) return 0;
+    if (__privateGet(this, _frameCount) <= this.warmupFrames) return 0;
+    if (observedDelayMs !== void 0 && Number.isFinite(observedDelayMs) && observedDelayMs > this.thresholdMs) {
+      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