@fogpipe/forma-core 0.10.2 → 0.10.3

package/dist/{chunk-KUZ3NPM4.js → chunk-RG7JYFQ6.js}

@@ -3,6 +3,69 @@ import {
   evaluateBoolean
 } from "./chunk-U2OXXFEH.js";
 
+// src/format/index.ts
+var SUPPORTED_FORMATS = [
+  "currency",
+  "percent",
+  "date",
+  "datetime"
+];
+var DECIMAL_FORMAT_PATTERN = /^decimal\((\d+)\)$/;
+function isValidFormat(format) {
+  if (SUPPORTED_FORMATS.includes(format)) {
+    return true;
+  }
+  return DECIMAL_FORMAT_PATTERN.test(format);
+}
+function parseDecimalFormat(format) {
+  const match = format.match(DECIMAL_FORMAT_PATTERN);
+  if (match) {
+    return parseInt(match[1], 10);
+  }
+  return null;
+}
+function formatValue(value, format, options) {
+  const { locale = "en-US", currency = "USD", nullDisplay } = options ?? {};
+  if (value === null || value === void 0) {
+    if (nullDisplay !== void 0) {
+      return nullDisplay;
+    }
+    return String(value);
+  }
+  if (!format) {
+    return String(value);
+  }
+  const decimals = parseDecimalFormat(format);
+  if (decimals !== null) {
+    return typeof value === "number" ? value.toFixed(decimals) : String(value);
+  }
+  if (format === "currency") {
+    return typeof value === "number" ? new Intl.NumberFormat(locale, {
+      style: "currency",
+      currency
+    }).format(value) : String(value);
+  }
+  if (format === "percent") {
+    return typeof value === "number" ? new Intl.NumberFormat(locale, {
+      style: "percent",
+      minimumFractionDigits: 0,
+      maximumFractionDigits: 2
+    }).format(value) : String(value);
+  }
+  if (format === "date") {
+    const date = value instanceof Date ? value : new Date(String(value));
+    return !isNaN(date.getTime()) ? new Intl.DateTimeFormat(locale).format(date) : String(value);
+  }
+  if (format === "datetime") {
+    const date = value instanceof Date ? value : new Date(String(value));
+    return !isNaN(date.getTime()) ? new Intl.DateTimeFormat(locale, {
+      dateStyle: "short",
+      timeStyle: "short"
+    }).format(date) : String(value);
+  }
+  return String(value);
+}
+
 // src/engine/calculate.ts
 function calculate(data, spec) {
   const result = calculateWithErrors(data, spec);
@@ -125,7 +188,7 @@ function findComputedDependencies(expression, availableFields) {
   }
   return deps;
 }
-function getFormattedValue(fieldName, data, spec) {
+function getFormattedValue(fieldName, data, spec, options) {
   var _a;
   if (!((_a = spec.computed) == null ? void 0 : _a[fieldName])) {
     return null;
@@ -134,32 +197,12 @@ function getFormattedValue(fieldName, data, spec) {
   const computed = calculate(data, spec);
   const value = computed[fieldName];
   if (value === null || value === void 0) {
+    if ((options == null ? void 0 : options.nullDisplay) !== void 0) {
+      return formatValue(value, fieldDef.format, options);
+    }
     return null;
   }
-  return formatValue(value, fieldDef.format);
-}
-function formatValue(value, format) {
-  if (!format) {
-    return String(value);
-  }
-  const decimalMatch = format.match(/^decimal\((\d+)\)$/);
-  if (decimalMatch) {
-    const decimals = parseInt(decimalMatch[1], 10);
-    return typeof value === "number" ? value.toFixed(decimals) : String(value);
-  }
-  if (format === "currency") {
-    return typeof value === "number" ? new Intl.NumberFormat("en-US", {
-      style: "currency",
-      currency: "USD"
-    }).format(value) : String(value);
-  }
-  if (format === "percent") {
-    return typeof value === "number" ? new Intl.NumberFormat("en-US", {
-      style: "percent",
-      minimumFractionDigits: 1
-    }).format(value) : String(value);
-  }
-  return String(value);
+  return formatValue(value, fieldDef.format, options);
 }
 function calculateField(fieldName, data, spec) {
   const computed = calculate(data, spec);
@@ -785,6 +828,11 @@ function validateSingleField(fieldPath, data, spec) {
 }
 
 export {
+  SUPPORTED_FORMATS,
+  DECIMAL_FORMAT_PATTERN,
+  isValidFormat,
+  parseDecimalFormat,
+  formatValue,
   calculate,
   calculateWithErrors,
   getFormattedValue,
@@ -799,4 +847,4 @@ export {
   validate,
   validateSingleField
 };
-//# sourceMappingURL=chunk-KUZ3NPM4.js.map
+//# sourceMappingURL=chunk-RG7JYFQ6.js.map

package/dist/chunk-RG7JYFQ6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/format/index.ts","../src/engine/calculate.ts","../src/engine/visibility.ts","../src/engine/required.ts","../src/engine/enabled.ts","../src/engine/validate.ts"],"sourcesContent":["/**\n * Format utilities for computed field values\n *\n * Provides constants, validation helpers, and formatting functions\n * for computed field format specifications.\n */\n\n// ============================================================================\n// Constants\n// ============================================================================\n\n/**\n * Supported format specifiers (excluding decimal which uses pattern)\n */\nexport const SUPPORTED_FORMATS = [\n  \"currency\",\n  \"percent\",\n  \"date\",\n  \"datetime\",\n] as const;\n\n/**\n * Pattern for decimal format: decimal(N) where N is number of decimal places\n */\nexport const DECIMAL_FORMAT_PATTERN = /^decimal\\((\\d+)\\)$/;\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Supported format type (excluding decimal pattern)\n */\nexport type SupportedFormat = (typeof SUPPORTED_FORMATS)[number];\n\n/**\n * Options for value formatting\n */\nexport interface FormatOptions {\n  /** Locale for number/date formatting (default: \"en-US\") */\n  locale?: string;\n  /** Currency code for currency format (default: \"USD\") */\n  currency?: string;\n  /** String to display for null/undefined values (default: returns String(value)) */\n  nullDisplay?: string;\n}\n\n// ============================================================================\n// Validation Helpers\n// ============================================================================\n\n/**\n * Check if a format string is valid\n *\n * Valid formats:\n * - \"currency\"\n * - \"percent\"\n * - \"date\"\n * - \"datetime\"\n * - \"decimal(N)\" where N is a non-negative integer\n *\n * @param format - Format string to validate\n * @returns True if format is valid\n */\nexport function isValidFormat(format: string): boolean {\n  if (SUPPORTED_FORMATS.includes(format as SupportedFormat)) {\n    return true;\n  }\n  return DECIMAL_FORMAT_PATTERN.test(format);\n}\n\n/**\n * Parse decimal format and extract precision\n *\n * @param format - Format string (e.g., \"decimal(2)\")\n * @returns Number of decimal places, or null if not a decimal format\n */\nexport function parseDecimalFormat(format: string): number | null {\n  const match = format.match(DECIMAL_FORMAT_PATTERN);\n  if (match) {\n    return parseInt(match[1], 10);\n  }\n  return null;\n}\n\n// ============================================================================\n// Formatting\n// ============================================================================\n\n/**\n * Format a value according to a format specification\n *\n * Supported formats:\n * - decimal(n) - Number with n decimal places\n * - currency - Number formatted as currency\n * - percent - Number formatted as percentage\n * - date - Date formatted as local date string\n * - datetime - Date formatted as local date/time string\n * - (none/unknown) - Default string conversion\n *\n * @param value - Value to format\n * @param format - Format specification\n * @param options - Formatting options\n * @returns Formatted string\n *\n * @example\n * formatValue(1234.567, \"decimal(2)\")  // \"1234.57\"\n * formatValue(1234.5, \"currency\")       // \"$1,234.50\"\n * formatValue(0.156, \"percent\")         // \"15.6%\"\n * formatValue(null, undefined, { nullDisplay: \"—\" })  // \"—\"\n */\nexport function formatValue(\n  value: unknown,\n  format?: string,\n  options?: FormatOptions\n): string {\n  const { locale = \"en-US\", currency = \"USD\", nullDisplay } = options ?? {};\n\n  // Handle null/undefined\n  if (value === null || value === undefined) {\n    if (nullDisplay !== undefined) {\n      return nullDisplay;\n    }\n    return String(value);\n  }\n\n  // No format specified - default string conversion\n  if (!format) {\n    return String(value);\n  }\n\n  // Handle decimal(n) format\n  const decimals = parseDecimalFormat(format);\n  if (decimals !== null) {\n    return typeof value === \"number\" ? value.toFixed(decimals) : String(value);\n  }\n\n  // Handle currency format\n  if (format === \"currency\") {\n    return typeof value === \"number\"\n      ? new Intl.NumberFormat(locale, {\n          style: \"currency\",\n          currency: currency,\n        }).format(value)\n      : String(value);\n  }\n\n  // Handle percent format\n  if (format === \"percent\") {\n    return typeof value === \"number\"\n      ? new Intl.NumberFormat(locale, {\n          style: \"percent\",\n          minimumFractionDigits: 0,\n          maximumFractionDigits: 2,\n        }).format(value)\n      : String(value);\n  }\n\n  // Handle date format\n  if (format === \"date\") {\n    const date = value instanceof Date ? value : new Date(String(value));\n    return !isNaN(date.getTime())\n      ? new Intl.DateTimeFormat(locale).format(date)\n      : String(value);\n  }\n\n  // Handle datetime format\n  if (format === \"datetime\") {\n    const date = value instanceof Date ? value : new Date(String(value));\n    return !isNaN(date.getTime())\n      ? new Intl.DateTimeFormat(locale, {\n          dateStyle: \"short\",\n          timeStyle: \"short\",\n        }).format(date)\n      : String(value);\n  }\n\n  // Unknown format - fallback to string conversion\n  return String(value);\n}\n","/**\n * Calculation Engine\n *\n * Evaluates computed fields based on form data.\n * Computed values are derived from form data using FEEL expressions.\n */\n\nimport { evaluate } from \"../feel/index.js\";\nimport { formatValue, type FormatOptions } from \"../format/index.js\";\nimport type {\n  Forma,\n  ComputedField,\n  EvaluationContext,\n  CalculationResult,\n  CalculationError,\n} from \"../types.js\";\n\n// ============================================================================\n// Main Function\n// ============================================================================\n\n/**\n * Calculate all computed values from form data\n *\n * Evaluates each computed field's FEEL expression and returns the results.\n * Errors are collected rather than thrown, allowing partial results.\n *\n * @param data - Current form data\n * @param spec - Form specification with computed fields\n * @returns Computed values and any calculation errors\n *\n * @example\n * const spec = {\n *   computed: {\n *     bmi: {\n *       expression: \"weight / (height / 100) ** 2\",\n *       label: \"BMI\",\n *       format: \"decimal(1)\"\n *     },\n *     isObese: {\n *       expression: \"$computed.bmi >= 30\"\n *     }\n *   }\n * };\n *\n * const result = calculate({ weight: 85, height: 175 }, spec);\n * // => { values: { bmi: 27.76, isObese: false }, errors: [] }\n */\nexport function calculate(\n  data: Record<string, unknown>,\n  spec: Forma\n): Record<string, unknown> {\n  const result = calculateWithErrors(data, spec);\n  return result.values;\n}\n\n/**\n * Calculate computed values with error reporting\n *\n * Same as calculate() but also returns any errors that occurred.\n *\n * @param data - Current form data\n * @param spec - Form specification\n * @returns Values and errors\n */\nexport function calculateWithErrors(\n  data: Record<string, unknown>,\n  spec: Forma\n): CalculationResult {\n  if (!spec.computed) {\n    return { values: {}, errors: [] };\n  }\n\n  const values: Record<string, unknown> = {};\n  const errors: CalculationError[] = [];\n\n  // Get computation order (handles dependencies)\n  const orderedFields = getComputationOrder(spec.computed);\n\n  // Evaluate each computed field in dependency order\n  for (const fieldName of orderedFields) {\n    const fieldDef = spec.computed[fieldName];\n    if (!fieldDef) continue;\n\n    const result = evaluateComputedField(\n      fieldName,\n      fieldDef,\n      data,\n      values, // Pass already-computed values for dependencies\n      spec.referenceData // Pass reference data for lookups\n    );\n\n    if (result.success) {\n      values[fieldName] = result.value;\n    } else {\n      errors.push({\n        field: fieldName,\n        message: result.error,\n        expression: fieldDef.expression,\n      });\n      // Set to null so dependent fields can still evaluate\n      values[fieldName] = null;\n    }\n  }\n\n  return { values, errors };\n}\n\n// ============================================================================\n// Field Evaluation\n// ============================================================================\n\ninterface ComputeSuccess {\n  success: true;\n  value: unknown;\n}\n\ninterface ComputeFailure {\n  success: false;\n  error: string;\n}\n\ntype ComputeResult = ComputeSuccess | ComputeFailure;\n\n/**\n * Evaluate a single computed field\n */\nfunction evaluateComputedField(\n  _name: string,\n  fieldDef: ComputedField,\n  data: Record<string, unknown>,\n  computedSoFar: Record<string, unknown>,\n  referenceData?: Record<string, unknown>\n): ComputeResult {\n  // Check if any referenced computed field is null - propagate null to dependents\n  // This prevents issues like: bmi is null, but bmiCategory still evaluates to \"obese\"\n  // because `null < 18.5` is false in comparisons\n  const referencedComputed = findComputedReferences(fieldDef.expression);\n  for (const ref of referencedComputed) {\n    if (computedSoFar[ref] === null) {\n      return {\n        success: true,\n        value: null,\n      };\n    }\n  }\n\n  const context: EvaluationContext = {\n    data,\n    computed: computedSoFar,\n    referenceData,\n  };\n\n  const result = evaluate(fieldDef.expression, context);\n\n  if (!result.success) {\n    return {\n      success: false,\n      error: result.error,\n    };\n  }\n\n  // Treat NaN and Infinity as null - prevents unexpected behavior in conditional expressions\n  // (e.g., NaN < 18.5 is false, causing fallthrough in if-else chains)\n  if (typeof result.value === \"number\" && (!Number.isFinite(result.value))) {\n    return {\n      success: true,\n      value: null,\n    };\n  }\n\n  return {\n    success: true,\n    value: result.value,\n  };\n}\n\n/**\n * Find computed field references in an expression (e.g., computed.bmi)\n */\nfunction findComputedReferences(expression: string): string[] {\n  const refs: string[] = [];\n  const regex = /computed\\.(\\w+)/g;\n  let match;\n  while ((match = regex.exec(expression)) !== null) {\n    refs.push(match[1]);\n  }\n  return refs;\n}\n\n// ============================================================================\n// Dependency Resolution\n// ============================================================================\n\n/**\n * Determine the order to evaluate computed fields based on dependencies\n *\n * Computed fields can reference other computed fields via $computed.name.\n * This function performs topological sort to ensure dependencies are\n * evaluated first.\n */\nfunction getComputationOrder(\n  computed: Record<string, ComputedField>\n): string[] {\n  const fieldNames = Object.keys(computed);\n\n  // Build dependency graph\n  const deps = new Map<string, Set<string>>();\n  for (const name of fieldNames) {\n    deps.set(name, findComputedDependencies(computed[name].expression, fieldNames));\n  }\n\n  // Topological sort\n  const sorted: string[] = [];\n  const visited = new Set<string>();\n  const visiting = new Set<string>();\n\n  function visit(name: string): void {\n    if (visited.has(name)) return;\n    if (visiting.has(name)) {\n      // Circular dependency - just add it and let evaluation fail gracefully\n      console.warn(`Circular dependency detected in computed field: ${name}`);\n      sorted.push(name);\n      visited.add(name);\n      return;\n    }\n\n    visiting.add(name);\n\n    const fieldDeps = deps.get(name) ?? new Set();\n    for (const dep of fieldDeps) {\n      visit(dep);\n    }\n\n    visiting.delete(name);\n    visited.add(name);\n    sorted.push(name);\n  }\n\n  for (const name of fieldNames) {\n    visit(name);\n  }\n\n  return sorted;\n}\n\n/**\n * Find which computed fields are referenced in an expression\n */\nfunction findComputedDependencies(\n  expression: string,\n  availableFields: string[]\n): Set<string> {\n  const deps = new Set<string>();\n\n  // Look for computed.fieldName patterns (without $ prefix)\n  const regex = /computed\\.(\\w+)/g;\n  let match;\n  while ((match = regex.exec(expression)) !== null) {\n    const fieldName = match[1];\n    if (availableFields.includes(fieldName)) {\n      deps.add(fieldName);\n    }\n  }\n\n  return deps;\n}\n\n// ============================================================================\n// Formatted Output\n// ============================================================================\n\n/**\n * Get a computed value formatted according to its format specification\n *\n * @param fieldName - Name of the computed field\n * @param data - Current form data\n * @param spec - Form specification\n * @param options - Formatting options (locale, currency, nullDisplay)\n * @returns Formatted string or null if field not found or value is null/undefined\n */\nexport function getFormattedValue(\n  fieldName: string,\n  data: Record<string, unknown>,\n  spec: Forma,\n  options?: FormatOptions\n): string | null {\n  if (!spec.computed?.[fieldName]) {\n    return null;\n  }\n\n  const fieldDef = spec.computed[fieldName];\n  const computed = calculate(data, spec);\n  const value = computed[fieldName];\n\n  if (value === null || value === undefined) {\n    // If nullDisplay is specified, use formatValue to get it\n    if (options?.nullDisplay !== undefined) {\n      return formatValue(value, fieldDef.format, options);\n    }\n    return null;\n  }\n\n  return formatValue(value, fieldDef.format, options);\n}\n\n// ============================================================================\n// Single Field Calculation\n// ============================================================================\n\n/**\n * Calculate a single computed field\n *\n * @param fieldName - Name of the computed field\n * @param data - Current form data\n * @param spec - Form specification\n * @returns Computed value or null if calculation failed\n */\nexport function calculateField(\n  fieldName: string,\n  data: Record<string, unknown>,\n  spec: Forma\n): unknown {\n  const computed = calculate(data, spec);\n  return computed[fieldName] ?? null;\n}\n","/**\n * Visibility Engine\n *\n * Determines which fields should be visible based on form data\n * and Forma visibility rules.\n */\n\nimport { evaluateBoolean } from \"../feel/index.js\";\nimport type {\n  Forma,\n  FieldDefinition,\n  EvaluationContext,\n  VisibilityResult,\n} from \"../types.js\";\nimport { calculate } from \"./calculate.js\";\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface VisibilityOptions {\n  /** Pre-calculated computed values (avoids recalculation) */\n  computed?: Record<string, unknown>;\n}\n\n// ============================================================================\n// Main Function\n// ============================================================================\n\n/**\n * Determine visibility for all fields in a form\n *\n * Returns a map of field paths to boolean visibility states.\n * Fields without visibleWhen expressions are always visible.\n *\n * @param data - Current form data\n * @param spec - Form specification\n * @param options - Optional pre-calculated computed values\n * @returns Map of field paths to visibility states\n *\n * @example\n * const visibility = getVisibility(\n *   { age: 21, hasLicense: true },\n *   forma\n * );\n * // => { age: true, hasLicense: true, vehicleType: true, ... }\n */\nexport function getVisibility(\n  data: Record<string, unknown>,\n  spec: Forma,\n  options: VisibilityOptions = {}\n): VisibilityResult {\n  // Calculate computed values if not provided\n  const computed = options.computed ?? calculate(data, spec);\n\n  // Build base evaluation context\n  const baseContext: EvaluationContext = {\n    data,\n    computed,\n    referenceData: spec.referenceData,\n  };\n\n  const result: VisibilityResult = {};\n\n  // Process all fields in field order\n  for (const fieldPath of spec.fieldOrder) {\n    const fieldDef = spec.fields[fieldPath];\n    if (fieldDef) {\n      evaluateFieldVisibility(fieldPath, fieldDef, data, baseContext, result);\n    }\n  }\n\n  return result;\n}\n\n// ============================================================================\n// Field Evaluation\n// ============================================================================\n\n/**\n * Evaluate visibility for a single field and its nested fields\n */\nfunction evaluateFieldVisibility(\n  path: string,\n  fieldDef: FieldDefinition,\n  data: Record<string, unknown>,\n  context: EvaluationContext,\n  result: VisibilityResult\n): void {\n  // Evaluate the field's own visibility\n  if (fieldDef.visibleWhen) {\n    result[path] = evaluateBoolean(fieldDef.visibleWhen, context);\n  } else {\n    result[path] = true; // No condition = always visible\n  }\n\n  // If not visible, children are implicitly not visible\n  if (!result[path]) {\n    return;\n  }\n\n  // Handle array fields with item visibility\n  if (fieldDef.itemFields) {\n    const arrayData = data[path];\n    if (Array.isArray(arrayData)) {\n      evaluateArrayItemVisibility(path, fieldDef, arrayData, context, result);\n    }\n  }\n}\n\n/**\n * Evaluate visibility for array item fields\n *\n * For each item in the array, evaluates the visibility of each\n * item field using the $item context.\n */\nfunction evaluateArrayItemVisibility(\n  arrayPath: string,\n  fieldDef: FieldDefinition,\n  arrayData: unknown[],\n  baseContext: EvaluationContext,\n  result: VisibilityResult\n): void {\n  if (!fieldDef.itemFields) return;\n\n  for (let i = 0; i < arrayData.length; i++) {\n    const item = arrayData[i] as Record<string, unknown>;\n\n    // Create item-specific context\n    const itemContext: EvaluationContext = {\n      ...baseContext,\n      item,\n      itemIndex: i,\n    };\n\n    // Evaluate each item field's visibility\n    for (const [fieldName, itemFieldDef] of Object.entries(fieldDef.itemFields)) {\n      const itemFieldPath = `${arrayPath}[${i}].${fieldName}`;\n\n      if (itemFieldDef.visibleWhen) {\n        result[itemFieldPath] = evaluateBoolean(itemFieldDef.visibleWhen, itemContext);\n      } else {\n        result[itemFieldPath] = true;\n      }\n    }\n  }\n}\n\n// ============================================================================\n// Individual Field Visibility\n// ============================================================================\n\n/**\n * Check if a single field is visible\n *\n * Useful for checking visibility of one field without computing all.\n *\n * @param fieldPath - Field path to check\n * @param data - Current form data\n * @param spec - Form specification\n * @param options - Optional pre-calculated computed values\n * @returns True if the field is visible\n */\nexport function isFieldVisible(\n  fieldPath: string,\n  data: Record<string, unknown>,\n  spec: Forma,\n  options: VisibilityOptions = {}\n): boolean {\n  const fieldDef = spec.fields[fieldPath];\n  if (!fieldDef) {\n    return true; // Unknown fields are visible by default\n  }\n\n  if (!fieldDef.visibleWhen) {\n    return true; // No condition = always visible\n  }\n\n  const computed = options.computed ?? calculate(data, spec);\n  const context: EvaluationContext = {\n    data,\n    computed,\n    referenceData: spec.referenceData,\n  };\n\n  return evaluateBoolean(fieldDef.visibleWhen, context);\n}\n\n// ============================================================================\n// Page Visibility\n// ============================================================================\n\n/**\n * Determine which pages are visible in a wizard form\n *\n * @param data - Current form data\n * @param spec - Form specification with pages\n * @param options - Optional pre-calculated computed values\n * @returns Map of page IDs to visibility states\n */\nexport function getPageVisibility(\n  data: Record<string, unknown>,\n  spec: Forma,\n  options: VisibilityOptions = {}\n): Record<string, boolean> {\n  if (!spec.pages) {\n    return {};\n  }\n\n  const computed = options.computed ?? calculate(data, spec);\n  const context: EvaluationContext = {\n    data,\n    computed,\n    referenceData: spec.referenceData,\n  };\n\n  const result: Record<string, boolean> = {};\n\n  for (const page of spec.pages) {\n    if (page.visibleWhen) {\n      result[page.id] = evaluateBoolean(page.visibleWhen, context);\n    } else {\n      result[page.id] = true;\n    }\n  }\n\n  return result;\n}\n","/**\n * Required Fields Engine\n *\n * Determines which fields are currently required based on\n * conditional requiredWhen expressions and schema required array.\n */\n\nimport { evaluateBoolean } from \"../feel/index.js\";\nimport type {\n  Forma,\n  FieldDefinition,\n  EvaluationContext,\n  RequiredFieldsResult,\n} from \"../types.js\";\nimport { calculate } from \"./calculate.js\";\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface RequiredOptions {\n  /** Pre-calculated computed values */\n  computed?: Record<string, unknown>;\n}\n\n// ============================================================================\n// Main Function\n// ============================================================================\n\n/**\n * Determine which fields are currently required\n *\n * Returns a map of field paths to boolean required states.\n * Evaluates requiredWhen expressions for conditional requirements.\n *\n * @param data - Current form data\n * @param spec - Form specification\n * @param options - Optional pre-calculated computed values\n * @returns Map of field paths to required states\n *\n * @example\n * const required = getRequired(\n *   { hasInsurance: true },\n *   forma\n * );\n * // => { hasInsurance: true, insuranceProvider: true, policyNumber: true }\n */\nexport function getRequired(\n  data: Record<string, unknown>,\n  spec: Forma,\n  options: RequiredOptions = {}\n): RequiredFieldsResult {\n  const computed = options.computed ?? calculate(data, spec);\n  const context: EvaluationContext = {\n    data,\n    computed,\n    referenceData: spec.referenceData,\n  };\n\n  const result: RequiredFieldsResult = {};\n\n  // Evaluate each field's required status\n  for (const fieldPath of spec.fieldOrder) {\n    const fieldDef = spec.fields[fieldPath];\n    if (fieldDef) {\n      result[fieldPath] = isFieldRequired(fieldPath, fieldDef, spec, context);\n    }\n  }\n\n  // Also check array item fields\n  for (const [fieldPath, fieldDef] of Object.entries(spec.fields)) {\n    if (fieldDef.itemFields) {\n      const arrayData = data[fieldPath];\n      if (Array.isArray(arrayData)) {\n        for (let i = 0; i < arrayData.length; i++) {\n          const item = arrayData[i] as Record<string, unknown>;\n          const itemContext: EvaluationContext = {\n            data,\n            computed,\n            referenceData: spec.referenceData,\n            item,\n            itemIndex: i,\n          };\n\n          for (const [itemFieldName, itemFieldDef] of Object.entries(fieldDef.itemFields)) {\n            const itemFieldPath = `${fieldPath}[${i}].${itemFieldName}`;\n            result[itemFieldPath] = isFieldRequired(\n              itemFieldPath,\n              itemFieldDef,\n              spec,\n              itemContext\n            );\n          }\n        }\n      }\n    }\n  }\n\n  return result;\n}\n\n// ============================================================================\n// Field Required Check\n// ============================================================================\n\n/**\n * Check if a single field is required based on requiredWhen or schema\n * @internal Exported for use by validate.ts\n */\nexport function isFieldRequired(\n  fieldPath: string,\n  fieldDef: FieldDefinition,\n  spec: Forma,\n  context: EvaluationContext\n): boolean {\n  // If field has requiredWhen, evaluate it\n  if (fieldDef.requiredWhen) {\n    return evaluateBoolean(fieldDef.requiredWhen, context);\n  }\n\n  // Otherwise, check schema required array\n  return spec.schema.required?.includes(fieldPath) ?? false;\n}\n\n/**\n * Check if a single field is currently required\n *\n * @param fieldPath - Path to the field\n * @param data - Current form data\n * @param spec - Form specification\n * @returns True if the field is required\n */\nexport function isRequired(\n  fieldPath: string,\n  data: Record<string, unknown>,\n  spec: Forma\n): boolean {\n  const fieldDef = spec.fields[fieldPath];\n  if (!fieldDef) {\n    return spec.schema.required?.includes(fieldPath) ?? false;\n  }\n\n  const computed = calculate(data, spec);\n  const context: EvaluationContext = {\n    data,\n    computed,\n    referenceData: spec.referenceData,\n  };\n\n  return isFieldRequired(fieldPath, fieldDef, spec, context);\n}\n","/**\n * Enabled Fields Engine\n *\n * Determines which fields are currently enabled (editable) based on\n * conditional enabledWhen expressions.\n */\n\nimport { evaluateBoolean } from \"../feel/index.js\";\nimport type {\n  Forma,\n  FieldDefinition,\n  EvaluationContext,\n  EnabledResult,\n} from \"../types.js\";\nimport { calculate } from \"./calculate.js\";\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface EnabledOptions {\n  /** Pre-calculated computed values */\n  computed?: Record<string, unknown>;\n}\n\n// ============================================================================\n// Main Function\n// ============================================================================\n\n/**\n * Determine which fields are currently enabled (editable)\n *\n * Returns a map of field paths to boolean enabled states.\n * Fields without enabledWhen expressions are always enabled.\n *\n * @param data - Current form data\n * @param spec - Form specification\n * @param options - Optional pre-calculated computed values\n * @returns Map of field paths to enabled states\n *\n * @example\n * const enabled = getEnabled(\n *   { isLocked: true },\n *   forma\n * );\n * // => { isLocked: true, lockedField: false, ... }\n */\nexport function getEnabled(\n  data: Record<string, unknown>,\n  spec: Forma,\n  options: EnabledOptions = {}\n): EnabledResult {\n  const computed = options.computed ?? calculate(data, spec);\n  const context: EvaluationContext = {\n    data,\n    computed,\n    referenceData: spec.referenceData,\n  };\n\n  const result: EnabledResult = {};\n\n  // Evaluate each field's enabled status\n  for (const fieldPath of spec.fieldOrder) {\n    const fieldDef = spec.fields[fieldPath];\n    if (fieldDef) {\n      result[fieldPath] = isFieldEnabled(fieldDef, context);\n    }\n  }\n\n  // Also check array item fields\n  for (const [fieldPath, fieldDef] of Object.entries(spec.fields)) {\n    if (fieldDef.itemFields) {\n      const arrayData = data[fieldPath];\n      if (Array.isArray(arrayData)) {\n        for (let i = 0; i < arrayData.length; i++) {\n          const item = arrayData[i] as Record<string, unknown>;\n          const itemContext: EvaluationContext = {\n            data,\n            computed,\n            referenceData: spec.referenceData,\n            item,\n            itemIndex: i,\n          };\n\n          for (const [itemFieldName, itemFieldDef] of Object.entries(fieldDef.itemFields)) {\n            const itemFieldPath = `${fieldPath}[${i}].${itemFieldName}`;\n            result[itemFieldPath] = isFieldEnabled(itemFieldDef, itemContext);\n          }\n        }\n      }\n    }\n  }\n\n  return result;\n}\n\n// ============================================================================\n// Field Enabled Check\n// ============================================================================\n\n/**\n * Check if a field is enabled based on its definition\n */\nfunction isFieldEnabled(\n  fieldDef: FieldDefinition,\n  context: EvaluationContext\n): boolean {\n  // If field has enabledWhen, evaluate it\n  if (fieldDef.enabledWhen) {\n    return evaluateBoolean(fieldDef.enabledWhen, context);\n  }\n\n  // No condition = always enabled\n  return true;\n}\n\n/**\n * Check if a single field is currently enabled\n *\n * @param fieldPath - Path to the field\n * @param data - Current form data\n * @param spec - Form specification\n * @returns True if the field is enabled\n */\nexport function isEnabled(\n  fieldPath: string,\n  data: Record<string, unknown>,\n  spec: Forma\n): boolean {\n  const fieldDef = spec.fields[fieldPath];\n  if (!fieldDef) {\n    return true; // Unknown fields are enabled by default\n  }\n\n  if (!fieldDef.enabledWhen) {\n    return true; // No condition = always enabled\n  }\n\n  const computed = calculate(data, spec);\n  const context: EvaluationContext = {\n    data,\n    computed,\n    referenceData: spec.referenceData,\n  };\n\n  return evaluateBoolean(fieldDef.enabledWhen, context);\n}\n","/**\n * Validation Engine\n *\n * Validates form data against Forma rules including:\n * - JSON Schema type validation\n * - Required field validation (with conditional requiredWhen)\n * - Custom FEEL validation rules\n * - Array item validation\n */\n\nimport { evaluateBoolean } from \"../feel/index.js\";\nimport type {\n  Forma,\n  FieldDefinition,\n  ValidationRule,\n  EvaluationContext,\n  ValidationResult,\n  FieldError,\n  JSONSchemaProperty,\n} from \"../types.js\";\nimport { calculate } from \"./calculate.js\";\nimport { getVisibility } from \"./visibility.js\";\nimport { isFieldRequired } from \"./required.js\";\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface ValidateOptions {\n  /** Pre-calculated computed values */\n  computed?: Record<string, unknown>;\n  /** Pre-calculated visibility */\n  visibility?: Record<string, boolean>;\n  /** Only validate visible fields (default: true) */\n  onlyVisible?: boolean;\n}\n\n// ============================================================================\n// Main Function\n// ============================================================================\n\n/**\n * Validate form data against a Forma\n *\n * Performs comprehensive validation including:\n * - Required field checks (respecting conditional requiredWhen)\n * - JSON Schema type validation\n * - Custom FEEL validation rules\n * - Array min/max items validation\n * - Array item field validation\n *\n * By default, only visible fields are validated.\n *\n * @param data - Current form data\n * @param spec - Form specification\n * @param options - Validation options\n * @returns Validation result with valid flag and errors array\n *\n * @example\n * const result = validate(\n *   { name: \"\", age: 15 },\n *   forma\n * );\n * // => {\n * //   valid: false,\n * //   errors: [\n * //     { field: \"name\", message: \"Name is required\", severity: \"error\" },\n * //     { field: \"age\", message: \"Must be 18 or older\", severity: \"error\" }\n * //   ]\n * // }\n */\nexport function validate(\n  data: Record<string, unknown>,\n  spec: Forma,\n  options: ValidateOptions = {}\n): ValidationResult {\n  const { onlyVisible = true } = options;\n\n  // Calculate computed values\n  const computed = options.computed ?? calculate(data, spec);\n\n  // Calculate visibility\n  const visibility = options.visibility ?? getVisibility(data, spec, { computed });\n\n  // Collect errors\n  const errors: FieldError[] = [];\n\n  // Validate each field\n  for (const fieldPath of spec.fieldOrder) {\n    const fieldDef = spec.fields[fieldPath];\n    if (!fieldDef) continue;\n\n    // Skip hidden fields if onlyVisible is true\n    if (onlyVisible && visibility[fieldPath] === false) {\n      continue;\n    }\n\n    // Get schema property for type validation\n    const schemaProperty = spec.schema.properties[fieldPath];\n\n    // Validate this field\n    const fieldErrors = validateField(\n      fieldPath,\n      data[fieldPath],\n      fieldDef,\n      schemaProperty,\n      spec,\n      data,\n      computed,\n      visibility,\n      onlyVisible\n    );\n\n    errors.push(...fieldErrors);\n  }\n\n  return {\n    valid: errors.filter((e) => e.severity === \"error\").length === 0,\n    errors,\n  };\n}\n\n// ============================================================================\n// Field Validation\n// ============================================================================\n\n/**\n * Validate a single field and its nested fields\n */\nfunction validateField(\n  path: string,\n  value: unknown,\n  fieldDef: FieldDefinition,\n  schemaProperty: JSONSchemaProperty | undefined,\n  spec: Forma,\n  data: Record<string, unknown>,\n  computed: Record<string, unknown>,\n  visibility: Record<string, boolean>,\n  onlyVisible: boolean\n): FieldError[] {\n  const errors: FieldError[] = [];\n  const context: EvaluationContext = {\n    data,\n    computed,\n    referenceData: spec.referenceData,\n    value,\n  };\n\n  // 1. Required validation\n  const required = isFieldRequired(path, fieldDef, spec, context);\n  if (required && isEmpty(value)) {\n    errors.push({\n      field: path,\n      message: fieldDef.label\n        ? `${fieldDef.label} is required`\n        : \"This field is required\",\n      severity: \"error\",\n    });\n  }\n\n  // 2. Type validation (only if value is present)\n  if (!isEmpty(value) && schemaProperty) {\n    const typeError = validateType(path, value, schemaProperty, fieldDef);\n    if (typeError) {\n      errors.push(typeError);\n    }\n  }\n\n  // 3. Custom FEEL validation rules\n  if (fieldDef.validations && !isEmpty(value)) {\n    const customErrors = validateCustomRules(path, fieldDef.validations, context);\n    errors.push(...customErrors);\n  }\n\n  // 4. Array validation\n  if (Array.isArray(value) && fieldDef.itemFields) {\n    const arrayErrors = validateArray(\n      path,\n      value,\n      fieldDef,\n      spec,\n      data,\n      computed,\n      visibility,\n      onlyVisible\n    );\n    errors.push(...arrayErrors);\n  }\n\n  return errors;\n}\n\n/**\n * Check if a value is empty\n */\nfunction isEmpty(value: unknown): boolean {\n  if (value === null || value === undefined) return true;\n  if (typeof value === \"string\" && value.trim() === \"\") return true;\n  if (Array.isArray(value) && value.length === 0) return true;\n  return false;\n}\n\n// ============================================================================\n// Type Validation\n// ============================================================================\n\n/**\n * Validate value against JSON Schema type\n */\nfunction validateType(\n  path: string,\n  value: unknown,\n  schema: JSONSchemaProperty,\n  fieldDef: FieldDefinition\n): FieldError | null {\n  const label = fieldDef.label ?? path;\n\n  switch (schema.type) {\n    case \"string\": {\n      if (typeof value !== \"string\") {\n        return {\n          field: path,\n          message: `${label} must be a string`,\n          severity: \"error\",\n        };\n      }\n\n      // String-specific validations\n      if (\"minLength\" in schema && schema.minLength !== undefined) {\n        if (value.length < schema.minLength) {\n          return {\n            field: path,\n            message: `${label} must be at least ${schema.minLength} characters`,\n            severity: \"error\",\n          };\n        }\n      }\n\n      if (\"maxLength\" in schema && schema.maxLength !== undefined) {\n        if (value.length > schema.maxLength) {\n          return {\n            field: path,\n            message: `${label} must be no more than ${schema.maxLength} characters`,\n            severity: \"error\",\n          };\n        }\n      }\n\n      if (\"pattern\" in schema && schema.pattern) {\n        const regex = new RegExp(schema.pattern);\n        if (!regex.test(value)) {\n          return {\n            field: path,\n            message: `${label} format is invalid`,\n            severity: \"error\",\n          };\n        }\n      }\n\n      if (\"enum\" in schema && schema.enum) {\n        if (!schema.enum.includes(value)) {\n          return {\n            field: path,\n            message: `${label} must be one of: ${schema.enum.join(\", \")}`,\n            severity: \"error\",\n          };\n        }\n      }\n\n      if (\"format\" in schema && schema.format) {\n        const formatError = validateFormat(path, value, schema.format, label);\n        if (formatError) return formatError;\n      }\n\n      return null;\n    }\n\n    case \"number\":\n    case \"integer\": {\n      if (typeof value !== \"number\") {\n        return {\n          field: path,\n          message: `${label} must be a number`,\n          severity: \"error\",\n        };\n      }\n\n      if (schema.type === \"integer\" && !Number.isInteger(value)) {\n        return {\n          field: path,\n          message: `${label} must be a whole number`,\n          severity: \"error\",\n        };\n      }\n\n      if (\"minimum\" in schema && schema.minimum !== undefined) {\n        if (value < schema.minimum) {\n          return {\n            field: path,\n            message: `${label} must be at least ${schema.minimum}`,\n            severity: \"error\",\n          };\n        }\n      }\n\n      if (\"maximum\" in schema && schema.maximum !== undefined) {\n        if (value > schema.maximum) {\n          return {\n            field: path,\n            message: `${label} must be no more than ${schema.maximum}`,\n            severity: \"error\",\n          };\n        }\n      }\n\n      if (\"exclusiveMinimum\" in schema && schema.exclusiveMinimum !== undefined) {\n        if (value <= schema.exclusiveMinimum) {\n          return {\n            field: path,\n            message: `${label} must be greater than ${schema.exclusiveMinimum}`,\n            severity: \"error\",\n          };\n        }\n      }\n\n      if (\"exclusiveMaximum\" in schema && schema.exclusiveMaximum !== undefined) {\n        if (value >= schema.exclusiveMaximum) {\n          return {\n            field: path,\n            message: `${label} must be less than ${schema.exclusiveMaximum}`,\n            severity: \"error\",\n          };\n        }\n      }\n\n      if (\"multipleOf\" in schema && schema.multipleOf !== undefined) {\n        const multipleOf = schema.multipleOf;\n        // Use epsilon comparison to handle floating point precision issues\n        const remainder = Math.abs(value % multipleOf);\n        const isValid = remainder < 1e-10 || Math.abs(remainder - multipleOf) < 1e-10;\n        if (!isValid) {\n          return {\n            field: path,\n            message: `${label} must be a multiple of ${multipleOf}`,\n            severity: \"error\",\n          };\n        }\n      }\n\n      return null;\n    }\n\n    case \"boolean\": {\n      if (typeof value !== \"boolean\") {\n        return {\n          field: path,\n          message: `${label} must be true or false`,\n          severity: \"error\",\n        };\n      }\n      return null;\n    }\n\n    case \"array\": {\n      if (!Array.isArray(value)) {\n        return {\n          field: path,\n          message: `${label} must be a list`,\n          severity: \"error\",\n        };\n      }\n      return null;\n    }\n\n    case \"object\": {\n      if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n        return {\n          field: path,\n          message: `${label} must be an object`,\n          severity: \"error\",\n        };\n      }\n      return null;\n    }\n\n    default:\n      return null;\n  }\n}\n\n/**\n * Validate string format\n */\nfunction validateFormat(\n  path: string,\n  value: string,\n  format: string,\n  label: string\n): FieldError | null {\n  switch (format) {\n    case \"email\": {\n      // Simple email regex\n      const emailRegex = /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/;\n      if (!emailRegex.test(value)) {\n        return {\n          field: path,\n          message: `${label} must be a valid email address`,\n          severity: \"error\",\n        };\n      }\n      return null;\n    }\n\n    case \"date\": {\n      // ISO date format YYYY-MM-DD\n      const dateRegex = /^\\d{4}-\\d{2}-\\d{2}$/;\n      if (!dateRegex.test(value)) {\n        return {\n          field: path,\n          message: `${label} must be a valid date`,\n          severity: \"error\",\n        };\n      }\n      // Verify the date is actually valid (e.g., not Feb 30)\n      const parsed = new Date(value + \"T00:00:00Z\");\n      if (isNaN(parsed.getTime()) || parsed.toISOString().slice(0, 10) !== value) {\n        return {\n          field: path,\n          message: `${label} must be a valid date`,\n          severity: \"error\",\n        };\n      }\n      return null;\n    }\n\n    case \"date-time\": {\n      if (isNaN(Date.parse(value))) {\n        return {\n          field: path,\n          message: `${label} must be a valid date and time`,\n          severity: \"error\",\n        };\n      }\n      return null;\n    }\n\n    case \"uri\": {\n      try {\n        new URL(value);\n        return null;\n      } catch {\n        return {\n          field: path,\n          message: `${label} must be a valid URL`,\n          severity: \"error\",\n        };\n      }\n    }\n\n    case \"uuid\": {\n      const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;\n      if (!uuidRegex.test(value)) {\n        return {\n          field: path,\n          message: `${label} must be a valid UUID`,\n          severity: \"error\",\n        };\n      }\n      return null;\n    }\n\n    default:\n      return null;\n  }\n}\n\n// ============================================================================\n// Custom Rule Validation\n// ============================================================================\n\n/**\n * Validate custom FEEL validation rules\n */\nfunction validateCustomRules(\n  path: string,\n  rules: ValidationRule[],\n  context: EvaluationContext\n): FieldError[] {\n  const errors: FieldError[] = [];\n\n  for (const rule of rules) {\n    const isValid = evaluateBoolean(rule.rule, context);\n\n    if (!isValid) {\n      errors.push({\n        field: path,\n        message: rule.message,\n        severity: rule.severity ?? \"error\",\n      });\n    }\n  }\n\n  return errors;\n}\n\n// ============================================================================\n// Array Validation\n// ============================================================================\n\n/**\n * Validate array field including items\n */\nfunction validateArray(\n  path: string,\n  value: unknown[],\n  fieldDef: FieldDefinition,\n  spec: Forma,\n  data: Record<string, unknown>,\n  computed: Record<string, unknown>,\n  visibility: Record<string, boolean>,\n  onlyVisible: boolean\n): FieldError[] {\n  const errors: FieldError[] = [];\n  const label = fieldDef.label ?? path;\n\n  // Check min/max items\n  if (fieldDef.minItems !== undefined && value.length < fieldDef.minItems) {\n    errors.push({\n      field: path,\n      message: `${label} must have at least ${fieldDef.minItems} items`,\n      severity: \"error\",\n    });\n  }\n\n  if (fieldDef.maxItems !== undefined && value.length > fieldDef.maxItems) {\n    errors.push({\n      field: path,\n      message: `${label} must have no more than ${fieldDef.maxItems} items`,\n      severity: \"error\",\n    });\n  }\n\n  // Validate each item's fields\n  if (fieldDef.itemFields) {\n    for (let i = 0; i < value.length; i++) {\n      const item = value[i] as Record<string, unknown>;\n      const itemErrors = validateArrayItem(\n        path,\n        i,\n        item,\n        fieldDef.itemFields,\n        spec,\n        data,\n        computed,\n        visibility,\n        onlyVisible\n      );\n      errors.push(...itemErrors);\n    }\n  }\n\n  return errors;\n}\n\n/**\n * Validate fields within a single array item\n */\nfunction validateArrayItem(\n  arrayPath: string,\n  index: number,\n  item: Record<string, unknown>,\n  itemFields: Record<string, FieldDefinition>,\n  spec: Forma,\n  data: Record<string, unknown>,\n  computed: Record<string, unknown>,\n  visibility: Record<string, boolean>,\n  onlyVisible: boolean\n): FieldError[] {\n  const errors: FieldError[] = [];\n\n  for (const [fieldName, fieldDef] of Object.entries(itemFields)) {\n    const itemFieldPath = `${arrayPath}[${index}].${fieldName}`;\n\n    // Skip hidden fields\n    if (onlyVisible && visibility[itemFieldPath] === false) {\n      continue;\n    }\n\n    const value = item[fieldName];\n    const context: EvaluationContext = {\n      data,\n      computed,\n      referenceData: spec.referenceData,\n      item,\n      itemIndex: index,\n      value,\n    };\n\n    // Required check\n    const isRequired = fieldDef.requiredWhen\n      ? evaluateBoolean(fieldDef.requiredWhen, context)\n      : false;\n\n    if (isRequired && isEmpty(value)) {\n      errors.push({\n        field: itemFieldPath,\n        message: fieldDef.label\n          ? `${fieldDef.label} is required`\n          : \"This field is required\",\n        severity: \"error\",\n      });\n    }\n\n    // Custom validations\n    if (fieldDef.validations && !isEmpty(value)) {\n      const customErrors = validateCustomRules(itemFieldPath, fieldDef.validations, context);\n      errors.push(...customErrors);\n    }\n  }\n\n  return errors;\n}\n\n// ============================================================================\n// Single Field Validation\n// ============================================================================\n\n/**\n * Validate a single field\n *\n * @param fieldPath - Path to the field\n * @param data - Current form data\n * @param spec - Form specification\n * @returns Array of errors for this field\n */\nexport function validateSingleField(\n  fieldPath: string,\n  data: Record<string, unknown>,\n  spec: Forma\n): FieldError[] {\n  const fieldDef = spec.fields[fieldPath];\n  if (!fieldDef) {\n    return [];\n  }\n\n  const computed = calculate(data, spec);\n  const visibility = getVisibility(data, spec, { computed });\n  const schemaProperty = spec.schema.properties[fieldPath];\n\n  return validateField(\n    fieldPath,\n    data[fieldPath],\n    fieldDef,\n    schemaProperty,\n    spec,\n    data,\n    computed,\n    visibility,\n    true\n  );\n}\n"],"mappings":"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","names":["isRequired"]}

package/dist/engine/calculate.d.ts

@@ -4,6 +4,7 @@
  * Evaluates computed fields based on form data.
  * Computed values are derived from form data using FEEL expressions.
  */
+import { type FormatOptions } from "../format/index.js";
 import type { Forma, CalculationResult } from "../types.js";
 /**
  * Calculate all computed values from form data
@@ -49,9 +50,10 @@ export declare function calculateWithErrors(data: Record<string, unknown>, spec:
  * @param fieldName - Name of the computed field
  * @param data - Current form data
  * @param spec - Form specification
- * @returns Formatted string or null if not displayable
+ * @param options - Formatting options (locale, currency, nullDisplay)
+ * @returns Formatted string or null if field not found or value is null/undefined
  */
-export declare function getFormattedValue(fieldName: string, data: Record<string, unknown>, spec: Forma): string | null;
+export declare function getFormattedValue(fieldName: string, data: Record<string, unknown>, spec: Forma, options?: FormatOptions): string | null;
 /**
  * Calculate a single computed field
  *

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

@@ -1 +1 @@
-{"version":3,"file":"calculate.d.ts","sourceRoot":"","sources":["../../src/engine/calculate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,KAAK,EAGL,iBAAiB,EAElB,MAAM,aAAa,CAAC;AAMrB;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,EAAE,KAAK,GACV,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGzB;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,EAAE,KAAK,GACV,iBAAiB,CAsCnB;AAsKD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,EAAE,KAAK,GACV,MAAM,GAAG,IAAI,CAcf;AAkDD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,EAAE,KAAK,GACV,OAAO,CAGT"}
+{"version":3,"file":"calculate.d.ts","sourceRoot":"","sources":["../../src/engine/calculate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAe,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,KAAK,EACV,KAAK,EAGL,iBAAiB,EAElB,MAAM,aAAa,CAAC;AAMrB;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,EAAE,KAAK,GACV,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGzB;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,EAAE,KAAK,GACV,iBAAiB,CAsCnB;AAsKD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,EAAE,KAAK,EACX,OAAO,CAAC,EAAE,aAAa,GACtB,MAAM,GAAG,IAAI,CAkBf;AAMD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,EAAE,KAAK,GACV,OAAO,CAGT"}

package/dist/engine/index.cjs

@@ -20,9 +20,12 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/engine/index.ts
 var engine_exports = {};
 __export(engine_exports, {
+  DECIMAL_FORMAT_PATTERN: () => DECIMAL_FORMAT_PATTERN,
+  SUPPORTED_FORMATS: () => SUPPORTED_FORMATS,
   calculate: () => calculate,
   calculateField: () => calculateField,
   calculateWithErrors: () => calculateWithErrors,
+  formatValue: () => formatValue,
   getEnabled: () => getEnabled,
   getFormattedValue: () => getFormattedValue,
   getPageVisibility: () => getPageVisibility,
@@ -31,6 +34,8 @@ __export(engine_exports, {
   isEnabled: () => isEnabled,
   isFieldVisible: () => isFieldVisible,
   isRequired: () => isRequired,
+  isValidFormat: () => isValidFormat,
+  parseDecimalFormat: () => parseDecimalFormat,
   validate: () => validate,
   validateSingleField: () => validateSingleField
 });
@@ -102,6 +107,69 @@ Got: ${typeof result.value}`
   return result.value;
 }
 
+// src/format/index.ts
+var SUPPORTED_FORMATS = [
+  "currency",
+  "percent",
+  "date",
+  "datetime"
+];
+var DECIMAL_FORMAT_PATTERN = /^decimal\((\d+)\)$/;
+function isValidFormat(format) {
+  if (SUPPORTED_FORMATS.includes(format)) {
+    return true;
+  }
+  return DECIMAL_FORMAT_PATTERN.test(format);
+}
+function parseDecimalFormat(format) {
+  const match = format.match(DECIMAL_FORMAT_PATTERN);
+  if (match) {
+    return parseInt(match[1], 10);
+  }
+  return null;
+}
+function formatValue(value, format, options) {
+  const { locale = "en-US", currency = "USD", nullDisplay } = options ?? {};
+  if (value === null || value === void 0) {
+    if (nullDisplay !== void 0) {
+      return nullDisplay;
+    }
+    return String(value);
+  }
+  if (!format) {
+    return String(value);
+  }
+  const decimals = parseDecimalFormat(format);
+  if (decimals !== null) {
+    return typeof value === "number" ? value.toFixed(decimals) : String(value);
+  }
+  if (format === "currency") {
+    return typeof value === "number" ? new Intl.NumberFormat(locale, {
+      style: "currency",
+      currency
+    }).format(value) : String(value);
+  }
+  if (format === "percent") {
+    return typeof value === "number" ? new Intl.NumberFormat(locale, {
+      style: "percent",
+      minimumFractionDigits: 0,
+      maximumFractionDigits: 2
+    }).format(value) : String(value);
+  }
+  if (format === "date") {
+    const date = value instanceof Date ? value : new Date(String(value));
+    return !isNaN(date.getTime()) ? new Intl.DateTimeFormat(locale).format(date) : String(value);
+  }
+  if (format === "datetime") {
+    const date = value instanceof Date ? value : new Date(String(value));
+    return !isNaN(date.getTime()) ? new Intl.DateTimeFormat(locale, {
+      dateStyle: "short",
+      timeStyle: "short"
+    }).format(date) : String(value);
+  }
+  return String(value);
+}
+
 // src/engine/calculate.ts
 function calculate(data, spec) {
   const result = calculateWithErrors(data, spec);
@@ -224,7 +292,7 @@ function findComputedDependencies(expression, availableFields) {
   }
   return deps;
 }
-function getFormattedValue(fieldName, data, spec) {
+function getFormattedValue(fieldName, data, spec, options) {
   var _a;
   if (!((_a = spec.computed) == null ? void 0 : _a[fieldName])) {
     return null;
@@ -233,32 +301,12 @@ function getFormattedValue(fieldName, data, spec) {
   const computed = calculate(data, spec);
   const value = computed[fieldName];
   if (value === null || value === void 0) {
+    if ((options == null ? void 0 : options.nullDisplay) !== void 0) {
+      return formatValue(value, fieldDef.format, options);
+    }
     return null;
   }
-  return formatValue(value, fieldDef.format);
-}
-function formatValue(value, format) {
-  if (!format) {
-    return String(value);
-  }
-  const decimalMatch = format.match(/^decimal\((\d+)\)$/);
-  if (decimalMatch) {
-    const decimals = parseInt(decimalMatch[1], 10);
-    return typeof value === "number" ? value.toFixed(decimals) : String(value);
-  }
-  if (format === "currency") {
-    return typeof value === "number" ? new Intl.NumberFormat("en-US", {
-      style: "currency",
-      currency: "USD"
-    }).format(value) : String(value);
-  }
-  if (format === "percent") {
-    return typeof value === "number" ? new Intl.NumberFormat("en-US", {
-      style: "percent",
-      minimumFractionDigits: 1
-    }).format(value) : String(value);
-  }
-  return String(value);
+  return formatValue(value, fieldDef.format, options);
 }
 function calculateField(fieldName, data, spec) {
   const computed = calculate(data, spec);
@@ -884,9 +932,12 @@ function validateSingleField(fieldPath, data, spec) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  DECIMAL_FORMAT_PATTERN,
+  SUPPORTED_FORMATS,
   calculate,
   calculateField,
   calculateWithErrors,
+  formatValue,
   getEnabled,
   getFormattedValue,
   getPageVisibility,
@@ -895,6 +946,8 @@ function validateSingleField(fieldPath, data, spec) {
   isEnabled,
   isFieldVisible,
   isRequired,
+  isValidFormat,
+  parseDecimalFormat,
   validate,
   validateSingleField
 });