@devaloop/devalang 0.0.1-beta.2 → 0.1.1

package/templates/minimal/README.md

@@ -1,218 +0,0 @@
-<div align="center">
-    <img src="https://devalang.com/images/devalang-logo-min.png" alt="Devalang Logo" width="100" />
-</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-beta-blue)
-![Version](https://img.shields.io/npm/v/@devaloop/devalang)
-![License: MIT](https://img.shields.io/badge/license-MIT-green)
-
-![Linux](https://img.shields.io/badge/linux-supported-blue?logo=linux)
-![macOS](https://img.shields.io/badge/macOS-supported-blue?logo=apple)
-![Windows](https://img.shields.io/badge/windows-supported-blue?logo=windows)
-
-![npm](https://img.shields.io/npm/dt/@devaloop/devalang)
-![crates](https://img.shields.io/crates/d/devalang)
-
-![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/devaloop-labs/devalang/.github/workflows/ci.yml)
-
-# 🦊 Devalang (CORE) — Compose music with code
-
-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.
-
-> **🚧 Notice 🚧**
->
-> Includes synthesis, playback, and rendering features, but is still in early development, and breaking changes may occur.
->
-> **NEW**: [Devaforge is now available for creating addons](https://github.com/devaloop-labs/devaforge).
->
-> **NEW**: Now available for Windows, Linux, and macOS.
-
-## 📚 Quick Access
-
-- [▶️ 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)
-- [📦 Devaforge on npm](https://www.npmjs.com/package/@devaloop/devaforge)
-- [📦 Devalang on npm](https://www.npmjs.com/package/@devaloop/devalang)
-
-## ⏱️ Try it now !
-
-### Try Devalang in your browser
-
-> [Have a look at the Playground to try Devalang directly in your browser](https://playground.devalang.com)
-
-### Try Devalang in your terminal
-
-#### With Node.js
-
-```bash
-npm install -g @devaloop/devalang@latest
-```
-
-#### With Rust
-
-```bash
-cargo install devalang
-```
-
-#### Initialize a new project
-
-```bash
-devalang init --name my-project --template minimal
-```
-
-#### Write your first script
-
-Create a new Devalang file `src/index.deva` in the project directory:
-
-```deva
-# src/index.deva
-
-# BPM definition
-bpm 125
-
-# Bank picking (make sure you've installed it)
-bank devaloop.808 as my808Bank
-
-# Pattern literal without options
-pattern kickPattern with my808Bank.kick = "x--- x--- x--- x---"
-
-group myGroup:
-    # Rhythmic (each beat playing a kick)
-    # on beat:
-    #     .my808Bank.kick 1/4
-
-    # Synth definition with ADSR
-    let myLead = synth sine {
-        attack: 0,
-        decay: 100,
-        sustain: 100,
-        release: 100
-    }
-
-    # Global automation
-    automate myLead:
-        param volume {
-            0% = 0.0
-            100% = 0.5
-        }
-        param pitch {
-            0% = -12.0
-            100% = 12.0
-        }
-
-    # Notes in a loop with condition
-    for i in [1, 2, 3]:
-        if i == 3:
-            myLead -> note(C5, { duration: 200 })
-            print "Playing note C5 for " + i
-
-    # Pause runtime for 500ms
-    sleep 500
-
-    # Note with automation
-    myLead -> note(C4, {
-        duration: 400,
-        velocity: 0.8,
-        automate: {
-            pan: {
-                0%: -1.0,
-                100%: 0.0
-            }
-        }
-    })
-
-    # Notes with params
-    myLead -> note(G4, { duration: 600, glide: true, target_freq: 659.25 })
-    myLead -> note(B3, { duration: 400, slide: true, target_amp: 0.3 })
-
-# Spawning the group & the pattern to play them in parallel
-spawn myGroup
-spawn kickPattern
-```
-
-### And the best part ? You can play it directly from the command line:
-
-#### Play the script once
-
-```bash
-devalang play
-```
-
-#### **LIVE mode** (repeat the playback + watch mode)
-
-```bash
-devalang play --repeat
-```
-
-### 🎉 You can now hear your Devalang code in action
-
-> For more examples, check out the [examples directory](./examples/)
-
-## ❓ Why Devalang ?
-
-- 🎹 Prototype audio ideas without opening a DAW, even VSCode with our Playground
-- 💻 Integrate sound into code-based workflows
-- 🎛️ Control audio parameters through readable syntax
-- 🧪 Build musical logic with variables and conditions
-- 🔄 Create complex patterns with ease
-
-## 🚀 Features
-
-- ⚡ **Fast Build & Hot Reload** — optimized build process for quicker iteration.
-- 🎵 **Audio Engine & Real-time runner** — low-latency playback, render-to-file, and a realtime runner used by `devalang play` for live feedback.
-- ▶️ **Live mode (watch + repeat)** — edit and hear changes instantly with `devalang play --repeat` and watch mode.
-- 🧩 **Language primitives** — synths, notes, ADSR, maps, arrays, loops, conditionals and functions for expressive musical logic.
-- 🎛️ **Per-note automation & modulators** — `automate` maps, `$mod.*`, `$easing.*` and `$math.*` helpers for envelopes and LFOs.
-- 🧩 **Module system & structured AST** — import/export variables, stable AST output for debugging and tooling.
-- 🧰 **Plugins & Addons (WASM-ready)** — install plugins/banks, `@use` directive, and WASM plugin integration so plugins can render or process audio at runtime.
-- 📦 **Addon manager & Devaforge** — CLI commands to discover/install banks, plugins and templates; `devaforge` helps create addons.
-- ⚙️ **CLI tooling** — `build`, `check`, `play`, `install`, `init`, `discover`, `telemetry` and more with consistent flags (`--watch`, `--debug`, `--compress`).
-- 📂 **Project templates & examples** — quick-start templates and many example projects in `examples/`.
-- 🧑‍💻 **TypeScript API & WASM distribution** — Node-friendly package with TypeScript bindings and a WASM build for browser/Node usage.
-- 🧰 **Editor & formatting support** — VSCode extension and Prettier plugin to edit Devalang with syntax and formatting support.
-- 🎵 **Custom samples & banks** — drop samples into `.deva` and reference them from code; banks of sounds for fast composition.
-- 🔄 **Looping, grouping & scheduling** — precise beat-tied scheduling primitives for complex rhythmic patterns.
-
-## 📄 Documentation
-
-### [Please refer to the online documentation](https://docs.devalang.com) for detailed information on syntax, features, and usage examples
-
-## 📰 What's new
-
-- **Devaforge**: Introduced a new system for creating and managing addons, including a CLI for addon generation.
-- **Documentation updates**: Improved documentation for clarity and completeness.
-- **Discovering addons**: Introduced a new command to detect addons.
-- **Public TypeScript API**: Added a public TypeScript API for easier integration.
-- **Improved error messages**: Enhanced error messages for better debugging.
-- **Bug fixes**: Various bug fixes and stability improvements.
-
-## 🛡️ License
-
-MIT — see [LICENSE](./LICENSE)
-
-## 🤝 Contributing
-
-Contributions, bug reports and suggestions are welcome !  
-Feel free to open an issue or submit a pull request.
-
-For more info, see [docs/CONTRIBUTING.md](./docs/CONTRIBUTING.md).
-
-## 📢 Contact
-
-Feel free to reach out for any inquiries or feedback.
-
-📧 [contact@devaloop.com](mailto:contact@devaloop.com)

package/templates/minimal/src/index.deva

@@ -1,2 +0,0 @@
-# Write your Devalang code here
-# ...

package/templates/welcome/.devalang

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

package/templates/welcome/README.md

@@ -1,218 +0,0 @@
-<div align="center">
-    <img src="https://devalang.com/images/devalang-logo-min.png" alt="Devalang Logo" width="100" />
-</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-beta-blue)
-![Version](https://img.shields.io/npm/v/@devaloop/devalang)
-![License: MIT](https://img.shields.io/badge/license-MIT-green)
-
-![Linux](https://img.shields.io/badge/linux-supported-blue?logo=linux)
-![macOS](https://img.shields.io/badge/macOS-supported-blue?logo=apple)
-![Windows](https://img.shields.io/badge/windows-supported-blue?logo=windows)
-
-![npm](https://img.shields.io/npm/dt/@devaloop/devalang)
-![crates](https://img.shields.io/crates/d/devalang)
-
-![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/devaloop-labs/devalang/.github/workflows/ci.yml)
-
-# 🦊 Devalang (CORE) — Compose music with code
-
-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.
-
-> **🚧 Notice 🚧**
->
-> Includes synthesis, playback, and rendering features, but is still in early development, and breaking changes may occur.
->
-> **NEW**: [Devaforge is now available for creating addons](https://github.com/devaloop-labs/devaforge).
->
-> **NEW**: Now available for Windows, Linux, and macOS.
-
-## 📚 Quick Access
-
-- [▶️ 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)
-- [📦 Devaforge on npm](https://www.npmjs.com/package/@devaloop/devaforge)
-- [📦 Devalang on npm](https://www.npmjs.com/package/@devaloop/devalang)
-
-## ⏱️ Try it now !
-
-### Try Devalang in your browser
-
-> [Have a look at the Playground to try Devalang directly in your browser](https://playground.devalang.com)
-
-### Try Devalang in your terminal
-
-#### With Node.js
-
-```bash
-npm install -g @devaloop/devalang@latest
-```
-
-#### With Rust
-
-```bash
-cargo install devalang
-```
-
-#### Initialize a new project
-
-```bash
-devalang init --name my-project --template minimal
-```
-
-#### Write your first script
-
-Create a new Devalang file `src/index.deva` in the project directory:
-
-```deva
-# src/index.deva
-
-# BPM definition
-bpm 125
-
-# Bank picking (make sure you've installed it)
-bank devaloop.808 as my808Bank
-
-# Pattern literal without options
-pattern kickPattern with my808Bank.kick = "x--- x--- x--- x---"
-
-group myGroup:
-    # Rhythmic (each beat playing a kick)
-    # on beat:
-    #     .my808Bank.kick 1/4
-
-    # Synth definition with ADSR
-    let myLead = synth sine {
-        attack: 0,
-        decay: 100,
-        sustain: 100,
-        release: 100
-    }
-
-    # Global automation
-    automate myLead:
-        param volume {
-            0% = 0.0
-            100% = 0.5
-        }
-        param pitch {
-            0% = -12.0
-            100% = 12.0
-        }
-
-    # Notes in a loop with condition
-    for i in [1, 2, 3]:
-        if i == 3:
-            myLead -> note(C5, { duration: 200 })
-            print "Playing note C5 for " + i
-
-    # Pause runtime for 500ms
-    sleep 500
-
-    # Note with automation
-    myLead -> note(C4, {
-        duration: 400,
-        velocity: 0.8,
-        automate: {
-            pan: {
-                0%: -1.0,
-                100%: 0.0
-            }
-        }
-    })
-
-    # Notes with params
-    myLead -> note(G4, { duration: 600, glide: true, target_freq: 659.25 })
-    myLead -> note(B3, { duration: 400, slide: true, target_amp: 0.3 })
-
-# Spawning the group & the pattern to play them in parallel
-spawn myGroup
-spawn kickPattern
-```
-
-### And the best part ? You can play it directly from the command line:
-
-#### Play the script once
-
-```bash
-devalang play
-```
-
-#### **LIVE mode** (repeat the playback + watch mode)
-
-```bash
-devalang play --repeat
-```
-
-### 🎉 You can now hear your Devalang code in action
-
-> For more examples, check out the [examples directory](./examples/)
-
-## ❓ Why Devalang ?
-
-- 🎹 Prototype audio ideas without opening a DAW, even VSCode with our Playground
-- 💻 Integrate sound into code-based workflows
-- 🎛️ Control audio parameters through readable syntax
-- 🧪 Build musical logic with variables and conditions
-- 🔄 Create complex patterns with ease
-
-## 🚀 Features
-
-- ⚡ **Fast Build & Hot Reload** — optimized build process for quicker iteration.
-- 🎵 **Audio Engine & Real-time runner** — low-latency playback, render-to-file, and a realtime runner used by `devalang play` for live feedback.
-- ▶️ **Live mode (watch + repeat)** — edit and hear changes instantly with `devalang play --repeat` and watch mode.
-- 🧩 **Language primitives** — synths, notes, ADSR, maps, arrays, loops, conditionals and functions for expressive musical logic.
-- 🎛️ **Per-note automation & modulators** — `automate` maps, `$mod.*`, `$easing.*` and `$math.*` helpers for envelopes and LFOs.
-- 🧩 **Module system & structured AST** — import/export variables, stable AST output for debugging and tooling.
-- 🧰 **Plugins & Addons (WASM-ready)** — install plugins/banks, `@use` directive, and WASM plugin integration so plugins can render or process audio at runtime.
-- 📦 **Addon manager & Devaforge** — CLI commands to discover/install banks, plugins and templates; `devaforge` helps create addons.
-- ⚙️ **CLI tooling** — `build`, `check`, `play`, `install`, `init`, `discover`, `telemetry` and more with consistent flags (`--watch`, `--debug`, `--compress`).
-- 📂 **Project templates & examples** — quick-start templates and many example projects in `examples/`.
-- 🧑‍💻 **TypeScript API & WASM distribution** — Node-friendly package with TypeScript bindings and a WASM build for browser/Node usage.
-- 🧰 **Editor & formatting support** — VSCode extension and Prettier plugin to edit Devalang with syntax and formatting support.
-- 🎵 **Custom samples & banks** — drop samples into `.deva` and reference them from code; banks of sounds for fast composition.
-- 🔄 **Looping, grouping & scheduling** — precise beat-tied scheduling primitives for complex rhythmic patterns.
-
-## 📄 Documentation
-
-### [Please refer to the online documentation](https://docs.devalang.com) for detailed information on syntax, features, and usage examples
-
-## 📰 What's new
-
-- **Devaforge**: Introduced a new system for creating and managing addons, including a CLI for addon generation.
-- **Documentation updates**: Improved documentation for clarity and completeness.
-- **Discovering addons**: Introduced a new command to detect addons.
-- **Public TypeScript API**: Added a public TypeScript API for easier integration.
-- **Improved error messages**: Enhanced error messages for better debugging.
-- **Bug fixes**: Various bug fixes and stability improvements.
-
-## 🛡️ License
-
-MIT — see [LICENSE](./LICENSE)
-
-## 🤝 Contributing
-
-Contributions, bug reports and suggestions are welcome !  
-Feel free to open an issue or submit a pull request.
-
-For more info, see [docs/CONTRIBUTING.md](./docs/CONTRIBUTING.md).
-
-## 📢 Contact
-
-Feel free to reach out for any inquiries or feedback.
-
-📧 [contact@devaloop.com](mailto:contact@devaloop.com)

package/templates/welcome/src/index.deva

@@ -1,61 +0,0 @@
-# 🦊 Welcome to Devalang
-# Happy live-coding !
-
-@import { bpmVar } from './variables.deva'
-@load "../samples/kick-808.wav" as myKick
-
-# BPM definition
-bpm bpmVar
-
-group myGroup:
-    # Rhythmic (each beat playing a kick)
-    on beat:
-        .myKick 1/4
-
-    # Synth definition with ADSR
-    let myLead = synth sine {
-        attack: 0,
-        decay: 100,
-        sustain: 100,
-        release: 100
-    }
-
-    # Global automation
-    automate myLead:
-        param volume {
-            0% = 0.0
-            100% = 0.5
-        }
-        param pitch {
-            0% = -12.0
-            100% = 12.0
-        }
-
-    # Notes in a loop with condition
-    for i in [1, 2, 3]:
-        if i == 3:
-            myLead -> note(C5, { duration: 200 })
-            print "Playing note C5 for " + i
-
-    # Pause runtime for 500ms
-    sleep 500
-
-    # Note with automation
-    myLead -> note(C4, {
-        duration: 400,
-        velocity: 0.8,
-        automate: {
-            pan: {
-                0%: -1.0,
-                100%: 0.0
-            }
-        }
-    })
-
-    # Notes with params
-    myLead -> note(E4, { duration: 400 })
-    myLead -> note(G4, { duration: 600, glide: true, target_freq: 659.25 })
-    myLead -> note(B3, { duration: 400, slide: true, target_amp: 0.3 })
-
-# Calling the group to play it
-call myGroup

package/templates/welcome/src/variables.deva

@@ -1,3 +0,0 @@
-let bpmVar = 135
-
-@export { bpmVar }

package/tests/integration.rs

@@ -1,21 +0,0 @@
-// Aggregator test: include tests from tests/rust/* as distinct modules.
-// This keeps sources organized while providing a single integration test
-// file that Cargo will compile and run.
-
-mod rust_tests {
-    pub mod cli_help {
-        include!("rust/cli_help.rs");
-    }
-    pub mod cli_version {
-        include!("rust/cli_version.rs");
-    }
-    pub mod cli_template_list {
-        include!("rust/cli_template_list.rs");
-    }
-    pub mod cli_check_build {
-        include!("rust/cli_check_build.rs");
-    }
-}
-
-// Re-export tests so the test runner finds them at crate root.
-pub use rust_tests::*;

package/tests/rust/cli_check_build.rs

@@ -1,21 +0,0 @@
-use assert_cmd::Command;
-use tempfile::tempdir;
-
-#[test]
-fn cli_check_and_build_no_crash() {
-    // create a temp output dir and run check/build against examples entry
-    let out = tempdir().expect("create tempdir");
-    let out_path = out.path().to_str().unwrap();
-
-    // Run `devalang check --entry examples --output <out> --debug`
-    let mut cmd = Command::cargo_bin("devalang").expect("binary not found");
-    cmd.args(["check", "--entry", "examples", "--output", out_path, "--debug"]);
-    let assert = cmd.assert();
-    // check may return success or non-zero depending on environment, ensure it doesn't panic
-    assert.get_output();
-
-    // Run build command similarly; we only assert it runs (not necessarily success on all envs)
-    let mut cmd2 = Command::cargo_bin("devalang").expect("binary not found");
-    cmd2.args(["build", "--entry", "examples", "--output", out_path, "--debug"]);
-    cmd2.assert().get_output();
-}

package/tests/rust/cli_help.rs

@@ -1,12 +0,0 @@
-use assert_cmd::Command;
-use predicates::prelude::*;
-
-#[test]
-fn cli_prints_help() {
-    // Build the binary in debug mode and run it with --help
-    let mut cmd = Command::cargo_bin("devalang").expect("binary not found");
-    cmd.arg("--help");
-    cmd.assert()
-        .success()
-        .stdout(predicate::str::contains("devalang"));
-}

package/tests/rust/cli_template_list.rs

@@ -1,10 +0,0 @@
-use assert_cmd::Command;
-
-#[test]
-fn cli_template_list_runs() {
-    let mut cmd = Command::cargo_bin("devalang").expect("binary not found");
-    cmd.args(["template", "list"]);
-    let assert = cmd.assert();
-    // ensure it runs without panic; output may vary
-    assert.get_output();
-}

package/tests/rust/cli_version.rs

@@ -1,11 +0,0 @@
-use assert_cmd::Command;
-use predicates::prelude::*;
-
-#[test]
-fn cli_prints_version() {
-    let mut cmd = Command::cargo_bin("devalang").expect("binary not found");
-    cmd.arg("--version");
-    cmd.assert()
-        .success()
-        .stdout(predicate::str::contains("devalang"));
-}