@goplayerjuggler/abc-tools 1.0.2 → 1.0.4

package/src/math.js

@@ -3,88 +3,88 @@
 // ============================================================================
 
 class Fraction {
-  constructor(numerator, denominator = 1) {
-    if (denominator === 0) {
-      throw new Error("Denominator cannot be zero");
-    }
+	constructor(numerator, denominator = 1) {
+		if (denominator === 0) {
+			throw new Error("Denominator cannot be zero");
+		}
 
-    const g = gcd(Math.abs(numerator), Math.abs(denominator));
-    this.num = numerator / g;
-    this.den = denominator / g;
+		const g = gcd(Math.abs(numerator), Math.abs(denominator));
+		this.num = numerator / g;
+		this.den = denominator / g;
 
-    // Keep denominator positive
-    if (this.den < 0) {
-      this.num = -this.num;
-      this.den = -this.den;
-    }
-  }
+		// Keep denominator positive
+		if (this.den < 0) {
+			this.num = -this.num;
+			this.den = -this.den;
+		}
+	}
 
-  clone() {
-    return new Fraction(this.num, this.den);
-  }
+	clone() {
+		return new Fraction(this.num, this.den);
+	}
 
-  multiply(n) {
-    if (typeof n === "number") {
-      return new Fraction(this.num * n, this.den);
-    }
-    return new Fraction(this.num * n.num, this.den * n.den);
-  }
+	multiply(n) {
+		if (typeof n === "number") {
+			return new Fraction(this.num * n, this.den);
+		}
+		return new Fraction(this.num * n.num, this.den * n.den);
+	}
 
-  divide(n) {
-    if (typeof n === "number") {
-      return new Fraction(this.num, this.den * n);
-    }
-    return new Fraction(this.num * n.den, this.den * n.num);
-  }
+	divide(n) {
+		if (typeof n === "number") {
+			return new Fraction(this.num, this.den * n);
+		}
+		return new Fraction(this.num * n.den, this.den * n.num);
+	}
 
-  add(n) {
-    if (typeof n === "number") {
-      return new Fraction(this.num + n * this.den, this.den);
-    }
-    return new Fraction(this.num * n.den + n.num * this.den, this.den * n.den);
-  }
+	add(n) {
+		if (typeof n === "number") {
+			return new Fraction(this.num + n * this.den, this.den);
+		}
+		return new Fraction(this.num * n.den + n.num * this.den, this.den * n.den);
+	}
 
-  subtract(n) {
-    if (typeof n === "number") {
-      return new Fraction(this.num - n * this.den, this.den);
-    }
-    return new Fraction(this.num * n.den - n.num * this.den, this.den * n.den);
-  }
+	subtract(n) {
+		if (typeof n === "number") {
+			return new Fraction(this.num - n * this.den, this.den);
+		}
+		return new Fraction(this.num * n.den - n.num * this.den, this.den * n.den);
+	}
 
-  compare(other) {
-    // Returns -1 if this < other, 0 if equal, 1 if this > other
-    const diff = this.num * other.den - other.num * this.den;
-    return diff < 0 ? -1 : diff > 0 ? 1 : 0;
-  }
+	compare(other) {
+		// Returns -1 if this < other, 0 if equal, 1 if this > other
+		const diff = this.num * other.den - other.num * this.den;
+		return diff < 0 ? -1 : diff > 0 ? 1 : 0;
+	}
 
-  equals(other) {
-    return this.num === other.num && this.den === other.den;
-  }
+	equals(other) {
+		return this.num === other.num && this.den === other.den;
+	}
 
-  isGreaterThan(other) {
-    return this.compare(other) > 0;
-  }
+	isGreaterThan(other) {
+		return this.compare(other) > 0;
+	}
 
-  isLessThan(other) {
-    return this.compare(other) < 0;
-  }
+	isLessThan(other) {
+		return this.compare(other) < 0;
+	}
 
-  toString() {
-    return this.den === 1 ? `${this.num}` : `${this.num}/${this.den}`;
-  }
+	toString() {
+		return this.den === 1 ? `${this.num}` : `${this.num}/${this.den}`;
+	}
 }
 
 function gcd(a, b) {
-  return b === 0 ? a : gcd(b, a % b);
+	return b === 0 ? a : gcd(b, a % b);
 }
 
 // function lcm(a, b) {
 //   return Math.abs(a * b) / gcd(a, b);
 // }
 if (typeof module !== "undefined" && module.exports) {
-  module.exports = {
-    // lcm,
-    // gcd,
-    Fraction,
-  };
+	module.exports = {
+		// lcm,
+		// gcd,
+		Fraction,
+	};
 }

package/src/parse/barline-parser.js

@@ -0,0 +1,115 @@
+// ============================================================================
+// ABC BAR LINE PARSING
+// ============================================================================
+//
+// Handles classification of bar lines and repeat notation:
+// - Regular bars: |
+// - Double bars: ||
+// - Final bars: |]
+// - Repeat starts: |:, [|
+// - Repeat ends: :|, |]
+// - Double repeats: ::, :|:
+// - Repeat endings: |1, |2, etc.
+//
+// ============================================================================
+
+/**
+ * Classify bar line type
+ *
+ * @param {string} barLineStr - Bar line string from ABC notation
+ * @returns {object} - Classification with type, text, and properties
+ *
+ * Return object structure:
+ * {
+ *   type: string,           // 'regular', 'double', 'final', 'repeat-start', 'repeat-end', 'repeat-both', 'repeat-ending', 'other'
+ *   text: string,           // Original bar line string
+ *   isRepeat: boolean,      // Whether this bar line involves repeats
+ *   ending?: number         // For repeat-ending type, which ending (1-6)
+ * }
+ */
+function classifyBarLine(barLineStr) {
+	const trimmed = barLineStr.trim();
+
+	// Repeat endings
+	if (trimmed.match(/^\|[1-6]$/)) {
+		return {
+			type: "repeat-ending",
+			ending: parseInt(trimmed[1]),
+			text: barLineStr,
+			isRepeat: true,
+		};
+	}
+
+	// Start repeat
+	if (trimmed.match(/^\|:/) || trimmed.match(/^\[\|/)) {
+		return {
+			type: "repeat-start",
+			text: barLineStr,
+			isRepeat: true,
+		};
+	}
+
+	// End repeat
+	if (
+		trimmed.match(/^:\|/) ||
+		(trimmed.match(/^\|\]/) && !trimmed.match(/^\|\]$/))
+	) {
+		return {
+			type: "repeat-end",
+			text: barLineStr,
+			isRepeat: true,
+		};
+	}
+
+	// Double repeat
+	if (
+		trimmed.match(/^::/) ||
+		trimmed.match(/^:\|:/) ||
+		trimmed.match(/^::\|:?/) ||
+		trimmed.match(/^::\|\|:?/)
+	) {
+		return {
+			type: "repeat-both",
+			text: barLineStr,
+			isRepeat: true,
+		};
+	}
+
+	// Final bar
+	if (trimmed === "|]") {
+		return {
+			type: "final",
+			text: barLineStr,
+			isRepeat: false,
+		};
+	}
+
+	// Double bar
+	if (trimmed === "||") {
+		return {
+			type: "double",
+			text: barLineStr,
+			isRepeat: false,
+		};
+	}
+
+	// Regular bar
+	if (trimmed === "|") {
+		return {
+			type: "regular",
+			text: barLineStr,
+			isRepeat: false,
+		};
+	}
+
+	// Unknown/complex bar line
+	return {
+		type: "other",
+		text: barLineStr,
+		isRepeat: trimmed.includes(":"),
+	};
+}
+
+module.exports = {
+	classifyBarLine,
+};

package/src/parse/header-parser.js

@@ -0,0 +1,140 @@
+const { Fraction } = require("../math.js");
+
+// ============================================================================
+// ABC HEADER PARSING
+// ============================================================================
+//
+// Handles extraction of header fields from ABC notation:
+// - Key signature (K:)
+// - Meter/time signature (M:)
+// - Unit note length (L:)
+// - Line metadata (comments, continuations)
+//
+// ============================================================================
+
+/**
+ * Extract key signature from ABC header
+ *
+ * @param {string} abc - ABC notation string
+ * @returns {string} - Tonic note (e.g., 'C', 'D', 'G')
+ * @throws {Error} - If no key signature found
+ */
+function getTonalBase(abc) {
+	const keyMatch = abc.match(/^K:\s*([A-G])/m);
+	if (!keyMatch) {
+		throw new Error("No key signature found in ABC");
+	}
+	return keyMatch[1].toUpperCase();
+}
+
+/**
+ * Extract meter/time signature from ABC header
+ *
+ * @param {string} abc - ABC notation string
+ * @returns {[number, number]} - Meter as [numerator, denominator] (e.g., [3, 4] for 3/4 time)
+ */
+function getMeter(abc) {
+	const meterMatch = abc.match(/^M:\s*(\d+)\/(\d+)/m);
+	if (meterMatch) {
+		return [parseInt(meterMatch[1]), parseInt(meterMatch[2])];
+	}
+	return [4, 4]; // Default to 4/4
+}
+
+/**
+ * Extract unit note length as a Fraction object
+ *
+ * @param {string} abc - ABC notation string
+ * @returns {Fraction} - Unit length (e.g., 1/8, 1/4)
+ */
+function getUnitLength(abc) {
+	const lengthMatch = abc.match(/^L:\s*(\d+)\/(\d+)/m);
+	if (lengthMatch) {
+		return new Fraction(parseInt(lengthMatch[1]), parseInt(lengthMatch[2]));
+	}
+	return new Fraction(1, 8); // Default to 1/8
+}
+
+/**
+ * Process ABC lines: extract music lines with metadata
+ * Handles comments, line continuations, and separates headers from music
+ * Preserves newline positions for layout tracking
+ *
+ * @param {string} abc - ABC notation string
+ * @returns {object} - { musicText, lineMetadata, newlinePositions, headerLines, headerEndIndex }
+ */
+function getMusicLines(abc) {
+	const lines = abc.split("\n");
+	const musicLines = [];
+	const lineMetadata = [];
+	const newlinePositions = [];
+	const headerLines = [];
+	let headerEndIndex = 0;
+	let inHeaders = true;
+	let currentPos = 0;
+
+	for (let i = 0; i < lines.length; i++) {
+		const line = lines[i];
+		let trimmed = line.trim();
+
+		// Skip empty lines and comment-only lines
+		if (trimmed === "" || trimmed.startsWith("%")) {
+			if (inHeaders) {
+				headerEndIndex = i + 1;
+			}
+			continue;
+		}
+
+		// Check for header lines
+		if (inHeaders && trimmed.match(/^[A-Z]:/)) {
+			headerLines.push(line);
+			headerEndIndex = i + 1;
+			continue;
+		}
+		inHeaders = false;
+
+		// Extract inline comment if present
+		const commentMatch = trimmed.match(/\s*%(.*)$/);
+		const comment = commentMatch ? commentMatch[1].trim() : null;
+
+		// Check for line continuation
+		const hasContinuation = trimmed.match(/\\\s*(%|$)/) !== null;
+
+		// Remove inline comments and line continuation marker
+		trimmed = trimmed.replace(/\s*%.*$/, "").trim();
+		trimmed = trimmed.replace(/\\\s*$/, "").trim();
+
+		if (trimmed) {
+			musicLines.push(trimmed);
+			lineMetadata.push({
+				lineIndex: i,
+				originalLine: line,
+				content: trimmed,
+				comment,
+				hasContinuation,
+			});
+
+			// Track position where newline would be (unless continuation)
+			if (!hasContinuation && musicLines.length > 1) {
+				newlinePositions.push(currentPos);
+			}
+
+			currentPos += trimmed.length + 1; // +1 for the space we'll add when joining
+		}
+	}
+
+	return {
+		musicText: musicLines.join("\n"),
+		lineMetadata,
+		newlinePositions,
+		headerLines,
+		headerEndIndex,
+	};
+}
+
+module.exports = {
+	getTonalBase,
+	getMeter,
+	getUnitLength,
+	getMusicLines,
+};