finform-react-builder 1.4.0 → 1.5.0

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

@@ -0,0 +1,38 @@
+import { ApiConfig } from './types';
+export interface ApiResponse<T = any> {
+    data: T;
+    status: number;
+    statusText: string;
+}
+export interface ApiError {
+    message: string;
+    status?: number;
+    statusText?: string;
+}
+/**
+ * Fetches data from an API endpoint using React Query
+ */
+export declare function fetchApiData(apiConfig: ApiConfig, baseUrl?: string, defaultHeaders?: Record<string, string>, dependentValues?: Record<string, any>): Promise<Array<{
+    label: string;
+    value: string | number;
+}>>;
+/**
+ * React Query hook for fetching API data with caching - only fetches on user interaction
+ */
+export declare function useApiData(apiConfig: ApiConfig | null, baseUrl?: string, defaultHeaders?: Record<string, string>, dependentValues?: Record<string, any>, // Changed from formData to dependentValues
+enabled?: boolean): import('@tanstack/react-query').UseQueryResult<{
+    label: string;
+    value: string | number;
+}[], Error>;
+/**
+ * Checks if a field has API configuration
+ */
+export declare function hasApiConfig(field: any): boolean;
+/**
+ * Gets the API configuration from a field
+ */
+export declare function getApiConfig(field: any): ApiConfig | null;
+/**
+ * Checks if a field should be shown based on conditional logic
+ */
+export declare function shouldShowField(field: any, formData: Record<string, any>): boolean;

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

@@ -4,4 +4,5 @@ export { StepNavigation } from './StepNavigation';
 export { ImageComponent } from './ImageComponent';
 export { CustomButtons } from './CustomButtons';
 export { generateSchema } from './generateSchema';
-export type { FieldConfig, BaseField, TextField, NumberField, SelectField, CheckboxField, ToggleField, RadioField, SwitchField, AutocompleteField, DateField, ImageField, FinFormProps, FieldRendererProps, ValidationRule, StepNavigationProps, FormButton, ButtonGroup, FormTitle, FormTheme, } from './types';
+export { fetchApiData, hasApiConfig, getApiConfig, shouldShowField, useApiData } from './apiUtils';
+export type { FieldConfig, ValidationRule, FormButton, ButtonGroup, FormTitle, FormTheme, FinFormProps, ApiConfig, } from './types';

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

@@ -4,16 +4,31 @@ export interface ValidationRule {
     required?: boolean;
     minLength?: number;
     maxLength?: number;
-    min?: number;
-    max?: number;
+    min?: number | string;
+    max?: number | string;
     custom?: (value: any) => boolean | string;
 }
+export interface ApiConfig {
+    endpoint: string;
+    method?: 'GET' | 'POST' | 'PUT' | 'DELETE';
+    valueField?: string;
+    labelField?: string;
+    headers?: Record<string, string>;
+    params?: Record<string, any>;
+    body?: any;
+    transform?: (data: any[]) => Array<{
+        label: string;
+        value: string | number;
+    }>;
+    dependsOn?: string;
+    conditional?: boolean;
+}
 export interface BaseField {
     id?: string;
     title?: string;
     name: string;
     label: string;
-    type: 'text' | 'email' | 'password' | 'number' | 'select' | 'checkbox' | 'toggle' | 'radio' | 'switch' | 'autocomplete' | 'date' | 'textarea' | 'image' | 'title' | 'section';
+    type: 'text' | 'email' | 'password' | 'number' | 'tel' | 'select' | 'checkbox' | 'toggle' | 'radio' | 'switch' | 'autocomplete' | 'date' | 'textarea' | 'image' | 'title' | 'section';
     placeholder?: string;
     required?: boolean;
     disabled?: boolean;
@@ -26,9 +41,16 @@ export interface BaseField {
     md?: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12;
     lg?: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12;
     xl?: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12;
+    api_endpoint?: string;
+    api_method?: 'GET' | 'POST' | 'PUT' | 'DELETE';
+    value_field?: string;
+    label_field?: string;
+    depends_on?: string;
+    conditional?: boolean;
+    apiConfig?: ApiConfig;
 }
 export interface TextField extends BaseField {
-    type: 'text' | 'email' | 'password' | 'textarea';
+    type: 'text' | 'email' | 'password' | 'tel' | 'textarea';
     minLength?: number;
     maxLength?: number;
     pattern?: string;
@@ -40,10 +62,18 @@ export interface NumberField extends BaseField {
 }
 export interface SelectField extends BaseField {
     type: 'select';
-    options: Array<{
+    options?: Array<{
         label: string;
         value: string | number;
     }>;
+    default?: string | number;
+    api_endpoint?: string;
+    api_method?: 'GET' | 'POST' | 'PUT' | 'DELETE';
+    value_field?: string;
+    label_field?: string;
+    depends_on?: string;
+    conditional?: boolean;
+    apiConfig?: ApiConfig;
 }
 export interface CheckboxField extends BaseField {
     type: 'checkbox';
@@ -67,13 +97,20 @@ export interface SwitchField extends BaseField {
 }
 export interface AutocompleteField extends BaseField {
     type: 'autocomplete';
-    options: Array<{
+    options?: Array<{
         label: string;
         value: string | number;
     }>;
     multiple?: boolean;
     freeSolo?: boolean;
     filterOptions?: boolean;
+    api_endpoint?: string;
+    api_method?: 'GET' | 'POST' | 'PUT' | 'DELETE';
+    value_field?: string;
+    label_field?: string;
+    depends_on?: string;
+    conditional?: boolean;
+    apiConfig?: ApiConfig;
 }
 export interface DateField extends BaseField {
     type: 'date';
@@ -156,6 +193,8 @@ export interface FinFormProps {
     showSubmitButton?: boolean;
     buttons?: FormButton[];
     buttonGroup?: ButtonGroup;
+    baseUrl?: string;
+    apiHeaders?: Record<string, string>;
     isMultiStep?: boolean;
     currentStep?: number;
     onStepChange?: (currentStep: number, totalSteps: number) => void;
@@ -169,6 +208,9 @@ export interface FieldRendererProps {
     field: FieldConfig;
     control: any;
     errors: any;
+    baseUrl?: string;
+    apiHeaders?: Record<string, string>;
+    formData?: Record<string, any>;
 }
 export interface StepNavigationProps {
     currentStep: number;