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

package/.devalang

@@ -1,9 +1,8 @@
-[defaults]
-entry = "./examples"
-output = "./output"
-watch = false
-
-[[banks]]
-path = "devalang://bank/808"
-version = "0.0.1"
-author = "devaloop"
+[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.12"
+version = "0.0.1-alpha.14"
 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"
@@ -20,7 +20,7 @@ required-features = ["cli"]
 
 [lib]
 path = "rust/lib.rs"
-crate-type = ["cdylib"]
+crate-type = ["cdylib", "rlib"]
 
 [profile.release]
 opt-level = "s"
@@ -50,4 +50,9 @@ js-sys = "0.3"
 reqwest = { version = "0.12.22", optional = true, features = ["json"] }
 flate2 = { version = "1.0", optional = true }
 tokio = { version = "1", features = ["full"], optional = true }
-zip = { version = "4.3.0", optional = true }
+zip = { version = "4.3.0", optional = true }
+rayon = "1.10.0"
+webbrowser = "0.8"
+tiny_http = "0.9.0"
+dirs = "5"
+urlencoding = "2.1"

package/README.md

@@ -1,5 +1,5 @@
 <div align="center">
-    <img src="https://devalang.com/images/devalang-logo-cyan.svg" alt="Devalang Logo" width="300" />
+    <img src="https://devalang.com/images/devalang-logo.svg" alt="Devalang Logo" width="300" />
 </div>
 
 ![Rust](https://img.shields.io/badge/Made%20with-Rust-orange?logo=rust)
@@ -7,7 +7,7 @@
 ![Node.js](https://img.shields.io/badge/Node.js-18%2B-brightgreen?logo=node.js)
 
 ![Project Status](https://img.shields.io/badge/status-alpha-red)
-![Version](https://img.shields.io/badge/version-0.0.1-blue)
+![Version](https://img.shields.io/npm/v/@devaloop/devalang)
 ![License: MIT](https://img.shields.io/badge/license-MIT-green)
 ![Platform](https://img.shields.io/badge/platform-Windows-blue)
 
@@ -16,26 +16,20 @@
 
 [![VSCode Extension](https://img.shields.io/visual-studio-marketplace/v/devaloop.devalang-vscode?label=VSCode%20Extension)](https://marketplace.visualstudio.com/items?itemName=devaloop.devalang-vscode)
 
-# 🎶 Devalang
-
-Compose music with code — structured, expressive, and fast.
+# 🦊 Devalang (CORE) — Compose music with code
 
 Devalang is a tiny domain-specific language (DSL) for music makers, sound designers, and audio hackers.
 Compose loops, control samples, render and play audio — all in clean, readable text.
 
-🦊 Whether you're building a track, shaping textures, or performing live, Devalang helps you think in rhythms. It’s designed to be simple, expressive, and fast — because your ideas shouldn’t wait.
+Whether you're building a track, shaping textures, or performing live, Devalang helps you think in rhythms. It’s designed to be simple, expressive, and fast — because your ideas shouldn’t wait.
 
 From studio sketches to live sets, Devalang gives you rhythmic control — with the elegance of code.
 
-> 🚧 **v0.0.1-alpha.11 Notice** 🚧
->
-> NEW: Devalang is available in your browser at [playground.devalang.com](https://playground.devalang.com) !
->
-> NEW: Online documentation is now available at [docs.devalang.com](https://docs.devalang.com)
+> 🚧 Alpha Notice 🚧
 >
 > Includes synthesis, playback, and rendering features, but is still in early development.
 >
-> Currently, Devalang CLI is only available for **Windows**.  
+> Currently, Devalang CLI is only available for **Windows**.
 > Linux and macOS binaries will be added in future releases via cross-platform builds.
 
 ## 📚 Quick Access
@@ -51,7 +45,11 @@ From studio sketches to live sets, Devalang gives you rhythmic control — with
 
 ## ⏱️ Try it now !
 
-### You can also have a look at the [Playground](https://playground.devalang.com) to try Devalang directly in your browser
+### Try Devalang in your browser
+
+> Have a look at the [Playground](https://playground.devalang.com) to try Devalang directly in your browser
+
+### Try Devalang CLI
 
 ```bash
 # Install Devalang CLI globally
@@ -68,10 +66,23 @@ Create a new Devalang file `src/index.deva` in the project directory:
 # src/index.deva
 
 group myLead:
-    let mySynth = synth sine
-
-    mySynth -> note(C4, { duration: 400 })
-    mySynth -> note(G4, { duration: 600 })
+    let mySynth = synth sine {
+        attack: 0,
+        decay: 100,
+        sustain: 100,
+        release: 100
+    }
+
+    mySynth -> note(C4, {
+        duration: 400,
+        velocity: 0.7,
+        glide: true
+    })
+
+    mySynth -> note(G4, {
+         duration: 600,
+         slide: true
+    })
 
 # Play the lead
 
@@ -95,19 +106,19 @@ devalang play --repeat
 
 > For more examples, check out the [examples directory](./examples/).
 
-## ❓ Why Devalang?
+## ❓ Why Devalang ?
 
-- 🎹 Prototype audio ideas without opening a DAW
+- 🎹 Prototype audio ideas without opening a DAW, even VSCode
 - 💻 Integrate sound into code-based workflows
 - 🎛️ Control audio parameters through readable syntax
 - 🧪 Build musical logic with variables and conditions
-
-> Producer, coder, or both — Devalang gives you musical structure, instantly.
+- 🔄 Create complex patterns with ease
 
 ## 🚀 Features
 
 - 🎵 **Audio Engine**: Integrated audio playback and rendering
 - 🧩 **Module system** for importing and exporting variables between files
+- 📦 **Addon manager** for managing external banks, plugins and more
 - 📜 **Structured AST** generation for debugging and future compilation
 - 🔢 **Basic data types**: strings, numbers, booleans, maps, arrays
 - 👁️ **Watch mode** for `build`, `check` and `play` commands
@@ -119,22 +130,9 @@ devalang play --repeat
 
 ### Please refer to the [online documentation](https://docs.devalang.com) for detailed information on syntax, features, and usage examples.
 
-## 📜 Changelog Highlights
-
-For a complete list of changes, see [docs/CHANGELOG.md](./docs/CHANGELOG.md)
-
-- Implemented beat durations in `triggers` and `arrow_calls` statements
-- Implemented `bank` resolver to resolve banks of sounds in the code
-  - Support for namespaced banks of sounds (e.g. `.808.myTrigger`)
-- Implemented multiple commands for `bank` management
-  - `bank list`, `bank available`, `bank info <bank_name>`, `bank remove <bank_name>`, `bank update`, `bank update <bank_name>`
-- Implemented `install` command to install banks of sounds
-  - `install bank <bank_name>`
-
 ## 🧯 Known issues
 
 - No smart modules yet, all groups, variables, and samples must be explicitly imported where used
-- No support yet for `pattern`, `function`, ... statements
 - No support yet for cross-platform builds (Linux, macOS)
 
 ## 🧪 Roadmap Highlights
@@ -154,6 +152,10 @@ MIT — see [LICENSE](./LICENSE)
 Contributions, bug reports and suggestions are welcome !  
 Feel free to open an issue or submit a pull request.
 
+For more info, see [docs/CONTRIBUTING.md](./docs/CONTRIBUTING.md).
+
 ## 📢 Contact
 
+Feel free to reach out for any inquiries or feedback.
+
 📧 [contact@devaloop.com](mailto:contact@devaloop.com)

package/docs/CHANGELOG.md

@@ -1,9 +1,73 @@
 <div align="center">
-    <img src="https://devalang.com/images/devalang-logo-cyan.svg" alt="Devalang Logo" width="300" />
+    <img src="https://devalang.com/images/devalang-logo.svg" alt="Devalang Logo" width="300" />
 </div>
 
 # Changelog
 
+## Version 0.0.1-alpha.14 (2025-08-24)
+
+### 🌎 Ecosystem
+
+- Deployed "SSO" (Single Sign-On) for user authentication. [(https://sso.devalang.com)](https://sso.devalang.com) when using `devalang login`.
+
+### 🧩 Language Features
+
+- Added support for ADSR envelopes in synthesizers.
+  - Example: `let mySynth = synth sine { attack: 0, decay: 50, sustain: 100, release: 50 }`
+- Added support for `note` parameters in synthesizers.
+  - Example: `mySynth -> note(C4, { duration: 500, velocity: 0.8, glide: true, slide: false })`
+
+### 🧠 Core Engine
+
+- Patched banks resolution with improved namespace handling. (declaring `bank <bank_author>.<bank_name>` and using `.<bank_name>.<bank_trigger>`)
+- Patched `arrow_call` to correctly handle argument parsing and improve error reporting.
+  - Implemented multi-line argument parsing for `arrow_call`.
+  - Patched execution of `arrow_call` to ensure correct timing and execution order.
+- Upgraded indent lexer to handle multi-line statements and improve indentation handling.
+- Upgraded `parse_map_value` to handle multi-line values and improve parsing logic in Parser.
+- Added `log_message_with_trace` function to log messages with informations when running commands with `debug` flag.
+
+### 🧰 Commands
+
+- Added `login` command to authenticate users to install protected or private packages.
+- Refactored `install` command to support installing banks, presets and plugins.
+  - `install bank <bank_author>.<bank_name>` to install a specific bank of sounds.
+  - `install preset <preset_author>.<preset_name>` to install a specific preset.
+  - `install plugin <plugin_author>.<plugin_name>` to install a specific plugin.
+- Implemented `debug` and `compress` arguments for `build`, `check` and `play` commands.
+  - `build --debug` to build the AST with debug information.
+  - `check --debug` to check the syntax with debug information.
+  - `play --debug` to play the audio with debug information.
+  - `build --compress` to compress the output.
+  - `check --compress` to compress the output.
+  - `play --compress` to compress the output.
+
+## Version 0.0.1-alpha.13 (2025-07-26)
+
+### 🧩 Language Features
+
+- Added support for `fn` directive to define functions in Devalang.
+  - Example: `fn myFunction(param1, param2):`
+
+### 🧠 Core Engine
+
+- Patched `trigger`, `call`, and `spawn`, `renderer` to handle correct cursor time in the audio interpreter.
+- Refactored audio engine and interpreter to handle correct timing and execution while using `loop`, `call`, and `spawn` statements.
+- Refactored `trigger` effects to apply more effects to triggers.
+  - Example: `.myTrigger auto { reverb: 0.25, pitch: 0.75, gain: 0.8 }`
+- Refactored `preprocessor` to handle correct namespaced banks of sounds and triggers.
+- Refactored `collect_errors_recursively` to provide detailed error reporting across nested statements.
+- Optimized the `renderer` to handle silent buffers and improve performance.
+
+### 🛠️ Utilities
+
+- Added the `extract_loop_body_statements` utility for better loop handling.
+- Improved logging for module variables and functions.
+
+### 🧩 Web Assembly
+
+- Patched `lib.rs` dependencies to ensure compatibility with the latest Rust and WASM standards.
+
 ## Version 0.0.1-alpha.12 (2025-07-21)
 
 ### 🧩 Language Features

package/docs/CONTRIBUTING.md

@@ -0,0 +1 @@
+# This file is a placeholder

package/docs/ROADMAP.md

@@ -1,5 +1,5 @@
 <div align="center">
-        <img src="https://devalang.com/images/devalang-logo-cyan.svg" alt="Devalang Logo" width="300" />
+    <img src="https://devalang.com/images/devalang-logo.svg" alt="Devalang Logo" width="300" />
 </div>
 
 # Roadmap
@@ -8,7 +8,7 @@ Devalang is a work in progress. Here’s what we’re planning next:
 
 ## Completed
 
-- ✅ **Audio engine**: Integrate the audio engine for sound playback. 
+- ✅ **Audio engine**: Integrate the audio engine for sound playback.
 - ✅ **Basic syntax**: Implement the core syntax for Devalang, including data types and basic statements.
 - ✅ **Watch mode**: Add a watch mode to automatically rebuild on file changes.
 - ✅ **Module system**: Add support for importing and exporting variables between files using `@import` and `@export`.

package/docs/TODO.md

@@ -1,5 +1,5 @@
 <div align="center">
-    <img src="https://devalang.com/images/devalang-logo-cyan.svg" alt="Devalang Logo" width="300" />
+    <img src="https://devalang.com/images/devalang-logo.svg" alt="Devalang Logo" width="300" />
 </div>
 
 # TODOs list
@@ -17,15 +17,16 @@ This is a list of tasks and features to be implemented in Devalang. Note that th
   - [x] Implement template info
 - [x] Checking
   - [x] Implement watch mode
-  - [ ] Implement debug mode
+  - [x] Implement debug mode
   - [ ] Implement compilation mode
 - [x] Building
   - [x] Implement watch mode
-  - [ ] Implement debug mode
+  - [x] Implement debug mode
   - [ ] Implement compilation mode
-  - [ ] Implement compression mode
+  - [x] Implement compression mode
 - [x] Play
   - [x] Implement Audio Engine
+  - [x] Implement debug mode
   - [x] Implement loop mode
 
 ## Core components
@@ -44,7 +45,7 @@ This is a list of tasks and features to be implemented in Devalang. Note that th
 - [x] @export
 - [x] @load
 - [ ] @include
-- [ ] function
+- [x] function
 - [ ] pattern
 - [x] group
 - [x] call

package/examples/bank.deva

@@ -1,9 +1,7 @@
 # This file demonstrates the use of banks in Devalang.
 
-let default_bank = 808
-
-bank default_bank
+bank devaloop.808
 
 .808.kick auto
 .808.snare auto
-.808.hat auto
+.808.openhat auto

package/examples/function.deva

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

package/examples/index.deva

@@ -1,18 +1,29 @@
-# This file demonstrates the use of main features in Devalang.
+# This example demonstrates how to create a custom synth and use it in a group with notes.
 
-@import { duration, default_bank, params, loopCount, tempo } from "./variables.deva"
-@import { myLead } from "./synth.deva"
-@import { myLoop } from "./loop.deva"
+bpm 135
 
-@load "./samples/kick-808.wav" as kickCustom
-@load "./samples/hat-808.wav" as hatCustom
+let customSynth = synth sine {
+    attack: 0,
+    decay: 100,
+    sustain: 50,
+    release: 200,
+}
 
-# bpm tempo
+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
+    })
 
-# group myTrack:
-#     spawn myLoop
-#     spawn myLead
-
-# call myTrack
-
-.kickCustom duration { gain: 1, pitch: 1.25 }
+spawn mySynthGroup

package/package.json

@@ -1,21 +1,21 @@
 {
   "name": "@devaloop/devalang",
   "private": false,
-  "version": "0.0.1-alpha.12",
+  "version": "0.0.1-alpha.14",
   "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": {
     "devalang": "./out-tsc/bin/index.js"
   },
   "scripts": {
-    "prepublish": "cargo build --release && npm run script:postbuild",
-    "rust:dev:build": "cargo run build --entry examples --output output",
-    "rust:dev:check": "cargo run check --entry examples --output output",
-    "rust:dev:play": "cargo run play --entry examples --output output --repeat",
+    "rust:dev:build": "cargo run build --entry examples --output output --debug",
+    "rust:dev:check": "cargo run check --entry examples --output output --debug",
+    "rust:dev:play": "cargo run play --entry examples --output output --repeat --debug",
     "rust:wasm:web": "wasm-pack build --target=web --no-default-features",
     "rust:wasm:node": "wasm-pack build --target=nodejs --no-default-features",
     "script:postbuild": "tsc && node out-tsc/scripts/postbuild.js",
-    "script:version:bump": "tsc && node out-tsc/scripts/version/index.js"
+    "script:version:bump": "tsc && node out-tsc/scripts/version/index.js",
+    "prepublish": "cargo build --release && npm run script:postbuild"
   },
   "homepage": "https://devalang.com",
   "keywords": [

package/project-version.json

@@ -1,6 +1,6 @@
 {
-  "version": "0.0.1-alpha.12",
+  "version": "0.0.1-alpha.14",
   "channel": "alpha",
-  "lastCommit": "e16a21167693d0265195bf4256b3f8ec0ed1e55f",
-  "build": 11
+  "lastCommit": "e9243d1e7ec612d0d4d31307bcfbf28c5e912b11",
+  "build": 13
 }

package/rust/cli/bank.rs

@@ -398,6 +398,7 @@ async fn list_installed_banks() -> Result<Vec<BankFile>, String> {
         return Ok(banks); // No banks installed
     }
 
+    // TODO: Verify installed banks in files
     // let installed_banks = std::fs
     //     ::read_dir(bank_dir)
     //     .map_err(|e| format!("Failed to read bank directory: {}", e))?;
@@ -416,7 +417,7 @@ async fn list_installed_banks() -> Result<Vec<BankFile>, String> {
         );
     }
 
-    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())
     )?;
 

package/rust/cli/build.rs

@@ -4,8 +4,9 @@ use crate::{
         builder::Builder,
         debugger::{
             lexer::write_lexer_log_file,
+            module::{ write_module_function_log_file, write_module_variable_log_file },
             preprocessor::write_preprocessor_log_file,
-            store::write_store_log_file,
+            store::{ write_function_log_file, write_variables_log_file },
         },
         preprocessor::loader::ModuleLoader,
         store::global::GlobalStore,
@@ -20,7 +21,9 @@ pub fn handle_build_command(
     config: Option<Config>,
     entry: Option<String>,
     output: Option<String>,
-    watch: bool
+    watch: bool,
+    debug: bool,
+    compress: bool
 ) {
     let fetched_entry = if entry.is_none() {
         config
@@ -76,7 +79,7 @@ pub fn handle_build_command(
 
     // SECTION Begin build
     if fetched_watch {
-        begin_build(entry_file.clone(), fetched_output.clone());
+        begin_build(entry_file.clone(), fetched_output.clone(), debug, compress);
 
         logger.log_message(
             LogLevel::Watcher,
@@ -86,14 +89,14 @@ pub fn handle_build_command(
         watch_directory(entry_file.clone(), move || {
             logger.log_message(LogLevel::Watcher, "Detected changes, re-building...");
 
-            begin_build(entry_file.clone(), fetched_output.clone());
+            begin_build(entry_file.clone(), fetched_output.clone(), debug, compress);
         }).unwrap();
     } else {
-        begin_build(entry_file.clone(), fetched_output.clone());
+        begin_build(entry_file.clone(), fetched_output.clone(), debug, compress);
     }
 }
 
-fn begin_build(entry: String, output: String) {
+fn begin_build(entry: String, output: String, debug: bool, compress: bool) {
     let spinner = with_spinner("Building...", || {
         thread::sleep(Duration::from_millis(800));
     });
@@ -111,27 +114,86 @@ fn begin_build(entry: String, output: String) {
     let (modules_tokens, modules_statements) = module_loader.load_all_modules(&mut global_store);
 
     // SECTION Write logs
-    write_lexer_log_file(&normalized_output_dir, "lexer_tokens.log", modules_tokens.clone());
-    write_preprocessor_log_file(
-        &normalized_output_dir,
-        "resolved_statements.log",
-        modules_statements.clone()
-    );
-    write_store_log_file(&normalized_output_dir, "global_store.log", global_store.modules.clone());
+    if debug {
+        for (module_path, module) in global_store.modules.clone() {
+            write_module_variable_log_file(
+                &normalized_output_dir,
+                &module_path,
+                &module.variable_table
+            );
+            write_module_function_log_file(
+                &normalized_output_dir,
+                &module_path,
+                &module.function_table
+            );
+        }
+
+        write_lexer_log_file(&normalized_output_dir, "lexer_tokens.log", modules_tokens.clone());
+        write_preprocessor_log_file(
+            &normalized_output_dir,
+            "resolved_statements.log",
+            modules_statements.clone()
+        );
+        write_variables_log_file(
+            &normalized_output_dir,
+            "global_variables.log",
+            global_store.variables.clone()
+        );
+        write_function_log_file(
+            &normalized_output_dir,
+            "global_functions.log",
+            global_store.functions.clone()
+        );
+    }
 
     // SECTION Building AST and Audio
     let builder = Builder::new();
-    builder.build_ast(&modules_statements, &normalized_output_dir);
+    builder.build_ast(&modules_statements, &normalized_output_dir, compress);
     builder.build_audio(&modules_statements, &normalized_output_dir, &mut global_store);
 
     // SECTION Logging
     let logger = Logger::new();
 
+    if debug {
+        let modules_loaded = global_store.modules
+            .iter()
+            .map(|(k, _)| k)
+            .collect::<Vec<_>>();
+        let global_variables_loaded = global_store.variables.variables.keys().collect::<Vec<_>>();
+        let global_functions_loaded = global_store.functions.functions.keys().collect::<Vec<_>>();
+
+        logger.log_message_with_trace(
+            LogLevel::Debug,
+            &format!("Modules loaded: {}", global_store.modules.len()),
+            modules_loaded
+                .iter()
+                .map(|s| s.as_str())
+                .collect()
+        );
+        logger.log_message_with_trace(
+            LogLevel::Debug,
+            &format!("Global variables: {}", global_store.variables.variables.len()),
+            global_variables_loaded
+                .iter()
+                .map(|s| s.as_str())
+                .collect()
+        );
+        logger.log_message_with_trace(
+            LogLevel::Debug,
+            &format!("Global functions: {}", global_store.functions.functions.len()),
+            global_functions_loaded
+                .iter()
+                .map(|s| s.as_str())
+                .collect()
+        );
+    }
+
     let success_message = format!(
         "Build completed successfully in {:.2?}. Output files written to: '{}'",
         duration.elapsed(),
         normalized_output_dir
     );
 
+    spinner.finish_and_clear();
     logger.log_message(LogLevel::Success, &success_message);
 }