@norskvideo/moq-watch 0.1.0

package/README.md

@@ -0,0 +1,143 @@
+<p align="center">
+	<img height="128px" src="https://github.com/moq-dev/moq/blob/main/.github/logo.svg" alt="Media over QUIC">
+</p>
+
+# @moq/watch
+
+[![npm](https://img.shields.io/npm/v/@moq/watch)](https://www.npmjs.com/package/@moq/watch)
+[![TypeScript](https://img.shields.io/badge/TypeScript-ready-blue.svg)](https://www.typescriptlang.org/)
+
+Subscribe to and render [Media over QUIC](https://moq.dev/) (MoQ) broadcasts, built on top of [@moq/hang](../hang) and [@moq/net](../lite).
+
+## Installation
+
+```bash
+bun add @moq/watch
+# or
+npm add @moq/watch
+```
+
+### No-build CDN usage
+
+For quick demos or embeds where a bundler is overkill, esm.sh serves the
+published npm package as a browser-ready ESM module. Bare imports like
+`@moq/hang` are automatically rewritten to other esm.sh URLs. No build step or
+import map required:
+
+```html
+<script type="module">
+    import "https://esm.sh/@moq/watch/element";
+    import "https://esm.sh/@moq/watch/ui";
+</script>
+
+<moq-watch-ui>
+    <moq-watch url="https://relay.example.com/anon" name="room/alice.hang">
+        <canvas></canvas>
+    </moq-watch>
+</moq-watch-ui>
+```
+
+Pin a version range in the URL for production, e.g.
+`https://esm.sh/@moq/watch@0.2/element`. jsDelivr's `+esm` endpoint
+(`https://cdn.jsdelivr.net/npm/@moq/watch/element.js/+esm`) works the same way
+if you prefer it.
+
+For anything beyond embedding on a static page you should install the
+package and use a real bundler (the examples below).
+
+## Web Component
+
+The simplest way to watch a stream:
+
+```html
+<script type="module">
+    import "@moq/watch/element";
+</script>
+
+<moq-watch
+    url="https://relay.example.com/anon"
+    name="room/alice.hang"
+    controls>
+    <canvas></canvas>
+</moq-watch>
+```
+
+### Attributes
+
+| Attribute | Type                                | Default  | Description                              |
+|-----------|-------------------------------------|----------|------------------------------------------|
+| `url`     | string                              | required | Relay server URL                         |
+| `name`    | string                              | required | Broadcast name/path                      |
+| `paused`  | boolean                             | false    | Pause playback                           |
+| `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. |
+
+The `visible` attribute controls when the video track is downloaded, based on the canvas
+position relative to the viewport:
+
+- `never`: never download video.
+- a distance (`0px`, `200px`, `100%`, ...): download while the canvas is within that distance
+  of the viewport **and** the tab is visible. `0px` means strictly on screen; a larger distance
+  (`20%`, the default) pre-warms the video before it scrolls into view.
+- `always`: always download video, regardless of the canvas position or tab visibility.
+
+Only the distance mode suspends video while the tab is hidden; `always` keeps downloading.
+
+## JavaScript API
+
+For more control:
+
+```typescript
+import * as Watch from "@moq/watch";
+
+const watch = new Watch.Broadcast(connection, {
+    enabled: true,
+    name: "alice.hang",
+    video: { enabled: true },
+    audio: { enabled: true },
+});
+
+// Access the video stream
+watch.video.media.subscribe((stream) => {
+    if (stream) {
+        videoElement.srcObject = stream;
+    }
+});
+```
+
+## UI Web Component
+
+`@moq/watch` includes a Web Component UI overlay (`<moq-watch-ui>`) with playback controls, volume, buffering indicator, unsupported-codec indicator, quality selector, and stats panel. It is built on top of `@moq/signals` with no framework dependency.
+
+```html
+<script type="module">
+    import "@moq/watch/element";
+    import "@moq/watch/ui";
+</script>
+
+<moq-watch-ui>
+    <moq-watch url="https://relay.example.com/anon" name="room/alice.hang">
+        <canvas></canvas>
+    </moq-watch>
+</moq-watch-ui>
+```
+
+The `<moq-watch-ui>` element automatically discovers the nested `<moq-watch>` element and wires up reactive controls.
+
+## 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
+- **Quality selection** — Switch between available renditions
+
+## License
+
+Licensed under either:
+
+- Apache License, Version 2.0 ([LICENSE-APACHE](../../LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)
+- MIT license ([LICENSE-MIT](../../LICENSE-MIT) or http://opensource.org/licenses/MIT)

package/audio/backend.d.ts

@@ -0,0 +1,26 @@
+import type { Getter, Signal } from "@norskvideo/moq-signals";
+import type { BufferedRanges } from "../buffered";
+import type { Source } from "./source";
+/** Audio-specific signals that work regardless of the backend source (MSE vs WebCodecs). */
+export interface Backend {
+    /** The source of the audio. */
+    source: Source;
+    /** The volume of the audio, between 0 and 1. */
+    volume: Signal<number>;
+    /** Whether the audio is muted. */
+    muted: Signal<boolean>;
+    /** The stats of the audio. */
+    stats: Getter<Stats | undefined>;
+    /** Buffered time ranges for the MSE backend. */
+    buffered: Getter<BufferedRanges>;
+    /** The AudioContext used for WebCodecs playback. */
+    context: Getter<AudioContext | undefined>;
+}
+/** Audio playback statistics. */
+export interface Stats {
+    /** Number of samples decoded. */
+    sampleCount: number;
+    /** Number of encoded bytes received. */
+    bytesReceived: number;
+}
+//# sourceMappingURL=backend.d.ts.map

package/audio/backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../src/audio/backend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC,4FAA4F;AAC5F,MAAM,WAAW,OAAO;IACvB,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IAEf,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAEvB,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAEvB,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC;IAEjC,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC;IAEjC,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC;CAC1C;AAED,iCAAiC;AACjC,MAAM,WAAW,KAAK;IACrB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,aAAa,EAAE,MAAM,CAAC;CACtB"}

package/audio/buffer.d.ts

@@ -0,0 +1,42 @@
+import { Time } from "@norskvideo/moq-net";
+import { type Getter } from "@norskvideo/moq-signals";
+/**
+ * Unified interface for the audio buffer between the main thread and the AudioWorklet.
+ *
+ * Two implementations exist:
+ *   - `SharedAudioBuffer`: backed by SharedArrayBuffer, lock-free writes via Atomics.
+ *   - `PostAudioBuffer`: backed by postMessage transfer (the fallback when SAB is unavailable).
+ *
+ * Use `createAudioBuffer()` to pick the right implementation automatically.
+ */
+export interface AudioBuffer {
+    readonly rate: number;
+    readonly channels: number;
+    /** Insert audio samples at the given timestamp. Handles out-of-order writes. */
+    insert(timestamp: Time.Micro, data: Float32Array[]): void;
+    /** Update the target latency in samples. */
+    setLatency(samples: number): void;
+    /** Flush buffered samples and re-stall, ready to anchor the next utterance (buffered mode). */
+    reset(): 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
+     * floor ahead of the playhead, so the caller holds the (encoded) frame instead of decoding it too
+     * far ahead of the floor-sized ring. Resolves immediately when not buffered (the ring bounds itself).
+     */
+    wait(timestamp: Time.Micro): Promise<void>;
+    /** Current playback timestamp (derived from reader position). */
+    readonly timestamp: Getter<Time.Micro>;
+    /** Whether the buffer is stalled (waiting to fill). */
+    readonly stalled: Getter<boolean>;
+    /** Release any resources (event listeners, intervals, etc.). */
+    close(): void;
+}
+/** Returns true when SharedArrayBuffer is available and usable in the current context. */
+export declare function supportsSharedArrayBuffer(): boolean;
+/**
+ * Create the best audio buffer implementation for the current environment.
+ * Picks `SharedAudioBuffer` when possible, falling back to `PostAudioBuffer`.
+ */
+export declare function createAudioBuffer(worklet: AudioWorkletNode, channels: number, rate: number, latencySamples: number, buffered?: boolean): AudioBuffer;
+//# sourceMappingURL=buffer.d.ts.map

package/audio/buffer.d.ts.map

@@ -0,0 +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"}

package/audio/decoder.d.ts

@@ -0,0 +1,32 @@
+import { Time } from "@norskvideo/moq-net";
+import { type Getter, Signal } from "@norskvideo/moq-signals";
+import type { BufferedRanges } from "../buffered";
+import type { Source } from "./source";
+export type DecoderProps = {
+    enabled?: boolean | Signal<boolean>;
+};
+export interface AudioStats {
+    /** Number of encoded bytes received. */
+    bytesReceived: number;
+}
+/**
+ * Downloads audio from a track and emits it to an AudioContext.
+ *
+ * The user is responsible for hooking up audio to speakers, an analyzer, etc.
+ */
+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);
+    reset(): void;
+    close(): void;
+}
+//# sourceMappingURL=decoder.d.ts.map

package/audio/decoder.d.ts.map

@@ -0,0 +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"}

package/audio/emitter.d.ts

@@ -0,0 +1,17 @@
+import { 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 declare class Emitter {
+    #private;
+    source: Decoder;
+    volume: Signal<number>;
+    muted: Signal<boolean>;
+    paused: Signal<boolean>;
+    constructor(source: Decoder, props?: EmitterProps);
+    close(): void;
+}
+//# sourceMappingURL=emitter.d.ts.map

package/audio/emitter.d.ts.map

@@ -0,0 +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,EA+DhD;IAED,KAAK,SAEJ;CACD"}

package/audio/index.d.ts

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

@@ -0,0 +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"}

package/audio/mse.d.ts

@@ -0,0 +1,22 @@
+import { type Getter, Signal } from "@norskvideo/moq-signals";
+import { type BufferedRanges } from "../buffered";
+import type { Muxer } from "../mse";
+import type { Backend, Stats } from "./backend";
+import type { Source } from "./source";
+export type MseProps = {
+    volume?: number | Signal<number>;
+    muted?: boolean | Signal<boolean>;
+};
+export declare class Mse implements Backend {
+    #private;
+    muxer: Muxer;
+    source: Source;
+    volume: Signal<number>;
+    muted: Signal<boolean>;
+    readonly stats: Getter<Stats | undefined>;
+    readonly buffered: Getter<BufferedRanges>;
+    readonly context: Getter<AudioContext | undefined>;
+    constructor(muxer: Muxer, source: Source, props?: MseProps);
+    close(): void;
+}
+//# sourceMappingURL=mse.d.ts.map

package/audio/mse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mse.d.ts","sourceRoot":"","sources":["../../src/audio/mse.ts"],"names":[],"mappings":"AAGA,OAAO,EAAU,KAAK,MAAM,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3D,OAAO,EAAE,KAAK,cAAc,EAAqB,MAAM,aAAa,CAAC;AACrE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC,MAAM,MAAM,QAAQ,GAAG;IACtB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;CAClC,CAAC;AAEF,qBAAa,GAAI,YAAW,OAAO;;IAClC,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IAEf,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAGvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,GAAG,SAAS,CAAC,CAAe;IAGxD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,cAAc,CAAC,CAAkB;IAG3D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,YAAY,GAAG,SAAS,CAAC,CAAmD;IAIrG,YAAY,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,QAAQ,EAUzD;IA8LD,KAAK,IAAI,IAAI,CAEZ;CACD"}

package/audio/render-worklet.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=render-worklet.d.ts.map

package/audio/render-worklet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-worklet.d.ts","sourceRoot":"","sources":["../../src/audio/render-worklet.ts"],"names":[],"mappings":""}

package/audio/render.d.ts

@@ -0,0 +1,38 @@
+import type { Time } from "@norskvideo/moq-net";
+import type { SharedRingBufferInit } from "./shared-ring-buffer";
+export type Message = InitShared | InitPost | Data | Latency | Reset;
+export type ToMain = State;
+/** Init message when SharedArrayBuffer is available. */
+export interface InitShared extends SharedRingBufferInit {
+    type: "init-shared";
+}
+/** Init message for the postMessage fallback path. */
+export interface InitPost {
+    type: "init-post";
+    channels: number;
+    rate: number;
+    latency: Time.Milli;
+    buffered: boolean;
+}
+/** Flush the buffer and re-stall (fallback path only; shared path resets via Atomics). */
+export interface Reset {
+    type: "reset";
+}
+/** Audio samples sent via postMessage (fallback path only). */
+export interface Data {
+    type: "data";
+    data: Float32Array[];
+    timestamp: Time.Micro;
+}
+/** Latency update sent via postMessage (fallback path only). */
+export interface Latency {
+    type: "latency";
+    latency: Time.Milli;
+}
+/** State update from the worklet back to main thread (fallback path only). */
+export interface State {
+    type: "state";
+    timestamp: Time.Micro;
+    stalled: boolean;
+}
+//# sourceMappingURL=render.d.ts.map

package/audio/render.d.ts.map

@@ -0,0 +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"}

package/audio/ring-buffer.d.ts

@@ -0,0 +1,21 @@
+import { Time } from "@norskvideo/moq-net";
+export declare class AudioRingBuffer {
+    #private;
+    readonly rate: number;
+    readonly channels: number;
+    constructor(props: {
+        rate: number;
+        channels: number;
+        latency: Time.Milli;
+        buffered?: boolean;
+    });
+    get stalled(): boolean;
+    get timestamp(): Time.Micro;
+    get length(): number;
+    get capacity(): number;
+    resize(latency: Time.Milli): void;
+    write(timestamp: Time.Micro, data: Float32Array[]): void;
+    reset(): void;
+    read(output: Float32Array[]): number;
+}
+//# sourceMappingURL=ring-buffer.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ring-buffer.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ring-buffer.test.d.ts","sourceRoot":"","sources":["../../src/audio/ring-buffer.test.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,62 @@
+import { Time } from "@norskvideo/moq-net";
+export interface SharedRingBufferInit {
+    channels: number;
+    capacity: number;
+    rate: number;
+    samples: SharedArrayBuffer;
+    control: SharedArrayBuffer;
+    buffered: boolean;
+}
+export declare function allocSharedRingBuffer(channels: number, capacity: number, rate: number, buffered?: boolean): SharedRingBufferInit;
+export declare class SharedRingBuffer {
+    #private;
+    readonly channels: number;
+    readonly capacity: number;
+    readonly rate: number;
+    readonly buffered: boolean;
+    readonly init: SharedRingBufferInit;
+    constructor(init: SharedRingBufferInit);
+    /**
+     * Insert audio samples at the given timestamp.
+     * Main thread only. Handles out-of-order writes, gap filling, and overflow.
+     */
+    insert(timestamp: Time.Micro, data: Float32Array[]): void;
+    /**
+     * Read audio samples into the output buffers.
+     * AudioWorklet only. Returns the number of samples read.
+     */
+    read(output: Float32Array[]): number;
+    /** Update the target latency in samples. */
+    setLatency(samples: number): 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.
+     */
+    reset(): void;
+    /**
+     * Allocate a new ring with `newCapacity` samples and copy the unread window
+     * [READ, WRITE) plus control state into it. Used when growing capacity so
+     * we don't drop buffered audio. If `newCapacity` is smaller than the unread
+     * span, the oldest samples are truncated.
+     *
+     * Main thread only. `resize()` reads from the source `SharedRingBuffer` and
+     * writes into a freshly allocated buffer from `allocSharedRingBuffer`, so it
+     * relies on the same invariant as `insert()`: no concurrent main-thread
+     * writers. The AudioWorklet reader is tolerated via the CAS discipline used
+     * by READ/WRITE elsewhere.
+     */
+    resize(newCapacity: number): SharedRingBuffer;
+    /** Current playback timestamp derived from READ position. */
+    get timestamp(): Time.Micro;
+    /** Whether the buffer is stalled (waiting to fill). */
+    get stalled(): boolean;
+    /**
+     * Number of buffered samples (WRITE - READ).
+     *
+     * Non-atomic: WRITE and READ are loaded separately, so a concurrent
+     * writer/reader can make the two loads inconsistent. Intended for
+     * tests and diagnostics, not control-flow decisions.
+     */
+    get length(): number;
+}
+//# sourceMappingURL=shared-ring-buffer.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=shared-ring-buffer.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shared-ring-buffer.test.d.ts","sourceRoot":"","sources":["../../src/audio/shared-ring-buffer.test.ts"],"names":[],"mappings":""}

package/audio/source.d.ts

@@ -0,0 +1,34 @@
+import type * as Catalog from "@norskvideo/moq-hang/catalog";
+import { type Getter, 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.
+ */
+export type Supported = (config: Catalog.AudioConfig) => Promise<boolean>;
+export type SourceProps = {
+    broadcast?: Broadcast | Signal<Broadcast | undefined>;
+    target?: Target | Signal<Target | undefined>;
+    supported?: Supported;
+};
+/**
+ * Source handles catalog extraction, support checking, and rendition selection
+ * for audio playback. It is used by both MSE and Decoder backends.
+ */
+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);
+    close(): void;
+}
+//# sourceMappingURL=source.d.ts.map

package/audio/source.d.ts.map

@@ -0,0 +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"}

package/backend.d.ts

@@ -0,0 +1,65 @@
+import * as Moq from "@norskvideo/moq-net";
+import { Effect, Signal } from "@norskvideo/moq-signals";
+import * as Audio from "./audio";
+import type { Broadcast } from "./broadcast";
+import type { BufferedRanges } from "./buffered";
+import { type Latency, Sync } from "./sync";
+import * as Video from "./video";
+export interface Backend {
+    paused: Signal<boolean>;
+    video?: Video.Backend;
+    audio?: Audio.Backend;
+    latency: Signal<Latency>;
+    jitter: Signal<Moq.Time.Milli>;
+    buffered: Signal<boolean>;
+    reset(): void;
+}
+export interface MultiBackendProps {
+    element?: HTMLCanvasElement | HTMLVideoElement | Signal<HTMLCanvasElement | HTMLVideoElement | undefined>;
+    broadcast?: Broadcast | Signal<Broadcast | undefined>;
+    latency?: Latency | Signal<Latency>;
+    connection?: Signal<Moq.Connection.Established | undefined>;
+    paused?: boolean | Signal<boolean>;
+    visible?: Video.Visible | Signal<Video.Visible>;
+}
+declare class VideoBackend implements Video.Backend {
+    source: Video.Source;
+    stats: Signal<Video.Stats | undefined>;
+    stalled: Signal<boolean>;
+    buffered: Signal<BufferedRanges>;
+    timestamp: Signal<Moq.Time.Milli>;
+    constructor(source: Video.Source);
+}
+declare class AudioBackend implements Audio.Backend {
+    source: Audio.Source;
+    volume: Signal<number>;
+    muted: Signal<boolean>;
+    stats: Signal<Audio.Stats | undefined>;
+    buffered: Signal<BufferedRanges>;
+    context: Signal<AudioContext | undefined>;
+    constructor(source: Audio.Source);
+}
+/**
+ * A generic backend that supports either MSE or WebCodecs based on the provided element.
+ *
+ * This primarily backs the `<moq-watch>` web component, but is useful standalone.
+ */
+export declare class MultiBackend implements Backend {
+    #private;
+    element: Signal<HTMLCanvasElement | HTMLVideoElement | undefined>;
+    broadcast: Signal<Broadcast | undefined>;
+    latency: Signal<Latency>;
+    jitter: Signal<Moq.Time.Milli>;
+    buffered: Signal<boolean>;
+    paused: Signal<boolean>;
+    visible: Signal<Video.Visible>;
+    video: VideoBackend;
+    audio: AudioBackend;
+    sync: Sync;
+    signals: Effect;
+    constructor(props?: MultiBackendProps);
+    reset(): void;
+    close(): void;
+}
+export {};
+//# sourceMappingURL=backend.d.ts.map

package/backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../src/backend.ts"],"names":[],"mappings":"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"}

package/base64.d.ts

@@ -0,0 +1,3 @@
+/** Decode a base64 string into bytes. Throws on invalid input. */
+export declare function base64ToBytes(b64: string): Uint8Array;
+//# sourceMappingURL=base64.d.ts.map

package/base64.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.d.ts","sourceRoot":"","sources":["../src/base64.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAKrD"}