@devaloop/devalang 0.0.1-alpha.13 → 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,54 +1,58 @@
-[package]
-name = "devalang"
-version = "0.0.1-alpha.13"
-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"
-repository = "https://github.com/devaloop-labs/devalang"
-keywords = ["music", "dsl", "audio", "cli"]
-categories = ["command-line-utilities", "development-tools", "parser-implementations"]
-readme = "README.md"
-homepage = "https://devalang.com"
-documentation = "https://docs.devalang.com/"
-license-file = "LICENSE"
-edition = "2024"
-
-[[bin]]
-name = "devalang"
-path = "rust/main.rs"
-required-features = ["cli"]
-
-[lib]
-path = "rust/lib.rs"
-crate-type = ["cdylib", "rlib"]
-
-[profile.release]
-opt-level = "s"
-
-[features]
-default = ["cli"]
-cli = ["crossterm", "indicatif", "inquire", "zip", "reqwest", "flate2", "tokio"]
-
-[dependencies]
-clap = { version = "4.5", features = ["derive"] }
-serde = { version = "1.0", features = ["derive"] }
-serde_json = "1.0"
-rodio = "0.17"
-hound = "3.4.0"
-toml = "0.8"
-notify = "6.1"
-fs_extra = "1.3"
-include_dir = "0.7"
-wasm-bindgen = "0.2"
-serde-wasm-bindgen = "0.4"
-nom_locate = "4.0.0"
-chrono = "0.4"
-crossterm =  { version = "0.27", optional = true }
-indicatif = { version = "0.17", optional = true }
-inquire = { version = "0.7.5", optional = true }
-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 }
-rayon = "1.10.0"
+[package]
+name = "devalang"
+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"
+repository = "https://github.com/devaloop-labs/devalang"
+keywords = ["music", "dsl", "audio", "cli"]
+categories = ["command-line-utilities", "development-tools", "parser-implementations"]
+readme = "README.md"
+homepage = "https://devalang.com"
+documentation = "https://docs.devalang.com/"
+license-file = "LICENSE"
+edition = "2024"
+
+[[bin]]
+name = "devalang"
+path = "rust/main.rs"
+required-features = ["cli"]
+
+[lib]
+path = "rust/lib.rs"
+crate-type = ["cdylib", "rlib"]
+
+[profile.release]
+opt-level = "s"
+
+[features]
+default = ["cli"]
+cli = ["crossterm", "indicatif", "inquire", "zip", "reqwest", "flate2", "tokio"]
+
+[dependencies]
+clap = { version = "4.5", features = ["derive"] }
+serde = { version = "1.0", features = ["derive"] }
+serde_json = "1.0"
+rodio = "0.17"
+hound = "3.4.0"
+toml = "0.8"
+notify = "6.1"
+fs_extra = "1.3"
+include_dir = "0.7"
+wasm-bindgen = "0.2"
+serde-wasm-bindgen = "0.4"
+nom_locate = "4.0.0"
+chrono = "0.4"
+crossterm =  { version = "0.27", optional = true }
+indicatif = { version = "0.17", optional = true }
+inquire = { version = "0.7.5", optional = true }
+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 }
+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.13 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
@@ -141,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,16 +1,54 @@
 <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.

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

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,15 +1,29 @@
-# This file demonstrates the use of main features in Devalang.
-bpm 135
+# This example demonstrates how to create a custom synth and use it in a group with notes.
 
-bank 808
+bpm 135
 
-let entityTest1 = .808.kick auto
-let entityTest2 = .808.clap auto
-let entityTest3 = .808.snare auto
+let customSynth = synth sine {
+    attack: 0,
+    decay: 100,
+    sustain: 50,
+    release: 200,
+}
 
-fn myFirstGroup(entity1, entity2, entity3):
-    .entity1
-    .entity2
-    .entity3
+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
+    })
 
-call myFirstGroup(entityTest1, entityTest2, entityTest3)
+spawn mySynthGroup

package/package.json

@@ -1,21 +1,21 @@
 {
   "name": "@devaloop/devalang",
   "private": false,
-  "version": "0.0.1-alpha.13",
+  "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.13",
+  "version": "0.0.1-alpha.14",
   "channel": "alpha",
-  "lastCommit": "f25a91c6efe3dca91cc8fa3bfa829d3fc2271855",
-  "build": 12
+  "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

@@ -21,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
@@ -77,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,
@@ -87,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));
     });
@@ -112,49 +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
-    for (module_path, module) in global_store.modules.clone() {
-        write_module_variable_log_file(
+    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,
-            &module_path,
-            &module.variable_table
+            "resolved_statements.log",
+            modules_statements.clone()
         );
-        write_module_function_log_file(
+        write_variables_log_file(
             &normalized_output_dir,
-            &module_path,
-            &module.function_table
+            "global_variables.log",
+            global_store.variables.clone()
+        );
+        write_function_log_file(
+            &normalized_output_dir,
+            "global_functions.log",
+            global_store.functions.clone()
         );
     }
 
-    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);
 }