@devaloop/devalang 0.0.1-alpha.9 → 0.0.1-beta.1

package/docs/COMMANDS.md

@@ -1,85 +0,0 @@
-<div align="center">
-    <img src="https://firebasestorage.googleapis.com/v0/b/devaloop-labs.firebasestorage.app/o/devalang-teal-logo.svg?alt=media&token=d2a5705a-1eba-4b49-88e6-895a761fb7f7" alt="Devalang Logo">
-</div>
-
-# Devalang Commands Guide
-
-## Initialization
-
-Initialize a new Devalang project (current folder)
-
-```bash
-devalang init
-```
-
-Initialize a new Devalang project (new folder)
-
-```bash
-devalang init --name <project-name> --template <template-name>
-```
-
-Available arguments:
-
-- `--name`: The name of the project (cannot be empty)
-- `--template`: The template to use for the project (default to `welcome`)
-
-## Checking
-
-Checking syntax of .deva file(s)
-
-```bash
-devalang check --entry ./examples --output ./output --watch
-```
-
-Available arguments :
-
-- `--no-config`: Whether to ignore the configuration file (default to `false`)
-- `--entry`: The input folder (default to `./src`)
-- `--output`: The output folder (default to `./output`)
-- `--watch`: Whether to watch for changes and re-analyze (default to `false`)
-
-## Building
-
-Building AST of .deva file(s)
-
-```bash
-devalang build --entry ./examples --output ./output --watch
-```
-
-Available arguments :
-
-- `--no-config`: Whether to ignore the configuration file (default to `false`)
-- `--entry`: The input folder (default to `./src`)
-- `--output`: The output folder (default to `./output`)
-- `--watch`: Whether to watch for changes and rebuild (default to `false`)
-
-
-## Playing
-
-Playing .deva file(s) without audio playback (once)
-
-```bash
-devalang play --entry ./examples --output ./output
-```
-
-Playing .deva file(s) with audio playback (once by file change)
-
-```bash
-devalang play --entry ./examples --output ./output --watch
-```
-
-Playing .deva file(s) with audio playback (infinite loop)
-
-```bash
-devalang play --entry ./examples --output ./output --repeat
-```
-
-Note : You cannot use `--watch` and `--repeat` options together. Use `--repeat` instead.
-
-Available arguments :
-
-- `--no-config`: Whether to ignore the configuration file (default to `false`)
-- `--entry`: The input folder (default to `./src`)
-- `--output`: The output folder (default to `./output`)
-- `--watch`: Whether to watch for changes and rebuild + play (default to `false`)
-- `--repeat`: Whether to repeat the playback of the audio file (default to `false`)

package/docs/CONFIG.md

@@ -1,30 +0,0 @@
-<div align="center">
-    <img src="https://firebasestorage.googleapis.com/v0/b/devaloop-labs.firebasestorage.app/o/devalang-teal-logo.svg?alt=media&token=d2a5705a-1eba-4b49-88e6-895a761fb7f7" alt="Devalang Logo">
-</div>
-
-# Devalang Configuration File
-
-Use a configuration file if you don't want to pass command-line arguments every time you run a command. The configuration file allows you to set default values for various settings, making it easier to manage your Devalang project.
-
-## Ignoring the Configuration File
-
-If you prefer not to use a configuration file, you can ignore it by passing the `--no-config` flag when running Devalang commands. This will bypass any settings defined in the configuration file and use only the command-line arguments you provide.
-
-## Structure of the Configuration File
-
-The configuration file is a TOML (Tom's Obvious, Minimal Language) file that contains key-value pairs to define various settings for your Devalang project. Below is a sample configuration file:
-
-```toml
-[defaults]
-entry = "./src"
-output = "./output"
-watch = false
-repeat = true
-```
-
-### Available Settings
-
-- `entry`: (String) The entry point for your Devalang project (default to `./src`)
-- `output`: (String) The output directory for generated files (default to `./output`)
-- `watch`: (Boolean) Whether to watch for changes in files and automatically rebuild or check them (default to `false`)
-- `repeat`: (Boolean) Whether to repeat the playback of audio files (default to `false`)

package/docs/SYNTAX.md

@@ -1,210 +0,0 @@
-<div align="center">
-    <img src="https://firebasestorage.googleapis.com/v0/b/devaloop-labs.firebasestorage.app/o/devalang-teal-logo.svg?alt=media&token=d2a5705a-1eba-4b49-88e6-895a761fb7f7" alt="Devalang Logo">
-</div>
-
-# Devalang Syntax Guide
-
-Devalang supports a simple and intuitive syntax for composing music and sound design. Below is a guide to the basic syntax elements, types, and usage examples.
-
-The engine is designed to be easy to read and write, allowing you to focus on your music rather than the code.
-
-The engine uses indentation to define blocks, similar to Python. Each block must be indented consistently.
-
-➡️ For full examples, check the `examples/` folder of the repository.
-
-## Types
-
-<details>
-<summary>Show available types</summary>
-
-### Duration
-
-Duration is defined using a number. It represents the length of a sound in milliseconds.
-
-```deva
-let duration = 1000
-```
-
-Will play a sound for 1000 milliseconds (1 second).
-
-NOTE: Other time units like seconds or beats are not supported yet, but will be in the future.
-
-### String
-
-Strings are defined using double quotes.
-
-```deva
-let string = "myValue"
-```
-
-### Number
-
-Numbers can be integers or floating-point values. They do not require quotes.
-
-```deva
-let number = 99
-```
-
-### Boolean
-
-Booleans can be either `true` or `false` without quotes.
-
-```deva
-let boolean = false
-```
-
-### Map
-
-Maps are key-value pairs defined using curly braces. Keys are strings, and values can be of any type (string, number, boolean, map, or array).
-
-```deva
-let map = { myKey: 99 }
-```
-
-### Array
-
-Arrays are ordered lists of values defined using square brackets. Values can be of any type (string, number, boolean, map, or array).
-
-```deva
-let array = [3, 4]
-```
-
-</details>
-
-## Syntax usage
-
-### Beats Per Minute
-
-BPM is used to set the global tempo of the music.
-
-```deva
-bpm 125
-```
-
-### Sound Bank
-
-Bank is used to select a sound bank for the audio engine.
-
-```deva
-bank 808
-```
-
-### Importing / Exporting Modules
-
-Modules can be imported and exported to share variables between different files.
-
-> ⚠️ The import/export system is still experimental and may change in the future.
->
-> You must explicitly declare imports and exports in each file — Devalang does not automatically detect or resolve them.
-
-Exporting variables from a module :
-
-```deva
-# exported.deva
-
-let exportedIterator = 10
-let exportedParams = { drive: 50, decay: 30 }
-
-@export { exportedIterator, exportedParams }
-```
-
-Importing and using the exported variables in another module :
-
-```deva
-# index.deva
-
-@import { exportedIterator, exportedParams } "./exported.deva"
-
-loop exportedIterator:
-    .kick auto exportedParams
-```
-
-### Loading Samples
-
-You can load your own samples and use them in your music.
-
-Load usage : `@load <path> as <name>`
-
-Trigger usage : `.<name> <duration> <params>`
-
-```deva
-@load "./path/to/instrument.mp3" as mySample
-
-.mySample auto {reverb: 50, drive: 25}
-```
-
-### Variables
-
-Variables are defined using the `let` keyword, followed by the variable name and its value. The value can be of any type (string, number, boolean, map, or array).
-
-```deva
-let number = 0
-let boolean = true
-let string = "string"
-let map = { myKey: 200 }
-let array = [0, 1, 2]
-```
-
-### Loops
-
-Loops are defined using the `loop` keyword, followed by the number of iterations. The body of the loop is indented.
-
-```deva
-loop 10:
-    # ...
-```
-
-### Groups
-
-Groups are defined using the `group` keyword, followed by the group name. The body of the group is indented.
-
-Groups allow you to organize your code into reusable blocks. They can be called or spawned later in the code.
-
-```deva
-group myGroup:
-    # ...
-```
-
-### Conditions
-
-Conditions are defined using the `if` keyword, followed by a condition. The body of the condition is indented.
-
-```deva
-if myCondition:
-    # ...
-```
-
-You can also use `else` and `else if` for alternative branches:
-
-```deva
-if myCondition:
-    # ...
-else if anotherCondition:
-    # ...
-else:
-    # ...
-```
-
-### Calling Groups (Sequential Execution)
-
-Groups can be called using the `call` keyword, which executes only the group in sequence.
-
-> ⚠️ `call` only works on `group` declarations. It does not apply to other statements.
-
-This executes the entire group in the current execution thread, following a sequential order.
-
-```deva
-call myGroup
-```
-
-### Spawning Groups (Parallel Execution)
-
-Groups can be spawned using the `spawn` keyword, which executes only the group in parallel.
-
-> ⚠️ spawn also only works on group declarations. It does not make the group’s content parallel unless it explicitly uses spawn inside.
-
-This runs the entire group in a separate execution thread, allowing it to play alongside other actions.
-
-```deva
-spawn myGroup
-```

package/out-tsc/scripts/postbuild.js

@@ -1,11 +0,0 @@
-"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);

package/rust/cli/build.rs

@@ -1,137 +0,0 @@
-use crate::{
-    config::Config,
-    core::{
-        builder::Builder,
-        debugger::{
-            lexer::write_lexer_log_file,
-            preprocessor::write_preprocessor_log_file,
-            store::write_store_log_file,
-        },
-        preprocessor::loader::ModuleLoader,
-        store::global::GlobalStore,
-        utils::path::{ find_entry_file, normalize_path },
-    },
-    utils::{ logger::{ LogLevel, Logger }, spinner::with_spinner, watcher::watch_directory },
-};
-use std::{ thread, time::Duration };
-
-#[cfg(feature = "cli")]
-pub fn handle_build_command(
-    config: Option<Config>,
-    entry: Option<String>,
-    output: Option<String>,
-    watch: bool
-) {
-    let fetched_entry = if entry.is_none() {
-        config
-            .as_ref()
-            .and_then(|c| c.defaults.entry.clone())
-            .unwrap_or_else(|| "".to_string())
-    } else {
-        entry.clone().unwrap_or_else(|| "".to_string())
-    };
-
-    let fetched_output = if output.is_none() {
-        config
-            .as_ref()
-            .and_then(|c| c.defaults.output.clone())
-            .unwrap_or_else(|| "".to_string())
-    } else {
-        output.clone().unwrap_or_else(|| "".to_string())
-    };
-
-    let fetched_watch = if watch {
-        watch
-    } else {
-        config
-            .as_ref()
-            .and_then(|c| c.defaults.watch)
-            .unwrap_or(false)
-    };
-
-    let logger = Logger::new();
-
-    if fetched_entry.is_empty() {
-        logger.log_message(
-            LogLevel::Error,
-            "Entry path is not specified. Please provide a valid entry path."
-        );
-        std::process::exit(1);
-    }
-    if fetched_output.is_empty() {
-        logger.log_message(
-            LogLevel::Error,
-            "Output directory is not specified. Please provide a valid output directory."
-        );
-        std::process::exit(1);
-    }
-
-    let entry_file = find_entry_file(&fetched_entry).unwrap_or_else(|| {
-        logger.log_message(
-            LogLevel::Error,
-            &format!("❌ index.deva not found in directory: {}", fetched_entry)
-        );
-        std::process::exit(1);
-    });
-
-    // SECTION Begin build
-    if fetched_watch {
-        begin_build(entry_file.clone(), fetched_output.clone());
-
-        logger.log_message(
-            LogLevel::Watcher,
-            &format!("Watching for changes in '{}'...", fetched_entry)
-        );
-
-        watch_directory(entry_file.clone(), move || {
-            logger.log_message(LogLevel::Watcher, "Detected changes, re-building...");
-
-            begin_build(entry_file.clone(), fetched_output.clone());
-        }).unwrap();
-    } else {
-        begin_build(entry_file.clone(), fetched_output.clone());
-    }
-}
-
-fn begin_build(entry: String, output: String) {
-    let spinner = with_spinner("Building...", || {
-        thread::sleep(Duration::from_millis(800));
-    });
-
-    let duration = std::time::Instant::now();
-
-    let normalized_entry_file = normalize_path(&entry);
-    let normalized_output_dir = normalize_path(&output);
-
-    let mut global_store = GlobalStore::new();
-    let module_loader = ModuleLoader::new(&normalized_entry_file, &normalized_output_dir);
-
-    // SECTION Load
-    // NOTE: We use modules in the build command, so we need to load them
-    let (modules_tokens, modules_statements) = module_loader.load_all_modules(&mut global_store);
-
-    // SECTION Write logs
-    write_lexer_log_file(&normalized_output_dir, "lexer_tokens.log", modules_tokens.clone());
-    write_preprocessor_log_file(
-        &normalized_output_dir,
-        "resolved_statements.log",
-        modules_statements.clone()
-    );
-    write_store_log_file(&normalized_output_dir, "global_store.log", global_store.modules.clone());
-
-    // SECTION Building AST and Audio
-    let builder = Builder::new();
-    builder.build_ast(&modules_statements, &normalized_output_dir);
-    builder.build_audio(&modules_statements, &normalized_output_dir, &mut global_store);
-
-    // SECTION Logging
-    let logger = Logger::new();
-
-    let success_message = format!(
-        "Build completed successfully in {:.2?}. Output files written to: '{}'",
-        duration.elapsed(),
-        normalized_output_dir
-    );
-
-    logger.log_message(LogLevel::Success, &success_message);
-}

package/rust/cli/check.rs

@@ -1,117 +0,0 @@
-use crate::{
-    config::Config,
-    core::{
-        preprocessor::loader::ModuleLoader,
-        store::global::GlobalStore,
-        utils::path::{ find_entry_file, normalize_path },
-    },
-    utils::{ logger::{ LogLevel, Logger }, spinner::with_spinner, watcher::watch_directory },
-};
-use std::{ thread, time::Duration };
-
-#[cfg(feature = "cli")]
-pub fn handle_check_command(
-    config: Option<Config>,
-    entry: Option<String>,
-    output: Option<String>,
-    watch: bool
-) {
-    let fetched_entry = if entry.is_none() {
-        config
-            .as_ref()
-            .and_then(|c| c.defaults.entry.clone())
-            .unwrap_or_else(|| "".to_string())
-    } else {
-        entry.clone().unwrap_or_else(|| "".to_string())
-    };
-
-    let fetched_output = if output.is_none() {
-        config
-            .as_ref()
-            .and_then(|c| c.defaults.output.clone())
-            .unwrap_or_else(|| "".to_string())
-    } else {
-        output.clone().unwrap_or_else(|| "".to_string())
-    };
-
-    let fetched_watch = if watch {
-        watch
-    } else {
-        config
-            .as_ref()
-            .and_then(|c| c.defaults.watch)
-            .unwrap_or(false)
-    };
-
-    let logger = Logger::new();
-
-    if fetched_entry.is_empty() {
-        logger.log_message(
-            LogLevel::Error,
-            "Entry path is not specified. Please provide a valid entry path."
-        );
-        std::process::exit(1);
-    }
-    if fetched_output.is_empty() {
-        logger.log_message(
-            LogLevel::Error,
-            "Output directory is not specified. Please provide a valid output directory."
-        );
-        std::process::exit(1);
-    }
-
-    let entry_file = find_entry_file(&fetched_entry).unwrap_or_else(|| {
-        logger.log_message(
-            LogLevel::Error,
-            &format!("❌ index.deva not found in directory: {}", fetched_entry)
-        );
-        std::process::exit(1);
-    });
-
-    // SECTION Begin check
-    if fetched_watch {
-        begin_check(entry_file.clone(), fetched_output.clone());
-
-        logger.log_message(
-            LogLevel::Watcher,
-            &format!("Watching for changes in '{}'...", fetched_entry)
-        );
-
-        watch_directory(entry_file.clone(), move || {
-            logger.log_message(LogLevel::Watcher, "Detected changes, re-checking...");
-
-            begin_check(entry_file.clone(), fetched_output.clone());
-        }).unwrap();
-    } else {
-        begin_check(entry_file.clone(), fetched_output.clone());
-    }
-}
-
-fn begin_check(entry: String, output: String) {
-    let spinner = with_spinner("Checking...", || {
-        thread::sleep(Duration::from_millis(800));
-    });
-
-    let duration = std::time::Instant::now();
-
-    let normalized_entry_file = normalize_path(&entry);
-    let normalized_output_dir = normalize_path(&output);
-
-    let mut global_store = GlobalStore::new();
-    let module_loader = ModuleLoader::new(&normalized_entry_file, &normalized_output_dir);
-
-    // SECTION Load
-    // NOTE: We don't use modules in the check command, but we still need to load them
-    let modules = module_loader.load_all_modules(&mut global_store);
-
-    // TODO: Implement debugging
-
-    let success_message = format!(
-        "Check completed successfully in {:.2?}. Output files written to: '{}'",
-        duration.elapsed(),
-        normalized_output_dir
-    );
-
-    let logger = Logger::new();
-    logger.log_message(LogLevel::Success, &success_message);
-}