@devaloop/devalang 0.0.1-alpha.1 → 0.0.1-alpha.11

package/.devalang

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

package/Cargo.toml

@@ -1,20 +1,22 @@
 [package]
 name = "devalang"
-version = "0.0.1-alpha.1"
+version = "0.0.1-alpha.11"
 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://devaloop.com"
-documentation = "https://docs.rs/devalang"
+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,4 +44,11 @@ serde-wasm-bindgen = "0.4"
 nom_locate = "4.0.0"
 chrono = "0.4"
 crossterm =  { version = "0.27", optional = true }
-indicatif = "0.17"
+indicatif = { version = "0.17", optional = true }
+inquire = { version = "0.7.5", optional = true }
+js-sys = "0.3"
+reqwest = { version = "0.12.22", features = ["json"] }
+flate2 = "1.0"
+tar = "0.4"
+tokio = { version = "1", features = ["full"] }
+zip = "4.3.0"

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)
@@ -11,141 +11,139 @@
 ![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**
+[![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)
 
-🎶 Compose music with code — simple, structured, sonic.
+# 🎶 Devalang
+
+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, 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** 🚧
+> 🚧 **v0.0.1-alpha.11 Notice** 🚧
 >
-> Devalang is still in early development. This version does not yet include **sound rendering**.
+> NEW: Devalang is available in your browser at [playground.devalang.com](https://playground.devalang.com) !
 >
-> You can parse code, generate the AST, and validate syntax — all essential building blocks for the upcoming audio engine.
+> NEW: Online documentation is now available at [docs.devalang.com](https://docs.devalang.com)
 >
-> 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.
+> 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.
 
-## 🚀 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
-- ⏱️ `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`)
+## 📚 Quick Access
 
-## 📆 Installation
+- [▶️ Playground](https://playground.devalang.com)
+- [📖 Documentation](https://docs.devalang.com)
+- [🧩 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)
 
-### For users
+## ⏱️ Try it now !
 
-> - ⚠️ Requires [Node.js 18+](https://nodejs.org/en/download)
-
-Install the package globally (NPM)
+### You can also have a look at the [Playground](https://playground.devalang.com) to try Devalang directly in your browser
 
 ```bash
+# Install Devalang CLI globally
 npm install -g @devaloop/devalang
-```
-
-Usage without install (NPX)
 
-```bash
-npx @devaloop/devalang <command>
+# Create a new Devalang project
+devalang init --name my-project --template minimal
+cd my-project
 ```
 
-### For contributors
+Create a new Devalang file `src/index.deva` in the project directory:
 
-> - ⚠️ Requires [Node.js 18+](https://nodejs.org/en/download)
-> - ⚠️ Requires [Rust 1.70+](https://www.rust-lang.org/learn/get-started#installing-rust)
+```deva
+# src/index.deva
 
-```bash
-> git clone https://github.com/devaloop-labs/devalang.git
-> cd devalang
-> npm install
-> cargo install --path .
-```
+group myLead:
+    let mySynth = synth sine
 
-Usage for development (feel free to change arguments in package.json)
+    mySynth -> note(C4, { duration: 400 })
+    mySynth -> note(G4, { duration: 600 })
 
-```bash
-# For syntax checking test
-npm run rust:dev <command>
+# Play the lead
+
+call myLead
 ```
 
-## ❔ Usage
+And the best part ? You can play it directly from the command line:
 
-For more examples, see [docs/COMMANDS.md](./docs/COMMANDS.md)
+```bash
+# Play the Devalang file
+devalang play
 
-Checking syntax only and output debug files
+# Play the Devalang file with watch mode
+devalang play --watch
 
-```bash
-devalang check --entry <entry-directory> --output <output-directory>
+# LIVE mode (repeat the playback + watch mode)
+devalang play --repeat
 ```
 
-Building output file(s) (AST generation for the moment)
+### 🎉 You can now hear your Devalang code in action!
 
-```bash
-devalang build --entry <entry-directory> --output <output-directory>
-```
+> For more examples, check out the [examples directory](./examples/).
 
-## 📄 Syntax example
+## ❓ Why Devalang?
 
-For more examples, see [docs/SYNTAX.md](./docs/SYNTAX.md)
+- 🎹 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
 
-```deva
-# index.deva
+> Producer, coder, or both — Devalang gives you musical structure, instantly.
 
-@import { globalBpm, globalBank, kickDuration } from "global.deva"
+## 🚀 Features
 
-bpm globalBpm
-# Will declare the tempo at the globalBpm variable beats per minute
+- 🎵 **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
 
-bank globalBank
-# Will declare a custom instrument bank using the globalBank variable
+## 📄 Documentation
 
-loop 5:
-    .kick kickDuration {reverb=50, drive=25}
-    # Will play 5 times a kick for the duration of the kickDuration variable with reverb and drive effects
-```
+### Please refer to the [online documentation](https://docs.devalang.com) for detailed information on syntax, features, and usage examples.
 
-```deva
-# global.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
 
-- 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 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
 
 For more info, see [docs/ROADMAP.md](./docs/ROADMAP.md)
 
-- ⏳ Audio engine integration
-- ⏳ Other statements (e.g `if`, `@group`, ...)
-- ⏳ Watch mode for automatic rebuilds
+- ⏳ Other statements (e.g `function`, `pattern`, ...)
+- ⏳ Cross-platform support (Linux, macOS)
+- ⏳ More built-in instruments (e.g. snare, hi-hat, etc.)
 
 ## 🛡️ License
 

package/docs/CHANGELOG.md

@@ -0,0 +1,213 @@
+<div align="center">
+    <img src="https://devalang.com/images/devalang-logo-cyan.svg" alt="Devalang Logo" width="300" />
+</div>
+
+# Changelog
+
+## 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
+
+- Updated [new documentation website](https://docs.devalang.com) with new features and examples.
+
+### 🧠 Core Engine
+
+- Patched `call`, `spawn` to handle correct cursor time.
+- Patched `advance_char` to handle correct indentation and dedentation.
+- Patched `bank` resolver to handle numbers in bank names.
+- Patched `spawn` calls that was not calling a variable.
+
+### 🧩 Web Assembly
+
+- Added `load_wasm_module` function to the WASM module to load Devalang modules dynamically.
+- Added `render_audio` function to the WASM module to render audio files.
+
+## Version 0.0.1-alpha.9 (2025-07-14)
+
+### ✨ Syntax
+
+- Added support for `synth` directives to define synthesizer sounds directly in code  
+  → Example:
+
+  ```deva
+  let mySynth = synth sine
+  ```
+
+### 🧠 Core Engine
+
+- ✅ **Major refactor** of the resolution layer:
+
+  - `condition`, `loop`, `group`, `trigger`, `call`, `spawn`, and `driver` were fully rewritten
+  - Ensures **correct variable scoping**, **cross-module references**, and **imported symbol resolution**
+
+- ✅ Audio interpreter updated:
+  - `call` and `spawn` now execute correctly in parallel, preserving **temporal alignment** across groups
+
+### 🧩 Language Features
+
+- Improved `@import` behavior:
+  - Modules can now be imported using **relative paths only**
+  - No need for absolute or root-based imports
+
+## Version 0.0.1-alpha.8 (2025-07-12)
+
+### Syntax
+
+- Implemented `if` directive to conditionally execute blocks of code.
+- Implemented `else` directive to provide an alternative block of code when the `if` condition is not met.
+- Implemented `else if` directive to provide additional conditions for the `if` directive.
+
+### Core Components
+
+- Implemented evaluator for audio statements, to execute conditional statements.
+- Fixed `group` resolution and export issues.
+- Implemented `Global Store` debugger to inspect variables by module for build command.
+- Organized `TokenKind` and `StatementKind` enums for better clarity and maintainability.
+- Refactored audio interpreter to handle the new syntax and directives.
+- Refactored lexer to handle new directives and improve tokenization.
+- Refactored parser to handle new directives and improve parsing logic.
+- Added support for `call` and `spawn` execution of imported groups.
+- Enforced scoped resolution of groups in `spawn` and `call` (must be imported in current module).
+
+## Version 0.0.1-alpha.7 (2025-07-11)
+
+## Examples
+
+- Added examples in `examples` folder (group, loop, variables, index).
+
+## 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
+
+- Integrated Audio Engine to handle audio playback and rendering.
+- Implemented Audio Player to play audio files.
+- Added support for audio playback with the `play` command.
+
+### 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)
+
+- /!\ Major refactor of the project structure and module system /!\
+- Refactored module system to support multiple modules and submodules.
+- Patched all directives to be compatible with the new project structure.
+- Prepared for the upcoming audio engine integration and sound rendering capabilities.
+- Updated documentation to reflect the new project structure and features.
+
+## Version 0.0.1-alpha.2 (2025-06-26)
+
+### Commands
+
+- Implemented `init` command to initialize a new Devalang project.
+- Implemented `template` command to manage templates.
+  - Added `list` subcommand to list available templates.
+  - Added `info` subcommand to show information about a specific template.
+- Implemented `watch` subcommand for the `build` and `check` command to watch for changes in files and automatically rebuild or check them.
+
+### Core Components
+
+- Implemented Config manager to handle configuration files.
+  - Added support for `.devalang` configuration file as a TOML file.
+- Implemented File System watcher to monitor file changes.
+- Implemented Template manager to handle templates and their metadata.
+
+### Syntax
+
+- Added support for built-in triggers for `.snare`, `.hihat`, `.clap`, `.tom`, `.crash`, `.ride`, `.synth`, `.bass`, and `.pad`.
+
+## Version 0.0.1-alpha.1 (2025-06-25)
+
+### Syntax
+
+- Added support for `@import` directive to import other Devalang files.
+- Added support for `@export` directive to export variables and functions.
+- Added support for `@load` directive to load external resources.
+- Added support for `bpm` directive to set the beats per minute.
+- Added support for `bank` directive to define a bank of sounds.
+- Added support for `loop` directive to define loops in the code.
+
+### Commands
+
+- Implemented `check` command to check the syntax of Devalang files.
+- Implemented `build` command to build the Abstract Syntax Tree (AST) of Devalang files.
+
+### Core Components
+
+- Implemented Lexer to tokenize Devalang source code.
+- Implemented Parser to parse the tokens and build the AST.
+- Implemented Preprocessor to handle directives and preprocess the source code.
+- Implemented Debugger to debug Devalang code.
+- Implemented Builder to build the final output from the AST.

package/docs/ROADMAP.md

@@ -1,12 +1,16 @@
 <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
 
 Devalang is a work in progress. Here’s what we’re planning next:
 
+## Completed
+
+- ✅ **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`.
 - ✅ **AST generation**: Implement the Abstract Syntax Tree (AST) generation for debugging and future compilation.
 - ✅ **Basic data types**: Support strings, numbers, booleans, maps, and arrays.
@@ -16,12 +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.
+- ✅ **VSCode extension**: Create a VSCode extension for syntax highlighting and code completion.
+
+## 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.
-- ⏳ **Watch mode**: Add a watch mode to automatically rebuild on file changes.
-- ⏳ **Functions**: Add support for defining and calling functions.
-- ⏳ **Audio engine**: Integrate the audio engine for sound playback.
+- ⏳ **Smart modules**: Let Devalang detect and use groups, samples, and variables without needing to import them manually.
+- ⏳ **Other statements**: Implement `pattern`, `function`, and other control structures.
 - ⏳ **Testing**: Expand test coverage for all features.

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
@@ -8,26 +8,29 @@ This is a list of tasks and features to be implemented in Devalang. Note that th
 
 ## Commands
 
-- [ ] New project
-- [ ] Template
-  - [ ] Implement template list
-  - [ ] Implement template info
+- [x] Init project
+  - [x] Implement init command
+  - [x] Implement template selector
+  - [ ] Implement project name validation
+- [x] Template
+  - [x] Implement template list
+  - [x] Implement template info
 - [x] Checking
-  - [ ] Implement watch mode
+  - [x] Implement watch mode
   - [ ] Implement debug mode
   - [ ] Implement compilation mode
 - [x] Building
-  - [ ] Implement watch mode
+  - [x] Implement watch mode
   - [ ] Implement debug mode
   - [ ] Implement compilation mode
   - [ ] Implement compression mode
-- [ ] Play
-  - [ ] Implement Audio Engine
-  - [ ] Implement loop mode
+- [x] Play
+  - [x] Implement Audio Engine
+  - [x] Implement loop mode
 
 ## Core components
 
-- [ ] Audio Engine
+- [x] Audio Engine
 - [x] Lexer
 - [x] Parser
 - [x] Preprocessor
@@ -36,31 +39,31 @@ This is a list of tasks and features to be implemented in Devalang. Note that th
 
 ## Syntax elements
 
-- [ ] #
+- [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
 - [x] let
-- [ ] if
-- [ ] else
-- [ ] else if
+- [x] if
+- [x] else
+- [x] else if
 
-## Built-in triggers
+## Triggers
 
-- [x] .kick
-- [ ] .snare
-- [ ] .hihat
-- [ ] .tom
-- [ ] .clap
-- [ ] .crash
-- [ ] .ride
-- [ ] .synth
-- [ ] .bass
-- [ ] .pad
+- [x] Built-in triggers
+- [x] Custom triggers
+
+## Other TODOs
+
+- [ ] Comment all core components
+- [ ] Add unit tests for all core components

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/condition.deva

@@ -0,0 +1,20 @@
+# This file demonstrates the use of conditional blocks in Devalang.
+
+@import { duration, default_bank, params, loopCount, tempo } from "./variables.deva"
+@import { myGroup } from "./group.deva"
+
+@load "./samples/kick-808.wav" as kickCustom
+@load "./samples/hat-808.wav" as hatCustom
+
+group conditionBlock:
+    if tempo > 120:
+        # Will be executed if the condition is true
+        .kickCustom auto
+    else if tempo > 155:
+        # Will be executed if the condition is false
+        .hatCustom auto
+    else:
+        .kickCustom auto
+        .hatCustom auto
+
+@export { conditionBlock }