@devaloop/devalang 0.0.1-alpha.8 → 0.0.1-beta.1

package/examples/condition.deva

@@ -1,24 +1,20 @@
 # This file demonstrates the use of conditional blocks in Devalang.
 
-@import { myGroup } from "./examples/group.deva"
+@import { duration, default_bank, params, loopCount, tempo } from "./variables.deva"
+@import { myGroup } from "./group.deva"
 
-@load "./examples/samples/kick-808.wav" as kickCustom
-@load "./examples/samples/hat-808.wav" as hatCustom
+@load "./samples/kick-808.wav" as kickCustom
+@load "./samples/hat-808.wav" as hatCustom
 
 group conditionBlock:
     if tempo > 120:
         # Will be executed if the condition is true
-        .kickCustom
+        .kickCustom auto
     else if tempo > 155:
         # Will be executed if the condition is false
-        .hatCustom
+        .hatCustom auto
     else:
-        # Following lines will be executed if the condition is neither true or false
-        
-        # This will call myGroup sequentially (in the main thread)
-        call myGroup
-
-        # This will spawn a group in parallel to the main thread (kick + hat simultaneously)
-        # spawn myGroup
+        .kickCustom auto
+        .hatCustom auto
 
 @export { conditionBlock }

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/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/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/group.deva

@@ -1,9 +1,9 @@
 # This file demonstrates the use of grouping in Devalang.
 
-@import { duration, default_bank, params, loopCount, tempo } from "./examples/variables.deva"
+@import { duration, default_bank, params, loopCount, tempo } from "./variables.deva"
 
-@load "./examples/samples/kick-808.wav" as kickCustom
-@load "./examples/samples/hat-808.wav" as hatCustom
+@load "./samples/kick-808.wav" as kickCustom
+@load "./samples/hat-808.wav" as hatCustom
 
 group myGroup:
     .kickCustom duration params

package/examples/index.deva

@@ -1,16 +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 "./examples/variables.deva"
-@import { conditionBlock } from "./examples/condition.deva"
-@import { myGroup } from "./examples/group.deva"
+# BPM definition
+bpm 125
 
+# Bank picking (make sure you've installed it)
+bank devaloop.808 as my808Bank
 
-@load "./examples/samples/kick-808.wav" as kickCustom
-@load "./examples/samples/hat-808.wav" as hatCustom
+# Pattern literal without options
+pattern kickPattern with my808Bank.kick = "x--- x--- x--- x---"
 
-bpm tempo
+group myGroup:
+    # Rhythmic (each beat playing a kick)
+    # on beat:
+    #     .my808Bank.kick 1/4
 
-bank default_bank
+    # Synth definition with ADSR
+    let myLead = synth sine {
+        attack: 0,
+        decay: 100,
+        sustain: 100,
+        release: 100
+    }
 
-# This will call the group sequentially (line by line)
-call conditionBlock
+    # 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/loop.deva

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

@@ -0,0 +1,14 @@
+# This file defines a simple synth lead using Devalang's syntax.
+
+group myLead:
+    let mySynth = synth sine
+    
+    mySynth -> note(C4, { duration: 400 })
+    mySynth -> note(G4, { duration: 400 })
+    mySynth -> note(E4, { duration: 600 })
+    mySynth -> note(A4, { duration: 400 })
+    mySynth -> note(F4, { duration: 800 })
+    mySynth -> note(D4, { duration: 400 })
+    mySynth -> note(B3, { duration: 600 })
+
+@export { myLead }

package/examples/variables.deva

@@ -1,8 +1,8 @@
 # This file only exports variables for use in other files.
 
 let duration = auto
-let default_bank = 808
-let params = {decay:10, delay:30}
+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,37 @@
+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;
+/**
+ * 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,76 @@
+"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.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;
+}
+/**
+ * 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 });

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

@@ -0,0 +1,106 @@
+import { Value, Duration } from "./value";
+/**
+ * Represents a statement kind in the code.
+ */
+export type StatementKind = {
+    kind: "Tempo";
+} | {
+    kind: "Bank";
+    alias?: string;
+} | {
+    kind: "Print";
+} | {
+    kind: "Load";
+    source: string;
+    alias: string;
+} | {
+    kind: "Use";
+    name: string;
+    alias?: string;
+} | {
+    kind: "Let";
+    name: string;
+} | {
+    kind: "Automate";
+    target: string;
+} | {
+    kind: "ArrowCall";
+    target: string;
+    method: string;
+    args: Value[];
+} | {
+    kind: "Function";
+    name: string;
+    parameters: string[];
+    body: Statement[];
+} | {
+    kind: "Synth";
+} | {
+    kind: "Trigger";
+    entity: string;
+    duration: Duration;
+    effects?: Value;
+} | {
+    kind: "Sleep";
+} | {
+    kind: "Call";
+    name: string;
+    args: Value[];
+} | {
+    kind: "Spawn";
+    name: string;
+    args: Value[];
+} | {
+    kind: "Loop";
+} | {
+    kind: "Group";
+} | {
+    kind: "Include";
+    path: string;
+} | {
+    kind: "Export";
+    names: string[];
+    source: string;
+} | {
+    kind: "Import";
+    names: string[];
+    source: string;
+} | {
+    kind: "If";
+} | {
+    kind: "Else";
+} | {
+    kind: "ElseIf";
+} | {
+    kind: "Comment";
+} | {
+    kind: "Indent";
+} | {
+    kind: "Dedent";
+} | {
+    kind: "NewLine";
+} | {
+    kind: "On";
+    event: string;
+    args?: Value[];
+    body: Statement[];
+} | {
+    kind: "Emit";
+    event: string;
+    payload?: Value;
+} | {
+    kind: "Unknown";
+} | {
+    kind: "Error";
+    message: string;
+};
+/**
+ * Represents a statement in the code.
+ */
+export interface Statement {
+    kind: StatementKind;
+    value: Value;
+    indent: number;
+    line: number;
+    column: number;
+}

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

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