@sudobility/music_drawing 0.0.1

package/dist/measure-content.js

@@ -0,0 +1,553 @@
+/**
+ * Shared VexFlow measure-content builders (spec §7, §26): turn one domain
+ * measure into its `Stave`/`Voice`s/`Beam`s, and a track's accumulated
+ * note channels into `StaveTie`s. Consumed by `canvas-renderer.ts` per
+ * drawn system; kept renderer-agnostic (nothing here draws or touches a
+ * context/backend).
+ *
+ * Pure adapter: no store/React imports (spec §3, §37).
+ */
+import { Accidental, Beam, MultiMeasureRest, Stave, StaveModifierPosition, Barline, Curve, Modifier, Repetition, StaveHairpin, StaveLine, TextBracket, StaveTie, Tuplet, Volta, Stem, TextJustification, Voice, } from 'vexflow';
+import { isNoteEvent } from '@sudobility/music_types';
+import { clefChangesAt, effectiveClef } from '@sudobility/music_types';
+import { buildVoiceContent, keySignatureToVexSpec, pitchToVexKey, } from './convert.js';
+import { displayGroups, drumDisplayGroups } from './display-timing.js';
+import { tupletGroups } from '@sudobility/music_types';
+import { isFootDrum } from './percussion.js';
+import { pitchToMidi } from '@sudobility/music_types';
+/**
+ * Glyph scale for cue notes. VexFlow's default is 38; grace notes use a
+ * comparable reduction. Small enough to read as "not yours" at a glance,
+ * large enough to read at all.
+ */
+export const CUE_GLYPH_SCALE = 26;
+/** Cue labels are small italic by convention, and must not crowd the bar number. */
+export const CUE_LABEL_FONT_SIZE = 9;
+function sameTimeSignature(a, b) {
+    return a.numerator === b.numerator && a.denominator === b.denominator;
+}
+function sameKeySignature(a, b) {
+    return a.fifths === b.fifths && a.mode === b.mode;
+}
+/**
+ * Beams one voice's tickables — flat, and in the voice's own direction, when
+ * that voice is a drum voice.
+ *
+ * Beamed by pitch, as melodic notes are, a drum beam followed the gap between
+ * a kick and a hi-hat: it swept diagonally from above the staff down past the
+ * bottom of it. Drum notation answers that with flat beams, which is what the
+ * convention exists for. Spacers are passed through rather than filtered out,
+ * so a beam correctly stops where the voice stops playing.
+ */
+function beamsFor(tickables, stemDirection) {
+    if (stemDirection === undefined)
+        return Beam.generateBeams(tickables);
+    return Beam.generateBeams(tickables, {
+        flat_beams: true,
+        stem_direction: stemDirection,
+    });
+}
+/**
+ * Splits a drum voice into what the player's hands do and what their feet do.
+ *
+ * Feet are the bass drum and the hi-hat pedal; everything else is hands. The
+ * split exists so the two can be stemmed in opposite directions — the reason
+ * drum charts are readable at a glance.
+ */
+function splitHandsAndFeet(events) {
+    const hands = [];
+    const feet = [];
+    for (const event of events) {
+        // Rests belong to the hands: a bar of silence should show one rest, not two.
+        if (isNoteEvent(event) && isFootDrum(pitchToMidi(event.pitch)))
+            feet.push(event);
+        else
+            hands.push(event);
+    }
+    return { hands, feet };
+}
+/** Whether two bars belong to the same volta — the same numbers, in order. */
+function sameEnding(a, b) {
+    const left = a?.endingNumbers;
+    const right = b?.endingNumbers;
+    if (!left || !right)
+        return false;
+    return left.length === right.length && left.every((n, i) => n === right[i]);
+}
+/**
+ * Domain jump -> the `Repetition` VexFlow draws for it.
+ *
+ * A straight mapping: the two libraries name these the same way, unlike the
+ * mordents, because the vocabulary is fixed Italian rather than a description.
+ */
+const JUMP_REPETITION = {
+    'da-capo': Repetition.type.DC,
+    'da-capo-al-fine': Repetition.type.DC_AL_FINE,
+    'da-capo-al-coda': Repetition.type.DC_AL_CODA,
+    'dal-segno': Repetition.type.DS,
+    'dal-segno-al-fine': Repetition.type.DS_AL_FINE,
+    'dal-segno-al-coda': Repetition.type.DS_AL_CODA,
+};
+/** Builds one measure's `Stave`, its VexFlow `Voice`s, and its beams; records notes into `channels` for tie building. */
+export function buildMeasureContent(measure, track, 
+/**
+ * This measure's position in `track.measures`.
+ *
+ * Passed in rather than read off `measure.index`: a print-only part collapses
+ * runs of rests, which shortens the array while every surviving measure keeps
+ * its original `index`, so the two stop agreeing. The caller iterates the
+ * array and knows the truth.
+ */
+measureIndex, placement, prevMeasure, 
+/** The bar after this one, for deriving where a volta bracket ends. */
+nextMeasure, ppq, channels, allMetas) {
+    const { box, isFirstInSystem } = placement;
+    // A percussion track's notes name drums, not pitches, which changes both
+    // where they sit and whether an accidental could ever apply to them.
+    // The clef *in force here*, which is not `track.clef` once a part changes
+    // clef mid-piece — a piano left hand crossing into treble is the usual case.
+    const clef = effectiveClef(track, measureIndex);
+    const isPercussion = clef === 'percussion';
+    const stave = new Stave(box.x, box.y, box.width);
+    stave.setAttribute('id', measure.id);
+    // At a system start the clef is re-stated because every system states it;
+    // mid-system it is drawn only where it actually changes — exactly the rule
+    // the key signature below already follows.
+    if (isFirstInSystem || clefChangesAt(track, measureIndex)) {
+        stave.addClef(clef);
+    }
+    // A drum staff has no key: its lines are instruments, not pitches, so a
+    // signature there is meaningless — and the sharps were being drawn against
+    // notes no accidental can apply to.
+    if (!isPercussion &&
+        (isFirstInSystem ||
+            !prevMeasure ||
+            !sameKeySignature(prevMeasure.keySignature, measure.keySignature))) {
+        stave.addKeySignature(keySignatureToVexSpec(measure.keySignature));
+    }
+    if (!prevMeasure ||
+        !sameTimeSignature(prevMeasure.timeSignature, measure.timeSignature)) {
+        stave.addTimeSignature(`${measure.timeSignature.numerator}/${measure.timeSignature.denominator}`);
+    }
+    /*
+      Repeat barlines. Stave-level, not note-level: they are the walls of the
+      bar, so they belong here rather than anywhere in the note path.
+  
+      Set on both ends independently — a `:|` with no matching `|:` repeats from
+      the start of the piece, which is a real marking rather than an error.
+    */
+    if (measure.repeatStart)
+        stave.setBegBarType(Barline.type.REPEAT_BEGIN);
+    if (measure.repeatEnd)
+        stave.setEndBarType(Barline.type.REPEAT_END);
+    /*
+      A section break or the end of the piece.
+  
+      Applied *after* the repeat above and only when there is no repeat end here,
+      so a bar that both closes a repeat and ends a section keeps the `:|` — the
+      repeat is the instruction a player acts on, and a double bar drawn over it
+      would silently remove a repeat from the performance.
+    */
+    if (measure.barline && !measure.repeatEnd) {
+        stave.setEndBarType(measure.barline === 'final' ? Barline.type.END : Barline.type.DOUBLE);
+    }
+    /*
+      The navigation marks: the sign, the coda, `Fine`, `To Coda` and the jump
+      instruction itself.
+  
+      Drawn with VexFlow's `Repetition`, which places each above the stave at
+      the side an engraver puts it — the segno and coda open a section so they
+      sit on the left, while an instruction obeyed at the end of a bar sits on
+      the right. Every one is independent: a bar can carry the coda sign and a
+      `Fine`, and one can carry `To Coda` and nothing else.
+    */
+    if (measure.segno)
+        stave.addModifier(new Repetition(Repetition.type.SEGNO_LEFT, 0, 0));
+    if (measure.coda)
+        stave.addModifier(new Repetition(Repetition.type.CODA_LEFT, 0, 0));
+    if (measure.toCoda)
+        stave.addModifier(new Repetition(Repetition.type.TO_CODA, 0, 0));
+    if (measure.fine)
+        stave.addModifier(new Repetition(Repetition.type.FINE, 0, 0));
+    if (measure.jump)
+        stave.addModifier(new Repetition(JUMP_REPETITION[measure.jump], 0, 0));
+    /*
+      The volta bracket, and which pass it covers.
+  
+      Derived from the neighbours rather than stored as a span: a bar opens the
+      bracket when the bar before it is not part of the same ending, and closes
+      it when the bar after is not. Deleting a bar out of a first ending then
+      shortens the bracket instead of leaving one that points at nothing — the
+      same reason a tuplet is derived from its durations.
+    */
+    if (measure.endingNumbers?.length) {
+        const label = `${measure.endingNumbers.join(', ')}.`;
+        const opens = !sameEnding(prevMeasure, measure);
+        const closes = !sameEnding(nextMeasure, measure);
+        const type = opens
+            ? closes
+                ? Volta.type.BEGIN_END
+                : Volta.type.BEGIN
+            : closes
+                ? Volta.type.END
+                : Volta.type.MID;
+        // Only the opening bar prints the number; a continuation would repeat it
+        // under its own bracket segment.
+        stave.setVoltaType(type, opens ? label : '', 0);
+    }
+    // Boxed, because a bare letter beside a dynamic or a tempo marking is easy
+    // to miss — and a rehearsal mark that is missed has failed at its one job.
+    // Set before the multi-measure-rest return, so a marked rest still shows its
+    // letter: that bar is exactly the one a lost player is hunting for.
+    if (measure.rehearsalMark !== undefined) {
+        stave.setSection(measure.rehearsalMark, 0, 0, 12, true);
+    }
+    // A collapsed measure draws one wide rest and a numeral instead of notes.
+    // Returned rather than drawn here so the renderer keeps sole responsibility
+    // for putting ink on a context.
+    if (measure.multiMeasureRestCount !== undefined) {
+        return {
+            stave,
+            voices: [],
+            beams: [],
+            tuplets: [],
+            // The count goes in twice: VexFlow takes it positionally and also
+            // requires it in the options, which `Factory.MultiMeasureRest` fills in
+            // for you. Constructing directly means supplying both.
+            multiMeasureRest: new MultiMeasureRest(measure.multiMeasureRestCount, {
+                number_of_measures: measure.multiMeasureRestCount,
+                show_number: true,
+            }),
+        };
+    }
+    // A cue bar draws the cue and nothing else. The player's own whole-bar rest
+    // would collide with it — the canvas layout has no collision avoidance — and
+    // small notes under an instrument name already read as "not yours".
+    //
+    // Deliberately not recorded into `channels` or `allMetas`: a cue note is not
+    // the player's note, so it must never tie to one or answer a hit test.
+    if (measure.cue !== undefined) {
+        stave.setText(measure.cue.label, StaveModifierPosition.ABOVE, {
+            justification: TextJustification.LEFT,
+        });
+        // Small italic, the engraving convention for a cue label — and small
+        // enough not to crowd the measure number sitting just above it.
+        // `setText` returns the stave, not the modifier, so the StaveText has to
+        // be fetched back off the stave to restyle it.
+        const staveTexts = stave
+            .getModifiers()
+            .filter(m => m.getCategory() === 'StaveText');
+        staveTexts[staveTexts.length - 1]?.setFont({
+            family: 'serif',
+            size: CUE_LABEL_FONT_SIZE,
+            weight: 'normal',
+            style: 'italic',
+        });
+        const { tickables, notes } = buildVoiceContent(displayGroups(measure.cue.events, measure.startTick, measure.durationTicks, ppq), ppq, CUE_GLYPH_SCALE, isPercussion);
+        if (notes.length === 0)
+            return { stave, voices: [], beams: [], tuplets: [] };
+        const cueVoice = new Voice({
+            num_beats: measure.timeSignature.numerator,
+            beat_value: measure.timeSignature.denominator,
+        });
+        cueVoice.setMode(Voice.Mode.SOFT);
+        cueVoice.addTickables(tickables);
+        if (!isPercussion)
+            Accidental.applyAccidentals([cueVoice], keySignatureToVexSpec(measure.keySignature));
+        return {
+            stave,
+            voices: [cueVoice],
+            beams: beamsFor(tickables, isPercussion ? Stem.UP : undefined),
+            // A cue is a reminder of another player's line, printed small; it never
+            // carries a bracket of its own.
+            tuplets: [],
+        };
+    }
+    const voices = [];
+    const beams = [];
+    const tuplets = [];
+    /** Builds one VexFlow voice, recording its notes under `voiceOrdinal` for ties. */
+    const addVoice = (events, voiceOrdinal, stemDirection) => {
+        const { tickables, notes, metas } = buildVoiceContent(isPercussion
+            ? drumDisplayGroups(events, measure.startTick, measure.durationTicks, ppq)
+            : displayGroups(events, measure.startTick, measure.durationTicks, ppq), ppq, undefined, isPercussion);
+        if (notes.length === 0)
+            return;
+        if (stemDirection !== undefined)
+            for (const note of notes)
+                note.setStemDirection(stemDirection);
+        const vexVoice = new Voice({
+            num_beats: measure.timeSignature.numerator,
+            beat_value: measure.timeSignature.denominator,
+        });
+        // SOFT mode: don't throw if a voice's summed ticks don't exactly match
+        // the time signature (e.g. the decomposeDuration nearest-duration
+        // fallback for a non-standard remainder can be off by a few ticks).
+        vexVoice.setMode(Voice.Mode.SOFT);
+        vexVoice.addTickables(tickables);
+        voices.push(vexVoice);
+        beams.push(...beamsFor(tickables, stemDirection));
+        /*
+          Triplet brackets, derived from the durations rather than stored: three
+          notes each two thirds of a plain value *are* a triplet, and `tupletGroups`
+          reads exactly that. Built from `events` and applied to `notes` by index —
+          the two are parallel only while nothing decomposes, so a group whose
+          notes cannot be found is skipped rather than bracketing the wrong ones.
+        */
+        for (const group of tupletGroups(events, ppq)) {
+            const members = notes.slice(group.start, group.start + group.length);
+            if (members.length !== group.length)
+                continue;
+            const tuplet = new Tuplet(members, {
+                num_notes: group.actualNotes,
+                notes_occupied: group.normalNotes,
+            });
+            if (stemDirection !== undefined)
+                tuplet.setTupletLocation(stemDirection);
+            tuplets.push(tuplet);
+        }
+        const channel = channels.get(voiceOrdinal) ?? [];
+        notes.forEach((note, i) => channel.push({ note, meta: metas[i] }));
+        channels.set(voiceOrdinal, channel);
+        allMetas.push(...metas);
+    };
+    /**
+     * Whether this stave carries more than one voice with anything in it.
+     *
+     * A single voice keeps VexFlow's automatic stem direction, which is decided
+     * per note from its position on the stave and is what an engraver would do.
+     * Fixing it up on a one-voice stave would point half the notes the wrong way
+     * for no benefit.
+     */
+    const soundingVoices = measure.voices.filter(v => v.events.length > 0).length;
+    measure.voices.forEach((domainVoice, voiceOrdinal) => {
+        if (!isPercussion) {
+            // Two voices sharing a stave are told apart by their stems: the upper
+            // voice up, the lower voice down. Without this they are drawn
+            // identically and there is no way to see which line is being edited —
+            // which is the whole reason a second voice exists.
+            const stemDirection = soundingVoices > 1
+                ? voiceOrdinal === 0
+                    ? Stem.UP
+                    : Stem.DOWN
+                : undefined;
+            addVoice(domainVoice.events, voiceOrdinal, stemDirection);
+            return;
+        }
+        // A drum staff carries two voices, not one: hands stemmed up, feet stemmed
+        // down. Struck together in a single voice they became one chord, so a kick
+        // in the bottom space and a hi-hat above the top line shared one stem
+        // running the height of the staff. Splitting them is what every drum chart
+        // does, and it is the only way the two can point in opposite directions.
+        const { hands, feet } = splitHandsAndFeet(domainVoice.events);
+        addVoice(hands, voiceOrdinal, Stem.UP);
+        addVoice(feet, voiceOrdinal, Stem.DOWN);
+    });
+    // Accidental *glyphs* are decided here, once per measure, across every
+    // voice on this stave — never unconditionally per note (see convert.ts):
+    // VexFlow's own key-signature-and-context-aware logic decides whether a
+    // sharp/flat/natural is actually needed (e.g. no redundant accidental on
+    // an in-key F# in G major), reading each note's spelling straight out of
+    // the `keys` string `convert.ts` already built.
+    if (voices.length > 0) {
+        if (!isPercussion)
+            Accidental.applyAccidentals(voices, keySignatureToVexSpec(measure.keySignature));
+    }
+    return { stave, voices, beams, tuplets };
+}
+/**
+ * Ties every adjacent pair of notes in a voice-ordinal channel whose keys
+ * actually match by pitch — covers both cross-barline ties and same-measure
+ * duration-decomposition ties with one mechanism. Matches by pitch, never
+ * by array index/adjacency (a chord where only one of several members ties
+ * forward must produce exactly one `StaveTie`, on the correct key indices
+ * on each side — see `KeyTie`'s doc in convert.ts and
+ * `domain/score/ties.ts`'s `findForwardPartner`/`findBackwardPartner`,
+ * which requires the same tick/pitch/tie-flag matching for the same
+ * reason: a same-tick note sharing a channel by coincidence must not be
+ * spliced in).
+ */
+export function buildTies(channel, 
+/**
+ * Whether a note was actually drawn this frame.
+ *
+ * A tie is positioned from its two notes' Y values, which only exist once
+ * the note has been drawn — so a tie to a note on a culled (off-screen)
+ * stave throws `NoYValues` inside VexFlow. Filtering here rather than
+ * catching there is what keeps one such pair from taking the rest of the
+ * channel's ties with it.
+ */
+isDrawn = () => true) {
+    const ties = [];
+    for (let i = 0; i < channel.length - 1; i += 1) {
+        const a = channel[i];
+        const b = channel[i + 1];
+        if (a.meta.isRest || b.meta.isRest || !a.meta.tieStart || !b.meta.tieStop)
+            continue;
+        if (!isDrawn(a.note) || !isDrawn(b.note))
+            continue;
+        const firstIndices = [];
+        const lastIndices = [];
+        const usedB = new Set();
+        a.meta.keyTies.forEach((aKey, aIndex) => {
+            if (!aKey.tieStart)
+                return;
+            const aSpelling = pitchToVexKey(aKey.pitch);
+            const bIndex = b.meta.keyTies.findIndex((bKey, idx) => !usedB.has(idx) &&
+                bKey.tieStop &&
+                pitchToVexKey(bKey.pitch) === aSpelling);
+            if (bIndex === -1)
+                return;
+            usedB.add(bIndex);
+            firstIndices.push(aIndex);
+            lastIndices.push(bIndex);
+        });
+        if (firstIndices.length === 0)
+            continue;
+        ties.push(new StaveTie({
+            first_note: a.note,
+            last_note: b.note,
+            first_indices: firstIndices,
+            last_indices: lastIndices,
+        }));
+    }
+    return ties;
+}
+/**
+ * Draws each phrase mark in a channel as one curve, start note to stop note.
+ *
+ * Unlike `buildTies` this does not work on adjacent pairs: a slur spans a run
+ * of notes, and the pair to join is "the note that opened it" and "the next
+ * one that closes it". Matching is by order rather than by pitch for the same
+ * reason — a slur groups different pitches, which is what distinguishes it
+ * from a tie.
+ *
+ * `isDrawn` filters the same hazard ties have: a curve is positioned from its
+ * two notes' Y values, which only exist once they have been drawn, so one
+ * reaching a culled off-screen stave would throw inside VexFlow.
+ */
+/**
+ * Draws each hairpin in a channel as one wedge, opening note to closing note.
+ *
+ * `buildSlurs`' structure exactly, because a hairpin is the same kind of span:
+ * opened by one note, closed by a later one, matched in order rather than by
+ * pitch. It carries the same culling hazard too — a wedge is positioned from
+ * its two notes' Y values, which only exist once they have been drawn, so one
+ * reaching a culled off-screen stave throws inside VexFlow.
+ *
+ * Below the stave, where the dynamics already sit, so a level and the change
+ * between two levels read as one system rather than two.
+ */
+export function buildHairpins(channel, isDrawn = () => true) {
+    const hairpins = [];
+    let open = null;
+    for (const entry of channel) {
+        if (entry.meta.isRest)
+            continue;
+        if (!open && entry.meta.hairpinStart) {
+            open = { note: entry.note, kind: entry.meta.hairpinStart };
+            continue;
+        }
+        if (open && entry.meta.hairpinStop) {
+            if (isDrawn(open.note) && isDrawn(entry.note)) {
+                const wedge = new StaveHairpin({ first_note: open.note, last_note: entry.note }, open.kind === 'crescendo'
+                    ? StaveHairpin.type.CRESC
+                    : StaveHairpin.type.DECRESC);
+                wedge.setPosition(Modifier.Position.BELOW);
+                hairpins.push(wedge);
+            }
+            open = null;
+        }
+    }
+    // An unclosed opening draws nothing: half a wedge is not a wedge, and the
+    // command that writes these never produces one.
+    return hairpins;
+}
+/**
+ * The octave brackets in a channel, one `TextBracket` per span.
+ *
+ * Above the stave for `8va`/`15ma` and below for the `b` forms, which is where
+ * the displacement points. Culled like the curves: a bracket is positioned
+ * from its two notes, so one reaching an off-screen stave throws.
+ */
+export function buildOttavas(channel, isDrawn = () => true) {
+    const brackets = [];
+    let open = null;
+    for (const entry of channel) {
+        if (entry.meta.isRest)
+            continue;
+        if (!open && entry.meta.ottavaStart) {
+            open = { note: entry.note, kind: entry.meta.ottavaStart };
+            continue;
+        }
+        if (open && entry.meta.ottavaStop) {
+            if (isDrawn(open.note) && isDrawn(entry.note)) {
+                const above = open.kind === '8va' || open.kind === '15ma';
+                brackets.push(new TextBracket({
+                    start: open.note,
+                    stop: entry.note,
+                    text: open.kind === '8va' || open.kind === '8vb' ? '8' : '15',
+                    superscript: open.kind.slice(1),
+                    position: above
+                        ? TextBracket.Position.TOP
+                        : TextBracket.Position.BOTTOM,
+                }));
+            }
+            open = null;
+        }
+    }
+    return brackets;
+}
+/**
+ * The slides in a channel, drawn as a straight line between the two notes.
+ *
+ * VexFlow has no `Glissando`; a `StaveLine` between the notes is what its own
+ * examples use, and it is what a glissando is on the page — a line from one
+ * notehead to the next.
+ */
+export function buildGlissandos(channel, isDrawn = () => true) {
+    const lines = [];
+    let open = null;
+    for (const entry of channel) {
+        if (entry.meta.isRest)
+            continue;
+        if (!open && entry.meta.glissandoStart) {
+            open = entry;
+            continue;
+        }
+        if (open && entry.meta.glissandoStop) {
+            if (isDrawn(open.note) && isDrawn(entry.note)) {
+                lines.push(new StaveLine({
+                    first_note: open.note,
+                    last_note: entry.note,
+                    first_indices: [0],
+                    last_indices: [0],
+                }));
+            }
+            open = null;
+        }
+    }
+    return lines;
+}
+export function buildSlurs(channel, isDrawn = () => true) {
+    const slurs = [];
+    let open = null;
+    for (const entry of channel) {
+        if (entry.meta.isRest)
+            continue;
+        if (!open && entry.meta.slurStart) {
+            open = entry;
+            continue;
+        }
+        if (open && entry.meta.slurStop) {
+            if (isDrawn(open.note) && isDrawn(entry.note)) {
+                slurs.push(new Curve(open.note, entry.note, {}));
+            }
+            open = null;
+        }
+    }
+    // An unclosed start draws nothing: half a phrase mark is not a phrase mark,
+    // and the command that writes these never produces one.
+    return slurs;
+}
+//# sourceMappingURL=measure-content.js.map

package/dist/measure-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"measure-content.js","sourceRoot":"","sources":["../src/measure-content.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EACL,UAAU,EACV,IAAI,EACJ,gBAAgB,EAChB,KAAK,EACL,qBAAqB,EACrB,OAAO,EACP,KAAK,EACL,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,SAAS,EACT,WAAW,EACX,QAAQ,EACR,MAAM,EACN,KAAK,EACL,IAAI,EACJ,iBAAiB,EACjB,KAAK,GACN,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAQtD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,GACd,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAItD;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,CAAC;AAElC,oFAAoF;AACpF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAErC,SAAS,iBAAiB,CAAC,CAAgB,EAAE,CAAgB;IAC3D,OAAO,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,WAAW,CAAC;AACxE,CAAC;AAED,SAAS,gBAAgB,CAAC,CAAe,EAAE,CAAe;IACxD,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC;AACpD,CAAC;AAKD;;;;;;;;;GASG;AACH,SAAS,QAAQ,CAAC,SAA0B,EAAE,aAAsB;IAClE,IAAI,aAAa,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;IACtE,OAAO,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE;QACnC,UAAU,EAAE,IAAI;QAChB,cAAc,EAAE,aAAa;KAC9B,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,SAAS,iBAAiB,CAAC,MAAsB;IAI/C,MAAM,KAAK,GAAmB,EAAE,CAAC;IACjC,MAAM,IAAI,GAAmB,EAAE,CAAC;IAChC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,6EAA6E;QAC7E,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC5D,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;;YACd,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzB,CAAC;AAED,8EAA8E;AAC9E,SAAS,UAAU,CAAC,CAAsB,EAAE,CAAsB;IAChE,MAAM,IAAI,GAAG,CAAC,EAAE,aAAa,CAAC;IAC9B,MAAM,KAAK,GAAG,CAAC,EAAE,aAAa,CAAC;IAC/B,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAClC,OAAO,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED;;;;;GAKG;AACH,MAAM,eAAe,GAAiD;IACpE,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE;IAC7B,iBAAiB,EAAE,UAAU,CAAC,IAAI,CAAC,UAAU;IAC7C,iBAAiB,EAAE,UAAU,CAAC,IAAI,CAAC,UAAU;IAC7C,WAAW,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE;IAC/B,mBAAmB,EAAE,UAAU,CAAC,IAAI,CAAC,UAAU;IAC/C,mBAAmB,EAAE,UAAU,CAAC,IAAI,CAAC,UAAU;CAChD,CAAC;AAEF,yHAAyH;AACzH,MAAM,UAAU,mBAAmB,CACjC,OAAgB,EAChB,KAAY;AACZ;;;;;;;GAOG;AACH,YAAoB,EACpB,SAAwB,EACxB,WAAgC;AAChC,uEAAuE;AACvE,WAAgC,EAChC,GAAW,EACX,QAA8B,EAC9B,QAAoB;IASpB,MAAM,EAAE,GAAG,EAAE,eAAe,EAAE,GAAG,SAAS,CAAC;IAC3C,yEAAyE;IACzE,qEAAqE;IACrE,0EAA0E;IAC1E,6EAA6E;IAC7E,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;IAChD,MAAM,YAAY,GAAG,IAAI,KAAK,YAAY,CAAC;IAC3C,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;IACjD,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IAErC,0EAA0E;IAC1E,2EAA2E;IAC3E,2CAA2C;IAC3C,IAAI,eAAe,IAAI,aAAa,CAAC,KAAK,EAAE,YAAY,CAAC,EAAE,CAAC;QAC1D,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IACD,wEAAwE;IACxE,2EAA2E;IAC3E,oCAAoC;IACpC,IACE,CAAC,YAAY;QACb,CAAC,eAAe;YACd,CAAC,WAAW;YACZ,CAAC,gBAAgB,CAAC,WAAW,CAAC,YAAY,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC,EACpE,CAAC;QACD,KAAK,CAAC,eAAe,CAAC,qBAAqB,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;IACrE,CAAC;IACD,IACE,CAAC,WAAW;QACZ,CAAC,iBAAiB,CAAC,WAAW,CAAC,aAAa,EAAE,OAAO,CAAC,aAAa,CAAC,EACpE,CAAC;QACD,KAAK,CAAC,gBAAgB,CACpB,GAAG,OAAO,CAAC,aAAa,CAAC,SAAS,IAAI,OAAO,CAAC,aAAa,CAAC,WAAW,EAAE,CAC1E,CAAC;IACJ,CAAC;IAED;;;;;;MAME;IACF,IAAI,OAAO,CAAC,WAAW;QAAE,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACxE,IAAI,OAAO,CAAC,SAAS;QAAE,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAEpE;;;;;;;MAOE;IACF,IAAI,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;QAC1C,KAAK,CAAC,aAAa,CACjB,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CACrE,CAAC;IACJ,CAAC;IAED;;;;;;;;;MASE;IACF,IAAI,OAAO,CAAC,KAAK;QACf,KAAK,CAAC,WAAW,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACtE,IAAI,OAAO,CAAC,IAAI;QACd,KAAK,CAAC,WAAW,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACrE,IAAI,OAAO,CAAC,MAAM;QAChB,KAAK,CAAC,WAAW,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACnE,IAAI,OAAO,CAAC,IAAI;QACd,KAAK,CAAC,WAAW,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAChE,IAAI,OAAO,CAAC,IAAI;QACd,KAAK,CAAC,WAAW,CAAC,IAAI,UAAU,CAAC,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAEzE;;;;;;;;MAQE;IACF,IAAI,OAAO,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,GAAG,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;QACrD,MAAM,KAAK,GAAG,CAAC,UAAU,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,CAAC,UAAU,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACjD,MAAM,IAAI,GAAG,KAAK;YAChB,CAAC,CAAC,MAAM;gBACN,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS;gBACtB,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK;YACpB,CAAC,CAAC,MAAM;gBACN,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG;gBAChB,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;QACrB,yEAAyE;QACzE,iCAAiC;QACjC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,2EAA2E;IAC3E,2EAA2E;IAC3E,6EAA6E;IAC7E,oEAAoE;IACpE,IAAI,OAAO,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;QACxC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;IAC1D,CAAC;IAED,0EAA0E;IAC1E,4EAA4E;IAC5E,gCAAgC;IAChC,IAAI,OAAO,CAAC,qBAAqB,KAAK,SAAS,EAAE,CAAC;QAChD,OAAO;YACL,KAAK;YACL,MAAM,EAAE,EAAE;YACV,KAAK,EAAE,EAAE;YACT,OAAO,EAAE,EAAE;YACX,kEAAkE;YAClE,wEAAwE;YACxE,uDAAuD;YACvD,gBAAgB,EAAE,IAAI,gBAAgB,CAAC,OAAO,CAAC,qBAAqB,EAAE;gBACpE,kBAAkB,EAAE,OAAO,CAAC,qBAAqB;gBACjD,WAAW,EAAE,IAAI;aAClB,CAAC;SACH,CAAC;IACJ,CAAC;IAED,4EAA4E;IAC5E,6EAA6E;IAC7E,oEAAoE;IACpE,EAAE;IACF,6EAA6E;IAC7E,uEAAuE;IACvE,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QAC9B,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,qBAAqB,CAAC,KAAK,EAAE;YAC5D,aAAa,EAAE,iBAAiB,CAAC,IAAI;SACtC,CAAC,CAAC;QAEH,qEAAqE;QACrE,gEAAgE;QAChE,yEAAyE;QACzE,+CAA+C;QAC/C,MAAM,UAAU,GAAG,KAAK;aACrB,YAAY,EAAE;aACd,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,WAAW,CAAC,CAAC;QAChD,UAAU,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC;YACzC,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,mBAAmB;YACzB,MAAM,EAAE,QAAQ;YAChB,KAAK,EAAE,QAAQ;SAChB,CAAC,CAAC;QAEH,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,iBAAiB,CAC5C,aAAa,CACX,OAAO,CAAC,GAAG,CAAC,MAAM,EAClB,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,aAAa,EACrB,GAAG,CACJ,EACD,GAAG,EACH,eAAe,EACf,YAAY,CACb,CAAC;QACF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YACpB,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;QAEvD,MAAM,QAAQ,GAAG,IAAI,KAAK,CAAC;YACzB,SAAS,EAAE,OAAO,CAAC,aAAa,CAAC,SAAS;YAC1C,UAAU,EAAE,OAAO,CAAC,aAAa,CAAC,WAAW;SAC9C,CAAC,CAAC;QACH,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,QAAQ,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QACjC,IAAI,CAAC,YAAY;YACf,UAAU,CAAC,gBAAgB,CACzB,CAAC,QAAQ,CAAC,EACV,qBAAqB,CAAC,OAAO,CAAC,YAAY,CAAC,CAC5C,CAAC;QAEJ,OAAO;YACL,KAAK;YACL,MAAM,EAAE,CAAC,QAAQ,CAAC;YAClB,KAAK,EAAE,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;YAC9D,wEAAwE;YACxE,gCAAgC;YAChC,OAAO,EAAE,EAAE;SACZ,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAY,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAW,EAAE,CAAC;IACzB,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,mFAAmF;IACnF,MAAM,QAAQ,GAAG,CACf,MAAsB,EACtB,YAAoB,EACpB,aAAsB,EAChB,EAAE;QACR,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,iBAAiB,CACnD,YAAY;YACV,CAAC,CAAC,iBAAiB,CACf,MAAM,EACN,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,aAAa,EACrB,GAAG,CACJ;YACH,CAAC,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,EACxE,GAAG,EACH,SAAS,EACT,YAAY,CACb,CAAC;QACF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC/B,IAAI,aAAa,KAAK,SAAS;YAC7B,KAAK,MAAM,IAAI,IAAI,KAAK;gBAAE,IAAI,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC;QAEjE,MAAM,QAAQ,GAAG,IAAI,KAAK,CAAC;YACzB,SAAS,EAAE,OAAO,CAAC,aAAa,CAAC,SAAS;YAC1C,UAAU,EAAE,OAAO,CAAC,aAAa,CAAC,WAAW;SAC9C,CAAC,CAAC;QACH,uEAAuE;QACvE,kEAAkE;QAClE,oEAAoE;QACpE,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,QAAQ,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QACjC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC;QAElD;;;;;;UAME;QACF,KAAK,MAAM,KAAK,IAAI,YAAY,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;YAC9C,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;YACrE,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM;gBAAE,SAAS;YAC9C,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,OAAO,EAAE;gBACjC,SAAS,EAAE,KAAK,CAAC,WAAW;gBAC5B,cAAc,EAAE,KAAK,CAAC,WAAW;aAClC,CAAC,CAAC;YACH,IAAI,aAAa,KAAK,SAAS;gBAAE,MAAM,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC;YACzE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;QAED,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QACjD,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACnE,QAAQ,CAAC,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;IAC1B,CAAC,CAAC;IAEF;;;;;;;OAOG;IACH,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;IAE9E,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,YAAY,EAAE,EAAE;QACnD,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,sEAAsE;YACtE,8DAA8D;YAC9D,sEAAsE;YACtE,mDAAmD;YACnD,MAAM,aAAa,GACjB,cAAc,GAAG,CAAC;gBAChB,CAAC,CAAC,YAAY,KAAK,CAAC;oBAClB,CAAC,CAAC,IAAI,CAAC,EAAE;oBACT,CAAC,CAAC,IAAI,CAAC,IAAI;gBACb,CAAC,CAAC,SAAS,CAAC;YAChB,QAAQ,CAAC,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC;YAC1D,OAAO;QACT,CAAC;QACD,2EAA2E;QAC3E,2EAA2E;QAC3E,sEAAsE;QACtE,2EAA2E;QAC3E,yEAAyE;QACzE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,iBAAiB,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAC9D,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;QACvC,QAAQ,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,uEAAuE;IACvE,yEAAyE;IACzE,wEAAwE;IACxE,yEAAyE;IACzE,yEAAyE;IACzE,gDAAgD;IAChD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,IAAI,CAAC,YAAY;YACf,UAAU,CAAC,gBAAgB,CACzB,MAAM,EACN,qBAAqB,CAAC,OAAO,CAAC,YAAY,CAAC,CAC5C,CAAC;IACN,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC3C,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,SAAS,CACvB,OAAgB;AAChB;;;;;;;;GAQG;AACH,UAAwC,GAAG,EAAE,CAAC,IAAI;IAElD,MAAM,IAAI,GAAe,EAAE,CAAC;IAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/C,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACrB,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACzB,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO;YACvE,SAAS;QACX,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;YAAE,SAAS;QAEnD,MAAM,YAAY,GAAa,EAAE,CAAC;QAClC,MAAM,WAAW,GAAa,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;QAChC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;YACtC,IAAI,CAAC,IAAI,CAAC,QAAQ;gBAAE,OAAO;YAC3B,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC5C,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CACrC,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CACZ,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;gBACf,IAAI,CAAC,OAAO;gBACZ,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,SAAS,CAC1C,CAAC;YACF,IAAI,MAAM,KAAK,CAAC,CAAC;gBAAE,OAAO;YAC1B,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAClB,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC1B,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;QAEH,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACxC,IAAI,CAAC,IAAI,CACP,IAAI,QAAQ,CAAC;YACX,UAAU,EAAE,CAAC,CAAC,IAAI;YAClB,SAAS,EAAE,CAAC,CAAC,IAAI;YACjB,aAAa,EAAE,YAAY;YAC3B,YAAY,EAAE,WAAW;SAC1B,CAAC,CACH,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;GAYG;AACH;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAgB,EAChB,UAAwC,GAAG,EAAE,CAAC,IAAI;IAElD,MAAM,QAAQ,GAAmB,EAAE,CAAC;IACpC,IAAI,IAAI,GAGG,IAAI,CAAC;IAEhB,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM;YAAE,SAAS;QAChC,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACrC,IAAI,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YAC3D,SAAS;QACX,CAAC;QACD,IAAI,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACnC,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9C,MAAM,KAAK,GAAG,IAAI,YAAY,CAC5B,EAAE,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE,EAChD,IAAI,CAAC,IAAI,KAAK,WAAW;oBACvB,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK;oBACzB,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAC9B,CAAC;gBACF,KAAK,CAAC,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;gBAC3C,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACvB,CAAC;YACD,IAAI,GAAG,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,0EAA0E;IAC1E,gDAAgD;IAChD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAC1B,OAAgB,EAChB,UAAwC,GAAG,EAAE,CAAC,IAAI;IAElD,MAAM,QAAQ,GAAkB,EAAE,CAAC;IACnC,IAAI,IAAI,GAGG,IAAI,CAAC;IAEhB,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM;YAAE,SAAS;QAChC,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACpC,IAAI,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YAC1D,SAAS;QACX,CAAC;QACD,IAAI,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YAClC,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC;gBAC1D,QAAQ,CAAC,IAAI,CACX,IAAI,WAAW,CAAC;oBACd,KAAK,EAAE,IAAI,CAAC,IAAI;oBAChB,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,IAAI,EAAE,IAAI,CAAC,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI;oBAC7D,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;oBAC/B,QAAQ,EAAE,KAAK;wBACb,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG;wBAC1B,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,MAAM;iBAChC,CAAC,CACH,CAAC;YACJ,CAAC;YACD,IAAI,GAAG,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAgB,EAChB,UAAwC,GAAG,EAAE,CAAC,IAAI;IAElD,MAAM,KAAK,GAAgB,EAAE,CAAC;IAC9B,IAAI,IAAI,GAA2B,IAAI,CAAC;IAExC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM;YAAE,SAAS;QAChC,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YACvC,IAAI,GAAG,KAAK,CAAC;YACb,SAAS;QACX,CAAC;QACD,IAAI,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACrC,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9C,KAAK,CAAC,IAAI,CACR,IAAI,SAAS,CAAC;oBACZ,UAAU,EAAE,IAAI,CAAC,IAAI;oBACrB,SAAS,EAAE,KAAK,CAAC,IAAI;oBACrB,aAAa,EAAE,CAAC,CAAC,CAAC;oBAClB,YAAY,EAAE,CAAC,CAAC,CAAC;iBAClB,CAAC,CACH,CAAC;YACJ,CAAC;YACD,IAAI,GAAG,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,OAAgB,EAChB,UAAwC,GAAG,EAAE,CAAC,IAAI;IAElD,MAAM,KAAK,GAAY,EAAE,CAAC;IAC1B,IAAI,IAAI,GAA2B,IAAI,CAAC;IAExC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM;YAAE,SAAS;QAChC,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YAClC,IAAI,GAAG,KAAK,CAAC;YACb,SAAS;QACX,CAAC;QACD,IAAI,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChC,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9C,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;YACnD,CAAC;YACD,IAAI,GAAG,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,4EAA4E;IAC5E,wDAAwD;IACxD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/note-color.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Note color-role resolution. Pure: no VexFlow, no store, no DOM — so the
+ * precedence rule is unit-testable on its own and the canvas renderer only
+ * has to call it.
+ */
+import type { NoteColorRole, RenderTheme } from './types.js';
+/**
+ * The role to draw a VexFlow note with, given every domain event id it
+ * represents (>1 for a chord, or for one segment of a duration-decomposed
+ * long note). Ids absent from `noteColors` count as `normal`.
+ */
+export declare function resolveNoteColorRole(eventIds: readonly string[], noteColors: ReadonlyMap<string, NoteColorRole> | undefined): NoteColorRole;
+/**
+ * The non-color half of a note's state cue (spec §27: "do not rely on color
+ * alone"). The old highlight overlay carried this with solid/dashed/dotted
+ * stroke patterns; those went away with the rectangles, so the weight of the
+ * glyph carries it now — a thicker `lineWidth` on stems, flags and beams.
+ *
+ * Deliberately NOT a shadow. An earlier version added `shadowBlur` so the cue
+ * would reach a notehead too (a filled glyph, which no stroke width can
+ * thicken). Canvas shadows force the rasterizer down a separate blur pass per
+ * draw, and this is applied to precisely the notes that change most often —
+ * every note-on and note-off during playback, on the thread Tone.js schedules
+ * from. Playback hesitated. The cue is worth less than smooth audio.
+ *
+ * The cost of that trade: a *stemless* whole note now has color as its only
+ * cue. Every other note keeps the stroke-weight channel, and the selection
+ * summary in the status bar and screen-reader text still names the state.
+ *
+ * One emphasis level for every non-normal state rather than three: the
+ * perceptually important distinction is "is this note affected" versus "is it
+ * not". `selected` and `regenerated` are mutually exclusive anyway
+ * (`regenerated` is a property of the whole selection), and `playing` is
+ * transient and accompanied by the moving caret.
+ */
+export declare function noteEmphasisFor(role: NoteColorRole): {
+    lineWidth: number;
+};
+/**
+ * The theme color a role draws in.
+ *
+ * Only `normal` varies by track. A selected, regenerated or playing note keeps
+ * its state color wherever it is: those states are the reason to look at the
+ * note, and cmd-shift-click selects across every track, so dimming a selection
+ * because it is not on the active track would hide what the user just did.
+ */
+export declare function noteColorFor(role: NoteColorRole, theme: RenderTheme, onActiveTrack?: boolean): string;
+//# sourceMappingURL=note-color.d.ts.map

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

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