@factorialco/f0-react 1.452.0 → 1.453.0

package/dist/f0.d.ts

@@ -6521,6 +6521,21 @@ declare interface F0FormActionBarSubmitConfig extends F0FormSubmitConfigBase {
     actionBarLabel?: string;
 }
 
+/**
+ * Common props shared across all F0Form variants (formDefinition-based).
+ * Used as the constraint for `F0FormLikeComponent`.
+ */
+declare interface F0FormCommonProps {
+    formDefinition: F0FormDefinitionSingleSchema_2<F0FormSchema> | F0FormDefinitionPerSection_2<F0PerSectionSchema>;
+    className?: string;
+    styling?: F0FormStylingConfig;
+    formRef?: React.MutableRefObject<F0FormRef | null>;
+    initialFiles?: InitialFile[];
+    useUpload?: UseFileUpload;
+    renderCustomField?: RenderCustomFieldFunction;
+    isLoading?: boolean;
+}
+
 /**
  * Submit configuration for default button type
  */
@@ -6748,6 +6763,19 @@ declare interface F0FormFieldNonFileProps extends F0FormFieldCommonProps {
 
 export declare type F0FormFieldProps = F0FormFieldFileProps | F0FormFieldNonFileProps;
 
+/**
+ * Component type for F0Form-like wrappers (e.g. FactorialF0Form).
+ *
+ * Because F0Form uses overloaded/generic signatures, neither F0Form
+ * nor FactorialF0Form can be directly assigned to this type.
+ * Cast the component when passing it:
+ *
+ * ```tsx
+ * <F0Provider formComponent={FactorialF0Form as F0FormLikeComponent} />
+ * ```
+ */
+export declare type F0FormLikeComponent = React.ComponentType<F0FormCommonProps>;
+
 /**
  * Union of all F0Form prop variants.
  * The component detects the mode based on whether `schema` is a single Zod schema
@@ -7314,6 +7342,17 @@ export declare const F0Provider: React.FC<{
     showExperimentalWarnings?: boolean;
     dataCollectionStorageHandler?: DataCollectionStorageHandler;
     renderDataTestIdAttribute?: boolean;
+    /**
+     * Custom form component to use instead of the default F0Form in
+     * AI canvas form panels. Useful for platform-level wrappers that
+     * auto-provide `renderCustomField` or `useUpload`.
+     *
+     * Cast overloaded components when passing:
+     * ```tsx
+     * <F0Provider formComponent={FactorialF0Form as F0FormLikeComponent} />
+     * ```
+     */
+    formComponent?: F0FormLikeComponent;
 }>;
 
 /**
@@ -12456,6 +12495,8 @@ export declare interface UseF0FormReturn {
  */
 export declare type UseFileUpload = () => FileUploadHookReturn;
 
+export declare const useFormComponent: () => F0FormLikeComponent | undefined;
+
 export declare const useGroups: <R extends RecordType>(groups: GroupRecord<R>[], defaultOpenGroups?: boolean | GroupRecord<R>["key"][]) => {
     openGroups: Record<string, boolean>;
     setGroupOpen: (key: string, open: boolean) => void;
@@ -12833,6 +12874,11 @@ declare module "gridstack" {
 }
 
 
+declare namespace Calendar {
+    var displayName: string;
+}
+
+
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
         aiBlock: {
@@ -12880,8 +12926,3 @@ declare module "@tiptap/core" {
         };
     }
 }
-
-
-declare namespace Calendar {
-    var displayName: string;
-}