@kongyo2/kongyoroid 1.0.0 → 2.0.0

package/dist/song/mml.js

@@ -0,0 +1,184 @@
+import { invalid } from "../errors.js";
+const NOTE_OFFSETS = { c: 0, d: 2, e: 4, f: 5, g: 7, a: 9, b: 11 };
+function lengthToBeats(length, dots, path, offset) {
+    if (length <= 0 || length > 256)
+        invalid(`${path}[${offset}]`, `Invalid note length ${length}; use 1–256 (4 = quarter note).`);
+    let beats = 4 / length;
+    let extra = beats / 2;
+    for (let dot = 0; dot < dots; dot++) {
+        beats += extra;
+        extra /= 2;
+    }
+    return beats;
+}
+export function parseMml(text, path = "$.mml") {
+    const chars = Array.from(text.normalize("NFKC"));
+    const notes = [];
+    let tempo;
+    let octave = 4;
+    let defaultLength = 4;
+    let velocity;
+    let index = 0;
+    let pendingTie = false;
+    let pendingLyric;
+    const readNumber = () => {
+        let digits = "";
+        while (index < chars.length && /^[0-9]$/u.test(chars[index] ?? "")) {
+            digits += chars[index];
+            index += 1;
+        }
+        return digits.length === 0 ? undefined : Number(digits);
+    };
+    const readDots = () => {
+        let dots = 0;
+        while (chars[index] === ".") {
+            dots += 1;
+            index += 1;
+        }
+        return dots;
+    };
+    while (index < chars.length) {
+        const char = chars[index] ?? "";
+        const lower = char.toLowerCase();
+        const start = index;
+        if (/\s/u.test(char) || char === "|" || char === ",") {
+            index += 1;
+            continue;
+        }
+        if (char === "[") {
+            const close = chars.indexOf("]", index);
+            if (close < 0)
+                invalid(`${path}[${index}]`, "Unclosed [ in MML lyric.");
+            pendingLyric = chars.slice(index + 1, close).join("");
+            index = close + 1;
+            continue;
+        }
+        if (lower === "t") {
+            index += 1;
+            const value = readNumber();
+            if (value === undefined || value < 20 || value > 400)
+                invalid(`${path}[${start}]`, "t must be followed by a tempo in 20–400.");
+            tempo = value;
+            continue;
+        }
+        if (lower === "o") {
+            index += 1;
+            const value = readNumber();
+            if (value === undefined || value > 9)
+                invalid(`${path}[${start}]`, "o must be followed by an octave 0–9.");
+            octave = value;
+            continue;
+        }
+        if (char === "<") {
+            octave -= 1;
+            index += 1;
+            continue;
+        }
+        if (char === ">") {
+            octave += 1;
+            index += 1;
+            continue;
+        }
+        if (lower === "l") {
+            index += 1;
+            const value = readNumber();
+            if (value === undefined || value <= 0 || value > 256)
+                invalid(`${path}[${start}]`, "l must be followed by a length 1–256.");
+            defaultLength = value;
+            continue;
+        }
+        if (lower === "v") {
+            index += 1;
+            const value = readNumber();
+            if (value === undefined || value > 127)
+                invalid(`${path}[${start}]`, "v must be followed by a velocity 0–15 (or 16–127).");
+            velocity = value <= 15 ? Math.max(1, Math.round((value / 15) * 127)) : value;
+            continue;
+        }
+        if (lower === "q") {
+            index += 1;
+            readNumber();
+            continue;
+        }
+        if (char === "&" || char === "^") {
+            pendingTie = true;
+            index += 1;
+            continue;
+        }
+        if (lower === "r" || lower === "p") {
+            if (pendingTie)
+                invalid(`${path}[${start}]`, "& must join two pitched notes; a rest cannot be tied.");
+            index += 1;
+            const length = readNumber() ?? defaultLength;
+            const dots = readDots();
+            notes.push({
+                key: null,
+                beats: lengthToBeats(length, dots, path, start),
+                continuation: "none",
+                velocity: undefined,
+                lyric: undefined,
+                offset: start,
+            });
+            pendingTie = false;
+            continue;
+        }
+        if (lower === "n") {
+            index += 1;
+            const value = readNumber();
+            if (value === undefined || value > 127)
+                invalid(`${path}[${start}]`, "n must be followed by a MIDI note number 0–127.");
+            const dots = readDots();
+            notes.push({
+                key: value,
+                beats: lengthToBeats(defaultLength, dots, path, start),
+                continuation: pendingTie ? (notes.at(-1)?.key === value ? "tie" : "melisma") : "none",
+                velocity,
+                lyric: pendingTie ? undefined : pendingLyric,
+                offset: start,
+            });
+            pendingTie = false;
+            pendingLyric = undefined;
+            continue;
+        }
+        const base = NOTE_OFFSETS[lower];
+        if (base !== undefined) {
+            index += 1;
+            let shift = 0;
+            while (chars[index] === "+" || chars[index] === "#" || chars[index] === "-") {
+                shift += chars[index] === "-" ? -1 : 1;
+                index += 1;
+            }
+            const length = readNumber() ?? defaultLength;
+            const dots = readDots();
+            const key = (octave + 1) * 12 + base + shift;
+            if (key < 0 || key > 127)
+                invalid(`${path}[${start}]`, `Note ${char} in octave ${octave} is outside the MIDI range.`);
+            const previous = notes.at(-1);
+            const continuation = pendingTie && previous !== undefined && previous.key !== null
+                ? previous.key === key
+                    ? "tie"
+                    : "melisma"
+                : "none";
+            if (pendingTie && (previous === undefined || previous.key === null))
+                invalid(`${path}[${start}]`, "& must join two pitched notes.");
+            notes.push({
+                key,
+                beats: lengthToBeats(length, dots, path, start),
+                continuation,
+                velocity,
+                lyric: continuation === "none" ? pendingLyric : undefined,
+                offset: start,
+            });
+            pendingTie = false;
+            pendingLyric = undefined;
+            continue;
+        }
+        invalid(`${path}[${start}]`, `Unexpected character ${JSON.stringify(char)} in MML.`, {
+            hint: "Supported: t120 (tempo), o4 (octave), < > (octave shift), l8 (default length), v12 (velocity), c d e f g a b with + - #, lengths 1–64 and dots, r (rest), & (tie/melisma), n60 (MIDI), [きゃ] (inline lyric).",
+        });
+    }
+    if (pendingTie)
+        invalid(`${path}[${chars.length}]`, "MML ends with a dangling &.");
+    return { tempo, notes };
+}
+//# sourceMappingURL=mml.js.map

package/dist/song/mml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mml.js","sourceRoot":"","sources":["../../src/song/mml.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAiBvC,MAAM,YAAY,GAAqC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;AAErG,SAAS,aAAa,CAAC,MAAc,EAAE,IAAY,EAAE,IAAY,EAAE,MAAc;IAC/E,IAAI,MAAM,IAAI,CAAC,IAAI,MAAM,GAAG,GAAG;QAC7B,OAAO,CAAC,GAAG,IAAI,IAAI,MAAM,GAAG,EAAE,uBAAuB,MAAM,iCAAiC,CAAC,CAAC;IAChG,IAAI,KAAK,GAAG,CAAC,GAAG,MAAM,CAAC;IACvB,IAAI,KAAK,GAAG,KAAK,GAAG,CAAC,CAAC;IACtB,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC;QACpC,KAAK,IAAI,KAAK,CAAC;QACf,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,OAAe,OAAO;IAC3D,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IACjD,MAAM,KAAK,GAAc,EAAE,CAAC;IAC5B,IAAI,KAAyB,CAAC;IAC9B,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,QAA4B,CAAC;IACjC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,IAAI,YAAgC,CAAC;IACrC,MAAM,UAAU,GAAG,GAAuB,EAAE;QAC1C,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,OAAO,KAAK,GAAG,KAAK,CAAC,MAAM,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YACnE,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;YACvB,KAAK,IAAI,CAAC,CAAC;QACb,CAAC;QACD,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1D,CAAC,CAAC;IACF,MAAM,QAAQ,GAAG,GAAW,EAAE;QAC5B,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC;YAC5B,IAAI,IAAI,CAAC,CAAC;YACV,KAAK,IAAI,CAAC,CAAC;QACb,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IACF,OAAO,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,KAAK,CAAC;QACpB,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACrD,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QACD,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACxC,IAAI,KAAK,GAAG,CAAC;gBAAE,OAAO,CAAC,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,0BAA0B,CAAC,CAAC;YACxE,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACtD,KAAK,GAAG,KAAK,GAAG,CAAC,CAAC;YAClB,SAAS;QACX,CAAC;QACD,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;YAClB,KAAK,IAAI,CAAC,CAAC;YACX,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;YAC3B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,GAAG,EAAE,IAAI,KAAK,GAAG,GAAG;gBAClD,OAAO,CAAC,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,0CAA0C,CAAC,CAAC;YAC3E,KAAK,GAAG,KAAK,CAAC;YACd,SAAS;QACX,CAAC;QACD,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;YAClB,KAAK,IAAI,CAAC,CAAC;YACX,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;YAC3B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,GAAG,CAAC;gBAAE,OAAO,CAAC,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,sCAAsC,CAAC,CAAC;YAC3G,MAAM,GAAG,KAAK,CAAC;YACf,SAAS;QACX,CAAC;QACD,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,MAAM,IAAI,CAAC,CAAC;YACZ,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QACD,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,MAAM,IAAI,CAAC,CAAC;YACZ,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QACD,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;YAClB,KAAK,IAAI,CAAC,CAAC;YACX,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;YAC3B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,GAAG,GAAG;gBAClD,OAAO,CAAC,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,uCAAuC,CAAC,CAAC;YACxE,aAAa,GAAG,KAAK,CAAC;YACtB,SAAS;QACX,CAAC;QACD,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;YAClB,KAAK,IAAI,CAAC,CAAC;YACX,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;YAC3B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,GAAG,GAAG;gBACpC,OAAO,CAAC,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,oDAAoD,CAAC,CAAC;YACrF,QAAQ,GAAG,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;YAC7E,SAAS;QACX,CAAC;QACD,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;YAClB,KAAK,IAAI,CAAC,CAAC;YACX,UAAU,EAAE,CAAC;YACb,SAAS;QACX,CAAC;QACD,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjC,UAAU,GAAG,IAAI,CAAC;YAClB,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QACD,IAAI,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;YACnC,IAAI,UAAU;gBAAE,OAAO,CAAC,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,uDAAuD,CAAC,CAAC;YACtG,KAAK,IAAI,CAAC,CAAC;YACX,MAAM,MAAM,GAAG,UAAU,EAAE,IAAI,aAAa,CAAC;YAC7C,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC;gBACT,GAAG,EAAE,IAAI;gBACT,KAAK,EAAE,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC;gBAC/C,YAAY,EAAE,MAAM;gBACpB,QAAQ,EAAE,SAAS;gBACnB,KAAK,EAAE,SAAS;gBAChB,MAAM,EAAE,KAAK;aACd,CAAC,CAAC;YACH,UAAU,GAAG,KAAK,CAAC;YACnB,SAAS;QACX,CAAC;QACD,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;YAClB,KAAK,IAAI,CAAC,CAAC;YACX,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;YAC3B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,GAAG,GAAG;gBACpC,OAAO,CAAC,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,iDAAiD,CAAC,CAAC;YAClF,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC;gBACT,GAAG,EAAE,KAAK;gBACV,KAAK,EAAE,aAAa,CAAC,aAAa,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC;gBACtD,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM;gBACrF,QAAQ;gBACR,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY;gBAC5C,MAAM,EAAE,KAAK;aACd,CAAC,CAAC;YACH,UAAU,GAAG,KAAK,CAAC;YACnB,YAAY,GAAG,SAAS,CAAC;YACzB,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,KAAK,IAAI,CAAC,CAAC;YACX,IAAI,KAAK,GAAG,CAAC,CAAC;YACd,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC;gBAC5E,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACvC,KAAK,IAAI,CAAC,CAAC;YACb,CAAC;YACD,MAAM,MAAM,GAAG,UAAU,EAAE,IAAI,aAAa,CAAC;YAC7C,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAC;YACxB,MAAM,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,IAAI,GAAG,KAAK,CAAC;YAC7C,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,GAAG,GAAG;gBACtB,OAAO,CAAC,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,QAAQ,IAAI,cAAc,MAAM,6BAA6B,CAAC,CAAC;YAC9F,MAAM,QAAQ,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9B,MAAM,YAAY,GAChB,UAAU,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,GAAG,KAAK,IAAI;gBAC3D,CAAC,CAAC,QAAQ,CAAC,GAAG,KAAK,GAAG;oBACpB,CAAC,CAAC,KAAK;oBACP,CAAC,CAAC,SAAS;gBACb,CAAC,CAAC,MAAM,CAAC;YACb,IAAI,UAAU,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,GAAG,KAAK,IAAI,CAAC;gBACjE,OAAO,CAAC,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,gCAAgC,CAAC,CAAC;YACjE,KAAK,CAAC,IAAI,CAAC;gBACT,GAAG;gBACH,KAAK,EAAE,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC;gBAC/C,YAAY;gBACZ,QAAQ;gBACR,KAAK,EAAE,YAAY,KAAK,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS;gBACzD,MAAM,EAAE,KAAK;aACd,CAAC,CAAC;YACH,UAAU,GAAG,KAAK,CAAC;YACnB,YAAY,GAAG,SAAS,CAAC;YACzB,SAAS;QACX,CAAC;QACD,OAAO,CAAC,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,wBAAwB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE;YACnF,IAAI,EAAE,6MAA6M;SACpN,CAAC,CAAC;IACL,CAAC;IACD,IAAI,UAAU;QAAE,OAAO,CAAC,GAAG,IAAI,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE,6BAA6B,CAAC,CAAC;IACnF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC1B,CAAC"}

package/dist/song/pitch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pitch.d.ts","sourceRoot":"","sources":["../../src/song/pitch.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,KAAK,EAAE,MAAY,CAAC;AAMjC,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,GAAE,MAAgB,GAAG,MAAM,CA4BjF;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGnD;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7C"}

package/dist/{pitch.js → song/pitch.js}

@@ -1,4 +1,4 @@
-import { invalid } from "./errors.js";
+import { invalid } from "../errors.js";
 export const A4_HZ = 440;
 const SEMITONES = { C: 0, D: 2, E: 4, F: 5, G: 7, A: 9, B: 11 };
 const NAMES = ["C", "C#", "D", "D#", "E", "F", "F#", "G", "G#", "A", "A#", "B"];

package/dist/song/pitch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pitch.js","sourceRoot":"","sources":["../../src/song/pitch.ts"],"names":[],"mappings":"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"}

package/dist/song/score.d.ts

@@ -0,0 +1,92 @@
+import type { MoraPhonemes } from "../text/mora.ts";
+export declare const DEFAULT_FRAME_RATE: number;
+export declare const MAX_NOTES: number;
+export declare const MIN_BEATS: number;
+export declare const MAX_BEATS: number;
+export declare const MAX_LYRIC_MORAS: number;
+export type Continuation = "none" | "tie" | "melisma";
+export type NoteArticulation = "auto" | "legato" | "rearticulate";
+export interface NoteVibrato {
+    readonly depthCents?: number;
+    readonly rateHz?: number;
+    readonly delayMs?: number;
+    readonly fadeMs?: number;
+}
+export interface NoteInput {
+    readonly id?: string;
+    readonly key: number | string | null;
+    readonly beats: number;
+    readonly lyric?: string;
+    readonly continuation?: Continuation;
+    readonly continueFrom?: string;
+    readonly articulation?: NoteArticulation;
+    readonly velocity?: number;
+    readonly gainDb?: number;
+    readonly portamentoMs?: number;
+    readonly vibrato?: NoteVibrato | false;
+}
+export interface Note {
+    readonly id: string;
+    readonly index: number;
+    readonly key: number | null;
+    readonly beats: number;
+    readonly lyric: string;
+    readonly moras: readonly MoraPhonemes[];
+    readonly moraTexts: readonly string[];
+    readonly continuation: Continuation;
+    readonly articulation: NoteArticulation;
+    readonly velocity: number;
+    readonly gainDb: number;
+    readonly portamentoSeconds: number | undefined;
+    readonly vibrato: NoteVibrato | false | undefined;
+}
+export interface EngineNote {
+    readonly id: string;
+    readonly key: number | null;
+    readonly frame_length: number;
+    readonly lyric: string;
+}
+export interface EngineScore {
+    readonly notes: readonly EngineNote[];
+}
+export interface ScoreText {
+    readonly lyrics: string;
+    readonly melody: string;
+    readonly beats?: string | readonly number[];
+}
+export interface MmlScore {
+    readonly mml: string;
+    readonly lyrics?: string;
+}
+export declare const NOTE_KEYS: readonly string[];
+export interface LyricAlignment {
+    readonly moras: readonly string[];
+    readonly pitchedNotes: number;
+    readonly assigned: readonly {
+        readonly note: number;
+        readonly mora: number;
+        readonly text: string;
+    }[];
+    readonly leftoverMoras: readonly string[];
+    readonly unfilledNotes: readonly number[];
+}
+export declare function alignLyrics(lyrics: string, melody: readonly string[], path?: string): LyricAlignment;
+export declare function parseScoreText(input: ScoreText, path?: string): readonly NoteInput[];
+export declare function parseMmlScore(input: MmlScore, path?: string): {
+    readonly notes: readonly NoteInput[];
+    readonly tempo: number | undefined;
+};
+export declare function parseNoteInput(value: unknown, path: string): NoteInput;
+export declare function resolveNotes(input: readonly NoteInput[], path?: string, transpose?: number): readonly Note[];
+export interface ParsedNotes {
+    readonly notes: readonly NoteInput[];
+    readonly tempo: number | undefined;
+    readonly form: "list" | "compact" | "mml";
+}
+export declare function parseNotes(value: unknown, path?: string): ParsedNotes;
+export declare function scoreSeconds(notes: readonly Note[], tempo: number): number;
+export declare function notesToEngineScore(notes: readonly Note[], tempo: number, frameRate?: number, leadIn?: number, leadOut?: number): EngineScore;
+export declare function engineScoreFrames(score: EngineScore): number;
+export declare function transposeInput(value: unknown, path: string): number;
+export declare function parseBooleanFlag(value: unknown, path: string): boolean;
+//# sourceMappingURL=score.d.ts.map

package/dist/song/score.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"score.d.ts","sourceRoot":"","sources":["../../src/song/score.ts"],"names":[],"mappings":"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"}