ZBR v1.5.0

Author: itszubariel

CHANGELOG.md

@@ -2,6 +2,22 @@
 
 All notable changes to the ZBR project are documented here and in the [changelog](https://zbrlang.vercel.app/docs/changelog) website.
 
+## v1.5.0 - Parser Flexibility and Alias Robustness
+
+This release introduces major improvements to the parser's flexibility, simplifies function invocation, and resolves critical bugs in the alias system and positional argument handling.
+
+### Core
+- **Optional Brackets** — Zero-argument function calls no longer require curly brackets (e.g., `Zusername` works the same as `Zusername{}`).
+- **Literal Text Handling** — Unknown Z-prefixed identifiers (e.g., `ZUnknown`) without brackets are now treated as literal text instead of causing runtime errors.
+- **Nested Bracketless Calls** — Bracketless function calls are now correctly recognized and evaluated even when nested within the arguments of other function calls (e.g., `ZsendMessage{ZchannelID;hello}`).
+- **Alias Fixes** — Resolved argument merging issues where aliased function calls were losing arguments, and added validation to ensure the aliased function is a valid ZBR function.
+
+### Argument Parsing
+- **Empty Argument Preservation** — `split_args` now correctly preserves empty arguments between semicolons (e.g., `Zfunc{;arg2}` correctly maps `arg2` to index 1).
+- **Positional Argument Robustness** — Refactored 161 functions across the codebase to explicitly handle empty string arguments as "use default" values, preventing positional misalignment bugs.
+
+---
+
 ## v1.4.4 - Runtime Aliases and Reply Fix
 
 This release introduces the `Zalias` system for improved code reusability and fixes a bug in message evaluation.

Cargo.lock

@@ -1,6 +1,6 @@
 [package]
 name = "zbr"
-version = "1.4.4"
+version = "1.5.0"
 edition = "2021"
 
 [dependencies]

Cargo.toml

@@ -3,21 +3,19 @@
 ZBR is a scripting language for Discord bots powered by a high-performance Rust runtime engine. 
 You write commands as plain `.zbr` files using ZBR functions, no boilerplate, no event handlers, no framework knowledge required.
 
-Previously a complex setup, **ZBR is now a streamlined CLI tool** distributed via npm. You can now initialize, manage, and run your entire bot engine with a single command.
-
 ## Quick Start
 
 Get your bot up and running in seconds:
 
-### Option 1: Webapp Editor (Recommended for testing)
+### Option 1: Webapp Editor (Recommended)
 Head over to the [ZBR Webapp](https://zbr-webapp.vercel.app) for a zero-setup development experience.
 1. Build your commands, manage variables, and tweak settings visually.
 2. Press **Run** to launch your bot instantly in the cloud for testing.
 3. Your bot is now live for testing!
 
 > **Note:** The Webapp "Run" button is strictly for rapid prototyping and interactive testing. For 24/7 production hosting, you must export your project as a ZIP and use the CLI.
 
-### Option 2: CLI (For Technical Users)
+### Option 2: CLI
 1. **Install the CLI globally:**
    ```bash
    npm i @zbrlang/zbr
@@ -61,7 +59,7 @@ For those who prefer a visual development environment, the [ZBR Webapp](https://
 Zvar{xp;ZgetUserVar{xp}}
 Zvar{level;ZgetUserVar{level}}
 
-Ztitle{Zusername{}s Rank}
+Ztitle{Zusername's Rank}
 Zdescription{Level: Zvar{level}
 XP: Zvar{xp}}
 Zcolor{#5865F2}
@@ -76,7 +74,7 @@ ZaddField{Server Rank;#Zvar{rank};true}
 #option user|User to ban|user|required
 #option reason|Reason for the ban|string|optional
 
-ZonlyIf{ZisAdmin{}==true;You need administrator permission to use this command}
+ZonlyIf{ZisAdmin==true;You need administrator permission to use this command}
 Zban{Zoption{user};Zoption{reason}}
 Banned Zoption{user}.
 ```
@@ -86,7 +84,7 @@ Banned Zoption{user}.
 #name Confirm Ban Handler
 #type interaction
 
-Zephemeral{}
+Zephemeral
 Zban{ZgetServerVar{pending_ban}}
 Done.
 ```

README.md

@@ -97,22 +97,24 @@
   },
   {
     "name": "Zalias",
-    "description": "Registers an alias that substitutes and evaluates the stored AST node when called. Aliases are local to the command execution.",
-    "syntax": "Zalias{expression;alias_name}",
+    "description": "Creates a runtime alias for a ZBR function. The alias can be called using Z+alias_name+{} syntax.",
+    "syntax": "Zalias{function;alias_name}",
     "variadic": false,
     "arguments": [
       {
-        "name": "expression",
-        "type": "string",
-        "required": true
+        "name": "function",
+        "type": "function",
+        "required": true,
+        "description": "A valid ZBR function call (e.g. Zusername{})"
       },
       {
         "name": "alias_name",
         "type": "string",
-        "required": true
+        "required": true,
+        "description": "The alias name without Z prefix. Call the alias using Z+alias_name+{} (e.g. Zgreet{})"
       }
     ],
-    "example": "Zalias{ZguildID{};ZGI}"
+    "example": "Zalias{Zusername;greet} Zgreet{}"
   },
   {
     "name": "ZaddField",

docs/functions.json

@@ -1,6 +1,6 @@
 {
   "name": "@zbrlang/zbr",
-  "version": "1.4.4",
+  "version": "1.5.0",
   "description": "ZBR CLI, A simple and powerful Discord bot scripting engine.",
   "bin": {
     "zbr": "./bin/cli.js"