@devaloop/devalang 0.0.1-alpha.14 → 0.0.1-alpha.16

package/.devalang

@@ -1,8 +1,10 @@
-[defaults]
-entry = "./examples"
-output = "./output"
-watch = false
-
-[[banks]]
-path = "devalang://bank/devaloop.808"
-version = "0.0.2"
+[defaults]
+entry = "./examples"
+output = "./output"
+watch = false
+debug = true
+compress = true
+
+[[banks]]
+path = "devalang://bank/devaloop.808"
+version = "0.0.2"

package/.github/workflows/ci.yml

@@ -0,0 +1,92 @@
+name: CI & Release
+
+on:
+  push:
+    branches:
+      - main
+    tags:
+      - "v*"
+  pull_request:
+
+jobs:
+  build:
+    name: Build binaries
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        include:
+          - os: ubuntu-latest
+            target: x86_64-unknown-linux-gnu
+            bin_ext: ""
+          - os: macos-latest
+            target: x86_64-apple-darwin
+            bin_ext: ""
+          - os: windows-latest
+            target: x86_64-pc-windows-msvc
+            bin_ext: ".exe"
+
+    steps:
+      - name: Checkout sources
+        uses: actions/checkout@v4
+
+      - name: Install ALSA (Linux)
+        if: matrix.os == 'ubuntu-latest'
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libasound2-dev pkg-config
+
+      - name: Install Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: Install Rust
+        uses: actions-rs/toolchain@v1
+        with:
+          toolchain: stable
+          override: true
+          target: ${{ matrix.target }}
+
+      - name: NPM Install
+        run: npm install
+
+      - name: Build TS
+        run: npx tsc
+
+      - name: Build release
+        run: cargo build --release --target ${{ matrix.target }}
+
+      - name: Ensure out-tsc/bin exists (Unix)
+        if: runner.os != 'Windows'
+        run: mkdir -p out-tsc/bin
+
+      - name: Ensure out-tsc/bin exists (Windows)
+        if: runner.os == 'Windows'
+        shell: pwsh
+        run: |
+          New-Item -ItemType Directory -Force out-tsc/bin | Out-Null
+
+      - name: Copy binary (Unix)
+        if: runner.os != 'Windows'
+        run: cp target/${{ matrix.target }}/release/devalang${{ matrix.bin_ext }} out-tsc/bin/devalang-${{ matrix.target }}${{ matrix.bin_ext }}
+
+      - name: Copy binary (Windows)
+        if: runner.os == 'Windows'
+        shell: pwsh
+        run: |
+          Copy-Item "target\${{ matrix.target }}\release\devalang${{ matrix.bin_ext }}" "out-tsc\bin\devalang-${{ matrix.target }}${{ matrix.bin_ext }}" -Force
+
+      - name: Upload artifact (CI)
+        if: startsWith(github.ref, 'refs/heads/')
+        uses: actions/upload-artifact@v4
+        with:
+          name: devalang-${{ matrix.target }}
+          path: out-tsc/bin/*
+
+      - name: Upload to GitHub Release
+        if: startsWith(github.ref, 'refs/tags/')
+        uses: softprops/action-gh-release@v2
+        with:
+          files: out-tsc/bin/*
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/Cargo.toml

@@ -1,58 +1,60 @@
-[package]
-name = "devalang"
-version = "0.0.1-alpha.14"
-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", "development-tools", "parser-implementations"]
-readme = "README.md"
-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"
-crate-type = ["cdylib", "rlib"]
-
-[profile.release]
-opt-level = "s"
-
-[features]
-default = ["cli"]
-cli = ["crossterm", "indicatif", "inquire", "zip", "reqwest", "flate2", "tokio"]
-
-[dependencies]
-clap = { version = "4.5", features = ["derive"] }
-serde = { version = "1.0", features = ["derive"] }
-serde_json = "1.0"
-rodio = "0.17"
-hound = "3.4.0"
-toml = "0.8"
-notify = "6.1"
-fs_extra = "1.3"
-include_dir = "0.7"
-wasm-bindgen = "0.2"
-serde-wasm-bindgen = "0.4"
-nom_locate = "4.0.0"
-chrono = "0.4"
-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 }
-rayon = "1.10.0"
-webbrowser = "0.8"
-tiny_http = "0.9.0"
-dirs = "5"
-urlencoding = "2.1"
+[package]
+name = "devalang"
+version = "0.0.1-alpha.16"
+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", "development-tools", "parser-implementations"]
+readme = "README.md"
+homepage = "https://devalang.com"
+documentation = "https://docs.devalang.com/"
+edition = "2024"
+
+[[bin]]
+name = "devalang"
+path = "rust/main.rs"
+required-features = ["cli"]
+
+[lib]
+name = "devalang_core"
+path = "rust/lib.rs"
+crate-type = ["cdylib", "rlib"]
+
+[profile.release]
+opt-level = "s"
+
+[features]
+default = ["cli"]
+cli = ["crossterm", "indicatif", "inquire", "zip", "reqwest", "flate2", "tokio"]
+
+[dependencies]
+clap = { version = "4.5", features = ["derive"] }
+serde = { version = "1.0", features = ["derive"] }
+serde_json = "1.0"
+rodio = "0.17"
+hound = "3.4.0"
+toml = "0.8"
+notify = "6.1"
+fs_extra = "1.3"
+include_dir = "0.7"
+wasm-bindgen = "0.2"
+serde-wasm-bindgen = "0.4"
+nom_locate = "4.0.0"
+chrono = "0.4"
+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 }
+rayon = "1.10.0"
+webbrowser = "0.8"
+tiny_http = "0.9.0"
+dirs = "5"
+urlencoding = "2.1"
+uuid = { version = "1.18.0", features = ["v4"] }
+wasmtime = "19"

package/README.md

@@ -1,5 +1,5 @@
 <div align="center">
-    <img src="https://devalang.com/images/devalang-logo.svg" alt="Devalang Logo" width="300" />
+    <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)
@@ -65,31 +65,48 @@ Create a new Devalang file `src/index.deva` in the project directory:
 ```deva
 # src/index.deva
 
-group myLead:
-    let mySynth = synth sine {
+group main:
+    let lead = synth sine {
         attack: 0,
         decay: 100,
         sustain: 100,
         release: 100
     }
 
-    mySynth -> note(C4, {
+    # Global automation for this synth (applies to subsequent notes)
+    automate lead:
+        param volume {
+            0% = 0.0
+            100% = 1.0
+        }
+        param pan {
+            0% = -1.0
+            100% = 1.0
+        }
+        param pitch {
+            0% = -12.0
+            100% = 12.0
+        }
+
+    lead -> note(C4, {
         duration: 400,
-        velocity: 0.7,
-        glide: true
+        velocity: 0.8,
+        automate: { pan: { 0%: -1.0, 100%: 0.0 } }
     })
 
-    mySynth -> note(G4, {
-         duration: 600,
-         slide: true
-    })
+    lead -> note(E4, { duration: 400 })
+    lead -> note(G4, { duration: 600, glide: true, target_freq: 659.25 })
+    lead -> note(B3, { duration: 400, slide: true, target_amp: 0.3 })
+
+    for i in [1, 2, 3]:
+        lead -> note(C5, { duration: 200 })
 
 # Play the lead
 
-call myLead
+call main
 ```
 
-And the best part ? You can play it directly from the command line:
+### And the best part ? You can play it directly from the command line:
 
 ```bash
 # Play the Devalang file
@@ -102,9 +119,9 @@ devalang play --watch
 devalang play --repeat
 ```
 
-### 🎉 You can now hear your Devalang code in action!
+### 🎉 You can now hear your Devalang code in action
 
-> For more examples, check out the [examples directory](./examples/).
+> For more examples, check out the [examples directory](./examples/)
 
 ## ❓ Why Devalang ?
 
@@ -128,7 +145,7 @@ devalang play --repeat
 
 ## 📄 Documentation
 
-### Please refer to the [online documentation](https://docs.devalang.com) for detailed information on syntax, features, and usage examples.
+### Please refer to the [online documentation](https://docs.devalang.com) for detailed information on syntax, features, and usage examples
 
 ## 🧯 Known issues
 

package/docs/CHANGELOG.md

@@ -1,9 +1,101 @@
 <div align="center">
-    <img src="https://devalang.com/images/devalang-logo.svg" alt="Devalang Logo" width="300" />
+    <img src="https://devalang.com/images/devalang-logo-min.png" alt="Devalang Logo" width="100" />
 </div>
 
 # Changelog
 
+## 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

package/docs/CONTRIBUTING.md

@@ -1 +1,101 @@
-# This file is a placeholder
+<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://devalang.com/images/devalang-logo.svg" alt="Devalang Logo" width="300" />
+    <img src="https://devalang.com/images/devalang-logo-min.png" alt="Devalang Logo" width="100" />
 </div>
 
 # Roadmap
@@ -27,4 +27,4 @@ Devalang is a work in progress. Here’s what we’re planning next:
 
 - ⏳ **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.
+- ⏳ **Testing**: Expand test coverage for all features.

package/docs/TODO.md

@@ -1,5 +1,5 @@
 <div align="center">
-    <img src="https://devalang.com/images/devalang-logo.svg" alt="Devalang Logo" width="300" />
+    <img src="https://devalang.com/images/devalang-logo-min.png" alt="Devalang Logo" width="100" />
 </div>
 
 # TODOs list

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

@@ -1,7 +1,7 @@
 # This file demonstrates the use of banks in Devalang.
 
-bank devaloop.808
+bank devaloop.808 as myBank
 
-.808.kick auto
-.808.snare auto
-.808.openhat auto
+.myBank.kick auto
+.myBank.snare auto
+.myBank.openhat auto

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)

package/examples/function.deva

@@ -1,11 +1,11 @@
 # This file demonstrates the use of main features in Devalang.
 bpm 135
 
-bank 808
+bank devaloop.808 as myBank
 
-let entityTest1 = .808.kick auto
-let entityTest2 = .808.clap auto
-let entityTest3 = .808.snare auto
+let entityTest1 = .myBank.kick auto
+let entityTest2 = .myBank.clap auto
+let entityTest3 = .myBank.snare auto
 
 fn myFirstGroup(entity1, entity2, entity3):
     .entity1