@sudobility/music_types 0.13.26 → 0.13.27

package/dist/domain/editor/labelled-option.d.ts

@@ -0,0 +1,6 @@
+/** One entry of a picker: the value it sets and the text it shows (see `labelledOptions` in music_lib). */
+export type LabelledOption<T extends string> = {
+    value: T;
+    label: string;
+};
+//# sourceMappingURL=labelled-option.d.ts.map

package/dist/domain/editor/labelled-option.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"labelled-option.d.ts","sourceRoot":"","sources":["../../../src/domain/editor/labelled-option.ts"],"names":[],"mappings":"AAAA,2GAA2G;AAC3G,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,MAAM,IAAI;IAAE,KAAK,EAAE,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/domain/editor/labelled-option.js

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

package/dist/domain/editor/labelled-option.js.map

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

package/dist/domain/editor/library-copy.d.ts

@@ -0,0 +1,61 @@
+/**
+ * The words the frontend libraries need, as contracts a host fills in.
+ *
+ * No library in this family holds strings in any language. Each app hands over
+ * its sentences — music_lib's `createLibraryCopy(t)` builds every table from a
+ * translate function — and these are the shapes of those tables.
+ */
+import type { SelectionSummaryCopy } from "../selection/selection.js";
+import type { MusicXmlWarnings } from "../../formats/musicxml.js";
+import type { TemplateCopy } from "../documents/templates.js";
+import type { EditingCopy } from "./editing-copy.js";
+/**
+ * The messages music_lib raises from long-lived internals — an autosave, the
+ * playback adapter, a signed-out call.
+ *
+ * **Every entry is a function, resolved at the moment the message is needed.**
+ * They used to be plain strings, captured when the host called
+ * `setLibraryMessages` — which strands whatever language was loaded at
+ * start-up, so a reader who switches to Chinese goes on getting English
+ * toasts. `EditingCopy` already learned this and passes `commandLabel` as a
+ * resolver for the same reason. The shape stays an object with a field per
+ * message rather than a single `(key) => string`, because a record fails to
+ * compile when a member is added and a resolver silently goes on answering for
+ * the old set.
+ */
+export type LibraryMessages = {
+    /** Action label on a retryable error toast. */
+    retry: () => string;
+    /** Autosave to the server failed; the change is still held locally. */
+    saveFailed: () => string;
+    /** The transport could not start. */
+    playbackFailed: () => string;
+    /** The score could not be handed to the playback engine. */
+    scoreLoadFailed: () => string;
+    /** An authenticated call was attempted while signed out. */
+    authRequired: () => string;
+    /**
+     * A server-backed feature was reached on a host that has no server.
+     *
+     * Distinct from `authRequired`, which means "sign in and this works". This
+     * one means the feature is not on offer here at all — a native app editing a
+     * local file. A host whose UI asks `serverAvailable` first should never show
+     * it; it is the backstop for the paths that do not.
+     */
+    serverUnavailable: () => string;
+};
+export type LibraryMessageKey = keyof LibraryMessages;
+/** Every copy table the libraries read, each resolved when it is used. */
+export type LibraryCopy = {
+    /** For `setEditingCopy`: undo labels, validation, refusals. */
+    editing: () => EditingCopy;
+    /** For `selectionSummaryLabel`. */
+    selection: () => SelectionSummaryCopy;
+    /** For `openMusicXml`: one sentence per case the importer warns about. */
+    musicXmlWarnings: () => MusicXmlWarnings;
+    /** For `setLibraryMessages`: the messages raised from long-lived internals. */
+    library: () => LibraryMessages;
+    /** For `projectTemplates`: each template's name and description. */
+    templates: () => TemplateCopy;
+};
+//# sourceMappingURL=library-copy.d.ts.map

package/dist/domain/editor/library-copy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"library-copy.d.ts","sourceRoot":"","sources":["../../../src/domain/editor/library-copy.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,+CAA+C;IAC/C,KAAK,EAAE,MAAM,MAAM,CAAC;IACpB,uEAAuE;IACvE,UAAU,EAAE,MAAM,MAAM,CAAC;IACzB,qCAAqC;IACrC,cAAc,EAAE,MAAM,MAAM,CAAC;IAC7B,4DAA4D;IAC5D,eAAe,EAAE,MAAM,MAAM,CAAC;IAC9B,4DAA4D;IAC5D,YAAY,EAAE,MAAM,MAAM,CAAC;IAC3B;;;;;;;OAOG;IACH,iBAAiB,EAAE,MAAM,MAAM,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,MAAM,eAAe,CAAC;AAEtD,0EAA0E;AAC1E,MAAM,MAAM,WAAW,GAAG;IACxB,+DAA+D;IAC/D,OAAO,EAAE,MAAM,WAAW,CAAC;IAC3B,mCAAmC;IACnC,SAAS,EAAE,MAAM,oBAAoB,CAAC;IACtC,0EAA0E;IAC1E,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;IACzC,+EAA+E;IAC/E,OAAO,EAAE,MAAM,eAAe,CAAC;IAC/B,oEAAoE;IACpE,SAAS,EAAE,MAAM,YAAY,CAAC;CAC/B,CAAC"}

package/dist/domain/editor/library-copy.js

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

package/dist/domain/editor/library-copy.js.map

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

package/dist/domain/editor/print.d.ts

@@ -0,0 +1,30 @@
+/**
+ * The paper a score prints on, as vocabulary and picker options.
+ *
+ * The page geometry that uses these — dimensions, margins, pagination — is
+ * music_drawing's.
+ */
+/** The papers a score prints on, in the order a picker offers them. */
+export declare const PAPER_SIZES: readonly ["a4", "letter", "legal"];
+export type PaperSize = (typeof PAPER_SIZES)[number];
+/** Portrait first: it is the default and what almost every part is. */
+export declare const PAPER_ORIENTATIONS: readonly ["portrait", "landscape"];
+export type PaperOrientation = (typeof PAPER_ORIENTATIONS)[number];
+/**
+ * The paper picker. `css` is the `@page` size keyword; an orientation's value
+ * is its own CSS keyword already.
+ *
+ * A4 has a key like the others even though it reads "A4" in both languages —
+ * one shape for every entry is what lets a picker map straight through, and the
+ * locales list it as shared by design.
+ */
+export declare const PAPER_OPTIONS: ReadonlyArray<{
+    value: PaperSize;
+    labelKey: string;
+    css: string;
+}>;
+export declare const ORIENTATION_OPTIONS: ReadonlyArray<{
+    value: PaperOrientation;
+    labelKey: string;
+}>;
+//# sourceMappingURL=print.d.ts.map

package/dist/domain/editor/print.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"print.d.ts","sourceRoot":"","sources":["../../../src/domain/editor/print.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,uEAAuE;AACvE,eAAO,MAAM,WAAW,oCAAqC,CAAC;AAC9D,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,uEAAuE;AACvE,eAAO,MAAM,kBAAkB,oCAAqC,CAAC;AACrE,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAoBnE;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,EAAE,aAAa,CAAC;IACxC,KAAK,EAAE,SAAS,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACb,CAIE,CAAC;AAEJ,eAAO,MAAM,mBAAmB,EAAE,aAAa,CAAC;IAC9C,KAAK,EAAE,gBAAgB,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAGE,CAAC"}

package/dist/domain/editor/print.js

@@ -0,0 +1,43 @@
+/**
+ * The paper a score prints on, as vocabulary and picker options.
+ *
+ * The page geometry that uses these — dimensions, margins, pagination — is
+ * music_drawing's.
+ */
+/** The papers a score prints on, in the order a picker offers them. */
+export const PAPER_SIZES = ["a4", "letter", "legal"];
+/** Portrait first: it is the default and what almost every part is. */
+export const PAPER_ORIENTATIONS = ["portrait", "landscape"];
+const PAPER_LABEL_KEY = {
+    a4: "print.paperA4",
+    letter: "print.paperLetter",
+    legal: "print.paperLegal",
+};
+/** The CSS `@page { size }` keyword for each paper. */
+const PAPER_CSS = {
+    a4: "A4",
+    letter: "letter",
+    legal: "legal",
+};
+const ORIENTATION_LABEL_KEY = {
+    portrait: "print.portrait",
+    landscape: "print.landscape",
+};
+/**
+ * The paper picker. `css` is the `@page` size keyword; an orientation's value
+ * is its own CSS keyword already.
+ *
+ * A4 has a key like the others even though it reads "A4" in both languages —
+ * one shape for every entry is what lets a picker map straight through, and the
+ * locales list it as shared by design.
+ */
+export const PAPER_OPTIONS = PAPER_SIZES.map((value) => ({
+    value,
+    labelKey: PAPER_LABEL_KEY[value],
+    css: PAPER_CSS[value],
+}));
+export const ORIENTATION_OPTIONS = PAPER_ORIENTATIONS.map((value) => ({
+    value,
+    labelKey: ORIENTATION_LABEL_KEY[value],
+}));
+//# sourceMappingURL=print.js.map

package/dist/domain/editor/print.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"print.js","sourceRoot":"","sources":["../../../src/domain/editor/print.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,uEAAuE;AACvE,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAU,CAAC;AAG9D,uEAAuE;AACvE,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,UAAU,EAAE,WAAW,CAAU,CAAC;AAGrE,MAAM,eAAe,GAA8B;IACjD,EAAE,EAAE,eAAe;IACnB,MAAM,EAAE,mBAAmB;IAC3B,KAAK,EAAE,kBAAkB;CAC1B,CAAC;AAEF,uDAAuD;AACvD,MAAM,SAAS,GAA8B;IAC3C,EAAE,EAAE,IAAI;IACR,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,OAAO;CACf,CAAC;AAEF,MAAM,qBAAqB,GAAqC;IAC9D,QAAQ,EAAE,gBAAgB;IAC1B,SAAS,EAAE,iBAAiB;CAC7B,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,aAAa,GAIrB,WAAW,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC/B,KAAK;IACL,QAAQ,EAAE,eAAe,CAAC,KAAK,CAAC;IAChC,GAAG,EAAE,SAAS,CAAC,KAAK,CAAC;CACtB,CAAC,CAAC,CAAC;AAEJ,MAAM,CAAC,MAAM,mBAAmB,GAG3B,kBAAkB,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACtC,KAAK;IACL,QAAQ,EAAE,qBAAqB,CAAC,KAAK,CAAC;CACvC,CAAC,CAAC,CAAC"}

package/dist/domain/editor/score-input.d.ts

@@ -0,0 +1,158 @@
+/**
+ * What a hand does to the score, as data: a press and what lies under it, a
+ * pointer gesture, a key chord, a group of piano keys, a lyric keystroke.
+ *
+ * The geometry that answers "what is under this point" is music_drawing's; the
+ * meaning of each input is music_editing's. The shapes they pass between them
+ * are declared here once, so neither package restates the other's.
+ */
+import type { Pitch, UUID } from "../../model/score.js";
+import type { PitchDisplay } from "../score/display-score.js";
+/**
+ * Whatever lies under a point on the score, as the canvas reports it.
+ *
+ * `null` (passed where a hit is expected) means the press landed on nothing —
+ * between systems, or on the gutter's empty band.
+ *
+ * A stave's `pitch` is the pitch **as drawn** at that point, after the display
+ * lenses; `routeScorePress` inverts them itself, because a drawn pitch stored
+ * raw writes a note an octave out inside an `8va` and a tone out on a B-flat
+ * part — and it does so silently, since the note then draws where it was
+ * pressed and only sounds wrong.
+ */
+export type ScoreCanvasHit = {
+    kind: "trackGutter";
+    trackId: UUID;
+} | {
+    kind: "measureNumber";
+    measureIndex: number;
+} | {
+    kind: "note";
+    /** Every event sharing the notehead's box: a chord is one target. */
+    eventIds: readonly UUID[];
+    trackId: UUID;
+    measureIndex: number;
+    tick: number;
+} | {
+    kind: "stave";
+    trackId: UUID;
+    measureIndex: number;
+    tick: number;
+    /** The pitch *as drawn* at that point, when the point is on a stave. */
+    pitch: Pitch | null;
+};
+export type ScorePressModifiers = {
+    shift: boolean;
+    /** Cmd on macOS, Ctrl elsewhere — resolved by the host. */
+    mod: boolean;
+    /** The store's `noteInput`, passed so a host can route a press it has already read. */
+    noteInput: boolean;
+    /** How the pressed pitch was drawn, so it can be taken back to sounding pitch. */
+    pitchDisplay: PitchDisplay;
+    /** The bar a shift-extended bar selection grows from; see `selectMeasureRange`. */
+    anchor: number | null;
+    /**
+     * The tick the canvas reports for the press point (`ScoreCanvas.tickAt`), or
+     * null where there is none. What a Mod press selects *to*.
+     *
+     * Not the hit's own tick: a hit only exists inside a measure, and its tick
+     * falls back to 0 where the canvas has no answer — so reading it made a
+     * Mod press between systems do nothing and one on an unmapped stretch select
+     * back to the start of the piece. Required rather than defaulted to the hit,
+     * so a host cannot quietly keep the old answer.
+     */
+    pointTick: number | null;
+};
+/**
+ * What a primary press that may become a drag starts.
+ *
+ * - `move` — Alt on a note: drag the selection to another track or tick. The
+ *   anchor is the last id of the box. `selectChord` is the chord to select
+ *   first when none of it is selected yet (null to keep the selection); an
+ *   explicit modifier leaves no ambiguity with a box select, so requiring a
+ *   prior selection would be friction for nothing.
+ * - `pitchDrag` — a press on the *one* selected note. Requiring it to be
+ *   selected first is what keeps an ordinary press-and-drag across the staff a
+ *   box select.
+ * - `box` — everything else; Shift adds to the selection rather than replacing
+ *   it. A box that never moves past the host's slop is an ordinary press, and
+ *   goes to `routeScorePress` instead.
+ */
+export type PointerGesture = {
+    kind: "move";
+    anchorId: UUID;
+    anchorTick: number;
+    selectChord: readonly UUID[] | null;
+} | {
+    kind: "pitchDrag";
+    eventId: UUID;
+    pitch: Pitch;
+} | {
+    kind: "box";
+    additive: boolean;
+};
+/** What produced a press. */
+export type PointerKind = "mouse" | "touch";
+/** What a press was, once it ended (`classifyPress`). */
+export type PressKind = "tap" | "longPress" | "drag";
+/**
+ * One keypress, platform-free.
+ *
+ * `mod` is Cmd on macOS and Ctrl elsewhere, resolved by the host because only
+ * it knows which platform it is on — and reserved for the system throughout
+ * the shortcut table, so a browser or OS shortcut is never mistaken for an
+ * edit.
+ */
+export type EditorKeyChord = {
+    key: string;
+    shift: boolean;
+    alt: boolean;
+    mod: boolean;
+};
+/** Piano keys pressed together, grouped into one chord until the last lifts. */
+export type KeyGroup = {
+    /** Every key touched since the first went down, in the order touched. */
+    midis: readonly number[];
+    /** Keys still held. Empty means the group is finished. */
+    down: readonly number[];
+    /** When the first key went down; 0 when no group is open. */
+    startedAt: number;
+};
+export type ReleaseResult = {
+    group: KeyGroup;
+    /** Set once the last finger lifts — what to hand `playKeyGroup`. */
+    finished: {
+        midis: readonly number[];
+        heldMs: number;
+    } | null;
+};
+/** A change to an existing note's pitch. */
+export type PitchChange = {
+    id: UUID;
+    to: Pitch;
+};
+/** Where lyric entry is in the line. */
+export type LyricEntryState = {
+    /** The note being written, into the notes entry began with. */
+    index: number;
+    /** How many notes the line has. */
+    count: number;
+    /** Whether the syllable before this one ended in a hyphen. */
+    continuing: boolean;
+};
+/** A keystroke, or its on-screen equivalent, that means something to entry. */
+export type LyricInput = "space" | "tab" | "hyphen" | "enter" | "escape" | "back";
+export type LyricWrite = {
+    index: number;
+    text: string;
+    continuing: boolean;
+    hyphenated: boolean;
+};
+export type LyricStep = {
+    state: LyricEntryState;
+    /** What to write, or null when the input writes nothing. */
+    write: LyricWrite | null;
+    /** Whether entry is over. */
+    close: boolean;
+};
+//# sourceMappingURL=score-input.d.ts.map

package/dist/domain/editor/score-input.d.ts.map

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

package/dist/domain/editor/score-input.js

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

package/dist/domain/editor/score-input.js.map

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

package/dist/domain/editor/toast.d.ts

@@ -0,0 +1,32 @@
+/**
+ * A toast: a transient message a store raises and a host renders.
+ */
+export type ToastSeverity = "info" | "success" | "warning" | "error";
+/**
+ * An optional action button (spec §28: "retry actions where appropriate"),
+ * e.g. "Retry" on a failed import/save toast, or "Undo" on a paste refused
+ * after a cut. The toast is dismissed once it is used, so `onClick` does only
+ * the work.
+ */
+export type ToastAction = {
+    label: string;
+    onClick: () => void;
+};
+export type Toast = {
+    id: string;
+    message: string;
+    severity: ToastSeverity;
+    action?: ToastAction;
+};
+/**
+ * A host's toast renderer.
+ *
+ * The toast arrives with its id already assigned, because the store's caller
+ * is handed that id back — a refused paste's Undo action dismisses its own
+ * toast by it.
+ */
+export type ToastSink = {
+    push(toast: Toast): void;
+    dismiss(id: string): void;
+};
+//# sourceMappingURL=toast.d.ts.map

package/dist/domain/editor/toast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toast.d.ts","sourceRoot":"","sources":["../../../src/domain/editor/toast.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAErE;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAAC;AAEjE,MAAM,MAAM,KAAK,GAAG;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,aAAa,CAAC;IACxB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACzB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC"}

package/dist/domain/editor/toast.js

@@ -0,0 +1,5 @@
+/**
+ * A toast: a transient message a store raises and a host renders.
+ */
+export {};
+//# sourceMappingURL=toast.js.map

package/dist/domain/editor/toast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toast.js","sourceRoot":"","sources":["../../../src/domain/editor/toast.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/domain/editor/toolbar.d.ts

@@ -0,0 +1,62 @@
+/**
+ * The editing bar's vocabulary: its controls, the More menu, the two ways to
+ * add a track, and how many voices it offers.
+ *
+ * When each control is available is music_editing's rule
+ * (`selectToolbarAvailability`); what they are called is the host's copy.
+ */
+/**
+ * Every control on the editing bar whose availability depends on the score.
+ *
+ * The view controls — zoom, layout, pitch display, the inspector toggle — are
+ * deliberately absent: they change how the score is looked at rather than the
+ * score, so they are live with no score, with nothing selected and while the
+ * transport plays, and a row of constant `true`s would only be something for a
+ * bar to forget to read.
+ */
+export declare const TOOLBAR_CONTROLS: readonly ["addTrack", "noteDuration", "dotted", "triplet", "accidental", "articulation", "ornament", "tie", "insertMode", "replaceMode", "stackMode", "insertNote", "slur", "crescendo", "diminuendo", "arpeggiate", "beamBreak", "beamNone", "fermata", "noteInput", "insertRest", "quantizeGrid", "quantize", "voice", "moreActions", "selectAll", "addMeasure", "deleteMeasure", "goToBar", "enterLyrics", "glissando"];
+export type ToolbarControl = (typeof TOOLBAR_CONTROLS)[number];
+export type ToolbarAvailability = Record<ToolbarControl, boolean>;
+/**
+ * How many voices the bar offers.
+ *
+ * Two is where notation actually needs them — stems up against stems down on
+ * one stave. More is real notation too, but nothing else in the editor tells
+ * voices apart yet, so offering four would be offering somewhere to lose notes.
+ */
+export declare const EDITOR_VOICE_COUNT = 2;
+export type AddTrackChoice = "blank" | "generate";
+export type AddTrackChoiceOption = {
+    value: AddTrackChoice;
+    labelKey: string;
+    hintKey: string;
+    disabled: boolean;
+};
+/** The rarely-used actions both bars keep behind a More menu, in order. */
+export declare const EDITOR_MORE_ACTIONS: readonly [{
+    readonly value: "select-all";
+    readonly labelKey: "editor.selectAllNotes";
+    readonly control: "selectAll";
+}, {
+    readonly value: "add-measure";
+    readonly labelKey: "editor.addMeasure";
+    readonly control: "addMeasure";
+}, {
+    readonly value: "delete-measure";
+    readonly labelKey: "editor.deleteMeasure";
+    readonly control: "deleteMeasure";
+}, {
+    readonly value: "go-to-bar";
+    readonly labelKey: "editor.goToBar";
+    readonly control: "goToBar";
+}, {
+    readonly value: "enter-lyrics";
+    readonly labelKey: "editor.enterLyrics";
+    readonly control: "enterLyrics";
+}, {
+    readonly value: "glissando";
+    readonly labelKey: "editor.glissando";
+    readonly control: "glissando";
+}];
+export type EditorMoreAction = (typeof EDITOR_MORE_ACTIONS)[number]["value"];
+//# sourceMappingURL=toolbar.d.ts.map

package/dist/domain/editor/toolbar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolbar.d.ts","sourceRoot":"","sources":["../../../src/domain/editor/toolbar.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,4ZAgCnB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;AAElE;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,UAAU,CAAC;AAElD,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,cAAc,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,2EAA2E;AAC3E,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;EA2B9B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC"}

package/dist/domain/editor/toolbar.js

@@ -0,0 +1,83 @@
+/**
+ * The editing bar's vocabulary: its controls, the More menu, the two ways to
+ * add a track, and how many voices it offers.
+ *
+ * When each control is available is music_editing's rule
+ * (`selectToolbarAvailability`); what they are called is the host's copy.
+ */
+/**
+ * Every control on the editing bar whose availability depends on the score.
+ *
+ * The view controls — zoom, layout, pitch display, the inspector toggle — are
+ * deliberately absent: they change how the score is looked at rather than the
+ * score, so they are live with no score, with nothing selected and while the
+ * transport plays, and a row of constant `true`s would only be something for a
+ * bar to forget to read.
+ */
+export const TOOLBAR_CONTROLS = [
+    "addTrack",
+    "noteDuration",
+    "dotted",
+    "triplet",
+    "accidental",
+    "articulation",
+    "ornament",
+    "tie",
+    "insertMode",
+    "replaceMode",
+    "stackMode",
+    "insertNote",
+    "slur",
+    "crescendo",
+    "diminuendo",
+    "arpeggiate",
+    "beamBreak",
+    "beamNone",
+    "fermata",
+    "noteInput",
+    "insertRest",
+    "quantizeGrid",
+    "quantize",
+    "voice",
+    "moreActions",
+    "selectAll",
+    "addMeasure",
+    "deleteMeasure",
+    "goToBar",
+    "enterLyrics",
+    "glissando",
+];
+/**
+ * How many voices the bar offers.
+ *
+ * Two is where notation actually needs them — stems up against stems down on
+ * one stave. More is real notation too, but nothing else in the editor tells
+ * voices apart yet, so offering four would be offering somewhere to lose notes.
+ */
+export const EDITOR_VOICE_COUNT = 2;
+/** The rarely-used actions both bars keep behind a More menu, in order. */
+export const EDITOR_MORE_ACTIONS = [
+    {
+        value: "select-all",
+        labelKey: "editor.selectAllNotes",
+        control: "selectAll",
+    },
+    {
+        value: "add-measure",
+        labelKey: "editor.addMeasure",
+        control: "addMeasure",
+    },
+    {
+        value: "delete-measure",
+        labelKey: "editor.deleteMeasure",
+        control: "deleteMeasure",
+    },
+    { value: "go-to-bar", labelKey: "editor.goToBar", control: "goToBar" },
+    {
+        value: "enter-lyrics",
+        labelKey: "editor.enterLyrics",
+        control: "enterLyrics",
+    },
+    { value: "glissando", labelKey: "editor.glissando", control: "glissando" },
+];
+//# sourceMappingURL=toolbar.js.map

package/dist/domain/editor/toolbar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolbar.js","sourceRoot":"","sources":["../../../src/domain/editor/toolbar.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,UAAU;IACV,cAAc;IACd,QAAQ;IACR,SAAS;IACT,YAAY;IACZ,cAAc;IACd,UAAU;IACV,KAAK;IACL,YAAY;IACZ,aAAa;IACb,WAAW;IACX,YAAY;IACZ,MAAM;IACN,WAAW;IACX,YAAY;IACZ,YAAY;IACZ,WAAW;IACX,UAAU;IACV,SAAS;IACT,WAAW;IACX,YAAY;IACZ,cAAc;IACd,UAAU;IACV,OAAO;IACP,aAAa;IACb,WAAW;IACX,YAAY;IACZ,eAAe;IACf,SAAS;IACT,aAAa;IACb,WAAW;CACH,CAAC;AAMX;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAWpC,2EAA2E;AAC3E,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC;QACE,KAAK,EAAE,YAAY;QACnB,QAAQ,EAAE,uBAAuB;QACjC,OAAO,EAAE,WAAW;KACrB;IACD;QACE,KAAK,EAAE,aAAa;QACpB,QAAQ,EAAE,mBAAmB;QAC7B,OAAO,EAAE,YAAY;KACtB;IACD;QACE,KAAK,EAAE,gBAAgB;QACvB,QAAQ,EAAE,sBAAsB;QAChC,OAAO,EAAE,eAAe;KACzB;IACD,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,gBAAgB,EAAE,OAAO,EAAE,SAAS,EAAE;IACtE;QACE,KAAK,EAAE,cAAc;QACrB,QAAQ,EAAE,oBAAoB;QAC9B,OAAO,EAAE,aAAa;KACvB;IACD,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,kBAAkB,EAAE,OAAO,EAAE,WAAW,EAAE;CAK1E,CAAC"}

package/dist/domain/editor/view-settings.d.ts

@@ -0,0 +1,22 @@
+/**
+ * How the notation is laid out: `page` wraps systems to fit the width,
+ * `continuous` lays every measure out in one long system.
+ *
+ * An array with the type read off it, so a toolbar offering the choice reads
+ * this rather than writing the list out again — which is how one of them comes
+ * to offer a mode the renderer no longer has.
+ */
+export declare const LAYOUT_MODES: readonly ["page", "continuous"];
+export type LayoutMode = (typeof LAYOUT_MODES)[number];
+/**
+ * The grids a quantize is offered on.
+ *
+ * Stops at a thirty-second: below that a grid is finer than the deviations a
+ * human performance actually has, so snapping to it changes nothing while
+ * looking like it did something.
+ */
+export declare const QUANTIZE_GRIDS: readonly ["quarter", "eighth", "sixteenth", "thirtysecond"];
+export type QuantizeGrid = (typeof QUANTIZE_GRIDS)[number];
+/** The short label a grid is written as on a bar: `1/16`. */
+export declare const QUANTIZE_GRID_SHORT: Record<QuantizeGrid, string>;
+//# sourceMappingURL=view-settings.d.ts.map

package/dist/domain/editor/view-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-settings.d.ts","sourceRoot":"","sources":["../../../src/domain/editor/view-settings.ts"],"names":[],"mappings":"AAMA;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,iCAAkC,CAAC;AAE5D,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,6DAKiB,CAAC;AAE7C,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,6DAA6D;AAC7D,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAK5D,CAAC"}

package/dist/domain/editor/view-settings.js

@@ -0,0 +1,30 @@
+/**
+ * How the notation is laid out: `page` wraps systems to fit the width,
+ * `continuous` lays every measure out in one long system.
+ *
+ * An array with the type read off it, so a toolbar offering the choice reads
+ * this rather than writing the list out again — which is how one of them comes
+ * to offer a mode the renderer no longer has.
+ */
+export const LAYOUT_MODES = ["page", "continuous"];
+/**
+ * The grids a quantize is offered on.
+ *
+ * Stops at a thirty-second: below that a grid is finer than the deviations a
+ * human performance actually has, so snapping to it changes nothing while
+ * looking like it did something.
+ */
+export const QUANTIZE_GRIDS = [
+    "quarter",
+    "eighth",
+    "sixteenth",
+    "thirtysecond",
+];
+/** The short label a grid is written as on a bar: `1/16`. */
+export const QUANTIZE_GRID_SHORT = {
+    quarter: "1/4",
+    eighth: "1/8",
+    sixteenth: "1/16",
+    thirtysecond: "1/32",
+};
+//# sourceMappingURL=view-settings.js.map

package/dist/domain/editor/view-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-settings.js","sourceRoot":"","sources":["../../../src/domain/editor/view-settings.ts"],"names":[],"mappings":"AAMA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,YAAY,CAAU,CAAC;AAI5D;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,SAAS;IACT,QAAQ;IACR,WAAW;IACX,cAAc;CAC4B,CAAC;AAI7C,6DAA6D;AAC7D,MAAM,CAAC,MAAM,mBAAmB,GAAiC;IAC/D,OAAO,EAAE,KAAK;IACd,MAAM,EAAE,KAAK;IACb,SAAS,EAAE,MAAM;IACjB,YAAY,EAAE,MAAM;CACrB,CAAC"}