custom_flutter_chord 1.2.2
custom_flutter_chord: ^1.2.2 copied to clipboard
Lyrics Chord parser and renderer for Flutter. It also comes with transpose and auto-scroll features.
1.2.2 #
- License change: the package is now proprietary software of GOVERNOR LTD
(previously MIT). Access, use, copying, modification and distribution require
explicit prior written authorization obtained through the official channels
(contact@governor.ltd). See
LICENSEfor the full terms. - Docs: README rewritten — licensing notice, updated feature list and an
implementation section that reflects the current behaviour (transposition →
MinorMode→chordNotationpipeline,keyRootdegrees and therelative/parallelminor modes); the previous text still described the pre-1.2.0 minor conversion. - Docs:
example/README.mdreplaced by real documentation of the demo app. - Changelog history prior to 1.0.0 removed.
- Example: drop the unnecessary
src/chord_transposer.dartimport (unnecessary_import);ChordNotationcomes from the library barrel. - No changes to the library API or behaviour.
1.2.1 #
- Fix:
onTapChordnow returns the chord after the active minor conversion (same value shown in the lyrics), so the tapped chord matches the rendered one. Previously, withMinorMode.parallel, tapping a chord passed the un-converted chord (e.g. rendered "Ab" but tapped "A"). Conversion is centralised inconvertedChordText, used by both the renderer and the tap.
1.2.0 #
- Add
MinorMode(none/relative/parallel) and theminorModeparameter toLyricsRenderer, replacing the oldminorScalebehaviour with two correct minor-key conversions applied on top oftransposeIncrement:relative: relative minor — chords are left untouched; only the degree reference (number/roman) re-centres a minor third below the major tonic.parallel: parallel minor — each diatonic chord of the major key is mapped to the natural-minor field (I→i, ii→ii°, iii→♭III, IV→iv, V→v, vi→♭VI, vii°→♭VII). Extensions and slash chords are preserved; flat degrees are spelled with flats; chromatic chords are kept unchanged.
- Export
ChordNotation,ChordScaleandMinorModefrom the library barrel. minorScaleis kept for backwards compatibility (minorModetakes precedence).
1.1.0 #
- Add
keyRoottoLyricsRenderer: when set, thenumberandromannotations render chords as functional degrees relative to the song key (e.g. in G: G→1/I, C→4/IV, Em→6/vi) instead of the absolute C = 1/I mapping. Degrees stay invariant undertransposeIncrement. - Roman degrees are now quality-aware (uppercase major, lowercase minor,
°diminished,+augmented) and slash chords convert both root and bass. - Backwards compatible: with
keyRootnull the previous absolute mapping is kept.
1.0.2 #
- Fix chord overlapping when they are too close to each other.
- Add
[•]as a visual separator for trailing chords to improve readability.
1.0.0 #
- Add visual separator for trailing chords to improve readability.
- The separator
[•]is automatically inserted between chords at the end of a line or in chord-only lines. - Add support for multiple chord notations (
german,traditionalGerman,french,portuguese,roman,number). - Fix and improve transposition to minor scale.