@devaloop/devalang 0.0.1-beta.2 → 0.1.1

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.
-
-## In Progress
-
-- ⏳ **Addon generator**: Implement addon generation for creating reusable plugins, banks and presets.
-- ⏳ **Testing**: Expand test coverage for all features.
-
-## 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

@@ -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/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 install plugin <author>.<plugin_name>)
-
-@use devaloop.acid as acidPlugin
-
-let acidSynth = synth acidPlugin.synth {
-    waveform: "saw",
-    accent: 0.1,
-    decay: 250
-}
-
-group mySynthGroup:
-    acidSynth -> note(C4, { duration: 600 })
-    acidSynth -> note(E4, { duration: 600 })
-
-call mySynthGroup

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/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;

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

@@ -1,87 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-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 {
-    // prefer runtime pkg generated by wasm-pack when available
-    // require at runtime so the package can be used even if wasm hasn't been built
-    // (this keeps tests and consumers robust).
-    // eslint-disable-next-line @typescript-eslint/no-var-requires
-    wasmPkg = require("../../pkg/devalang_core");
-}
-catch (_e) {
-    wasmPkg = undefined;
-}
-/**
- * Parses the user code.
- * @param entry_path The entry path for the code.
- * @param source The source code to parse.
- * @returns ParseResult | any
- */
-function parse(entry_path, source) {
-    if (wasmPkg && typeof wasmPkg.parse === "function") {
-        return wasmPkg.parse(entry_path, source);
-    }
-    throw new Error("WASM binding 'parse' not available. Build the wasm package or use the JS runtime.");
-}
-/**
- * Renders the debug information for the user code.
- * @param user_code The user-provided code to render debug information for.
- * @returns DebugResult | any
- */
-function debug_render(user_code) {
-    if (wasmPkg && typeof wasmPkg.debug_render === "function") {
-        return wasmPkg.debug_render(user_code);
-    }
-    throw new Error("WASM binding 'debug_render' not available. Build the wasm package or use the JS runtime.");
-}
-/**
- * Renders audio from the user code.
- * @param user_code The user-provided code to render audio from.
- * @returns Float32Array
- */
-function render_audio(user_code) {
-    if (wasmPkg && typeof wasmPkg.render_audio === "function") {
-        return wasmPkg.render_audio(user_code);
-    }
-    // Fallback: indicate missing wasm with an empty buffer rather than breaking consumers.
-    return new Float32Array(0);
-}
-/**
- * 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
- */
-function register_playhead_callback(cb) {
-    if (wasmPkg && typeof wasmPkg.register_playhead_callback === "function") {
-        return wasmPkg.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
- */
-function unregister_playhead_callback() {
-    if (wasmPkg && typeof wasmPkg.unregister_playhead_callback === "function") {
-        return wasmPkg.unregister_playhead_callback();
-    }
-    return;
-}

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

@@ -1,6 +0,0 @@
-/**
- * Core functionality for the Devalang language.
- * This module exports all the core types and functions used in the language.
- */
-export * from "./types/index";
-export * from "./functions/index";

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

@@ -1,4 +0,0 @@
-export * from "./result";
-export * from "./statement";
-export * from "./value";
-export * from "./plugin";

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

@@ -1,20 +0,0 @@
-"use strict";
-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 __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./result"), exports);
-__exportStar(require("./statement"), exports);
-__exportStar(require("./value"), exports);
-__exportStar(require("./plugin"), exports);

package/out-tsc/core/types/plugin.d.ts

@@ -1,18 +0,0 @@
-/**
- * Represents a plugin export.
- */
-export interface PluginExport {
-    name: string;
-    kind: string;
-    default?: any;
-}
-/**
- * Represents a plugin.
- */
-export interface PluginInfo {
-    author: string;
-    name: string;
-    version?: string;
-    description?: string;
-    exports: PluginExport[];
-}

package/out-tsc/core/types/plugin.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/out-tsc/core/types/result.d.ts

@@ -1,27 +0,0 @@
-/**
- * Represents an error that occurred during parsing.
- */
-export interface ErrorResult {
-    message: string;
-    line: number;
-    column: number;
-}
-/**
- * Represents the result of parsing user code.
- */
-export interface ParseResult {
-    ok: boolean;
-    ast: string;
-    errors: ErrorResult[];
-}
-/**
- * Represents the result of debugging user code.
- */
-export interface DebugResult {
-    samples_len: number;
-    any_nonzero: boolean;
-    ast: string;
-    note_count: number;
-    global_vars: string[];
-    statements_count: number;
-}

package/out-tsc/core/types/result.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });