@form-eng/core 1.0.0 → 1.1.0

package/dist/index.d.mts

@@ -30,7 +30,7 @@ interface IFieldCondition {
     /** The field name to evaluate */
     field: string;
     /** Comparison operator */
-    operator: "equals" | "notEquals" | "greaterThan" | "lessThan" | "greaterThanOrEqual" | "lessThanOrEqual" | "contains" | "notContains" | "startsWith" | "endsWith" | "in" | "notIn" | "isEmpty" | "isNotEmpty" | "matches";
+    operator: "equals" | "notEquals" | "greaterThan" | "lessThan" | "greaterThanOrEqual" | "lessThanOrEqual" | "contains" | "notContains" | "startsWith" | "endsWith" | "in" | "notIn" | "isEmpty" | "isNotEmpty" | "matches" | "arrayContains" | "arrayNotContains" | "arrayLengthEquals" | "arrayLengthGreaterThan" | "arrayLengthLessThan";
     /** The value to compare against. Not required for isEmpty/isNotEmpty. */
     value?: unknown;
 }
@@ -96,6 +96,8 @@ interface IFieldEffect {
     computedValue?: string;
     /** Override field ordering */
     fieldOrder?: string[];
+    /** Directly set the field's value when the rule condition is met */
+    setValue?: unknown;
     /** Apply effects to OTHER fields (keyed by field name) */
     fields?: Record<string, IFieldEffect>;
 }
@@ -263,9 +265,7 @@ interface IFormSettings {
 }
 
 /**
- * Props passed to injected field components (v2 schema).
- *
- * This replaces the v1 IHookFieldSharedProps type.
+ * Props passed to injected field components via React.cloneElement.
  * The generic parameter T types the `config` metadata object.
  */
 interface IFieldProps<T = Record<string, unknown>> {
@@ -315,9 +315,7 @@ interface IFieldProps<T = Record<string, unknown>> {
 
 /**
  * Runtime state for a single field after all rules have been evaluated.
- *
- * This replaces the v1 IBusinessRule type. Contains the evaluated state
- * consumed by form components to determine rendering behavior.
+ * Consumed by form components to determine rendering behavior.
  */
 interface IRuntimeFieldState {
     /** UI component type to render. May be swapped by rules. */
@@ -348,11 +346,16 @@ interface IRuntimeFieldState {
     dependsOnFields?: string[];
     /** The source rules that produced this state (for tracing/debugging). */
     activeRuleIds?: string[];
+    /**
+     * A pending value to set on the field, produced by a rule with setValue effect.
+     * The form component reads this and calls RHF setValue. Undefined if no rule set a value.
+     */
+    pendingSetValue?: {
+        value: unknown;
+    };
 }
 /**
  * Runtime state for the entire form.
- *
- * This replaces the v1 IConfigBusinessRules + IBusinessRulesState types.
  */
 interface IRuntimeFormState {
     /** Per-field runtime state keyed by field name. */
@@ -362,8 +365,6 @@ interface IRuntimeFormState {
 }
 /**
  * State stored in the rules engine provider (keyed by config name).
- *
- * This replaces the v1 IBusinessRulesState type.
  */
 interface IRulesEngineState {
     configs: Record<string, IRuntimeFormState>;
@@ -605,6 +606,15 @@ declare const ComponentTypes: {
     readonly ReadOnlyWithButton: "ReadOnlyWithButton";
     readonly ChoiceSet: "ChoiceSet";
     readonly FieldArray: "FieldArray";
+    readonly RadioGroup: "RadioGroup";
+    readonly CheckboxGroup: "CheckboxGroup";
+    readonly Rating: "Rating";
+    readonly ColorPicker: "ColorPicker";
+    readonly Autocomplete: "Autocomplete";
+    readonly FileUpload: "FileUpload";
+    readonly DateRange: "DateRange";
+    readonly DateTime: "DateTime";
+    readonly PhoneInput: "PhoneInput";
 };
 /** Form-level constants */
 declare const FormConstants: {
@@ -804,6 +814,27 @@ interface IValidationContext {
     values: IEntityData;
     signal?: AbortSignal;
 }
+/** Metadata describing a validator for use in designer UIs and documentation. */
+interface IValidatorMetadata {
+    /** Human-readable display name */
+    label: string;
+    /** Optional description of what the validator checks */
+    description?: string;
+    /** Named parameters the validator accepts */
+    params?: Record<string, {
+        type: "string" | "number" | "boolean";
+        label: string;
+        required?: boolean;
+    }>;
+}
+/** Register metadata for a custom (or built-in) validator */
+declare function registerValidatorMetadata(name: string, metadata: IValidatorMetadata): void;
+/** Get metadata for a specific validator by name */
+declare function getValidatorMetadata(name: string): IValidatorMetadata | undefined;
+/** Get all registered validator metadata */
+declare function getAllValidatorMetadata(): Record<string, IValidatorMetadata>;
+/** Reset validator metadata registry (for testing) */
+declare function resetValidatorMetadataRegistry(): void;
 /** Register custom validators (merge into registry) */
 declare function registerValidators(custom: Record<string, ValidatorFn>): void;
 /** Get a validator by name */
@@ -1454,4 +1485,4 @@ declare function getTimeline(): ITimelineEvent[];
  */
 declare function clearTimeline(): void;
 
-export { CheckAsyncFieldValidationRules, CheckDefaultValues, CheckFieldValidationRules, CheckValidDropdownOptions, ComponentTypes, ConfirmInputsModal, type Dictionary, ExecuteComputedValue, FIELD_PARENT_PREFIX, FieldArray, FieldWrapper, FormConstants, FormDevTools, FormEngine, FormErrorBoundary, FormFields, FormStrings, GetChildEntity, GetComputedValuesOnCreate, GetComputedValuesOnDirtyFields, GetConfirmInputModalProps, GetFieldsToRender, type IAnalyticsCallbacks, type IClearRulesAction, type ICondition, type IConfigValidationError, type IConfirmInputModalProps, type ICoreLocaleStrings, type ICycleError, type IDraftPersistenceOptions, type IDraftState, type IEntityData, type IFieldArrayProps, type IFieldCondition, type IFieldConfig, type IFieldEffect, type IFieldProps, type IFieldToRender, type IFormAnalytics, type IFormConfig, type IFormDevToolsProps, type IFormEngineSharedProps, type IFormSettings, type IInjectedFieldProvider, type IJsonSchemaNode, type ILogicalCondition, type IOption, type IRjsfConvertOptions, type IRjsfUiSchema, type IRule, type IRuleTraceEvent, type IRulesEngineProvider, type IRulesEngineState, type IRuntimeFieldState, type IRuntimeFormState, type ISetRulesAction, type ITimelineEvent, type IUpdateRulesAction, type IUseDraftPersistenceResult, type IValidationContext, type IValidationRule, type IValueFunctionContext, type IWizardConfig, type IWizardFormProps, type IWizardNavigationProps, type IWizardStep, type IWizardStepHeaderProps, InitOnCreateFormState, InitOnEditFormState, InjectedFieldProvider, IsExpandVisible, _default as RenderField, type RulesEngineAction, RulesEngineActionType, RulesEngineProvider, ShowField, SortOptions as SortDropdownOptions, SortOptions$1 as SortOptions, type SubEntityType, type TimelineEventType, type TypedFieldConfig, UseInjectedFieldContext, UseRulesEngineContext, type ValidatorFn, type ValueFunction, WizardForm, buildDefaultFieldStates, buildDependencyGraph, clearRuleTraceLog, clearTimeline, convertBooleanToYesOrNoText, createLazyFieldRegistry, createMaxLengthRule, createMinLengthRule, createNumericRangeRule, createOption, createPatternRule, createRequiredIfRule, deepCopy, defineFormConfig, deserializeFormState, detectDependencyCycles, detectSelfDependencies, disableRuleTracing, enableRuleTracing, evaluateAffectedFields, evaluateAllRules, evaluateCondition, evaluateExpression, executeValueFunction, extractConditionDependencies, extractExpressionDependencies, extractFunctionDependencies, flushRenderCycle, fromRjsfSchema, getCurrentLocale, getLastRenderedFields, getLocaleString, getRenderCounts, getRuleTraceLog, getStepFieldOrder, getStepFields, getStepIndex, getTimeline, getTotalFormRenders, getValidator, getValidatorRegistry, getValueFunction, getVisibleSteps, isEmpty, isFieldCondition, isLogicalCondition, isNull, isRuleTracingEnabled, isStepValid, isStringEmpty, logEvent, registerLocale, registerValidators, registerValueFunctions, resetLocale, resetRenderTracker, resetValidatorRegistry, resetValueFunctionRegistry, runSyncValidations, runValidations, serializeFormState, sortDropdownOptions, toRjsfSchema, topologicalSort, traceRuleEvent, trackRender, useBeforeUnload, useDraftPersistence, useFormAnalytics, validateDependencyGraph, validateFieldConfigs, validateStepFields, zodSchemaToFieldConfig };
+export { CheckAsyncFieldValidationRules, CheckDefaultValues, CheckFieldValidationRules, CheckValidDropdownOptions, ComponentTypes, ConfirmInputsModal, type Dictionary, ExecuteComputedValue, FIELD_PARENT_PREFIX, FieldArray, FieldWrapper, FormConstants, FormDevTools, FormEngine, FormErrorBoundary, FormFields, FormStrings, GetChildEntity, GetComputedValuesOnCreate, GetComputedValuesOnDirtyFields, GetConfirmInputModalProps, GetFieldsToRender, type IAnalyticsCallbacks, type IClearRulesAction, type ICondition, type IConfigValidationError, type IConfirmInputModalProps, type ICoreLocaleStrings, type ICycleError, type IDraftPersistenceOptions, type IDraftState, type IEntityData, type IFieldArrayProps, type IFieldCondition, type IFieldConfig, type IFieldEffect, type IFieldProps, type IFieldToRender, type IFormAnalytics, type IFormConfig, type IFormDevToolsProps, type IFormEngineSharedProps, type IFormSettings, type IInjectedFieldProvider, type IJsonSchemaNode, type ILogicalCondition, type IOption, type IRjsfConvertOptions, type IRjsfUiSchema, type IRule, type IRuleTraceEvent, type IRulesEngineProvider, type IRulesEngineState, type IRuntimeFieldState, type IRuntimeFormState, type ISetRulesAction, type ITimelineEvent, type IUpdateRulesAction, type IUseDraftPersistenceResult, type IValidationContext, type IValidationRule, type IValidatorMetadata, type IValueFunctionContext, type IWizardConfig, type IWizardFormProps, type IWizardNavigationProps, type IWizardStep, type IWizardStepHeaderProps, InitOnCreateFormState, InitOnEditFormState, InjectedFieldProvider, IsExpandVisible, _default as RenderField, type RulesEngineAction, RulesEngineActionType, RulesEngineProvider, ShowField, SortOptions as SortDropdownOptions, SortOptions$1 as SortOptions, type SubEntityType, type TimelineEventType, type TypedFieldConfig, UseInjectedFieldContext, UseRulesEngineContext, type ValidatorFn, type ValueFunction, WizardForm, buildDefaultFieldStates, buildDependencyGraph, clearRuleTraceLog, clearTimeline, convertBooleanToYesOrNoText, createLazyFieldRegistry, createMaxLengthRule, createMinLengthRule, createNumericRangeRule, createOption, createPatternRule, createRequiredIfRule, deepCopy, defineFormConfig, deserializeFormState, detectDependencyCycles, detectSelfDependencies, disableRuleTracing, enableRuleTracing, evaluateAffectedFields, evaluateAllRules, evaluateCondition, evaluateExpression, executeValueFunction, extractConditionDependencies, extractExpressionDependencies, extractFunctionDependencies, flushRenderCycle, fromRjsfSchema, getAllValidatorMetadata, getCurrentLocale, getLastRenderedFields, getLocaleString, getRenderCounts, getRuleTraceLog, getStepFieldOrder, getStepFields, getStepIndex, getTimeline, getTotalFormRenders, getValidator, getValidatorMetadata, getValidatorRegistry, getValueFunction, getVisibleSteps, isEmpty, isFieldCondition, isLogicalCondition, isNull, isRuleTracingEnabled, isStepValid, isStringEmpty, logEvent, registerLocale, registerValidatorMetadata, registerValidators, registerValueFunctions, resetLocale, resetRenderTracker, resetValidatorMetadataRegistry, resetValidatorRegistry, resetValueFunctionRegistry, runSyncValidations, runValidations, serializeFormState, sortDropdownOptions, toRjsfSchema, topologicalSort, traceRuleEvent, trackRender, useBeforeUnload, useDraftPersistence, useFormAnalytics, validateDependencyGraph, validateFieldConfigs, validateStepFields, zodSchemaToFieldConfig };

package/dist/index.d.ts

@@ -30,7 +30,7 @@ interface IFieldCondition {
     /** The field name to evaluate */
     field: string;
     /** Comparison operator */
-    operator: "equals" | "notEquals" | "greaterThan" | "lessThan" | "greaterThanOrEqual" | "lessThanOrEqual" | "contains" | "notContains" | "startsWith" | "endsWith" | "in" | "notIn" | "isEmpty" | "isNotEmpty" | "matches";
+    operator: "equals" | "notEquals" | "greaterThan" | "lessThan" | "greaterThanOrEqual" | "lessThanOrEqual" | "contains" | "notContains" | "startsWith" | "endsWith" | "in" | "notIn" | "isEmpty" | "isNotEmpty" | "matches" | "arrayContains" | "arrayNotContains" | "arrayLengthEquals" | "arrayLengthGreaterThan" | "arrayLengthLessThan";
     /** The value to compare against. Not required for isEmpty/isNotEmpty. */
     value?: unknown;
 }
@@ -96,6 +96,8 @@ interface IFieldEffect {
     computedValue?: string;
     /** Override field ordering */
     fieldOrder?: string[];
+    /** Directly set the field's value when the rule condition is met */
+    setValue?: unknown;
     /** Apply effects to OTHER fields (keyed by field name) */
     fields?: Record<string, IFieldEffect>;
 }
@@ -263,9 +265,7 @@ interface IFormSettings {
 }
 
 /**
- * Props passed to injected field components (v2 schema).
- *
- * This replaces the v1 IHookFieldSharedProps type.
+ * Props passed to injected field components via React.cloneElement.
  * The generic parameter T types the `config` metadata object.
  */
 interface IFieldProps<T = Record<string, unknown>> {
@@ -315,9 +315,7 @@ interface IFieldProps<T = Record<string, unknown>> {
 
 /**
  * Runtime state for a single field after all rules have been evaluated.
- *
- * This replaces the v1 IBusinessRule type. Contains the evaluated state
- * consumed by form components to determine rendering behavior.
+ * Consumed by form components to determine rendering behavior.
  */
 interface IRuntimeFieldState {
     /** UI component type to render. May be swapped by rules. */
@@ -348,11 +346,16 @@ interface IRuntimeFieldState {
     dependsOnFields?: string[];
     /** The source rules that produced this state (for tracing/debugging). */
     activeRuleIds?: string[];
+    /**
+     * A pending value to set on the field, produced by a rule with setValue effect.
+     * The form component reads this and calls RHF setValue. Undefined if no rule set a value.
+     */
+    pendingSetValue?: {
+        value: unknown;
+    };
 }
 /**
  * Runtime state for the entire form.
- *
- * This replaces the v1 IConfigBusinessRules + IBusinessRulesState types.
  */
 interface IRuntimeFormState {
     /** Per-field runtime state keyed by field name. */
@@ -362,8 +365,6 @@ interface IRuntimeFormState {
 }
 /**
  * State stored in the rules engine provider (keyed by config name).
- *
- * This replaces the v1 IBusinessRulesState type.
  */
 interface IRulesEngineState {
     configs: Record<string, IRuntimeFormState>;
@@ -605,6 +606,15 @@ declare const ComponentTypes: {
     readonly ReadOnlyWithButton: "ReadOnlyWithButton";
     readonly ChoiceSet: "ChoiceSet";
     readonly FieldArray: "FieldArray";
+    readonly RadioGroup: "RadioGroup";
+    readonly CheckboxGroup: "CheckboxGroup";
+    readonly Rating: "Rating";
+    readonly ColorPicker: "ColorPicker";
+    readonly Autocomplete: "Autocomplete";
+    readonly FileUpload: "FileUpload";
+    readonly DateRange: "DateRange";
+    readonly DateTime: "DateTime";
+    readonly PhoneInput: "PhoneInput";
 };
 /** Form-level constants */
 declare const FormConstants: {
@@ -804,6 +814,27 @@ interface IValidationContext {
     values: IEntityData;
     signal?: AbortSignal;
 }
+/** Metadata describing a validator for use in designer UIs and documentation. */
+interface IValidatorMetadata {
+    /** Human-readable display name */
+    label: string;
+    /** Optional description of what the validator checks */
+    description?: string;
+    /** Named parameters the validator accepts */
+    params?: Record<string, {
+        type: "string" | "number" | "boolean";
+        label: string;
+        required?: boolean;
+    }>;
+}
+/** Register metadata for a custom (or built-in) validator */
+declare function registerValidatorMetadata(name: string, metadata: IValidatorMetadata): void;
+/** Get metadata for a specific validator by name */
+declare function getValidatorMetadata(name: string): IValidatorMetadata | undefined;
+/** Get all registered validator metadata */
+declare function getAllValidatorMetadata(): Record<string, IValidatorMetadata>;
+/** Reset validator metadata registry (for testing) */
+declare function resetValidatorMetadataRegistry(): void;
 /** Register custom validators (merge into registry) */
 declare function registerValidators(custom: Record<string, ValidatorFn>): void;
 /** Get a validator by name */
@@ -1454,4 +1485,4 @@ declare function getTimeline(): ITimelineEvent[];
  */
 declare function clearTimeline(): void;
 
-export { CheckAsyncFieldValidationRules, CheckDefaultValues, CheckFieldValidationRules, CheckValidDropdownOptions, ComponentTypes, ConfirmInputsModal, type Dictionary, ExecuteComputedValue, FIELD_PARENT_PREFIX, FieldArray, FieldWrapper, FormConstants, FormDevTools, FormEngine, FormErrorBoundary, FormFields, FormStrings, GetChildEntity, GetComputedValuesOnCreate, GetComputedValuesOnDirtyFields, GetConfirmInputModalProps, GetFieldsToRender, type IAnalyticsCallbacks, type IClearRulesAction, type ICondition, type IConfigValidationError, type IConfirmInputModalProps, type ICoreLocaleStrings, type ICycleError, type IDraftPersistenceOptions, type IDraftState, type IEntityData, type IFieldArrayProps, type IFieldCondition, type IFieldConfig, type IFieldEffect, type IFieldProps, type IFieldToRender, type IFormAnalytics, type IFormConfig, type IFormDevToolsProps, type IFormEngineSharedProps, type IFormSettings, type IInjectedFieldProvider, type IJsonSchemaNode, type ILogicalCondition, type IOption, type IRjsfConvertOptions, type IRjsfUiSchema, type IRule, type IRuleTraceEvent, type IRulesEngineProvider, type IRulesEngineState, type IRuntimeFieldState, type IRuntimeFormState, type ISetRulesAction, type ITimelineEvent, type IUpdateRulesAction, type IUseDraftPersistenceResult, type IValidationContext, type IValidationRule, type IValueFunctionContext, type IWizardConfig, type IWizardFormProps, type IWizardNavigationProps, type IWizardStep, type IWizardStepHeaderProps, InitOnCreateFormState, InitOnEditFormState, InjectedFieldProvider, IsExpandVisible, _default as RenderField, type RulesEngineAction, RulesEngineActionType, RulesEngineProvider, ShowField, SortOptions as SortDropdownOptions, SortOptions$1 as SortOptions, type SubEntityType, type TimelineEventType, type TypedFieldConfig, UseInjectedFieldContext, UseRulesEngineContext, type ValidatorFn, type ValueFunction, WizardForm, buildDefaultFieldStates, buildDependencyGraph, clearRuleTraceLog, clearTimeline, convertBooleanToYesOrNoText, createLazyFieldRegistry, createMaxLengthRule, createMinLengthRule, createNumericRangeRule, createOption, createPatternRule, createRequiredIfRule, deepCopy, defineFormConfig, deserializeFormState, detectDependencyCycles, detectSelfDependencies, disableRuleTracing, enableRuleTracing, evaluateAffectedFields, evaluateAllRules, evaluateCondition, evaluateExpression, executeValueFunction, extractConditionDependencies, extractExpressionDependencies, extractFunctionDependencies, flushRenderCycle, fromRjsfSchema, getCurrentLocale, getLastRenderedFields, getLocaleString, getRenderCounts, getRuleTraceLog, getStepFieldOrder, getStepFields, getStepIndex, getTimeline, getTotalFormRenders, getValidator, getValidatorRegistry, getValueFunction, getVisibleSteps, isEmpty, isFieldCondition, isLogicalCondition, isNull, isRuleTracingEnabled, isStepValid, isStringEmpty, logEvent, registerLocale, registerValidators, registerValueFunctions, resetLocale, resetRenderTracker, resetValidatorRegistry, resetValueFunctionRegistry, runSyncValidations, runValidations, serializeFormState, sortDropdownOptions, toRjsfSchema, topologicalSort, traceRuleEvent, trackRender, useBeforeUnload, useDraftPersistence, useFormAnalytics, validateDependencyGraph, validateFieldConfigs, validateStepFields, zodSchemaToFieldConfig };
+export { CheckAsyncFieldValidationRules, CheckDefaultValues, CheckFieldValidationRules, CheckValidDropdownOptions, ComponentTypes, ConfirmInputsModal, type Dictionary, ExecuteComputedValue, FIELD_PARENT_PREFIX, FieldArray, FieldWrapper, FormConstants, FormDevTools, FormEngine, FormErrorBoundary, FormFields, FormStrings, GetChildEntity, GetComputedValuesOnCreate, GetComputedValuesOnDirtyFields, GetConfirmInputModalProps, GetFieldsToRender, type IAnalyticsCallbacks, type IClearRulesAction, type ICondition, type IConfigValidationError, type IConfirmInputModalProps, type ICoreLocaleStrings, type ICycleError, type IDraftPersistenceOptions, type IDraftState, type IEntityData, type IFieldArrayProps, type IFieldCondition, type IFieldConfig, type IFieldEffect, type IFieldProps, type IFieldToRender, type IFormAnalytics, type IFormConfig, type IFormDevToolsProps, type IFormEngineSharedProps, type IFormSettings, type IInjectedFieldProvider, type IJsonSchemaNode, type ILogicalCondition, type IOption, type IRjsfConvertOptions, type IRjsfUiSchema, type IRule, type IRuleTraceEvent, type IRulesEngineProvider, type IRulesEngineState, type IRuntimeFieldState, type IRuntimeFormState, type ISetRulesAction, type ITimelineEvent, type IUpdateRulesAction, type IUseDraftPersistenceResult, type IValidationContext, type IValidationRule, type IValidatorMetadata, type IValueFunctionContext, type IWizardConfig, type IWizardFormProps, type IWizardNavigationProps, type IWizardStep, type IWizardStepHeaderProps, InitOnCreateFormState, InitOnEditFormState, InjectedFieldProvider, IsExpandVisible, _default as RenderField, type RulesEngineAction, RulesEngineActionType, RulesEngineProvider, ShowField, SortOptions as SortDropdownOptions, SortOptions$1 as SortOptions, type SubEntityType, type TimelineEventType, type TypedFieldConfig, UseInjectedFieldContext, UseRulesEngineContext, type ValidatorFn, type ValueFunction, WizardForm, buildDefaultFieldStates, buildDependencyGraph, clearRuleTraceLog, clearTimeline, convertBooleanToYesOrNoText, createLazyFieldRegistry, createMaxLengthRule, createMinLengthRule, createNumericRangeRule, createOption, createPatternRule, createRequiredIfRule, deepCopy, defineFormConfig, deserializeFormState, detectDependencyCycles, detectSelfDependencies, disableRuleTracing, enableRuleTracing, evaluateAffectedFields, evaluateAllRules, evaluateCondition, evaluateExpression, executeValueFunction, extractConditionDependencies, extractExpressionDependencies, extractFunctionDependencies, flushRenderCycle, fromRjsfSchema, getAllValidatorMetadata, getCurrentLocale, getLastRenderedFields, getLocaleString, getRenderCounts, getRuleTraceLog, getStepFieldOrder, getStepFields, getStepIndex, getTimeline, getTotalFormRenders, getValidator, getValidatorMetadata, getValidatorRegistry, getValueFunction, getVisibleSteps, isEmpty, isFieldCondition, isLogicalCondition, isNull, isRuleTracingEnabled, isStepValid, isStringEmpty, logEvent, registerLocale, registerValidatorMetadata, registerValidators, registerValueFunctions, resetLocale, resetRenderTracker, resetValidatorMetadataRegistry, resetValidatorRegistry, resetValueFunctionRegistry, runSyncValidations, runValidations, serializeFormState, sortDropdownOptions, toRjsfSchema, topologicalSort, traceRuleEvent, trackRender, useBeforeUnload, useDraftPersistence, useFormAnalytics, validateDependencyGraph, validateFieldConfigs, validateStepFields, zodSchemaToFieldConfig };

package/dist/index.js

@@ -93,6 +93,7 @@ __export(index_exports, {
   extractFunctionDependencies: () => extractFunctionDependencies,
   flushRenderCycle: () => flushRenderCycle,
   fromRjsfSchema: () => fromRjsfSchema,
+  getAllValidatorMetadata: () => getAllValidatorMetadata,
   getCurrentLocale: () => getCurrentLocale,
   getLastRenderedFields: () => getLastRenderedFields,
   getLocaleString: () => getLocaleString,
@@ -104,6 +105,7 @@ __export(index_exports, {
   getTimeline: () => getTimeline,
   getTotalFormRenders: () => getTotalFormRenders,
   getValidator: () => getValidator,
+  getValidatorMetadata: () => getValidatorMetadata,
   getValidatorRegistry: () => getValidatorRegistry,
   getValueFunction: () => getValueFunction,
   getVisibleSteps: () => getVisibleSteps,
@@ -116,10 +118,12 @@ __export(index_exports, {
   isStringEmpty: () => isStringEmpty,
   logEvent: () => logEvent,
   registerLocale: () => registerLocale,
+  registerValidatorMetadata: () => registerValidatorMetadata,
   registerValidators: () => registerValidators,
   registerValueFunctions: () => registerValueFunctions,
   resetLocale: () => resetLocale,
   resetRenderTracker: () => resetRenderTracker,
+  resetValidatorMetadataRegistry: () => resetValidatorMetadataRegistry,
   resetValidatorRegistry: () => resetValidatorRegistry,
   resetValueFunctionRegistry: () => resetValueFunctionRegistry,
   runSyncValidations: () => runSyncValidations,
@@ -218,7 +222,16 @@ var ComponentTypes = {
   ReadOnlyRichText: "ReadOnlyRichText",
   ReadOnlyWithButton: "ReadOnlyWithButton",
   ChoiceSet: "ChoiceSet",
-  FieldArray: "FieldArray"
+  FieldArray: "FieldArray",
+  RadioGroup: "RadioGroup",
+  CheckboxGroup: "CheckboxGroup",
+  Rating: "Rating",
+  ColorPicker: "ColorPicker",
+  Autocomplete: "Autocomplete",
+  FileUpload: "FileUpload",
+  DateRange: "DateRange",
+  DateTime: "DateTime",
+  PhoneInput: "PhoneInput"
 };
 var FormConstants = {
   defaultExpandCutoffCount: 12,
@@ -469,7 +482,7 @@ var FormStrings = {
   }
 };
 
-// src/providers/BusinessRulesProvider.tsx
+// src/providers/RulesEngineProvider.tsx
 var import_react = __toESM(require("react"));
 
 // src/helpers/ConditionEvaluator.ts
@@ -528,6 +541,16 @@ function evaluateFieldCondition(condition, values) {
       } catch {
         return false;
       }
+    case "arrayContains":
+      return Array.isArray(fieldValue) ? fieldValue.some((v) => looseEquals(v, condition.value)) : false;
+    case "arrayNotContains":
+      return Array.isArray(fieldValue) ? !fieldValue.some((v) => looseEquals(v, condition.value)) : true;
+    case "arrayLengthEquals":
+      return Array.isArray(fieldValue) ? fieldValue.length === toNumber(condition.value) : false;
+    case "arrayLengthGreaterThan":
+      return Array.isArray(fieldValue) ? fieldValue.length > toNumber(condition.value) : false;
+    case "arrayLengthLessThan":
+      return Array.isArray(fieldValue) ? fieldValue.length < toNumber(condition.value) : false;
     default:
       return false;
   }
@@ -837,6 +860,9 @@ function evaluateAllRules(fields, values, areAllFieldsReadonly) {
     }
     logEvent("rule_evaluated", fieldName, `${config.rules.length} rule(s) evaluated`);
     applyEffectToState(fieldStates, fieldName, ruleResults.selfEffect);
+    if (ruleResults.pendingSetValue !== void 0 && fieldStates[fieldName]) {
+      fieldStates[fieldName].pendingSetValue = ruleResults.pendingSetValue;
+    }
     for (const [targetField, effect] of Object.entries(ruleResults.crossEffects)) {
       if (fieldStates[targetField]) {
         applyEffectToState(fieldStates, targetField, effect);
@@ -872,7 +898,8 @@ function evaluateAffectedFields(changedField, fields, values, currentState) {
       label: config.label,
       defaultValue: config.defaultValue,
       computeOnCreateOnly: config.computeOnCreateOnly,
-      activeRuleIds: []
+      activeRuleIds: [],
+      pendingSetValue: void 0
     };
   }
   for (const [ownerField, config] of Object.entries(fields)) {
@@ -880,6 +907,9 @@ function evaluateAffectedFields(changedField, fields, values, currentState) {
     const ruleResults = evaluateFieldRules(config.rules, values);
     if (affected.has(ownerField) || ownerField === changedField) {
       applyEffectToState(updatedStates, ownerField, ruleResults.selfEffect);
+      if (ruleResults.pendingSetValue !== void 0 && updatedStates[ownerField]) {
+        updatedStates[ownerField].pendingSetValue = ruleResults.pendingSetValue;
+      }
     }
     for (const [targetField, effect] of Object.entries(ruleResults.crossEffects)) {
       if (affected.has(targetField) && updatedStates[targetField]) {
@@ -913,6 +943,7 @@ function evaluateFieldRules(rules, values) {
   const crossEffects = {};
   let fieldOrder;
   const activeRuleIds = [];
+  let pendingSetValue;
   for (let i = 0; i < sorted.length; i++) {
     const rule = sorted[i];
     const conditionMet = evaluateCondition(rule.when, values);
@@ -920,6 +951,9 @@ function evaluateFieldRules(rules, values) {
       activeRuleIds.push(rule.id ?? `rule_${i}`);
     }
     const effect = conditionMet ? rule.then : rule.else;
+    if (conditionMet && rule.then?.setValue !== void 0 && pendingSetValue === void 0) {
+      pendingSetValue = { value: rule.then.setValue };
+    }
     if (!effect) continue;
     mergeEffect(selfEffect, effect);
     if (effect.fields) {
@@ -934,7 +968,7 @@ function evaluateFieldRules(rules, values) {
       fieldOrder = effect.fieldOrder;
     }
   }
-  return { selfEffect, crossEffects, fieldOrder, activeRuleIds };
+  return { selfEffect, crossEffects, fieldOrder, activeRuleIds, pendingSetValue };
 }
 function mergeEffect(target, source) {
   if (source.required !== void 0 && target.required === void 0) {
@@ -978,7 +1012,7 @@ function applyEffectToState(states, fieldName, effect) {
   if (effect.computedValue !== void 0) state.computedValue = effect.computedValue;
 }
 
-// src/reducers/BusinessRulesReducer.ts
+// src/reducers/RulesEngineReducer.ts
 var defaultRulesEngineState = {
   configs: {}
 };
@@ -1025,9 +1059,9 @@ var rulesEngineReducer = (state = defaultRulesEngineState, action) => {
       return state;
   }
 };
-var BusinessRulesReducer_default = rulesEngineReducer;
+var RulesEngineReducer_default = rulesEngineReducer;
 
-// src/providers/BusinessRulesProvider.tsx
+// src/providers/RulesEngineProvider.tsx
 var import_jsx_runtime = require("react/jsx-runtime");
 var RulesEngineContext = import_react.default.createContext(
   void 0
@@ -1042,7 +1076,7 @@ function UseRulesEngineContext() {
   return context;
 }
 var RulesEngineProvider = (props) => {
-  const [rulesState, dispatch] = import_react.default.useReducer(BusinessRulesReducer_default, defaultRulesEngineState);
+  const [rulesState, dispatch] = import_react.default.useReducer(RulesEngineReducer_default, defaultRulesEngineState);
   const rulesStateRef = import_react.default.useRef(rulesState);
   import_react.default.useEffect(() => {
     rulesStateRef.current = rulesState;
@@ -1081,7 +1115,7 @@ var RulesEngineProvider = (props) => {
   return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(RulesEngineContext.Provider, { value: providerValue, children: props.children });
 };
 
-// src/providers/InjectedHookFieldProvider.tsx
+// src/providers/InjectedFieldProvider.tsx
 var import_react2 = __toESM(require("react"));
 var import_jsx_runtime2 = require("react/jsx-runtime");
 var InjectedFieldContext = import_react2.default.createContext(
@@ -1225,6 +1259,19 @@ var requiredIf = (value, params, context) => {
   }
   return void 0;
 };
+var validatorMetadataRegistry = {};
+function registerValidatorMetadata(name, metadata) {
+  validatorMetadataRegistry = { ...validatorMetadataRegistry, [name]: metadata };
+}
+function getValidatorMetadata(name) {
+  return validatorMetadataRegistry[name];
+}
+function getAllValidatorMetadata() {
+  return { ...validatorMetadataRegistry };
+}
+function resetValidatorMetadataRegistry() {
+  validatorMetadataRegistry = {};
+}
 var defaultValidators = {
   required,
   email,
@@ -1524,7 +1571,7 @@ function validateDependencyGraph(fields) {
   try {
     if (typeof globalThis !== "undefined" && globalThis.__DEV__ !== false) {
       for (const error of errors) {
-        console.warn(`[dynamic-forms] ${error.message}`);
+        console.warn(`[form-engine] ${error.message}`);
       }
     }
   } catch {
@@ -1830,7 +1877,7 @@ var FieldWrapper = import_react6.default.memo((props) => {
     /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("label", { id: labelId, htmlFor: id, className: "field-label", children: [
       label,
       required2 && /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(import_jsx_runtime5.Fragment, { children: [
-        /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("span", { className: "required-indicator", "aria-hidden": "true", style: { color: "var(--form-required-color, #d13438)" }, children: " *" }),
+        /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("span", { className: "required-indicator", "aria-hidden": "true", style: { color: "var(--fe-required-color, #d13438)" }, children: " *" }),
         /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("span", { className: "sr-only", style: { position: "absolute", width: "1px", height: "1px", padding: 0, margin: "-1px", overflow: "hidden", clip: "rect(0, 0, 0, 0)", whiteSpace: "nowrap", border: 0 }, children: " (required)" })
       ] })
     ] }),
@@ -1838,19 +1885,19 @@ var FieldWrapper = import_react6.default.memo((props) => {
     !additionalInfoComponent && additionalInfo && /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("span", { className: "additional-info", title: additionalInfo, children: "\u24D8" })
   ] });
   const defaultErrorAndStatus = /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("div", { className: "message", children: error ? /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(import_jsx_runtime5.Fragment, { children: [
-    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("span", { className: "error-icon", "aria-hidden": "true", style: { color: "var(--form-error-color, #d13438)" }, children: "\u2716" }),
-    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("span", { className: "error-message", id: errorMessageId, role: "alert", style: { color: "var(--form-error-color, #d13438)" }, children: error.message || "Error" })
+    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("span", { className: "error-icon", "aria-hidden": "true", style: { color: "var(--fe-error-color, #d13438)" }, children: "\u2716" }),
+    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("span", { className: "error-message", id: errorMessageId, role: "alert", style: { color: "var(--fe-error-color, #d13438)" }, children: error.message || "Error" })
   ] }) : savePending ? /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(import_jsx_runtime5.Fragment, { children: [
-    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("span", { className: "warning-icon", "aria-hidden": "true", style: { color: "var(--form-warning-color, #ffb900)" }, children: "\u26A0" }),
-    /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("span", { className: "warning-message", id: errorMessageId, role: "status", style: { color: "var(--form-warning-color, #ffb900)" }, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("span", { className: "warning-icon", "aria-hidden": "true", style: { color: "var(--fe-warning-color, #ffb900)" }, children: "\u26A0" }),
+    /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("span", { className: "warning-message", id: errorMessageId, role: "status", style: { color: "var(--fe-warning-color, #ffb900)" }, children: [
       !isManualSave ? FormStrings.autoSavePending : FormStrings.savePending,
       " (",
       `${errorCount} ${FormStrings.remaining}`,
       ")"
     ] })
   ] }) : saving ? /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(import_jsx_runtime5.Fragment, { children: [
-    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("span", { className: "save-spinner", "aria-hidden": "true", style: { color: "var(--form-saving-color, #0078d4)" }, children: "\u231B" }),
-    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("span", { className: "save-message", id: errorMessageId, role: "status", style: { color: "var(--form-saving-color, #0078d4)" }, children: FormStrings.saving })
+    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("span", { className: "save-spinner", "aria-hidden": "true", style: { color: "var(--fe-saving-color, #0078d4)" }, children: "\u231B" }),
+    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("span", { className: "save-message", id: errorMessageId, role: "status", style: { color: "var(--fe-saving-color, #0078d4)" }, children: FormStrings.saving })
   ] }) : /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_jsx_runtime5.Fragment, {}) });
   return /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(
     "div",
@@ -2169,7 +2216,7 @@ var ConfirmInputsModal = (props) => {
     trigger();
     setValue(`${fieldName}`, fieldValue, { shouldDirty: true });
   };
-  const content = /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("div", { className: "dynamic-form-wrapper", children: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("div", { className: "dynamic-form-container", children: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("form", { className: "dynamic-form modal", children: confirmInputFields?.map((confirmInputField) => {
+  const content = /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("div", { className: "fe-form-wrapper", children: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("div", { className: "fe-form-container", children: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("form", { className: "fe-form fe-modal", children: confirmInputFields?.map((confirmInputField) => {
     const fieldState = rulesState.configs[configName]?.fieldStates[confirmInputField];
     const fieldConfig = fields[confirmInputField];
     if (!fieldState || !fieldConfig) return null;
@@ -2197,9 +2244,9 @@ var ConfirmInputsModal = (props) => {
   if (renderDialog) {
     return renderDialog({ isOpen: !!isOpen, onSave: saveConfirmInputFields, onCancel: cancelConfirmInputFields, children: content });
   }
-  return /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("dialog", { ref: dialogRef, className: "dynamic-form-modal", role: "dialog", "aria-modal": "true", "aria-label": FormStrings.confirm, onKeyDown: handleKeyDown, children: [
+  return /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("dialog", { ref: dialogRef, className: "fe-modal", role: "dialog", "aria-modal": "true", "aria-label": FormStrings.confirm, onKeyDown: handleKeyDown, children: [
     content,
-    /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("div", { className: "dynamic-form-modal-actions", children: [
+    /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("div", { className: "fe-modal-actions", children: [
       /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("button", { type: "button", ref: saveButtonRef, onClick: saveConfirmInputFields, children: FormStrings.save }),
       /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("button", { type: "button", onClick: cancelConfirmInputFields, children: FormStrings.cancel })
     ] })
@@ -2271,10 +2318,10 @@ var FormFields = (props) => {
   const collapsedClass = !isExpanded && (expandEnabled || expandEnabled === void 0) ? "collapsed" : "";
   const fieldsToRender = GetFieldsToRender(fieldRenderLimit ?? 0, fieldOrder ?? [], formState?.fieldStates);
   const loadingKey = `${programName}-${entityType}-${entityId}-form-loaded`;
-  return /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("div", { className: `dynamic-form-container ${collapsedClass}`, children: /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)(
+  return /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("div", { className: `fe-form-container ${collapsedClass}`, children: /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)(
     "form",
     {
-      className: `dynamic-form ${collapsedClass} ${inPanel ? "in-panel" : ""}`,
+      className: `fe-form ${collapsedClass} ${inPanel ? "in-panel" : ""}`,
       style: collapsedClass && collapsedMaxHeight ? { maxHeight: `${collapsedMaxHeight}px` } : void 0,
       "data-testid": `${programName}-${entityType}-${entityId}-form`,
       children: [
@@ -2556,9 +2603,9 @@ var FormEngine = (props) => {
   const cutoff = expandEnabled && !isExpanded ? effectiveExpandCutoff ?? FormConstants.defaultExpandCutoffCount : void 0;
   return /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)(import_react_hook_form4.FormProvider, { ...formMethods, formState: { ...formMethods.formState, isDirty, isValid, dirtyFields, errors, isSubmitting, isSubmitSuccessful }, children: [
     /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("div", { role: "status", "aria-live": "polite", className: "sr-only", style: { position: "absolute", width: "1px", height: "1px", padding: 0, margin: "-1px", overflow: "hidden", clip: "rect(0, 0, 0, 0)", whiteSpace: "nowrap", border: 0 }, "data-testid": "form-status-live-region", children: statusMessage }),
-    enableFilter && /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("div", { className: "dynamic-form-filter", children: renderFilterInput ? renderFilterInput({ onChange: onFilterChange }) : /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("input", { type: "text", placeholder: FormStrings.filterFields, "aria-label": FormStrings.filterFields, onChange: (e) => onFilterChange(e.target.value), className: "dynamic-form-filter-input" }) }),
-    formErrors && formErrors.length > 0 && /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("div", { className: "form-errors", role: "alert", style: { color: "var(--form-error-color, #d13438)", padding: "8px", marginBottom: "8px" }, children: formErrors.map((err, i) => /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("div", { className: "form-error-item", children: err }, i)) }),
-    /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)("div", { className: "dynamic-form-wrapper", children: [
+    enableFilter && /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("div", { className: "fe-filter", children: renderFilterInput ? renderFilterInput({ onChange: onFilterChange }) : /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("input", { type: "text", placeholder: FormStrings.filterFields, "aria-label": FormStrings.filterFields, onChange: (e) => onFilterChange(e.target.value), className: "fe-filter-input" }) }),
+    formErrors && formErrors.length > 0 && /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("div", { className: "form-errors", role: "alert", style: { color: "var(--fe-error-color, #d13438)", padding: "8px", marginBottom: "8px" }, children: formErrors.map((err, i) => /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("div", { className: "form-error-item", children: err }, i)) }),
+    /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)("div", { className: "fe-form-wrapper", children: [
       /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(
         FormFields,
         {
@@ -2585,7 +2632,7 @@ var FormEngine = (props) => {
         }
       ),
       expandEnabled && (renderExpandButton ? renderExpandButton({ isExpanded, onToggle: () => setIsExpanded(!isExpanded) }) : /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("button", { className: "expand-button", onClick: () => setIsExpanded(!isExpanded), "aria-expanded": isExpanded, "data-testid": `${programName}-${entityType}-${entityId}-expand-form`, children: isExpanded ? FormStrings.seeLess : FormStrings.expand })),
-      effectiveManualSave && (renderSaveButton ? renderSaveButton({ onSave: manualSave, isDirty, isValid, isSubmitting }) : /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)("div", { className: "dynamic-form-save-actions", style: { marginTop: "16px", display: "flex", gap: "8px" }, children: [
+      effectiveManualSave && (renderSaveButton ? renderSaveButton({ onSave: manualSave, isDirty, isValid, isSubmitting }) : /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)("div", { className: "fe-save-actions", style: { marginTop: "16px", display: "flex", gap: "8px" }, children: [
         /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("button", { type: "button", className: "save-button", onClick: manualSave, disabled: !isDirty || isSubmitting, children: isCreate ? FormStrings.create : FormStrings.save }),
         /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("button", { type: "button", className: "cancel-button", onClick: () => {
           reset();
@@ -4313,6 +4360,7 @@ function isRuleTracingEnabled() {
   extractFunctionDependencies,
   flushRenderCycle,
   fromRjsfSchema,
+  getAllValidatorMetadata,
   getCurrentLocale,
   getLastRenderedFields,
   getLocaleString,
@@ -4324,6 +4372,7 @@ function isRuleTracingEnabled() {
   getTimeline,
   getTotalFormRenders,
   getValidator,
+  getValidatorMetadata,
   getValidatorRegistry,
   getValueFunction,
   getVisibleSteps,
@@ -4336,10 +4385,12 @@ function isRuleTracingEnabled() {
   isStringEmpty,
   logEvent,
   registerLocale,
+  registerValidatorMetadata,
   registerValidators,
   registerValueFunctions,
   resetLocale,
   resetRenderTracker,
+  resetValidatorMetadataRegistry,
   resetValidatorRegistry,
   resetValueFunctionRegistry,
   runSyncValidations,