finform-react-builder 1.13.1 → 1.15.0

package/dist/components/FinForm/CustomButtons.d.ts

@@ -3,6 +3,7 @@ import { FormButton } from './types';
 interface CustomButtonsProps {
     buttons: FormButton[];
     disabled?: boolean;
+    testIdPrefix?: string;
 }
 export declare const CustomButtons: React.FC<CustomButtonsProps>;
 export {};

package/dist/components/FinForm/index.d.ts

@@ -6,4 +6,5 @@ export { CustomButtons } from './CustomButtons';
 export { generateSchema } from './generateSchema';
 export { fetchApiData, hasApiConfig, getApiConfig, shouldShowField, useApiData } from './apiUtils';
 export * from './inputs';
-export type { FieldConfig, ValidationRule, FormButton, ButtonGroup, FormTitle, FormTheme, FinFormProps, ApiConfig, } from './types';
+export type { FieldConfig, AutomationFieldConfig, ValidationRule, FormButton, ButtonGroup, FormTitle, FormTheme, FinFormProps, ApiConfig, } from './types';
+export { buildFinformTestIds, resolveFieldTestIds } from './testIds';

package/dist/components/FinForm/inputs/FinAutocomplete.d.ts

@@ -21,5 +21,9 @@ export interface FinAutocompleteProps {
     onOpen?: () => void;
     noOptionsText?: string;
     sx?: any;
+    inputTestId?: string;
+    labelTestId?: string;
+    errorTestId?: string;
+    optionTestId?: (optionValue: string | number) => string;
 }
 export declare const FinAutocomplete: React.FC<FinAutocompleteProps>;

package/dist/components/FinForm/inputs/FinCheckbox.d.ts

@@ -5,5 +5,7 @@ export interface FinCheckboxProps {
     disabled?: boolean;
     onChange: (checked: boolean) => void;
     sx?: any;
+    inputTestId?: string;
+    labelTestId?: string;
 }
 export declare const FinCheckbox: React.FC<FinCheckboxProps>;

package/dist/components/FinForm/inputs/FinDateField.d.ts

@@ -1,9 +1,36 @@
 import { default as React } from 'react';
-import { TextFieldProps } from '@mui/material';
-export type FinDateFieldProps = TextFieldProps & {
+export declare const DEFAULT_DATE_FORMAT = "DD-MM-YYYY";
+/** Map dayjs format tokens to a human placeholder (DD/MM/YYYY, etc.). */
+export declare function dateFormatToPlaceholder(format: string): string;
+export type FinDateFieldProps = {
+    value?: string | null;
+    onChange?: (value: string) => void;
+    onBlur?: () => void;
+    name?: string;
+    /** Dayjs format for typed input + display (e.g. DD-MM-YYYY). */
+    dateFormat?: string;
+    minDate?: string;
+    maxDate?: string;
     label?: React.ReactNode;
     labelPosition?: 'inner' | 'top' | 'none';
     labelVariant?: 'caption' | 'body2' | 'subtitle2' | 'h6';
-    [key: string]: any;
+    disabled?: boolean;
+    error?: boolean;
+    helperText?: React.ReactNode;
+    fullWidth?: boolean;
+    size?: 'small' | 'medium';
+    placeholder?: string;
+    sx?: any;
+    inputTestId?: string;
+    labelTestId?: string;
+    errorTestId?: string;
+    /** @deprecated Use minDate / maxDate props. Kept for FieldRenderer backward compat. */
+    inputProps?: {
+        min?: string;
+        max?: string;
+        [key: string]: unknown;
+    };
+    id?: string;
+    required?: boolean;
 };
 export declare const FinDateField: React.FC<FinDateFieldProps>;

package/dist/components/FinForm/inputs/FinEditableGrid.d.ts

@@ -45,6 +45,8 @@ export type GridColumn = {
     };
     sx?: any;
     cellSx?: any;
+    /** Per-column dayjs format override for date columns. */
+    dateFormat?: string;
 };
 export interface FinEditableGridProps {
     name: string;
@@ -68,6 +70,8 @@ export interface FinEditableGridProps {
     setValue?: (name: string, value: any, options?: any) => void;
     rowSelectionMode?: "single" | "multi";
     rowSelectionKey?: string;
+    /** Form-level dayjs date format for date columns. */
+    dateFormat?: string;
 }
 export declare const FinEditableGrid: React.FC<FinEditableGridProps>;
 export default FinEditableGrid;

package/dist/components/FinForm/inputs/FinSelect.d.ts

@@ -12,5 +12,9 @@ export interface FinSelectProps extends Omit<SelectProps, 'onChange'> {
     onChange?: SelectProps['onChange'];
     labelVariant?: 'caption' | 'body2' | 'subtitle2' | 'h6';
     placeholder?: string;
+    inputTestId?: string;
+    labelTestId?: string;
+    errorTestId?: string;
+    optionTestId?: (optionValue: string | number) => string;
 }
 export declare const FinSelect: React.FC<FinSelectProps>;

package/dist/components/FinForm/inputs/FinTextField.d.ts

@@ -11,5 +11,8 @@ export type FinTextFieldProps = TextFieldProps & {
     endorsementRadius?: number | string;
     endorsementHeight?: number;
     endorsementPaddingX?: number;
+    inputTestId?: string;
+    labelTestId?: string;
+    errorTestId?: string;
 };
 export declare const FinTextField: React.FC<FinTextFieldProps>;

package/dist/components/FinForm/inputs/FinTextarea.d.ts

@@ -4,5 +4,8 @@ export type FinTextareaProps = TextFieldProps & {
     labelText?: string;
     labelVariant?: 'caption' | 'body2' | 'subtitle2' | 'h6';
     hasError?: boolean;
+    inputTestId?: string;
+    labelTestId?: string;
+    errorTestId?: string;
 };
 export declare const FinTextarea: React.FC<FinTextareaProps>;

package/dist/components/FinForm/testIds.d.ts

@@ -0,0 +1,24 @@
+import { FieldConfig } from './types';
+export interface FinformFieldTestIds {
+    field: string;
+    label: string;
+    input: string;
+    error: string;
+    section: string;
+    upload: string;
+    preview: string;
+    remove: string;
+    replace: string;
+    option: (optionValue: string | number) => string;
+    submit: string;
+    cancel: string;
+}
+export declare function buildFinformTestIds(prefix: string, fieldName: string): FinformFieldTestIds;
+export type ResolvedFieldTestIds = Omit<FinformFieldTestIds, 'submit' | 'cancel' | 'option'> & {
+    option: (optionValue: string | number) => string;
+};
+export declare function resolveFieldTestIds(prefix: string | undefined, field: FieldConfig): ResolvedFieldTestIds | null;
+export declare function resolveFormButtonTestIds(prefix: string | undefined): {
+    submit: string;
+    cancel: string;
+} | null;

package/dist/components/FinForm/types.d.ts

@@ -153,6 +153,8 @@ export interface DateField extends BaseField {
     type: 'date';
     minDate?: string;
     maxDate?: string;
+    /** Per-field dayjs format override (e.g. DD-MM-YYYY). Falls back to FinForm dateFormat. */
+    dateFormat?: string;
 }
 export interface ImageField extends BaseField {
     type: 'image';
@@ -341,6 +343,18 @@ export interface DragDropListField extends Omit<BaseField, 'helperText'> {
     sx?: any;
 }
 export type FieldConfig = TextField | NumberField | SelectField | CheckboxField | CheckboxGroupField | ToggleField | RadioField | SwitchField | AutocompleteField | DateField | ImageField | TitleField | SectionField | ComponentField | FinUiHeaderField | TabsField | GridField | ListCardsField | DragDropListField;
+export type AutomationFieldConfig = FieldConfig & {
+    testId?: string;
+    automation?: {
+        skip?: boolean;
+        fieldTestId?: string;
+        inputTestId?: string;
+        labelTestId?: string;
+        errorTestId?: string;
+        sampleValue?: unknown;
+        invalidValue?: unknown;
+    };
+};
 export interface FormButton {
     text: string;
     color?: string;
@@ -408,6 +422,13 @@ export interface FinFormProps {
         showStepTitles?: boolean;
         stepTitles?: string[];
     };
+    /** Prefix for stable data-testid attributes on generated form controls (e.g. "client-profile"). */
+    testIdPrefix?: string;
+    /**
+     * Dayjs format for all date fields (e.g. DD-MM-YYYY, MM-DD-YYYY, YYYY-MM-DD).
+     * Host app should map company regional settings to this value.
+     */
+    dateFormat?: string;
 }
 export interface FieldRendererProps {
     field: FieldConfig;
@@ -417,6 +438,15 @@ export interface FieldRendererProps {
     apiHeaders?: Record<string, string>;
     formData?: Record<string, any>;
     setValue?: (name: string, value: any, options?: any) => void;
+    testIdPrefix?: string;
+    /** Form-level dayjs date format inherited by date fields. */
+    dateFormat?: string;
+}
+export interface FinInputTestIdProps {
+    inputTestId?: string;
+    labelTestId?: string;
+    errorTestId?: string;
+    optionTestId?: (optionValue: string | number) => string;
 }
 export interface StepNavigationProps {
     currentStep: number;