chordsheetjs 10.4.1 → 10.5.0

package/README.md

@@ -892,6 +892,7 @@ the paragraph contents as one string where lines are separated by newlines.</p>
     * [.changeMetadata(name, value)](#Song+changeMetadata)
     * [.mapItems(func)](#Song+mapItems) ⇒ [<code>Song</code>](#Song)
     * [.getChords()](#Song+getChords) ⇒ <code>Array.&lt;string&gt;</code>
+    * [.getChordDefinitions()](#Song+getChordDefinitions) ⇒ <code>Record.&lt;string, ChordDefinition&gt;</code>
     * [.mapLines(func)](#Song+mapLines) ⇒ [<code>Song</code>](#Song)
 
 <a name="new_Song_new"></a>
@@ -1102,6 +1103,20 @@ song.mapItems((item) => {
 
 **Kind**: instance method of [<code>Song</code>](#Song)  
 **Returns**: <code>Array.&lt;string&gt;</code> - <p>the chords</p>  
+<a name="Song+getChordDefinitions"></a>
+
+### song.getChordDefinitions() ⇒ <code>Record.&lt;string, ChordDefinition&gt;</code>
+<p>Returns all chord definitions from the song.
+Definitions are made using the <code>{chord}</code> or <code>{define}</code> directive.
+A chord definitions overrides a previous chord definition for the exact same chord.</p>
+
+**Kind**: instance method of [<code>Song</code>](#Song)  
+**Returns**: <code>Record.&lt;string, ChordDefinition&gt;</code> - <p>the chord definitions</p>  
+**See**
+
+- https://chordpro.org/chordpro/directives-define/
+- https://chordpro.org/chordpro/directives-chord/
+
 <a name="Song+mapLines"></a>
 
 ### song.mapLines(func) ⇒ [<code>Song</code>](#Song)

package/lib/bundle.js

@@ -326,6 +326,7 @@ var ChordSheetJS = (() => {
       $parcel$defineInteropFlag(module.exports);
       $parcel$export(module.exports, "default", () => $892913528e7f60f9$export$2e2bcd8739ae039);
       $parcel$export(module.exports, "Chord", () => $177a605b8569b31c$export$2e2bcd8739ae039);
+      $parcel$export(module.exports, "ChordDefinition", () => $36ec5eba476f1300$export$2e2bcd8739ae039);
       $parcel$export(module.exports, "ChordLyricsPair", () => $551a223fc13b5c10$export$2e2bcd8739ae039);
       $parcel$export(module.exports, "ChordProFormatter", () => $244a67400187e14e$export$2e2bcd8739ae039);
       $parcel$export(module.exports, "ChordProParser", () => $957f29f677b8d58d$export$2e2bcd8739ae039);
@@ -13883,6 +13884,18 @@ to a key`);
         }
       };
       var $177a605b8569b31c$export$2e2bcd8739ae039 = $177a605b8569b31c$var$Chord;
+      var $36ec5eba476f1300$var$ChordDefinition = class _$36ec5eba476f1300$var$ChordDefinition {
+        constructor(name, baseFret, frets, fingers) {
+          this.name = name;
+          this.baseFret = baseFret;
+          this.frets = frets;
+          this.fingers = fingers || [];
+        }
+        clone() {
+          return new _$36ec5eba476f1300$var$ChordDefinition(this.name, this.baseFret, this.frets, this.fingers);
+        }
+      };
+      var $36ec5eba476f1300$export$2e2bcd8739ae039 = $36ec5eba476f1300$var$ChordDefinition;
       var $f1e1976743ced067$export$a014e67b549cbef4 = {
         separator: ","
       };
@@ -18719,6 +18732,23 @@ Or set the song key before changing key:
           return Array.from(chords);
         }
         /**
+        * Returns all chord definitions from the song.
+        * Definitions are made using the `{chord}` or `{define}` directive.
+        * A chord definitions overrides a previous chord definition for the exact same chord.
+        * @returns {Record<string, ChordDefinition>} the chord definitions
+        * @see https://chordpro.org/chordpro/directives-define/
+        * @see https://chordpro.org/chordpro/directives-chord/
+        */
+        getChordDefinitions() {
+          const chordDefinitions = {};
+          this.foreachItem((item) => {
+            if (!(item instanceof (0, $7251dad5f4a4c35f$export$2e2bcd8739ae039))) return;
+            const { chordDefinition } = item;
+            if (chordDefinition) chordDefinitions[chordDefinition.name] = chordDefinition.clone();
+          });
+          return chordDefinitions;
+        }
+        /**
         * Change the song contents inline. Return a new {@link Line} to replace it. Return `null` to remove it.
         * @example
         * // remove lines with only Tags:
@@ -18772,15 +18802,6 @@ Or set the song key before changing key:
         }
       };
       var $c53141c05fae8382$export$2e2bcd8739ae039 = $c53141c05fae8382$var$Song;
-      var $36ec5eba476f1300$var$ChordDefinition = class {
-        constructor(name, baseFret, frets, fingers) {
-          this.name = name;
-          this.baseFret = baseFret;
-          this.frets = frets;
-          this.fingers = fingers || [];
-        }
-      };
-      var $36ec5eba476f1300$export$2e2bcd8739ae039 = $36ec5eba476f1300$var$ChordDefinition;
       var $8b93ef43471b6ed2$var$CHORD_LYRICS_PAIR = "chordLyricsPair";
       var $8b93ef43471b6ed2$var$CHORD_SHEET = "chordSheet";
       var $8b93ef43471b6ed2$var$COMMENT = "comment";
@@ -31806,6 +31827,7 @@ Or set the song key before changing key:
       var $892913528e7f60f9$export$2e2bcd8739ae039 = {
         CHORUS: $dce48cb70c4120bb$export$8db6c706fc9142b2,
         Chord: $177a605b8569b31c$export$2e2bcd8739ae039,
+        ChordDefinition: $36ec5eba476f1300$export$2e2bcd8739ae039,
         ChordLyricsPair: $551a223fc13b5c10$export$2e2bcd8739ae039,
         ChordProFormatter: $244a67400187e14e$export$2e2bcd8739ae039,
         ChordProParser: $957f29f677b8d58d$export$2e2bcd8739ae039,