@form-eng/core 1.1.0 → 1.2.0

package/dist/index.d.mts

@@ -121,6 +121,29 @@ interface IRule {
     priority?: number;
 }
 
+/** Generic dictionary type */
+type Dictionary<T> = Record<string, T>;
+/** Entity data type */
+type IEntityData = Record<string, unknown>;
+/** Sub-entity value type */
+type SubEntityType = string | number | boolean | Date | object | null | undefined;
+declare function isEmpty(value: unknown): boolean;
+declare function isNull(value: unknown): value is null | undefined;
+declare function isStringEmpty(value: string | null | undefined): boolean;
+declare function deepCopy<T>(obj: T): T;
+declare function convertBooleanToYesOrNoText(value: boolean | null | undefined): string;
+/** Sort options alphabetically by label */
+declare function sortDropdownOptions(a: {
+    label?: string;
+}, b: {
+    label?: string;
+}): number;
+/** Create an option from a value string (value and label are the same) */
+declare function createOption(value: string): {
+    value: string;
+    label: string;
+};
+
 /**
  * Static configuration for a single form field (v2 schema).
  *
@@ -173,6 +196,20 @@ interface IFieldConfig {
     skipLayoutReadOnly?: boolean;
     /** Whether the field is disabled at the layout level. */
     disabled?: boolean;
+    /**
+     * Async function that loads options dynamically for select/radio/checkbox fields.
+     * When present, overrides the static `options` array with the resolved result.
+     * Results are cached per unique combination of `optionsDependsOn` field values.
+     */
+    loadOptions?: (context: {
+        fieldId: string;
+        values: IEntityData;
+    }) => Promise<IOption[]>;
+    /**
+     * Field IDs whose values trigger a re-run of `loadOptions` when they change.
+     * If omitted, `loadOptions` is only called once on mount.
+     */
+    optionsDependsOn?: string[];
 }
 
 /** Configuration for a single wizard step */
@@ -299,6 +336,8 @@ interface IFieldProps<T = Record<string, unknown>> {
     config?: T;
     /** Dropdown/select options (was `dropdownOptions` in v1) */
     options?: IOption[];
+    /** True while async loadOptions is in-flight for this field */
+    optionsLoading?: boolean;
     /** Field label */
     label?: string;
     /** Component type string */
@@ -334,6 +373,8 @@ interface IRuntimeFieldState {
     confirmInput?: boolean;
     /** Available options for dropdown-type fields (may be filtered by rules). */
     options?: IOption[];
+    /** True while async loadOptions is in-flight. Passed through to field adapters via IFieldProps. */
+    optionsLoading?: boolean;
     /** Override field label (may be set by rules). */
     label?: string;
     /** Default value to set when the field value is null and the field is visible. */
@@ -534,29 +575,6 @@ interface IFieldToRender {
     softHidden?: boolean;
 }
 
-/** Generic dictionary type */
-type Dictionary<T> = Record<string, T>;
-/** Entity data type */
-type IEntityData = Record<string, unknown>;
-/** Sub-entity value type */
-type SubEntityType = string | number | boolean | Date | object | null | undefined;
-declare function isEmpty(value: unknown): boolean;
-declare function isNull(value: unknown): value is null | undefined;
-declare function isStringEmpty(value: string | null | undefined): boolean;
-declare function deepCopy<T>(obj: T): T;
-declare function convertBooleanToYesOrNoText(value: boolean | null | undefined): string;
-/** Sort options alphabetically by label */
-declare function sortDropdownOptions(a: {
-    label?: string;
-}, b: {
-    label?: string;
-}): number;
-/** Create an option from a value string (value and label are the same) */
-declare function createOption(value: string): {
-    value: string;
-    label: string;
-};
-
 interface IFormEngineSharedProps {
     entityId?: string;
     entityType?: string;
@@ -580,6 +598,41 @@ interface IFormEngineSharedProps {
     parentEntity?: IEntityData;
 }
 
+/**
+ * Shared field config interfaces used by adapter packages.
+ * These define the shape of the `config` prop (IFieldProps.config) for specific field types.
+ */
+/** Config for Rating field */
+interface IRatingConfig {
+    max?: number;
+    allowHalf?: boolean;
+}
+/** Config for DateRange field */
+interface IDateRangeConfig {
+    minDate?: string;
+    maxDate?: string;
+}
+/** Value shape for DateRange field */
+interface IDateRangeValue {
+    start: string;
+    end: string;
+}
+/** Config for DateTime field */
+interface IDateTimeConfig {
+    minDateTime?: string;
+    maxDateTime?: string;
+}
+/** Config for FileUpload field */
+interface IFileUploadConfig {
+    multiple?: boolean;
+    accept?: string;
+    maxSizeMb?: number;
+}
+/** Config for PhoneInput field */
+interface IPhoneInputConfig {
+    format?: "us" | "international" | "raw";
+}
+
 declare const FIELD_PARENT_PREFIX = "Parent.";
 /** Component type constants */
 declare const ComponentTypes: {
@@ -990,6 +1043,8 @@ interface IFormEngineProps extends IFormEngineSharedProps {
         isSubmitting: boolean;
     }) => React.ReactNode;
     formErrors?: string[];
+    /** Per-field server-side errors to inject (e.g. from a failed API save). Keys are field names, values are error messages. */
+    fieldErrors?: Record<string, string>;
     renderLabel?: (props: {
         id: string;
         labelId: string;
@@ -1008,6 +1063,17 @@ interface IFormEngineProps extends IFormEngineSharedProps {
         errorCount?: number;
         isManualSave?: boolean;
     }) => React.ReactNode;
+    /** Called with validated form values when the user submits. Works alongside auto-save. */
+    onSubmit?: (values: IEntityData) => void | Promise<void>;
+    /** Called with RHF FieldErrors when submit validation fails. */
+    onSubmitError?: (errors: react_hook_form.FieldErrors) => void;
+    /** Render prop for a custom submit button. If onSubmit is provided and this is omitted, a default submit button is rendered. */
+    renderSubmitButton?: (props: {
+        onSubmit: () => void;
+        isDirty: boolean;
+        isValid: boolean;
+        isSubmitting: boolean;
+    }) => React.ReactNode;
 }
 declare const FormEngine: React.FC<IFormEngineProps>;
 
@@ -1127,6 +1193,7 @@ interface IRenderFieldProps {
     readOnly?: boolean;
     disabled?: boolean;
     options?: IOption[];
+    optionsLoading?: boolean;
     validate?: IValidationRule[];
     parentEntityId?: string;
     parentEntityType?: string;
@@ -1384,25 +1451,73 @@ declare function serializeFormState(data: IEntityData): string;
 declare function deserializeFormState(json: string): IEntityData;
 
 /**
- * Evaluates an expression string against form values.
- *
- * Supports:
- * - $values.fieldName for field references (including nested paths)
- * - $fn.name() for value function calls
- * - $parent.fieldName for parent entity references
- * - $root.fieldName alias for $values.fieldName
- * - Math functions: Math.round, Math.floor, Math.ceil, Math.abs, Math.min, Math.max
- * - Arithmetic: +, -, *, /
- * - Comparison: >, <, >=, <=, ===, !==
- * - Logical: &&, ||
- * - String concatenation via +
- *
- * @example
- *   "$values.quantity * $values.unitPrice"
- *   "$fn.setDate()"
- *   "$parent.category"
- *   "Math.round($values.total * 100) / 100"
+ * Generates a consistent data-testid for field components.
+ * Used by all adapter packages for test attribute generation.
+ */
+declare const GetFieldDataTestId: (fieldName: string, programName?: string, entityType?: string, entityId?: string) => string;
+/**
+ * Appends "error" to a className when a field has a validation error.
+ * Used by Fluent and MUI adapters for error styling.
+ */
+declare const FieldClassName: (className: string, error?: FieldError) => string;
+/**
+ * Returns a field state string based on the current field props.
+ * Used by headless adapter for data-state attributes.
+ */
+declare function getFieldState(props: {
+    error?: FieldError;
+    required?: boolean;
+    readOnly?: boolean;
+    disabled?: boolean;
+}): string | undefined;
+/**
+ * Formats an ISO date string for display.
+ * Returns short date (e.g. "Jan 15, 2024") or date+time (e.g. "Jan 15, 2024, 02:30 PM").
+ */
+declare function formatDateTime(dateStr: string, options?: {
+    hideTimestamp?: boolean;
+}): string;
+/**
+ * Safely formats a value as a date+time string, falling back to String() on error.
  */
+declare function formatDateTimeValue(value: unknown): string;
+/**
+ * Formats a date range value for read-only display.
+ * Returns "start – end", or just the one that exists.
+ */
+declare function formatDateRange(value: unknown): string;
+/**
+ * Extracts display names from File or File[] values.
+ */
+declare function getFileNames(value: unknown): string;
+/**
+ * Strips all non-digit characters from a string.
+ */
+declare function extractDigits(value: string): string;
+/**
+ * Formats a digit string as a phone number.
+ * Supports US "(XXX) XXX-XXXX", international "+X XXX XXX XXXX", and raw digits.
+ */
+declare function formatPhone(digits: string, format: "us" | "international" | "raw"): string;
+/**
+ * Truncates text with "..." if it exceeds maxChars.
+ */
+declare function ellipsifyText(value: string, maxChars: number): string;
+/** Default max file size in MB for FileUpload fields */
+declare const MAX_FILE_SIZE_MB_DEFAULT = 10;
+/** Shared strings for DocumentLinks component */
+declare const DocumentLinksStrings: {
+    link: string;
+    addLink: string;
+    addAnotherLink: string;
+    deleteLink: string;
+    confirmDeleteLink: string;
+    delete: string;
+    cancel: string;
+    saveChanges: string;
+    save: string;
+};
+
 declare function evaluateExpression(expression: string, values: IEntityData, fieldName?: string, parentEntity?: IEntityData, currentUserId?: string): unknown;
 /**
  * Extracts field names referenced in an expression via $values.fieldName or $root.fieldName.
@@ -1485,4 +1600,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 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 };
+export { CheckAsyncFieldValidationRules, CheckDefaultValues, CheckFieldValidationRules, CheckValidDropdownOptions, ComponentTypes, ConfirmInputsModal, type Dictionary, DocumentLinksStrings, ExecuteComputedValue, FIELD_PARENT_PREFIX, FieldArray, FieldClassName, FieldWrapper, FormConstants, FormDevTools, FormEngine, FormErrorBoundary, FormFields, FormStrings, GetChildEntity, GetComputedValuesOnCreate, GetComputedValuesOnDirtyFields, GetConfirmInputModalProps, GetFieldDataTestId, GetFieldsToRender, type IAnalyticsCallbacks, type IClearRulesAction, type ICondition, type IConfigValidationError, type IConfirmInputModalProps, type ICoreLocaleStrings, type ICycleError, type IDateRangeConfig, type IDateRangeValue, type IDateTimeConfig, type IDraftPersistenceOptions, type IDraftState, type IEntityData, type IFieldArrayProps, type IFieldCondition, type IFieldConfig, type IFieldEffect, type IFieldProps, type IFieldToRender, type IFileUploadConfig, type IFormAnalytics, type IFormConfig, type IFormDevToolsProps, type IFormEngineSharedProps, type IFormSettings, type IInjectedFieldProvider, type IJsonSchemaNode, type ILogicalCondition, type IOption, type IPhoneInputConfig, type IRatingConfig, 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, MAX_FILE_SIZE_MB_DEFAULT, _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, ellipsifyText, enableRuleTracing, evaluateAffectedFields, evaluateAllRules, evaluateCondition, evaluateExpression, executeValueFunction, extractConditionDependencies, extractDigits, extractExpressionDependencies, extractFunctionDependencies, flushRenderCycle, formatDateRange, formatDateTime, formatDateTimeValue, formatPhone, fromRjsfSchema, getAllValidatorMetadata, getCurrentLocale, getFieldState, getFileNames, 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

@@ -121,6 +121,29 @@ interface IRule {
     priority?: number;
 }
 
+/** Generic dictionary type */
+type Dictionary<T> = Record<string, T>;
+/** Entity data type */
+type IEntityData = Record<string, unknown>;
+/** Sub-entity value type */
+type SubEntityType = string | number | boolean | Date | object | null | undefined;
+declare function isEmpty(value: unknown): boolean;
+declare function isNull(value: unknown): value is null | undefined;
+declare function isStringEmpty(value: string | null | undefined): boolean;
+declare function deepCopy<T>(obj: T): T;
+declare function convertBooleanToYesOrNoText(value: boolean | null | undefined): string;
+/** Sort options alphabetically by label */
+declare function sortDropdownOptions(a: {
+    label?: string;
+}, b: {
+    label?: string;
+}): number;
+/** Create an option from a value string (value and label are the same) */
+declare function createOption(value: string): {
+    value: string;
+    label: string;
+};
+
 /**
  * Static configuration for a single form field (v2 schema).
  *
@@ -173,6 +196,20 @@ interface IFieldConfig {
     skipLayoutReadOnly?: boolean;
     /** Whether the field is disabled at the layout level. */
     disabled?: boolean;
+    /**
+     * Async function that loads options dynamically for select/radio/checkbox fields.
+     * When present, overrides the static `options` array with the resolved result.
+     * Results are cached per unique combination of `optionsDependsOn` field values.
+     */
+    loadOptions?: (context: {
+        fieldId: string;
+        values: IEntityData;
+    }) => Promise<IOption[]>;
+    /**
+     * Field IDs whose values trigger a re-run of `loadOptions` when they change.
+     * If omitted, `loadOptions` is only called once on mount.
+     */
+    optionsDependsOn?: string[];
 }
 
 /** Configuration for a single wizard step */
@@ -299,6 +336,8 @@ interface IFieldProps<T = Record<string, unknown>> {
     config?: T;
     /** Dropdown/select options (was `dropdownOptions` in v1) */
     options?: IOption[];
+    /** True while async loadOptions is in-flight for this field */
+    optionsLoading?: boolean;
     /** Field label */
     label?: string;
     /** Component type string */
@@ -334,6 +373,8 @@ interface IRuntimeFieldState {
     confirmInput?: boolean;
     /** Available options for dropdown-type fields (may be filtered by rules). */
     options?: IOption[];
+    /** True while async loadOptions is in-flight. Passed through to field adapters via IFieldProps. */
+    optionsLoading?: boolean;
     /** Override field label (may be set by rules). */
     label?: string;
     /** Default value to set when the field value is null and the field is visible. */
@@ -534,29 +575,6 @@ interface IFieldToRender {
     softHidden?: boolean;
 }
 
-/** Generic dictionary type */
-type Dictionary<T> = Record<string, T>;
-/** Entity data type */
-type IEntityData = Record<string, unknown>;
-/** Sub-entity value type */
-type SubEntityType = string | number | boolean | Date | object | null | undefined;
-declare function isEmpty(value: unknown): boolean;
-declare function isNull(value: unknown): value is null | undefined;
-declare function isStringEmpty(value: string | null | undefined): boolean;
-declare function deepCopy<T>(obj: T): T;
-declare function convertBooleanToYesOrNoText(value: boolean | null | undefined): string;
-/** Sort options alphabetically by label */
-declare function sortDropdownOptions(a: {
-    label?: string;
-}, b: {
-    label?: string;
-}): number;
-/** Create an option from a value string (value and label are the same) */
-declare function createOption(value: string): {
-    value: string;
-    label: string;
-};
-
 interface IFormEngineSharedProps {
     entityId?: string;
     entityType?: string;
@@ -580,6 +598,41 @@ interface IFormEngineSharedProps {
     parentEntity?: IEntityData;
 }
 
+/**
+ * Shared field config interfaces used by adapter packages.
+ * These define the shape of the `config` prop (IFieldProps.config) for specific field types.
+ */
+/** Config for Rating field */
+interface IRatingConfig {
+    max?: number;
+    allowHalf?: boolean;
+}
+/** Config for DateRange field */
+interface IDateRangeConfig {
+    minDate?: string;
+    maxDate?: string;
+}
+/** Value shape for DateRange field */
+interface IDateRangeValue {
+    start: string;
+    end: string;
+}
+/** Config for DateTime field */
+interface IDateTimeConfig {
+    minDateTime?: string;
+    maxDateTime?: string;
+}
+/** Config for FileUpload field */
+interface IFileUploadConfig {
+    multiple?: boolean;
+    accept?: string;
+    maxSizeMb?: number;
+}
+/** Config for PhoneInput field */
+interface IPhoneInputConfig {
+    format?: "us" | "international" | "raw";
+}
+
 declare const FIELD_PARENT_PREFIX = "Parent.";
 /** Component type constants */
 declare const ComponentTypes: {
@@ -990,6 +1043,8 @@ interface IFormEngineProps extends IFormEngineSharedProps {
         isSubmitting: boolean;
     }) => React.ReactNode;
     formErrors?: string[];
+    /** Per-field server-side errors to inject (e.g. from a failed API save). Keys are field names, values are error messages. */
+    fieldErrors?: Record<string, string>;
     renderLabel?: (props: {
         id: string;
         labelId: string;
@@ -1008,6 +1063,17 @@ interface IFormEngineProps extends IFormEngineSharedProps {
         errorCount?: number;
         isManualSave?: boolean;
     }) => React.ReactNode;
+    /** Called with validated form values when the user submits. Works alongside auto-save. */
+    onSubmit?: (values: IEntityData) => void | Promise<void>;
+    /** Called with RHF FieldErrors when submit validation fails. */
+    onSubmitError?: (errors: react_hook_form.FieldErrors) => void;
+    /** Render prop for a custom submit button. If onSubmit is provided and this is omitted, a default submit button is rendered. */
+    renderSubmitButton?: (props: {
+        onSubmit: () => void;
+        isDirty: boolean;
+        isValid: boolean;
+        isSubmitting: boolean;
+    }) => React.ReactNode;
 }
 declare const FormEngine: React.FC<IFormEngineProps>;
 
@@ -1127,6 +1193,7 @@ interface IRenderFieldProps {
     readOnly?: boolean;
     disabled?: boolean;
     options?: IOption[];
+    optionsLoading?: boolean;
     validate?: IValidationRule[];
     parentEntityId?: string;
     parentEntityType?: string;
@@ -1384,25 +1451,73 @@ declare function serializeFormState(data: IEntityData): string;
 declare function deserializeFormState(json: string): IEntityData;
 
 /**
- * Evaluates an expression string against form values.
- *
- * Supports:
- * - $values.fieldName for field references (including nested paths)
- * - $fn.name() for value function calls
- * - $parent.fieldName for parent entity references
- * - $root.fieldName alias for $values.fieldName
- * - Math functions: Math.round, Math.floor, Math.ceil, Math.abs, Math.min, Math.max
- * - Arithmetic: +, -, *, /
- * - Comparison: >, <, >=, <=, ===, !==
- * - Logical: &&, ||
- * - String concatenation via +
- *
- * @example
- *   "$values.quantity * $values.unitPrice"
- *   "$fn.setDate()"
- *   "$parent.category"
- *   "Math.round($values.total * 100) / 100"
+ * Generates a consistent data-testid for field components.
+ * Used by all adapter packages for test attribute generation.
+ */
+declare const GetFieldDataTestId: (fieldName: string, programName?: string, entityType?: string, entityId?: string) => string;
+/**
+ * Appends "error" to a className when a field has a validation error.
+ * Used by Fluent and MUI adapters for error styling.
+ */
+declare const FieldClassName: (className: string, error?: FieldError) => string;
+/**
+ * Returns a field state string based on the current field props.
+ * Used by headless adapter for data-state attributes.
+ */
+declare function getFieldState(props: {
+    error?: FieldError;
+    required?: boolean;
+    readOnly?: boolean;
+    disabled?: boolean;
+}): string | undefined;
+/**
+ * Formats an ISO date string for display.
+ * Returns short date (e.g. "Jan 15, 2024") or date+time (e.g. "Jan 15, 2024, 02:30 PM").
+ */
+declare function formatDateTime(dateStr: string, options?: {
+    hideTimestamp?: boolean;
+}): string;
+/**
+ * Safely formats a value as a date+time string, falling back to String() on error.
  */
+declare function formatDateTimeValue(value: unknown): string;
+/**
+ * Formats a date range value for read-only display.
+ * Returns "start – end", or just the one that exists.
+ */
+declare function formatDateRange(value: unknown): string;
+/**
+ * Extracts display names from File or File[] values.
+ */
+declare function getFileNames(value: unknown): string;
+/**
+ * Strips all non-digit characters from a string.
+ */
+declare function extractDigits(value: string): string;
+/**
+ * Formats a digit string as a phone number.
+ * Supports US "(XXX) XXX-XXXX", international "+X XXX XXX XXXX", and raw digits.
+ */
+declare function formatPhone(digits: string, format: "us" | "international" | "raw"): string;
+/**
+ * Truncates text with "..." if it exceeds maxChars.
+ */
+declare function ellipsifyText(value: string, maxChars: number): string;
+/** Default max file size in MB for FileUpload fields */
+declare const MAX_FILE_SIZE_MB_DEFAULT = 10;
+/** Shared strings for DocumentLinks component */
+declare const DocumentLinksStrings: {
+    link: string;
+    addLink: string;
+    addAnotherLink: string;
+    deleteLink: string;
+    confirmDeleteLink: string;
+    delete: string;
+    cancel: string;
+    saveChanges: string;
+    save: string;
+};
+
 declare function evaluateExpression(expression: string, values: IEntityData, fieldName?: string, parentEntity?: IEntityData, currentUserId?: string): unknown;
 /**
  * Extracts field names referenced in an expression via $values.fieldName or $root.fieldName.
@@ -1485,4 +1600,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 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 };
+export { CheckAsyncFieldValidationRules, CheckDefaultValues, CheckFieldValidationRules, CheckValidDropdownOptions, ComponentTypes, ConfirmInputsModal, type Dictionary, DocumentLinksStrings, ExecuteComputedValue, FIELD_PARENT_PREFIX, FieldArray, FieldClassName, FieldWrapper, FormConstants, FormDevTools, FormEngine, FormErrorBoundary, FormFields, FormStrings, GetChildEntity, GetComputedValuesOnCreate, GetComputedValuesOnDirtyFields, GetConfirmInputModalProps, GetFieldDataTestId, GetFieldsToRender, type IAnalyticsCallbacks, type IClearRulesAction, type ICondition, type IConfigValidationError, type IConfirmInputModalProps, type ICoreLocaleStrings, type ICycleError, type IDateRangeConfig, type IDateRangeValue, type IDateTimeConfig, type IDraftPersistenceOptions, type IDraftState, type IEntityData, type IFieldArrayProps, type IFieldCondition, type IFieldConfig, type IFieldEffect, type IFieldProps, type IFieldToRender, type IFileUploadConfig, type IFormAnalytics, type IFormConfig, type IFormDevToolsProps, type IFormEngineSharedProps, type IFormSettings, type IInjectedFieldProvider, type IJsonSchemaNode, type ILogicalCondition, type IOption, type IPhoneInputConfig, type IRatingConfig, 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, MAX_FILE_SIZE_MB_DEFAULT, _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, ellipsifyText, enableRuleTracing, evaluateAffectedFields, evaluateAllRules, evaluateCondition, evaluateExpression, executeValueFunction, extractConditionDependencies, extractDigits, extractExpressionDependencies, extractFunctionDependencies, flushRenderCycle, formatDateRange, formatDateTime, formatDateTimeValue, formatPhone, fromRjsfSchema, getAllValidatorMetadata, getCurrentLocale, getFieldState, getFileNames, 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 };