VexFlowEngineering reports

VexFlow since
5.0.0

A collection of all the new features, bug fixes, and and other improvements in VexFlow since v5.0.

Opening system of Chopin’s Ballade, with fingering and pedal marksFrédéric Chopin · Ballade No. 3 in A-flat major, Op. 47 Explore the score ↗
259commits
162change summaries
521visual exhibits
880declaration changes

Release trail

The range includes the tagged releases below and subsequent changes on main. The commit history gives the exact endpoint for each change.

Features

New in 5.9.0

Horizontal guitar chord frames

The same D grip turns sideways with high E on top. The open circle and two mutes sit to the left of the nut. The second grip shows the upright fifth-fret label and partial barre.

Horizontal guitar chord frames afterBefore and after

Guitar voicing lookup

The open C voicing mutes low E. The open C/E voicing sounds it. Their bass notes and every sounded pitch were checked against standard guitar tuning. A second C voicing can be selected by name.

Voicing lookup for C and C/E afterBefore and after

Five-string banjo tablature

The fifth-string TAB still reads 0 and 7. The paired staff now shows G and A, two semitones apart. Fret 7 on the full-length first string still raises its open D by seven semitones.

Short fifth string on the banjo afterBefore and after

Seven-pedal harp diagrams

Read the left-foot pedals D C B before the divider and the right-foot pedals E F G A after it. The second setting moves only F from sharp to natural.

Seven-pedal harp diagram afterBefore and after

Harp pedal changes

Starting from seven naturals, the first change prints B♭ and F♯. Repeating the setting leaves that entrance clear. Returning F to natural prints F♮.

Harp pedal changes at a rest afterBefore and after

Accordion reed registers

Compare the single middle reed, the high and low reeds together, and the double middle reeds. Each register stays with its entrance when note spacing changes.

Accordion reed registers afterBefore and after

Flute fingering diagrams

The first fingering closes L1, L2 and R1. The second also closes L3. Both diagrams keep the same hand groups and key order.

Six-key flute fingerings afterBefore and after

Moving woodwind trill keys

R2 alternates between open and closed while the other five keys keep their positions. Compare the static and moving key at both sizes.

Moving flute trill key afterBefore and after

Percussion sticking

Follow R L R R, then L R L L. The letters share a baseline on each system, clear the below-staff accent, and stay centered on their attacks through a line break.

Side-drum sticking afterBefore and after

Named Highland embellishments

Both examples land on low A. The grip plays low G, D, low G. The taorluath adds E. The earlier example enters each pitch by hand. The named forms produce the same engraving.

Highland grip and taorluath afterBefore and after

Clef-aware written key signatures

The same G4 flat and E4 sharp are placed in treble and alto. The signs keep their input order when the clef changes and return to their original positions in treble.

Clef-aware written signatures afterBefore and after

Named makam key signatures

Two passages select Sabâ by name. The edition supplies a koma flat on B and a bakiye flat on D. Selecting another edition uses that edition’s written signs.

Edition-defined makam signatures afterBefore and after

Movable four-shape notes

The C-major and D-major scales share the same degree sequence. Written E takes a square in C and an oval in D. The written pitches, quarter-note durations and key signatures are preserved.

Movable four-shape heads afterBefore and after

French lute fret letters

The top course reads a, b, c, i, k. Open bass courses 7, 8 and 9 sit below the six ruled courses and carry distinct signs.

French lute tablature afterBefore and after

Staffless German lute tablature

The four attacks read a, b, f, k on a staffless row. Changing the first attack from course 5 to course 4 changes a to b and preserves the rhythm and spacing.

German lute tablature afterBefore and after

Chant clefs and divisions

The C and F clefs move between staff lines. Written pitches follow the selected clef. The four divisions reserve space without adding musical time.

Chant clefs and divisions afterBefore and after

Syllabic square neumes

Lu-mi-na sets five pitches under three syllables. C–D rises as a podatus, E–D falls as a clivis and the final C is a punctum. The narrow example breaks before the last syllable.

Square neumes and lyrics afterBefore and after

White mensural notation

The maxima, longa and brevis retain the exercise’s four, two and one breve units. The sign row shows a circle and semicircle, each with and without a dot.

White mensural values and mensuration signs afterBefore and after

Interstaff Mensurstriche

The two internal measure boundaries run between the facing staff lines. Increasing the staff spacing lengthens both strokes. The held upper A and the two bass attacks keep their timing.

Interstaff Mensurstriche afterBefore and after

Kievan half notes

The seven half notes use the Kievan line and space forms. Moving the second pitch from D to E replaces its space form with the line form and preserves the half-note duration.

Kievan half notes afterBefore and after

Corrected sixth string in half-step-down tuning

The sixth open string now reads E♭3, one semitone below standard E3. The regression test caught the previous pitch (37) on string 6 and now passes on all six strings, including the corrected pitch (39).

Corrected tuningBefore and after

New in 5.8.0

SVG attribute filtering

The SVG renderer checks attribute names before applying them to live elements.

SVG attribute filteringSource excerpt

New engraving in five featured scores

The test gallery puts chord-frame fingerings, flared hairpins and pitched trills into complete musical phrases.

Visual test galleryCurrent

Additional barline styles

Dashed, dotted and double-heavy bars now work at stave ends and inside a voice. The upper row shows the full span. The lower row shows the shortened span. Compare the last two columns with the unchanged double-thin and final bars. The 5.7.0 panel uses single bars for the three previously unavailable styles.

Measure boundaries afterBefore and after

Bracketed editorial accidentals

Use setAsCautionary('brackets') for an editorial sign. The no-argument call still uses round parentheses. In the final chord, the plain G♯ and bracketed B♮ clear each other and their noteheads without offsets.

Editorial accidentals afterBefore and after

Double-octave clefs

Treble and bass clefs now accept 15ma and 15mb at stave and inline sizes. Follow each small clef to its quarter note. The last two columns show the existing single-octave controls. The measured bounds include the full numeral in all three browsers.

Double-octave clefs afterBefore and after

Dashed pitch ties

StaveTie.setStyle({ lineDash: '4 3' }) now draws an open dashed arc. The lower E is tied and the upper B is struck twice. The solid G tie is the control. A continuous tie with dashed: true carries the pattern and selected pitches through a system break.

Both dashed fragments after a system breakBefore and after

Laissez vibrer ties

A let-ring tie can now leave one selected head above or below the chord. The reach is measured from that head in pixels. The quarter rest still starts on beat two. The regular D tie in the last bar is the control.

Laissez vibrer ties afterBefore and after

Pitched trill cues

Both principals are half-note Gs. The parenthesized flat and head identify B-flat in the first bar. The second bar shows A with an explicit natural. Both full-size As still start on beat three. The final two bars show the plain and accidental-only controls.

Pitched trill partners afterBefore and after

Fingering inside chord frames

D major reads 1 3 2 and C major reads 3 2 1 from the lowest stopped string to the highest. In the third frame, only the G-string digit has been cleared.

Chord-frame fingerings afterBefore and after

Aligned stanza numbers

Compare 1. and 12. at the left of the first system. “Bright” and “The” stay centered on the first G. The labels appear once when the hymn wraps onto two systems.

Stanza numbers at the lyric margin afterBefore and after

Multi-measure ossias

The reduced staff covers bars 2–3. Its middle barline lines up with the main melody. After a break, the remaining six eighth notes resume above bar 3, and the ossia ends before bar 4.

Ossia split between bars 2 and 3Before and after

Figured-bass continuation lines

Read 6 above 4 on beat one. The 6 holds through beat three. The lower 4 resolves to 3 on beat two and holds through beat four, where a new 5 appears above it. The lines follow their own endpoints at both widths.

Figured bass with independent continuations afterBefore and after

Timed niente dynamics

The four-beat phrase begins at piano and arrives at niente on the last G. The earlier version rejected n, so its comparison shows the supported piano with the last beat left empty. The new version prints one niente letter on the same baseline after resizing.

Timed niente letter afterBefore and after

Flared hairpins

The flared crescendo opens to a quarter of its final aperture halfway through the mark. The diminuendo mirrors it. Compare the straight controls at the same widths. With a system break, each fragment continues the curve from the preceding system.

Flared crescendo and diminuendo afterBefore and after

Parenthesized turns

The first G carries a plain turn. The second carries the same named ornament in parentheses. The signs are included in its measured bounds and stay clear of the turn when the passage is redrawn.

Editorial turn in parentheses afterBefore and after

Half-dashed slurs

The five-note phrase changes from dashed to solid above the middle B. Both parts follow the same curve. The comparison shows the join at two widths.

Half-dashed slurs afterBefore and after

Wavy glissandi

The slide from G4 to D5 rises and the slide to A4 falls. The narrower score fits fewer waves between the heads. After a system break, each fragment keeps the direction of the slide.

Wavy pitched glissandi afterBefore and after

French-style interior stems

Compare the two middle stems with the outer stems. In the French group the middle stems end at the beam closest to the heads, leaving the gap between strips clear. The four sixteenths still occupy one beat.

French-style beaming afterBefore and after

Tuplets across measures and systems

The earlier score uses two local triplets to fit the bar durations. The new score declares six members once. Their bracket shows one 6 and continues across the break. The next quarter still lands on beat two.

Cross-bar sextuplet afterBefore and after

Independent meters on a shared pulse

The earlier renderer required separate parts for the two meters. The new score aligns twelve quarter-note attacks on two staves. The upper staff counts in threes and the lower in fours. At the break after pulse six, the lower staff resumes on beat three of its second local bar.

Independent barlines afterBefore and after

Transposing quoted cues

The clarinet part quotes the flute a written major second higher, in D major. Changing the flute’s final A to B-flat produces C natural in the cue. The attribution, cue size and clarinet rest are preserved.

Transposed flute cue afterBefore and after

Two-player conductor staves

Both flute parts come from the same source. The conductor sees “1.” for the solo, “a2” for the unison and opposing stems when the lines divide. The independent parts keep their original pitches, durations and rests.

Condensed flute staff afterBefore and after

Fret-hand fingering on tablature

The earlier version threw during formatting, so its panel shows the unmarked frets. The new fingering follows the selected string in a TAB chord. The comparison includes an open string, a nonnumeric label and an enclosed finger digit beside its fret.

Native TAB fingerings afterBefore and after

Shared unison accidentals

The shared E-sharp carries one automatic sharp. The two voices keep their notes, and each independent extraction prints its own sharp.

Shared unison accidentals afterBefore and after

TAB ties clear neighboring voices

The fitted tie accounts for the other voice’s fret digits. The comparison shows the authored and automatic sides on the sustained string.

TAB ties around fret ink afterBefore and after

Validated dashed-line patterns

Dashed-line drawing validates the pattern before changing the current path. The engraving comparison covers text brackets and circled string numbers.

Text brackets and string-number continuations before and afterIssue screenshot

Bounded beam slope fitting

Beam fitting checks both ends of a bounded slope range. Equal limits select a fixed slope. The comparison shows the default engraving on four passages.

Rising and falling beamed passages before and afterIssue screenshot

New in 5.7.0

Chord clearance across barlines

Long harmony labels reserve space on both sides of a barline. At narrow widths the sheet can wrap the measures. Short chord names retain their spacing.

Chord labels clear at the barline, short names keep their positions, and the narrow score wrapsBefore and after

Shared stems across piano staves

Heads split between two piano staves can meet one stem on the beam. Compare the same chords drawn as two independent voices.

After, four shared stems join both staves to the beamBefore and after

Transposing slash chords

A transposed passage now carries its harmony with it. The root and slash bass move by the written interval while the chord quality and N.C. remain literal.

The slash chord and altered chord transpose, and N.C. stays literalBefore and after

Ordinary beams across systems

One beam can cross a barline on a wide system. When the score wraps, its outgoing and incoming segments retain the rhythm of the same group.

One continuous beam in the wide layout, with outgoing and incoming segments on two systemsBefore and after

Whole-note and cross-staff tremolos

Measured alternating tremolos support up to four strokes. Whole notes can carry floating strokes, and a pair can span two staves at different separations.

Whole-note floating strokes, a four-stroke half-note pair and cross-staff tremolos at two staff gapsBefore and after

Bends held through ties

A bend can start on one string, keep its pitch through a tied attack, and release later. An adjacent fretted string retains its pitch through the gesture.

String three holds a whole-tone bend across a tied barline, then releases. The same gesture wraps on the right.Before and after

Two lyric syllables on one attack

Two syllables sharing one note can be joined by an undertie. Follow the first verse as the same passage reflows.

The first verse begins with la and mi joined by an undertie in both layoutsBefore and after

Glissandi across systems

A straight glissando can connect selected chord heads across a break. Both segments preserve the direction of the slide and leave room beside the heads.

Ascending and descending glissandi keep their direction and head clearance on both rowsBefore and after

Feathered beams

Secondary beams fan open or closed while the primary beam and written note durations stay fixed. The editable example lets you change the direction.

Beams open in opposite directions above a shared second beat, including after reflow2 exhibits

Niente hairpin tips

An open circle marks the closed musical tip of a crescendo or diminuendo. Wrapping the passage leaves that circle at the endpoint without adding one at the break.

Open circles mark the closed tips of both hairpins. The system break adds no circles.Before and after

New in 5.6.1

TAB clefs fit the strings

The clef sits halfway between the outer strings with clearance above and below its ink. Four-string instruments use a dedicated glyph. The examples show how the same placement adapts to different string counts.

Four-string and six-string TAB clefs after the fix5 exhibits

Time signatures on tablature

Numeric meters and the common and cut time symbols center on the tablature stave. The examples compare their positions as the number of strings changes.

Time signatures by string countCurrent

New in 5.6.0

Score lettering at reading size

Chord roots use 14 pt Academico and their extensions use 8.4 pt. Verse syllables use 12 pt. A held syllable can anchor its extender so the line clears the word and keeps its height across a system break.

Greensleeves and Kesh chord comparisons11 exhibits

Fret numbers and picking-hand letters

Tab frets use 11 pt and reserve space on both sides of the string position. Stroke arrows clear the widest fret in the chord. In the rasgueado study the accent sits between the stem and the picking-hand label “i + golpe”.

Patio al alba stroke arrows and the accent below i plus golpe before and after3 exhibits

A tied string across a system break

Select a string for a tablature tie even when the two chords list their frets in different orders. Ties and repeat endings split at system breaks and carry into an extracted guitar part.

After: the same tie and first ending on one system and across a break2 exhibits

Written rhythm on screen and paper

Structured chord notes engrave augmentation dots on each head. Rhythmic tab places the dots at the shared stem. Lead sheets retain their barlines and signature choices in printed parts. Explicit rest positions retain their ledger lines, and Bravura slash heads meet their stems at the font anchors.

Single and double dots on both chord heads and at each tab stem2 exhibits

Lead sheets in extracted parts

Compare the screen score and the printed melody part. The Cmaj7 label, lyric syllables, double bar and final bar carry through publication, including measures with a hidden time signature.

Screen and melody part with chord, lyrics and barlinesBefore and after

Ledger lines for positioned rests

Whole and half rests retain their explicit staff positions. Ledger lines support the rests outside the stave, including in ensemble scores.

After, with supported rests at the requested lines2 exhibits

Fret diagram position labels

A chord diagram uses the score’s text face for the position label. An individual diagram can override the typeface and weight.

After: Academico by default and a bold monospace overrideBefore and after

Rhythm slash stem anchors

Quarter, eighth and half slash heads now attach their stems at Bravura’s published anchors. The same correction is visible in the Harbor Song lead sheet.

The same six slash notes with stems meeting the published Bravura anchors2 exhibits

Rehearsal lettering and lyric extenders

Rehearsal lettering sits inside its frame using the measured ink. Held lyrics retain their baseline and leave room after the last letter.

Saints before and after at page width2 exhibits

New since 5.0.0

Rhythm and beaming

Extended written durations

Longa and maxima join the long-duration vocabulary. At the other end, notes can carry 256th, 512th and 1024th values with matching flags and tick counts.

Longa, maxima and short flagged notesCurrent

Tuplet labels and nesting

A suffix glyph can show a reference note alongside a tuplet number or ratio. Nested groups retain their own identity and placement, including brackets below the staff.

Suffixed TupletCurrent

Beam groups and rhythmic relationships

EasyScore builds automatic groups from the meter and explicit groupings. Tuplets, ties and beams can refer to the same managed notes and preserve strict voice timing.

EasyScore: rhythm & relationshipsCurrent

Contour and partial beams

A beam can follow a selected contour, use an explicit partial-beam side and honor flat-beam settings. Stem joins are recomputed after resize.

Narrow and wide beam examples on main and M22 exhibits

Measured tremolo

Two chords can share an alternating tremolo with explicit stroke count, occupied time and written values. The M6 study combines it with literal keyboard, wind and string instructions.

Alternating chords and playing instructionsBefore and after

Horizontal and vertical layout

Responsive sheets

Sheet groups formatted systems into rows and exposes their bounds and overflow. Retained drawing lets a host change the available width and lay out the same notes again.

Bravura after3 exhibits

Proportional and optical spacing

Strict proportional spacing aligns events against a common rhythmic timeline. Optical spacing reserves measured ink and reports a minimum width when an inline prefix or short ending needs room.

After: strict proportional spacing across voices and rational rhythms2 exhibits

Engraving measurements and profiles

Callers can inspect qualified note, stem and beam regions before drawing. Engraving policy can use staff-space units and a score-specific profile with font metadata and fallback.

After M1. The head clears the beam and all four stems meet the refitted beam.2 exhibits

Verse layout

Phrase layout assigns verses to shared baselines and draws hyphens and melisma extenders. Skipped attacks preserve the syllable sequence and alignment with the music.

Choir comparison showing two aligned verses, hyphens and melisma extenders2 exhibits

Curves and outside marks

A phrase can fit a slur past intervening ink and reserve lanes for dynamics, hairpins, pedal and octave lines. Infeasible pinned positions produce a diagnostic.

Piano comparison showing the slur above the accent, the crescendo between dynamics, the ottava and the pedal2 exhibits

Continuous system breaks

Greedy and balanced break selection use measured row costs, authored keeps and mandatory breaks. Changing width can move a complete group to another system.

Choir at wide and narrow widths3 exhibits

Spans across systems

Ties, slurs, wedges, pedals, lyrics, tuplets, endings, octave and trill lines split into indexed fragments. Labels, continuation pitch and wedge aperture follow the logical span across the break.

Vocal phrase across narrow systemsBefore and after

Grand staff and ensemble policy

Cross-staff beams and split-chord stems follow displayed staves, while empty-staff hiding and multimeasure rests preserve the original measures. Returning players retain their identity.

Piano beam and pedal, then the split chord and arpeggio3 exhibits

Pages, score and extracted parts

Publication lays out physical paper sizes, page furniture, margins, turn constraints and independent part views. SVG pages retain source IDs; cues and ossias remain distinguishable from the performing voice.

Main’s continuous opening and M5’s first printed A4 page5 exhibits

Inherited themes

Factory styles propagate through staves, notes, stems, ledger lines and separately queued marks. Element-specific colors can still highlight an individual note.

Bravura after3 exhibits

Pitch, symbols and instruments

Extended key signatures

The numbered sharps and flats syntax supports signatures beyond seven signs and explicit zero-sign keys. The key parser validates the range and preserves the requested sign family.

Eight sharps and ten flatsCurrent

Optional repeat brackets

Repeat barlines can use straight or curved bracket wings. The existing unadorned repeat remains available, including at the beginning of a stave.

Repeat bracket stylesBefore and after

Spelling, transposition and microtones

Explicit pitch spelling, ordered microtonal signatures, courtesy signs and cancellation survive construction. The clarinet study exercises a pickup and a tied spelling through an instrument change.

Quarter tones and Persian accidentalsBefore and after

Percussion profiles

A kit maps instrument names to staff positions and head shapes. The drum-set study includes a legend, mixed heads and independent voices; a second study uses a single visible staff line.

Two-voice kit with legend and the lead sheet2 exhibits

Chord typography and lead sheets

Optional font-specific kerning tightens selected chord-symbol combinations for supported font pairs. The Harbor Song study combines literal chord names, slash bass, lyrics, rhythmic slashes and a repeat.

Opt-in kerning with Academico/Bravura and Petaluma Script/Petaluma2 exhibits

Independent meter studies

A fixed six-quarter window aligns two bars of 3/4 with three bars of 2/4. The later ensemble control prints separate parts with a common rehearsal entrance. General independent-meter pagination remains a future requirement.

Clarinet pickup, independent barlines and the cadenza2 exhibits

Contemporary performance controls

An original piano-and-flute study tests the meeting point after a measured group and the limits of a white-key cluster. Conventional notation establishes a reading target for future feathered and spatial notation.

Two metered piano groups and the flute entrances3 exhibits

Guitar and rhythmic tablature

Paired notation and fret diagrams

A fretted instrument derives staff and TAB descriptions from tuning, string positions and capo. The Drop D study combines a fret frame, grace slide, prebend, hold and release.

Guitar bend and chord frame, and ordered microtonal signatures, main and M62 exhibits

Rasgueado and golpe

Each measured stroke records its finger and physical direction. Reversing the printed arrow convention preserves the performed order, and a simultaneous golpe consumes no extra time.

Rasgueado with physical arrow legend and a simultaneous golpe2 exhibits

Bossa nova accompaniment

Independent bass and chord voices preserve offbeat attacks and a three-head tie across the bar. A struck muted string has a timed X on TAB and a crosshead at its written display position.

Bossa nova with the tied chord above the changing bass and the following muted attack2 exhibits

Palm mute and timed string bend

A mute targets named strings between inclusive attacks and continues over a system break. A bend on one member of a dyad retains its semitone change and exact rise, hold and release fractions.

String six mute crosses the break, with a timed bend on string three2 exhibits

Repertoire and print editions

Petzold’s Minuet

The print edition lays out 32 bars on two Letter pages, with dynamics, ornaments, pedal markings and page furniture.

Minuet in G major · page 12 exhibits

Bach’s D minor fugue

The eight-bar web study introduces the voices. Both pages of the print edition show their development through bar 44.

Fugue No. 6 in D minor3 exhibits

Chopin’s Ballade No. 3

Follow the opening 24 bars from the carousel study to the Letter edition, including the small ossia, fingering and pedal changes.

Ballade No. 3 in A-flat major2 exhibits

When the Saints Go Marching In

The jazz arrangement pairs reharmonized chord changes with lyrics. The handwritten music face distinguishes the lead sheet from the keyboard studies.

When the Saints Go Marching InCurrent

Greensleeves and High Wire

Compare the guitar chord melody with an electric lead part. The two examples use paired notation and tab to show harmony, legato and technique markings.

Greensleeves2 exhibits

The Kesh Jig and Bach’s Prelude

The jig marks sections and grace notes in a dance tune. The Prelude uses groups of repeated arpeggios, dynamics and articulation on a grand staff.

The Kesh Jig2 exhibits

Pocket Change and Narrow Steps

The drum study assigns rhythms to kit voices. The microtonal study shows how unfamiliar accidentals read in a short melodic passage.

Pocket Change2 exhibits

Bug fixes

Engraving corrections

Unisons, voices and accidentals

Three enharmonically distinct heads on one line now remain visible. Shared positions and accidental columns are ordered consistently across voices, and four close voices reserve separate columns where needed.

Altered unison and four voices on main and M22 exhibits

Stem attachment to X heads

Stems use the SMuFL attachment for X noteheads. This affects percussion and muted notes where the old join visibly missed the head.

Drum Chord HeadsBefore and after

Beams between attacks

A beamed middle voice now clears a lower head at the shared attack. Later clearance checks include intervening heads between beamed attacks and preserve stem joins after reflow.

Corrected beam2 exhibits

Automatic stems across a beam group

EasyScore resolves automatic stem direction for the complete group before drawing. The regression includes a group passing through the middle staff line.

After: EasyScore automatically chooses a shared beam direction2 exhibits

Tuplet bracket clearance

Brackets now reserve space above mixed marks and beneath the reference triplet. Nested groups and auxiliary ornament signs contribute to the measured clearance.

Vertical alignment - many mixed elementsBefore and after

Opening direction of curves

Upward and downward slurs now follow the requested opening and clear the intervening group in both reference passages. Endpoints remain attached to the intended notes.

Opening Direction - upBefore and after

Bends on adjacent strings

Multiple bends on one chord are ordered and nested by string. The half bend sits inside the full bend and two quarter bends remain traceable to their own arrows.

Corrected bends2 exhibits

Rests against sounding voices

Rest placement checks the other voice’s chord and stem at the same rhythmic position. The comparison shows the additional vertical clearance.

Rest clearance across voices2 exhibits

Pedal beneath annotations

The pedal baseline accounts for intervening bottom annotations along the span. Text, brackets and change notches share the resulting reservation.

Pedal clears bottom annotations2 exhibits

Grace group measurement

A formatted grace group exposes bounds before drawing. Repeated queries preserve the note positions and the group continues to use the parent staff.

Grace group bounding box2 exhibits

Grace TAB fret size

Explicit and default grace fret sizes now affect both text and measured width. Multi-digit fret numbers stay centered even after ghost-note changes.

Grace TAB fret sizing2 exhibits

Grace accidentals and side

Ordered grace accidental policy resolves before-groups, hosts and after-groups in sequence. Groups attached to opposite sides reserve separate space and their slurs meet the appropriate head edges.

Main and M2 grace slurs, tuplet and ornament clearance, and optical spacing2 exhibits

Text fonts and lyric baselines

Annotations prefer the text face while notation glyphs retain the music face. Lyric syllables can share an explicit baseline across notes with different stems and pitches.

Text and music font order4 exhibits

Ties beneath lyrics

Lyric widths no longer shorten a note-to-note tie. Both endpoints follow the noteheads independently of the length of an attached word.

Tie length with lyrics2 exhibits

Repeated drawing and bounds

Drawing an articulation twice preserves its position. Curves, strokes, clefs, signatures and tuplets gained or corrected bounds used by pointer targeting and measurement.

Draw Is IdempotentCurrent

Ornaments after resize

Delayed turns and long falls recompute their offset from the current neighboring note. Retained draws avoid accumulating offsets from an earlier width.

Retained ornaments on main and M22 exhibits

Percussion barline height

A one-line percussion part now has barlines spanning its visible line. The kit legend aligns with the written instruments.

Single-line drum barline and alternating chord tremolo, main and M62 exhibits

Page turns and text metrics

Pagination measures headings and footers in the physical print viewport. The Letter turn uses the available space after accounting for the actual footer and system height.

Letter conductor and cello pages before and after measuring in the physical page viewport2 exhibits

Timing, rendering and delivery

Accidentals in simultaneous voices

Automatic accidentals process onsets in numeric order and consider notes at a shared onset together. Reordering the input voices leaves the printed accidentals in place.

Automatic Accidentals - Multi Voice OffsetCurrent

Bounds for curves and tuplet brackets

A curve exposes its bounding box for selection. Tuplets above and below the staff have bounds for the bracket and its number.

Opening Direction - up3 exhibits

Tuplet duration edits

Repeated attachment is idempotent. Voices refresh total ticks, shortest duration and spacing weights after tuplet changes, including nesting and detachment.

Nested Tuplets Only Tuplet ChildrenCurrent

Clef state and key spelling

Composed key changes preserve the active clef and numbered sharp signatures keep their sharps. Both changes prevent the printed sign or position from contradicting the source.

Compare literal and key-aware accidentalsCurrent

SVG groups and dimensions

Group class attributes are retained for styling and inspection. Resizing the SVG surface uses valid CSS lengths and keeps viewBox geometry consistent.

Basic StyleBefore and after

Modules and older Safari

Published ESM imports resolve under Node, and the package verifies ESM, CommonJS and declarations with an external consumer. A structured-clone ponyfill covers older Safari runtimes.

Modules and older SafariSource excerpt

Preview state and errors

The guide reuses a warm runtime across edits and navigation. Async failures keep their error details, reset isolates prior execution, and scaled pointer coordinates resolve the intended target.

Interactive user guideCurrent

Security

Runtime and toolchain

Registry keys

Null-prototype maps at both index levels isolate caller-supplied IDs and class names. Unknown index names fail explicitly.

Registry keysSource excerpt

Bounded notation parsing

Malformed duration and notation input is bounded. Invalid meter values fail before entering loops that require a valid advancing beat.

Bounded notation parsingSource excerpt

Release and font tools

Release downloads validate version input and pass process arguments separately. The font inspection demo treats font metadata as text.

Release and font toolsSource excerpt

Dependency advisories

The project updated DOMPurify, shell-quote, fast-uri, zod and ip-address, plus browser download and build dependencies. Scoped overrides cover specified minimatch, basic-ftp and shell-quote paths.

Dependency advisoriesSource excerpt

Locked tools and audit policy

CI checks the locked dependency graph. The dated picomatch exception applies to named development-tool paths and has an expiry and removal procedure.

Locked tools and audit policySource excerpt

Editable examples

The host runs editable code inside a sandboxed preview iframe and handles its messages and errors. Standalone downloads and resets have regression checks for isolation.

Interactive user guideCurrent

API and behavior

Construction and ownership

Typed articulations and fermatas

Named articulations resolve to the requested glyph. The comparison shows the former staccato fallback alongside the corrected fermatas.

After: correct fermatasBefore and after

Native objects in EasyScore

Native notes and modifiers can participate in a managed score. The extension example combines typed construction and native objects on one stave.

Native extensions on whiteIssue screenshot

Grace groups and percussion heads

Construct and attach an owned grace group, or mix pitched and shaped percussion heads in a typed sequence. Both studies render through the public EasyScore API.

Grace groups2 exhibits

Odd meters and nested brackets

Compose multiple voices in an odd meter and name the notes that belong to a tuplet. The bracket example shows nested rhythmic relationships.

easyscore-m4-odd-meter2 exhibits

Staff labels and rhythmic tablature

Construct a tab stave with named strings and fret positions, then add staff labels through the same typed facade.

easyscore-m5-tab2 exhibits

Score connectors and repeats

Connect the staves of a system and preserve a measure’s repeat notation when laying out the complete score.

easyscore-m7-connector2 exhibits

Managed EasyScore facade

Typed constructors cover staff and TAB notes, rests, modifiers, grace groups and stave markings. Batch construction, validation and scoped defaults support editing without leaking temporary settings.

EasyScore: notes & modifiersCurrent

References and source selection

Authored IDs, source spans and validated native adoption let a host map a drawn note back to its input. Relationships validate endpoints and Factory ownership.

EasyScore: references & extensionsCurrent

Composition policy

Declarative staves and measures support pickups, inherited clef and key, signature repetition, explicit accidental policy and responsive systems. Existing native objects can participate through their owning factory.

easyscore-m6-wide3 exhibits

Opt-in engraving behavior

Retained drawing, optical spacing, exact spacing, ordered grace accidentals and font-specific chord kerning have explicit entry points. Applications depending on old collision positions may see different geometry after updating.

Proportional spacingCurrent

Portable SVG

Callers can supply matching fonts to convert music and text to paths for standalone SVG. Missing glyphs or unsupported text produce diagnostics during the export.

Portable SVG export2 exhibits

Persistence design

The approved VF6 direction stores versioned measures, rational time, stable IDs, portable excerpts and authored overrides. The executable adapter study documents boundaries of the proposed format.

Persistence designSource excerpt

Tools and accessibility

Interactive applications

Canvas on mobile

A host-owned list provides the same reading order as SVG. A tap or keyboard move selects the corresponding event even after resizing a high-density Canvas surface.

Mobile Canvas reader with the same event selected2 exhibits

Interactive user guide

Progressive lessons take a reader from four notes to composition and layout. Lesson deep links, keyboard navigation, local drafts and a shared playground keep examples editable and runnable.

After: Quickstart using EasyScore.create5 exhibits

Visual test gallery

The public module index leads to individual QUnit examples and playable score studies. Bundled fonts, local source and a versioned asset manifest make the site portable.

New module index and Minuet in G3 exhibits

Keyboard and screen-reader score navigation

ScoreNavigation orders logical events by measure, onset, staff and voice. A native list and renderer-independent hit regions preserve selection across SVG, Canvas, zoom and reflow. The roadmap records a human assistive-technology walkthrough.

Desktop SVG reader with a flute note selected by keyboard2 exhibits

Playable gallery repertoire

Eight additional musical examples exercise complete passages, including a jig, a chorale melody and original studies. Their module index links the rendered music to editable source.

Pocket ChangeCurrent

Commit and release quality reports

Each commit report measures source, coverage, complexity, unused declarations, compressed bundles and locked dependencies. Release publishing links measurements to a tag and records them in a versioned archive.

Commit quality reportCurrent

Engineering and docs

Verification, performance and publishing

Regression comparison

The 98-case roadmap gallery compares candidate and reviewed main pixels and geometry in the same browser, retains the 5.2.0 historical pass and checks a fresh repeat. Reviewed exceptions and source IDs are recorded per case.

Regression comparisonSource excerpt

Browser and importer qualification

A pinned Playwright matrix exercises Chromium, Firefox and WebKit, mobile scaling, font readiness, keyboard selection and export. The MusicXML adapter pilot compares parse results, note identity, timing and layout through OSMD.

Browser and importer qualificationSource excerpt

Performance studies

Six original score workloads separate construction, layout and drawing times. Later experiments measure retained and local updates against a clean layout and record host and browser metadata.

Performance studiesSource excerpt

Text measurement and rendering work

A shared measurement cache reduces repeated work for identical text and font settings. Engraving probes distinguish measured geometry from rasterized ink.

Text measurement and rendering workSource excerpt

Construct noteheads and flags once

StaveNote avoids duplicating noteheads during construction. Rebuilding a chord removes obsolete child heads, and changing the stem direction reuses the note’s flag.

Notehead shapesCurrent

Fonts and rendering diagnostics

Failed font requests now identify the requested face. Tests cover delayed loads, failed glyph lookup, fallback behavior and agreement between live text and exported outlines.

Bravura and Petaluma with Academico in live SVG and standalone outlined SVG2 exhibits

Demo migration

Browser, worker, ESM and CommonJS examples were updated for the 5.x package entry points and font loading. The local sandbox can test a debug build inside an iframe.

Demo migrationSource excerpt

Headless and package workflows

The jsdom path supports headless notation rendering. An external package consumer checks declarations and each published module entry point, complementing in-repository tests.

Headless and package workflowsSource excerpt

Build and release instructions

Build, testing, package verification and deployment procedures are consolidated. The guide and gallery use versioned local assets; uploads validate files and publish assets before the HTML.

Build and release instructionsSource excerpt

Contributor and user documentation

The README adds UTF-8 setup and links to worked examples. API contracts, score-layout policies, portable export, security guidance and the roadmap have dedicated reference documents.

Interactive user guideCurrent

VF6 acceptance baseline

The requirements connect each design decision to a score or test, record screenshot and assistive-technology approval, and identify future contemporary notation and ensemble work.

VF6 acceptance baselineSource excerpt

Visual index

Open an exhibit to see it at full size. Use Previous and Next or the arrow keys to browse your results. Issue comparisons identify the original and corrected scores.

API inventory

Public TypeScript declarations compared by exported name and member. Expand a row for the exact signatures. An added overload or a spelling change can appear here alongside a behavioral change.

Documentation

Open a guide from the revision that contains it. The inventory includes added, modified, moved and removed Markdown files between the two endpoints.

55 documentation files

Commit history

Every commit reachable from the endpoint after the 5.0.0 tag, including merges, release preparation, dependency updates and follow-up corrections. Expand a commit to inspect a source excerpt, read its description, or open the full diff.

Method and limits

The release images come from the browser bundle stored in the 5.0.0 Git tag. The current bundle was built from 136e78e2ae86. Both ran in Chromium 145.0.7632.6 on a white background at device scale 1. The native suites produced 463 and 537 score captures respectively. The current examples include 98 guide examples and supplementary studies.

Native comparisons match module, test name and font at both revisions. Test source can also evolve. Shared roadmap studies use the same authored score and the release’s native soft-voice equivalent where needed. When the 5.0.0 input is unavailable, a changed intermediate roadmap control is explicitly labeled 5.2.0. A current-only image means the old test or drawing was unavailable. Some studies exercise familiar notation through a new API. Issue screenshots link to the original review comment; paired images retain their before and after captions. Source excerpts document changes without a visible score. Each commit also has a first-parent diff excerpt or file inventory and a link to its full Git record. Reference controls that render identically are identified in the index.

The declaration inventory includes exported types and public members, excludes private and protected members, and compares emitted TypeScript. Compiler changes can affect a printed declaration. The complete Git comparison also covers internal implementations, configuration, generated files and assets. The proposed VF6 requirements and future specialist work are documented in their own section.