@norskvideo/moq-watch 0.1.2 → 0.1.4

package/README.md

@@ -72,7 +72,7 @@ The simplest way to watch a stream:
 | `muted`   | boolean                             | false    | Mute audio                               |
 | `visible` | never, distance, or always          | `20%`    | When to download video (see below)       |
 | `volume`  | number                              | 0.5      | Audio volume (0-1)                       |
-| `reload`  | boolean                             | true     | Wait for (re)announcement before subscribing. Defaults off for `mediaoverquic.com` relays until they support broadcast discovery. |
+| `reload`  | boolean                             | true     | Wait for (re)announcement before subscribing. Ignored when the relay does not support broadcast discovery. |
 
 The `visible` attribute controls when the video track is downloaded, based on the canvas
 position relative to the viewport:
@@ -129,7 +129,6 @@ The `<moq-watch-ui>` element automatically discovers the nested `<moq-watch>` el
 ## Features
 
 - **WebCodecs decoding** — Hardware-accelerated video and audio decoding
-- **MSE fallback** — Media Source Extensions for broader codec support
 - **Reactive state** — All properties are signals from `@moq/signals`
 - **Chat** — Subscribe to text chat channels
 - **Location** — Peer location and window tracking

package/audio/buffer.d.ts

@@ -18,6 +18,14 @@ export interface AudioBuffer {
     setLatency(samples: number): void;
     /** Flush buffered samples and re-stall, ready to anchor the next utterance (buffered mode). */
     reset(): void;
+    /**
+     * Drop buffered samples at or after `timestamp`, keeping what is already due.
+     *
+     * Used when a new track takes over the timeline: its samples overwrite the slots they land on,
+     * but the previous track's write-ahead tail would otherwise play once the new audio runs out.
+     * Unlike `reset()` this keeps playing, so there's no gap at the handover.
+     */
+    truncate(timestamp: Time.Micro): void;
     /**
      * Resolve once the playhead is near enough to decode a frame at `timestamp`. In buffered mode this
      * applies backpressure: it stays pending while decoding `timestamp` would run more than the latency

package/audio/buffer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buffer.d.ts","sourceRoot":"","sources":["../../src/audio/buffer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAChC,OAAO,EAAU,KAAK,MAAM,EAAU,MAAM,cAAc,CAAC;AAwD3D;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,gFAAgF;IAChF,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;IAE1D,4CAA4C;IAC5C,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAElC,+FAA+F;IAC/F,KAAK,IAAI,IAAI,CAAC;IAEd;;;;;OAKG;IACH,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3C,iEAAiE;IACjE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAEvC,uDAAuD;IACvD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAElC,gEAAgE;IAChE,KAAK,IAAI,IAAI,CAAC;CACd;AAED,0FAA0F;AAC1F,wBAAgB,yBAAyB,IAAI,OAAO,CAMnD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAChC,OAAO,EAAE,gBAAgB,EACzB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,EACtB,QAAQ,UAAQ,GACd,WAAW,CAOb"}
+{"version":3,"file":"buffer.d.ts","sourceRoot":"","sources":["../../src/audio/buffer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAChC,OAAO,EAAU,KAAK,MAAM,EAAU,MAAM,cAAc,CAAC;AAwD3D;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,gFAAgF;IAChF,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;IAE1D,4CAA4C;IAC5C,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAElC,+FAA+F;IAC/F,KAAK,IAAI,IAAI,CAAC;IAEd;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IAEtC;;;;;OAKG;IACH,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3C,iEAAiE;IACjE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAEvC,uDAAuD;IACvD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAElC,gEAAgE;IAChE,KAAK,IAAI,IAAI,CAAC;CACd;AAED,0FAA0F;AAC1F,wBAAgB,yBAAyB,IAAI,OAAO,CAMnD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAChC,OAAO,EAAE,gBAAgB,EACzB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,EACtB,QAAQ,UAAQ,GACd,WAAW,CAUb"}

package/audio/decoder.d.ts

@@ -1,11 +1,23 @@
+import * as Catalog from "@norskvideo/moq-hang/catalog";
+import * as Container from "@norskvideo/moq-hang/container";
 import { Time } from "@norskvideo/moq-net";
-import { type Getter, Signal } from "@norskvideo/moq-signals";
-import type { BufferedRanges } from "../buffered";
+import { type Getter, type Inputs, type Readonlys, Signal } from "@norskvideo/moq-signals";
+import { type Sync } from "../sync";
 import type { Source } from "./source";
-export type DecoderProps = {
-    enabled?: boolean | Signal<boolean>;
+export type DecoderInput = {
+    enabled: Getter<boolean>;
 };
-export interface AudioStats {
+type DecoderOutput = {
+    context: Signal<AudioContext | undefined>;
+    root: Signal<AudioNode | undefined>;
+    sampleRate: Signal<number | undefined>;
+    stats: Signal<Stats | undefined>;
+    timestamp: Signal<Time.Milli | undefined>;
+    stalled: Signal<boolean>;
+    buffered: Signal<Container.BufferedRanges>;
+};
+/** Cumulative audio statistics since the decoder started. */
+export interface Stats {
     /** Number of encoded bytes received. */
     bytesReceived: number;
 }
@@ -16,17 +28,15 @@ export interface AudioStats {
  */
 export declare class Decoder {
     #private;
-    source: Source;
-    enabled: Signal<boolean>;
-    readonly context: Getter<AudioContext | undefined>;
-    readonly root: Getter<AudioNode | undefined>;
-    readonly sampleRate: Getter<number | undefined>;
-    readonly stats: Getter<AudioStats | undefined>;
-    readonly timestamp: Getter<Time.Milli | undefined>;
-    readonly stalled: Getter<boolean>;
-    readonly buffered: Getter<BufferedRanges>;
-    constructor(source: Source, props?: DecoderProps);
+    readonly in: Readonlys<DecoderInput>;
+    readonly source: Source;
+    readonly sync: Sync;
+    readonly out: Readonlys<DecoderOutput>;
+    constructor(source: Source, sync: Sync, props?: Inputs<DecoderInput>);
     reset(): void;
     close(): void;
+    static supported: typeof supported;
 }
+declare function supported(config: Catalog.AudioConfig): Promise<boolean>;
+export {};
 //# sourceMappingURL=decoder.d.ts.map

package/audio/decoder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decoder.d.ts","sourceRoot":"","sources":["../../src/audio/decoder.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAChC,OAAO,EAAU,KAAK,MAAM,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIlD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC,MAAM,MAAM,YAAY,GAAG;IAE1B,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;CACpC,CAAC;AAEF,MAAM,WAAW,UAAU;IAC1B,wCAAwC;IACxC,aAAa,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,qBAAa,OAAO;;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAGzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,YAAY,GAAG,SAAS,CAAC,CAAiB;IAKnE,QAAQ,CAAC,IAAI,EAAoB,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;IAG/D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,GAAG,SAAS,CAAC,CAAoB;IAGnE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,UAAU,GAAG,SAAS,CAAC,CAAe;IAI7D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC,CAAmB;IAIrE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAiB;IAOlD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,cAAc,CAAC,CAAkB;IAuB3D,YAAY,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,YAAY,EAc/C;IA+VD,KAAK,IAAI,IAAI,CAEZ;IAaD,KAAK,SAEJ;CACD"}
+{"version":3,"file":"decoder.d.ts","sourceRoot":"","sources":["../../src/audio/decoder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,mBAAmB,CAAC;AAC7C,OAAO,KAAK,SAAS,MAAM,qBAAqB,CAAC;AAGjD,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAChC,OAAO,EAAU,KAAK,MAAM,EAAU,KAAK,MAAM,EAAE,KAAK,SAAS,EAAa,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3G,OAAO,EAA6B,KAAK,IAAI,EAAE,MAAM,SAAS,CAAC;AAK/D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAWvC,MAAM,MAAM,YAAY,GAAG;IAE1B,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;CACzB,CAAC;AAEF,KAAK,aAAa,GAAG;IACpB,OAAO,EAAE,MAAM,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC;IAI1C,IAAI,EAAE,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;IAEpC,UAAU,EAAE,MAAM,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACvC,KAAK,EAAE,MAAM,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC;IAGjC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC;IAG1C,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAGzB,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;CAC3C,CAAC;AAEF,6DAA6D;AAC7D,MAAM,WAAW,KAAK;IACrB,wCAAwC;IACxC,aAAa,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,qBAAa,OAAO;;IACnB,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAWpB,QAAQ,CAAC,GAAG,2BAAwB;IA0BpC,YAAY,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,YAAY,CAAC,EAanE;IA8bD,KAAK,IAAI,IAAI,CAEZ;IAWD,KAAK,SAEJ;IAGD,MAAM,CAAC,SAAS,mBAAa;CAC7B;AAED,iBAAe,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAsCtE"}

package/audio/emitter.d.ts

@@ -1,17 +1,20 @@
-import { Signal } from "@norskvideo/moq-signals";
+import { type Getter, type Inputs, type Readonlys, Signal } from "@norskvideo/moq-signals";
 import type { Decoder } from "./decoder";
-export type EmitterProps = {
-    volume?: number | Signal<number>;
-    muted?: boolean | Signal<boolean>;
-    paused?: boolean | Signal<boolean>;
+export type EmitterInput = {
+    volume: Getter<number>;
+    muted: Getter<boolean>;
+    paused: Getter<boolean>;
+};
+type EmitterOutput = {
+    enabled: Signal<boolean>;
 };
 export declare class Emitter {
     #private;
-    source: Decoder;
-    volume: Signal<number>;
-    muted: Signal<boolean>;
-    paused: Signal<boolean>;
-    constructor(source: Decoder, props?: EmitterProps);
+    readonly source: Decoder;
+    readonly in: Readonlys<EmitterInput>;
+    readonly out: Readonlys<EmitterOutput>;
+    constructor(source: Decoder, props?: Inputs<EmitterInput>);
     close(): void;
 }
+export {};
 //# sourceMappingURL=emitter.d.ts.map

package/audio/emitter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"emitter.d.ts","sourceRoot":"","sources":["../../src/audio/emitter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,MAAM,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,MAAM,MAAM,YAAY,GAAG;IAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;CACnC,CAAC;AAGF,qBAAa,OAAO;;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAIvB,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAUxB,YAAY,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,YAAY,EAkFhD;IAED,KAAK,SAEJ;CACD"}
+{"version":3,"file":"emitter.d.ts","sourceRoot":"","sources":["../../src/audio/emitter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,MAAM,EAAU,KAAK,MAAM,EAAE,KAAK,SAAS,EAAa,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3G,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,MAAM,MAAM,YAAY,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAIvB,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAGvB,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;CACxB,CAAC;AAEF,KAAK,aAAa,GAAG;IAEpB,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;CACzB,CAAC;AAGF,qBAAa,OAAO;;IACnB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAEzB,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC;IAKrC,QAAQ,CAAC,GAAG,2BAAwB;IAOpC,YAAY,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,YAAY,CAAC,EAoExD;IAED,KAAK,SAEJ;CACD"}

package/audio/handover.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Tracks whether the audio ring still holds samples from a superseded subscription.
+ *
+ * The ring outlives the subscription that fills it, so reopening one (a rendition swap, a
+ * republished broadcast, a reconnect) leaves the previous subscription's decoded audio buffered.
+ * The replacement is the authority from its first frame onwards, so everything the ring holds past
+ * that timestamp is stale and has to go.
+ */
+export declare class Handover {
+    #private;
+    /** Record a subscription opening on the current ring. */
+    opened(): void;
+    /** Consume one decoded frame and report whether it is the first of a replacement subscription. */
+    takeover(): boolean;
+}
+//# sourceMappingURL=handover.d.ts.map

package/audio/handover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handover.d.ts","sourceRoot":"","sources":["../../src/audio/handover.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,qBAAa,QAAQ;;IAIpB,yDAAyD;IACzD,MAAM,IAAI,IAAI,CAGb;IAED,kGAAkG;IAClG,QAAQ,IAAI,OAAO,CAIlB;CACD"}

package/audio/index.d.ts

@@ -1,6 +1,4 @@
-export type * from "./backend";
 export * from "./decoder";
 export * from "./emitter";
-export * from "./mse";
 export * from "./source";
 //# sourceMappingURL=index.d.ts.map

package/audio/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/audio/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,WAAW,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/audio/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC"}

package/audio/render.d.ts

@@ -1,6 +1,7 @@
 import type { Time } from "@norskvideo/moq-net";
 import type { SharedRingBufferInit } from "./shared-ring-buffer";
-export type Message = InitShared | InitPost | Data | Latency | Reset;
+/** Everything the main thread sends the render worklet over its port. */
+export type Message = InitShared | InitPost | Data | Latency | Reset | Truncate;
 export type ToMain = State;
 /** Init message when SharedArrayBuffer is available. */
 export interface InitShared extends SharedRingBufferInit {
@@ -18,6 +19,14 @@ export interface InitPost {
 export interface Reset {
     type: "reset";
 }
+/**
+ * Drop buffered samples at or after `timestamp`, keeping what is already due (fallback path only;
+ * the shared path truncates via Atomics).
+ */
+export interface Truncate {
+    type: "truncate";
+    timestamp: Time.Micro;
+}
 /** Audio samples sent via postMessage (fallback path only). */
 export interface Data {
     type: "data";

package/audio/render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/audio/render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,MAAM,MAAM,OAAO,GAAG,UAAU,GAAG,QAAQ,GAAG,IAAI,GAAG,OAAO,GAAG,KAAK,CAAC;AACrE,MAAM,MAAM,MAAM,GAAG,KAAK,CAAC;AAE3B,wDAAwD;AACxD,MAAM,WAAW,UAAW,SAAQ,oBAAoB;IACvD,IAAI,EAAE,aAAa,CAAC;CACpB;AAED,sDAAsD;AACtD,MAAM,WAAW,QAAQ;IACxB,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC;IAGpB,QAAQ,EAAE,OAAO,CAAC;CAClB;AAED,0FAA0F;AAC1F,MAAM,WAAW,KAAK;IACrB,IAAI,EAAE,OAAO,CAAC;CACd;AAED,+DAA+D;AAC/D,MAAM,WAAW,IAAI;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,YAAY,EAAE,CAAC;IACrB,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC;CACtB;AAED,gEAAgE;AAChE,MAAM,WAAW,OAAO;IACvB,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC;CACpB;AAED,8EAA8E;AAC9E,MAAM,WAAW,KAAK;IACrB,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;CACjB"}
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/audio/render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,yEAAyE;AACzE,MAAM,MAAM,OAAO,GAAG,UAAU,GAAG,QAAQ,GAAG,IAAI,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAC;AAChF,MAAM,MAAM,MAAM,GAAG,KAAK,CAAC;AAE3B,wDAAwD;AACxD,MAAM,WAAW,UAAW,SAAQ,oBAAoB;IACvD,IAAI,EAAE,aAAa,CAAC;CACpB;AAED,sDAAsD;AACtD,MAAM,WAAW,QAAQ;IACxB,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC;IAGpB,QAAQ,EAAE,OAAO,CAAC;CAClB;AAED,0FAA0F;AAC1F,MAAM,WAAW,KAAK;IACrB,IAAI,EAAE,OAAO,CAAC;CACd;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACxB,IAAI,EAAE,UAAU,CAAC;IACjB,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC;CACtB;AAED,+DAA+D;AAC/D,MAAM,WAAW,IAAI;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,YAAY,EAAE,CAAC;IACrB,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC;CACtB;AAED,gEAAgE;AAChE,MAAM,WAAW,OAAO;IACvB,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC;CACpB;AAED,8EAA8E;AAC9E,MAAM,WAAW,KAAK;IACrB,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;CACjB"}

package/audio/ring-buffer.d.ts

@@ -15,6 +15,13 @@ export declare class AudioRingBuffer {
     get capacity(): number;
     resize(latency: Time.Milli): void;
     write(timestamp: Time.Micro, data: Float32Array[]): void;
+    /**
+     * Drop buffered samples at or after `timestamp`, keeping whatever is already due.
+     *
+     * A successor track overwrites the slots its own samples land on, but anything the previous
+     * track wrote beyond them would otherwise still play once the successor runs out.
+     */
+    truncate(timestamp: Time.Micro): void;
     reset(): void;
     read(output: Float32Array[]): number;
 }

package/audio/ring-buffer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ring-buffer.d.ts","sourceRoot":"","sources":["../../src/audio/ring-buffer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAEhC,qBAAa,eAAe;;IAK3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAU1B,YAAY,KAAK,EAAE;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC;QACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACnB,EAqBA;IAMD,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,SAAS,IAAI,IAAI,CAAC,KAAK,CAE1B;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAgChC;IAED,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,IAAI,CA6EvD;IAGD,KAAK,IAAI,IAAI,CAKZ;IAED,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,CAqBnC;CACD"}
+{"version":3,"file":"ring-buffer.d.ts","sourceRoot":"","sources":["../../src/audio/ring-buffer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAEhC,qBAAa,eAAe;;IAK3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAU1B,YAAY,KAAK,EAAE;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC;QACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACnB,EAqBA;IAMD,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,SAAS,IAAI,IAAI,CAAC,KAAK,CAE1B;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAgChC;IAED,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,IAAI,CA8EvD;IAED;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAKpC;IAGD,KAAK,IAAI,IAAI,CAKZ;IAED,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,CAqBnC;CACD"}

package/audio/shared-ring-buffer.d.ts

@@ -5,8 +5,15 @@ export interface SharedRingBufferInit {
     rate: number;
     samples: SharedArrayBuffer;
     control: SharedArrayBuffer;
+    state: SharedArrayBuffer;
     buffered: boolean;
 }
+/**
+ * Allocate the shared memory for a ring holding at least `capacity` samples per channel.
+ *
+ * The capacity is rounded up to a power of two so `slot` can mask instead of taking a
+ * remainder; read `init.capacity` back rather than assuming the requested value.
+ */
 export declare function allocSharedRingBuffer(channels: number, capacity: number, rate: number, buffered?: boolean): SharedRingBufferInit;
 export declare class SharedRingBuffer {
     #private;
@@ -15,7 +22,15 @@ export declare class SharedRingBuffer {
     readonly rate: number;
     readonly buffered: boolean;
     readonly init: SharedRingBufferInit;
-    constructor(init: SharedRingBufferInit);
+    /**
+     * Wrap the shared memory described by `init`.
+     *
+     * Pass `previous` in the worklet when this ring replaces one already being read. `resize`
+     * snapshots the playhead on the main thread and hands the replacement over by message, so the
+     * reader keeps draining the old ring in the meantime. Carrying its cursor across means those
+     * samples are not played twice.
+     */
+    constructor(init: SharedRingBufferInit, previous?: SharedRingBuffer);
     /**
      * Insert audio samples at the given timestamp.
      * Main thread only. Handles out-of-order writes, gap filling, and overflow.
@@ -28,6 +43,14 @@ export declare class SharedRingBuffer {
     read(output: Float32Array[]): number;
     /** Update the target latency in samples. */
     setLatency(samples: number): void;
+    /**
+     * Drop buffered samples at or after `timestamp`, keeping whatever is already due.
+     * Main thread only.
+     *
+     * A successor track overwrites the slots its own samples land on, but anything the previous
+     * track wrote beyond them would otherwise still play once the successor runs out.
+     */
+    truncate(timestamp: Time.Micro): void;
     /**
      * Flush buffered samples and re-stall, ready to anchor the next utterance (buffered mode).
      * Main thread only. The worklet reader sees STALLED and stops until the next insert.
@@ -46,7 +69,12 @@ export declare class SharedRingBuffer {
      * by READ/WRITE elsewhere.
      */
     resize(newCapacity: number): SharedRingBuffer;
-    /** Current playback timestamp derived from READ position. */
+    /**
+     * Current playback timestamp derived from READ position.
+     *
+     * Main thread only, and stateful: it advances the unwrapped read position, so it has to be
+     * polled rather than sampled once. See `#position`.
+     */
     get timestamp(): Time.Micro;
     /** Whether the buffer is stalled (waiting to fill). */
     get stalled(): boolean;

package/audio/shared-ring-buffer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shared-ring-buffer.d.ts","sourceRoot":"","sources":["../../src/audio/shared-ring-buffer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAShC,MAAM,WAAW,oBAAoB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,iBAAiB,CAAC;IAC3B,OAAO,EAAE,iBAAiB,CAAC;IAE3B,QAAQ,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,qBAAqB,CACpC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,QAAQ,UAAQ,GACd,oBAAoB,CAatB;AA0BD,qBAAa,gBAAgB;;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IAQpC,YAAY,IAAI,EAAE,oBAAoB,EAcrC;IAED;;;OAGG;IACH,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,IAAI,CAqExD;IAED;;;OAGG;IACH,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,CAiCnC;IAED,4CAA4C;IAC5C,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEhC;IAED;;;OAGG;IACH,KAAK,IAAI,IAAI,CAKZ;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,gBAAgB,CA6B5C;IAED,6DAA6D;IAC7D,IAAI,SAAS,IAAI,IAAI,CAAC,KAAK,CAG1B;IAED,uDAAuD;IACvD,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;;;;;OAMG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;CACD"}
+{"version":3,"file":"shared-ring-buffer.d.ts","sourceRoot":"","sources":["../../src/audio/shared-ring-buffer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAmChC,MAAM,WAAW,oBAAoB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,iBAAiB,CAAC;IAC3B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,KAAK,EAAE,iBAAiB,CAAC;IAEzB,QAAQ,EAAE,OAAO,CAAC;CAClB;AAOD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACpC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,QAAQ,UAAQ,GACd,oBAAoB,CAgBtB;AAkBD,qBAAa,gBAAgB;;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IAuBpC;;;;;;;OAOG;IACH,YAAY,IAAI,EAAE,oBAAoB,EAAE,QAAQ,CAAC,EAAE,gBAAgB,EAiBlE;IA0CD;;;OAGG;IACH,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,IAAI,CAmFxD;IAED;;;OAGG;IACH,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,CAqDnC;IAED,4CAA4C;IAC5C,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEhC;IAED;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAcpC;IAED;;;OAGG;IACH,KAAK,IAAI,IAAI,CAMZ;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,gBAAgB,CAqC5C;IAiBD;;;;;OAKG;IACH,IAAI,SAAS,IAAI,IAAI,CAAC,KAAK,CAE1B;IAED,uDAAuD;IACvD,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;;;;;OAMG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;CACD"}

package/audio/source.d.ts

@@ -1,34 +1,38 @@
 import type * as Catalog from "@norskvideo/moq-hang/catalog";
-import { type Getter, Signal } from "@norskvideo/moq-signals";
+import type * as Moq from "@norskvideo/moq-net";
+import { type Getter, type Inputs, type Readonlys, Signal } from "@norskvideo/moq-signals";
 import type { Broadcast } from "../broadcast";
-import type { Sync } from "../sync";
 export type Target = {
     name?: string;
 };
 /**
- * A function that checks if an audio configuration is supported by the backend.
+ * A function that checks if an audio configuration can be played.
+ *
+ * `Decoder.supported` is the WebCodecs probe used by `<moq-watch>`.
  */
 export type Supported = (config: Catalog.AudioConfig) => Promise<boolean>;
-export type SourceProps = {
-    broadcast?: Broadcast | Signal<Broadcast | undefined>;
-    target?: Target | Signal<Target | undefined>;
-    supported?: Supported;
+export type SourceInput = {
+    broadcast: Getter<Broadcast | undefined>;
+    target: Getter<Target | undefined>;
+    supported: Getter<Supported | undefined>;
+};
+type SourceOutput = {
+    catalog: Signal<Catalog.Audio | undefined>;
+    available: Signal<Record<string, Catalog.AudioConfig>>;
+    track: Signal<string | undefined>;
+    config: Signal<Catalog.AudioConfig | undefined>;
+    jitter: Signal<Moq.Time.Milli | undefined>;
 };
 /**
  * Source handles catalog extraction, support checking, and rendition selection
- * for audio playback. It is used by both MSE and Decoder backends.
+ * for audio playback. The Decoder consumes whichever rendition it picks.
  */
 export declare class Source {
     #private;
-    broadcast: Signal<Broadcast | undefined>;
-    target: Signal<Target | undefined>;
-    readonly catalog: Getter<Catalog.Audio | undefined>;
-    readonly available: Getter<Record<string, Catalog.AudioConfig>>;
-    readonly track: Signal<string | undefined>;
-    readonly config: Getter<Catalog.AudioConfig | undefined>;
-    supported: Signal<Supported | undefined>;
-    sync: Sync;
-    constructor(sync: Sync, props?: SourceProps);
+    readonly in: Readonlys<SourceInput>;
+    readonly out: Readonlys<SourceOutput>;
+    constructor(props?: Inputs<SourceInput>);
     close(): void;
 }
+export {};
 //# sourceMappingURL=source.d.ts.map

package/audio/source.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../src/audio/source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,OAAO,MAAM,mBAAmB,CAAC;AAElD,OAAO,EAAU,KAAK,MAAM,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAKpC,MAAM,MAAM,MAAM,GAAG;IAEpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAE1E,MAAM,MAAM,WAAW,GAAG;IACzB,SAAS,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;IAGtD,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAG7C,SAAS,CAAC,EAAE,SAAS,CAAC;CACtB,CAAC;AAEF;;;GAGG;AACH,qBAAa,MAAM;;IAClB,SAAS,EAAE,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;IACzC,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAEnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC;IAGpD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,CAAmB;IAGlF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,GAAG,SAAS,CAAC,CAAe;IAGzD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAAgB;IAExE,SAAS,EAAE,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;IAGzC,IAAI,EAAE,IAAI,CAAC;IAIX,YAAY,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,EAAE,WAAW,EAe1C;IAiFD,KAAK,IAAI,IAAI,CAEZ;CACD"}
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../src/audio/source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,OAAO,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,KAAK,GAAG,MAAM,UAAU,CAAC;AAErC,OAAO,EAAU,KAAK,MAAM,EAAU,KAAK,MAAM,EAAE,KAAK,SAAS,EAAa,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3G,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAK9C,MAAM,MAAM,MAAM,GAAG;IAEpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAE1E,MAAM,MAAM,WAAW,GAAG;IACzB,SAAS,EAAE,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;IAGzC,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAInC,SAAS,EAAE,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;CACzC,CAAC;AAEF,KAAK,YAAY,GAAG;IACnB,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC;IAC3C,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;IACvD,KAAK,EAAE,MAAM,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;IAGhD,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC;CAC3C,CAAC;AAEF;;;GAGG;AACH,qBAAa,MAAM;;IAClB,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;IASpC,QAAQ,CAAC,GAAG,0BAAwB;IAIpC,YAAY,KAAK,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC,EAUtC;IAoGD,KAAK,IAAI,IAAI,CAEZ;CACD"}

package/audio/subscription.d.ts

@@ -0,0 +1,10 @@
+import type * as Moq from "@norskvideo/moq-net";
+import type { Time } from "@norskvideo/moq-net";
+import type { Effect, Getter } from "@norskvideo/moq-signals";
+/** Opens a live-edge audio subscription and keeps its expiry budget aligned with playback. @internal */
+export declare function subscribe(effect: Effect, { broadcast, track, maxLatency, }: {
+    broadcast: Moq.Broadcast.Consumer;
+    track: string;
+    maxLatency: Getter<Time.Milli>;
+}): Moq.Track.Subscriber;
+//# sourceMappingURL=subscription.d.ts.map

package/audio/subscription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.d.ts","sourceRoot":"","sources":["../../src/audio/subscription.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,GAAG,MAAM,UAAU,CAAC;AACrC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEnD,wGAAwG;AACxG,wBAAgB,SAAS,CACxB,MAAM,EAAE,MAAM,EACd,EACC,SAAS,EACT,KAAK,EACL,UAAU,GACV,EAAE;IACF,SAAS,EAAE,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;CAC/B,GACC,GAAG,CAAC,KAAK,CAAC,UAAU,CActB"}

package/audio/terminal.d.ts

@@ -0,0 +1,36 @@
+import type { Time } from "@norskvideo/moq-net";
+interface SampleSpan {
+    readonly timestamp: number;
+    readonly sampleRate: number;
+    readonly numberOfFrames: number;
+}
+interface Update {
+    readonly discontinuity: number;
+    readonly end?: Time.Micro;
+    readonly frame?: {
+        readonly timestamp: Time.Micro;
+    };
+}
+/** The portion of decoded audio that belongs to the source timeline. */
+export interface DecodedSpan {
+    /** Source timestamp of the first retained frame. */
+    readonly timestamp: Time.Micro;
+    /** Decoded frames to skip before copying. */
+    readonly frameOffset: number;
+    /** Decoded frames to retain after the offset. */
+    readonly frames: number;
+}
+/** Track codec epochs and map decoded output onto the source timeline. */
+export declare class Terminal {
+    #private;
+    /** The exclusive source endpoint most recently received. */
+    get end(): Time.Micro | undefined;
+    /** Reset state for a new container consumer with Opus pre-skip in 48 kHz frames. */
+    clear(preSkip?: number): void;
+    /** Apply one ordered consumer result and report whether its codec epoch changed. */
+    update(next: Update): boolean;
+    /** Remove codec pre-skip and terminal padding from one decoded sample. */
+    span(sample: SampleSpan): DecodedSpan;
+}
+export {};
+//# sourceMappingURL=terminal.d.ts.map

package/audio/terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../src/audio/terminal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAErC,UAAU,UAAU;IACnB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CAChC;AAED,UAAU,MAAM;IACf,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAA;KAAE,CAAC;CACpD;AAED,wEAAwE;AACxE,MAAM,WAAW,WAAW;IAC3B,oDAAoD;IACpD,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC;IAC/B,6CAA6C;IAC7C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,iDAAiD;IACjD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACxB;AAED,0EAA0E;AAC1E,qBAAa,QAAQ;;IAOpB,4DAA4D;IAC5D,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,GAAG,SAAS,CAEhC;IAED,oFAAoF;IACpF,KAAK,CAAC,OAAO,SAAI,GAAG,IAAI,CAKvB;IAED,oFAAoF;IACpF,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAU5B;IAED,0EAA0E;IAC1E,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,WAAW,CAuBpC;CAMD"}

package/audio/unlock.d.ts

@@ -0,0 +1,20 @@
+import { type Effect } from "@norskvideo/moq-signals";
+/**
+ * Resume a suspended {@link AudioContext} from a real user gesture.
+ *
+ * The context is built at page load, before any user activation can exist, so browsers that
+ * gate audio on a gesture reject a `resume()` made then. A single unconditional attempt would
+ * fire once, be rejected, and never retry, leaving audio silent. This instead attempts
+ * `resume()` immediately (for autoplay-permissive browsers like Chrome with prior engagement),
+ * then retries on every `pointerdown`/`keydown` until the context is actually running, dropping
+ * the gesture listeners once it is. `pointerdown` and `keydown` cover mouse, touch, pen, and
+ * keyboard, and each carries a user activation.
+ *
+ * Safari also reports an "interrupted" state (a WebKit-only value outside the
+ * suspended/running/closed set) and can leave it on its own; mirroring `statechange` into a
+ * signal picks that up so the listeners are re-armed or dropped as the state moves.
+ *
+ * Scoped to `effect`: the listeners are removed when the effect reruns or closes.
+ */
+export declare function unlockOnGesture(effect: Effect, context: AudioContext): void;
+//# sourceMappingURL=unlock.d.ts.map

package/audio/unlock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unlock.d.ts","sourceRoot":"","sources":["../../src/audio/unlock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAU,MAAM,cAAc,CAAC;AAEnD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAe3E"}

package/audio/warmup.d.ts

@@ -0,0 +1,9 @@
+/** Tracks decoder callbacks discarded during initial playback setup. */
+export declare class Warmup {
+    #private;
+    /** Create a warm-up window containing `callbacks` decoder callbacks. */
+    constructor(callbacks: number);
+    /** Consume one callback and report whether it belongs to the warm-up window. */
+    drop(): boolean;
+}
+//# sourceMappingURL=warmup.d.ts.map

package/audio/warmup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warmup.d.ts","sourceRoot":"","sources":["../../src/audio/warmup.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,qBAAa,MAAM;;IAGlB,wEAAwE;IACxE,YAAY,SAAS,EAAE,MAAM,EAE5B;IAED,gFAAgF;IAChF,IAAI,IAAI,OAAO,CAId;CACD"}

package/broadcast.d.ts

@@ -1,71 +1,31 @@
 import * as Catalog from "@norskvideo/moq-hang/catalog";
 import type * as Moq from "@norskvideo/moq-net";
-import { Effect, type Getter, Signal } from "@norskvideo/moq-signals";
-/** Consumes a custom track once subscribed, scoped to the subscription's lifetime. */
-export type ConsumeTrack = (track: Moq.Track, effect: Effect) => void;
-/**
- * Catalog formats accepted by Watch.
- *
- * Watch supports the on-the-wire catalog formats from `@norskvideo/moq-hang`, plus
- * `"hangz"` (the DEFLATE-compressed `catalog.json.z` track) and `"manual"`, where
- * the user supplies the catalog directly without fetching. `"hangz"` is opt-in
- * only: it shares the `.hang` broadcast suffix and is never auto-detected, so set
- * it explicitly via `catalogFormat`.
- */
+import { Effect, type Getter, type Inputs, type Readonlys, Signal } from "@norskvideo/moq-signals";
 export declare const CATALOG_FORMATS: readonly ["hang", "msf", "hangz", "manual"];
-/** A catalog format accepted by Watch. */
 export type CatalogFormat = (typeof CATALOG_FORMATS)[number];
-/** Parse a catalog format string, returning `undefined` for unknown values. */
 export declare function parseCatalogFormat(value: string | null): CatalogFormat | undefined;
-export interface BroadcastProps {
-    connection?: Moq.Connection.Established | Signal<Moq.Connection.Established | undefined>;
-    announced?: Getter<Set<Moq.Path.Valid>>;
-    enabled?: boolean | Signal<boolean>;
-    name?: Moq.Path.Valid | Signal<Moq.Path.Valid>;
-    reload?: boolean | Signal<boolean>;
-    catalogFormat?: CatalogFormat | Signal<CatalogFormat | undefined>;
-    catalog?: Catalog.Root | Signal<Catalog.Root | undefined>;
-}
-/** A catalog source that optionally reloads automatically when live or offline. */
+type Status = "offline" | "loading" | "live";
+export type BroadcastInput = {
+    connection: Getter<Moq.Connection.Established | undefined>;
+    enabled: Getter<boolean>;
+    name: Getter<Moq.Path.Valid>;
+    reload: Getter<boolean>;
+    catalogFormat: Getter<CatalogFormat | undefined>;
+    catalog: Getter<Catalog.Root | undefined>;
+};
+type BroadcastOutput = {
+    status: Signal<Status>;
+    active: Signal<Moq.Broadcast.Consumer | undefined>;
+    catalog: Signal<Catalog.Root | undefined>;
+};
 export declare class Broadcast {
     #private;
-    connection: Signal<Moq.Connection.Established | undefined>;
-    enabled: Signal<boolean>;
-    name: Signal<Moq.Path.Valid>;
-    status: Signal<"live" | "loading" | "offline">;
-    reload: Signal<boolean>;
-    catalogFormat: Signal<CatalogFormat | undefined>;
-    readonly active: Getter<Moq.Broadcast | undefined>;
-    catalog: Signal<Catalog.Root | undefined>;
-    signals: Effect;
-    constructor(props?: BroadcastProps);
-    /**
-     * Subscribe to a custom track within this broadcast, following the active broadcast across
-     * reconnects. `consume` runs with a freshly-subscribed track and a subscription-scoped effect
-     * each time a broadcast becomes active (re-running on reconnect).
-     *
-     * For a JSON track, wrap the track with a `@norskvideo/moq-json` `Consumer` and read it in a spawned loop
-     * (e.g. into a Signal). An application advertises the track in its own catalog section, which it
-     * reads back from {@link catalog} (unknown sections pass through the loose schema):
-     *
-     * ```ts
-     * import * as Json from "@norskvideo/moq-json";
-     * const scte35 = new Signal<{ splices: number[] } | undefined>(undefined);
-     * broadcast.subscribeTrack("scte35.json", Catalog.PRIORITY.catalog, (track, effect) => {
-     * 	const consumer = new Json.Snapshot.Consumer<{ splices: number[] }>(track);
-     * 	effect.spawn(async () => {
-     * 		for (;;) {
-     * 			const next = await Promise.race([effect.cancel, consumer.next()]);
-     * 			if (next === undefined) break;
-     * 			scte35.set(next);
-     * 		}
-     * 	});
-     * });
-     * ```
-     *
-     * Returns a function to stop subscribing; also stopped when this broadcast closes.
-     */
-    subscribeTrack(name: string, priority: number, consume: ConsumeTrack): () => void;
+    readonly in: Readonlys<BroadcastInput>;
+    readonly out: Readonlys<BroadcastOutput>;
+    constructor(props?: Inputs<BroadcastInput>);
+    /** Resolve a rendition's `broadcast` reference to a consumer, or `undefined` if unreachable. */
+    relativeBroadcast(effect: Effect, rel: string | undefined): Moq.Broadcast.Consumer | undefined;
     close(): void;
 }
+export {};
 //# sourceMappingURL=broadcast.d.ts.map

package/broadcast.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"broadcast.d.ts","sourceRoot":"","sources":["../src/broadcast.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,mBAAmB,CAAC;AAE7C,OAAO,KAAK,KAAK,GAAG,MAAM,UAAU,CAAC;AAErC,OAAO,EAAE,MAAM,EAAE,KAAK,MAAM,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAI3D,sFAAsF;AACtF,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;AAEtE;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,6CAAmD,CAAC;AAChF,0CAA0C;AAC1C,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,aAAa,GAAG,SAAS,CAGlF;AAED,MAAM,WAAW,cAAc;IAC9B,UAAU,CAAC,EAAE,GAAG,CAAC,UAAU,CAAC,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;IAIzF,SAAS,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAIxC,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAGpC,IAAI,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAI/C,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAOnC,aAAa,CAAC,EAAE,aAAa,GAAG,MAAM,CAAC,aAAa,GAAG,SAAS,CAAC,CAAC;IAOlE,OAAO,CAAC,EAAE,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,CAAC;CAC1D;AAED,mFAAmF;AACnF,qBAAa,SAAS;;IACrB,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;IAE3D,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,MAAM,yCAAyD;IAC/D,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAGxB,aAAa,EAAE,MAAM,CAAC,aAAa,GAAG,SAAS,CAAC,CAAC;IAGjD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,SAAS,GAAG,SAAS,CAAC,CAAgB;IAIlE,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,CAAC;IAU1C,OAAO,SAAgB;IAEvB,YAAY,KAAK,CAAC,EAAE,cAAc,EAajC;IAuGD;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,IAAI,CAahF;IAED,KAAK,SAEJ;CACD"}
+{"version":3,"file":"broadcast.d.ts","sourceRoot":"","sources":["../src/broadcast.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,mBAAmB,CAAC;AAG7C,OAAO,KAAK,KAAK,GAAG,MAAM,UAAU,CAAC;AAErC,OAAO,EAAE,MAAM,EAAE,KAAK,MAAM,EAAU,KAAK,MAAM,EAAE,KAAK,SAAS,EAAa,MAAM,EAAE,MAAM,cAAc,CAAC;AAmD3G,eAAO,MAAM,eAAe,6CAAmD,CAAC;AAChF,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,aAAa,GAAG,SAAS,CAGlF;AAED,KAAK,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;AAI7C,MAAM,MAAM,cAAc,GAAG;IAC5B,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;IAI3D,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAGzB,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAI7B,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAOxB,aAAa,EAAE,MAAM,CAAC,aAAa,GAAG,SAAS,CAAC,CAAC;IAIjD,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,CAAC;CAC1C,CAAC;AAEF,KAAK,eAAe,GAAG;IACtB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,GAAG,SAAS,CAAC,CAAC;IAKnD,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,CAAC;CAC1C,CAAC;AAGF,qBAAa,SAAS;;IACrB,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC,cAAc,CAAC,CAAC;IAOvC,QAAQ,CAAC,GAAG,6BAAwB;IAsBpC,YAAY,KAAK,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC,EAczC;IAuLD,gGAAgG;IAChG,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC,QAAQ,GAAG,SAAS,CAa7F;IAED,KAAK,SAEJ;CACD"}