chordsheetjs 12.3.0 → 12.3.1

package/README.md

@@ -1,4 +1,4 @@
-# ChordSheetJS [![Code Climate](https://codeclimate.com/github/martijnversluis/ChordSheetJS/badges/gpa.svg)](https://codeclimate.com/github/martijnversluis/ChordSheetJS) [![CI](https://github.com/martijnversluis/ChordSheetJS/actions/workflows/ci.yml/badge.svg)](https://github.com/martijnversluis/ChordSheetJS/actions/workflows/ci.yml?query=branch%3Amaster) [![Release](https://github.com/martijnversluis/ChordSheetJS/actions/workflows/release.yml/badge.svg)](https://github.com/martijnversluis/ChordSheetJS/actions/workflows/release.yml)
+# ChordSheetJS [![CI](https://github.com/martijnversluis/ChordSheetJS/actions/workflows/ci.yml/badge.svg)](https://github.com/martijnversluis/ChordSheetJS/actions/workflows/ci.yml?query=branch%3Amaster) [![Release](https://github.com/martijnversluis/ChordSheetJS/actions/workflows/release.yml/badge.svg)](https://github.com/martijnversluis/ChordSheetJS/actions/workflows/release.yml)
 
 A JavaScript library for parsing and formatting chord sheets
 

package/lib/bundle.js

@@ -5452,43 +5452,43 @@ ${error.stack}`);
       var $cbaaf2a368d4190f$export$2e2bcd8739ae039 = $cbaaf2a368d4190f$var$LineExpander;
       var $9047ab737bb447ce$var$MetadataAccessors = class {
         get key() {
-          return this.getSingleMetadata((0, $d21c5c7a462f3c34$export$7167c830cefcb6b5));
+          return this.getSingleMetadataValue((0, $d21c5c7a462f3c34$export$7167c830cefcb6b5));
         }
         get title() {
-          return this.getSingleMetadata((0, $d21c5c7a462f3c34$export$f1e53f710478ceb4));
+          return this.getSingleMetadataValue((0, $d21c5c7a462f3c34$export$f1e53f710478ceb4));
         }
         get subtitle() {
-          return this.getSingleMetadata((0, $d21c5c7a462f3c34$export$5895c693c74b9cf4));
+          return this.getSingleMetadataValue((0, $d21c5c7a462f3c34$export$5895c693c74b9cf4));
         }
         get capo() {
-          return this.getMetadata((0, $d21c5c7a462f3c34$export$866f445d49bad88e));
+          return this.getMetadataValue((0, $d21c5c7a462f3c34$export$866f445d49bad88e));
         }
         get duration() {
-          return this.getSingleMetadata((0, $d21c5c7a462f3c34$export$bacc88974c736870));
+          return this.getSingleMetadataValue((0, $d21c5c7a462f3c34$export$bacc88974c736870));
         }
         get tempo() {
-          return this.getSingleMetadata((0, $d21c5c7a462f3c34$export$bd8d57d0bc5a8478));
+          return this.getSingleMetadataValue((0, $d21c5c7a462f3c34$export$bd8d57d0bc5a8478));
         }
         get time() {
-          return this.getMetadata((0, $d21c5c7a462f3c34$export$a9905336c0111a3a));
+          return this.getMetadataValue((0, $d21c5c7a462f3c34$export$a9905336c0111a3a));
         }
         get year() {
-          return this.getSingleMetadata((0, $d21c5c7a462f3c34$export$90b88dc425a06a95));
+          return this.getSingleMetadataValue((0, $d21c5c7a462f3c34$export$90b88dc425a06a95));
         }
         get album() {
-          return this.getMetadata((0, $d21c5c7a462f3c34$export$10227cb086d1770c));
+          return this.getMetadataValue((0, $d21c5c7a462f3c34$export$10227cb086d1770c));
         }
         get copyright() {
-          return this.getSingleMetadata((0, $d21c5c7a462f3c34$export$4ab8c75045d12480));
+          return this.getSingleMetadataValue((0, $d21c5c7a462f3c34$export$4ab8c75045d12480));
         }
         get lyricist() {
-          return this.getMetadata((0, $d21c5c7a462f3c34$export$a6901bd008617c61));
+          return this.getMetadataValue((0, $d21c5c7a462f3c34$export$a6901bd008617c61));
         }
         get artist() {
-          return this.getMetadata((0, $d21c5c7a462f3c34$export$17d8dfb3db842bf));
+          return this.getMetadataValue((0, $d21c5c7a462f3c34$export$17d8dfb3db842bf));
         }
         get composer() {
-          return this.getMetadata((0, $d21c5c7a462f3c34$export$98424633dc8c377f));
+          return this.getMetadataValue((0, $d21c5c7a462f3c34$export$98424633dc8c377f));
         }
       };
       var $9047ab737bb447ce$export$2e2bcd8739ae039 = $9047ab737bb447ce$var$MetadataAccessors;
@@ -5533,10 +5533,10 @@ ${error.stack}`);
           if (value) this.metadata[key] = value;
           else delete this.metadata[key];
         }
-        getMetadata(name) {
+        getMetadataValue(name) {
           return this.get(name);
         }
-        getSingleMetadata(name) {
+        getSingleMetadataValue(name) {
           return this.getSingle(name);
         }
         /**
@@ -5839,7 +5839,6 @@ ${error.stack}`);
           this.warnings = [];
           this.song = song;
           this.song.lines = this.lines;
-          this.song.metadata = this.metadata;
           this.song.warnings = this.warnings;
         }
         get previousLine() {
@@ -5855,7 +5854,7 @@ ${error.stack}`);
           }
           this.setCurrentProperties(this.sectionType, this.selector);
           this.currentLine.transposeKey = this.transposeKey ?? this.currentKey;
-          this.currentLine.key = this.currentKey || this.metadata.getSingle((0, $d21c5c7a462f3c34$export$7167c830cefcb6b5));
+          this.currentLine.key = this.currentKey || this.song.getMetadata().getSingle((0, $d21c5c7a462f3c34$export$7167c830cefcb6b5));
           this.currentLine.lineNumber = this.lines.length - 1;
           return this.currentLine;
         }
@@ -5893,8 +5892,7 @@ ${error.stack}`);
           if (this.currentLine === null) this.addLine();
         }
         applyTagOnSong(tag) {
-          if (tag.isMetaTag()) this.setMetadata(tag.name, tag.value || "");
-          else if (tag.name === (0, $d21c5c7a462f3c34$export$ae60ab9b4739fc3d)) this.transposeKey = tag.value;
+          if (tag.name === (0, $d21c5c7a462f3c34$export$ae60ab9b4739fc3d)) this.transposeKey = tag.value;
           else if (tag.name === (0, $d21c5c7a462f3c34$export$b7627374a6424f68)) this.currentKey = tag.value;
           else if (tag.isSectionDelimiter()) this.setSectionTypeFromTag(tag);
           else if (tag.isInlineFontTag()) this.fontStack.applyTag(tag);
@@ -5904,9 +5902,6 @@ ${error.stack}`);
           if (!this.currentLine) throw new Error("Expected this.currentLine to be present");
           this.currentLine.addTag(tag);
         }
-        setMetadata(name, value) {
-          this.metadata.add(name, value);
-        }
         setSectionTypeFromTag(tag) {
           const [tagType, sectionType] = (0, $35ced0783ee29c4f$export$2e2bcd8739ae039).interpret(tag.name, tag.value);
           if (!sectionType) return;
@@ -5934,6 +5929,42 @@ ${error.stack}`);
         }
       };
       var $69c885ea9d252cfd$export$2e2bcd8739ae039 = $69c885ea9d252cfd$var$SongBuilder;
+      var $feda9c006f56d800$var$SongMapper = class {
+        constructor(song) {
+          this.addedLine = false;
+          this.song = song;
+          this.clonedSong = new (0, $c53141c05fae8382$export$2e2bcd8739ae039)();
+          this.builder = new (0, $69c885ea9d252cfd$export$2e2bcd8739ae039)(this.clonedSong);
+        }
+        mapItems(func) {
+          this.song.lines.forEach((line) => {
+            this.mapLineItems(line, func);
+          });
+          return this.clonedSong;
+        }
+        mapLineItems(line, func) {
+          line.items.forEach((item) => {
+            this.mapItem(func, item);
+          });
+          if (line.isEmpty()) this.ensureLine();
+          this.addedLine = false;
+        }
+        mapItem(func, item) {
+          const changedItem = func(item);
+          if (changedItem === null) return;
+          const isArray = Array.isArray(changedItem);
+          if (!isArray || changedItem.length > 0) this.ensureLine();
+          if (isArray) changedItem.forEach((i) => this.builder.addItem(i));
+          else this.builder.addItem(changedItem);
+        }
+        ensureLine() {
+          if (!this.addedLine) {
+            this.builder.addLine();
+            this.addedLine = true;
+          }
+        }
+      };
+      var $feda9c006f56d800$export$2e2bcd8739ae039 = $feda9c006f56d800$var$SongMapper;
       var $e02a17f5a26edf19$var$defaultConstructorOptions = {
         capo: 0,
         contextKey: null,
@@ -6029,54 +6060,18 @@ ${error.stack}`);
         const metadataValueTruthy = metadataValue && metadataValue !== "";
         return isNegated ? !metadataValueTruthy : !!metadataValueTruthy;
       }
-      var $feda9c006f56d800$var$SongMapper = class {
-        constructor(song) {
-          this.addedLine = false;
-          this.song = song;
-          this.clonedSong = new (0, $c53141c05fae8382$export$2e2bcd8739ae039)();
-          this.builder = new (0, $69c885ea9d252cfd$export$2e2bcd8739ae039)(this.clonedSong);
-        }
-        mapItems(func) {
-          this.song.lines.forEach((line) => {
-            this.mapLineItems(line, func);
-          });
-          return this.clonedSong;
-        }
-        mapLineItems(line, func) {
-          line.items.forEach((item) => {
-            this.mapItem(func, item);
-          });
-          if (line.isEmpty()) this.ensureLine();
-          this.addedLine = false;
-        }
-        mapItem(func, item) {
-          const changedItem = func(item);
-          if (changedItem === null) return;
-          const isArray = Array.isArray(changedItem);
-          if (!isArray || changedItem.length > 0) this.ensureLine();
-          if (isArray) changedItem.forEach((i) => this.builder.addItem(i));
-          else this.builder.addItem(changedItem);
-        }
-        ensureLine() {
-          if (!this.addedLine) {
-            this.builder.addLine();
-            this.addedLine = true;
-          }
-        }
-      };
-      var $feda9c006f56d800$export$2e2bcd8739ae039 = $feda9c006f56d800$var$SongMapper;
       var $c53141c05fae8382$var$Song = class _$c53141c05fae8382$var$Song extends (0, $9047ab737bb447ce$export$2e2bcd8739ae039) {
         /**
         * Creates a new {Song} instance
         * @param metadata {Record<string, string | string[]>|Metadata} predefined metadata
         */
-        constructor(metadata = {}) {
+        constructor(metadata = null) {
           super(), /**
           * The {@link Line} items of which the song consists
           * @member {Line[]}
           */
-          this.lines = [], this._bodyLines = null, this._bodyParagraphs = null, this.warnings = [];
-          this.metadata = new (0, $5c7afec93ec943b9$export$2e2bcd8739ae039)(metadata);
+          this.lines = [], this._bodyLines = null, this._bodyParagraphs = null, this.warnings = [], this._metadata = null;
+          if (metadata) this._metadata = new (0, $5c7afec93ec943b9$export$2e2bcd8739ae039)(metadata);
         }
         /**
         * Returns the song lines, skipping the leading empty lines (empty as in not rendering any content). This is useful
@@ -6138,18 +6133,17 @@ ${error.stack}`);
         */
         clone() {
           const clone = new _$c53141c05fae8382$var$Song();
-          clone.metadata = this.metadata.clone();
           clone.warnings = [
             ...this.warnings
           ];
           clone.lines = this.lines.map((line) => line.clone());
           return clone;
         }
-        getMetadata(name) {
-          return this.metadata.getMetadata(name);
+        getMetadataValue(name) {
+          return this.metadata.getMetadataValue(name);
         }
-        getSingleMetadata(name) {
-          return this.metadata.getSingleMetadata(name);
+        getSingleMetadataValue(name) {
+          return this.metadata.getSingleMetadataValue(name);
         }
         /**
         * Returns a copy of the song with the key value set to the specified key. It changes:
@@ -6430,6 +6424,33 @@ Or set the song key before changing key:
           });
           return chordDefinitions;
         }
+        /**
+        * The song's metadata. When there is only one value for an entry, the value is a string. Else, the value is
+        * an array containing all unique values for the entry.
+        * @type {Metadata}
+        */
+        get metadata() {
+          if (!this._metadata) this._metadata = this.getMetadata();
+          return this._metadata;
+        }
+        getMetadata(configuration) {
+          const metadata = new (0, $5c7afec93ec943b9$export$2e2bcd8739ae039)();
+          this.foreachItem((item) => {
+            if (!(item instanceof (0, $7251dad5f4a4c35f$export$2e2bcd8739ae039))) return;
+            const tag = item;
+            if (!tag.isMetaTag()) return;
+            const { selector, isNegated } = tag;
+            if (selector && configuration && !(0, $2ce1086ce25c9ac0$export$efb38dd75b8e2957)({
+              selector,
+              isNegated
+            }, {
+              metadata,
+              configuration
+            })) return;
+            metadata.add(item.name, item.value);
+          });
+          return metadata;
+        }
         get chordDefinitions() {
           return new (0, $4ff43932a550a629$export$2e2bcd8739ae039)(this.getChordDefinitions());
         }
@@ -23522,7 +23543,7 @@ Or set the song key before changing key:
         }
       };
       var $a5a21ced491ea51f$export$2e2bcd8739ae039 = $a5a21ced491ea51f$var$UltimateGuitarParser;
-      var $ae92e002ce14f11a$export$2e2bcd8739ae039 = "12.3.0";
+      var $ae92e002ce14f11a$export$2e2bcd8739ae039 = "12.3.1";
       var $892913528e7f60f9$export$2e2bcd8739ae039 = {
         CHORUS: $dce48cb70c4120bb$export$8db6c706fc9142b2,
         Chord: $177a605b8569b31c$export$2e2bcd8739ae039,