@sudobility/music_drawing 0.0.30 → 0.0.31

package/dist/index.d.ts

@@ -22,6 +22,7 @@ export * from './layout.js';
 export * from './pagination.js';
 export * from './print-layout.js';
 export * from './note-colors.js';
+export * from './out-of-range.js';
 export * from './hit-test.js';
 export * from './track-gutter.js';
 export * from './note-drag.js';
@@ -40,4 +41,10 @@ export * from './icon-canvas.js';
  * between them. Shared by the web and native apps, which both draw one.
  */
 export * from './keyboard-geometry.js';
+/**
+ * And what those keys are called, which is the staff's convention rather than
+ * the geometry's: a transposing part read in written pitch letters its keys
+ * where its player reads them.
+ */
+export * from './keyboard-labels.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":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AAEjC;;;GAGG;AACH,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AAEjC;;;GAGG;AACH,cAAc,wBAAwB,CAAC;AAEvC;;;;GAIG;AACH,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -22,6 +22,7 @@ export * from './layout.js';
 export * from './pagination.js';
 export * from './print-layout.js';
 export * from './note-colors.js';
+export * from './out-of-range.js';
 export * from './hit-test.js';
 export * from './track-gutter.js';
 export * from './note-drag.js';
@@ -40,4 +41,10 @@ export * from './icon-canvas.js';
  * between them. Shared by the web and native apps, which both draw one.
  */
 export * from './keyboard-geometry.js';
+/**
+ * And what those keys are called, which is the staff's convention rather than
+ * the geometry's: a transposing part read in written pitch letters its keys
+ * where its player reads them.
+ */
+export * from './keyboard-labels.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AAEjC;;;GAGG;AACH,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AAEjC;;;GAGG;AACH,cAAc,wBAAwB,CAAC;AAEvC;;;;GAIG;AACH,cAAc,sBAAsB,CAAC"}

package/dist/keyboard-geometry.d.ts

@@ -1,19 +1,50 @@
-/** A0 — the lowest key on a standard 88-key piano. */
-export declare const KEYBOARD_MIN_MIDI = 21;
-/** C8 — the highest. */
-export declare const KEYBOARD_MAX_MIDI = 108;
-/** The 88 keys span 52 whites; the blacks overlay them and add no width. */
-export declare const WHITE_KEY_COUNT = 52;
+/**
+ * Physical piano-keyboard layout. Pure arithmetic — no React, no store — so
+ * the key positions are unit-testable on their own.
+ *
+ * Here rather than in an app because two of them now draw a keyboard, and a
+ * second copy of this would drift from the first the moment either was tuned.
+ * It sits in music_drawing beside the score layout for the same reason that
+ * does: it answers where something is drawn, and it needs only music_types.
+ *
+ * The piano roll modelled pitch as one uniform row per semitone. A real
+ * keyboard cannot: white keys tile edge to edge and each black key straddles
+ * the boundary *between* two whites, overlapping both.
+ *
+ *   ┌─┬─┬─┬─┬─┬─┬─┐
+ *   │ │█│ │█│ │ │█│    white: x = whiteIndex * w
+ *   │ └┬┘ └┬┘ │ └┬┘    black: x = (whiteIndex + 1) * w - blackWidth / 2
+ *   │C │D │E │F │G │
+ *   └──┴──┴──┴──┴──┘
+ */
+import { type MidiRange } from '@sudobility/music_types';
 /**
  * The keyboard is drawn over a caller-chosen range, not always all 88 keys:
  * the active track's instrument decides it, so a piccolo part does not present
  * three octaves of keys that will never sound.
+ *
+ * An **alias** of music_types' `MidiRange`, not a structural twin of it. What
+ * a caller passes is almost always `trackKeyboardRange(track)`, so the two were
+ * already the same shape by coincidence; saying so outright means a change to
+ * `MidiRange` reaches the keyboard rather than being silently accepted by a
+ * local copy that happens still to match.
+ */
+export type KeyboardRange = MidiRange;
+/**
+ * The 88-key piano — `FULL_KEYBOARD` **by identity**, not a second pair of
+ * numbers that agrees with it today.
+ *
+ * Kept under this name because both apps' keyboards import `FULL_RANGE`, and
+ * because it reads as this module's default range (`computeKeys(w, h)`) where
+ * `FULL_KEYBOARD` reads as a fact about instruments.
  */
-export type KeyboardRange = {
-    min: number;
-    max: number;
-};
 export declare const FULL_RANGE: KeyboardRange;
+/** A0 — the lowest key on a standard 88-key piano. */
+export declare const KEYBOARD_MIN_MIDI: number;
+/** C8 — the highest. */
+export declare const KEYBOARD_MAX_MIDI: number;
+/** The 88 keys span 52 whites; the blacks overlay them and add no width. */
+export declare const WHITE_KEY_COUNT = 52;
 /**
  * Widens `range` so it begins and ends on a white key, and clamps it to the
  * 88-key piano.
@@ -21,6 +52,11 @@ export declare const FULL_RANGE: KeyboardRange;
  * A keyboard whose first or last key is black looks broken — a black key has no
  * white neighbour to hang off on that side, so it would float. Widening is
  * always safe: it only ever adds a key the instrument nearly reaches.
+ *
+ * Clamped against `FULL_KEYBOARD` rather than against literals of its own: the
+ * ranges arriving here come from the same catalogue that bounds itself by that
+ * constant, so a local pair of numbers would be a second opinion on where the
+ * piano ends.
  */
 export declare function snapToWhiteKeys(range: KeyboardRange): KeyboardRange;
 /** How many white keys a range spans, which is what sets the keyboard's width. */

package/dist/keyboard-geometry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"keyboard-geometry.d.ts","sourceRoot":"","sources":["../src/keyboard-geometry.ts"],"names":[],"mappings":"AA0BA,sDAAsD;AACtD,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,wBAAwB;AACxB,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,4EAA4E;AAC5E,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzD,eAAO,MAAM,UAAU,EAAE,aAGxB,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,aAAa,CASnE;AAED,kFAAkF;AAClF,wBAAgB,aAAa,CAAC,KAAK,GAAE,aAA0B,GAAG,MAAM,CAKvE;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC,oDAAoD;AACpD,eAAO,MAAM,qBAAqB,MAAM,CAAC;AACzC,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAE3C,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,uDAAuD;IACvD,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf;;;;;;;OAOG;IACH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB;;;;;;;OAOG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;;OAQG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,sFAAsF;AACtF,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,YAAY,CAAC;AAE/C,8EAA8E;AAC9E,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGhD;AAED,kIAAkI;AAClI,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,8DAA8D;AAC9D,wBAAgB,aAAa,CAC3B,aAAa,EAAE,MAAM,EACrB,KAAK,GAAE,aAA0B,GAChC,MAAM,CAER;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,KAAK,GAAE,aAA0B,EACjC,MAAM,GAAE,SAAmB,GAC1B,QAAQ,EAAE,CAwDZ"}
+{"version":3,"file":"keyboard-geometry.d.ts","sourceRoot":"","sources":["../src/keyboard-geometry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAML,KAAK,SAAS,EACf,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;;;GAUG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,CAAC;AAEtC;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,EAAE,aAA6B,CAAC;AAEvD,sDAAsD;AACtD,eAAO,MAAM,iBAAiB,QAAoB,CAAC;AACnD,wBAAwB;AACxB,eAAO,MAAM,iBAAiB,QAAoB,CAAC;AACnD,4EAA4E;AAC5E,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,aAAa,CASnE;AAED,kFAAkF;AAClF,wBAAgB,aAAa,CAAC,KAAK,GAAE,aAA0B,GAAG,MAAM,CAKvE;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC,oDAAoD;AACpD,eAAO,MAAM,qBAAqB,MAAM,CAAC;AACzC,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAE3C,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,uDAAuD;IACvD,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf;;;;;;;OAOG;IACH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB;;;;;;;OAOG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;;OAQG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,sFAAsF;AACtF,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,YAAY,CAAC;AAE/C,8EAA8E;AAC9E,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGhD;AAED,kIAAkI;AAClI,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,8DAA8D;AAC9D,wBAAgB,aAAa,CAC3B,aAAa,EAAE,MAAM,EACrB,KAAK,GAAE,aAA0B,GAChC,MAAM,CAER;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,KAAK,GAAE,aAA0B,EACjC,MAAM,GAAE,SAAmB,GAC1B,QAAQ,EAAE,CAwDZ"}

package/dist/keyboard-geometry.js

@@ -17,17 +17,22 @@
  *   │C │D │E │F │G │
  *   └──┴──┴──┴──┴──┘
  */
-import { gmPercussion, gmPercussionName, midiToPitch, pitchToString, } from '@sudobility/music_types';
+import { FULL_KEYBOARD, gmPercussion, gmPercussionName, midiToPitch, pitchToString, } from '@sudobility/music_types';
+/**
+ * The 88-key piano — `FULL_KEYBOARD` **by identity**, not a second pair of
+ * numbers that agrees with it today.
+ *
+ * Kept under this name because both apps' keyboards import `FULL_RANGE`, and
+ * because it reads as this module's default range (`computeKeys(w, h)`) where
+ * `FULL_KEYBOARD` reads as a fact about instruments.
+ */
+export const FULL_RANGE = FULL_KEYBOARD;
 /** A0 — the lowest key on a standard 88-key piano. */
-export const KEYBOARD_MIN_MIDI = 21;
+export const KEYBOARD_MIN_MIDI = FULL_KEYBOARD.min;
 /** C8 — the highest. */
-export const KEYBOARD_MAX_MIDI = 108;
+export const KEYBOARD_MAX_MIDI = FULL_KEYBOARD.max;
 /** The 88 keys span 52 whites; the blacks overlay them and add no width. */
 export const WHITE_KEY_COUNT = 52;
-export const FULL_RANGE = {
-    min: KEYBOARD_MIN_MIDI,
-    max: KEYBOARD_MAX_MIDI,
-};
 /**
  * Widens `range` so it begins and ends on a white key, and clamps it to the
  * 88-key piano.
@@ -35,13 +40,18 @@ export const FULL_RANGE = {
  * A keyboard whose first or last key is black looks broken — a black key has no
  * white neighbour to hang off on that side, so it would float. Widening is
  * always safe: it only ever adds a key the instrument nearly reaches.
+ *
+ * Clamped against `FULL_KEYBOARD` rather than against literals of its own: the
+ * ranges arriving here come from the same catalogue that bounds itself by that
+ * constant, so a local pair of numbers would be a second opinion on where the
+ * piano ends.
  */
 export function snapToWhiteKeys(range) {
-    let min = Math.max(KEYBOARD_MIN_MIDI, Math.min(range.min, range.max));
-    let max = Math.min(KEYBOARD_MAX_MIDI, Math.max(range.min, range.max));
-    while (min > KEYBOARD_MIN_MIDI && isBlackKey(min))
+    let min = Math.max(FULL_KEYBOARD.min, Math.min(range.min, range.max));
+    let max = Math.min(FULL_KEYBOARD.max, Math.max(range.min, range.max));
+    while (min > FULL_KEYBOARD.min && isBlackKey(min))
         min -= 1;
-    while (max < KEYBOARD_MAX_MIDI && isBlackKey(max))
+    while (max < FULL_KEYBOARD.max && isBlackKey(max))
         max += 1;
     // If clamping left an edge black (the very ends of the piano), step inward.
     while (isBlackKey(min) && min < max)

package/dist/keyboard-geometry.js.map

@@ -1 +1 @@
-{"version":3,"file":"keyboard-geometry.js","sourceRoot":"","sources":["../src/keyboard-geometry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,aAAa,GACd,MAAM,yBAAyB,CAAC;AAEjC,sDAAsD;AACtD,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AACpC,wBAAwB;AACxB,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AACrC,4EAA4E;AAC5E,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,CAAC;AASlC,MAAM,CAAC,MAAM,UAAU,GAAkB;IACvC,GAAG,EAAE,iBAAiB;IACtB,GAAG,EAAE,iBAAiB;CACvB,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,KAAoB;IAClD,IAAI,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IACtE,IAAI,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IACtE,OAAO,GAAG,GAAG,iBAAiB,IAAI,UAAU,CAAC,GAAG,CAAC;QAAE,GAAG,IAAI,CAAC,CAAC;IAC5D,OAAO,GAAG,GAAG,iBAAiB,IAAI,UAAU,CAAC,GAAG,CAAC;QAAE,GAAG,IAAI,CAAC,CAAC;IAC5D,4EAA4E;IAC5E,OAAO,UAAU,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,GAAG;QAAE,GAAG,IAAI,CAAC,CAAC;IAC9C,OAAO,UAAU,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,GAAG;QAAE,GAAG,IAAI,CAAC,CAAC;IAC9C,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AACtB,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,aAAa,CAAC,QAAuB,UAAU;IAC7D,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,IAAI,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,IAAI,KAAK,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC;QACrD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,KAAK,IAAI,CAAC,CAAC;IACpC,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAEtC,oDAAoD;AACpD,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AACzC,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAuC3C,sFAAsF;AACtF,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAWnC,8EAA8E;AAC9E,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,MAAM,UAAU,GAAG,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;IAC3C,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;AAC/C,CAAC;AAED,kIAAkI;AAClI,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,aAAa,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,aAAa,CAC3B,aAAqB,EACrB,QAAuB,UAAU;IAEjC,OAAO,aAAa,CAAC,KAAK,CAAC,GAAG,aAAa,CAAC;AAC9C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CACzB,aAAqB,EACrB,cAAsB,EACtB,QAAuB,UAAU,EACjC,SAAoB,OAAO;IAE3B,MAAM,MAAM,GAAe,EAAE,CAAC;IAC9B,MAAM,MAAM,GAAe,EAAE,CAAC;IAC9B,MAAM,UAAU,GAAG,aAAa,GAAG,qBAAqB,CAAC;IACzD,MAAM,WAAW,GAAG,cAAc,GAAG,sBAAsB,CAAC;IAC5D,MAAM,KAAK,GAAG,MAAM,KAAK,YAAY,CAAC;IAEtC,2EAA2E;IAC3E,uEAAuE;IACvE,6CAA6C;IAC7C,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,KAAK,IAAI,IAAI,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,IAAI,KAAK,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;QACxD,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,UAAU,GACd,KAAK,CAAC,UAAU,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,IAAI,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC;QACvE,2EAA2E;QAC3E,2EAA2E;QAC3E,4CAA4C;QAC5C,MAAM,KAAK,GAAG,KAAK;YACjB,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,KAAK,IAAI,IAAI,CAAC;YACrC,CAAC,CAAC,UAAU;gBACV,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC;gBACjB,CAAC,CAAC,IAAI,CAAC;QACX,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAE9D,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI;gBACJ,OAAO,EAAE,IAAI;gBACb,CAAC,EAAE,UAAU,GAAG,aAAa,GAAG,UAAU,GAAG,CAAC;gBAC9C,KAAK,EAAE,UAAU;gBACjB,MAAM,EAAE,WAAW;gBACnB,sEAAsE;gBACtE,uEAAuE;gBACvE,8CAA8C;gBAC9C,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;gBAC3B,IAAI;gBACJ,2DAA2D;gBAC3D,QAAQ,EAAE,cAAc,GAAG,CAAC,GAAG,gBAAgB;aAChD,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI;gBACJ,OAAO,EAAE,KAAK;gBACd,CAAC,EAAE,UAAU,GAAG,aAAa;gBAC7B,KAAK,EAAE,aAAa;gBACpB,MAAM,EAAE,cAAc;gBACtB,KAAK;gBACL,IAAI;gBACJ,QAAQ,EAAE,cAAc,GAAG,CAAC;aAC7B,CAAC,CAAC;YACH,UAAU,IAAI,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC;AAChC,CAAC"}
+{"version":3,"file":"keyboard-geometry.js","sourceRoot":"","sources":["../src/keyboard-geometry.ts"],"names":[],"mappings":"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"}

package/dist/keyboard-labels.d.ts

@@ -0,0 +1,61 @@
+/**
+ * What the keys are *called*, as against where they are.
+ *
+ * `keyboard-geometry.ts` answers where each key sits and names it from its own
+ * midi number — which is **sounding** pitch, because that is the one convention
+ * the model stores and the compass (`trackKeyboardRange`) is quoted in. That is
+ * right for everything except the one thing a reader compares a key against:
+ * the staff beside it, which in written-pitch mode is drawn through
+ * `writtenScore` and so disagrees with the keyboard by the instrument's
+ * interval.
+ *
+ * On a B-flat trumpet that disagreement is a whole tone, and it is silent: the
+ * key said `C4`, pressing it stored a sounding C4 — correctly, since the store
+ * holds sounding pitch — and the staff then drew the D4 the player reads. The
+ * note was right and the label was wrong, which is the worse of the two to
+ * debug because nothing about the score is broken.
+ *
+ * So the keys keep their sounding midi numbers — the audition, the lit keys
+ * during playback and the selected-chord marks are all keyed by it, and note
+ * entry stores it unconverted — and only the *labels* move. Press the key that
+ * reads `C4` and a C4 appears on the staff, because that key is the sounding
+ * B-flat 3 the trumpet writes as C.
+ *
+ * This is the same "one convention internally, converted at the edges" rule the
+ * inspector follows through `displayedPitchForNote`. The keyboard's edge is its
+ * lettering, so that is the only place the conversion belongs.
+ *
+ * A separate module from the geometry on purpose: nothing here is about
+ * position, and the geometry has no business knowing what a transposing
+ * instrument is.
+ */
+import { type PitchDisplay, type Track } from '@sudobility/music_types';
+import type { PianoKey } from './keyboard-geometry.js';
+/**
+ * How far a keyboard's labels move for `track`, given what the staff is showing.
+ *
+ * Zero in concert-pitch mode, zero with no track, and zero on a percussion
+ * track — `trackWrittenTransposition` already answers the last of those, since
+ * a drum staff's positions name drums rather than places in a compass. That
+ * zero is what keeps a kit's key labels ("Cl HH", "Bass Drum") out of
+ * `relabelKeys`' hands.
+ */
+export declare function keyboardLabelSemitones(track: Pick<Track, 'clef' | 'midiProgram'> | null | undefined, pitchDisplay: PitchDisplay): number;
+/**
+ * `keys` lettered `semitones` away from what they sound.
+ *
+ * Returns the **identical array** at zero, which is every concert-pitch
+ * keyboard and every non-transposing instrument — the geometry is memoized on
+ * its inputs in both apps, and a fresh array per render would re-reconcile 88
+ * keys for nothing.
+ *
+ * Two things are deliberately left alone. Which keys carry a printed `label` is
+ * unchanged: those are the C and F landmarks of the black-key groups, and they
+ * are landmarks because of where they *are* — relabelling by written name would
+ * put the printed reference on a black key with no room for it. And the
+ * spelling stays sharp, like `noteLabel`'s, because a keyboard has no key
+ * signature to spell against; this moves a name by an interval, it does not
+ * respell a score.
+ */
+export declare function relabelKeys(keys: PianoKey[], semitones: number): PianoKey[];
+//# sourceMappingURL=keyboard-labels.d.ts.map

package/dist/keyboard-labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard-labels.d.ts","sourceRoot":"","sources":["../src/keyboard-labels.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,KAAK,EACX,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAAC,GAAG,IAAI,GAAG,SAAS,EAC7D,YAAY,EAAE,YAAY,GACzB,MAAM,CAGR;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,QAAQ,EAAE,CAU3E"}

package/dist/keyboard-labels.js

@@ -0,0 +1,75 @@
+/**
+ * What the keys are *called*, as against where they are.
+ *
+ * `keyboard-geometry.ts` answers where each key sits and names it from its own
+ * midi number — which is **sounding** pitch, because that is the one convention
+ * the model stores and the compass (`trackKeyboardRange`) is quoted in. That is
+ * right for everything except the one thing a reader compares a key against:
+ * the staff beside it, which in written-pitch mode is drawn through
+ * `writtenScore` and so disagrees with the keyboard by the instrument's
+ * interval.
+ *
+ * On a B-flat trumpet that disagreement is a whole tone, and it is silent: the
+ * key said `C4`, pressing it stored a sounding C4 — correctly, since the store
+ * holds sounding pitch — and the staff then drew the D4 the player reads. The
+ * note was right and the label was wrong, which is the worse of the two to
+ * debug because nothing about the score is broken.
+ *
+ * So the keys keep their sounding midi numbers — the audition, the lit keys
+ * during playback and the selected-chord marks are all keyed by it, and note
+ * entry stores it unconverted — and only the *labels* move. Press the key that
+ * reads `C4` and a C4 appears on the staff, because that key is the sounding
+ * B-flat 3 the trumpet writes as C.
+ *
+ * This is the same "one convention internally, converted at the edges" rule the
+ * inspector follows through `displayedPitchForNote`. The keyboard's edge is its
+ * lettering, so that is the only place the conversion belongs.
+ *
+ * A separate module from the geometry on purpose: nothing here is about
+ * position, and the geometry has no business knowing what a transposing
+ * instrument is.
+ */
+import { midiToPitch, pitchToString, trackWrittenTransposition, } from '@sudobility/music_types';
+/**
+ * How far a keyboard's labels move for `track`, given what the staff is showing.
+ *
+ * Zero in concert-pitch mode, zero with no track, and zero on a percussion
+ * track — `trackWrittenTransposition` already answers the last of those, since
+ * a drum staff's positions name drums rather than places in a compass. That
+ * zero is what keeps a kit's key labels ("Cl HH", "Bass Drum") out of
+ * `relabelKeys`' hands.
+ */
+export function keyboardLabelSemitones(track, pitchDisplay) {
+    if (!track || pitchDisplay !== 'written')
+        return 0;
+    return trackWrittenTransposition(track);
+}
+/**
+ * `keys` lettered `semitones` away from what they sound.
+ *
+ * Returns the **identical array** at zero, which is every concert-pitch
+ * keyboard and every non-transposing instrument — the geometry is memoized on
+ * its inputs in both apps, and a fresh array per render would re-reconcile 88
+ * keys for nothing.
+ *
+ * Two things are deliberately left alone. Which keys carry a printed `label` is
+ * unchanged: those are the C and F landmarks of the black-key groups, and they
+ * are landmarks because of where they *are* — relabelling by written name would
+ * put the printed reference on a black key with no room for it. And the
+ * spelling stays sharp, like `noteLabel`'s, because a keyboard has no key
+ * signature to spell against; this moves a name by an interval, it does not
+ * respell a score.
+ */
+export function relabelKeys(keys, semitones) {
+    if (semitones === 0)
+        return keys;
+    return keys.map(key => {
+        const written = pitchToString(midiToPitch(key.midi + semitones));
+        return {
+            ...key,
+            label: key.label === null ? null : written,
+            name: written,
+        };
+    });
+}
+//# sourceMappingURL=keyboard-labels.js.map

package/dist/keyboard-labels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard-labels.js","sourceRoot":"","sources":["../src/keyboard-labels.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,OAAO,EACL,WAAW,EACX,aAAa,EACb,yBAAyB,GAG1B,MAAM,yBAAyB,CAAC;AAGjC;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CACpC,KAA6D,EAC7D,YAA0B;IAE1B,IAAI,CAAC,KAAK,IAAI,YAAY,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC;IACnD,OAAO,yBAAyB,CAAC,KAAK,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,WAAW,CAAC,IAAgB,EAAE,SAAiB;IAC7D,IAAI,SAAS,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACjC,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;QACpB,MAAM,OAAO,GAAG,aAAa,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC;QACjE,OAAO;YACL,GAAG,GAAG;YACN,KAAK,EAAE,GAAG,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO;YAC1C,IAAI,EAAE,OAAO;SACd,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/note-color.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"note-color.d.ts","sourceRoot":"","sources":["../src/note-color.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAkB7D;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,SAAS,GACzD,aAAa,CAUf;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAE1E;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,aAAa,EACnB,KAAK,EAAE,WAAW,EAClB,aAAa,UAAO,GACnB,MAAM,CAWR"}
+{"version":3,"file":"note-color.d.ts","sourceRoot":"","sources":["../src/note-color.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAwB7D;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,SAAS,GACzD,aAAa,CAUf;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAE1E;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,aAAa,EACnB,KAAK,EAAE,WAAW,EAClB,aAAa,UAAO,GACnB,MAAM,CAaR"}

package/dist/note-color.js

@@ -6,11 +6,17 @@
  * Pressing play clears the selection, so `playing` and `selected` do not
  * normally coexist — this ordering only resolves the case where the user
  * selects notes while playback is already running.
+ *
+ * `outOfRange` sits below all three and above `normal`: it is a property of
+ * the music rather than something the reader just did, so selecting a note the
+ * instrument cannot play still reads as selected — but an unselected one has
+ * to be visible, or the mark is worth nothing.
  */
 const PRECEDENCE = [
     'playing',
     'regenerated',
     'selected',
+    'outOfRange',
     'normal',
 ];
 /**
@@ -74,6 +80,8 @@ export function noteColorFor(role, theme, onActiveTrack = true) {
             return theme.noteRegenerated;
         case 'selected':
             return theme.noteSelected;
+        case 'outOfRange':
+            return theme.noteOutOfRange;
         case 'normal':
             return onActiveTrack ? theme.noteNormal : theme.noteInactive;
     }

package/dist/note-color.js.map

@@ -1 +1 @@
-{"version":3,"file":"note-color.js","sourceRoot":"","sources":["../src/note-color.ts"],"names":[],"mappings":"AAOA;;;;;;;;GAQG;AACH,MAAM,UAAU,GAA6B;IAC3C,SAAS;IACT,aAAa;IACb,UAAU;IACV,QAAQ;CACT,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAA2B,EAC3B,UAA0D;IAE1D,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC1D,IAAI,IAAI,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;IACjC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,IAAI,KAAK,CAAC,CAAC,IAAI,IAAI,GAAG,IAAI;YAAE,IAAI,GAAG,IAAI,CAAC;IAC9C,CAAC;IACD,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,eAAe,CAAC,IAAmB;IACjD,OAAO,EAAE,SAAS,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;AACpD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAmB,EACnB,KAAkB,EAClB,aAAa,GAAG,IAAI;IAEpB,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,SAAS;YACZ,OAAO,KAAK,CAAC,WAAW,CAAC;QAC3B,KAAK,aAAa;YAChB,OAAO,KAAK,CAAC,eAAe,CAAC;QAC/B,KAAK,UAAU;YACb,OAAO,KAAK,CAAC,YAAY,CAAC;QAC5B,KAAK,QAAQ;YACX,OAAO,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC;IACjE,CAAC;AACH,CAAC"}
+{"version":3,"file":"note-color.js","sourceRoot":"","sources":["../src/note-color.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,GAA6B;IAC3C,SAAS;IACT,aAAa;IACb,UAAU;IACV,YAAY;IACZ,QAAQ;CACT,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAA2B,EAC3B,UAA0D;IAE1D,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC1D,IAAI,IAAI,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;IACjC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,IAAI,KAAK,CAAC,CAAC,IAAI,IAAI,GAAG,IAAI;YAAE,IAAI,GAAG,IAAI,CAAC;IAC9C,CAAC;IACD,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,eAAe,CAAC,IAAmB;IACjD,OAAO,EAAE,SAAS,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;AACpD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAmB,EACnB,KAAkB,EAClB,aAAa,GAAG,IAAI;IAEpB,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,SAAS;YACZ,OAAO,KAAK,CAAC,WAAW,CAAC;QAC3B,KAAK,aAAa;YAChB,OAAO,KAAK,CAAC,eAAe,CAAC;QAC/B,KAAK,UAAU;YACb,OAAO,KAAK,CAAC,YAAY,CAAC;QAC5B,KAAK,YAAY;YACf,OAAO,KAAK,CAAC,cAAc,CAAC;QAC9B,KAAK,QAAQ;YACX,OAAO,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC;IACjE,CAAC;AACH,CAAC"}

package/dist/note-colors.d.ts

@@ -21,12 +21,22 @@ import type { NoteColorRole } from './types.js';
 export type BuildNoteColorsParams = {
     selectedIds: readonly string[];
     playingIds: readonly string[];
+    /**
+     * Notes the instrument cannot play, outside its measured compass.
+     *
+     * Written FIRST, so anything the reader did — selecting, regenerating,
+     * playing — paints over it. A note being unplayable is a property of the
+     * music and keeps; a selection is what they are doing right now.
+     */
+    outOfRangeIds?: readonly string[];
     /** When true, selected notes colour as `regenerated` rather than `selected`. */
     regenerated: boolean;
 };
-export declare function buildNoteColors({ selectedIds, playingIds, regenerated, }: BuildNoteColorsParams): Map<string, NoteColorRole>;
+export declare function buildNoteColors({ selectedIds, playingIds, outOfRangeIds, regenerated, }: BuildNoteColorsParams): Map<string, NoteColorRole>;
 export type NoteColorsForParams = {
     selectedIds: readonly string[];
+    /** Notes outside their instrument's measured compass. */
+    outOfRangeIds?: readonly string[];
     /** What the engine reports as sounding right now, across every track. */
     sounding: readonly SoundingNote[];
     /**
@@ -51,5 +61,5 @@ export type NoteColorsForParams = {
  * being read goes dark whenever it rests. The piano keyboard already showed
  * the active track alone, and this is what makes the notation agree with it.
  */
-export declare function noteColorsFor({ selectedIds, sounding, activeTrackId, regenerated, }: NoteColorsForParams): Map<string, NoteColorRole>;
+export declare function noteColorsFor({ selectedIds, outOfRangeIds, sounding, activeTrackId, regenerated, }: NoteColorsForParams): Map<string, NoteColorRole>;
 //# sourceMappingURL=note-colors.d.ts.map

package/dist/note-colors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"note-colors.d.ts","sourceRoot":"","sources":["../src/note-colors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,MAAM,qBAAqB,GAAG;IAClC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,gFAAgF;IAChF,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,wBAAgB,eAAe,CAAC,EAC9B,WAAW,EACX,UAAU,EACV,WAAW,GACZ,EAAE,qBAAqB,GAAG,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAMpD;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,yEAAyE;IACzE,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;IAClC;;;;;;OAMG;IACH,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,EAC5B,WAAW,EACX,QAAQ,EACR,aAAa,EACb,WAAW,GACZ,EAAE,mBAAmB,GAAG,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAQlD"}
+{"version":3,"file":"note-colors.d.ts","sourceRoot":"","sources":["../src/note-colors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,MAAM,qBAAqB,GAAG;IAClC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,gFAAgF;IAChF,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,wBAAgB,eAAe,CAAC,EAC9B,WAAW,EACX,UAAU,EACV,aAAa,EACb,WAAW,GACZ,EAAE,qBAAqB,GAAG,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAOpD;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,yDAAyD;IACzD,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,yEAAyE;IACzE,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;IAClC;;;;;;OAMG;IACH,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,EAC5B,WAAW,EACX,aAAa,EACb,QAAQ,EACR,aAAa,EACb,WAAW,GACZ,EAAE,mBAAmB,GAAG,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CASlD"}

package/dist/note-colors.js

@@ -1,6 +1,8 @@
-export function buildNoteColors({ selectedIds, playingIds, regenerated, }) {
+export function buildNoteColors({ selectedIds, playingIds, outOfRangeIds, regenerated, }) {
     const colors = new Map();
     const selectedRole = regenerated ? 'regenerated' : 'selected';
+    for (const id of outOfRangeIds ?? [])
+        colors.set(id, 'outOfRange');
     for (const id of selectedIds)
         colors.set(id, selectedRole);
     for (const id of playingIds)
@@ -19,9 +21,10 @@ export function buildNoteColors({ selectedIds, playingIds, regenerated, }) {
  * being read goes dark whenever it rests. The piano keyboard already showed
  * the active track alone, and this is what makes the notation agree with it.
  */
-export function noteColorsFor({ selectedIds, sounding, activeTrackId, regenerated, }) {
+export function noteColorsFor({ selectedIds, outOfRangeIds, sounding, activeTrackId, regenerated, }) {
     return buildNoteColors({
         selectedIds,
+        ...(outOfRangeIds ? { outOfRangeIds } : {}),
         playingIds: sounding
             .filter(note => note.trackId === activeTrackId)
             .map(note => note.noteId),

package/dist/note-colors.js.map

@@ -1 +1 @@
-{"version":3,"file":"note-colors.js","sourceRoot":"","sources":["../src/note-colors.ts"],"names":[],"mappings":"AA4BA,MAAM,UAAU,eAAe,CAAC,EAC9B,WAAW,EACX,UAAU,EACV,WAAW,GACW;IACtB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAyB,CAAC;IAChD,MAAM,YAAY,GAAkB,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC;IAC7E,KAAK,MAAM,EAAE,IAAI,WAAW;QAAE,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;IAC3D,KAAK,MAAM,EAAE,IAAI,UAAU;QAAE,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;IACvD,OAAO,MAAM,CAAC;AAChB,CAAC;AAiBD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAAC,EAC5B,WAAW,EACX,QAAQ,EACR,aAAa,EACb,WAAW,GACS;IACpB,OAAO,eAAe,CAAC;QACrB,WAAW;QACX,UAAU,EAAE,QAAQ;aACjB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,KAAK,aAAa,CAAC;aAC9C,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC;QAC3B,WAAW;KACZ,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"note-colors.js","sourceRoot":"","sources":["../src/note-colors.ts"],"names":[],"mappings":"AAoCA,MAAM,UAAU,eAAe,CAAC,EAC9B,WAAW,EACX,UAAU,EACV,aAAa,EACb,WAAW,GACW;IACtB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAyB,CAAC;IAChD,MAAM,YAAY,GAAkB,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC;IAC7E,KAAK,MAAM,EAAE,IAAI,aAAa,IAAI,EAAE;QAAE,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;IACnE,KAAK,MAAM,EAAE,IAAI,WAAW;QAAE,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;IAC3D,KAAK,MAAM,EAAE,IAAI,UAAU;QAAE,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;IACvD,OAAO,MAAM,CAAC;AAChB,CAAC;AAmBD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAAC,EAC5B,WAAW,EACX,aAAa,EACb,QAAQ,EACR,aAAa,EACb,WAAW,GACS;IACpB,OAAO,eAAe,CAAC;QACrB,WAAW;QACX,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3C,UAAU,EAAE,QAAQ;aACjB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,KAAK,aAAa,CAAC;aAC9C,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC;QAC3B,WAAW;KACZ,CAAC,CAAC;AACL,CAAC"}

package/dist/out-of-range.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Notes an instrument cannot play, found in a score that already holds them.
+ *
+ * Here rather than in an app for the reason `note-colors.ts` beside it gives:
+ * two apps draw this score, and "which notes are lit, and why" having two
+ * answers is how the native app came to light nothing at all during playback.
+ *
+ * The compass lives in one place — `gm-catalogue.ts`, reached through
+ * `trackKeyboardRange` — and three of the four surfaces that care already read
+ * it: the keyboard shows exactly that span, generation now states it in the
+ * prompt, and `inspect.ts` judges a generated part against it. The notation is
+ * the exception, by design: it draws what the score holds, because a score is
+ * not only ever a generated one.
+ *
+ * That is the disagreement a reader actually meets. A timpani part written a
+ * fifth below its lowest drum draws perfectly well on the stave and cannot
+ * light a single key on the keyboard — measured on one project, 482 of 1,067
+ * notes. Nothing here rewrites those notes: they are marked, and moving them
+ * by an octave is a musical decision that belongs to the person reading, not
+ * to a scan.
+ *
+ * Gated on `trackRangeIsBinding`, the same condition the server applies, so the
+ * page and the server cannot disagree about what counts as out of range. A
+ * compass nobody verified marks nothing.
+ *
+ * ## Sounding pitch, and so the STORED score
+ *
+ * Every number in `gm-catalogue.ts` is sounding pitch, and `midiIsInRange` is
+ * documented as taking one. The score this package *draws* is not: the app
+ * hands `render` a `displayScore(score, pitchDisplay)`, which in written mode
+ * has moved a B-flat clarinet up a tone and, in every mode, has moved an
+ * `8va`'s noteheads down an octave. Scanning that would place a clarinet's
+ * whole part a tone above where it sounds and mark the top of it wrongly.
+ *
+ * So this takes the **stored** score — the one the app holds, before the
+ * lenses — and the result stays correct in either display mode because it is
+ * expressed as event **ids**, which both lenses preserve: `transposeEvents`
+ * and `ottavaScore` spread `...event` and replace only `pitch`. The renderer
+ * colours by id, so "which notes" survives a transposition that changes what
+ * those notes look like. `out-of-range.test.ts` pins that with a clarinet.
+ */
+import { type MidiRange, type Score } from '@sudobility/music_types';
+export type OutOfRangeTrack = {
+    trackId: string;
+    name: string;
+    /** What the instrument can play. */
+    compass: MidiRange;
+    /** How many notes fall outside it. */
+    count: number;
+    /** The distinct pitches that do, lowest first. */
+    midis: number[];
+};
+export type OutOfRangeScan = {
+    /** Every offending note id, for the notation's colours. */
+    ids: string[];
+    /** One entry per track that has any, for the inspector's sentence. */
+    byTrack: OutOfRangeTrack[];
+};
+/**
+ * Every note `score` holds that its own instrument cannot play.
+ *
+ * `score` is the **stored** score — sounding pitch, before `displayScore`. Do
+ * not pass the score handed to `render`; see this module's doc for why, and
+ * why the ids come back usable in either display mode anyway.
+ */
+export declare function outOfRangeNoteIds(score: Score | null): OutOfRangeScan;
+//# sourceMappingURL=out-of-range.d.ts.map

package/dist/out-of-range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"out-of-range.d.ts","sourceRoot":"","sources":["../src/out-of-range.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,OAAO,EAOL,KAAK,SAAS,EACd,KAAK,KAAK,EACX,MAAM,yBAAyB,CAAC;AAEjC,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,OAAO,EAAE,SAAS,CAAC;IACnB,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,2DAA2D;IAC3D,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,sEAAsE;IACtE,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B,CAAC;AAIF;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,cAAc,CAiDrE"}

package/dist/out-of-range.js

@@ -0,0 +1,101 @@
+/**
+ * Notes an instrument cannot play, found in a score that already holds them.
+ *
+ * Here rather than in an app for the reason `note-colors.ts` beside it gives:
+ * two apps draw this score, and "which notes are lit, and why" having two
+ * answers is how the native app came to light nothing at all during playback.
+ *
+ * The compass lives in one place — `gm-catalogue.ts`, reached through
+ * `trackKeyboardRange` — and three of the four surfaces that care already read
+ * it: the keyboard shows exactly that span, generation now states it in the
+ * prompt, and `inspect.ts` judges a generated part against it. The notation is
+ * the exception, by design: it draws what the score holds, because a score is
+ * not only ever a generated one.
+ *
+ * That is the disagreement a reader actually meets. A timpani part written a
+ * fifth below its lowest drum draws perfectly well on the stave and cannot
+ * light a single key on the keyboard — measured on one project, 482 of 1,067
+ * notes. Nothing here rewrites those notes: they are marked, and moving them
+ * by an octave is a musical decision that belongs to the person reading, not
+ * to a scan.
+ *
+ * Gated on `trackRangeIsBinding`, the same condition the server applies, so the
+ * page and the server cannot disagree about what counts as out of range. A
+ * compass nobody verified marks nothing.
+ *
+ * ## Sounding pitch, and so the STORED score
+ *
+ * Every number in `gm-catalogue.ts` is sounding pitch, and `midiIsInRange` is
+ * documented as taking one. The score this package *draws* is not: the app
+ * hands `render` a `displayScore(score, pitchDisplay)`, which in written mode
+ * has moved a B-flat clarinet up a tone and, in every mode, has moved an
+ * `8va`'s noteheads down an octave. Scanning that would place a clarinet's
+ * whole part a tone above where it sounds and mark the top of it wrongly.
+ *
+ * So this takes the **stored** score — the one the app holds, before the
+ * lenses — and the result stays correct in either display mode because it is
+ * expressed as event **ids**, which both lenses preserve: `transposeEvents`
+ * and `ottavaScore` spread `...event` and replace only `pitch`. The renderer
+ * colours by id, so "which notes" survives a transposition that changes what
+ * those notes look like. `out-of-range.test.ts` pins that with a clarinet.
+ */
+import { isNoteEvent, isPercussionTrack, midiIsInRange, pitchToMidi, trackKeyboardRange, trackRangeIsBinding, } from '@sudobility/music_types';
+const EMPTY = { ids: [], byTrack: [] };
+/**
+ * Every note `score` holds that its own instrument cannot play.
+ *
+ * `score` is the **stored** score — sounding pitch, before `displayScore`. Do
+ * not pass the score handed to `render`; see this module's doc for why, and
+ * why the ids come back usable in either display mode anyway.
+ */
+export function outOfRangeNoteIds(score) {
+    if (!score)
+        return EMPTY;
+    const ids = [];
+    const byTrack = [];
+    for (const track of score.tracks) {
+        /*
+         * A drum pitch names a drum rather than a place in a compass, so this test
+         * comes FIRST and is not folded into the gate below it.
+         *
+         * `trackRangeIsBinding` answers **true** for percussion on purpose — a kit
+         * has the pieces it has, which is the right answer for note entry and for
+         * generation, where refusing an address no drum sits at is a service. It is
+         * the wrong answer here: `percussion.ts` already handles a drum outside
+         * `GM_PERCUSSION_RANGE` by parking it on the middle line as `UNMAPPED`, and
+         * colouring it as well would be two marks for one fact.
+         */
+        if (isPercussionTrack(track))
+            continue;
+        if (!trackRangeIsBinding(track))
+            continue;
+        const compass = trackKeyboardRange(track);
+        const midis = new Set();
+        let count = 0;
+        for (const measure of track.measures) {
+            for (const voice of measure.voices) {
+                for (const event of voice.events) {
+                    if (!isNoteEvent(event))
+                        continue;
+                    const midi = pitchToMidi(event.pitch);
+                    if (midiIsInRange(midi, compass))
+                        continue;
+                    ids.push(event.id);
+                    midis.add(midi);
+                    count += 1;
+                }
+            }
+        }
+        if (count > 0) {
+            byTrack.push({
+                trackId: track.id,
+                name: track.name,
+                compass,
+                count,
+                midis: [...midis].sort((a, b) => a - b),
+            });
+        }
+    }
+    return ids.length > 0 ? { ids, byTrack } : EMPTY;
+}
+//# sourceMappingURL=out-of-range.js.map

package/dist/out-of-range.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"out-of-range.js","sourceRoot":"","sources":["../src/out-of-range.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,kBAAkB,EAClB,mBAAmB,GAGpB,MAAM,yBAAyB,CAAC;AAoBjC,MAAM,KAAK,GAAmB,EAAE,GAAG,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAmB;IACnD,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,OAAO,GAAsB,EAAE,CAAC;IAEtC,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjC;;;;;;;;;;WAUG;QACH,IAAI,iBAAiB,CAAC,KAAK,CAAC;YAAE,SAAS;QACvC,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC;YAAE,SAAS;QAE1C,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;QAChC,IAAI,KAAK,GAAG,CAAC,CAAC;QAEd,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACrC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;gBACnC,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;oBACjC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;wBAAE,SAAS;oBAClC,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;oBACtC,IAAI,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC;wBAAE,SAAS;oBAC3C,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;oBACnB,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;oBAChB,KAAK,IAAI,CAAC,CAAC;gBACb,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACd,OAAO,CAAC,IAAI,CAAC;gBACX,OAAO,EAAE,KAAK,CAAC,EAAE;gBACjB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,OAAO;gBACP,KAAK;gBACL,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;aACxC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AACnD,CAAC"}

package/dist/render-theme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render-theme.d.ts","sourceRoot":"","sources":["../src/render-theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,eAAO,MAAM,kBAAkB,EAAE,WAUhC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,WAU/B,CAAC"}
+{"version":3,"file":"render-theme.d.ts","sourceRoot":"","sources":["../src/render-theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,eAAO,MAAM,kBAAkB,EAAE,WAWhC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,WAW/B,CAAC"}

package/dist/render-theme.js

@@ -5,6 +5,7 @@ export const LIGHT_RENDER_THEME = {
     noteSelected: '#6d28d9',
     noteRegenerated: '#8b5a2b',
     notePlaying: '#1565c0',
+    noteOutOfRange: '#c2185b',
     staveActive: '#000000',
     staveInactive: '#71717a',
     caret: '#d32f2f',
@@ -16,6 +17,7 @@ export const DARK_RENDER_THEME = {
     noteSelected: '#a78bfa',
     noteRegenerated: '#d9a066',
     notePlaying: '#64b5f6',
+    noteOutOfRange: '#f06292',
     staveActive: '#ffffff',
     staveInactive: '#8a8a93',
     caret: '#ef5350',

package/dist/render-theme.js.map

@@ -1 +1 @@
-{"version":3,"file":"render-theme.js","sourceRoot":"","sources":["../src/render-theme.ts"],"names":[],"mappings":"AA4BA,MAAM,CAAC,MAAM,kBAAkB,GAAgB;IAC7C,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE,SAAS;IACrB,YAAY,EAAE,SAAS;IACvB,YAAY,EAAE,SAAS;IACvB,eAAe,EAAE,SAAS;IAC1B,WAAW,EAAE,SAAS;IACtB,WAAW,EAAE,SAAS;IACtB,aAAa,EAAE,SAAS;IACxB,KAAK,EAAE,SAAS;CACjB,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAgB;IAC5C,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE,SAAS;IACrB,YAAY,EAAE,SAAS;IACvB,YAAY,EAAE,SAAS;IACvB,eAAe,EAAE,SAAS;IAC1B,WAAW,EAAE,SAAS;IACtB,WAAW,EAAE,SAAS;IACtB,aAAa,EAAE,SAAS;IACxB,KAAK,EAAE,SAAS;CACjB,CAAC"}
+{"version":3,"file":"render-theme.js","sourceRoot":"","sources":["../src/render-theme.ts"],"names":[],"mappings":"AA4BA,MAAM,CAAC,MAAM,kBAAkB,GAAgB;IAC7C,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE,SAAS;IACrB,YAAY,EAAE,SAAS;IACvB,YAAY,EAAE,SAAS;IACvB,eAAe,EAAE,SAAS;IAC1B,WAAW,EAAE,SAAS;IACtB,cAAc,EAAE,SAAS;IACzB,WAAW,EAAE,SAAS;IACtB,aAAa,EAAE,SAAS;IACxB,KAAK,EAAE,SAAS;CACjB,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAgB;IAC5C,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE,SAAS;IACrB,YAAY,EAAE,SAAS;IACvB,YAAY,EAAE,SAAS;IACvB,eAAe,EAAE,SAAS;IAC1B,WAAW,EAAE,SAAS;IACtB,cAAc,EAAE,SAAS;IACzB,WAAW,EAAE,SAAS;IACtB,aAAa,EAAE,SAAS;IACxB,KAAK,EAAE,SAAS;CACjB,CAAC"}

package/dist/test/fixtures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../src/test/fixtures.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,cAAc,8BAA8B,CAAC;AAc7C,OAAO,KAAK,EAAsB,KAAK,EAAS,MAAM,yBAAyB,CAAC;AAChF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;;;GAMG;AACH,wBAAgB,eAAe,IAAI,WAAW,CAY7C;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,YAAY,SAAK,GAAG,KAAK,CAuFlD"}
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../src/test/fixtures.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,cAAc,8BAA8B,CAAC;AAc7C,OAAO,KAAK,EAAsB,KAAK,EAAS,MAAM,yBAAyB,CAAC;AAChF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;;;GAMG;AACH,wBAAgB,eAAe,IAAI,WAAW,CAa7C;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,YAAY,SAAK,GAAG,KAAK,CAuFlD"}

package/dist/test/fixtures.js

@@ -25,6 +25,7 @@ export function testRenderTheme() {
         noteSelected: '#333333',
         noteRegenerated: '#444444',
         notePlaying: '#555555',
+        noteOutOfRange: '#999999',
         staveActive: '#666666',
         staveInactive: '#777777',
         caret: '#888888',

package/dist/test/fixtures.js.map

@@ -1 +1 @@
-{"version":3,"file":"fixtures.js","sourceRoot":"","sources":["../../src/test/fixtures.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fixtures.js","sourceRoot":"","sources":["../../src/test/fixtures.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,cAAc,8BAA8B,CAAC;AAE7C,OAAO,EACL,oBAAoB,EACpB,WAAW,EACX,QAAQ,GACT,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,OAAO,EACP,eAAe,EACf,SAAS,EACT,aAAa,EACb,YAAY,GACb,MAAM,8BAA8B,CAAC;AAItC;;;;;;GAMG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO;QACL,UAAU,EAAE,SAAS;QACrB,UAAU,EAAE,SAAS;QACrB,YAAY,EAAE,SAAS;QACvB,YAAY,EAAE,SAAS;QACvB,eAAe,EAAE,SAAS;QAC1B,WAAW,EAAE,SAAS;QACtB,cAAc,EAAE,SAAS;QACzB,WAAW,EAAE,SAAS;QACtB,aAAa,EAAE,SAAS;QACxB,KAAK,EAAE,SAAS;KACjB,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS,CAAC,YAAY,GAAG,EAAE;IACzC,MAAM,GAAG,GAAG,aAAa,EAAE,CAAC;IAC5B,MAAM,GAAG,GAAG,GAAG,CAAC;IAChB,MAAM,YAAY,GAAG,oBAAoB,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAC1D,MAAM,YAAY,GAAG,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,WAAW,CAAC;IAE1B,MAAM,MAAM,GAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;QACrC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClC,MAAM,QAAQ,GAAc,EAAE,CAAC;QAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,YAAY,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YACzC,MAAM,SAAS,GAAG,CAAC,GAAG,YAAY,CAAC;YACnC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAClC,MAAM,MAAM,GAAgB,EAAE,CAAC;YAC/B,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;gBACvC,MAAM,UAAU,GAAG,IAAI,KAAK,CAAC,CAAC;gBAC9B,MAAM,WAAW,GAAG,IAAI,KAAK,CAAC,CAAC;gBAC/B,mEAAmE;gBACnE,sEAAsE;gBACtE,2DAA2D;gBAC3D,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;gBACnB,MAAM,CAAC,IAAI,CAAC;oBACV,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC;oBACpB,kEAAkE;oBAClE,yDAAyD;oBACzD,KAAK,EAAE,YAAY,CACjB,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,EACvD,CAAC,CACF;oBACD,SAAS,EAAE,SAAS,GAAG,IAAI,GAAG,YAAY;oBAC1C,aAAa,EAAE,YAAY;oBAC3B,QAAQ,EAAE,EAAE;oBACZ,OAAO;oBACP,OAAO;oBACP,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACvD,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,WAAW,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAChE,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACxD,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,WAAW,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACjE,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,UAAU;wBAC1B,CAAC,CAAC,EAAE,YAAY,EAAE,WAAoB,EAAE;wBACxC,CAAC,CAAC,EAAE,CAAC;oBACP,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,WAAW,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACpE,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACpE,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,WAAW,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACnE,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC7D,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,WAAW,IAAI,CAAC,GAAG,CAAC;wBACpC,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE;wBACzB,CAAC,CAAC,EAAE,CAAC;iBACR,CAAC,CAAC;YACL,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC;gBACZ,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC;gBACvB,KAAK,EAAE,CAAC;gBACR,SAAS;gBACT,aAAa,EAAE,YAAY;gBAC3B,aAAa,EAAE,SAAS;gBACxB,YAAY,EAAE,OAAO;gBACrB,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;aACnD,CAAC,CAAC;QACL,CAAC;QACD,OAAO;YACL,EAAE,EAAE,OAAO;YACX,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE;YACrB,cAAc,EAAE,OAAO;YACvB,WAAW,EAAE,CAAC;YACd,WAAW,EAAE,CAAC;YACd,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,QAAkB,CAAC,CAAC,CAAE,MAAgB;YACvD,MAAM,EAAE,CAAC;YACT,GAAG,EAAE,CAAC;YACN,KAAK,EAAE,KAAK;YACZ,IAAI,EAAE,KAAK;YACX,QAAQ;SACT,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC;QACrB,OAAO,EAAE,CAAC;QACV,GAAG;QACH,QAAQ,EAAE;YACR,KAAK,EAAE,OAAO;YACd,SAAS,EAAE,eAAe;YAC1B,SAAS,EAAE,eAAe;SAC3B;QACD,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;QACxD,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -6,7 +6,7 @@
  * them rather than by editing their fields.
  */
 /** How a note is colored, by state. See `note-color.ts`'s `resolveNoteColorRole` for precedence. */
-export type NoteColorRole = 'normal' | 'selected' | 'regenerated' | 'playing';
+export type NoteColorRole = 'normal' | 'selected' | 'regenerated' | 'playing' | 'outOfRange';
 export type RenderMode = 'screen' | 'print';
 type RenderDisplayOptions = {
     renderMode?: RenderMode;
@@ -48,6 +48,18 @@ export type RenderTheme = {
     noteSelected: string;
     noteRegenerated: string;
     notePlaying: string;
+    /**
+     * A note the instrument cannot play — outside its compass in
+     * `gm-catalogue.ts`, on a program whose compass was actually measured.
+     *
+     * The notation is the one surface that will draw anything it is given: the
+     * keyboard knows the compass and simply cannot light such a note, which is
+     * what made a timpani part written a fifth too low invisible until somebody
+     * compared the two. Colour rather than an overlay, because every other note
+     * state here is colour and a second mechanism would be a second thing to
+     * reason about.
+     */
+    noteOutOfRange: string;
     /**
      * Large translucent fill behind a selected measure. Defaults to
      * `noteSelected` for existing callers, but can be softer than the selected

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,oGAAoG;AACpG,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,UAAU,GAAG,aAAa,GAAG,SAAS,CAAC;AAE9E,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE5C,KAAK,oBAAoB,GAAG;IAC1B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,UAAU,CAIvE;AAED,yEAAyE;AACzE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAE1E;AAED;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,4EAA4E;IAC5E,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;;;;;OAUG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,aAAa,EAAE,MAAM,CAAC;IACtB,oHAAoH;IACpH,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,uCAAuC;AACvC,eAAO,MAAM,SAAS,YAAY,CAAC;AAEnC;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,EAAE,WAYzC,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,0BAA0B,EAAE,WAYxC,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,iCAAkC,CAAC;AAE5D,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD,MAAM,MAAM,aAAa,GAAG;IAC1B,gGAAgG;IAChG,IAAI,EAAE,MAAM,CAAC;IACb,mGAAmG;IACnG,UAAU,EAAE,UAAU,CAAC;IACvB;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,kGAAkG;IAClG,KAAK,EAAE,MAAM,CAAC;IACd,sHAAsH;IACtH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAChD,sGAAsG;IACtG,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,4IAA4I;IAC5I,kBAAkB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACzC;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,EAAE,WAAW,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,IAAI,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,oGAAoG;AACpG,MAAM,MAAM,aAAa,GACvB,QAAQ,GAAG,UAAU,GAAG,aAAa,GAAG,SAAS,GAAG,YAAY,CAAC;AAEnE,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE5C,KAAK,oBAAoB,GAAG;IAC1B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,UAAU,CAIvE;AAED,yEAAyE;AACzE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAE1E;AAED;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,4EAA4E;IAC5E,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;;;;;OAUG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;;;;;;OAUG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,aAAa,EAAE,MAAM,CAAC;IACtB,oHAAoH;IACpH,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,uCAAuC;AACvC,eAAO,MAAM,SAAS,YAAY,CAAC;AAEnC;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,EAAE,WAazC,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,0BAA0B,EAAE,WAkBxC,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,iCAAkC,CAAC;AAE5D,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD,MAAM,MAAM,aAAa,GAAG;IAC1B,gGAAgG;IAChG,IAAI,EAAE,MAAM,CAAC;IACb,mGAAmG;IACnG,UAAU,EAAE,UAAU,CAAC;IACvB;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,kGAAkG;IAClG,KAAK,EAAE,MAAM,CAAC;IACd,sHAAsH;IACtH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAChD,sGAAsG;IACtG,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,4IAA4I;IAC5I,kBAAkB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACzC;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,EAAE,WAAW,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,IAAI,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/types.js

@@ -33,6 +33,7 @@ export const DEFAULT_SCREEN_RENDER_THEME = {
     noteSelected: '#050816',
     noteRegenerated: '#2563eb',
     notePlaying: '#0f766e',
+    noteOutOfRange: '#b91c1c',
     measureSelection: '#f59e0b',
     staveActive: '#64748b',
     staveInactive: '#c3ccd8',
@@ -47,6 +48,12 @@ export const DEFAULT_PRINT_RENDER_THEME = {
     noteSelected: PRINT_INK,
     noteRegenerated: PRINT_INK,
     notePlaying: PRINT_INK,
+    /*
+      Ink on paper, like every other state here: a printed part has no compass
+      warning to give, and a grey note among black ones reads as a mistake in
+      the printing rather than in the music.
+    */
+    noteOutOfRange: PRINT_INK,
     measureSelection: PRINT_INK,
     staveActive: PRINT_INK,
     staveInactive: PRINT_INK,

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,OAA6B;IACzD,OAAO,CACL,OAAO,CAAC,UAAU,IAAI,CAAC,OAAO,CAAC,aAAa,KAAK,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAC7E,CAAC;AACJ,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,mBAAmB,CAAC,OAA6B;IAC/D,OAAO,OAAO,CAAC,aAAa,IAAI,aAAa,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;AACtE,CAAC;AAiDD,uCAAuC;AACvC,MAAM,CAAC,MAAM,SAAS,GAAG,SAAS,CAAC;AAEnC;;;;GAIG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAgB;IACtD,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE,SAAS;IACrB,YAAY,EAAE,SAAS;IACvB,YAAY,EAAE,SAAS;IACvB,eAAe,EAAE,SAAS;IAC1B,WAAW,EAAE,SAAS;IACtB,gBAAgB,EAAE,SAAS;IAC3B,WAAW,EAAE,SAAS;IACtB,aAAa,EAAE,SAAS;IACxB,KAAK,EAAE,SAAS;IAChB,eAAe,EAAE,SAAS;CAC3B,CAAC;AAEF,uEAAuE;AACvE,MAAM,CAAC,MAAM,0BAA0B,GAAgB;IACrD,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE,SAAS;IACrB,YAAY,EAAE,SAAS;IACvB,YAAY,EAAE,SAAS;IACvB,eAAe,EAAE,SAAS;IAC1B,WAAW,EAAE,SAAS;IACtB,gBAAgB,EAAE,SAAS;IAC3B,WAAW,EAAE,SAAS;IACtB,aAAa,EAAE,SAAS;IACxB,KAAK,EAAE,SAAS;IAChB,eAAe,EAAE,SAAS;CAC3B,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,YAAY,CAAU,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,OAA6B;IACzD,OAAO,CACL,OAAO,CAAC,UAAU,IAAI,CAAC,OAAO,CAAC,aAAa,KAAK,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAC7E,CAAC;AACJ,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,mBAAmB,CAAC,OAA6B;IAC/D,OAAO,OAAO,CAAC,aAAa,IAAI,aAAa,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;AACtE,CAAC;AA6DD,uCAAuC;AACvC,MAAM,CAAC,MAAM,SAAS,GAAG,SAAS,CAAC;AAEnC;;;;GAIG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAgB;IACtD,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE,SAAS;IACrB,YAAY,EAAE,SAAS;IACvB,YAAY,EAAE,SAAS;IACvB,eAAe,EAAE,SAAS;IAC1B,WAAW,EAAE,SAAS;IACtB,cAAc,EAAE,SAAS;IACzB,gBAAgB,EAAE,SAAS;IAC3B,WAAW,EAAE,SAAS;IACtB,aAAa,EAAE,SAAS;IACxB,KAAK,EAAE,SAAS;IAChB,eAAe,EAAE,SAAS;CAC3B,CAAC;AAEF,uEAAuE;AACvE,MAAM,CAAC,MAAM,0BAA0B,GAAgB;IACrD,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE,SAAS;IACrB,YAAY,EAAE,SAAS;IACvB,YAAY,EAAE,SAAS;IACvB,eAAe,EAAE,SAAS;IAC1B,WAAW,EAAE,SAAS;IACtB;;;;MAIE;IACF,cAAc,EAAE,SAAS;IACzB,gBAAgB,EAAE,SAAS;IAC3B,WAAW,EAAE,SAAS;IACtB,aAAa,EAAE,SAAS;IACxB,KAAK,EAAE,SAAS;IAChB,eAAe,EAAE,SAAS;CAC3B,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,YAAY,CAAU,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sudobility/music_drawing",
-  "version": "0.0.30",
+  "version": "0.0.31",
   "description": "Canvas score rendering for Moosiac: layout, VexFlow drawing and the paint loop.",
   "type": "module",
   "main": "./dist/index.js",
@@ -44,11 +44,11 @@
     "vexflow": "^4.2.5"
   },
   "peerDependencies": {
-    "@sudobility/music_types": "^0.13.21"
+    "@sudobility/music_types": "^0.13.22"
   },
   "devDependencies": {
     "@eslint/js": "^9.38.0",
-    "@sudobility/music_types": "^0.13.21",
+    "@sudobility/music_types": "^0.13.22",
     "@sudobility/types": "^1.9.67",
     "@tonejs/midi": "^2.0.28",
     "@types/jsdom": "^30.0.0",