@sudobility/music_types 0.13.25 → 0.13.27

package/dist/domain/notation/picker-options.js

@@ -17,7 +17,18 @@
  * "nothing chosen" (Radix refuses it outright, and the native `Select` behaves
  * the same way).
  */
-import { ACCIDENTALS, ARTICULATIONS, BARLINE_STYLES, DYNAMICS, ORNAMENTS, } from "../../index.js";
+/*
+ * Imported from `model/score.js`, which declares them, and deliberately NOT
+ * from the package barrel. A module that reads a *value* out of `index.js`
+ * joins a cycle with everything the barrel re-exports — and the option lists
+ * below are built while this module loads, so the read happens at
+ * module-evaluation time, which is where such a cycle throws. That is what made
+ * `music-vocabulary.js` unimportable as an entry point: it reaches this module,
+ * this module pulled in the whole barrel, and `style-presets.js` then built its
+ * table from a `SONG_SECONDS` that `music-vocabulary` had not defined yet.
+ * Import the declaring module, never the barrel.
+ */
+import { ACCIDENTALS, ARTICULATIONS, BARLINE_STYLES, CLEFS, DYNAMICS, ORNAMENTS, } from "../../model/score.js";
 /** "No marking here", distinct from a marking that happens to be quiet. */
 export const NO_MARK = "none";
 /**
@@ -54,7 +65,7 @@ export const ACCIDENTAL_OPTIONS = ACCIDENTALS.map((value) => ({ value, labelKey:
 /** Dynamics, with "no dynamic" first. A level is not a loudness of zero. */
 export const DYNAMIC_OPTIONS = [
     { value: NO_MARK, labelKey: "inspector.noDynamic" },
-    ...DYNAMICS.map((value) => ({ value, labelKey: `dynamic.${value}` })),
+    ...DYNAMICS.map((value) => ({ value })),
 ];
 /**
  * The grids a MIDI import may be quantized onto, coarsest first.
@@ -127,4 +138,32 @@ export const KEY_MODE_OPTIONS = ["major", "minor"].map((value) => ({
     value,
     labelKey: `key.${value}`,
 }));
+/**
+ * The word for each clef.
+ *
+ * Every clef picker used to print the model's own token — `treble`, `bass` — so
+ * a reader chose a clef in lower-case English whatever their language. Both
+ * apps then fixed that the same way and each kept its own copy of this table,
+ * which is exactly the drift this file exists to prevent: a `Record`, so a
+ * sixth clef fails to compile here rather than printing its token in somebody's
+ * picker.
+ *
+ * Published as the record *and* as the options below, because both shapes are
+ * in use: the Bar tab names the clef *in force* ("carry on with Treble"), which
+ * is one lookup rather than a list.
+ */
+export const CLEF_LABEL_KEY = {
+    treble: "clef.treble",
+    bass: "clef.bass",
+    alto: "clef.alto",
+    tenor: "clef.tenor",
+    percussion: "clef.percussion",
+};
+/**
+ * Every clef, in the model's order.
+ *
+ * There is no "none" here: a stave always has a clef, so the absence a *bar*
+ * can express is `INHERIT_CLEF`, which the Bar tab prepends itself.
+ */
+export const CLEF_OPTIONS = CLEFS.map((value) => ({ value, labelKey: CLEF_LABEL_KEY[value] }));
 //# sourceMappingURL=picker-options.js.map

package/dist/domain/notation/picker-options.js.map

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

package/dist/domain/notation/toolbar-icons.d.ts

@@ -3,7 +3,7 @@
  *
  * The shapes are `NOTATION_ICONS` (generated, next door); this is the part
  * both toolbars had each written out as a list — note value to glyph,
- * accidental to glyph, edit mode to glyph — and that agreed only because
+ * accidental to glyph — and that agreed only because
  * nobody had redrawn one. Records keyed by the vocabulary, never parallel
  * arrays, so a sixth accidental or a seventh base duration fails to compile
  * here instead of drawing nothing in one app.
@@ -18,19 +18,4 @@ import type { NotationIconName } from "./notation-icon-art.js";
 export declare const DURATION_ICON: Record<BaseDuration, NotationIconName>;
 /** The glyph for each accidental. */
 export declare const ACCIDENTAL_ICON: Record<Accidental, NotationIconName>;
-/**
- * What a click on a stave does to music already there, in toolbar order.
- *
- * The value is spelled as music_editing's `EditMode` spells it; the type is
- * not imported from there because this package may not depend on it. Stack's
- * hint has a second form, `editor.stackModeUnavailable`, for a track whose
- * instrument cannot play a chord — that depends on the track, so the app picks
- * it.
- */
-export declare const EDIT_MODE_OPTIONS: ReadonlyArray<{
-    value: "insert" | "replace" | "stack";
-    icon: NotationIconName;
-    labelKey: string;
-    hintKey: string;
-}>;
 //# sourceMappingURL=toolbar-icons.d.ts.map

package/dist/domain/notation/toolbar-icons.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toolbar-icons.d.ts","sourceRoot":"","sources":["../../../src/domain/notation/toolbar-icons.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,6CAA6C;AAC7C,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,YAAY,EAAE,gBAAgB,CAOhE,CAAC;AAEF,qCAAqC;AACrC,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,UAAU,EAAE,gBAAgB,CAMhE,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,EAAE,aAAa,CAAC;IAC5C,KAAK,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;IACtC,IAAI,EAAE,gBAAgB,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB,CAmBA,CAAC"}
+{"version":3,"file":"toolbar-icons.d.ts","sourceRoot":"","sources":["../../../src/domain/notation/toolbar-icons.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,6CAA6C;AAC7C,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,YAAY,EAAE,gBAAgB,CAOhE,CAAC;AAEF,qCAAqC;AACrC,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,UAAU,EAAE,gBAAgB,CAMhE,CAAC"}

package/dist/domain/notation/toolbar-icons.js

@@ -15,33 +15,4 @@ export const ACCIDENTAL_ICON = {
     [1]: "SharpIcon",
     [2]: "DoubleSharpIcon",
 };
-/**
- * What a click on a stave does to music already there, in toolbar order.
- *
- * The value is spelled as music_editing's `EditMode` spells it; the type is
- * not imported from there because this package may not depend on it. Stack's
- * hint has a second form, `editor.stackModeUnavailable`, for a track whose
- * instrument cannot play a chord — that depends on the track, so the app picks
- * it.
- */
-export const EDIT_MODE_OPTIONS = [
-    {
-        value: "insert",
-        icon: "InsertModeIcon",
-        labelKey: "editor.insertMode",
-        hintKey: "editor.insertModeHint",
-    },
-    {
-        value: "replace",
-        icon: "ReplaceModeIcon",
-        labelKey: "editor.replaceMode",
-        hintKey: "editor.replaceModeHint",
-    },
-    {
-        value: "stack",
-        icon: "ChordIcon",
-        labelKey: "editor.stackMode",
-        hintKey: "editor.stackModeHint",
-    },
-];
 //# sourceMappingURL=toolbar-icons.js.map

package/dist/domain/notation/toolbar-icons.js.map

@@ -1 +1 @@
-{"version":3,"file":"toolbar-icons.js","sourceRoot":"","sources":["../../../src/domain/notation/toolbar-icons.ts"],"names":[],"mappings":"AAiBA,6CAA6C;AAC7C,MAAM,CAAC,MAAM,aAAa,GAA2C;IACnE,KAAK,EAAE,eAAe;IACtB,IAAI,EAAE,cAAc;IACpB,OAAO,EAAE,iBAAiB;IAC1B,MAAM,EAAE,gBAAgB;IACxB,SAAS,EAAE,mBAAmB;IAC9B,YAAY,EAAE,sBAAsB;CACrC,CAAC;AAEF,qCAAqC;AACrC,MAAM,CAAC,MAAM,eAAe,GAAyC;IACnE,CAAC,CAAC,CAAC,CAAC,EAAE,gBAAgB;IACtB,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU;IAChB,CAAC,CAAC,CAAC,EAAE,aAAa;IAClB,CAAC,CAAC,CAAC,EAAE,WAAW;IAChB,CAAC,CAAC,CAAC,EAAE,iBAAiB;CACvB,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAKzB;IACH;QACE,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,gBAAgB;QACtB,QAAQ,EAAE,mBAAmB;QAC7B,OAAO,EAAE,uBAAuB;KACjC;IACD;QACE,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,iBAAiB;QACvB,QAAQ,EAAE,oBAAoB;QAC9B,OAAO,EAAE,wBAAwB;KAClC;IACD;QACE,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,WAAW;QACjB,QAAQ,EAAE,kBAAkB;QAC5B,OAAO,EAAE,sBAAsB;KAChC;CACF,CAAC"}
+{"version":3,"file":"toolbar-icons.js","sourceRoot":"","sources":["../../../src/domain/notation/toolbar-icons.ts"],"names":[],"mappings":"AAiBA,6CAA6C;AAC7C,MAAM,CAAC,MAAM,aAAa,GAA2C;IACnE,KAAK,EAAE,eAAe;IACtB,IAAI,EAAE,cAAc;IACpB,OAAO,EAAE,iBAAiB;IAC1B,MAAM,EAAE,gBAAgB;IACxB,SAAS,EAAE,mBAAmB;IAC9B,YAAY,EAAE,sBAAsB;CACrC,CAAC;AAEF,qCAAqC;AACrC,MAAM,CAAC,MAAM,eAAe,GAAyC;IACnE,CAAC,CAAC,CAAC,CAAC,EAAE,gBAAgB;IACtB,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU;IAChB,CAAC,CAAC,CAAC,EAAE,aAAa;IAClB,CAAC,CAAC,CAAC,EAAE,WAAW;IAChB,CAAC,CAAC,CAAC,EAAE,iBAAiB;CACvB,CAAC"}

package/dist/domain/score/transport-settings.d.ts

@@ -0,0 +1,29 @@
+/**
+ * The transport settings a store keeps beside a player, and how binding one
+ * can fail — as vocabulary. The binder itself (`bindPlayer`) and the defaults
+ * are music_lib's.
+ */
+import type { ScoreRange } from "../../model/score.js";
+import type { PlaybackLoadState } from "../../platform/playback.js";
+/**
+ * Transport settings the binder keeps in the store beside the player.
+ *
+ * In the store so a transport bar can render them; beside the player because
+ * the player is what obeys them. **Optional on an editing store**: music_lib's
+ * playback slice and its document store carry all five, while a bare editing
+ * store carries none — the binder writes them into whichever store it is
+ * given.
+ */
+export type TransportSettings = {
+    loopRange: ScoreRange | null;
+    tempoMultiplier: number;
+    metronome: boolean;
+    masterVolume: number;
+    synthLoad: PlaybackLoadState;
+};
+/**
+ * What went wrong binding a player, as a kind rather than a sentence — no
+ * library holds words. The host turns it into its own toast.
+ */
+export type PlayerFailure = "scoreLoadFailed" | "playbackFailed";
+//# sourceMappingURL=transport-settings.d.ts.map

package/dist/domain/score/transport-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-settings.d.ts","sourceRoot":"","sources":["../../../src/domain/score/transport-settings.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEpE;;;;;;;;GAQG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,EAAE,UAAU,GAAG,IAAI,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,iBAAiB,CAAC;CAC9B,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,iBAAiB,GAAG,gBAAgB,CAAC"}

package/dist/domain/score/transport-settings.js

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

package/dist/domain/score/transport-settings.js.map

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

package/dist/formats/audio-import.d.ts

@@ -0,0 +1,15 @@
+/**
+ * What a recording import accepts.
+ *
+ * The file goes to the server, which separates and transcribes it — nothing is
+ * decoded on the device — so these name the upload: which files to offer and
+ * what MIME type each is sent as. Vocabulary only, and so declared here; the
+ * helpers that read a file name (`audioMimeFor`, `isLongAudio`) are about
+ * files and live in `@sudobility/music_io`.
+ */
+/** The formats offered by the file picker, which the transcriber decodes. */
+export declare const AUDIO_IMPORT_EXTENSIONS: readonly ["wav", "mp3", "mpa", "m4a", "aac"];
+export type AudioImportExtension = (typeof AUDIO_IMPORT_EXTENSIONS)[number];
+/** MIME types by extension. React Native will not infer one for an upload. */
+export declare const AUDIO_MIME: Record<AudioImportExtension, string>;
+//# sourceMappingURL=audio-import.d.ts.map

package/dist/formats/audio-import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-import.d.ts","sourceRoot":"","sources":["../../src/formats/audio-import.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,6EAA6E;AAC7E,eAAO,MAAM,uBAAuB,8CAM1B,CAAC;AACX,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5E,8EAA8E;AAC9E,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,oBAAoB,EAAE,MAAM,CAM3D,CAAC"}

package/dist/formats/audio-import.js

@@ -0,0 +1,26 @@
+/**
+ * What a recording import accepts.
+ *
+ * The file goes to the server, which separates and transcribes it — nothing is
+ * decoded on the device — so these name the upload: which files to offer and
+ * what MIME type each is sent as. Vocabulary only, and so declared here; the
+ * helpers that read a file name (`audioMimeFor`, `isLongAudio`) are about
+ * files and live in `@sudobility/music_io`.
+ */
+/** The formats offered by the file picker, which the transcriber decodes. */
+export const AUDIO_IMPORT_EXTENSIONS = [
+    "wav",
+    "mp3",
+    "mpa",
+    "m4a",
+    "aac",
+];
+/** MIME types by extension. React Native will not infer one for an upload. */
+export const AUDIO_MIME = {
+    wav: "audio/wav",
+    mp3: "audio/mpeg",
+    mpa: "audio/mpeg",
+    m4a: "audio/mp4",
+    aac: "audio/aac",
+};
+//# sourceMappingURL=audio-import.js.map

package/dist/formats/audio-import.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-import.js","sourceRoot":"","sources":["../../src/formats/audio-import.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,6EAA6E;AAC7E,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;CACG,CAAC;AAGX,8EAA8E;AAC9E,MAAM,CAAC,MAAM,UAAU,GAAyC;IAC9D,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,YAAY;IACjB,GAAG,EAAE,YAAY;IACjB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,WAAW;CACjB,CAAC"}

package/dist/formats/index.d.ts

@@ -9,4 +9,14 @@
  */
 export * from "./midi.js";
 export * from "./mod.js";
+/**
+ * What the codecs are asked and answer: import options and results, the MIDI
+ * wizard's summary, the MusicXML warning contract and the tracker fit report.
+ * Types and vocabulary only — the codecs themselves are music_codecs'.
+ */
+export * from "./midi-import.js";
+export * from "./musicxml.js";
+export * from "./tracker-export.js";
+/** The recordings the audio import offers, and the MIME type each uploads as. */
+export * from "./audio-import.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/formats/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AAEzB;;;;GAIG;AACH,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AAEpC,iFAAiF;AACjF,cAAc,mBAAmB,CAAC"}

package/dist/formats/index.js

@@ -9,4 +9,14 @@
  */
 export * from "./midi.js";
 export * from "./mod.js";
+/**
+ * What the codecs are asked and answer: import options and results, the MIDI
+ * wizard's summary, the MusicXML warning contract and the tracker fit report.
+ * Types and vocabulary only — the codecs themselves are music_codecs'.
+ */
+export * from "./midi-import.js";
+export * from "./musicxml.js";
+export * from "./tracker-export.js";
+/** The recordings the audio import offers, and the MIME type each uploads as. */
+export * from "./audio-import.js";
 //# sourceMappingURL=index.js.map

package/dist/formats/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/formats/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/formats/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AAEzB;;;;GAIG;AACH,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AAEpC,iFAAiF;AACjF,cAAc,mBAAmB,CAAC"}

package/dist/formats/midi-import.d.ts

@@ -0,0 +1,128 @@
+/**
+ * The shapes a MIDI import is described in: the read-only summary the import
+ * wizard opens with, the options it writes, and what an import returns.
+ *
+ * Types only. The analysis and the importer that produce and consume them live
+ * in `@sudobility/music_codecs`, which decodes MIDI on both sides of the
+ * network; the form rules that edit the options live in music_lib. Both apps
+ * name these shapes, so they are declared once here.
+ */
+import type { Clef, DurationName, Score, TimeSignature } from "../model/score.js";
+export type MidiTrackSummary = {
+    index: number;
+    name: string;
+    channel: number;
+    program: number;
+    instrumentName: string;
+    noteCount: number;
+    durationSeconds: number;
+    /** True when the track's channel is 9 (GM channel 10), the standard percussion channel. */
+    isPercussion: boolean;
+    /** Mean MIDI note number of the track's notes, or `null` if it has none — used to default a target clef. */
+    averageMidi: number | null;
+};
+export type MidiTempoEventSummary = {
+    tick: number;
+    bpm: number;
+};
+export type MidiTimeSignatureSummary = {
+    tick: number;
+    numerator: number;
+    denominator: number;
+};
+/**
+ * The grid a MIDI file's onsets already sit on.
+ *
+ * Detected rather than assumed: import used to snap every file to a fixed
+ * sixteenth grid, which turns an even eighth-note triplet into a limping
+ * dotted-sixteenth figure. See `grid-detection.ts` in music_codecs.
+ */
+export type DetectedGrid = {
+    grid: DurationName | null;
+    /** Triplet subdivision of `grid` — 2/3 of it, matching `quantize`'s `tripletGrid`. */
+    triplet: boolean;
+};
+/**
+ * Read-only summary of a raw MIDI file, for the import wizard (spec §15):
+ * per-track name/channel/program/note-count/duration, tempo events, and
+ * time signatures, without importing anything into the score model yet.
+ */
+export type MidiSummary = {
+    ppq: number;
+    durationSeconds: number;
+    tracks: MidiTrackSummary[];
+    tempoEvents: MidiTempoEventSummary[];
+    timeSignatures: MidiTimeSignatureSummary[];
+    /**
+     * The grid the file's onsets already sit on, which the wizard opens
+     * pre-filled with. Detected rather than assumed so that importing a file
+     * written in triplets or swing does not snap it onto a straight grid — see
+     * `grid-detection.ts`.
+     */
+    detectedGrid: DetectedGrid;
+};
+export type MidiTrackSelection = {
+    sourceIndex: number;
+    include: boolean;
+    clef: Clef;
+    name: string;
+};
+/**
+ * MIDI import wizard options (spec §15): what to include, how to clean up
+ * performance timing, and how to lay tracks out on staves.
+ * `defaultMidiImportOptions` in music_codecs derives starting values from a
+ * `MidiSummary` so the wizard can open pre-filled.
+ */
+export type MidiImportOptions = {
+    trackSelections: MidiTrackSelection[];
+    /** Quantization grid value (spec §15's "whole" .. "sixteenth triplet" list); `null` skips start/duration quantization entirely. */
+    quantizeGrid: DurationName | null;
+    /** Use a triplet subdivision of `quantizeGrid` when quantizing. */
+    tripletDetection: boolean;
+    /** Notes shorter than this (at 480 ppq) are dropped as accidental/ornamental noise; `1` preserves every representable note. */
+    minDurationTicks: number;
+    /** Cluster near-simultaneous onsets within a small tolerance onto a shared start tick. */
+    mergeNearDuplicates: boolean;
+    /** `"extend"` lengthens notes to the sustain-pedal release point; `"ignore"` uses raw note-off timing. */
+    sustainPedal: "extend" | "ignore";
+    /** Split a single MIDI track into two linked grand-staff tracks ("Piano RH"/"Piano LH") instead of one track on `defaultClefFor`'s guessed clef. */
+    pianoStaffSplit: boolean;
+    /** MIDI note number at/above which a note is placed on the upper (RH/treble) staff when `pianoStaffSplit` is set. */
+    splitPointMidi: number;
+    /** Estimate a key signature from the included tracks' notes (Krumhansl-style) instead of defaulting to C major. */
+    detectKey: boolean;
+};
+/**
+ * A change to the options: any plain field, and optionally one track's row,
+ * addressed by its `sourceIndex` — the track's index in the file, which is
+ * what the wizard's rows are keyed by. Position in `trackSelections` is not
+ * the same thing once a file has empty tracks.
+ */
+export type MidiImportPatch = Partial<Omit<MidiImportOptions, "trackSelections" | "splitPointMidi" | "minDurationTicks">> & {
+    /**
+     * The two number fields take `null` for a **cleared** field, which is what
+     * `parseNumericDraft(text)` answers for empty text.
+     *
+     * Not `Number(text)`: that reads an emptied field as 0, so clearing the split
+     * point to type a new one moved the split to the lowest note there is — the
+     * same class of bug as the `|| 60` this replaces, from the other direction.
+     */
+    splitPointMidi?: number | null;
+    minDurationTicks?: number | null;
+    track?: Pick<MidiTrackSelection, "sourceIndex"> & Partial<Pick<MidiTrackSelection, "include" | "clef">>;
+};
+export type MidiImportResult = {
+    score: Score;
+    warnings: string[];
+};
+export type TimeSignatureChange = {
+    tick: number;
+    timeSignature: TimeSignature;
+};
+export type MeasureSpan = {
+    index: number;
+    startTick: number;
+    durationTicks: number;
+    timeSignature: TimeSignature;
+};
+//# sourceMappingURL=midi-import.d.ts.map

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

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

package/dist/formats/midi-import.js

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

package/dist/formats/midi-import.js.map

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

package/dist/formats/musicxml.d.ts

@@ -0,0 +1,44 @@
+/**
+ * The shapes a MusicXML import is described in.
+ *
+ * Types only; the importer lives in `@sudobility/music_codecs`. The warning
+ * catalogue is a contract the host fills in — each app hands over a translated
+ * sentence per key — so it is declared here, where both the importer and the
+ * hosts that satisfy it can name it without either depending on the other.
+ */
+import type { Score } from "../model/score.js";
+/**
+ * Every warning the MusicXML importer can raise, in the caller's words.
+ *
+ * Functions where the warning names something it found — a clef, a tag, a
+ * tempo — so the host can put the value where its own grammar wants it rather
+ * than having English word order baked in by the importer.
+ *
+ * Every key must have a call site in the importer: music_codecs'
+ * `warning-contract.test.ts` fails on one that cannot fire.
+ */
+export type MusicXmlWarnings = {
+    unsupportedClef: (sign: string, line: number) => string;
+    unsupportedKeyMode: (mode: string) => string;
+    unsupportedTime: (measureNumber: number) => string;
+    complexTimeSignature: string;
+    unsupportedPitchStep: (step: string) => string;
+    alterRounded: (alter: string, clamped: number) => string;
+    unsupportedNotation: (tag: string) => string;
+    unsupportedNoteElement: (tag: string) => string;
+    unsupportedArticulation: (tag: string) => string;
+    multipleArticulations: string;
+    unpitched: string;
+    noPitchOrRest: string;
+    noDuration: string;
+    nonPositiveDuration: string;
+    noteTrimmed: string;
+    unsupportedMeasureElement: (tag: string) => string;
+    noTempo: (defaultBpm: number) => string;
+    tempoClamped: (bpm: number, min: number, max: number, clamped: number) => string;
+};
+export type MusicXmlImportResult = {
+    score: Score;
+    warnings: string[];
+};
+//# sourceMappingURL=musicxml.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"musicxml.d.ts","sourceRoot":"","sources":["../../src/formats/musicxml.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C;;;;;;;;;GASG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACxD,kBAAkB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC7C,eAAe,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,MAAM,CAAC;IACnD,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oBAAoB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC/C,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IACzD,mBAAmB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IAC7C,sBAAsB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IAChD,uBAAuB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IACjD,qBAAqB,EAAE,MAAM,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,yBAAyB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IACnD,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,CAAC;IACxC,YAAY,EAAE,CACZ,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,KACZ,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC"}

package/dist/formats/musicxml.js

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

package/dist/formats/musicxml.js.map

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

package/dist/formats/tracker-export.d.ts

@@ -0,0 +1,55 @@
+/**
+ * The shapes a tracker export is described in: which formats can be written,
+ * what each can hold, and what an export lost.
+ *
+ * Types and vocabulary only. `TRACKER_LIMITS` (the numbers, anchored to our own
+ * decoder) and the exporter itself live in `@sudobility/music_codecs`.
+ */
+import type { TrackerModule } from "./mod.js";
+/** The formats export can write. A subset of `TrackerFormat`, which import also covers. */
+export type WritableTrackerFormat = "mod" | "s3m" | "xm" | "it";
+export type TrackerLimits = {
+    channels: number;
+    instruments: number;
+    /** Inclusive MIDI note range this format can express. */
+    lowestMidi: number;
+    highestMidi: number;
+};
+export type TrackerExportOptions = {
+    format: WritableTrackerFormat;
+    /** Rows per quarter note. 4 gives sixteenths and cannot express triplets. */
+    rowsPerBeat?: number;
+};
+/**
+ * What an export lost. **Everything lossy is counted, never hidden**: a
+ * tracker row grid, a channel count and a three-octave range are all narrower
+ * than a score, and the app shows these counts before writing.
+ */
+export type TrackerFitReport = {
+    /** Notes moved into range. */
+    clampedNotes: number;
+    /** Voices that did not fit the format's channel count. */
+    droppedVoices: number;
+    /** Notes shorter than one row, lost to the grid. */
+    droppedShortNotes: number;
+    /** Notes whose start moved to land on a row. */
+    quantisedNotes: number;
+};
+export type TrackerExportResult = {
+    module: TrackerModule;
+    report: TrackerFitReport;
+};
+/**
+ * What this export actually lost, as a list something can be said about.
+ *
+ * Each entry names a *kind* of loss. Which kinds exist, and the order a reader
+ * should meet them in, is a fact about the format rather than about a dialog —
+ * so every app that shows a fit report shows the same four in the same order
+ * (`trackerFitLosses` in music_codecs omits the zero counts).
+ *
+ * The strings are keys, not prose: the count has to pluralise in the reader's
+ * own language, which appending an "s" does not do.
+ */
+export declare const TRACKER_FIT_LOSSES: readonly ["clampedNotes", "droppedVoices", "droppedShortNotes", "quantisedNotes"];
+export type TrackerFitLoss = (typeof TRACKER_FIT_LOSSES)[number];
+//# sourceMappingURL=tracker-export.d.ts.map

package/dist/formats/tracker-export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracker-export.d.ts","sourceRoot":"","sources":["../../src/formats/tracker-export.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,2FAA2F;AAC3F,MAAM,MAAM,qBAAqB,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,GAAG,IAAI,CAAC;AAEhE,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,qBAAqB,CAAC;IAC9B,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,8BAA8B;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,aAAa,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gDAAgD;IAChD,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,gBAAgB,CAAC;CAC1B,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,mFAKyB,CAAC;AAEzD,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/formats/tracker-export.js

@@ -0,0 +1,18 @@
+/**
+ * What this export actually lost, as a list something can be said about.
+ *
+ * Each entry names a *kind* of loss. Which kinds exist, and the order a reader
+ * should meet them in, is a fact about the format rather than about a dialog —
+ * so every app that shows a fit report shows the same four in the same order
+ * (`trackerFitLosses` in music_codecs omits the zero counts).
+ *
+ * The strings are keys, not prose: the count has to pluralise in the reader's
+ * own language, which appending an "s" does not do.
+ */
+export const TRACKER_FIT_LOSSES = [
+    "clampedNotes",
+    "droppedVoices",
+    "droppedShortNotes",
+    "quantisedNotes",
+];
+//# sourceMappingURL=tracker-export.js.map

package/dist/formats/tracker-export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracker-export.js","sourceRoot":"","sources":["../../src/formats/tracker-export.ts"],"names":[],"mappings":"AA+CA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,cAAc;IACd,eAAe;IACf,mBAAmB;IACnB,gBAAgB;CACsC,CAAC"}

package/dist/index.d.ts

@@ -78,6 +78,7 @@ export * from "./domain/instruments/gm-transposition.js";
 export * from "./domain/instruments/gm-percussion.js";
 export * from "./domain/generation/style-presets.js";
 export * from "./domain/generation/option-order.js";
+export * from "./domain/documents/project-file.js";
 export * from "./domain/generation/score-presets.js";
 export * from "./domain/selection/selection.js";
 export * from "./services/regeneration/controller.js";
@@ -97,7 +98,6 @@ export * from "./domain/notation/toolbar-icons.js";
 export * from "./domain/score/transport-readouts.js";
 export * from "./domain/instruments/instrument-menus.js";
 export * from "./domain/instruments/instrument-reference.js";
-export * from "./domain/generation/credits.js";
 export * from "./domain/score/articulation.js";
 export * from "./domain/score/bar-numbers.js";
 export * from "./domain/score/collapse-rests.js";
@@ -130,4 +130,27 @@ export * from "./domain/time/tuplets.js";
  * Generated; see the module header.
  */
 export * from "./domain/notation/notation-icon-art.js";
+export * from "./domain/instruments/out-of-range.js";
+export * from "./domain/documents/document-state.js";
+export * from "./domain/documents/export-formats.js";
+export * from "./domain/documents/formats.js";
+export * from "./domain/documents/publish.js";
+export * from "./domain/documents/templates.js";
+export * from "./domain/generation/request-drafts.js";
+export * from "./domain/generation/replace-drafts.js";
+export * from "./domain/score/transport-settings.js";
+export * from "./domain/editor/app-errors.js";
+export * from "./domain/editor/context-menu.js";
+export * from "./domain/editor/device-prefs.js";
+export * from "./domain/editor/docs.js";
+export * from "./domain/editor/edit-mode.js";
+export * from "./domain/editor/editing-copy.js";
+export * from "./domain/editor/inspector.js";
+export * from "./domain/editor/labelled-option.js";
+export * from "./domain/editor/library-copy.js";
+export * from "./domain/editor/print.js";
+export * from "./domain/editor/score-input.js";
+export * from "./domain/editor/toast.js";
+export * from "./domain/editor/toolbar.js";
+export * from "./domain/editor/view-settings.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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