@fogpipe/forma-core 0.12.0 → 0.13.0

package/dist/engine/required.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"required.d.ts","sourceRoot":"","sources":["../../src/engine/required.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,KAAK,EACL,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,aAAa,CAAC;AAOrB,MAAM,WAAW,eAAe;IAC9B,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,EAAE,KAAK,EACX,OAAO,GAAE,eAAoB,GAC5B,oBAAoB,CAgDtB;AAMD;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,eAAe,EACzB,IAAI,EAAE,KAAK,EACX,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAQT;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACxB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,EAAE,KAAK,GACV,OAAO,CAcT"}
+{"version":3,"file":"required.d.ts","sourceRoot":"","sources":["../../src/engine/required.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,KAAK,EACL,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,aAAa,CAAC;AAOrB,MAAM,WAAW,eAAe;IAC9B,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,EAAE,KAAK,EACX,OAAO,GAAE,eAAoB,GAC5B,oBAAoB,CAkDtB;AAMD;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,eAAe,EACzB,IAAI,EAAE,KAAK,EACX,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAQT;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACxB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,EAAE,KAAK,GACV,OAAO,CAcT"}

package/dist/engine/validate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/engine/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EACV,KAAK,EAKL,gBAAgB,EAChB,UAAU,EAEX,MAAM,aAAa,CAAC;AASrB,MAAM,WAAW,eAAe;IAC9B,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,gCAAgC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,mDAAmD;IACnD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,EAAE,KAAK,EACX,OAAO,GAAE,eAAoB,GAC5B,gBAAgB,CAkDlB;AAkiBD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,EAAE,KAAK,GACV,UAAU,EAAE,CAqBd"}
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/engine/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EACV,KAAK,EAKL,gBAAgB,EAChB,UAAU,EAEX,MAAM,aAAa,CAAC;AASrB,MAAM,WAAW,eAAe;IAC9B,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,gCAAgC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,mDAAmD;IACnD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,EAAE,KAAK,EACX,OAAO,GAAE,eAAoB,GAC5B,gBAAgB,CAmDlB;AAsjBD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,EAAE,KAAK,GACV,UAAU,EAAE,CAqBd"}

package/dist/engine/visibility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"visibility.d.ts","sourceRoot":"","sources":["../../src/engine/visibility.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,KAAK,EAIL,gBAAgB,EAChB,YAAY,EACb,MAAM,aAAa,CAAC;AAQrB,MAAM,WAAW,iBAAiB;IAChC,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,YAAY,EAAE,CAAC;CACvD;AA0DD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,EAAE,KAAK,EACX,OAAO,GAAE,iBAAsB,GAC9B,gBAAgB,CAmBlB;AA8DD;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,EAAE,KAAK,EACX,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAkBT;AAMD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,EAAE,KAAK,EACX,OAAO,GAAE,iBAAsB,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAuBzB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,EAAE,KAAK,EACX,OAAO,GAAE,iBAAsB,GAC9B,uBAAuB,CA6BzB;AAMD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,YAAY,EAAE,GAAG,SAAS,EACnC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,EAAE,KAAK,EACX,OAAO,GAAE;IACP,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;CACf,GACL,YAAY,EAAE,CAchB"}
+{"version":3,"file":"visibility.d.ts","sourceRoot":"","sources":["../../src/engine/visibility.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,KAAK,EAIL,gBAAgB,EAChB,YAAY,EACb,MAAM,aAAa,CAAC;AAQrB,MAAM,WAAW,iBAAiB;IAChC,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,YAAY,EAAE,CAAC;CACvD;AAmED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,EAAE,KAAK,EACX,OAAO,GAAE,iBAAsB,GAC9B,gBAAgB,CAmBlB;AAmED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,EAAE,KAAK,EACX,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAkBT;AAMD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,EAAE,KAAK,EACX,OAAO,GAAE,iBAAsB,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAuBzB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,EAAE,KAAK,EACX,OAAO,GAAE,iBAAsB,GAC9B,uBAAuB,CAuCzB;AAMD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,YAAY,EAAE,GAAG,SAAS,EACnC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,EAAE,KAAK,EACX,OAAO,GAAE;IACP,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;CACf,GACL,YAAY,EAAE,CAchB"}

package/dist/feel/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/feel/index.ts"],"sourcesContent":["/**\n * FEEL Expression Evaluator\n *\n * Wraps the feelin library to provide FEEL expression evaluation\n * with Forma context conventions.\n *\n * Context variable conventions:\n * - `fieldName` - Direct field value access\n * - `computed.name` - Computed value access\n * - `ref.path` - Reference data lookup (external lookup tables)\n * - `item.fieldName` - Array item field access (within array context)\n * - `itemIndex` - Current array item index (0-based)\n * - `value` - Current field value (in validation expressions)\n */\n\nimport { evaluate as feelinEvaluate } from \"feelin\";\nimport type { EvaluationContext, FEELExpression } from \"../types.js\";\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface EvaluateResult<T = unknown> {\n  success: true;\n  value: T;\n}\n\nexport interface EvaluateError {\n  success: false;\n  error: string;\n  expression: string;\n}\n\nexport type EvaluationOutcome<T = unknown> = EvaluateResult<T> | EvaluateError;\n\n// ============================================================================\n// Context Building\n// ============================================================================\n\n/**\n * Build the FEEL evaluation context from our EvaluationContext\n *\n * Maps our context conventions to feelin context format:\n * - Form data fields are spread directly\n * - computed becomes an object (accessed as computed.fieldName)\n * - ref becomes an object for reference data (accessed as ref.path.to.data)\n * - item becomes an object for array context (accessed as item.fieldName)\n * - itemIndex is a number for array context\n * - value is the current field value\n */\nfunction buildFeelContext(ctx: EvaluationContext): Record<string, unknown> {\n  const feelContext: Record<string, unknown> = {\n    // Spread form data directly so fields are accessible by name\n    ...ctx.data,\n  };\n\n  // Add computed values under 'computed' (accessed as computed.fieldName)\n  if (ctx.computed) {\n    feelContext[\"computed\"] = ctx.computed;\n  }\n\n  // Add reference data under 'ref' (accessed as ref.path.to.data)\n  if (ctx.referenceData) {\n    feelContext[\"ref\"] = ctx.referenceData;\n  }\n\n  // Add array item context (accessed as item.fieldName)\n  if (ctx.item !== undefined) {\n    feelContext[\"item\"] = ctx.item;\n  }\n\n  // Add array index\n  if (ctx.itemIndex !== undefined) {\n    feelContext[\"itemIndex\"] = ctx.itemIndex;\n  }\n\n  // Add current field value for validation expressions\n  if (ctx.value !== undefined) {\n    feelContext[\"value\"] = ctx.value;\n  }\n\n  return feelContext;\n}\n\n// ============================================================================\n// Expression Evaluation\n// ============================================================================\n\n/**\n * Evaluate a FEEL expression and return the result\n *\n * @param expression - FEEL expression string\n * @param context - Evaluation context with form data, computed values, etc.\n * @returns Evaluation outcome with success/value or error\n *\n * @example\n * // Simple field comparison\n * evaluate(\"age >= 18\", { data: { age: 21 } })\n * // => { success: true, value: true }\n *\n * @example\n * // Computed value reference\n * evaluate(\"computed.bmi > 30\", { data: {}, computed: { bmi: 32.5 } })\n * // => { success: true, value: true }\n *\n * @example\n * // Array item context\n * evaluate(\"item.frequency = \\\"daily\\\"\", { data: {}, item: { frequency: \"daily\" } })\n * // => { success: true, value: true }\n */\nexport function evaluate<T = unknown>(\n  expression: FEELExpression,\n  context: EvaluationContext\n): EvaluationOutcome<T> {\n  try {\n    const feelContext = buildFeelContext(context);\n    const result = feelinEvaluate(expression, feelContext);\n    return {\n      success: true,\n      value: result as T,\n    };\n  } catch (error) {\n    return {\n      success: false,\n      error: error instanceof Error ? error.message : String(error),\n      expression,\n    };\n  }\n}\n\n/**\n * Evaluate a FEEL expression expecting a boolean result\n *\n * Used for visibility, required, and enabled conditions.\n * Returns false on error or non-boolean result for safety.\n *\n * @param expression - FEEL expression that should return boolean\n * @param context - Evaluation context\n * @returns Boolean result (false on error)\n */\nexport function evaluateBoolean(\n  expression: FEELExpression,\n  context: EvaluationContext\n): boolean {\n  const result = evaluate<boolean>(expression, context);\n\n  if (!result.success) {\n    console.warn(\n      `FEEL expression error: ${result.error}\\nExpression: ${result.expression}`\n    );\n    return false;\n  }\n\n  // FEEL uses three-valued logic where comparisons with null return null.\n  // For form visibility/required/enabled conditions, we treat null as false.\n  //\n  // Common causes of null results:\n  // - \"fieldName = true\" when fieldName is undefined → null (not false!)\n  // - \"fieldName != null\" when fieldName is undefined → null (not true!)\n  // - \"computed.x = true\" when x is null → null\n  //\n  // Null-safe alternatives:\n  // - Check if boolean answered: \"fieldName = true or fieldName = false\"\n  // - Check if explicitly false: \"fieldName != true\" (true when undefined OR false)\n  // - String length: \"fieldName != null and string length(fieldName) > 0\"\n  if (result.value === null || result.value === undefined) {\n    console.warn(\n      `[forma] FEEL expression returned null (treating as false): \"${expression}\"\\n` +\n        `This often means a referenced field is undefined. See docs for null-safe patterns.`\n    );\n    return false;\n  }\n\n  if (typeof result.value !== \"boolean\") {\n    console.warn(\n      `FEEL expression did not return boolean: ${expression}\\nGot: ${typeof result.value}`\n    );\n    return false;\n  }\n\n  return result.value;\n}\n\n/**\n * Evaluate a FEEL expression expecting a numeric result\n *\n * Used for computed values that return numbers.\n *\n * @param expression - FEEL expression that should return number\n * @param context - Evaluation context\n * @returns Numeric result or null on error\n */\nexport function evaluateNumber(\n  expression: FEELExpression,\n  context: EvaluationContext\n): number | null {\n  const result = evaluate<number>(expression, context);\n\n  if (!result.success) {\n    console.warn(\n      `FEEL expression error: ${result.error}\\nExpression: ${result.expression}`\n    );\n    return null;\n  }\n\n  if (typeof result.value !== \"number\") {\n    console.warn(\n      `FEEL expression did not return number: ${expression}\\nGot: ${typeof result.value}`\n    );\n    return null;\n  }\n\n  return result.value;\n}\n\n/**\n * Evaluate a FEEL expression expecting a string result\n *\n * @param expression - FEEL expression that should return string\n * @param context - Evaluation context\n * @returns String result or null on error\n */\nexport function evaluateString(\n  expression: FEELExpression,\n  context: EvaluationContext\n): string | null {\n  const result = evaluate<string>(expression, context);\n\n  if (!result.success) {\n    console.warn(\n      `FEEL expression error: ${result.error}\\nExpression: ${result.expression}`\n    );\n    return null;\n  }\n\n  if (typeof result.value !== \"string\") {\n    console.warn(\n      `FEEL expression did not return string: ${expression}\\nGot: ${typeof result.value}`\n    );\n    return null;\n  }\n\n  return result.value;\n}\n\n// ============================================================================\n// Batch Evaluation\n// ============================================================================\n\n/**\n * Evaluate multiple FEEL expressions at once\n *\n * Useful for evaluating all visibility conditions in a form.\n *\n * @param expressions - Map of field names to FEEL expressions\n * @param context - Evaluation context\n * @returns Map of field names to boolean results\n */\nexport function evaluateBooleanBatch(\n  expressions: Record<string, FEELExpression>,\n  context: EvaluationContext\n): Record<string, boolean> {\n  const results: Record<string, boolean> = {};\n\n  for (const [key, expression] of Object.entries(expressions)) {\n    results[key] = evaluateBoolean(expression, context);\n  }\n\n  return results;\n}\n\n// ============================================================================\n// Expression Validation\n// ============================================================================\n\n/**\n * Check if a FEEL expression is syntactically valid\n *\n * @param expression - FEEL expression to validate\n * @returns True if the expression can be parsed\n */\nexport function isValidExpression(expression: FEELExpression): boolean {\n  try {\n    // Try to evaluate with empty context - we just want to check parsing\n    feelinEvaluate(expression, {});\n    return true;\n  } catch {\n    // Expression failed to parse or evaluate\n    return false;\n  }\n}\n\n/**\n * Validate a FEEL expression and return any parsing errors\n *\n * @param expression - FEEL expression to validate\n * @returns Null if valid, error message if invalid\n */\nexport function validateExpression(expression: FEELExpression): string | null {\n  try {\n    // Evaluate with minimal context to catch parse errors\n    feelinEvaluate(expression, {});\n    return null;\n  } catch (error) {\n    // Only return actual parsing errors, not runtime errors\n    const message = error instanceof Error ? error.message : String(error);\n    if (message.includes(\"parse\") || message.includes(\"syntax\")) {\n      return message;\n    }\n    // Runtime errors (missing variables, etc.) are OK for validation\n    return null;\n  }\n}\n"],"mappings":"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","names":["feelinEvaluate"]}
+{"version":3,"sources":["../../src/feel/index.ts"],"sourcesContent":["/**\n * FEEL Expression Evaluator\n *\n * Wraps the feelin library to provide FEEL expression evaluation\n * with Forma context conventions.\n *\n * Context variable conventions:\n * - `fieldName` - Direct field value access\n * - `computed.name` - Computed value access\n * - `ref.path` - Reference data lookup (external lookup tables)\n * - `item.fieldName` - Array item field access (within array context)\n * - `itemIndex` - Current array item index (0-based)\n * - `value` - Current field value (in validation expressions)\n */\n\nimport { evaluate as feelinEvaluate } from \"feelin\";\nimport type { EvaluationContext, FEELExpression } from \"../types.js\";\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface EvaluateResult<T = unknown> {\n  success: true;\n  value: T;\n}\n\nexport interface EvaluateError {\n  success: false;\n  error: string;\n  expression: string;\n}\n\nexport type EvaluationOutcome<T = unknown> = EvaluateResult<T> | EvaluateError;\n\n// ============================================================================\n// Context Building\n// ============================================================================\n\n/**\n * Build the FEEL evaluation context from our EvaluationContext\n *\n * Maps our context conventions to feelin context format:\n * - Form data fields are spread directly\n * - computed becomes an object (accessed as computed.fieldName)\n * - ref becomes an object for reference data (accessed as ref.path.to.data)\n * - item becomes an object for array context (accessed as item.fieldName)\n * - itemIndex is a number for array context\n * - value is the current field value\n */\nfunction buildFeelContext(ctx: EvaluationContext): Record<string, unknown> {\n  const feelContext: Record<string, unknown> = {\n    // Spread form data directly so fields are accessible by name\n    ...ctx.data,\n  };\n\n  // Add computed values under 'computed' (accessed as computed.fieldName)\n  if (ctx.computed) {\n    feelContext[\"computed\"] = ctx.computed;\n  }\n\n  // Add reference data under 'ref' (accessed as ref.path.to.data)\n  if (ctx.referenceData) {\n    feelContext[\"ref\"] = ctx.referenceData;\n  }\n\n  // Add array item context (accessed as item.fieldName)\n  if (ctx.item !== undefined) {\n    feelContext[\"item\"] = ctx.item;\n  }\n\n  // Add array index\n  if (ctx.itemIndex !== undefined) {\n    feelContext[\"itemIndex\"] = ctx.itemIndex;\n  }\n\n  // Add current field value for validation expressions\n  if (ctx.value !== undefined) {\n    feelContext[\"value\"] = ctx.value;\n  }\n\n  return feelContext;\n}\n\n// ============================================================================\n// Expression Evaluation\n// ============================================================================\n\n/**\n * Evaluate a FEEL expression and return the result\n *\n * @param expression - FEEL expression string\n * @param context - Evaluation context with form data, computed values, etc.\n * @returns Evaluation outcome with success/value or error\n *\n * @example\n * // Simple field comparison\n * evaluate(\"age >= 18\", { data: { age: 21 } })\n * // => { success: true, value: true }\n *\n * @example\n * // Computed value reference\n * evaluate(\"computed.bmi > 30\", { data: {}, computed: { bmi: 32.5 } })\n * // => { success: true, value: true }\n *\n * @example\n * // Array item context\n * evaluate(\"item.frequency = \\\"daily\\\"\", { data: {}, item: { frequency: \"daily\" } })\n * // => { success: true, value: true }\n */\nexport function evaluate<T = unknown>(\n  expression: FEELExpression,\n  context: EvaluationContext,\n): EvaluationOutcome<T> {\n  try {\n    const feelContext = buildFeelContext(context);\n    const result = feelinEvaluate(expression, feelContext);\n    return {\n      success: true,\n      value: result as T,\n    };\n  } catch (error) {\n    return {\n      success: false,\n      error: error instanceof Error ? error.message : String(error),\n      expression,\n    };\n  }\n}\n\n/**\n * Evaluate a FEEL expression expecting a boolean result\n *\n * Used for visibility, required, and enabled conditions.\n * Returns false on error or non-boolean result for safety.\n *\n * @param expression - FEEL expression that should return boolean\n * @param context - Evaluation context\n * @returns Boolean result (false on error)\n */\nexport function evaluateBoolean(\n  expression: FEELExpression,\n  context: EvaluationContext,\n): boolean {\n  const result = evaluate<boolean>(expression, context);\n\n  if (!result.success) {\n    console.warn(\n      `FEEL expression error: ${result.error}\\nExpression: ${result.expression}`,\n    );\n    return false;\n  }\n\n  // FEEL uses three-valued logic where comparisons with null return null.\n  // For form visibility/required/enabled conditions, we treat null as false.\n  //\n  // Common causes of null results:\n  // - \"fieldName = true\" when fieldName is undefined → null (not false!)\n  // - \"fieldName != null\" when fieldName is undefined → null (not true!)\n  // - \"computed.x = true\" when x is null → null\n  //\n  // Null-safe alternatives:\n  // - Check if boolean answered: \"fieldName = true or fieldName = false\"\n  // - Check if explicitly false: \"fieldName != true\" (true when undefined OR false)\n  // - String length: \"fieldName != null and string length(fieldName) > 0\"\n  if (result.value === null || result.value === undefined) {\n    console.warn(\n      `[forma] FEEL expression returned null (treating as false): \"${expression}\"\\n` +\n        `This often means a referenced field is undefined. See docs for null-safe patterns.`,\n    );\n    return false;\n  }\n\n  if (typeof result.value !== \"boolean\") {\n    console.warn(\n      `FEEL expression did not return boolean: ${expression}\\nGot: ${typeof result.value}`,\n    );\n    return false;\n  }\n\n  return result.value;\n}\n\n/**\n * Evaluate a FEEL expression expecting a numeric result\n *\n * Used for computed values that return numbers.\n *\n * @param expression - FEEL expression that should return number\n * @param context - Evaluation context\n * @returns Numeric result or null on error\n */\nexport function evaluateNumber(\n  expression: FEELExpression,\n  context: EvaluationContext,\n): number | null {\n  const result = evaluate<number>(expression, context);\n\n  if (!result.success) {\n    console.warn(\n      `FEEL expression error: ${result.error}\\nExpression: ${result.expression}`,\n    );\n    return null;\n  }\n\n  if (typeof result.value !== \"number\") {\n    console.warn(\n      `FEEL expression did not return number: ${expression}\\nGot: ${typeof result.value}`,\n    );\n    return null;\n  }\n\n  return result.value;\n}\n\n/**\n * Evaluate a FEEL expression expecting a string result\n *\n * @param expression - FEEL expression that should return string\n * @param context - Evaluation context\n * @returns String result or null on error\n */\nexport function evaluateString(\n  expression: FEELExpression,\n  context: EvaluationContext,\n): string | null {\n  const result = evaluate<string>(expression, context);\n\n  if (!result.success) {\n    console.warn(\n      `FEEL expression error: ${result.error}\\nExpression: ${result.expression}`,\n    );\n    return null;\n  }\n\n  if (typeof result.value !== \"string\") {\n    console.warn(\n      `FEEL expression did not return string: ${expression}\\nGot: ${typeof result.value}`,\n    );\n    return null;\n  }\n\n  return result.value;\n}\n\n// ============================================================================\n// Batch Evaluation\n// ============================================================================\n\n/**\n * Evaluate multiple FEEL expressions at once\n *\n * Useful for evaluating all visibility conditions in a form.\n *\n * @param expressions - Map of field names to FEEL expressions\n * @param context - Evaluation context\n * @returns Map of field names to boolean results\n */\nexport function evaluateBooleanBatch(\n  expressions: Record<string, FEELExpression>,\n  context: EvaluationContext,\n): Record<string, boolean> {\n  const results: Record<string, boolean> = {};\n\n  for (const [key, expression] of Object.entries(expressions)) {\n    results[key] = evaluateBoolean(expression, context);\n  }\n\n  return results;\n}\n\n// ============================================================================\n// Expression Validation\n// ============================================================================\n\n/**\n * Check if a FEEL expression is syntactically valid\n *\n * @param expression - FEEL expression to validate\n * @returns True if the expression can be parsed\n */\nexport function isValidExpression(expression: FEELExpression): boolean {\n  try {\n    // Try to evaluate with empty context - we just want to check parsing\n    feelinEvaluate(expression, {});\n    return true;\n  } catch {\n    // Expression failed to parse or evaluate\n    return false;\n  }\n}\n\n/**\n * Validate a FEEL expression and return any parsing errors\n *\n * @param expression - FEEL expression to validate\n * @returns Null if valid, error message if invalid\n */\nexport function validateExpression(expression: FEELExpression): string | null {\n  try {\n    // Evaluate with minimal context to catch parse errors\n    feelinEvaluate(expression, {});\n    return null;\n  } catch (error) {\n    // Only return actual parsing errors, not runtime errors\n    const message = error instanceof Error ? error.message : String(error);\n    if (message.includes(\"parse\") || message.includes(\"syntax\")) {\n      return message;\n    }\n    // Runtime errors (missing variables, etc.) are OK for validation\n    return null;\n  }\n}\n"],"mappings":"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","names":["feelinEvaluate"]}

package/dist/feel/index.js

@@ -6,7 +6,7 @@ import {
   evaluateString,
   isValidExpression,
   validateExpression
-} from "../chunk-U2OXXFEH.js";
+} from "../chunk-BDICNCE2.js";
 export {
   evaluate,
   evaluateBoolean,

package/dist/index.cjs

@@ -358,7 +358,10 @@ function getComputationOrder(computed) {
   const fieldNames = Object.keys(computed);
   const deps = /* @__PURE__ */ new Map();
   for (const name of fieldNames) {
-    deps.set(name, findComputedDependencies(computed[name].expression, fieldNames));
+    deps.set(
+      name,
+      findComputedDependencies(computed[name].expression, fieldNames)
+    );
   }
   const sorted = [];
   const visited = /* @__PURE__ */ new Set();
@@ -438,10 +441,15 @@ function processArrayItemOptions(arrayPath, fieldDef, arrayData, baseContext, re
       item,
       itemIndex: i
     };
-    for (const [itemFieldName, itemFieldDef] of Object.entries(fieldDef.itemFields)) {
+    for (const [itemFieldName, itemFieldDef] of Object.entries(
+      fieldDef.itemFields
+    )) {
       if (isSelectionField(itemFieldDef) && itemFieldDef.options && itemFieldDef.options.length > 0) {
         const itemFieldPath = `${arrayPath}[${i}].${itemFieldName}`;
-        result[itemFieldPath] = filterOptionsByContext(itemFieldDef.options, itemContext);
+        result[itemFieldPath] = filterOptionsByContext(
+          itemFieldDef.options,
+          itemContext
+        );
       }
     }
   }
@@ -487,10 +495,15 @@ function evaluateArrayItemVisibility(arrayPath, fieldDef, arrayData, baseContext
       item,
       itemIndex: i
     };
-    for (const [fieldName, itemFieldDef] of Object.entries(fieldDef.itemFields)) {
+    for (const [fieldName, itemFieldDef] of Object.entries(
+      fieldDef.itemFields
+    )) {
       const itemFieldPath = `${arrayPath}[${i}].${fieldName}`;
       if (itemFieldDef.visibleWhen) {
-        result[itemFieldPath] = evaluateBoolean(itemFieldDef.visibleWhen, itemContext);
+        result[itemFieldPath] = evaluateBoolean(
+          itemFieldDef.visibleWhen,
+          itemContext
+        );
       } else {
         result[itemFieldPath] = true;
       }
@@ -550,7 +563,13 @@ function getOptionsVisibility(data, spec, options = {}) {
     if (isArrayField(fieldDef) && fieldDef.itemFields) {
       const arrayData = data[fieldPath];
       if (Array.isArray(arrayData)) {
-        processArrayItemOptions(fieldPath, fieldDef, arrayData, baseContext, result);
+        processArrayItemOptions(
+          fieldPath,
+          fieldDef,
+          arrayData,
+          baseContext,
+          result
+        );
       }
     }
   }
@@ -597,7 +616,9 @@ function getRequired(data, spec, options = {}) {
             item,
             itemIndex: i
           };
-          for (const [itemFieldName, itemFieldDef] of Object.entries(fieldDef.itemFields)) {
+          for (const [itemFieldName, itemFieldDef] of Object.entries(
+            fieldDef.itemFields
+          )) {
             const itemFieldPath = `${fieldPath}[${i}].${itemFieldName}`;
             result[itemFieldPath] = isFieldRequired(
               itemFieldPath,
@@ -653,7 +674,15 @@ function getEnabled(data, spec, options = {}) {
     if (fieldDef.type === "array" && fieldDef.itemFields) {
       const arrayData = data[fieldPath];
       if (Array.isArray(arrayData)) {
-        evaluateArrayItemEnabled(fieldPath, fieldDef, arrayData, data, computed, spec, result);
+        evaluateArrayItemEnabled(
+          fieldPath,
+          fieldDef,
+          arrayData,
+          data,
+          computed,
+          spec,
+          result
+        );
       }
     }
   }
@@ -676,7 +705,9 @@ function evaluateArrayItemEnabled(arrayPath, fieldDef, arrayData, data, computed
       item,
       itemIndex: i
     };
-    for (const [itemFieldName, itemFieldDef] of Object.entries(fieldDef.itemFields)) {
+    for (const [itemFieldName, itemFieldDef] of Object.entries(
+      fieldDef.itemFields
+    )) {
       const itemFieldPath = `${arrayPath}[${i}].${itemFieldName}`;
       result[itemFieldPath] = isFieldEnabled(itemFieldDef, itemContext);
     }
@@ -718,7 +749,15 @@ function getReadonly(data, spec, options = {}) {
     if (fieldDef.type === "array" && fieldDef.itemFields) {
       const arrayData = data[fieldPath];
       if (Array.isArray(arrayData)) {
-        evaluateArrayItemReadonly(fieldPath, fieldDef, arrayData, data, computed, spec, result);
+        evaluateArrayItemReadonly(
+          fieldPath,
+          fieldDef,
+          arrayData,
+          data,
+          computed,
+          spec,
+          result
+        );
       }
     }
   }
@@ -741,7 +780,9 @@ function evaluateArrayItemReadonly(arrayPath, fieldDef, arrayData, data, compute
       item,
       itemIndex: i
     };
-    for (const [itemFieldName, itemFieldDef] of Object.entries(fieldDef.itemFields)) {
+    for (const [itemFieldName, itemFieldDef] of Object.entries(
+      fieldDef.itemFields
+    )) {
       const itemFieldPath = `${arrayPath}[${i}].${itemFieldName}`;
       result[itemFieldPath] = isFieldReadonly(itemFieldDef, itemContext);
     }
@@ -821,7 +862,11 @@ function validateField(path, value, fieldDef, schemaProperty, spec, data, comput
     }
   }
   if (fieldDef.validations && !isEmpty(value)) {
-    const customErrors = validateCustomRules(path, fieldDef.validations, context);
+    const customErrors = validateCustomRules(
+      path,
+      fieldDef.validations,
+      context
+    );
     errors.push(...customErrors);
   }
   if (Array.isArray(value) && fieldDef.type === "array") {
@@ -1169,7 +1214,11 @@ function validateArrayItem(arrayPath, index, item, itemFields, itemSchema, spec,
       }
     }
     if ((fieldDef == null ? void 0 : fieldDef.validations) && !isEmpty(value)) {
-      const customErrors = validateCustomRules(itemFieldPath, fieldDef.validations, context);
+      const customErrors = validateCustomRules(
+        itemFieldPath,
+        fieldDef.validations,
+        context
+      );
       errors.push(...customErrors);
     }
   }