@sudobility/music_types 0.11.35 → 0.13.1

package/CLAUDE.md

@@ -39,6 +39,26 @@ Everything exports from a single sectioned `src/index.ts`:
 
 ## Gotchas
 
+- **The playhead is the one stateful service in this package, and that is a
+  deliberate precedent.** `MusicPosition` and its singleton live in
+  `src/position/`. Everything else here is model and primitives; the playhead
+  earns the exception because it has exactly one writer
+  (`@sudobility/music_player`) and readers in every other package — the caret,
+  the note highlighting, the piano keyboard — so any other home creates a
+  dependency edge that exists only to reach it. It still obeys the four rules:
+  works on both sides, no dependency, no hooks, no async.
+- **`base64.ts` is here because its two consumers ended up in different
+  packages.** `music_io`'s React Native file exporter encodes; `music_player`'s
+  sample-pack loader decodes. The module exists precisely so there is one
+  alphabet and one round-trip test rather than a copy each — splitting it would
+  break the property it was written to guarantee.
+- **The playback *plan* is here; the engine *contract* is not.** `PlaybackPlan`
+  composes `PerformanceTimeline`, which `performanceTimeline()` in
+  `domain/score/` produces, so the whole plan cluster is anchored here — moving
+  it would make this package import from `music_player`. `PlaybackEngine`,
+  `PlaybackObserver` and `AuditionVoice` did move, because that package is the
+  only thing that implements or calls them.
+
 - No domain logic here: tick math, factories, commands, validation logic all live in `@sudobility/music_lib`. This package must never depend on music_lib (music_api depends on this package and must not pull in UI/audio code).
 - `noteEventSchema`/`restEventSchema` are `.strict()` on purpose (a stray `pitch` key must not pass as a rest); other schemas strip unknown keys for forward compatibility.
 - Ticks are integers at 480 PPQ by convention; `startTick` is absolute.

package/dist/bytes/base64.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Base64, both directions.
+ *
+ * Here rather than in a platform package because its two consumers now live in
+ * different ones — `music_io`'s React Native file exporter encodes, and
+ * `music_player`'s sample-pack loader decodes — and this module exists
+ * precisely so there is one alphabet and one round-trip test rather than a
+ * copy each. Pure string and byte work: no dependency, no async, nothing
+ * platform-bound, so it sits inside this package's four rules.
+ *
+ * Written out rather than reached for because Hermes guarantees neither `btoa`
+ * nor Node's `Buffer`, and the two places that need it need opposite
+ * directions: `file/file.rn.ts` encodes bytes to hand `react-native-fs` a
+ * base64 string, and `playback/pack-library.ts` decodes the base64 mp3 data
+ * URIs inside a FluidR3 sample pack.
+ *
+ * One module rather than a copy each, so the alphabet is defined once and the
+ * pair can be round-tripped against each other — which is a stronger check than
+ * either direction gets alone, since a matching error in both would still
+ * survive testing them separately.
+ *
+ * **Both are hot enough to be worth the shape they are in.** A sample pack is
+ * ~2.7MB of base64 decoded on the way into playback, per instrument, and an
+ * audio export is tens of megabytes encoded on the way out — on a phone, with
+ * no JIT. The obvious implementations of each were measured at 77ms and 580ms
+ * for those sizes on a laptop; these are 9ms and 303ms.
+ */
+/** Bytes to base64, padded. */
+export declare function bytesToBase64(bytes: Uint8Array): string;
+/**
+ * Base64 to bytes. Anything outside the alphabet — padding, newlines a data URI
+ * may carry — is skipped rather than rejected.
+ *
+ * Skipped *inline* rather than stripped first: the obvious
+ * `replace(/[^A-Za-z0-9+/]/g, '')` copies the whole multi-megabyte string
+ * before any decoding starts, which on a sample pack costs as much as the
+ * decode itself.
+ */
+export declare function base64ToBytes(base64: string): ArrayBuffer;
+//# sourceMappingURL=base64.d.ts.map

package/dist/bytes/base64.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.d.ts","sourceRoot":"","sources":["../../src/bytes/base64.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAyBH,+BAA+B;AAC/B,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAmBvD;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAoBzD"}

package/dist/bytes/base64.js

@@ -0,0 +1,101 @@
+/**
+ * Base64, both directions.
+ *
+ * Here rather than in a platform package because its two consumers now live in
+ * different ones — `music_io`'s React Native file exporter encodes, and
+ * `music_player`'s sample-pack loader decodes — and this module exists
+ * precisely so there is one alphabet and one round-trip test rather than a
+ * copy each. Pure string and byte work: no dependency, no async, nothing
+ * platform-bound, so it sits inside this package's four rules.
+ *
+ * Written out rather than reached for because Hermes guarantees neither `btoa`
+ * nor Node's `Buffer`, and the two places that need it need opposite
+ * directions: `file/file.rn.ts` encodes bytes to hand `react-native-fs` a
+ * base64 string, and `playback/pack-library.ts` decodes the base64 mp3 data
+ * URIs inside a FluidR3 sample pack.
+ *
+ * One module rather than a copy each, so the alphabet is defined once and the
+ * pair can be round-tripped against each other — which is a stronger check than
+ * either direction gets alone, since a matching error in both would still
+ * survive testing them separately.
+ *
+ * **Both are hot enough to be worth the shape they are in.** A sample pack is
+ * ~2.7MB of base64 decoded on the way into playback, per instrument, and an
+ * audio export is tens of megabytes encoded on the way out — on a phone, with
+ * no JIT. The obvious implementations of each were measured at 77ms and 580ms
+ * for those sizes on a laptop; these are 9ms and 303ms.
+ */
+const ALPHABET = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
+/**
+ * Character code to sextet, -1 for anything else.
+ *
+ * A table rather than `ALPHABET.indexOf(char)`, which is a linear search over
+ * 64 characters *per character decoded* — 8.5x the total cost on a pack-sized
+ * input, and worse under an interpreter than under V8.
+ */
+const SEXTET = new Int8Array(256).fill(-1);
+for (let i = 0; i < ALPHABET.length; i += 1)
+    SEXTET[ALPHABET.charCodeAt(i)] = i;
+/**
+ * How much string to accumulate before pushing it into the chunk list.
+ *
+ * Growing one string four characters at a time asks the engine to keep
+ * re-materialising it; joining a list of moderate pieces is roughly twice as
+ * fast on an export-sized input. Large enough that the list stays short, small
+ * enough that no single piece is itself expensive to grow.
+ */
+const ENCODE_CHUNK_CHARS = 8192;
+/** Bytes to base64, padded. */
+export function bytesToBase64(bytes) {
+    const chunks = [];
+    let piece = '';
+    for (let i = 0; i < bytes.length; i += 3) {
+        const a = bytes[i];
+        const b = bytes[i + 1];
+        const c = bytes[i + 2];
+        piece +=
+            ALPHABET[a >> 2] +
+                ALPHABET[((a & 0x03) << 4) | ((b ?? 0) >> 4)] +
+                (b === undefined ? '=' : ALPHABET[((b & 0x0f) << 2) | ((c ?? 0) >> 6)]) +
+                (c === undefined ? '=' : ALPHABET[c & 0x3f]);
+        if (piece.length >= ENCODE_CHUNK_CHARS) {
+            chunks.push(piece);
+            piece = '';
+        }
+    }
+    if (piece)
+        chunks.push(piece);
+    return chunks.join('');
+}
+/**
+ * Base64 to bytes. Anything outside the alphabet — padding, newlines a data URI
+ * may carry — is skipped rather than rejected.
+ *
+ * Skipped *inline* rather than stripped first: the obvious
+ * `replace(/[^A-Za-z0-9+/]/g, '')` copies the whole multi-megabyte string
+ * before any decoding starts, which on a sample pack costs as much as the
+ * decode itself.
+ */
+export function base64ToBytes(base64) {
+    // An upper bound — exact when there is no padding or whitespace, over by at
+    // most a couple of bytes when there is. Trimmed at the end rather than
+    // counted in a first pass, which would be another walk over megabytes.
+    const out = new Uint8Array(((base64.length * 3) >> 2) + 3);
+    let outIndex = 0;
+    let accumulator = 0;
+    let bits = 0;
+    for (let i = 0; i < base64.length; i += 1) {
+        const sextet = SEXTET[base64.charCodeAt(i) & 0xff];
+        if (sextet < 0)
+            continue;
+        accumulator = (accumulator << 6) | sextet;
+        bits += 6;
+        if (bits >= 8) {
+            bits -= 8;
+            out[outIndex] = (accumulator >> bits) & 0xff;
+            outIndex += 1;
+        }
+    }
+    return out.buffer.slice(0, outIndex);
+}
+//# sourceMappingURL=base64.js.map

package/dist/bytes/base64.js.map

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

package/dist/bytes/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./base64.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bytes/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

package/dist/bytes/index.js

@@ -0,0 +1,2 @@
+export * from "./base64.js";
+//# sourceMappingURL=index.js.map

package/dist/bytes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/bytes/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

package/dist/formats/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Score file-format models: the neutral shapes a MIDI file and a tracker
+ * module decode into.
+ *
+ * Not under `platform/`, deliberately. These carry notes rather than samples,
+ * so nothing about them is platform-bound — the codecs that produce them live
+ * in `@sudobility/music_codecs` and run identically on web, React Native and
+ * the server.
+ */
+export * from "./midi.js";
+export * from "./mod.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/formats/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC"}

package/dist/formats/index.js

@@ -0,0 +1,12 @@
+/**
+ * Score file-format models: the neutral shapes a MIDI file and a tracker
+ * module decode into.
+ *
+ * Not under `platform/`, deliberately. These carry notes rather than samples,
+ * so nothing about them is platform-bound — the codecs that produce them live
+ * in `@sudobility/music_codecs` and run identically on web, React Native and
+ * the server.
+ */
+export * from "./midi.js";
+export * from "./mod.js";
+//# sourceMappingURL=index.js.map

package/dist/formats/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/formats/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC"}

package/dist/{platform → formats}/midi.d.ts

@@ -52,8 +52,4 @@ export type MidiFile = {
     /** Longest track duration in seconds. */
     duration: number;
 };
-export interface MidiCodec {
-    decode(data: ArrayBuffer): MidiFile;
-    encode(file: MidiFile): Uint8Array;
-}
 //# sourceMappingURL=midi.d.ts.map

package/dist/formats/midi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"midi.d.ts","sourceRoot":"","sources":["../../src/formats/midi.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AACF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AACF,MAAM,MAAM,cAAc,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAC5D,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB;;;;;OAKG;IACH,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAC;IACpD,aAAa,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,MAAM,EAAE;QACN,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,cAAc,EAAE,CAAC;QACzB,cAAc,EAAE,sBAAsB,EAAE,CAAC;KAC1C,CAAC;IACF,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC"}

package/dist/{platform → formats}/midi.js.map

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

package/dist/{platform → formats}/mod.d.ts

@@ -54,24 +54,4 @@ export type TrackerModule = {
     /** `patterns[p][row][channel]`. Row count varies per pattern — MOD is always 64, IT allows 200. */
     patterns: TrackerCell[][][];
 };
-/**
- * Reading a tracker module.
- *
- * A capability for surface consistency — the app reaches every file format
- * through `getAppServices().io` — even though nothing about parsing is
- * platform-bound. All three implementations delegate to one shared module.
- */
-export interface TrackerCodec {
-    /** Sniffs the format from the bytes and decodes it. Throws on anything that is not one, rather than returning a garbage module that looks imported. */
-    decode(bytes: ArrayBuffer): TrackerModule;
-    /**
-     * Writes a module out, in the format `module.format` names.
-     *
-     * No sample data is written: a module is a notes format, so the slots are
-     * named and empty and the file is silent until somebody fills them. Throws
-     * for a format export does not write (`dsm`, `mptm`) rather than guessing a
-     * near neighbour.
-     */
-    encode(module: TrackerModule): ArrayBuffer;
-}
 //# sourceMappingURL=mod.d.ts.map

package/dist/formats/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../src/formats/mod.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,MAAM,CAAC;AAEzE,2GAA2G;AAC3G,MAAM,MAAM,iBAAiB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhE;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,gEAAgE;IAChE,UAAU,EAAE,MAAM,CAAC;IACnB,0FAA0F;IAC1F,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAAC;IAC5B,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,iBAAiB,EAAE,CAAC;IACjC,2FAA2F;IAC3F,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,mGAAmG;IACnG,QAAQ,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;CAC7B,CAAC"}

package/dist/formats/mod.js.map

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

package/dist/index.d.ts

@@ -28,6 +28,9 @@ export * from "./model/generation.js";
 export * from "./model/api.js";
 export * from "./model/position.js";
 export * from "./model/selection-source.js";
+export * from "./position/index.js";
+export * from "./bytes/index.js";
+export * from "./formats/index.js";
 export * from "./platform/index.js";
 export * from "./domain/pitch/pitch.js";
 export * from "./domain/pitch/transpose.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AASH,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAK5C,cAAc,qBAAqB,CAAC;AAMpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kCAAkC,CAAC;AACjD,cAAc,mCAAmC,CAAC;AAClD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kCAAkC,CAAC;AAMjD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yCAAyC,CAAC;AACxD,cAAc,qCAAqC,CAAC;AACpD,cAAc,sCAAsC,CAAC;AACrD,cAAc,oCAAoC,CAAC;AACnD,cAAc,iCAAiC,CAAC;AAChD,cAAc,oCAAoC,CAAC;AACnD,cAAc,wCAAwC,CAAC;AACvD,cAAc,sCAAsC,CAAC;AACrD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AACjD,cAAc,sCAAsC,CAAC;AACrD,cAAc,0CAA0C,CAAC;AACzD,cAAc,uCAAuC,CAAC;AACtD,cAAc,iCAAiC,CAAC;AAChD,cAAc,uCAAuC,CAAC;AAItD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,2CAA2C,CAAC;AAC1D,cAAc,iCAAiC,CAAC;AAChD,cAAc,kCAAkC,CAAC;AACjD,cAAc,wCAAwC,CAAC;AACvD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,0CAA0C,CAAC;AACzD,cAAc,mCAAmC,CAAC;AAClD,cAAc,sCAAsC,CAAC;AACrD,cAAc,uCAAuC,CAAC;AACtD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kCAAkC,CAAC;AACjD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kCAAkC,CAAC;AACjD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,wCAAwC,CAAC;AACvD,cAAc,mCAAmC,CAAC;AAClD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC;AAChD,cAAc,oCAAoC,CAAC;AACnD,cAAc,yCAAyC,CAAC;AACxD,cAAc,qCAAqC,CAAC;AACpD,cAAc,qCAAqC,CAAC;AACpD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AASH,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAQ5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AAEjC,cAAc,oBAAoB,CAAC;AAKnC,cAAc,qBAAqB,CAAC;AAMpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kCAAkC,CAAC;AACjD,cAAc,mCAAmC,CAAC;AAClD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kCAAkC,CAAC;AAMjD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yCAAyC,CAAC;AACxD,cAAc,qCAAqC,CAAC;AACpD,cAAc,sCAAsC,CAAC;AACrD,cAAc,oCAAoC,CAAC;AACnD,cAAc,iCAAiC,CAAC;AAChD,cAAc,oCAAoC,CAAC;AACnD,cAAc,wCAAwC,CAAC;AACvD,cAAc,sCAAsC,CAAC;AACrD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AACjD,cAAc,sCAAsC,CAAC;AACrD,cAAc,0CAA0C,CAAC;AACzD,cAAc,uCAAuC,CAAC;AACtD,cAAc,iCAAiC,CAAC;AAChD,cAAc,uCAAuC,CAAC;AAItD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,2CAA2C,CAAC;AAC1D,cAAc,iCAAiC,CAAC;AAChD,cAAc,kCAAkC,CAAC;AACjD,cAAc,wCAAwC,CAAC;AACvD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,0CAA0C,CAAC;AACzD,cAAc,mCAAmC,CAAC;AAClD,cAAc,sCAAsC,CAAC;AACrD,cAAc,uCAAuC,CAAC;AACtD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kCAAkC,CAAC;AACjD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kCAAkC,CAAC;AACjD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,wCAAwC,CAAC;AACvD,cAAc,mCAAmC,CAAC;AAClD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC;AAChD,cAAc,oCAAoC,CAAC;AACnD,cAAc,yCAAyC,CAAC;AACxD,cAAc,qCAAqC,CAAC;AACpD,cAAc,qCAAqC,CAAC;AACpD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC"}

package/dist/index.js

@@ -36,7 +36,16 @@ export * from "./model/api.js";
 export * from "./model/position.js";
 export * from "./model/selection-source.js";
 // ---------------------------------------------------------------------------
-// 10. Platform interfaces (implementations live in @sudobility/music_io)
+// 10. Score file-format models (codecs live in @sudobility/music_codecs)
+// ---------------------------------------------------------------------------
+// ---------------------------------------------------------------------------
+// Playhead — the one stateful service here; see position/music-position.ts
+// ---------------------------------------------------------------------------
+export * from "./position/index.js";
+export * from "./bytes/index.js";
+export * from "./formats/index.js";
+// ---------------------------------------------------------------------------
+// 11. Platform interfaces (implementations live in @sudobility/music_io)
 // ---------------------------------------------------------------------------
 export * from "./platform/index.js";
 // ---------------------------------------------------------------------------

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,8EAA8E;AAC9E,+CAA+C;AAC/C,EAAE;AACF,8EAA8E;AAC9E,sEAAsE;AACtE,iEAAiE;AACjE,8EAA8E;AAC9E,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAE5C,8EAA8E;AAC9E,yEAAyE;AACzE,8EAA8E;AAC9E,cAAc,qBAAqB,CAAC;AAEpC,8EAA8E;AAC9E,8DAA8D;AAC9D,8EAA8E;AAE9E,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kCAAkC,CAAC;AACjD,cAAc,mCAAmC,CAAC;AAClD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kCAAkC,CAAC;AAEjD,8EAA8E;AAC9E,iFAAiF;AACjF,8EAA8E;AAE9E,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yCAAyC,CAAC;AACxD,cAAc,qCAAqC,CAAC;AACpD,cAAc,sCAAsC,CAAC;AACrD,cAAc,oCAAoC,CAAC;AACnD,cAAc,iCAAiC,CAAC;AAChD,cAAc,oCAAoC,CAAC;AACnD,cAAc,wCAAwC,CAAC;AACvD,cAAc,sCAAsC,CAAC;AACrD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AACjD,cAAc,sCAAsC,CAAC;AACrD,cAAc,0CAA0C,CAAC;AACzD,cAAc,uCAAuC,CAAC;AACtD,cAAc,iCAAiC,CAAC;AAChD,cAAc,uCAAuC,CAAC;AAEtD,yEAAyE;AACzE,yCAAyC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,2CAA2C,CAAC;AAC1D,cAAc,iCAAiC,CAAC;AAChD,cAAc,kCAAkC,CAAC;AACjD,cAAc,wCAAwC,CAAC;AACvD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,0CAA0C,CAAC;AACzD,cAAc,mCAAmC,CAAC;AAClD,cAAc,sCAAsC,CAAC;AACrD,cAAc,uCAAuC,CAAC;AACtD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kCAAkC,CAAC;AACjD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kCAAkC,CAAC;AACjD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,wCAAwC,CAAC;AACvD,cAAc,mCAAmC,CAAC;AAClD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC;AAChD,cAAc,oCAAoC,CAAC;AACnD,cAAc,yCAAyC,CAAC;AACxD,cAAc,qCAAqC,CAAC;AACpD,cAAc,qCAAqC,CAAC;AACpD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/platform/index.d.ts

@@ -7,7 +7,5 @@ export * from "./audio.js";
 export * from "./playback.js";
 export * from "./xml.js";
 export * from "./file.js";
-export * from "./midi.js";
 export * from "./midi-input.js";
-export * from "./mod.js";
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/platform/index.js

@@ -7,7 +7,5 @@ export * from "./audio.js";
 export * from "./playback.js";
 export * from "./xml.js";
 export * from "./file.js";
-export * from "./midi.js";
 export * from "./midi-input.js";
-export * from "./mod.js";
 //# sourceMappingURL=index.js.map

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,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,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"}

package/dist/platform/midi-input.d.ts

@@ -1,8 +1,10 @@
 /**
  * Playing notes in from a MIDI keyboard.
  *
- * Separate from `MidiCodec`, which reads and writes `.mid` files: this is a
- * live input device, and the two have nothing in common but the word MIDI.
+ * Separate from the `.mid` file codec in `@sudobility/music_codecs`: reading a
+ * file is byte arithmetic that runs anywhere, while this is a live input
+ * device that only a platform can offer. The two have nothing in common but
+ * the word MIDI, which is why only this one is a capability.
  *
  * A capability rather than a direct Web MIDI call, for the same reason
  * playback is one: the browser has `navigator.requestMIDIAccess`, React Native

package/dist/platform/midi-input.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"midi-input.d.ts","sourceRoot":"","sources":["../../src/platform/midi-input.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,+BAA+B;AAC/B,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAElC,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;AAE/D,MAAM,MAAM,SAAS,GAAG;IACtB,yDAAyD;IACzD,WAAW,IAAI,OAAO,CAAC;IAEvB;;;;;;OAMG;IACH,WAAW,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAE1C;;;;;;OAMG;IACH,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,IAAI,CAAC;CACrE,CAAC"}
+{"version":3,"file":"midi-input.d.ts","sourceRoot":"","sources":["../../src/platform/midi-input.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,+BAA+B;AAC/B,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAElC,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;AAE/D,MAAM,MAAM,SAAS,GAAG;IACtB,yDAAyD;IACzD,WAAW,IAAI,OAAO,CAAC;IAEvB;;;;;;OAMG;IACH,WAAW,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAE1C;;;;;;OAMG;IACH,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,IAAI,CAAC;CACrE,CAAC"}

package/dist/platform/midi-input.js

@@ -1,8 +1,10 @@
 /**
  * Playing notes in from a MIDI keyboard.
  *
- * Separate from `MidiCodec`, which reads and writes `.mid` files: this is a
- * live input device, and the two have nothing in common but the word MIDI.
+ * Separate from the `.mid` file codec in `@sudobility/music_codecs`: reading a
+ * file is byte arithmetic that runs anywhere, while this is a live input
+ * device that only a platform can offer. The two have nothing in common but
+ * the word MIDI, which is why only this one is a capability.
  *
  * A capability rather than a direct Web MIDI call, for the same reason
  * playback is one: the browser has `navigator.requestMIDIAccess`, React Native

package/dist/platform/midi-input.js.map

@@ -1 +1 @@
-{"version":3,"file":"midi-input.js","sourceRoot":"","sources":["../../src/platform/midi-input.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}
+{"version":3,"file":"midi-input.js","sourceRoot":"","sources":["../../src/platform/midi-input.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}

package/dist/platform/playback.d.ts

@@ -7,7 +7,6 @@
  * things that import an audio library; everything that depends on playback
  * depends on this file instead, so the engine stays swappable and mockable.
  */
-import type { ScoreRange } from "../index.js";
 import type { RenderTrack } from "./audio.js";
 export type TransportPlaybackState = "stopped" | "playing" | "paused";
 /**
@@ -24,29 +23,6 @@ export type SoundingNote = {
     /** Its sounding MIDI pitch, so a keyboard can light a key without resolving the event. */
     midi: number;
 };
-export type PlaybackObserver = {
-    onPositionTick(tick: number): void;
-    /**
-     * The notes currently sounding, whenever that set changes.
-     *
-     * Resolved rather than bare ids. The scheduler already knows each note's
-     * track and pitch — it scheduled them — and emitting only the id forced every
-     * consumer to search the whole score to get it back: `playingPitchesForTrack`
-     * was an O(score) scan per sounding note, twenty times a second.
-     */
-    onActiveNotes(notes: SoundingNote[]): void;
-    onStateChange(state: TransportPlaybackState): void;
-    /**
-     * How far along the engine is in becoming able to make a sound.
-     *
-     * Optional because not every engine has anything to load. The soundfont
-     * engine does: tens of megabytes to fetch and several seconds for the synth
-     * to digest, all on the first press of Play. Without this the transport
-     * simply looks broken for that whole time — which is exactly how it read
-     * before there was anywhere to report it.
-     */
-    onLoadStateChange?(state: PlaybackLoadState): void;
-};
 /**
  * The engine's readiness to play, for a progress indicator.
  *
@@ -77,20 +53,6 @@ export type PlaybackTrack = RenderTrack & {
     muted: boolean;
     solo: boolean;
 };
-/**
- * A voice to audition, resolved from the GM tables **by the caller**.
- *
- * The engine cannot resolve it: a percussion voice's program addresses a drum
- * kit, and only the GM tables know which kit an arbitrary address falls in.
- * Resolving here is what lets the platform layer keep no catalogue of its own.
- */
-export type AuditionVoice = {
-    /** The kit's program on a percussion voice, the instrument's own otherwise. */
-    program: number;
-    /** The GM catalogue name for `program`. */
-    name: string;
-    isPercussion: boolean;
-};
 /** One playback-ready note, in score ticks, carrying the ids playback reports back. */
 export type PlaybackNote = {
     tick: number;
@@ -135,6 +97,15 @@ export type PerformanceTimeline = {
     segments: readonly TimelineSegment[];
     durationTicks: number;
 };
+/**
+ * The engine contract — `PlaybackEngine`, `PlaybackObserver` and
+ * `AuditionVoice` — lives in `@sudobility/music_player`, which is the only
+ * thing that implements it.
+ *
+ * The *plan* stays here, and must: `PlaybackPlan` composes `PerformanceTimeline`,
+ * which `performanceTimeline()` in `domain/score/` produces. Moving it would
+ * make this package import from music_player.
+ */
 export type PlaybackPlan = {
     tracks: readonly PlaybackTrack[];
     notes: readonly PlaybackNote[];
@@ -156,56 +127,4 @@ export type PlaybackLoadState = {
     status: "failed";
     message: string;
 };
-export interface PlaybackEngine {
-    initialize(): Promise<void>;
-    /** Adopts a plan. The engine is handed music, never a score. */
-    load(plan: PlaybackPlan): Promise<void>;
-    play(fromTick?: number): Promise<void>;
-    pause(): void;
-    stop(): void;
-    seek(tick: number): void;
-    setTempoMultiplier(multiplier: number): void;
-    setLoop(range: ScoreRange | null): void;
-    setTrackMute(trackId: string, muted: boolean): void;
-    setTrackSolo(trackId: string, solo: boolean): void;
-    /**
-     * Re-reads every track's volume, pan, mute and solo and pushes them,
-     * touching nothing that is scheduled.
-     *
-     * The mixing counterpart to `load`. Mute and solo had setters; volume and pan
-     * did not, and a track's volume was only ever read at load time — so once a
-     * mix change stopped reloading the score (the playback edit lock, see
-     * `music_lib`'s `score-slice`), moving a fader during playback moved the
-     * fader and not the sound.
-     *
-     * Takes only the tracks, so changing a gain does not rebuild every note —
-     * which is the whole reason this is separate from `load`. Idempotent, and
-     * takes them all rather than one property: the caller says "the mix changed,
-     * here it is" and does not work out which property it was.
-     */
-    applyMix(tracks: readonly PlaybackTrack[]): void;
-    /** Toggles the metronome click. */
-    setMetronome(enabled: boolean): void;
-    /** Sets overall output level, 0-1 linear gain. */
-    setMasterVolume(volume: number): void;
-    /**
-     * Sounds `midi` immediately on `program`'s voice and holds it, independent of
-     * the transport — for auditioning a key while editing.
-     *
-     * `voice.isPercussion` mirrors what playback does with a percussion-clef
-     * track: without it, tapping a note on a drum track auditioned a pitched
-     * instrument while the same note played back as a drum.
-     *
-     * Separate from `play` because the two answer different questions: `play`
-     * renders the written score along a timeline, this makes a sound *now*, for
-     * as long as the caller holds it, whether or not a score is even loaded.
-     * Implementations must not disturb transport state.
-     */
-    noteOn(midi: number, voice: AuditionVoice): void;
-    /** Releases a pitch started by `noteOn`. Silent no-op if it is not sounding. */
-    noteOff(midi: number): void;
-    /** Registers (or, with `null`, clears) the single observer receiving position/active-note/state updates. */
-    setObserver(observer: PlaybackObserver | null): void;
-    dispose(): void;
-}
 //# sourceMappingURL=playback.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"playback.d.ts","sourceRoot":"","sources":["../../src/platform/playback.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"playback.d.ts","sourceRoot":"","sources":["../../src/platform/playback.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,MAAM,sBAAsB,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEtE;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAC;IACf,kFAAkF;IAClF,OAAO,EAAE,MAAM,CAAC;IAChB,0FAA0F;IAC1F,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAGF;;;;;;GAMG;AACH;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACrC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;CACzC;AAED;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG;IACxC,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;CACf,CAAC;AAGF,uFAAuF;AACvF,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,iEAAiE;AACjE,MAAM,MAAM,cAAc,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC;AAE/D;;;;;;;GAOG;AACH,yEAAyE;AACzE,MAAM,MAAM,eAAe,GAAG;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAC;IACrC,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;IACjC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IAC/B,MAAM,EAAE,SAAS,cAAc,EAAE,CAAC;IAClC,KAAK,EAAE,eAAe,CAAC;IACvB,mEAAmE;IACnE,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,2DAA2D;IAC3D,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GACzB;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC9C;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,GACnB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/position/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./music-position.js";
+export * from "./singleton.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/position/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC"}

package/dist/position/index.js

@@ -0,0 +1,3 @@
+export * from "./music-position.js";
+export * from "./singleton.js";
+//# sourceMappingURL=index.js.map

package/dist/position/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/position/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC"}

package/dist/position/music-position.d.ts

@@ -0,0 +1,63 @@
+/**
+ * The one place that knows where playback is.
+ *
+ * **The first stateful singleton service in music_types, and deliberately so.**
+ * This package is otherwise model and primitives. The playhead earns the
+ * exception because it has exactly one writer — `@sudobility/music_player` —
+ * and readers in every other package: the caret, the note highlighting and the
+ * piano keyboard. Any other home creates a dependency edge that exists only to
+ * reach it. It still obeys the four rules this package keeps: it works on both
+ * the frontend and the backend, adds no dependency, contains no hooks and
+ * contains no async code.
+ *
+ * Implements `IMusicPosition` — see that interface for why this exists at all.
+ * The short version: the caret, the note highlighting and the piano keyboard
+ * used to derive the playhead three different ways and drifted apart under
+ * load. Now they read one number.
+ *
+ * **The smoothing lives here, not in the caret.** That is the load-bearing
+ * decision. The engine reports position about thirty times a second, and those
+ * reports arrive in clumps because they come off the audio scheduler's
+ * lookahead loop rather than a wall clock — driving anything straight off them
+ * leaves it stalled on most frames and jumping when it does move. So the
+ * playhead is dead-reckoned forward from the last report, and because that
+ * happens *inside the single source of truth*, every consumer that asks gets
+ * the same smoothed answer at the same instant. When the caret did its own
+ * dead-reckoning, it was smoothing a number nobody else was smoothing.
+ *
+ * The anchor is the engine's own clock reading, not `performance.now()` at the
+ * moment the report was handled. Anchoring on receipt folds event-loop latency
+ * into the playhead: under load the anchor is stamped late and everything
+ * derived from it lags the audio, which is exactly the drift this replaces.
+ */
+import type { IMusicPositionSource, UnsubscribePosition } from '../model/position.js';
+export declare class MusicPosition implements IMusicPositionSource {
+    private readonly listeners;
+    /** The last authoritative report, and the clock reading it belongs to. */
+    private anchorTick;
+    private anchorSeconds;
+    private playing;
+    private ticksPerSecond;
+    get isPlaying(): boolean;
+    /**
+     * The playhead now.
+     *
+     * While stopped this is exactly the last reported tick — a paused caret must
+     * not creep. While playing it is the last report projected forward by the
+     * time since it was taken, which is what makes motion even however unevenly
+     * the reports land.
+     */
+    get tick(): number;
+    report(tick: number, atSeconds?: number): void;
+    /**
+     * Update the tick rate without disturbing the anchor.
+     *
+     * Deliberately not folded into `report`: re-anchoring is `report`'s job and
+     * a rate change must not do it, or a tempo change mid-bar would restart the
+     * projection from wherever the last report left off.
+     */
+    setRate(ticksPerSecond: number): void;
+    setPlaying(playing: boolean, ticksPerSecond?: number): void;
+    subscribe(listener: (tick: number) => void): UnsubscribePosition;
+}
+//# sourceMappingURL=music-position.d.ts.map

package/dist/position/music-position.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"music-position.d.ts","sourceRoot":"","sources":["../../src/position/music-position.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,sBAAsB,CAAC;AAS9B,qBAAa,aAAc,YAAW,oBAAoB;IACxD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqC;IAE/D,0EAA0E;IAC1E,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,aAAa,CAAgB;IAErC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,cAAc,CAAK;IAE3B,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;;;;;;OAOG;IACH,IAAI,IAAI,IAAI,MAAM,CASjB;IAED,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAM9C;;;;;;OAMG;IACH,OAAO,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI;IAIrC,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI;IAY3D,SAAS,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,mBAAmB;CAIjE"}

package/dist/position/music-position.js

@@ -0,0 +1,69 @@
+/** Wall-clock seconds, monotonic where the platform offers it. */
+function nowSeconds() {
+    return typeof performance !== 'undefined'
+        ? performance.now() / 1000
+        : Date.now() / 1000;
+}
+export class MusicPosition {
+    constructor() {
+        this.listeners = new Set();
+        /** The last authoritative report, and the clock reading it belongs to. */
+        this.anchorTick = 0;
+        this.anchorSeconds = nowSeconds();
+        this.playing = false;
+        this.ticksPerSecond = 0;
+    }
+    get isPlaying() {
+        return this.playing;
+    }
+    /**
+     * The playhead now.
+     *
+     * While stopped this is exactly the last reported tick — a paused caret must
+     * not creep. While playing it is the last report projected forward by the
+     * time since it was taken, which is what makes motion even however unevenly
+     * the reports land.
+     */
+    get tick() {
+        if (!this.playing || this.ticksPerSecond <= 0)
+            return this.anchorTick;
+        const elapsed = nowSeconds() - this.anchorSeconds;
+        // Never backwards: a report that arrives late would otherwise pull the
+        // playhead back a few ticks, which reads as a stutter.
+        return Math.max(this.anchorTick, this.anchorTick + elapsed * this.ticksPerSecond);
+    }
+    report(tick, atSeconds) {
+        this.anchorTick = tick;
+        this.anchorSeconds = atSeconds ?? nowSeconds();
+        for (const listener of this.listeners)
+            listener(tick);
+    }
+    /**
+     * Update the tick rate without disturbing the anchor.
+     *
+     * Deliberately not folded into `report`: re-anchoring is `report`'s job and
+     * a rate change must not do it, or a tempo change mid-bar would restart the
+     * projection from wherever the last report left off.
+     */
+    setRate(ticksPerSecond) {
+        this.ticksPerSecond = Math.max(0, ticksPerSecond);
+    }
+    setPlaying(playing, ticksPerSecond) {
+        // Re-anchor on the transition, or the first `tick` read after resuming
+        // would project forward from however long the transport sat paused.
+        if (playing !== this.playing) {
+            this.anchorTick = this.tick;
+            this.anchorSeconds = nowSeconds();
+        }
+        this.playing = playing;
+        if (ticksPerSecond !== undefined)
+            this.ticksPerSecond = ticksPerSecond;
+        for (const listener of this.listeners)
+            listener(this.anchorTick);
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+}
+//# sourceMappingURL=music-position.js.map

package/dist/position/music-position.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"music-position.js","sourceRoot":"","sources":["../../src/position/music-position.ts"],"names":[],"mappings":"AAqCA,kEAAkE;AAClE,SAAS,UAAU;IACjB,OAAO,OAAO,WAAW,KAAK,WAAW;QACvC,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,IAAI;QAC1B,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AACxB,CAAC;AAED,MAAM,OAAO,aAAa;IAA1B;QACmB,cAAS,GAAG,IAAI,GAAG,EAA0B,CAAC;QAE/D,0EAA0E;QAClE,eAAU,GAAG,CAAC,CAAC;QACf,kBAAa,GAAG,UAAU,EAAE,CAAC;QAE7B,YAAO,GAAG,KAAK,CAAC;QAChB,mBAAc,GAAG,CAAC,CAAC;IA0D7B,CAAC;IAxDC,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,IAAI;QACN,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,cAAc,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC,UAAU,CAAC;QACtE,MAAM,OAAO,GAAG,UAAU,EAAE,GAAG,IAAI,CAAC,aAAa,CAAC;QAClD,uEAAuE;QACvE,uDAAuD;QACvD,OAAO,IAAI,CAAC,GAAG,CACb,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,UAAU,GAAG,OAAO,GAAG,IAAI,CAAC,cAAc,CAChD,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,IAAY,EAAE,SAAkB;QACrC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,IAAI,CAAC,aAAa,GAAG,SAAS,IAAI,UAAU,EAAE,CAAC;QAC/C,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS;YAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;IACxD,CAAC;IAED;;;;;;OAMG;IACH,OAAO,CAAC,cAAsB;QAC5B,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;IACpD,CAAC;IAED,UAAU,CAAC,OAAgB,EAAE,cAAuB;QAClD,uEAAuE;QACvE,oEAAoE;QACpE,IAAI,OAAO,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;YAC7B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC;YAC5B,IAAI,CAAC,aAAa,GAAG,UAAU,EAAE,CAAC;QACpC,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,cAAc,KAAK,SAAS;YAAE,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACvE,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS;YAAE,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACnE,CAAC;IAED,SAAS,CAAC,QAAgC;QACxC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC;CACF"}

package/dist/position/singleton.d.ts

@@ -0,0 +1,34 @@
+/**
+ * The music-position singleton.
+ *
+ * Same shape as the rest of the family's services (see `@sudobility/di`'s
+ * storage and network singletons): initialise once at start-up, read it
+ * everywhere, reset it in tests.
+ *
+ * A singleton because the playhead *is* global to a running transport — there
+ * is one piece of music playing, and the whole point of this type is that
+ * everything following it reads the same number. Two instances would
+ * reintroduce exactly the disagreement it exists to prevent.
+ */
+import type { IMusicPosition, IMusicPositionSource } from '../model/position.js';
+/**
+ * Creates the singleton if it does not exist.
+ *
+ * Idempotent, so a second call from a re-mounting composition root does not
+ * silently swap the playhead out from under everything subscribed to it.
+ */
+export declare function initializeMusicPosition(override?: IMusicPositionSource): IMusicPositionSource;
+/**
+ * The writable playhead, for whatever is driving the transport.
+ *
+ * Auto-initialises rather than throwing: unlike a storage service there is no
+ * configuration to get wrong, and a playhead that refuses to exist until
+ * somebody remembers a start-up call is a worse failure than one that starts
+ * at zero.
+ */
+export declare function getMusicPositionSource(): IMusicPositionSource;
+/** The read-only playhead, for anything that follows the music. */
+export declare function getMusicPosition(): IMusicPosition;
+/** Drops the singleton. Tests only — a suite must not inherit the last one's playhead. */
+export declare function resetMusicPosition(): void;
+//# sourceMappingURL=singleton.d.ts.map

package/dist/position/singleton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"singleton.d.ts","sourceRoot":"","sources":["../../src/position/singleton.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAK9B;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,CAAC,EAAE,oBAAoB,GAC9B,oBAAoB,CAGtB;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,IAAI,oBAAoB,CAE7D;AAED,mEAAmE;AACnE,wBAAgB,gBAAgB,IAAI,cAAc,CAEjD;AAED,0FAA0F;AAC1F,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}

package/dist/position/singleton.js

@@ -0,0 +1,33 @@
+import { MusicPosition } from './music-position.js';
+let instance = null;
+/**
+ * Creates the singleton if it does not exist.
+ *
+ * Idempotent, so a second call from a re-mounting composition root does not
+ * silently swap the playhead out from under everything subscribed to it.
+ */
+export function initializeMusicPosition(override) {
+    if (!instance)
+        instance = override ?? new MusicPosition();
+    return instance;
+}
+/**
+ * The writable playhead, for whatever is driving the transport.
+ *
+ * Auto-initialises rather than throwing: unlike a storage service there is no
+ * configuration to get wrong, and a playhead that refuses to exist until
+ * somebody remembers a start-up call is a worse failure than one that starts
+ * at zero.
+ */
+export function getMusicPositionSource() {
+    return initializeMusicPosition();
+}
+/** The read-only playhead, for anything that follows the music. */
+export function getMusicPosition() {
+    return initializeMusicPosition();
+}
+/** Drops the singleton. Tests only — a suite must not inherit the last one's playhead. */
+export function resetMusicPosition() {
+    instance = null;
+}
+//# sourceMappingURL=singleton.js.map

package/dist/position/singleton.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"singleton.js","sourceRoot":"","sources":["../../src/position/singleton.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,IAAI,QAAQ,GAAgC,IAAI,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CACrC,QAA+B;IAE/B,IAAI,CAAC,QAAQ;QAAE,QAAQ,GAAG,QAAQ,IAAI,IAAI,aAAa,EAAE,CAAC;IAC1D,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO,uBAAuB,EAAE,CAAC;AACnC,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,gBAAgB;IAC9B,OAAO,uBAAuB,EAAE,CAAC;AACnC,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,kBAAkB;IAChC,QAAQ,GAAG,IAAI,CAAC;AAClB,CAAC"}

package/package.json

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"midi.d.ts","sourceRoot":"","sources":["../../src/platform/midi.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AACF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AACF,MAAM,MAAM,cAAc,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAC5D,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB;;;;;OAKG;IACH,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAC;IACpD,aAAa,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,MAAM,EAAE;QACN,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,cAAc,EAAE,CAAC;QACzB,cAAc,EAAE,sBAAsB,EAAE,CAAC;KAC1C,CAAC;IACF,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,QAAQ,CAAC;IACpC,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,CAAC;CACpC"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../src/platform/mod.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,MAAM,CAAC;AAEzE,2GAA2G;AAC3G,MAAM,MAAM,iBAAiB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhE;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,gEAAgE;IAChE,UAAU,EAAE,MAAM,CAAC;IACnB,0FAA0F;IAC1F,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAAC;IAC5B,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,iBAAiB,EAAE,CAAC;IACjC,2FAA2F;IAC3F,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,mGAAmG;IACnG,QAAQ,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;CAC7B,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,uJAAuJ;IACvJ,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,aAAa,CAAC;IAC1C;;;;;;;OAOG;IACH,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,WAAW,CAAC;CAC5C"}

package/dist/platform/mod.js.map

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