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

package/rust/utils/spinner.rs

@@ -1,6 +1,8 @@
+#[cfg(feature = "cli")]
 use indicatif::{ ProgressBar, ProgressStyle };
 use std::{ time::Duration };
 
+#[cfg(feature = "cli")]
 pub fn with_spinner<T, F>(start_msg: &str, f: F) -> T where F: FnOnce() -> T {
     let spinner = ProgressBar::new_spinner();
     spinner.set_style(

package/templates/minimal/.devalang

@@ -1,4 +1,5 @@
 [defaults]
 entry = "./src"
 output = "./output"
-watch = false
+watch = false
+repeat = false

package/templates/minimal/README.md

@@ -0,0 +1,202 @@
+<div align="center">
+    <img src="https://firebasestorage.googleapis.com/v0/b/devaloop-labs.firebasestorage.app/o/devalang-teal-logo.svg?alt=media&token=d2a5705a-1eba-4b49-88e6-895a761fb7f7" alt="Devalang Logo">
+</div>
+
+![Rust](https://img.shields.io/badge/Made%20with-Rust-orange?logo=rust)
+![TypeScript](https://img.shields.io/badge/Built%20with-TypeScript-blue?logo=typescript)
+![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)
+![License: MIT](https://img.shields.io/badge/license-MIT-green)
+![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)
+
+## 🎼 Devalang, by **Devaloop Labs**
+
+🎶 Compose music with code — simple, structured, sonic.
+
+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.
+
+From studio sketches to live sets, Devalang gives you rhythmic control — with the elegance of code.
+
+> 🚧 **v0.0.1-alpha.5 Notice** 🚧
+>
+> Currently, Devalang CLI is only available for **Windows**.  
+> Linux and macOS binaries will be added in future releases via cross-platform builds.
+
+---
+
+## 📚 Quick Access
+
+- [📖 Documentation](./docs/)
+- [💡 Examples](./examples/)
+- [🌐 Project Website](https://devalang.com)
+
+## 🚀 Features
+
+- 🎵 **Audio Engine**: Integrated audio playback and rendering
+- 🧩 **Module system** for importing and exporting variables between files
+- 📜 **Structured AST** generation for debugging and future compilation
+- 🔢 **Basic data types**: strings, numbers, booleans, maps, arrays
+- 👁️ **Watch mode** for `build`, `check` and `play` commands
+- 📂 **Project templates** for quick setup
+
+## 📆 Installation
+
+### For users
+
+> - ⚠️ Requires [Node.js 18+](https://nodejs.org/en/download)
+
+Install the package globally (NPM)
+
+```bash
+npm install -g @devaloop/devalang
+```
+
+Usage without install (NPX)
+
+```bash
+npx @devaloop/devalang <command>
+```
+
+### For contributors
+
+> - ⚠️ Requires [Node.js 18+](https://nodejs.org/en/download)
+> - ⚠️ Requires [Rust 1.70+](https://www.rust-lang.org/learn/get-started#installing-rust)
+
+```bash
+> git clone https://github.com/devaloop-labs/devalang.git
+> cd devalang
+> npm install
+> cargo install --path .
+```
+
+Development usage (you can customize arguments in package.json)
+
+```bash
+# For syntax checking test
+npm run rust:dev:check
+# For building test
+npm run rust:dev:build
+```
+
+## ❔ Usage
+
+NOTE: Commands are available via `devalang` or `npx @devaloop/devalang`.
+
+NOTE: Arguments can be passed to commands using `--<argument>` syntax. You can also use a configuration file to set default values for various settings, making it easier to manage your Devalang project.
+
+NOTE: Some commands require a mandatory `--entry` argument to specify the input folder, and a `--output` argument to specify the output folder. If not specified, they default to `./src` and `./output` respectively.
+
+For more examples, see [docs/COMMANDS.md](./docs/COMMANDS.md)
+
+### Initialize a new project
+
+In the current directory
+
+```bash
+devalang init
+```
+
+Or use optional arguments to specify a directory name and a template
+
+```bash
+devalang init --name <project-name> --template <template-name>
+```
+
+### Checking syntax only
+
+```bash
+devalang check --watch
+```
+
+### Building output files
+
+```bash
+devalang build --watch
+```
+
+### Playing audio files (once by file change)
+
+```bash
+devalang play --watch
+```
+
+### Playing audio files (continuous playback, even without file changes)
+
+```bash
+devalang play --repeat
+```
+
+## ⚙️ Configuration
+
+You can use a configuration file to set default values for various settings, making it easier to manage your Devalang project.
+
+To do this, create a `.devalang` file in the root of your project directory.
+
+See [docs/CONFIG.md](./docs/CONFIG.md) for more information.
+
+## 📄 Syntax example
+
+For more examples, see [docs/SYNTAX.md](./docs/SYNTAX.md)
+
+```deva
+# index.deva
+
+@import { globalBpm, globalBank, kickDuration } from "global.deva"
+
+@load "./examples/samples/kick-808.wav" as customKick
+
+bpm globalBpm
+# Will declare the tempo at the globalBpm variable beats per minute
+
+bank globalBank
+# Will declare a custom instrument bank using the globalBank variable
+
+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
+```
+
+```deva
+# global.deva
+
+let globalBpm = 120
+let globalBank = 808
+let kickDuration = 500
+
+@export { globalBpm, globalBank, kickDuration }
+```
+
+## 🧯 Known issues
+
+- No support yet for `if`, `else`, `else if` statements
+- No support yet for `@group`, `@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`, ...)
+- ⏳ Cross-platform support (Linux, macOS)
+- ⏳ More built-in instruments (e.g. snare, hi-hat, etc.)
+
+## 🛡️ License
+
+MIT — see [LICENSE](./LICENSE)
+
+## 🤝 Contributing
+
+Contributions, bug reports and suggestions are welcome !  
+Feel free to open an issue or submit a pull request.
+
+## 📢 Contact
+
+📧 [contact@devaloop.com](mailto:contact@devaloop.com)

package/templates/welcome/.devalang

@@ -1,4 +1,5 @@
 [defaults]
 entry = "./src"
 output = "./output"
-watch = false
+watch = false
+repeat = false

package/templates/welcome/README.md

@@ -11,44 +11,41 @@
 ![License: MIT](https://img.shields.io/badge/license-MIT-green)
 ![Platform](https://img.shields.io/badge/platform-Windows-blue)
 
-![npm](https://img.shields.io/npm/dm/@devaloop/devalang)
+![npm](https://img.shields.io/npm/dt/@devaloop/devalang)
+![crates](https://img.shields.io/crates/d/devalang)
 
 ## 🎼 Devalang, by **Devaloop Labs**
 
 🎶 Compose music with code — simple, structured, sonic.
 
 Devalang is a tiny domain-specific language (DSL) for music makers, sound designers, and audio hackers.
-Compose loops, control samples, and automate parameters — all in clean, readable text.
+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.
 
 From studio sketches to live sets, Devalang gives you rhythmic control — with the elegance of code.
 
-> 🚧 **v0.0.1-alpha.1 Notice** 🚧
->
-> Devalang is still in early development. This version does not yet include **sound rendering**.
->
-> You can parse code, generate the AST, and validate syntax — all essential building blocks for the upcoming audio engine.
->
-> Currently, only `.kick` is included as a built-in trigger.
-> Custom instruments can be defined with `@load`, allowing any sound sample to be triggered with the same syntax.
+> 🚧 **v0.0.1-alpha.5 Notice** 🚧
 >
 > Currently, Devalang CLI is only available for **Windows**.  
 > Linux and macOS binaries will be added in future releases via cross-platform builds.
 
+---
+
+## 📚 Quick Access
+
+- [📖 Documentation](./docs/)
+- [💡 Examples](./examples/)
+- [🌐 Project Website](https://devalang.com)
+
 ## 🚀 Features
 
-- 🧩 Module system for importing and exporting variables between files (`@import`, `@export`)
-- 📜 Structured AST generation for debugging and future compilation
-- 🔢 Basic data types: strings, numbers, booleans, maps, arrays
-- 👁️ Watch mode for `build` and `check` commands
-- ⏱️ `bpm` assignment for setting tempo
-- 🧱 `bank` declaration to define the instrument set
-- 🔁 Looping system with fixed repetitions (`loop 4:`)
-- 🧪 Instruction calls with parameters (e.g. `.kick auto {reverb:10, decay:20}`) for testing pattern syntax
-- 📄 `let` assignments for storing reusable values
-- 🔄 `@load` assignment to load a sample (.mp3, .wav) to use it as a value
-- 🛠️ CLI tools for syntax checking (`check`), AST output (`build`)
+- 🎵 **Audio Engine**: Integrated audio playback and rendering
+- 🧩 **Module system** for importing and exporting variables between files
+- 📜 **Structured AST** generation for debugging and future compilation
+- 🔢 **Basic data types**: strings, numbers, booleans, maps, arrays
+- 👁️ **Watch mode** for `build`, `check` and `play` commands
+- 📂 **Project templates** for quick setup
 
 ## 📆 Installation
 
@@ -80,15 +77,23 @@ npx @devaloop/devalang <command>
 > cargo install --path .
 ```
 
-Usage for development (feel free to change arguments in package.json)
+Development usage (you can customize arguments in package.json)
 
 ```bash
 # For syntax checking test
-npm run rust:dev <command>
+npm run rust:dev:check
+# For building test
+npm run rust:dev:build
 ```
 
 ## ❔ Usage
 
+NOTE: Commands are available via `devalang` or `npx @devaloop/devalang`.
+
+NOTE: Arguments can be passed to commands using `--<argument>` syntax. You can also use a configuration file to set default values for various settings, making it easier to manage your Devalang project.
+
+NOTE: Some commands require a mandatory `--entry` argument to specify the input folder, and a `--output` argument to specify the output folder. If not specified, they default to `./src` and `./output` respectively.
+
 For more examples, see [docs/COMMANDS.md](./docs/COMMANDS.md)
 
 ### Initialize a new project
@@ -105,16 +110,28 @@ Or use optional arguments to specify a directory name and a template
 devalang init --name <project-name> --template <template-name>
 ```
 
-### Checking syntax only and output debug files
+### Checking syntax only
 
 ```bash
-devalang check --entry <entry-directory> --output <output-directory> --watch
+devalang check --watch
 ```
 
-### Building output file(s) (AST generation for the moment)
+### Building output files
 
 ```bash
-devalang build --entry <entry-directory> --output <output-directory> --watch
+devalang build --watch
+```
+
+### Playing audio files (once by file change)
+
+```bash
+devalang play --watch
+```
+
+### Playing audio files (continuous playback, even without file changes)
+
+```bash
+devalang play --repeat
 ```
 
 ## ⚙️ Configuration
@@ -134,6 +151,8 @@ For more examples, see [docs/SYNTAX.md](./docs/SYNTAX.md)
 
 @import { globalBpm, globalBank, kickDuration } from "global.deva"
 
+@load "./examples/samples/kick-808.wav" as customKick
+
 bpm globalBpm
 # Will declare the tempo at the globalBpm variable beats per minute
 
@@ -141,7 +160,7 @@ bank globalBank
 # Will declare a custom instrument bank using the globalBank variable
 
 loop 5:
-    .kick kickDuration {reverb=50, drive=25}
+    .customKick kickDuration {reverb=50, drive=25}
     # Will play 5 times a kick for the duration of the kickDuration variable with reverb and drive effects
 ```
 
@@ -157,16 +176,14 @@ let kickDuration = 500
 
 ## 🧯 Known issues
 
-- No support yet for Audio Engine
 - No support yet for `if`, `else`, `else if` statements
 - No support yet for `@group`, `@pattern`, `@function` statements
-- Nested loops and conditions may not be fully tested
+- No support yet for cross-platform builds (Linux, macOS)
 
 ## 🧪 Roadmap Highlights
 
 For more info, see [docs/ROADMAP.md](./docs/ROADMAP.md)
 
-- ⏳ Audio engine integration
 - ⏳ Other statements (e.g `if`, `@group`, ...)
 - ⏳ Cross-platform support (Linux, macOS)
 - ⏳ More built-in instruments (e.g. snare, hi-hat, etc.)

package/examples/exported.deva

@@ -1,7 +0,0 @@
-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/rust/audio/interpreter.rs

@@ -1,143 +0,0 @@
-use crate::{
-    audio::{ engine::AudioEngine, loader::load_trigger },
-    core::{
-        parser::statement::{ Statement, StatementKind },
-        shared::value::Value,
-        store::variable::VariableTable,
-    },
-};
-
-pub fn interprete_statements(
-    statements: &Vec<Statement>,
-    audio_engine: AudioEngine,
-    entry: String,
-    output: String
-) -> (AudioEngine, f32, f32) {
-    let mut base_bpm = 120.0;
-    let mut base_duration = 60.0 / base_bpm;
-
-    let variable_table = audio_engine.variables.clone();
-
-    let (updated_audio_engine, base_bpm, max_end_time) = execute_audio_statements(
-        audio_engine.clone(),
-        variable_table.clone(),
-        statements.clone(),
-        base_bpm.clone(),
-        base_duration.clone(),
-        0.0,
-        0.0
-    );
-
-    (updated_audio_engine, base_bpm, max_end_time)
-}
-
-pub fn execute_audio_statements(
-    mut audio_engine: AudioEngine,
-    mut variable_table: VariableTable,
-    mut statements: Vec<Statement>,
-    mut base_bpm: f32,
-    mut base_duration: f32,
-    mut max_end_time: f32,
-    mut cursor_time: f32
-) -> (AudioEngine, f32, f32) {
-    for stmt in statements {
-        match &stmt.kind {
-            StatementKind::Load { source, alias } => {
-                variable_table.set(alias.to_string(), Value::String(source.clone()));
-            }
-
-            StatementKind::Let { name } => {
-                variable_table.set(name.to_string(), stmt.value.clone());
-            }
-
-            StatementKind::Tempo => {
-                if let Value::Number(bpm_) = &stmt.value {
-                    base_bpm = *bpm_ as f32;
-                    base_duration = 60.0 / base_bpm;
-                } else {
-                    eprintln!("❌ Invalid tempo value: {:?}", stmt.value);
-                }
-            }
-
-            StatementKind::Trigger { entity, duration } => {
-                if let Some(trigger_val) = variable_table.get(entity) {
-                    let (src, duration_secs) = load_trigger(
-                        trigger_val,
-                        duration,
-                        base_duration,
-                        variable_table.clone()
-                    );
-
-                    audio_engine.insert(&src, cursor_time, duration_secs, None);
-
-                    cursor_time += duration_secs;
-
-                    if cursor_time > max_end_time {
-                        max_end_time = cursor_time;
-                    }
-                } else {
-                    eprintln!("❌ Unknown trigger entity: {}", entity);
-                }
-            }
-
-            StatementKind::Loop => {
-                if let Value::Map(loop_value) = &stmt.value {
-                    let iterator = loop_value.get("iterator");
-                    let body = loop_value.get("body");
-
-                    let loop_count = if let Some(Value::Number(n)) = iterator {
-                        *n as usize
-                    } else {
-                        eprintln!("❌ Loop iterator must be a number: {:?}", iterator);
-                        continue;
-                    };
-
-                    let loop_body = if let Some(Value::Block(body)) = body {
-                        body.clone()
-                    } else {
-                        eprintln!("❌ Loop body must be a block: {:?}", body);
-                        continue;
-                    };
-
-                    for _ in 0..loop_count {
-                        let (loop_engine, _, loop_end_time) = execute_audio_statements(
-                            audio_engine.clone(),
-                            variable_table.clone(),
-                            loop_body.clone(),
-                            base_bpm,
-                            base_duration,
-                            max_end_time,
-                            cursor_time
-                        );
-
-                        audio_engine = loop_engine;
-
-                        // Update time and max_end_time after each loop iteration
-                        cursor_time = loop_end_time;
-                        if loop_end_time > max_end_time {
-                            max_end_time = loop_end_time;
-                        }
-                    }
-                }
-            }
-
-            StatementKind::Bank => {}
-
-            StatementKind::Import { names, source } => {}
-
-            StatementKind::Export { names, source } => {}
-
-            StatementKind::Unknown => {
-                // Ignore unknown statements
-            }
-
-            _ => {
-                eprintln!("Unsupported statement kind: {:?}", stmt);
-            }
-        }
-    }
-
-    audio_engine.set_variables(variable_table);
-
-    (audio_engine, base_bpm, max_end_time)
-}