@devaloop/devalang 0.0.1-beta.3 → 0.1.2

package/docs/CONTRIBUTING.md

@@ -1,101 +0,0 @@
-<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,38 +0,0 @@
-<div align="center">
-    <img src="https://devalang.com/images/devalang-logo-min.png" alt="Devalang Logo" width="100" />
-</div>
-
-# Roadmap
-
-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`.
-- ✅ **AST generation**: Implement the Abstract Syntax Tree (AST) generation for debugging and future compilation.
-- ✅ **Basic data types**: Support strings, numbers, booleans, maps, and arrays.
-- ✅ **BPM assignment**: Implement `bpm` assignment to set the tempo.
-- ✅ **Bank declaration**: Add `bank` declaration to define the instrument set.
-- ✅ **Looping system**: Implement a looping system with fixed repetitions using `loop 4:`.
-- ✅ **Instruction calls**: Add support for instruction calls with parameters (e.g. `.kick auto {reverb:10, decay:20}`).
-- ✅ **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.
-- ✅ **Addon generator**: Implement addon generation for creating reusable plugins, banks and presets.
-- ✅ **Effect chains**: Implement effect chains for applying multiple effects to a single note or group.
-
-## In Progress
-
-- ⏳ **Testing**: Expand test coverage for all features.
-- ⏳ **Mixing & Routing**: Implement mixing and routing capabilities for advanced audio control.
-
-## Planned
-
-- ⏳ **MIDI mapping**: Implement MIDI mapping for external control.
-- ⏳ **GUI**: Develop a graphical user interface for easier interaction.
-- ⏳ **Smart modules**: Let Devalang detect and use groups, samples, and variables without needing to import them manually.

package/docs/TODO.md

@@ -1,71 +0,0 @@
-<div align="center">
-    <img src="https://devalang.com/images/devalang-logo-min.png" alt="Devalang Logo" width="100" />
-</div>
-
-# TODOs list
-
-This is a list of tasks and features to be implemented in Devalang. Note that this is not an exhaustive list, and some items may be added or removed over time.
-
-## Commands
-
-- [x] Init project
-  - [x] Implement init command
-  - [x] Implement template selector
-- [x] Template
-  - [x] Implement template list
-  - [x] Implement template info
-- [x] Checking
-  - [x] Implement watch mode
-  - [x] Implement debug mode
-- [x] Building
-  - [x] Implement watch 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
-
-- [x] Audio Engine
-- [x] Lexer
-- [x] Parser
-- [x] Preprocessor
-- [x] Debugger
-- [x] Builder
-
-## Syntax elements
-
-- [x] #
-- [x] @import
-- [x] @export
-- [x] @load
-- [x] function
-- [x] pattern
-- [x] group
-- [x] call
-- [x] spawn
-- [x] sleep
-- [x] bpm
-- [x] bank
-- [x] loop
-- [x] let
-- [x] if
-- [x] else
-- [x] else if
-
-## Triggers
-
-- [x] Custom triggers
-- [x] Event 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

package/examples/automation.deva

@@ -1,42 +0,0 @@
-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 +0,0 @@
-# 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/bus.deva

@@ -1,10 +0,0 @@
-# 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/chain.deva

@@ -1,19 +0,0 @@
-let myChord = synth sine
-
-myChord -> note(C4)
-        -> arp({ pattern: "up", rate: 1/8 }) 
-        -> slide({ duration: 2000 }) 
-        -> echo({ delay: 250, feedback: 0.5 }) 
-        -> reverb({ room_size: 0.8 })
-
-myChord -> note(E4)
-        -> arp({ pattern: "up", rate: 1/8 }) 
-        -> slide({ duration: 2000 }) 
-        -> echo({ delay: 250, feedback: 0.5 }) 
-        -> reverb({ room_size: 0.8 })
-
-myChord -> note(G4)
-        -> arp({ pattern: "up", rate: 1/8 })
-        -> slide({ duration: 2000 })
-        -> echo({ delay: 250, feedback: 0.5 })
-        -> reverb({ room_size: 0.8 })

package/examples/condition.deva

@@ -1,20 +0,0 @@
-# This file demonstrates the use of conditional blocks in Devalang.
-
-@import { duration, default_bank, params, loopCount, tempo } from "./variables.deva"
-@import { myGroup } from "./group.deva"
-
-@load "./samples/kick-808.wav" as kickCustom
-@load "./samples/hat-808.wav" as hatCustom
-
-group conditionBlock:
-    if tempo > 120:
-        # Will be executed if the condition is true
-        .kickCustom auto
-    else if tempo > 155:
-        # Will be executed if the condition is false
-        .hatCustom auto
-    else:
-        .kickCustom auto
-        .hatCustom auto
-
-@export { conditionBlock }

package/examples/duration.deva

@@ -1,9 +0,0 @@
-# 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/effect.deva

@@ -1,2 +0,0 @@
-# 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/events.deva

@@ -1,12 +0,0 @@
-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/filter.deva

@@ -1,11 +0,0 @@
-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/function.deva

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

package/examples/group.deva

@@ -1,12 +0,0 @@
-# This file demonstrates the use of grouping 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
-
-group myGroup:
-    .kickCustom duration params
-    .hatCustom duration params
-
-@export { myGroup }

package/examples/index.deva

@@ -1,63 +0,0 @@
-# This file demonstrates general use cases of Devalang.
-
-# 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

package/examples/lfo.deva

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

package/examples/loop.deva

@@ -1,10 +0,0 @@
-# This file demonstrates the use of loops in Devalang.
-
-group myLoop:
-    for i in [1, 2, 3]:
-        print "looping with for" + i
-
-    loop 3:
-        print "looping with loop"
-
-@export { myLoop }

package/examples/pattern.deva

@@ -1,8 +0,0 @@
-# This file demonstrates the usage of patterns in Devaloop
-
-bank devaloop.808 as my808
-
-# Pattern literal without options
-pattern kickPattern with my808.kick = "x--- x--- x--- x---"
-
-call kickPattern

package/examples/plugin.deva

@@ -1,16 +0,0 @@
-# This is an example of using a plugin in Devalang.
-# Make sure you have the plugin installed in your Devaloop application. (devalang addon install <author>.<addon_name>)
-
-@use devaloop.acid as acidPlugin
-
-group acidSynthGroup:
-    let acidSynth = synth acidPlugin.synth {
-        waveform: "saw",
-        resonance: 1.0,
-    }
-
-    acidSynth -> note(C4, { duration: 1000 })
-    acidSynth -> note(E3, { duration: 1000 })
-    acidSynth -> note(B2, { duration: 1000 })
-
-call acidSynthGroup

package/examples/routing.deva

@@ -1,23 +0,0 @@
-# NOTE Future version of Deva may include built-in routing capabilities.
-
-# @load "./samples/kick-808.wav" as kickCustom
-
-# group myLead:
-#     let mySynth = synth sine
-    
-#     mySynth -> note(C4, { duration: 400 })
-
-# group myKick:
-#     .kickCustom 1/4
-    
-# routing:
-#     node $master
-#     node myLead
-#     node myKick
-#     node hallReverb = effect reverb { decay: 3.0, mix: 0.5 }
-
-#     connect myLead -> hallReverb -> $master
-    
-#     connect myLead -> $master with { delay: { time: 300, feedback: 0.3 } }
-    
-#     connect myKick -> myLead with { sidechain: 0.6 }

package/examples/synth.deva

@@ -1,24 +0,0 @@
-# This file defines a simple synth lead using Devalang's syntax.
-
-group myLead:
-    let mySynth = synth sine
-    
-    mySynth -> note(C4, { duration: 400 })
-    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 })
-
-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

@@ -1,17 +0,0 @@
-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/examples/variables.deva

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

package/out-tsc/bin/project-version.json

@@ -1,6 +0,0 @@
-{
-  "version": "0.0.1-beta.3",
-  "channel": "beta",
-  "lastCommit": "d9c8d5927288897aebf7faceb2b3495b5b8b87eb",
-  "build": 2
-}

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

@@ -1,42 +0,0 @@
-import { ParseResult } from "../types/result";
-import { DebugResult } from "../types/result";
-/**
- * Parses the user code.
- * @param entry_path The entry path for the code.
- * @param source The source code to parse.
- * @returns ParseResult | any
- */
-export declare function parse(entry_path: string, source: string): ParseResult | any;
-/**
- * Renders the debug information for the user code.
- * @param user_code The user-provided code to render debug information for.
- * @returns DebugResult | any
- */
-export declare function debug_render(user_code: string): DebugResult | any;
-/**
- * Renders audio from the user code.
- * @param user_code The user-provided code to render audio from.
- * @returns Float32Array
- */
-export declare function render_audio(user_code: string): Float32Array;
-/**
- * Register a JS callback to receive playhead events { time, line, column } during playback.
- * The callback will be called with a single object argument.
- * @param cb The callback function to register.
- * @returns void
- */
-export declare function register_playhead_callback(cb: (ev: {
-    time: number;
-    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
- */
-export declare function unregister_playhead_callback(): any;