@revisium/formula 0.3.0 → 0.5.0

package/README.md

@@ -46,6 +46,13 @@ evaluate('items[0].price + items[1].price', { items: [{ price: 10 }, { price: 20
 evaluate('price > 100', { price: 150 });
 // true
 
+// Fields named like functions
+evaluate('max(max, 0)', { max: 10 });
+// 10 (max() function is called with field "max" as argument)
+
+evaluate('max(max - field.min, 0)', { max: 100, field: { min: 20 } });
+// 80
+
 // Type inference
 import { inferFormulaType } from '@revisium/formula';
 
@@ -72,6 +79,25 @@ validateFormulaAgainstSchema('price * quantity', 'total', schema);
 
 validateFormulaAgainstSchema('price > 100', 'total', schema);
 // { field: 'total', error: "Type mismatch: formula returns 'boolean' but field expects 'number'" }
+
+// Array item formulas with path resolution
+import { evaluateWithContext } from '@revisium/formula';
+
+// Absolute path: /field always resolves from root data
+evaluateWithContext('price * (1 + /taxRate)', {
+  rootData: { taxRate: 0.1, items: [{ price: 100 }] },
+  itemData: { price: 100 },
+  currentPath: 'items[0]'
+});
+// 110
+
+// Relative path: ../field resolves from parent (root)
+evaluateWithContext('price * (1 - ../discount)', {
+  rootData: { discount: 0.2, items: [] },
+  itemData: { price: 100 },
+  currentPath: 'items[0]'
+});
+// 80
 ```
 
 ## API
@@ -83,6 +109,7 @@ validateFormulaAgainstSchema('price > 100', 'total', schema);
 | `parseFormula` | Low-level parser returning AST, dependencies, features |
 | `validateSyntax` | Validate expression syntax |
 | `evaluate` | Evaluate expression with context |
+| `evaluateWithContext` | Evaluate with automatic `/` and `../` path resolution |
 | `inferFormulaType` | Infer return type of expression |
 
 ### Expression API
@@ -116,14 +143,19 @@ validateFormulaAgainstSchema('price > 100', 'total', schema);
 | `obj.field` | Nested object | `stats.damage` |
 | `arr[N]` | Array index | `items[0].price` |
 | `arr[-1]` | Last element | `items[-1]` |
+| `/field` | Absolute path (from root) | `/taxRate`, `/config.tax` |
+| `../field` | Relative path (parent scope) | `../discount`, `../settings.multiplier` |
 
 ## Version Detection
 
 | Feature | Min Version |
 |---------|-------------|
 | Simple refs (`field`) | 1.0 |
+| Function-named fields | 1.0 |
 | Nested paths (`a.b`) | 1.1 |
 | Array index (`[0]`, `[-1]`) | 1.1 |
+| Absolute paths (`/field`) | 1.1 |
+| Relative paths (`../field`) | 1.1 |
 
 ## License