starlight-cli 1.0.43 → 1.0.45

package/README.md

@@ -1,71 +1,255 @@
-# Starlight Language 
+# Starlight Language
 
-Starlight is a lightweight, developer-oriented programming language designed for server-side scripting, automation, and general-purpose programming. It combines simplicity with powerful features like async/await, custom modules, and a clear, concise syntax.
+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/)
 
-## Features
+---
 
-- Modern Syntax: Inspired by JavaScript and Python, optimized for server-side tasks.
-- Async/Await Support: Handle asynchronous operations cleanly.
-- Modules & Imports: Use `import` to bring in libraries or other `.sl` files.
-- Server-side Ready: Ideal for scripting, automation, and backend logic.
-- Interactive Input: Built-in `ask` and `sldeploy` commands for user interaction.
-- Built-in Utilities: `sleep(ms)`, `len()`, `keys()`, `values()`, `fetch()`, `get()`, `post()`.
+## Key Features
 
-## Getting Started
+* **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`
 
-1. Install Node.js (v18+ recommended)
-2. Install via NPM:
+---
 
-\`\`\`
-npm install starlight-cli
-\`\`\`
+## Installation
 
-## Example Program (`hello.sl`)
+1. Install **Node.js** (v18+ recommended)
+2. Install Starlight CLI:
 
-\`\`\`
+```
+npm install -g starlight-cli
+```
+
+---
+
+## Your First Program (`hello.sl`)
+
+```
 let name = ask("What is your name?")
-sldeploy("Hello, " + name + "!")
-\`\`\`
+sldeploy "Hello, " + name + "!"
+```
 
 Run:
 
-\`\`\`
+```
 starlight hello.sl
-\`\`\`
+```
 
-Output:
+---
 
-\`\`\`
+## Output
+
+```
 What is your name? Alice
 Hello, Alice!
-\`\`\`
+```
+
+---
+
+## Core Language Concepts
+
+### 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"
+}
+```
+
+---
+
+## Loops
+
+### While Loop
+
+```
+let i = 0
+while (i < 3) {
+  sldeploy i
+  i = i + 1
+}
+```
+
+---
+
+### For Loop (C-style)
+
+```
+for (let i = 0; i < 3; i = i + 1) {
+  sldeploy i
+}
+```
+
+---
+
+### For-In Loop (Python-style)
+
+Iterate over arrays:
+
+```
+let items = ["apple", "banana", "orange"]
+
+for item in items {
+  sldeploy item
+}
+```
+
+With `let` (scoped variable):
+
+```
+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]
+}
+```
+
+---
+
+## Objects & Arrays
+
+```
+let product = {
+  "name": "Star Lamp",
+  "price": 50,
+  "tags": ["space", "light"]
+}
+
+sldeploy product
+```
+
+---
+
+## 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 }
+```
+
+It automatically formats arrays, objects, functions, and nested values.
+
+---
+
+## ask (User Input)
+
+```
+let age = ask("Enter your age:")
+sldeploy "You entered: " + age
+```
+
+---
+
+## Modules & Imports
+
+### Import JavaScript Packages
+
+```
+import colors from "starlight-color"
+
+sldeploy colors.blue("Hello Starlight")
+```
+
+### Import Local Files
+
+```
+import { add } from "./math.sl"
+```
+
+---
+
+## Built-in Utilities
+
+* `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
+
+---
 
 ## Server-side Example
 
-\`\`\`
+```
 define server = async () => {
   let response = await get("https://jsonplaceholder.typicode.com/todos/1")
-  sldeploy(response)
+  sldeploy response
 }
 
 server()
-\`\`\`
-
-## Core Concepts
+```
 
-- Variables: `let x = 10`
-- Functions: `func add(a, b) { return a + b }`
-- Async Functions: `async func fetchData() { ... }`
-- Conditionals: `if (x > 5) { ... } else { ... }`
-- Loops: `while`, `for`
-- Modules: `import { something } from "./module.sl"`
+---
 
 ## Why Starlight?
 
-Starlight is developer-focused, designed for server-side scripting and automation. Its clean syntax and minimal overhead make it easy to write powerful scripts.
+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**
+
+---
 
-For full tutorials, API references, and examples, visit: [https://starlight-learn-lang.pages.dev/](https://starlight-learn-lang.pages.dev/)
+📘 Full documentation and tutorials:
+[https://starlight-learn-lang.pages.dev/](https://starlight-learn-lang.pages.dev/)
 
-License: MIT
+**License:** MIT

package/dist/index.js

@@ -1370,56 +1370,78 @@ class Environment {
     if (this.parent) return this.parent.get(name);
     throw new Error(`Undefined variable: ${name}`);
   }
+
+  set(name, value) {
+    if (name in this.store) { this.store[name] = value; return value; }
+    if (this.parent && this.parent.has(name)) { return this.parent.set(name, value); }
+    this.store[name] = value;
+    return value;
+  }
+
+  define(name, value) {
+    this.store[name] = value;
+    return value;
+  }
+}
+
+class Evaluator {
+  constructor() {
+    this.global = new Environment();
+    this.setupBuiltins();
+  }
 formatValue(value, seen = new Set()) {
+  // Circular reference handling
   if (typeof value === 'object' && value !== null) {
     if (seen.has(value)) return '[Circular]';
     seen.add(value);
   }
 
-  if (value === null) return 'null';
+  // Python-style null / undefined
+  if (value === null) return 'None';
   if (value === undefined) return 'undefined';
 
   const t = typeof value;
 
-  if (t === 'string') return value;
-  if (t === 'number' || t === 'boolean') return String(value);
+  // Strings (quoted)
+  if (t === 'string') return `"${value}"`;
+
+  // Numbers
+  if (t === 'number') return String(value);
+
+  // Booleans (Python-style)
+  if (t === 'boolean') return value ? 'True' : 'False';
 
+  // Native JS functions
   if (t === 'function') {
-    return '[function]';
+    return value.name
+      ? `<function ${value.name}>`
+      : '<function>';
   }
 
+  // Arrays
   if (Array.isArray(value)) {
     return '[' + value.map(v => this.formatValue(v, seen)).join(', ') + ']';
   }
 
+  // Objects (including your language functions)
   if (t === 'object') {
+    // Detect user-defined functions (AST-based)
+    if (value.params && value.body) {
+      return value.name
+        ? `<function ${value.name}>`
+        : '<function>';
+    }
+
     const entries = Object.entries(value).map(
       ([k, v]) => `${k}: ${this.formatValue(v, seen)}`
     );
     return '{ ' + entries.join(', ') + ' }';
   }
 
+  // Fallback
   return String(value);
 }
 
-  set(name, value) {
-    if (name in this.store) { this.store[name] = value; return value; }
-    if (this.parent && this.parent.has(name)) { return this.parent.set(name, value); }
-    this.store[name] = value;
-    return value;
-  }
-
-  define(name, value) {
-    this.store[name] = value;
-    return value;
-  }
-}
-
-class Evaluator {
-  constructor() {
-    this.global = new Environment();
-    this.setupBuiltins();
-  }
 
   setupBuiltins() {
     this.global.define('len', arg => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "starlight-cli",
-  "version": "1.0.43",
+  "version": "1.0.45",
   "description": "Starlight Programming Language CLI",
   "bin": {
     "starlight": "index.js"

package/src/evaluator.js

@@ -27,56 +27,78 @@ class Environment {
     if (this.parent) return this.parent.get(name);
     throw new Error(`Undefined variable: ${name}`);
   }
+
+  set(name, value) {
+    if (name in this.store) { this.store[name] = value; return value; }
+    if (this.parent && this.parent.has(name)) { return this.parent.set(name, value); }
+    this.store[name] = value;
+    return value;
+  }
+
+  define(name, value) {
+    this.store[name] = value;
+    return value;
+  }
+}
+
+class Evaluator {
+  constructor() {
+    this.global = new Environment();
+    this.setupBuiltins();
+  }
 formatValue(value, seen = new Set()) {
+  // Circular reference handling
   if (typeof value === 'object' && value !== null) {
     if (seen.has(value)) return '[Circular]';
     seen.add(value);
   }
 
-  if (value === null) return 'null';
+  // Python-style null / undefined
+  if (value === null) return 'None';
   if (value === undefined) return 'undefined';
 
   const t = typeof value;
 
-  if (t === 'string') return value;
-  if (t === 'number' || t === 'boolean') return String(value);
+  // Strings (quoted)
+  if (t === 'string') return `"${value}"`;
+
+  // Numbers
+  if (t === 'number') return String(value);
+
+  // Booleans (Python-style)
+  if (t === 'boolean') return value ? 'True' : 'False';
 
+  // Native JS functions
   if (t === 'function') {
-    return '[function]';
+    return value.name
+      ? `<function ${value.name}>`
+      : '<function>';
   }
 
+  // Arrays
   if (Array.isArray(value)) {
     return '[' + value.map(v => this.formatValue(v, seen)).join(', ') + ']';
   }
 
+  // Objects (including your language functions)
   if (t === 'object') {
+    // Detect user-defined functions (AST-based)
+    if (value.params && value.body) {
+      return value.name
+        ? `<function ${value.name}>`
+        : '<function>';
+    }
+
     const entries = Object.entries(value).map(
       ([k, v]) => `${k}: ${this.formatValue(v, seen)}`
     );
     return '{ ' + entries.join(', ') + ' }';
   }
 
+  // Fallback
   return String(value);
 }
 
-  set(name, value) {
-    if (name in this.store) { this.store[name] = value; return value; }
-    if (this.parent && this.parent.has(name)) { return this.parent.set(name, value); }
-    this.store[name] = value;
-    return value;
-  }
-
-  define(name, value) {
-    this.store[name] = value;
-    return value;
-  }
-}
-
-class Evaluator {
-  constructor() {
-    this.global = new Environment();
-    this.setupBuiltins();
-  }
 
   setupBuiltins() {
     this.global.define('len', arg => {