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

package/.devalang

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

package/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "devalang"
-version = "0.0.1-alpha.10"
+version = "0.0.1-alpha.12"
 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"
@@ -27,7 +27,7 @@ opt-level = "s"
 
 [features]
 default = ["cli"]
-cli = ["crossterm", "indicatif", "inquire"]
+cli = ["crossterm", "indicatif", "inquire", "zip", "reqwest", "flate2", "tokio"]
 
 [dependencies]
 clap = { version = "4.5", features = ["derive"] }
@@ -47,3 +47,7 @@ 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 }

package/README.md

@@ -1,5 +1,5 @@
 <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">
+    <img src="https://devalang.com/images/devalang-logo-cyan.svg" alt="Devalang Logo" width="300" />
 </div>
 
 ![Rust](https://img.shields.io/badge/Made%20with-Rust-orange?logo=rust)
@@ -16,9 +16,9 @@
 
 [![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**
+# 🎶 Devalang
 
-🎶 Compose music with code — structured, expressive, and fast.
+Compose music with code — structured, expressive, and fast.
 
 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.
@@ -27,192 +27,109 @@ 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.10 Notice** 🚧
+> 🚧 **v0.0.1-alpha.11 Notice** 🚧
 >
-> NEW: Online documentation is now available at [docs.devalang.com](https://docs.devalang.com).
+> NEW: Devalang is available in your browser at [playground.devalang.com](https://playground.devalang.com) !
 >
-> NEW: Devalang VSCode extension is now available !
-> [Get it here](https://marketplace.visualstudio.com/items?itemName=devaloop.devalang-vscode).
+> NEW: Online documentation is now available at [docs.devalang.com](https://docs.devalang.com)
 >
 > Includes synthesis, playback, and rendering features, but is still in early development.
 >
 > Currently, Devalang CLI is only available for **Windows**.  
 > Linux and macOS binaries will be added in future releases via cross-platform builds.
 
----
-
 ## 📚 Quick Access
 
+- [▶️ Playground](https://playground.devalang.com)
 - [📖 Documentation](https://docs.devalang.com)
-- [💡 Examples](./examples/)
 - [🧩 VSCode Extension](https://marketplace.visualstudio.com/items?itemName=devaloop.devalang-vscode)
 - [🎨 Prettier Plugin](https://www.npmjs.com/package/@devaloop/prettier-plugin-devalang)
+- [📜 Changelog](./docs/CHANGELOG.md)
+- [💡 Examples](./examples/)
 - [🌐 Project Website](https://devalang.com)
+- [📦 Devalang CLI on npm](https://www.npmjs.com/package/@devaloop/devalang)
 
-## ❓ Why Devalang?
-
-- 🎹 Prototype audio ideas without opening a DAW
-- 💻 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.
-
-## 🚀 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
-- 🎛️ **Custom samples**: easily load and trigger your own audio files
-- 🔄 **Looping and grouping**: create complex patterns with ease
+## ⏱️ Try it now !
 
-## 📆 Installation
-
-### For users
-
-> ⚠️ Requires [Node.js 18+](https://nodejs.org/en/download)
-
-For Node users (NPM)
+### You can also have a look at the [Playground](https://playground.devalang.com) to try Devalang directly in your browser
 
 ```bash
-npm install -g @devaloop/devalang@latest
-```
-
-> ⚠️ Requires [Rust 1.70+](https://www.rust-lang.org/learn/get-started#installing-rust)
-
-For Rust users (Cargo)
+# Install Devalang CLI globally
+npm install -g @devaloop/devalang
 
-```bash
-cargo install devalang
+# Create a new Devalang project
+devalang init --name my-project --template minimal
+cd my-project
 ```
 
-### 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
-```
-
-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`.
+Create a new Devalang file `src/index.deva` in the project directory:
 
-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
-```
+```deva
+# src/index.deva
 
-Or use optional arguments to specify a directory name and a template
+group myLead:
+    let mySynth = synth sine
 
-```bash
-devalang init --name <project-name> --template <template-name>
-```
+    mySynth -> note(C4, { duration: 400 })
+    mySynth -> note(G4, { duration: 600 })
 
-### Checking syntax only
+# Play the lead
 
-```bash
-devalang check --watch
+call myLead
 ```
 
-### Building output files
+And the best part ? You can play it directly from the command line:
 
 ```bash
-devalang build --watch
-```
-
-### Playing audio files (once by file change)
+# Play the Devalang file
+devalang play
 
-```bash
+# Play the Devalang file with watch mode
 devalang play --watch
-```
-
-### Playing audio files (continuous playback, even without file changes)
 
-```bash
+# LIVE mode (repeat the playback + watch mode)
 devalang play --repeat
 ```
 
-## ⚙️ Configuration
+### 🎉 You can now hear your Devalang code in action!
 
-You can use a configuration file to set default values for various settings, making it easier to manage your Devalang project.
+> For more examples, check out the [examples directory](./examples/).
 
-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
+## ❓ Why Devalang?
 
-bank globalBank
-# Will declare a custom instrument bank using the globalBank variable
+- 🎹 Prototype audio ideas without opening a DAW
+- 💻 Integrate sound into code-based workflows
+- 🎛️ Control audio parameters through readable syntax
+- 🧪 Build musical logic with variables and conditions
 
-loop 5:
-    .customKick kickDuration {reverb=50, drive=25}
-    # Will play 5 times a custom sample for 500ms with reverb and overdrive effects
+> Producer, coder, or both — Devalang gives you musical structure, instantly.
 
-group myGroup:
-    .customKick kickDuration {reverb=50, drive=25}
-    # Will play the same sample in a group, allowing for more complex patterns
+## 🚀 Features
 
-call myGroup
-# Will be executed line by line (sequentially)
+- 🎵 **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
+- 🎛️ **Custom samples**: easily load and trigger your own audio files
+- 🔄 **Looping and grouping**: create complex patterns with ease
 
-# spawn myGroup
-# Will be executed in parallel (concurrently)
-# ⚠️ Note: `spawn` runs the entire group in parallel, but the group’s internal logic remains sequential unless it uses `spawn` internally.
-```
+## 📄 Documentation
 
-> 🧠 Note: `call` and `spawn` only work with `group` blocks. They do not apply to individual samples or other statements.
+### Please refer to the [online documentation](https://docs.devalang.com) for detailed information on syntax, features, and usage examples.
 
-```deva
-# variables.deva
+## 📜 Changelog Highlights
 
-let globalBpm = 120
-let globalBank = 808
-let kickDuration = 500
+For a complete list of changes, see [docs/CHANGELOG.md](./docs/CHANGELOG.md)
 
-@export { globalBpm, globalBank, kickDuration }
-```
+- 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
 

package/docs/CHANGELOG.md

@@ -1,9 +1,68 @@
 <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">
+    <img src="https://devalang.com/images/devalang-logo-cyan.svg" alt="Devalang Logo" width="300" />
 </div>
 
 # Changelog
 
+## Version 0.0.1-alpha.12 (2025-07-21)
+
+### 🧩 Language Features
+
+- Implemented `trigger` effects to apply effects to triggers, allowing for more dynamic sound manipulation.
+  - Example: `.myTrigger auto { reverb: 1.0, pitch: 1.5, gain: 0.8 }`
+
+### 🧠 Core Engine
+
+- Moved `utils::installer` to `installer::utils` to better organize the project structure.
+- Set CLI dependencies as optional in `Cargo.toml` to allow for a cleaner build without CLI features.
+- Patched `@load` relative path resolution to ensure correct loading of external resources.
+- Patched `trigger` statement that was not correctly parsed when using namespaced banks of sounds.
+
+### 🧩 Web Assembly
+
+- Patched `lib.rs` dependencies to ensure compatibility with the latest Rust and WASM standards.
+
+## Version 0.0.1-alpha.11 (2025-07-20)
+
+### 📖 Documentation
+
+- Removed old documentation, please refer to the [new documentation website](https://docs.devalang.com) for the latest information.
+
+### ✨ Syntax
+
+- Added namespaced banks of sounds, allowing for better organization and management of sound banks.
+  - Example: `.808.myTrigger` to access a specific trigger in the `808` bank.
+- Added support for beat durations in `triggers` statements, allowing for more precise timing control.
+  - Example: `.myTrigger 1/4 { ... }` to trigger the sound every quarter beat.
+- Added support for beat durations in `arrow_calls` statements, allowing for more precise timing control.
+  - Example: `mySynth -> note(C4, { duration: 1/8 })` to play a note for an eighth beat.
+
+### 🧠 Core Engine
+
+- Implemented `bank` resolver to resolve banks of sounds in the code.
+  - Example: `bank 808` will resolve to a bank of sounds named `808` if exists (check bank available command).
+
+### 🧰 Commands
+
+> Use the `bank 808` statement to access the default sounds and triggers !
+> Then you can use `808.myTrigger` to access a specific trigger in the `808` bank.
+
+- Added `bank` command to manage banks of sounds.
+
+  - `bank list` to list installed banks of sounds.
+  - `bank available` to list available banks of sounds for installation.
+  - `bank info <bank_name>` to show information about a specific bank.
+  - `bank remove <bank_name>` to remove a bank.
+  - `bank update` to update all banks of sounds.
+  - `bank update <bank_name>` to update a specific bank.
+
+- Added `install` command to install banks of sounds.
+  - `install bank <bank_name>` to install a specific bank of sounds.
+
+### 🧪 Experimental
+
+- Introduced lazy loading and namespace-based resolution of installed sound banks.
+
 ## Version 0.0.1-alpha.10 (2025-07-19)
 
 ### 📖 Documentation

package/docs/ROADMAP.md

@@ -1,5 +1,5 @@
 <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">
+        <img src="https://devalang.com/images/devalang-logo-cyan.svg" alt="Devalang Logo" width="300" />
 </div>
 
 # Roadmap

package/docs/TODO.md

@@ -1,5 +1,5 @@
 <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">
+    <img src="https://devalang.com/images/devalang-logo-cyan.svg" alt="Devalang Logo" width="300" />
 </div>
 
 # TODOs list

package/examples/bank.deva

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

package/examples/duration.deva

@@ -0,0 +1,9 @@
+# This file demonstrates the use of duration in Devalang.
+
+@load "./samples/kick-808.wav" as kickCustom
+@load "./samples/hat-808.wav" as hatCustom
+
+.kickCustom 1/4
+.hatCustom 1/8
+.kickCustom 1/4
+.hatCustom 1/8

package/examples/index.deva

@@ -7,12 +7,12 @@
 @load "./samples/kick-808.wav" as kickCustom
 @load "./samples/hat-808.wav" as hatCustom
 
-bpm tempo
+# bpm tempo
 
-bank default_bank
+# group myTrack:
+#     spawn myLoop
+#     spawn myLead
 
-group myTrack:
-    spawn myLoop
-    spawn myLead
+# call myTrack
 
-call myTrack
+.kickCustom duration { gain: 1, pitch: 1.25 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@devaloop/devalang",
   "private": false,
-  "version": "0.0.1-alpha.10",
+  "version": "0.0.1-alpha.12",
   "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": {
@@ -11,6 +11,7 @@
     "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: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",

package/project-version.json

@@ -1,6 +1,6 @@
 {
-  "version": "0.0.1-alpha.10",
+  "version": "0.0.1-alpha.12",
   "channel": "alpha",
-  "lastCommit": "a3649180a74374e193198131f4192a15f67009a5",
-  "build": 9
+  "lastCommit": "e16a21167693d0265195bf4256b3f8ec0ed1e55f",
+  "build": 11
 }