@blockcast/mmt-render 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (75) hide show
  1. package/README.md +207 -0
  2. package/dist/audio/audio-buffer-plan.d.ts +27 -0
  3. package/dist/audio/audio-buffer-plan.d.ts.map +1 -0
  4. package/dist/audio/audio-render-pipeline.d.ts +83 -0
  5. package/dist/audio/audio-render-pipeline.d.ts.map +1 -0
  6. package/dist/audio/audio-render-pipeline.js +372 -0
  7. package/dist/audio/audio-render-pipeline.js.map +7 -0
  8. package/dist/audio/audio-ring-buffer.d.ts +55 -0
  9. package/dist/audio/audio-ring-buffer.d.ts.map +1 -0
  10. package/dist/audio/audio-ring-buffer.js +255 -0
  11. package/dist/audio/audio-ring-buffer.js.map +7 -0
  12. package/dist/audio/index.d.ts +9 -0
  13. package/dist/audio/index.d.ts.map +1 -0
  14. package/dist/audio/index.js +640 -0
  15. package/dist/audio/index.js.map +7 -0
  16. package/dist/audio/render-messages.d.ts +94 -0
  17. package/dist/audio/render-messages.d.ts.map +1 -0
  18. package/dist/audio/render-messages.js +1 -0
  19. package/dist/audio/render-messages.js.map +7 -0
  20. package/dist/audio/render-worklet.d.ts +13 -0
  21. package/dist/audio/render-worklet.d.ts.map +1 -0
  22. package/dist/audio/worklet-url.d.ts +25 -0
  23. package/dist/audio/worklet-url.d.ts.map +1 -0
  24. package/dist/audio/worklet-url.js +11 -0
  25. package/dist/audio/worklet-url.js.map +7 -0
  26. package/dist/index.d.ts +13 -0
  27. package/dist/index.d.ts.map +1 -0
  28. package/dist/index.js +5 -0
  29. package/dist/index.js.map +7 -0
  30. package/dist/pacing/au-duration.d.ts +18 -0
  31. package/dist/pacing/au-duration.d.ts.map +1 -0
  32. package/dist/pacing/au-duration.js +23 -0
  33. package/dist/pacing/au-duration.js.map +7 -0
  34. package/dist/pacing/frame-pacer.d.ts +71 -0
  35. package/dist/pacing/frame-pacer.d.ts.map +1 -0
  36. package/dist/pacing/frame-pacer.js +89 -0
  37. package/dist/pacing/frame-pacer.js.map +7 -0
  38. package/dist/pacing/index.d.ts +6 -0
  39. package/dist/pacing/index.d.ts.map +1 -0
  40. package/dist/pacing/index.js +166 -0
  41. package/dist/pacing/index.js.map +7 -0
  42. package/dist/pacing/interleave-timing.d.ts +64 -0
  43. package/dist/pacing/interleave-timing.d.ts.map +1 -0
  44. package/dist/pacing/interleave-timing.js +58 -0
  45. package/dist/pacing/interleave-timing.js.map +7 -0
  46. package/dist/video/index.d.ts +4 -0
  47. package/dist/video/index.d.ts.map +1 -0
  48. package/dist/video/index.js +247 -0
  49. package/dist/video/index.js.map +7 -0
  50. package/dist/video/keyframe-gate.d.ts +21 -0
  51. package/dist/video/keyframe-gate.d.ts.map +1 -0
  52. package/dist/video/keyframe-gate.js +39 -0
  53. package/dist/video/keyframe-gate.js.map +7 -0
  54. package/dist/video/video-render-pipeline.d.ts +60 -0
  55. package/dist/video/video-render-pipeline.d.ts.map +1 -0
  56. package/dist/video/video-render-pipeline.js +247 -0
  57. package/dist/video/video-render-pipeline.js.map +7 -0
  58. package/dist/worklet/render-worklet.js +403 -0
  59. package/dist/worklet/render-worklet.js.map +7 -0
  60. package/package.json +101 -0
  61. package/src/audio/audio-buffer-plan.ts +62 -0
  62. package/src/audio/audio-render-pipeline.ts +313 -0
  63. package/src/audio/audio-ring-buffer.ts +281 -0
  64. package/src/audio/index.ts +14 -0
  65. package/src/audio/render-messages.ts +110 -0
  66. package/src/audio/render-worklet.ts +161 -0
  67. package/src/audio/worklet-url.ts +30 -0
  68. package/src/index.ts +13 -0
  69. package/src/pacing/au-duration.ts +34 -0
  70. package/src/pacing/frame-pacer.ts +129 -0
  71. package/src/pacing/index.ts +5 -0
  72. package/src/pacing/interleave-timing.ts +95 -0
  73. package/src/video/index.ts +7 -0
  74. package/src/video/keyframe-gate.ts +35 -0
  75. package/src/video/video-render-pipeline.ts +179 -0
@@ -0,0 +1,255 @@
1
+ var __typeError = (msg) => {
2
+ throw TypeError(msg);
3
+ };
4
+ var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
5
+ var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
6
+ var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
7
+ var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
8
+ var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "access private method"), method);
9
+ var __privateWrapper = (obj, member, setter, getter) => ({
10
+ set _(value) {
11
+ __privateSet(obj, member, value, setter);
12
+ },
13
+ get _() {
14
+ return __privateGet(obj, member, getter);
15
+ }
16
+ });
17
+
18
+ // src/audio/audio-ring-buffer.ts
19
+ var _buffer, _writeIndex, _readIndex, _stalled, _startupFrames, _resumeFrames, _resumeFollowsStartup, _hasStarted, _capacityHeadroomFrames, _timestampAnchors, _diagEnabled, _diagReads, _diagFillSum, _diagOverflowSamples, _AudioRingBuffer_instances, pruneTimestampAnchors_fn, refillFrames_fn;
20
+ var AudioRingBuffer = class {
21
+ constructor(config) {
22
+ __privateAdd(this, _AudioRingBuffer_instances);
23
+ __privateAdd(this, _buffer);
24
+ __privateAdd(this, _writeIndex, 0);
25
+ __privateAdd(this, _readIndex, 0);
26
+ __privateAdd(this, _stalled);
27
+ __privateAdd(this, _startupFrames);
28
+ __privateAdd(this, _resumeFrames);
29
+ __privateAdd(this, _resumeFollowsStartup);
30
+ __privateAdd(this, _hasStarted);
31
+ __privateAdd(this, _capacityHeadroomFrames);
32
+ __privateAdd(this, _timestampAnchors, []);
33
+ __privateAdd(this, _diagEnabled);
34
+ __privateAdd(this, _diagReads, 0);
35
+ __privateAdd(this, _diagFillSum, 0);
36
+ __privateAdd(this, _diagOverflowSamples, 0);
37
+ if (!Number.isInteger(config.channels) || config.channels <= 0) {
38
+ throw new Error("invalid channels");
39
+ }
40
+ if (!Number.isFinite(config.rate) || config.rate <= 0) {
41
+ throw new Error("invalid sample rate");
42
+ }
43
+ if (!Number.isFinite(config.latencyMs) || config.latencyMs <= 0) {
44
+ throw new Error("invalid latency");
45
+ }
46
+ const latencyFrames = Math.ceil(config.rate * (config.latencyMs / 1e3));
47
+ const startupFrames = config.startupFrames ?? latencyFrames;
48
+ const resumeFrames = config.resumeFrames ?? startupFrames;
49
+ const thresholdFrames = Math.max(startupFrames, resumeFrames);
50
+ const capacityFrames = config.capacityFrames ?? Math.max(latencyFrames, thresholdFrames);
51
+ if (!Number.isSafeInteger(startupFrames) || startupFrames <= 0) {
52
+ throw new Error("invalid startup frames");
53
+ }
54
+ if (!Number.isSafeInteger(resumeFrames) || resumeFrames <= 0) {
55
+ throw new Error("invalid resume frames");
56
+ }
57
+ if (!Number.isSafeInteger(capacityFrames) || capacityFrames < thresholdFrames) {
58
+ throw new Error("invalid capacity frames");
59
+ }
60
+ this.channels = config.channels;
61
+ this.rate = config.rate;
62
+ __privateSet(this, _startupFrames, startupFrames);
63
+ __privateSet(this, _resumeFrames, resumeFrames);
64
+ __privateSet(this, _resumeFollowsStartup, config.resumeFrames === void 0);
65
+ __privateSet(this, _hasStarted, config.startUnstalled ?? false);
66
+ __privateSet(this, _capacityHeadroomFrames, capacityFrames - thresholdFrames);
67
+ __privateSet(this, _stalled, !(config.startUnstalled ?? false));
68
+ __privateSet(this, _diagEnabled, config.diag ?? false);
69
+ __privateSet(this, _buffer, Array.from(
70
+ { length: config.channels },
71
+ () => new Float32Array(capacityFrames)
72
+ ));
73
+ }
74
+ get stalled() {
75
+ return __privateGet(this, _stalled);
76
+ }
77
+ get startupFrames() {
78
+ return __privateGet(this, _startupFrames);
79
+ }
80
+ get capacity() {
81
+ return __privateGet(this, _buffer)[0].length;
82
+ }
83
+ get length() {
84
+ return __privateGet(this, _writeIndex) - __privateGet(this, _readIndex);
85
+ }
86
+ /** Timestamp of the next media sample after the PCM already emitted. */
87
+ get timestampUs() {
88
+ const anchor = __privateGet(this, _timestampAnchors)[0];
89
+ if (!anchor || anchor.sampleIndex > __privateGet(this, _readIndex)) return void 0;
90
+ return anchor.timestampUs + (__privateGet(this, _readIndex) - anchor.sampleIndex) / this.rate * 1e6;
91
+ }
92
+ write(timestampUs, data) {
93
+ if (data.length !== this.channels) throw new Error("wrong channel count");
94
+ if (!Number.isFinite(timestampUs)) throw new Error("invalid timestamp");
95
+ const samples = data[0].length;
96
+ if (samples === 0) return;
97
+ if (data.some((channel) => channel.length !== samples)) {
98
+ throw new Error("mismatched channel lengths");
99
+ }
100
+ const start = __privateGet(this, _writeIndex);
101
+ const end = start + samples;
102
+ __privateGet(this, _timestampAnchors).push({ sampleIndex: start, timestampUs });
103
+ const overflow = end - __privateGet(this, _readIndex) - this.capacity;
104
+ if (overflow > 0) {
105
+ __privateSet(this, _stalled, false);
106
+ __privateSet(this, _hasStarted, true);
107
+ __privateSet(this, _readIndex, __privateGet(this, _readIndex) + overflow);
108
+ if (__privateGet(this, _diagEnabled)) __privateSet(this, _diagOverflowSamples, __privateGet(this, _diagOverflowSamples) + overflow);
109
+ __privateMethod(this, _AudioRingBuffer_instances, pruneTimestampAnchors_fn).call(this);
110
+ }
111
+ const refillFrames = __privateGet(this, _hasStarted) ? __privateGet(this, _resumeFrames) : __privateGet(this, _startupFrames);
112
+ if (__privateGet(this, _stalled) && end - __privateGet(this, _readIndex) >= refillFrames) {
113
+ __privateSet(this, _stalled, false);
114
+ __privateSet(this, _hasStarted, true);
115
+ }
116
+ for (let channel = 0; channel < this.channels; channel++) {
117
+ const src = data[channel];
118
+ const dst = __privateGet(this, _buffer)[channel];
119
+ for (let i = 0; i < samples; i++) {
120
+ dst[(start + i) % dst.length] = src[i];
121
+ }
122
+ }
123
+ __privateSet(this, _writeIndex, end);
124
+ }
125
+ read(output) {
126
+ if (output.length !== this.channels) throw new Error("wrong channel count");
127
+ if (__privateGet(this, _stalled)) return 0;
128
+ const available = this.length;
129
+ if (available === 0) {
130
+ __privateSet(this, _stalled, true);
131
+ return 0;
132
+ }
133
+ const requested = output[0].length;
134
+ const readSamples = Math.min(available, requested);
135
+ for (let channel = 0; channel < this.channels; channel++) {
136
+ const dst = output[channel];
137
+ const src = __privateGet(this, _buffer)[channel];
138
+ for (let i = 0; i < readSamples; i++) {
139
+ dst[i] = src[(__privateGet(this, _readIndex) + i) % src.length];
140
+ }
141
+ for (let i = readSamples; i < requested; i++) dst[i] = 0;
142
+ }
143
+ __privateSet(this, _readIndex, __privateGet(this, _readIndex) + readSamples);
144
+ __privateMethod(this, _AudioRingBuffer_instances, pruneTimestampAnchors_fn).call(this);
145
+ if (readSamples < requested) __privateSet(this, _stalled, true);
146
+ if (__privateGet(this, _diagEnabled)) {
147
+ __privateWrapper(this, _diagReads)._++;
148
+ __privateSet(this, _diagFillSum, __privateGet(this, _diagFillSum) + available);
149
+ }
150
+ return readSamples;
151
+ }
152
+ /** Clear queued PCM; optionally treat the next fill as post-start recovery. */
153
+ reset(startUnstalled = false, resumeAfterReset = false) {
154
+ __privateSet(this, _writeIndex, 0);
155
+ __privateSet(this, _readIndex, 0);
156
+ __privateSet(this, _stalled, !startUnstalled);
157
+ __privateSet(this, _hasStarted, startUnstalled || resumeAfterReset);
158
+ __privateSet(this, _timestampAnchors, []);
159
+ __privateSet(this, _diagReads, 0);
160
+ __privateSet(this, _diagFillSum, 0);
161
+ __privateSet(this, _diagOverflowSamples, 0);
162
+ }
163
+ /**
164
+ * Change the startup latency while preserving the configured storage
165
+ * headroom above its buffering thresholds. Active playout keeps draining
166
+ * retained PCM; a stalled buffer waits for its startup or resume threshold.
167
+ */
168
+ resize(latencyMs) {
169
+ if (!Number.isFinite(latencyMs) || latencyMs <= 0) {
170
+ throw new Error("invalid latency");
171
+ }
172
+ const newStartupFrames = Math.ceil(this.rate * (latencyMs / 1e3));
173
+ if (!Number.isSafeInteger(newStartupFrames) || newStartupFrames <= 0) {
174
+ throw new Error("invalid latency");
175
+ }
176
+ const newResumeFrames = __privateGet(this, _resumeFollowsStartup) ? newStartupFrames : __privateGet(this, _resumeFrames);
177
+ const newCapacity = Math.max(newStartupFrames, newResumeFrames) + __privateGet(this, _capacityHeadroomFrames);
178
+ if (!Number.isSafeInteger(newCapacity) || newCapacity < Math.max(newStartupFrames, newResumeFrames)) {
179
+ throw new Error("invalid capacity frames");
180
+ }
181
+ const wasStalled = __privateGet(this, _stalled);
182
+ __privateSet(this, _startupFrames, newStartupFrames);
183
+ __privateSet(this, _resumeFrames, newResumeFrames);
184
+ if (newCapacity === this.capacity) {
185
+ if (wasStalled && this.length >= __privateMethod(this, _AudioRingBuffer_instances, refillFrames_fn).call(this)) {
186
+ __privateSet(this, _stalled, false);
187
+ __privateSet(this, _hasStarted, true);
188
+ }
189
+ return;
190
+ }
191
+ const next = Array.from(
192
+ { length: this.channels },
193
+ () => new Float32Array(newCapacity)
194
+ );
195
+ const samplesToKeep = Math.min(this.length, newCapacity);
196
+ const copyStart = __privateGet(this, _writeIndex) - samplesToKeep;
197
+ for (let channel = 0; channel < this.channels; channel++) {
198
+ const src = __privateGet(this, _buffer)[channel];
199
+ const dst = next[channel];
200
+ for (let i = 0; i < samplesToKeep; i++) {
201
+ const sampleIndex = copyStart + i;
202
+ dst[sampleIndex % dst.length] = src[sampleIndex % src.length];
203
+ }
204
+ }
205
+ __privateSet(this, _buffer, next);
206
+ __privateSet(this, _readIndex, copyStart);
207
+ __privateMethod(this, _AudioRingBuffer_instances, pruneTimestampAnchors_fn).call(this);
208
+ __privateSet(this, _stalled, samplesToKeep === 0 || wasStalled && samplesToKeep < __privateMethod(this, _AudioRingBuffer_instances, refillFrames_fn).call(this));
209
+ if (!__privateGet(this, _stalled)) __privateSet(this, _hasStarted, true);
210
+ }
211
+ getDiagAndReset() {
212
+ if (!__privateGet(this, _diagEnabled) || __privateGet(this, _diagReads) === 0) return null;
213
+ const result = {
214
+ reads: __privateGet(this, _diagReads),
215
+ avgFill: Math.round(__privateGet(this, _diagFillSum) / __privateGet(this, _diagReads)),
216
+ capacity: this.capacity,
217
+ skips: 0,
218
+ dups: 0,
219
+ overflowSamples: __privateGet(this, _diagOverflowSamples)
220
+ };
221
+ __privateSet(this, _diagReads, 0);
222
+ __privateSet(this, _diagFillSum, 0);
223
+ __privateSet(this, _diagOverflowSamples, 0);
224
+ return result;
225
+ }
226
+ };
227
+ _buffer = new WeakMap();
228
+ _writeIndex = new WeakMap();
229
+ _readIndex = new WeakMap();
230
+ _stalled = new WeakMap();
231
+ _startupFrames = new WeakMap();
232
+ _resumeFrames = new WeakMap();
233
+ _resumeFollowsStartup = new WeakMap();
234
+ _hasStarted = new WeakMap();
235
+ _capacityHeadroomFrames = new WeakMap();
236
+ _timestampAnchors = new WeakMap();
237
+ _diagEnabled = new WeakMap();
238
+ _diagReads = new WeakMap();
239
+ _diagFillSum = new WeakMap();
240
+ _diagOverflowSamples = new WeakMap();
241
+ _AudioRingBuffer_instances = new WeakSet();
242
+ pruneTimestampAnchors_fn = function() {
243
+ let keep = 0;
244
+ while (keep + 1 < __privateGet(this, _timestampAnchors).length && __privateGet(this, _timestampAnchors)[keep + 1].sampleIndex <= __privateGet(this, _readIndex)) {
245
+ keep++;
246
+ }
247
+ if (keep > 0) __privateGet(this, _timestampAnchors).splice(0, keep);
248
+ };
249
+ refillFrames_fn = function() {
250
+ return __privateGet(this, _hasStarted) ? __privateGet(this, _resumeFrames) : __privateGet(this, _startupFrames);
251
+ };
252
+ export {
253
+ AudioRingBuffer
254
+ };
255
+ //# sourceMappingURL=audio-ring-buffer.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../src/audio/audio-ring-buffer.ts"],
4
+ "sourcesContent": ["/**\n * Timestamp-anchored FIFO shared by MMT AudioWorklet consumers.\n *\n * PCM remains in decoder emission order. Media timestamps are exact anchors\n * for playout reporting only; they never reposition samples or trigger a\n * guessed discontinuity. The FIFO starts after its full catalog-derived\n * latency is buffered and performs no sample skip/dup clock recovery.\n */\n\nexport interface AudioRingBufferConfig {\n channels: number\n rate: number\n latencyMs: number\n /** Exact PCM startup threshold. Overrides latencyMs when provided. */\n startupFrames?: number\n /** PCM refill threshold after the first underrun. Defaults to startupFrames. */\n resumeFrames?: number\n /** Exact PCM storage ceiling. Must cover the startup and resume thresholds. */\n capacityFrames?: number\n startUnstalled?: boolean\n /** Deprecated compatibility input. Clock recovery is not performed. */\n warmupReads?: number\n diag?: boolean\n}\n\nexport interface AudioRingBufferDiag {\n reads: number\n avgFill: number\n capacity: number\n skips: number\n dups: number\n overflowSamples: number\n}\n\ntype TimestampAnchor = {\n sampleIndex: number\n timestampUs: number\n}\n\nexport class AudioRingBuffer {\n readonly channels: number\n readonly rate: number\n\n #buffer: Float32Array[]\n #writeIndex = 0\n #readIndex = 0\n #stalled: boolean\n #startupFrames: number\n #resumeFrames: number\n #resumeFollowsStartup: boolean\n #hasStarted: boolean\n #capacityHeadroomFrames: number\n #timestampAnchors: TimestampAnchor[] = []\n\n #diagEnabled: boolean\n #diagReads = 0\n #diagFillSum = 0\n #diagOverflowSamples = 0\n\n constructor(config: AudioRingBufferConfig) {\n if (!Number.isInteger(config.channels) || config.channels <= 0) {\n throw new Error('invalid channels')\n }\n if (!Number.isFinite(config.rate) || config.rate <= 0) {\n throw new Error('invalid sample rate')\n }\n if (!Number.isFinite(config.latencyMs) || config.latencyMs <= 0) {\n throw new Error('invalid latency')\n }\n\n const latencyFrames = Math.ceil(config.rate * (config.latencyMs / 1000))\n const startupFrames = config.startupFrames ?? latencyFrames\n const resumeFrames = config.resumeFrames ?? startupFrames\n const thresholdFrames = Math.max(startupFrames, resumeFrames)\n const capacityFrames = config.capacityFrames ?? Math.max(latencyFrames, thresholdFrames)\n if (!Number.isSafeInteger(startupFrames) || startupFrames <= 0) {\n throw new Error('invalid startup frames')\n }\n if (!Number.isSafeInteger(resumeFrames) || resumeFrames <= 0) {\n throw new Error('invalid resume frames')\n }\n if (!Number.isSafeInteger(capacityFrames) || capacityFrames < thresholdFrames) {\n throw new Error('invalid capacity frames')\n }\n\n this.channels = config.channels\n this.rate = config.rate\n this.#startupFrames = startupFrames\n this.#resumeFrames = resumeFrames\n this.#resumeFollowsStartup = config.resumeFrames === undefined\n this.#hasStarted = config.startUnstalled ?? false\n this.#capacityHeadroomFrames = capacityFrames - thresholdFrames\n this.#stalled = !(config.startUnstalled ?? false)\n this.#diagEnabled = config.diag ?? false\n this.#buffer = Array.from(\n { length: config.channels },\n () => new Float32Array(capacityFrames),\n )\n }\n\n get stalled(): boolean { return this.#stalled }\n get startupFrames(): number { return this.#startupFrames }\n get capacity(): number { return this.#buffer[0].length }\n get length(): number { return this.#writeIndex - this.#readIndex }\n\n /** Timestamp of the next media sample after the PCM already emitted. */\n get timestampUs(): number | undefined {\n const anchor = this.#timestampAnchors[0]\n if (!anchor || anchor.sampleIndex > this.#readIndex) return undefined\n return anchor.timestampUs + ((this.#readIndex - anchor.sampleIndex) / this.rate) * 1_000_000\n }\n\n write(timestampUs: number, data: Float32Array[]): void {\n if (data.length !== this.channels) throw new Error('wrong channel count')\n if (!Number.isFinite(timestampUs)) throw new Error('invalid timestamp')\n const samples = data[0].length\n if (samples === 0) return\n if (data.some((channel) => channel.length !== samples)) {\n throw new Error('mismatched channel lengths')\n }\n\n const start = this.#writeIndex\n const end = start + samples\n this.#timestampAnchors.push({ sampleIndex: start, timestampUs })\n\n const overflow = end - this.#readIndex - this.capacity\n if (overflow > 0) {\n this.#stalled = false\n this.#hasStarted = true\n this.#readIndex += overflow\n if (this.#diagEnabled) this.#diagOverflowSamples += overflow\n this.#pruneTimestampAnchors()\n }\n\n const refillFrames = this.#hasStarted ? this.#resumeFrames : this.#startupFrames\n if (this.#stalled && end - this.#readIndex >= refillFrames) {\n this.#stalled = false\n this.#hasStarted = true\n }\n\n for (let channel = 0; channel < this.channels; channel++) {\n const src = data[channel]\n const dst = this.#buffer[channel]\n for (let i = 0; i < samples; i++) {\n dst[(start + i) % dst.length] = src[i]\n }\n }\n this.#writeIndex = end\n }\n\n read(output: Float32Array[]): number {\n if (output.length !== this.channels) throw new Error('wrong channel count')\n if (this.#stalled) return 0\n\n const available = this.length\n if (available === 0) {\n this.#stalled = true\n return 0\n }\n\n const requested = output[0].length\n const readSamples = Math.min(available, requested)\n\n for (let channel = 0; channel < this.channels; channel++) {\n const dst = output[channel]\n const src = this.#buffer[channel]\n for (let i = 0; i < readSamples; i++) {\n dst[i] = src[(this.#readIndex + i) % src.length]\n }\n for (let i = readSamples; i < requested; i++) dst[i] = 0\n }\n\n this.#readIndex += readSamples\n this.#pruneTimestampAnchors()\n if (readSamples < requested) this.#stalled = true\n\n if (this.#diagEnabled) {\n this.#diagReads++\n this.#diagFillSum += available\n }\n return readSamples\n }\n\n /** Clear queued PCM; optionally treat the next fill as post-start recovery. */\n reset(startUnstalled = false, resumeAfterReset = false): void {\n this.#writeIndex = 0\n this.#readIndex = 0\n this.#stalled = !startUnstalled\n this.#hasStarted = startUnstalled || resumeAfterReset\n this.#timestampAnchors = []\n this.#diagReads = 0\n this.#diagFillSum = 0\n this.#diagOverflowSamples = 0\n }\n\n /**\n * Change the startup latency while preserving the configured storage\n * headroom above its buffering thresholds. Active playout keeps draining\n * retained PCM; a stalled buffer waits for its startup or resume threshold.\n */\n resize(latencyMs: number): void {\n if (!Number.isFinite(latencyMs) || latencyMs <= 0) {\n throw new Error('invalid latency')\n }\n const newStartupFrames = Math.ceil(this.rate * (latencyMs / 1000))\n if (!Number.isSafeInteger(newStartupFrames) || newStartupFrames <= 0) {\n throw new Error('invalid latency')\n }\n const newResumeFrames = this.#resumeFollowsStartup ? newStartupFrames : this.#resumeFrames\n const newCapacity =\n Math.max(newStartupFrames, newResumeFrames) + this.#capacityHeadroomFrames\n if (\n !Number.isSafeInteger(newCapacity) ||\n newCapacity < Math.max(newStartupFrames, newResumeFrames)\n ) {\n throw new Error('invalid capacity frames')\n }\n const wasStalled = this.#stalled\n this.#startupFrames = newStartupFrames\n this.#resumeFrames = newResumeFrames\n if (newCapacity === this.capacity) {\n if (wasStalled && this.length >= this.#refillFrames()) {\n this.#stalled = false\n this.#hasStarted = true\n }\n return\n }\n\n const next = Array.from(\n { length: this.channels },\n () => new Float32Array(newCapacity),\n )\n const samplesToKeep = Math.min(this.length, newCapacity)\n const copyStart = this.#writeIndex - samplesToKeep\n for (let channel = 0; channel < this.channels; channel++) {\n const src = this.#buffer[channel]\n const dst = next[channel]\n for (let i = 0; i < samplesToKeep; i++) {\n const sampleIndex = copyStart + i\n dst[sampleIndex % dst.length] = src[sampleIndex % src.length]\n }\n }\n\n this.#buffer = next\n this.#readIndex = copyStart\n this.#pruneTimestampAnchors()\n this.#stalled = samplesToKeep === 0 || (wasStalled && samplesToKeep < this.#refillFrames())\n if (!this.#stalled) this.#hasStarted = true\n }\n\n getDiagAndReset(): AudioRingBufferDiag | null {\n if (!this.#diagEnabled || this.#diagReads === 0) return null\n const result: AudioRingBufferDiag = {\n reads: this.#diagReads,\n avgFill: Math.round(this.#diagFillSum / this.#diagReads),\n capacity: this.capacity,\n skips: 0,\n dups: 0,\n overflowSamples: this.#diagOverflowSamples,\n }\n this.#diagReads = 0\n this.#diagFillSum = 0\n this.#diagOverflowSamples = 0\n return result\n }\n\n #pruneTimestampAnchors(): void {\n let keep = 0\n while (\n keep + 1 < this.#timestampAnchors.length &&\n this.#timestampAnchors[keep + 1].sampleIndex <= this.#readIndex\n ) {\n keep++\n }\n if (keep > 0) this.#timestampAnchors.splice(0, keep)\n }\n\n #refillFrames(): number {\n return this.#hasStarted ? this.#resumeFrames : this.#startupFrames\n }\n}\n"],
5
+ "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAuCO,IAAM,kBAAN,MAAsB;AAAA,EAoB3B,YAAY,QAA+B;AApBtC;AAIL;AACA,oCAAc;AACd,mCAAa;AACb;AACA;AACA;AACA;AACA;AACA;AACA,0CAAuC,CAAC;AAExC;AACA,mCAAa;AACb,qCAAe;AACf,6CAAuB;AAGrB,QAAI,CAAC,OAAO,UAAU,OAAO,QAAQ,KAAK,OAAO,YAAY,GAAG;AAC9D,YAAM,IAAI,MAAM,kBAAkB;AAAA,IACpC;AACA,QAAI,CAAC,OAAO,SAAS,OAAO,IAAI,KAAK,OAAO,QAAQ,GAAG;AACrD,YAAM,IAAI,MAAM,qBAAqB;AAAA,IACvC;AACA,QAAI,CAAC,OAAO,SAAS,OAAO,SAAS,KAAK,OAAO,aAAa,GAAG;AAC/D,YAAM,IAAI,MAAM,iBAAiB;AAAA,IACnC;AAEA,UAAM,gBAAgB,KAAK,KAAK,OAAO,QAAQ,OAAO,YAAY,IAAK;AACvE,UAAM,gBAAgB,OAAO,iBAAiB;AAC9C,UAAM,eAAe,OAAO,gBAAgB;AAC5C,UAAM,kBAAkB,KAAK,IAAI,eAAe,YAAY;AAC5D,UAAM,iBAAiB,OAAO,kBAAkB,KAAK,IAAI,eAAe,eAAe;AACvF,QAAI,CAAC,OAAO,cAAc,aAAa,KAAK,iBAAiB,GAAG;AAC9D,YAAM,IAAI,MAAM,wBAAwB;AAAA,IAC1C;AACA,QAAI,CAAC,OAAO,cAAc,YAAY,KAAK,gBAAgB,GAAG;AAC5D,YAAM,IAAI,MAAM,uBAAuB;AAAA,IACzC;AACA,QAAI,CAAC,OAAO,cAAc,cAAc,KAAK,iBAAiB,iBAAiB;AAC7E,YAAM,IAAI,MAAM,yBAAyB;AAAA,IAC3C;AAEA,SAAK,WAAW,OAAO;AACvB,SAAK,OAAO,OAAO;AACnB,uBAAK,gBAAiB;AACtB,uBAAK,eAAgB;AACrB,uBAAK,uBAAwB,OAAO,iBAAiB;AACrD,uBAAK,aAAc,OAAO,kBAAkB;AAC5C,uBAAK,yBAA0B,iBAAiB;AAChD,uBAAK,UAAW,EAAE,OAAO,kBAAkB;AAC3C,uBAAK,cAAe,OAAO,QAAQ;AACnC,uBAAK,SAAU,MAAM;AAAA,MACnB,EAAE,QAAQ,OAAO,SAAS;AAAA,MAC1B,MAAM,IAAI,aAAa,cAAc;AAAA,IACvC;AAAA,EACF;AAAA,EAEA,IAAI,UAAmB;AAAE,WAAO,mBAAK;AAAA,EAAS;AAAA,EAC9C,IAAI,gBAAwB;AAAE,WAAO,mBAAK;AAAA,EAAe;AAAA,EACzD,IAAI,WAAmB;AAAE,WAAO,mBAAK,SAAQ,CAAC,EAAE;AAAA,EAAO;AAAA,EACvD,IAAI,SAAiB;AAAE,WAAO,mBAAK,eAAc,mBAAK;AAAA,EAAW;AAAA;AAAA,EAGjE,IAAI,cAAkC;AACpC,UAAM,SAAS,mBAAK,mBAAkB,CAAC;AACvC,QAAI,CAAC,UAAU,OAAO,cAAc,mBAAK,YAAY,QAAO;AAC5D,WAAO,OAAO,eAAgB,mBAAK,cAAa,OAAO,eAAe,KAAK,OAAQ;AAAA,EACrF;AAAA,EAEA,MAAM,aAAqB,MAA4B;AACrD,QAAI,KAAK,WAAW,KAAK,SAAU,OAAM,IAAI,MAAM,qBAAqB;AACxE,QAAI,CAAC,OAAO,SAAS,WAAW,EAAG,OAAM,IAAI,MAAM,mBAAmB;AACtE,UAAM,UAAU,KAAK,CAAC,EAAE;AACxB,QAAI,YAAY,EAAG;AACnB,QAAI,KAAK,KAAK,CAAC,YAAY,QAAQ,WAAW,OAAO,GAAG;AACtD,YAAM,IAAI,MAAM,4BAA4B;AAAA,IAC9C;AAEA,UAAM,QAAQ,mBAAK;AACnB,UAAM,MAAM,QAAQ;AACpB,uBAAK,mBAAkB,KAAK,EAAE,aAAa,OAAO,YAAY,CAAC;AAE/D,UAAM,WAAW,MAAM,mBAAK,cAAa,KAAK;AAC9C,QAAI,WAAW,GAAG;AAChB,yBAAK,UAAW;AAChB,yBAAK,aAAc;AACnB,yBAAK,YAAL,mBAAK,cAAc;AACnB,UAAI,mBAAK,cAAc,oBAAK,sBAAL,mBAAK,wBAAwB;AACpD,4BAAK,sDAAL;AAAA,IACF;AAEA,UAAM,eAAe,mBAAK,eAAc,mBAAK,iBAAgB,mBAAK;AAClE,QAAI,mBAAK,aAAY,MAAM,mBAAK,eAAc,cAAc;AAC1D,yBAAK,UAAW;AAChB,yBAAK,aAAc;AAAA,IACrB;AAEA,aAAS,UAAU,GAAG,UAAU,KAAK,UAAU,WAAW;AACxD,YAAM,MAAM,KAAK,OAAO;AACxB,YAAM,MAAM,mBAAK,SAAQ,OAAO;AAChC,eAAS,IAAI,GAAG,IAAI,SAAS,KAAK;AAChC,aAAK,QAAQ,KAAK,IAAI,MAAM,IAAI,IAAI,CAAC;AAAA,MACvC;AAAA,IACF;AACA,uBAAK,aAAc;AAAA,EACrB;AAAA,EAEA,KAAK,QAAgC;AACnC,QAAI,OAAO,WAAW,KAAK,SAAU,OAAM,IAAI,MAAM,qBAAqB;AAC1E,QAAI,mBAAK,UAAU,QAAO;AAE1B,UAAM,YAAY,KAAK;AACvB,QAAI,cAAc,GAAG;AACnB,yBAAK,UAAW;AAChB,aAAO;AAAA,IACT;AAEA,UAAM,YAAY,OAAO,CAAC,EAAE;AAC5B,UAAM,cAAc,KAAK,IAAI,WAAW,SAAS;AAEjD,aAAS,UAAU,GAAG,UAAU,KAAK,UAAU,WAAW;AACxD,YAAM,MAAM,OAAO,OAAO;AAC1B,YAAM,MAAM,mBAAK,SAAQ,OAAO;AAChC,eAAS,IAAI,GAAG,IAAI,aAAa,KAAK;AACpC,YAAI,CAAC,IAAI,KAAK,mBAAK,cAAa,KAAK,IAAI,MAAM;AAAA,MACjD;AACA,eAAS,IAAI,aAAa,IAAI,WAAW,IAAK,KAAI,CAAC,IAAI;AAAA,IACzD;AAEA,uBAAK,YAAL,mBAAK,cAAc;AACnB,0BAAK,sDAAL;AACA,QAAI,cAAc,UAAW,oBAAK,UAAW;AAE7C,QAAI,mBAAK,eAAc;AACrB,6BAAK,YAAL;AACA,yBAAK,cAAL,mBAAK,gBAAgB;AAAA,IACvB;AACA,WAAO;AAAA,EACT;AAAA;AAAA,EAGA,MAAM,iBAAiB,OAAO,mBAAmB,OAAa;AAC5D,uBAAK,aAAc;AACnB,uBAAK,YAAa;AAClB,uBAAK,UAAW,CAAC;AACjB,uBAAK,aAAc,kBAAkB;AACrC,uBAAK,mBAAoB,CAAC;AAC1B,uBAAK,YAAa;AAClB,uBAAK,cAAe;AACpB,uBAAK,sBAAuB;AAAA,EAC9B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,OAAO,WAAyB;AAC9B,QAAI,CAAC,OAAO,SAAS,SAAS,KAAK,aAAa,GAAG;AACjD,YAAM,IAAI,MAAM,iBAAiB;AAAA,IACnC;AACA,UAAM,mBAAmB,KAAK,KAAK,KAAK,QAAQ,YAAY,IAAK;AACjE,QAAI,CAAC,OAAO,cAAc,gBAAgB,KAAK,oBAAoB,GAAG;AACpE,YAAM,IAAI,MAAM,iBAAiB;AAAA,IACnC;AACA,UAAM,kBAAkB,mBAAK,yBAAwB,mBAAmB,mBAAK;AAC7E,UAAM,cACJ,KAAK,IAAI,kBAAkB,eAAe,IAAI,mBAAK;AACrD,QACE,CAAC,OAAO,cAAc,WAAW,KACjC,cAAc,KAAK,IAAI,kBAAkB,eAAe,GACxD;AACA,YAAM,IAAI,MAAM,yBAAyB;AAAA,IAC3C;AACA,UAAM,aAAa,mBAAK;AACxB,uBAAK,gBAAiB;AACtB,uBAAK,eAAgB;AACrB,QAAI,gBAAgB,KAAK,UAAU;AACjC,UAAI,cAAc,KAAK,UAAU,sBAAK,6CAAL,YAAsB;AACrD,2BAAK,UAAW;AAChB,2BAAK,aAAc;AAAA,MACrB;AACA;AAAA,IACF;AAEA,UAAM,OAAO,MAAM;AAAA,MACjB,EAAE,QAAQ,KAAK,SAAS;AAAA,MACxB,MAAM,IAAI,aAAa,WAAW;AAAA,IACpC;AACA,UAAM,gBAAgB,KAAK,IAAI,KAAK,QAAQ,WAAW;AACvD,UAAM,YAAY,mBAAK,eAAc;AACrC,aAAS,UAAU,GAAG,UAAU,KAAK,UAAU,WAAW;AACxD,YAAM,MAAM,mBAAK,SAAQ,OAAO;AAChC,YAAM,MAAM,KAAK,OAAO;AACxB,eAAS,IAAI,GAAG,IAAI,eAAe,KAAK;AACtC,cAAM,cAAc,YAAY;AAChC,YAAI,cAAc,IAAI,MAAM,IAAI,IAAI,cAAc,IAAI,MAAM;AAAA,MAC9D;AAAA,IACF;AAEA,uBAAK,SAAU;AACf,uBAAK,YAAa;AAClB,0BAAK,sDAAL;AACA,uBAAK,UAAW,kBAAkB,KAAM,cAAc,gBAAgB,sBAAK,6CAAL;AACtE,QAAI,CAAC,mBAAK,UAAU,oBAAK,aAAc;AAAA,EACzC;AAAA,EAEA,kBAA8C;AAC5C,QAAI,CAAC,mBAAK,iBAAgB,mBAAK,gBAAe,EAAG,QAAO;AACxD,UAAM,SAA8B;AAAA,MAClC,OAAO,mBAAK;AAAA,MACZ,SAAS,KAAK,MAAM,mBAAK,gBAAe,mBAAK,WAAU;AAAA,MACvD,UAAU,KAAK;AAAA,MACf,OAAO;AAAA,MACP,MAAM;AAAA,MACN,iBAAiB,mBAAK;AAAA,IACxB;AACA,uBAAK,YAAa;AAClB,uBAAK,cAAe;AACpB,uBAAK,sBAAuB;AAC5B,WAAO;AAAA,EACT;AAgBF;AA7OE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAEA;AACA;AACA;AACA;AAlBK;AAmOL,2BAAsB,WAAS;AAC7B,MAAI,OAAO;AACX,SACE,OAAO,IAAI,mBAAK,mBAAkB,UAClC,mBAAK,mBAAkB,OAAO,CAAC,EAAE,eAAe,mBAAK,aACrD;AACA;AAAA,EACF;AACA,MAAI,OAAO,EAAG,oBAAK,mBAAkB,OAAO,GAAG,IAAI;AACrD;AAEA,kBAAa,WAAW;AACtB,SAAO,mBAAK,eAAc,mBAAK,iBAAgB,mBAAK;AACtD;",
6
+ "names": []
7
+ }
@@ -0,0 +1,9 @@
1
+ export { AudioRingBuffer } from './audio-ring-buffer.js';
2
+ export type { AudioRingBufferConfig, AudioRingBufferDiag } from './audio-ring-buffer.js';
3
+ export { deriveAudioBurstBufferPlan } from './audio-buffer-plan.js';
4
+ export type { AudioBurstBufferPlan, AudioBurstBufferPlanInput } from './audio-buffer-plan.js';
5
+ export { AudioRenderPipeline } from './audio-render-pipeline.js';
6
+ export type { AudioRenderPipelineOpts } from './audio-render-pipeline.js';
7
+ export type { FromMain, ToMain, InitMessage, DataMessage, StartMessage, WriteAckMessage, LatencyMessage, ResetMessage, DiagRequestMessage, StateMessage, DiagMessage, } from './render-messages.js';
8
+ export { WORKLET_PROCESSOR_NAME, workletModuleUrl } from './worklet-url.js';
9
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/audio/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,YAAY,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AACxF,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAA;AACnE,YAAY,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAA;AAC7F,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAChE,YAAY,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAA;AAIzE,YAAY,EACV,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,eAAe,EAAE,cAAc,EACzF,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,WAAW,GAC5D,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA"}