starlight-cli 1.0.41 → 1.0.43

package/dist/index.js

@@ -1370,6 +1370,37 @@ class Environment {
     if (this.parent) return this.parent.get(name);
     throw new Error(`Undefined variable: ${name}`);
   }
+formatValue(value, seen = new Set()) {
+  if (typeof value === 'object' && value !== null) {
+    if (seen.has(value)) return '[Circular]';
+    seen.add(value);
+  }
+
+  if (value === null) return 'null';
+  if (value === undefined) return 'undefined';
+
+  const t = typeof value;
+
+  if (t === 'string') return value;
+  if (t === 'number' || t === 'boolean') return String(value);
+
+  if (t === 'function') {
+    return '[function]';
+  }
+
+  if (Array.isArray(value)) {
+    return '[' + value.map(v => this.formatValue(v, seen)).join(', ') + ']';
+  }
+
+  if (t === 'object') {
+    const entries = Object.entries(value).map(
+      ([k, v]) => `${k}: ${this.formatValue(v, seen)}`
+    );
+    return '{ ' + entries.join(', ') + ' }';
+  }
+
+  return String(value);
+}
 
   set(name, value) {
     if (name in this.store) { this.store[name] = value; return value; }
@@ -1720,16 +1751,11 @@ async evalCompoundAssignment(node, env) {
 
 async evalSldeploy(node, env) {
   const val = await this.evaluate(node.expr, env);
-
-  if (typeof val === 'object' && val !== null) {
-    console.log(JSON.stringify(val, null, 2));
-  } else {
-    console.log(val);
-  }
-
+  console.log(this.formatValue(val));
   return val;
 }
 
+
 async evalAsk(node, env) {
   const prompt = await this.evaluate(node.prompt, env);
   const input = readlineSync.question(prompt + ' ');
@@ -1801,9 +1827,8 @@ async evalWhile(node, env) {
   return null;
 }
 async evalFor(node, env) {
-
   // -------------------------------
-  // Python-style: for x in iterable
+  // Python-style: for x in iterable (with optional 'let')
   // -------------------------------
   if (node.type === 'ForInStatement') {
     const iterable = await this.evaluate(node.iterable, env);
@@ -1814,10 +1839,12 @@ async evalFor(node, env) {
 
     const loopVar = node.variable; // STRING from parser
 
+    const createLoopEnv = () => node.letKeyword ? new Environment(env) : env;
+
     // Arrays
     if (Array.isArray(iterable)) {
       for (const value of iterable) {
-        const loopEnv = new Environment(env);
+        const loopEnv = createLoopEnv();
         loopEnv.define(loopVar, value);
 
         try {
@@ -1832,7 +1859,7 @@ async evalFor(node, env) {
     // Objects (keys)
     else {
       for (const key of Object.keys(iterable)) {
-        const loopEnv = new Environment(env);
+        const loopEnv = createLoopEnv();
         loopEnv.define(loopVar, key);
 
         try {
@@ -2396,16 +2423,30 @@ importStatement() {
 forStatement() {
   this.eat('FOR');
 
-  // --- Python-style: for variable in iterable ---
-  if (this.current.type === 'IDENTIFIER' && this.peekType() === 'IN') {
-    const variable = this.current.value; // loop variable
-    this.eat('IDENTIFIER');
+  // --- Python-style: for variable in iterable (supports optional 'let') ---
+  if ((this.current.type === 'LET' && this.peekType() === 'IDENTIFIER' && this.peekType(2) === 'IN') ||
+      (this.current.type === 'IDENTIFIER' && this.peekType() === 'IN')) {
+
+    let variable;
+    let iterable;
+    let letKeyword = false;
 
-    this.eat('IN');
-    const iterable = this.expression(); // the array/object to loop over
+    if (this.current.type === 'LET') {
+      letKeyword = true;
+      this.eat('LET');
+      variable = this.current.value;
+      this.eat('IDENTIFIER');
+      this.eat('IN');
+      iterable = this.expression();
+    } else {
+      variable = this.current.value;
+      this.eat('IDENTIFIER');
+      this.eat('IN');
+      iterable = this.expression();
+    }
 
     const body = this.block();
-    return { type: 'ForInStatement', variable, iterable, body };
+    return { type: 'ForInStatement', variable, iterable, letKeyword, body };
   }
 
   // --- C-style: for(init; test; update) ---
@@ -2431,7 +2472,7 @@ forStatement() {
     if (this.current.type !== 'RPAREN') update = this.expression();
     this.eat('RPAREN');
   } else {
-    // fallback: single expression (could be used for Python-style with "in", already handled above)
+    // fallback: single expression (rare, mostly handled above)
     init = this.expression();
     if (this.current.type === 'IN') {
       this.eat('IN');

package/package.json

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

package/src/evaluator.js

@@ -27,6 +27,37 @@ class Environment {
     if (this.parent) return this.parent.get(name);
     throw new Error(`Undefined variable: ${name}`);
   }
+formatValue(value, seen = new Set()) {
+  if (typeof value === 'object' && value !== null) {
+    if (seen.has(value)) return '[Circular]';
+    seen.add(value);
+  }
+
+  if (value === null) return 'null';
+  if (value === undefined) return 'undefined';
+
+  const t = typeof value;
+
+  if (t === 'string') return value;
+  if (t === 'number' || t === 'boolean') return String(value);
+
+  if (t === 'function') {
+    return '[function]';
+  }
+
+  if (Array.isArray(value)) {
+    return '[' + value.map(v => this.formatValue(v, seen)).join(', ') + ']';
+  }
+
+  if (t === 'object') {
+    const entries = Object.entries(value).map(
+      ([k, v]) => `${k}: ${this.formatValue(v, seen)}`
+    );
+    return '{ ' + entries.join(', ') + ' }';
+  }
+
+  return String(value);
+}
 
   set(name, value) {
     if (name in this.store) { this.store[name] = value; return value; }
@@ -377,16 +408,11 @@ async evalCompoundAssignment(node, env) {
 
 async evalSldeploy(node, env) {
   const val = await this.evaluate(node.expr, env);
-
-  if (typeof val === 'object' && val !== null) {
-    console.log(JSON.stringify(val, null, 2));
-  } else {
-    console.log(val);
-  }
-
+  console.log(this.formatValue(val));
   return val;
 }
 
+
 async evalAsk(node, env) {
   const prompt = await this.evaluate(node.prompt, env);
   const input = readlineSync.question(prompt + ' ');
@@ -458,9 +484,8 @@ async evalWhile(node, env) {
   return null;
 }
 async evalFor(node, env) {
-
   // -------------------------------
-  // Python-style: for x in iterable
+  // Python-style: for x in iterable (with optional 'let')
   // -------------------------------
   if (node.type === 'ForInStatement') {
     const iterable = await this.evaluate(node.iterable, env);
@@ -471,10 +496,12 @@ async evalFor(node, env) {
 
     const loopVar = node.variable; // STRING from parser
 
+    const createLoopEnv = () => node.letKeyword ? new Environment(env) : env;
+
     // Arrays
     if (Array.isArray(iterable)) {
       for (const value of iterable) {
-        const loopEnv = new Environment(env);
+        const loopEnv = createLoopEnv();
         loopEnv.define(loopVar, value);
 
         try {
@@ -489,7 +516,7 @@ async evalFor(node, env) {
     // Objects (keys)
     else {
       for (const key of Object.keys(iterable)) {
-        const loopEnv = new Environment(env);
+        const loopEnv = createLoopEnv();
         loopEnv.define(loopVar, key);
 
         try {

package/src/parser.js

@@ -229,16 +229,30 @@ importStatement() {
 forStatement() {
   this.eat('FOR');
 
-  // --- Python-style: for variable in iterable ---
-  if (this.current.type === 'IDENTIFIER' && this.peekType() === 'IN') {
-    const variable = this.current.value; // loop variable
-    this.eat('IDENTIFIER');
-
-    this.eat('IN');
-    const iterable = this.expression(); // the array/object to loop over
+  // --- Python-style: for variable in iterable (supports optional 'let') ---
+  if ((this.current.type === 'LET' && this.peekType() === 'IDENTIFIER' && this.peekType(2) === 'IN') ||
+      (this.current.type === 'IDENTIFIER' && this.peekType() === 'IN')) {
+
+    let variable;
+    let iterable;
+    let letKeyword = false;
+
+    if (this.current.type === 'LET') {
+      letKeyword = true;
+      this.eat('LET');
+      variable = this.current.value;
+      this.eat('IDENTIFIER');
+      this.eat('IN');
+      iterable = this.expression();
+    } else {
+      variable = this.current.value;
+      this.eat('IDENTIFIER');
+      this.eat('IN');
+      iterable = this.expression();
+    }
 
     const body = this.block();
-    return { type: 'ForInStatement', variable, iterable, body };
+    return { type: 'ForInStatement', variable, iterable, letKeyword, body };
   }
 
   // --- C-style: for(init; test; update) ---
@@ -264,7 +278,7 @@ forStatement() {
     if (this.current.type !== 'RPAREN') update = this.expression();
     this.eat('RPAREN');
   } else {
-    // fallback: single expression (could be used for Python-style with "in", already handled above)
+    // fallback: single expression (rare, mostly handled above)
     init = this.expression();
     if (this.current.type === 'IN') {
       this.eat('IN');