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

package/.devalang

@@ -2,6 +2,8 @@
 entry = "./examples"
 output = "./output"
 watch = false
+debug = true
+compress = true
 
 [[banks]]
 path = "devalang://bank/devaloop.808"

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.15"
-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"
+[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)

package/docs/CHANGELOG.md

@@ -1,9 +1,42 @@
 <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

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

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

@@ -18,7 +18,7 @@ group myLead:
     #         100% = 12.0
     #     }
     
-    # This will automate only C4
+    # This will automate only one note
     mySynth -> note(C4, { 
         duration: 400,
         automate: {
@@ -39,6 +39,4 @@ group myLead:
     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

package/examples/index.deva

@@ -1,3 +1,5 @@
+# This file demonstrates general uses of Devalang.
+
 bpm 120
 
 group main:
@@ -38,8 +40,4 @@ group main:
 	lead -> note(G4, { duration: 600, glide: true, target_freq: 659.25 })
 	lead -> note(B3, { duration: 400, slide: true, target_amp: 0.3 })
 
-	# Simple looped fill
-	for i in [1, 2, 3]:
-		lead -> note(C5, { duration: 200 })
-
-call main
+call main

package/examples/loop.deva

@@ -1,16 +1,10 @@
-# This file demonstrates the use of a loop in Devalang.
-
-@import { duration, default_bank, params, loopCount, tempo } from "./variables.deva"
-
-@load "./samples/kick-808.wav" as kickCustom
-@load "./samples/hat-808.wav" as hatCustom
+# This file demonstrates the use of loops in Devalang.
 
 group myLoop:
-    loop loopCount:
-        .kickCustom duration params
+    for i in [1, 2, 3]:
+        print "looping with for" + i
 
-        # Uncomment the next line (.hatCustom) while executing "play" command
-        # with `--repeat` option to see magic happen !
-        # .hatCustom duration params
+    loop 3:
+        print "looping with loop"
 
 @export { myLoop }

package/examples/pattern.deva

@@ -0,0 +1,8 @@
+# TODO planned for future release
+
+# bank devaloop.808 as 808
+
+# # Pattern literal without options
+# pattern kickPattern with 808.kick = "x--- x--- x--- x---"
+
+# call kickPattern

package/examples/plugin.deva

@@ -1,15 +1,16 @@
-# NOTE: Available in next release
+# This is an example of using a plugin in Devalang.
+# Make sure you have the plugin installed in your Devaloop application. (devalang install plugin <author>.<plugin_name>)
 
-# @use devaloop.acid as acidPlugin
+@use devaloop.acid as acidPlugin
 
-# let acidSynth = synth acidPlugin.synth {
-#     waveform: "saw",
-#     accent: 0.1,
-#     decay: 250
-# }
+let acidSynth = synth acidPlugin.synth {
+    waveform: "saw",
+    accent: 0.1,
+    decay: 250
+}
 
-# group mySynthGroup:
-#     acidSynth -> note(C4, { duration: 600 })
-#     acidSynth -> note(E4, { duration: 600 })
+group mySynthGroup:
+    acidSynth -> note(C4, { duration: 600 })
+    acidSynth -> note(E4, { duration: 600 })
 
-# call mySynthGroup
+call mySynthGroup

package/examples/variables.deva

@@ -1,7 +1,7 @@
 # This file only exports variables for use in other files.
 
 let duration = auto
-let default_bank = 808
+let default_bank = devaloop.808
 let params = { decay: 10, delay: 30 }
 let loopCount = 5
 let tempo = 115

package/out-tsc/bin/index.js

@@ -1,13 +1,57 @@
 #!/usr/bin/env node
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 const child_process_1 = require("child_process");
-const path_1 = __importDefault(require("path"));
-const binaryPath = path_1.default.join(__dirname, "devalang.exe");
-const subCommand = process.argv[2] || "help";
+const path = __importStar(require("path"));
+let binaryName;
+switch (process.platform) {
+    case "win32":
+        binaryName = "devalang-x86_64-pc-windows-msvc.exe";
+        break;
+    case "darwin":
+        binaryName = "devalang-x86_64-apple-darwin";
+        break;
+    case "linux":
+        binaryName = "devalang-x86_64-unknown-linux-gnu";
+        break;
+    default:
+        console.error(`Unsupported platform: ${process.platform}`);
+        process.exit(1);
+}
+const binaryPath = path.join(__dirname, binaryName);
 const args = process.argv.slice(2);
 const child = (0, child_process_1.spawn)(binaryPath, args, { stdio: "inherit" });
-child.on("exit", (code) => process.exit(code));
+child.on("exit", (code) => process.exit(code !== null && code !== void 0 ? code : 1));

package/out-tsc/index.js

@@ -1,2 +1,4 @@
 "use strict";
-// This file is part of the Devalang project
+/**
+ * TypeScript wrapper for Devalang.
+ */

package/out-tsc/scripts/postbuild.js

@@ -1,11 +1,10 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-const source = path_1.default.join(__dirname, "..", "..", "target", "release", "devalang.exe");
-const destination = path_1.default.join(__dirname, "..", "bin", "devalang.exe");
-fs_1.default.copyFileSync(source, destination);
-fs_1.default.chmodSync(destination, 0o755);
+/**
+ * NOTE: This script is deprecated since we use Github Actions
+ */
+// import fs from "fs";
+// import path from "path";
+// const source = path.join(__dirname, "..", "..", "target", "release", "devalang.exe");
+// const destination = path.join(__dirname, "..", "bin", "devalang.exe");
+// fs.copyFileSync(source, destination);
+// fs.chmodSync(destination, 0o755);