takomusic 1.2.0

package/dist/interpreter/builtins/core.js

@@ -0,0 +1,265 @@
+// Core builtin functions: title, ppq, tempo, timeSig, at, advance, note, rest, chord, drum
+import { makeNull, toNumber } from '../runtime.js';
+import { MFError, createError } from '../../errors.js';
+import { DRUM_MAP } from '../trackState.js';
+// Using 'any' for 'this' to avoid circular dependency and private member issues
+export function builtinTitle(args, position) {
+    this.checkGlobalPhase(position);
+    const val = this.evaluate(args[0]);
+    if (val.type !== 'string') {
+        throw new MFError('TYPE', 'title() expects string', position, this.filePath);
+    }
+    this.ir.title = val.value;
+    return makeNull();
+}
+export function builtinPpq(args, position) {
+    this.checkGlobalPhase(position);
+    const val = this.evaluate(args[0]);
+    if (val.type !== 'int') {
+        throw new MFError('TYPE', 'ppq() expects int', position, this.filePath);
+    }
+    this.ir.ppq = val.value;
+    return makeNull();
+}
+export function builtinTempo(args, position) {
+    this.checkGlobalPhase(position);
+    if (args.length === 1) {
+        // tempo(bpm)
+        const bpm = this.evaluate(args[0]);
+        const bpmVal = toNumber(bpm);
+        this.ir.tempos.push({ tick: 0, bpm: bpmVal });
+    }
+    else {
+        // tempo(time, bpm)
+        const time = this.evaluate(args[0]);
+        const bpm = this.evaluate(args[1]);
+        if (time.type !== 'time') {
+            throw new MFError('TYPE', 'tempo() time must be Time', position, this.filePath);
+        }
+        const tick = this.timeToTick(time, position);
+        this.ir.tempos.push({ tick, bpm: toNumber(bpm) });
+    }
+    return makeNull();
+}
+export function builtinTimeSig(args, position) {
+    this.checkGlobalPhase(position);
+    if (args.length === 2) {
+        // timeSig(num, den)
+        const num = this.evaluate(args[0]);
+        const den = this.evaluate(args[1]);
+        if (num.type !== 'int' || den.type !== 'int') {
+            throw new MFError('TYPE', 'timeSig() expects int, int', position, this.filePath);
+        }
+        this.ir.timeSigs.push({ tick: 0, numerator: num.value, denominator: den.value });
+    }
+    else {
+        // timeSig(time, num, den)
+        const time = this.evaluate(args[0]);
+        const num = this.evaluate(args[1]);
+        const den = this.evaluate(args[2]);
+        if (time.type !== 'time') {
+            throw new MFError('TYPE', 'timeSig() time must be Time', position, this.filePath);
+        }
+        // Must be at bar start
+        if (time.beat !== 1 || time.sub !== 0) {
+            throw createError('E020', 'timeSig must be at bar start (beat=1, sub=0)', position, this.filePath);
+        }
+        const tick = this.timeToTick(time, position);
+        if (num.type !== 'int' || den.type !== 'int') {
+            throw new MFError('TYPE', 'timeSig() expects int, int', position, this.filePath);
+        }
+        this.ir.timeSigs.push({ tick, numerator: num.value, denominator: den.value });
+    }
+    return makeNull();
+}
+export function builtinAt(args, position) {
+    this.checkTrackPhase(position);
+    const time = this.evaluate(args[0]);
+    if (time.type !== 'time') {
+        throw new MFError('TYPE', 'at() expects Time', position, this.filePath);
+    }
+    const tick = this.timeToTick(time, position);
+    this.currentTrack.cursor = tick;
+    return makeNull();
+}
+export function builtinAtTick(args, position) {
+    this.checkTrackPhase(position);
+    const tick = this.evaluate(args[0]);
+    if (tick.type !== 'int') {
+        throw new MFError('TYPE', 'atTick() expects int', position, this.filePath);
+    }
+    this.currentTrack.cursor = tick.value;
+    return makeNull();
+}
+export function builtinAdvance(args, position) {
+    this.checkTrackPhase(position);
+    const dur = this.evaluate(args[0]);
+    if (dur.type !== 'dur') {
+        throw new MFError('TYPE', 'advance() expects Dur', position, this.filePath);
+    }
+    const ticks = this.durToTicks(dur, position);
+    this.currentTrack.cursor += ticks;
+    return makeNull();
+}
+export function builtinAdvanceTick(args, position) {
+    this.checkTrackPhase(position);
+    const dt = this.evaluate(args[0]);
+    if (dt.type !== 'int') {
+        throw new MFError('TYPE', 'advanceTick() expects int', position, this.filePath);
+    }
+    this.currentTrack.cursor += dt.value;
+    return makeNull();
+}
+export function builtinNote(args, position) {
+    this.checkTrackPhase(position);
+    const track = this.currentTrack;
+    const pitch = this.evaluate(args[0]);
+    const dur = this.evaluate(args[1]);
+    if (pitch.type !== 'pitch') {
+        throw new MFError('TYPE', 'note() pitch must be Pitch', position, this.filePath);
+    }
+    if (dur.type !== 'dur') {
+        throw new MFError('TYPE', 'note() duration must be Dur', position, this.filePath);
+    }
+    // Validate pitch range
+    if (pitch.midi < 0 || pitch.midi > 127) {
+        throw createError('E110', `Pitch ${pitch.midi} out of range 0..127`, position, this.filePath);
+    }
+    const durTicks = this.durToTicks(dur, position);
+    const tick = track.cursor;
+    if (track.kind === 'vocal') {
+        // Vocal needs lyric
+        if (args.length < 3) {
+            throw createError('E210', 'Vocal note requires lyric', position, this.filePath);
+        }
+        const lyric = this.evaluate(args[2]);
+        if (lyric.type !== 'string' || lyric.value === '') {
+            throw createError('E210', 'Vocal lyric must be non-empty string', position, this.filePath);
+        }
+        // Check for overlap
+        this.checkVocalOverlap(track, tick, durTicks, position);
+        const event = {
+            type: 'note',
+            tick,
+            dur: durTicks,
+            key: pitch.midi,
+            lyric: lyric.value,
+        };
+        track.events.push(event);
+    }
+    else {
+        // MIDI track
+        const vel = args.length >= 3
+            ? toNumber(this.evaluate(args[2]))
+            : track.defaultVel ?? 96;
+        const event = {
+            type: 'note',
+            tick,
+            dur: durTicks,
+            key: pitch.midi,
+            vel,
+        };
+        track.events.push(event);
+    }
+    track.cursor += durTicks;
+    return makeNull();
+}
+export function builtinRest(args, position) {
+    this.checkTrackPhase(position);
+    const track = this.currentTrack;
+    const dur = this.evaluate(args[0]);
+    if (dur.type !== 'dur') {
+        throw new MFError('TYPE', 'rest() expects Dur', position, this.filePath);
+    }
+    const durTicks = this.durToTicks(dur, position);
+    const tick = track.cursor;
+    const event = {
+        type: 'rest',
+        tick,
+        dur: durTicks,
+    };
+    track.events.push(event);
+    track.cursor += durTicks;
+    return makeNull();
+}
+export function builtinChord(args, position) {
+    this.checkTrackPhase(position);
+    const track = this.currentTrack;
+    const pitchArr = this.evaluate(args[0]);
+    const dur = this.evaluate(args[1]);
+    if (pitchArr.type !== 'array') {
+        throw new MFError('TYPE', 'chord() expects array of pitches', position, this.filePath);
+    }
+    if (dur.type !== 'dur') {
+        throw new MFError('TYPE', 'chord() duration must be Dur', position, this.filePath);
+    }
+    const durTicks = this.durToTicks(dur, position);
+    const tick = track.cursor;
+    const vel = args.length >= 3
+        ? toNumber(this.evaluate(args[2]))
+        : track.defaultVel ?? 96;
+    for (const p of pitchArr.elements) {
+        if (p.type !== 'pitch') {
+            throw new MFError('TYPE', 'chord() array must contain only Pitch', position, this.filePath);
+        }
+        if (p.midi < 0 || p.midi > 127) {
+            throw createError('E110', `Pitch ${p.midi} out of range 0..127`, position, this.filePath);
+        }
+        const event = {
+            type: 'note',
+            tick,
+            dur: durTicks,
+            key: p.midi,
+            vel,
+        };
+        track.events.push(event);
+    }
+    track.cursor += durTicks;
+    return makeNull();
+}
+export function builtinDrum(args, position, rawArgs) {
+    this.checkTrackPhase(position);
+    const track = this.currentTrack;
+    // Get drum name from raw AST to get the identifier name
+    const drumNameExpr = rawArgs[0];
+    let drumName;
+    if (drumNameExpr.kind === 'Identifier') {
+        drumName = drumNameExpr.name;
+    }
+    else if (drumNameExpr.kind === 'StringLiteral') {
+        drumName = drumNameExpr.value;
+    }
+    else {
+        const evaluated = this.evaluate(drumNameExpr);
+        if (evaluated.type === 'string') {
+            drumName = evaluated.value;
+        }
+        else {
+            throw new MFError('TYPE', 'drum() expects drum name identifier or string', position, this.filePath);
+        }
+    }
+    const dur = this.evaluate(args[1]);
+    if (dur.type !== 'dur') {
+        throw new MFError('TYPE', 'drum() duration must be Dur', position, this.filePath);
+    }
+    const midiNote = DRUM_MAP[drumName];
+    if (midiNote === undefined) {
+        throw createError('E110', `Unknown drum name: ${drumName}`, position, this.filePath);
+    }
+    const durTicks = this.durToTicks(dur, position);
+    const tick = track.cursor;
+    const vel = args.length >= 3
+        ? toNumber(this.evaluate(args[2]))
+        : track.defaultVel ?? 96;
+    const event = {
+        type: 'note',
+        tick,
+        dur: durTicks,
+        key: midiNote,
+        vel,
+    };
+    track.events.push(event);
+    track.cursor += durTicks;
+    return makeNull();
+}
+//# sourceMappingURL=core.js.map

package/dist/interpreter/builtins/core.js.map

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

package/dist/interpreter/builtins/dynamics.d.ts

@@ -0,0 +1,8 @@
+import type { Expression } from '../../types/ast.js';
+import type { Articulation } from '../../types/ir.js';
+import { RuntimeValue } from '../runtime.js';
+export declare function builtinDynamic(this: any, args: Expression[], position: any): RuntimeValue;
+export declare function builtinCrescendo(this: any, args: Expression[], position: any): RuntimeValue;
+export declare function builtinDecrescendo(this: any, args: Expression[], position: any): RuntimeValue;
+export declare function builtinArticulatedNote(this: any, args: Expression[], position: any, articulation: Articulation): RuntimeValue;
+//# sourceMappingURL=dynamics.d.ts.map

package/dist/interpreter/builtins/dynamics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamics.d.ts","sourceRoot":"","sources":["../../../src/interpreter/builtins/dynamics.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAA6C,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjG,OAAO,EAAE,YAAY,EAAsB,MAAM,eAAe,CAAC;AAGjE,wBAAgB,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,GAAG,GAAG,YAAY,CAiCzF;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,GAAG,GAAG,YAAY,CAsB3F;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,GAAG,GAAG,YAAY,CAsB7F;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,GAAG,EACT,IAAI,EAAE,UAAU,EAAE,EAClB,QAAQ,EAAE,GAAG,EACb,YAAY,EAAE,YAAY,GACzB,YAAY,CAgBd"}

package/dist/interpreter/builtins/dynamics.js

@@ -0,0 +1,86 @@
+// Dynamics builtin functions: dynamic, crescendo, decrescendo, articulations
+import { makeNull } from '../runtime.js';
+import { MFError } from '../../errors.js';
+export function builtinDynamic(args, position) {
+    this.checkTrackPhase(position);
+    const track = this.currentTrack;
+    const markExpr = args[0];
+    let markStr;
+    if (markExpr.kind === 'Identifier') {
+        markStr = markExpr.name;
+    }
+    else {
+        const mark = this.evaluate(args[0]);
+        if (mark.type !== 'string') {
+            throw new MFError('TYPE', 'dynamic() mark must be string or identifier', position, this.filePath);
+        }
+        markStr = mark.value;
+    }
+    const validMarks = ['ppp', 'pp', 'p', 'mp', 'mf', 'f', 'ff', 'fff', 'sfz', 'fp'];
+    if (!validMarks.includes(markStr)) {
+        throw new MFError('TYPE', `Unknown dynamic mark: ${markStr}. Valid: ${validMarks.join(', ')}`, position, this.filePath);
+    }
+    if (!track.notation) {
+        track.notation = { dynamics: [], slurs: [], crescendos: [], ties: [], hairpins: [], articulations: [] };
+    }
+    const event = {
+        type: 'dynamic',
+        tick: track.cursor,
+        mark: markStr,
+    };
+    track.notation.dynamics.push(event);
+    return makeNull();
+}
+export function builtinCrescendo(args, position) {
+    this.checkTrackPhase(position);
+    const track = this.currentTrack;
+    const dur = this.evaluate(args[0]);
+    if (dur.type !== 'dur') {
+        throw new MFError('TYPE', 'crescendo() duration must be Dur', position, this.filePath);
+    }
+    const durTicks = this.durToTicks(dur, position);
+    if (!track.notation) {
+        track.notation = { dynamics: [], slurs: [], crescendos: [], ties: [], hairpins: [], articulations: [] };
+    }
+    const event = {
+        type: 'crescendo',
+        tick: track.cursor,
+        endTick: track.cursor + durTicks,
+    };
+    track.notation.crescendos.push(event);
+    return makeNull();
+}
+export function builtinDecrescendo(args, position) {
+    this.checkTrackPhase(position);
+    const track = this.currentTrack;
+    const dur = this.evaluate(args[0]);
+    if (dur.type !== 'dur') {
+        throw new MFError('TYPE', 'decrescendo() duration must be Dur', position, this.filePath);
+    }
+    const durTicks = this.durToTicks(dur, position);
+    if (!track.notation) {
+        track.notation = { dynamics: [], slurs: [], crescendos: [], ties: [], hairpins: [], articulations: [] };
+    }
+    const event = {
+        type: 'decrescendo',
+        tick: track.cursor,
+        endTick: track.cursor + durTicks,
+    };
+    track.notation.crescendos.push(event);
+    return makeNull();
+}
+export function builtinArticulatedNote(args, position, articulation) {
+    this.checkTrackPhase(position);
+    const track = this.currentTrack;
+    // Set articulation for next note
+    if (!track.notation) {
+        track.notation = { dynamics: [], slurs: [], crescendos: [], ties: [], hairpins: [], articulations: [] };
+    }
+    track.notation.articulations.push({
+        type: 'articulation',
+        tick: track.cursor,
+        kind: articulation,
+    });
+    return makeNull();
+}
+//# sourceMappingURL=dynamics.js.map

package/dist/interpreter/builtins/dynamics.js.map

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

package/dist/interpreter/builtins/effects.d.ts

@@ -0,0 +1,16 @@
+import type { Expression } from '../../types/ast.js';
+import { RuntimeValue } from '../runtime.js';
+export declare function builtinReverb(this: any, args: Expression[], position: any): RuntimeValue;
+export declare function builtinDelay(this: any, args: Expression[], position: any): RuntimeValue;
+export declare function builtinEQ(this: any, args: Expression[], position: any): RuntimeValue;
+export declare function builtinCompressor(this: any, args: Expression[], position: any): RuntimeValue;
+export declare function builtinPhaser(this: any, args: Expression[], position: any): RuntimeValue;
+export declare function builtinFlanger(this: any, args: Expression[], position: any): RuntimeValue;
+export declare function builtinChorus(this: any, args: Expression[], position: any): RuntimeValue;
+export declare function builtinDistortion(this: any, args: Expression[], position: any): RuntimeValue;
+export declare function builtinFilter(this: any, args: Expression[], position: any): RuntimeValue;
+export declare function builtinSidechain(this: any, args: Expression[], position: any): RuntimeValue;
+export declare function builtinLimiter(this: any, args: Expression[], position: any): RuntimeValue;
+export declare function builtinMaximizer(this: any, args: Expression[], position: any): RuntimeValue;
+export declare function builtinEQBand(this: any, args: Expression[], position: any): RuntimeValue;
+//# sourceMappingURL=effects.d.ts.map

package/dist/interpreter/builtins/effects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effects.d.ts","sourceRoot":"","sources":["../../../src/interpreter/builtins/effects.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAsB,MAAM,eAAe,CAAC;AAGjE,wBAAgB,aAAa,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,GAAG,GAAG,YAAY,CAmBxF;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,GAAG,GAAG,YAAY,CAmBvF;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,GAAG,GAAG,YAAY,CAmBpF;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,GAAG,GAAG,YAAY,CAoB5F;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,GAAG,GAAG,YAAY,CAiBxF;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,GAAG,GAAG,YAAY,CAiBzF;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,GAAG,GAAG,YAAY,CAiBxF;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,GAAG,GAAG,YAAY,CAgB5F;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,GAAG,GAAG,YAAY,CAoBxF;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,GAAG,GAAG,YAAY,CAuB3F;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,GAAG,GAAG,YAAY,CAmBzF;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,GAAG,GAAG,YAAY,CAkB3F;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,GAAG,GAAG,YAAY,CAoBxF"}

package/dist/interpreter/builtins/effects.js

@@ -0,0 +1,220 @@
+// Effects builtin functions: reverb, delay, eq, compressor, phaser, flanger, chorus, distortion, filter, sidechain, limiter, maximizer, eqBand
+import { makeNull, toNumber } from '../runtime.js';
+import { MFError } from '../../errors.js';
+export function builtinReverb(args, position) {
+    this.checkTrackPhase(position);
+    const track = this.currentTrack;
+    const roomSize = args.length > 0 ? toNumber(this.evaluate(args[0])) / 127 : 0.5;
+    const damping = args.length > 1 ? toNumber(this.evaluate(args[1])) / 127 : 0.5;
+    const wetDry = args.length > 2 ? toNumber(this.evaluate(args[2])) / 127 : 0.3;
+    if (!track.effects) {
+        track.effects = [];
+    }
+    track.effects.push({
+        type: 'effect',
+        effectType: 'reverb',
+        params: { roomSize, damping, wetDry },
+    });
+    return makeNull();
+}
+export function builtinDelay(args, position) {
+    this.checkTrackPhase(position);
+    const track = this.currentTrack;
+    const time = args.length > 0 ? toNumber(this.evaluate(args[0])) : 250; // ms
+    const feedback = args.length > 1 ? toNumber(this.evaluate(args[1])) / 127 : 0.4;
+    const wetDry = args.length > 2 ? toNumber(this.evaluate(args[2])) / 127 : 0.3;
+    if (!track.effects) {
+        track.effects = [];
+    }
+    track.effects.push({
+        type: 'effect',
+        effectType: 'delay',
+        params: { time, feedback, wetDry },
+    });
+    return makeNull();
+}
+export function builtinEQ(args, position) {
+    this.checkTrackPhase(position);
+    const track = this.currentTrack;
+    const lowGain = args.length > 0 ? toNumber(this.evaluate(args[0])) - 64 : 0;
+    const midGain = args.length > 1 ? toNumber(this.evaluate(args[1])) - 64 : 0;
+    const highGain = args.length > 2 ? toNumber(this.evaluate(args[2])) - 64 : 0;
+    if (!track.effects) {
+        track.effects = [];
+    }
+    track.effects.push({
+        type: 'effect',
+        effectType: 'eq',
+        params: { lowGain, midGain, highGain },
+    });
+    return makeNull();
+}
+export function builtinCompressor(args, position) {
+    this.checkTrackPhase(position);
+    const track = this.currentTrack;
+    const threshold = args.length > 0 ? toNumber(this.evaluate(args[0])) : -20; // dB
+    const ratio = args.length > 1 ? toNumber(this.evaluate(args[1])) : 4;
+    const attack = args.length > 2 ? toNumber(this.evaluate(args[2])) : 10; // ms
+    const release = args.length > 3 ? toNumber(this.evaluate(args[3])) : 100; // ms
+    if (!track.effects) {
+        track.effects = [];
+    }
+    track.effects.push({
+        type: 'effect',
+        effectType: 'compressor',
+        params: { threshold, ratio, attack, release },
+    });
+    return makeNull();
+}
+export function builtinPhaser(args, position) {
+    this.checkTrackPhase(position);
+    const track = this.currentTrack;
+    const rate = args.length > 0 ? toNumber(this.evaluate(args[0])) : 0.5;
+    const depth = args.length > 1 ? toNumber(this.evaluate(args[1])) : 50;
+    const feedback = args.length > 2 ? toNumber(this.evaluate(args[2])) : 50;
+    const stages = args.length > 3 ? Math.floor(toNumber(this.evaluate(args[3]))) : 4;
+    if (!track.effects)
+        track.effects = [];
+    track.effects.push({
+        type: 'effect',
+        effectType: 'phaser',
+        params: { rate, depth, feedback, stages },
+    });
+    return makeNull();
+}
+export function builtinFlanger(args, position) {
+    this.checkTrackPhase(position);
+    const track = this.currentTrack;
+    const rate = args.length > 0 ? toNumber(this.evaluate(args[0])) : 0.25;
+    const depth = args.length > 1 ? toNumber(this.evaluate(args[1])) : 50;
+    const feedback = args.length > 2 ? toNumber(this.evaluate(args[2])) : 50;
+    const mix = args.length > 3 ? toNumber(this.evaluate(args[3])) : 50;
+    if (!track.effects)
+        track.effects = [];
+    track.effects.push({
+        type: 'effect',
+        effectType: 'flanger',
+        params: { rate, depth, feedback, mix },
+    });
+    return makeNull();
+}
+export function builtinChorus(args, position) {
+    this.checkTrackPhase(position);
+    const track = this.currentTrack;
+    const rate = args.length > 0 ? toNumber(this.evaluate(args[0])) : 1.0;
+    const depth = args.length > 1 ? toNumber(this.evaluate(args[1])) : 50;
+    const voices = args.length > 2 ? Math.floor(toNumber(this.evaluate(args[2]))) : 3;
+    const mix = args.length > 3 ? toNumber(this.evaluate(args[3])) : 50;
+    if (!track.effects)
+        track.effects = [];
+    track.effects.push({
+        type: 'effect',
+        effectType: 'chorus',
+        params: { rate, depth, voices, mix },
+    });
+    return makeNull();
+}
+export function builtinDistortion(args, position) {
+    this.checkTrackPhase(position);
+    const track = this.currentTrack;
+    const drive = args.length > 0 ? toNumber(this.evaluate(args[0])) : 50;
+    const tone = args.length > 1 ? toNumber(this.evaluate(args[1])) : 50;
+    const mix = args.length > 2 ? toNumber(this.evaluate(args[2])) : 100;
+    if (!track.effects)
+        track.effects = [];
+    track.effects.push({
+        type: 'effect',
+        effectType: 'distortion',
+        params: { drive, tone, mix },
+    });
+    return makeNull();
+}
+export function builtinFilter(args, position) {
+    this.checkTrackPhase(position);
+    const track = this.currentTrack;
+    const filterType = this.evaluate(args[0]);
+    const cutoff = args.length > 1 ? toNumber(this.evaluate(args[1])) : 1000;
+    const resonance = args.length > 2 ? toNumber(this.evaluate(args[2])) : 50;
+    if (filterType.type !== 'string') {
+        throw new MFError('TYPE', 'filter() type must be string', position, this.filePath);
+    }
+    if (!track.effects)
+        track.effects = [];
+    track.effects.push({
+        type: 'effect',
+        effectType: 'filter',
+        params: { filterType: filterType.value, cutoff, resonance },
+    });
+    return makeNull();
+}
+export function builtinSidechain(args, position) {
+    this.checkTrackPhase(position);
+    const track = this.currentTrack;
+    const sourceTrack = this.evaluate(args[0]);
+    const threshold = args.length > 1 ? toNumber(this.evaluate(args[1])) : -20;
+    const ratio = args.length > 2 ? toNumber(this.evaluate(args[2])) : 4;
+    const attack = args.length > 3 ? toNumber(this.evaluate(args[3])) : 10;
+    const release = args.length > 4 ? toNumber(this.evaluate(args[4])) : 100;
+    if (sourceTrack.type !== 'string') {
+        throw new MFError('TYPE', 'sidechain() source must be string', position, this.filePath);
+    }
+    // Store as effect with sidechain params
+    if (!track.effects)
+        track.effects = [];
+    track.effects.push({
+        type: 'effect',
+        effectType: 'compressor',
+        params: { threshold, ratio, attack, release, sidechain: sourceTrack.value },
+    });
+    return makeNull();
+}
+export function builtinLimiter(args, position) {
+    this.checkTrackPhase(position);
+    const track = this.currentTrack;
+    const threshold = toNumber(this.evaluate(args[0]));
+    const ceiling = toNumber(this.evaluate(args[1]));
+    const release = args.length > 2 ? toNumber(this.evaluate(args[2])) : 100;
+    if (!track.effects) {
+        track.effects = [];
+    }
+    track.effects.push({
+        type: 'effect',
+        effectType: 'limiter',
+        params: { threshold, ceiling, release },
+    });
+    return makeNull();
+}
+export function builtinMaximizer(args, position) {
+    this.checkTrackPhase(position);
+    const track = this.currentTrack;
+    const threshold = toNumber(this.evaluate(args[0]));
+    const ceiling = toNumber(this.evaluate(args[1]));
+    if (!track.effects) {
+        track.effects = [];
+    }
+    track.effects.push({
+        type: 'effect',
+        effectType: 'limiter',
+        params: { threshold, ceiling, release: 50, isMaximizer: 1 },
+    });
+    return makeNull();
+}
+export function builtinEQBand(args, position) {
+    this.checkTrackPhase(position);
+    const track = this.currentTrack;
+    const freq = toNumber(this.evaluate(args[0]));
+    const gain = toNumber(this.evaluate(args[1]));
+    const q = args.length > 2 ? toNumber(this.evaluate(args[2])) : 1;
+    const bandType = args.length > 3 ? this.evaluate(args[3]) : { type: 'string', value: 'peak' };
+    if (track.linearPhaseEQs && track.linearPhaseEQs.length > 0) {
+        const eq = track.linearPhaseEQs[track.linearPhaseEQs.length - 1];
+        eq.bands.push({
+            frequency: freq,
+            gain,
+            q,
+            type: bandType.value || 'peak',
+        });
+    }
+    return makeNull();
+}
+//# sourceMappingURL=effects.js.map