@devaloop/devalang 0.0.1-alpha.14 → 0.0.1-alpha.15

package/.devalang

@@ -1,8 +1,8 @@
-[defaults]
-entry = "./examples"
-output = "./output"
-watch = false
-
-[[banks]]
-path = "devalang://bank/devaloop.808"
-version = "0.0.2"
+[defaults]
+entry = "./examples"
+output = "./output"
+watch = false
+
+[[banks]]
+path = "devalang://bank/devaloop.808"
+version = "0.0.2"

package/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "devalang"
-version = "0.0.1-alpha.14"
+version = "0.0.1-alpha.15"
 authors = ["Devaloop <contact@devaloop.com>"]
 description = "Write music like code. Devalang is a domain-specific language (DSL) for sound designers and music hackers. Compose, automate, and control sound — in plain text."
 license = "MIT"
@@ -10,7 +10,6 @@ categories = ["command-line-utilities", "development-tools", "parser-implementat
 readme = "README.md"
 homepage = "https://devalang.com"
 documentation = "https://docs.devalang.com/"
-license-file = "LICENSE"
 edition = "2024"
 
 [[bin]]
@@ -19,6 +18,7 @@ path = "rust/main.rs"
 required-features = ["cli"]
 
 [lib]
+name = "devalang_core"
 path = "rust/lib.rs"
 crate-type = ["cdylib", "rlib"]
 

package/README.md

@@ -65,31 +65,48 @@ Create a new Devalang file `src/index.deva` in the project directory:
 ```deva
 # src/index.deva
 
-group myLead:
-    let mySynth = synth sine {
+group main:
+    let lead = synth sine {
         attack: 0,
         decay: 100,
         sustain: 100,
         release: 100
     }
 
-    mySynth -> note(C4, {
+    # Global automation for this synth (applies to subsequent notes)
+    automate lead:
+        param volume {
+            0% = 0.0
+            100% = 1.0
+        }
+        param pan {
+            0% = -1.0
+            100% = 1.0
+        }
+        param pitch {
+            0% = -12.0
+            100% = 12.0
+        }
+
+    lead -> note(C4, {
         duration: 400,
-        velocity: 0.7,
-        glide: true
+        velocity: 0.8,
+        automate: { pan: { 0%: -1.0, 100%: 0.0 } }
     })
 
-    mySynth -> note(G4, {
-         duration: 600,
-         slide: true
-    })
+    lead -> note(E4, { duration: 400 })
+    lead -> note(G4, { duration: 600, glide: true, target_freq: 659.25 })
+    lead -> note(B3, { duration: 400, slide: true, target_amp: 0.3 })
+
+    for i in [1, 2, 3]:
+        lead -> note(C5, { duration: 200 })
 
 # Play the lead
 
-call myLead
+call main
 ```
 
-And the best part ? You can play it directly from the command line:
+### And the best part ? You can play it directly from the command line:
 
 ```bash
 # Play the Devalang file
@@ -102,9 +119,9 @@ devalang play --watch
 devalang play --repeat
 ```
 
-### 🎉 You can now hear your Devalang code in action!
+### 🎉 You can now hear your Devalang code in action
 
-> For more examples, check out the [examples directory](./examples/).
+> For more examples, check out the [examples directory](./examples/)
 
 ## ❓ Why Devalang ?
 
@@ -128,7 +145,7 @@ devalang play --repeat
 
 ## 📄 Documentation
 
-### Please refer to the [online documentation](https://docs.devalang.com) for detailed information on syntax, features, and usage examples.
+### Please refer to the [online documentation](https://docs.devalang.com) for detailed information on syntax, features, and usage examples
 
 ## 🧯 Known issues
 

package/docs/CHANGELOG.md

@@ -4,6 +4,65 @@
 
 # Changelog
 
+## Version 0.0.1-alpha.15 (2025-08-27)
+
+### ✨ Language Features
+
+- Added `automate` statement to schedule parameter automation (e.g. volume, pan, pitch) over time
+  - Supports per-note automation via a `automate` map on note calls (e.g. `note(C4, { automate: { volume: { 0%: 0.0, 100%: 1.0 } } })`)
+- Added `print` statement to ease debugging at runtime
+- Added special variables and functions usable in expressions:
+  - `$env.bpm`, `$env.beat`
+  - `$math.sin(expr)`, `$math.cos(expr)`
+  - `$env.position` (alias of beat), `$env.seed` (global session seed for deterministic randomness)
+  - `$math.random(seed?)`, `$math.lerp(a, b, t)`
+  - `$easing.*` functions for shaping values in [0,1]:
+    - `linear`, `easeIn/Out/InOutQuad`, `easeIn/Out/InOutCubic`, `easeIn/Out/InOutQuart`,
+      `easeIn/Out/InOutExpo`, `easeIn/Out/InOutBack`, `easeIn/Out/InOutElastic`, `easeIn/Out/InOutBounce`
+  - `$mod.*` modulators for time-based control:
+    - `lfo.sine(ratePerBeat)`, `lfo.tri(ratePerBeat)`, `envelope(attack, decay, sustain, release, t)`
+- Added basic `for` loops and array literals
+  - Example: `for i in [1, 2, 3]: print i`
+
+### 🧠 Core Engine
+
+- Implemented runtime automation in the audio renderer with linear envelope interpolation
+- Per-note automation supported (volume, pan, pitch) and evaluated during rendering
+- Fixed evaluator recursion guard and improved `$math.*` expression handling (prevents stack overflows)
+- Minor ADSR defaults polish: ensure `sustain` defaults to `1.0`
+- Evaluator now supports `$mod.*` and `$easing.*` calls (evaluated before `$math.*`) for richer automation
+- Modularized `AudioEngine::insert_note` into small helpers (oscillator, ADSR computation, pan gains, envelope evaluation, stereo mix)
+  - Reused helpers in `pad_samples` to reduce duplication
+- Moved special variables/functions to a dedicated module: `core::audio::special`, and refactored the evaluator to use it
+- Continued borrow-friendly refactors to avoid unnecessary clones and improve readability
+
+### 🧩 Parser / Preprocessor
+
+- Parser upgrades for operators `+ - * /`, parentheses and brackets
+- Improved arrow-call parsing and map handling for multi-line values
+- Resolvers: refined `call`/`spawn` resolution (better error messages with stack traces)
+
+### 🧱 Architecture / Refactor
+
+- Modularized audio interpreter (split by statement type); clearer responsibilities
+- Reduced allocations by passing slices/borrows instead of cloning large structures
+- Removed dead code and unused params across resolvers, handlers, and interpreter modules
+
+### 🧰 Tooling / Build
+
+- Resolved binary/lib artifact collision by renaming the internal library crate to `devalang_core`
+- Warning sweep: build now compiles cleanly without Rust warnings (and fewer Clippy lints)
+- Moved error collection helpers into a dedicated `utils::error` module
+
+### 🐛 Fixes & Stability
+
+- Prevent infinite recursion during numeric expression evaluation
+- Stabilized renderer and interpreter timing when combining `loop`, `call`, and `spawn`
+
+### ⚠️ Breaking changes
+
+- Internal crate rename to `devalang_core` (no change to the CLI or WASM package names)
+
 ## Version 0.0.1-alpha.14 (2025-08-24)
 
 ### 🌎 Ecosystem

package/docs/ROADMAP.md

@@ -27,4 +27,4 @@ Devalang is a work in progress. Here’s what we’re planning next:
 
 - ⏳ **Smart modules**: Let Devalang detect and use groups, samples, and variables without needing to import them manually.
 - ⏳ **Other statements**: Implement `pattern`, `function`, and other control structures.
-- ⏳ **Testing**: Expand test coverage for all features.
+- ⏳ **Testing**: Expand test coverage for all features.

package/examples/automation.deva

@@ -0,0 +1,44 @@
+bpm 120
+
+group myLead:
+    let mySynth = synth sine
+
+    # This will automate all notes inside mySynth
+    # automate mySynth:
+    #     param volume {
+    #         0% = 0.0
+    #         100% = 1.0
+    #     }
+    #     param pan {
+    #         0% = -1.0
+    #         100% = 1.0
+    #     }
+    #     param pitch {
+    #         0% = -12.0
+    #         100% = 12.0
+    #     }
+    
+    # This will automate only C4
+    mySynth -> note(C4, { 
+        duration: 400,
+        automate: {
+            pitch: {
+                0%: -12.0
+                100%: 12.0
+            },
+            pan: {
+                0%: -1.0,
+                100%: 1.0
+            }
+        }
+    })
+    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 })
+
+
+
+call myLead

package/examples/index.deva

@@ -1,29 +1,45 @@
-# This example demonstrates how to create a custom synth and use it in a group with notes.
+bpm 120
 
-bpm 135
+group main:
+	let lead = synth sine {
+        attack: 0,
+        decay: 100,
+        sustain: 100,
+        release: 100
+    }
 
-let customSynth = synth sine {
-    attack: 0,
-    decay: 100,
-    sustain: 50,
-    release: 200,
-}
+	# Global automation for this synth (applies to subsequent notes)
+	automate lead:
+		param volume {
+			0% = 0.0
+			100% = 1.0
+		}
+		param pan {
+			0% = -1.0
+			100% = 1.0
+		}
+		param pitch {
+			0% = -12.0
+			100% = 12.0
+		}
 
-group mySynthGroup:
-    customSynth -> note(C4, { 
-        duration: 1000,
-        glide: true,
-        velocity: 0.8
-    })
-    customSynth -> note(E3, { 
-        duration: 1000,
-        glide: true,
-        velocity: 0.5
-    })
-    customSynth -> note(D3, { 
-        duration: 1000,
-        glide: true,
-        velocity: 0.6
-    })
+	# Notes (per-note automation can override globals)
+	lead -> note(C4, {
+		duration: 400,
+		velocity: 0.8,
+		automate: {
+			pan: {
+				0%: -1.0
+				100%: 0.0
+			}
+		}
+	})
+	lead -> note(E4, { duration: 400 })
+	lead -> note(G4, { duration: 600, glide: true, target_freq: 659.25 })
+	lead -> note(B3, { duration: 400, slide: true, target_amp: 0.3 })
 
-spawn mySynthGroup
+	# Simple looped fill
+	for i in [1, 2, 3]:
+		lead -> note(C5, { duration: 200 })
+
+call main

package/examples/plugin.deva

@@ -0,0 +1,15 @@
+# NOTE: Available in next release
+
+# @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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@devaloop/devalang",
   "private": false,
-  "version": "0.0.1-alpha.14",
+  "version": "0.0.1-alpha.15",
   "description": "Write music like code. Devalang is a domain-specific language (DSL) for sound designers and music hackers. Compose, automate, and control sound — in plain text.",
   "main": "out-tsc/index.js",
   "bin": {

package/project-version.json

@@ -1,6 +1,6 @@
 {
-  "version": "0.0.1-alpha.14",
+  "version": "0.0.1-alpha.15",
   "channel": "alpha",
-  "lastCommit": "e9243d1e7ec612d0d4d31307bcfbf28c5e912b11",
-  "build": 13
+  "lastCommit": "31dad63ed5eb76bdb5ada9177685ccea2ae06bdc",
+  "build": 14
 }

package/rust/cli/bank.rs

@@ -1,6 +1,6 @@
 use std::fs;
 
-use serde::{ Deserialize, Serialize };
+use serde::Deserialize;
 use crate::{
     common::cdn::get_cdn_url,
     config::loader::{ load_config, remove_bank_from_config, update_bank_version_in_config },
@@ -102,7 +102,7 @@ pub async fn handle_update_bank_command(name: Option<String>) -> Result<(), Stri
             );
         }
 
-        let mut config = load_config(Some(&config_path)).ok_or_else(||
+        let config = load_config(Some(&config_path)).ok_or_else(||
             format!("Failed to load config from '{}'", config_path.display())
         )?;
 
@@ -255,8 +255,8 @@ pub async fn handle_remove_bank_command(name: String) -> Result<(), String> {
 pub async fn handle_bank_available_command() -> Result<(), String> {
     let bank_list = match list_external_banks().await {
         Ok(list) => list,
-        Err(err) => {
-            eprintln!("❌ Error fetching bank list: {}", err);
+    Err(_err) => {
+            eprintln!("❌ Error fetching bank list");
             return Err("Failed to fetch bank list".into());
         }
     };
@@ -283,7 +283,7 @@ pub async fn handle_bank_info_command(
 
     let response = match reqwest::get(&url).await {
         Ok(resp) => resp,
-        Err(err) => {
+    Err(_err) => {
             return Err("Failed to fetch bank info".into());
         }
     };
@@ -294,8 +294,8 @@ pub async fn handle_bank_info_command(
 
     let bytes = match response.bytes().await {
         Ok(b) => b,
-        Err(err) => {
-            eprintln!("❌ Error reading response body: {}", err);
+    Err(_err) => {
+            eprintln!("❌ Error reading response body");
             return Err("Failed to read response body".into());
         }
     };
@@ -314,8 +314,8 @@ pub async fn handle_bank_info_command(
 pub async fn handle_bank_list_command() -> Result<(), String> {
     let bank_list = match list_installed_banks().await {
         Ok(list) => list,
-        Err(err) => {
-            eprintln!("❌ Error fetching bank list: {}", err);
+    Err(_err) => {
+            eprintln!("❌ Error fetching bank list");
             return Err("Failed to fetch bank list".into());
         }
     };
@@ -325,11 +325,10 @@ pub async fn handle_bank_list_command() -> Result<(), String> {
     for bank_toml in bank_list {
         let latest_version = match fetch_latest_version(bank_toml.bank.name.clone()).await {
             Ok(version) => version,
-            Err(err) => {
+        Err(_err) => {
                 eprintln!(
-                    "❌ Error fetching latest version for '{}': {}",
-                    bank_toml.bank.name,
-                    err
+                    "❌ Error fetching latest version for '{}'",
+                    bank_toml.bank.name
                 );
                 continue;
             }
@@ -441,8 +440,8 @@ async fn list_installed_banks() -> Result<Vec<BankFile>, String> {
 
                     match toml::from_str::<BankFile>(&content) {
                         Ok(bank_info) => banks.push(bank_info),
-                        Err(err) => {
-                            eprintln!("❌ Error parsing bank info for '{}': {}", bank_name, err);
+                        Err(_err) => {
+                            eprintln!("❌ Error parsing bank info for '{}'", bank_name);
                         }
                     }
                 } else {

package/rust/cli/check.rs

@@ -12,7 +12,7 @@ use crate::{
         utils::path::{ find_entry_file, normalize_path },
     },
     utils::{
-        collect_errors_recursively,
+        error::collect_errors_recursively,
         logger::{ LogLevel, Logger },
         spinner::with_spinner,
         watcher::watch_directory,

package/rust/cli/play.rs

@@ -134,7 +134,7 @@ pub fn handle_play_command(
     }
 }
 
-fn begin_play(config: &Option<Config>, entry_file: &str, output: &str, debug: bool) {
+fn begin_play(_config: &Option<Config>, entry_file: &str, output: &str, debug: bool) {
     let spinner = with_spinner("Building...", || {
         thread::sleep(Duration::from_millis(800));
     });

package/rust/cli/update.rs

@@ -1,4 +1,4 @@
-pub async fn handle_update_command(only: Option<String>) -> Result<(), Box<dyn std::error::Error>> {
+pub async fn handle_update_command(_only: Option<String>) -> Result<(), Box<dyn std::error::Error>> {
     println!("Updates are not yet implemented. This is a placeholder function.");
     Ok(())
 }

package/rust/common/api.rs

@@ -1,8 +1,5 @@
 pub fn get_api_url() -> String {
-    let api_url = std::env
-        ::var("API_URL")
-        .unwrap_or_else(|_| "https://api.devalang.com".to_string());
-        // .unwrap_or_else(|_| "http://127.0.0.1:8989".to_string());
-
-    api_url
+    let api_url = "https://api.devalang.com";
+    // let api_url = "http://127.0.0.1:8989";
+    api_url.to_string()
 }

package/rust/common/cdn.rs

@@ -1,8 +1,5 @@
 pub fn get_cdn_url() -> String {
-    let cdn_url = std::env
-        ::var("CDN_URL")
-        .unwrap_or_else(|_| "https://cdn.devalang.com".to_string());
-        // .unwrap_or_else(|_| "http://127.0.0.1:8888".to_string());
-
-    cdn_url
+    let cdn_url = "https://cdn.devalang.com";
+    // let cdn_url = "http://127.0.0.1:8888";
+    cdn_url.to_string()
 }

package/rust/common/sso.rs

@@ -1,8 +1,5 @@
 pub fn get_sso_url() -> String {
-    let sso_url = std::env
-        ::var("SSO_URL")
-        .unwrap_or_else(|_| "https://sso.devalang.com".to_string());
-        // .unwrap_or_else(|_| "http://localhost:5174".to_string());
-
-    sso_url
+    let sso_url = "https://sso.devalang.com";
+    // let sso_url = "http://localhost:5174";
+    sso_url.to_string()
 }