@form-eng/core 1.0.0 → 1.1.0

package/dist/index.mjs

@@ -76,7 +76,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,
@@ -327,7 +336,7 @@ var FormStrings = {
   }
 };
 
-// src/providers/BusinessRulesProvider.tsx
+// src/providers/RulesEngineProvider.tsx
 import React from "react";
 
 // src/helpers/ConditionEvaluator.ts
@@ -386,6 +395,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;
   }
@@ -695,6 +714,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);
@@ -730,7 +752,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)) {
@@ -738,6 +761,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]) {
@@ -771,6 +797,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);
@@ -778,6 +805,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) {
@@ -792,7 +822,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) {
@@ -836,7 +866,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: {}
 };
@@ -883,9 +913,9 @@ var rulesEngineReducer = (state = defaultRulesEngineState, action) => {
       return state;
   }
 };
-var BusinessRulesReducer_default = rulesEngineReducer;
+var RulesEngineReducer_default = rulesEngineReducer;
 
-// src/providers/BusinessRulesProvider.tsx
+// src/providers/RulesEngineProvider.tsx
 import { jsx } from "react/jsx-runtime";
 var RulesEngineContext = React.createContext(
   void 0
@@ -900,7 +930,7 @@ function UseRulesEngineContext() {
   return context;
 }
 var RulesEngineProvider = (props) => {
-  const [rulesState, dispatch] = React.useReducer(BusinessRulesReducer_default, defaultRulesEngineState);
+  const [rulesState, dispatch] = React.useReducer(RulesEngineReducer_default, defaultRulesEngineState);
   const rulesStateRef = React.useRef(rulesState);
   React.useEffect(() => {
     rulesStateRef.current = rulesState;
@@ -939,7 +969,7 @@ var RulesEngineProvider = (props) => {
   return /* @__PURE__ */ jsx(RulesEngineContext.Provider, { value: providerValue, children: props.children });
 };
 
-// src/providers/InjectedHookFieldProvider.tsx
+// src/providers/InjectedFieldProvider.tsx
 import React2 from "react";
 import { jsx as jsx2 } from "react/jsx-runtime";
 var InjectedFieldContext = React2.createContext(
@@ -1083,6 +1113,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,
@@ -1382,7 +1425,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 {
@@ -1688,7 +1731,7 @@ var FieldWrapper = React5.memo((props) => {
     /* @__PURE__ */ jsxs3("label", { id: labelId, htmlFor: id, className: "field-label", children: [
       label,
       required2 && /* @__PURE__ */ jsxs3(Fragment, { children: [
-        /* @__PURE__ */ jsx5("span", { className: "required-indicator", "aria-hidden": "true", style: { color: "var(--form-required-color, #d13438)" }, children: " *" }),
+        /* @__PURE__ */ jsx5("span", { className: "required-indicator", "aria-hidden": "true", style: { color: "var(--fe-required-color, #d13438)" }, children: " *" }),
         /* @__PURE__ */ jsx5("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)" })
       ] })
     ] }),
@@ -1696,19 +1739,19 @@ var FieldWrapper = React5.memo((props) => {
     !additionalInfoComponent && additionalInfo && /* @__PURE__ */ jsx5("span", { className: "additional-info", title: additionalInfo, children: "\u24D8" })
   ] });
   const defaultErrorAndStatus = /* @__PURE__ */ jsx5("div", { className: "message", children: error ? /* @__PURE__ */ jsxs3(Fragment, { children: [
-    /* @__PURE__ */ jsx5("span", { className: "error-icon", "aria-hidden": "true", style: { color: "var(--form-error-color, #d13438)" }, children: "\u2716" }),
-    /* @__PURE__ */ jsx5("span", { className: "error-message", id: errorMessageId, role: "alert", style: { color: "var(--form-error-color, #d13438)" }, children: error.message || "Error" })
+    /* @__PURE__ */ jsx5("span", { className: "error-icon", "aria-hidden": "true", style: { color: "var(--fe-error-color, #d13438)" }, children: "\u2716" }),
+    /* @__PURE__ */ jsx5("span", { className: "error-message", id: errorMessageId, role: "alert", style: { color: "var(--fe-error-color, #d13438)" }, children: error.message || "Error" })
   ] }) : savePending ? /* @__PURE__ */ jsxs3(Fragment, { children: [
-    /* @__PURE__ */ jsx5("span", { className: "warning-icon", "aria-hidden": "true", style: { color: "var(--form-warning-color, #ffb900)" }, children: "\u26A0" }),
-    /* @__PURE__ */ jsxs3("span", { className: "warning-message", id: errorMessageId, role: "status", style: { color: "var(--form-warning-color, #ffb900)" }, children: [
+    /* @__PURE__ */ jsx5("span", { className: "warning-icon", "aria-hidden": "true", style: { color: "var(--fe-warning-color, #ffb900)" }, children: "\u26A0" }),
+    /* @__PURE__ */ jsxs3("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__ */ jsxs3(Fragment, { children: [
-    /* @__PURE__ */ jsx5("span", { className: "save-spinner", "aria-hidden": "true", style: { color: "var(--form-saving-color, #0078d4)" }, children: "\u231B" }),
-    /* @__PURE__ */ jsx5("span", { className: "save-message", id: errorMessageId, role: "status", style: { color: "var(--form-saving-color, #0078d4)" }, children: FormStrings.saving })
+    /* @__PURE__ */ jsx5("span", { className: "save-spinner", "aria-hidden": "true", style: { color: "var(--fe-saving-color, #0078d4)" }, children: "\u231B" }),
+    /* @__PURE__ */ jsx5("span", { className: "save-message", id: errorMessageId, role: "status", style: { color: "var(--fe-saving-color, #0078d4)" }, children: FormStrings.saving })
   ] }) : /* @__PURE__ */ jsx5(Fragment, {}) });
   return /* @__PURE__ */ jsxs3(
     "div",
@@ -2027,7 +2070,7 @@ var ConfirmInputsModal = (props) => {
     trigger();
     setValue(`${fieldName}`, fieldValue, { shouldDirty: true });
   };
-  const content = /* @__PURE__ */ jsx7("div", { className: "dynamic-form-wrapper", children: /* @__PURE__ */ jsx7("div", { className: "dynamic-form-container", children: /* @__PURE__ */ jsx7("form", { className: "dynamic-form modal", children: confirmInputFields?.map((confirmInputField) => {
+  const content = /* @__PURE__ */ jsx7("div", { className: "fe-form-wrapper", children: /* @__PURE__ */ jsx7("div", { className: "fe-form-container", children: /* @__PURE__ */ jsx7("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;
@@ -2055,9 +2098,9 @@ var ConfirmInputsModal = (props) => {
   if (renderDialog) {
     return renderDialog({ isOpen: !!isOpen, onSave: saveConfirmInputFields, onCancel: cancelConfirmInputFields, children: content });
   }
-  return /* @__PURE__ */ jsxs5("dialog", { ref: dialogRef, className: "dynamic-form-modal", role: "dialog", "aria-modal": "true", "aria-label": FormStrings.confirm, onKeyDown: handleKeyDown, children: [
+  return /* @__PURE__ */ jsxs5("dialog", { ref: dialogRef, className: "fe-modal", role: "dialog", "aria-modal": "true", "aria-label": FormStrings.confirm, onKeyDown: handleKeyDown, children: [
     content,
-    /* @__PURE__ */ jsxs5("div", { className: "dynamic-form-modal-actions", children: [
+    /* @__PURE__ */ jsxs5("div", { className: "fe-modal-actions", children: [
       /* @__PURE__ */ jsx7("button", { type: "button", ref: saveButtonRef, onClick: saveConfirmInputFields, children: FormStrings.save }),
       /* @__PURE__ */ jsx7("button", { type: "button", onClick: cancelConfirmInputFields, children: FormStrings.cancel })
     ] })
@@ -2129,10 +2172,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__ */ jsx9("div", { className: `dynamic-form-container ${collapsedClass}`, children: /* @__PURE__ */ jsxs7(
+  return /* @__PURE__ */ jsx9("div", { className: `fe-form-container ${collapsedClass}`, children: /* @__PURE__ */ jsxs7(
     "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: [
@@ -2414,9 +2457,9 @@ var FormEngine = (props) => {
   const cutoff = expandEnabled && !isExpanded ? effectiveExpandCutoff ?? FormConstants.defaultExpandCutoffCount : void 0;
   return /* @__PURE__ */ jsxs8(FormProvider, { ...formMethods, formState: { ...formMethods.formState, isDirty, isValid, dirtyFields, errors, isSubmitting, isSubmitSuccessful }, children: [
     /* @__PURE__ */ jsx10("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__ */ jsx10("div", { className: "dynamic-form-filter", children: renderFilterInput ? renderFilterInput({ onChange: onFilterChange }) : /* @__PURE__ */ jsx10("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__ */ jsx10("div", { className: "form-errors", role: "alert", style: { color: "var(--form-error-color, #d13438)", padding: "8px", marginBottom: "8px" }, children: formErrors.map((err, i) => /* @__PURE__ */ jsx10("div", { className: "form-error-item", children: err }, i)) }),
-    /* @__PURE__ */ jsxs8("div", { className: "dynamic-form-wrapper", children: [
+    enableFilter && /* @__PURE__ */ jsx10("div", { className: "fe-filter", children: renderFilterInput ? renderFilterInput({ onChange: onFilterChange }) : /* @__PURE__ */ jsx10("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__ */ jsx10("div", { className: "form-errors", role: "alert", style: { color: "var(--fe-error-color, #d13438)", padding: "8px", marginBottom: "8px" }, children: formErrors.map((err, i) => /* @__PURE__ */ jsx10("div", { className: "form-error-item", children: err }, i)) }),
+    /* @__PURE__ */ jsxs8("div", { className: "fe-form-wrapper", children: [
       /* @__PURE__ */ jsx10(
         FormFields,
         {
@@ -2443,7 +2486,7 @@ var FormEngine = (props) => {
         }
       ),
       expandEnabled && (renderExpandButton ? renderExpandButton({ isExpanded, onToggle: () => setIsExpanded(!isExpanded) }) : /* @__PURE__ */ jsx10("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__ */ jsxs8("div", { className: "dynamic-form-save-actions", style: { marginTop: "16px", display: "flex", gap: "8px" }, children: [
+      effectiveManualSave && (renderSaveButton ? renderSaveButton({ onSave: manualSave, isDirty, isValid, isSubmitting }) : /* @__PURE__ */ jsxs8("div", { className: "fe-save-actions", style: { marginTop: "16px", display: "flex", gap: "8px" }, children: [
         /* @__PURE__ */ jsx10("button", { type: "button", className: "save-button", onClick: manualSave, disabled: !isDirty || isSubmitting, children: isCreate ? FormStrings.create : FormStrings.save }),
         /* @__PURE__ */ jsx10("button", { type: "button", className: "cancel-button", onClick: () => {
           reset();
@@ -4170,6 +4213,7 @@ export {
   extractFunctionDependencies,
   flushRenderCycle,
   fromRjsfSchema,
+  getAllValidatorMetadata,
   getCurrentLocale,
   getLastRenderedFields,
   getLocaleString,
@@ -4181,6 +4225,7 @@ export {
   getTimeline,
   getTotalFormRenders,
   getValidator,
+  getValidatorMetadata,
   getValidatorRegistry,
   getValueFunction,
   getVisibleSteps,
@@ -4193,10 +4238,12 @@ export {
   isStringEmpty,
   logEvent,
   registerLocale,
+  registerValidatorMetadata,
   registerValidators,
   registerValueFunctions,
   resetLocale,
   resetRenderTracker,
+  resetValidatorMetadataRegistry,
   resetValidatorRegistry,
   resetValueFunctionRegistry,
   runSyncValidations,