@enjoys/react-chatbot-plugin 1.1.0 → 1.3.0

package/dist/index.d.ts

@@ -4446,6 +4446,8 @@ export declare interface ChatBotProps {
     components?: Record<string, ComponentType<StepComponentProps>>;
     /** Map of async action handlers (key = step.asyncAction.handler) */
     actionHandlers?: Record<string, (data: Record<string, unknown>, ctx: ActionContext) => Promise<FlowActionResult>>;
+    /** Override built-in form field renderers per field type. Each renderer receives strongly-typed props + the default element. */
+    renderFormField?: FormFieldRenderMap;
 }
 
 export declare const ChatBubbleIcon: default_2.FC<IconProps>;
@@ -4604,6 +4606,15 @@ declare interface CheckboxFieldProps {
     error?: string;
 }
 
+/** Props passed to checkbox custom field renderers */
+export declare interface CheckboxFieldRenderProps {
+    type: 'checkbox';
+    field: FormFieldConfig;
+    value: string[];
+    onChange: (value: string[]) => void;
+    error?: string;
+}
+
 export declare const CloseIcon: default_2.FC<IconProps>;
 
 export declare const DynamicForm: default_2.FC<DynamicFormProps>;
@@ -4612,6 +4623,7 @@ declare interface DynamicFormProps {
     config: FormConfig;
     onSubmit: (data: Record<string, unknown>) => void;
     primaryColor: string;
+    renderFormField?: FormFieldRenderMap;
 }
 
 export declare const EmojiIcon: default_2.FC<IconProps>;
@@ -4624,6 +4636,16 @@ declare interface EmojiPickerProps {
     primaryColor: string;
 }
 
+/** Props passed to file custom field renderers */
+export declare interface FileFieldRenderProps {
+    type: 'file';
+    field: FormFieldConfig;
+    value: FileList | null;
+    onChange: (value: FileList | null) => void;
+    error?: string;
+    primaryColor: string;
+}
+
 export declare const FileIcon: default_2.FC<IconProps>;
 
 export declare const FilePreviewList: default_2.FC<FilePreviewListProps>;
@@ -4791,6 +4813,27 @@ export declare interface FormFieldOption {
     value: string;
 }
 
+/** Map of field type → custom renderer. The renderer receives strongly-typed props + the default element. */
+export declare type FormFieldRenderMap = Partial<{
+    text: (props: TextFieldRenderProps, defaultElement: React.ReactNode) => React.ReactNode;
+    email: (props: TextFieldRenderProps, defaultElement: React.ReactNode) => React.ReactNode;
+    password: (props: TextFieldRenderProps, defaultElement: React.ReactNode) => React.ReactNode;
+    number: (props: TextFieldRenderProps, defaultElement: React.ReactNode) => React.ReactNode;
+    tel: (props: TextFieldRenderProps, defaultElement: React.ReactNode) => React.ReactNode;
+    url: (props: TextFieldRenderProps, defaultElement: React.ReactNode) => React.ReactNode;
+    textarea: (props: TextFieldRenderProps, defaultElement: React.ReactNode) => React.ReactNode;
+    date: (props: TextFieldRenderProps, defaultElement: React.ReactNode) => React.ReactNode;
+    time: (props: TextFieldRenderProps, defaultElement: React.ReactNode) => React.ReactNode;
+    select: (props: SelectFieldRenderProps, defaultElement: React.ReactNode) => React.ReactNode;
+    multiselect: (props: SelectFieldRenderProps, defaultElement: React.ReactNode) => React.ReactNode;
+    radio: (props: RadioFieldRenderProps, defaultElement: React.ReactNode) => React.ReactNode;
+    checkbox: (props: CheckboxFieldRenderProps, defaultElement: React.ReactNode) => React.ReactNode;
+    file: (props: FileFieldRenderProps, defaultElement: React.ReactNode) => React.ReactNode;
+}>;
+
+/** Union of all field render props — discriminated by `type` */
+export declare type FormFieldRenderProps = TextFieldRenderProps | SelectFieldRenderProps | RadioFieldRenderProps | CheckboxFieldRenderProps | FileFieldRenderProps;
+
 export declare type FormFieldType = 'text' | 'email' | 'password' | 'number' | 'tel' | 'url' | 'textarea' | 'select' | 'multiselect' | 'radio' | 'checkbox' | 'file' | 'date' | 'time' | 'hidden';
 
 export declare interface FormFieldValidation {
@@ -4838,6 +4881,7 @@ declare interface LoginScreenProps {
     config: FormConfig;
     onLogin: (data: Record<string, unknown>) => void;
     primaryColor: string;
+    renderFormField?: FormFieldRenderMap;
 }
 
 export declare interface MessageAttachment {
@@ -4872,6 +4916,8 @@ declare interface MessageListProps {
     collectedData?: Record<string, unknown>;
     /** Current step ID */
     currentStepId?: string | null;
+    /** Custom form field renderers per field type */
+    renderFormField?: FormFieldRenderMap;
 }
 
 export declare type MessageSender = 'bot' | 'user' | 'system';
@@ -4939,6 +4985,15 @@ declare interface RadioFieldProps {
     error?: string;
 }
 
+/** Props passed to radio custom field renderers */
+export declare interface RadioFieldRenderProps {
+    type: 'radio';
+    field: FormFieldConfig;
+    value: string;
+    onChange: (value: string) => void;
+    error?: string;
+}
+
 export declare const RemoveIcon: default_2.FC<IconProps>;
 
 export declare function resolveTheme(theme?: ChatTheme): Required<ChatTheme>;
@@ -4954,6 +5009,15 @@ declare interface SelectFieldProps {
     error?: string;
 }
 
+/** Props passed to select/multiselect custom field renderers */
+export declare interface SelectFieldRenderProps {
+    type: 'select' | 'multiselect';
+    field: FormFieldConfig;
+    value: string | string[];
+    onChange: (value: string | string[]) => void;
+    error?: string;
+}
+
 export declare const SendIcon: default_2.FC<IconProps>;
 
 /** Props passed to custom components rendered in flow steps */
@@ -4975,6 +5039,15 @@ declare interface TextFieldProps {
     error?: string;
 }
 
+/** Props passed to text-like custom field renderers */
+export declare interface TextFieldRenderProps {
+    type: 'text' | 'email' | 'password' | 'number' | 'tel' | 'url' | 'textarea' | 'date' | 'time';
+    field: FormFieldConfig;
+    value: string;
+    onChange: (value: string) => void;
+    error?: string;
+}
+
 export declare const TypingIndicator: default_2.FC<TypingIndicatorProps>;
 
 declare interface TypingIndicatorProps {