@revisium/formula 0.2.1 → 0.4.0

package/dist/formula-spec.js

@@ -31,10 +31,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: [
@@ -75,12 +366,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",
@@ -108,7 +437,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"
     },
@@ -171,6 +500,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: {
@@ -180,8 +561,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.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/formula-spec.ts"],"names":[],"mappings":"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","file":"formula-spec.js","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.js","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/{index-DO2EZ7U6.d.cts → index-JZFJ9oT6.d.cts}

@@ -57,6 +57,12 @@ declare function validateSyntax(expression: string): {
     position?: number;
 };
 declare function evaluate(expression: string, context: Record<string, unknown>): unknown;
+interface EvaluateContextOptions {
+    rootData: Record<string, unknown>;
+    itemData?: Record<string, unknown>;
+    currentPath?: string;
+}
+declare function evaluateWithContext(expression: string, options: EvaluateContextOptions): unknown;
 type InferredType = 'number' | 'boolean' | 'string' | 'unknown';
 interface FieldTypes {
     [fieldName: string]: 'number' | 'string' | 'boolean' | 'object' | 'array';
@@ -87,11 +93,14 @@ interface XFormulaInput {
 interface SchemaProperty {
     type?: string;
     'x-formula'?: XFormulaInput;
+    properties?: Record<string, SchemaProperty>;
+    items?: SchemaProperty;
     [key: string]: unknown;
 }
 interface JsonSchema {
     type?: string;
     properties?: Record<string, SchemaProperty>;
+    items?: SchemaProperty;
     [key: string]: unknown;
 }
 interface ExtractedFormula {
@@ -113,4 +122,4 @@ interface SchemaValidationResult {
 declare function validateFormulaAgainstSchema(expression: string, fieldName: string, schema: JsonSchema): FormulaValidationError | null;
 declare function validateSchemaFormulas(schema: JsonSchema): SchemaValidationResult;
 
-export { type ASTNode as A, type ExtractedFormula as E, type FieldTypes as F, type InferredType as I, type JsonSchema as J, type ParseResult as P, type SyntaxValidationResult as S, type XFormula as X, parseExpression as a, type ParsedExpression as b, validateFormulaSyntax as c, extractSchemaFormulas as d, evaluate as e, validateFormulaAgainstSchema as f, validateSchemaFormulas as g, type FormulaValidationError as h, inferFormulaType as i, type SchemaValidationResult as j, type FormulaMinorVersion as k, type FormulaFeature as l, type FormulaAnalysis as m, type PathSegment as n, type ParsedPath as o, parseFormula as p, type PathValidationResult as q, type FormulaContext as r, type FormulaResult as s, validateSyntax as v };
+export { type ASTNode as A, type EvaluateContextOptions as E, type FieldTypes as F, type InferredType as I, type JsonSchema as J, type ParseResult as P, type SyntaxValidationResult as S, type XFormula as X, evaluateWithContext as a, parseExpression as b, type ParsedExpression as c, validateFormulaSyntax as d, evaluate as e, extractSchemaFormulas as f, type ExtractedFormula as g, validateFormulaAgainstSchema as h, inferFormulaType as i, validateSchemaFormulas as j, type FormulaValidationError as k, type SchemaValidationResult as l, type FormulaMinorVersion as m, type FormulaFeature as n, type FormulaAnalysis as o, parseFormula as p, type PathSegment as q, type ParsedPath as r, type PathValidationResult as s, type FormulaContext as t, type FormulaResult as u, validateSyntax as v };

package/dist/{index-DO2EZ7U6.d.ts → index-JZFJ9oT6.d.ts}

@@ -57,6 +57,12 @@ declare function validateSyntax(expression: string): {
     position?: number;
 };
 declare function evaluate(expression: string, context: Record<string, unknown>): unknown;
+interface EvaluateContextOptions {
+    rootData: Record<string, unknown>;
+    itemData?: Record<string, unknown>;
+    currentPath?: string;
+}
+declare function evaluateWithContext(expression: string, options: EvaluateContextOptions): unknown;
 type InferredType = 'number' | 'boolean' | 'string' | 'unknown';
 interface FieldTypes {
     [fieldName: string]: 'number' | 'string' | 'boolean' | 'object' | 'array';
@@ -87,11 +93,14 @@ interface XFormulaInput {
 interface SchemaProperty {
     type?: string;
     'x-formula'?: XFormulaInput;
+    properties?: Record<string, SchemaProperty>;
+    items?: SchemaProperty;
     [key: string]: unknown;
 }
 interface JsonSchema {
     type?: string;
     properties?: Record<string, SchemaProperty>;
+    items?: SchemaProperty;
     [key: string]: unknown;
 }
 interface ExtractedFormula {
@@ -113,4 +122,4 @@ interface SchemaValidationResult {
 declare function validateFormulaAgainstSchema(expression: string, fieldName: string, schema: JsonSchema): FormulaValidationError | null;
 declare function validateSchemaFormulas(schema: JsonSchema): SchemaValidationResult;
 
-export { type ASTNode as A, type ExtractedFormula as E, type FieldTypes as F, type InferredType as I, type JsonSchema as J, type ParseResult as P, type SyntaxValidationResult as S, type XFormula as X, parseExpression as a, type ParsedExpression as b, validateFormulaSyntax as c, extractSchemaFormulas as d, evaluate as e, validateFormulaAgainstSchema as f, validateSchemaFormulas as g, type FormulaValidationError as h, inferFormulaType as i, type SchemaValidationResult as j, type FormulaMinorVersion as k, type FormulaFeature as l, type FormulaAnalysis as m, type PathSegment as n, type ParsedPath as o, parseFormula as p, type PathValidationResult as q, type FormulaContext as r, type FormulaResult as s, validateSyntax as v };
+export { type ASTNode as A, type EvaluateContextOptions as E, type FieldTypes as F, type InferredType as I, type JsonSchema as J, type ParseResult as P, type SyntaxValidationResult as S, type XFormula as X, evaluateWithContext as a, parseExpression as b, type ParsedExpression as c, validateFormulaSyntax as d, evaluate as e, extractSchemaFormulas as f, type ExtractedFormula as g, validateFormulaAgainstSchema as h, inferFormulaType as i, validateSchemaFormulas as j, type FormulaValidationError as k, type SchemaValidationResult as l, type FormulaMinorVersion as m, type FormulaFeature as n, type FormulaAnalysis as o, parseFormula as p, type PathSegment as q, type ParsedPath as r, type PathValidationResult as s, type FormulaContext as t, type FormulaResult as u, validateSyntax as v };