@kongyo2/kongyoroid 1.0.0

package/dist/request.js

@@ -0,0 +1,115 @@
+import { invalid } from "./errors.js";
+import { DEFAULT_SAMPLE_RATE, LIMITS, SAMPLE_RATE_RANGE } from "./limits.js";
+import { formatKanaNotation, parseKanaNotation } from "./notation.js";
+import { SONG_PROPERTIES, SPEECH_PROPERTIES } from "./schema.js";
+import { MAX_NOTES, parseNotes, resolveNotes, scoreSeconds, transposeInput } from "./score.js";
+import { boolean, has, integer, keys, literal, number, object, optional, string } from "./validate.js";
+const ENGINES = ["voicevox", "formant", "auto"];
+export function parseEngine(value, path = "$.engine") {
+    return literal(value, path, ENGINES);
+}
+export function parseStyleRef(value, path) {
+    if (typeof value === "number")
+        return integer(value, path, 0, 4_294_967_295);
+    if (typeof value === "string") {
+        const name = value.trim();
+        if (name.length === 0 || name.length > 200)
+            invalid(path, "Expected a style id or a non-empty style name.");
+        return /^\d+$/u.test(name) ? Number(name) : name;
+    }
+    return invalid(path, "Expected a style id (integer) or a style name (string).");
+}
+function parseSampleRate(value, path) {
+    return integer(value, path, SAMPLE_RATE_RANGE.min, SAMPLE_RATE_RANGE.max);
+}
+function parseSeed(value, path) {
+    return integer(value, path, 1, 4_294_967_295);
+}
+function parseCommon(o) {
+    const implied = has(o, "speaker") || has(o, "singer") || has(o, "teacher") ? "voicevox" : "formant";
+    return {
+        engine: optional(o, "engine", "$", implied, parseEngine),
+        sampleRate: has(o, "sampleRate") ? parseSampleRate(o["sampleRate"], "$.sampleRate") : undefined,
+        volume: optional(o, "volume", "$", 1, (v, p) => number(v, p, 0, 3)),
+        seed: optional(o, "seed", "$", 1, parseSeed),
+    };
+}
+export function parseSpeechRequest(o) {
+    keys(o, Object.keys(SPEECH_PROPERTIES), "$");
+    const text = string(o["text"], "$.text", 1, LIMITS.textChars);
+    if (text.trim().length === 0)
+        invalid("$.text", "Text must not be blank.");
+    const kana = has(o, "kana")
+        ? formatKanaNotation(parseKanaNotation(string(o["kana"], "$.kana", 1, LIMITS.kanaChars), "$.kana"))
+        : undefined;
+    return {
+        kind: "speech",
+        ...parseCommon(o),
+        text,
+        kana,
+        speaker: has(o, "speaker") ? parseStyleRef(o["speaker"], "$.speaker") : undefined,
+        speed: optional(o, "speed", "$", 1, (v, p) => number(v, p, 0.25, 4)),
+        pitch: optional(o, "pitch", "$", 0, (v, p) => number(v, p, -1, 1)),
+        intonation: optional(o, "intonation", "$", 1, (v, p) => number(v, p, 0, 3)),
+        prePause: optional(o, "prePause", "$", 0.1, (v, p) => number(v, p, 0, 10)),
+        postPause: optional(o, "postPause", "$", 0.1, (v, p) => number(v, p, 0, 10)),
+        pauseLength: has(o, "pauseLength") ? number(o["pauseLength"], "$.pauseLength", 0, 10) : undefined,
+        pauseScale: optional(o, "pauseScale", "$", 1, (v, p) => number(v, p, 0, 10)),
+        upspeak: optional(o, "upspeak", "$", true, boolean),
+        split: optional(o, "split", "$", "sentence", (v, p) => literal(v, p, ["sentence", "paragraph", "none"])),
+    };
+}
+export function parseSongRequest(o) {
+    keys(o, Object.keys(SONG_PROPERTIES), "$");
+    const tempo = optional(o, "tempo", "$", 120, (v, p) => number(v, p, 20, 400));
+    const transpose = optional(o, "transpose", "$", 0, transposeInput);
+    const inputNotes = parseNotes(o["notes"], "$.notes");
+    if (inputNotes.length > MAX_NOTES)
+        invalid("$.notes", `A score is limited to ${MAX_NOTES} notes.`);
+    const notes = resolveNotes(inputNotes, "$.notes", transpose);
+    const leadIn = optional(o, "leadIn", "$", 0.16, (v, p) => number(v, p, 0, 5));
+    const leadOut = optional(o, "leadOut", "$", 0.16, (v, p) => number(v, p, 0, 5));
+    const seconds = scoreSeconds(notes, tempo) + leadIn + leadOut;
+    if (seconds > LIMITS.audioSeconds) {
+        invalid("$.notes", `The score lasts ${seconds.toFixed(1)} s; the limit is ${LIMITS.audioSeconds} s.`);
+    }
+    return {
+        kind: "song",
+        ...parseCommon(o),
+        notes,
+        tempo,
+        singer: has(o, "singer") ? parseStyleRef(o["singer"], "$.singer") : undefined,
+        teacher: has(o, "teacher") ? parseStyleRef(o["teacher"], "$.teacher") : undefined,
+        transpose,
+        vibratoDepth: has(o, "vibratoDepth") ? number(o["vibratoDepth"], "$.vibratoDepth", 0, 200) : undefined,
+        vibratoRate: optional(o, "vibratoRate", "$", 5.5, (v, p) => number(v, p, 0, 12)),
+        leadIn,
+        leadOut,
+    };
+}
+export function parseRequest(value) {
+    const o = object(value, "$");
+    const kind = literal(o["kind"], "$.kind", ["speech", "song"]);
+    return kind === "speech" ? parseSpeechRequest(o) : parseSongRequest(o);
+}
+export function speechRequest(input) {
+    return { kind: "speech", ...input };
+}
+export function songRequest(input) {
+    return { kind: "song", ...input };
+}
+export function parseJson(text, path = "$") {
+    if (Buffer.byteLength(text, "utf8") > LIMITS.inputBytes) {
+        invalid(path, `Input exceeds ${LIMITS.inputBytes} bytes.`);
+    }
+    try {
+        return JSON.parse(text);
+    }
+    catch (error) {
+        return invalid(path, `Invalid JSON: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+export function effectiveSampleRate(request, engineDefault = DEFAULT_SAMPLE_RATE) {
+    return request.sampleRate ?? engineDefault;
+}
+//# sourceMappingURL=request.js.map

package/dist/request.js.map

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

package/dist/schema.d.ts

@@ -0,0 +1,9 @@
+export type JsonSchema = Readonly<Record<string, unknown>>;
+export declare const SPEECH_PROPERTIES: JsonSchema;
+export declare const NOTE_SCHEMA: JsonSchema;
+export declare const SCORE_TEXT_SCHEMA: JsonSchema;
+export declare const SONG_PROPERTIES: JsonSchema;
+export declare const REQUEST_SCHEMA: JsonSchema;
+export declare const BATCH_JOB_SCHEMA: JsonSchema;
+export declare const CAPABILITIES: JsonSchema;
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAkC3D,eAAO,MAAM,iBAAiB,EAAE,UA8C/B,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,UA8BzB,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,UA0B/B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,UAgC7B,CAAC;AAmBF,eAAO,MAAM,cAAc,EAAE,UAK5B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,UAa9B,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,UAsE1B,CAAC"}

package/dist/schema.js

@@ -0,0 +1,267 @@
+import { EXIT_CODES } from "./errors.js";
+import { LIMITS, SAMPLE_RATE_RANGE } from "./limits.js";
+import { MAX_BEATS, MAX_NOTES, MIN_BEATS } from "./score.js";
+import { PACKAGE_NAME, VERSION } from "./version.js";
+const styleRef = {
+    anyOf: [
+        { type: "integer", minimum: 0, maximum: 4_294_967_295 },
+        { type: "string", minLength: 1, maxLength: 200 },
+    ],
+    description: 'A VOICEVOX style id from the voices command, or a name: "ずんだもん" (first matching style) or "ずんだもん/ノーマル" (exact style).',
+};
+const common = {
+    engine: {
+        enum: ["formant", "voicevox", "auto"],
+        default: "formant",
+        description: "formant is the built-in engine: kana text or kana notation, deterministic, no external service. voicevox drives a running VOICEVOX ENGINE (character voices, kanji text, user dictionary) and is selected automatically when speaker, singer, or teacher is given. auto uses voicevox when the endpoint answers, otherwise formant.",
+    },
+    sampleRate: {
+        type: "integer",
+        minimum: SAMPLE_RATE_RANGE.min,
+        maximum: SAMPLE_RATE_RANGE.max,
+        description: "Output sample rate in Hz. Defaults to the engine default (24000).",
+    },
+    volume: { type: "number", minimum: 0, maximum: 3, default: 1, description: "Linear output gain." },
+    seed: {
+        type: "integer",
+        minimum: 1,
+        maximum: 4_294_967_295,
+        default: 1,
+        description: "Noise seed for the formant engine; ignored by voicevox.",
+    },
+};
+export const SPEECH_PROPERTIES = {
+    kind: { const: "speech" },
+    ...common,
+    text: {
+        type: "string",
+        minLength: 1,
+        maxLength: LIMITS.textChars,
+        description: "Text to read. voicevox accepts ordinary Japanese including kanji; formant accepts kana only.",
+    },
+    kana: {
+        type: "string",
+        minLength: 1,
+        maxLength: LIMITS.kanaChars,
+        description: "Optional reading in AquesTalk-style notation, e.g. コンニチワ'/セカ'イ？ (katakana, / between accent phrases, 、 for a pause, ' after the accent nucleus, _ before a devoiced vowel, ？ for a question). When given, it replaces the engine's own reading of text and disables splitting.",
+    },
+    speaker: styleRef,
+    speed: { type: "number", minimum: 0.25, maximum: 4, default: 1, description: "Speaking rate multiplier." },
+    pitch: {
+        type: "number",
+        minimum: -1,
+        maximum: 1,
+        default: 0,
+        description: "VOICEVOX pitchScale semantics; the practical range is about -0.15 to 0.15.",
+    },
+    intonation: { type: "number", minimum: 0, maximum: 3, default: 1, description: "Pitch-range multiplier." },
+    prePause: { type: "number", minimum: 0, maximum: 10, default: 0.1, description: "Leading silence in seconds." },
+    postPause: { type: "number", minimum: 0, maximum: 10, default: 0.1, description: "Trailing silence in seconds." },
+    pauseLength: {
+        type: "number",
+        minimum: 0,
+        maximum: 10,
+        description: "Absolute punctuation pause in seconds. Omit to keep the engine's own pause lengths.",
+    },
+    pauseScale: { type: "number", minimum: 0, maximum: 10, default: 1, description: "Punctuation pause multiplier." },
+    upspeak: {
+        type: "boolean",
+        default: true,
+        description: "Raise the final mora of interrogative phrases (VOICEVOX enable_interrogative_upspeak).",
+    },
+    split: {
+        enum: ["sentence", "paragraph", "none"],
+        default: "sentence",
+        description: "How long text is chunked before synthesis. Chunks are synthesized concurrently and concatenated in order.",
+    },
+};
+export const NOTE_SCHEMA = {
+    type: "object",
+    additionalProperties: false,
+    required: ["key", "beats"],
+    properties: {
+        key: {
+            anyOf: [
+                { type: "integer", minimum: 0, maximum: 127 },
+                { type: "string", pattern: "^[A-Ga-g](#|♯|b|♭|x)?-?[0-9]$" },
+                { type: "null" },
+            ],
+            description: "MIDI key (60 = C4), a note name such as C4 or F#3, or null for a rest.",
+        },
+        beats: {
+            type: "number",
+            minimum: MIN_BEATS,
+            maximum: MAX_BEATS,
+            description: "Duration in quarter-note beats at the score tempo.",
+        },
+        lyric: {
+            type: "string",
+            maxLength: 8,
+            default: "",
+            description: 'Exactly one kana mora for a pitched note (ア, キャ, ン, ...), "ー" to hold the previous vowel, empty for a rest.',
+        },
+    },
+    if: { properties: { key: { type: "null" } } },
+    then: { properties: { lyric: { const: "" } } },
+    else: { properties: { lyric: { type: "string", minLength: 1 } } },
+};
+export const SCORE_TEXT_SCHEMA = {
+    type: "object",
+    additionalProperties: false,
+    required: ["lyrics", "melody"],
+    properties: {
+        lyrics: {
+            type: "string",
+            maxLength: LIMITS.textChars,
+            description: "Kana lyrics; one mora is consumed per pitched melody note. ー holds the previous vowel.",
+        },
+        melody: {
+            type: "string",
+            minLength: 1,
+            maxLength: LIMITS.textChars,
+            description: 'Whitespace-separated notes: note names (C4, F#4, Bb3), MIDI integers, R for a rest, ~ for a tie. Example: "C4 D4 E4 R ~".',
+        },
+        beats: {
+            anyOf: [
+                { type: "string" },
+                { type: "array", items: { type: "number", minimum: MIN_BEATS, maximum: MAX_BEATS }, minItems: 1 },
+            ],
+            description: 'Beat lengths per melody token ("1 1 2 0.5 1/2"). One value applies to every note; omitted means 1 beat each.',
+        },
+    },
+};
+export const SONG_PROPERTIES = {
+    kind: { const: "song" },
+    ...common,
+    notes: {
+        anyOf: [
+            { type: "array", minItems: 1, maxItems: MAX_NOTES, items: { $ref: "#/$defs/note" } },
+            { $ref: "#/$defs/scoreText" },
+        ],
+        description: "Either an explicit note list or a compact lyrics/melody/beats score.",
+    },
+    tempo: { type: "number", minimum: 20, maximum: 400, default: 120, description: "Beats per minute." },
+    singer: {
+        ...styleRef,
+        description: "VOICEVOX style that renders the voice (type frame_decode or sing). Defaults to the first singing style the engine offers.",
+    },
+    teacher: {
+        ...styleRef,
+        description: "VOICEVOX style that predicts timing and pitch (type singing_teacher or sing). Defaults to the singer when it can teach, otherwise to the first teacher.",
+    },
+    transpose: { type: "integer", minimum: -48, maximum: 48, default: 0, description: "Semitones added to every key." },
+    vibratoDepth: {
+        type: "number",
+        minimum: 0,
+        maximum: 200,
+        description: "Vibrato depth in cents. voicevox defaults to 0 (the engine's own expression); formant defaults to 25.",
+    },
+    vibratoRate: { type: "number", minimum: 0, maximum: 12, default: 5.5, description: "Vibrato rate in Hz." },
+    leadIn: { type: "number", minimum: 0, maximum: 5, default: 0.16, description: "Rest added before the first note." },
+    leadOut: { type: "number", minimum: 0, maximum: 5, default: 0.16, description: "Rest added after the last note." },
+};
+function variant(kind, properties, required) {
+    return {
+        type: "object",
+        title: kind === "speech" ? "SpeechRequest" : "SongRequest",
+        additionalProperties: false,
+        required: ["kind", ...required],
+        properties,
+    };
+}
+const REQUEST_BODY = {
+    title: "kongyoroid RenderRequest",
+    description: "One speech (読み上げ) or song (歌唱) render. Unknown properties are rejected. Output is a mono PCM16 WAV.",
+    oneOf: [variant("speech", SPEECH_PROPERTIES, ["text"]), variant("song", SONG_PROPERTIES, ["notes"])],
+};
+export const REQUEST_SCHEMA = {
+    $schema: "http://json-schema.org/draft-07/schema#",
+    $id: "https://github.com/kongyo2/kongyoroid/schema/render-request.json",
+    ...REQUEST_BODY,
+    $defs: { note: NOTE_SCHEMA, scoreText: SCORE_TEXT_SCHEMA },
+};
+export const BATCH_JOB_SCHEMA = {
+    $schema: "http://json-schema.org/draft-07/schema#",
+    $id: "https://github.com/kongyo2/kongyoroid/schema/batch-job.json",
+    title: "kongyoroid BatchJob",
+    description: "One JSONL line for the batch command. The request schema is embedded under $defs.request.",
+    type: "object",
+    additionalProperties: false,
+    required: ["id", "request"],
+    properties: {
+        id: { type: "string", pattern: "^[A-Za-z0-9_-]{1,64}$", description: "Output file name stem, unique per batch." },
+        request: { $ref: "#/$defs/request" },
+    },
+    $defs: { request: REQUEST_BODY, note: NOTE_SCHEMA, scoreText: SCORE_TEXT_SCHEMA },
+};
+export const CAPABILITIES = {
+    name: PACKAGE_NAME,
+    version: VERSION,
+    description: "Japanese speech and singing synthesis for LLM agents.",
+    output: { container: "wav", encoding: "pcm16", channels: 1, sampleRate: { default: 24000, ...SAMPLE_RATE_RANGE } },
+    defaultEngine: "formant",
+    engines: {
+        formant: {
+            external: false,
+            speech: "Kana text or kana notation (accent phrases, pauses, devoicing, questions); deterministic for a request and seed.",
+            song: "Score of one-mora notes with ties and rests; deterministic.",
+            maxSeconds: LIMITS.formantSeconds,
+        },
+        voicevox: {
+            external: true,
+            endpoint: { default: "http://127.0.0.1:50021", env: ["KONGYOROID_ENDPOINT", "VOICEVOX_URL"] },
+            speech: "Japanese text with kanji; readings adjustable via kana notation and the user dictionary.",
+            song: "Score of one-mora notes rendered by a singing style; timing and pitch predicted by a teacher style.",
+            styles: "Discover with the voices command; select by id or by name. Giving a style selects this engine.",
+        },
+    },
+    commands: [
+        "speak",
+        "sing",
+        "render",
+        "batch",
+        "reading",
+        "voices",
+        "doctor",
+        "dict",
+        "play",
+        "schema",
+        "capabilities",
+    ],
+    env: {
+        KONGYOROID_ENDPOINT: "VOICEVOX ENGINE base URL.",
+        VOICEVOX_URL: "Alias of KONGYOROID_ENDPOINT.",
+        KONGYOROID_ENGINE: "Default engine: voicevox, formant, or auto.",
+        KONGYOROID_SPEAKER: "Default speech style (id or name).",
+        KONGYOROID_SINGER: "Default singing style (id or name).",
+        KONGYOROID_TEACHER: "Default singing teacher style (id or name).",
+        KONGYOROID_CACHE_DIR: "Directory for the on-disk render cache.",
+    },
+    limits: {
+        textChars: LIMITS.textChars,
+        notes: LIMITS.notes,
+        audioSeconds: LIMITS.audioSeconds,
+        formantSeconds: LIMITS.formantSeconds,
+        inputBytes: LIMITS.inputBytes,
+        batchLines: LIMITS.batchLines,
+        concurrency: LIMITS.concurrency,
+    },
+    exitCodes: EXIT_CODES,
+    errorCodes: [
+        "INVALID_INPUT",
+        "UNSUPPORTED_TEXT",
+        "ENGINE_UNAVAILABLE",
+        "ENGINE_HTTP",
+        "ENGINE_REJECTED",
+        "ENGINE_PROTOCOL",
+        "TIMEOUT",
+        "ABORTED",
+        "QUEUE_FULL",
+        "IO_ERROR",
+        "PLAYER_UNAVAILABLE",
+        "INTERNAL",
+    ],
+    stdout: "One JSON object per line. With --output - the WAV bytes go to stdout and the JSON goes to stderr.",
+    stderr: "Errors as one JSON object: { ok: false, error: { code, message, path?, hint?, retryable } }.",
+};
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

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

package/dist/score.d.ts

@@ -0,0 +1,37 @@
+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 interface NoteInput {
+    readonly key: number | string | null;
+    readonly beats: number;
+    readonly lyric: string;
+}
+export interface Note {
+    readonly key: number | null;
+    readonly beats: number;
+    readonly lyric: string;
+}
+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 declare function parseScoreText(input: ScoreText, path?: string): readonly NoteInput[];
+export declare function parseNoteInput(value: unknown, path: string): NoteInput;
+export declare function resolveNotes(input: readonly NoteInput[], path?: string, transpose?: number): readonly Note[];
+export declare function parseNotes(value: unknown, path?: string): readonly NoteInput[];
+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;
+//# sourceMappingURL=score.d.ts.map

package/dist/score.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"score.d.ts","sourceRoot":"","sources":["../src/score.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,kBAAkB,EAAE,MAAc,CAAC;AAChD,eAAO,MAAM,SAAS,EAAE,MAAa,CAAC;AACtC,eAAO,MAAM,SAAS,EAAE,MAAe,CAAC;AACxC,eAAO,MAAM,SAAS,EAAE,MAAW,CAAC;AAEpC,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;CAC7C;AAkBD,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,GAAE,MAAY,GAAG,SAAS,SAAS,EAAE,CAgDzF;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,CAUtE;AAED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,SAAS,SAAS,EAAE,EAC3B,IAAI,GAAE,MAAkB,EACxB,SAAS,GAAE,MAAU,GACpB,SAAS,IAAI,EAAE,CAkCjB;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,GAAE,MAAkB,GAAG,SAAS,SAAS,EAAE,CAwBzF;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAI1E;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,SAAS,IAAI,EAAE,EACtB,KAAK,EAAE,MAAM,EACb,SAAS,GAAE,MAA2B,EACtC,MAAM,GAAE,MAAa,EACrB,OAAO,GAAE,MAAa,GACrB,WAAW,CAsBb;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAI5D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnE"}

package/dist/score.js

@@ -0,0 +1,166 @@
+import { invalid } from "./errors.js";
+import { kanaToUnits, lookupMora, toKatakana, vowelToKana } from "./mora.js";
+import { noteToMidi } from "./pitch.js";
+import { array, has, integer, isObject, keys, number, object, string } from "./validate.js";
+export const DEFAULT_FRAME_RATE = 93.75;
+export const MAX_NOTES = 4096;
+export const MIN_BEATS = 1 / 64;
+export const MAX_BEATS = 64;
+const REST_TOKENS = new Set(["r", "rest", "_"]);
+const TIE_TOKENS = new Set(["~", "-", "ー"]);
+function parseBeat(token, path) {
+    const fraction = /^(\d+(?:\.\d+)?)\/(\d+(?:\.\d+)?)$/u.exec(token);
+    const value = fraction === null ? Number(token) : Number(fraction[1]) / Number(fraction[2]);
+    return number(value, path, MIN_BEATS, MAX_BEATS);
+}
+function tokens(text) {
+    return text
+        .normalize("NFKC")
+        .split(/[\s,]+/u)
+        .filter((token) => token.length > 0);
+}
+export function parseScoreText(input, path = "$") {
+    const melody = tokens(string(input.melody, `${path}.melody`, 1, 100_000));
+    if (melody.length === 0)
+        invalid(`${path}.melody`, "The melody has no notes.");
+    if (melody.length > MAX_NOTES)
+        invalid(`${path}.melody`, `A score is limited to ${MAX_NOTES} notes.`);
+    const rawBeats = input.beats;
+    const beatTokens = rawBeats === undefined ? [] : typeof rawBeats === "string" ? tokens(rawBeats) : rawBeats.map((b) => String(b));
+    const beats = beatTokens.map((token, index) => parseBeat(token, `${path}.beats[${index}]`));
+    if (beats.length > 1 && beats.length !== melody.length) {
+        invalid(`${path}.beats`, `Expected ${melody.length} beat values to match the melody, got ${beats.length}.`);
+    }
+    const moras = kanaToUnits(string(input.lyrics, `${path}.lyrics`, 0, 100_000), `${path}.lyrics`).filter((unit) => unit.kind === "mora");
+    const notes = [];
+    let moraIndex = 0;
+    for (const [index, token] of melody.entries()) {
+        const beat = beats.length === 0 ? 1 : (beats[beats.length === 1 ? 0 : index] ?? 1);
+        const lower = token.toLowerCase();
+        if (REST_TOKENS.has(lower)) {
+            notes.push({ key: null, beats: beat, lyric: "" });
+            continue;
+        }
+        if (TIE_TOKENS.has(token)) {
+            const previous = notes.findLast((note) => note.key !== null);
+            if (previous === undefined)
+                invalid(`${path}.melody[${index}]`, "A tie needs a preceding pitched note.");
+            notes.push({ key: previous.key, beats: beat, lyric: "ー" });
+            continue;
+        }
+        const mora = moras[moraIndex];
+        if (mora === undefined) {
+            invalid(`${path}.lyrics`, `The melody has more pitched notes than the lyrics have moras (${moras.length} moras).`, "Give one kana mora per pitched note, or use R for rests and ~ for ties in the melody.");
+        }
+        moraIndex += 1;
+        notes.push({ key: noteToMidi(token, `${path}.melody[${index}]`), beats: beat, lyric: mora.text });
+    }
+    if (moraIndex < moras.length) {
+        invalid(`${path}.lyrics`, `The lyrics have ${moras.length - moraIndex} more moras than the melody has pitched notes.`, "Add notes to the melody or shorten the lyrics.");
+    }
+    return notes;
+}
+export function parseNoteInput(value, path) {
+    const note = object(value, path);
+    keys(note, ["key", "beats", "lyric"], path);
+    const key = note["key"];
+    if (key !== null && typeof key !== "number" && typeof key !== "string") {
+        invalid(`${path}.key`, "Expected a MIDI integer, a note name such as C4, or null for a rest.");
+    }
+    const beats = number(note["beats"], `${path}.beats`, MIN_BEATS, MAX_BEATS);
+    const lyric = has(note, "lyric") ? string(note["lyric"], `${path}.lyric`, 0, 8) : "";
+    return { key, beats, lyric };
+}
+export function resolveNotes(input, path = "$.notes", transpose = 0) {
+    const resolved = [];
+    for (const [index, note] of input.entries()) {
+        const notePath = `${path}[${index}]`;
+        const lyric = toKatakana(note.lyric).replaceAll(/\s+/gu, "");
+        if (note.key === null) {
+            if (lyric !== "")
+                invalid(`${notePath}.lyric`, "A rest (key null) must have an empty lyric.");
+            resolved.push({ key: null, beats: note.beats, lyric: "" });
+            continue;
+        }
+        const key = noteToMidi(note.key, `${notePath}.key`) + transpose;
+        if (key < 0 || key > 127)
+            invalid(`${notePath}.key`, `Transposed key ${key} is outside the MIDI range 0–127.`);
+        if (lyric.length === 0)
+            invalid(`${notePath}.lyric`, "A pitched note needs a one-mora lyric such as ア or キャ.");
+        if (TIE_TOKENS.has(lyric)) {
+            const previous = resolved.findLast((n) => n.key !== null);
+            if (previous === undefined)
+                invalid(`${notePath}.lyric`, "A tie needs a preceding pitched note.");
+            const phonemes = lookupMora(previous.lyric);
+            if (phonemes === undefined || phonemes.vowel === "cl" || phonemes.vowel === "pau") {
+                invalid(`${notePath}.lyric`, "A tie must follow a note with a voiced vowel.");
+            }
+            resolved.push({ key, beats: note.beats, lyric: vowelToKana(phonemes.vowel) });
+            continue;
+        }
+        const phonemes = lookupMora(lyric);
+        if (phonemes === undefined) {
+            invalid(`${notePath}.lyric`, `Lyric ${JSON.stringify(note.lyric)} is not a single kana mora.`, "VOICEVOX sings exactly one mora per note; split multi-mora lyrics across notes.");
+        }
+        resolved.push({ key, beats: note.beats, lyric });
+    }
+    return resolved;
+}
+export function parseNotes(value, path = "$.notes") {
+    if (isObject(value)) {
+        keys(value, ["lyrics", "melody", "beats"], path);
+        const beats = value["beats"];
+        if (beats !== undefined && typeof beats !== "string" && !Array.isArray(beats)) {
+            invalid(`${path}.beats`, "Expected a string of beat values or an array of numbers.");
+        }
+        return parseScoreText({
+            lyrics: string(value["lyrics"], `${path}.lyrics`, 0, 100_000),
+            melody: string(value["melody"], `${path}.melody`, 1, 100_000),
+            ...(beats === undefined
+                ? {}
+                : {
+                    beats: typeof beats === "string"
+                        ? beats
+                        : beats.map((b, i) => number(b, `${path}.beats[${i}]`, MIN_BEATS, MAX_BEATS)),
+                }),
+        }, path);
+    }
+    return array(value, path, 1, MAX_NOTES).map((note, index) => parseNoteInput(note, `${path}[${index}]`));
+}
+export function scoreSeconds(notes, tempo) {
+    let beats = 0;
+    for (const note of notes)
+        beats += note.beats;
+    return (beats * 60) / tempo;
+}
+export function notesToEngineScore(notes, tempo, frameRate = DEFAULT_FRAME_RATE, leadIn = 0.16, leadOut = 0.16) {
+    const engineNotes = [];
+    const padding = (seconds) => Math.max(1, Math.round(seconds * frameRate));
+    if (notes[0]?.key !== null)
+        engineNotes.push({ id: "lead-in", key: null, frame_length: padding(leadIn), lyric: "" });
+    let frames = 0;
+    let seconds = 0;
+    for (const [index, note] of notes.entries()) {
+        seconds += (note.beats * 60) / tempo;
+        const boundary = Math.round(seconds * frameRate);
+        const length = boundary - frames;
+        if (length < 1) {
+            invalid(`$.notes[${index}].beats`, `Note ${index} is shorter than one engine frame (${(1000 / frameRate).toFixed(2)} ms at ${tempo} BPM).`);
+        }
+        engineNotes.push({ id: `n${index}`, key: note.key, frame_length: length, lyric: note.lyric });
+        frames = boundary;
+    }
+    if (notes.at(-1)?.key !== null)
+        engineNotes.push({ id: "lead-out", key: null, frame_length: padding(leadOut), lyric: "" });
+    return { notes: engineNotes };
+}
+export function engineScoreFrames(score) {
+    let total = 0;
+    for (const note of score.notes)
+        total += note.frame_length;
+    return total;
+}
+export function transposeInput(value, path) {
+    return integer(value, path, -48, 48);
+}
+//# sourceMappingURL=score.js.map