@morphql/language-definitions 0.1.29 → 0.1.30

package/dist/index.cjs

@@ -467,6 +467,134 @@ var FUNCTIONS = [
       example: "array(1, 2, 3)  // [1, 2, 3]"
     }
   },
+  {
+    name: "avg",
+    doc: {
+      signature: "avg(array, valueExpression)",
+      description: "Returns the average of a numeric expression evaluated per item. Only non-NaN values contribute. Returns 0 for empty or null arrays.",
+      parameters: [
+        { name: "array", description: "The array to average over" },
+        {
+          name: "valueExpression",
+          description: "Expression evaluated for each item to extract the numeric value. Bare field names resolve against each item."
+        }
+      ],
+      returns: "number",
+      example: "set avgPrice = avg(items, price)"
+    }
+  },
+  {
+    name: "minof",
+    doc: {
+      signature: "minof(array, valueExpression)",
+      description: "Returns the minimum of a numeric expression evaluated per item. Skips non-numeric values. Returns null for empty or null arrays.",
+      parameters: [
+        { name: "array", description: "The array to find the minimum in" },
+        {
+          name: "valueExpression",
+          description: "Expression evaluated for each item. Bare field names resolve against each item."
+        }
+      ],
+      returns: "number | null",
+      example: "set cheapest = minof(products, price)"
+    }
+  },
+  {
+    name: "maxof",
+    doc: {
+      signature: "maxof(array, valueExpression)",
+      description: "Returns the maximum of a numeric expression evaluated per item. Skips non-numeric values. Returns null for empty or null arrays.",
+      parameters: [
+        { name: "array", description: "The array to find the maximum in" },
+        {
+          name: "valueExpression",
+          description: "Expression evaluated for each item. Bare field names resolve against each item."
+        }
+      ],
+      returns: "number | null",
+      example: "set mostExpensive = maxof(products, price)"
+    }
+  },
+  {
+    name: "every",
+    doc: {
+      signature: "every(array, conditionExpression)",
+      description: "Returns true if a condition expression is truthy for every item in the array. Returns true for empty or null arrays (vacuously true).",
+      parameters: [
+        { name: "array", description: "The array to test" },
+        {
+          name: "conditionExpression",
+          description: "Boolean expression evaluated for each item. Bare field names resolve against each item."
+        }
+      ],
+      returns: "boolean",
+      example: 'set allPaid = every(orders, status == "paid")\nset valid = every(items, amount > 0)'
+    }
+  },
+  {
+    name: "some",
+    doc: {
+      signature: "some(array, conditionExpression)",
+      description: "Returns true if a condition expression is truthy for at least one item. Returns false for empty or null arrays.",
+      parameters: [
+        { name: "array", description: "The array to test" },
+        {
+          name: "conditionExpression",
+          description: "Boolean expression evaluated for each item. Bare field names resolve against each item."
+        }
+      ],
+      returns: "boolean",
+      example: "set hasOverdue = some(invoices, daysOverdue > 0)\nset hasDiscount = some(items, discount > 0)"
+    }
+  },
+  {
+    name: "distinct",
+    doc: {
+      signature: "distinct(array, valueExpression)",
+      description: "Returns an array of distinct values of an expression across the array, preserving first-seen order. Deduplication is based on String() coercion.",
+      parameters: [
+        { name: "array", description: "The array to extract distinct values from" },
+        {
+          name: "valueExpression",
+          description: "Expression evaluated for each item. Bare field names resolve against each item."
+        }
+      ],
+      returns: "array",
+      example: "set categories = distinct(products, category)\nset statuses = distinct(orders, status)"
+    }
+  },
+  {
+    name: "sum",
+    doc: {
+      signature: "sum(array, valueExpression)",
+      description: "Sums a numeric expression evaluated per item across an array. null, undefined and non-numeric values are treated as 0.",
+      parameters: [
+        { name: "array", description: "The array to sum over" },
+        {
+          name: "valueExpression",
+          description: "Expression evaluated for each item to extract the numeric value. Bare field names resolve against each item."
+        }
+      ],
+      returns: "number",
+      example: "set total = sum(orders, amount)\nset discounted = sum(items, price * quantity)"
+    }
+  },
+  {
+    name: "groupby",
+    doc: {
+      signature: "groupby(array, keyExpression)",
+      description: "Groups an array of items by a key expression evaluated per item. Returns an array of `{ key, items }` objects in insertion order. Typically used as the `from` source of a `section multiple`.",
+      parameters: [
+        { name: "array", description: "The array to group" },
+        {
+          name: "keyExpression",
+          description: "Expression evaluated for each item to compute the group key. Bare field names resolve against each item."
+        }
+      ],
+      returns: "array of { key, items }",
+      example: "section multiple byCategory(\n  set category = key\n  set count = length(items)\n  section multiple products(\n    set name = name\n  ) from items\n) from groupby(products, category)"
+    }
+  },
   // ── Math functions ────────────────────────────────────────────────────────
   {
     name: "floor",

package/dist/index.js

@@ -425,6 +425,134 @@ var FUNCTIONS = [
       example: "array(1, 2, 3)  // [1, 2, 3]"
     }
   },
+  {
+    name: "avg",
+    doc: {
+      signature: "avg(array, valueExpression)",
+      description: "Returns the average of a numeric expression evaluated per item. Only non-NaN values contribute. Returns 0 for empty or null arrays.",
+      parameters: [
+        { name: "array", description: "The array to average over" },
+        {
+          name: "valueExpression",
+          description: "Expression evaluated for each item to extract the numeric value. Bare field names resolve against each item."
+        }
+      ],
+      returns: "number",
+      example: "set avgPrice = avg(items, price)"
+    }
+  },
+  {
+    name: "minof",
+    doc: {
+      signature: "minof(array, valueExpression)",
+      description: "Returns the minimum of a numeric expression evaluated per item. Skips non-numeric values. Returns null for empty or null arrays.",
+      parameters: [
+        { name: "array", description: "The array to find the minimum in" },
+        {
+          name: "valueExpression",
+          description: "Expression evaluated for each item. Bare field names resolve against each item."
+        }
+      ],
+      returns: "number | null",
+      example: "set cheapest = minof(products, price)"
+    }
+  },
+  {
+    name: "maxof",
+    doc: {
+      signature: "maxof(array, valueExpression)",
+      description: "Returns the maximum of a numeric expression evaluated per item. Skips non-numeric values. Returns null for empty or null arrays.",
+      parameters: [
+        { name: "array", description: "The array to find the maximum in" },
+        {
+          name: "valueExpression",
+          description: "Expression evaluated for each item. Bare field names resolve against each item."
+        }
+      ],
+      returns: "number | null",
+      example: "set mostExpensive = maxof(products, price)"
+    }
+  },
+  {
+    name: "every",
+    doc: {
+      signature: "every(array, conditionExpression)",
+      description: "Returns true if a condition expression is truthy for every item in the array. Returns true for empty or null arrays (vacuously true).",
+      parameters: [
+        { name: "array", description: "The array to test" },
+        {
+          name: "conditionExpression",
+          description: "Boolean expression evaluated for each item. Bare field names resolve against each item."
+        }
+      ],
+      returns: "boolean",
+      example: 'set allPaid = every(orders, status == "paid")\nset valid = every(items, amount > 0)'
+    }
+  },
+  {
+    name: "some",
+    doc: {
+      signature: "some(array, conditionExpression)",
+      description: "Returns true if a condition expression is truthy for at least one item. Returns false for empty or null arrays.",
+      parameters: [
+        { name: "array", description: "The array to test" },
+        {
+          name: "conditionExpression",
+          description: "Boolean expression evaluated for each item. Bare field names resolve against each item."
+        }
+      ],
+      returns: "boolean",
+      example: "set hasOverdue = some(invoices, daysOverdue > 0)\nset hasDiscount = some(items, discount > 0)"
+    }
+  },
+  {
+    name: "distinct",
+    doc: {
+      signature: "distinct(array, valueExpression)",
+      description: "Returns an array of distinct values of an expression across the array, preserving first-seen order. Deduplication is based on String() coercion.",
+      parameters: [
+        { name: "array", description: "The array to extract distinct values from" },
+        {
+          name: "valueExpression",
+          description: "Expression evaluated for each item. Bare field names resolve against each item."
+        }
+      ],
+      returns: "array",
+      example: "set categories = distinct(products, category)\nset statuses = distinct(orders, status)"
+    }
+  },
+  {
+    name: "sum",
+    doc: {
+      signature: "sum(array, valueExpression)",
+      description: "Sums a numeric expression evaluated per item across an array. null, undefined and non-numeric values are treated as 0.",
+      parameters: [
+        { name: "array", description: "The array to sum over" },
+        {
+          name: "valueExpression",
+          description: "Expression evaluated for each item to extract the numeric value. Bare field names resolve against each item."
+        }
+      ],
+      returns: "number",
+      example: "set total = sum(orders, amount)\nset discounted = sum(items, price * quantity)"
+    }
+  },
+  {
+    name: "groupby",
+    doc: {
+      signature: "groupby(array, keyExpression)",
+      description: "Groups an array of items by a key expression evaluated per item. Returns an array of `{ key, items }` objects in insertion order. Typically used as the `from` source of a `section multiple`.",
+      parameters: [
+        { name: "array", description: "The array to group" },
+        {
+          name: "keyExpression",
+          description: "Expression evaluated for each item to compute the group key. Bare field names resolve against each item."
+        }
+      ],
+      returns: "array of { key, items }",
+      example: "section multiple byCategory(\n  set category = key\n  set count = length(items)\n  section multiple products(\n    set name = name\n  ) from items\n) from groupby(products, category)"
+    }
+  },
   // ── Math functions ────────────────────────────────────────────────────────
   {
     name: "floor",

package/dist/morphql-lang.json

@@ -530,6 +530,158 @@
         "example": "array(1, 2, 3)  // [1, 2, 3]"
       }
     },
+    {
+      "name": "avg",
+      "doc": {
+        "signature": "avg(array, valueExpression)",
+        "description": "Returns the average of a numeric expression evaluated per item. Only non-NaN values contribute. Returns 0 for empty or null arrays.",
+        "parameters": [
+          {
+            "name": "array",
+            "description": "The array to average over"
+          },
+          {
+            "name": "valueExpression",
+            "description": "Expression evaluated for each item to extract the numeric value. Bare field names resolve against each item."
+          }
+        ],
+        "returns": "number",
+        "example": "set avgPrice = avg(items, price)"
+      }
+    },
+    {
+      "name": "minof",
+      "doc": {
+        "signature": "minof(array, valueExpression)",
+        "description": "Returns the minimum of a numeric expression evaluated per item. Skips non-numeric values. Returns null for empty or null arrays.",
+        "parameters": [
+          {
+            "name": "array",
+            "description": "The array to find the minimum in"
+          },
+          {
+            "name": "valueExpression",
+            "description": "Expression evaluated for each item. Bare field names resolve against each item."
+          }
+        ],
+        "returns": "number | null",
+        "example": "set cheapest = minof(products, price)"
+      }
+    },
+    {
+      "name": "maxof",
+      "doc": {
+        "signature": "maxof(array, valueExpression)",
+        "description": "Returns the maximum of a numeric expression evaluated per item. Skips non-numeric values. Returns null for empty or null arrays.",
+        "parameters": [
+          {
+            "name": "array",
+            "description": "The array to find the maximum in"
+          },
+          {
+            "name": "valueExpression",
+            "description": "Expression evaluated for each item. Bare field names resolve against each item."
+          }
+        ],
+        "returns": "number | null",
+        "example": "set mostExpensive = maxof(products, price)"
+      }
+    },
+    {
+      "name": "every",
+      "doc": {
+        "signature": "every(array, conditionExpression)",
+        "description": "Returns true if a condition expression is truthy for every item in the array. Returns true for empty or null arrays (vacuously true).",
+        "parameters": [
+          {
+            "name": "array",
+            "description": "The array to test"
+          },
+          {
+            "name": "conditionExpression",
+            "description": "Boolean expression evaluated for each item. Bare field names resolve against each item."
+          }
+        ],
+        "returns": "boolean",
+        "example": "set allPaid = every(orders, status == \"paid\")\nset valid = every(items, amount > 0)"
+      }
+    },
+    {
+      "name": "some",
+      "doc": {
+        "signature": "some(array, conditionExpression)",
+        "description": "Returns true if a condition expression is truthy for at least one item. Returns false for empty or null arrays.",
+        "parameters": [
+          {
+            "name": "array",
+            "description": "The array to test"
+          },
+          {
+            "name": "conditionExpression",
+            "description": "Boolean expression evaluated for each item. Bare field names resolve against each item."
+          }
+        ],
+        "returns": "boolean",
+        "example": "set hasOverdue = some(invoices, daysOverdue > 0)\nset hasDiscount = some(items, discount > 0)"
+      }
+    },
+    {
+      "name": "distinct",
+      "doc": {
+        "signature": "distinct(array, valueExpression)",
+        "description": "Returns an array of distinct values of an expression across the array, preserving first-seen order. Deduplication is based on String() coercion.",
+        "parameters": [
+          {
+            "name": "array",
+            "description": "The array to extract distinct values from"
+          },
+          {
+            "name": "valueExpression",
+            "description": "Expression evaluated for each item. Bare field names resolve against each item."
+          }
+        ],
+        "returns": "array",
+        "example": "set categories = distinct(products, category)\nset statuses = distinct(orders, status)"
+      }
+    },
+    {
+      "name": "sum",
+      "doc": {
+        "signature": "sum(array, valueExpression)",
+        "description": "Sums a numeric expression evaluated per item across an array. null, undefined and non-numeric values are treated as 0.",
+        "parameters": [
+          {
+            "name": "array",
+            "description": "The array to sum over"
+          },
+          {
+            "name": "valueExpression",
+            "description": "Expression evaluated for each item to extract the numeric value. Bare field names resolve against each item."
+          }
+        ],
+        "returns": "number",
+        "example": "set total = sum(orders, amount)\nset discounted = sum(items, price * quantity)"
+      }
+    },
+    {
+      "name": "groupby",
+      "doc": {
+        "signature": "groupby(array, keyExpression)",
+        "description": "Groups an array of items by a key expression evaluated per item. Returns an array of `{ key, items }` objects in insertion order. Typically used as the `from` source of a `section multiple`.",
+        "parameters": [
+          {
+            "name": "array",
+            "description": "The array to group"
+          },
+          {
+            "name": "keyExpression",
+            "description": "Expression evaluated for each item to compute the group key. Bare field names resolve against each item."
+          }
+        ],
+        "returns": "array of { key, items }",
+        "example": "section multiple byCategory(\n  set category = key\n  set count = length(items)\n  section multiple products(\n    set name = name\n  ) from items\n) from groupby(products, category)"
+      }
+    },
     {
       "name": "floor",
       "doc": {

package/package.json

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