@sudobility/music_types 0.9.0 → 0.11.0

package/dist/platform/audio.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Platform-bound audio decoding and encoding.
+ *
+ * Web uses Web Audio, which already understands wav and mp3 (and therefore
+ * `.mpa`, which is the same MPEG audio) — React Native will need something
+ * else entirely, which is why this is an interface rather than a function.
+ *
+ * The *analysis* is deliberately not here: pitch tracking, segmentation and
+ * tempo detection are pure functions over samples and live in music_lib, where
+ * they can be tested with a synthesised tone and no browser.
+ */
+export type DecodedAudio = {
+    samples: Float32Array;
+    sampleRate: number;
+};
+export interface AudioCodec {
+    /**
+     * Decode `.wav`/`.mp3`/`.mpa` to **mono** PCM.
+     *
+     * Channels are mixed down rather than preserved: the analysis is monophonic,
+     * so stereo would double the work for nothing.
+     */
+    decode(bytes: ArrayBuffer): Promise<DecodedAudio>;
+    encodeWav(audio: DecodedAudio): ArrayBuffer;
+    encodeMp3(audio: DecodedAudio): ArrayBuffer;
+}
+/** One note to sound in an offline render. */
+export type RenderEvent = {
+    midi: number;
+    startSec: number;
+    durationSec: number;
+    /** 0..1, as the synth voices expect. */
+    velocity: number;
+    midiProgram: number;
+    isPercussion: boolean;
+};
+/**
+ * Offline audio rendering — the platform-bound half of audio export.
+ *
+ * Takes events somebody else decided on (`renderEvents` in music_lib works out
+ * mute, solo and timing), so everything musical stays testable without an
+ * audio context and only the scheduling lives behind this interface.
+ */
+export interface AudioRenderer {
+    render(events: readonly RenderEvent[], durationSec: number): Promise<DecodedAudio>;
+}
+//# sourceMappingURL=audio.d.ts.map

package/dist/platform/audio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../../src/platform/audio.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,YAAY,GAAG;IAAE,OAAO,EAAE,YAAY,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzE,MAAM,WAAW,UAAU;IACzB;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAClD,SAAS,CAAC,KAAK,EAAE,YAAY,GAAG,WAAW,CAAC;IAC5C,SAAS,CAAC,KAAK,EAAE,YAAY,GAAG,WAAW,CAAC;CAC7C;AAED,8CAA8C;AAC9C,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CACpF"}

package/dist/platform/audio.js

@@ -0,0 +1,13 @@
+/**
+ * Platform-bound audio decoding and encoding.
+ *
+ * Web uses Web Audio, which already understands wav and mp3 (and therefore
+ * `.mpa`, which is the same MPEG audio) — React Native will need something
+ * else entirely, which is why this is an interface rather than a function.
+ *
+ * The *analysis* is deliberately not here: pitch tracking, segmentation and
+ * tempo detection are pure functions over samples and live in music_lib, where
+ * they can be tested with a synthesised tone and no browser.
+ */
+export {};
+//# sourceMappingURL=audio.js.map

package/dist/platform/audio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.js","sourceRoot":"","sources":["../../src/platform/audio.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/platform/index.d.ts

@@ -1,3 +1,4 @@
+export * from './audio.js';
 /**
  * Platform interfaces. Type-only contracts whose implementations live in
  * `@sudobility/music_io`, which serves web and React Native from one import

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/platform/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/platform/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B;;;;GAIG;AACH,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC"}

package/dist/platform/index.js

@@ -1,3 +1,4 @@
+export * from './audio.js';
 /**
  * Platform interfaces. Type-only contracts whose implementations live in
  * `@sudobility/music_io`, which serves web and React Native from one import

package/dist/platform/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/platform/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/platform/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B;;;;GAIG;AACH,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sudobility/music_types",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "description": "TypeScript types and Zod schemas for the ScoreSmith music API - scores, generation contracts, project payloads",
   "type": "module",
   "main": "./dist/index.js",