expo-juce 0.5.2 → 0.7.0-rc.0

package/README.md

@@ -23,10 +23,16 @@ iOS only for now; the Android and web modules are scaffolds.
         │
  juce::AudioDeviceManager ─► GraphPlayer (AudioIODeviceCallback: graph, peaks, NaNs, test tone)
         │
- juce::AudioProcessorGraph  PolySynthProcessor ─► audio output node
+ juce::AudioProcessorGraph  PolySynthProcessor ─► FxChainProcessor ─► audio output node
+                            AuxProcessor (metronome + backing track) ───► audio output node (summed)
                             ├─ NoteEventQueue: note-on ring (256) drained at block start; releases as marks
                             ├─ 8 × Voice: dsp::Oscillator → StateVariableTPTFilter (LP) → ADSR
                             └─ TransportEngine (tempo / position / beat crossings)
+                            FxChainProcessor: drive → crush → eq → chorus → phaser → echo → reverb →
+                            pump → compressor → safety limiter; settings in a process-lifetime store
+                            AuxProcessor: clicks rendered at prepare; track buffer swapped in from
+                            a process-lifetime BackingTrack holder (decoded on a background queue)
+ GraphPlayer also writes the output into an AnalysisRing (getAnalysis: peak / rms / scope)
 ```
 
 ## Roadmap: Full Audio Workstation
@@ -44,9 +50,9 @@ Replaced the mono SynthEngine + AVAudioEngine with a JUCE-owned audio stack buil
 `setup()` rejects with the failing step, `getDiagnostics()` exposes every layer from device callbacks to synth peak, `playTestTone()` bypasses the graph, an offline harness reproduces the device callback on Linux. Root causes of the first on-device silence (fixed 2026-10-22): a stale Metro bundle running the app on stubs, infinite recursion in `-setBeatCallback:`, `setup()` always resolving, and expo-av switching the shared session to Ambient. 0.5.2 adds: 128-sample buffer, no allocation on the audio thread, native `JucePadView` touch path, 2 ms default attack, session re-assert and interruption / media-reset recovery (keeping synth settings and transport state across rebuilds).
 
 ### Sub-project 2: Effects Chain
-**Status:** Planned
+**Status:** In progress (0.6.0) — engine + JS API done and verified in the offline harness; not yet run on a device
 
-Add `AudioProcessor` nodes for standard effects: reverb, delay, distortion, EQ, compressor. Inserted into the graph after the synth node on a master effects bus. Each effect is an independent processor — can be bypassed, reordered, or removed.
+One `FxChainProcessor` node between the synth and the output with nine effects in a fixed order: drive → crush → eq → chorus → phaser → echo → reverb → pump → compressor, then an always-on safety limiter (-0.3 dBFS). Each effect is enabled / bypassed independently (`setEffectEnabled`, `setEffectParam`, `getEffectsState`, see [Effects](#effects-060)); echo sync and pump follow the transport tempo and beat. Also in 0.6.0: an `AuxProcessor` node summed into the output after the effects, with a sample-accurate metronome (5 click styles, bar accent) and a backing track (off-thread decode + resample, gapless MP3 loop regions, lock-free swap, follows transport play / stop / seek; see [Metronome and backing track](#metronome-and-backing-track-060)); `getAnalysis()` (output peak / rms, 128-point scope, last note, transport) for HUDs; a `hitPolygon` touch shape on `JucePadView`. Later: reorderable / per-node effects via modular routing (sub-project 5).
 
 ### Sub-project 3: Sample Playback / Drum Machine
 **Status:** Planned — an earlier JUCE sampler prototype is the starting point
@@ -126,6 +132,185 @@ ExpoJuce.playTestTone(500);           // 440 Hz into the device output, bypasses
 await ExpoJuce.shutdown();
 ```
 
+### Effects (0.6.0+)
+
+A master effects chain sits between the synth and the output. All effects are off by
+default; order is fixed (drive → crush → eq → chorus → phaser → echo → reverb → pump →
+compressor), followed by a safety limiter (-0.3 dBFS ceiling, always on, not user-facing).
+
+```ts
+ExpoJuce.setEffectEnabled('reverb', true);            // boolean: false = unknown effect
+ExpoJuce.setEffectParam('reverb', 'mix', 0.4);        // boolean: false = unknown effect/param or NaN
+ExpoJuce.setEffectParam('echo', 'division', 1);       // synced echo, 1/8 at the transport tempo
+const fx = ExpoJuce.getEffectsState();                // { reverb: { enabled, params: { size, … } }, … }
+```
+
+- Synchronous and lock-free, any thread. Values are clamped to the ranges below (switches and
+  division indices rounded); `getEffectsState()` reports the stored values.
+- Settings are remembered natively whether or not the engine is running: calls made before
+  `setup()`, or during an automatic engine rebuild, take effect when the chain runs.
+- Turning an effect on or off crossfades it (10 ms); a disabled effect is skipped entirely and
+  an effect turned on starts clean (no stale echo or reverb tail). Echo and reverb spill over:
+  turning them off stops feeding them, and their tail keeps ringing out until it has faded
+  below -90 dBFS (at most 5 s, faded out over the last 50 ms); only then are they bypassed.
+  With every effect off (and tails ended) the output is the synth output, bit for bit (while
+  it stays under the limiter ceiling).
+- Parameter changes are smoothed where they would click (mix, gains, delay time, EQ bands).
+- Echo `sync` and `pump` follow the transport tempo; pump is locked to the transport beat
+  while it plays and free-runs at the tempo while it is stopped.
+- Binaries older than 0.6.0: the setters return `false` and `getEffectsState()` returns the
+  defaults. Web: no-ops.
+
+| effect | params (range, default) |
+|---|---|
+| `drive` | `amount` 0–1 (0.4), `tone` 0–1 (0.6), `mix` 0–1 (1) — pre-gain 1–40×, tanh, tone LP 800 Hz–20 kHz |
+| `crush` | `bits` 2–16 (8), `downsample` 1–32 (4), `noise` 0–1 (0.1), `mix` 0–1 (1) |
+| `eq` | `low` −12–12 dB (0, shelf 120 Hz), `mid` −12–12 dB (0, peak Q 0.9), `midFreq` 200–5000 Hz (1000), `high` −12–12 dB (0, shelf 6 kHz) |
+| `chorus` | `rate` 0.05–5 Hz (0.8), `depth` 0–1 (0.4), `mix` 0–1 (0.5) |
+| `phaser` | `rate` 0.05–5 Hz (0.4), `depth` 0–1 (0.6), `feedback` 0–0.9 (0.5), `mix` 0–1 (0.5) |
+| `echo` | `time` 0.02–2 s (0.375), `sync` 0/1 (1), `division` 0–5 (2; 1/4, 1/8, 1/8 dotted, 1/16, 1/4 dotted, 1/2), `feedback` 0–0.95 (0.4), `tone` 0–1 (0.5), `pingPong` 0/1 (0), `mix` 0–1 (0.35) |
+| `reverb` | `size` 0–1 (0.6), `damping` 0–1 (0.5), `width` 0–1 (1), `mix` 0–1 (0.3) |
+| `pump` | `depth` 0–1 (0.6), `shape` 0–1 (0.5; soft → snappy), `division` 0–3 (0; 1/4, 1/8, 1/2, 1/1) |
+| `compressor` | `threshold` −60–0 dB (−18), `ratio` 1–20 (4), `attack` 0.1–100 ms (10), `release` 10–1000 ms (120), `makeup` 0–24 dB (4) |
+
+`mix` is a dry/wet crossfade (0 = dry). Synced echo time is capped at 2 s.
+
+### Metronome and backing track (0.6.0+)
+
+An aux source next to the synth: its output is summed into the device output **after** the
+effects chain (clicks and the track are not effected). Both follow the transport.
+
+```ts
+ExpoJuce.setMetronome({ enabled: true, style: 'wood', level: 0.7, accent: true, beatsPerBar: 4 }); // false: unknown style
+
+const info = await ExpoJuce.loadBackingTrack(fileUri, {   // gapless info: optional, MP3 only
+  loopSamples: 682839, leadingSamples: 4561, trailingSamples: 1496,
+});
+// { durationSec, sampleRate, channels, loopStartSample, loopSamples, decodedSamples, regionRule, decoder }
+ExpoJuce.setBackingTrackOptions({ level: 0.8, loop: true, enabled: true });
+ExpoJuce.startTransport();                                 // the track and the clicks start
+ExpoJuce.unloadBackingTrack();
+```
+
+- **Metronome**: a click on every beat while the transport plays, starting on the exact
+  sample where the beat falls (any block size), accented on beat 1 of the bar. Styles
+  `classic` (sine blip 1.5 kHz / accent 2.5 kHz), `wood` (resonant noise burst), `beep`
+  (square 1 / 2 kHz), `cowbell` (two squares 540 / 800 Hz through a band-pass), `hat`
+  (high-passed noise). Clicks are rendered once when the engine prepares (no allocation while
+  playing). Options: `enabled` (false), `style` ('classic'), `level` 0–1 (0.8), `accent`
+  (true), `beatsPerBar` 1–16 (4). `setMetronome` returns `false` and applies nothing if
+  `style` is not one of the five.
+- **Backing track**: `loadBackingTrack(uri, gapless?)` takes a local file (`file://` URI or
+  absolute path; download remote files first). It decodes WAV, AIFF, FLAC and MP3 (plus
+  CoreAudio formats such as M4A / AAC on iOS) on a background queue straight to the device
+  rate and swaps the buffer in without blocking or allocating on the audio thread; the old
+  buffer is freed on the main thread after the audio thread has let go of it. Only the
+  playable buffer stays in memory (after a device-rate change the file is decoded again).
+  Limit: 6 minutes (17 280 000 frames per channel at 48 kHz, about 138 MB; the same duration
+  at other rates), and the load is refused if the process has less memory available than the
+  decode needs (about twice the final buffer). A newer load or `unloadBackingTrack()`
+  supersedes a load in flight (it rejects with `ERR_BACKING_TRACK_SUPERSEDED`); other errors:
+  `ERR_BACKING_TRACK_URI`, `_FILE`, `_FORMAT`, `_TOO_LONG`, `_MEMORY`.
+- **Gapless MP3 loops**: MP3 encoders pad the start and end. With `gapless` (the LAME / Xing
+  tag values, frames at the file's rate) the loop region is, by decoded length:
+  - `loopSamples` (the decoder honoured the tag) → `[0, loopSamples)`, `regionRule: 'tag'`;
+  - 1152 + leading + loopSamples + trailing (the decoder ignored the tag and decoded the tag
+    frame) → `[1152 + leading, +loopSamples)`, `'padded'`;
+  - leading + loopSamples + trailing (the decoder skipped the tag frame but kept the encoder
+    padding, as JUCE's own MP3 decoder does) → `[leading, +loopSamples)`, `'paddedNoTagFrame'`;
+  - anything else, or no `gapless` → the whole file, `'whole'` (with `gapless` given, this
+    means the fallback fired and the loop will include the padding).
+
+  The region is cut before resampling; `decodedSamples` / `decoder` tell what the decoder did.
+- **Playback** follows the transport. Track sample 0 is beat 0: when the transport starts or
+  is moved (`setTransportPosition`), the track goes to beat × 60 / bpm seconds (modulo its
+  length when looping), so pause + resume continues where it stopped and seeks land on the
+  beat grid. While playing, the track simply advances with the audio: a tempo change does not
+  move or stretch it (it keeps its own speed). Starts away from the top, seeks, stops, and
+  replacing or unloading the track while it plays are crossfaded over 5 ms. With `loop` off it
+  plays once and then stays silent until the transport is moved back.
+- Options: `level` 0–1 (0.8), `loop` (true), `enabled` (true).
+- Metronome and backing-track options and the loaded track are kept natively for the life of
+  the app: they work before `setup()` and survive engine rebuilds.
+- Binaries older than 0.6.0: the setters are no-ops (`setMetronome` returns `false`) and
+  `loadBackingTrack` rejects with `ERR_UNSUPPORTED`. Web: the same.
+
+### Arpeggiator (0.7.0+)
+
+A sample-accurate arpeggiator between the note queue and the voices. While it is enabled, every
+note the synth receives (pads, keys, `noteOn`) joins its held list instead of sounding, and the
+arp plays the held notes step by step on the transport's grid; disabled, notes play directly as
+before (voices that were sounding when the arp was enabled keep sounding until released).
+
+```ts
+ExpoJuce.setArpeggiator({ enabled: true, mode: 'upDown', rate: '1/16', octaves: 2, gate: 0.6 });
+ExpoJuce.setArpeggiator({ pattern: [true, false, true, true], swing: 0.2, ratchet: 2 }); // partial
+const state = ExpoJuce.getArpeggiatorState(); // every option as stored (ArpOptions)
+ExpoJuce.ARP_DEFAULTS;                        // the defaults below
+```
+
+- Options (`ArpOptions`, omitted keys keep their value, numbers are clamped; `setArpeggiator`
+  returns `false` and applies nothing for an unknown `mode` / `rate` or a `pattern` that is not
+  1–16 booleans):
+  - `enabled` (false)
+  - `mode` ('up'): `'up'` held notes ascending, `'down'`, `'upDown'` (up, then the interior
+    reversed: `[60, 64, 72, 76]` → `60 64 72 76 72 64`), `'played'` (press order), `'random'`
+    (a uniform pick per step), `'chord'` (every held note on every step)
+  - `rate` ('1/16'): `'1/4'`, `'1/8'`, `'1/8T'`, `'1/8D'`, `'1/16'`, `'1/16T'`, `'1/32'`
+    (1, 2, 3, 4/3, 4, 6, 8 steps per beat)
+  - `octaves` 1–4 (1): the cycle repeats +12 per extra octave
+  - `gate` 0.05–1.5 of a step (0.6): note length; above 1 the note overlaps the next step
+    (legato; a one-note cycle retriggers the same voice)
+  - `swing` 0–0.5 of a step (0): odd steps start that much later
+  - `latch` (false): the list is kept when every note is released; the next press replaces it
+  - `pattern` 1–16 booleans (16 × true), all or nothing: a false step is a rest and does not
+    advance the cycle
+  - `accent` 0–1 (0): steps other than the first of the pattern play at
+    velocity × (1 − 0.6 × accent)
+  - `ratchet` 1–4 (1): hits per step, each with `gate` of its share
+  - `transposeSteps` 0–8 (0) and `transposeDistance` −12..12 (0): each pass through the pattern
+    rises by `transposeDistance` semitones, wrapping after `transposeSteps` passes
+- Timing: step `k` starts `k × L` after the arp starts (`L = 60 / bpm / stepsPerBeat`), on the
+  exact sample whatever the block size. While the transport plays the steps sit on the beat grid
+  (`beat × stepsPerBeat` integer; a chord landing up to ¼ step after a grid line plays at once,
+  later ones wait for the next line) and a tempo change re-derives the grid from the new bpm.
+  Stopped, the grid starts at the first note-on and runs free at the current tempo.
+- The cycle restarts when the held list goes from empty to non-empty; adding or removing notes
+  while it plays takes effect at the next step. `allNotesOff()` stops the arp and clears its
+  list (a latched list included). Disabling stops the sounding arp notes at once.
+- 16 voices (`MAX_VOICES`), so a 16-note `chord` or ratchets with long releases do not steal.
+- Options are kept natively for the life of the app in one store the synth reads once per block:
+  they work before `setup()`, survive engine rebuilds and apply within a block even while a
+  rebuild is in progress. Binaries older than 0.7.0: `setArpeggiator` returns `false`,
+  `getArpeggiatorState` returns `ARP_DEFAULTS`. Web: the same.
+
+### Analysis (0.6.0+)
+
+```ts
+const a = ExpoJuce.getAnalysis();
+// { peak, rms, scope: number[128], bands: number[24], sampleRate, lastNote, bpm, beat, playing,
+//   arp: { active, step, steps, note } }
+```
+
+Synchronous and lock-free, cheap enough to call every animation frame (from one place: each
+call consumes the levels). `peak` (peak hold) and `rms` (both channels) cover the output
+since the previous call (synth, effects, metronome and backing track as sent to the device);
+`scope` is 128 points, oldest first, taken every 16th sample from the last 2048 output samples
+(mono, may tear across a block; it is for display). `bpm` / `beat` / `playing` are the
+transport as of the last rendered block. `lastNote` is the last note the synth started (-1 if
+none). Zeros when the engine is not running.
+
+0.7.0+ adds `bands`: 24 log-spaced spectrum bands between 40 Hz and 16 kHz, each 0–1 for
+−60..0 dBFS of the loudest FFT bin in the band, from a Hann-windowed 2048-point FFT of the same
+output samples, computed on the calling thread (about 50 µs per call). Band edges are
+`edge_0 = 40`, `edge_i = max(40 × 400^(i/24), edge_(i−1) + sampleRate / 2048)`,
+`edge_24 = 16000`: the lowest bands are one FFT bin wide (23.4 Hz at 48 kHz) until the
+geometric spacing takes over around 140 Hz, so no two bands read the same bin. `sampleRate` is
+the device rate the bands were computed at. `arp` is the arpeggiator as of the last block:
+`active` (enabled and holding notes), `step` (pattern slot of the last step started), `steps`
+(pattern length), `note` (last note the arp started, -1 if none). Older binaries: 24 zeros,
+`sampleRate` 0, `arp` inactive.
+
 ### `JucePadView` (0.5.2+)
 
 A native view that plays a note on touch from the iOS main thread, without the JS thread,
@@ -147,6 +332,15 @@ import { JucePadView } from 'expo-juce';
 
 Check the shipped type definitions for the exact event payloads once 0.5.2 is published.
 
+`hitPolygon` (0.6.0+) makes the touch area non-rectangular: a flat `[x0, y0, x1, y1, …]`
+polygon normalised to the view (0–1). Touches outside it (including on its children) pass
+through to the views underneath, so pads with overlapping bounding boxes do not steal each
+other's touches. Empty, odd-length or fewer than 3 points: the whole view.
+
+```tsx
+<JucePadView note={62} hitPolygon={[0.5, 0, 1, 0.5, 0.5, 1, 0, 0.5]} style={{ width: 96, height: 96 }} />
+```
+
 ### Diagnostics
 
 `getDiagnostics()` returns setup state (`isReady`, `setupStep`, `lastError`), device
@@ -159,8 +353,11 @@ Check the shipped type definitions for the exact event payloads once 0.5.2 is pu
 `mediaResetCount`, `lastRecoveryError`, `engineState`. A debug screen in the app can show them
 as a pass/fail ladder — see [docs/latency.md](docs/latency.md#5-a-diagnostics-panel).
 
-Synth settings and transport state (tempo, position, playing) survive the engine's automatic
-rebuilds after a media-services reset or a stalled device; held notes do not.
+0.6.0+ adds `fxProcessCount`, `fxLimiterGain` (1 = the safety limiter is idle),
+`fxNonFiniteResets`, `metronomeClicks`, `backingTrackLoaded` and `backingTrackPositionSec`.
+
+Synth settings, effect, metronome and backing-track settings (and the loaded track) and transport state (tempo, position, playing) survive the
+engine's automatic rebuilds after a media-services reset or a stalled device; held notes do not.
 
 ## Latency
 
@@ -195,11 +392,11 @@ bash and fail under npm on Windows, so build and publish by hand from Git Bash:
 npm install
 # 1. bump "version" in package.json, e.g. 0.5.2-diag.2
 CI=1 bash node_modules/expo-module-scripts/bin/expo-module-build   # tsc → build/
-npm publish --tag diag --ignore-scripts                            # npm 2FA code required
+npm publish --tag next --ignore-scripts --otp=<code>               # npm 2FA code required
 ```
 
 `--ignore-scripts` skips `prepublishOnly`, so step 1's build is mandatory. Prereleases go
-under a dist-tag (`diag`) so `latest` is not moved.
+under a dist-tag (`next`, earlier `diag`) so `latest` is not moved.
 
 Then in the consuming app: `npm install expo-juce@<version> --save-exact`, check that
 `package-lock.json` still has its macOS-only optional entries (a lockfile regenerated on
@@ -210,8 +407,9 @@ cannot resolve `file:` dependencies, which is why every native change goes throu
 
 1. **TypeScript:** `npx tsc --noEmit` here and in the consuming app.
 2. **Engine C++:** the offline harness compiles the vendored JUCE headless with `Voice`,
-   `VoiceAllocator`, `TransportEngine`, `PolySynthProcessor` and a copy of `GraphPlayer`, replays the
-   `doSetup` order and drives the callback with iOS-like block sizes. From `test/harness` in
+   `VoiceAllocator`, `TransportEngine`, `PolySynthProcessor`, `FxChainProcessor` and a copy of
+   `GraphPlayer`, replays the `doSetup` order (synth → fx → output) and drives the callback with
+   iOS-like block sizes; separate cases check every effect, bypass and echo sync. From `test/harness` in
    WSL (or any Linux shell):
    ```sh
    cmake -S . -B build && cmake --build build -j16 && ./build/harness

package/build/ExpoJuce.types.d.ts

@@ -29,6 +29,12 @@ export type JucePadViewProps = {
     velocity?: number;
     /** When false, touches pass through and no note is played (default true). */
     enabled?: boolean;
+    /**
+     * Touch area as a polygon: flat `[x0, y0, x1, y1, …]` normalised to the view (0–1). Touches
+     * outside it pass through to the views underneath. Empty, odd-length or fewer than 3 points:
+     * the whole view (default). iOS, 0.6.0+.
+     */
+    hitPolygon?: number[];
     /** Fired on the first touch, after the note has been sent to the engine (visuals/haptics only). */
     onNoteOn?: (event: PadNoteOnEvent) => void;
     /** Fired when the last touch lifts or is cancelled, after the note-off was sent. */
@@ -36,6 +42,160 @@ export type JucePadViewProps = {
     style?: StyleProp<ViewStyle>;
     children?: React.ReactNode;
 };
+/**
+ * Effects of the master chain (synth → effects → output), in processing order. A safety
+ * limiter (-0.3 dBFS ceiling) always runs after them and is not user-facing.
+ */
+export type EffectId = 'drive' | 'crush' | 'eq' | 'chorus' | 'phaser' | 'echo' | 'reverb' | 'pump' | 'compressor';
+/** Parameter names per effect (ranges and defaults: see README "Effects"). */
+export type EffectParams = {
+    drive: 'amount' | 'tone' | 'mix';
+    crush: 'bits' | 'downsample' | 'noise' | 'mix';
+    eq: 'low' | 'mid' | 'midFreq' | 'high';
+    chorus: 'rate' | 'depth' | 'mix';
+    phaser: 'rate' | 'depth' | 'feedback' | 'mix';
+    echo: 'time' | 'sync' | 'division' | 'feedback' | 'tone' | 'pingPong' | 'mix';
+    reverb: 'size' | 'damping' | 'width' | 'mix';
+    pump: 'depth' | 'shape' | 'division';
+    compressor: 'threshold' | 'ratio' | 'attack' | 'release' | 'makeup';
+};
+/** One effect's state as stored natively (values after clamping). */
+export type EffectState = {
+    enabled: boolean;
+    params: Record<string, number>;
+};
+/** Returned by `getEffectsState()`: every effect, enabled or not. */
+export type EffectsState = Record<EffectId, EffectState>;
+/** Metronome click sounds. */
+export type MetronomeStyle = 'classic' | 'wood' | 'beep' | 'cowbell' | 'hat';
+/** `setMetronome()` options; omitted keys keep their current value. */
+export type MetronomeOptions = {
+    /** Clicks while the transport plays (default false). */
+    enabled?: boolean;
+    /** Click sound (default 'classic'). */
+    style?: MetronomeStyle;
+    /** 0–1 (default 0.8). */
+    level?: number;
+    /** Higher click on beat 1 of the bar (default true). */
+    accent?: boolean;
+    /** 1–16, rounded (default 4). */
+    beatsPerBar?: number;
+};
+/**
+ * Gapless info of an MP3 (frames at the file's own rate, from its LAME/Xing tag): lets
+ * `loadBackingTrack` cut the exact loop out of what the decoder returns.
+ */
+export type BackingTrackGapless = {
+    loopSamples: number;
+    leadingSamples: number;
+    trailingSamples: number;
+};
+/** Loop region chosen by `loadBackingTrack()` (see `BackingTrackInfo.regionRule`). */
+export type BackingTrackRegionRule = 'tag' | 'padded' | 'paddedNoTagFrame' | 'whole';
+/** Resolved by `loadBackingTrack()`. Sample counts are frames at the file's own rate. */
+export type BackingTrackInfo = {
+    /** Length of the loop region in seconds. */
+    durationSec: number;
+    /** The file's sample rate (playback is resampled to the device rate). */
+    sampleRate: number;
+    channels: number;
+    /** Where the loop region starts in the decoded audio. */
+    loopStartSample: number;
+    /** Length of the loop region. */
+    loopSamples: number;
+    /** Frames the decoder produced before the region was cut. */
+    decodedSamples?: number;
+    /**
+     * Which loop region was used (0.6.0-rc.1+): 'tag' (the decoder honoured the gapless tag),
+     * 'padded' (tag frame decoded as silence, padding cut), 'paddedNoTagFrame' (tag frame skipped,
+     * padding cut), 'whole' (no gapless info, or a length matching no case: the whole file).
+     */
+    regionRule?: BackingTrackRegionRule;
+    /** Decoder used (e.g. "CoreAudio", "MP3 file", "WAV file"). */
+    decoder?: string;
+};
+/** `setBackingTrackOptions()` options; omitted keys keep their current value. */
+export type BackingTrackOptions = {
+    /** 0–1 (default 0.8). */
+    level?: number;
+    /** Loop the track (default true); otherwise it plays once and then is silent. */
+    loop?: boolean;
+    /** Plays with the transport (default true). */
+    enabled?: boolean;
+};
+/** Arpeggiator note order (0.7.0+). */
+export type ArpMode = 'up' | 'down' | 'upDown' | 'played' | 'random' | 'chord';
+/**
+ * Arpeggiator step rate (0.7.0+). Steps per beat: '1/4' 1, '1/8' 2, '1/8T' 3, '1/8D' 4/3,
+ * '1/16' 4, '1/16T' 6, '1/32' 8.
+ */
+export type ArpRate = '1/4' | '1/8' | '1/8T' | '1/8D' | '1/16' | '1/16T' | '1/32';
+/**
+ * `setArpeggiator()` options / `getArpeggiatorState()` result (0.7.0+). In `setArpeggiator`
+ * omitted keys keep their current value; numbers are clamped to their range; an unknown `mode`
+ * or `rate` rejects the whole call (nothing applied).
+ */
+export type ArpOptions = {
+    /** Arpeggiate held notes instead of playing them directly (default false). */
+    enabled: boolean;
+    /** Note order (default 'up'). */
+    mode: ArpMode;
+    /** Step rate relative to the transport tempo (default '1/16'). */
+    rate: ArpRate;
+    /** 1–4 octaves of the held notes in the cycle (default 1). */
+    octaves: number;
+    /** Note length, 0.05–1.5 of a step (default 0.6); > 1 overlaps the next step (legato). */
+    gate: number;
+    /** 0–0.5 of a step added to odd steps (default 0). */
+    swing: number;
+    /** Keep playing after every note is released; the next press starts a new chord (default false). */
+    latch: boolean;
+    /** 1–16 steps, true = the step plays (default 16 × true). */
+    pattern: boolean[];
+    /** 0–1 (default 0): steps other than step 0 play at velocity × (1 − 0.6 × accent). */
+    accent: number;
+    /** 1–4 hits per step (default 1). */
+    ratchet: number;
+    /** 0–8 pattern passes before the transposition wraps (default 0 = off). */
+    transposeSteps: number;
+    /** −12..12 semitones added per pass (default 0). */
+    transposeDistance: number;
+};
+/** Arpeggiator state in `Analysis.arp` (0.7.0+), as of the last rendered block. */
+export type ArpAnalysis = {
+    /** The arp is enabled and holds notes (a step is sounding or coming). */
+    active: boolean;
+    /** Pattern slot of the last step started (0-based). */
+    step: number;
+    /** Pattern length. */
+    steps: number;
+    /** Last note the arp started; -1 if none yet. */
+    note: number;
+};
+/** Returned by `getAnalysis()`: the device output (synth, effects, metronome, backing track). */
+export type Analysis = {
+    /** Max |sample| since the previous getAnalysis() call (peak hold), 0–1+. */
+    peak: number;
+    /** RMS (both channels) since the previous getAnalysis() call. */
+    rms: number;
+    /** 128 points, oldest first, decimated (every 16th sample) from the last 2048 output samples (mono). */
+    scope: number[];
+    /**
+     * 24 log-spaced bands, 40 Hz – 16 kHz, each 0–1 (−60..0 dBFS of the loudest FFT bin in the
+     * band) from the last 2048 output samples (0.7.0+; 24 zeros on older binaries).
+     */
+    bands: number[];
+    /** Sample rate the bands were computed at (0 when the engine is not running / older binaries). */
+    sampleRate: number;
+    /** Last note the synth started; -1 if none yet. */
+    lastNote: number;
+    /** Transport tempo, position (beats) and play state as of the last rendered block. */
+    bpm: number;
+    beat: number;
+    playing: boolean;
+    /** Arpeggiator state (0.7.0+; inactive on older binaries). */
+    arp: ArpAnalysis;
+};
 /** Native engine lifecycle state reported in `AudioDiagnostics.engineState`. */
 export type EngineState = 'ready' | 'recovering' | 'failed' | 'uninitialized';
 /**
@@ -69,9 +229,11 @@ export type AudioDiagnostics = {
     nanCount: number;
     /** Cumulative test-tone samples actually mixed into the device output (audio thread). */
     toneSamplesMixed: number;
+    /** Note-ons accepted into the note queue (cumulative since launch, across engine rebuilds). */
     notesQueued: number;
+    /** Note-ons the synth has started (cumulative since launch). */
     notesConsumed: number;
-    /** noteOn events dropped because the event queue was full. */
+    /** Note-ons dropped because the note queue was full. Note releases are never dropped. */
     notesDropped: number;
     activeVoices: number;
     /** ms from noteOn enqueue to the synth consuming it; -1 if none yet. */
@@ -100,6 +262,18 @@ export type AudioDiagnostics = {
     lockBusyDrops?: number;
     /** Times the audio callback was found stalled and the device was reopened (0.5.2+). */
     deadDeviceRestarts?: number;
+    /** FxChainProcessor::processBlock calls (0.6.0+). */
+    fxProcessCount?: number;
+    /** Lowest safety-limiter gain in the last effects block, 1 = not limiting (0.6.0+). */
+    fxLimiterGain?: number;
+    /** Effect chunks whose output went non-finite and were silenced + reset (0.6.0+). */
+    fxNonFiniteResets?: number;
+    /** Metronome clicks started (cumulative in the current engine, 0.6.0+). */
+    metronomeClicks?: number;
+    /** A backing track is loaded (0.6.0+). */
+    backingTrackLoaded?: boolean;
+    /** Backing-track playback position in seconds; -1 when not playing (0.6.0+). */
+    backingTrackPositionSec?: number;
     sessionCategory: string;
     sessionSampleRate: number;
     sessionIOBufferMs: number;

package/build/ExpoJuce.types.d.ts.map

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

package/build/ExpoJuce.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoJuce.types.js","sourceRoot":"","sources":["../src/ExpoJuce.types.ts"],"names":[],"mappings":"","sourcesContent":["import type * as React from 'react';\r\nimport type { StyleProp, ViewStyle } from 'react-native';\r\n\r\nexport type ChangeEventPayload = {\r\n  value: string;\r\n};\r\n\r\nexport type BeatEventPayload = {\r\n  beat: number;\r\n  bpm: number;\r\n};\r\n\r\nexport type SetupOptions = {\r\n  /** Preferred I/O buffer size in samples (default 128). The device grants the nearest size it supports. */\r\n  bufferSize?: number;\r\n  /** Preferred sample rate in Hz (default 48000). */\r\n  sampleRate?: number;\r\n};\r\n\r\n/** Payload of `JucePadView` `onNoteOn`. */\r\nexport type PadNoteOnEvent = {\r\n  note: number;\r\n  velocity: number;\r\n};\r\n\r\n/** Payload of `JucePadView` `onNoteOff`. */\r\nexport type PadNoteOffEvent = {\r\n  note: number;\r\n};\r\n\r\nexport type JucePadViewProps = {\r\n  /** MIDI note triggered while the pad is touched. */\r\n  note: number;\r\n  /** MIDI velocity 0-127 (default 100). */\r\n  velocity?: number;\r\n  /** When false, touches pass through and no note is played (default true). */\r\n  enabled?: boolean;\r\n  /** Fired on the first touch, after the note has been sent to the engine (visuals/haptics only). */\r\n  onNoteOn?: (event: PadNoteOnEvent) => void;\r\n  /** Fired when the last touch lifts or is cancelled, after the note-off was sent. */\r\n  onNoteOff?: (event: PadNoteOffEvent) => void;\r\n  style?: StyleProp<ViewStyle>;\r\n  children?: React.ReactNode;\r\n};\r\n\r\n/** Native engine lifecycle state reported in `AudioDiagnostics.engineState`. */\r\nexport type EngineState = 'ready' | 'recovering' | 'failed' | 'uninitialized';\r\n\r\n/**\r\n * Snapshot of native audio-engine state, returned by `getDiagnostics()`.\r\n * Counters are cumulative since setup; peaks are a decaying hold (~300 ms half-life)\r\n * of the max |sample| per block. All fields have safe defaults when not set up.\r\n */\r\nexport type AudioDiagnostics = {\r\n  /** Native engine finished setup. */\r\n  isReady: boolean;\r\n  /** Last setup step reached (0-11); -1 if setup never ran. On failure, the failing step. */\r\n  setupStep: number;\r\n  /** Setup failure and/or non-fatal setup notes; empty string if none. */\r\n  lastError: string;\r\n  deviceName: string;\r\n  deviceType: string;\r\n  sampleRate: number;\r\n  bufferSize: number;\r\n  outputLatencySamples: number;\r\n  /** Device IO callbacks received. */\r\n  callbackCount: number;\r\n  /** AudioProcessorGraph::processBlock calls made by the device callback. */\r\n  graphProcessCount: number;\r\n  /** PolySynthProcessor::processBlock calls. */\r\n  synthProcessCount: number;\r\n  /** Peak of the graph output written to the device (before test tone). */\r\n  outputPeak: number;\r\n  /** Peak of the synth output inside PolySynthProcessor. */\r\n  synthPeak: number;\r\n  /** Device blocks containing a non-finite (NaN/Inf) output sample. */\r\n  nanCount: number;\r\n  /** Cumulative test-tone samples actually mixed into the device output (audio thread). */\r\n  toneSamplesMixed: number;\r\n  notesQueued: number;\r\n  notesConsumed: number;\r\n  /** noteOn events dropped because the event queue was full. */\r\n  notesDropped: number;\r\n  activeVoices: number;\r\n  /** ms from noteOn enqueue to the synth consuming it; -1 if none yet. */\r\n  lastNoteToRenderMs: number;\r\n  /** ms from the UITouch hardware timestamp (JucePadView) to the synth consuming the note; -1 if none yet. */\r\n  lastTouchToRenderMs: number;\r\n  /** Buffer size (samples) requested at setup; compare with `bufferSize` (granted). */\r\n  preferredBufferSize: number;\r\n  /** Sample rate (Hz) requested at setup; compare with `sampleRate` (granted). */\r\n  preferredSampleRate: number;\r\n  /** Times another component changed the session category and it was re-asserted to Playback. */\r\n  sessionReassertCount: number;\r\n  /** AVAudioSession interruptions (calls, Siri, alarms) begun since launch. */\r\n  interruptionCount: number;\r\n  /** AVAudioSession media-services resets handled (full engine rebuild) since launch. */\r\n  mediaResetCount: number;\r\n  /** Last session-recovery problem; empty string if none. */\r\n  lastRecoveryError: string;\r\n  /**\r\n   * Engine lifecycle (0.5.2+; absent on older binaries): \"ready\", \"recovering\" (rebuild running,\r\n   * retry scheduled, or a lifecycle section in progress), \"failed\" (setup failed or rebuild\r\n   * retries exhausted), \"uninitialized\" (never set up, or shut down).\r\n   */\r\n  engineState?: EngineState;\r\n  /** JS-thread calls dropped because the engine lifecycle lock was busy (0.5.2+). */\r\n  lockBusyDrops?: number;\r\n  /** Times the audio callback was found stalled and the device was reopened (0.5.2+). */\r\n  deadDeviceRestarts?: number;\r\n  sessionCategory: string;\r\n  sessionSampleRate: number;\r\n  sessionIOBufferMs: number;\r\n  sessionOutputLatencyMs: number;\r\n  otherAudioPlaying: boolean;\r\n  /** AVAudioSession current route output port types. */\r\n  routeOutputs: string[];\r\n};\r\n"]}
+{"version":3,"file":"ExpoJuce.types.js","sourceRoot":"","sources":["../src/ExpoJuce.types.ts"],"names":[],"mappings":"","sourcesContent":["import type * as React from 'react';\r\nimport type { StyleProp, ViewStyle } from 'react-native';\r\n\r\nexport type ChangeEventPayload = {\r\n  value: string;\r\n};\r\n\r\nexport type BeatEventPayload = {\r\n  beat: number;\r\n  bpm: number;\r\n};\r\n\r\nexport type SetupOptions = {\r\n  /** Preferred I/O buffer size in samples (default 128). The device grants the nearest size it supports. */\r\n  bufferSize?: number;\r\n  /** Preferred sample rate in Hz (default 48000). */\r\n  sampleRate?: number;\r\n};\r\n\r\n/** Payload of `JucePadView` `onNoteOn`. */\r\nexport type PadNoteOnEvent = {\r\n  note: number;\r\n  velocity: number;\r\n};\r\n\r\n/** Payload of `JucePadView` `onNoteOff`. */\r\nexport type PadNoteOffEvent = {\r\n  note: number;\r\n};\r\n\r\nexport type JucePadViewProps = {\r\n  /** MIDI note triggered while the pad is touched. */\r\n  note: number;\r\n  /** MIDI velocity 0-127 (default 100). */\r\n  velocity?: number;\r\n  /** When false, touches pass through and no note is played (default true). */\r\n  enabled?: boolean;\r\n  /**\r\n   * Touch area as a polygon: flat `[x0, y0, x1, y1, …]` normalised to the view (0–1). Touches\r\n   * outside it pass through to the views underneath. Empty, odd-length or fewer than 3 points:\r\n   * the whole view (default). iOS, 0.6.0+.\r\n   */\r\n  hitPolygon?: number[];\r\n  /** Fired on the first touch, after the note has been sent to the engine (visuals/haptics only). */\r\n  onNoteOn?: (event: PadNoteOnEvent) => void;\r\n  /** Fired when the last touch lifts or is cancelled, after the note-off was sent. */\r\n  onNoteOff?: (event: PadNoteOffEvent) => void;\r\n  style?: StyleProp<ViewStyle>;\r\n  children?: React.ReactNode;\r\n};\r\n\r\n/**\r\n * Effects of the master chain (synth → effects → output), in processing order. A safety\r\n * limiter (-0.3 dBFS ceiling) always runs after them and is not user-facing.\r\n */\r\nexport type EffectId =\r\n  | 'drive'\r\n  | 'crush'\r\n  | 'eq'\r\n  | 'chorus'\r\n  | 'phaser'\r\n  | 'echo'\r\n  | 'reverb'\r\n  | 'pump'\r\n  | 'compressor';\r\n\r\n/** Parameter names per effect (ranges and defaults: see README \"Effects\"). */\r\nexport type EffectParams = {\r\n  drive: 'amount' | 'tone' | 'mix';\r\n  crush: 'bits' | 'downsample' | 'noise' | 'mix';\r\n  eq: 'low' | 'mid' | 'midFreq' | 'high';\r\n  chorus: 'rate' | 'depth' | 'mix';\r\n  phaser: 'rate' | 'depth' | 'feedback' | 'mix';\r\n  echo: 'time' | 'sync' | 'division' | 'feedback' | 'tone' | 'pingPong' | 'mix';\r\n  reverb: 'size' | 'damping' | 'width' | 'mix';\r\n  pump: 'depth' | 'shape' | 'division';\r\n  compressor: 'threshold' | 'ratio' | 'attack' | 'release' | 'makeup';\r\n};\r\n\r\n/** One effect's state as stored natively (values after clamping). */\r\nexport type EffectState = {\r\n  enabled: boolean;\r\n  params: Record<string, number>;\r\n};\r\n\r\n/** Returned by `getEffectsState()`: every effect, enabled or not. */\r\nexport type EffectsState = Record<EffectId, EffectState>;\r\n\r\n/** Metronome click sounds. */\r\nexport type MetronomeStyle = 'classic' | 'wood' | 'beep' | 'cowbell' | 'hat';\r\n\r\n/** `setMetronome()` options; omitted keys keep their current value. */\r\nexport type MetronomeOptions = {\r\n  /** Clicks while the transport plays (default false). */\r\n  enabled?: boolean;\r\n  /** Click sound (default 'classic'). */\r\n  style?: MetronomeStyle;\r\n  /** 0–1 (default 0.8). */\r\n  level?: number;\r\n  /** Higher click on beat 1 of the bar (default true). */\r\n  accent?: boolean;\r\n  /** 1–16, rounded (default 4). */\r\n  beatsPerBar?: number;\r\n};\r\n\r\n/**\r\n * Gapless info of an MP3 (frames at the file's own rate, from its LAME/Xing tag): lets\r\n * `loadBackingTrack` cut the exact loop out of what the decoder returns.\r\n */\r\nexport type BackingTrackGapless = {\r\n  loopSamples: number;\r\n  leadingSamples: number;\r\n  trailingSamples: number;\r\n};\r\n\r\n/** Loop region chosen by `loadBackingTrack()` (see `BackingTrackInfo.regionRule`). */\r\nexport type BackingTrackRegionRule = 'tag' | 'padded' | 'paddedNoTagFrame' | 'whole';\r\n\r\n/** Resolved by `loadBackingTrack()`. Sample counts are frames at the file's own rate. */\r\nexport type BackingTrackInfo = {\r\n  /** Length of the loop region in seconds. */\r\n  durationSec: number;\r\n  /** The file's sample rate (playback is resampled to the device rate). */\r\n  sampleRate: number;\r\n  channels: number;\r\n  /** Where the loop region starts in the decoded audio. */\r\n  loopStartSample: number;\r\n  /** Length of the loop region. */\r\n  loopSamples: number;\r\n  /** Frames the decoder produced before the region was cut. */\r\n  decodedSamples?: number;\r\n  /**\r\n   * Which loop region was used (0.6.0-rc.1+): 'tag' (the decoder honoured the gapless tag),\r\n   * 'padded' (tag frame decoded as silence, padding cut), 'paddedNoTagFrame' (tag frame skipped,\r\n   * padding cut), 'whole' (no gapless info, or a length matching no case: the whole file).\r\n   */\r\n  regionRule?: BackingTrackRegionRule;\r\n  /** Decoder used (e.g. \"CoreAudio\", \"MP3 file\", \"WAV file\"). */\r\n  decoder?: string;\r\n};\r\n\r\n/** `setBackingTrackOptions()` options; omitted keys keep their current value. */\r\nexport type BackingTrackOptions = {\r\n  /** 0–1 (default 0.8). */\r\n  level?: number;\r\n  /** Loop the track (default true); otherwise it plays once and then is silent. */\r\n  loop?: boolean;\r\n  /** Plays with the transport (default true). */\r\n  enabled?: boolean;\r\n};\r\n\r\n/** Arpeggiator note order (0.7.0+). */\r\nexport type ArpMode = 'up' | 'down' | 'upDown' | 'played' | 'random' | 'chord';\r\n\r\n/**\r\n * Arpeggiator step rate (0.7.0+). Steps per beat: '1/4' 1, '1/8' 2, '1/8T' 3, '1/8D' 4/3,\r\n * '1/16' 4, '1/16T' 6, '1/32' 8.\r\n */\r\nexport type ArpRate = '1/4' | '1/8' | '1/8T' | '1/8D' | '1/16' | '1/16T' | '1/32';\r\n\r\n/**\r\n * `setArpeggiator()` options / `getArpeggiatorState()` result (0.7.0+). In `setArpeggiator`\r\n * omitted keys keep their current value; numbers are clamped to their range; an unknown `mode`\r\n * or `rate` rejects the whole call (nothing applied).\r\n */\r\nexport type ArpOptions = {\r\n  /** Arpeggiate held notes instead of playing them directly (default false). */\r\n  enabled: boolean;\r\n  /** Note order (default 'up'). */\r\n  mode: ArpMode;\r\n  /** Step rate relative to the transport tempo (default '1/16'). */\r\n  rate: ArpRate;\r\n  /** 1–4 octaves of the held notes in the cycle (default 1). */\r\n  octaves: number;\r\n  /** Note length, 0.05–1.5 of a step (default 0.6); > 1 overlaps the next step (legato). */\r\n  gate: number;\r\n  /** 0–0.5 of a step added to odd steps (default 0). */\r\n  swing: number;\r\n  /** Keep playing after every note is released; the next press starts a new chord (default false). */\r\n  latch: boolean;\r\n  /** 1–16 steps, true = the step plays (default 16 × true). */\r\n  pattern: boolean[];\r\n  /** 0–1 (default 0): steps other than step 0 play at velocity × (1 − 0.6 × accent). */\r\n  accent: number;\r\n  /** 1–4 hits per step (default 1). */\r\n  ratchet: number;\r\n  /** 0–8 pattern passes before the transposition wraps (default 0 = off). */\r\n  transposeSteps: number;\r\n  /** −12..12 semitones added per pass (default 0). */\r\n  transposeDistance: number;\r\n};\r\n\r\n/** Arpeggiator state in `Analysis.arp` (0.7.0+), as of the last rendered block. */\r\nexport type ArpAnalysis = {\r\n  /** The arp is enabled and holds notes (a step is sounding or coming). */\r\n  active: boolean;\r\n  /** Pattern slot of the last step started (0-based). */\r\n  step: number;\r\n  /** Pattern length. */\r\n  steps: number;\r\n  /** Last note the arp started; -1 if none yet. */\r\n  note: number;\r\n};\r\n\r\n/** Returned by `getAnalysis()`: the device output (synth, effects, metronome, backing track). */\r\nexport type Analysis = {\r\n  /** Max |sample| since the previous getAnalysis() call (peak hold), 0–1+. */\r\n  peak: number;\r\n  /** RMS (both channels) since the previous getAnalysis() call. */\r\n  rms: number;\r\n  /** 128 points, oldest first, decimated (every 16th sample) from the last 2048 output samples (mono). */\r\n  scope: number[];\r\n  /**\r\n   * 24 log-spaced bands, 40 Hz – 16 kHz, each 0–1 (−60..0 dBFS of the loudest FFT bin in the\r\n   * band) from the last 2048 output samples (0.7.0+; 24 zeros on older binaries).\r\n   */\r\n  bands: number[];\r\n  /** Sample rate the bands were computed at (0 when the engine is not running / older binaries). */\r\n  sampleRate: number;\r\n  /** Last note the synth started; -1 if none yet. */\r\n  lastNote: number;\r\n  /** Transport tempo, position (beats) and play state as of the last rendered block. */\r\n  bpm: number;\r\n  beat: number;\r\n  playing: boolean;\r\n  /** Arpeggiator state (0.7.0+; inactive on older binaries). */\r\n  arp: ArpAnalysis;\r\n};\r\n\r\n/** Native engine lifecycle state reported in `AudioDiagnostics.engineState`. */\r\nexport type EngineState = 'ready' | 'recovering' | 'failed' | 'uninitialized';\r\n\r\n/**\r\n * Snapshot of native audio-engine state, returned by `getDiagnostics()`.\r\n * Counters are cumulative since setup; peaks are a decaying hold (~300 ms half-life)\r\n * of the max |sample| per block. All fields have safe defaults when not set up.\r\n */\r\nexport type AudioDiagnostics = {\r\n  /** Native engine finished setup. */\r\n  isReady: boolean;\r\n  /** Last setup step reached (0-11); -1 if setup never ran. On failure, the failing step. */\r\n  setupStep: number;\r\n  /** Setup failure and/or non-fatal setup notes; empty string if none. */\r\n  lastError: string;\r\n  deviceName: string;\r\n  deviceType: string;\r\n  sampleRate: number;\r\n  bufferSize: number;\r\n  outputLatencySamples: number;\r\n  /** Device IO callbacks received. */\r\n  callbackCount: number;\r\n  /** AudioProcessorGraph::processBlock calls made by the device callback. */\r\n  graphProcessCount: number;\r\n  /** PolySynthProcessor::processBlock calls. */\r\n  synthProcessCount: number;\r\n  /** Peak of the graph output written to the device (before test tone). */\r\n  outputPeak: number;\r\n  /** Peak of the synth output inside PolySynthProcessor. */\r\n  synthPeak: number;\r\n  /** Device blocks containing a non-finite (NaN/Inf) output sample. */\r\n  nanCount: number;\r\n  /** Cumulative test-tone samples actually mixed into the device output (audio thread). */\r\n  toneSamplesMixed: number;\r\n  /** Note-ons accepted into the note queue (cumulative since launch, across engine rebuilds). */\r\n  notesQueued: number;\r\n  /** Note-ons the synth has started (cumulative since launch). */\r\n  notesConsumed: number;\r\n  /** Note-ons dropped because the note queue was full. Note releases are never dropped. */\r\n  notesDropped: number;\r\n  activeVoices: number;\r\n  /** ms from noteOn enqueue to the synth consuming it; -1 if none yet. */\r\n  lastNoteToRenderMs: number;\r\n  /** ms from the UITouch hardware timestamp (JucePadView) to the synth consuming the note; -1 if none yet. */\r\n  lastTouchToRenderMs: number;\r\n  /** Buffer size (samples) requested at setup; compare with `bufferSize` (granted). */\r\n  preferredBufferSize: number;\r\n  /** Sample rate (Hz) requested at setup; compare with `sampleRate` (granted). */\r\n  preferredSampleRate: number;\r\n  /** Times another component changed the session category and it was re-asserted to Playback. */\r\n  sessionReassertCount: number;\r\n  /** AVAudioSession interruptions (calls, Siri, alarms) begun since launch. */\r\n  interruptionCount: number;\r\n  /** AVAudioSession media-services resets handled (full engine rebuild) since launch. */\r\n  mediaResetCount: number;\r\n  /** Last session-recovery problem; empty string if none. */\r\n  lastRecoveryError: string;\r\n  /**\r\n   * Engine lifecycle (0.5.2+; absent on older binaries): \"ready\", \"recovering\" (rebuild running,\r\n   * retry scheduled, or a lifecycle section in progress), \"failed\" (setup failed or rebuild\r\n   * retries exhausted), \"uninitialized\" (never set up, or shut down).\r\n   */\r\n  engineState?: EngineState;\r\n  /** JS-thread calls dropped because the engine lifecycle lock was busy (0.5.2+). */\r\n  lockBusyDrops?: number;\r\n  /** Times the audio callback was found stalled and the device was reopened (0.5.2+). */\r\n  deadDeviceRestarts?: number;\r\n  /** FxChainProcessor::processBlock calls (0.6.0+). */\r\n  fxProcessCount?: number;\r\n  /** Lowest safety-limiter gain in the last effects block, 1 = not limiting (0.6.0+). */\r\n  fxLimiterGain?: number;\r\n  /** Effect chunks whose output went non-finite and were silenced + reset (0.6.0+). */\r\n  fxNonFiniteResets?: number;\r\n  /** Metronome clicks started (cumulative in the current engine, 0.6.0+). */\r\n  metronomeClicks?: number;\r\n  /** A backing track is loaded (0.6.0+). */\r\n  backingTrackLoaded?: boolean;\r\n  /** Backing-track playback position in seconds; -1 when not playing (0.6.0+). */\r\n  backingTrackPositionSec?: number;\r\n  sessionCategory: string;\r\n  sessionSampleRate: number;\r\n  sessionIOBufferMs: number;\r\n  sessionOutputLatencyMs: number;\r\n  otherAudioPlaying: boolean;\r\n  /** AVAudioSession current route output port types. */\r\n  routeOutputs: string[];\r\n};\r\n"]}

package/build/ExpoJuceModule.d.ts

@@ -1,3 +1,48 @@
-declare const _default: any;
+import type { Analysis, ArpOptions, AudioDiagnostics, BackingTrackGapless, BackingTrackInfo, BackingTrackOptions, EffectsState, MetronomeOptions } from './ExpoJuce.types';
+export type ExpoJuceNativeModule = {
+    PI: number;
+    hello(): string;
+    setup(options?: {
+        bufferSize?: number;
+        sampleRate?: number;
+    }): Promise<void>;
+    shutdown(): Promise<void>;
+    hasJucePadView?(): boolean;
+    getDiagnostics(): AudioDiagnostics;
+    playTestTone(durationMs: number): boolean;
+    noteOn(note: number, velocity: number): void;
+    noteOff(note: number): void;
+    allNotesOff(): void;
+    setWaveform(waveform: string): void;
+    setFilterCutoff(hz: number): void;
+    setFilterResonance(q: number): void;
+    setAttack(ms: number): void;
+    setDecay(ms: number): void;
+    setSustain(level: number): void;
+    setRelease(ms: number): void;
+    setDetune(cents: number): void;
+    setMasterLevel(level: number): void;
+    setEffectEnabled?(id: string, enabled: boolean): boolean;
+    setEffectParam?(id: string, param: string, value: number): boolean;
+    getEffectsState?(): EffectsState;
+    setMetronome?(options: MetronomeOptions): boolean;
+    setBackingTrackOptions?(options: BackingTrackOptions): void;
+    loadBackingTrack?(uri: string, gapless: BackingTrackGapless | null): Promise<BackingTrackInfo>;
+    unloadBackingTrack?(): void;
+    getAnalysis?(): Analysis;
+    setArpeggiator?(options: Partial<ArpOptions>): boolean;
+    getArpeggiatorState?(): ArpOptions;
+    startTransport(): void;
+    stopTransport(): void;
+    setTempo(bpm: number): void;
+    setTransportPosition(beat: number): void;
+    getTransportPosition(): number;
+    getTempo(): number;
+    isTransportPlaying(): boolean;
+    setValueAsync(value: string): Promise<void>;
+    addListener(eventName: string): void;
+    removeListeners(count: number): void;
+};
+declare const _default: ExpoJuceNativeModule;
 export default _default;
 //# sourceMappingURL=ExpoJuceModule.d.ts.map

package/build/ExpoJuceModule.d.ts.map

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

package/build/ExpoJuceModule.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoJuceModule.js","sourceRoot":"","sources":["../src/ExpoJuceModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,kEAAkE;AAClE,4EAA4E;AAC5E,eAAe,mBAAmB,CAAC,UAAU,CAAC,CAAC","sourcesContent":["import { requireNativeModule } from 'expo-modules-core';\r\n\r\n// It loads the native module object from the JSI or falls back to\r\n// the bridge module (from NativeModulesProxy) if the remote debugger is on.\r\nexport default requireNativeModule('ExpoJuce');\r\n"]}
+{"version":3,"file":"ExpoJuceModule.js","sourceRoot":"","sources":["../src/ExpoJuceModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AA0ExD,kEAAkE;AAClE,4EAA4E;AAC5E,eAAe,mBAAmB,CAAuB,UAAU,CAAC,CAAC","sourcesContent":["import { requireNativeModule } from 'expo-modules-core';\r\n\r\nimport type {\r\n  Analysis,\r\n  ArpOptions,\r\n  AudioDiagnostics,\r\n  BackingTrackGapless,\r\n  BackingTrackInfo,\r\n  BackingTrackOptions,\r\n  EffectsState,\r\n  MetronomeOptions,\r\n} from './ExpoJuce.types';\r\n\r\n// The native module (ios/ExpoJuceModule.swift). Functions added after 0.5.0 are optional,\r\n// because an older binary does not export them: callers check `typeof fn === 'function'`.\r\nexport type ExpoJuceNativeModule = {\r\n  PI: number;\r\n  hello(): string;\r\n\r\n  // Lifecycle. Binaries older than 0.5.2 take no argument (see setup() in index.ts).\r\n  setup(options?: { bufferSize?: number; sampleRate?: number }): Promise<void>;\r\n  shutdown(): Promise<void>;\r\n  hasJucePadView?(): boolean;\r\n\r\n  // Diagnostics\r\n  getDiagnostics(): AudioDiagnostics;\r\n  playTestTone(durationMs: number): boolean;\r\n\r\n  // Synth\r\n  noteOn(note: number, velocity: number): void;\r\n  noteOff(note: number): void;\r\n  allNotesOff(): void;\r\n  setWaveform(waveform: string): void;\r\n  setFilterCutoff(hz: number): void;\r\n  setFilterResonance(q: number): void;\r\n  setAttack(ms: number): void;\r\n  setDecay(ms: number): void;\r\n  setSustain(level: number): void;\r\n  setRelease(ms: number): void;\r\n  setDetune(cents: number): void;\r\n  setMasterLevel(level: number): void;\r\n\r\n  // Effects (0.6.0+)\r\n  setEffectEnabled?(id: string, enabled: boolean): boolean;\r\n  setEffectParam?(id: string, param: string, value: number): boolean;\r\n  getEffectsState?(): EffectsState;\r\n\r\n  // Metronome, backing track, analysis (0.6.0+)\r\n  setMetronome?(options: MetronomeOptions): boolean;\r\n  setBackingTrackOptions?(options: BackingTrackOptions): void;\r\n  loadBackingTrack?(uri: string, gapless: BackingTrackGapless | null): Promise<BackingTrackInfo>;\r\n  unloadBackingTrack?(): void;\r\n  getAnalysis?(): Analysis;\r\n\r\n  // Arpeggiator (0.7.0+)\r\n  setArpeggiator?(options: Partial<ArpOptions>): boolean;\r\n  getArpeggiatorState?(): ArpOptions;\r\n\r\n  // Transport\r\n  startTransport(): void;\r\n  stopTransport(): void;\r\n  setTempo(bpm: number): void;\r\n  setTransportPosition(beat: number): void;\r\n  getTransportPosition(): number;\r\n  getTempo(): number;\r\n  isTransportPlaying(): boolean;\r\n\r\n  // Events\r\n  setValueAsync(value: string): Promise<void>;\r\n  // Event-emitter hooks (keeps the type compatible with expo-modules-core's EventEmitter).\r\n  addListener(eventName: string): void;\r\n  removeListeners(count: number): void;\r\n};\r\n\r\n// It loads the native module object from the JSI or falls back to\r\n// the bridge module (from NativeModulesProxy) if the remote debugger is on.\r\nexport default requireNativeModule<ExpoJuceNativeModule>('ExpoJuce');\r\n"]}