@devaloop/devalang 0.0.1-beta.1 → 0.0.1-beta.2

package/.devalang

@@ -1,10 +1,9 @@
-[defaults]
-entry = "./examples"
-output = "./output"
-watch = false
-debug = true
-compress = true
-
-[[banks]]
-path = "devalang://bank/devaloop.808"
-version = "0.0.1"
+[defaults]
+entry = "./examples"
+output = "./output"
+watch = false
+debug = true
+compress = true
+audio_format = "wav16"
+sample_rate = 44100
+output_format = ["wav", "mid"]

package/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "devalang"
-version = "0.0.1-beta.1"
+version = "0.0.1-beta.2"
 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"
@@ -29,7 +29,7 @@ default = ["cli"]
 cli = ["crossterm", "indicatif", "inquire", "zip", "reqwest", "flate2", "tokio"]
 
 [dependencies]
-devalang_types = { path = "rust/types", version = "0.0.2" }
+devalang_types = { path = "rust/types", version = "0.0.3" }
 clap = { version = "4.5", features = ["derive"] }
 serde = { version = "1.0", features = ["derive"] }
 serde_json = "1.0"
@@ -59,6 +59,7 @@ dirs = "5"
 urlencoding = "2.1"
 uuid = { version = "1.18.0", features = ["v4"] }
 console_error_panic_hook = "0.1.7"
+midly = "0.5.3"
 
 [dev-dependencies]
 assert_cmd = "2"
@@ -72,9 +73,9 @@ getrandom = { version = "0.3", features = ["wasm_js"] }
 uuid = { version = "1.18.0", features = ["v4", "js", "rng-getrandom"] }
 # Keep a lightweight linkage to the utils crate for wasm builds without
 # enabling native CLI features.
-devalang_utils = { path = "rust/utils", default-features = false, version = "0.0.1" }
+devalang_utils = { path = "rust/utils", default-features = false, version = "0.0.2" }
 
 # devalang_utils with CLI and wasmtime are only needed for native targets.
 [target.'cfg(not(target_arch = "wasm32"))'.dependencies]
-devalang_utils = { path = "rust/utils", features = ["cli"], version = "0.0.1" }
+devalang_utils = { path = "rust/utils", features = ["cli"], version = "0.0.2" }
 wasmtime = "19"

package/README.md

@@ -65,7 +65,7 @@ npm install -g @devaloop/devalang@latest
 #### With Rust
 
 ```bash
-cargo install devalang
+cargo install devalang --version <version>
 ```
 
 #### Initialize a new project
@@ -136,8 +136,8 @@ group myGroup:
     })
 
     # 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 })
+    myLead -> note(G4, { duration: 600, glide: true })
+    myLead -> note(B3, { duration: 400, slide: true })
 
 # Spawning the group & the pattern to play them in parallel
 spawn myGroup
@@ -173,8 +173,7 @@ devalang play --repeat
 ## 🚀 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.
+- 🎵 **Audio Engine & Real-time runner** — low-latency playback, render-to-file, and a realtime runner used by `devalang play --repeat` for live feedback.
 - 🧩 **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.
@@ -193,11 +192,14 @@ devalang play --repeat
 
 ## 📰 What's new
 
+- **MIDI export**: Added the ability to export MIDI files from Devalang scripts.
+- **Synthesizer improvements**: Enhanced the built-in synthesizer with new types and modulation options.
 - **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.
+- **Major refactor**: Significant codebase refactor for improved maintainability and performance.
 - **Bug fixes**: Various bug fixes and stability improvements.
 
 ## 🛡️ License

package/docs/CHANGELOG.md

@@ -4,6 +4,48 @@
 
 # Changelog
 
+## Version 0.0.1-beta.2 (2025-09-07)
+
+### 🛠️ MIDI & format
+
+- Added support for `mid` export in `build` command.
+  - Example: `devalang build --output-format mid,wav`
+- Added support for `wav16` and `wav32` audio formats in `play` command.
+  - Example: `devalang play --audio-format <wav16 | wav32>`
+- Added support for `sample_rate` parameter in `play` and `build` commands.
+  - Example: `devalang play --sample-rate <44100 | 48000 | 96000>`
+  - Example: `devalang build --sample-rate <44100 | 48000 | 96000>`
+
+### ✨ Language Features
+
+- `synth` enhancements:
+  - Types:
+    - Added `pad` type for lush, evolving sounds.
+    - Added `pluck` type for sharp, percussive tones.
+    - Added `arp` type for arpeggiated sequences.
+    - Added `sub` type for deep bass sounds.
+  - LFOs:
+    - Added `lfo` parameter to `synth` for low-frequency oscillation modulation.
+    - LFO supports `rate`, `depth`, and `target` parameters.
+  - Filters:
+      - Added `filters` parameter to `synth` for applying filters.
+- `arrow_call` enhancements:
+  - Added support for `chord` method to play multiple notes simultaneously.
+
+### 🧠 Architecture & Refactor
+
+- Modularized some core components to improve maintainability and readability.
+
+### 📚 Examples
+
+- Added `examples/filter.deva` to showcase filter usage in synths.
+- Added `examples/lfo.deva` to illustrate LFO modulation in synths.
+- Added `examples/synth_types.deva` to demonstrate various synth types.
+
+### 📦 WASM
+
+- Added `collect_playhead_events` function to the WASM module to collect playhead events during audio rendering.
+
 ## 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.

package/docs/ROADMAP.md

@@ -9,6 +9,7 @@ Devalang is a work in progress. Here’s what we’re planning next:
 ## Completed
 
 - ✅ **Audio engine**: Integrate the audio engine for sound playback.
+- ✅ **MIDI export**: Implement MIDI export functionality to save compositions as MIDI files.
 - ✅ **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`.
@@ -27,8 +28,11 @@ Devalang is a work in progress. Here’s what we’re planning next:
 
 - ⏳ **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
 
+- ⏳ **MIDI mapping**: Implement MIDI mapping for external control.
+- ⏳ **GUI**: Develop a graphical user interface for easier interaction.
+- ⏳ **Mixing & Routing**: Implement mixing and routing capabilities for advanced audio control.
+- ⏳ **Effect chains**: Implement effect chains for applying multiple effects to a single note or group.
 - ⏳ **Smart modules**: Let Devalang detect and use groups, samples, and variables without needing to import them manually.

package/docs/TODO.md

@@ -41,9 +41,8 @@ This is a list of tasks and features to be implemented in Devalang. Note that th
 - [x] @import
 - [x] @export
 - [x] @load
-- [ ] @include
 - [x] function
-- [ ] pattern
+- [x] pattern
 - [x] group
 - [x] call
 - [x] spawn
@@ -58,8 +57,8 @@ This is a list of tasks and features to be implemented in Devalang. Note that th
 
 ## Triggers
 
-- [x] Built-in triggers
 - [x] Custom triggers
+- [x] Event triggers
 
 ## Banks
 
@@ -69,14 +68,4 @@ This is a list of tasks and features to be implemented in Devalang. Note that th
 ## Plugins
 
 - [x] Implement plugin system (e.g. install, remove, list)
-- [ ] Create example plugins
-
-## Addon generator
-
-- [x] Implement addon generator
-- [ ] Create example addons
-
-## Other TODOs
-
-- [ ] Comment all core components
-- [ ] Add unit tests for all core components
+- [ ] Create example plugins

package/examples/bus.deva

@@ -0,0 +1,10 @@
+# NOTE Planned for future release
+
+# let sidechainBus = bus {
+#     fx: [
+#         { type: "compressor", threshold: -20, ratio: 8, attack: 5, release: 100,
+#           sidechain: myKick }
+#     ]
+# }
+# route myLead -> sidechainBus -> masterBus
+# route myKick -> myBass -> masterBus

package/examples/effect.deva

@@ -0,0 +1,2 @@
+# NOTE Planned for future release
+# myChord -> note(C4) -> arp({ pattern: "up", rate: 1/8 }) -> slide({ duration: 2000 }) -> echo({ delay: 250, feedback: 0.5 }) -> reverb({ room_size: 0.8 })

package/examples/filter.deva

@@ -0,0 +1,11 @@
+let myFilteredSynth = synth sine {
+    filters: [
+        { type: "lowpass", cutoff: 800.0, resonance: 1.0 },
+        { type: "bandpass", cutoff: 400.0, resonance: 1.0 },
+        { type: "highpass", cutoff: 200.0, resonance: 1.0 }
+    ],
+}
+
+myFilteredSynth -> note(C4, { duration: 500 })
+myFilteredSynth -> note(E4, { duration: 500 })
+myFilteredSynth -> note(G4, { duration: 500 })

package/examples/lfo.deva

@@ -0,0 +1,9 @@
+let myLFOSynth = synth sine {
+    lfo: {
+        rate: 1/4,
+        depth: 0.5,
+        target: "cutoff"
+    }
+}
+
+myLFOSynth -> note(C4, { duration: 500 })

package/examples/synth.deva

@@ -11,4 +11,14 @@ group myLead:
     mySynth -> note(D4, { duration: 400 })
     mySynth -> note(B3, { duration: 600 })
 
-@export { myLead }
+group myChords:
+    let chordSynth = synth square
+    
+    chordSynth -> chord(Cmaj, { duration: 1600 })
+    chordSynth -> chord(Fmaj, { duration: 1600 })
+    chordSynth -> chord(Gmaj, { duration: 1600 })
+    chordSynth -> chord(Am, { duration: 1600 })
+
+# Play both groups together
+spawn myLead
+spawn myChords

package/examples/synth_types.deva

@@ -0,0 +1,17 @@
+let myPad = synth sine {
+    type: "pad"
+}
+
+let myPluck = synth sine {
+    type: "pluck"
+}
+
+let myArp = synth sine {
+    type: "arp",
+    rate: 16,
+    step: 2
+}
+
+let mySub = synth sine {
+    type: "sub",
+}

package/out-tsc/core/functions/index.d.ts

@@ -30,6 +30,11 @@ export declare function register_playhead_callback(cb: (ev: {
     line: number;
     column: number;
 }) => void): any;
+/**
+ * Collects playhead events that have been recorded during playback.
+ * @returns Array of playhead events { time, line, column }.
+ */
+export declare function collect_playhead_events(): any;
 /**
  * Unregisters the JS callback for playhead events.
  * @returns void

package/out-tsc/core/functions/index.js

@@ -4,6 +4,7 @@ exports.parse = parse;
 exports.debug_render = debug_render;
 exports.render_audio = render_audio;
 exports.register_playhead_callback = register_playhead_callback;
+exports.collect_playhead_events = collect_playhead_events;
 exports.unregister_playhead_callback = unregister_playhead_callback;
 let wasmPkg = undefined;
 try {
@@ -64,6 +65,16 @@ function register_playhead_callback(cb) {
     // no-op fallback
     return;
 }
+/**
+ * Collects playhead events that have been recorded during playback.
+ * @returns Array of playhead events { time, line, column }.
+ */
+function collect_playhead_events() {
+    if (wasmPkg && typeof wasmPkg.collect_playhead_events === "function") {
+        return wasmPkg.collect_playhead_events();
+    }
+    return [];
+}
 /**
  * Unregisters the JS callback for playhead events.
  * @returns void

package/out-tsc/pkg/devalang_core.d.ts

@@ -2,12 +2,14 @@ export declare function parse(...args: any[]): any;
 export declare function debug_render(...args: any[]): any;
 export declare function render_audio(...args: any[]): any;
 export declare function register_playhead_callback(cb?: any): any;
+export declare function collect_playhead_events(): any;
 export declare function unregister_playhead_callback(): any;
 declare const pkg: {
     parse: typeof parse;
     debug_render: typeof debug_render;
     render_audio: typeof render_audio;
     register_playhead_callback: typeof register_playhead_callback;
+    collect_playhead_events: typeof collect_playhead_events;
     unregister_playhead_callback: typeof unregister_playhead_callback;
 };
 export default pkg;

package/out-tsc/pkg/devalang_core.js

@@ -4,6 +4,7 @@ exports.parse = parse;
 exports.debug_render = debug_render;
 exports.render_audio = render_audio;
 exports.register_playhead_callback = register_playhead_callback;
+exports.collect_playhead_events = collect_playhead_events;
 exports.unregister_playhead_callback = unregister_playhead_callback;
 /**
  * Shim TypeScript source that re-exports the runtime wasm-pack package when
@@ -41,10 +42,24 @@ function register_playhead_callback(cb) {
         return runtimePkg.register_playhead_callback(cb);
     return;
 }
+function collect_playhead_events() {
+    if (runtimePkg && typeof runtimePkg.collect_playhead_events === "function") {
+        return runtimePkg.collect_playhead_events();
+    }
+    return [];
+}
 function unregister_playhead_callback() {
-    if (runtimePkg && typeof runtimePkg.unregister_playhead_callback === "function")
+    if (runtimePkg &&
+        typeof runtimePkg.unregister_playhead_callback === "function")
         return runtimePkg.unregister_playhead_callback();
     return;
 }
-const pkg = { parse, debug_render, render_audio, register_playhead_callback, unregister_playhead_callback };
+const pkg = {
+    parse,
+    debug_render,
+    render_audio,
+    register_playhead_callback,
+    collect_playhead_events,
+    unregister_playhead_callback,
+};
 exports.default = pkg;

package/out-tsc/pkg/devalang_core_bg.wasm.d.ts

@@ -1,28 +1,29 @@
 /* tslint:disable */
 /* eslint-disable */
 export const memory: WebAssembly.Memory;
-export const debug_render: (a: number, b: number) => [number, number, number];
 export const parse: (a: number, b: number, c: number, d: number) => [number, number, number];
-export const register_playhead_callback: (a: any) => void;
+export const debug_render: (a: number, b: number) => [number, number, number];
 export const render_audio: (a: number, b: number) => [number, number, number];
+export const register_playhead_callback: (a: any) => void;
+export const collect_playhead_events: () => [number, number, number];
 export const unregister_playhead_callback: () => void;
+export const rust_lzma_wasm_shim_malloc: (a: number) => number;
 export const rust_lzma_wasm_shim_calloc: (a: number, b: number) => number;
 export const rust_lzma_wasm_shim_free: (a: number) => void;
-export const rust_lzma_wasm_shim_malloc: (a: number) => number;
-export const rust_lzma_wasm_shim_memchr: (a: number, b: number, c: number) => number;
 export const rust_lzma_wasm_shim_memcmp: (a: number, b: number, c: number) => number;
 export const rust_lzma_wasm_shim_memcpy: (a: number, b: number, c: number) => number;
 export const rust_lzma_wasm_shim_memmove: (a: number, b: number, c: number) => number;
 export const rust_lzma_wasm_shim_memset: (a: number, b: number, c: number) => number;
 export const rust_lzma_wasm_shim_strlen: (a: number) => number;
-export const rust_zstd_wasm_shim_calloc: (a: number, b: number) => number;
-export const rust_zstd_wasm_shim_free: (a: number) => void;
+export const rust_lzma_wasm_shim_memchr: (a: number, b: number, c: number) => number;
+export const rust_zstd_wasm_shim_qsort: (a: number, b: number, c: number, d: number) => void;
 export const rust_zstd_wasm_shim_malloc: (a: number) => number;
 export const rust_zstd_wasm_shim_memcmp: (a: number, b: number, c: number) => number;
+export const rust_zstd_wasm_shim_calloc: (a: number, b: number) => number;
+export const rust_zstd_wasm_shim_free: (a: number) => void;
 export const rust_zstd_wasm_shim_memcpy: (a: number, b: number, c: number) => number;
 export const rust_zstd_wasm_shim_memmove: (a: number, b: number, c: number) => number;
 export const rust_zstd_wasm_shim_memset: (a: number, b: number, c: number) => number;
-export const rust_zstd_wasm_shim_qsort: (a: number, b: number, c: number, d: number) => void;
 export const __wbindgen_malloc: (a: number, b: number) => number;
 export const __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
 export const __wbindgen_exn_store: (a: number) => void;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@devaloop/devalang",
   "private": false,
-  "version": "0.0.1-beta.1",
+  "version": "0.0.1-beta.2",
   "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.",
   "main": "out-tsc/index.js",
   "bin": {

package/project-version.json

@@ -1,6 +1,6 @@
 {
-  "version": "0.0.1-beta.1",
+  "version": "0.0.1-beta.2",
   "channel": "beta",
-  "lastCommit": "888ed3a754f3bc95362eb9742c2ed8873b3cfd5f",
-  "build": 0
+  "lastCommit": "024b7abee45bdc5e034a4efd4a3f60dbd958eec0",
+  "build": 1
 }