@form-eng/core 1.1.1 → 1.2.0

package/dist/index.js

@@ -36,9 +36,11 @@ __export(index_exports, {
   CheckValidDropdownOptions: () => CheckValidDropdownOptions,
   ComponentTypes: () => ComponentTypes,
   ConfirmInputsModal: () => ConfirmInputsModal_default,
+  DocumentLinksStrings: () => DocumentLinksStrings,
   ExecuteComputedValue: () => ExecuteComputedValue,
   FIELD_PARENT_PREFIX: () => FIELD_PARENT_PREFIX,
   FieldArray: () => FieldArray,
+  FieldClassName: () => FieldClassName,
   FieldWrapper: () => FieldWrapper,
   FormConstants: () => FormConstants,
   FormDevTools: () => FormDevTools,
@@ -50,11 +52,13 @@ __export(index_exports, {
   GetComputedValuesOnCreate: () => GetComputedValuesOnCreate,
   GetComputedValuesOnDirtyFields: () => GetComputedValuesOnDirtyFields,
   GetConfirmInputModalProps: () => GetConfirmInputModalProps,
+  GetFieldDataTestId: () => GetFieldDataTestId,
   GetFieldsToRender: () => GetFieldsToRender,
   InitOnCreateFormState: () => InitOnCreateFormState,
   InitOnEditFormState: () => InitOnEditFormState,
   InjectedFieldProvider: () => InjectedFieldProvider,
   IsExpandVisible: () => IsExpandVisible,
+  MAX_FILE_SIZE_MB_DEFAULT: () => MAX_FILE_SIZE_MB_DEFAULT,
   RenderField: () => RenderField_default,
   RulesEngineActionType: () => RulesEngineActionType,
   RulesEngineProvider: () => RulesEngineProvider,
@@ -82,6 +86,7 @@ __export(index_exports, {
   detectDependencyCycles: () => detectDependencyCycles,
   detectSelfDependencies: () => detectSelfDependencies,
   disableRuleTracing: () => disableRuleTracing,
+  ellipsifyText: () => ellipsifyText,
   enableRuleTracing: () => enableRuleTracing,
   evaluateAffectedFields: () => evaluateAffectedFields,
   evaluateAllRules: () => evaluateAllRules,
@@ -89,12 +94,19 @@ __export(index_exports, {
   evaluateExpression: () => evaluateExpression,
   executeValueFunction: () => executeValueFunction,
   extractConditionDependencies: () => extractConditionDependencies,
+  extractDigits: () => extractDigits,
   extractExpressionDependencies: () => extractExpressionDependencies,
   extractFunctionDependencies: () => extractFunctionDependencies,
   flushRenderCycle: () => flushRenderCycle,
+  formatDateRange: () => formatDateRange,
+  formatDateTime: () => formatDateTime,
+  formatDateTimeValue: () => formatDateTimeValue,
+  formatPhone: () => formatPhone,
   fromRjsfSchema: () => fromRjsfSchema,
   getAllValidatorMetadata: () => getAllValidatorMetadata,
   getCurrentLocale: () => getCurrentLocale,
+  getFieldState: () => getFieldState,
+  getFileNames: () => getFileNames,
   getLastRenderedFields: () => getLastRenderedFields,
   getLocaleString: () => getLocaleString,
   getRenderCounts: () => getRenderCounts,
@@ -634,7 +646,27 @@ function resetValueFunctionRegistry() {
 }
 
 // src/helpers/ExpressionEngine.ts
+var import_expr_eval = require("expr-eval");
+var _parser = new import_expr_eval.Parser();
+var _origAdd = _parser.binaryOps["+"];
+_parser.binaryOps["+"] = (a, b) => {
+  if (typeof a === "string" || typeof b === "string") return String(a) + String(b);
+  return _origAdd(a, b);
+};
+_parser.consts["NaN"] = NaN;
 function evaluateExpression(expression, values, fieldName, parentEntity, currentUserId) {
+  const singleFnMatch = /^\s*\$fn\.([a-zA-Z_][a-zA-Z0-9_]*)\(\)\s*$/.exec(expression);
+  if (singleFnMatch) {
+    const fn = getValueFunction(singleFnMatch[1]);
+    if (!fn) return void 0;
+    return fn({
+      fieldName: fieldName ?? "",
+      fieldValue: fieldName ? values[fieldName] : void 0,
+      values,
+      parentEntity,
+      currentUserId
+    });
+  }
   let resolved = expression.replace(
     /\$fn\.([a-zA-Z_][a-zA-Z0-9_]*)\(\)/g,
     (_, fnName) => {
@@ -647,48 +679,35 @@ function evaluateExpression(expression, values, fieldName, parentEntity, current
           parentEntity,
           currentUserId
         });
-        if (result === null || result === void 0) return "undefined";
+        if (result === null || result === void 0) return "NaN";
         if (typeof result === "string") return JSON.stringify(result);
-        if (result instanceof Date) return `new Date(${result.getTime()})`;
+        if (result instanceof Date) return String(result.getTime());
         return String(result);
       }
-      return "undefined";
+      return "NaN";
     }
   );
+  const serializeValue = (value) => {
+    if (value === null || value === void 0) return "NaN";
+    if (typeof value === "string") return JSON.stringify(value);
+    if (typeof value === "boolean") return value ? "true" : "false";
+    if (value instanceof Date) return String(value.getTime());
+    return String(value);
+  };
   resolved = resolved.replace(
     /\$parent\.([a-zA-Z_][a-zA-Z0-9_.]*)/g,
-    (_, fieldPath) => {
-      const value = getNestedValue2(parentEntity ?? {}, fieldPath);
-      if (value === null || value === void 0) return "undefined";
-      if (typeof value === "string") return JSON.stringify(value);
-      return String(value);
-    }
+    (_, fieldPath) => serializeValue(getNestedValue2(parentEntity ?? {}, fieldPath))
   );
   resolved = resolved.replace(
     /\$root\.([a-zA-Z_][a-zA-Z0-9_.]*)/g,
-    (_, fieldPath) => {
-      const value = getNestedValue2(values, fieldPath);
-      if (value === null || value === void 0) return "undefined";
-      if (typeof value === "string") return JSON.stringify(value);
-      return String(value);
-    }
+    (_, fieldPath) => serializeValue(getNestedValue2(values, fieldPath))
   );
   resolved = resolved.replace(
     /\$values\.([a-zA-Z_][a-zA-Z0-9_.]*)/g,
-    (_, fieldPath) => {
-      const value = getNestedValue2(values, fieldPath);
-      if (value === null || value === void 0) return "undefined";
-      if (typeof value === "string") return JSON.stringify(value);
-      return String(value);
-    }
+    (_, fieldPath) => serializeValue(getNestedValue2(values, fieldPath))
   );
   try {
-    const safeEval = new Function(
-      "Math",
-      "Date",
-      `"use strict"; return (${resolved});`
-    );
-    return safeEval(Math, Date);
+    return _parser.evaluate(resolved, {});
   } catch {
     return void 0;
   }
@@ -1794,7 +1813,7 @@ var FieldArray = (props) => {
 
 // src/components/InlineForm.tsx
 var import_react11 = __toESM(require("react"));
-var import_react_hook_form4 = require("react-hook-form");
+var import_react_hook_form5 = require("react-hook-form");
 
 // src/hooks/useFormAnalytics.ts
 var import_react5 = require("react");
@@ -1990,6 +2009,7 @@ var RenderField = (props) => {
     readOnly,
     disabled,
     options,
+    optionsLoading,
     validate,
     parentEntityId,
     parentEntityType,
@@ -2084,6 +2104,7 @@ var RenderField = (props) => {
                   savePending,
                   config,
                   options,
+                  optionsLoading,
                   label,
                   type,
                   description,
@@ -2116,6 +2137,7 @@ var RenderField = (props) => {
     readOnly,
     disabled,
     options,
+    optionsLoading,
     softHidden,
     renderLabel,
     renderError,
@@ -2256,6 +2278,7 @@ var ConfirmInputsModal_default = ConfirmInputsModal;
 
 // src/components/InlineFormFields.tsx
 var import_react10 = __toESM(require("react"));
+var import_react_hook_form4 = require("react-hook-form");
 
 // src/components/FormErrorBoundary.tsx
 var import_react9 = __toESM(require("react"));
@@ -2315,6 +2338,33 @@ var FormFields = (props) => {
     renderStatus,
     analytics
   } = props;
+  const [asyncOptions, setAsyncOptions] = import_react10.default.useState({});
+  const [asyncOptionsLoading, setAsyncOptionsLoading] = import_react10.default.useState({});
+  const asyncCacheKeyRef = import_react10.default.useRef({});
+  const { getValues } = (0, import_react_hook_form4.useFormContext)();
+  import_react10.default.useEffect(() => {
+    if (!fields) return;
+    Object.entries(fields).forEach(([fieldId, fieldConfig]) => {
+      if (!fieldConfig.loadOptions) return;
+      const depValues = (fieldConfig.optionsDependsOn ?? []).reduce(
+        (acc, dep) => {
+          acc[dep] = getValues(dep);
+          return acc;
+        },
+        {}
+      );
+      const cacheKey = JSON.stringify(depValues);
+      if (asyncCacheKeyRef.current[fieldId] === cacheKey) return;
+      asyncCacheKeyRef.current[fieldId] = cacheKey;
+      setAsyncOptionsLoading((prev) => ({ ...prev, [fieldId]: true }));
+      fieldConfig.loadOptions({ fieldId, values: getValues() }).then((options) => {
+        setAsyncOptions((prev) => ({ ...prev, [fieldId]: options }));
+      }).catch(() => {
+      }).finally(() => {
+        setAsyncOptionsLoading((prev) => ({ ...prev, [fieldId]: false }));
+      });
+    });
+  });
   const collapsedClass = !isExpanded && (expandEnabled || expandEnabled === void 0) ? "collapsed" : "";
   const fieldsToRender = GetFieldsToRender(fieldRenderLimit ?? 0, fieldOrder ?? [], formState?.fieldStates);
   const loadingKey = `${programName}-${entityType}-${entityId}-form-loaded`;
@@ -2342,7 +2392,8 @@ var FormFields = (props) => {
               hidden: fieldState.hidden,
               required: fieldState.required,
               readOnly: fieldState.readOnly,
-              options: fieldState.options,
+              options: asyncOptions[fieldName] ?? fieldState.options,
+              optionsLoading: asyncOptionsLoading[fieldName] ?? false,
               validate: fieldState.validate,
               parentEntityId,
               parentEntityType,
@@ -2400,9 +2451,13 @@ var FormEngine = (props) => {
     renderDialog,
     renderSaveButton,
     formErrors,
+    fieldErrors,
     renderLabel,
     renderError,
-    renderStatus
+    renderStatus,
+    onSubmit: onSubmitProp,
+    onSubmitError,
+    renderSubmitButton
   } = props;
   const fields = formConfig?.fields ?? props.fieldConfigs ?? {};
   const formSettings = formConfig?.settings;
@@ -2422,7 +2477,7 @@ var FormEngine = (props) => {
   const [inputFieldsConfirmed, setInputFieldsConfirmed] = import_react11.default.useState(true);
   const [filterText, setFilterText] = import_react11.default.useState();
   const [statusMessage, setStatusMessage] = import_react11.default.useState("");
-  const formMethods = (0, import_react_hook_form4.useForm)({ mode: "onChange", defaultValues });
+  const formMethods = (0, import_react_hook_form5.useForm)({ mode: "onChange", defaultValues });
   const { reset, resetField, handleSubmit, trigger, setValue, getValues, setError, clearErrors, formState } = formMethods;
   const rulesStateRef = import_react11.default.useRef(rulesState);
   const formStateRef = import_react11.default.useRef({ ...formState });
@@ -2438,6 +2493,12 @@ var FormEngine = (props) => {
   import_react11.default.useEffect(() => {
     initForm(defaultValues);
   }, [areAllFieldsReadonly]);
+  import_react11.default.useEffect(() => {
+    if (!fieldErrors) return;
+    Object.entries(fieldErrors).forEach(([fieldName, message]) => {
+      setError(fieldName, { type: "server", message });
+    });
+  }, [fieldErrors]);
   const initForm = (entityData) => {
     const { formState: loadedState, initEntityData } = isCreate ? InitOnCreateFormState(configName, fields, entityData, parentEntity ?? {}, currentUserId ?? "", setValue, initFormState) : InitOnEditFormState(configName, fields, entityData, areAllFieldsReadonly ?? false, initFormState);
     setExpandEnabled(IsExpandVisible(loadedState.fieldStates, effectiveExpandCutoff));
@@ -2583,6 +2644,26 @@ var FormEngine = (props) => {
       }
     });
   };
+  const handleFormSubmit = import_react11.default.useCallback(() => {
+    if (!onSubmitProp) return;
+    const cfg = rulesStateRef.current.configs[configName];
+    if (cfg?.fieldStates) {
+      Object.keys(cfg.fieldStates).forEach((fieldName) => {
+        if (cfg.fieldStates[fieldName]?.hidden) clearErrors(fieldName);
+      });
+    }
+    trigger().then((valid) => {
+      if (!valid) {
+        setIsExpanded(true);
+        (typeof requestAnimationFrame !== "undefined" ? requestAnimationFrame : setTimeout)(() => focusFirstError());
+        onSubmitError?.(formStateRef.current.errors);
+      } else {
+        const values = formMethods.getValues();
+        Promise.resolve(onSubmitProp(values)).catch(() => {
+        });
+      }
+    });
+  }, [onSubmitProp, onSubmitError, configName, trigger, clearErrors]);
   const onFilterChange = import_react11.default.useCallback((value) => {
     if (filterTimeoutRef.current) clearTimeout(filterTimeoutRef.current);
     filterTimeoutRef.current = setTimeout(() => setFilterText(value), 500);
@@ -2601,7 +2682,7 @@ var FormEngine = (props) => {
     confirmInputModalProps.current = void 0;
   };
   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: [
+  return /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)(import_react_hook_form5.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: "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)) }),
@@ -2638,7 +2719,8 @@ var FormEngine = (props) => {
           reset();
           initForm(defaultValues);
         }, disabled: !isDirty || isSubmitting, children: FormStrings.cancel })
-      ] }))
+      ] })),
+      onSubmitProp && (renderSubmitButton ? renderSubmitButton({ onSubmit: handleFormSubmit, isDirty, isValid, isSubmitting }) : /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("div", { className: "fe-submit-actions", style: { marginTop: "16px" }, children: /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("button", { type: "button", className: "submit-button", onClick: handleFormSubmit, disabled: isSubmitting, children: FormStrings.save }) }))
     ] }),
     /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(
       ConfirmInputsModal_default,
@@ -4267,6 +4349,86 @@ function useBeforeUnload(shouldWarn, message, onAbandonment) {
   }, [shouldWarn, message]);
 }
 
+// src/helpers/FieldUtils.ts
+var GetFieldDataTestId = (fieldName, programName, entityType, entityId) => {
+  return `${programName}-${entityType}-${entityId}-${fieldName}`;
+};
+var FieldClassName = (className, error) => {
+  return error ? `${className} error` : className;
+};
+function getFieldState(props) {
+  if (props.error) return "error";
+  if (props.required) return "required";
+  if (props.readOnly) return "readonly";
+  if (props.disabled) return "disabled";
+  return void 0;
+}
+function formatDateTime(dateStr, options) {
+  if (!dateStr) return "";
+  const date = new Date(dateStr);
+  if (isNaN(date.getTime())) return dateStr;
+  if (options?.hideTimestamp) {
+    return date.toLocaleDateString(void 0, { year: "numeric", month: "short", day: "numeric" });
+  }
+  return date.toLocaleString(void 0, { year: "numeric", month: "short", day: "numeric", hour: "2-digit", minute: "2-digit" });
+}
+function formatDateTimeValue(value) {
+  if (!value) return "";
+  try {
+    return formatDateTime(value);
+  } catch {
+    return String(value);
+  }
+}
+function formatDateRange(value) {
+  if (!value) return "";
+  const v = value;
+  if (!v.start && !v.end) return "";
+  if (v.start && v.end) return `${v.start} \u2013 ${v.end}`;
+  return v.start || v.end;
+}
+function getFileNames(value) {
+  if (!value) return "";
+  if (Array.isArray(value)) return value.map((f) => f.name).join(", ");
+  return value.name ?? "";
+}
+function extractDigits(value) {
+  return value.replace(/\D/g, "");
+}
+function formatPhone(digits, format) {
+  if (format === "raw") return digits;
+  if (format === "international") {
+    const d2 = digits.slice(0, 12);
+    if (d2.length === 0) return "";
+    if (d2.length <= 1) return `+${d2}`;
+    if (d2.length <= 4) return `+${d2[0]} ${d2.slice(1)}`;
+    if (d2.length <= 7) return `+${d2[0]} ${d2.slice(1, 4)} ${d2.slice(4)}`;
+    return `+${d2[0]} ${d2.slice(1, 4)} ${d2.slice(4, 7)} ${d2.slice(7)}`;
+  }
+  const d = digits.slice(0, 10);
+  if (d.length === 0) return "";
+  if (d.length <= 3) return `(${d}`;
+  if (d.length <= 6) return `(${d.slice(0, 3)}) ${d.slice(3)}`;
+  return `(${d.slice(0, 3)}) ${d.slice(3, 6)}-${d.slice(6)}`;
+}
+function ellipsifyText(value, maxChars) {
+  if (!value || value.length <= maxChars) return value ?? "";
+  const cutoff = maxChars - 3;
+  return `${value.substring(0, cutoff)}...`;
+}
+var MAX_FILE_SIZE_MB_DEFAULT = 10;
+var DocumentLinksStrings = {
+  link: "Link",
+  addLink: "Add Link",
+  addAnotherLink: "Add Another Link",
+  deleteLink: "Delete Link",
+  confirmDeleteLink: "Are you sure you want to delete",
+  delete: "Delete",
+  cancel: "Cancel",
+  saveChanges: "Save Changes",
+  save: "Save"
+};
+
 // src/helpers/RuleTracer.ts
 var traceEnabled = false;
 var traceLog = [];
@@ -4303,9 +4465,11 @@ function isRuleTracingEnabled() {
   CheckValidDropdownOptions,
   ComponentTypes,
   ConfirmInputsModal,
+  DocumentLinksStrings,
   ExecuteComputedValue,
   FIELD_PARENT_PREFIX,
   FieldArray,
+  FieldClassName,
   FieldWrapper,
   FormConstants,
   FormDevTools,
@@ -4317,11 +4481,13 @@ function isRuleTracingEnabled() {
   GetComputedValuesOnCreate,
   GetComputedValuesOnDirtyFields,
   GetConfirmInputModalProps,
+  GetFieldDataTestId,
   GetFieldsToRender,
   InitOnCreateFormState,
   InitOnEditFormState,
   InjectedFieldProvider,
   IsExpandVisible,
+  MAX_FILE_SIZE_MB_DEFAULT,
   RenderField,
   RulesEngineActionType,
   RulesEngineProvider,
@@ -4349,6 +4515,7 @@ function isRuleTracingEnabled() {
   detectDependencyCycles,
   detectSelfDependencies,
   disableRuleTracing,
+  ellipsifyText,
   enableRuleTracing,
   evaluateAffectedFields,
   evaluateAllRules,
@@ -4356,12 +4523,19 @@ function isRuleTracingEnabled() {
   evaluateExpression,
   executeValueFunction,
   extractConditionDependencies,
+  extractDigits,
   extractExpressionDependencies,
   extractFunctionDependencies,
   flushRenderCycle,
+  formatDateRange,
+  formatDateTime,
+  formatDateTimeValue,
+  formatPhone,
   fromRjsfSchema,
   getAllValidatorMetadata,
   getCurrentLocale,
+  getFieldState,
+  getFileNames,
   getLastRenderedFields,
   getLocaleString,
   getRenderCounts,