@blockcast/mmt-render 0.1.0 → 0.3.0-main.36c5f6abe867

package/dist/pacing/index.js.map

@@ -1,7 +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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",
+  "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 * This is the `k-padded-v1` K-stride pacing model and nothing more: it is\n * presentation-time arithmetic for a stream whose blocks are K symbols and D\n * media groups long, NOT an FEC block locator. FecBlockMapper no longer maps\n * media groups to blocks (BLO-35597), so the stride math lives here, and a\n * stream under any other `fec.blockProfile` (an `iso-ssbg1-v1` block's length\n * is stated per block on the wire, so it has no stride) is refused.\n */\n\nimport type { FecBlockMapper } from '@blockcast/mmt-fec'\n\n/** 2^32: SS_ID is a 32-bit serial number (ISO/IEC 23008-1 C.5.2). */\nconst SS_ID_SPAN = 0x1_0000_0000\n\nexport interface InterleaveTimingOpts {\n  /** Track's FEC mapper (provides K and D); must be `k-padded-v1`. */\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  /** Source symbols contributed by each media group: ceil(K / D). */\n  readonly symbolsPerGroup: 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    if (opts.mapper.blockProfile !== 'k-padded-v1') {\n      throw new Error(\n        `InterleaveTiming is the k-padded-v1 K-stride pacing model; a ${opts.mapper.blockProfile ?? 'non-FEC'} ` +\n          'stream has no K-stride block geometry',\n      )\n    }\n    this.mapper = opts.mapper\n    this.symbolsPerGroup = Math.ceil(opts.mapper.k / opts.mapper.d)\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    // \u00A78.3 under k-padded-v1: SBN = floor(G / D), ESI = groupInBlock \u00D7\n    // symbolsPerGroup + O, SS_ID = SBN \u00D7 K + ESI (a 32-bit serial number;\n    // reduce SBN first so the product stays exact).\n    const { k, d } = this.mapper\n    const sbn = Math.floor(groupId / d)\n    const esi = (groupId - sbn * d) * this.symbolsPerGroup + objectId\n    const ssId = ((sbn % SS_ID_SPAN) * k + esi) % SS_ID_SPAN\n    return this.anchorMpuUs + 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    // k-padded-v1: SBN = floor(SS_ID / K), ESI = SS_ID mod K.\n    const sbn = Math.floor(rawSsId / this.mapper.k)\n    const esi = rawSsId % this.mapper.k\n    // Invert \u00A78.3: esi = groupInBlock * symbolsPerGroup + objectId\n    const spg = this.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

@@ -18,10 +18,17 @@
  *
  * Consumers: CMAF segment assembler (block boundary → segment cut points),
  * debug overlays, cross-path FEC combining, sync diagnostics.
+ *
+ * This is the `k-padded-v1` K-stride pacing model and nothing more: it is
+ * presentation-time arithmetic for a stream whose blocks are K symbols and D
+ * media groups long, NOT an FEC block locator. FecBlockMapper no longer maps
+ * media groups to blocks (BLO-35597), so the stride math lives here, and a
+ * stream under any other `fec.blockProfile` (an `iso-ssbg1-v1` block's length
+ * is stated per block on the wire, so it has no stride) is refused.
  */
 import type { FecBlockMapper } from '@blockcast/mmt-fec';
 export interface InterleaveTimingOpts {
-    /** Track's FEC mapper (provides K, D, symbolsPerGroup). */
+    /** Track's FEC mapper (provides K and D); must be `k-padded-v1`. */
     mapper: FecBlockMapper;
     /** Nominal AU duration in microseconds. */
     frameDurationUs: number;
@@ -32,6 +39,8 @@ export declare class InterleaveTiming {
     readonly mapper: FecBlockMapper;
     readonly frameDurationUs: number;
     readonly anchorMpuUs: number;
+    /** Source symbols contributed by each media group: ceil(K / D). */
+    readonly symbolsPerGroup: number;
     constructor(opts: InterleaveTimingOpts);
     /**
      * Presentation time (µs) for an AU at MoQ coords (group_id, object_id).

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

@@ -1 +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"}
+{"version":3,"file":"interleave-timing.d.ts","sourceRoot":"","sources":["../../src/pacing/interleave-timing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAKxD,MAAM,WAAW,oBAAoB;IACnC,oEAAoE;IACpE,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;IAC5B,mEAAmE;IACnE,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;gBAEpB,IAAI,EAAE,oBAAoB;IAmBtC;;;OAGG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAWzD;;;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;IAapF;;;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

@@ -1,4 +1,5 @@
 // src/pacing/interleave-timing.ts
+var SS_ID_SPAN = 4294967296;
 var InterleaveTiming = class {
   constructor(opts) {
     if (!(opts.frameDurationUs > 0)) {
@@ -7,7 +8,13 @@ var InterleaveTiming = class {
     if (!Number.isFinite(opts.anchorMpuUs)) {
       throw new Error("anchorMpuUs must be finite");
     }
+    if (opts.mapper.blockProfile !== "k-padded-v1") {
+      throw new Error(
+        `InterleaveTiming is the k-padded-v1 K-stride pacing model; a ${opts.mapper.blockProfile ?? "non-FEC"} stream has no K-stride block geometry`
+      );
+    }
     this.mapper = opts.mapper;
+    this.symbolsPerGroup = Math.ceil(opts.mapper.k / opts.mapper.d);
     this.frameDurationUs = opts.frameDurationUs;
     this.anchorMpuUs = opts.anchorMpuUs;
   }
@@ -16,8 +23,11 @@ var InterleaveTiming = class {
    * Per draft §8.3 + Sony anchor.
    */
   presentationUs(groupId, objectId) {
-    const coords = this.mapper.derive(groupId, objectId);
-    return this.anchorMpuUs + coords.ssId * this.frameDurationUs;
+    const { k, d } = this.mapper;
+    const sbn = Math.floor(groupId / d);
+    const esi = (groupId - sbn * d) * this.symbolsPerGroup + objectId;
+    const ssId = (sbn % SS_ID_SPAN * k + esi) % SS_ID_SPAN;
+    return this.anchorMpuUs + ssId * this.frameDurationUs;
   }
   /**
    * Presentation time (µs) for an AU identified by its flat SS_ID
@@ -32,8 +42,9 @@ var InterleaveTiming = class {
    */
   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 sbn = Math.floor(rawSsId / this.mapper.k);
+    const esi = rawSsId % this.mapper.k;
+    const spg = this.symbolsPerGroup;
     const groupInBlock = Math.floor(esi / spg);
     const objectId = esi - groupInBlock * spg;
     const groupId = sbn * this.mapper.d + groupInBlock;

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

@@ -1,7 +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;",
+  "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 * This is the `k-padded-v1` K-stride pacing model and nothing more: it is\n * presentation-time arithmetic for a stream whose blocks are K symbols and D\n * media groups long, NOT an FEC block locator. FecBlockMapper no longer maps\n * media groups to blocks (BLO-35597), so the stride math lives here, and a\n * stream under any other `fec.blockProfile` (an `iso-ssbg1-v1` block's length\n * is stated per block on the wire, so it has no stride) is refused.\n */\n\nimport type { FecBlockMapper } from '@blockcast/mmt-fec'\n\n/** 2^32: SS_ID is a 32-bit serial number (ISO/IEC 23008-1 C.5.2). */\nconst SS_ID_SPAN = 0x1_0000_0000\n\nexport interface InterleaveTimingOpts {\n  /** Track's FEC mapper (provides K and D); must be `k-padded-v1`. */\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  /** Source symbols contributed by each media group: ceil(K / D). */\n  readonly symbolsPerGroup: 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    if (opts.mapper.blockProfile !== 'k-padded-v1') {\n      throw new Error(\n        `InterleaveTiming is the k-padded-v1 K-stride pacing model; a ${opts.mapper.blockProfile ?? 'non-FEC'} ` +\n          'stream has no K-stride block geometry',\n      )\n    }\n    this.mapper = opts.mapper\n    this.symbolsPerGroup = Math.ceil(opts.mapper.k / opts.mapper.d)\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    // \u00A78.3 under k-padded-v1: SBN = floor(G / D), ESI = groupInBlock \u00D7\n    // symbolsPerGroup + O, SS_ID = SBN \u00D7 K + ESI (a 32-bit serial number;\n    // reduce SBN first so the product stays exact).\n    const { k, d } = this.mapper\n    const sbn = Math.floor(groupId / d)\n    const esi = (groupId - sbn * d) * this.symbolsPerGroup + objectId\n    const ssId = ((sbn % SS_ID_SPAN) * k + esi) % SS_ID_SPAN\n    return this.anchorMpuUs + 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    // k-padded-v1: SBN = floor(SS_ID / K), ESI = SS_ID mod K.\n    const sbn = Math.floor(rawSsId / this.mapper.k)\n    const esi = rawSsId % this.mapper.k\n    // Invert \u00A78.3: esi = groupInBlock * symbolsPerGroup + objectId\n    const spg = this.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": ";AAgCA,IAAM,aAAa;AAWZ,IAAM,mBAAN,MAAuB;AAAA,EAO5B,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,QAAI,KAAK,OAAO,iBAAiB,eAAe;AAC9C,YAAM,IAAI;AAAA,QACR,gEAAgE,KAAK,OAAO,gBAAgB,SAAS;AAAA,MAEvG;AAAA,IACF;AACA,SAAK,SAAS,KAAK;AACnB,SAAK,kBAAkB,KAAK,KAAK,KAAK,OAAO,IAAI,KAAK,OAAO,CAAC;AAC9D,SAAK,kBAAkB,KAAK;AAC5B,SAAK,cAAc,KAAK;AAAA,EAC1B;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,eAAe,SAAiB,UAA0B;AAIxD,UAAM,EAAE,GAAG,EAAE,IAAI,KAAK;AACtB,UAAM,MAAM,KAAK,MAAM,UAAU,CAAC;AAClC,UAAM,OAAO,UAAU,MAAM,KAAK,KAAK,kBAAkB;AACzD,UAAM,QAAS,MAAM,aAAc,IAAI,OAAO;AAC9C,WAAO,KAAK,cAAc,OAAO,KAAK;AAAA,EACxC;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;AAEvE,UAAM,MAAM,KAAK,MAAM,UAAU,KAAK,OAAO,CAAC;AAC9C,UAAM,MAAM,UAAU,KAAK,OAAO;AAElC,UAAM,MAAM,KAAK;AACjB,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.js

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