chordsheetjs 5.1.2 → 6.0.0

package/d7b54993c4ea66c07a35bd36690482ab620f836e.patch

@@ -0,0 +1,105 @@
+commit d7b54993c4ea66c07a35bd36690482ab620f836e
+Author: Martijn Versluis <martijnversluis@users.noreply.github.com>
+Date:   Sun Jan 30 16:35:24 2022 +0100
+
+    Do not rely on contructor name
+    
+    Due to build tools scrambling constructor names, we can not rely on those
+    for type checking. Thus we have to use `instanceof`. This change removes
+    usages of `constructor.name` and solves the cyclic dependency by moving around
+    some functions.
+    
+    Resolves #421
+
+diff --git a/src/formatter/html_div_formatter.js b/src/formatter/html_div_formatter.js
+index f92f532..b1de230 100644
+--- a/src/formatter/html_div_formatter.js
++++ b/src/formatter/html_div_formatter.js
+@@ -1,6 +1,6 @@
+ import Handlebars from 'handlebars';
+ 
+-import '../handlebars_helpers';
++import '../template_helpers';
+ import HtmlFormatter from './html_formatter';
+ import './templates/html_div_formatter';
+ import { scopeCss } from '../utilities';
+diff --git a/src/formatter/html_table_formatter.js b/src/formatter/html_table_formatter.js
+index 4883fef..7d7e8ea 100644
+--- a/src/formatter/html_table_formatter.js
++++ b/src/formatter/html_table_formatter.js
+@@ -1,6 +1,6 @@
+ import Handlebars from 'handlebars';
+ 
+-import '../handlebars_helpers';
++import '../template_helpers';
+ import HtmlFormatter from './html_formatter';
+ import './templates/html_table_formatter';
+ import { scopeCss } from '../utilities';
+diff --git a/src/formatter/text_formatter.js b/src/formatter/text_formatter.js
+index 61385f1..81fe226 100644
+--- a/src/formatter/text_formatter.js
++++ b/src/formatter/text_formatter.js
+@@ -1,10 +1,10 @@
+ import ChordLyricsPair from '../chord_sheet/chord_lyrics_pair';
+ import Tag from '../chord_sheet/tag';
+ import { renderChord } from '../helpers';
++import { hasTextContents } from '../template_helpers';
+ 
+ import {
+   hasChordContents,
+-  hasTextContents,
+   padLeft,
+ } from '../utilities';
+ 
+diff --git a/src/handlebars_helpers.js b/src/template_helpers.js
+similarity index 87%
+rename from src/handlebars_helpers.js
+rename to src/template_helpers.js
+index 0e5ff98..b330f87 100644
+--- a/src/handlebars_helpers.js
++++ b/src/template_helpers.js
+@@ -7,12 +7,20 @@ import { renderChord } from './helpers';
+ 
+ import {
+   hasChordContents,
+-  hasTextContents,
+   isEvaluatable,
+ } from './utilities';
+ 
+ const lineHasContents = (line) => line.items.some((item) => item.isRenderable());
+ 
++/* eslint import/prefer-default-export: 0 */
++export const hasTextContents = (line) => (
++  line.items.some((item) => (
++    (item instanceof ChordLyricsPair && item.lyrics)
++    || (item instanceof Tag && item.isRenderable())
++    || isEvaluatable(item)
++  ))
++);
++
+ HandleBars.registerHelper('isChordLyricsPair', (item) => item instanceof ChordLyricsPair);
+ 
+ HandleBars.registerHelper('isTag', (item) => item instanceof Tag);
+diff --git a/src/utilities.js b/src/utilities.js
+index 03c69cc..503c811 100644
+--- a/src/utilities.js
++++ b/src/utilities.js
+@@ -8,18 +8,6 @@ export const hasChordContents = (line) => line.items.some((item) => !!item.chord
+ 
+ export const isEvaluatable = (item) => typeof item.evaluate === 'function';
+ 
+-function isInstanceOf(object, constructorName) {
+-  return object?.constructor?.name === constructorName;
+-}
+-
+-export const hasTextContents = (line) => (
+-  line.items.some((item) => (
+-    (isInstanceOf(item, 'ChordLyricsPair') && item.lyrics)
+-      || (isInstanceOf(item, 'Tag') && item.isRenderable())
+-      || isEvaluatable(item)
+-  ))
+-);
+-
+ export const padLeft = (str, length) => {
+   let paddedString = str;
+   for (let l = str.length; l < length; l += 1, paddedString += ' ');

package/lib/chord.js

@@ -1,6 +1,6 @@
 "use strict";
 
-function _typeof(obj) { "@babel/helpers - typeof"; if (typeof Symbol === "function" && typeof Symbol.iterator === "symbol") { _typeof = function _typeof(obj) { return typeof obj; }; } else { _typeof = function _typeof(obj) { return obj && typeof Symbol === "function" && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }; } return _typeof(obj); }
+function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
 
 Object.defineProperty(exports, "__esModule", {
   value: true
@@ -12,13 +12,15 @@ var _utilities = require("./utilities");
 
 var _key = _interopRequireDefault(require("./key"));
 
+var _suffixNormalizeMapping = _interopRequireDefault(require("./normalize_mappings/suffix-normalize-mapping"));
+
 var _constants = require("./constants");
 
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
 
-function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); if (enumerableOnly) { symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; }); } keys.push.apply(keys, symbols); } return keys; }
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
 
-function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i] != null ? arguments[i] : {}; if (i % 2) { ownKeys(Object(source), true).forEach(function (key) { _defineProperty(target, key, source[key]); }); } else if (Object.getOwnPropertyDescriptors) { Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)); } else { ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } } return target; }
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
 
 function _defineProperty(obj, key, value) { if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
 
@@ -26,7 +28,7 @@ function _classCallCheck(instance, Constructor) { if (!(instance instanceof Cons
 
 function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }
 
-function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); return Constructor; }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
 
 function _classPrivateMethodInitSpec(obj, privateSet) { _checkPrivateRedeclaration(obj, privateSet); privateSet.add(obj); }
 
@@ -36,35 +38,30 @@ function _checkPrivateRedeclaration(obj, privateCollection) { if (privateCollect
 
 function _classPrivateMethodGet(receiver, privateSet, fn) { if (!privateSet.has(receiver)) { throw new TypeError("attempted to get private field on non-instance"); } return fn; }
 
-function _classPrivateFieldGet(receiver, privateMap) { var descriptor = _classExtractFieldDescriptor(receiver, privateMap, "get"); return _classApplyDescriptorGet(receiver, descriptor); }
+function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
 
-function _classExtractFieldDescriptor(receiver, privateMap, action) { if (!privateMap.has(receiver)) { throw new TypeError("attempted to " + action + " private field on non-instance"); } return privateMap.get(receiver); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
 
-function _classApplyDescriptorGet(receiver, descriptor) { if (descriptor.get) { return descriptor.get.call(receiver); } return descriptor.value; }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
 
-function _wrapRegExp() { _wrapRegExp = function _wrapRegExp(re, groups) { return new BabelRegExp(re, undefined, groups); }; var _super = RegExp.prototype; var _groups = new WeakMap(); function BabelRegExp(re, flags, groups) { var _this = new RegExp(re, flags); _groups.set(_this, groups || _groups.get(re)); return _setPrototypeOf(_this, BabelRegExp.prototype); } _inherits(BabelRegExp, RegExp); BabelRegExp.prototype.exec = function (str) { var result = _super.exec.call(this, str); if (result) result.groups = buildGroups(result, this); return result; }; BabelRegExp.prototype[Symbol.replace] = function (str, substitution) { if (typeof substitution === "string") { var groups = _groups.get(this); return _super[Symbol.replace].call(this, str, substitution.replace(/\$<([^>]+)>/g, function (_, name) { return "$" + groups[name]; })); } else if (typeof substitution === "function") { var _this = this; return _super[Symbol.replace].call(this, str, function () { var args = arguments; if (_typeof(args[args.length - 1]) !== "object") { args = [].slice.call(args); args.push(buildGroups(args, _this)); } return substitution.apply(this, args); }); } else { return _super[Symbol.replace].call(this, str, substitution); } }; function buildGroups(result, re) { var g = _groups.get(re); return Object.keys(g).reduce(function (groups, name) { groups[name] = result[g[name]]; return groups; }, Object.create(null)); } return _wrapRegExp.apply(this, arguments); }
+function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
 
-function _inherits(subClass, superClass) { if (typeof superClass !== "function" && superClass !== null) { throw new TypeError("Super expression must either be null or a function"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); if (superClass) _setPrototypeOf(subClass, superClass); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
 
-function _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf || function _setPrototypeOf(o, p) { o.__proto__ = p; return o; }; return _setPrototypeOf(o, p); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
 
-var MAJOR_SCALE = [null, 'M', 'm', 'm', 'M', 'M', 'm', 'dim'];
+function _wrapRegExp() { _wrapRegExp = function _wrapRegExp(re, groups) { return new BabelRegExp(re, void 0, groups); }; var _super = RegExp.prototype, _groups = new WeakMap(); function BabelRegExp(re, flags, groups) { var _this = new RegExp(re, flags); return _groups.set(_this, groups || _groups.get(re)), _setPrototypeOf(_this, BabelRegExp.prototype); } function buildGroups(result, re) { var g = _groups.get(re); return Object.keys(g).reduce(function (groups, name) { return groups[name] = result[g[name]], groups; }, Object.create(null)); } return _inherits(BabelRegExp, RegExp), BabelRegExp.prototype.exec = function (str) { var result = _super.exec.call(this, str); return result && (result.groups = buildGroups(result, this)), result; }, BabelRegExp.prototype[Symbol.replace] = function (str, substitution) { if ("string" == typeof substitution) { var groups = _groups.get(this); return _super[Symbol.replace].call(this, str, substitution.replace(/\$<([^>]+)>/g, function (_, name) { return "$" + groups[name]; })); } if ("function" == typeof substitution) { var _this = this; return _super[Symbol.replace].call(this, str, function () { var args = arguments; return "object" != _typeof(args[args.length - 1]) && (args = [].slice.call(args)).push(buildGroups(args, _this)), substitution.apply(this, args); }); } return _super[Symbol.replace].call(this, str, substitution); }, _wrapRegExp.apply(this, arguments); }
 
-function normalizeSuffix(suffix) {
-  if (suffix === 'M') {
-    return '';
-  }
+function _inherits(subClass, superClass) { if (typeof superClass !== "function" && superClass !== null) { throw new TypeError("Super expression must either be null or a function"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); Object.defineProperty(subClass, "prototype", { writable: false }); if (superClass) _setPrototypeOf(subClass, superClass); }
 
-  return suffix;
-}
+function _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf || function _setPrototypeOf(o, p) { o.__proto__ = p; return o; }; return _setPrototypeOf(o, p); }
 
-function chordSuffix(noteNumber, suffix) {
-  if ((0, _utilities.isEmptyString)(suffix)) {
-    var defaultSuffix = MAJOR_SCALE[noteNumber];
-    return normalizeSuffix(defaultSuffix);
+function normalizeSuffix(suffix) {
+  if (_suffixNormalizeMapping["default"][suffix] === '[blank]') {
+    return null;
   }
 
-  return normalizeSuffix(suffix);
+  return _suffixNormalizeMapping["default"][suffix] || suffix;
 }
 
 var chordRegex = /*#__PURE__*/_wrapRegExp(/^([A-G])(#|b)?((?:(?![\t-\r \/\xA0\u1680\u2000-\u200A\u2028\u2029\u202F\u205F\u3000\uFEFF])[\s\S])*)(\/([A-G])(#|b)?)?$/i, {
@@ -83,7 +80,16 @@ var numericChordRegex = /*#__PURE__*/_wrapRegExp(/^(#|b)?([1-7])((?:(?![\t-\r \/
   bassBase: 6
 });
 
-var regexes = [numericChordRegex, chordRegex];
+var sortedNumerals = _toConsumableArray(_constants.ROMAN_NUMERALS).sort(function (numeralA, numeralB) {
+  return numeralB.length - numeralA.length;
+});
+
+var numerals = [].concat(_toConsumableArray(sortedNumerals), _toConsumableArray(sortedNumerals.map(function (numeral) {
+  return numeral.toLowerCase();
+}))).join('|');
+var numeralChordRegex = // eslint-disable-next-line max-len
+new RegExp("^(?<modifier>#|b)?(?<base>".concat(numerals, ")(?<suffix>[^/\\s]*)(\\/(?<bassModifier>#|b)?(?<bassBase>").concat(numerals, "))?$"));
+var regexes = [numericChordRegex, numeralChordRegex, chordRegex];
 /**
  * Represents a Chord, consisting of a root, suffix (quality) and bass
  */
@@ -122,15 +128,24 @@ var Chord = /*#__PURE__*/function () {
       set: void 0
     });
 
+    this.suffix = (0, _utilities.presence)(suffix);
     this.root = root || new _key["default"]({
       note: base,
-      modifier: modifier
+      modifier: modifier,
+      minor: suffix === 'm'
     });
-    this.suffix = (0, _utilities.presence)(suffix);
-    this.bass = bass || (bassBase ? new _key["default"]({
-      note: bassBase,
-      modifier: bassModifier
-    }) : null);
+
+    if (bass) {
+      this.bass = bass;
+    } else if (bassBase) {
+      this.bass = new _key["default"]({
+        note: bassBase,
+        modifier: bassModifier,
+        minor: suffix === 'm'
+      });
+    } else {
+      this.bass = null;
+    }
   }
 
   _createClass(Chord, [{
@@ -162,11 +177,18 @@ var Chord = /*#__PURE__*/function () {
 
       var keyObj = _key["default"].wrap(key);
 
-      return new Chord({
-        suffix: chordSuffix(_classPrivateFieldGet(this, _rootNote), this.suffix),
-        root: this.root.toChordSymbol(keyObj),
-        bass: (_this$bass = this.bass) === null || _this$bass === void 0 ? void 0 : _this$bass.toChordSymbol(keyObj)
+      var rootKey = this.root.toChordSymbol(keyObj).normalizeEnharmonics(keyObj);
+      var chordSymbolChord = new Chord({
+        suffix: normalizeSuffix(this.suffix),
+        root: rootKey,
+        bass: (_this$bass = this.bass) === null || _this$bass === void 0 ? void 0 : _this$bass.toChordSymbol(keyObj).normalizeEnharmonics(rootKey)
       });
+
+      if (this.root.isMinor()) {
+        chordSymbolChord = chordSymbolChord.makeMinor();
+      }
+
+      return chordSymbolChord;
     }
     /**
      * Converts the chord to a chord symbol string, using the supplied key as a reference.
@@ -193,7 +215,7 @@ var Chord = /*#__PURE__*/function () {
       return _classPrivateMethodGet(this, _is, _is2).call(this, _constants.SYMBOL);
     }
     /**
-     * Converts the chord to a numeric chord, using the supplied kye as a reference.
+     * Converts the chord to a numeric chord, using the supplied key as a reference.
      * For example, a chord symbol A# with reference key E will return the numeric chord #4.
      * @param {Key|string} key the reference key
      * @returns {Chord} the numeric chord
@@ -202,20 +224,77 @@ var Chord = /*#__PURE__*/function () {
   }, {
     key: "toNumeric",
     value: function toNumeric(key) {
-      var _this$bass2;
+      var _this$bass3;
 
       if (this.isNumeric()) {
         return this.clone();
       }
 
+      if (this.isNumeral()) {
+        var _this$bass2;
+
+        return this.set({
+          root: this.root.toNumeric(),
+          bass: (_this$bass2 = this.bass) === null || _this$bass2 === void 0 ? void 0 : _this$bass2.toNumeric()
+        });
+      }
+
       var keyObj = _key["default"].wrap(key);
 
       return new Chord({
-        suffix: chordSuffix(_classPrivateFieldGet(this, _rootNote), this.suffix),
+        suffix: normalizeSuffix(this.suffix),
         root: this.root.toNumeric(keyObj),
-        bass: (_this$bass2 = this.bass) === null || _this$bass2 === void 0 ? void 0 : _this$bass2.toNumeric(keyObj)
+        bass: (_this$bass3 = this.bass) === null || _this$bass3 === void 0 ? void 0 : _this$bass3.toNumeric(keyObj)
       });
     }
+    /**
+     * Converts the chord to a numeral chord, using the supplied key as a reference.
+     * For example, a chord symbol A# with reference key E will return the numeral chord #IV.
+     * @param {Key|string|null} key the reference key. The key is required when converting a chord symbol
+     * @returns {Chord} the numeral chord
+     */
+
+  }, {
+    key: "toNumeral",
+    value: function toNumeral() {
+      var _this$bass5;
+
+      var key = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : null;
+
+      if (this.isNumeral()) {
+        return this.clone();
+      }
+
+      if (this.isNumeric()) {
+        var _this$bass4;
+
+        return this.set({
+          root: this.root.toNumeral(),
+          bass: (_this$bass4 = this.bass) === null || _this$bass4 === void 0 ? void 0 : _this$bass4.toNumeral()
+        });
+      }
+
+      var keyObj = _key["default"].wrap(key);
+
+      return new Chord({
+        suffix: normalizeSuffix(this.suffix),
+        root: this.root.toNumeral(keyObj),
+        bass: (_this$bass5 = this.bass) === null || _this$bass5 === void 0 ? void 0 : _this$bass5.toNumeral(keyObj)
+      });
+    }
+    /**
+     * Converts the chord to a numeral chord string, using the supplied kye as a reference.
+     * For example, a chord symbol A# with reference key E will return the numeral chord #4.
+     * @param {Key|string} key the reference key
+     * @returns {string} the numeral chord string
+     * @see {toNumeral}
+     */
+
+  }, {
+    key: "toNumeralString",
+    value: function toNumeralString(key) {
+      return this.toNumeral(key).toString();
+    }
     /**
      * Determines whether the chord is numeric
      * @returns {boolean}
@@ -239,6 +318,16 @@ var Chord = /*#__PURE__*/function () {
     value: function toNumericString(key) {
       return this.toNumeric(key).toString();
     }
+    /**
+     * Determines whether the chord is a numeral
+     * @returns {boolean}
+     */
+
+  }, {
+    key: "isNumeral",
+    value: function isNumeral() {
+      return _classPrivateMethodGet(this, _is, _is2).call(this, _constants.NUMERAL);
+    }
     /**
      * Converts the chord to a string, eg `Esus4/G#` or `1sus4/#3`
      * @returns {string} the chord string
@@ -256,7 +345,7 @@ var Chord = /*#__PURE__*/function () {
       return chordString;
     }
     /**
-     * Normalizes the chord:
+     * Normalizes the chord root and bass notes:
      * - Fb becomes E
      * - Cb becomes B
      * - B# becomes C
@@ -266,14 +355,26 @@ var Chord = /*#__PURE__*/function () {
      * - 7# becomes 1
      * - 3# becomes 4
      *
-     * If the chord is already normalized, this will return a copy.
+     * Besides that it normalizes the suffix. For example, `sus2` becomes `2`, `sus4` becomes `sus`.
+     * All suffix normalizations can be found in `src/normalize_mappings/suffix-mapping.txt`.
+     *
      * @returns {Chord} the normalized chord
      */
 
   }, {
     key: "normalize",
-    value: function normalize() {
-      return _classPrivateMethodGet(this, _process, _process2).call(this, 'normalize');
+    value: function normalize(key) {
+      if (!(0, _utilities.presence)(key)) {
+        return _classPrivateMethodGet(this, _process, _process2).call(this, 'normalize').set({
+          suffix: (0, _utilities.presence)(normalizeSuffix(this.suffix))
+        });
+      }
+
+      return this.set({
+        root: this.root.normalizeEnharmonics(key),
+        suffix: (0, _utilities.presence)(normalizeSuffix(this.suffix)),
+        bass: this.bass ? this.bass.normalizeEnharmonics(this.root.toString()) : null
+      });
     }
     /**
      * Switches to the specified modifier
@@ -317,15 +418,26 @@ var Chord = /*#__PURE__*/function () {
     value: function transpose(delta) {
       return _classPrivateMethodGet(this, _process, _process2).call(this, 'transpose', delta);
     }
+  }, {
+    key: "makeMinor",
+    value: function makeMinor() {
+      if (!this.suffix || this.suffix[0] !== 'm') {
+        return this.set({
+          suffix: "m".concat(this.suffix || '')
+        });
+      }
+
+      return this.clone();
+    }
   }, {
     key: "set",
     value: function set(properties) {
-      var _this$bass3;
+      var _this$bass6;
 
       return new this.constructor(_objectSpread({
         root: this.root.clone(),
         suffix: this.suffix,
-        bass: (_this$bass3 = this.bass) === null || _this$bass3 === void 0 ? void 0 : _this$bass3.clone()
+        bass: (_this$bass6 = this.bass) === null || _this$bass6 === void 0 ? void 0 : _this$bass6.clone()
       }, properties));
     }
   }], [{

package/lib/chord_sheet/chord_lyrics_pair.js

@@ -9,7 +9,7 @@ function _classCallCheck(instance, Constructor) { if (!(instance instanceof Cons
 
 function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }
 
-function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); return Constructor; }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
 
 /**
  * Represents a chord with the corresponding (partial) lyrics

package/lib/chord_sheet/chord_pro/composite.js

@@ -9,7 +9,7 @@ function _classCallCheck(instance, Constructor) { if (!(instance instanceof Cons
 
 function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }
 
-function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); return Constructor; }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
 
 var Composite = /*#__PURE__*/function () {
   function Composite(expressions) {

package/lib/chord_sheet/chord_pro/evaluation_error.js

@@ -1,15 +1,19 @@
 "use strict";
 
-function _typeof(obj) { "@babel/helpers - typeof"; if (typeof Symbol === "function" && typeof Symbol.iterator === "symbol") { _typeof = function _typeof(obj) { return typeof obj; }; } else { _typeof = function _typeof(obj) { return obj && typeof Symbol === "function" && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }; } return _typeof(obj); }
+function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
 
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports["default"] = void 0;
 
+function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }
+
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
+
 function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
 
-function _inherits(subClass, superClass) { if (typeof superClass !== "function" && superClass !== null) { throw new TypeError("Super expression must either be null or a function"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); if (superClass) _setPrototypeOf(subClass, superClass); }
+function _inherits(subClass, superClass) { if (typeof superClass !== "function" && superClass !== null) { throw new TypeError("Super expression must either be null or a function"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); Object.defineProperty(subClass, "prototype", { writable: false }); if (superClass) _setPrototypeOf(subClass, superClass); }
 
 function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }
 
@@ -47,7 +51,7 @@ var EvaluationError = /*#__PURE__*/function (_Error) {
     return _this;
   }
 
-  return EvaluationError;
+  return _createClass(EvaluationError);
 }( /*#__PURE__*/_wrapNativeSuper(Error));
 
 var _default = EvaluationError;

package/lib/chord_sheet/chord_pro/literal.js

@@ -9,7 +9,7 @@ function _classCallCheck(instance, Constructor) { if (!(instance instanceof Cons
 
 function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }
 
-function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); return Constructor; }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
 
 var Literal = /*#__PURE__*/function () {
   function Literal(expression) {

package/lib/chord_sheet/chord_pro/ternary.js

@@ -17,7 +17,7 @@ function _classCallCheck(instance, Constructor) { if (!(instance instanceof Cons
 
 function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }
 
-function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); return Constructor; }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
 
 var Ternary = /*#__PURE__*/function () {
   function Ternary() {

package/lib/chord_sheet/comment.js

@@ -9,7 +9,7 @@ function _classCallCheck(instance, Constructor) { if (!(instance instanceof Cons
 
 function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }
 
-function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); return Constructor; }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
 
 /**
  * Represents a comment. See https://www.chordpro.org/chordpro/chordpro-file-format-specification/#overview

package/lib/chord_sheet/line.js

@@ -19,7 +19,7 @@ function _classCallCheck(instance, Constructor) { if (!(instance instanceof Cons
 
 function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }
 
-function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); return Constructor; }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
 
 /**
  * Represents a line in a chord sheet, consisting of items of type ChordLyricsPair or Tag

package/lib/chord_sheet/metadata.js

@@ -35,7 +35,7 @@ function _classCallCheck(instance, Constructor) { if (!(instance instanceof Cons
 
 function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }
 
-function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); return Constructor; }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
 
 function appendValue(array, key, value) {
   if (!array.includes(value)) {

package/lib/chord_sheet/paragraph.js

@@ -23,7 +23,7 @@ function _classCallCheck(instance, Constructor) { if (!(instance instanceof Cons
 
 function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }
 
-function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); return Constructor; }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
 
 /**
  * Represents a paragraph of lines in a chord sheet

package/lib/chord_sheet/song.js

@@ -1,6 +1,6 @@
 "use strict";
 
-function _typeof(obj) { "@babel/helpers - typeof"; if (typeof Symbol === "function" && typeof Symbol.iterator === "symbol") { _typeof = function _typeof(obj) { return typeof obj; }; } else { _typeof = function _typeof(obj) { return obj && typeof Symbol === "function" && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }; } return _typeof(obj); }
+function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
 
 Object.defineProperty(exports, "__esModule", {
   value: true
@@ -43,7 +43,7 @@ function _classCallCheck(instance, Constructor) { if (!(instance instanceof Cons
 
 function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }
 
-function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); return Constructor; }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
 
 /**
  * Represents a song in a chord sheet. Currently a chord sheet can only have one song.

package/lib/chord_sheet/tag.js

@@ -12,7 +12,7 @@ function _classCallCheck(instance, Constructor) { if (!(instance instanceof Cons
 
 function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }
 
-function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); return Constructor; }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
 
 function _defineProperty(obj, key, value) { if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
 

package/lib/chord_sheet_serializer.js

@@ -25,7 +25,7 @@ function _classCallCheck(instance, Constructor) { if (!(instance instanceof Cons
 
 function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }
 
-function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); return Constructor; }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
 
 var CHORD_SHEET = 'chordSheet';
 var CHORD_LYRICS_PAIR = 'chordLyricsPair';

package/lib/constants.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.VERSE = exports.TAB = exports.SYMBOL = exports.NUMERIC = exports.NONE = exports.INDETERMINATE = exports.CHORUS = void 0;
+exports.VERSE = exports.TAB = exports.SYMBOL = exports.ROMAN_NUMERALS = exports.NUMERIC = exports.NUMERAL = exports.NONE = exports.INDETERMINATE = exports.CHORUS = void 0;
 
 /**
  * Used to mark a paragraph as verse
@@ -47,4 +47,8 @@ exports.TAB = TAB;
 var SYMBOL = 'symbol';
 exports.SYMBOL = SYMBOL;
 var NUMERIC = 'numeric';
-exports.NUMERIC = NUMERIC;
+exports.NUMERIC = NUMERIC;
+var NUMERAL = 'numeral';
+exports.NUMERAL = NUMERAL;
+var ROMAN_NUMERALS = ['I', 'II', 'III', 'IV', 'V', 'VI', 'VII'];
+exports.ROMAN_NUMERALS = ROMAN_NUMERALS;

package/lib/formatter/chord_pro_formatter.js

@@ -19,7 +19,7 @@ function _classCallCheck(instance, Constructor) { if (!(instance instanceof Cons
 
 function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }
 
-function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); return Constructor; }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
 
 var NEW_LINE = '\n';
 /**