@sudobility/music_types 0.13.26 → 0.13.27

package/dist/platform/index.js.map

@@ -1 +1 @@
-{"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,iBAAiB,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,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC"}

package/dist/platform/score-files.d.ts

@@ -0,0 +1,36 @@
+/**
+ * The file layer above the codecs, as a contract.
+ *
+ * `@sudobility/music_codecs` turns bytes into a `Score` and back; an
+ * implementation of this turns *files* into a `Score` and back — read bytes,
+ * call the codec, hand over a score; take a score, call the codec, write the
+ * file. `@sudobility/music_io` implements it (`createScoreFiles`) and exposes
+ * it on its `MusicIo` bundle.
+ *
+ * **`open*`/`save*`, never `import*`/`export*`.** music_codecs already exports
+ * `importMidi`/`exportMidi`; two identically-named functions in packages an app
+ * imports together is a collision that gets resolved wrongly under time
+ * pressure.
+ *
+ * **Audio is deliberately asymmetric with the score formats.** `saveAudio`
+ * takes PCM the caller already rendered, because rendering is a live synth in
+ * `@sudobility/music_player` and the file layer never holds a reference to one.
+ */
+import type { Score } from "../model/score.js";
+import type { TrackerModule } from "../formats/mod.js";
+import type { MidiImportOptions, MidiImportResult, MidiSummary } from "../formats/midi-import.js";
+import type { MusicXmlImportResult, MusicXmlWarnings } from "../formats/musicxml.js";
+export type ScoreFiles = {
+    openMidi(bytes: ArrayBuffer, options: MidiImportOptions): MidiImportResult;
+    analyzeMidi(bytes: ArrayBuffer): MidiSummary;
+    openTracker(bytes: ArrayBuffer): {
+        module: TrackerModule;
+        score: Score;
+    };
+    openMusicXml(text: string, warnings: MusicXmlWarnings): Promise<MusicXmlImportResult>;
+    saveMidi(score: Score, filename: string): Promise<void>;
+    saveTracker(module: TrackerModule, filename: string): Promise<void>;
+    saveMusicXml(score: Score, filename: string): Promise<void>;
+    saveAudio(samples: Float32Array, sampleRate: number, format: "wav" | "mp3", filename: string): Promise<void>;
+};
+//# sourceMappingURL=score-files.d.ts.map

package/dist/platform/score-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"score-files.d.ts","sourceRoot":"","sources":["../../src/platform/score-files.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACZ,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EACV,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,iBAAiB,GAAG,gBAAgB,CAAC;IAC3E,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAAC;IAC7C,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG;QAAE,MAAM,EAAE,aAAa,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC;IACzE,YAAY,CACV,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAEjC,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,WAAW,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,SAAS,CACP,OAAO,EAAE,YAAY,EACrB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,KAAK,GAAG,KAAK,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB,CAAC"}

package/dist/platform/score-files.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=score-files.js.map

package/dist/platform/score-files.js.map

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

package/dist/platform/storage.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The storage a frontend store is handed, as structural contracts.
+ *
+ * Structural so each platform brings its own and a test brings a map: the web
+ * passes `localStorage` behind @sudobility/di's `StorageService`, a sandboxed
+ * macOS build reaches a file through a security-scoped bookmark — a different
+ * storage, not a different document.
+ */
+/** Structural subset of @sudobility/di's StorageService used for device prefs. */
+export type PrefsStorage = {
+    getItem(key: string): Promise<string | null | undefined> | string | null | undefined;
+    setItem(key: string, value: string): Promise<void> | void;
+};
+/** The filesystem, as far as a document needs one. */
+export type DocumentFileStorage = {
+    readText(uri: string): Promise<string>;
+    writeText(uri: string, text: string): Promise<void>;
+};
+//# sourceMappingURL=storage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/platform/storage.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,kFAAkF;AAClF,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,CACL,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAClE,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC3D,CAAC;AAEF,sDAAsD;AACtD,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACvC,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD,CAAC"}

package/dist/platform/storage.js

@@ -0,0 +1,10 @@
+/**
+ * The storage a frontend store is handed, as structural contracts.
+ *
+ * Structural so each platform brings its own and a test brings a map: the web
+ * passes `localStorage` behind @sudobility/di's `StorageService`, a sandboxed
+ * macOS build reaches a file through a security-scoped bookmark — a different
+ * storage, not a different document.
+ */
+export {};
+//# sourceMappingURL=storage.js.map

package/dist/platform/storage.js.map

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

package/package.json

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