starlight-cli 1.1.2 → 1.1.4

package/README.md

@@ -2,52 +2,64 @@
 
 Starlight is a lightweight, developer-oriented programming language designed for **server-side scripting, automation, and general-purpose programming**. It combines a clean, readable syntax inspired by JavaScript and Python with powerful runtime features such as async/await, modules, and interactive I/O.
 
-**Official Reference:** [https://starlight-learn-lang.pages.dev/](https://starlight-learn-lang.pages.dev/)
+**Official Reference:** [
 
 ---
 
 ## Key Features
 
-* **Modern, Simple Syntax** – Familiar to JavaScript and Python developers
-* **Async / Await** – Native support for asynchronous operations
-* **Modules & Imports** – Import JavaScript packages or other `.sl` files
-* **Server-side Ready** – Built on Node.js, ideal for backend logic
-* **Interactive I/O** – Built-in `ask` and `sldeploy`
-* **Built-in Utilities** – `sleep`, `len`, `keys`, `values`, `fetch`, `get`, `post`
+
+  - **Modern, Simple Syntax** – Familiar to JavaScript and Python developers
+  - **Async / Await** – Native support for asynchronous operations
+  - **Modules & Imports** – Import JavaScript packages or other `.sl` files
+  - **Server-side Ready** – Built on Node.js, ideal for backend logic
+  - **Interactive I/O** – Built-in `ask` and `sldeploy`
+  - **Built-in Utilities** – `sleep`, `len`, `keys`, `values`, `fetch`, `get`, `post`
+
 
 ---
 
 ## Installation
 
-1. Install **Node.js** (v18+ recommended)
-2. Install Starlight CLI:
 
-```
+  Install **Node.js** (v18+ recommended)1. $1
+  Install Starlight CLI:1. $1
+
+
+```
+
 npm install -g starlight-cli
+
 ```
 
 ---
 
 ## Your First Program (`hello.sl`)
 
-```
+```
+
 let name = ask("What is your name?")
 sldeploy "Hello, " + name + "!"
+
 ```
 
 Run:
 
-```
+```
+
 starlight hello.sl
+
 ```
 
 ---
 
 ## Output
 
-```
+```
+
 What is your name? Alice
 Hello, Alice!
+
 ```
 
 ---
@@ -56,200 +68,187 @@ Hello, Alice!
 
 ### Variables
 
-```
+```
+
 let x = 10
 let text = "hello"
+
 ```
 
 ---
 
 ### Functions
 
-```
+```
+
 func add(a, b) {
   return a + b
 }
 
 sldeploy add(2, 3)
+
 ```
 
 ### Async Functions
 
-```
+```
+
 async func load() {
   let data = await get("https://example.com/api")
   sldeploy data
 }
 
 load()
+
 ```
 
 ---
 
-## Conditionals
-
-```
-if (x > 5) {
-  sldeploy "Greater than 5"
-} else {
-  sldeploy "5 or less"
-}
-```
+## Arrow Functions
 
----
+Arrow functions provide a **concise and expressive** way to define functions. They support expressions, block bodies, conditionals, loops, and `return` statements.
 
-## Loops
+### Basic Arrow Function
 
-### While Loop
+```
 
-```
-let i = 0
-while (i < 3) {
-  sldeploy i
-  i = i + 1
-}
+let square = x => x * x
+sldeploy square(5)
+
 ```
 
----
+### Multiple Parameters
 
-### For Loop (C-style)
+```
 
+let add = (a, b) => a + b
+sldeploy add(10, 20)
+
 ```
-for (let i = 0; i < 3; i = i + 1) {
-  sldeploy i
-}
-```
-
----
-
-### For-In Loop (Python-style)
 
-Iterate over arrays:
+### Block Body with if / else
 
-```
-let items = ["apple", "banana", "orange"]
+```
 
-for item in items {
-  sldeploy item
+let label = p => {
+  if (p.price > 1000) {
+    return "Premium"
+  } else {
+    return "Standard"
+  }
 }
+
 ```
 
-With `let` (scoped variable):
+### Arrow Functions with Objects
 
-```
-for let item in items {
-  sldeploy item
-}
-```
-
-Iterate over object keys:
-
-```
-let user = { "name": "Alice", "age": 20 }
+```
 
-for key in user {
-  sldeploy key + ": " + user[key]
+let summarize = p => {
+  return {
+    "name": p.name,
+    "value": p.price * p.stock
+  }
 }
+
 ```
 
+Arrow functions capture their surrounding scope and behave like standard functions while remaining lightweight and readable.
+
 ---
 
-## Objects & Arrays
+## Conditionals
 
-```
-let product = {
-  "name": "Star Lamp",
-  "price": 50,
-  "tags": ["space", "light"]
-}
+```
 
-sldeploy product
+if (x > 5) {
+  sldeploy "Greater than 5"
+} else {
+  sldeploy "5 or less"
+}
+
 ```
 
 ---
 
-## sldeploy (Output)
-
-`sldeploy` works like Python's `print` and can display **any type**:
-
-```
-sldeploy 42
-sldeploy "hello"
-sldeploy true
-sldeploy [1, 2, 3]
-sldeploy { "a": 1, "b": 2 }
-```
+## Loops
 
-It automatically formats arrays, objects, functions, and nested values.
+### While Loop
 
----
+```
 
-## ask (User Input)
+let i = 0
+while (i  {
+  let response = await get("https://jsonplaceholder.typicode.com/todos/1")
+  sldeploy response
+}
 
-```
-let age = ask("Enter your age:")
-sldeploy "You entered: " + age
+server()
+
 ```
 
 ---
 
-## Modules & Imports
+## Start & Race Statements
 
-### Import JavaScript Packages
+Starlight includes a **start / race** control structure similar to a switch statement, with **fall-through behavior**.
 
-```
-import colors from "starlight-color"
+### Syntax
 
-sldeploy colors.blue("Hello Starlight")
-```
+```
 
-### Import Local Files
+start (value) {
+  race (1) {
+    # body
+  }
 
+  race (2) {
+    # body
+  }
+}
+
 ```
-import { add } from "./math.sl"
-```
-
----
 
-## Built-in Utilities
+### Example
 
-* `len(value)` – length of array, string, or object
-* `keys(object)` – object keys
-* `values(object)` – object values
-* `sleep(ms)` – async delay
-* `fetch(url)` – low-level fetch
-* `get(url)` – GET request
-* `post(url, data)` – POST request
-* `num(value)` – convert to number
-* `str(value)` – convert to string
+```
 
----
+define x = 2;
 
-## Server-side Example
+start (x) {
+  race (1) { sldeploy("Race 1 executed"); }
+  race (2) { sldeploy("Race 2 executed"); }
+  race (3) { sldeploy("Race 3 executed"); }
+}
 
+sldeploy("Done with start statement");
+
 ```
-define server = async () => {
-  let response = await get("https://jsonplaceholder.typicode.com/todos/1")
-  sldeploy response
-}
 
-server()
+### Expected Output
+
+```
+
+Race 2 executed
+Race 3 executed
+Done with start statement
+
 ```
 
 ---
 
 ## Why Starlight?
 
-Starlight is designed for developers who want:
 
-* A **simple but powerful** scripting language
-* **Fast server-side automation**
-* Familiar syntax with **less boilerplate**
-* Full access to the **Node.js ecosystem**
+  - A **simple but powerful** scripting language
+  - **Fast server-side automation**
+  - Familiar syntax with **less boilerplate**
+  - Full access to the **Node.js ecosystem**
+
 
 ---
 
 📘 Full documentation and tutorials:
-[https://starlight-learn-lang.pages.dev/](https://starlight-learn-lang.pages.dev/)
+https://starlight-learn-lang.pages.dev/](https://starlight-learn-lang.pages.dev/>https://starlight-learn-lang.pages.dev/</link)
 
-**License:** MIT
+**License:** MIT