abcjs 6.0.0-beta.7 → 6.0.0

package/src/edit/abc_editor.js

@@ -1,139 +1,3 @@
-// abc_editor.js
-//    Copyright (C) 2015-2020 Paul Rosen (paul at paulrosen dot net)
-//
-//    Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
-//    documentation files (the "Software"), to deal in the Software without restriction, including without limitation
-//    the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and
-//    to permit persons to whom the Software is furnished to do so, subject to the following conditions:
-//
-//    The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
-//
-//    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING
-//    BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
-//    NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
-//    DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-//    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
-
-// window.ABCJS.Editor is the interface class for the area that contains the ABC text. It is responsible for
-// holding the text of the tune and calling the parser and the rendering engines.
-//
-// EditArea is an example of using a textarea as the control that is shown to the user. As long as
-// the same interface is used, window.ABCJS.Editor can use a different type of object.
-//
-// EditArea:
-// - constructor(textareaid)
-//		This contains the id of a textarea control that will be used.
-// - addSelectionListener(listener)
-//		A callback class that contains the entry point fireSelectionChanged()
-// - addChangeListener(listener)
-//		A callback class that contains the entry point fireChanged()
-// - getSelection()
-//		returns the object { start: , end: } with the current selection in characters
-// - setSelection(start, end)
-//		start and end are the character positions that should be selected.
-// - getString()
-//		returns the ABC text that is currently displayed.
-// - setString(str)
-//		sets the ABC text that is currently displayed, and resets the initialText variable
-// - getElem()
-//		returns the textarea element
-// - string initialText
-//		Contains the starting text. This can be compared against the current text to see if anything changed.
-//
-
-/*global document, window, clearTimeout, setTimeout */
-
-var TuneBook = require('../api/abc_tunebook').TuneBook;
-var parseCommon = require('../parse/abc_common');
-var Parse = require('../parse/abc_parse');
-var TextPrinter = require('../transform/abc2abc_write');
-var EngraverController = require('../write/abc_engraver_controller');
-var SynthController = require('../synth/synth-controller');
-var supportsAudio = require('../synth/supports-audio');
-
-// Polyfill for CustomEvent for old IE versions
-try {
-	if (typeof window.CustomEvent !== "function") {
-		var CustomEvent = function (event, params) {
-			params = params || {bubbles: false, cancelable: false, detail: undefined};
-			var evt = document.createEvent('CustomEvent');
-			evt.initCustomEvent(event, params.bubbles, params.cancelable, params.detail);
-			return evt;
-		};
-		CustomEvent.prototype = window.Event.prototype;
-		window.CustomEvent = CustomEvent;
-	}
-} catch (e) {
-	// if we aren't in a browser, this code will crash, but it is not needed then either.
-}
-
-var EditArea = function(textareaid) {
-  this.textarea = document.getElementById(textareaid);
-  this.initialText = this.textarea.value;
-  this.isDragging = false;
-}
-
-EditArea.prototype.addSelectionListener = function(listener) {
-  this.textarea.onmousemove = function(ev) {
-	  if (this.isDragging)
-	    listener.fireSelectionChanged();
-  };
-};
-
-EditArea.prototype.addChangeListener = function(listener) {
-  this.changelistener = listener;
-  this.textarea.onkeyup = function() {
-    listener.fireChanged();
-  };
-  this.textarea.onmousedown = function() {
-	this.isDragging = true;
-    listener.fireSelectionChanged();
-  };
-  this.textarea.onmouseup = function() {
-	this.isDragging = false;
-    listener.fireChanged();
-  };
-  this.textarea.onchange = function() {
-    listener.fireChanged();
-  };
-};
-
-//TODO won't work under IE?
-EditArea.prototype.getSelection = function() {
-  return {start: this.textarea.selectionStart, end: this.textarea.selectionEnd};
-};
-
-EditArea.prototype.setSelection = function(start, end) {
-	if(this.textarea.setSelectionRange)
-	   this.textarea.setSelectionRange(start, end);
-	else if(this.textarea.createTextRange) {
-		// For IE8
-	   var e = this.textarea.createTextRange();
-	   e.collapse(true);
-	   e.moveEnd('character', end);
-	   e.moveStart('character', start);
-	   e.select();
-	}
-  this.textarea.focus();
-};
-
-EditArea.prototype.getString = function() {
-  return this.textarea.value;
-};
-
-EditArea.prototype.setString = function(str) {
-  this.textarea.value = str;
-  this.initialText = this.getString();
-  if (this.changelistener) {
-    this.changelistener.fireChanged();
-  }
-};
-
-EditArea.prototype.getElem = function() {
-  return this.textarea;
-};
-
-//
 // window.ABCJS.Editor:
 //
 // constructor(editarea, params)
@@ -158,18 +22,13 @@ EditArea.prototype.getElem = function() {
 //		adds or removes the class abc_textarea_readonly, and adds or removes the attribute readonly=yes
 // - setDirtyStyle(bool)
 //		adds or removes the class abc_textarea_dirty
-// - renderTune(abc, parserparams, div)
-//		Immediately renders the tune. (Useful for creating the SVG output behind the scenes, if div is hidden)
-//		string abc: the ABC text
-//		parserparams: params to send to the parser
-//		div: the HTML id to render to.
 // - modelChanged()
 //		Called when the model has been changed to trigger re-rendering
 // - parseABC()
 //		Called internally by fireChanged()
 //		returns true if there has been a change since last call.
 // - updateSelection()
-//		Called when the user has changed the selection. This calls the engraver_controller to show the selection.
+//		Called when the user has changed the selection. This calls the engraver to show the selection.
 // - fireSelectionChanged()
 //		Called by the textarea object when the user has changed the selection.
 // - paramChanged(engraverparams)
@@ -181,43 +40,65 @@ EditArea.prototype.getElem = function() {
 // - isDirty()
 //		Returns true or false, whether the textarea contains the same text that it started with.
 // - highlight(abcelem)
-//		Called by the engraver_controller to highlight an area.
+//		Called by the engraver to highlight an area.
 // - pause(bool)
 //		Stops the automatic rendering when the user is typing.
 //
+var parseCommon = require('../parse/abc_common');
+var SynthController = require('../synth/synth-controller');
+var supportsAudio = require('../synth/supports-audio');
+var renderAbc = require('../api/abc_tunebook_svg');
+var EditArea = require('./abc_editarea');
 
-var Editor = function(editarea, params) {
-	// Copy all the options that will be passed through
-	this.abcjsParams = {};
+function gatherAbcParams(params) {
+	// There used to be a bunch of ways parameters can be passed in. This just simplifies it.
+	var abcjsParams = {};
 	var key;
 	if (params.abcjsParams) {
 		for (key in params.abcjsParams) {
 			if (params.abcjsParams.hasOwnProperty(key)) {
-				this.abcjsParams[key] = params.abcjsParams[key];
+				abcjsParams[key] = params.abcjsParams[key];
 			}
 		}
 	}
 	if (params.midi_options) {
 		for (key in params.midi_options) {
 			if (params.midi_options.hasOwnProperty(key)) {
-				this.abcjsParams[key] = params.midi_options[key];
+				abcjsParams[key] = params.midi_options[key];
 			}
 		}
 	}
 	if (params.parser_options) {
 		for (key in params.parser_options) {
 			if (params.parser_options.hasOwnProperty(key)) {
-				this.abcjsParams[key] = params.parser_options[key];
+				abcjsParams[key] = params.parser_options[key];
 			}
 		}
 	}
 	if (params.render_options) {
 		for (key in params.render_options) {
 			if (params.render_options.hasOwnProperty(key)) {
-				this.abcjsParams[key] = params.render_options[key];
+				abcjsParams[key] = params.render_options[key];
 			}
 		}
 	}
+	/*
+	if (params.tablature_options) {
+		abcjsParams['tablatures'] = params.tablature_options;
+	}
+	*/
+	if (abcjsParams.tablature) {
+		if (params.warnings_id) {
+			// store for plugin error handling
+			abcjsParams.tablature.warnings_id = params.warnings_id;
+		}
+	}
+	return abcjsParams;
+}
+
+var Editor = function(editarea, params) {
+	// Copy all the options that will be passed through
+	this.abcjsParams = gatherAbcParams(params);
 
 	if (params.indicate_changed)
 		this.indicate_changed = true;
@@ -230,25 +111,30 @@ var Editor = function(editarea, params) {
   this.editarea.addChangeListener(this);
 
   if (params.canvas_id) {
-    this.div = document.getElementById(params.canvas_id);
+    this.div = params.canvas_id;
   } else if (params.paper_id) {
-    this.div = document.getElementById(params.paper_id);
+    this.div = params.paper_id;
   } else {
     this.div = document.createElement("DIV");
     this.editarea.getElem().parentNode.insertBefore(this.div, this.editarea.getElem());
   }
+  if (typeof this.div === 'string')
+	  this.div = document.getElementById(this.div);
 
   if (params.selectionChangeCallback) {
   	this.selectionChangeCallback = params.selectionChangeCallback;
   }
 
+  this.clientClickListener = this.abcjsParams.clickListener;
+  this.abcjsParams.clickListener = this.highlight.bind(this);
+
   if (params.synth) {
   	if (supportsAudio()) {
 	    this.synth = {
 		    el: params.synth.el,
 		    cursorControl: params.synth.cursorControl,
 		    options: params.synth.options
-	    }
+	    };
     }
   }
 	// If the user wants midi, then store the elements that it will be written to. The element could either be passed in as an id,
@@ -269,21 +155,20 @@ var Editor = function(editarea, params) {
 		}
 	}
 
-  if (params.generate_warnings || params.warnings_id) {
-    if (params.warnings_id) {
+  if (params.warnings_id) {
+  	if (typeof(params.warnings_id) === "string")
       this.warningsdiv = document.getElementById(params.warnings_id);
-    } else {
-      this.warningsdiv = this.div;
-    }
+  	else
+		this.warningsdiv = params.warnings_id;
+  } else if (params.generate_warnings) {
+	  this.warningsdiv = document.createElement("div");
+	  this.div.parentNode.insertBefore(this.warningsdiv, this.div);
   }
 
   this.onchangeCallback = params.onchange;
 
-  if (params.gui) {
-    this.target = document.getElementById(editarea);
-    this.abcjsParams.editable = true;
-  }
-  this.oldt = "";
+  this.currentAbc = "";
+  this.tunes = [];
   this.bReentry = false;
   this.parseABC();
   this.modelChanged();
@@ -319,15 +204,6 @@ var Editor = function(editarea, params) {
   };
 };
 
-Editor.prototype.renderTune = function(abc, params, div) {
-  var tunebook = new TuneBook(abc);
-  var abcParser = Parse();
-  abcParser.parse(tunebook.tunes[0].abc, params, tunebook.tunes[0].startPos - tunebook.header.length); //TODO handle multiple tunes
-  var tune = abcParser.getTune();
-  var engraver_controller = new EngraverController(div, this.abcjsParams);
-  engraver_controller.engraveABC(tune);
-};
-
 Editor.prototype.redrawMidi = function() {
 	if (this.generate_midi && !this.midiPause) {
 		var event = new window.CustomEvent("generateMidi", {
@@ -342,47 +218,44 @@ Editor.prototype.redrawMidi = function() {
 		window.dispatchEvent(event);
 	}
 	if (this.synth) {
+		var userAction = this.synth.synthControl; // Can't really tell if there was a user action before drawing, but we assume that if the synthControl was created already there was a user action.
 		if (!this.synth.synthControl) {
 			this.synth.synthControl = new SynthController();
 			this.synth.synthControl.load(this.synth.el, this.synth.cursorControl, this.synth.options);
 		}
-		this.synth.synthControl.setTune(this.tunes[0], false, this.abcjsParams);
+		this.synth.synthControl.setTune(this.tunes[0], userAction, this.synth.options);
 	}
 };
 
 Editor.prototype.modelChanged = function() {
-  if (this.tunes === undefined) {
-    if (this.downloadMidi !== undefined)
-		this.downloadMidi.innerHTML = "";
-    if (this.inlineMidi !== undefined)
-		this.inlineMidi.innerHTML = "";
-    this.div.innerHTML = "";
-	return;
-  }
-
   if (this.bReentry)
     return; // TODO is this likely? maybe, if we rewrite abc immediately w/ abc2abc
-  this.bReentry = true;
-  this.timerId = null;
-  this.div.innerHTML = "";
-  this.engraver_controller = new EngraverController(this.div, this.abcjsParams);
-  this.engraver_controller.engraveABC(this.tunes);
-	this.tunes[0].engraver = this.engraver_controller;	// TODO-PER: We actually want an output object for each tune, not the entire controller. When refactoring, don't save data in the controller.
-	this.redrawMidi();
+	this.bReentry = true;
+	try {
+		this.timerId = null;
+		if (this.synth && this.synth.synthControl)
+			this.synth.synthControl.disable(true);
+
+		this.tunes = renderAbc(this.div, this.currentAbc, this.abcjsParams);
+		if (this.tunes.length > 0) {
+			this.warnings = this.tunes[0].warnings;
+		}
+		this.redrawMidi();
+	} catch(error) {
+		console.error("ABCJS error: ", error);
+		if (!this.warnings)
+			this.warnings = [];
+		this.warnings.push(error.message);
+	}
 
   if (this.warningsdiv) {
     this.warningsdiv.innerHTML = (this.warnings) ? this.warnings.join("<br />") : "No errors";
   }
-  if (this.target) {
-    var textprinter = new TextPrinter(this.target, true);
-    textprinter.printABC(this.tunes[0]); //TODO handle multiple tunes
-  }
-  this.engraver_controller.addSelectListener(this.highlight.bind(this));
   this.updateSelection();
   this.bReentry = false;
 };
 
-// Call this to reparse in response to the printing parameters changing
+// Call this to reparse in response to the client changing the parameters on the fly
 Editor.prototype.paramChanged = function(engraverParams) {
 	if (engraverParams) {
 		for (var key in engraverParams) {
@@ -391,51 +264,48 @@ Editor.prototype.paramChanged = function(engraverParams) {
 			}
 		}
 	}
-	this.oldt = "";
+	this.currentAbc = "";
+	this.fireChanged();
+};
+
+Editor.prototype.synthParamChanged = function(options) {
+	if (!this.synth)
+		return;
+	this.synth.options = {};
+	if (options) {
+		for (var key in options) {
+			if (options.hasOwnProperty(key)) {
+				this.synth.options[key] = options[key];
+			}
+		}
+	}
+	this.currentAbc = "";
 	this.fireChanged();
 };
 
 // return true if the model has changed
 Editor.prototype.parseABC = function() {
   var t = this.editarea.getString();
-  if (t===this.oldt) {
+  if (t===this.currentAbc) {
     this.updateSelection();
     return false;
   }
 
-  this.oldt = t;
-  if (t === "") {
-	this.tunes = undefined;
-	this.warnings = "";
-	return true;
-  }
-  var tunebook = new TuneBook(t);
-
-  this.tunes = [];
-  this.startPos = [];
-  this.warnings = [];
-  for (var i=0; i<tunebook.tunes.length; i++) {
-    var abcParser = new Parse();
-    abcParser.parse(tunebook.tunes[i].abc, this.abcjsParams, tunebook.tunes[i].startPos - tunebook.header.length);
-    this.tunes[i] = abcParser.getTune();
-	  this.startPos[i] = tunebook.tunes[i].startPos;
-    var warnings = abcParser.getWarnings() || [];
-    for (var j=0; j<warnings.length; j++) {
-      this.warnings.push(warnings[j]);
-    }
-  }
+  this.currentAbc = t;
   return true;
 };
 
 Editor.prototype.updateSelection = function() {
   var selection = this.editarea.getSelection();
   try {
-    this.engraver_controller.rangeHighlight(selection.start, selection.end);
+  	if (this.tunes.length > 0 && this.tunes[0].engraver)
+	  this.tunes[0].engraver.rangeHighlight(selection.start, selection.end);
   } catch (e) {} // maybe printer isn't defined yet?
 	if (this.selectionChangeCallback)
 		this.selectionChangeCallback(selection.start, selection.end);
 };
 
+// Called when the textarea's selection is in the process of changing (after mouse down, dragging, or keyboard arrows)
 Editor.prototype.fireSelectionChanged = function() {
   this.updateSelection();
 };
@@ -470,7 +340,7 @@ Editor.prototype.setDirtyStyle = function(isDirty) {
     }
 };
 
-// call when abc text is changed and needs re-parsing
+// call when the textarea alerts us that the abc text is changed and needs re-parsing
 Editor.prototype.fireChanged = function() {
   if (this.bIsPaused)
     return;
@@ -503,13 +373,15 @@ Editor.prototype.isDirty = function() {
 	return this.editarea.initialText !== this.editarea.getString();
 };
 
-Editor.prototype.highlight = function(abcelem, tuneNumber, classes) {
+Editor.prototype.highlight = function(abcelem, tuneNumber, classes, analysis, drag, mouseEvent) {
 	// TODO-PER: The marker appears to get off by one for each tune parsed. I'm not sure why, but adding the tuneNumber in corrects it for the time being.
 //	var offset = (tuneNumber !== undefined) ? this.startPos[tuneNumber] + tuneNumber : 0;
 
   this.editarea.setSelection(abcelem.startChar, abcelem.endChar);
 	if (this.selectionChangeCallback)
 		this.selectionChangeCallback(abcelem.startChar, abcelem.endChar);
+	if (this.clientClickListener)
+		this.clientClickListener(abcelem, tuneNumber, classes, analysis, drag, mouseEvent);
 };
 
 Editor.prototype.pause = function(shouldPause) {
@@ -519,6 +391,8 @@ Editor.prototype.pause = function(shouldPause) {
 };
 
 Editor.prototype.millisecondsPerMeasure = function() {
+	if (!this.synth || !this.synth.synthControl || !this.synth.synthControl.visualObj)
+		return 0;
 	return this.synth.synthControl.visualObj.millisecondsPerMeasure();
 };
 

package/src/midi/abc_midi_create.js

@@ -1,23 +1,6 @@
 //    abc_midi_create.js: Turn a linear series of events into a midi file.
-//    Copyright (C) 2010-2020 Gregory Dyke (gregdyke at gmail dot com) and Paul Rosen
-//
-//    Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
-//    documentation files (the "Software"), to deal in the Software without restriction, including without limitation
-//    the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and
-//    to permit persons to whom the Software is furnished to do so, subject to the following conditions:
-//
-//    The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
-//
-//    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING
-//    BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
-//    NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
-//    DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-//    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
-var flatten = require('./abc_midi_flattener');
-var Preparer = require('./abc_midi_js_preparer');
-var rendererFactory = require('./abc_midi_renderer');
-var sequence = require('./abc_midi_sequencer');
+var rendererFactory = require('../synth/abc_midi_renderer');
 
 var create;
 
@@ -28,22 +11,21 @@ var create;
 
 	create = function(abcTune, options) {
 		if (options === undefined) options = {};
-		var sequenceInst = sequence(abcTune, options);
-		var commands = flatten(sequenceInst, options);
+		var commands = abcTune.setUpAudio(options);
 		var midi = rendererFactory();
-		var midiJs = new Preparer();
 
 		var title = abcTune.metaText ? abcTune.metaText.title : undefined;
 		if (title && title.length > 128)
 			title = title.substring(0,124) + '...';
 		var key = abcTune.getKeySignature();
 		var time = abcTune.getMeterFraction();
+		var beatsPerSecond = commands.tempo / 60;
+		//var beatLength = abcTune.getBeatLength();
 		midi.setGlobalInfo(commands.tempo, title, key, time);
-		midiJs.setGlobalInfo(commands.tempo, title);
 
 		for (var i = 0; i < commands.tracks.length; i++) {
 			midi.startTrack();
-			midiJs.startTrack();
+			var notePlacement = {};
 			for (var j = 0; j < commands.tracks[i].length; j++) {
 				var event = commands.tracks[i][j];
 				switch (event.cmd) {
@@ -51,46 +33,62 @@ var create;
 						midi.setText(event.type, event.text);
 						break;
 					case 'program':
-						midi.setChannel(event.channel);
+						var pan = 0;
+						if (options.pan && options.pan.length > i)
+							pan = options.pan[i];
+						midi.setChannel(event.channel, pan);
 						midi.setInstrument(event.instrument);
-						midiJs.setChannel(event.channel);
-						midiJs.setInstrument(event.instrument);
 						break;
-					case 'start':
-						midi.startNote(convertPitch(event.pitch), event.volume);
-						midiJs.startNote(convertPitch(event.pitch), event.volume);
-						break;
-					case 'stop':
-						midi.endNote(convertPitch(event.pitch));
-						midiJs.endNote(convertPitch(event.pitch));
-						break;
-					case 'move':
-						midi.addRest(event.duration * baseDuration);
-						midiJs.addRest(event.duration * baseDuration);
+					case 'note':
+						var gapLengthInBeats = event.gap * beatsPerSecond;
+						var start = event.start;
+						// The staccato and legato are indicated by event.gap.
+						// event.gap is in seconds but the durations are in whole notes.
+						var end = start + event.duration - gapLengthInBeats;
+						if (!notePlacement[start])
+							notePlacement[start] = [];
+						notePlacement[start].push({ pitch: event.pitch, volume: event.volume, cents: event.cents });
+						if (!notePlacement[end])
+							notePlacement[end] = [];
+						notePlacement[end].push({ pitch: event.pitch, volume: 0 });
 						break;
 					default:
 						console.log("MIDI create Unknown: " + event.cmd);
 				}
 			}
+			addNotes(midi, notePlacement, baseDuration);
 			midi.endTrack();
-			midiJs.endTrack();
 		}
 
-		var midiFile = midi.getData();
-		var midiInline = midiJs.getData();
-		if (options.generateInline === undefined) // default is to generate inline controls.
-			options.generateInline = true;
-		if (options.generateInline && options.generateDownload)
-			return { download: midiFile, inline: midiInline };
-		else if (options.generateInline)
-			return midiInline;
-		else
-			return midiFile;
+		return midi.getData();
 	};
 
-	function convertPitch(pitch) {
-		return 60 + pitch;
+	function addNotes(midi, notePlacement, baseDuration) {
+		var times = Object.keys(notePlacement);
+		for (var h = 0; h < times.length; h++)
+			times[h] = parseFloat(times[h]);
+		times.sort(function(a,b) {
+			return a - b;
+		});
+		var lastTime = 0;
+		for (var i = 0; i < times.length; i++) {
+			var events = notePlacement[times[i]];
+			if (times[i] > lastTime) {
+				var distance = (times[i] - lastTime) * baseDuration;
+				midi.addRest(distance);
+				lastTime = times[i];
+			}
+			for (var j = 0; j < events.length; j++) {
+				var event = events[j];
+				if (event.volume) {
+					midi.startNote(event.pitch, event.volume, event.cents);
+				} else {
+					midi.endNote(event.pitch);
+				}
+			}
+		}
 	}
+
 })();
 
 module.exports = create;

package/src/parse/abc_common.js

@@ -1,18 +1,4 @@
 //    abc_parse.js: parses a string representing ABC Music Notation into a usable internal structure.
-//    Copyright (C) 2010-2020 Paul Rosen (paul at paulrosen dot net)
-//
-//    Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
-//    documentation files (the "Software"), to deal in the Software without restriction, including without limitation
-//    the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and
-//    to permit persons to whom the Software is furnished to do so, subject to the following conditions:
-//
-//    The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
-//
-//    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING
-//    BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
-//    NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
-//    DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-//    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
 var parseCommon = {};