@devaloop/devalang 0.0.1-alpha.9 → 0.0.1-beta.2

package/examples/bank.deva

@@ -0,0 +1,7 @@
+# This file demonstrates the use of banks in Devalang.
+
+bank devaloop.808 as myBank
+
+.myBank.kick auto
+.myBank.snare auto
+.myBank.openhat auto

package/examples/bus.deva

@@ -0,0 +1,10 @@
+# NOTE Planned for future release
+
+# let sidechainBus = bus {
+#     fx: [
+#         { type: "compressor", threshold: -20, ratio: 8, attack: 5, release: 100,
+#           sidechain: myKick }
+#     ]
+# }
+# route myLead -> sidechainBus -> masterBus
+# route myKick -> myBass -> masterBus

package/examples/duration.deva

@@ -0,0 +1,9 @@
+# This file demonstrates the use of duration in Devalang.
+
+@load "./samples/kick-808.wav" as kickCustom
+@load "./samples/hat-808.wav" as hatCustom
+
+.kickCustom 1/4
+.hatCustom 1/8
+.kickCustom 1/4
+.hatCustom 1/8

package/examples/effect.deva

@@ -0,0 +1,2 @@
+# NOTE Planned for future release
+# myChord -> note(C4) -> arp({ pattern: "up", rate: 1/8 }) -> slide({ duration: 2000 }) -> echo({ delay: 250, feedback: 0.5 }) -> reverb({ room_size: 0.8 })

package/examples/events.deva

@@ -0,0 +1,12 @@
+bpm 120
+
+on beat:
+    print "kick on each beat"
+
+on bar:
+    print "bar!"
+
+on custom(value):
+    print "custom event with value: " + value
+
+emit custom(10)

package/examples/filter.deva

@@ -0,0 +1,11 @@
+let myFilteredSynth = synth sine {
+    filters: [
+        { type: "lowpass", cutoff: 800.0, resonance: 1.0 },
+        { type: "bandpass", cutoff: 400.0, resonance: 1.0 },
+        { type: "highpass", cutoff: 200.0, resonance: 1.0 }
+    ],
+}
+
+myFilteredSynth -> note(C4, { duration: 500 })
+myFilteredSynth -> note(E4, { duration: 500 })
+myFilteredSynth -> note(G4, { duration: 500 })

package/examples/function.deva

@@ -0,0 +1,15 @@
+# This file demonstrates the use of main features in Devalang.
+bpm 135
+
+bank devaloop.808 as myBank
+
+let entityTest1 = .myBank.kick auto
+let entityTest2 = .myBank.clap auto
+let entityTest3 = .myBank.snare auto
+
+fn myFirstGroup(entity1, entity2, entity3):
+    .entity1
+    .entity2
+    .entity3
+
+call myFirstGroup(entityTest1, entityTest2, entityTest3)

package/examples/index.deva

@@ -1,18 +1,63 @@
-# This file demonstrates the use of main features in Devalang.
+# This file demonstrates general use cases of Devalang.
 
-@import { duration, default_bank, params, loopCount, tempo } from "./variables.deva"
-@import { myLead } from "./synth.deva"
-@import { myLoop } from "./loop.deva"
+# BPM definition
+bpm 125
 
-@load "./samples/kick-808.wav" as kickCustom
-@load "./samples/hat-808.wav" as hatCustom
+# Bank picking (make sure you've installed it)
+bank devaloop.808 as my808Bank
 
-bpm tempo
+# Pattern literal without options
+pattern kickPattern with my808Bank.kick = "x--- x--- x--- x---"
 
-bank default_bank
+group myGroup:
+    # Rhythmic (each beat playing a kick)
+    # on beat:
+    #     .my808Bank.kick 1/4
 
-group myTrack:
-    spawn myLoop
-    spawn myLead
+    # Synth definition with ADSR
+    let myLead = synth sine {
+        attack: 0,
+        decay: 100,
+        sustain: 100,
+        release: 100
+    }
 
-call myTrack
+    # Global automation
+    automate myLead:
+        param volume {
+            0% = 0.0
+            100% = 0.5
+        }
+        param pitch {
+            0% = -12.0
+            100% = 12.0
+        }
+
+    # Notes in a loop with condition
+    for i in [1, 2, 3]:
+        if i == 3:
+            myLead -> note(C5, { duration: 200 })
+            print "Playing note C5 for " + i
+
+    # Pause runtime for 500ms
+    sleep 500
+
+    # Note with automation
+    myLead -> note(C4, {
+        duration: 400,
+        velocity: 0.8,
+        automate: {
+            pan: {
+                0%: -1.0,
+                100%: 0.0
+            }
+        }
+    })
+
+    # Notes with params
+    myLead -> note(G4, { duration: 600, glide: true, target_freq: 659.25 })
+    myLead -> note(B3, { duration: 400, slide: true, target_amp: 0.3 })
+
+# Spawning the group & the pattern to play them in parallel
+spawn myGroup
+spawn kickPattern

package/examples/lfo.deva

@@ -0,0 +1,9 @@
+let myLFOSynth = synth sine {
+    lfo: {
+        rate: 1/4,
+        depth: 0.5,
+        target: "cutoff"
+    }
+}
+
+myLFOSynth -> note(C4, { duration: 500 })

package/examples/loop.deva

@@ -1,17 +1,10 @@
-# This file demonstrates the use of a loop in Devalang.
-
-@import { duration, default_bank, params, loopCount, tempo } from "./variables.deva"
-
-@load "./samples/kick-808.wav" as kickCustom
-@load "./samples/hat-808.wav" as hatCustom
+# This file demonstrates the use of loops in Devalang.
 
 group myLoop:
-    loop loopCount:
-        .kickCustom duration params
-
-        # Uncomment the next line (.hat) while executing "play" command
-        # with `--repeat` option to see magic happen !
+    for i in [1, 2, 3]:
+        print "looping with for" + i
 
-        .hatCustom duration params
+    loop 3:
+        print "looping with loop"
 
 @export { myLoop }

package/examples/pattern.deva

@@ -0,0 +1,8 @@
+# This file demonstrates the usage of patterns in Devaloop
+
+bank devaloop.808 as my808
+
+# Pattern literal without options
+pattern kickPattern with my808.kick = "x--- x--- x--- x---"
+
+call kickPattern

package/examples/plugin.deva

@@ -0,0 +1,16 @@
+# This is an example of using a plugin in Devalang.
+# Make sure you have the plugin installed in your Devaloop application. (devalang install plugin <author>.<plugin_name>)
+
+@use devaloop.acid as acidPlugin
+
+let acidSynth = synth acidPlugin.synth {
+    waveform: "saw",
+    accent: 0.1,
+    decay: 250
+}
+
+group mySynthGroup:
+    acidSynth -> note(C4, { duration: 600 })
+    acidSynth -> note(E4, { duration: 600 })
+
+call mySynthGroup

package/examples/synth.deva

@@ -11,4 +11,14 @@ group myLead:
     mySynth -> note(D4, { duration: 400 })
     mySynth -> note(B3, { duration: 600 })
 
-@export { myLead }
+group myChords:
+    let chordSynth = synth square
+    
+    chordSynth -> chord(Cmaj, { duration: 1600 })
+    chordSynth -> chord(Fmaj, { duration: 1600 })
+    chordSynth -> chord(Gmaj, { duration: 1600 })
+    chordSynth -> chord(Am, { duration: 1600 })
+
+# Play both groups together
+spawn myLead
+spawn myChords

package/examples/synth_types.deva

@@ -0,0 +1,17 @@
+let myPad = synth sine {
+    type: "pad"
+}
+
+let myPluck = synth sine {
+    type: "pluck"
+}
+
+let myArp = synth sine {
+    type: "arp",
+    rate: 16,
+    step: 2
+}
+
+let mySub = synth sine {
+    type: "sub",
+}

package/examples/variables.deva

@@ -1,7 +1,7 @@
 # This file only exports variables for use in other files.
 
 let duration = auto
-let default_bank = 808
+let default_bank = devaloop.808
 let params = { decay: 10, delay: 30 }
 let loopCount = 5
 let tempo = 115

package/out-tsc/bin/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/out-tsc/bin/index.js

@@ -1,13 +1,57 @@
 #!/usr/bin/env node
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 const child_process_1 = require("child_process");
-const path_1 = __importDefault(require("path"));
-const binaryPath = path_1.default.join(__dirname, "devalang.exe");
-const subCommand = process.argv[2] || "help";
+const path = __importStar(require("path"));
+let binaryName;
+switch (process.platform) {
+    case "win32":
+        binaryName = "devalang-x86_64-pc-windows-msvc.exe";
+        break;
+    case "darwin":
+        binaryName = "devalang-x86_64-apple-darwin";
+        break;
+    case "linux":
+        binaryName = "devalang-x86_64-unknown-linux-gnu";
+        break;
+    default:
+        console.error(`Unsupported platform: ${process.platform}`);
+        process.exit(1);
+}
+const binaryPath = path.join(__dirname, binaryName);
 const args = process.argv.slice(2);
 const child = (0, child_process_1.spawn)(binaryPath, args, { stdio: "inherit" });
-child.on("exit", (code) => process.exit(code));
+child.on("exit", (code) => process.exit(code !== null && code !== void 0 ? code : 1));

package/out-tsc/core/functions/index.d.ts

@@ -0,0 +1,42 @@
+import { ParseResult } from "../types/result";
+import { DebugResult } from "../types/result";
+/**
+ * Parses the user code.
+ * @param entry_path The entry path for the code.
+ * @param source The source code to parse.
+ * @returns ParseResult | any
+ */
+export declare function parse(entry_path: string, source: string): ParseResult | any;
+/**
+ * Renders the debug information for the user code.
+ * @param user_code The user-provided code to render debug information for.
+ * @returns DebugResult | any
+ */
+export declare function debug_render(user_code: string): DebugResult | any;
+/**
+ * Renders audio from the user code.
+ * @param user_code The user-provided code to render audio from.
+ * @returns Float32Array
+ */
+export declare function render_audio(user_code: string): Float32Array;
+/**
+ * Register a JS callback to receive playhead events { time, line, column } during playback.
+ * The callback will be called with a single object argument.
+ * @param cb The callback function to register.
+ * @returns void
+ */
+export declare function register_playhead_callback(cb: (ev: {
+    time: number;
+    line: number;
+    column: number;
+}) => void): any;
+/**
+ * Collects playhead events that have been recorded during playback.
+ * @returns Array of playhead events { time, line, column }.
+ */
+export declare function collect_playhead_events(): any;
+/**
+ * Unregisters the JS callback for playhead events.
+ * @returns void
+ */
+export declare function unregister_playhead_callback(): any;

package/out-tsc/core/functions/index.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parse = parse;
+exports.debug_render = debug_render;
+exports.render_audio = render_audio;
+exports.register_playhead_callback = register_playhead_callback;
+exports.collect_playhead_events = collect_playhead_events;
+exports.unregister_playhead_callback = unregister_playhead_callback;
+let wasmPkg = undefined;
+try {
+    // prefer runtime pkg generated by wasm-pack when available
+    // require at runtime so the package can be used even if wasm hasn't been built
+    // (this keeps tests and consumers robust).
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    wasmPkg = require("../../pkg/devalang_core");
+}
+catch (_e) {
+    wasmPkg = undefined;
+}
+/**
+ * Parses the user code.
+ * @param entry_path The entry path for the code.
+ * @param source The source code to parse.
+ * @returns ParseResult | any
+ */
+function parse(entry_path, source) {
+    if (wasmPkg && typeof wasmPkg.parse === "function") {
+        return wasmPkg.parse(entry_path, source);
+    }
+    throw new Error("WASM binding 'parse' not available. Build the wasm package or use the JS runtime.");
+}
+/**
+ * Renders the debug information for the user code.
+ * @param user_code The user-provided code to render debug information for.
+ * @returns DebugResult | any
+ */
+function debug_render(user_code) {
+    if (wasmPkg && typeof wasmPkg.debug_render === "function") {
+        return wasmPkg.debug_render(user_code);
+    }
+    throw new Error("WASM binding 'debug_render' not available. Build the wasm package or use the JS runtime.");
+}
+/**
+ * Renders audio from the user code.
+ * @param user_code The user-provided code to render audio from.
+ * @returns Float32Array
+ */
+function render_audio(user_code) {
+    if (wasmPkg && typeof wasmPkg.render_audio === "function") {
+        return wasmPkg.render_audio(user_code);
+    }
+    // Fallback: indicate missing wasm with an empty buffer rather than breaking consumers.
+    return new Float32Array(0);
+}
+/**
+ * Register a JS callback to receive playhead events { time, line, column } during playback.
+ * The callback will be called with a single object argument.
+ * @param cb The callback function to register.
+ * @returns void
+ */
+function register_playhead_callback(cb) {
+    if (wasmPkg && typeof wasmPkg.register_playhead_callback === "function") {
+        return wasmPkg.register_playhead_callback(cb);
+    }
+    // no-op fallback
+    return;
+}
+/**
+ * Collects playhead events that have been recorded during playback.
+ * @returns Array of playhead events { time, line, column }.
+ */
+function collect_playhead_events() {
+    if (wasmPkg && typeof wasmPkg.collect_playhead_events === "function") {
+        return wasmPkg.collect_playhead_events();
+    }
+    return [];
+}
+/**
+ * Unregisters the JS callback for playhead events.
+ * @returns void
+ */
+function unregister_playhead_callback() {
+    if (wasmPkg && typeof wasmPkg.unregister_playhead_callback === "function") {
+        return wasmPkg.unregister_playhead_callback();
+    }
+    return;
+}

package/out-tsc/core/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Core functionality for the Devalang language.
+ * This module exports all the core types and functions used in the language.
+ */
+export * from "./types/index";
+export * from "./functions/index";

package/out-tsc/core/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Core functionality for the Devalang language.
+ * This module exports all the core types and functions used in the language.
+ */
+__exportStar(require("./types/index"), exports);
+__exportStar(require("./functions/index"), exports);

package/out-tsc/core/types/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./result";
+export * from "./statement";
+export * from "./value";
+export * from "./plugin";

package/out-tsc/core/types/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./result"), exports);
+__exportStar(require("./statement"), exports);
+__exportStar(require("./value"), exports);
+__exportStar(require("./plugin"), exports);

package/out-tsc/core/types/plugin.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Represents a plugin export.
+ */
+export interface PluginExport {
+    name: string;
+    kind: string;
+    default?: any;
+}
+/**
+ * Represents a plugin.
+ */
+export interface PluginInfo {
+    author: string;
+    name: string;
+    version?: string;
+    description?: string;
+    exports: PluginExport[];
+}

package/out-tsc/core/types/plugin.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/out-tsc/core/types/result.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Represents an error that occurred during parsing.
+ */
+export interface ErrorResult {
+    message: string;
+    line: number;
+    column: number;
+}
+/**
+ * Represents the result of parsing user code.
+ */
+export interface ParseResult {
+    ok: boolean;
+    ast: string;
+    errors: ErrorResult[];
+}
+/**
+ * Represents the result of debugging user code.
+ */
+export interface DebugResult {
+    samples_len: number;
+    any_nonzero: boolean;
+    ast: string;
+    note_count: number;
+    global_vars: string[];
+    statements_count: number;
+}

package/out-tsc/core/types/result.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });