@factorialco/f0-react 1.436.0 → 1.436.1

package/dist/f0.d.ts

@@ -5899,8 +5899,15 @@ export declare interface F0FileConfig {
     multiple?: boolean;
     /** Helper text shown in the dropzone area */
     description?: string;
-    /** Consumer-provided hook that returns upload capabilities */
-    useUpload: UseFileUpload;
+    /**
+     * Consumer-provided upload hook.
+     *
+     * When used inside `<F0Form>`, the form-level `useUpload` is preferred.
+     * This prop is primarily for standalone file fields rendered outside of
+     * `<F0Form>` / `F0FormContext.Provider`, where the upload hook cannot be
+     * supplied via context.
+     */
+    useUpload?: UseFileUpload;
 }
 
 /**
@@ -5916,8 +5923,11 @@ export declare type F0FileField = F0BaseField & {
     multiple?: boolean;
     /** Dropzone description text */
     description?: string;
-    /** Consumer-provided upload hook */
-    useUpload: UseFileUpload;
+    /**
+     * Consumer-provided upload hook for standalone usage.
+     * When inside `<F0Form>`, the form-level `useUpload` takes precedence.
+     */
+    useUpload?: UseFileUpload;
     /** Conditional rendering */
     renderIf?: FileFieldRenderIf;
 };
@@ -6217,6 +6227,8 @@ export declare interface F0FormPropsWithPerSectionDefinition<T extends F0PerSect
     styling?: F0FormStylingConfig;
     formRef?: React.MutableRefObject<F0FormRef | null>;
     initialFiles?: InitialFile[];
+    /** Upload hook shared by all file fields in the form. */
+    useUpload?: UseFileUpload;
     /**
      * Callback that renders custom fields identified by `customFieldName`.
      * When a field has `customFieldName`, this function is called instead of the inline `render`.
@@ -6271,6 +6283,10 @@ export declare interface F0FormPropsWithPerSectionSchema<T extends F0PerSectionS
      * `defaultValues` against `InitialFile.value`.
      */
     initialFiles?: InitialFile[];
+    /**
+     * Upload hook shared by all file fields in the form.
+     */
+    useUpload?: UseFileUpload;
     /**
      * Callback that renders custom fields identified by `customFieldName`.
      * When a field has `customFieldName`, this function is called instead of the inline `render`.
@@ -6326,6 +6342,11 @@ export declare interface F0FormPropsWithSingleSchema<TSchema extends F0FormSchem
      * `defaultValues` against `InitialFile.value`.
      */
     initialFiles?: InitialFile[];
+    /**
+     * Upload hook shared by all file fields in the form.
+     * Called once per file to obtain an independent upload instance.
+     */
+    useUpload?: UseFileUpload;
     /**
      * Callback that renders custom fields identified by `customFieldName`.
      * When a field has `customFieldName`, this function is called instead of the inline `render`.
@@ -6360,6 +6381,8 @@ export declare interface F0FormPropsWithSingleSchemaDefinition<TSchema extends F
     styling?: F0FormStylingConfig;
     formRef?: React.MutableRefObject<F0FormRef | null>;
     initialFiles?: InitialFile[];
+    /** Upload hook shared by all file fields in the form. */
+    useUpload?: UseFileUpload;
     /**
      * Callback that renders custom fields identified by `customFieldName`.
      * When a field has `customFieldName`, this function is called instead of the inline `render`.