@blockcast/mmt-render 0.3.0-main.d9354616fdf2 → 0.3.0-main.dd5b3a8dcbc8

package/README.md

@@ -1,6 +1,6 @@
 # @blockcast/mmt-render
 
-Shared render pipeline for MMT players: FEC-aware wall-clock pacing, per-AU presentation-time reconstruction under FEC interleave, an `AudioWorkletProcessor` with an exact-timestamp PCM FIFO, and a keyframe-gated `VideoDecoder` driver. The package is the canonical substrate for moqtail, `hang-mmt-fec`, and Shaka integrations so they do not independently invent timing, buffering, or sample-correction policy. It is *not* a "reference renderer + diagnostics UI" — there is no DOM, chart, or catalog browser. Diagnostics are structured snapshots and worklet telemetry messages that callers can render however they like.
+Shared render pipeline for MMT players: FEC-aware wall-clock pacing, an `AudioWorkletProcessor` with an exact-timestamp PCM FIFO, and a keyframe-gated `VideoDecoder` driver. The package is the canonical substrate for moqtail, `hang-mmt-fec`, and Shaka integrations so they do not independently invent timing, buffering, or sample-correction policy. It is *not* a "reference renderer + diagnostics UI" — there is no DOM, chart, or catalog browser. Diagnostics are structured snapshots and worklet telemetry messages that callers can render however they like.
 
 ## Install
 
@@ -17,8 +17,9 @@ import { AudioRenderPipeline } from "@blockcast/mmt-render/audio"
 import { FecBlockMapper } from "@blockcast/mmt-fec"
 
 const ctx = new AudioContext({ sampleRate: 48000 })
-// blockProfile is the catalog `fec.blockProfile`: required, never defaulted.
-const mapper = new FecBlockMapper({ blockProfile: "k-padded-v1", interleaveDepthMs: 66, gopDurationMs: 21.33, k: 32 })
+// blockProfile is the catalog `fec.blockProfile`: required, never defaulted,
+// and "iso-ssbg1-v1" is the only profile (the retired "k-padded-v1" is refused).
+const mapper = new FecBlockMapper({ blockProfile: "iso-ssbg1-v1", interleaveDepthMs: 66, gopDurationMs: 21.33, k: 32 })
 
 const audio = new AudioRenderPipeline({
   context: ctx,
@@ -79,9 +80,8 @@ Per `package.json`:
 | Subpath | Symbols |
 |---------|---------|
 | `@blockcast/mmt-render` | re-exports of `./pacing`, `./audio`, `./video` |
-| `@blockcast/mmt-render/pacing` | `FrameCountPacer`, `InterleaveTiming`, `auDurationMsFromCodec`, `pictureDurationMs` |
+| `@blockcast/mmt-render/pacing` | `FrameCountPacer`, `auDurationMsFromCodec`, `pictureDurationMs` |
 | `@blockcast/mmt-render/pacing/frame-pacer` | `FrameCountPacer` only |
-| `@blockcast/mmt-render/pacing/interleave-timing` | `InterleaveTiming` only |
 | `@blockcast/mmt-render/audio` | `AudioRenderPipeline`, `AudioRingBuffer`, message types, `WORKLET_PROCESSOR_NAME`, `workletModuleUrl` |
 | `@blockcast/mmt-render/audio/ring-buffer` | `AudioRingBuffer` only |
 | `@blockcast/mmt-render/audio/render-messages` | `FromMain` / `ToMain` message types |
@@ -102,18 +102,6 @@ Media-agnostic wall-clock pacer. Anchors on the first `notifyFrame()` call; comp
 
 `PacerSnapshot` exposes `frameCount`, `mediaMs`, `wallMs`, `aheadMs`, `thresholdMs`, `anchored` for diagnostics overlays.
 
-### `InterleaveTiming` (`src/pacing/interleave-timing.ts`)
-
-Per-AU presentation-time reconstruction from FEC coordinates: the `k-padded-v1` K-stride pacing model of `draft-ramadan-moq-fec-00 §8.3`, with `symbolsPerGroup = ceil(K / D)` computed here. It is pacing arithmetic, not an FEC block locator, and refuses a mapper under any other `fec.blockProfile`:
-
-```
-au_index_in_block = groupInBlock × symbolsPerGroup + objectId
-ssId              = sbn × K + au_index_in_block
-presentationUs    = anchorMpuUs + ssId × frameDurationUs
-```
-
-Same answer whether the AU arrived via MoQ unicast (group_id/object_id) or multicast UDP (SS_ID from the FEC Payload ID). Methods: `presentationUs(groupId, objectId)`, `presentationUsFromSsId(ssId)`, `frameAtOffset(offsetUs)` (inverse), `blockTimeRangeUs(sbn)`. Consumers: CMAF segment cut points, debug overlays, cross-path FEC combining.
-
 ### `auDurationMsFromCodec` / `pictureDurationMs` (`src/pacing/au-duration.ts`)
 
 Nominal AU duration helpers. AAC-LC = 1024 samples; Opus default = 960; FLAC = 4096. Throws on unknown codec — no silent fallback. Lives in the pacing subpath specifically to avoid pulling in `mmt-container`.
@@ -201,7 +189,7 @@ pnpm test:watch
 pnpm build           # tsc --emitDeclarationOnly + esbuild bundles (incl. worklet IIFE)
 ```
 
-Existing suites: `frame-pacer.test.ts`, `interleave-timing.test.ts`, `audio-ring-buffer.test.ts`, `keyframe-gate.test.ts`. The pacer suite uses `vi.spyOn(performance, "now")` to drive deterministic wall time. There is no DOM / `AudioContext` integration test — the worklet is exercised in-browser by the consuming players' E2E suites.
+Existing suites: `frame-pacer.test.ts`, `audio-ring-buffer.test.ts`, `keyframe-gate.test.ts`. The pacer suite uses `vi.spyOn(performance, "now")` to drive deterministic wall time. There is no DOM / `AudioContext` integration test — the worklet is exercised in-browser by the consuming players' E2E suites.
 
 ## License
 

package/dist/index.d.ts

@@ -2,7 +2,7 @@
  * @blockcast/mmt-render — shared MMT render pipeline for MoQ players.
  *
  * Subpath exports:
- *   - ./pacing                FrameCountPacer, InterleaveTiming
+ *   - ./pacing                FrameCountPacer
  *   - ./audio                 AudioRenderPipeline, AudioRingBuffer, worklet helpers
  *   - ./video                 VideoRenderPipeline, KeyframeGate
  *   - ./audio/worklet.js      Prebuilt self-contained AudioWorklet bundle

package/dist/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/index.ts"],
-  "sourcesContent": ["/**\n * @blockcast/mmt-render \u2014 shared MMT render pipeline for MoQ players.\n *\n * Subpath exports:\n *   - ./pacing                FrameCountPacer, InterleaveTiming\n *   - ./audio                 AudioRenderPipeline, AudioRingBuffer, worklet helpers\n *   - ./video                 VideoRenderPipeline, KeyframeGate\n *   - ./audio/worklet.js      Prebuilt self-contained AudioWorklet bundle\n */\n\nexport * from './pacing/index.js'\nexport * from './audio/index.js'\nexport * from './video/index.js'\n"],
+  "sourcesContent": ["/**\n * @blockcast/mmt-render \u2014 shared MMT render pipeline for MoQ players.\n *\n * Subpath exports:\n *   - ./pacing                FrameCountPacer\n *   - ./audio                 AudioRenderPipeline, AudioRingBuffer, worklet helpers\n *   - ./video                 VideoRenderPipeline, KeyframeGate\n *   - ./audio/worklet.js      Prebuilt self-contained AudioWorklet bundle\n */\n\nexport * from './pacing/index.js'\nexport * from './audio/index.js'\nexport * from './video/index.js'\n"],
   "mappings": ";AAUA,cAAc;AACd,cAAc;AACd,cAAc;",
   "names": []
 }

package/dist/pacing/index.d.ts

@@ -1,6 +1,4 @@
 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

@@ -1 +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"}
+{"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,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/pacing/index.js

@@ -88,72 +88,6 @@ function now() {
   return Date.now();
 }
 
-// src/pacing/interleave-timing.ts
-var SS_ID_SPAN = 4294967296;
-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");
-    }
-    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;
-  }
-  /**
-   * Presentation time (µs) for an AU at MoQ coords (group_id, object_id).
-   * Per draft §8.3 + Sony anchor.
-   */
-  presentationUs(groupId, objectId) {
-    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
-   * (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 = 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;
-    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");
@@ -174,7 +108,6 @@ function pictureDurationMs(framerate) {
 }
 export {
   FrameCountPacer,
-  InterleaveTiming,
   auDurationMsFromCodec,
   pictureDurationMs
 };

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   *   - 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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",
+  "sources": ["../../src/pacing/frame-pacer.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 * 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": ";AAoDO,IAAM,kBAAN,MAAsB;AAAA,EAK3B,cAAc;AAAA,EACd,gBAAgB;AAAA,EAChB,YAAY;AAAA,EAEZ,YAAY,MAA2B;AACrC,QAAI,EAAE,KAAK,kBAAkB,IAAI;AAC/B,YAAM,IAAI,MAAM,6BAA6B;AAAA,IAC/C;AACA,SAAK,kBAAkB,KAAK;AAC5B,SAAK,cAAc,KAAK,OAAO;AAC/B,SAAK,eAAe,KAAK,IAAI,GAAG,KAAK,gBAAgB,CAAC;AAAA,EACxD;AAAA;AAAA,EAGA,cAAoB;AAClB,QAAI,CAAC,KAAK,WAAW;AACnB,WAAK,gBAAgB,IAAI;AACzB,WAAK,YAAY;AAAA,IACnB;AACA,SAAK;AAAA,EACP;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgCA,eAAe,iBAAkC;AAC/C,QAAI,KAAK,eAAe,EAAG,QAAO;AAClC,QAAI,CAAC,KAAK,UAAW,QAAO;AAC5B,QAAI,KAAK,eAAe,KAAK,aAAc,QAAO;AAIlD,QAAI,oBAAoB,UAAa,OAAO,SAAS,eAAe,KAAK,kBAAkB,KAAK,aAAa;AAC3G,aAAO;AAAA,IACT;AAEA,UAAM,UAAU,KAAK,cAAc,KAAK;AACxC,UAAM,SAAS,IAAI,IAAI,KAAK;AAC5B,UAAM,UAAU,UAAU;AAC1B,QAAI,WAAW,KAAK,YAAa,QAAO;AACxC,WAAO,UAAU,KAAK,cAAc;AAAA,EACtC;AAAA;AAAA,EAGA,QAAc;AACZ,SAAK,cAAc;AACnB,SAAK,gBAAgB;AACrB,SAAK,YAAY;AAAA,EACnB;AAAA,EAEA,IAAI,WAA0B;AAC5B,UAAM,UAAU,KAAK,cAAc,KAAK;AACxC,UAAM,SAAS,KAAK,YAAY,IAAI,IAAI,KAAK,gBAAgB;AAC7D,WAAO;AAAA,MACL,YAAY,KAAK;AAAA,MACjB;AAAA,MACA;AAAA,MACA,SAAS,UAAU;AAAA,MACnB,aAAa,KAAK;AAAA,MAClB,UAAU,KAAK;AAAA,IACjB;AAAA,EACF;AACF;AAEA,SAAS,MAAc;AAGrB,MAAI,OAAO,gBAAgB,eAAe,OAAO,YAAY,QAAQ,YAAY;AAC/E,WAAO,YAAY,IAAI;AAAA,EACzB;AACA,SAAO,KAAK,IAAI;AAClB;;;AC9IO,SAAS,sBAAsB,OAAe,YAA4B;AAC/E,MAAI,EAAE,aAAa,GAAI,OAAM,IAAI,MAAM,wBAAwB;AAC/D,MAAI,MAAM,WAAW,MAAM,KAAK,MAAM,WAAW,MAAM,GAAG;AACxD,WAAQ,MAAM,aAAc;AAAA,EAC9B;AACA,MAAI,MAAM,WAAW,MAAM,KAAK,MAAM,WAAW,KAAK,KAAK,MAAM,WAAW,KAAK,GAAG;AAClF,WAAQ,OAAO,aAAc;AAAA,EAC/B;AACA,MAAI,MAAM,WAAW,MAAM,KAAK,MAAM,WAAW,MAAM,GAAG;AACxD,WAAQ,OAAO,aAAc;AAAA,EAC/B;AACA,QAAM,IAAI,MAAM,mDAAmD,KAAK,EAAE;AAC5E;AAKO,SAAS,kBAAkB,WAA2B;AAC3D,MAAI,EAAE,YAAY,GAAI,OAAM,IAAI,MAAM,uBAAuB;AAC7D,SAAO,MAAO;AAChB;",
   "names": []
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@blockcast/mmt-render",
-  "version": "0.3.0-main.d9354616fdf2",
-  "description": "Shared MMT render pipeline (FEC-aware pacing, interleave timing, audio worklet) for MoQ players",
+  "version": "0.3.0-main.dd5b3a8dcbc8",
+  "description": "Shared MMT render pipeline (FEC-aware pacing, audio worklet, video render) for MoQ players",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -18,10 +18,6 @@
       "import": "./dist/pacing/frame-pacer.js",
       "types": "./dist/pacing/frame-pacer.d.ts"
     },
-    "./pacing/interleave-timing": {
-      "import": "./dist/pacing/interleave-timing.js",
-      "types": "./dist/pacing/interleave-timing.d.ts"
-    },
     "./audio": {
       "import": "./dist/audio/index.js",
       "types": "./dist/audio/index.d.ts"
@@ -73,8 +69,8 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@blockcast/mmt-container": "0.3.0-main.d9354616fdf2",
-    "@blockcast/mmt-fec": "0.3.0-main.d9354616fdf2"
+    "@blockcast/mmt-container": "0.3.0-main.dd5b3a8dcbc8",
+    "@blockcast/mmt-fec": "0.3.0-main.dd5b3a8dcbc8"
   },
   "devDependencies": {
     "@types/audioworklet": "^0.0.77",

package/src/index.ts

@@ -2,7 +2,7 @@
  * @blockcast/mmt-render — shared MMT render pipeline for MoQ players.
  *
  * Subpath exports:
- *   - ./pacing                FrameCountPacer, InterleaveTiming
+ *   - ./pacing                FrameCountPacer
  *   - ./audio                 AudioRenderPipeline, AudioRingBuffer, worklet helpers
  *   - ./video                 VideoRenderPipeline, KeyframeGate
  *   - ./audio/worklet.js      Prebuilt self-contained AudioWorklet bundle

package/src/pacing/index.ts

@@ -1,5 +1,3 @@
 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'

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

@@ -1,73 +0,0 @@
-/**
- * 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.
- *
- * 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 and D); must be `k-padded-v1`. */
-    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;
-    /** 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).
-     * 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

@@ -1 +0,0 @@
-{"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,69 +0,0 @@
-// src/pacing/interleave-timing.ts
-var SS_ID_SPAN = 4294967296;
-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");
-    }
-    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;
-  }
-  /**
-   * Presentation time (µs) for an AU at MoQ coords (group_id, object_id).
-   * Per draft §8.3 + Sony anchor.
-   */
-  presentationUs(groupId, objectId) {
-    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
-   * (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 = 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;
-    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

@@ -1,7 +0,0 @@
-{
-  "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 * 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/src/pacing/interleave-timing.ts

@@ -1,122 +0,0 @@
-/**
- * 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.
- *
- * 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'
-
-/** 2^32: SS_ID is a 32-bit serial number (ISO/IEC 23008-1 C.5.2). */
-const SS_ID_SPAN = 0x1_0000_0000
-
-export interface InterleaveTimingOpts {
-  /** Track's FEC mapper (provides K and D); must be `k-padded-v1`. */
-  mapper: FecBlockMapper
-  /** Nominal AU duration in microseconds. */
-  frameDurationUs: number
-  /** Wall-time anchor: the mpu_timestamp of the first observed AU (µs). */
-  anchorMpuUs: number
-}
-
-export 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) {
-    if (!(opts.frameDurationUs > 0)) {
-      throw new Error('frameDurationUs must be > 0')
-    }
-    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
-  }
-
-  /**
-   * 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 {
-    // §8.3 under k-padded-v1: SBN = floor(G / D), ESI = groupInBlock ×
-    // symbolsPerGroup + O, SS_ID = SBN × K + ESI (a 32-bit serial number;
-    // reduce SBN first so the product stays exact).
-    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
-   * (multicast FEC Payload ID path).
-   */
-  presentationUsFromSsId(ssId: number): number {
-    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: number): { groupId: number; objectId: number; ssId: number } {
-    const rawSsId = Math.max(0, Math.floor(offsetUs / this.frameDurationUs))
-    // k-padded-v1: SBN = floor(SS_ID / K), ESI = SS_ID mod K.
-    const sbn = Math.floor(rawSsId / this.mapper.k)
-    const esi = rawSsId % this.mapper.k
-    // Invert §8.3: esi = groupInBlock * symbolsPerGroup + objectId
-    const spg = this.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: number): { startUs: number; endUs: number } {
-    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,
-    }
-  }
-}