@fogpipe/forma-core 0.12.0-alpha.2 → 0.13.0

package/src/engine/enabled.ts

@@ -49,7 +49,7 @@ export interface EnabledOptions {
 export function getEnabled(
   data: Record<string, unknown>,
   spec: Forma,
-  options: EnabledOptions = {}
+  options: EnabledOptions = {},
 ): EnabledResult {
   const computed = options.computed ?? calculate(data, spec);
   const context: EvaluationContext = {
@@ -73,7 +73,15 @@ export function getEnabled(
     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,
+        );
       }
     }
   }
@@ -90,7 +98,7 @@ export function getEnabled(
  */
 function isFieldEnabled(
   fieldDef: FieldDefinition,
-  context: EvaluationContext
+  context: EvaluationContext,
 ): boolean {
   // If field has enabledWhen, evaluate it
   if (fieldDef.enabledWhen) {
@@ -111,7 +119,7 @@ function evaluateArrayItemEnabled(
   data: Record<string, unknown>,
   computed: Record<string, unknown>,
   spec: Forma,
-  result: EnabledResult
+  result: EnabledResult,
 ): void {
   if (!fieldDef.itemFields) return;
 
@@ -125,7 +133,9 @@ function evaluateArrayItemEnabled(
       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);
     }
@@ -143,7 +153,7 @@ function evaluateArrayItemEnabled(
 export function isEnabled(
   fieldPath: string,
   data: Record<string, unknown>,
-  spec: Forma
+  spec: Forma,
 ): boolean {
   const fieldDef = spec.fields[fieldPath];
   if (!fieldDef) {

package/src/engine/index.ts

@@ -38,41 +38,21 @@ export type {
 } from "./visibility.js";
 
 // Required
-export {
-  getRequired,
-  isRequired,
-} from "./required.js";
+export { getRequired, isRequired } from "./required.js";
 
-export type {
-  RequiredOptions,
-} from "./required.js";
+export type { RequiredOptions } from "./required.js";
 
 // Enabled
-export {
-  getEnabled,
-  isEnabled,
-} from "./enabled.js";
+export { getEnabled, isEnabled } from "./enabled.js";
 
-export type {
-  EnabledOptions,
-} from "./enabled.js";
+export type { EnabledOptions } from "./enabled.js";
 
 // Readonly
-export {
-  getReadonly,
-  isReadonly,
-} from "./readonly.js";
+export { getReadonly, isReadonly } from "./readonly.js";
 
-export type {
-  ReadonlyOptions,
-} from "./readonly.js";
+export type { ReadonlyOptions } from "./readonly.js";
 
 // Validate
-export {
-  validate,
-  validateSingleField,
-} from "./validate.js";
+export { validate, validateSingleField } from "./validate.js";
 
-export type {
-  ValidateOptions,
-} from "./validate.js";
+export type { ValidateOptions } from "./validate.js";

package/src/engine/readonly.ts

@@ -53,7 +53,7 @@ export interface ReadonlyOptions {
 export function getReadonly(
   data: Record<string, unknown>,
   spec: Forma,
-  options: ReadonlyOptions = {}
+  options: ReadonlyOptions = {},
 ): ReadonlyResult {
   const computed = options.computed ?? calculate(data, spec);
   const context: EvaluationContext = {
@@ -77,7 +77,15 @@ export function getReadonly(
     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,
+        );
       }
     }
   }
@@ -94,7 +102,7 @@ export function getReadonly(
  */
 function isFieldReadonly(
   fieldDef: FieldDefinition,
-  context: EvaluationContext
+  context: EvaluationContext,
 ): boolean {
   // If field has readonlyWhen, evaluate it
   if (fieldDef.readonlyWhen) {
@@ -115,7 +123,7 @@ function evaluateArrayItemReadonly(
   data: Record<string, unknown>,
   computed: Record<string, unknown>,
   spec: Forma,
-  result: ReadonlyResult
+  result: ReadonlyResult,
 ): void {
   if (!fieldDef.itemFields) return;
 
@@ -129,7 +137,9 @@ function evaluateArrayItemReadonly(
       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);
     }
@@ -147,7 +157,7 @@ function evaluateArrayItemReadonly(
 export function isReadonly(
   fieldPath: string,
   data: Record<string, unknown>,
-  spec: Forma
+  spec: Forma,
 ): boolean {
   const fieldDef = spec.fields[fieldPath];
   if (!fieldDef) {

package/src/engine/required.ts

@@ -48,7 +48,7 @@ export interface RequiredOptions {
 export function getRequired(
   data: Record<string, unknown>,
   spec: Forma,
-  options: RequiredOptions = {}
+  options: RequiredOptions = {},
 ): RequiredFieldsResult {
   const computed = options.computed ?? calculate(data, spec);
   const context: EvaluationContext = {
@@ -82,13 +82,15 @@ export function getRequired(
             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,
               itemFieldDef,
               spec,
-              itemContext
+              itemContext,
             );
           }
         }
@@ -111,7 +113,7 @@ export function isFieldRequired(
   fieldPath: string,
   fieldDef: FieldDefinition,
   spec: Forma,
-  context: EvaluationContext
+  context: EvaluationContext,
 ): boolean {
   // If field has requiredWhen, evaluate it
   if (fieldDef.requiredWhen) {
@@ -133,7 +135,7 @@ export function isFieldRequired(
 export function isRequired(
   fieldPath: string,
   data: Record<string, unknown>,
-  spec: Forma
+  spec: Forma,
 ): boolean {
   const fieldDef = spec.fields[fieldPath];
   if (!fieldDef) {

package/src/engine/validate.ts

@@ -73,7 +73,7 @@ export interface ValidateOptions {
 export function validate(
   data: Record<string, unknown>,
   spec: Forma,
-  options: ValidateOptions = {}
+  options: ValidateOptions = {},
 ): ValidationResult {
   const { onlyVisible = true } = options;
 
@@ -81,7 +81,8 @@ export function validate(
   const computed = options.computed ?? calculate(data, spec);
 
   // Calculate visibility
-  const visibility = options.visibility ?? getVisibility(data, spec, { computed });
+  const visibility =
+    options.visibility ?? getVisibility(data, spec, { computed });
 
   // Collect errors
   const errors: FieldError[] = [];
@@ -114,7 +115,7 @@ export function validate(
       data,
       computed,
       visibility,
-      onlyVisible
+      onlyVisible,
     );
 
     errors.push(...fieldErrors);
@@ -142,7 +143,7 @@ function validateField(
   data: Record<string, unknown>,
   computed: Record<string, unknown>,
   visibility: Record<string, boolean>,
-  onlyVisible: boolean
+  onlyVisible: boolean,
 ): FieldError[] {
   const errors: FieldError[] = [];
   const context: EvaluationContext = {
@@ -174,7 +175,11 @@ function validateField(
 
   // 3. Custom FEEL validation rules
   if (fieldDef.validations && !isEmpty(value)) {
-    const customErrors = validateCustomRules(path, fieldDef.validations, context);
+    const customErrors = validateCustomRules(
+      path,
+      fieldDef.validations,
+      context,
+    );
     errors.push(...customErrors);
   }
 
@@ -189,7 +194,7 @@ function validateField(
       data,
       computed,
       visibility,
-      onlyVisible
+      onlyVisible,
     );
     errors.push(...arrayErrors);
   }
@@ -218,7 +223,7 @@ function validateType(
   path: string,
   value: unknown,
   schema: JSONSchemaProperty,
-  fieldDef: { label?: string }
+  fieldDef: { label?: string },
 ): FieldError | null {
   const label = fieldDef.label ?? path;
 
@@ -320,7 +325,10 @@ function validateType(
         }
       }
 
-      if ("exclusiveMinimum" in schema && schema.exclusiveMinimum !== undefined) {
+      if (
+        "exclusiveMinimum" in schema &&
+        schema.exclusiveMinimum !== undefined
+      ) {
         if (value <= schema.exclusiveMinimum) {
           return {
             field: path,
@@ -330,7 +338,10 @@ function validateType(
         }
       }
 
-      if ("exclusiveMaximum" in schema && schema.exclusiveMaximum !== undefined) {
+      if (
+        "exclusiveMaximum" in schema &&
+        schema.exclusiveMaximum !== undefined
+      ) {
         if (value >= schema.exclusiveMaximum) {
           return {
             field: path,
@@ -344,7 +355,8 @@ function validateType(
         const multipleOf = schema.multipleOf;
         // Use epsilon comparison to handle floating point precision issues
         const remainder = Math.abs(value % multipleOf);
-        const isValid = remainder < 1e-10 || Math.abs(remainder - multipleOf) < 1e-10;
+        const isValid =
+          remainder < 1e-10 || Math.abs(remainder - multipleOf) < 1e-10;
         if (!isValid) {
           return {
             field: path,
@@ -402,7 +414,7 @@ function validateFormat(
   path: string,
   value: string,
   format: string,
-  label: string
+  label: string,
 ): FieldError | null {
   switch (format) {
     case "email": {
@@ -430,7 +442,10 @@ function validateFormat(
       }
       // Verify the date is actually valid (e.g., not Feb 30)
       const parsed = new Date(value + "T00:00:00Z");
-      if (isNaN(parsed.getTime()) || parsed.toISOString().slice(0, 10) !== value) {
+      if (
+        isNaN(parsed.getTime()) ||
+        parsed.toISOString().slice(0, 10) !== value
+      ) {
         return {
           field: path,
           message: `${label} must be a valid date`,
@@ -465,7 +480,8 @@ function validateFormat(
     }
 
     case "uuid": {
-      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;
+      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;
       if (!uuidRegex.test(value)) {
         return {
           field: path,
@@ -491,7 +507,7 @@ function validateFormat(
 function validateCustomRules(
   path: string,
   rules: ValidationRule[],
-  context: EvaluationContext
+  context: EvaluationContext,
 ): FieldError[] {
   const errors: FieldError[] = [];
 
@@ -526,13 +542,14 @@ function validateArray(
   data: Record<string, unknown>,
   computed: Record<string, unknown>,
   visibility: Record<string, boolean>,
-  onlyVisible: boolean
+  onlyVisible: boolean,
 ): FieldError[] {
   const errors: FieldError[] = [];
   const label = fieldDef.label ?? path;
 
   // Get array schema for minItems/maxItems fallback
-  const arraySchema = schemaProperty?.type === "array" ? schemaProperty : undefined;
+  const arraySchema =
+    schemaProperty?.type === "array" ? schemaProperty : undefined;
 
   // Check min/max items - fieldDef overrides schema
   const minItems = fieldDef.minItems ?? arraySchema?.minItems;
@@ -571,7 +588,7 @@ function validateArray(
         data,
         computed,
         visibility,
-        onlyVisible
+        onlyVisible,
       );
       errors.push(...itemErrors);
     }
@@ -593,7 +610,7 @@ function validateArrayItem(
   data: Record<string, unknown>,
   computed: Record<string, unknown>,
   visibility: Record<string, boolean>,
-  onlyVisible: boolean
+  onlyVisible: boolean,
 ): FieldError[] {
   const errors: FieldError[] = [];
 
@@ -649,7 +666,7 @@ function validateArrayItem(
         itemFieldPath,
         value,
         fieldSchema,
-        fieldDef ?? { label: fieldName }
+        fieldDef ?? { label: fieldName },
       );
       if (typeError) {
         errors.push(typeError);
@@ -658,7 +675,11 @@ function validateArrayItem(
 
     // Custom validations from fieldDef
     if (fieldDef?.validations && !isEmpty(value)) {
-      const customErrors = validateCustomRules(itemFieldPath, fieldDef.validations, context);
+      const customErrors = validateCustomRules(
+        itemFieldPath,
+        fieldDef.validations,
+        context,
+      );
       errors.push(...customErrors);
     }
   }
@@ -681,7 +702,7 @@ function validateArrayItem(
 export function validateSingleField(
   fieldPath: string,
   data: Record<string, unknown>,
-  spec: Forma
+  spec: Forma,
 ): FieldError[] {
   const fieldDef = spec.fields[fieldPath];
   if (!fieldDef) {
@@ -701,6 +722,6 @@ export function validateSingleField(
     data,
     computed,
     visibility,
-    true
+    true,
   );
 }

package/src/engine/visibility.ts

@@ -46,7 +46,7 @@ export interface OptionsVisibilityResult {
  */
 function filterOptionsByContext(
   options: readonly SelectOption[],
-  context: EvaluationContext
+  context: EvaluationContext,
 ): SelectOption[] {
   return options.filter((option) => {
     if (!option.visibleWhen) return true;
@@ -67,7 +67,7 @@ function processArrayItemOptions(
   fieldDef: ArrayFieldDefinition,
   arrayData: readonly unknown[],
   baseContext: EvaluationContext,
-  result: Record<string, SelectOption[]>
+  result: Record<string, SelectOption[]>,
 ): void {
   if (!fieldDef.itemFields) return;
 
@@ -79,10 +79,19 @@ function processArrayItemOptions(
       itemIndex: i,
     };
 
-    for (const [itemFieldName, itemFieldDef] of Object.entries(fieldDef.itemFields)) {
-      if (isSelectionField(itemFieldDef) && itemFieldDef.options && itemFieldDef.options.length > 0) {
+    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,
+        );
       }
     }
   }
@@ -113,7 +122,7 @@ function processArrayItemOptions(
 export function getVisibility(
   data: Record<string, unknown>,
   spec: Forma,
-  options: VisibilityOptions = {}
+  options: VisibilityOptions = {},
 ): VisibilityResult {
   const computed = options.computed ?? calculate(data, spec);
 
@@ -143,7 +152,7 @@ function evaluateFieldVisibility(
   fieldDef: FieldDefinition,
   data: Record<string, unknown>,
   context: EvaluationContext,
-  result: VisibilityResult
+  result: VisibilityResult,
 ): void {
   if (fieldDef.visibleWhen) {
     result[path] = evaluateBoolean(fieldDef.visibleWhen, context);
@@ -171,7 +180,7 @@ function evaluateArrayItemVisibility(
   fieldDef: ArrayFieldDefinition,
   arrayData: unknown[],
   baseContext: EvaluationContext,
-  result: VisibilityResult
+  result: VisibilityResult,
 ): void {
   if (!fieldDef.itemFields) return;
 
@@ -183,11 +192,16 @@ function evaluateArrayItemVisibility(
       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;
       }
@@ -204,7 +218,7 @@ export function isFieldVisible(
   fieldPath: string,
   data: Record<string, unknown>,
   spec: Forma,
-  options: VisibilityOptions = {}
+  options: VisibilityOptions = {},
 ): boolean {
   const fieldDef = spec.fields[fieldPath];
   if (!fieldDef) {
@@ -235,7 +249,7 @@ export function isFieldVisible(
 export function getPageVisibility(
   data: Record<string, unknown>,
   spec: Forma,
-  options: VisibilityOptions = {}
+  options: VisibilityOptions = {},
 ): Record<string, boolean> {
   if (!spec.pages) {
     return {};
@@ -294,7 +308,7 @@ export function getPageVisibility(
 export function getOptionsVisibility(
   data: Record<string, unknown>,
   spec: Forma,
-  options: VisibilityOptions = {}
+  options: VisibilityOptions = {},
 ): OptionsVisibilityResult {
   const computed = options.computed ?? calculate(data, spec);
   const result: Record<string, SelectOption[]> = {};
@@ -310,7 +324,11 @@ export function getOptionsVisibility(
     if (!fieldDef) continue;
 
     // Top-level fields with options
-    if (isSelectionField(fieldDef) && fieldDef.options && fieldDef.options.length > 0) {
+    if (
+      isSelectionField(fieldDef) &&
+      fieldDef.options &&
+      fieldDef.options.length > 0
+    ) {
       result[fieldPath] = filterOptionsByContext(fieldDef.options, baseContext);
     }
 
@@ -318,7 +336,13 @@ export function getOptionsVisibility(
     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,
+        );
       }
     }
   }
@@ -360,7 +384,7 @@ export function getVisibleOptions(
     computed?: Record<string, unknown>;
     item?: Record<string, unknown>;
     itemIndex?: number;
-  } = {}
+  } = {},
 ): SelectOption[] {
   if (!options || options.length === 0) return [];
 

package/src/feel/index.ts

@@ -110,7 +110,7 @@ function buildFeelContext(ctx: EvaluationContext): Record<string, unknown> {
  */
 export function evaluate<T = unknown>(
   expression: FEELExpression,
-  context: EvaluationContext
+  context: EvaluationContext,
 ): EvaluationOutcome<T> {
   try {
     const feelContext = buildFeelContext(context);
@@ -140,13 +140,13 @@ export function evaluate<T = unknown>(
  */
 export function evaluateBoolean(
   expression: FEELExpression,
-  context: EvaluationContext
+  context: EvaluationContext,
 ): boolean {
   const result = evaluate<boolean>(expression, context);
 
   if (!result.success) {
     console.warn(
-      `FEEL expression error: ${result.error}\nExpression: ${result.expression}`
+      `FEEL expression error: ${result.error}\nExpression: ${result.expression}`,
     );
     return false;
   }
@@ -166,14 +166,14 @@ export function evaluateBoolean(
   if (result.value === null || result.value === undefined) {
     console.warn(
       `[forma] FEEL expression returned null (treating as false): "${expression}"\n` +
-        `This often means a referenced field is undefined. See docs for null-safe patterns.`
+        `This often means a referenced field is undefined. See docs for null-safe patterns.`,
     );
     return false;
   }
 
   if (typeof result.value !== "boolean") {
     console.warn(
-      `FEEL expression did not return boolean: ${expression}\nGot: ${typeof result.value}`
+      `FEEL expression did not return boolean: ${expression}\nGot: ${typeof result.value}`,
     );
     return false;
   }
@@ -192,20 +192,20 @@ export function evaluateBoolean(
  */
 export function evaluateNumber(
   expression: FEELExpression,
-  context: EvaluationContext
+  context: EvaluationContext,
 ): number | null {
   const result = evaluate<number>(expression, context);
 
   if (!result.success) {
     console.warn(
-      `FEEL expression error: ${result.error}\nExpression: ${result.expression}`
+      `FEEL expression error: ${result.error}\nExpression: ${result.expression}`,
     );
     return null;
   }
 
   if (typeof result.value !== "number") {
     console.warn(
-      `FEEL expression did not return number: ${expression}\nGot: ${typeof result.value}`
+      `FEEL expression did not return number: ${expression}\nGot: ${typeof result.value}`,
     );
     return null;
   }
@@ -222,20 +222,20 @@ export function evaluateNumber(
  */
 export function evaluateString(
   expression: FEELExpression,
-  context: EvaluationContext
+  context: EvaluationContext,
 ): string | null {
   const result = evaluate<string>(expression, context);
 
   if (!result.success) {
     console.warn(
-      `FEEL expression error: ${result.error}\nExpression: ${result.expression}`
+      `FEEL expression error: ${result.error}\nExpression: ${result.expression}`,
     );
     return null;
   }
 
   if (typeof result.value !== "string") {
     console.warn(
-      `FEEL expression did not return string: ${expression}\nGot: ${typeof result.value}`
+      `FEEL expression did not return string: ${expression}\nGot: ${typeof result.value}`,
     );
     return null;
   }
@@ -258,7 +258,7 @@ export function evaluateString(
  */
 export function evaluateBooleanBatch(
   expressions: Record<string, FEELExpression>,
-  context: EvaluationContext
+  context: EvaluationContext,
 ): Record<string, boolean> {
   const results: Record<string, boolean> = {};
 

package/src/format/index.ts

@@ -112,7 +112,7 @@ export function parseDecimalFormat(format: string): number | null {
 export function formatValue(
   value: unknown,
   format?: string,
-  options?: FormatOptions
+  options?: FormatOptions,
 ): string {
   const { locale = "en-US", currency = "USD", nullDisplay } = options ?? {};