@factorialco/f0-react 1.381.0 → 1.383.0

package/dist/f0.d.ts

@@ -49,6 +49,8 @@ import { F0AvatarListProps as F0AvatarListProps_2 } from './types';
 import { F0AvatarPersonProps as F0AvatarPersonProps_2 } from './types';
 import { F0AvatarTeamProps as F0AvatarTeamProps_2 } from './F0AvatarTeam';
 import { F0DialogInternalProps } from './internal-types';
+import { F0FormDefinitionPerSection as F0FormDefinitionPerSection_2 } from '../F0WizardForm/types';
+import { F0FormDefinitionSingleSchema as F0FormDefinitionSingleSchema_2 } from '../F0WizardForm/types';
 import { F0GridStackProps as F0GridStackProps_2 } from './F0GridStack';
 import { F0TagBalanceProps } from './types';
 import { F0TagCompanyProps } from './types';
@@ -2584,6 +2586,18 @@ export declare const defaultTranslations: {
                 readonly other: "{{count}} issues";
             };
         };
+        readonly file: {
+            readonly dropzone: "Drag and drop a file, or click to select";
+            readonly dropzoneActive: "Drop the file here";
+            readonly dropzoneMultiple: "Drag and drop files, or click to select";
+            readonly acceptedTypes: "Accepted formats: {{types}}";
+            readonly remove: "Remove";
+            readonly uploading: "Uploading…";
+            readonly processing: "Processing…";
+            readonly uploadFailed: "Upload failed";
+            readonly fileTooLarge: "File exceeds {{maxSize}} MB limit";
+            readonly invalidFileType: "File type not accepted. Accepted formats: {{types}}";
+        };
         readonly validation: {
             readonly required: "This field is required";
             readonly invalidType: "Invalid value";
@@ -2614,6 +2628,12 @@ export declare const defaultTranslations: {
             };
         };
     };
+    readonly wizard: {
+        readonly previous: "Previous";
+        readonly next: "Continue";
+        readonly submit: "Submit";
+        readonly stepOf: "Step {{current}} of {{total}}";
+    };
 };
 
 export declare type DialogPosition = (typeof dialogPositions)[number];
@@ -2881,11 +2901,26 @@ export declare interface F0AlertProps {
 }
 
 /**
- * Config for array fields (multi-select)
+ * Config for array fields (multi-select or multi-file)
  * @typeParam T - The value type (string or number)
  * @typeParam R - Record type for data source (when using source instead of options)
  */
-export declare type F0ArrayConfig<T extends string | number = string, R extends Record<string, unknown> = Record<string, unknown>> = F0BaseConfig & F0SelectConfig<T, R> & {
+export declare type F0ArrayConfig<T extends string | number = string, R extends Record<string, unknown> = Record<string, unknown>> = F0ArraySelectConfig<T, R> | F0ArrayFileConfig;
+
+/**
+ * Config for file fields (multiple file upload, form value is string[])
+ */
+declare type F0ArrayFileConfig = F0BaseConfig & F0FileConfig & {
+    fieldType: "file";
+    multiple: true;
+};
+
+/**
+ * Config for array fields with select (multi-select)
+ * @typeParam T - The value type (string or number)
+ * @typeParam R - Record type for data source (when using source instead of options)
+ */
+declare type F0ArraySelectConfig<T extends string | number = string, R extends Record<string, unknown> = Record<string, unknown>> = F0BaseConfig & F0SelectConfig<T, R> & {
     fieldType?: "select";
 };
 
@@ -3741,19 +3776,66 @@ export declare function F0EventCatcherProvider({ children, onEvent, enabled, cat
 /**
  * Union of all F0 field types used for rendering
  */
-export declare type F0Field = F0TextField | F0NumberField | F0TextareaField | F0SelectField | F0CheckboxField | F0SwitchField | F0DateField | F0TimeField | F0DateTimeField | F0DateRangeField | F0RichTextField | F0CustomField;
+export declare type F0Field = F0TextField | F0NumberField | F0TextareaField | F0SelectField | F0CheckboxField | F0SwitchField | F0DateField | F0TimeField | F0DateTimeField | F0DateRangeField | F0RichTextField | F0FileField | F0CustomField;
 
 /**
  * Complete F0 field configuration (union of all possible configs)
  * @typeParam T - The value type for select fields (string or number)
  * @typeParam R - Record type for data source (when using source instead of options)
  */
-export declare type F0FieldConfig<T extends string | number = string | number, R extends Record<string, unknown> = Record<string, unknown>> = F0StringConfig<string, undefined, R> | F0NumberFieldConfig<R> | F0BooleanConfig | F0DateFieldConfig | F0TimeFieldConfig | F0DateTimeFieldConfig | F0ArrayConfig<T, R> | F0ObjectConfig;
+export declare type F0FieldConfig<T extends string | number = string | number, R extends Record<string, unknown> = Record<string, unknown>> = F0StringConfig<string, undefined, R> | F0NumberFieldConfig<R> | F0BooleanConfig | F0DateFieldConfig | F0TimeFieldConfig | F0DateTimeFieldConfig | F0ArrayConfig<T, R> | F0FileFieldConfig | F0ObjectConfig;
 
 /**
  * Field types for rendering
  */
-export declare type F0FieldType = "text" | "number" | "textarea" | "select" | "checkbox" | "switch" | "date" | "time" | "datetime" | "daterange" | "richtext" | "custom";
+export declare type F0FieldType = "text" | "number" | "textarea" | "select" | "checkbox" | "switch" | "date" | "time" | "datetime" | "daterange" | "richtext" | "file" | "custom";
+
+/**
+ * F0 config options specific to file fields
+ */
+export declare interface F0FileConfig {
+    /**
+     * Accepted MIME types.
+     *
+     * @example
+     * accept: ["image"]                       // all image types
+     * accept: ["image/png", "image/jpeg"]     // specific types
+     * accept: ["image", "application/pdf"]    // mix of category and specific
+     */
+    accept?: MimeType_2[];
+    /** Maximum file size in megabytes (per file) */
+    maxSizeMB?: number;
+    /** Allow multiple file uploads (form value becomes `string[]`) */
+    multiple?: boolean;
+    /** Helper text shown in the dropzone area */
+    description?: string;
+    /** Consumer-provided hook that returns upload capabilities */
+    useUpload: UseFileUpload;
+}
+
+/**
+ * File field with all properties for rendering (runtime type)
+ */
+export declare type F0FileField = F0BaseField & {
+    type: "file";
+    /** Accepted MIME types */
+    accept?: MimeType_2[];
+    /** Maximum file size in megabytes */
+    maxSizeMB?: number;
+    /** Allow multiple files */
+    multiple?: boolean;
+    /** Dropzone description text */
+    description?: string;
+    /** Consumer-provided upload hook */
+    useUpload: UseFileUpload;
+    /** Conditional rendering */
+    renderIf?: FileFieldRenderIf;
+};
+
+/**
+ * Union of all file field configs
+ */
+export declare type F0FileFieldConfig = F0StringFileConfig | F0ArrayFileConfig;
 
 export declare const F0FilterPickerContent: F0FilterPickerContentGeneric;
 
@@ -3789,6 +3871,8 @@ export declare type F0FilterPickerContentPublicProps<Filters extends FiltersDefi
 export declare const F0Form: {
     <TSchema extends F0FormSchema>(props: F0FormPropsWithSingleSchema<TSchema>): React.ReactElement;
     <T extends F0PerSectionSchema>(props: F0FormPropsWithPerSectionSchema<T>): React.ReactElement;
+    <TSchema extends F0FormSchema>(props: F0FormPropsWithSingleSchemaDefinition<TSchema>): React.ReactElement;
+    <T extends F0PerSectionSchema>(props: F0FormPropsWithPerSectionDefinition<T>): React.ReactElement;
 };
 
 /**
@@ -3829,6 +3913,38 @@ declare interface F0FormDefaultSubmitConfig extends F0FormSubmitConfigBase {
      * @default false
      */
     hideSubmitButton?: boolean;
+    /**
+     * When true, hides the internal action bar (loading/success feedback).
+     * Useful when the parent component provides its own action bar.
+     * @default false
+     */
+    hideActionBar?: boolean;
+}
+
+export declare type F0FormDefinition<T extends F0FormSchema_2 | F0PerSectionSchema_2 = F0FormSchema_2 | F0PerSectionSchema_2> = T extends F0FormSchema_2 ? F0FormDefinitionSingleSchema<T> : T extends F0PerSectionSchema_2 ? F0FormDefinitionPerSection<T> : never;
+
+export declare interface F0FormDefinitionPerSection<T extends F0PerSectionSchema_2> {
+    /* Excluded from this release type: _brand */
+    name: string;
+    schema: T;
+    sections?: Record<string, F0PerSectionSectionConfig>;
+    defaultValues?: {
+        [K in keyof T]?: Partial<z.infer<T[K]>>;
+    };
+    onSubmit: (arg: F0WizardFormPerSectionSubmitArg<T>) => Promise<F0FormSubmitResult> | F0FormSubmitResult;
+    submitConfig?: F0PerSectionSubmitConfig;
+    errorTriggerMode?: F0FormErrorTriggerMode;
+}
+
+export declare interface F0FormDefinitionSingleSchema<TSchema extends F0FormSchema_2> {
+    /* Excluded from this release type: _brand */
+    name: string;
+    schema: TSchema;
+    sections?: Record<string, F0SectionConfig>;
+    defaultValues?: Partial<z.infer<TSchema>>;
+    onSubmit: (arg: F0WizardFormSingleSubmitArg<TSchema>) => Promise<F0FormSubmitResult> | F0FormSubmitResult;
+    submitConfig?: F0FormSubmitConfig;
+    errorTriggerMode?: F0FormErrorTriggerMode;
 }
 
 /**
@@ -3930,11 +4046,24 @@ export declare function f0FormField<T extends ZodTypeAny, TConfig = undefined>(s
 export declare function f0FormField<T extends ZodTypeAny, V extends string | number = string | number, R extends Record<string, unknown> = Record<string, unknown>>(schema: T, config: F0FieldConfig<V, R>): T & F0ZodType<T>;
 
 /**
- * Union of both F0Form prop variants.
+ * Union of all F0Form prop variants.
  * The component detects the mode based on whether `schema` is a single Zod schema
- * or a record of schemas keyed by section ID.
+ * or a record of schemas keyed by section ID, or whether a `formDefinition` is provided.
  */
-export declare type F0FormProps<TSchema extends F0FormSchema | F0PerSectionSchema = F0FormSchema | F0PerSectionSchema> = TSchema extends F0FormSchema ? F0FormPropsWithSingleSchema<TSchema> : TSchema extends F0PerSectionSchema ? F0FormPropsWithPerSectionSchema<TSchema> : never;
+export declare type F0FormProps<TSchema extends F0FormSchema | F0PerSectionSchema = F0FormSchema | F0PerSectionSchema> = TSchema extends F0FormSchema ? F0FormPropsWithSingleSchema<TSchema> | F0FormPropsWithSingleSchemaDefinition<TSchema> : TSchema extends F0PerSectionSchema ? F0FormPropsWithPerSectionSchema<TSchema> | F0FormPropsWithPerSectionDefinition<TSchema> : never;
+
+/**
+ * Props for F0Form using a formDefinition (per-section schema mode).
+ * Form-related props are extracted from the definition; only rendering/integration
+ * props are passed directly.
+ */
+export declare interface F0FormPropsWithPerSectionDefinition<T extends F0PerSectionSchema> {
+    formDefinition: F0FormDefinitionPerSection_2<T>;
+    className?: string;
+    styling?: F0FormStylingConfig;
+    formRef?: React.MutableRefObject<F0FormRef | null>;
+    initialFiles?: InitialFile[];
+}
 
 /**
  * Props for the F0Form component (per-section schema mode).
@@ -3971,6 +4100,12 @@ export declare interface F0FormPropsWithPerSectionSchema<T extends F0PerSectionS
      * Ref to control the form programmatically from outside.
      */
     formRef?: React.MutableRefObject<F0FormRef | null>;
+    /**
+     * Pre-existing file metadata shared across all file fields.
+     * Each file field automatically resolves its entries by matching
+     * `defaultValues` against `InitialFile.value`.
+     */
+    initialFiles?: InitialFile[];
 }
 
 /**
@@ -4009,6 +4144,25 @@ export declare interface F0FormPropsWithSingleSchema<TSchema extends F0FormSchem
      * Use with the `useF0Form` hook to get a ref and submit/reset functions.
      */
     formRef?: React.MutableRefObject<F0FormRef | null>;
+    /**
+     * Pre-existing file metadata shared across all file fields.
+     * Each file field automatically resolves its entries by matching
+     * `defaultValues` against `InitialFile.value`.
+     */
+    initialFiles?: InitialFile[];
+}
+
+/**
+ * Props for F0Form using a formDefinition (single schema mode).
+ * Form-related props are extracted from the definition; only rendering/integration
+ * props are passed directly.
+ */
+export declare interface F0FormPropsWithSingleSchemaDefinition<TSchema extends F0FormSchema> {
+    formDefinition: F0FormDefinitionSingleSchema_2<TSchema>;
+    className?: string;
+    styling?: F0FormStylingConfig;
+    formRef?: React.MutableRefObject<F0FormRef | null>;
+    initialFiles?: InitialFile[];
 }
 
 /**
@@ -4029,6 +4183,10 @@ export declare interface F0FormRef {
      * Check if the form has unsaved changes
      */
     isDirty: () => boolean;
+    /**
+     * Get the current form values (including unsaved changes)
+     */
+    getValues: () => Record<string, unknown>;
     /* Excluded from this release type: _setStateCallback */
 }
 
@@ -4037,6 +4195,8 @@ export declare interface F0FormRef {
  */
 export declare type F0FormSchema<T extends ZodRawShape = ZodRawShape> = z.ZodObject<T> | ZodEffects<z.ZodObject<T>>;
 
+declare type F0FormSchema_2<T extends ZodRawShape = ZodRawShape> = z.ZodObject<T> | ZodEffects<z.ZodObject<T>>;
+
 /**
  * Callback to update form state in the hook
  */
@@ -4279,6 +4439,8 @@ export declare type F0OneSwitchProps = React.ComponentPropsWithoutRef<typeof Swi
  */
 export declare type F0PerSectionSchema = Record<string, F0FormSchema>;
 
+declare type F0PerSectionSchema_2 = Record<string, F0FormSchema_2>;
+
 /**
  * Section configuration for per-section schema mode.
  * Extends F0SectionConfig with per-section submit and default values.
@@ -4307,6 +4469,12 @@ export declare interface F0PerSectionSubmitConfig {
      * @default false
      */
     showSubmitWhenDirty?: boolean;
+    /**
+     * When true, hides the submit button.
+     * Useful when submission is controlled externally (e.g. inside F0WizardForm).
+     * @default false
+     */
+    hideSubmitButton?: boolean;
 }
 
 export declare const F0Provider: React.FC<{
@@ -4595,7 +4763,15 @@ export declare type F0Source = {
  * @typeParam TConfig - Type of the fieldConfig object (for custom fields)
  * @typeParam R - Record type for data source (when using source instead of options)
  */
-export declare type F0StringConfig<TValue = string, TConfig = undefined, R extends Record<string, unknown> = Record<string, unknown>> = F0StringTextConfig | F0StringTextareaConfig | F0StringSelectConfig<R> | F0CustomFieldConfig<TValue, TConfig>;
+export declare type F0StringConfig<TValue = string, TConfig = undefined, R extends Record<string, unknown> = Record<string, unknown>> = F0StringTextConfig | F0StringTextareaConfig | F0StringSelectConfig<R> | F0StringFileConfig | F0CustomFieldConfig<TValue, TConfig>;
+
+/**
+ * Config for file fields (single file upload, form value is a string identifier)
+ */
+declare type F0StringFileConfig = F0BaseConfig & F0FileConfig & {
+    fieldType: "file";
+    multiple?: false;
+};
 
 /**
  * Config for string fields with select options
@@ -4810,6 +4986,104 @@ declare type F0TimeFieldConfig = F0BaseConfig & F0TimeConfig & {
     fieldType: "time";
 };
 
+export declare const F0WizardForm: {
+    <TSchema extends F0FormSchema_2>(props: F0WizardFormSingleSchemaProps<TSchema>): default_2.ReactElement;
+    <T extends F0PerSectionSchema_2>(props: F0WizardFormPerSectionProps<T>): default_2.ReactElement;
+};
+
+declare interface F0WizardFormBaseProps {
+    isOpen: boolean;
+    onClose?: () => void;
+    title?: string;
+    width?: DialogWidth;
+    defaultStepIndex?: number;
+    nextLabel?: string;
+    previousLabel?: string;
+    onStepChanged?: (stepIndex: number) => void;
+    steps?: F0WizardFormStep[];
+    /**
+     * When true, users can click on any step that is not explicitly marked
+     * as incomplete (i.e. its `isCompleted` callback does not return `false`)
+     * to jump to it.
+     * When false (default), users must navigate sequentially using Next/Previous.
+     * @default false
+     */
+    allowStepSkipping?: boolean;
+    /**
+     * When true, the wizard automatically closes after the last step's
+     * onSubmit returns `{ success: true }`.
+     * Also implied when `linkAfterLastStepSubmit` is provided.
+     * @default false
+     */
+    autoCloseOnLastStepSubmit?: boolean;
+    /**
+     * When true, the wizard automatically skips to the first non-completed step
+     * on open. A step is completed when all required fields have values, or when
+     * the step's custom `isCompleted` function returns true.
+     * Only applies on initial render; users can still navigate back freely.
+     * @default false
+     */
+    autoSkipCompletedSteps?: boolean;
+}
+
+export declare interface F0WizardFormPerSectionProps<T extends F0PerSectionSchema_2> extends F0WizardFormBaseProps {
+    formDefinition: F0FormDefinitionPerSection<T>;
+    /**
+     * Function that receives the submitted data and returns a URL to navigate to
+     * after the last step's onSubmit returns `{ success: true }`.
+     * When provided, the wizard auto-closes and navigates to the returned URL.
+     */
+    linkAfterLastStepSubmit?: (arg: {
+        fullData: InferPerSectionValues_2<T>;
+    }) => string;
+}
+
+/**
+ * Per-section submit argument: discriminated union where sectionId narrows data.
+ * fullData always contains all sections' latest values.
+ */
+export declare type F0WizardFormPerSectionSubmitArg<T extends F0PerSectionSchema_2> = {
+    [K in keyof T & string]: {
+        sectionId: K;
+        data: z.infer<T[K]>;
+        fullData: InferPerSectionValues_2<T>;
+    };
+}[keyof T & string];
+
+export declare interface F0WizardFormSingleSchemaProps<TSchema extends F0FormSchema_2> extends F0WizardFormBaseProps {
+    formDefinition: F0FormDefinitionSingleSchema<TSchema>;
+    /**
+     * Function that receives the submitted data and returns a URL to navigate to
+     * after the last step's onSubmit returns `{ success: true }`.
+     * When provided, the wizard auto-closes and navigates to the returned URL.
+     */
+    linkAfterLastStepSubmit?: (arg: {
+        fullData: z.infer<TSchema>;
+    }) => string;
+}
+
+/**
+ * Single-schema submit argument: data is the full form.
+ */
+export declare interface F0WizardFormSingleSubmitArg<TSchema extends F0FormSchema_2> {
+    data: z.infer<TSchema>;
+}
+
+export declare interface F0WizardFormStep {
+    title: string;
+    sectionIds: string[];
+    nextLabel?: string;
+    previousLabel?: string;
+    /**
+     * Custom function to determine if this step is considered completed.
+     * Receives the step's current data. When provided, takes precedence
+     * over the default "all required fields filled" check.
+     */
+    isCompleted?: (arg: {
+        data: Record<string, unknown>;
+    }) => boolean;
+}
+
 /**
  * Extended Zod type with F0 metadata
  */
@@ -4823,7 +5097,7 @@ export declare interface F0ZodType<T extends ZodTypeAny = ZodTypeAny> {
 /**
  * Field types for rendering
  */
-export declare type FieldType = "text" | "number" | "textarea" | "select" | "checkbox" | "switch" | "date" | "time" | "datetime" | "daterange" | "richtext" | "custom";
+export declare type FieldType = "text" | "number" | "textarea" | "select" | "checkbox" | "switch" | "date" | "time" | "datetime" | "daterange" | "richtext" | "file" | "custom";
 
 export declare type FileAvatarVariant = Extract<AvatarVariant, {
     type: "file";
@@ -4834,6 +5108,41 @@ declare type FileDef = {
     type: string;
 };
 
+/**
+ * All valid renderIf conditions for file fields
+ */
+declare type FileFieldRenderIf = CommonRenderIfCondition | F0BaseFieldRenderIfFunction;
+
+/**
+ * Return type of the consumer-provided upload hook
+ */
+export declare interface FileUploadHookReturn {
+    /** Uploads a file and returns the result */
+    upload: (file: File) => Promise<FileUploadResult>;
+    /** Cancels the in-flight upload */
+    cancelUpload?: () => void;
+    /** Upload progress from 0 to 1 */
+    progress: number;
+    /** Current upload status */
+    status: FileUploadStatus;
+}
+
+/**
+ * Result of a file upload operation.
+ * `value` is the identifier stored as the form value (e.g. a signedId, URL, or any string).
+ */
+export declare type FileUploadResult = {
+    type: "success";
+    value: string;
+} | {
+    type: "aborted";
+};
+
+/**
+ * Upload status states
+ */
+export declare type FileUploadStatus = "idle" | "processing" | "uploading" | "success";
+
 /**
  * Union of all available filter types.
  * Used to define possible filter configurations in a collection.
@@ -5317,6 +5626,10 @@ export declare type InferPerSectionValues<T extends F0PerSectionSchema> = {
     [K in keyof T]: z.infer<T[K]>;
 };
 
+declare type InferPerSectionValues_2<T extends F0PerSectionSchema_2> = {
+    [K in keyof T]: z.infer<T[K]>;
+};
+
 export declare type InFilterDefinition<T = string | number, R extends RecordType = RecordType> = BaseFilterDefinition<"in"> & {
     options: InFilterOptions_2<T, R>;
 };
@@ -5392,6 +5705,21 @@ export declare type InfiniteScrollPaginatedResponse<TRecord> = BasePaginatedResp
     hasMore: boolean;
 };
 
+/**
+ * Metadata for a file that already exists (e.g. from a previous upload).
+ * Passed via `initialFiles` so the field can display it without re-uploading.
+ */
+export declare interface InitialFile {
+    /** The identifier that matches the form's default value (signedId, URL, etc.) */
+    value: string;
+    /** Display name (e.g. "report.pdf") */
+    name: string;
+    /** MIME type for icon display (e.g. "application/pdf") */
+    type?: string;
+    /** File size in bytes */
+    size?: number;
+}
+
 declare const INPUTFIELD_SIZES: readonly ["sm", "md"];
 
 declare type InputFieldInheritedProps = (typeof inputFieldInheritedProps)[number];
@@ -5656,6 +5984,20 @@ declare type MentionsConfig = {
     users: MentionedUser[];
 };
 
+/**
+ * Known MIME types for the file field `accept` prop.
+ *
+ * Supports three formats:
+ * - Specific types: `"image/png"`, `"application/pdf"`
+ * - Wildcard categories: `"image/*"`, `"video/*"`
+ * - Bare categories (shorthand for wildcard): `"image"`, `"video"`
+ *
+ * The `string & {}` escape hatch allows unlisted MIME types while
+ * still providing autocomplete for known ones.
+ */
+declare type MimeType_2 = "image" | "video" | "audio" | "text" | "application" | "image/*" | "video/*" | "audio/*" | "text/*" | "application/*" | "image/jpeg" | "image/png" | "image/gif" | "image/webp" | "image/svg+xml" | "image/heic" | "image/bmp" | "image/tiff" | "image/avif" | "video/mp4" | "video/webm" | "video/quicktime" | "audio/mpeg" | "audio/ogg" | "audio/wav" | "application/pdf" | "application/msword" | "application/vnd.openxmlformats-officedocument.wordprocessingml.document" | "application/vnd.ms-excel" | "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" | "application/vnd.ms-powerpoint" | "application/vnd.openxmlformats-officedocument.presentationml.presentation" | "application/zip" | "application/json" | "text/plain" | "text/csv" | "text/html" | "text/markdown";
+export { MimeType_2 as MimeType }
+
 declare const moduleAvatarVariants: (props?: ({
     size?: "lg" | "md" | "sm" | "xs" | "xxs" | undefined;
 } & ({
@@ -7566,6 +7908,32 @@ export declare const useF0Dialog: () => F0DialogContextType;
  */
 export declare function useF0Form(): UseF0FormReturn;
 
+export declare function useF0FormDefinition<TSchema extends F0FormSchema_2>(input: UseF0FormDefinitionSingleSchemaInput<TSchema>): F0FormDefinitionSingleSchema<TSchema>;
+
+export declare function useF0FormDefinition<T extends F0PerSectionSchema_2>(input: UseF0FormDefinitionPerSectionInput<T>): F0FormDefinitionPerSection<T>;
+
+declare interface UseF0FormDefinitionPerSectionInput<T extends F0PerSectionSchema_2> {
+    name: string;
+    schema: T;
+    sections?: Record<string, F0PerSectionSectionConfig>;
+    defaultValues?: {
+        [K in keyof T]?: Partial<z.infer<T[K]>>;
+    };
+    onSubmit: (arg: F0WizardFormPerSectionSubmitArg<T>) => Promise<F0FormSubmitResult> | F0FormSubmitResult;
+    submitConfig?: F0PerSectionSubmitConfig;
+    errorTriggerMode?: F0FormErrorTriggerMode;
+}
+
+declare interface UseF0FormDefinitionSingleSchemaInput<TSchema extends F0FormSchema_2> {
+    name: string;
+    schema: TSchema;
+    sections?: Record<string, F0SectionConfig>;
+    defaultValues?: Partial<z.infer<TSchema>>;
+    onSubmit: (arg: F0WizardFormSingleSubmitArg<TSchema>) => Promise<F0FormSubmitResult> | F0FormSubmitResult;
+    submitConfig?: F0FormSubmitConfig;
+    errorTriggerMode?: F0FormErrorTriggerMode;
+}
+
 /**
  * Return type for the useF0Form hook
  */
@@ -7588,6 +7956,10 @@ export declare interface UseF0FormReturn {
      * Check if the form has unsaved changes
      */
     isDirty: () => boolean;
+    /**
+     * Get the current form values (including unsaved changes)
+     */
+    getValues: () => Record<string, unknown>;
     /**
      * Whether the form is currently submitting
      */
@@ -7598,6 +7970,22 @@ export declare interface UseF0FormReturn {
     hasErrors: boolean;
 }
 
+/**
+ * A hook that returns upload capabilities for a single file.
+ * Each call creates an independent upload instance with its own state.
+ *
+ * @example
+ * ```tsx
+ * const useMyUpload: UseFileUpload = () => {
+ *   const { upload, progress, status, cancelUpload } = useDirectUpload({
+ *     resourceType: "MyModule::Document",
+ *   })
+ *   return { upload, progress, status, cancelUpload }
+ * }
+ * ```
+ */
+export declare type UseFileUpload = () => FileUploadHookReturn;
+
 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;