import { RegisteredRouter } from "@tanstack/react-router";
import { RoutePaths } from "@tanstack/router-core";
import { CommonProps, Refable, type Styleable } from "@trackunit/react-components";
import { MappedOmit } from "@trackunit/shared-utils";
import { ReactNode } from "react";
import { UseFormReturn } from "react-hook-form";
import { AnyZodObject, SomeZodObject, z } from "zod";
export type StepState = "active" | "done" | "invalid" | "disabled" | "ready";
export type StepDefinitions<TFullSchema extends AnyZodObject> = {
    [KeyFullStep in keyof z.TypeOf<TFullSchema>]: KeyFullStep extends `${infer KeyParentStep}/${infer _KeySubStep}` ? KeyParentStep extends keyof z.TypeOf<TFullSchema> ? DefinedStep<z.TypeOf<TFullSchema>[KeyFullStep], z.TypeOf<TFullSchema>> & {
        shouldRender?: (fullFormState: Partial<z.TypeOf<TFullSchema>>) => boolean;
    } : never : DefinedStep<z.TypeOf<TFullSchema>[KeyFullStep], z.TypeOf<TFullSchema>>;
};
export type StepComponentPropsInner<TStepSchema extends TFullSchemaValue[keyof TFullSchemaValue], TFullSchemaValue extends z.TypeOf<AnyZodObject>> = {
    form: UseFormReturn<TStepSchema>;
    fullForm: UseFormReturn<TFullSchemaValue>;
    setSubmitHandler: ((onFinalSubmit: (fullFormState: TFullSchemaValue) => void) => void) | null;
    beforeStepSubmit?: ((beforeSubmit: (fullFormState: TFullSchemaValue) => void) => void) | null;
    resetFullFormState?: ((reset: () => void) => void) | null;
    /** Lets the step disable the footer's primary action, e.g. after a completed final submit. */
    setPrimaryActionDisabled?: ((disabled: boolean) => void) | null;
};
export interface SimpleStepProps {
    title: string;
    description: string | ReactNode;
    sidebarDescription?: string;
    containerClassName?: string;
}
interface DefinedStep<TStepSchema extends TFullSchemaValue[keyof TFullSchemaValue], TFullSchemaValue extends z.TypeOf<AnyZodObject>> extends SimpleStepProps {
    component: (props: StepComponentPropsInner<TStepSchema, TFullSchemaValue>) => ReactNode;
    onPrimaryAction?: (form: UseFormReturn<TStepSchema>) => Promise<unknown> | void;
    defaultValues?: Partial<TStepSchema>;
}
export type StepComponentProps<TFullSchemaHook extends () => AnyZodObject, TStepKey extends keyof z.TypeOf<ReturnType<TFullSchemaHook>>> = StepComponentPropsInner<z.TypeOf<ReturnType<TFullSchemaHook>>[TStepKey], z.TypeOf<ReturnType<TFullSchemaHook>>>;
export interface FromWizardComponentProps<TFullSchema extends AnyZodObject, TComponentStepDefinitions extends StepDefinitions<TFullSchema>> extends MappedOmit<UseFormWizardProps<TFullSchema, TComponentStepDefinitions>, "steps">, CommonProps, Refable<HTMLDivElement>, Styleable {
    steps: TComponentStepDefinitions;
}
type StepPathString = `${string}/$stepPath`;
export type StringWithStepKey<TPath> = [TPath] extends [never] ? StepPathString : string extends TPath ? StepPathString : TPath extends StepPathString ? TPath : never;
/**
 * The main props interface for the useFormWizard hook.
 * This interface contains the full configuration needed
 * for the Hook to generate the props for the wizard component.
 */
export interface UseFormWizardProps<TFullSchema extends SomeZodObject, TStepDefinitions extends StepDefinitions<TFullSchema>> {
    fullFormSchema: TFullSchema;
    lastStepPrimaryActionLabel: string;
    onCancel?: (stepKey: string) => void;
    basePath: StringWithStepKey<`${RoutePaths<RegisteredRouter["routeTree"]>}`>;
    steps: TStepDefinitions;
    isEdit?: boolean;
}
/**
 * Generates the props for rendering a Form Wizard component.
 * This hook processes the provided step definitions and form schema to prepare the necessary props for the Form Wizard component.
 *
 * @param props Configuration options for the Form Wizard component.
 * @param props.fullFormSchema The Zod schema for the entire form.
 * @param props.lastStepPrimaryActionLabel Label for the primary action button on the last step.
 * @param props.onCancel Callback to execute when canceling the form submission. Defaults to navigating to the parent route.
 * @param props.basePath Base path for routing within the form wizard.
 * @param props.steps Definitions for each step in the form wizard. Keys are used as path and a slash is used to define a substep.
 * @param props.isEdit Indicates whether the form is being edited or created. If the step has a default value, it is considered valid when editing.
 * @example
 * ```
 * typescript
 * import { useFormWizard } from './path/to/useFormWizard';
 * const { steps,...wizardProps } = useFormWizard({
 * fullFormSchema: useYourZodSchema(),
 * lastStepPrimaryActionLabel: 'Finish',
 * basePath: '/your-base-path/$stepPath',
 * steps: {
 *   entry: {
 *     title: "Add your thing",
 *     description: Choose how to add your thing,
 *     sidebarDescription: Choose how to add your thing,
 *     defaultValues: { entryMethod: "upload" },
 *     component: stepProps => <EntryMethodStep {...stepProps} />,
 *   },
 *   "entry/manual": {
 *     shouldRender: fullFormState => fullFormState.entry?.entryMethod === "manual",
 *     title: "Type your thing",
 *     description: "Manually type your thing",
 *     component: stepProps => <ManualStep {...stepProps} />,
 *   },
 *   "entry/upload": {
 *     shouldRender: fullFormState => fullFormState.entry?.entryMethod === "upload",
 *     title: "Upload your thing",
 *     description: "Upload a spreadsheet thing",
 *     component: stepProps => <UploadStep {...stepProps} />,
 *   },
 *   review: {
 *     title: "Review & Save",
 *     description: "Make sure everything looks alright",
 *     sidebarDescription: "Make sure everything looks alright",
 *     component: stepProps => <ReviewSaveStep {...stepProps} />,
 *   },
 * },
 * ```
});
 */
export declare const useFormWizard: <TStepDefinition extends StepDefinitions<TFullSchema>, TFullSchema extends AnyZodObject>(props: UseFormWizardProps<TFullSchema, TStepDefinition>) => FromWizardComponentProps<TFullSchema, StepDefinitions<TFullSchema>>;
export {};