@revisium/formula 0.2.1 → 0.4.0

package/dist/formula-spec.cjs

@@ -33,10 +33,301 @@ var formulaSpec = {
       { operator: "||", description: "Logical OR" },
       { operator: "!", description: "Logical NOT" }
     ],
-    other: [
-      "Parentheses: (a + b) * c",
-      "Ternary: condition ? valueIfTrue : valueIfFalse",
-      "Unary minus: -value, a + -b"
+    other: ["Parentheses: (a + b) * c", "Unary minus: -value, a + -b"]
+  },
+  functions: {
+    string: [
+      {
+        name: "concat",
+        description: "Concatenate multiple values into a single string",
+        signature: "concat(value1, value2, ...)",
+        returnType: "string",
+        examples: [
+          'concat(firstName, " ", lastName) // "John Doe"',
+          'concat("Price: ", price, " USD") // "Price: 100 USD"'
+        ]
+      },
+      {
+        name: "upper",
+        description: "Convert string to uppercase",
+        signature: "upper(text)",
+        returnType: "string",
+        examples: ['upper(name) // "HELLO"']
+      },
+      {
+        name: "lower",
+        description: "Convert string to lowercase",
+        signature: "lower(text)",
+        returnType: "string",
+        examples: ['lower(name) // "hello"']
+      },
+      {
+        name: "trim",
+        description: "Remove whitespace from both ends of a string",
+        signature: "trim(text)",
+        returnType: "string",
+        examples: ['trim(name) // "hello" from "  hello  "']
+      },
+      {
+        name: "left",
+        description: "Extract characters from the beginning of a string",
+        signature: "left(text, count)",
+        returnType: "string",
+        examples: ['left(name, 3) // "hel" from "hello"']
+      },
+      {
+        name: "right",
+        description: "Extract characters from the end of a string",
+        signature: "right(text, count)",
+        returnType: "string",
+        examples: ['right(name, 3) // "llo" from "hello"']
+      },
+      {
+        name: "replace",
+        description: "Replace first occurrence of a substring",
+        signature: "replace(text, search, replacement)",
+        returnType: "string",
+        examples: ['replace(name, "o", "0") // "hell0" from "hello"']
+      },
+      {
+        name: "join",
+        description: "Join array elements into a string",
+        signature: "join(array, separator?)",
+        returnType: "string",
+        examples: ['join(tags) // "a,b,c"', 'join(tags, " | ") // "a | b | c"']
+      }
+    ],
+    numeric: [
+      {
+        name: "round",
+        description: "Round a number to specified decimal places",
+        signature: "round(number, decimals?)",
+        returnType: "number",
+        examples: ["round(3.14159, 2) // 3.14", "round(3.5) // 4"]
+      },
+      {
+        name: "floor",
+        description: "Round down to the nearest integer",
+        signature: "floor(number)",
+        returnType: "number",
+        examples: ["floor(3.7) // 3"]
+      },
+      {
+        name: "ceil",
+        description: "Round up to the nearest integer",
+        signature: "ceil(number)",
+        returnType: "number",
+        examples: ["ceil(3.2) // 4"]
+      },
+      {
+        name: "abs",
+        description: "Get the absolute value",
+        signature: "abs(number)",
+        returnType: "number",
+        examples: ["abs(-5) // 5"]
+      },
+      {
+        name: "sqrt",
+        description: "Calculate the square root",
+        signature: "sqrt(number)",
+        returnType: "number",
+        examples: ["sqrt(16) // 4"]
+      },
+      {
+        name: "pow",
+        description: "Raise a number to a power",
+        signature: "pow(base, exponent)",
+        returnType: "number",
+        examples: ["pow(2, 3) // 8"]
+      },
+      {
+        name: "min",
+        description: "Get the minimum of multiple values",
+        signature: "min(value1, value2, ...)",
+        returnType: "number",
+        examples: ["min(a, b, c) // smallest value"]
+      },
+      {
+        name: "max",
+        description: "Get the maximum of multiple values",
+        signature: "max(value1, value2, ...)",
+        returnType: "number",
+        examples: ["max(a, b, c) // largest value"]
+      },
+      {
+        name: "log",
+        description: "Calculate the natural logarithm",
+        signature: "log(number)",
+        returnType: "number",
+        examples: ["log(10) // 2.302..."]
+      },
+      {
+        name: "log10",
+        description: "Calculate the base-10 logarithm",
+        signature: "log10(number)",
+        returnType: "number",
+        examples: ["log10(100) // 2"]
+      },
+      {
+        name: "exp",
+        description: "Calculate e raised to a power",
+        signature: "exp(number)",
+        returnType: "number",
+        examples: ["exp(1) // 2.718..."]
+      },
+      {
+        name: "sign",
+        description: "Get the sign of a number (-1, 0, or 1)",
+        signature: "sign(number)",
+        returnType: "number",
+        examples: ["sign(-5) // -1", "sign(0) // 0", "sign(5) // 1"]
+      },
+      {
+        name: "length",
+        description: "Get the length of a string or array",
+        signature: "length(value)",
+        returnType: "number",
+        examples: ['length(name) // 5 from "hello"', "length(items) // 3"]
+      }
+    ],
+    boolean: [
+      {
+        name: "and",
+        description: "Logical AND of two values",
+        signature: "and(a, b)",
+        returnType: "boolean",
+        examples: ["and(isActive, hasPermission) // true if both true"]
+      },
+      {
+        name: "or",
+        description: "Logical OR of two values",
+        signature: "or(a, b)",
+        returnType: "boolean",
+        examples: ["or(isAdmin, isOwner) // true if either true"]
+      },
+      {
+        name: "not",
+        description: "Logical NOT of a value",
+        signature: "not(value)",
+        returnType: "boolean",
+        examples: ["not(isDeleted) // true if false"]
+      },
+      {
+        name: "contains",
+        description: "Check if a string contains a substring",
+        signature: "contains(text, search)",
+        returnType: "boolean",
+        examples: ['contains(name, "ell") // true for "hello"']
+      },
+      {
+        name: "startswith",
+        description: "Check if a string starts with a prefix",
+        signature: "startswith(text, prefix)",
+        returnType: "boolean",
+        examples: ['startswith(name, "hel") // true for "hello"']
+      },
+      {
+        name: "endswith",
+        description: "Check if a string ends with a suffix",
+        signature: "endswith(text, suffix)",
+        returnType: "boolean",
+        examples: ['endswith(name, "llo") // true for "hello"']
+      },
+      {
+        name: "isnull",
+        description: "Check if a value is null or undefined",
+        signature: "isnull(value)",
+        returnType: "boolean",
+        examples: ["isnull(optionalField) // true if null/undefined"]
+      },
+      {
+        name: "includes",
+        description: "Check if an array contains a value",
+        signature: "includes(array, value)",
+        returnType: "boolean",
+        examples: [
+          'includes(tags, "featured") // true if array contains value'
+        ]
+      }
+    ],
+    array: [
+      {
+        name: "sum",
+        description: "Calculate the sum of array elements",
+        signature: "sum(array)",
+        returnType: "number",
+        examples: ["sum(prices) // total of all prices"]
+      },
+      {
+        name: "avg",
+        description: "Calculate the average of array elements",
+        signature: "avg(array)",
+        returnType: "number",
+        examples: ["avg(scores) // average score"]
+      },
+      {
+        name: "count",
+        description: "Get the number of elements in an array",
+        signature: "count(array)",
+        returnType: "number",
+        examples: ["count(items) // number of items"]
+      },
+      {
+        name: "first",
+        description: "Get the first element of an array",
+        signature: "first(array)",
+        returnType: "any",
+        examples: ["first(items) // first item"]
+      },
+      {
+        name: "last",
+        description: "Get the last element of an array",
+        signature: "last(array)",
+        returnType: "any",
+        examples: ["last(items) // last item"]
+      }
+    ],
+    conversion: [
+      {
+        name: "tostring",
+        description: "Convert a value to string",
+        signature: "tostring(value)",
+        returnType: "string",
+        examples: ['tostring(42) // "42"']
+      },
+      {
+        name: "tonumber",
+        description: "Convert a value to number",
+        signature: "tonumber(value)",
+        returnType: "number",
+        examples: ['tonumber("42") // 42']
+      },
+      {
+        name: "toboolean",
+        description: "Convert a value to boolean",
+        signature: "toboolean(value)",
+        returnType: "boolean",
+        examples: ["toboolean(1) // true", "toboolean(0) // false"]
+      }
+    ],
+    conditional: [
+      {
+        name: "if",
+        description: "Return one of two values based on a condition",
+        signature: "if(condition, valueIfTrue, valueIfFalse)",
+        returnType: "any",
+        examples: [
+          'if(stock > 0, "Available", "Out of Stock")',
+          "if(price > 100, price * 0.9, price)"
+        ]
+      },
+      {
+        name: "coalesce",
+        description: "Return the first non-null value",
+        signature: "coalesce(value1, value2, ...)",
+        returnType: "any",
+        examples: ['coalesce(nickname, name, "Anonymous")']
+      }
     ]
   },
   features: [
@@ -77,12 +368,50 @@ var formulaSpec = {
         "items[-2].price // second to last"
       ],
       dependenciesExtracted: ['["items[0].price"]', '["items[-1].name"]']
+    },
+    {
+      name: "root_path",
+      description: "Absolute path reference starting with /. Always resolves from root data, even inside array item formulas",
+      minVersion: "1.1",
+      examples: [
+        "/taxRate",
+        "/config.tax",
+        "price * (1 + /taxRate)",
+        "price * /config.multiplier"
+      ],
+      dependenciesExtracted: ['["/taxRate"]', '["/config.tax"]']
+    },
+    {
+      name: "relative_path",
+      description: "Relative path reference starting with ../. Resolves from parent context (root data) when inside array item formulas",
+      minVersion: "1.1",
+      examples: [
+        "../discount",
+        "../settings.multiplier",
+        "price * (1 - ../discount)",
+        "price * ../settings.multiplier"
+      ],
+      dependenciesExtracted: ['["../discount"]', '["../settings.multiplier"]']
+    },
+    {
+      name: "function_named_fields",
+      description: "Fields can have the same name as built-in functions (max, min, sum, etc.). Built-in functions are always checked first when a function call is made",
+      minVersion: "1.0",
+      examples: [
+        "max(max, 0)",
+        "min(min, 100)",
+        "max(max - field.min, 0)",
+        "round(round * 2)"
+      ]
     }
   ],
   versionDetection: [
     { feature: "Simple refs, arithmetic, comparisons", minVersion: "1.0" },
+    { feature: "Function-named fields (max(max, 0))", minVersion: "1.0" },
     { feature: "Nested paths (a.b)", minVersion: "1.1" },
-    { feature: "Array index ([0], [-1])", minVersion: "1.1" }
+    { feature: "Array index ([0], [-1])", minVersion: "1.1" },
+    { feature: "Absolute paths (/field)", minVersion: "1.1" },
+    { feature: "Relative paths (../field)", minVersion: "1.1" }
   ],
   parseResult: {
     description: "The parser automatically detects the minimum required version",
@@ -110,7 +439,7 @@ var formulaSpec = {
       result: "boolean"
     },
     {
-      expression: 'stock > 0 ? "Available" : "Out of Stock"',
+      expression: 'if(stock > 0, "Available", "Out of Stock")',
       description: "Conditional text based on stock",
       result: "string"
     },
@@ -173,6 +502,58 @@ evaluate('price > 100', { price: 150 })
 
 evaluate('a + b * c', { a: 1, b: 2, c: 3 })
 // 7`
+    },
+    {
+      name: "Function-named fields",
+      description: "Fields can have the same name as built-in functions",
+      code: `// Built-in functions take precedence in function calls
+evaluate('max(max, 0)', { max: 10 })
+// 10 (max() function, then max field)
+
+evaluate('max(max - field.min, 0)', { max: 100, field: { min: 20 } })
+// 80
+
+evaluate('round(round * 2)', { round: 3.7 })
+// 7
+
+// Field named "sum" doesn't conflict with sum() function
+evaluate('sum(values) + sum', { values: [1, 2, 3], sum: 10 })
+// 16`
+    },
+    {
+      name: "Evaluate with context (array items)",
+      description: "Use evaluateWithContext() for array item formulas with path resolution",
+      code: `// Absolute path: /field always resolves from root
+evaluateWithContext('price * (1 + /taxRate)', {
+  rootData: { taxRate: 0.1, items: [{ price: 100 }] },
+  itemData: { price: 100 },
+  currentPath: 'items[0]'
+})
+// 110
+
+// Nested absolute path
+evaluateWithContext('price * /config.multiplier', {
+  rootData: { config: { multiplier: 1.5 }, items: [] },
+  itemData: { price: 100 },
+  currentPath: 'items[0]'
+})
+// 150
+
+// Relative path: ../field resolves from parent (root)
+evaluateWithContext('price * (1 - ../discount)', {
+  rootData: { discount: 0.2, items: [] },
+  itemData: { price: 100 },
+  currentPath: 'items[0]'
+})
+// 80
+
+// itemData takes precedence over rootData for same field
+evaluateWithContext('value + 10', {
+  rootData: { value: 100 },
+  itemData: { value: 50 },
+  currentPath: 'items[0]'
+})
+// 60`
     }
   ],
   schemaUsage: {
@@ -182,8 +563,7 @@ evaluate('a + b * c', { a: 1, b: 2, c: 3 })
       "Add x-formula to string, number, or boolean field schema",
       "readOnly: true is REQUIRED for fields with x-formula",
       "Expression must reference existing fields in the same table",
-      "Circular dependencies are not allowed (a references b, b references a)",
-      "Referenced fields must exist before the formula field in schema order"
+      "Circular dependencies are not allowed (a references b, b references a)"
     ]
   }
 };

package/dist/formula-spec.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/formula-spec.ts"],"names":[],"mappings":"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","file":"formula-spec.cjs","sourcesContent":["export interface FormulaSpec {\n  version: string;\n  description: string;\n  syntax: {\n    fieldReferences: string[];\n    arithmeticOperators: { operator: string; description: string }[];\n    comparisonOperators: { operator: string; description: string }[];\n    logicalOperators: { operator: string; description: string }[];\n    other: string[];\n  };\n  features: {\n    name: string;\n    description: string;\n    minVersion: string;\n    examples: string[];\n    dependenciesExtracted?: string[];\n  }[];\n  versionDetection: { feature: string; minVersion: string }[];\n  parseResult: {\n    description: string;\n    interface: string;\n  };\n  examples: {\n    expression: string;\n    description: string;\n    result?: string;\n  }[];\n  apiExamples: {\n    name: string;\n    description: string;\n    code: string;\n  }[];\n  schemaUsage: {\n    structure: string;\n    fieldTypes: string[];\n    rules: string[];\n  };\n}\n\nexport const formulaSpec: FormulaSpec = {\n  version: '1.1',\n  description:\n    'Formula expressions for computed fields. Formulas reference other fields and calculate values automatically.',\n\n  syntax: {\n    fieldReferences: [\n      'Simple field: fieldName (e.g., price, quantity)',\n      'Nested path: object.property (e.g., stats.damage)',\n      'Array index: array[0] or array[-1] for last element',\n      'Combined: items[0].price, user.addresses[-1].city',\n    ],\n    arithmeticOperators: [\n      { operator: '+', description: 'Addition or string concatenation' },\n      { operator: '-', description: 'Subtraction' },\n      { operator: '*', description: 'Multiplication' },\n      { operator: '/', description: 'Division' },\n      { operator: '%', description: 'Modulo (remainder)' },\n    ],\n    comparisonOperators: [\n      { operator: '==', description: 'Equal' },\n      { operator: '!=', description: 'Not equal' },\n      { operator: '>', description: 'Greater than' },\n      { operator: '<', description: 'Less than' },\n      { operator: '>=', description: 'Greater or equal' },\n      { operator: '<=', description: 'Less or equal' },\n    ],\n    logicalOperators: [\n      { operator: '&&', description: 'Logical AND' },\n      { operator: '||', description: 'Logical OR' },\n      { operator: '!', description: 'Logical NOT' },\n    ],\n    other: [\n      'Parentheses: (a + b) * c',\n      'Ternary: condition ? valueIfTrue : valueIfFalse',\n      'Unary minus: -value, a + -b',\n    ],\n  },\n\n  features: [\n    {\n      name: 'simple_refs',\n      description: 'Reference top-level fields by name',\n      minVersion: '1.0',\n      examples: ['price', 'quantity', 'baseDamage'],\n      dependenciesExtracted: ['[\"price\"]', '[\"quantity\"]', '[\"baseDamage\"]'],\n    },\n    {\n      name: 'arithmetic',\n      description: 'Basic math operations (+, -, *, /)',\n      minVersion: '1.0',\n      examples: ['price * 1.1', 'a + b - c', 'quantity * price'],\n    },\n    {\n      name: 'comparison',\n      description: 'Compare values (>, <, >=, <=, ==, !=)',\n      minVersion: '1.0',\n      examples: ['price > 100', 'x == 10', 'quantity >= 5'],\n    },\n    {\n      name: 'nested_path',\n      description: 'Access nested object properties using dot notation',\n      minVersion: '1.1',\n      examples: ['stats.damage', 'user.profile.name', 'item.metadata.category'],\n      dependenciesExtracted: ['[\"stats.damage\"]'],\n    },\n    {\n      name: 'array_index',\n      description:\n        'Access array elements by numeric index. Negative indices access from the end',\n      minVersion: '1.1',\n      examples: [\n        'items[0].price',\n        'inventory[1].quantity',\n        'items[-1].name  // last element',\n        'items[-2].price // second to last',\n      ],\n      dependenciesExtracted: ['[\"items[0].price\"]', '[\"items[-1].name\"]'],\n    },\n  ],\n\n  versionDetection: [\n    { feature: 'Simple refs, arithmetic, comparisons', minVersion: '1.0' },\n    { feature: 'Nested paths (a.b)', minVersion: '1.1' },\n    { feature: 'Array index ([0], [-1])', minVersion: '1.1' },\n  ],\n\n  parseResult: {\n    description:\n      'The parser automatically detects the minimum required version',\n    interface: `interface ParseResult {\n  ast: ASTNode;           // Abstract syntax tree\n  dependencies: string[]; // List of field dependencies\n  features: string[];     // List of detected features\n  minVersion: string;     // Minimum required version (\"1.0\" or \"1.1\")\n}`,\n  },\n\n  examples: [\n    {\n      expression: 'price * quantity',\n      description: 'Calculate total from price and quantity',\n      result: 'number',\n    },\n    {\n      expression: 'firstName + \" \" + lastName',\n      description: 'Concatenate strings with space',\n      result: 'string',\n    },\n    {\n      expression: 'quantity > 0',\n      description: 'Check if in stock',\n      result: 'boolean',\n    },\n    {\n      expression: 'stock > 0 ? \"Available\" : \"Out of Stock\"',\n      description: 'Conditional text based on stock',\n      result: 'string',\n    },\n    {\n      expression: 'price * (1 + taxRate)',\n      description: 'Price with tax',\n      result: 'number',\n    },\n    {\n      expression: 'items[0].price + items[1].price',\n      description: 'Sum first two item prices (v1.1)',\n      result: 'number',\n    },\n  ],\n\n  apiExamples: [\n    {\n      name: 'Simple Expression (v1.0)',\n      description: 'Parse a basic arithmetic expression',\n      code: `parseExpression('price * 1.1')\n// {\n//   minVersion: \"1.0\",\n//   features: [],\n//   dependencies: [\"price\"]\n// }`,\n    },\n    {\n      name: 'Nested Path (v1.1)',\n      description: 'Parse expression with nested object access',\n      code: `parseExpression('stats.damage * multiplier')\n// {\n//   minVersion: \"1.1\",\n//   features: [\"nested_path\"],\n//   dependencies: [\"stats.damage\", \"multiplier\"]\n// }`,\n    },\n    {\n      name: 'Array Access (v1.1)',\n      description: 'Parse expression with array index access',\n      code: `parseExpression('items[0].price + items[1].price')\n// {\n//   minVersion: \"1.1\",\n//   features: [\"array_index\", \"nested_path\"],\n//   dependencies: [\"items[0].price\", \"items[1].price\"]\n// }`,\n    },\n    {\n      name: 'Evaluate expressions',\n      description: 'Execute formulas with context data',\n      code: `evaluate('price * 1.1', { price: 100 })\n// 110\n\nevaluate('stats.damage', { stats: { damage: 50 } })\n// 50\n\nevaluate('items[0].price', { items: [{ price: 10 }] })\n// 10\n\nevaluate('price > 100', { price: 150 })\n// true\n\nevaluate('a + b * c', { a: 1, b: 2, c: 3 })\n// 7`,\n    },\n  ],\n\n  schemaUsage: {\n    structure:\n      '{ \"x-formula\": { \"version\": 1, \"expression\": \"...\" }, \"readOnly\": true }',\n    fieldTypes: ['string', 'number', 'boolean'],\n    rules: [\n      'Add x-formula to string, number, or boolean field schema',\n      'readOnly: true is REQUIRED for fields with x-formula',\n      'Expression must reference existing fields in the same table',\n      'Circular dependencies are not allowed (a references b, b references a)',\n      'Referenced fields must exist before the formula field in schema order',\n    ],\n  },\n};\n"]}
+{"version":3,"sources":["../src/formula-spec.ts"],"names":[],"mappings":"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","file":"formula-spec.cjs","sourcesContent":["export interface FunctionSpec {\n  name: string;\n  description: string;\n  signature: string;\n  returnType: 'string' | 'number' | 'boolean' | 'any';\n  examples: string[];\n}\n\nexport interface FormulaSpec {\n  version: string;\n  description: string;\n  syntax: {\n    fieldReferences: string[];\n    arithmeticOperators: { operator: string; description: string }[];\n    comparisonOperators: { operator: string; description: string }[];\n    logicalOperators: { operator: string; description: string }[];\n    other: string[];\n  };\n  functions: {\n    string: FunctionSpec[];\n    numeric: FunctionSpec[];\n    boolean: FunctionSpec[];\n    array: FunctionSpec[];\n    conversion: FunctionSpec[];\n    conditional: FunctionSpec[];\n  };\n  features: {\n    name: string;\n    description: string;\n    minVersion: string;\n    examples: string[];\n    dependenciesExtracted?: string[];\n  }[];\n  versionDetection: { feature: string; minVersion: string }[];\n  parseResult: {\n    description: string;\n    interface: string;\n  };\n  examples: {\n    expression: string;\n    description: string;\n    result?: string;\n  }[];\n  apiExamples: {\n    name: string;\n    description: string;\n    code: string;\n  }[];\n  schemaUsage: {\n    structure: string;\n    fieldTypes: string[];\n    rules: string[];\n  };\n}\n\nexport const formulaSpec: FormulaSpec = {\n  version: '1.1',\n  description:\n    'Formula expressions for computed fields. Formulas reference other fields and calculate values automatically.',\n\n  syntax: {\n    fieldReferences: [\n      'Simple field: fieldName (e.g., price, quantity)',\n      'Nested path: object.property (e.g., stats.damage)',\n      'Array index: array[0] or array[-1] for last element',\n      'Combined: items[0].price, user.addresses[-1].city',\n    ],\n    arithmeticOperators: [\n      { operator: '+', description: 'Addition or string concatenation' },\n      { operator: '-', description: 'Subtraction' },\n      { operator: '*', description: 'Multiplication' },\n      { operator: '/', description: 'Division' },\n      { operator: '%', description: 'Modulo (remainder)' },\n    ],\n    comparisonOperators: [\n      { operator: '==', description: 'Equal' },\n      { operator: '!=', description: 'Not equal' },\n      { operator: '>', description: 'Greater than' },\n      { operator: '<', description: 'Less than' },\n      { operator: '>=', description: 'Greater or equal' },\n      { operator: '<=', description: 'Less or equal' },\n    ],\n    logicalOperators: [\n      { operator: '&&', description: 'Logical AND' },\n      { operator: '||', description: 'Logical OR' },\n      { operator: '!', description: 'Logical NOT' },\n    ],\n    other: ['Parentheses: (a + b) * c', 'Unary minus: -value, a + -b'],\n  },\n\n  functions: {\n    string: [\n      {\n        name: 'concat',\n        description: 'Concatenate multiple values into a single string',\n        signature: 'concat(value1, value2, ...)',\n        returnType: 'string',\n        examples: [\n          'concat(firstName, \" \", lastName) // \"John Doe\"',\n          'concat(\"Price: \", price, \" USD\") // \"Price: 100 USD\"',\n        ],\n      },\n      {\n        name: 'upper',\n        description: 'Convert string to uppercase',\n        signature: 'upper(text)',\n        returnType: 'string',\n        examples: ['upper(name) // \"HELLO\"'],\n      },\n      {\n        name: 'lower',\n        description: 'Convert string to lowercase',\n        signature: 'lower(text)',\n        returnType: 'string',\n        examples: ['lower(name) // \"hello\"'],\n      },\n      {\n        name: 'trim',\n        description: 'Remove whitespace from both ends of a string',\n        signature: 'trim(text)',\n        returnType: 'string',\n        examples: ['trim(name) // \"hello\" from \"  hello  \"'],\n      },\n      {\n        name: 'left',\n        description: 'Extract characters from the beginning of a string',\n        signature: 'left(text, count)',\n        returnType: 'string',\n        examples: ['left(name, 3) // \"hel\" from \"hello\"'],\n      },\n      {\n        name: 'right',\n        description: 'Extract characters from the end of a string',\n        signature: 'right(text, count)',\n        returnType: 'string',\n        examples: ['right(name, 3) // \"llo\" from \"hello\"'],\n      },\n      {\n        name: 'replace',\n        description: 'Replace first occurrence of a substring',\n        signature: 'replace(text, search, replacement)',\n        returnType: 'string',\n        examples: ['replace(name, \"o\", \"0\") // \"hell0\" from \"hello\"'],\n      },\n      {\n        name: 'join',\n        description: 'Join array elements into a string',\n        signature: 'join(array, separator?)',\n        returnType: 'string',\n        examples: ['join(tags) // \"a,b,c\"', 'join(tags, \" | \") // \"a | b | c\"'],\n      },\n    ],\n    numeric: [\n      {\n        name: 'round',\n        description: 'Round a number to specified decimal places',\n        signature: 'round(number, decimals?)',\n        returnType: 'number',\n        examples: ['round(3.14159, 2) // 3.14', 'round(3.5) // 4'],\n      },\n      {\n        name: 'floor',\n        description: 'Round down to the nearest integer',\n        signature: 'floor(number)',\n        returnType: 'number',\n        examples: ['floor(3.7) // 3'],\n      },\n      {\n        name: 'ceil',\n        description: 'Round up to the nearest integer',\n        signature: 'ceil(number)',\n        returnType: 'number',\n        examples: ['ceil(3.2) // 4'],\n      },\n      {\n        name: 'abs',\n        description: 'Get the absolute value',\n        signature: 'abs(number)',\n        returnType: 'number',\n        examples: ['abs(-5) // 5'],\n      },\n      {\n        name: 'sqrt',\n        description: 'Calculate the square root',\n        signature: 'sqrt(number)',\n        returnType: 'number',\n        examples: ['sqrt(16) // 4'],\n      },\n      {\n        name: 'pow',\n        description: 'Raise a number to a power',\n        signature: 'pow(base, exponent)',\n        returnType: 'number',\n        examples: ['pow(2, 3) // 8'],\n      },\n      {\n        name: 'min',\n        description: 'Get the minimum of multiple values',\n        signature: 'min(value1, value2, ...)',\n        returnType: 'number',\n        examples: ['min(a, b, c) // smallest value'],\n      },\n      {\n        name: 'max',\n        description: 'Get the maximum of multiple values',\n        signature: 'max(value1, value2, ...)',\n        returnType: 'number',\n        examples: ['max(a, b, c) // largest value'],\n      },\n      {\n        name: 'log',\n        description: 'Calculate the natural logarithm',\n        signature: 'log(number)',\n        returnType: 'number',\n        examples: ['log(10) // 2.302...'],\n      },\n      {\n        name: 'log10',\n        description: 'Calculate the base-10 logarithm',\n        signature: 'log10(number)',\n        returnType: 'number',\n        examples: ['log10(100) // 2'],\n      },\n      {\n        name: 'exp',\n        description: 'Calculate e raised to a power',\n        signature: 'exp(number)',\n        returnType: 'number',\n        examples: ['exp(1) // 2.718...'],\n      },\n      {\n        name: 'sign',\n        description: 'Get the sign of a number (-1, 0, or 1)',\n        signature: 'sign(number)',\n        returnType: 'number',\n        examples: ['sign(-5) // -1', 'sign(0) // 0', 'sign(5) // 1'],\n      },\n      {\n        name: 'length',\n        description: 'Get the length of a string or array',\n        signature: 'length(value)',\n        returnType: 'number',\n        examples: ['length(name) // 5 from \"hello\"', 'length(items) // 3'],\n      },\n    ],\n    boolean: [\n      {\n        name: 'and',\n        description: 'Logical AND of two values',\n        signature: 'and(a, b)',\n        returnType: 'boolean',\n        examples: ['and(isActive, hasPermission) // true if both true'],\n      },\n      {\n        name: 'or',\n        description: 'Logical OR of two values',\n        signature: 'or(a, b)',\n        returnType: 'boolean',\n        examples: ['or(isAdmin, isOwner) // true if either true'],\n      },\n      {\n        name: 'not',\n        description: 'Logical NOT of a value',\n        signature: 'not(value)',\n        returnType: 'boolean',\n        examples: ['not(isDeleted) // true if false'],\n      },\n      {\n        name: 'contains',\n        description: 'Check if a string contains a substring',\n        signature: 'contains(text, search)',\n        returnType: 'boolean',\n        examples: ['contains(name, \"ell\") // true for \"hello\"'],\n      },\n      {\n        name: 'startswith',\n        description: 'Check if a string starts with a prefix',\n        signature: 'startswith(text, prefix)',\n        returnType: 'boolean',\n        examples: ['startswith(name, \"hel\") // true for \"hello\"'],\n      },\n      {\n        name: 'endswith',\n        description: 'Check if a string ends with a suffix',\n        signature: 'endswith(text, suffix)',\n        returnType: 'boolean',\n        examples: ['endswith(name, \"llo\") // true for \"hello\"'],\n      },\n      {\n        name: 'isnull',\n        description: 'Check if a value is null or undefined',\n        signature: 'isnull(value)',\n        returnType: 'boolean',\n        examples: ['isnull(optionalField) // true if null/undefined'],\n      },\n      {\n        name: 'includes',\n        description: 'Check if an array contains a value',\n        signature: 'includes(array, value)',\n        returnType: 'boolean',\n        examples: [\n          'includes(tags, \"featured\") // true if array contains value',\n        ],\n      },\n    ],\n    array: [\n      {\n        name: 'sum',\n        description: 'Calculate the sum of array elements',\n        signature: 'sum(array)',\n        returnType: 'number',\n        examples: ['sum(prices) // total of all prices'],\n      },\n      {\n        name: 'avg',\n        description: 'Calculate the average of array elements',\n        signature: 'avg(array)',\n        returnType: 'number',\n        examples: ['avg(scores) // average score'],\n      },\n      {\n        name: 'count',\n        description: 'Get the number of elements in an array',\n        signature: 'count(array)',\n        returnType: 'number',\n        examples: ['count(items) // number of items'],\n      },\n      {\n        name: 'first',\n        description: 'Get the first element of an array',\n        signature: 'first(array)',\n        returnType: 'any',\n        examples: ['first(items) // first item'],\n      },\n      {\n        name: 'last',\n        description: 'Get the last element of an array',\n        signature: 'last(array)',\n        returnType: 'any',\n        examples: ['last(items) // last item'],\n      },\n    ],\n    conversion: [\n      {\n        name: 'tostring',\n        description: 'Convert a value to string',\n        signature: 'tostring(value)',\n        returnType: 'string',\n        examples: ['tostring(42) // \"42\"'],\n      },\n      {\n        name: 'tonumber',\n        description: 'Convert a value to number',\n        signature: 'tonumber(value)',\n        returnType: 'number',\n        examples: ['tonumber(\"42\") // 42'],\n      },\n      {\n        name: 'toboolean',\n        description: 'Convert a value to boolean',\n        signature: 'toboolean(value)',\n        returnType: 'boolean',\n        examples: ['toboolean(1) // true', 'toboolean(0) // false'],\n      },\n    ],\n    conditional: [\n      {\n        name: 'if',\n        description: 'Return one of two values based on a condition',\n        signature: 'if(condition, valueIfTrue, valueIfFalse)',\n        returnType: 'any',\n        examples: [\n          'if(stock > 0, \"Available\", \"Out of Stock\")',\n          'if(price > 100, price * 0.9, price)',\n        ],\n      },\n      {\n        name: 'coalesce',\n        description: 'Return the first non-null value',\n        signature: 'coalesce(value1, value2, ...)',\n        returnType: 'any',\n        examples: ['coalesce(nickname, name, \"Anonymous\")'],\n      },\n    ],\n  },\n\n  features: [\n    {\n      name: 'simple_refs',\n      description: 'Reference top-level fields by name',\n      minVersion: '1.0',\n      examples: ['price', 'quantity', 'baseDamage'],\n      dependenciesExtracted: ['[\"price\"]', '[\"quantity\"]', '[\"baseDamage\"]'],\n    },\n    {\n      name: 'arithmetic',\n      description: 'Basic math operations (+, -, *, /)',\n      minVersion: '1.0',\n      examples: ['price * 1.1', 'a + b - c', 'quantity * price'],\n    },\n    {\n      name: 'comparison',\n      description: 'Compare values (>, <, >=, <=, ==, !=)',\n      minVersion: '1.0',\n      examples: ['price > 100', 'x == 10', 'quantity >= 5'],\n    },\n    {\n      name: 'nested_path',\n      description: 'Access nested object properties using dot notation',\n      minVersion: '1.1',\n      examples: ['stats.damage', 'user.profile.name', 'item.metadata.category'],\n      dependenciesExtracted: ['[\"stats.damage\"]'],\n    },\n    {\n      name: 'array_index',\n      description:\n        'Access array elements by numeric index. Negative indices access from the end',\n      minVersion: '1.1',\n      examples: [\n        'items[0].price',\n        'inventory[1].quantity',\n        'items[-1].name  // last element',\n        'items[-2].price // second to last',\n      ],\n      dependenciesExtracted: ['[\"items[0].price\"]', '[\"items[-1].name\"]'],\n    },\n    {\n      name: 'root_path',\n      description:\n        'Absolute path reference starting with /. Always resolves from root data, even inside array item formulas',\n      minVersion: '1.1',\n      examples: [\n        '/taxRate',\n        '/config.tax',\n        'price * (1 + /taxRate)',\n        'price * /config.multiplier',\n      ],\n      dependenciesExtracted: ['[\"/taxRate\"]', '[\"/config.tax\"]'],\n    },\n    {\n      name: 'relative_path',\n      description:\n        'Relative path reference starting with ../. Resolves from parent context (root data) when inside array item formulas',\n      minVersion: '1.1',\n      examples: [\n        '../discount',\n        '../settings.multiplier',\n        'price * (1 - ../discount)',\n        'price * ../settings.multiplier',\n      ],\n      dependenciesExtracted: ['[\"../discount\"]', '[\"../settings.multiplier\"]'],\n    },\n    {\n      name: 'function_named_fields',\n      description:\n        'Fields can have the same name as built-in functions (max, min, sum, etc.). Built-in functions are always checked first when a function call is made',\n      minVersion: '1.0',\n      examples: [\n        'max(max, 0)',\n        'min(min, 100)',\n        'max(max - field.min, 0)',\n        'round(round * 2)',\n      ],\n    },\n  ],\n\n  versionDetection: [\n    { feature: 'Simple refs, arithmetic, comparisons', minVersion: '1.0' },\n    { feature: 'Function-named fields (max(max, 0))', minVersion: '1.0' },\n    { feature: 'Nested paths (a.b)', minVersion: '1.1' },\n    { feature: 'Array index ([0], [-1])', minVersion: '1.1' },\n    { feature: 'Absolute paths (/field)', minVersion: '1.1' },\n    { feature: 'Relative paths (../field)', minVersion: '1.1' },\n  ],\n\n  parseResult: {\n    description:\n      'The parser automatically detects the minimum required version',\n    interface: `interface ParseResult {\n  ast: ASTNode;           // Abstract syntax tree\n  dependencies: string[]; // List of field dependencies\n  features: string[];     // List of detected features\n  minVersion: string;     // Minimum required version (\"1.0\" or \"1.1\")\n}`,\n  },\n\n  examples: [\n    {\n      expression: 'price * quantity',\n      description: 'Calculate total from price and quantity',\n      result: 'number',\n    },\n    {\n      expression: 'firstName + \" \" + lastName',\n      description: 'Concatenate strings with space',\n      result: 'string',\n    },\n    {\n      expression: 'quantity > 0',\n      description: 'Check if in stock',\n      result: 'boolean',\n    },\n    {\n      expression: 'if(stock > 0, \"Available\", \"Out of Stock\")',\n      description: 'Conditional text based on stock',\n      result: 'string',\n    },\n    {\n      expression: 'price * (1 + taxRate)',\n      description: 'Price with tax',\n      result: 'number',\n    },\n    {\n      expression: 'items[0].price + items[1].price',\n      description: 'Sum first two item prices (v1.1)',\n      result: 'number',\n    },\n  ],\n\n  apiExamples: [\n    {\n      name: 'Simple Expression (v1.0)',\n      description: 'Parse a basic arithmetic expression',\n      code: `parseExpression('price * 1.1')\n// {\n//   minVersion: \"1.0\",\n//   features: [],\n//   dependencies: [\"price\"]\n// }`,\n    },\n    {\n      name: 'Nested Path (v1.1)',\n      description: 'Parse expression with nested object access',\n      code: `parseExpression('stats.damage * multiplier')\n// {\n//   minVersion: \"1.1\",\n//   features: [\"nested_path\"],\n//   dependencies: [\"stats.damage\", \"multiplier\"]\n// }`,\n    },\n    {\n      name: 'Array Access (v1.1)',\n      description: 'Parse expression with array index access',\n      code: `parseExpression('items[0].price + items[1].price')\n// {\n//   minVersion: \"1.1\",\n//   features: [\"array_index\", \"nested_path\"],\n//   dependencies: [\"items[0].price\", \"items[1].price\"]\n// }`,\n    },\n    {\n      name: 'Evaluate expressions',\n      description: 'Execute formulas with context data',\n      code: `evaluate('price * 1.1', { price: 100 })\n// 110\n\nevaluate('stats.damage', { stats: { damage: 50 } })\n// 50\n\nevaluate('items[0].price', { items: [{ price: 10 }] })\n// 10\n\nevaluate('price > 100', { price: 150 })\n// true\n\nevaluate('a + b * c', { a: 1, b: 2, c: 3 })\n// 7`,\n    },\n    {\n      name: 'Function-named fields',\n      description: 'Fields can have the same name as built-in functions',\n      code: `// Built-in functions take precedence in function calls\nevaluate('max(max, 0)', { max: 10 })\n// 10 (max() function, then max field)\n\nevaluate('max(max - field.min, 0)', { max: 100, field: { min: 20 } })\n// 80\n\nevaluate('round(round * 2)', { round: 3.7 })\n// 7\n\n// Field named \"sum\" doesn't conflict with sum() function\nevaluate('sum(values) + sum', { values: [1, 2, 3], sum: 10 })\n// 16`,\n    },\n    {\n      name: 'Evaluate with context (array items)',\n      description:\n        'Use evaluateWithContext() for array item formulas with path resolution',\n      code: `// Absolute path: /field always resolves from root\nevaluateWithContext('price * (1 + /taxRate)', {\n  rootData: { taxRate: 0.1, items: [{ price: 100 }] },\n  itemData: { price: 100 },\n  currentPath: 'items[0]'\n})\n// 110\n\n// Nested absolute path\nevaluateWithContext('price * /config.multiplier', {\n  rootData: { config: { multiplier: 1.5 }, items: [] },\n  itemData: { price: 100 },\n  currentPath: 'items[0]'\n})\n// 150\n\n// Relative path: ../field resolves from parent (root)\nevaluateWithContext('price * (1 - ../discount)', {\n  rootData: { discount: 0.2, items: [] },\n  itemData: { price: 100 },\n  currentPath: 'items[0]'\n})\n// 80\n\n// itemData takes precedence over rootData for same field\nevaluateWithContext('value + 10', {\n  rootData: { value: 100 },\n  itemData: { value: 50 },\n  currentPath: 'items[0]'\n})\n// 60`,\n    },\n  ],\n\n  schemaUsage: {\n    structure:\n      '{ \"x-formula\": { \"version\": 1, \"expression\": \"...\" }, \"readOnly\": true }',\n    fieldTypes: ['string', 'number', 'boolean'],\n    rules: [\n      'Add x-formula to string, number, or boolean field schema',\n      'readOnly: true is REQUIRED for fields with x-formula',\n      'Expression must reference existing fields in the same table',\n      'Circular dependencies are not allowed (a references b, b references a)',\n    ],\n  },\n};\n"]}

package/dist/formula-spec.d.cts

@@ -1,3 +1,10 @@
+interface FunctionSpec {
+    name: string;
+    description: string;
+    signature: string;
+    returnType: 'string' | 'number' | 'boolean' | 'any';
+    examples: string[];
+}
 interface FormulaSpec {
     version: string;
     description: string;
@@ -17,6 +24,14 @@ interface FormulaSpec {
         }[];
         other: string[];
     };
+    functions: {
+        string: FunctionSpec[];
+        numeric: FunctionSpec[];
+        boolean: FunctionSpec[];
+        array: FunctionSpec[];
+        conversion: FunctionSpec[];
+        conditional: FunctionSpec[];
+    };
     features: {
         name: string;
         description: string;
@@ -50,4 +65,4 @@ interface FormulaSpec {
 }
 declare const formulaSpec: FormulaSpec;
 
-export { type FormulaSpec, formulaSpec };
+export { type FormulaSpec, type FunctionSpec, formulaSpec };

package/dist/formula-spec.d.ts

@@ -1,3 +1,10 @@
+interface FunctionSpec {
+    name: string;
+    description: string;
+    signature: string;
+    returnType: 'string' | 'number' | 'boolean' | 'any';
+    examples: string[];
+}
 interface FormulaSpec {
     version: string;
     description: string;
@@ -17,6 +24,14 @@ interface FormulaSpec {
         }[];
         other: string[];
     };
+    functions: {
+        string: FunctionSpec[];
+        numeric: FunctionSpec[];
+        boolean: FunctionSpec[];
+        array: FunctionSpec[];
+        conversion: FunctionSpec[];
+        conditional: FunctionSpec[];
+    };
     features: {
         name: string;
         description: string;
@@ -50,4 +65,4 @@ interface FormulaSpec {
 }
 declare const formulaSpec: FormulaSpec;
 
-export { type FormulaSpec, formulaSpec };
+export { type FormulaSpec, type FunctionSpec, formulaSpec };