@sudobility/music_drawing 0.0.32 → 0.0.34

package/dist/cursor.d.ts

@@ -0,0 +1,60 @@
+import type { NotePositions } from './playhead.js';
+import type { LayoutPlan } from './layout.js';
+import type { Score } from '@sudobility/music_types';
+/** The cursor at one tick, in content px. `x` is the centre of the line. */
+export type CursorGeometry = {
+    x: number;
+    top: number;
+    height: number;
+};
+/**
+ * Tick → x for one system, as knots.
+ *
+ * `caretPositionForTick` is piecewise-linear between note onsets and bar
+ * boundaries (it interpolates between the drawn noteheads), so interpolating
+ * linearly between exactly those points reproduces it and the cursor passes
+ * through every notehead.
+ */
+export type CursorPath = {
+    /** Which system of the plan this describes. */
+    systemIndex: number;
+    /** Ascending ticks; the first is the system's first tick, the last just inside its end. */
+    ticks: number[];
+    /** Content x of each knot; never decreasing. */
+    xs: number[];
+    top: number;
+    height: number;
+    /**
+     * The gutter's right edge in **view** px. The line is hidden while it is left
+     * of this: the track info is painted over the sheet there.
+     */
+    clipLeft: number;
+};
+/**
+ * How the cursor moves: at `performance.now() === atMs` the playhead was at
+ * `tick`, advancing `ticksPerSecond`. A rate of 0 holds it at `tick`.
+ */
+export type CursorMotion = {
+    tick: number;
+    atMs: number;
+    ticksPerSecond: number;
+};
+/** The first tick of every measure, and where the score ends after them. */
+export declare function measureStartTicks(score: Score): number[];
+/** The system a tick is drawn in, or -1 for an empty plan. */
+export declare function systemIndexForTick(plan: LayoutPlan, starts: readonly number[], tick: number): number;
+/** The tick where a system's music ends (the next system's first tick). */
+export declare function systemEndTick(plan: LayoutPlan, starts: readonly number[], systemIndex: number): number;
+/** The cursor at a tick, in content px — expectation 1 of the spec. */
+export declare function cursorGeometryAt(plan: LayoutPlan, score: Score, zoom: number, tick: number, positions: NotePositions | undefined): CursorGeometry | null;
+/** The knots for the system `systemIndex`, in content px. */
+export declare function cursorPathFor(plan: LayoutPlan, score: Score, zoom: number, starts: readonly number[], systemIndex: number, positions: NotePositions | undefined): CursorPath | null;
+/** Where the playhead is at `nowMs`, per `motion`. Never before the anchor. */
+export declare function cursorTickAt(motion: CursorMotion, nowMs: number): number;
+/** Content x for a tick along a path, clamped to the path's ends. */
+export declare function cursorXAt(path: CursorPath, tick: number): number;
+/** Whether the line at content `x` shows, given the view's scroll — expectation 4. */
+export declare function cursorVisible(path: CursorPath, x: number, scrollLeft: number): boolean;
+/** Two paths draw the same line (within half a pixel). */
+export declare function sameCursorPath(a: CursorPath | null, b: CursorPath | null): boolean;
+//# sourceMappingURL=cursor.d.ts.map

package/dist/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../src/cursor.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAErD,4EAA4E;AAC5E,MAAM,MAAM,cAAc,GAAG;IAC3B,CAAC,EAAE,MAAM,CAAC;IACV,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,2FAA2F;IAC3F,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,gDAAgD;IAChD,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAKF,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,EAAE,CAUxD;AAED,8DAA8D;AAC9D,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,IAAI,EAAE,MAAM,GACX,MAAM,CASR;AAED,2EAA2E;AAC3E,wBAAgB,aAAa,CAC3B,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,WAAW,EAAE,MAAM,GAClB,MAAM,CAMR;AAED,uEAAuE;AACvE,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,aAAa,GAAG,SAAS,GACnC,cAAc,GAAG,IAAI,CAQvB;AAED,6DAA6D;AAC7D,wBAAgB,aAAa,CAC3B,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,aAAa,GAAG,SAAS,GACnC,UAAU,GAAG,IAAI,CAyCnB;AAED,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGxE;AAED,qEAAqE;AACrE,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAgBhE;AAED,sFAAsF;AACtF,wBAAgB,aAAa,CAC3B,IAAI,EAAE,UAAU,EAChB,CAAC,EAAE,MAAM,EACT,UAAU,EAAE,MAAM,GACjB,OAAO,CAET;AAED,0DAA0D;AAC1D,wBAAgB,cAAc,CAC5B,CAAC,EAAE,UAAU,GAAG,IAAI,EACpB,CAAC,EAAE,UAAU,GAAG,IAAI,GACnB,OAAO,CAiBT"}

package/dist/cursor.js

@@ -0,0 +1,157 @@
+/**
+ * The playback cursor as data: where it is, and how it moves.
+ *
+ * `ScoreCanvas` (see `docs/score-canvas.md`) hands a platform surface a
+ * `CursorPath` and a `CursorMotion` rather than a position per frame, so the
+ * surface can move the line without JavaScript on every frame. These functions
+ * are the reference for what a surface does with them; a native surface that
+ * cannot call them re-implements exactly this and nothing more.
+ *
+ * Units are **content px** (logical × zoom, scroll not subtracted) throughout,
+ * except `cursorVisible`, which takes the scroll offset because the gutter it
+ * clips against is pinned to the view.
+ */
+import { caretPositionForTick } from './playhead.js';
+import { TRACK_INFO_WIDTH } from './layout.js';
+/** Uniform samples between note onsets, for bars that have not been drawn. */
+const SAMPLE_TICKS = 120;
+/** The first tick of every measure, and where the score ends after them. */
+export function measureStartTicks(score) {
+    const measures = score.tracks[0]?.measures ?? [];
+    const starts = measures.map(measure => measure.startTick);
+    const last = measures[measures.length - 1];
+    starts.push(last
+        ? last.startTick + last.durationTicks * (last.multiMeasureRestCount ?? 1)
+        : 0);
+    return starts;
+}
+/** The system a tick is drawn in, or -1 for an empty plan. */
+export function systemIndexForTick(plan, starts, tick) {
+    for (let index = 0; index < plan.systems.length; index += 1) {
+        const indices = plan.systems[index].measureIndices;
+        const last = indices[indices.length - 1];
+        if (last === undefined)
+            continue;
+        const end = starts[last + 1] ?? Number.POSITIVE_INFINITY;
+        if (tick < end || index === plan.systems.length - 1)
+            return index;
+    }
+    return -1;
+}
+/** The tick where a system's music ends (the next system's first tick). */
+export function systemEndTick(plan, starts, systemIndex) {
+    const indices = plan.systems[systemIndex]?.measureIndices ?? [];
+    const last = indices[indices.length - 1];
+    return last === undefined
+        ? 0
+        : (starts[last + 1] ?? Number.POSITIVE_INFINITY);
+}
+/** The cursor at a tick, in content px — expectation 1 of the spec. */
+export function cursorGeometryAt(plan, score, zoom, tick, positions) {
+    const at = caretPositionForTick(plan, score, tick, positions);
+    if (!at)
+        return null;
+    return {
+        x: at.x * zoom,
+        top: at.yTop * zoom,
+        height: (at.yBottom - at.yTop) * zoom,
+    };
+}
+/** The knots for the system `systemIndex`, in content px. */
+export function cursorPathFor(plan, score, zoom, starts, systemIndex, positions) {
+    const system = plan.systems[systemIndex];
+    const indices = system?.measureIndices ?? [];
+    const first = indices[0];
+    const last = indices[indices.length - 1];
+    if (!system || first === undefined || last === undefined)
+        return null;
+    const startTick = starts[first] ?? 0;
+    // Just inside the system: its closing barline is the next system's start.
+    const endTick = Math.max(startTick, (starts[last + 1] ?? startTick) - 0.5);
+    const ticks = new Set([startTick, endTick]);
+    const measures = plan.trackLayouts[0]?.track.measures ?? [];
+    for (const measureIndex of indices) {
+        const from = starts[measureIndex] ?? startTick;
+        const to = Math.min(endTick, starts[measureIndex + 1] ?? endTick);
+        ticks.add(from);
+        for (let tick = from + SAMPLE_TICKS; tick < to; tick += SAMPLE_TICKS) {
+            ticks.add(tick);
+        }
+        const id = measures[measureIndex]?.id;
+        for (const note of (id ? positions?.get(id)?.positions : undefined) ?? []) {
+            if (note.tick >= startTick && note.tick <= endTick)
+                ticks.add(note.tick);
+        }
+    }
+    const sorted = [...ticks].sort((a, b) => a - b);
+    const xs = [];
+    let previous = Number.NEGATIVE_INFINITY;
+    for (const tick of sorted) {
+        const at = caretPositionForTick(plan, score, tick, positions);
+        previous = Math.max(previous, (at?.x ?? system.xLeft) * zoom);
+        xs.push(previous);
+    }
+    return {
+        systemIndex,
+        ticks: sorted,
+        xs,
+        top: system.yTop * zoom,
+        height: (system.yBottom - system.yTop) * zoom,
+        clipLeft: TRACK_INFO_WIDTH * zoom,
+    };
+}
+/** Where the playhead is at `nowMs`, per `motion`. Never before the anchor. */
+export function cursorTickAt(motion, nowMs) {
+    const elapsed = Math.max(0, (nowMs - motion.atMs) / 1000);
+    return motion.tick + motion.ticksPerSecond * elapsed;
+}
+/** Content x for a tick along a path, clamped to the path's ends. */
+export function cursorXAt(path, tick) {
+    const { ticks, xs } = path;
+    if (ticks.length === 0)
+        return 0;
+    if (tick <= ticks[0])
+        return xs[0];
+    const last = ticks.length - 1;
+    if (tick >= ticks[last])
+        return xs[last];
+    let lo = 0;
+    let hi = last;
+    while (hi - lo > 1) {
+        const mid = (lo + hi) >> 1;
+        if (ticks[mid] <= tick)
+            lo = mid;
+        else
+            hi = mid;
+    }
+    const span = ticks[hi] - ticks[lo];
+    if (span <= 0)
+        return xs[hi];
+    return xs[lo] + ((tick - ticks[lo]) / span) * (xs[hi] - xs[lo]);
+}
+/** Whether the line at content `x` shows, given the view's scroll — expectation 4. */
+export function cursorVisible(path, x, scrollLeft) {
+    return x - scrollLeft >= path.clipLeft;
+}
+/** Two paths draw the same line (within half a pixel). */
+export function sameCursorPath(a, b) {
+    if (a === b)
+        return true;
+    if (!a || !b)
+        return false;
+    if (a.systemIndex !== b.systemIndex ||
+        a.ticks.length !== b.ticks.length ||
+        a.top !== b.top ||
+        a.height !== b.height ||
+        a.clipLeft !== b.clipLeft) {
+        return false;
+    }
+    for (let index = 0; index < a.ticks.length; index += 1) {
+        if (a.ticks[index] !== b.ticks[index])
+            return false;
+        if (Math.abs(a.xs[index] - b.xs[index]) > 0.5)
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=cursor.js.map

package/dist/cursor.js.map

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

package/dist/index.d.ts

@@ -21,9 +21,11 @@ export * from './drawing-context.js';
 export * from './layout.js';
 export * from './pagination.js';
 export * from './print-layout.js';
+export * from './print-plan.js';
 export * from './note-colors.js';
 export * from './out-of-range.js';
 export * from './hit-test.js';
+export * from './press.js';
 export * from './track-gutter.js';
 export * from './note-drag.js';
 export * from './playback-scroll.js';
@@ -34,6 +36,14 @@ export * from './measure-content.js';
 export * from './canvas-renderer.js';
 export * from './note-color.js';
 export * from './playhead.js';
+/**
+ * The score canvas interface (`docs/score-canvas.md`): the one contract between
+ * the drawn score and what drives it, with the cursor as data and the playback
+ * binding both apps share.
+ */
+export * from './cursor.js';
+export * from './score-canvas.js';
+export * from './playback-binding.js';
 export * from './percussion.js';
 export * from './icon-canvas.js';
 /**
@@ -47,4 +57,9 @@ export * from './keyboard-geometry.js';
  * where its player reads them.
  */
 export * from './keyboard-labels.js';
+/**
+ * The two composed: a track's keys sized into a box, named, lettered for the
+ * pitch display, with label rows and fills — so neither app composes them.
+ */
+export * from './keyboard-keys.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,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"}
+{"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,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,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;AAE9B;;;;GAIG;AACH,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AAEjC;;;GAGG;AACH,cAAc,wBAAwB,CAAC;AAEvC;;;;GAIG;AACH,cAAc,sBAAsB,CAAC;AAErC;;;GAGG;AACH,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -21,9 +21,11 @@ export * from './drawing-context.js';
 export * from './layout.js';
 export * from './pagination.js';
 export * from './print-layout.js';
+export * from './print-plan.js';
 export * from './note-colors.js';
 export * from './out-of-range.js';
 export * from './hit-test.js';
+export * from './press.js';
 export * from './track-gutter.js';
 export * from './note-drag.js';
 export * from './playback-scroll.js';
@@ -34,6 +36,14 @@ export * from './measure-content.js';
 export * from './canvas-renderer.js';
 export * from './note-color.js';
 export * from './playhead.js';
+/**
+ * The score canvas interface (`docs/score-canvas.md`): the one contract between
+ * the drawn score and what drives it, with the cursor as data and the playback
+ * binding both apps share.
+ */
+export * from './cursor.js';
+export * from './score-canvas.js';
+export * from './playback-binding.js';
 export * from './percussion.js';
 export * from './icon-canvas.js';
 /**
@@ -47,4 +57,9 @@ export * from './keyboard-geometry.js';
  * where its player reads them.
  */
 export * from './keyboard-labels.js';
+/**
+ * The two composed: a track's keys sized into a box, named, lettered for the
+ * pitch display, with label rows and fills — so neither app composes them.
+ */
+export * from './keyboard-keys.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,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"}
+{"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,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,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;AAE9B;;;;GAIG;AACH,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AAEjC;;;GAGG;AACH,cAAc,wBAAwB,CAAC;AAEvC;;;;GAIG;AACH,cAAc,sBAAsB,CAAC;AAErC;;;GAGG;AACH,cAAc,oBAAoB,CAAC"}

package/dist/keyboard-geometry.d.ts

@@ -17,7 +17,7 @@
  *   │C │D │E │F │G │
  *   └──┴──┴──┴──┴──┘
  */
-import { type MidiRange } from '@sudobility/music_types';
+import { type MidiRange, type Track } 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
@@ -104,7 +104,31 @@ export type PianoKey = {
      * its neighbours'.
      */
     labelTop: number;
+    /**
+     * Outside what the instrument can play.
+     *
+     * Such a key is drawn only because the track holds notes there — an import
+     * can bring notes a real instrument cannot reach — and it cannot be played or
+     * written: a person can import a sub-octave bass layer, but not type one.
+     * Drawn dimmed (see `KEYBOARD_OUT_OF_RANGE_WHITE` / `KEYBOARD_OUT_OF_RANGE_BLACK`) so the playable span
+     * stays visible inside the widened keyboard.
+     */
+    outOfRange: boolean;
 };
+/**
+ * A white key outside the instrument's compass: pale enough to read as a key,
+ * grey enough to tell apart from the playable ones beside it.
+ */
+export declare const KEYBOARD_OUT_OF_RANGE_WHITE = "#e4e4e7";
+/**
+ * A black key outside the instrument's compass.
+ *
+ * Its own colour because the white one alone left half the dimmed span looking
+ * playable: an out-of-range octave read as pale whites with ordinary black keys
+ * between them, and the blacks are exactly as unplayable. Still dark enough to
+ * read as a black key, so the keyboard's pattern is not broken.
+ */
+export declare const KEYBOARD_OUT_OF_RANGE_BLACK = "#63636b";
 /** Height of one row of key labels, and so of the gutter a keyboard needs per row. */
 export declare const LABEL_ROW_HEIGHT = 12;
 /**
@@ -128,5 +152,29 @@ export declare function keyboardWidth(whiteKeyWidth: number, range?: KeyboardRan
  * and the blacks land on top of the whites they overlap, with no z-index
  * bookkeeping.
  */
-export declare function computeKeys(whiteKeyWidth: number, whiteKeyHeight: number, range?: KeyboardRange, naming?: KeyNaming): PianoKey[];
+export declare function computeKeys(whiteKeyWidth: number, whiteKeyHeight: number, range?: KeyboardRange, naming?: KeyNaming, 
+/** What the instrument can play; keys outside it are `outOfRange`. Null marks none. */
+playable?: MidiRange | null): PianoKey[];
+export type TrackKeyboardSpan = {
+    /** The keys to draw, snapped to whole white keys. */
+    range: KeyboardRange;
+    /**
+     * What the instrument can play, or null when its compass is not one the app
+     * enforces (`trackRangeIsBinding`) — in which case no key is marked, just as
+     * no note is flagged and no input is refused.
+     */
+    playable: MidiRange | null;
+};
+/**
+ * The keyboard for a track: its instrument's compass, widened to reach every
+ * note the track actually holds.
+ *
+ * Widened because a part can hold notes its instrument cannot play — an
+ * imported sub-octave bass layer is the usual one — and a keyboard that stopped
+ * at the compass lit no key at all for them. The widened keys are marked
+ * `outOfRange` through `playable`, which does not widen: they show what is
+ * there, they are not an invitation to write more of it. Both apps call this,
+ * so they draw the same keys and refuse the same presses.
+ */
+export declare function trackKeyboardSpan(track: Pick<Track, 'clef' | 'midiProgram' | 'measures'>): TrackKeyboardSpan;
 //# sourceMappingURL=keyboard-geometry.d.ts.map

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

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"keyboard-geometry.d.ts","sourceRoot":"","sources":["../src/keyboard-geometry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAWL,KAAK,SAAS,EACd,KAAK,KAAK,EACX,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;IACjB;;;;;;;;OAQG;IACH,UAAU,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,2BAA2B,YAAY,CAAC;AAErD;;;;;;;GAOG;AACH,eAAO,MAAM,2BAA2B,YAAY,CAAC;AAErD,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;AAC3B,uFAAuF;AACvF,QAAQ,GAAE,SAAS,GAAG,IAAW,GAChC,QAAQ,EAAE,CA2DZ;AAMD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,qDAAqD;IACrD,KAAK,EAAE,aAAa,CAAC;IACrB;;;;OAIG;IACH,QAAQ,EAAE,SAAS,GAAG,IAAI,CAAC;CAC5B,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,UAAU,CAAC,GACtD,iBAAiB,CA8BnB"}

package/dist/keyboard-geometry.js

@@ -17,7 +17,7 @@
  *   │C │D │E │F │G │
  *   └──┴──┴──┴──┴──┘
  */
-import { FULL_KEYBOARD, gmPercussion, gmPercussionName, midiToPitch, pitchToString, } from '@sudobility/music_types';
+import { FULL_KEYBOARD, gmPercussion, gmPercussionName, isNoteEvent, midiIsInRange, midiToPitch, pitchToMidi, pitchToString, trackKeyboardRange, trackRangeIsBinding, } from '@sudobility/music_types';
 /**
  * The 88-key piano — `FULL_KEYBOARD` **by identity**, not a second pair of
  * numbers that agrees with it today.
@@ -76,6 +76,20 @@ export const MIN_WHITE_KEY_WIDTH = 14;
 /** Black-key size, as a fraction of a white key. */
 export const BLACK_KEY_WIDTH_RATIO = 0.6;
 export const BLACK_KEY_HEIGHT_RATIO = 0.62;
+/**
+ * A white key outside the instrument's compass: pale enough to read as a key,
+ * grey enough to tell apart from the playable ones beside it.
+ */
+export const KEYBOARD_OUT_OF_RANGE_WHITE = '#e4e4e7';
+/**
+ * A black key outside the instrument's compass.
+ *
+ * Its own colour because the white one alone left half the dimmed span looking
+ * playable: an out-of-range octave read as pale whites with ordinary black keys
+ * between them, and the blacks are exactly as unplayable. Still dark enough to
+ * read as a black key, so the keyboard's pattern is not broken.
+ */
+export const KEYBOARD_OUT_OF_RANGE_BLACK = '#63636b';
 /** Height of one row of key labels, and so of the gutter a keyboard needs per row. */
 export const LABEL_ROW_HEIGHT = 12;
 /** True for the five black keys per octave (pitch classes 1, 3, 6, 8, 10). */
@@ -98,7 +112,9 @@ export function keyboardWidth(whiteKeyWidth, range = FULL_RANGE) {
  * and the blacks land on top of the whites they overlap, with no z-index
  * bookkeeping.
  */
-export function computeKeys(whiteKeyWidth, whiteKeyHeight, range = FULL_RANGE, naming = 'pitch') {
+export function computeKeys(whiteKeyWidth, whiteKeyHeight, range = FULL_RANGE, naming = 'pitch', 
+/** What the instrument can play; keys outside it are `outOfRange`. Null marks none. */
+playable = null) {
     const whites = [];
     const blacks = [];
     const blackWidth = whiteKeyWidth * BLACK_KEY_WIDTH_RATIO;
@@ -120,6 +136,7 @@ export function computeKeys(whiteKeyWidth, whiteKeyHeight, range = FULL_RANGE, n
                 ? noteLabel(midi)
                 : null;
         const name = drums ? gmPercussionName(midi) : noteLabel(midi);
+        const outOfRange = playable !== null && !midiIsInRange(midi, playable);
         if (isBlackKey(midi)) {
             blacks.push({
                 midi,
@@ -134,6 +151,7 @@ export function computeKeys(whiteKeyWidth, whiteKeyHeight, range = FULL_RANGE, n
                 name,
                 // Second row: clear of the white keys and of their labels.
                 labelTop: whiteKeyHeight + 1 + LABEL_ROW_HEIGHT,
+                outOfRange,
             });
         }
         else {
@@ -146,10 +164,61 @@ export function computeKeys(whiteKeyWidth, whiteKeyHeight, range = FULL_RANGE, n
                 label,
                 name,
                 labelTop: whiteKeyHeight + 1,
+                outOfRange,
             });
             whiteIndex += 1;
         }
     }
     return [...whites, ...blacks];
 }
+/** The whole MIDI note range, which an imported part may use past the piano's ends. */
+const MIDI_MIN = 0;
+const MIDI_MAX = 127;
+/**
+ * The keyboard for a track: its instrument's compass, widened to reach every
+ * note the track actually holds.
+ *
+ * Widened because a part can hold notes its instrument cannot play — an
+ * imported sub-octave bass layer is the usual one — and a keyboard that stopped
+ * at the compass lit no key at all for them. The widened keys are marked
+ * `outOfRange` through `playable`, which does not widen: they show what is
+ * there, they are not an invitation to write more of it. Both apps call this,
+ * so they draw the same keys and refuse the same presses.
+ */
+export function trackKeyboardSpan(track) {
+    const compass = trackKeyboardRange(track);
+    let min = compass.min;
+    let max = compass.max;
+    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 (midi < min)
+                    min = midi;
+                if (midi > max)
+                    max = midi;
+            }
+        }
+    }
+    // The compass itself keeps the 88-key snapping. Past it, the keyboard follows
+    // the notes as far as MIDI goes: an imported sub-bass reaches below A0, and
+    // stopping at the piano's end would light nothing for exactly those notes.
+    let { min: from, max: to } = snapToWhiteKeys(compass);
+    if (min < from) {
+        from = min;
+        while (from > MIDI_MIN && isBlackKey(from))
+            from -= 1;
+    }
+    if (max > to) {
+        to = max;
+        while (to < MIDI_MAX && isBlackKey(to))
+            to += 1;
+    }
+    return {
+        range: { min: from, max: to },
+        playable: trackRangeIsBinding(track) ? compass : null,
+    };
+}
 //# sourceMappingURL=keyboard-geometry.js.map

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,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,aAAa,GAEd,MAAM,yBAAyB,CAAC;AAejC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,UAAU,GAAkB,aAAa,CAAC;AAEvD,sDAAsD;AACtD,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,CAAC,GAAG,CAAC;AACnD,wBAAwB;AACxB,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,CAAC,GAAG,CAAC;AACnD,4EAA4E;AAC5E,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,CAAC;AAElC;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAAC,KAAoB;IAClD,IAAI,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IACtE,IAAI,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IACtE,OAAO,GAAG,GAAG,aAAa,CAAC,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC;QAAE,GAAG,IAAI,CAAC,CAAC;IAC5D,OAAO,GAAG,GAAG,aAAa,CAAC,GAAG,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-keys.d.ts

@@ -0,0 +1,93 @@
+/**
+ * The keyboard for a track, in one call: which keys, how big, what they are
+ * called, and where their labels go.
+ *
+ * Each of those was already a shared function — `trackKeyboardSpan`,
+ * `computeKeys`, `keyboardLabelSemitones`/`relabelKeys` — but the *composition*
+ * was written out in both apps, and the two compositions disagreed: the native
+ * app never relabelled a transposing part in written pitch, laid its labels
+ * inside the keys rather than in a gutter, recomputed black-key heights from
+ * the ratio, and fitted the width where the web scrolled. A keyboard is the
+ * sum of those decisions, so the sum lives here too.
+ *
+ * Web's rules are the reference: the height handed in is the whole panel, the
+ * label gutter comes out of it, and a drum kit's gutter is two rows because its
+ * black keys are named as well.
+ */
+import type { PitchDisplay, Track } from '@sudobility/music_types';
+import { type KeyNaming, type KeyboardRange, type PianoKey } from './keyboard-geometry.js';
+import type { MidiRange } from '@sudobility/music_types';
+import type { RenderTheme } from './types.js';
+/**
+ * Room below the keys for a pitched keyboard's one row of C/F labels.
+ *
+ * A little more than `LABEL_ROW_HEIGHT`, so the label clears the key's bottom
+ * edge instead of touching it.
+ */
+export declare const PITCH_LABEL_GUTTER = 14;
+/** A playable white key. */
+export declare const KEYBOARD_WHITE = "#fbfbfd";
+/** A playable black key. */
+export declare const KEYBOARD_BLACK = "#1f1f23";
+/**
+ * How the keys meet the width they are given.
+ *
+ * - `'scroll'` (web, the default): keys fill the width but never shrink below
+ *   `MIN_WHITE_KEY_WIDTH`; past that the keyboard is wider than its panel and
+ *   the panel scrolls. On a desktop a narrow window should not turn 88 keys
+ *   into slivers nobody can click.
+ * - `'width'` (native): the whole range always fits. On a phone a keyboard you
+ *   have to scroll is one you cannot play a two-handed chord on, and a finger
+ *   presses a sliver more reliably than a pointer does.
+ */
+export type KeyboardFit = 'scroll' | 'width';
+export type KeyboardKeysOptions = {
+    /** Available width. */
+    width: number;
+    /** The whole panel's height, label gutter included. */
+    height: number;
+    /** The active track; null or absent draws the whole piano with nothing marked. */
+    track: Pick<Track, 'clef' | 'midiProgram' | 'measures'> | null | undefined;
+    /** What the staff shows; moves the lettering of a transposing part. Default concert. */
+    pitchDisplay?: PitchDisplay;
+    fit?: KeyboardFit;
+};
+export type KeyboardKeys = {
+    /** The keys drawn, snapped to whole white keys. */
+    range: KeyboardRange;
+    /** What the instrument can play, or null when nothing is marked. */
+    playable: MidiRange | null;
+    naming: KeyNaming;
+    /** Whites first, then blacks — render in order and the blacks land on top. Each carries its own height and label position. */
+    keys: PianoKey[];
+    /** Height reserved under the white keys for labels. */
+    labelGutter: number;
+    /** A white key's height: `height − labelGutter`. */
+    keyHeight: number;
+    whiteKeyWidth: number;
+    /** The keyboard's total width — of `range`, not of the 88-key piano. */
+    width: number;
+};
+/**
+ * Everything a keyboard view needs to draw `track`'s keys into a box.
+ *
+ * Cheap enough to call per render (it walks the track's notes once) but it
+ * returns fresh arrays, so memoize on its inputs where the keys are reconciled.
+ */
+export declare function keyboardKeys({ width, height, track, pitchDisplay, fit, }: KeyboardKeysOptions): KeyboardKeys;
+/** What is happening to a key right now. */
+export type KeyState = {
+    /** Sounding in playback, or held down. */
+    lit: boolean;
+    /** A pitch of the one selected chord. */
+    selected: boolean;
+};
+/**
+ * The fill for `key`.
+ *
+ * Sounding wins over selected — it is the more transient signal, and a key
+ * that is both should show what is happening now — and either wins over the
+ * out-of-range dimming, which is a standing fact about the instrument.
+ */
+export declare function keyboardKeyFill(key: Pick<PianoKey, 'isBlack' | 'outOfRange'>, state: KeyState, theme: RenderTheme): string;
+//# sourceMappingURL=keyboard-keys.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard-keys.d.ts","sourceRoot":"","sources":["../src/keyboard-keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAWL,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,QAAQ,EACd,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,4BAA4B;AAC5B,eAAO,MAAM,cAAc,YAAY,CAAC;AACxC,4BAA4B;AAC5B,eAAO,MAAM,cAAc,YAAY,CAAC;AAExC;;;;;;;;;;GAUG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE7C,MAAM,MAAM,mBAAmB,GAAG;IAChC,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,kFAAkF;IAClF,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,UAAU,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IAC3E,wFAAwF;IACxF,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,GAAG,CAAC,EAAE,WAAW,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,mDAAmD;IACnD,KAAK,EAAE,aAAa,CAAC;IACrB,oEAAoE;IACpE,QAAQ,EAAE,SAAS,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,SAAS,CAAC;IAClB,8HAA8H;IAC9H,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,MAAM,EACN,KAAK,EACL,YAAwB,EACxB,GAAc,GACf,EAAE,mBAAmB,GAAG,YAAY,CAiCpC;AAED,4CAA4C;AAC5C,MAAM,MAAM,QAAQ,GAAG;IACrB,0CAA0C;IAC1C,GAAG,EAAE,OAAO,CAAC;IACb,yCAAyC;IACzC,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,GAAG,YAAY,CAAC,EAC7C,KAAK,EAAE,QAAQ,EACf,KAAK,EAAE,WAAW,GACjB,MAAM,CAMR"}