starlight-cli 1.1.6 → 1.1.7

package/README.md

@@ -364,6 +364,42 @@ Starlight keeps `map`, `filter`, and `reduce` as **language-level utilities** in
 
 ---
 
+### Nullish Coalescing (`??`) Support
+
+Our language now supports the **nullish coalescing operator** `??`, which allows you to provide a default value for `null` or `undefined` expressions.
+
+**Syntax:**
+
+```sl
+value = expression1 ?? expression2
+```
+
+* `expression1` is evaluated first.
+* If it is **not null or undefined**, its value is used.
+* Otherwise, the value of `expression2` is used.
+
+**Example:**
+
+```sl
+define a = null
+define b = a ?? 42
+sldeploy b  # Output: 42
+```
+
+**Notes:**
+
+* Only `null` and `undefined` are treated as "empty" values. Other falsy values like `0`, `false`, or `""` will **not** trigger the default.
+* This operator is optional. If you prefer, you can achieve the same result using a simple `if` statement:
+
+```sl
+define a = null
+define b = if a != null then a else 42
+sldeploy b  # Output: 42
+```
+
+This operator simplifies code that needs default values and makes your scripts cleaner and more readable.
+
+---
 
 ## Why Starlight?
 

package/dist/index.js

@@ -10942,12 +10942,20 @@ async evalBinary(node, env) {
 
 async evalLogical(node, env) {
   const l = await this.evaluate(node.left, env);
-  if (node.operator === 'AND') return l && await this.evaluate(node.right, env);
-  if (node.operator === 'OR') return l || await this.evaluate(node.right, env);
-  throw new RuntimeError(`Unknown logical operator: ${node.operator}`, node, this.source);
 
+  switch(node.operator) {
+    case 'AND': return l && await this.evaluate(node.right, env);
+    case 'OR': return l || await this.evaluate(node.right, env);
+    case '??': {
+      const r = await this.evaluate(node.right, env);
+      return (l !== null && l !== undefined) ? l : r;
+    }
+    default:
+      throw new RuntimeError(`Unknown logical operator: ${node.operator}`, node, this.source);
+  }
 }
 
+
 async evalUnary(node, env) {
   const val = await this.evaluate(node.argument, env);
   switch (node.operator) {
@@ -11377,6 +11385,18 @@ if (char === '-' && next === '>') {
   this.advance(); this.advance();
   continue;
 }
+if (char === '?' && next === '?') {
+    tokens.push({ type: 'NULLISH_COALESCING', value: '??', line: startLine, column: startCol });
+    this.advance(); 
+    this.advance(); 
+    continue;
+}
+
+if (char === '?') {
+    tokens.push({ type: 'QUESTION', value: '?', line: startLine, column: startCol });
+    this.advance();
+    continue;
+}
 
       if (char === '!' && next === '=') { tokens.push({ type: 'NOTEQ', line: startLine, column: startCol }); this.advance(); this.advance(); continue; }
       if (char === '<' && next === '=') { tokens.push({ type: 'LTE', line: startLine, column: startCol }); this.advance(); this.advance(); continue; }
@@ -11937,7 +11957,7 @@ expression() {
 }
 
 assignment() {
-  const node = this.logicalOr();
+  const node = this.ternary();
   const compoundOps = ['PLUSEQ', 'MINUSEQ', 'STAREQ', 'SLASHEQ', 'MODEQ'];
 
   const t = this.current;
@@ -11957,7 +11977,27 @@ assignment() {
 
   return node;
 }
-
+ternary() {
+  let node = this.nullishCoalescing();
+  while (this.current.type === 'QUESTION') {
+    const t = this.current;
+    this.eat('QUESTION');
+    const consequent = this.expression(); 
+    this.eat('COLON');
+    const alternate = this.expression();   
+    node = { type: 'ConditionalExpression', test: node, consequent, alternate, line: t.line, column: t.column };
+  }
+  return node;
+}
+nullishCoalescing() {
+  let node = this.logicalOr(); 
+  while (this.current.type === 'NULLISH_COALESCING') {
+    const t = this.current;
+    this.eat('NULLISH_COALESCING');
+    node = { type: 'LogicalExpression', operator: '??', left: node, right: this.logicalOr(), line: t.line, column: t.column };
+  }
+  return node;
+}
 logicalOr() {
   let node = this.logicalAnd();
   while (this.current.type === 'OR') {
@@ -12467,7 +12507,7 @@ const Lexer = __nccwpck_require__(211);
 const Parser = __nccwpck_require__(222);
 const Evaluator = __nccwpck_require__(112);
 
-const VERSION = '1.1.6';
+const VERSION = '1.1.7';
 
 const COLOR = {
     reset: '\x1b[0m',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "starlight-cli",
-  "version": "1.1.6",
+  "version": "1.1.7",
   "description": "Starlight Programming Language CLI",
   "bin": {
     "starlight": "index.js"
@@ -9,8 +9,18 @@
     "build": "ncc build src/starlight.js -o dist",
     "prepublishOnly": "npm run build"
   },
-  "author": "Macedon",
+  "author": "Dominex Macedon",
   "license": "MIT",
+  "keywords": [
+    "starlight",
+    "starlight-language",
+    "programming-language",
+    "scripting-language",
+    "server-side",
+    "cli",
+    "interpreter",
+    "starlight-cli"
+  ],
   "dependencies": {
     "blessed": "^0.1.81",
     "markdown-it": "^14.1.0",

package/src/evaluator.js

@@ -732,12 +732,20 @@ async evalBinary(node, env) {
 
 async evalLogical(node, env) {
   const l = await this.evaluate(node.left, env);
-  if (node.operator === 'AND') return l && await this.evaluate(node.right, env);
-  if (node.operator === 'OR') return l || await this.evaluate(node.right, env);
-  throw new RuntimeError(`Unknown logical operator: ${node.operator}`, node, this.source);
 
+  switch(node.operator) {
+    case 'AND': return l && await this.evaluate(node.right, env);
+    case 'OR': return l || await this.evaluate(node.right, env);
+    case '??': {
+      const r = await this.evaluate(node.right, env);
+      return (l !== null && l !== undefined) ? l : r;
+    }
+    default:
+      throw new RuntimeError(`Unknown logical operator: ${node.operator}`, node, this.source);
+  }
 }
 
+
 async evalUnary(node, env) {
   const val = await this.evaluate(node.argument, env);
   switch (node.operator) {

package/src/lexer.js

@@ -179,6 +179,18 @@ if (char === '-' && next === '>') {
   this.advance(); this.advance();
   continue;
 }
+if (char === '?' && next === '?') {
+    tokens.push({ type: 'NULLISH_COALESCING', value: '??', line: startLine, column: startCol });
+    this.advance(); 
+    this.advance(); 
+    continue;
+}
+
+if (char === '?') {
+    tokens.push({ type: 'QUESTION', value: '?', line: startLine, column: startCol });
+    this.advance();
+    continue;
+}
 
       if (char === '!' && next === '=') { tokens.push({ type: 'NOTEQ', line: startLine, column: startCol }); this.advance(); this.advance(); continue; }
       if (char === '<' && next === '=') { tokens.push({ type: 'LTE', line: startLine, column: startCol }); this.advance(); this.advance(); continue; }

package/src/parser.js

@@ -521,7 +521,7 @@ expression() {
 }
 
 assignment() {
-  const node = this.logicalOr();
+  const node = this.ternary();
   const compoundOps = ['PLUSEQ', 'MINUSEQ', 'STAREQ', 'SLASHEQ', 'MODEQ'];
 
   const t = this.current;
@@ -541,7 +541,27 @@ assignment() {
 
   return node;
 }
-
+ternary() {
+  let node = this.nullishCoalescing();
+  while (this.current.type === 'QUESTION') {
+    const t = this.current;
+    this.eat('QUESTION');
+    const consequent = this.expression(); 
+    this.eat('COLON');
+    const alternate = this.expression();   
+    node = { type: 'ConditionalExpression', test: node, consequent, alternate, line: t.line, column: t.column };
+  }
+  return node;
+}
+nullishCoalescing() {
+  let node = this.logicalOr(); 
+  while (this.current.type === 'NULLISH_COALESCING') {
+    const t = this.current;
+    this.eat('NULLISH_COALESCING');
+    node = { type: 'LogicalExpression', operator: '??', left: node, right: this.logicalOr(), line: t.line, column: t.column };
+  }
+  return node;
+}
 logicalOr() {
   let node = this.logicalAnd();
   while (this.current.type === 'OR') {

package/src/starlight.js

@@ -12,7 +12,7 @@ const Lexer = require('./lexer');
 const Parser = require('./parser');
 const Evaluator = require('./evaluator');
 
-const VERSION = '1.1.6';
+const VERSION = '1.1.7';
 
 const COLOR = {
     reset: '\x1b[0m',