@form-eng/core 1.1.1 → 1.2.0

package/dist/index.mjs

@@ -488,7 +488,27 @@ function resetValueFunctionRegistry() {
 }
 
 // src/helpers/ExpressionEngine.ts
+import { Parser } from "expr-eval";
+var _parser = new 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) => {
@@ -501,48 +521,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;
   }
@@ -1844,6 +1851,7 @@ var RenderField = (props) => {
     readOnly,
     disabled,
     options,
+    optionsLoading,
     validate,
     parentEntityId,
     parentEntityType,
@@ -1938,6 +1946,7 @@ var RenderField = (props) => {
                   savePending,
                   config,
                   options,
+                  optionsLoading,
                   label,
                   type,
                   description,
@@ -1970,6 +1979,7 @@ var RenderField = (props) => {
     readOnly,
     disabled,
     options,
+    optionsLoading,
     softHidden,
     renderLabel,
     renderError,
@@ -2110,6 +2120,7 @@ var ConfirmInputsModal_default = ConfirmInputsModal;
 
 // src/components/InlineFormFields.tsx
 import React9 from "react";
+import { useFormContext as useFormContext4 } from "react-hook-form";
 
 // src/components/FormErrorBoundary.tsx
 import React8 from "react";
@@ -2169,6 +2180,33 @@ var FormFields = (props) => {
     renderStatus,
     analytics
   } = props;
+  const [asyncOptions, setAsyncOptions] = React9.useState({});
+  const [asyncOptionsLoading, setAsyncOptionsLoading] = React9.useState({});
+  const asyncCacheKeyRef = React9.useRef({});
+  const { getValues } = useFormContext4();
+  React9.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`;
@@ -2196,7 +2234,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,
@@ -2254,9 +2293,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;
@@ -2292,6 +2335,12 @@ var FormEngine = (props) => {
   React10.useEffect(() => {
     initForm(defaultValues);
   }, [areAllFieldsReadonly]);
+  React10.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));
@@ -2437,6 +2486,26 @@ var FormEngine = (props) => {
       }
     });
   };
+  const handleFormSubmit = React10.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 = React10.useCallback((value) => {
     if (filterTimeoutRef.current) clearTimeout(filterTimeoutRef.current);
     filterTimeoutRef.current = setTimeout(() => setFilterText(value), 500);
@@ -2492,7 +2561,8 @@ var FormEngine = (props) => {
           reset();
           initForm(defaultValues);
         }, disabled: !isDirty || isSubmitting, children: FormStrings.cancel })
-      ] }))
+      ] })),
+      onSubmitProp && (renderSubmitButton ? renderSubmitButton({ onSubmit: handleFormSubmit, isDirty, isValid, isSubmitting }) : /* @__PURE__ */ jsx10("div", { className: "fe-submit-actions", style: { marginTop: "16px" }, children: /* @__PURE__ */ jsx10("button", { type: "button", className: "submit-button", onClick: handleFormSubmit, disabled: isSubmitting, children: FormStrings.save }) }))
     ] }),
     /* @__PURE__ */ jsx10(
       ConfirmInputsModal_default,
@@ -4121,6 +4191,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 = [];
@@ -4156,9 +4306,11 @@ export {
   CheckValidDropdownOptions,
   ComponentTypes,
   ConfirmInputsModal_default as ConfirmInputsModal,
+  DocumentLinksStrings,
   ExecuteComputedValue,
   FIELD_PARENT_PREFIX,
   FieldArray,
+  FieldClassName,
   FieldWrapper,
   FormConstants,
   FormDevTools,
@@ -4170,11 +4322,13 @@ export {
   GetComputedValuesOnCreate,
   GetComputedValuesOnDirtyFields,
   GetConfirmInputModalProps,
+  GetFieldDataTestId,
   GetFieldsToRender,
   InitOnCreateFormState,
   InitOnEditFormState,
   InjectedFieldProvider,
   IsExpandVisible,
+  MAX_FILE_SIZE_MB_DEFAULT,
   RenderField_default as RenderField,
   RulesEngineActionType,
   RulesEngineProvider,
@@ -4202,6 +4356,7 @@ export {
   detectDependencyCycles,
   detectSelfDependencies,
   disableRuleTracing,
+  ellipsifyText,
   enableRuleTracing,
   evaluateAffectedFields,
   evaluateAllRules,
@@ -4209,12 +4364,19 @@ export {
   evaluateExpression,
   executeValueFunction,
   extractConditionDependencies,
+  extractDigits,
   extractExpressionDependencies,
   extractFunctionDependencies,
   flushRenderCycle,
+  formatDateRange,
+  formatDateTime,
+  formatDateTimeValue,
+  formatPhone,
   fromRjsfSchema,
   getAllValidatorMetadata,
   getCurrentLocale,
+  getFieldState,
+  getFileNames,
   getLastRenderedFields,
   getLocaleString,
   getRenderCounts,