import React from 'react';
import type { StyleProp, View, ViewStyle } from 'react-native';
import type { WithTimingConfig } from 'react-native-reanimated';
import type { ThemeVars } from '@coinbase/cds-common/core/theme';
import type { IconName } from '@coinbase/cds-common/types/IconName';
import type { SpringConfig } from '@react-spring/core';
import type { IconProps } from '../icons/Icon';
import { type BoxBaseProps, type BoxProps } from '../layout/Box';
/** Data that represents a single step within a Stepper.*/
export type StepperValue<Metadata extends Record<string, unknown> = Record<string, unknown>> = {
  /** A unique indetifier of the step. This is used to reference the Stepper's active step. */
  id: string;
  /** The text or ReactNode displayed within the Stepper's Label subcomponent. */
  label?: React.ReactNode;
  accessibilityLabel?: string;
  /** Optional step metadata which is passed to the the Stepper subcomponents. */
  metadata?: Metadata;
  subSteps?: StepperValue<Metadata>[];
  Component?: StepperStepComponent<Metadata> | null;
  StepperSubstepContainerComponent?: StepperSubstepContainerComponent<Metadata> | null;
  StepperIconComponent?: StepperIconComponent<Metadata> | null;
  StepperLabelComponent?: StepperLabelComponent<Metadata> | null;
  StepperProgressComponent?: StepperProgressComponent<Metadata> | null;
  StepperHeaderComponent?: StepperHeaderComponent<Metadata> | null;
};
/** Props shared by most of Stepper's subcomponents. */
type StepperSubcomponentProps<Metadata extends Record<string, unknown> = Record<string, unknown>> =
  {
    /** The step object being rendered. */
    step: StepperValue<Metadata>;
    /** The parent step of the step being rendered */
    parentStep: StepperValue<Metadata> | null;
    /** The id of the current active step. Can be null if no active step. */
    activeStepId: string | null;
    /** The depth/nesting level of this step (0 = root, 1 = first level sub-step, etc.) */
    depth: number;
    /** Whether the step is the current, active step */
    active: boolean;
    /** Whether the step has been visited */
    visited: boolean;
    /** An array of all step ids in the stepper */
    flatStepIds: string[];
    /** Whether the entire stepper is complete */
    complete?: boolean;
    /** Whether the active step is a descendent of this step */
    isDescendentActive: boolean;
    /** Inline styles for the subcomponent element */
    style?: StyleProp<ViewStyle>;
  };
export type StepperStepProps<Metadata extends Record<string, unknown> = Record<string, unknown>> =
  StepperSubcomponentProps<Metadata> &
    BoxProps & {
      /**
       * A value between 0 and 1 representing the step's progress.
       * Progress bar subcomponents animate to this value internally.
       */
      progress: number;
      activeStepLabelElement: View | null;
      setActiveStepLabelElement: (element: View) => void;
      progressTimingConfig?: WithTimingConfig;
      animate?: boolean;
      disableAnimateOnMount?: boolean;
      completedStepAccessibilityLabel?: string;
      StepperStepComponent?: StepperStepComponent<Metadata>;
      StepperSubstepContainerComponent?: StepperSubstepContainerComponent<Metadata> | null;
      StepperLabelComponent?: StepperLabelComponent<Metadata> | null;
      StepperProgressComponent?: StepperProgressComponent<Metadata> | null;
      StepperIconComponent?: StepperIconComponent<Metadata> | null;
      styles?: {
        step?: StyleProp<ViewStyle>;
        label?: StyleProp<ViewStyle>;
        progress?: StyleProp<ViewStyle>;
        icon?: StyleProp<ViewStyle>;
        header?: StyleProp<ViewStyle>;
        substepContainer?: StyleProp<ViewStyle>;
      };
    };
export type StepperSubstepContainerProps<
  Metadata extends Record<string, unknown> = Record<string, unknown>,
> = StepperSubcomponentProps<Metadata> &
  BoxProps & {
    children: React.ReactNode;
  };
export type StepperHeaderProps<Metadata extends Record<string, unknown> = Record<string, unknown>> =
  BoxProps & {
    activeStep: StepperValue<Metadata> | null;
    flatStepIds: string[];
    complete?: boolean;
    disableAnimateOnMount?: boolean;
    style?: StyleProp<ViewStyle>;
  };
export type StepperLabelProps<Metadata extends Record<string, unknown> = Record<string, unknown>> =
  StepperSubcomponentProps<Metadata> &
    BoxProps & {
      setActiveStepLabelElement: (element: View) => void;
      defaultColor?: ThemeVars.Color;
      activeColor?: ThemeVars.Color;
      descendentActiveColor?: ThemeVars.Color;
      visitedColor?: ThemeVars.Color;
      completeColor?: ThemeVars.Color;
      completedStepAccessibilityLabel?: string;
    };
export type StepperProgressProps<
  Metadata extends Record<string, unknown> = Record<string, unknown>,
> = StepperSubcomponentProps<Metadata> &
  BoxProps & {
    progress: number;
    activeStepLabelElement: View | null;
    progressTimingConfig?: WithTimingConfig;
    animate?: boolean;
    disableAnimateOnMount?: boolean;
    defaultFill?: ThemeVars.Color;
    activeFill?: ThemeVars.Color;
    descendentActiveFill?: ThemeVars.Color;
    visitedFill?: ThemeVars.Color;
    completeFill?: ThemeVars.Color;
  };
export type StepperIconProps<Metadata extends Record<string, unknown> = Record<string, unknown>> =
  StepperSubcomponentProps<Metadata> &
    Omit<IconProps, 'name'> & {
      name?: IconName;
      defaultName?: IconName;
      activeName?: IconName;
      descendentActiveName?: IconName;
      visitedName?: IconName;
      completeName?: IconName;
      defaultColor?: ThemeVars.Color;
      activeColor?: ThemeVars.Color;
      descendentActiveColor?: ThemeVars.Color;
      visitedColor?: ThemeVars.Color;
      completeColor?: ThemeVars.Color;
    };
export type StepperStepComponent<
  Metadata extends Record<string, unknown> = Record<string, unknown>,
> = React.FC<StepperStepProps<Metadata>>;
export type StepperSubstepContainerComponent<
  Metadata extends Record<string, unknown> = Record<string, unknown>,
> = React.FC<StepperSubstepContainerProps<Metadata>>;
export type StepperLabelComponent<
  Metadata extends Record<string, unknown> = Record<string, unknown>,
> = React.FC<StepperLabelProps<Metadata>>;
export type StepperProgressComponent<
  Metadata extends Record<string, unknown> = Record<string, unknown>,
> = React.FC<StepperProgressProps<Metadata>>;
export type StepperIconComponent<
  Metadata extends Record<string, unknown> = Record<string, unknown>,
> = React.FC<StepperIconProps<Metadata>>;
export type StepperHeaderComponent<
  Metadata extends Record<string, unknown> = Record<string, unknown>,
> = React.FC<StepperHeaderProps<Metadata>>;
export type StepperBaseProps<Metadata extends Record<string, unknown> = Record<string, unknown>> =
  BoxBaseProps & {
    /** An optional accessibility label used to announce a step as complete/visited. Useful for providing an internationalized label for this state.
     * @default "Complete"
     */
    completedStepAccessibilityLabel?: string;
    /** The orientation of the stepper. */
    direction: 'vertical' | 'horizontal';
    /**
     * An array of steps to render.
     * @see StepperValue
     */
    steps: StepperValue<Metadata>[];
    /**
     * The id of the current/active step.
     * Set this to null to visualize a completely unfilled/incomplete Stepper.
     */
    activeStepId: string | null;
    /** Set this to true to visualize a completely filled/complete Stepper */
    complete?: boolean;
    /** An optional component to render in place of the default Step subcomponent. */
    StepperStepComponent?: StepperStepComponent<Metadata>;
    /** An optional component to render in place of the default SubstepContainer subcomponent. */
    StepperSubstepContainerComponent?: StepperSubstepContainerComponent<Metadata> | null;
    /** An optional component to render in place of the default Label subcomponent. Set to null to render nothing in this slot. */
    StepperLabelComponent?: StepperLabelComponent<Metadata> | null;
    /** An optional component to render in place of the default Progress subcomponent. Set to null to render nothing in this slot. */
    StepperProgressComponent?: StepperProgressComponent<Metadata> | null;
    /** An optional component to render in place of the default Icon subcomponent. Set to null to render nothing in this slot. */
    StepperIconComponent?: StepperIconComponent<Metadata> | null;
    /** An optional component to render in place of the default Header subcomponent. Set to null to render nothing in this slot. */
    StepperHeaderComponent?: StepperHeaderComponent<Metadata> | null;
    /** The timing config to use for the progress animation. */
    progressTimingConfig?: WithTimingConfig;
    /**
     * @deprecated Stepper no longer uses react-spring for progress; this value is ignored but retained for migration only. Use {@link progressTimingConfig} instead. This will be removed in a future major release.
     * @deprecationExpectedRemoval v10
     */
    progressSpringConfig?: SpringConfig;
    /** Whether to animate the progress bar.
     * @default true
     */
    animate?: boolean;
    /** Whether to disable the animation on mount. */
    disableAnimateOnMount?: boolean;
  };
export type StepperProps<Metadata extends Record<string, unknown> = Record<string, unknown>> =
  BoxProps &
    StepperBaseProps<Metadata> & {
      /** Custom styles for individual elements of the Stepper component */
      styles?: {
        /** Root Stepper container element */
        root?: StyleProp<ViewStyle>;
        /** Step subcomponent element */
        step?: StyleProp<ViewStyle>;
        /** Substep container element */
        substepContainer?: StyleProp<ViewStyle>;
        /** Label subcomponent element */
        label?: StyleProp<ViewStyle>;
        /** Progress subcomponent element */
        progress?: StyleProp<ViewStyle>;
        /** Icon subcomponent element */
        icon?: StyleProp<ViewStyle>;
        /** Header subcomponent element */
        header?: StyleProp<ViewStyle>;
      };
    };
export declare const horizontalStepGap = 0.5;
export declare const defaultProgressTimingConfig: WithTimingConfig;
/**
 * @deprecated Use {@link defaultProgressTimingConfig}. Retained for migration only; Stepper no longer uses react-spring for progress. This will be removed in a future major release.
 * @deprecationExpectedRemoval v10
 */
export declare const defaultProgressSpringConfig: SpringConfig;
type StepperComponent = <Metadata extends Record<string, unknown> = Record<string, unknown>>(
  props: StepperProps<Metadata> & {
    ref?: React.Ref<View>;
  },
) => React.ReactElement;
export declare const Stepper: StepperComponent;
export {};
//# sourceMappingURL=Stepper.d.ts.map