@beatbax/engine 0.1.0

package/dist/tests/refExpander.test.js

@@ -0,0 +1,37 @@
+import { applyModsToTokens } from '../expand/refExpander.js';
+describe('applyModsToTokens', () => {
+    test('octave and semitone transposition', () => {
+        const base = ['C4', 'E4', 'G4'];
+        const res = applyModsToTokens(base, ['oct(-1)', '+12']);
+        // oct(-1) should lower octave by 1 (C3,E3,G3), then +12 semitones brings back to C4 etc.
+        expect(res.tokens).toEqual(['C4', 'E4', 'G4']);
+    });
+    test('rev reversal', () => {
+        const base = ['A', 'B', 'C'];
+        const res = applyModsToTokens(base, ['rev']);
+        expect(res.tokens).toEqual(['C', 'B', 'A']);
+    });
+    test('slow repeats tokens', () => {
+        const base = ['X', 'Y'];
+        const res = applyModsToTokens(base, ['slow(3)']);
+        expect(res.tokens).toEqual(['X', 'X', 'X', 'Y', 'Y', 'Y']);
+    });
+    test('fast takes every nth token', () => {
+        const base = ['a', 'b', 'c', 'd', 'e', 'f'];
+        const res = applyModsToTokens(base, ['fast(2)']);
+        expect(res.tokens).toEqual(['a', 'c', 'e']);
+    });
+    test('inst override and pan', () => {
+        const base = ['note1', 'note2'];
+        const res = applyModsToTokens(base, ['inst(bass)', 'pan(L)']);
+        // inst override should be prepended, pan should wrap with pan() at end
+        expect(res.tokens[0]).toBe('inst(bass)');
+        expect(res.tokens[res.tokens.length - 1]).toBe('pan()');
+    });
+    test('no-op when base missing tokens', () => {
+        const base = [];
+        const res = applyModsToTokens(base, ['oct(1)']);
+        expect(Array.isArray(res.tokens)).toBe(true);
+    });
+});
+//# sourceMappingURL=refExpander.test.js.map

package/dist/tests/refExpander.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refExpander.test.js","sourceRoot":"","sources":["../../src/tests/refExpander.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,IAAI,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC7C,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAChC,MAAM,GAAG,GAAG,iBAAiB,CAAC,IAAI,EAAE,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;QACxD,yFAAyF;QACzF,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,cAAc,EAAE,GAAG,EAAE;QACxB,MAAM,IAAI,GAAG,CAAC,GAAG,EAAC,GAAG,EAAC,GAAG,CAAC,CAAC;QAC3B,MAAM,GAAG,GAAG,iBAAiB,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7C,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAC,GAAG,EAAC,GAAG,CAAC,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,qBAAqB,EAAE,GAAG,EAAE;QAC/B,MAAM,IAAI,GAAG,CAAC,GAAG,EAAC,GAAG,CAAC,CAAC;QACvB,MAAM,GAAG,GAAG,iBAAiB,CAAC,IAAI,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;QACjD,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,CAAC,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACtC,MAAM,IAAI,GAAG,CAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,CAAC,CAAC;QACvC,MAAM,GAAG,GAAG,iBAAiB,CAAC,IAAI,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;QACjD,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAC,GAAG,EAAC,GAAG,CAAC,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,uBAAuB,EAAE,GAAG,EAAE;QACjC,MAAM,IAAI,GAAG,CAAC,OAAO,EAAC,OAAO,CAAC,CAAC;QAC/B,MAAM,GAAG,GAAG,iBAAiB,CAAC,IAAI,EAAE,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC9D,uEAAuE;QACvE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACzC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,gCAAgC,EAAE,GAAG,EAAE;QAC1C,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,MAAM,GAAG,GAAG,iBAAiB,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;QAChD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/util/diag.d.ts

@@ -0,0 +1,16 @@
+import { SourceLocation } from '../parser/ast.js';
+export type DiagLevel = 'WARN' | 'ERROR' | 'INFO';
+export interface DiagMeta {
+    file?: string;
+    loc?: SourceLocation | null;
+}
+export declare function formatDiagnostic(level: DiagLevel, component: string, message: string, meta?: DiagMeta): string;
+export declare function warn(component: string, message: string, meta?: DiagMeta): void;
+export declare function error(component: string, message: string, meta?: DiagMeta): void;
+declare const _default: {
+    formatDiagnostic: typeof formatDiagnostic;
+    warn: typeof warn;
+    error: typeof error;
+};
+export default _default;
+//# sourceMappingURL=diag.d.ts.map

package/dist/util/diag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diag.d.ts","sourceRoot":"","sources":["../../src/util/diag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAElD,MAAM,WAAW,QAAQ;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;CAC7B;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,QAAQ,UAkBrG;AAED,wBAAgB,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,QAAQ,QAEvE;AAED,wBAAgB,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,QAAQ,QAExE;;;;;;AAED,wBAAiD"}

package/dist/util/diag.js

@@ -0,0 +1,29 @@
+export function formatDiagnostic(level, component, message, meta) {
+    const lvl = level || 'WARN';
+    const comp = component || 'unknown';
+    let parts = [];
+    parts.push(`[${lvl}]`);
+    parts.push(`[${comp}]`);
+    parts.push(message);
+    const fields = [];
+    if (meta) {
+        if (meta.file)
+            fields.push(`file=${meta.file}`);
+        if (meta.loc && meta.loc.start && typeof meta.loc.start.line === 'number') {
+            const col = meta.loc.start.column || 0;
+            fields.push(`line=${meta.loc.start.line}`);
+            fields.push(`column=${col}`);
+        }
+    }
+    if (fields.length)
+        parts.push(fields.join(', '));
+    return parts.join(' ');
+}
+export function warn(component, message, meta) {
+    console.warn(formatDiagnostic('WARN', component, message, meta));
+}
+export function error(component, message, meta) {
+    console.error(formatDiagnostic('ERROR', component, message, meta));
+}
+export default { formatDiagnostic, warn, error };
+//# sourceMappingURL=diag.js.map

package/dist/util/diag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diag.js","sourceRoot":"","sources":["../../src/util/diag.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,gBAAgB,CAAC,KAAgB,EAAE,SAAiB,EAAE,OAAe,EAAE,IAAe;IACpG,MAAM,GAAG,GAAG,KAAK,IAAI,MAAM,CAAC;IAC5B,MAAM,IAAI,GAAG,SAAS,IAAI,SAAS,CAAC;IACpC,IAAI,KAAK,GAAa,EAAE,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC;IACvB,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC;IACxB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpB,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,IAAI,EAAE,CAAC;QACT,IAAI,IAAI,CAAC,IAAI;YAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAChD,IAAI,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC1E,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;YACvC,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAC3C,MAAM,CAAC,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IACD,IAAI,MAAM,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACjD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,SAAiB,EAAE,OAAe,EAAE,IAAe;IACtE,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,SAAiB,EAAE,OAAe,EAAE,IAAe;IACvE,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,eAAe,EAAE,gBAAgB,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC"}

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "@beatbax/engine",
+  "version": "0.1.0",
+  "description": "Live-coding language and runtime for retro console chiptunes - chipset engine",
+  "private": false,
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "keywords": [
+    "chiptune",
+    "gameboy",
+    "music",
+    "audio",
+    "synthesis",
+    "live-coding",
+    "apu",
+    "tracker",
+    "hugetracker",
+    "uge"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kadraman/beatbax.git",
+    "directory": "packages/engine"
+  },
+  "license": "MIT",
+  "author": "BeatBax Contributors",
+  "homepage": "https://github.com/kadraman/beatbax#readme",
+  "exports": {
+    ".": "./dist/index.js",
+    "./*": "./dist/*.js",
+    "./parser": "./dist/parser/index.js",
+    "./parser/*": "./dist/parser/*.js",
+    "./parser/index": "./dist/parser/index.js",
+    "./parser/index.js": "./dist/parser/index.js",
+    "./export": "./dist/export/index.js",
+    "./export/*": "./dist/export/*.js",
+    "./import": "./dist/import/index.js",
+    "./import/*": "./dist/import/*.js",
+    "./song": {
+      "browser": "./dist/song/index.browser.js",
+      "default": "./dist/song/index.js"
+    },
+    "./song/resolver": {
+      "browser": "./dist/song/resolver.browser.js",
+      "default": "./dist/song/resolver.js"
+    },
+    "./song/importResolver": {
+      "browser": "./dist/song/importResolver.browser.js",
+      "default": "./dist/song/importResolver.js"
+    },
+    "./song/*": "./dist/song/*.js",
+    "./audio": "./dist/audio/index.js",
+    "./audio/*": "./dist/audio/*.js",
+    "./chips": "./dist/chips/index.js",
+    "./chips/*": "./dist/chips/*.js",
+    "./patterns": "./dist/patterns/index.js",
+    "./patterns/*": "./dist/patterns/*.js",
+    "./sequences": "./dist/sequences/index.js",
+    "./sequences/*": "./dist/sequences/*.js",
+    "./instruments": "./dist/instruments/index.js",
+    "./instruments/*": "./dist/instruments/*.js",
+    "./scheduler": "./dist/scheduler/index.js",
+    "./scheduler/*": "./dist/scheduler/*.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "clean": "rimraf dist",
+    "generate:peggy": "node ./scripts/generate-peggy-parser.cjs",
+    "prebuild": "npm run generate:peggy",
+    "build": "tsc -b",
+    "dev": "tsc --watch",
+    "pretest": "npm run build --if-present",
+    "test": "jest --config ./jest.config.cjs --passWithNoTests"
+  },
+  "dependencies": {
+    "standardized-audio-context": "^25.3.0"
+  },
+  "devDependencies": {
+    "peggy": "^4.2.0"
+  }
+}