@morphql/language-definitions 0.1.26 → 0.1.28

package/dist/index.cjs

@@ -466,6 +466,175 @@ var FUNCTIONS = [
       returns: "array",
       example: "array(1, 2, 3)  // [1, 2, 3]"
     }
+  },
+  // ── Math functions ────────────────────────────────────────────────────────
+  {
+    name: "floor",
+    doc: {
+      signature: "floor(value)",
+      description: "Rounds a number down to the nearest integer.",
+      parameters: [{ name: "value", description: "The number to round down" }],
+      returns: "number",
+      example: "floor(4.9)  // 4"
+    }
+  },
+  {
+    name: "ceil",
+    doc: {
+      signature: "ceil(value)",
+      description: "Rounds a number up to the nearest integer.",
+      parameters: [{ name: "value", description: "The number to round up" }],
+      returns: "number",
+      example: "ceil(4.1)  // 5"
+    }
+  },
+  {
+    name: "round",
+    doc: {
+      signature: "round(value, [mode])",
+      description: `Rounds a number to the nearest integer. Mode controls tie-breaking: "half-up" (default) rounds .5 away from zero; "half-even" uses banker's rounding (rounds .5 to the nearest even integer).`,
+      parameters: [
+        { name: "value", description: "The number to round" },
+        {
+          name: "mode",
+          description: '(Optional) Rounding mode: "half-up" (default) or "half-even"'
+        }
+      ],
+      returns: "number",
+      example: `round(4.5)              // 5  (half-up)
+round(4.5, "half-even") // 4  (banker's)
+round(3.5, "half-even") // 4  (banker's)`
+    }
+  },
+  {
+    name: "abs",
+    doc: {
+      signature: "abs(value)",
+      description: "Returns the absolute value of a number.",
+      parameters: [{ name: "value", description: "The number" }],
+      returns: "number",
+      example: "abs(-42)  // 42"
+    }
+  },
+  {
+    name: "fixed",
+    doc: {
+      signature: "fixed(value, [decimals], [mode])",
+      description: `Formats a number to a fixed number of decimal places. Mode controls tie-breaking: "half-up" (default) rounds .5 away from zero; "half-even" uses banker's rounding. Returns a string. Default decimals: 2.`,
+      parameters: [
+        { name: "value", description: "The number to format" },
+        {
+          name: "decimals",
+          description: "(Optional) Number of decimal places. Default: 2"
+        },
+        {
+          name: "mode",
+          description: '(Optional) Rounding mode: "half-up" (default) or "half-even"'
+        }
+      ],
+      returns: "string",
+      example: `fixed(2.5, 2)              // "2.50"  (half-up)
+fixed(2.5, 2, "half-even") // "2.50"  (banker's, no tie at 2 decimals)
+fixed(2.5, 0, "half-even") // "2"     (banker's, rounds to even)`
+    }
+  },
+  {
+    name: "min",
+    doc: {
+      signature: "min(a, b, ...)",
+      description: "Returns the smallest of two or more numbers.",
+      parameters: [{ name: "a, b, ...", description: "Numbers to compare" }],
+      returns: "number",
+      example: "min(3, 1, 4)  // 1"
+    }
+  },
+  {
+    name: "max",
+    doc: {
+      signature: "max(a, b, ...)",
+      description: "Returns the largest of two or more numbers.",
+      parameters: [{ name: "a, b, ...", description: "Numbers to compare" }],
+      returns: "number",
+      example: "max(3, 1, 4)  // 4"
+    }
+  },
+  // ── String functions ──────────────────────────────────────────────────────
+  {
+    name: "trim",
+    doc: {
+      signature: "trim(str)",
+      description: "Removes leading and trailing whitespace from a string.",
+      parameters: [{ name: "str", description: "The string to trim" }],
+      returns: "string",
+      example: 'trim("  hello  ")  // "hello"'
+    }
+  },
+  {
+    name: "padstart",
+    doc: {
+      signature: "padstart(str, length, [char])",
+      description: "Pads the start of a string with a character until it reaches the target length.",
+      parameters: [
+        { name: "str", description: "The string to pad" },
+        { name: "length", description: "Target total length" },
+        { name: "char", description: '(Optional) Pad character. Default: " "' }
+      ],
+      returns: "string",
+      example: 'padstart(id, 8, "0")  // "00000042"'
+    }
+  },
+  {
+    name: "padend",
+    doc: {
+      signature: "padend(str, length, [char])",
+      description: "Pads the end of a string with a character until it reaches the target length.",
+      parameters: [
+        { name: "str", description: "The string to pad" },
+        { name: "length", description: "Target total length" },
+        { name: "char", description: '(Optional) Pad character. Default: " "' }
+      ],
+      returns: "string",
+      example: 'padend(name, 20)  // "Alice               "'
+    }
+  },
+  {
+    name: "indexof",
+    doc: {
+      signature: "indexof(str, search)",
+      description: "Returns the index of the first occurrence of a substring. Returns -1 if not found.",
+      parameters: [
+        { name: "str", description: "The string to search in" },
+        { name: "search", description: "The substring to find" }
+      ],
+      returns: "number",
+      example: 'indexof("hello world", "world")  // 6'
+    }
+  },
+  {
+    name: "startswith",
+    doc: {
+      signature: "startswith(str, prefix)",
+      description: "Returns true if the string starts with the given prefix.",
+      parameters: [
+        { name: "str", description: "The string to check" },
+        { name: "prefix", description: "The prefix to look for" }
+      ],
+      returns: "boolean",
+      example: 'startswith("hello", "he")  // true'
+    }
+  },
+  {
+    name: "endswith",
+    doc: {
+      signature: "endswith(str, suffix)",
+      description: "Returns true if the string ends with the given suffix.",
+      parameters: [
+        { name: "str", description: "The string to check" },
+        { name: "suffix", description: "The suffix to look for" }
+      ],
+      returns: "boolean",
+      example: 'endswith("hello", "lo")  // true'
+    }
   }
 ];
 var getFunctionNames = () => FUNCTIONS.map((f) => f.name);
@@ -491,6 +660,7 @@ var OPERATORS = [
   { symbol: "-", category: "arithmetic", precedence: 10 },
   { symbol: "*", category: "arithmetic", precedence: 11 },
   { symbol: "/", category: "arithmetic", precedence: 11 },
+  { symbol: "%", category: "arithmetic", precedence: 11 },
   // Assignment
   { symbol: "=", category: "assignment", precedence: 1 }
 ];

package/dist/index.js

@@ -424,6 +424,175 @@ var FUNCTIONS = [
       returns: "array",
       example: "array(1, 2, 3)  // [1, 2, 3]"
     }
+  },
+  // ── Math functions ────────────────────────────────────────────────────────
+  {
+    name: "floor",
+    doc: {
+      signature: "floor(value)",
+      description: "Rounds a number down to the nearest integer.",
+      parameters: [{ name: "value", description: "The number to round down" }],
+      returns: "number",
+      example: "floor(4.9)  // 4"
+    }
+  },
+  {
+    name: "ceil",
+    doc: {
+      signature: "ceil(value)",
+      description: "Rounds a number up to the nearest integer.",
+      parameters: [{ name: "value", description: "The number to round up" }],
+      returns: "number",
+      example: "ceil(4.1)  // 5"
+    }
+  },
+  {
+    name: "round",
+    doc: {
+      signature: "round(value, [mode])",
+      description: `Rounds a number to the nearest integer. Mode controls tie-breaking: "half-up" (default) rounds .5 away from zero; "half-even" uses banker's rounding (rounds .5 to the nearest even integer).`,
+      parameters: [
+        { name: "value", description: "The number to round" },
+        {
+          name: "mode",
+          description: '(Optional) Rounding mode: "half-up" (default) or "half-even"'
+        }
+      ],
+      returns: "number",
+      example: `round(4.5)              // 5  (half-up)
+round(4.5, "half-even") // 4  (banker's)
+round(3.5, "half-even") // 4  (banker's)`
+    }
+  },
+  {
+    name: "abs",
+    doc: {
+      signature: "abs(value)",
+      description: "Returns the absolute value of a number.",
+      parameters: [{ name: "value", description: "The number" }],
+      returns: "number",
+      example: "abs(-42)  // 42"
+    }
+  },
+  {
+    name: "fixed",
+    doc: {
+      signature: "fixed(value, [decimals], [mode])",
+      description: `Formats a number to a fixed number of decimal places. Mode controls tie-breaking: "half-up" (default) rounds .5 away from zero; "half-even" uses banker's rounding. Returns a string. Default decimals: 2.`,
+      parameters: [
+        { name: "value", description: "The number to format" },
+        {
+          name: "decimals",
+          description: "(Optional) Number of decimal places. Default: 2"
+        },
+        {
+          name: "mode",
+          description: '(Optional) Rounding mode: "half-up" (default) or "half-even"'
+        }
+      ],
+      returns: "string",
+      example: `fixed(2.5, 2)              // "2.50"  (half-up)
+fixed(2.5, 2, "half-even") // "2.50"  (banker's, no tie at 2 decimals)
+fixed(2.5, 0, "half-even") // "2"     (banker's, rounds to even)`
+    }
+  },
+  {
+    name: "min",
+    doc: {
+      signature: "min(a, b, ...)",
+      description: "Returns the smallest of two or more numbers.",
+      parameters: [{ name: "a, b, ...", description: "Numbers to compare" }],
+      returns: "number",
+      example: "min(3, 1, 4)  // 1"
+    }
+  },
+  {
+    name: "max",
+    doc: {
+      signature: "max(a, b, ...)",
+      description: "Returns the largest of two or more numbers.",
+      parameters: [{ name: "a, b, ...", description: "Numbers to compare" }],
+      returns: "number",
+      example: "max(3, 1, 4)  // 4"
+    }
+  },
+  // ── String functions ──────────────────────────────────────────────────────
+  {
+    name: "trim",
+    doc: {
+      signature: "trim(str)",
+      description: "Removes leading and trailing whitespace from a string.",
+      parameters: [{ name: "str", description: "The string to trim" }],
+      returns: "string",
+      example: 'trim("  hello  ")  // "hello"'
+    }
+  },
+  {
+    name: "padstart",
+    doc: {
+      signature: "padstart(str, length, [char])",
+      description: "Pads the start of a string with a character until it reaches the target length.",
+      parameters: [
+        { name: "str", description: "The string to pad" },
+        { name: "length", description: "Target total length" },
+        { name: "char", description: '(Optional) Pad character. Default: " "' }
+      ],
+      returns: "string",
+      example: 'padstart(id, 8, "0")  // "00000042"'
+    }
+  },
+  {
+    name: "padend",
+    doc: {
+      signature: "padend(str, length, [char])",
+      description: "Pads the end of a string with a character until it reaches the target length.",
+      parameters: [
+        { name: "str", description: "The string to pad" },
+        { name: "length", description: "Target total length" },
+        { name: "char", description: '(Optional) Pad character. Default: " "' }
+      ],
+      returns: "string",
+      example: 'padend(name, 20)  // "Alice               "'
+    }
+  },
+  {
+    name: "indexof",
+    doc: {
+      signature: "indexof(str, search)",
+      description: "Returns the index of the first occurrence of a substring. Returns -1 if not found.",
+      parameters: [
+        { name: "str", description: "The string to search in" },
+        { name: "search", description: "The substring to find" }
+      ],
+      returns: "number",
+      example: 'indexof("hello world", "world")  // 6'
+    }
+  },
+  {
+    name: "startswith",
+    doc: {
+      signature: "startswith(str, prefix)",
+      description: "Returns true if the string starts with the given prefix.",
+      parameters: [
+        { name: "str", description: "The string to check" },
+        { name: "prefix", description: "The prefix to look for" }
+      ],
+      returns: "boolean",
+      example: 'startswith("hello", "he")  // true'
+    }
+  },
+  {
+    name: "endswith",
+    doc: {
+      signature: "endswith(str, suffix)",
+      description: "Returns true if the string ends with the given suffix.",
+      parameters: [
+        { name: "str", description: "The string to check" },
+        { name: "suffix", description: "The suffix to look for" }
+      ],
+      returns: "boolean",
+      example: 'endswith("hello", "lo")  // true'
+    }
   }
 ];
 var getFunctionNames = () => FUNCTIONS.map((f) => f.name);
@@ -449,6 +618,7 @@ var OPERATORS = [
   { symbol: "-", category: "arithmetic", precedence: 10 },
   { symbol: "*", category: "arithmetic", precedence: 11 },
   { symbol: "/", category: "arithmetic", precedence: 11 },
+  { symbol: "%", category: "arithmetic", precedence: 11 },
   // Assignment
   { symbol: "=", category: "assignment", precedence: 1 }
 ];

package/dist/morphql-lang.json

@@ -529,6 +529,241 @@
         "returns": "array",
         "example": "array(1, 2, 3)  // [1, 2, 3]"
       }
+    },
+    {
+      "name": "floor",
+      "doc": {
+        "signature": "floor(value)",
+        "description": "Rounds a number down to the nearest integer.",
+        "parameters": [
+          {
+            "name": "value",
+            "description": "The number to round down"
+          }
+        ],
+        "returns": "number",
+        "example": "floor(4.9)  // 4"
+      }
+    },
+    {
+      "name": "ceil",
+      "doc": {
+        "signature": "ceil(value)",
+        "description": "Rounds a number up to the nearest integer.",
+        "parameters": [
+          {
+            "name": "value",
+            "description": "The number to round up"
+          }
+        ],
+        "returns": "number",
+        "example": "ceil(4.1)  // 5"
+      }
+    },
+    {
+      "name": "round",
+      "doc": {
+        "signature": "round(value, [mode])",
+        "description": "Rounds a number to the nearest integer. Mode controls tie-breaking: \"half-up\" (default) rounds .5 away from zero; \"half-even\" uses banker's rounding (rounds .5 to the nearest even integer).",
+        "parameters": [
+          {
+            "name": "value",
+            "description": "The number to round"
+          },
+          {
+            "name": "mode",
+            "description": "(Optional) Rounding mode: \"half-up\" (default) or \"half-even\""
+          }
+        ],
+        "returns": "number",
+        "example": "round(4.5)              // 5  (half-up)\nround(4.5, \"half-even\") // 4  (banker's)\nround(3.5, \"half-even\") // 4  (banker's)"
+      }
+    },
+    {
+      "name": "abs",
+      "doc": {
+        "signature": "abs(value)",
+        "description": "Returns the absolute value of a number.",
+        "parameters": [
+          {
+            "name": "value",
+            "description": "The number"
+          }
+        ],
+        "returns": "number",
+        "example": "abs(-42)  // 42"
+      }
+    },
+    {
+      "name": "fixed",
+      "doc": {
+        "signature": "fixed(value, [decimals], [mode])",
+        "description": "Formats a number to a fixed number of decimal places. Mode controls tie-breaking: \"half-up\" (default) rounds .5 away from zero; \"half-even\" uses banker's rounding. Returns a string. Default decimals: 2.",
+        "parameters": [
+          {
+            "name": "value",
+            "description": "The number to format"
+          },
+          {
+            "name": "decimals",
+            "description": "(Optional) Number of decimal places. Default: 2"
+          },
+          {
+            "name": "mode",
+            "description": "(Optional) Rounding mode: \"half-up\" (default) or \"half-even\""
+          }
+        ],
+        "returns": "string",
+        "example": "fixed(2.5, 2)              // \"2.50\"  (half-up)\nfixed(2.5, 2, \"half-even\") // \"2.50\"  (banker's, no tie at 2 decimals)\nfixed(2.5, 0, \"half-even\") // \"2\"     (banker's, rounds to even)"
+      }
+    },
+    {
+      "name": "min",
+      "doc": {
+        "signature": "min(a, b, ...)",
+        "description": "Returns the smallest of two or more numbers.",
+        "parameters": [
+          {
+            "name": "a, b, ...",
+            "description": "Numbers to compare"
+          }
+        ],
+        "returns": "number",
+        "example": "min(3, 1, 4)  // 1"
+      }
+    },
+    {
+      "name": "max",
+      "doc": {
+        "signature": "max(a, b, ...)",
+        "description": "Returns the largest of two or more numbers.",
+        "parameters": [
+          {
+            "name": "a, b, ...",
+            "description": "Numbers to compare"
+          }
+        ],
+        "returns": "number",
+        "example": "max(3, 1, 4)  // 4"
+      }
+    },
+    {
+      "name": "trim",
+      "doc": {
+        "signature": "trim(str)",
+        "description": "Removes leading and trailing whitespace from a string.",
+        "parameters": [
+          {
+            "name": "str",
+            "description": "The string to trim"
+          }
+        ],
+        "returns": "string",
+        "example": "trim(\"  hello  \")  // \"hello\""
+      }
+    },
+    {
+      "name": "padstart",
+      "doc": {
+        "signature": "padstart(str, length, [char])",
+        "description": "Pads the start of a string with a character until it reaches the target length.",
+        "parameters": [
+          {
+            "name": "str",
+            "description": "The string to pad"
+          },
+          {
+            "name": "length",
+            "description": "Target total length"
+          },
+          {
+            "name": "char",
+            "description": "(Optional) Pad character. Default: \" \""
+          }
+        ],
+        "returns": "string",
+        "example": "padstart(id, 8, \"0\")  // \"00000042\""
+      }
+    },
+    {
+      "name": "padend",
+      "doc": {
+        "signature": "padend(str, length, [char])",
+        "description": "Pads the end of a string with a character until it reaches the target length.",
+        "parameters": [
+          {
+            "name": "str",
+            "description": "The string to pad"
+          },
+          {
+            "name": "length",
+            "description": "Target total length"
+          },
+          {
+            "name": "char",
+            "description": "(Optional) Pad character. Default: \" \""
+          }
+        ],
+        "returns": "string",
+        "example": "padend(name, 20)  // \"Alice               \""
+      }
+    },
+    {
+      "name": "indexof",
+      "doc": {
+        "signature": "indexof(str, search)",
+        "description": "Returns the index of the first occurrence of a substring. Returns -1 if not found.",
+        "parameters": [
+          {
+            "name": "str",
+            "description": "The string to search in"
+          },
+          {
+            "name": "search",
+            "description": "The substring to find"
+          }
+        ],
+        "returns": "number",
+        "example": "indexof(\"hello world\", \"world\")  // 6"
+      }
+    },
+    {
+      "name": "startswith",
+      "doc": {
+        "signature": "startswith(str, prefix)",
+        "description": "Returns true if the string starts with the given prefix.",
+        "parameters": [
+          {
+            "name": "str",
+            "description": "The string to check"
+          },
+          {
+            "name": "prefix",
+            "description": "The prefix to look for"
+          }
+        ],
+        "returns": "boolean",
+        "example": "startswith(\"hello\", \"he\")  // true"
+      }
+    },
+    {
+      "name": "endswith",
+      "doc": {
+        "signature": "endswith(str, suffix)",
+        "description": "Returns true if the string ends with the given suffix.",
+        "parameters": [
+          {
+            "name": "str",
+            "description": "The string to check"
+          },
+          {
+            "name": "suffix",
+            "description": "The suffix to look for"
+          }
+        ],
+        "returns": "boolean",
+        "example": "endswith(\"hello\", \"lo\")  // true"
+      }
     }
   ],
   "operators": [
@@ -607,6 +842,11 @@
       "category": "arithmetic",
       "precedence": 11
     },
+    {
+      "symbol": "%",
+      "category": "arithmetic",
+      "precedence": 11
+    },
     {
       "symbol": "=",
       "category": "assignment",

package/package.json

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