@morphql/language-definitions 0.1.6 → 0.1.8

package/dist/index.cjs

@@ -51,10 +51,10 @@ var KEYWORDS = [
       parameters: [
         {
           name: "format",
-          description: "If used as first keyword: The starting format, one of `json`, `xml`, or `object`. When used after a section, defines its source"
+          description: "If used as first keyword: The starting format name (e.g., `json`, `xml`, `csv`, `object`). When used after a section, defines its source."
         }
       ],
-      example: "from json to xml"
+      example: "from json to csv"
     }
   },
   {
@@ -64,18 +64,30 @@ var KEYWORDS = [
       signature: "to <format>",
       description: "Specifies the output data format.",
       parameters: [
-        { name: "format", description: "One of: `json`, `xml`, or `object`" }
+        {
+          name: "format",
+          description: "The name of one of the available adapters."
+        }
       ],
-      example: "from json to xml"
+      example: "from csv to json"
     }
   },
   {
     name: "transform",
     category: "control",
     doc: {
-      signature: "transform",
-      description: "Begins the transformation block containing actions.",
-      example: "transform\n  set name = firstName"
+      signature: "transform [unsafe]",
+      description: "Begins the transformation block containing actions. Optional 'unsafe' keyword disables safety features (optional chaining) for maximum performance.",
+      example: "transform\n  set name = firstName\n\ntransform unsafe\n  set result = price / quantity"
+    }
+  },
+  {
+    name: "unsafe",
+    category: "control",
+    doc: {
+      signature: "transform unsafe",
+      description: "Disables safety features (optional chaining) in generated code for maximum performance. Use only with validated/trusted input data.",
+      example: "transform unsafe\n  set result = price / quantity"
     }
   },
   {
@@ -116,7 +128,7 @@ var KEYWORDS = [
           description: "(Optional) Source path for the section data"
         }
       ],
-      example: "section metadata(\n  from xml to object\n  transform\n    set name = root.productName\n) from xmlString"
+      example: "section items(\n  from csv to object\n  transform\n    set name = A\n) from csvString"
     }
   },
   {
@@ -203,6 +215,16 @@ var KEYWORDS = [
       ],
       example: "set total = price * quantity\nmodify total = total * 1.10"
     }
+  },
+  {
+    name: "return",
+    category: "action",
+    doc: {
+      signature: "return <expression>",
+      description: "Returns a value from the transformation, bypassing the default serialization. Reads from target context by default.",
+      parameters: [{ name: "expression", description: "The value to return" }],
+      example: "set computed = price * 1.1\nreturn computed"
+    }
   }
 ];
 var getKeywordsByCategory = (category) => KEYWORDS.filter((k) => k.category === category);
@@ -354,11 +376,21 @@ var FUNCTIONS = [
     name: "aslist",
     doc: {
       signature: "aslist(value)",
-      description: "Ensures a value is an array. Useful for XML nodes that might be a single object or an array.",
+      description: "Ensures a value is an array. Useful for input formats like XML that might return a single object or an array for the same field.",
       parameters: [{ name: "value", description: "The value to normalize" }],
       returns: "array",
       example: "aslist(items)  // Always returns an array"
     }
+  },
+  {
+    name: "spreadsheet",
+    doc: {
+      signature: "spreadsheet(data)",
+      description: "Converts spreadsheet-style data (array of arrays) into an array of objects with named properties. First row is treated as headers.",
+      parameters: [{ name: "data", description: "Array of arrays (rows)" }],
+      returns: "array of objects",
+      example: 'spreadsheet(csvData)  // Converts [["name","age"],["John",30]] to [{name:"John",age:30}]'
+    }
   }
 ];
 var getFunctionNames = () => FUNCTIONS.map((f) => f.name);

package/dist/index.js

@@ -9,10 +9,10 @@ var KEYWORDS = [
       parameters: [
         {
           name: "format",
-          description: "If used as first keyword: The starting format, one of `json`, `xml`, or `object`. When used after a section, defines its source"
+          description: "If used as first keyword: The starting format name (e.g., `json`, `xml`, `csv`, `object`). When used after a section, defines its source."
         }
       ],
-      example: "from json to xml"
+      example: "from json to csv"
     }
   },
   {
@@ -22,18 +22,30 @@ var KEYWORDS = [
       signature: "to <format>",
       description: "Specifies the output data format.",
       parameters: [
-        { name: "format", description: "One of: `json`, `xml`, or `object`" }
+        {
+          name: "format",
+          description: "The name of one of the available adapters."
+        }
       ],
-      example: "from json to xml"
+      example: "from csv to json"
     }
   },
   {
     name: "transform",
     category: "control",
     doc: {
-      signature: "transform",
-      description: "Begins the transformation block containing actions.",
-      example: "transform\n  set name = firstName"
+      signature: "transform [unsafe]",
+      description: "Begins the transformation block containing actions. Optional 'unsafe' keyword disables safety features (optional chaining) for maximum performance.",
+      example: "transform\n  set name = firstName\n\ntransform unsafe\n  set result = price / quantity"
+    }
+  },
+  {
+    name: "unsafe",
+    category: "control",
+    doc: {
+      signature: "transform unsafe",
+      description: "Disables safety features (optional chaining) in generated code for maximum performance. Use only with validated/trusted input data.",
+      example: "transform unsafe\n  set result = price / quantity"
     }
   },
   {
@@ -74,7 +86,7 @@ var KEYWORDS = [
           description: "(Optional) Source path for the section data"
         }
       ],
-      example: "section metadata(\n  from xml to object\n  transform\n    set name = root.productName\n) from xmlString"
+      example: "section items(\n  from csv to object\n  transform\n    set name = A\n) from csvString"
     }
   },
   {
@@ -161,6 +173,16 @@ var KEYWORDS = [
       ],
       example: "set total = price * quantity\nmodify total = total * 1.10"
     }
+  },
+  {
+    name: "return",
+    category: "action",
+    doc: {
+      signature: "return <expression>",
+      description: "Returns a value from the transformation, bypassing the default serialization. Reads from target context by default.",
+      parameters: [{ name: "expression", description: "The value to return" }],
+      example: "set computed = price * 1.1\nreturn computed"
+    }
   }
 ];
 var getKeywordsByCategory = (category) => KEYWORDS.filter((k) => k.category === category);
@@ -312,11 +334,21 @@ var FUNCTIONS = [
     name: "aslist",
     doc: {
       signature: "aslist(value)",
-      description: "Ensures a value is an array. Useful for XML nodes that might be a single object or an array.",
+      description: "Ensures a value is an array. Useful for input formats like XML that might return a single object or an array for the same field.",
       parameters: [{ name: "value", description: "The value to normalize" }],
       returns: "array",
       example: "aslist(items)  // Always returns an array"
     }
+  },
+  {
+    name: "spreadsheet",
+    doc: {
+      signature: "spreadsheet(data)",
+      description: "Converts spreadsheet-style data (array of arrays) into an array of objects with named properties. First row is treated as headers.",
+      parameters: [{ name: "data", description: "Array of arrays (rows)" }],
+      returns: "array of objects",
+      example: 'spreadsheet(csvData)  // Converts [["name","age"],["John",30]] to [{name:"John",age:30}]'
+    }
   }
 ];
 var getFunctionNames = () => FUNCTIONS.map((f) => f.name);

package/dist/morphql-lang.json

@@ -9,10 +9,10 @@
         "parameters": [
           {
             "name": "format",
-            "description": "If used as first keyword: The starting format, one of `json`, `xml`, or `object`. When used after a section, defines its source"
+            "description": "If used as first keyword: The starting format name (e.g., `json`, `xml`, `csv`, `object`). When used after a section, defines its source."
           }
         ],
-        "example": "from json to xml"
+        "example": "from json to csv"
       }
     },
     {
@@ -24,19 +24,28 @@
         "parameters": [
           {
             "name": "format",
-            "description": "One of: `json`, `xml`, or `object`"
+            "description": "The name of one of the available adapters."
           }
         ],
-        "example": "from json to xml"
+        "example": "from csv to json"
       }
     },
     {
       "name": "transform",
       "category": "control",
       "doc": {
-        "signature": "transform",
-        "description": "Begins the transformation block containing actions.",
-        "example": "transform\n  set name = firstName"
+        "signature": "transform [unsafe]",
+        "description": "Begins the transformation block containing actions. Optional 'unsafe' keyword disables safety features (optional chaining) for maximum performance.",
+        "example": "transform\n  set name = firstName\n\ntransform unsafe\n  set result = price / quantity"
+      }
+    },
+    {
+      "name": "unsafe",
+      "category": "control",
+      "doc": {
+        "signature": "transform unsafe",
+        "description": "Disables safety features (optional chaining) in generated code for maximum performance. Use only with validated/trusted input data.",
+        "example": "transform unsafe\n  set result = price / quantity"
       }
     },
     {
@@ -86,7 +95,7 @@
             "description": "(Optional) Source path for the section data"
           }
         ],
-        "example": "section metadata(\n  from xml to object\n  transform\n    set name = root.productName\n) from xmlString"
+        "example": "section items(\n  from csv to object\n  transform\n    set name = A\n) from csvString"
       }
     },
     {
@@ -193,6 +202,21 @@
         ],
         "example": "set total = price * quantity\nmodify total = total * 1.10"
       }
+    },
+    {
+      "name": "return",
+      "category": "action",
+      "doc": {
+        "signature": "return <expression>",
+        "description": "Returns a value from the transformation, bypassing the default serialization. Reads from target context by default.",
+        "parameters": [
+          {
+            "name": "expression",
+            "description": "The value to return"
+          }
+        ],
+        "example": "set computed = price * 1.1\nreturn computed"
+      }
     }
   ],
   "functions": [
@@ -393,7 +417,7 @@
       "name": "aslist",
       "doc": {
         "signature": "aslist(value)",
-        "description": "Ensures a value is an array. Useful for XML nodes that might be a single object or an array.",
+        "description": "Ensures a value is an array. Useful for input formats like XML that might return a single object or an array for the same field.",
         "parameters": [
           {
             "name": "value",
@@ -403,6 +427,21 @@
         "returns": "array",
         "example": "aslist(items)  // Always returns an array"
       }
+    },
+    {
+      "name": "spreadsheet",
+      "doc": {
+        "signature": "spreadsheet(data)",
+        "description": "Converts spreadsheet-style data (array of arrays) into an array of objects with named properties. First row is treated as headers.",
+        "parameters": [
+          {
+            "name": "data",
+            "description": "Array of arrays (rows)"
+          }
+        ],
+        "returns": "array of objects",
+        "example": "spreadsheet(csvData)  // Converts [[\"name\",\"age\"],[\"John\",30]] to [{name:\"John\",age:30}]"
+      }
     }
   ],
   "operators": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@morphql/language-definitions",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Shared language definitions for MorphQL across VSCode, Monaco, and documentation",
   "type": "module",
   "publishConfig": {