@devaloop/devalang 0.0.1-alpha.9 → 0.0.1-beta.1

package/docs/CHANGELOG.md

@@ -1,9 +1,394 @@
 <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-min.png" alt="Devalang Logo" width="100" />
 </div>
 
 # Changelog
 
+## Version 0.0.1-beta.1 (2025-09-02)
+
+> First beta of Devalang 0.0.1. Focus on stability, language surface freeze, and developer experience. No breaking changes expected compared to alpha.18; experimental features are gated and may change.
+>
+> NOTE: this beta release does not include pre-built WASM/Node bindings in the npm package. If you need WASM bindings, build them locally in the `rust/devalang` directory with `wasm-pack build --target nodejs` and copy the generated `pkg` into `out-tsc/pkg/`, or wait for a future release that bundles the artifacts.
+
+### ✨ Language Features
+
+- Language surface freeze for beta: core syntax and semantics stabilized; future breaking changes will follow a deprecation policy.
+- `pattern` enhancements: improved scheduling accuracy and step handling; supports accents and swing via step markers; clearer error messages for malformed patterns.
+- Better diagnostics across the language: consistent error formatting with source spans and error codes.
+
+### 🧠 Core Engine
+
+- High-precision scheduler: tighter timing guarantees and improved alignment with BPM; more reliable loop execution and periodic handlers.
+- Audio quality: automatic micro-fades on start/end to reduce clicks; improved handling of tails and voice polyphony.
+- Sample engine: safer stereo/mono handling and level preservation; fewer edge-case distortions on rapid retriggers.
+
+### 🧩 Parser & Lexer
+
+- Span-rich errors across maps/arrays and complex expressions; clearer messages and recovery where possible.
+- Lexer driver matured to cleanly separate file resolution from tokenization; fewer panics and better diagnostics.
+
+### 🔁 Preprocessor & Resolution
+
+- Deterministic include/resolve order; variable lookup consistently walks parent scopes.
+- Pattern resolver integration hardened to ensure `call`/`spawn` of patterns behave like functions/groups.
+
+### 🛠️ CLI & Telemetry
+
+- `build`, `check`, `play`: consistent exit codes and non-watch behavior; clearer surfacing of errors.
+- `install`/`discover`: authentication flow improved; better JSON/API error reporting; integrity checks on downloaded artifacts.
+- Telemetry: stable anonymous machine UUID; records CLI version/OS/args with opt-out capability; ensures `.deva` directory exists.
+
+### 📦 Packaging (WASM/Node/Rust)
+
+- WASM/TypeScript distribution: safer postinstall with guarded downloads; robust `.d.ts` types and ESM/CJS compatibility.
+- Rust crates: metadata completed and internal versions pinned; native-only features kept optional to reduce footprint.
+
+### 🧪 Tests & CI
+
+- Added unit tests for parser, pattern scheduling, and selected core utilities; initial wasm smoke tests.
+- CI matrix across Linux/macOS/Windows and Node/Rust versions; release pipeline hardened.
+
+## Version 0.0.1-alpha.18 (2025-09-02)
+
+### ✨ Language Features
+
+- New `pattern` statement to define rhythmic patterns with an optional target entity.
+  - Example: `pattern kickPattern with my808.kick = "x--- x--- x--- x---"`
+- Patterns can be invoked with `call` or `spawn` just like functions or groups.
+
+### 🧠 Core Engine
+
+- Pattern playback: schedules steps across one bar (4 beats), computing per-step duration and triggering the target on non-rest characters.
+- ADSR envelope: improved interpolation at segment boundaries to avoid clicks and handle 0/1-sample edge cases.
+- Sample engine: robust stereo-to-mono mixdown with RMS-preserving scaling; applies a tiny automatic fade (~1 ms) when samples start/end abruptly to reduce clicks.
+
+### 🧩 Parser & Lexer
+
+- Added `Pattern` token and parser handler; supports `pattern <name> [with <bank.trigger>] = "..."`.
+- Introduced a dedicated lexer driver (`rust/core/lexer/driver.rs`) to separate file resolution from tokenization.
+- Map/array parsing now logs structured errors via the shared logger instead of printing to stdout.
+
+### 🔁 Preprocessor & Resolution
+
+- Pattern resolver stores definitions in the variable table, enabling later `call`/`spawn` usage.
+- Variable lookup now walks parent scopes, fixing missed resolutions for outer-scope identifiers.
+
+### 🛠️ CLI & Telemetry
+
+- `build`: non-watch mode now executes and surfaces errors correctly.
+- `install`: requires authentication and reports API/JSON errors with clear messages.
+- Telemetry: generates a stable UUID when missing; consistently records CLI version, OS, and args.
+- Ensures the `.deva` directory exists at startup.
+
+### 📚 Examples
+
+- Added `examples/pattern.deva`; updated `examples/index.deva` to demonstrate `pattern` and `spawn`.
+
+### 📦 Packaging
+
+- Added crate metadata (description, license, authors) and pinned internal versions for `devalang_types` and `devalang_utils`.
+
+### 🐛 Fixes & Stability
+
+- Safer `$math` parsing with diagnostics for malformed calls and argument evaluation failures.
+- Minor parser fixes (loop body collection, clearer error messages) and logging cleanups across modules.
+
+## Version 0.0.1-alpha.17 (2025-08-30)
+
+### ✨ Addons
+
+- Discovering addons: use the CLI to discover plugins or banks : place compiled addons (.devabank, .devaplugin) anywhere into your `.deva` folder, then run:
+
+  ```bash
+  devalang discover
+  ```
+
+- Installing external addons: use the CLI to install addons:
+
+  ```bash
+  devalang install <plugin | bank> user.myPlugin
+  ```
+
+- Plugin usage: you can now reference installed plugins directly from Devalang source
+  using the `@use` directive and an optional alias. Examples:
+
+  - `@use user.myPlugin` — exposes the plugin under its default name
+  - `@use user.myPlugin as myAlias` — expose the plugin as `myAlias` for shorter calls
+
+### 🧩 Packaging & TypeScript
+
+- Improved packaging and postinstall logic for the TypeScript/WASM distribution; the
+  Node package now avoids hard-failing when optional native binaries are not available.
+- `out-tsc` postinstall now performs guarded downloads and better logging to help consumers diagnose installation issues on CI or constrained environments.
+
+### 🧠 Architecture & Refactor
+
+- Introduced a shared `devalang_types` crate to centralize project types and config structures — this simplifies cross-crate typing between the CLI, core, utils and WASM artifacts.
+- Split utilities into a reusable `devalang_utils` crate (logger, watcher, spinner, file helpers, telemetry) and moved several helpers (path resolution, file copying, safe archive extraction) to that crate.
+- Modularized CLI features, clean separation between build/process, realtime runner, IO helpers and stats collection.
+
+### 🐛 Bug fixes & stability
+
+- Multiple robustness fixes across the parser, preprocessor and audio engine:
+  - dotted identifiers and synth/provider resolution improvements,
+  - safer path resolution for `.deva` resources (banks, plugins, presets),
+  - improved error collection and logging with annotated stacks for better debug output.
+- Audio runtime: better BPM/duration estimation and loop handling in the realtime runner to avoid premature termination of periodic handlers while loops execute.
+
+### 🧪 Tests & CI
+
+- Added test scaffolding and types to centralize cross-crate tests (test harness and lightweight types prepared in `devalang_types`); this enables adding unit tests incrementally without duplicating type definitions. (Full test coverage is ongoing.)
+
+## Version 0.0.1-alpha.16-hotfix.2 (2025-08-29)
+
+### 🌎 Ecosystem
+
+- Published `@devaloop/devaforge` on npm. A tool for creating and managing Devalang addons.
+
+### 🔎 Telemetry
+
+- Patched first usage and user configuration.
+
+## Version 0.0.1-alpha.16-hotfix.1 (2025-08-29)
+
+### 🌎 Ecosystem
+
+- Fixed Github Actions to build and release binaries for multiple platforms.
+- Fixed `postinstall` script to launch properly postinstall.js when installing core package
+
+## Version 0.0.1-alpha.16 (2025-08-28)
+
+### 🌎 Ecosystem
+
+- Added Github Actions to build and release binaries for multiple platforms.
+
+### 🧩 Language Features
+
+- `bank` handler: add `as <alias>` support and robust parsing of `author.name` and string names.
+  - Example: `bank user.808 as my808`, `bank user.myBank as myBank`
+- `plugin` handler: initial implementation with basic support for loading and resolving plugins.
+  - Example: `@use user.myPlugin`, `@use user.myPlugin as myAlias`
+- `on` event handler: implemented event trigger resolution and context management.
+  - Example: `on beat: ...`, `on bar: ...`, `on custom: ...`
+- `emit` event handler: initial implementation for emitting events.
+  - Example: `emit beat`, `emit custom { value: 42 }`
+- `print`: add JS-like string concatenation with `+` between strings, variables, numbers, and `$env`/`$math` expressions.
+  - Examples: `print "looping " + i`, `print "bpm=" + $env.bpm`, `print "sin=" + $math.sin(0.5)`
+
+### 🧠 Core Engine
+
+- Cleanest error handling for unknown triggers (module:line:column), no implicit file search.
+- Real-time runner (play): loops are paced at 1 iteration per beat on the same thread.
+  - Periodic events (`on beat`, `on $beat`, `on bar`, `on $bar`) are suspended while a loop is running to avoid interleaving.
+  - Loops stop strictly at the end of their block (dedent / end-of-line).
+  - Duration estimation improved by accounting for loop iteration counts to keep the runner alive as needed.
+
+### 🔎 Telemetry (stats)
+
+- Added basic telemetry support for tracking module loading and resolution times.
+  - To enable telemetry, execute `devalang telemetry enable`
+  - To disable telemetry, execute `devalang telemetry disable`
+
+## Version 0.0.1-alpha.15 (2025-08-27)
+
+### ✨ Language Features
+
+- Added `automate` statement to schedule parameter automation (e.g. volume, pan, pitch) over time
+  - Supports per-note automation via a `automate` map on note calls (e.g. `note(C4, { automate: { volume: { 0%: 0.0, 100%: 1.0 } } })`)
+- Added `print` statement to ease debugging at runtime
+- Added special variables and functions usable in expressions:
+  - `$env.bpm`, `$env.beat`
+  - `$math.sin(expr)`, `$math.cos(expr)`
+  - `$env.position` (alias of beat), `$env.seed` (global session seed for deterministic randomness)
+  - `$math.random(seed?)`, `$math.lerp(a, b, t)`
+  - `$easing.*` functions for shaping values in [0,1]:
+    - `linear`, `easeIn/Out/InOutQuad`, `easeIn/Out/InOutCubic`, `easeIn/Out/InOutQuart`,
+      `easeIn/Out/InOutExpo`, `easeIn/Out/InOutBack`, `easeIn/Out/InOutElastic`, `easeIn/Out/InOutBounce`
+  - `$mod.*` modulators for time-based control:
+    - `lfo.sine(ratePerBeat)`, `lfo.tri(ratePerBeat)`, `envelope(attack, decay, sustain, release, t)`
+- Added basic `for` loops and array literals
+  - Example: `for i in [1, 2, 3]: print i`
+
+### 🧠 Core Engine
+
+- Implemented runtime automation in the audio renderer with linear envelope interpolation
+- Per-note automation supported (volume, pan, pitch) and evaluated during rendering
+- Fixed evaluator recursion guard and improved `$math.*` expression handling (prevents stack overflows)
+- Minor ADSR defaults polish: ensure `sustain` defaults to `1.0`
+- Evaluator now supports `$mod.*` and `$easing.*` calls (evaluated before `$math.*`) for richer automation
+- Modularized `AudioEngine::insert_note` into small helpers (oscillator, ADSR computation, pan gains, envelope evaluation, stereo mix)
+  - Reused helpers in `pad_samples` to reduce duplication
+- Moved special variables/functions to a dedicated module: `core::audio::special`, and refactored the evaluator to use it
+- Continued borrow-friendly refactors to avoid unnecessary clones and improve readability
+
+### 🧩 Parser / Preprocessor
+
+- Parser upgrades for operators `+ - * /`, parentheses and brackets
+- Improved arrow-call parsing and map handling for multi-line values
+- Resolvers: refined `call`/`spawn` resolution (better error messages with stack traces)
+
+### 🧱 Architecture / Refactor
+
+- Modularized audio interpreter (split by statement type); clearer responsibilities
+- Reduced allocations by passing slices/borrows instead of cloning large structures
+- Removed dead code and unused params across resolvers, handlers, and interpreter modules
+
+### 🧰 Tooling / Build
+
+- Resolved binary/lib artifact collision by renaming the internal library crate to `devalang_core`
+- Warning sweep: build now compiles cleanly without Rust warnings (and fewer Clippy lints)
+- Moved error collection helpers into a dedicated `utils::error` module
+
+### 🐛 Fixes & Stability
+
+- Prevent infinite recursion during numeric expression evaluation
+- Stabilized renderer and interpreter timing when combining `loop`, `call`, and `spawn`
+
+### ⚠️ Breaking changes
+
+- Internal crate rename to `devalang_core` (no change to the CLI or WASM package names)
+
+## 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.
+- Refactored audio engine and interpreter to handle correct timing and execution while using `loop`, `call`, and `spawn` statements.
+- Refactored `trigger` effects to apply more effects to triggers.
+  - Example: `.myTrigger auto { reverb: 0.25, pitch: 0.75, gain: 0.8 }`
+- Refactored `preprocessor` to handle correct namespaced banks of sounds and triggers.
+- Refactored `collect_errors_recursively` to provide detailed error reporting across nested statements.
+- Optimized the `renderer` to handle silent buffers and improve performance.
+
+### 🛠️ Utilities
+
+- Added the `extract_loop_body_statements` utility for better loop handling.
+- Improved logging for module variables and functions.
+
+### 🧩 Web Assembly
+
+- Patched `lib.rs` dependencies to ensure compatibility with the latest Rust and WASM standards.
+
+## 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
+
+- 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

package/docs/CONTRIBUTING.md

@@ -0,0 +1,101 @@
+<div align="center">
+    <img src="https://devalang.com/images/devalang-logo-min.png" alt="Devalang Logo" width="100" />
+</div>
+
+# Contributing to Devalang
+
+Thanks for considering a contribution! This document explains how to set up your environment, build the project, and submit changes.
+
+## Code of Conduct
+
+By participating, you agree to follow our community standards: be respectful, constructive, and empathetic. If something goes wrong, please open an issue.
+
+## Project structure
+
+- `rust/`: Rust CLI, core engine, parser, preprocessor, audio runtime
+- `typescript/`: TypeScript utilities and scripts
+- `pkg/`: WASM package output (generated by wasm-pack)
+- `examples/`: Devalang examples
+- `docs/`: Documentation
+
+## Prerequisites
+
+- Rust (stable, edition 2024)
+- Node.js 18+
+- wasm-pack (if you work on the WASM package)
+
+## Setup
+
+1. Install dependencies
+
+- Rust toolchain (<https://rustup.rs>)
+- Node.js (<https://nodejs.org>)
+
+1. Clone and install
+
+- Clone this repository
+- Run `npm install`
+
+## Build and run
+
+- Build (debug): `cargo build`
+- Build (release): `cargo build --release`
+- TypeScript compile: `npm run script:build`
+- Development helpers:
+	- `npm run rust:dev:build`  — build AST/audio once
+	- `npm run rust:dev:check`  — syntax checks with debug logs
+	- `npm run rust:dev:play`   — play audio in a loop (repeat) with debug
+- WASM builds:
+	- Web:  `npm run rust:wasm:web`
+	- Node: `npm run rust:wasm:node`
+
+## Tests and sanity checks
+
+- Build and quick smoke test on examples:
+	- `cargo build`
+	- `npm run rust:dev:play`
+- Prepublish (used by CI/release): `npm run prepublish`
+
+## Versioning and releases
+
+- Project version lives in multiple places:
+	- `Cargo.toml`
+	- `package.json`
+	- `project-version.json` (includes build counter and last commit)
+	- `pkg/package.json` (WASM package)
+- Bump versions to the next pre-release (e.g. 0.0.1-alpha.16), then tag the repository:
+    - Bump version: `npm run script:version:bump pre`
+	- Commit bump:  `git commit -am "chore: bump version to 0.0.1-alpha.X"`
+	- Create tag:   `git tag v0.0.1-alpha.X`
+	- Push:         `git push && git push origin v0.0.1-alpha.X`
+- CI publishes release artifacts on tags matching `v*`.
+
+## Pull requests
+
+- Keep PRs small and focused
+- Describe the motivation and the approach
+- Link related issues
+- Add/update tests (when relevant)
+- Keep the existing style; avoid mass reformatting
+
+## Coding guidelines
+
+- Rust: follow Clippy suggestions where practical; prefer small, focused modules
+- Keep public APIs stable; document breaking changes in the changelog
+- Add comments where behavior is non-obvious (parser and interpreter paths)
+
+## Reporting issues
+
+Please include:
+
+- Version (`devalang --version`), OS, and repro steps
+- Minimal code sample (`.deva`) if possible
+- Expected vs. actual behavior
+
+## Security
+
+If you discover a vulnerability, please report it privately (<contact@devaloop.com>). Do not open a public issue until coordinated disclosure.
+
+## Thanks
+
+We appreciate your time and contributions — whether it’s code, docs, or feedback.

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-min.png" alt="Devalang Logo" width="100" />
 </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`.
@@ -21,11 +21,14 @@ Devalang is a work in progress. Here’s what we’re planning next:
 - ✅ **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
+## In Progress
 
-- ⏳ **Smart modules**: Let Devalang detect and use groups, samples, and variables without needing to import them manually.
-- ⏳ **VSCode extension**: Create a VSCode extension for syntax highlighting and code completion.
-- ⏳ **Other statements**: Implement `pattern`, `function`, and other control structures.
-- ⏳ **Functions**: Add support for defining and calling functions.
+- ⏳ **Addon generator**: Implement addon generation for creating reusable plugins, banks and presets.
 - ⏳ **Testing**: Expand test coverage for all features.
+- ⏳ **Other statements**: Implement `pattern`, and other control structures.
+
+## Planned
+
+- ⏳ **Smart modules**: Let Devalang detect and use groups, samples, and variables without needing to import them manually.

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-min.png" alt="Devalang Logo" width="100" />
 </div>
 
 # TODOs list
@@ -11,21 +11,19 @@ This is a list of tasks and features to be implemented in Devalang. Note that th
 - [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
   - [x] Implement watch mode
-  - [ ] Implement debug mode
-  - [ ] Implement compilation mode
+  - [x] Implement debug mode
 - [x] Building
   - [x] Implement watch mode
-  - [ ] Implement debug mode
-  - [ ] Implement compilation mode
-  - [ ] Implement compression mode
+  - [x] Implement debug mode
+  - [x] Implement compression mode
 - [x] Play
   - [x] Implement Audio Engine
+  - [x] Implement debug mode
   - [x] Implement loop mode
 
 ## Core components
@@ -44,7 +42,7 @@ This is a list of tasks and features to be implemented in Devalang. Note that th
 - [x] @export
 - [x] @load
 - [ ] @include
-- [ ] function
+- [x] function
 - [ ] pattern
 - [x] group
 - [x] call
@@ -63,8 +61,22 @@ This is a list of tasks and features to be implemented in Devalang. Note that th
 - [x] Built-in triggers
 - [x] Custom triggers
 
+## Banks
+
+- [x] Implement bank management (e.g. install, remove, list)
+- [x] Create example banks
+
+## Plugins
+
+- [x] Implement plugin system (e.g. install, remove, list)
+- [ ] Create example plugins
+
+## Addon generator
+
+- [x] Implement addon generator
+- [ ] Create example addons
+
 ## Other TODOs
 
-- [ ] Patch path handling to support relative paths
 - [ ] Comment all core components
 - [ ] Add unit tests for all core components

package/examples/automation.deva

@@ -0,0 +1,42 @@
+bpm 120
+
+group myLead:
+    let mySynth = synth sine
+
+    # This will automate all notes inside mySynth
+    # automate mySynth:
+    #     param volume {
+    #         0% = 0.0
+    #         100% = 1.0
+    #     }
+    #     param pan {
+    #         0% = -1.0
+    #         100% = 1.0
+    #     }
+    #     param pitch {
+    #         0% = -12.0
+    #         100% = 12.0
+    #     }
+    
+    # This will automate only one note
+    mySynth -> note(C4, { 
+        duration: 400,
+        automate: {
+            pitch: {
+                0%: -12.0
+                100%: 12.0
+            },
+            pan: {
+                0%: -1.0,
+                100%: 1.0
+            }
+        }
+    })
+    mySynth -> note(G4, { duration: 400 })
+    mySynth -> note(E4, { duration: 600 })
+    mySynth -> note(A4, { duration: 400 })
+    mySynth -> note(F4, { duration: 800 })
+    mySynth -> note(D4, { duration: 400 })
+    mySynth -> note(B3, { duration: 600 })
+
+call myLead

package/examples/bank.deva

@@ -0,0 +1,7 @@
+# This file demonstrates the use of banks in Devalang.
+
+bank devaloop.808 as myBank
+
+.myBank.kick auto
+.myBank.snare auto
+.myBank.openhat 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/events.deva

@@ -0,0 +1,12 @@
+bpm 120
+
+on beat:
+    print "kick on each beat"
+
+on bar:
+    print "bar!"
+
+on custom(value):
+    print "custom event with value: " + value
+
+emit custom(10)