@sudobility/music_drawing 0.0.36 → 0.0.38

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

@@ -1,67 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,101 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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/press.d.ts

@@ -1,66 +0,0 @@
-/**
- * What a press on the score was: a tap, a long press, or a drag.
- *
- * Both apps answer this at the end of every press, and they answered it with
- * different numbers in different files — the web's `DRAG_THRESHOLD` inside the
- * notation view, the native app's `LONG_PRESS_MS`/`LONG_PRESS_SLOP` inside its
- * scrolling score. The question is about the canvas (did the press stay on the
- * thing under it?), so it lives beside the hit-testing that answers the next
- * question.
- *
- * ## Mouse and touch differ, on purpose
- *
- * A mouse is still: a click that moved more than 3px was meant to move, which
- * is exactly where the web's box select has always started. A finger is not —
- * a deliberate tap on a phone routinely lands several points from where it
- * touched down, and holding a finger to 3px would turn a good share of taps
- * into drags. So a touch gets `TOUCH_TAP_SLOP`, the same allowance a long press
- * already had: a press that stays put long enough to be a long press would
- * otherwise have been a *drag* had it been released a moment sooner, which is
- * not a distinction a thumb can make.
- *
- * A mouse never long-presses. It has a secondary button for the context menu,
- * and a click held while the reader looks at something is not a request for
- * one — reading it as one would change what an ordinary slow click does on the
- * web. React Native on macOS passes `'touch'`, because its gesture model is the
- * touch one: the long press is how it opens the menu.
- *
- * ## Distance
- *
- * Measured per axis (the larger of |dx| and |dy|), which is the web's existing
- * rule to the pixel. The native app used the straight-line distance; per axis
- * lets a diagonal wander up to √2 further, which is under five points at a
- * 12pt slop and not something a hand can aim at.
- *
- * The caller latches: once a press has classified as a drag it stays one even
- * if the pointer comes back, which is how the web's `drag.moved` behaves. This
- * function answers for one moment and keeps no state.
- */
-/** What produced the press. */
-export type PointerKind = 'mouse' | 'touch';
-export type PressKind = 'tap' | 'longPress' | 'drag';
-/** How far a mouse press may move and still be a click, in px (web). */
-export declare const TAP_SLOP = 3;
-/** How far a finger may move and still be a tap, in pt. */
-export declare const TOUCH_TAP_SLOP = 12;
-/** How long a press is held to be a long press — iOS's and Android's own threshold. */
-export declare const LONG_PRESS_MS = 500;
-/** How far a long press may wander — about a thumb's width. */
-export declare const LONG_PRESS_SLOP = 12;
-/** The tap slop for a pointer kind. */
-export declare function tapSlopFor(pointer: PointerKind): number;
-export type PressMeasure = {
-    /** Movement since the press began, either sign. */
-    dx: number;
-    dy: number;
-    /** How long the press has been (or was) held. */
-    heldMs: number;
-    /** Defaults to `'mouse'`, the web's rule. */
-    pointer?: PointerKind;
-};
-/**
- * `'longPress'` if a touch was held `LONG_PRESS_MS` within `LONG_PRESS_SLOP`;
- * otherwise `'tap'` if it moved no more than the tap slop; otherwise `'drag'`.
- */
-export declare function classifyPress({ dx, dy, heldMs, pointer, }: PressMeasure): PressKind;
-//# sourceMappingURL=press.d.ts.map

package/dist/press.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"press.d.ts","sourceRoot":"","sources":["../src/press.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,+BAA+B;AAC/B,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,OAAO,CAAC;AAE5C,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,WAAW,GAAG,MAAM,CAAC;AAErD,wEAAwE;AACxE,eAAO,MAAM,QAAQ,IAAI,CAAC;AAE1B,2DAA2D;AAC3D,eAAO,MAAM,cAAc,KAAK,CAAC;AAEjC,uFAAuF;AACvF,eAAO,MAAM,aAAa,MAAM,CAAC;AAEjC,+DAA+D;AAC/D,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC,uCAAuC;AACvC,wBAAgB,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAEvD;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,mDAAmD;IACnD,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAC5B,EAAE,EACF,EAAE,EACF,MAAM,EACN,OAAiB,GAClB,EAAE,YAAY,GAAG,SAAS,CAU1B"}

package/dist/press.js

@@ -1,64 +0,0 @@
-/**
- * What a press on the score was: a tap, a long press, or a drag.
- *
- * Both apps answer this at the end of every press, and they answered it with
- * different numbers in different files — the web's `DRAG_THRESHOLD` inside the
- * notation view, the native app's `LONG_PRESS_MS`/`LONG_PRESS_SLOP` inside its
- * scrolling score. The question is about the canvas (did the press stay on the
- * thing under it?), so it lives beside the hit-testing that answers the next
- * question.
- *
- * ## Mouse and touch differ, on purpose
- *
- * A mouse is still: a click that moved more than 3px was meant to move, which
- * is exactly where the web's box select has always started. A finger is not —
- * a deliberate tap on a phone routinely lands several points from where it
- * touched down, and holding a finger to 3px would turn a good share of taps
- * into drags. So a touch gets `TOUCH_TAP_SLOP`, the same allowance a long press
- * already had: a press that stays put long enough to be a long press would
- * otherwise have been a *drag* had it been released a moment sooner, which is
- * not a distinction a thumb can make.
- *
- * A mouse never long-presses. It has a secondary button for the context menu,
- * and a click held while the reader looks at something is not a request for
- * one — reading it as one would change what an ordinary slow click does on the
- * web. React Native on macOS passes `'touch'`, because its gesture model is the
- * touch one: the long press is how it opens the menu.
- *
- * ## Distance
- *
- * Measured per axis (the larger of |dx| and |dy|), which is the web's existing
- * rule to the pixel. The native app used the straight-line distance; per axis
- * lets a diagonal wander up to √2 further, which is under five points at a
- * 12pt slop and not something a hand can aim at.
- *
- * The caller latches: once a press has classified as a drag it stays one even
- * if the pointer comes back, which is how the web's `drag.moved` behaves. This
- * function answers for one moment and keeps no state.
- */
-/** How far a mouse press may move and still be a click, in px (web). */
-export const TAP_SLOP = 3;
-/** How far a finger may move and still be a tap, in pt. */
-export const TOUCH_TAP_SLOP = 12;
-/** How long a press is held to be a long press — iOS's and Android's own threshold. */
-export const LONG_PRESS_MS = 500;
-/** How far a long press may wander — about a thumb's width. */
-export const LONG_PRESS_SLOP = 12;
-/** The tap slop for a pointer kind. */
-export function tapSlopFor(pointer) {
-    return pointer === 'touch' ? TOUCH_TAP_SLOP : TAP_SLOP;
-}
-/**
- * `'longPress'` if a touch was held `LONG_PRESS_MS` within `LONG_PRESS_SLOP`;
- * otherwise `'tap'` if it moved no more than the tap slop; otherwise `'drag'`.
- */
-export function classifyPress({ dx, dy, heldMs, pointer = 'mouse', }) {
-    const moved = Math.max(Math.abs(dx), Math.abs(dy));
-    if (pointer === 'touch' &&
-        heldMs >= LONG_PRESS_MS &&
-        moved <= LONG_PRESS_SLOP) {
-        return 'longPress';
-    }
-    return moved <= tapSlopFor(pointer) ? 'tap' : 'drag';
-}
-//# sourceMappingURL=press.js.map

package/dist/press.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"press.js","sourceRoot":"","sources":["../src/press.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAOH,wEAAwE;AACxE,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAC;AAE1B,2DAA2D;AAC3D,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC;AAEjC,uFAAuF;AACvF,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC;AAEjC,+DAA+D;AAC/D,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,CAAC;AAElC,uCAAuC;AACvC,MAAM,UAAU,UAAU,CAAC,OAAoB;IAC7C,OAAO,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC;AACzD,CAAC;AAYD;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,EAC5B,EAAE,EACF,EAAE,EACF,MAAM,EACN,OAAO,GAAG,OAAO,GACJ;IACb,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACnD,IACE,OAAO,KAAK,OAAO;QACnB,MAAM,IAAI,aAAa;QACvB,KAAK,IAAI,eAAe,EACxB,CAAC;QACD,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,OAAO,KAAK,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;AACvD,CAAC"}