music_xml 2.3.0

A Dart package to parse and serialize MusicXML 4.0.

2.3.0

• <defaults> element with scaling, concert-score, page-layout, system-layout, staff-layout, appearance, system-dividers, music-font, word-font, lyric-font, lyric-language
• Data type enums: MarginType, LineWidthType, NoteSizeType, DistanceType, GlyphType, FontStyle, FontWeight, FontSize

2.2.0

• <identification> element with creator, rights, encoding, source, relation, miscellaneous, and <supports>

2.1.0

• <work> element with work-number, work-title, and <opus> (XLink) #42

2.0.0

New Features

• Restructured codebase to mirror the MusicXML 4.0 element hierarchy
• All elements now extend XmlElement, enabling XML roundtripping (parse and serialize)
• <unpitched> support for percussion scores
• <grace> with typed attributes (slash, steal-time-following, steal-time-previous, make-time)
• <chord> as a typed element
• <score-partwise> with version, movement-number, movement-title
• <part-list> / <midi-instrument> as typed elements
• Typed <attributes> with divisions, key, time, clef, transpose as child elements
• <key> with key-step, key-alter, <key-accidental> (full AccidentalValue enum)
• <clef> with typed ClefSign enum
• <backup> / <forward> / <direction> / <sound> as typed elements
• Pitch.toMidiPitch() and Pitch.toPitchString() methods

Breaking Changes

• MusicXmlDocument
  • document.scoreParts -> document.score.partList.scoreParts
  • document.parts -> document.score.parts
• Measure
  • measure.clefSignature -> measure.attributesList.first.clefs
  • measure.timeSignature -> measure.attributesList.first.times
  • measure.keySignature -> measure.attributesList.first.keys
  • measure.barline (single) -> measure.barlines (list)
  • measure.number changed from int to Number (use .value)
• Note
  • note.pitch (was MapEntry<String, int>) renamed to note.pitchMap
  • note.pitchTypeSafe renamed to note.pitch (now the typed Pitch object)
• Renamed classes
  • KeySignature -> Key (mode is now a Mode object instead of String)
  • ClefSignature -> Clef (sign is now a Sign object with ClefSign enum)
  • TimeSignature -> Time
• ScorePart
  • ScorePart.id changed from String to Id (use .value)
  • ScorePart.partName changed from String to PartName (use .content)
• Tempo
  • timePosition removed (accessible via Sound parent)
• MusicXMLParserState removed from public exports (internal implementation detail)

Bug Fixes

• Fix Attributes.parse times parameter shadowing preventing time signatures from flowing to _fixTimeSignature
• Fix KeyAccidental.parse crash on unrecognized accidental values (now falls back to AccidentalValue.other)
• Fix Grace.parse parsing makeTime attribute twice
• Fix Tempo.qpm getter returning dynamic instead of double
• Fix _repairEmptyMeasure being a no-op (body was commented out)
• Fix floating-point comparison in _fixTimeSignature (now uses integer cross-multiplication)
• Fix Transpose.parse being called twice in Attributes.parse
• Remove duplicate pitch parsing in Note (consolidated into Pitch object)
• Standardize factory constructors to .parse() (was inconsistent .parse() / .fromXml())
• Rename chore.dart to chord.dart (typo)

1.3.0

• Read <clef> element

1.2.2

• fix: Xml documents with multiple score parts were not read anymore #13

1.2.1

• fix: doubled ties #9
• fix: parse part-name #9
• fix: parse list part #10

1.2.0

• Don't throw an exception when the lyric has no text
• Read movement-title
• Identify notes belonging to the same tied note by a shared id
• Refactor ChordSymbol to prevent warnings
• Add SimpleKind to get the basic form of a chord, i.e. major, minor, augmented, diminished, sus or other. With .kind.simple, the simple kind can be read out.
• Add Note.pitchTypeSafe property to read out pitch information more easily.
• Add Note.noteDurationTied to get the complied duration of a tied note.
• Add additional note information Note.isNoteOn, isNoteOff, continuesOtherNote, isContinuedByOtherNote

1.1.0

• Add lyric, tie, print (#3)

1.0.4

• Public constructor

1.0.3

• Upgrade dependencies

1.0.2

• Refactor constructors with factory

1.0.1

• Remove redundant dependencies

1.0.0

• Support parse from xml string.