@sudobility/music_player 0.1.0 → 0.1.2

package/dist/rn/index.js

@@ -0,0 +1,39 @@
+/**
+ * The React Native player: a sample-based FluidR3 engine.
+ *
+ * Playback is samples rather than the web's libfluidsynth-in-an-AudioWorklet —
+ * React Native has neither WebAssembly nor `addModule`, so that engine cannot
+ * be ported, only replaced. It is replaced with the *same font*, pre-rendered
+ * per note, so a phone plays the recordings a browser plays. See
+ * `playback/sample-engine.ts`.
+ */
+import { RNSamplePlaybackEngine } from './playback/sample-engine.js';
+import { createRNSoundfontRenderer } from './audio/offline-render.js';
+import { MusicPlayer } from '../player.js';
+export * from '../types.js';
+export * from '../singleton.js';
+export { MusicPlayer, RNSamplePlaybackEngine, createRNSoundfontRenderer };
+export { renderEvents } from '../shared/render-events.js';
+export { playbackPlan, playbackTracks, resolveVoice } from '../shared/plan.js';
+/** The React Native player, built fresh. Hand it to `initializeMusicPlayer`. */
+export function createMusicPlayer(options = {}) {
+    return new MusicPlayer(new RNSamplePlaybackEngine({
+        packBase: options.packBase,
+        percussionBase: options.percussionBase,
+    }));
+}
+/**
+ * Renders a plan to PCM, faster than realtime.
+ *
+ * Scheduled up front against an `OfflineAudioContext` rather than in real time.
+ * Sharing `PackLibrary` and `planVoice` with the engine is what keeps the file
+ * a recording of what was heard. The caller encodes and saves; this package
+ * does not touch files.
+ */
+export function renderSamples(options = {}) {
+    return createRNSoundfontRenderer({
+        packBase: options.packBase,
+        percussionBase: options.percussionBase,
+    }).render;
+}
+//# sourceMappingURL=index.js.map

package/dist/rn/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rn/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAwB/E,gFAAgF;AAChF,MAAM,UAAU,iBAAiB,CAC/B,UAAgC,EAAE;IAElC,OAAO,IAAI,WAAW,CACpB,IAAI,sBAAsB,CAAC;QACzB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,cAAc,EAAE,OAAO,CAAC,cAAc;KACvC,CAAC,CACH,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,UAAgC,EAAE;IAC9D,OAAO,yBAAyB,CAAC;QAC/B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,cAAc,EAAE,OAAO,CAAC,cAAc;KACvC,CAAC,CAAC,MAAM,CAAC;AACZ,CAAC"}

package/dist/rn/playback/audio-api.d.ts

@@ -0,0 +1,93 @@
+/**
+ * The slice of `react-native-audio-api` this engine uses.
+ *
+ * Declared structurally rather than imported so the engine can be constructed
+ * and driven in a test with a fake, and so this package's own dev tree does not
+ * need React Native — the library requires it at import time and cannot run
+ * outside a device anyway.
+ *
+ * Deliberately narrow. Widening it to the library's full surface would invite
+ * use of nodes that have not been thought about on this side of the boundary,
+ * which is the same reason `rn/types.d.ts` stays minimal.
+ */
+export type RNAudioBuffer = {
+    readonly length: number;
+    readonly numberOfChannels: number;
+    readonly sampleRate: number;
+    readonly duration: number;
+    getChannelData(channel: number): Float32Array;
+};
+export type RNAudioParam = {
+    value: number;
+    setValueAtTime(value: number, startTime: number): unknown;
+    linearRampToValueAtTime(value: number, endTime: number): unknown;
+    cancelScheduledValues(cancelTime: number): unknown;
+};
+export type RNAudioNode = {
+    connect(destination: RNAudioNode): unknown;
+    disconnect(): unknown;
+};
+export type RNGainNode = RNAudioNode & {
+    readonly gain: RNAudioParam;
+};
+export type RNBufferSource = RNAudioNode & {
+    buffer: RNAudioBuffer | null;
+    loop: boolean;
+    loopStart: number;
+    loopEnd: number;
+    readonly playbackRate: RNAudioParam;
+    readonly detune: RNAudioParam;
+    start(when?: number, offset?: number, duration?: number): void;
+    stop(when?: number): void;
+    onEnded?: (() => void) | null;
+};
+export type RNOscillator = RNAudioNode & {
+    readonly frequency: RNAudioParam;
+    type: string;
+    start(when?: number): void;
+    stop(when?: number): void;
+};
+export type RNStereoPanner = RNAudioNode & {
+    readonly pan: RNAudioParam;
+};
+export type RNBiquadFilter = RNAudioNode & {
+    type: string;
+    readonly frequency: RNAudioParam;
+    readonly Q: RNAudioParam;
+};
+/** The offline context, for export. Same node factories, plus `startRendering`. */
+export type RNOfflineAudioContext = {
+    readonly destination: RNAudioNode;
+    readonly sampleRate: number;
+    createGain(): RNGainNode;
+    createBufferSource(): RNBufferSource;
+    createStereoPanner(): RNStereoPanner;
+    createBiquadFilter(): RNBiquadFilter;
+    startRendering(): Promise<RNAudioBuffer>;
+};
+export type RNAudioContext = {
+    readonly currentTime: number;
+    readonly destination: RNAudioNode;
+    readonly sampleRate: number;
+    createGain(): RNGainNode;
+    createBufferSource(): RNBufferSource;
+    createOscillator(): RNOscillator;
+    createStereoPanner(): RNStereoPanner;
+    createBiquadFilter(): RNBiquadFilter;
+    resume(): Promise<void>;
+    close(): Promise<void> | void;
+};
+/** What `rn/playback/sample-engine.ts` needs from the module, and nothing else. */
+export type AudioApi = {
+    AudioContext: new () => RNAudioContext;
+    decodeAudioData(input: ArrayBuffer, sampleRate?: number): Promise<RNAudioBuffer>;
+    /** Absent before 0.13; `createRNSoundfontRenderer` says so rather than failing obscurely. */
+    OfflineAudioContext?: new (options: {
+        numberOfChannels: number;
+        length: number;
+        sampleRate: number;
+    }) => RNOfflineAudioContext;
+};
+/** Loads the real module. Lazy, so importing this package without it present does not throw. */
+export declare function loadAudioApi(): Promise<AudioApi>;
+//# sourceMappingURL=audio-api.d.ts.map

package/dist/rn/playback/audio-api.d.ts.map

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

package/dist/rn/playback/audio-api.js

@@ -0,0 +1,24 @@
+/**
+ * The slice of `react-native-audio-api` this engine uses.
+ *
+ * Declared structurally rather than imported so the engine can be constructed
+ * and driven in a test with a fake, and so this package's own dev tree does not
+ * need React Native — the library requires it at import time and cannot run
+ * outside a device anyway.
+ *
+ * Deliberately narrow. Widening it to the library's full surface would invite
+ * use of nodes that have not been thought about on this side of the boundary,
+ * which is the same reason `rn/types.d.ts` stays minimal.
+ */
+/** Loads the real module. Lazy, so importing this package without it present does not throw. */
+export async function loadAudioApi() {
+    const mod = (await import('react-native-audio-api'));
+    const AudioContext = mod.AudioContext ?? mod.default?.AudioContext;
+    const decodeAudioData = mod.decodeAudioData ?? mod.default?.decodeAudioData;
+    const OfflineAudioContext = mod.OfflineAudioContext ?? mod.default?.OfflineAudioContext;
+    if (!AudioContext || !decodeAudioData) {
+        throw new Error('react-native-audio-api is missing AudioContext or decodeAudioData; playback needs >=0.13.');
+    }
+    return { AudioContext, decodeAudioData, OfflineAudioContext };
+}
+//# sourceMappingURL=audio-api.js.map

package/dist/rn/playback/audio-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-api.js","sourceRoot":"","sources":["../../../src/rn/playback/audio-api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAuFH,gGAAgG;AAChG,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,MAAM,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAElD,CAAC;IACF,MAAM,YAAY,GAAG,GAAG,CAAC,YAAY,IAAI,GAAG,CAAC,OAAO,EAAE,YAAY,CAAC;IACnE,MAAM,eAAe,GAAG,GAAG,CAAC,eAAe,IAAI,GAAG,CAAC,OAAO,EAAE,eAAe,CAAC;IAC5E,MAAM,mBAAmB,GAAG,GAAG,CAAC,mBAAmB,IAAI,GAAG,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACxF,IAAI,CAAC,YAAY,IAAI,CAAC,eAAe,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CACb,2FAA2F,CAC5F,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAc,CAAC;AAC5E,CAAC"}

package/dist/rn/playback/expression-table.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Generated by `scripts/measure-expression.mjs` — do not edit.
+ *
+ * Per GM program: the low-pass corner at each probed velocity, the measured
+ * release, and whether the instrument holds its level while held.
+ * See `rn/playback/expression.ts` for what applies it.
+ */
+/**
+ * SHA-256 of the soundfont these numbers were measured from.
+ *
+ * Swap the font and every cutoff, release and sustain flag here describes an
+ * instrument that is no longer being played — silently, because nothing about a
+ * stale table throws. music_app owns the font, so music_app asserts the match.
+ */
+export declare const MEASURED_FROM_SHA256 = "2aacd036d7058d40a371846ef2f5dc5f130d648ab3837fe2626591ba49a71254";
+export type ExpressionEntry = {
+    cutoffs: Record<string, number>;
+    releaseSec: number | null;
+    sustains: boolean;
+};
+export declare const EXPRESSION_TABLE: Record<string, ExpressionEntry>;
+//# sourceMappingURL=expression-table.d.ts.map

package/dist/rn/playback/expression-table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expression-table.d.ts","sourceRoot":"","sources":["../../../src/rn/playback/expression-table.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,qEAAqE,CAAC;AAEvG,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CA64B5D,CAAC"}