@devaloop/devalang 0.0.1-alpha.4 → 0.0.1-alpha.7

package/Cargo.toml

@@ -1,20 +1,22 @@
 [package]
 name = "devalang"
-version = "0.0.1-alpha.4"
+version = "0.0.1-alpha.7"
 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", "audio", "development-tools"]
+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"
@@ -25,7 +27,7 @@ opt-level = "s"
 
 [features]
 default = ["cli"]
-cli = ["crossterm"]
+cli = ["crossterm", "indicatif", "inquire"]
 
 [dependencies]
 clap = { version = "4.5", features = ["derive"] }
@@ -42,5 +44,5 @@ serde-wasm-bindgen = "0.4"
 nom_locate = "4.0.0"
 chrono = "0.4"
 crossterm =  { version = "0.27", optional = true }
-indicatif = "0.17"
-inquire = "0.7.5"
+indicatif = { version = "0.17", optional = true }
+inquire = { version = "0.7.5", optional = true }

package/README.md

@@ -12,6 +12,9 @@
 ![Platform](https://img.shields.io/badge/platform-Windows-blue)
 
 ![npm](https://img.shields.io/npm/dt/@devaloop/devalang)
+![crates](https://img.shields.io/crates/d/devalang)
+
+[![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, by **Devaloop Labs**
 
@@ -24,9 +27,10 @@ Compose loops, control samples, render and play audio — all in clean, readable
 
 From studio sketches to live sets, Devalang gives you rhythmic control — with the elegance of code.
 
-> 🚧 **v0.0.1-alpha.4 Notice** 🚧
+> 🚧 **v0.0.1-alpha.5 Notice** 🚧
 >
-> **Audio Engine** is now integrated, enabling audio playback and rendering capabilities.
+> NEW: Devalang VSCode extension is now available !
+> [Get it here](https://marketplace.visualstudio.com/items?itemName=devaloop.devalang-vscode).
 >
 > Currently, Devalang CLI is only available for **Windows**.  
 > Linux and macOS binaries will be added in future releases via cross-platform builds.
@@ -37,6 +41,8 @@ From studio sketches to live sets, Devalang gives you rhythmic control — with
 
 - [📖 Documentation](./docs/)
 - [💡 Examples](./examples/)
+- [🧩 VSCode Extension](https://marketplace.visualstudio.com/items?itemName=devaloop.devalang-vscode)
+- [🎨 Prettier Plugin](https://www.npmjs.com/package/@devaloop/prettier-plugin-devalang)
 - [🌐 Project Website](https://devalang.com)
 
 ## 🚀 Features
@@ -160,13 +166,27 @@ bpm globalBpm
 bank globalBank
 # Will declare a custom instrument bank using the globalBank variable
 
+# Loops
+
 loop 5:
     .customKick kickDuration {reverb=50, drive=25}
-    # Will play 5 times a kick for the duration of the kickDuration variable with reverb and drive effects
+    # Will play 5 times a custom sample for 500ms with reverb and overdrive effects
+
+# Groups
+
+group myGroup:
+    .customKick kickDuration {reverb=50, drive=25}
+    # Will play the same sample in a group, allowing for more complex patterns
+
+# Will be executed line by line (sequentially)
+call myGroup
+
+# Will be executed in parallel (concurrently)
+# spawn myGroup
 ```
 
 ```deva
-# global.deva
+# variables.deva
 
 let globalBpm = 120
 let globalBank = 808
@@ -177,15 +197,14 @@ let kickDuration = 500
 
 ## 🧯 Known issues
 
-- No support yet for `if`, `else`, `else if` statements
-- No support yet for `@group`, `@pattern`, `@function` statements
+- No support yet for `if`, `else`, `else if`, `pattern`, `function`, ... statements
 - No support yet for cross-platform builds (Linux, macOS)
 
 ## 🧪 Roadmap Highlights
 
 For more info, see [docs/ROADMAP.md](./docs/ROADMAP.md)
 
-- ⏳ Other statements (e.g `if`, `@group`, ...)
+- ⏳ Other statements (e.g `if`, `function`, ...)
 - ⏳ Cross-platform support (Linux, macOS)
 - ⏳ More built-in instruments (e.g. snare, hi-hat, etc.)
 

package/docs/CHANGELOG.md

@@ -4,6 +4,38 @@
 
 # Changelog
 
+## Version 0.0.1-alpha.6 (2025-07-11)
+
+## Examples
+
+- Added example for `group` directive in `examples/group.devalang`.
+
+## Structure
+
+- Moved `rust/audio` folder to `rust/core/audio` to better organize the project structure.
+
+### Core Components
+
+- Implemented `group` directive to define groups of sounds.
+- Implemented `call` directive to call a group of sounds.
+- Implemented `spawn` directive to spawn a group of sounds in parallel.
+- Implemented `sleep` directive to pause execution for a specified duration.
+- Patched line and column tracking in the lexer to ensure correct indentation handling.
+- Patched string lexing advancing to handle first character correctly.
+
+## Version 0.0.1-alpha.5 (2025-07-05)
+
+### Syntax
+
+- Fixed block parsing issues caused by missing or incorrect `Indent` / `Dedent` token detection.
+- Indentation handling now triggers correctly at each newline.
+- Improved reliability of nested blocks (e.g., inside `loop`) with consistent `Dedent` termination.
+
+### Core Components
+
+- Added full **WebAssembly (WASM)** support — Devalang can now be compiled for browser or Node.js environments.
+- Prepared the ground for future IDE integrations (e.g., VSCode extension) by stabilizing core syntax parsing.
+
 ## Version 0.0.1-alpha.4 (2025-07-03)
 
 ### Audio Engine
@@ -15,11 +47,11 @@
 ### Commands
 
 - Implemented `play` command to play Devalang files.
+
   - Added `--watch` option to watch for changes in files and automatically rebuild and play them. (once)
   - Added `--repeat` option to repeat the playback of the audio file. (infinite)
-  
+
   Note : You cannot use `--watch` and `--repeat` options together. Use `--repeat` instead.
-  
 
 ## Version 0.0.1-alpha.3 (2025-07-01)
 

package/docs/ROADMAP.md

@@ -6,7 +6,7 @@
 
 Devalang is a work in progress. Here’s what we’re planning next:
 
-### Stable
+## Completed
 
 - ✅ **Audio engine**: Integrate the audio engine for sound playback. 
 - ✅ **Basic syntax**: Implement the core syntax for Devalang, including data types and basic statements.
@@ -20,11 +20,11 @@ Devalang is a work in progress. Here’s what we’re planning next:
 - ✅ **Instruction calls**: Add support for instruction calls with parameters (e.g. `.kick auto {reverb:10, decay:20}`).
 - ✅ **Let assignments**: Implement `let` assignments for storing reusable values.
 - ✅ **Sample loading**: Add `@load` assignment to load samples (.mp3, .wav) for use as values.
+- ✅ **WASM support**: Compile Devalang to WebAssembly for use in web applications and other environments.
 
-### Upcoming
+## Upcoming
 
 - ⏳ **VSCode extension**: Create a VSCode extension for syntax highlighting and code completion.
-- ⏳ **WASM support**: Compile Devalang to WebAssembly for use in web applications.
 - ⏳ **Other statements**: Implement `if`, `else`, and other control structures.
 - ⏳ **Pattern and group statements**: Add support for `@pattern` and `@group` to organize code.
 - ⏳ **Functions**: Add support for defining and calling functions.

package/docs/SYNTAX.md

@@ -17,6 +17,18 @@ The engine uses indentation to define blocks, similar to Python. Each block must
 <details>
 <summary>Show available types</summary>
 
+### Duration
+
+Duration is defined using a number. It represents the length of a sound in milliseconds.
+
+```deva
+let duration = 1000
+```
+
+Will play a sound for 1000 milliseconds (1 second).
+
+NOTE: Other time units like seconds or beats are not supported yet, but will be in the future.
+
 ### String
 
 Strings are defined using double quotes.
@@ -103,22 +115,13 @@ loop exportedIterator:
     .kick auto exportedParams
 ```
 
-### Built-in triggers
+### Triggers
 
-Usage : `.<trigger-name> <duration> <effects-map>`
+You can load your own samples and use them in your music.
 
-Other triggers will be added in future releases (e.g. `.snare`, `.hihat`, `.tom`, `.clap`, `.crash`, `.ride`, `.synth`, `.bass`, `.pad`).
-You can also create custom triggers using the `@load` directive.
+Load usage : `@load <path> as <name>`
 
-```deva
-.kick
-.kick 1/4
-.kick auto {reverb: 50, decay: 30}
-```
-
-### Custom triggers
-
-Same usage as built-in triggers, but with custom audio files or effects.
+Trigger usage : `.<name> <duration> <params>`
 
 ```deva
 @load "./path/to/instrument.mp3" as mySample
@@ -138,7 +141,7 @@ let map = {myKey: 200}
 let array = [0, 1, 2]
 ```
 
-### Basic loops
+### Loops
 
 Loops are defined using the `loop` keyword, followed by the number of iterations. The body of the loop is indented.
 
@@ -146,3 +149,28 @@ Loops are defined using the `loop` keyword, followed by the number of iterations
 loop 10:
     # ...
 ```
+
+### Groups
+
+Groups are defined using the `group` keyword, followed by the group name. The body of the group is indented.
+
+```deva
+group myGroup:
+    # ...
+```
+
+### Calling Groups (Sequential Execution)
+
+Groups can be called using the `call` keyword, which executes the group in sequence.
+
+```deva
+call myGroup
+```
+
+### Spawning Groups (Parallel Execution)
+
+Groups can be spawned using the `spawn` keyword, which executes the group in parallel.
+
+```deva
+spawn myGroup
+```

package/docs/TODO.md

@@ -42,11 +42,14 @@ This is a list of tasks and features to be implemented in Devalang. Note that th
 - [x] #
 - [x] @import
 - [x] @export
-- [ ] @group
-- [ ] @pattern
-- [ ] @function
 - [x] @load
 - [ ] @include
+- [ ] function
+- [ ] pattern
+- [x] group
+- [x] call
+- [x] spawn
+- [x] sleep
 - [x] bpm
 - [x] bank
 - [x] loop
@@ -62,8 +65,6 @@ This is a list of tasks and features to be implemented in Devalang. Note that th
 
 ## Other TODOs
 
-- [x] Implement a more robust error handling system
-- [x] Replace eprintln & println with `log_message` function
-- [x] Implement a more comprehensive logging system
-- [ ] Add unit tests for all core components
-- [ ] Comment all core components
+- [ ] Patch path handling to support relative paths
+- [ ] Comment all core components
+- [ ] Add unit tests for all core components

package/examples/group.deva

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

package/examples/index.deva

@@ -1,16 +1,17 @@
-@import { duration, default_bank, params, loopCount, tempo } from "./examples/exported.deva"
+# This file demonstrates the use of main features in Devalang.
 
-@load "./examples/samples/kick-808.wav" as sample
-@load "./examples/samples/hat-808.wav" as hat
+@import { duration, default_bank, params, loopCount, tempo } from "./examples/variables.deva"
+@import { myGroup } from "./examples/group.deva"
+
+@load "./examples/samples/kick-808.wav" as kickCustom
+@load "./examples/samples/hat-808.wav" as hatCustom
 
 bpm tempo
 
 bank default_bank
 
-loop loopCount:
-    .sample duration params
-
-    # Uncomment the next line (.hat) while executing "play" command 
-    # with `--repeat` option to see magic happen !
+# Will be executed line by line (sequentially)
+call myGroup
 
-    # .hat duration params
+# Will be executed in parallel (concurrently)
+# spawn myGroup

package/examples/loop.deva

@@ -0,0 +1,15 @@
+# This file demonstrates the use of a loop in Devalang.
+
+@import { duration, default_bank, params, loopCount, tempo } from "./examples/variables.deva"
+
+@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
+

package/examples/variables.deva

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

package/package.json

@@ -1,42 +1,44 @@
-{
-  "name": "@devaloop/devalang",
-  "private": false,
-  "version": "0.0.1-alpha.4",
-  "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",
-    "script:postbuild": "tsc && node out-tsc/scripts/postbuild.js",
-    "script:version:bump": "tsc && node out-tsc/scripts/version/index.js"
-  },
-  "homepage": "https://devalang.com",
-  "keywords": [
-    "devalang",
-    "music",
-    "sound",
-    "domain-specific language",
-    "dsl",
-    "programming language",
-    "sound design",
-    "music hacking",
-    "audio",
-    "synthesis",
-    "scripting",
-    "sound synthesis",
-    "music programming"
-  ],
-  "author": "Devaloop",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/devaloop-labs/devalang.git"
-  },
-  "dependencies": {
-    "@types/node": "^24.0.3"
-  }
+{
+  "name": "@devaloop/devalang",
+  "private": false,
+  "version": "0.0.1-alpha.7",
+  "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: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"
+  },
+  "homepage": "https://devalang.com",
+  "keywords": [
+    "devalang",
+    "music",
+    "sound",
+    "domain-specific language",
+    "dsl",
+    "programming language",
+    "sound design",
+    "music hacking",
+    "audio",
+    "synthesis",
+    "scripting",
+    "sound synthesis",
+    "music programming"
+  ],
+  "author": "Devaloop",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/devaloop-labs/devalang.git"
+  },
+  "dependencies": {
+    "@types/node": "^24.0.3"
+  }
 }

package/project-version.json

@@ -1,6 +1,6 @@
-{
-  "version": "0.0.1-alpha.4",
-  "channel": "alpha",
-  "lastCommit": "ca5336b3cd3f2189971e9e99a93a66042faff007",
-  "build": 3
+{
+  "version": "0.0.1-alpha.7",
+  "channel": "alpha",
+  "lastCommit": "81db490b7d9cc92f0512b49cf3dbaeb74cf57de1",
+  "build": 6
 }

package/rust/cli/build.rs

@@ -1,5 +1,4 @@
 use crate::{
-    audio::render::render_audio_with_modules,
     config::Config,
     core::{
         builder::Builder,
@@ -12,6 +11,7 @@ use crate::{
 };
 use std::{ thread, time::Duration };
 
+#[cfg(feature = "cli")]
 pub fn handle_build_command(
     config: Option<Config>,
     entry: Option<String>,
@@ -104,7 +104,7 @@ fn begin_build(entry: String, output: String) {
 
     // SECTION Load
     // NOTE: We use modules in the build command, so we need to load them
-    let (modules_tokens, modules_statements) = module_loader.load_all(&mut global_store);
+    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());
@@ -116,12 +116,12 @@ fn begin_build(entry: String, output: String) {
 
     // SECTION Building AST and Audio
     let builder = Builder::new();
-    builder.build_ast(&modules_statements);
+    builder.build_ast(&modules_statements, &normalized_output_dir);
     builder.build_audio(&modules_statements, &normalized_output_dir, &mut global_store);
 
     // SECTION Logging
     let logger = Logger::new();
-    
+
     let success_message = format!(
         "Build completed successfully in {:.2?}. Output files written to: '{}'",
         duration.elapsed(),

package/rust/cli/check.rs

@@ -9,6 +9,7 @@ use crate::{
 };
 use std::{ thread, time::Duration };
 
+#[cfg(feature = "cli")]
 pub fn handle_check_command(
     config: Option<Config>,
     entry: Option<String>,
@@ -101,7 +102,7 @@ fn begin_check(entry: String, output: String) {
 
     // SECTION Load
     // NOTE: We don't use modules in the check command, but we still need to load them
-    let modules = module_loader.load_all(&mut global_store);
+    let modules = module_loader.load_all_modules(&mut global_store);
 
     // TODO: Implement debugging
 

package/rust/cli/init.rs

@@ -1,11 +1,13 @@
 use std::{ fs, path::Path };
 use include_dir::{ include_dir, Dir };
-use inquire::{ Select, Confirm };
-
 use crate::{ cli::template::get_available_templates, utils::file::copy_dir_recursive };
 
+#[cfg(feature = "cli")]
+use inquire::{ Select, Confirm };
+
 static TEMPLATES_DIR: Dir = include_dir!("$CARGO_MANIFEST_DIR/templates");
 
+#[cfg(feature = "cli")]
 pub fn handle_init_command(name: Option<String>, template: Option<String>) {
     let current_dir = std::env::current_dir().unwrap();
     let project_name = name

package/rust/cli/play.rs

@@ -1,5 +1,4 @@
 use crate::{
-    audio::player::AudioPlayer,
     config::Config,
     core::{
         builder::Builder,
@@ -15,6 +14,7 @@ use std::{ path::Path, sync::mpsc::channel, thread, time::Duration };
 use std::fs;
 use std::collections::HashMap;
 
+#[cfg(feature = "cli")]
 pub fn handle_play_command(
     config: Option<Config>,
     entry: Option<String>,
@@ -22,6 +22,8 @@ pub fn handle_play_command(
     watch: bool,
     repeat: bool
 ) {
+    use crate::core::audio::player::AudioPlayer;
+
     let logger = Logger::new();
 
     let entry_path = entry
@@ -144,7 +146,7 @@ fn begin_play(config: &Option<Config>, entry_file: &str, output: &str) {
     let duration = std::time::Instant::now();
     let mut global_store = GlobalStore::new();
     let loader = ModuleLoader::new(&normalized_entry, &normalized_output_dir);
-    let (modules_tokens, modules_statements) = loader.load_all(&mut global_store);
+    let (modules_tokens, modules_statements) = loader.load_all_modules(&mut global_store);
 
     // SECTION Write logs
     write_lexer_log_file(&normalized_output_dir, "lexer_tokens.log", modules_tokens.clone());
@@ -156,7 +158,7 @@ fn begin_play(config: &Option<Config>, entry_file: &str, output: &str) {
 
     // SECTION Building AST and Audio
     let builder = Builder::new();
-    builder.build_ast(&modules_statements);
+    builder.build_ast(&modules_statements, &output);
     builder.build_audio(&modules_statements, &output, &mut global_store);
 
     // SECTION Logging

package/rust/cli/template.rs

@@ -1,9 +1,9 @@
 use include_dir::{ include_dir, Dir, DirEntry };
-
 use crate::utils::file::format_file_size;
 
 static TEMPLATES_DIR: Dir = include_dir!("$CARGO_MANIFEST_DIR/templates");
 
+#[cfg(feature = "cli")]
 pub fn handle_template_list_command() {
     let available_templates = get_available_templates();
 
@@ -16,6 +16,7 @@ pub fn handle_template_list_command() {
     println!("\nUsage : devalang init --name <project-name> --template <template-name>");
 }
 
+#[cfg(feature = "cli")]
 pub fn handle_template_info_command(name: String) {
     let template_dir = TEMPLATES_DIR.get_dir(name.clone()).unwrap_or_else(|| {
         println!("❌ The template '{}' is not found.", name);

package/rust/config/loader.rs

@@ -1,5 +1,4 @@
 use std::{ fs, path::Path };
-
 use crate::config::Config;
 
 pub fn load_config(path: Option<&Path>) -> Option<Config> {

package/rust/{audio → core/audio}/engine.rs

@@ -2,11 +2,7 @@ use std::{ collections::HashMap, fs::File, io::BufReader };
 use hound::{ SampleFormat, WavSpec, WavWriter };
 use rodio::{ Decoder, Source };
 
-use crate::core::{
-    parser::statement::Statement,
-    store::variable::VariableTable,
-    utils::path::normalize_path,
-};
+use crate::core::{ store::variable::VariableTable, utils::path::normalize_path };
 
 const SAMPLE_RATE: u32 = 44100;
 const CHANNELS: u16 = 2;