@graffiticode/basis 1.6.1 → 1.6.2

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@graffiticode/basis",
   "type": "module",
-  "version": "1.6.1",
+  "version": "1.6.2",
   "description": "The basis library for creating Graffiticode languages",
   "main": "index.js",
   "scripts": {

package/spec/spec.md

@@ -173,6 +173,7 @@ This approach draws inspiration from **Model-View-Update** (MVU) architectures,
 | `get` | `<string record: any>` | Retrieves a value from a record by key |
 | `hd` | `<list: any>` | First item of list |
 | `isEmpty` | `<list: bool>` | Returns true if the list is empty |
+| `log` | `<any: any>` | Logs the value to console and returns it (identity function) |
 | `map` | `<function list: list>` | Applies function to each item |
 | `max` | `<number number: number>` | Returns the larger of two numbers |
 | `min` | `<number number: number>` | Returns the smaller of two numbers |
@@ -266,6 +267,15 @@ Return true if list is empty, otherwise return false
 isEmpty []  | returns true
 ```
 
+### log
+
+Log a value to the console and return the value unchanged
+
+```
+log "Hello"  | prints "Hello" to console and returns "Hello"
+log (add 1 2)  | prints 3 to console and returns 3
+```
+
 ### map
 
 Apply a function to each element

package/src/compiler.js

@@ -506,6 +506,13 @@ export class Checker extends Visitor {
       resume(err, val);
     });
   }
+  LOG(node, options, resume) {
+    this.visit(node.elts[0], options, (err1, val1) => {
+      const err = [].concat(err1);
+      const val = node;
+      resume(err, val);
+    });
+  }
 }
 
 function enterEnv(ctx, name, paramc) {
@@ -1364,6 +1371,19 @@ export class Transformer extends Visitor {
       }
     });
   }
+  LOG(node, options, resume) {
+    this.visit(node.elts[0], options, (e0, v0) => {
+      const err = [].concat(e0);
+      try {
+        // Log the value to the console
+        console.log(`LOG: ${v0}`);
+        // Return the value unchanged (identity function)
+        resume(err, v0);
+      } catch (e) {
+        resume([...err, `Error in LOG operation: ${e.message}`], null);
+      }
+    });
+  }
 }
 
 export class Renderer {

package/src/lexicon.js

@@ -270,5 +270,13 @@ export const lexicon = {
     "length": 2,
     "arity": 2,
     "description": "Appends an element to the end of a list."
+  },
+  "log": {
+    "tk": 1,
+    "name": "LOG",
+    "cls": "function",
+    "length": 1,
+    "arity": 1,
+    "description": "Logs the value to the console and returns the value (identity function)."
   }
 };