@waveform-playlist/playout 11.1.0 → 11.2.0

package/dist/index.d.mts

@@ -489,6 +489,26 @@ declare class TonePlayout {
  * cross-browser compatibility (fixes Firefox AudioListener issues).
  */
 
+interface AudioContextOptions {
+    /** Desired sample rate. Creates a standardized-audio-context AudioContext
+     *  at this rate, bypassing Tone.js 15.1.22's limitation. Cross-browser safe. */
+    sampleRate?: number;
+    /** Latency hint passed to the AudioContext constructor. */
+    latencyHint?: AudioContextLatencyCategory | number;
+}
+/**
+ * Configure the global AudioContext with sample rate and latency hints.
+ * Creates a standardized-audio-context AudioContext (cross-browser, fixes
+ * Firefox AudioListener bug) and wraps it in Tone.js Context.
+ *
+ * Should be called BEFORE getGlobalContext(). If the context already exists
+ * (e.g., from resumeGlobalAudioContext), warns and returns the existing rate.
+ *
+ * ```ts
+ * configureGlobalContext({ sampleRate: 48000, latencyHint: 0 })
+ * ```
+ */
+declare function configureGlobalContext(options: AudioContextOptions): number;
 /**
  * Get the global Tone.js Context
  * This is the main context for cross-browser audio operations.
@@ -588,4 +608,4 @@ interface ToneAdapterOptions {
 }
 declare function createToneAdapter(options?: ToneAdapterOptions): PlayoutAdapter;
 
-export { type EffectsFunction, type LoopAndEnvelopeParams, type MidiClipInfo, MidiToneTrack, type MidiToneTrackOptions, type PlayableTrack, type PlaybackRateParams, SoundFontCache, type SoundFontSample, SoundFontToneTrack, type SoundFontToneTrackOptions, type ToneAdapterOptions, TonePlayout, type TonePlayoutOptions, ToneTrack, type ToneTrackOptions, type TrackEffectsFunction, calculatePlaybackRate, closeGlobalAudioContext, createToneAdapter, extractLoopAndEnvelope, getGeneratorValue, getGlobalAudioContext, getGlobalAudioContextState, getGlobalContext, getGlobalToneContext, getMediaStreamSource, getUnderlyingAudioParam, hasMediaStreamSource, int16ToFloat32, releaseMediaStreamSource, resumeGlobalAudioContext, timecentsToSeconds };
+export { type AudioContextOptions, type EffectsFunction, type LoopAndEnvelopeParams, type MidiClipInfo, MidiToneTrack, type MidiToneTrackOptions, type PlayableTrack, type PlaybackRateParams, SoundFontCache, type SoundFontSample, SoundFontToneTrack, type SoundFontToneTrackOptions, type ToneAdapterOptions, TonePlayout, type TonePlayoutOptions, ToneTrack, type ToneTrackOptions, type TrackEffectsFunction, calculatePlaybackRate, closeGlobalAudioContext, configureGlobalContext, createToneAdapter, extractLoopAndEnvelope, getGeneratorValue, getGlobalAudioContext, getGlobalAudioContextState, getGlobalContext, getGlobalToneContext, getMediaStreamSource, getUnderlyingAudioParam, hasMediaStreamSource, int16ToFloat32, releaseMediaStreamSource, resumeGlobalAudioContext, timecentsToSeconds };

package/dist/index.d.ts

@@ -489,6 +489,26 @@ declare class TonePlayout {
  * cross-browser compatibility (fixes Firefox AudioListener issues).
  */
 
+interface AudioContextOptions {
+    /** Desired sample rate. Creates a standardized-audio-context AudioContext
+     *  at this rate, bypassing Tone.js 15.1.22's limitation. Cross-browser safe. */
+    sampleRate?: number;
+    /** Latency hint passed to the AudioContext constructor. */
+    latencyHint?: AudioContextLatencyCategory | number;
+}
+/**
+ * Configure the global AudioContext with sample rate and latency hints.
+ * Creates a standardized-audio-context AudioContext (cross-browser, fixes
+ * Firefox AudioListener bug) and wraps it in Tone.js Context.
+ *
+ * Should be called BEFORE getGlobalContext(). If the context already exists
+ * (e.g., from resumeGlobalAudioContext), warns and returns the existing rate.
+ *
+ * ```ts
+ * configureGlobalContext({ sampleRate: 48000, latencyHint: 0 })
+ * ```
+ */
+declare function configureGlobalContext(options: AudioContextOptions): number;
 /**
  * Get the global Tone.js Context
  * This is the main context for cross-browser audio operations.
@@ -588,4 +608,4 @@ interface ToneAdapterOptions {
 }
 declare function createToneAdapter(options?: ToneAdapterOptions): PlayoutAdapter;
 
-export { type EffectsFunction, type LoopAndEnvelopeParams, type MidiClipInfo, MidiToneTrack, type MidiToneTrackOptions, type PlayableTrack, type PlaybackRateParams, SoundFontCache, type SoundFontSample, SoundFontToneTrack, type SoundFontToneTrackOptions, type ToneAdapterOptions, TonePlayout, type TonePlayoutOptions, ToneTrack, type ToneTrackOptions, type TrackEffectsFunction, calculatePlaybackRate, closeGlobalAudioContext, createToneAdapter, extractLoopAndEnvelope, getGeneratorValue, getGlobalAudioContext, getGlobalAudioContextState, getGlobalContext, getGlobalToneContext, getMediaStreamSource, getUnderlyingAudioParam, hasMediaStreamSource, int16ToFloat32, releaseMediaStreamSource, resumeGlobalAudioContext, timecentsToSeconds };
+export { type AudioContextOptions, type EffectsFunction, type LoopAndEnvelopeParams, type MidiClipInfo, MidiToneTrack, type MidiToneTrackOptions, type PlayableTrack, type PlaybackRateParams, SoundFontCache, type SoundFontSample, SoundFontToneTrack, type SoundFontToneTrackOptions, type ToneAdapterOptions, TonePlayout, type TonePlayoutOptions, ToneTrack, type ToneTrackOptions, type TrackEffectsFunction, calculatePlaybackRate, closeGlobalAudioContext, configureGlobalContext, createToneAdapter, extractLoopAndEnvelope, getGeneratorValue, getGlobalAudioContext, getGlobalAudioContextState, getGlobalContext, getGlobalToneContext, getMediaStreamSource, getUnderlyingAudioParam, hasMediaStreamSource, int16ToFloat32, releaseMediaStreamSource, resumeGlobalAudioContext, timecentsToSeconds };

package/dist/index.js

@@ -29,6 +29,7 @@ __export(index_exports, {
   applyFadeOut: () => import_core.applyFadeOut,
   calculatePlaybackRate: () => calculatePlaybackRate,
   closeGlobalAudioContext: () => closeGlobalAudioContext,
+  configureGlobalContext: () => configureGlobalContext,
   createToneAdapter: () => createToneAdapter,
   extractLoopAndEnvelope: () => extractLoopAndEnvelope,
   getGeneratorValue: () => getGeneratorValue,
@@ -1546,6 +1547,26 @@ var SoundFontCache = class {
 // src/audioContext.ts
 var import_tone5 = require("tone");
 var globalToneContext = null;
+function configureGlobalContext(options) {
+  if (globalToneContext) {
+    const existingRate = globalToneContext.rawContext.sampleRate;
+    if (options.sampleRate !== void 0 && options.sampleRate !== existingRate) {
+      console.warn(
+        "[playout] configureGlobalContext: context already created at " + existingRate + " Hz (requested " + options.sampleRate + " Hz). Call configureGlobalContext before any audio operations for sample rate control."
+      );
+    }
+    return existingRate;
+  }
+  globalToneContext = new import_tone5.Context();
+  (0, import_tone5.setContext)(globalToneContext);
+  const actualRate = globalToneContext.rawContext.sampleRate;
+  if (options.sampleRate !== void 0 && options.sampleRate !== actualRate) {
+    console.warn(
+      "[playout] Requested sampleRate " + options.sampleRate + " but AudioContext is running at " + actualRate + " \u2014 pre-computed peaks at " + options.sampleRate + " Hz will fall back to worker"
+    );
+  }
+  return actualRate;
+}
 function getGlobalContext() {
   if (!globalToneContext) {
     globalToneContext = new import_tone5.Context();
@@ -1894,6 +1915,7 @@ function createToneAdapter(options) {
   applyFadeOut,
   calculatePlaybackRate,
   closeGlobalAudioContext,
+  configureGlobalContext,
   createToneAdapter,
   extractLoopAndEnvelope,
   getGeneratorValue,