@sudobility/music_player 0.1.0 → 0.1.2

package/dist/mocks/index.js

@@ -0,0 +1,93 @@
+import { PlaybackBus } from '../shared/bus.js';
+export class MockMusicPlayer {
+    calls = [];
+    /** The score it was last handed, for tests to assert on. */
+    loadedScore = null;
+    position = new Set();
+    soundingListeners = new Set();
+    transport = new Set();
+    loadState = new Set();
+    /** A real bus, so a consumer's tests can publish into it exactly as the engine would. */
+    bus = new PlaybackBus();
+    async load(score, opts = {}) {
+        this.loadedScore = score;
+        this.calls.push(opts.visibleTrackIds
+            ? `load(visible:${opts.visibleTrackIds.length})`
+            : 'load');
+    }
+    async play() {
+        this.calls.push('play');
+    }
+    pause() {
+        this.calls.push('pause');
+    }
+    stop() {
+        this.calls.push('stop');
+    }
+    seek(tick) {
+        this.calls.push(`seek(${tick})`);
+    }
+    setLoop(range) {
+        this.calls.push(range ? `setLoop(${range.startTick},${range.endTick})` : 'clearLoop');
+    }
+    setTempoMultiplier(m) {
+        this.calls.push(`setTempoMultiplier(${m})`);
+    }
+    setMetronome(on) {
+        this.calls.push(`setMetronome(${on})`);
+    }
+    setMasterVolume(v) {
+        this.calls.push(`setMasterVolume(${v})`);
+    }
+    applyMix(tracks) {
+        this.calls.push(`applyMix(${tracks.length})`);
+    }
+    setVisibleTracks(ids) {
+        this.calls.push(`setVisibleTracks(${ids.length})`);
+    }
+    noteOn(midi, program, isPercussion = false) {
+        this.calls.push(`noteOn(${midi},${program},${isPercussion})`);
+    }
+    noteOff(midi) {
+        this.calls.push(`noteOff(${midi})`);
+    }
+    onPosition(fn) {
+        this.position.add(fn);
+        return () => this.position.delete(fn);
+    }
+    onSounding(fn) {
+        this.soundingListeners.add(fn);
+        return () => this.soundingListeners.delete(fn);
+    }
+    onTransport(fn) {
+        this.transport.add(fn);
+        return () => this.transport.delete(fn);
+    }
+    onLoadState(fn) {
+        this.loadState.add(fn);
+        return () => this.loadState.delete(fn);
+    }
+    dispose() {
+        this.calls.push('dispose');
+    }
+    // ---- test drivers: let a suite push events the way a real engine would ----
+    emitPosition(tick) {
+        this.bus.publishPosition(tick);
+        for (const fn of this.position)
+            fn(tick);
+    }
+    emitSounding(notes) {
+        this.bus.publishSounding(notes);
+        for (const fn of this.soundingListeners)
+            fn(notes);
+    }
+    emitTransport(state) {
+        for (const fn of this.transport)
+            fn(state);
+    }
+    emitLoadState(state) {
+        for (const fn of this.loadState)
+            fn(state);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/mocks/index.js.map

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

package/dist/player.d.ts

@@ -0,0 +1,81 @@
+import type { PlaybackLoadState, PlaybackTrack, Score, ScoreRange, SoundingNote, TransportPlaybackState } from '@sudobility/music_types';
+import type { PlaybackEngine } from './engine.js';
+import { PlaybackBus } from './shared/bus.js';
+import type { IMusicPlayer, Unsubscribe } from './types.js';
+export declare class MusicPlayer implements IMusicPlayer {
+    private readonly engine;
+    /**
+     * Where position and sounding notes go instead of the host's store.
+     *
+     * Both arrive far too often to route through React state — see `bus.ts`.
+     */
+    readonly bus: PlaybackBus;
+    /**
+     * How the loaded plan's performance time maps onto the written score.
+     *
+     * Replaced whenever the plan is — a repeat added or removed changes it. The
+     * identity default means a player with nothing loaded translates nothing.
+     */
+    private timeline;
+    /** The loaded plan's tempo conversion, so the playhead can be told how fast ticks pass. */
+    private tempo;
+    /** The transport's half/double-speed control, kept here since the store no longer holds it for us. */
+    private multiplier;
+    /** Mirrors the engine, so `load` can tell a mix change from a reload without asking the host. */
+    private state;
+    private score;
+    private visibleTrackIds;
+    private readonly loadStateListeners;
+    constructor(engine: PlaybackEngine);
+    load(score: Score, opts?: {
+        visibleTrackIds?: readonly string[];
+    }): Promise<void>;
+    play(): Promise<void>;
+    pause(): void;
+    stop(): void;
+    /**
+     * Seeks to a *written* position.
+     *
+     * The engine is given the first performance position of that tick, which is
+     * what "play from here" means to somebody reading the page — the first time
+     * through, not the repeat. The caret is the host's to move.
+     */
+    seek(scoreTick: number): void;
+    setLoop(range: ScoreRange | null): void;
+    /** The whole score, for a host that wants a loop but has no selection to derive one from. */
+    wholeScoreRange(): ScoreRange | null;
+    setTempoMultiplier(multiplier: number): void;
+    setMetronome(enabled: boolean): void;
+    setMasterVolume(volume: number): void;
+    applyMix(tracks: readonly PlaybackTrack[]): void;
+    setVisibleTracks(visibleTrackIds: readonly string[]): void;
+    noteOn(midi: number, program: number, isPercussion?: boolean): void;
+    noteOff(midi: number): void;
+    onPosition(fn: (scoreTick: number) => void): Unsubscribe;
+    onSounding(fn: (notes: readonly SoundingNote[]) => void): Unsubscribe;
+    onTransport(fn: (state: TransportPlaybackState) => void): Unsubscribe;
+    onLoadState(fn: (state: PlaybackLoadState) => void): Unsubscribe;
+    dispose(): void;
+    /**
+     * How many score ticks pass per real second at the current position.
+     *
+     * Read off the plan's own tempo conversion — the same one the engine
+     * schedules against, so the playhead's smoothing and the audio agree about
+     * how fast the music is going. The multiplier is the transport's half/double
+     * speed control: the engine divides logical seconds by it, so one real second
+     * is that many logical seconds of music.
+     */
+    private ticksPerSecond;
+    /**
+     * A track sounds only if it is visible *and* not muted.
+     *
+     * Visibility used to reach the notation and the print sheet but never the
+     * audio, so hiding a track removed it from view while it went on playing.
+     * Combining the two axes here rather than writing visibility into the
+     * channel's mute means an explicit mute survives being hidden and shown
+     * again — the score keeps the user's intent, and this only ever derives from
+     * it.
+     */
+    private applyTrackAudibility;
+}
+//# sourceMappingURL=player.d.ts.map

package/dist/player.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"player.d.ts","sourceRoot":"","sources":["../src/player.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAEV,iBAAiB,EAEjB,aAAa,EACb,KAAK,EACL,UAAU,EACV,YAAY,EACZ,sBAAsB,EACvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EACV,cAAc,EACf,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE5D,qBAAa,WAAY,YAAW,YAAY;IAgClC,OAAO,CAAC,QAAQ,CAAC,MAAM;IA/BnC;;;;OAIG;IACH,QAAQ,CAAC,GAAG,cAAqB;IAEjC;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAA2D;IAE3E,2FAA2F;IAC3F,OAAO,CAAC,KAAK,CAAsC;IAEnD,sGAAsG;IACtG,OAAO,CAAC,UAAU,CAAK;IAEvB,iGAAiG;IACjG,OAAO,CAAC,KAAK,CAAqC;IAElD,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,eAAe,CAAkC;IAEzD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAE/B;gBAEyB,MAAM,EAAE,cAAc;IAsC7C,IAAI,CACR,KAAK,EAAE,KAAK,EACZ,IAAI,GAAE;QAAE,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;KAAO,GACjD,OAAO,CAAC,IAAI,CAAC;IA4BV,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,IAAI;IAIZ;;;;;;OAMG;IACH,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAK7B,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,GAAG,IAAI;IAIvC,6FAA6F;IAC7F,eAAe,IAAI,UAAU,GAAG,IAAI;IAKpC,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAK5C,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIpC,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIrC,QAAQ,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,GAAG,IAAI;IAIhD,gBAAgB,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAK1D,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,UAAQ,GAAG,IAAI;IAMjE,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI3B,UAAU,CAAC,EAAE,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,GAAG,WAAW;IAIxD,UAAU,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,KAAK,IAAI,GAAG,WAAW;IAIrE,WAAW,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,sBAAsB,KAAK,IAAI,GAAG,WAAW;IAIrE,WAAW,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,GAAG,WAAW;IAKhE,OAAO,IAAI,IAAI;IAKf;;;;;;;;OAQG;IACH,OAAO,CAAC,cAAc;IAUtB;;;;;;;;;OASG;IACH,OAAO,CAAC,oBAAoB;CAS7B"}

package/dist/player.js

@@ -0,0 +1,209 @@
+/**
+ * The transport: everything `PlaybackController` did that was not the store.
+ *
+ * It came from music_lib, where it read Zustand directly for the score, the
+ * visible tracks, the selection and the caret. Those four are editing state and
+ * stayed behind; what arrives here is score maths and engine driving. The host
+ * binds the two together — see music_lib's playback adapter.
+ */
+import { scoreEndTick, sourceTickFor, performanceTickFor, } from '@sudobility/music_types';
+import { getMusicPositionSource } from '@sudobility/music_types';
+import { PlaybackBus } from './shared/bus.js';
+import { playbackPlan, playbackTracks, resolveVoice } from './shared/plan.js';
+export class MusicPlayer {
+    engine;
+    /**
+     * Where position and sounding notes go instead of the host's store.
+     *
+     * Both arrive far too often to route through React state — see `bus.ts`.
+     */
+    bus = new PlaybackBus();
+    /**
+     * How the loaded plan's performance time maps onto the written score.
+     *
+     * Replaced whenever the plan is — a repeat added or removed changes it. The
+     * identity default means a player with nothing loaded translates nothing.
+     */
+    timeline = { segments: [], durationTicks: 0 };
+    /** The loaded plan's tempo conversion, so the playhead can be told how fast ticks pass. */
+    tempo = null;
+    /** The transport's half/double-speed control, kept here since the store no longer holds it for us. */
+    multiplier = 1;
+    /** Mirrors the engine, so `load` can tell a mix change from a reload without asking the host. */
+    state = 'stopped';
+    score = null;
+    visibleTrackIds = null;
+    loadStateListeners = new Set();
+    constructor(engine) {
+        this.engine = engine;
+        engine.setObserver({
+            /*
+              Translated here, and only here.
+      
+              The engine reports *performance* time, which differs from written time
+              the moment a repeat exists. Converting at this one boundary means the
+              caret, the following-scroll, the bar/beat readout and the position
+              scrubber all keep receiving a score tick and none of them has to know
+              repeats exist. Without repeats the timeline is the identity and this
+              costs a single comparison.
+            */
+            onPositionTick: tick => {
+                const scoreTick = sourceTickFor(this.timeline, tick);
+                // Refreshed every report rather than once at play, so a fermata or a
+                // tempo change mid-piece projects at the speed actually in force.
+                getMusicPositionSource().setRate(this.ticksPerSecond(scoreTick));
+                this.bus.publishPosition(scoreTick);
+            },
+            onActiveNotes: notes => this.bus.publishSounding(notes),
+            onStateChange: state => {
+                this.state = state;
+                // Smoothing only applies while the transport advances, and the playhead
+                // re-anchors on the transition so a pause does not leave it projecting
+                // forward across the time spent stopped.
+                getMusicPositionSource().setPlaying(state === 'playing', this.ticksPerSecond(this.bus.positionTick));
+                this.bus.publishTransport(state);
+            },
+            // Optional on the contract: an engine with nothing to load never calls it.
+            onLoadStateChange: state => {
+                for (const listener of this.loadStateListeners)
+                    listener(state);
+            },
+        });
+    }
+    async load(score, opts = {}) {
+        this.score = score;
+        if (opts.visibleTrackIds !== undefined) {
+            this.visibleTrackIds = opts.visibleTrackIds;
+        }
+        if (this.state === 'playing') {
+            // Tracks only: rebuilding every note to change a gain would undo the
+            // reason this branch exists. The host's edit lock is what makes it safe —
+            // while playing, the only score change that can reach here is a mix
+            // change, and anything arriving from outside that path must `stop()`
+            // first or it will be heard as the old score.
+            this.engine.applyMix(playbackTracks(score));
+            return;
+        }
+        const plan = playbackPlan(score);
+        // Kept in step with what the engine holds: a repeat added or removed
+        // changes the mapping, and a stale one would put the caret in the wrong
+        // bar for every frame until the next load.
+        this.timeline = plan.timeline;
+        this.tempo = plan.tempo;
+        await this.engine.load(plan);
+        // `load` reseeds every channel's mute from `Track.muted`, so hidden tracks
+        // would sound again without this.
+        this.applyTrackAudibility();
+    }
+    async play() {
+        await this.engine.play();
+    }
+    pause() {
+        this.engine.pause();
+    }
+    stop() {
+        this.engine.stop();
+    }
+    /**
+     * Seeks to a *written* position.
+     *
+     * The engine is given the first performance position of that tick, which is
+     * what "play from here" means to somebody reading the page — the first time
+     * through, not the repeat. The caret is the host's to move.
+     */
+    seek(scoreTick) {
+        if (!this.score)
+            return;
+        this.engine.seek(performanceTickFor(this.timeline, Math.max(0, scoreTick)));
+    }
+    setLoop(range) {
+        this.engine.setLoop(range);
+    }
+    /** The whole score, for a host that wants a loop but has no selection to derive one from. */
+    wholeScoreRange() {
+        if (!this.score)
+            return null;
+        return { startTick: 0, endTick: scoreEndTick(this.score), trackIds: [] };
+    }
+    setTempoMultiplier(multiplier) {
+        this.multiplier = multiplier;
+        this.engine.setTempoMultiplier(multiplier);
+    }
+    setMetronome(enabled) {
+        this.engine.setMetronome(enabled);
+    }
+    setMasterVolume(volume) {
+        this.engine.setMasterVolume(volume);
+    }
+    applyMix(tracks) {
+        this.engine.applyMix([...tracks]);
+    }
+    setVisibleTracks(visibleTrackIds) {
+        this.visibleTrackIds = visibleTrackIds;
+        this.applyTrackAudibility();
+    }
+    noteOn(midi, program, isPercussion = false) {
+        // Resolved here: the engine has no GM tables, and a percussion program
+        // addresses a kit rather than an instrument.
+        this.engine.noteOn(midi, resolveVoice(program, isPercussion));
+    }
+    noteOff(midi) {
+        this.engine.noteOff(midi);
+    }
+    onPosition(fn) {
+        return this.bus.onPosition(fn);
+    }
+    onSounding(fn) {
+        return this.bus.onSounding(fn);
+    }
+    onTransport(fn) {
+        return this.bus.onTransport(fn);
+    }
+    onLoadState(fn) {
+        this.loadStateListeners.add(fn);
+        return () => this.loadStateListeners.delete(fn);
+    }
+    dispose() {
+        this.loadStateListeners.clear();
+        this.engine.dispose();
+    }
+    /**
+     * How many score ticks pass per real second at the current position.
+     *
+     * Read off the plan's own tempo conversion — the same one the engine
+     * schedules against, so the playhead's smoothing and the audio agree about
+     * how fast the music is going. The multiplier is the transport's half/double
+     * speed control: the engine divides logical seconds by it, so one real second
+     * is that many logical seconds of music.
+     */
+    ticksPerSecond(tick) {
+        if (!this.tempo)
+            return 0;
+        // A second of music, measured at the playhead: how many ticks fit between
+        // now and one second from now, which handles a tempo change mid-piece
+        // without needing to know the tempo map's shape.
+        const perSecond = this.tempo.secondsToTicks(this.tempo.ticksToSeconds(tick) + 1) - tick;
+        return Math.max(0, perSecond * this.multiplier);
+    }
+    /**
+     * A track sounds only if it is visible *and* not muted.
+     *
+     * Visibility used to reach the notation and the print sheet but never the
+     * audio, so hiding a track removed it from view while it went on playing.
+     * Combining the two axes here rather than writing visibility into the
+     * channel's mute means an explicit mute survives being hidden and shown
+     * again — the score keeps the user's intent, and this only ever derives from
+     * it.
+     */
+    applyTrackAudibility() {
+        const score = this.score;
+        if (!score)
+            return;
+        const visible = this.visibleTrackIds;
+        for (const track of score.tracks) {
+            const hidden = visible !== null && !visible.includes(track.id);
+            this.engine.setTrackMute(track.id, track.muted || hidden);
+        }
+    }
+}
+//# sourceMappingURL=player.js.map

package/dist/player.js.map

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

package/dist/rn/audio/offline-render.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Offline audio rendering on React Native.
+ *
+ * Export goes through the same samples as playback, for the same reason the web
+ * export goes through the same soundfont: the file is supposed to be a
+ * recording of what was heard, and two voicing paths drift apart the first time
+ * one is tuned.
+ *
+ * The engine could not simply be reused, because it schedules against a *live*
+ * context's clock and pumps notes 200ms at a time — rendering an export that
+ * way would take as long as the piece. `RenderPlan` is already fully resolved
+ * (seconds, not ticks; mute and solo applied by `renderEvents` in music_lib),
+ * so everything can be scheduled up front against an `OfflineAudioContext` and
+ * rendered as fast as the device manages. What is shared is the part that
+ * matters: `PackLibrary` picks the sample, and `planVoice` decides the gain and
+ * the release.
+ */
+import type { AudioRenderer, RenderTrack } from '@sudobility/music_types';
+import type { AudioApi } from '../playback/audio-api.js';
+export type OfflineRendererDeps = {
+    loadAudioApi?: () => Promise<AudioApi>;
+    fetchPack?: (url: string) => Promise<string>;
+    packBase?: string;
+    percussionBase?: string;
+};
+/** The pack a track's notes come from — the same rule live playback uses. */
+export declare function packNameForRenderTrack(track: RenderTrack): string | null;
+export declare function createRNSoundfontRenderer(deps?: OfflineRendererDeps): AudioRenderer;
+//# sourceMappingURL=offline-render.d.ts.map

package/dist/rn/audio/offline-render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"offline-render.d.ts","sourceRoot":"","sources":["../../../src/rn/audio/offline-render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,aAAa,EAA4B,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAQpG,OAAO,KAAK,EAAE,QAAQ,EAAwC,MAAM,0BAA0B,CAAC;AAM/F,MAAM,MAAM,mBAAmB,GAAG;IAChC,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvC,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,6EAA6E;AAC7E,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAMxE;AASD,wBAAgB,yBAAyB,CAAC,IAAI,GAAE,mBAAwB,GAAG,aAAa,CA0EvF"}

package/dist/rn/audio/offline-render.js

@@ -0,0 +1,134 @@
+import { headroomTrimFor } from '../../shared/mix.js';
+import { gmPackName, percussionPackName } from '../playback/gm-pack-name.js';
+import { PackLibrary } from '../playback/pack-library.js';
+import { RELEASE_SECONDS, planVoice } from '../playback/voice-plan.js';
+import { sustains } from '../playback/expression.js';
+import { applySustainLoop } from '../playback/sustain-loop.js';
+import { loadAudioApi } from '../playback/audio-api.js';
+const SAMPLE_RATE = 44100;
+/** Stereo, so panning survives into the file. */
+const CHANNELS = 2;
+/** The pack a track's notes come from — the same rule live playback uses. */
+export function packNameForRenderTrack(track) {
+    // The kit-versus-instrument distinction is already resolved into
+    // `voiceProgram`/`voiceName` by music_lib, which owns the GM tables.
+    return track.isPercussion
+        ? percussionPackName(track.voiceProgram)
+        : gmPackName(track.voiceProgram, track.voiceName);
+}
+function defaultFetchPack(url) {
+    return fetch(url).then((r) => {
+        if (!r.ok)
+            throw new Error(`Sample pack ${url} responded ${r.status}`);
+        return r.text();
+    });
+}
+export function createRNSoundfontRenderer(deps = {}) {
+    return {
+        async render(plan) {
+            const api = await (deps.loadAudioApi ?? loadAudioApi)();
+            if (!api.OfflineAudioContext) {
+                throw new Error('react-native-audio-api is missing OfflineAudioContext; export needs >=0.13.');
+            }
+            const library = new PackLibrary({
+                fetchPack: deps.fetchPack ?? defaultFetchPack,
+                decodeAudioData: (bytes) => api.decodeAudioData(bytes),
+                packBase: deps.packBase,
+                percussionBase: deps.percussionBase,
+            });
+            const packByTrack = new Map();
+            for (const track of plan.tracks) {
+                const name = packNameForRenderTrack(track);
+                if (name)
+                    packByTrack.set(track.id, name);
+            }
+            // Only the packs notes are actually played from: a plan lists every track
+            // so the headroom is right, including silent ones, and downloading a pack
+            // for a track that sounds nothing would be minutes of nothing.
+            const sounding = new Set([...plan.events].map((e) => packByTrack.get(e.trackId)).filter(Boolean));
+            for (const name of sounding)
+                await library.ensure(name);
+            // Headroom is sized by how many tracks *exist*, not how many sound — the
+            // same rule live playback applies, or an export of a muted-heavy score
+            // comes out a couple of dB louder than what was heard.
+            const headroom = headroomTrimFor(plan.tracks.length);
+            // The tail of the last note has to fit inside the file.
+            const seconds = plan.durationSec + RELEASE_SECONDS;
+            const ctx = new api.OfflineAudioContext({
+                numberOfChannels: CHANNELS,
+                length: Math.ceil(seconds * SAMPLE_RATE),
+                sampleRate: SAMPLE_RATE,
+            });
+            const master = ctx.createGain();
+            master.gain.value = headroom;
+            master.connect(ctx.destination);
+            const trackById = new Map(plan.tracks.map((t) => [t.id, t]));
+            for (const event of plan.events) {
+                const packName = packByTrack.get(event.trackId);
+                const track = trackById.get(event.trackId);
+                if (!packName || !track)
+                    continue;
+                const voicing = library.voice(packName, event.midi, track.isPercussion);
+                if (!voicing)
+                    continue;
+                // `velocity` arrives 0..1 here but `planVoice` takes a 0..127 MIDI
+                // value, so it is scaled back up rather than passed through — getting
+                // this backwards renders a silent file, which is why it has a test.
+                const voice = planVoice({
+                    atSeconds: event.startSec,
+                    durationSeconds: event.durationSec,
+                    velocity: event.velocity * 127,
+                    trackGain: track.volume,
+                    choice: voicing.choice,
+                    // Same expression as playback — velocity curve, per-instrument
+                    // release, velocity-to-brightness — so the file is a recording of
+                    // what was heard. Percussion opts out for the same reason it does live.
+                    program: track.isPercussion ? undefined : track.midiProgram,
+                });
+                const mayLoop = !track.isPercussion && sustains(track.midiProgram);
+                buildOfflineVoice(ctx, master, voicing.buffer, voice, track.pan, mayLoop);
+            }
+            const rendered = await ctx.startRendering();
+            return { samples: toMono(rendered), sampleRate: rendered.sampleRate };
+        },
+    };
+}
+function buildOfflineVoice(ctx, master, buffer, voice, pan, mayLoop) {
+    const source = ctx.createBufferSource();
+    source.buffer = buffer;
+    if (voice.detuneCents !== 0)
+        source.detune.value = voice.detuneCents;
+    if (mayLoop)
+        applySustainLoop(source, buffer, voice.releaseAt - voice.startAt, voice.sampleMidi);
+    const amp = ctx.createGain();
+    amp.gain.setValueAtTime(voice.gain, voice.startAt);
+    amp.gain.setValueAtTime(voice.gain, voice.releaseAt);
+    amp.gain.linearRampToValueAtTime(0, voice.endAt);
+    const panner = ctx.createStereoPanner();
+    panner.pan.value = Math.max(-1, Math.min(1, pan));
+    if (voice.cutoffHz === null) {
+        source.connect(amp);
+    }
+    else {
+        const filter = ctx.createBiquadFilter();
+        filter.type = 'lowpass';
+        filter.frequency.value = voice.cutoffHz;
+        source.connect(filter);
+        filter.connect(amp);
+    }
+    amp.connect(panner);
+    panner.connect(master);
+    source.start(voice.startAt);
+    source.stop(voice.endAt);
+}
+/** The `DecodedAudio` contract is mono; the render is stereo so panning is real. */
+function toMono(buffer) {
+    const out = new Float32Array(buffer.length);
+    for (let c = 0; c < buffer.numberOfChannels; c += 1) {
+        const data = buffer.getChannelData(c);
+        for (let i = 0; i < data.length; i += 1)
+            out[i] += data[i] / buffer.numberOfChannels;
+    }
+    return out;
+}
+//# sourceMappingURL=offline-render.js.map

package/dist/rn/audio/offline-render.js.map

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

package/dist/rn/index.d.ts

@@ -0,0 +1,50 @@
+/**
+ * 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';
+/**
+ * `expression-table` is deliberately *not* re-exported here: the app that owns
+ * the soundfont needs `MEASURED_FROM_SHA256` to check the two still agree, and
+ * reaching it through this entry drags in the RN optional peers, which a web
+ * app does not install. It has its own dependency-free subpath,
+ * `@sudobility/music_player/rn/expression-table`.
+ */
+export type RNMusicPlayerOptions = {
+    /**
+     * Where the instrument packs are served from. An app that would rather not
+     * depend on a third party at runtime can copy them and point this at its own
+     * CDN — they are CC-BY 3.0, so that is allowed, and it is the recommended
+     * setup for anything shipping to a store.
+     */
+    packBase?: string;
+    /**
+     * Where the drum-kit packs are served from. **Required for percussion**;
+     * there is no default because nobody publishes usably-licensed GM percussion.
+     */
+    percussionBase?: string;
+};
+/** The React Native player, built fresh. Hand it to `initializeMusicPlayer`. */
+export declare function createMusicPlayer(options?: RNMusicPlayerOptions): MusicPlayer;
+/**
+ * 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 declare function renderSamples(options?: RNMusicPlayerOptions): (plan: import("@sudobility/music_types").RenderPlan) => Promise<import("@sudobility/music_types").DecodedAudio>;
+//# sourceMappingURL=index.d.ts.map

package/dist/rn/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","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;AAC/E;;;;;;GAMG;AAEH,MAAM,MAAM,oBAAoB,GAAG;IACjC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,gFAAgF;AAChF,wBAAgB,iBAAiB,CAC/B,OAAO,GAAE,oBAAyB,GACjC,WAAW,CAOb;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB,mHAK/D"}