@beatbax/engine 0.1.0

package/dist/scheduler/tickScheduler.js

@@ -0,0 +1,74 @@
+import { error } from '../util/diag.js';
+export class TickScheduler {
+    ctx;
+    lookahead;
+    interval;
+    timer = null;
+    rafId = null;
+    queue = [];
+    opts;
+    constructor(ctx, opts = {}) {
+        this.ctx = ctx;
+        this.opts = opts;
+        this.lookahead = typeof opts.lookahead === 'number' ? opts.lookahead : 0.1;
+        this.interval = typeof opts.interval === 'number' ? opts.interval : 25;
+    }
+    schedule(time, fn) {
+        this.queue.push({ time, fn });
+        this.queue.sort((a, b) => a.time - b.time);
+    }
+    scheduleAligned(time, fn, frameHz = 512) {
+        if (!isFinite(time) || frameHz <= 0)
+            return this.schedule(time, fn);
+        const framePeriod = 1 / frameHz;
+        const aligned = Math.round(time / framePeriod) * framePeriod;
+        this.schedule(aligned, fn);
+    }
+    start() {
+        if (this.timer || this.rafId)
+            return;
+        const useRaf = !!this.opts.useRaf;
+        const rafFn = this.opts.raf || (typeof globalThis.requestAnimationFrame === 'function' ? globalThis.requestAnimationFrame.bind(globalThis) : null);
+        if (useRaf && rafFn) {
+            const loop = () => {
+                this.tick();
+                this.rafId = rafFn(loop);
+            };
+            this.rafId = rafFn(loop);
+            return;
+        }
+        const setInt = this.opts.setInterval || setInterval.bind(globalThis);
+        this.timer = setInt(() => this.tick(), this.interval);
+    }
+    stop() {
+        if (this.timer) {
+            const clearInt = this.opts.clearInterval || clearInterval.bind(globalThis);
+            clearInt(this.timer);
+            this.timer = null;
+        }
+        if (this.rafId !== null) {
+            const cancel = this.opts.cancelRaf || (typeof globalThis.cancelAnimationFrame === 'function' ? globalThis.cancelAnimationFrame.bind(globalThis) : null);
+            if (cancel)
+                cancel(this.rafId);
+            this.rafId = null;
+        }
+    }
+    clear() {
+        this.queue = [];
+    }
+    tick() {
+        const now = (this.ctx && typeof this.ctx.currentTime === 'number') ? this.ctx.currentTime : (Date.now() / 1000);
+        const cutoff = now + this.lookahead;
+        while (this.queue.length && this.queue[0].time <= cutoff) {
+            const ev = this.queue.shift();
+            try {
+                ev.fn();
+            }
+            catch (e) {
+                error('scheduler', 'Scheduled function error: ' + (e && e.message ? e.message : String(e)));
+            }
+        }
+    }
+}
+export default TickScheduler;
+//# sourceMappingURL=tickScheduler.js.map

package/dist/scheduler/tickScheduler.js.map

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

package/dist/sequences/expand.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Expand sequence definitions into flat token arrays by resolving pattern
+ * references and applying sequence-level transforms (oct, rev, slow, fast,
+ * semitone transposition, and inst(name) override which is emitted as an
+ * `inst(name)` token preceding the pattern tokens).
+ */
+export declare function expandSequenceItems(items: string[], pats: Record<string, string[]>, insts?: Record<string, any>, _missingWarned?: Set<string>, presets?: Record<string, string>): string[];
+export declare function expandAllSequences(seqs: Record<string, string[]>, pats: Record<string, string[]>, insts?: Record<string, any>, presets?: Record<string, string>): Record<string, string[]>;
+declare const _default: {
+    expandSequenceItems: typeof expandSequenceItems;
+    expandAllSequences: typeof expandAllSequences;
+};
+export default _default;
+//# sourceMappingURL=expand.d.ts.map

package/dist/sequences/expand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expand.d.ts","sourceRoot":"","sources":["../../src/sequences/expand.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAoChD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,CAAC,MAAM,GAAG,YAAY,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,EAAE,CA8D3M;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,YAAY,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAQ3M;;;;;AAED,wBAA2D"}

package/dist/sequences/expand.js

@@ -0,0 +1,137 @@
+import { warn } from '../util/diag.js';
+import { applyModsToTokens } from '../expand/refExpander.js';
+import { materializeSequenceItems } from '../parser/structured.js';
+/**
+ * Expand sequence definitions into flat token arrays by resolving pattern
+ * references and applying sequence-level transforms (oct, rev, slow, fast,
+ * semitone transposition, and inst(name) override which is emitted as an
+ * `inst(name)` token preceding the pattern tokens).
+ */
+const splitTopLevel = (s, sep = ':') => {
+    const out = [];
+    let cur = '';
+    let inS = false;
+    let inD = false;
+    let bracket = 0;
+    let paren = 0;
+    for (let i = 0; i < s.length; i++) {
+        const ch = s[i];
+        if (ch === "'" && !inD) {
+            inS = !inS;
+            cur += ch;
+            continue;
+        }
+        if (ch === '"' && !inS) {
+            inD = !inD;
+            cur += ch;
+            continue;
+        }
+        if (inS || inD) {
+            cur += ch;
+            continue;
+        }
+        if (ch === '[') {
+            bracket++;
+            cur += ch;
+            continue;
+        }
+        if (ch === ']') {
+            if (bracket > 0)
+                bracket--;
+            cur += ch;
+            continue;
+        }
+        if (ch === '(') {
+            paren++;
+            cur += ch;
+            continue;
+        }
+        if (ch === ')') {
+            if (paren > 0)
+                paren--;
+            cur += ch;
+            continue;
+        }
+        if (ch === sep && bracket === 0 && paren === 0) {
+            out.push(cur);
+            cur = '';
+            continue;
+        }
+        cur += ch;
+    }
+    out.push(cur);
+    return out.map(x => x.trim()).filter(Boolean);
+};
+export function expandSequenceItems(items, pats, insts, _missingWarned, presets) {
+    const out = [];
+    const missingWarned = _missingWarned || new Set();
+    // Normalize items to a string[] early so the rest of the expansion logic
+    // can operate on a consistent type. If items are structured SequenceItem
+    // objects, materialize them first.
+    let itemStrs;
+    // Ensure `items` is a non-empty array before accessing `items[0]`.
+    // Using `Array.isArray` avoids false positives for non-array objects.
+    if (Array.isArray(items) && items.length > 0 && typeof items[0] === 'object') {
+        try {
+            itemStrs = materializeSequenceItems(items);
+        }
+        catch (e) {
+            itemStrs = items.map(String);
+        }
+    }
+    else {
+        itemStrs = items;
+    }
+    for (const it of itemStrs) {
+        if (!it || it.trim() === '')
+            continue;
+        const parts = splitTopLevel(it, ':');
+        const base = parts[0];
+        const mods = parts.slice(1);
+        // Support repetition syntax in sequence items: base may be "name*2" or a group "(A B)*2"
+        let repeat = 1;
+        const mRepBase = base.match(/^(.+?)\*(\d+)$/);
+        let realBase = base;
+        if (mRepBase) {
+            realBase = mRepBase[1];
+            repeat = parseInt(mRepBase[2], 10);
+        }
+        // If this is a parenthesized group, expand inner items recursively
+        let tokens = [];
+        const mGroup = realBase.match(/^\((.*)\)$/s);
+        if (mGroup) {
+            const inner = mGroup[1].trim();
+            const innerParts = inner.match(/[^\s]+/g) || [];
+            tokens = expandSequenceItems(innerParts, pats, insts, missingWarned);
+        }
+        else if (pats[realBase]) {
+            tokens = pats[realBase].slice();
+        }
+        else {
+            tokens = [realBase];
+            // Only warn if realBase is not a known pattern AND not a known instrument
+            const isInstrument = insts && insts[realBase];
+            if (realBase && !missingWarned.has(realBase) && !isInstrument) {
+                missingWarned.add(realBase);
+                warn('sequences', `sequence item '${realBase}' referenced but no pattern named '${realBase}' was found.`);
+            }
+        }
+        const res = applyModsToTokens(tokens, mods, presets);
+        tokens = res.tokens;
+        for (let r = 0; r < repeat; r++) {
+            out.push(...tokens);
+        }
+    }
+    return out;
+}
+export function expandAllSequences(seqs, pats, insts, presets) {
+    const res = {};
+    for (const [name, items] of Object.entries(seqs)) {
+        // items may be an array of strings or structured SequenceItem objects
+        const expanded = expandSequenceItems(items, pats, insts, undefined, presets);
+        res[name] = expanded;
+    }
+    return res;
+}
+export default { expandSequenceItems, expandAllSequences };
+//# sourceMappingURL=expand.js.map

package/dist/sequences/expand.js.map

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

package/dist/song/importResolver.browser.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Browser-safe import resolution for .ins files.
+ * Only supports remote HTTP(S) imports - local file imports are blocked in browser contexts.
+ * This module does NOT import Node.js built-ins (fs, path) to ensure compatibility with browser bundlers.
+ */
+import { AST } from '../parser/ast.js';
+import { RemoteInstrumentCache, RemoteImportOptions } from '../import/remoteCache.js';
+export interface ImportResolverOptions {
+    /** Strict mode: treat instrument name overrides as errors instead of warnings */
+    strictMode?: boolean;
+    /** Warning handler */
+    onWarn?: (message: string, loc?: any) => void;
+    /** Remote import options (timeout, HTTPS-only, etc.) */
+    remoteOptions?: RemoteImportOptions;
+    /** Remote instrument cache (reused across multiple resolve calls) */
+    remoteCache?: RemoteInstrumentCache;
+}
+/**
+ * Resolve all imports in an AST and merge them into the instrument table.
+ * Returns a new AST with merged instruments.
+ * Browser version: Only supports remote imports (HTTP(S), GitHub).
+ */
+export declare function resolveImports(ast: AST, options?: ImportResolverOptions): Promise<AST>;
+/**
+ * Synchronous wrapper - not supported in browser (all remote imports are async).
+ * @deprecated Not available in browser context
+ */
+export declare function resolveImportsSync(_ast: AST, _options?: ImportResolverOptions): AST;
+//# sourceMappingURL=importResolver.browser.d.ts.map

package/dist/song/importResolver.browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"importResolver.browser.d.ts","sourceRoot":"","sources":["../../src/song/importResolver.browser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,GAAG,EAAW,MAAM,kBAAkB,CAAC;AAGhD,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEtF,MAAM,WAAW,qBAAqB;IACpC,iFAAiF;IACjF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,sBAAsB;IACtB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;IAC9C,wDAAwD;IACxD,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,qEAAqE;IACrE,WAAW,CAAC,EAAE,qBAAqB,CAAC;CAKrC;AA2KD;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,GAAG,EACR,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,GAAG,CAAC,CAwBd;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,GAAG,EACT,QAAQ,GAAE,qBAA0B,GACnC,GAAG,CAKL"}

package/dist/song/importResolver.browser.js

@@ -0,0 +1,168 @@
+/**
+ * Browser-safe import resolution for .ins files.
+ * Only supports remote HTTP(S) imports - local file imports are blocked in browser contexts.
+ * This module does NOT import Node.js built-ins (fs, path) to ensure compatibility with browser bundlers.
+ */
+import { isRemoteImport, isLocalImport } from '../import/urlUtils.js';
+import { RemoteInstrumentCache } from '../import/remoteCache.js';
+/**
+ * Validate that an AST contains only allowed node types for .ins files.
+ */
+function validateInsFile(ast, source) {
+    // .ins files should only contain instrument definitions and imports
+    const disallowed = [];
+    // Playback/structure directives
+    if (Object.keys(ast.pats || {}).length > 0)
+        disallowed.push('patterns');
+    if (Object.keys(ast.seqs || {}).length > 0)
+        disallowed.push('sequences');
+    if ((ast.channels || []).length > 0)
+        disallowed.push('channels');
+    if (ast.arranges && Object.keys(ast.arranges).length > 0)
+        disallowed.push('arranges');
+    if (ast.play !== undefined)
+        disallowed.push('play');
+    // Top-level scalar directives (should not be in .ins files)
+    if (ast.chip !== undefined)
+        disallowed.push('chip');
+    if (ast.bpm !== undefined)
+        disallowed.push('bpm');
+    if (ast.volume !== undefined)
+        disallowed.push('volume');
+    // Metadata
+    if (ast.metadata !== undefined && Object.keys(ast.metadata).length > 0) {
+        disallowed.push('metadata');
+    }
+    // Effect definitions
+    if (ast.effects && Object.keys(ast.effects).length > 0)
+        disallowed.push('effects');
+    // Pattern events and structured patterns
+    if (ast.patternEvents && Object.keys(ast.patternEvents).length > 0) {
+        disallowed.push('patternEvents');
+    }
+    if (ast.sequenceItems && Object.keys(ast.sequenceItems).length > 0) {
+        disallowed.push('sequenceItems');
+    }
+    // Check for any other non-standard properties that might be added
+    const allowedKeys = new Set([
+        'insts', 'imports', 'pats', 'seqs', 'channels', 'arranges', 'play',
+        'chip', 'bpm', 'volume', 'metadata', 'effects', 'patternEvents', 'sequenceItems'
+    ]);
+    for (const key of Object.keys(ast)) {
+        if (!allowedKeys.has(key) && key !== 'insts' && key !== 'imports') {
+            disallowed.push(`unknown property '${key}'`);
+        }
+    }
+    if (disallowed.length > 0) {
+        throw new Error(`Invalid .ins file "${source}": .ins files may only contain "inst" and "import" declarations. ` +
+            `Found: ${disallowed.join(', ')}`);
+    }
+}
+/**
+ * Load and parse a remote import file.
+ */
+async function loadRemoteImportFile(url, ctx) {
+    // Check for import cycles
+    if (ctx.importStack.includes(url)) {
+        const cycle = [...ctx.importStack, url].join(' -> ');
+        throw new Error(`Import cycle detected: ${cycle}`);
+    }
+    // Get or create remote cache
+    if (!ctx.remoteCache) {
+        ctx.remoteCache = new RemoteInstrumentCache(ctx.options.remoteOptions);
+    }
+    // Add to import stack
+    ctx.importStack.push(url);
+    try {
+        // Fetch from remote cache (handles caching internally)
+        const instruments = await ctx.remoteCache.fetch(url);
+        return instruments;
+    }
+    finally {
+        // Remove from import stack
+        ctx.importStack.pop();
+    }
+}
+/**
+ * Load and parse an import file (remote only in browser).
+ */
+async function loadImportFile(importSource, ctx) {
+    // Block local imports in browser
+    if (isLocalImport(importSource)) {
+        throw new Error(`Local imports are not supported in the browser for security reasons. ` +
+            `Import "${importSource}" cannot be loaded. ` +
+            `Use remote imports (https:// or github:) instead.`);
+    }
+    // Only remote imports are supported in browser
+    if (!isRemoteImport(importSource)) {
+        throw new Error(`Invalid import "${importSource}": Browser environment only supports remote imports. ` +
+            `Use "https://", "http://", or "github:" prefix for remote imports. ` +
+            `Local file imports require CLI environment.`);
+    }
+    return await loadRemoteImportFile(importSource, ctx);
+}
+/**
+ * Merge instrument maps with last-win semantics.
+ */
+function mergeInstruments(base, override, sourcePath, ctx) {
+    const result = { ...base };
+    for (const [name, inst] of Object.entries(override)) {
+        if (result[name] !== undefined) {
+            const message = `Instrument "${name}" from "${sourcePath}" overrides previously defined instrument`;
+            if (ctx.options.strictMode) {
+                throw new Error(message);
+            }
+            else if (ctx.options.onWarn) {
+                ctx.options.onWarn(message);
+            }
+        }
+        result[name] = inst;
+    }
+    return result;
+}
+/**
+ * Process all imports in an AST and return merged instruments.
+ */
+async function processImports(ast, ctx) {
+    let mergedInsts = {};
+    if (!ast.imports || ast.imports.length === 0) {
+        return mergedInsts;
+    }
+    for (const imp of ast.imports) {
+        const importedInsts = await loadImportFile(imp.source, ctx);
+        // Merge imported instruments (later imports override earlier ones)
+        mergedInsts = mergeInstruments(mergedInsts, importedInsts, imp.source, ctx);
+    }
+    return mergedInsts;
+}
+/**
+ * Resolve all imports in an AST and merge them into the instrument table.
+ * Returns a new AST with merged instruments.
+ * Browser version: Only supports remote imports (HTTP(S), GitHub).
+ */
+export async function resolveImports(ast, options = {}) {
+    const ctx = {
+        importStack: [],
+        options,
+        remoteCache: options.remoteCache,
+    };
+    // Process imports
+    const importedInsts = await processImports(ast, ctx);
+    // Merge imported instruments with local instruments (local overrides imported)
+    const finalInsts = mergeInstruments(importedInsts, ast.insts || {}, '<main>', ctx);
+    // Return new AST with merged instruments and cleared imports
+    return {
+        ...ast,
+        insts: finalInsts,
+        imports: [], // Clear imports to prevent double-resolution
+    };
+}
+/**
+ * Synchronous wrapper - not supported in browser (all remote imports are async).
+ * @deprecated Not available in browser context
+ */
+export function resolveImportsSync(_ast, _options = {}) {
+    throw new Error('resolveImportsSync is not available in browser context. ' +
+        'Use resolveImports() (async) instead for remote imports.');
+}
+//# sourceMappingURL=importResolver.browser.js.map

package/dist/song/importResolver.browser.js.map

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

package/dist/song/importResolver.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Import resolution for .ins files.
+ * Handles loading, caching, cycle detection, and merging of instrument definitions.
+ * Supports both local file imports and remote HTTP(S) imports.
+ */
+import { AST } from '../parser/ast.js';
+import { RemoteInstrumentCache, RemoteImportOptions } from '../import/remoteCache.js';
+export interface ImportResolverOptions {
+    /** Base file path for resolving relative imports */
+    baseFilePath?: string;
+    /** Additional search paths for resolving imports */
+    searchPaths?: string[];
+    /** Strict mode: treat instrument name overrides as errors instead of warnings */
+    strictMode?: boolean;
+    /** Warning handler */
+    onWarn?: (message: string, loc?: any) => void;
+    /** File system reader for testing */
+    readFile?: (filePath: string) => string;
+    /** File existence checker for testing */
+    fileExists?: (filePath: string) => boolean;
+    /** Allow absolute paths in imports (disabled by default for security) */
+    allowAbsolutePaths?: boolean;
+    /** Remote import options (timeout, HTTPS-only, etc.) */
+    remoteOptions?: RemoteImportOptions;
+    /** Remote instrument cache (reused across multiple resolve calls) */
+    remoteCache?: RemoteInstrumentCache;
+}
+/**
+ * Resolve all imports in an AST and merge them into the instrument table.
+ * Returns a new AST with merged instruments.
+ * Supports both local file imports and remote HTTP(S) imports.
+ */
+export declare function resolveImports(ast: AST, options?: ImportResolverOptions): Promise<AST>;
+/**
+ * Synchronous wrapper for resolveImports for backward compatibility.
+ * Does not support remote imports - throws an error if remote imports are encountered.
+ * @deprecated Use resolveImports (async) instead
+ */
+export declare function resolveImportsSync(ast: AST, options?: ImportResolverOptions): AST;
+//# sourceMappingURL=importResolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"importResolver.d.ts","sourceRoot":"","sources":["../../src/song/importResolver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,GAAG,EAAW,MAAM,kBAAkB,CAAC;AAKhD,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEtF,MAAM,WAAW,qBAAqB;IACpC,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,iFAAiF;IACjF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,sBAAsB;IACtB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;IAC9C,qCAAqC;IACrC,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;IACxC,yCAAyC;IACzC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;IAC3C,yEAAyE;IACzE,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,wDAAwD;IACxD,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,qEAAqE;IACrE,WAAW,CAAC,EAAE,qBAAqB,CAAC;CACrC;AA6ZD;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,GAAG,EACR,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,GAAG,CAAC,CA0Bd;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,GAAG,EACR,OAAO,GAAE,qBAA0B,GAClC,GAAG,CA8BL"}