takomusic 1.2.0

package/dist/config/config.js

@@ -0,0 +1,200 @@
+// Configuration file parser for mfconfig.toml
+import * as fs from 'fs';
+import * as path from 'path';
+import TOML from 'toml';
+const DEFAULT_CONFIG = {
+    project: {
+        entry: 'src/main.mf',
+        dist: 'dist',
+        out: 'out',
+        defaultProfile: 'cli',
+    },
+    profiles: {
+        miku: {
+            backend: 'miku-daw',
+            importStrategy: 'manual',
+            vsqxOut: 'dist/vocal.vsqx',
+            tempoMidOut: 'dist/tempo.mid',
+            renderOut: 'out/mix.wav',
+        },
+        cli: {
+            backend: 'headless',
+            musicxmlOut: 'dist/vocal.musicxml',
+            bandMidOut: 'dist/band.mid',
+            renderOut: 'out/mix.wav',
+        },
+    },
+};
+export function loadConfig(configPath) {
+    try {
+        const content = fs.readFileSync(configPath, 'utf-8');
+        const parsed = TOML.parse(content);
+        return mergeConfig(DEFAULT_CONFIG, parsed);
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            throw new Error(`Config file not found: ${configPath}`);
+        }
+        if (err instanceof Error && err.message.includes('Syntax error')) {
+            throw new Error(`Invalid TOML syntax in ${configPath}: ${err.message}`);
+        }
+        throw err;
+    }
+}
+export function validateConfig(configPath) {
+    const errors = [];
+    const warnings = [];
+    const baseDir = path.dirname(configPath);
+    try {
+        const content = fs.readFileSync(configPath, 'utf-8');
+        const parsed = TOML.parse(content);
+        // Check for unknown top-level keys
+        const validTopKeys = ['project', 'profiles'];
+        for (const key of Object.keys(parsed)) {
+            if (!validTopKeys.includes(key)) {
+                warnings.push(`Unknown config key: "${key}". Valid keys are: ${validTopKeys.join(', ')}`);
+            }
+        }
+        // Validate [project] section
+        if (parsed.project) {
+            const validProjectKeys = ['entry', 'dist', 'out', 'default_profile', 'name', 'version'];
+            for (const key of Object.keys(parsed.project)) {
+                if (!validProjectKeys.includes(key)) {
+                    warnings.push(`Unknown project key: "${key}". Valid keys are: ${validProjectKeys.join(', ')}`);
+                }
+            }
+            // Check entry file exists
+            if (parsed.project.entry) {
+                const entryPath = path.join(baseDir, parsed.project.entry);
+                if (!fs.existsSync(entryPath)) {
+                    errors.push(`Entry file not found: ${parsed.project.entry}`);
+                }
+            }
+        }
+        else {
+            warnings.push('Missing [project] section, using defaults');
+        }
+        // Validate [profiles] section
+        if (parsed.profiles) {
+            const validProfileNames = ['cli', 'miku'];
+            for (const profileName of Object.keys(parsed.profiles)) {
+                if (!validProfileNames.includes(profileName)) {
+                    warnings.push(`Unknown profile: "${profileName}". Valid profiles are: ${validProfileNames.join(', ')}`);
+                }
+            }
+            // Validate [profiles.cli]
+            if (parsed.profiles.cli) {
+                const validCliKeys = ['backend', 'vocal_cmd', 'midi_cmd', 'mix_cmd', 'musicxml_out', 'band_mid_out', 'render_out'];
+                for (const key of Object.keys(parsed.profiles.cli)) {
+                    if (!validCliKeys.includes(key)) {
+                        warnings.push(`Unknown profiles.cli key: "${key}". Valid keys are: ${validCliKeys.join(', ')}`);
+                    }
+                }
+                // Check command arrays
+                for (const cmdKey of ['vocal_cmd', 'midi_cmd', 'mix_cmd']) {
+                    const cmd = parsed.profiles.cli[cmdKey];
+                    if (cmd && !Array.isArray(cmd)) {
+                        errors.push(`profiles.cli.${cmdKey} must be an array of strings`);
+                    }
+                }
+            }
+            // Validate [profiles.miku]
+            if (parsed.profiles.miku) {
+                const validMikuKeys = ['backend', 'import_strategy', 'daw_exe', 'daw_args', 'daw_project', 'vsqx_out', 'tempo_mid_out', 'render_out', 'engine'];
+                for (const key of Object.keys(parsed.profiles.miku)) {
+                    if (!validMikuKeys.includes(key)) {
+                        warnings.push(`Unknown profiles.miku key: "${key}". Valid keys are: ${validMikuKeys.join(', ')}`);
+                    }
+                }
+            }
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings,
+        };
+    }
+    catch (err) {
+        if (err instanceof Error) {
+            errors.push(err.message);
+        }
+        return { valid: false, errors, warnings };
+    }
+}
+export function findConfigPath(startDir) {
+    let currentDir = startDir;
+    while (true) {
+        const configPath = path.join(currentDir, 'mfconfig.toml');
+        if (fs.existsSync(configPath)) {
+            return configPath;
+        }
+        const parentDir = path.dirname(currentDir);
+        if (parentDir === currentDir) {
+            return null;
+        }
+        currentDir = parentDir;
+    }
+}
+function mergeConfig(defaults, parsed) {
+    return {
+        project: {
+            entry: parsed.project?.entry ?? defaults.project.entry,
+            dist: parsed.project?.dist ?? defaults.project.dist,
+            out: parsed.project?.out ?? defaults.project.out,
+            defaultProfile: parsed.project?.default_profile ?? defaults.project.defaultProfile,
+        },
+        profiles: {
+            miku: parsed.profiles?.miku
+                ? {
+                    backend: 'miku-daw',
+                    importStrategy: parsed.profiles.miku.import_strategy ?? 'manual',
+                    dawExe: parsed.profiles.miku.daw_exe,
+                    dawArgs: parsed.profiles.miku.daw_args,
+                    dawProject: parsed.profiles.miku.daw_project,
+                    vsqxOut: parsed.profiles.miku.vsqx_out ?? defaults.profiles.miku.vsqxOut,
+                    tempoMidOut: parsed.profiles.miku.tempo_mid_out ?? defaults.profiles.miku.tempoMidOut,
+                    renderOut: parsed.profiles.miku.render_out ?? defaults.profiles.miku.renderOut,
+                }
+                : defaults.profiles.miku,
+            cli: parsed.profiles?.cli
+                ? {
+                    backend: 'headless',
+                    vocalCmd: parsed.profiles.cli.vocal_cmd,
+                    midiCmd: parsed.profiles.cli.midi_cmd,
+                    mixCmd: parsed.profiles.cli.mix_cmd,
+                    musicxmlOut: parsed.profiles.cli.musicxml_out ?? defaults.profiles.cli.musicxmlOut,
+                    bandMidOut: parsed.profiles.cli.band_mid_out ?? defaults.profiles.cli.bandMidOut,
+                    renderOut: parsed.profiles.cli.render_out ?? defaults.profiles.cli.renderOut,
+                }
+                : defaults.profiles.cli,
+        },
+    };
+}
+export function generateDefaultConfig() {
+    return `[project]
+entry = "src/main.mf"
+dist  = "dist"
+out   = "out"
+default_profile = "cli"
+
+[profiles.miku]
+backend = "miku-daw"
+import_strategy = "manual"
+# daw_exe  = "reaper"
+# daw_args = ["-renderproject", "{project}"]
+# daw_project = "reaper/song.rpp"
+vsqx_out     = "dist/vocal.vsqx"
+tempo_mid_out= "dist/tempo.mid"
+render_out   = "out/mix.wav"
+
+[profiles.cli]
+backend = "headless"
+# vocal_cmd = ["neutrino-run", "{musicxml}", "{vocal_wav}"]
+# midi_cmd  = ["fluidsynth-run", "{mid}", "{band_wav}"]
+# mix_cmd   = ["ffmpeg", "-i", "{vocal_wav}", "-i", "{band_wav}", "{mix_wav}"]
+musicxml_out = "dist/vocal.musicxml"
+band_mid_out = "dist/band.mid"
+render_out   = "out/mix.wav"
+`;
+}
+//# sourceMappingURL=config.js.map

package/dist/config/config.js.map

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

package/dist/config/index.d.ts

@@ -0,0 +1,2 @@
+export * from './config.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,2 @@
+export * from './config.js';
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,49 @@
+import type { Position } from './types/token.js';
+export declare class MFError extends Error {
+    code: string;
+    position?: Position | undefined;
+    filePath?: string | undefined;
+    suggestion?: string;
+    constructor(code: string, message: string, position?: Position | undefined, filePath?: string | undefined, suggestion?: string);
+    toString(): string;
+}
+export declare const ErrorCodes: {
+    readonly E001: "ppq not set";
+    readonly E010: "tempo at tick=0 not set";
+    readonly E011: "timeSig at tick=0 not set";
+    readonly E020: "timeSig must be at bar start";
+    readonly E050: "Global function called after track started";
+    readonly E101: "Dur to tick does not divide evenly";
+    readonly E102: "Time sub out of beat tick range";
+    readonly E110: "Pitch out of range 0..127";
+    readonly E120: "CC controller out of range 0..127";
+    readonly E121: "CC/control value out of range 0..127";
+    readonly E122: "Pitch bend value out of range -8192..8191";
+    readonly E123: "Tempo curve steps must be at least 2";
+    readonly E130: "Invalid clef type";
+    readonly E131: "Key signature fifths out of range -7..7";
+    readonly E132: "Invalid articulation type";
+    readonly E133: "Invalid barline style";
+    readonly E134: "Invalid vocal style";
+    readonly E200: "Vocal note overlap";
+    readonly E210: "Vocal lyric missing or empty";
+    readonly E300: "Top-level execution in imported module";
+    readonly E310: "Proc recursion detected";
+    readonly E400: "Undefined symbol";
+    readonly E401: "For loop iteration limit exceeded";
+};
+export declare const WarningCodes: {
+    readonly W100: "Note duration extremely short";
+    readonly W110: "Vocal pitch out of typical range";
+    readonly W200: "Too many tempo events";
+};
+export declare const ExitCodes: {
+    readonly SUCCESS: 0;
+    readonly STATIC_ERROR: 2;
+    readonly IO_ERROR: 3;
+    readonly EXTERNAL_TOOL_ERROR: 4;
+    readonly DEPENDENCY_MISSING: 5;
+};
+export declare function createError(code: keyof typeof ErrorCodes, details?: string, position?: Position, filePath?: string, suggestion?: string): MFError;
+export declare function findSimilarSymbols(name: string, available: string[], maxDistance?: number): string[];
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,qBAAa,OAAQ,SAAQ,KAAK;IAIvB,IAAI,EAAE,MAAM;IAEZ,QAAQ,CAAC,EAAE,QAAQ;IACnB,QAAQ,CAAC,EAAE,MAAM;IANnB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAGlB,IAAI,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACR,QAAQ,CAAC,EAAE,QAAQ,YAAA,EACnB,QAAQ,CAAC,EAAE,MAAM,YAAA,EACxB,UAAU,CAAC,EAAE,MAAM;IAOrB,QAAQ,IAAI,MAAM;CAanB;AAGD,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;CAqCb,CAAC;AAEX,eAAO,MAAM,YAAY;;;;CAIf,CAAC;AAGX,eAAO,MAAM,SAAS;;;;;;CAMZ,CAAC;AAEX,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,OAAO,UAAU,EAC7B,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,QAAQ,EACnB,QAAQ,CAAC,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAST;AAuDD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,WAAW,SAAI,GAAG,MAAM,EAAE,CAc/F"}

package/dist/errors.js

@@ -0,0 +1,168 @@
+// Error definitions for MFS language
+export class MFError extends Error {
+    code;
+    position;
+    filePath;
+    suggestion;
+    constructor(code, message, position, filePath, suggestion) {
+        super(message);
+        this.code = code;
+        this.position = position;
+        this.filePath = filePath;
+        this.name = 'MFError';
+        this.suggestion = suggestion;
+    }
+    toString() {
+        const loc = this.position
+            ? `${this.filePath || 'unknown'}:${this.position.line}:${this.position.column}`
+            : '';
+        let result = `\n  error[${this.code}]: ${this.message}`;
+        if (loc) {
+            result += `\n    --> ${loc}`;
+        }
+        if (this.suggestion) {
+            result += `\n    help: ${this.suggestion}`;
+        }
+        return result;
+    }
+}
+// Error codes as per spec
+export const ErrorCodes = {
+    // General
+    E001: 'ppq not set',
+    E010: 'tempo at tick=0 not set',
+    E011: 'timeSig at tick=0 not set',
+    E020: 'timeSig must be at bar start',
+    E050: 'Global function called after track started',
+    // Time/Duration
+    E101: 'Dur to tick does not divide evenly',
+    E102: 'Time sub out of beat tick range',
+    E110: 'Pitch out of range 0..127',
+    // MIDI Control
+    E120: 'CC controller out of range 0..127',
+    E121: 'CC/control value out of range 0..127',
+    E122: 'Pitch bend value out of range -8192..8191',
+    E123: 'Tempo curve steps must be at least 2',
+    // Notation
+    E130: 'Invalid clef type',
+    E131: 'Key signature fifths out of range -7..7',
+    E132: 'Invalid articulation type',
+    E133: 'Invalid barline style',
+    E134: 'Invalid vocal style',
+    // Vocal
+    E200: 'Vocal note overlap',
+    E210: 'Vocal lyric missing or empty',
+    // Module
+    E300: 'Top-level execution in imported module',
+    E310: 'Proc recursion detected',
+    // Symbol/Syntax
+    E400: 'Undefined symbol',
+    E401: 'For loop iteration limit exceeded',
+};
+export const WarningCodes = {
+    W100: 'Note duration extremely short',
+    W110: 'Vocal pitch out of typical range',
+    W200: 'Too many tempo events',
+};
+// Exit codes as per spec
+export const ExitCodes = {
+    SUCCESS: 0,
+    STATIC_ERROR: 2,
+    IO_ERROR: 3,
+    EXTERNAL_TOOL_ERROR: 4,
+    DEPENDENCY_MISSING: 5,
+};
+export function createError(code, details, position, filePath, suggestion) {
+    const message = details
+        ? `${ErrorCodes[code]}: ${details}`
+        : ErrorCodes[code];
+    // Add default suggestions for common errors
+    const defaultSuggestion = suggestion ?? getDefaultSuggestion(code, details);
+    return new MFError(code, message, position, filePath, defaultSuggestion);
+}
+function getDefaultSuggestion(code, details) {
+    switch (code) {
+        case 'E001':
+            return 'Add ppq(480) at the start of main()';
+        case 'E010':
+            return 'Add tempo(120) at the start of main()';
+        case 'E011':
+            return 'Add timeSig(4, 4) at the start of main()';
+        case 'E020':
+            return 'Time signature changes must occur at the start of a bar';
+        case 'E050':
+            return 'Move global functions (ppq, tempo, timeSig, title) before any track() blocks';
+        case 'E110':
+            return 'Valid MIDI pitch range is 0-127 (C-1 to G9). Try using a different octave.';
+        case 'E120':
+            return 'MIDI CC controller numbers must be between 0 and 127';
+        case 'E121':
+            return 'MIDI CC/control values must be between 0 and 127';
+        case 'E122':
+            return 'Pitch bend values must be between -8192 (full down) and 8191 (full up). 0 is center.';
+        case 'E123':
+            return 'tempoCurve() needs at least 2 steps to interpolate between tempos';
+        case 'E130':
+            return 'Valid clefs: treble, bass, alto, tenor, percussion, tab, treble8va, treble8vb, bass8va, bass8vb';
+        case 'E131':
+            return 'Key signature fifths range from -7 (7 flats) to 7 (7 sharps). 0 = C major/A minor';
+        case 'E132':
+            return 'Valid articulations: staccato, legato, accent, tenuto, marcato, staccatissimo, fermata, breath, caesura';
+        case 'E133':
+            return 'Valid barline styles: single, double, final, repeat-start, repeat-end, repeat-both, dashed, tick, short, none';
+        case 'E134':
+            return 'Valid vocal styles: soft, normal, power, falsetto, whisper, breathy, belt, head, chest';
+        case 'E200':
+            return 'Vocal notes cannot overlap. Use rest() or adjust timing with at()';
+        case 'E210':
+            return 'Vocal note() requires a lyric: note(C4, 1/4, "あ")';
+        case 'E300':
+            return 'Imported modules should only contain proc/const definitions, not executable code';
+        case 'E310':
+            return 'Procedures cannot call themselves directly or indirectly';
+        case 'E400':
+            if (details?.includes('main')) {
+                return 'Add "export proc main() { ... }" to define the entry point';
+            }
+            return undefined; // Will use symbol suggestion instead
+        case 'E401':
+            return 'For loop range bounds must be const values, not let variables';
+        default:
+            return undefined;
+    }
+}
+// Find similar symbol names using Levenshtein distance
+export function findSimilarSymbols(name, available, maxDistance = 3) {
+    const results = [];
+    for (const sym of available) {
+        const dist = levenshteinDistance(name.toLowerCase(), sym.toLowerCase());
+        if (dist <= maxDistance) {
+            results.push({ name: sym, distance: dist });
+        }
+    }
+    return results
+        .sort((a, b) => a.distance - b.distance)
+        .slice(0, 3)
+        .map((r) => r.name);
+}
+function levenshteinDistance(a, b) {
+    const matrix = [];
+    for (let i = 0; i <= b.length; i++) {
+        matrix[i] = [i];
+    }
+    for (let j = 0; j <= a.length; j++) {
+        matrix[0][j] = j;
+    }
+    for (let i = 1; i <= b.length; i++) {
+        for (let j = 1; j <= a.length; j++) {
+            if (b[i - 1] === a[j - 1]) {
+                matrix[i][j] = matrix[i - 1][j - 1];
+            }
+            else {
+                matrix[i][j] = Math.min(matrix[i - 1][j - 1] + 1, matrix[i][j - 1] + 1, matrix[i - 1][j] + 1);
+            }
+        }
+    }
+    return matrix[b.length][a.length];
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/formatter/formatter.d.ts

@@ -0,0 +1,13 @@
+import type { Program } from '../types/ast.js';
+export declare class Formatter {
+    private indent;
+    private output;
+    format(program: Program): string;
+    private formatStatement;
+    private formatExport;
+    private formatProc;
+    private formatExpr;
+    private escapeString;
+    private line;
+}
+//# sourceMappingURL=formatter.d.ts.map

package/dist/formatter/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../src/formatter/formatter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,OAAO,EAIR,MAAM,iBAAiB,CAAC;AAEzB,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,MAAM,CAAgB;IAE9B,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM;IAsChC,OAAO,CAAC,eAAe;IAsHvB,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,UAAU;IA2FlB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,IAAI;CAIb"}