@fieldia/core 0.1.0

package/src/lib/expression/evaluator.mjs

@@ -0,0 +1,118 @@
+/**
+ * AST evaluator for modifiers, ported from the React form engine.
+ *
+ * Python semantics where the React version used JavaScript's: an empty list
+ * or string is false, and an empty value is never smaller or larger than
+ * anything — modifiers come from backends that think in Python.
+ */
+/**
+ * Evaluate an AST node against a context object
+ *
+ * @param ast - The AST node to evaluate
+ * @param context - Object containing field values
+ * @returns The result of evaluation
+ *
+ * @example
+ * const ast = { type: 'BinaryOp', operator: '==', left: {...}, right: {...} };
+ * const context = { state: 'draft', amount: 100 };
+ * evaluate(ast, context); // Returns boolean result
+ */
+export function evaluate(ast, context) {
+    switch (ast.type) {
+        case 'BinaryOp':
+            return evaluateBinaryOp(ast, context);
+        case 'UnaryOp':
+            return evaluateUnaryOp(ast, context);
+        case 'Literal':
+            return ast.value;
+        case 'Identifier':
+            return getNestedValue(context, ast.name);
+        default:
+            throw new Error(`Unknown AST node type: ${ast.type}`);
+    }
+}
+/**
+ * Evaluate binary operations
+ */
+function evaluateBinaryOp(node, context) {
+    const left = normalize(evaluate(node.left, context));
+    const right = normalize(evaluate(node.right, context));
+    const operator = node.operator.toLowerCase();
+    const ordered = left !== null && right !== null;
+    switch (operator) {
+        // Comparison operators
+        case '==':
+            return left === right;
+        case '!=':
+        case '<>':
+            return left !== right;
+        case '<':
+            return ordered && left < right;
+        case '>':
+            return ordered && left > right;
+        case '<=':
+            return ordered && left <= right;
+        case '>=':
+            return ordered && left >= right;
+        // In operators
+        case 'in':
+            return Array.isArray(right) && right.includes(left);
+        case 'not in':
+            return Array.isArray(right) && !right.includes(left);
+        // Logical operators (use truthiness)
+        case 'and':
+            return truthy(left) && truthy(right);
+        case 'or':
+            return truthy(left) || truthy(right);
+        default:
+            throw new Error(`Unknown binary operator: ${node.operator}`);
+    }
+}
+/**
+ * Evaluate unary operations
+ */
+function evaluateUnaryOp(node, context) {
+    const operand = evaluate(node.operand, context);
+    const operator = node.operator.toLowerCase();
+    switch (operator) {
+        case 'not':
+            return !truthy(operand);
+        default:
+            throw new Error(`Unknown unary operator: ${node.operator}`);
+    }
+}
+/** A missing value compares like None. */
+function normalize(value) {
+    return value === undefined ? null : value;
+}
+/** Python's truth test: empty lists, strings and objects, 0 and None are false. */
+export function truthy(value) {
+    if (Array.isArray(value))
+        return value.length > 0;
+    if (value !== null && typeof value === 'object')
+        return Object.keys(value).length > 0;
+    return Boolean(value);
+}
+/**
+ * Get a nested value from an object using dot notation
+ *
+ * @param obj - The object to traverse
+ * @param path - Dot-separated path (e.g., 'partner_id.country_id.name')
+ * @returns The value at the path, or undefined if not found
+ *
+ * @example
+ * getNestedValue({ a: { b: { c: 5 } } }, 'a.b.c') // Returns 5
+ * getNestedValue({ a: null }, 'a.b.c') // Returns undefined
+ */
+function getNestedValue(obj, path) {
+    const parts = path.split('.');
+    let current = obj;
+    for (const part of parts) {
+        if (current === null || current === undefined) {
+            return undefined;
+        }
+        current = current[part];
+    }
+    return current;
+}
+//# sourceMappingURL=evaluator.mjs.map

package/src/lib/expression/evaluator.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluator.mjs","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/expression/evaluator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAY,EAAE,OAAgC;IACrE,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;QACjB,KAAK,UAAU;YACb,OAAO,gBAAgB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAExC,KAAK,SAAS;YACZ,OAAO,eAAe,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAEvC,KAAK,SAAS;YACZ,OAAO,GAAG,CAAC,KAAK,CAAC;QAEnB,KAAK,YAAY;YACf,OAAO,cAAc,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QAE3C;YACE,MAAM,IAAI,KAAK,CAAC,0BAA2B,GAAwB,CAAC,IAAI,EAAE,CAAC,CAAC;IAChF,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CAAC,IAAkB,EAAE,OAAgC;IAC5E,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;IACvD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IAC7C,MAAM,OAAO,GAAG,IAAI,KAAK,IAAI,IAAI,KAAK,KAAK,IAAI,CAAC;IAEhD,QAAQ,QAAQ,EAAE,CAAC;QACjB,uBAAuB;QACvB,KAAK,IAAI;YACP,OAAO,IAAI,KAAK,KAAK,CAAC;QAExB,KAAK,IAAI,CAAC;QACV,KAAK,IAAI;YACP,OAAO,IAAI,KAAK,KAAK,CAAC;QAExB,KAAK,GAAG;YACN,OAAO,OAAO,IAAK,IAAmB,GAAI,KAAoB,CAAC;QAEjE,KAAK,GAAG;YACN,OAAO,OAAO,IAAK,IAAmB,GAAI,KAAoB,CAAC;QAEjE,KAAK,IAAI;YACP,OAAO,OAAO,IAAK,IAAmB,IAAK,KAAoB,CAAC;QAElE,KAAK,IAAI;YACP,OAAO,OAAO,IAAK,IAAmB,IAAK,KAAoB,CAAC;QAElE,eAAe;QACf,KAAK,IAAI;YACP,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEtD,KAAK,QAAQ;YACX,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEvD,qCAAqC;QACrC,KAAK,KAAK;YACR,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;QAEvC,KAAK,IAAI;YACP,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;QAEvC;YACE,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IACjE,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,IAAiB,EAAE,OAAgC;IAC1E,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IAE7C,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,KAAK;YACR,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAE1B;YACE,MAAM,IAAI,KAAK,CAAC,2BAA2B,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IAChE,CAAC;AACH,CAAC;AAKD,0CAA0C;AAC1C,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;AAC5C,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,MAAM,CAAC,KAAc;IACnC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IAClD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IACtF,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC;AACxB,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAS,cAAc,CAAC,GAAY,EAAE,IAAY;IAChD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,OAAO,GAAY,GAAG,CAAC;IAE3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC9C,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,GAAI,OAAmC,CAAC,IAAI,CAAC,CAAC;IACvD,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/src/lib/expression/extractFieldNames.d.mts

@@ -0,0 +1,41 @@
+/**
+ * Extract field names from modifier expressions
+ *
+ * Used to determine which form fields need to be watched for modifier evaluation.
+ * This enables targeted subscriptions instead of watching all form values.
+ *
+ * @example
+ * ```typescript
+ * extractFieldNames("state == 'draft'") // ['state']
+ * extractFieldNames("state == 'draft' and amount > 100") // ['state', 'amount']
+ * extractFieldNames("partner_id.country_id.code == 'US'") // ['partner_id']
+ * extractFieldNames(true) // []
+ * extractFieldNames(undefined) // []
+ * ```
+ */
+/**
+ * Extract all field names referenced in a modifier expression
+ *
+ * @param expression - Modifier expression (string, boolean, or undefined)
+ * @returns Array of root field names to watch
+ */
+export declare function extractFieldNames(expression: string | boolean | undefined): string[];
+/**
+ * Extract all field names from a modifiers object
+ *
+ * @param modifiers - Object containing invisible/readonly/required expressions
+ * @returns Array of unique root field names to watch
+ *
+ * @example
+ * ```typescript
+ * extractFieldNamesFromModifiers({
+ *   invisible: "state == 'draft'",
+ *   readonly: "amount > 100"
+ * }) // ['state', 'amount']
+ * ```
+ */
+export declare function extractFieldNamesFromModifiers(modifiers: Record<string, string | boolean | undefined> | {
+    invisible?: string | boolean;
+    readonly?: string | boolean;
+    required?: string | boolean;
+}): string[];

package/src/lib/expression/extractFieldNames.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Extract field names from modifier expressions
+ *
+ * Used to determine which form fields need to be watched for modifier evaluation.
+ * This enables targeted subscriptions instead of watching all form values.
+ *
+ * @example
+ * ```typescript
+ * extractFieldNames("state == 'draft'") // ['state']
+ * extractFieldNames("state == 'draft' and amount > 100") // ['state', 'amount']
+ * extractFieldNames("partner_id.country_id.code == 'US'") // ['partner_id']
+ * extractFieldNames(true) // []
+ * extractFieldNames(undefined) // []
+ * ```
+ */
+/**
+ * Extract all field names referenced in a modifier expression
+ *
+ * @param expression - Modifier expression (string, boolean, or undefined)
+ * @returns Array of root field names to watch
+ */
+export declare function extractFieldNames(expression: string | boolean | undefined): string[];
+/**
+ * Extract all field names from a modifiers object
+ *
+ * @param modifiers - Object containing invisible/readonly/required expressions
+ * @returns Array of unique root field names to watch
+ *
+ * @example
+ * ```typescript
+ * extractFieldNamesFromModifiers({
+ *   invisible: "state == 'draft'",
+ *   readonly: "amount > 100"
+ * }) // ['state', 'amount']
+ * ```
+ */
+export declare function extractFieldNamesFromModifiers(modifiers: Record<string, string | boolean | undefined> | {
+    invisible?: string | boolean;
+    readonly?: string | boolean;
+    required?: string | boolean;
+}): string[];

package/src/lib/expression/extractFieldNames.js

@@ -0,0 +1,97 @@
+"use strict";
+/**
+ * Extract field names from modifier expressions
+ *
+ * Used to determine which form fields need to be watched for modifier evaluation.
+ * This enables targeted subscriptions instead of watching all form values.
+ *
+ * @example
+ * ```typescript
+ * extractFieldNames("state == 'draft'") // ['state']
+ * extractFieldNames("state == 'draft' and amount > 100") // ['state', 'amount']
+ * extractFieldNames("partner_id.country_id.code == 'US'") // ['partner_id']
+ * extractFieldNames(true) // []
+ * extractFieldNames(undefined) // []
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractFieldNames = extractFieldNames;
+exports.extractFieldNamesFromModifiers = extractFieldNamesFromModifiers;
+const tokenizer_1 = require("./tokenizer");
+/**
+ * Extract all field names referenced in a modifier expression
+ *
+ * @param expression - Modifier expression (string, boolean, or undefined)
+ * @returns Array of root field names to watch
+ */
+function extractFieldNames(expression) {
+    // Non-string expressions don't reference fields
+    if (typeof expression !== 'string' || expression.trim() === '') {
+        return [];
+    }
+    try {
+        const tokens = (0, tokenizer_1.tokenize)(expression);
+        const fields = new Set();
+        // Keywords that look like identifiers but aren't field names
+        const keywords = new Set(['null', 'true', 'false', 'True', 'False', 'None']);
+        tokens.forEach(token => {
+            if (token.type === 'IDENTIFIER') {
+                // Skip literal keywords
+                if (keywords.has(token.value)) {
+                    return;
+                }
+                // For nested fields like 'partner_id.country_id.name',
+                // we only need to watch the root field 'partner_id'
+                const rootField = token.value.split('.')[0];
+                fields.add(rootField);
+            }
+        });
+        return Array.from(fields);
+    }
+    catch {
+        // An expression that cannot be read reads no fields. validatePage reports
+        // it, so a validated page never reaches this branch.
+        return [];
+    }
+}
+// CRITICAL: Cache to prevent creating new arrays when the result is the same
+// WeakMap ensures memory is freed when modifiers object is garbage collected
+const extractionCache = new WeakMap();
+// Stable empty array for when there are no fields to extract
+const EMPTY_FIELDS_ARRAY = Object.freeze([]);
+/**
+ * Extract all field names from a modifiers object
+ *
+ * @param modifiers - Object containing invisible/readonly/required expressions
+ * @returns Array of unique root field names to watch
+ *
+ * @example
+ * ```typescript
+ * extractFieldNamesFromModifiers({
+ *   invisible: "state == 'draft'",
+ *   readonly: "amount > 100"
+ * }) // ['state', 'amount']
+ * ```
+ */
+function extractFieldNamesFromModifiers(modifiers) {
+    // Check cache first for stable reference
+    const cached = extractionCache.get(modifiers);
+    if (cached !== undefined) {
+        return cached;
+    }
+    const allFields = new Set();
+    Object.values(modifiers).forEach(expression => {
+        const fields = extractFieldNames(expression);
+        fields.forEach(field => allFields.add(field));
+    });
+    // Return stable empty array if no fields
+    if (allFields.size === 0) {
+        extractionCache.set(modifiers, EMPTY_FIELDS_ARRAY);
+        return EMPTY_FIELDS_ARRAY;
+    }
+    // Freeze the result array to ensure immutability
+    const result = Object.freeze(Array.from(allFields));
+    extractionCache.set(modifiers, result);
+    return result;
+}
+//# sourceMappingURL=extractFieldNames.js.map

package/src/lib/expression/extractFieldNames.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractFieldNames.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/expression/extractFieldNames.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;AAUH,8CAiCC;AAuBD,wEA0BC;AA1FD,2CAAuC;AAEvC;;;;;GAKG;AACH,SAAgB,iBAAiB,CAAC,UAAwC;IACxE,gDAAgD;IAChD,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC/D,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAA,oBAAQ,EAAC,UAAU,CAAC,CAAC;QACpC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;QAEjC,6DAA6D;QAC7D,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;QAE7E,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;YACrB,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBAChC,wBAAwB;gBACxB,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC9B,OAAO;gBACT,CAAC;gBAED,uDAAuD;gBACvD,oDAAoD;gBACpD,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC5C,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACxB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,0EAA0E;QAC1E,qDAAqD;QACrD,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,6EAA6E;AAC7E,6EAA6E;AAC7E,MAAM,eAAe,GAAG,IAAI,OAAO,EAAoB,CAAC;AAExD,6DAA6D;AAC7D,MAAM,kBAAkB,GAAa,MAAM,CAAC,MAAM,CAAC,EAAE,CAAwB,CAAC;AAE9E;;;;;;;;;;;;;GAaG;AACH,SAAgB,8BAA8B,CAC5C,SAAoJ;IAEpJ,yCAAyC;IACzC,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC9C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IAEpC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE;QAC5C,MAAM,MAAM,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;QAC7C,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,yCAAyC;IACzC,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACzB,eAAe,CAAC,GAAG,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;QACnD,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAED,iDAAiD;IACjD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAa,CAAC;IAChE,eAAe,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACvC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/src/lib/expression/extractFieldNames.mjs

@@ -0,0 +1,93 @@
+/**
+ * Extract field names from modifier expressions
+ *
+ * Used to determine which form fields need to be watched for modifier evaluation.
+ * This enables targeted subscriptions instead of watching all form values.
+ *
+ * @example
+ * ```typescript
+ * extractFieldNames("state == 'draft'") // ['state']
+ * extractFieldNames("state == 'draft' and amount > 100") // ['state', 'amount']
+ * extractFieldNames("partner_id.country_id.code == 'US'") // ['partner_id']
+ * extractFieldNames(true) // []
+ * extractFieldNames(undefined) // []
+ * ```
+ */
+import { tokenize } from './tokenizer.mjs';
+/**
+ * Extract all field names referenced in a modifier expression
+ *
+ * @param expression - Modifier expression (string, boolean, or undefined)
+ * @returns Array of root field names to watch
+ */
+export function extractFieldNames(expression) {
+    // Non-string expressions don't reference fields
+    if (typeof expression !== 'string' || expression.trim() === '') {
+        return [];
+    }
+    try {
+        const tokens = tokenize(expression);
+        const fields = new Set();
+        // Keywords that look like identifiers but aren't field names
+        const keywords = new Set(['null', 'true', 'false', 'True', 'False', 'None']);
+        tokens.forEach(token => {
+            if (token.type === 'IDENTIFIER') {
+                // Skip literal keywords
+                if (keywords.has(token.value)) {
+                    return;
+                }
+                // For nested fields like 'partner_id.country_id.name',
+                // we only need to watch the root field 'partner_id'
+                const rootField = token.value.split('.')[0];
+                fields.add(rootField);
+            }
+        });
+        return Array.from(fields);
+    }
+    catch {
+        // An expression that cannot be read reads no fields. validatePage reports
+        // it, so a validated page never reaches this branch.
+        return [];
+    }
+}
+// CRITICAL: Cache to prevent creating new arrays when the result is the same
+// WeakMap ensures memory is freed when modifiers object is garbage collected
+const extractionCache = new WeakMap();
+// Stable empty array for when there are no fields to extract
+const EMPTY_FIELDS_ARRAY = Object.freeze([]);
+/**
+ * Extract all field names from a modifiers object
+ *
+ * @param modifiers - Object containing invisible/readonly/required expressions
+ * @returns Array of unique root field names to watch
+ *
+ * @example
+ * ```typescript
+ * extractFieldNamesFromModifiers({
+ *   invisible: "state == 'draft'",
+ *   readonly: "amount > 100"
+ * }) // ['state', 'amount']
+ * ```
+ */
+export function extractFieldNamesFromModifiers(modifiers) {
+    // Check cache first for stable reference
+    const cached = extractionCache.get(modifiers);
+    if (cached !== undefined) {
+        return cached;
+    }
+    const allFields = new Set();
+    Object.values(modifiers).forEach(expression => {
+        const fields = extractFieldNames(expression);
+        fields.forEach(field => allFields.add(field));
+    });
+    // Return stable empty array if no fields
+    if (allFields.size === 0) {
+        extractionCache.set(modifiers, EMPTY_FIELDS_ARRAY);
+        return EMPTY_FIELDS_ARRAY;
+    }
+    // Freeze the result array to ensure immutability
+    const result = Object.freeze(Array.from(allFields));
+    extractionCache.set(modifiers, result);
+    return result;
+}
+//# sourceMappingURL=extractFieldNames.mjs.map

package/src/lib/expression/extractFieldNames.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractFieldNames.mjs","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/expression/extractFieldNames.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAAwC;IACxE,gDAAgD;IAChD,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC/D,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;QACpC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;QAEjC,6DAA6D;QAC7D,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;QAE7E,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;YACrB,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBAChC,wBAAwB;gBACxB,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC9B,OAAO;gBACT,CAAC;gBAED,uDAAuD;gBACvD,oDAAoD;gBACpD,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC5C,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACxB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,0EAA0E;QAC1E,qDAAqD;QACrD,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,6EAA6E;AAC7E,6EAA6E;AAC7E,MAAM,eAAe,GAAG,IAAI,OAAO,EAAoB,CAAC;AAExD,6DAA6D;AAC7D,MAAM,kBAAkB,GAAa,MAAM,CAAC,MAAM,CAAC,EAAE,CAAwB,CAAC;AAE9E;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,8BAA8B,CAC5C,SAAoJ;IAEpJ,yCAAyC;IACzC,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC9C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IAEpC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE;QAC5C,MAAM,MAAM,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;QAC7C,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,yCAAyC;IACzC,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACzB,eAAe,CAAC,GAAG,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;QACnD,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAED,iDAAiD;IACjD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAa,CAAC;IAChE,eAAe,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACvC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/src/lib/expression/modifier.d.mts

@@ -0,0 +1,14 @@
+import type { Modifier } from '../format/layout.mjs';
+/** A modifier read once, ready to evaluate against a record's values. */
+export interface CompiledModifier {
+    readonly source: Modifier | undefined;
+    /** The fields it reads, by their first name, in order of appearance. */
+    readonly fields: readonly string[];
+    evaluate(values: Readonly<Record<string, unknown>>): boolean;
+}
+/**
+ * Read a modifier. `true`, `false` and a missing modifier become constants;
+ * an expression is parsed now, so a mistake surfaces here and not on the
+ * first keystroke. Throws when the expression cannot be read.
+ */
+export declare function compileModifier(modifier: Modifier | undefined): CompiledModifier;

package/src/lib/expression/modifier.d.ts

@@ -0,0 +1,14 @@
+import type { Modifier } from '../format/layout';
+/** A modifier read once, ready to evaluate against a record's values. */
+export interface CompiledModifier {
+    readonly source: Modifier | undefined;
+    /** The fields it reads, by their first name, in order of appearance. */
+    readonly fields: readonly string[];
+    evaluate(values: Readonly<Record<string, unknown>>): boolean;
+}
+/**
+ * Read a modifier. `true`, `false` and a missing modifier become constants;
+ * an expression is parsed now, so a mistake surfaces here and not on the
+ * first keystroke. Throws when the expression cannot be read.
+ */
+export declare function compileModifier(modifier: Modifier | undefined): CompiledModifier;

package/src/lib/expression/modifier.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compileModifier = compileModifier;
+const evaluator_1 = require("./evaluator");
+const parser_1 = require("./parser");
+const tokenizer_1 = require("./tokenizer");
+/**
+ * Read a modifier. `true`, `false` and a missing modifier become constants;
+ * an expression is parsed now, so a mistake surfaces here and not on the
+ * first keystroke. Throws when the expression cannot be read.
+ */
+function compileModifier(modifier) {
+    if (typeof modifier !== 'string') {
+        const value = modifier === true;
+        return { source: modifier, fields: [], evaluate: () => value };
+    }
+    const ast = new parser_1.ExpressionParser((0, tokenizer_1.tokenize)(modifier)).parse();
+    return {
+        source: modifier,
+        fields: fieldsRead(ast),
+        evaluate(values) {
+            try {
+                return (0, evaluator_1.truthy)((0, evaluator_1.evaluate)(ast, values));
+            }
+            catch {
+                return false;
+            }
+        },
+    };
+}
+function fieldsRead(ast) {
+    const names = [];
+    const visit = (node) => {
+        switch (node.type) {
+            case 'Identifier': {
+                const root = node.name.split('.')[0];
+                if (!names.includes(root))
+                    names.push(root);
+                return;
+            }
+            case 'BinaryOp':
+                visit(node.left);
+                visit(node.right);
+                return;
+            case 'UnaryOp':
+                visit(node.operand);
+                return;
+            default:
+                return;
+        }
+    };
+    visit(ast);
+    return names;
+}
+//# sourceMappingURL=modifier.js.map

package/src/lib/expression/modifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modifier.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/expression/modifier.ts"],"names":[],"mappings":";;AAkBA,0CAiBC;AAlCD,2CAA+C;AAC/C,qCAA0D;AAC1D,2CAAuC;AAUvC;;;;GAIG;AACH,SAAgB,eAAe,CAAC,QAA8B;IAC5D,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,QAAQ,KAAK,IAAI,CAAC;QAChC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC;IACjE,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,yBAAgB,CAAC,IAAA,oBAAQ,EAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;IAC7D,OAAO;QACL,MAAM,EAAE,QAAQ;QAChB,MAAM,EAAE,UAAU,CAAC,GAAG,CAAC;QACvB,QAAQ,CAAC,MAAM;YACb,IAAI,CAAC;gBACH,OAAO,IAAA,kBAAM,EAAC,IAAA,oBAAQ,EAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;YACvC,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,GAAY;IAC9B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,CAAC,IAAa,EAAQ,EAAE;QACpC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,KAAK,YAAY,CAAC,CAAC,CAAC;gBAClB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBACrC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;oBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC5C,OAAO;YACT,CAAC;YACD,KAAK,UAAU;gBACb,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACjB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAClB,OAAO;YACT,KAAK,SAAS;gBACZ,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACpB,OAAO;YACT;gBACE,OAAO;QACX,CAAC;IACH,CAAC,CAAC;IACF,KAAK,CAAC,GAAG,CAAC,CAAC;IACX,OAAO,KAAK,CAAC;AACf,CAAC"}

package/src/lib/expression/modifier.mjs

@@ -0,0 +1,52 @@
+import { evaluate, truthy } from './evaluator.mjs';
+import { ExpressionParser } from './parser.mjs';
+import { tokenize } from './tokenizer.mjs';
+/**
+ * Read a modifier. `true`, `false` and a missing modifier become constants;
+ * an expression is parsed now, so a mistake surfaces here and not on the
+ * first keystroke. Throws when the expression cannot be read.
+ */
+export function compileModifier(modifier) {
+    if (typeof modifier !== 'string') {
+        const value = modifier === true;
+        return { source: modifier, fields: [], evaluate: () => value };
+    }
+    const ast = new ExpressionParser(tokenize(modifier)).parse();
+    return {
+        source: modifier,
+        fields: fieldsRead(ast),
+        evaluate(values) {
+            try {
+                return truthy(evaluate(ast, values));
+            }
+            catch {
+                return false;
+            }
+        },
+    };
+}
+function fieldsRead(ast) {
+    const names = [];
+    const visit = (node) => {
+        switch (node.type) {
+            case 'Identifier': {
+                const root = node.name.split('.')[0];
+                if (!names.includes(root))
+                    names.push(root);
+                return;
+            }
+            case 'BinaryOp':
+                visit(node.left);
+                visit(node.right);
+                return;
+            case 'UnaryOp':
+                visit(node.operand);
+                return;
+            default:
+                return;
+        }
+    };
+    visit(ast);
+    return names;
+}
+//# sourceMappingURL=modifier.mjs.map

package/src/lib/expression/modifier.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"modifier.mjs","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/expression/modifier.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAgB,MAAM,UAAU,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAUvC;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,QAA8B;IAC5D,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,QAAQ,KAAK,IAAI,CAAC;QAChC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC;IACjE,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;IAC7D,OAAO;QACL,MAAM,EAAE,QAAQ;QAChB,MAAM,EAAE,UAAU,CAAC,GAAG,CAAC;QACvB,QAAQ,CAAC,MAAM;YACb,IAAI,CAAC;gBACH,OAAO,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;YACvC,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,GAAY;IAC9B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,CAAC,IAAa,EAAQ,EAAE;QACpC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,KAAK,YAAY,CAAC,CAAC,CAAC;gBAClB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBACrC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;oBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC5C,OAAO;YACT,CAAC;YACD,KAAK,UAAU;gBACb,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACjB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAClB,OAAO;YACT,KAAK,SAAS;gBACZ,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACpB,OAAO;YACT;gBACE,OAAO;QACX,CAAC;IACH,CAAC,CAAC;IACF,KAAK,CAAC,GAAG,CAAC,CAAC;IACX,OAAO,KAAK,CAAC;AACf,CAAC"}

package/src/lib/expression/parser.d.mts

@@ -0,0 +1,109 @@
+/**
+ * Expression parser for modifiers, ported from the React form engine.
+ *
+ * Recursive descent parser that converts tokens into an Abstract Syntax Tree (AST).
+ * Implements Python-like operator precedence:
+ *   1. OR (lowest precedence)
+ *   2. AND
+ *   3. NOT
+ *   4. Comparison operators (==, !=, <, >, <=, >=, in, not in)
+ *   5. Values/Identifiers (highest precedence)
+ */
+import { type Token } from './tokenizer.mjs';
+/**
+ * AST Node Types
+ */
+export type ASTNode = BinaryOpNode | UnaryOpNode | LiteralNode | IdentifierNode;
+export interface BinaryOpNode {
+    type: 'BinaryOp';
+    operator: string;
+    left: ASTNode;
+    right: ASTNode;
+}
+export interface UnaryOpNode {
+    type: 'UnaryOp';
+    operator: string;
+    operand: ASTNode;
+}
+export interface LiteralNode {
+    type: 'Literal';
+    value: unknown;
+}
+export interface IdentifierNode {
+    type: 'Identifier';
+    name: string;
+}
+/**
+ * Recursive Descent Expression Parser
+ */
+export declare class ExpressionParser {
+    private tokens;
+    private position;
+    constructor(tokens: Token[]);
+    /**
+     * Parse tokens into an AST
+     */
+    parse(): ASTNode;
+    /**
+     * Parse OR expressions (lowest precedence)
+     * or_expr: and_expr ('or' and_expr)*
+     */
+    private parseOr;
+    /**
+     * Parse AND expressions
+     * and_expr: not_expr ('and' not_expr)*
+     */
+    private parseAnd;
+    /**
+     * Parse NOT expressions
+     * not_expr: 'not' comparison | comparison
+     */
+    private parseNot;
+    /**
+     * Parse comparison expressions
+     * comparison: value (comp_op value)?
+     * comp_op: '==' | '!=' | '<>' | '<' | '>' | '<=' | '>=' | 'in' | 'not in'
+     */
+    private parseComparison;
+    /**
+     * Parse value expressions (highest precedence)
+     * value: '(' or_expr ')' | literal | identifier
+     */
+    private parseValue;
+    /**
+     * Check if current token matches any of the given types/values
+     */
+    private match;
+    /**
+     * Match logical operators (case-insensitive)
+     */
+    private matchLogical;
+    /**
+     * Match comparison operators (case-insensitive)
+     */
+    private matchOperator;
+    /**
+     * Check if current token has given type
+     */
+    private check;
+    /**
+     * Consume current token and advance
+     */
+    private advance;
+    /**
+     * Get current token without advancing
+     */
+    private peek;
+    /**
+     * Get previous token
+     */
+    private previous;
+    /**
+     * Check if we've consumed all tokens
+     */
+    private isAtEnd;
+    /**
+     * Consume a token of specific type/value or throw error
+     */
+    private consume;
+}