/**
 * Type definitions for the Progress component.
 *
 * @module @mks2508/mks-ui/react/ui/Progress/Progress.types
 */
import type { Progress as ProgressPrimitives } from '@base-ui/react/progress';
import type { IBaseConfig, SlotOverrides } from '../../../core/types';
import type { ICountingNumberProps } from '../../../react-ui/primitives/CountingNumber';
/**
 * Available style slot names for the Progress component.
 * Each slot maps to a visual region that can be customized via the `slots` prop.
 *
 * - `root` - The outer progress container
 * - `track` - The background track bar
 * - `indicator` - The filled indicator bar that animates to the current value
 * - `label` - Optional label text (e.g., "Uploading...")
 * - `value` - Optional animated numeric value display
 *
 * @example
 * ```tsx
 * <Progress
 *   value={75}
 *   slots={{
 *     root: 'w-full',
 *     track: 'h-3 bg-zinc-800 rounded-full',
 *     indicator: 'bg-cyan-500 rounded-full',
 *     label: 'text-sm text-zinc-400',
 *     value: 'text-sm font-mono',
 *   }}
 * />
 * ```
 */
export type ProgressSlot = 'root' | 'track' | 'indicator' | 'label' | 'value';
/**
 * Internal context type for Progress state management.
 * Shared between the Progress root and its child components via React context.
 */
export type ProgressContextType = {
    /** Current progress value (0-100). */
    value: number;
};
/**
 * Configuration options for Progress behavior and animation.
 * Extends the base config with progress-specific settings.
 *
 * @example
 * ```tsx
 * <Progress
 *   value={75}
 *   config={{ animation: { duration: 0.5 }, springStiffness: 120 }}
 * />
 * ```
 */
export interface IProgressConfig extends IBaseConfig {
    /**
     * Spring stiffness for the indicator animation.
     * @defaultValue 100
     */
    springStiffness?: number;
    /**
     * Spring damping for the indicator animation.
     * @defaultValue 30
     */
    springDamping?: number;
}
/**
 * Props for the Progress root component.
 * Wraps Base UI Progress.Root with context provider, slot overrides, and configuration.
 *
 * @example
 * ```tsx
 * <Progress value={75} slots={{ root: 'flex flex-col gap-2' }}>
 *   <ProgressLabel>Uploading...</ProgressLabel>
 *   <ProgressTrack>
 *     <ProgressIndicator />
 *   </ProgressTrack>
 *   <ProgressValue />
 * </Progress>
 * ```
 */
export type IProgressProps = React.ComponentProps<typeof ProgressPrimitives.Root> & {
    /** Partial class overrides for each visual slot. */
    slots?: SlotOverrides<ProgressSlot>;
    /** Behavioral and animation configuration. */
    config?: IProgressConfig;
};
/**
 * Props for the ProgressIndicator sub-component.
 * Uses `motion.create` for spring-animated width transitions.
 *
 * @example
 * ```tsx
 * <ProgressIndicator className="h-full rounded-full" />
 * ```
 */
export type IProgressIndicatorProps = React.ComponentProps<typeof ProgressPrimitives.Indicator> & React.ComponentProps<'div'> & {
    /** Spring transition config for the indicator animation. */
    transition?: {
        type?: 'spring' | 'tween' | 'keyframes' | 'decay' | 'inertia';
        stiffness?: number;
        damping?: number;
        [key: string]: unknown;
    };
    /** Partial class overrides for each visual slot. */
    slots?: SlotOverrides<ProgressSlot>;
};
/**
 * Props for the ProgressTrack sub-component.
 * Wraps Base UI Progress.Track with slot overrides.
 *
 * @example
 * ```tsx
 * <ProgressTrack className="h-2 rounded-full overflow-hidden">
 *   <ProgressIndicator />
 * </ProgressTrack>
 * ```
 */
export type IProgressTrackProps = React.ComponentProps<typeof ProgressPrimitives.Track> & {
    /** Partial class overrides for each visual slot. */
    slots?: SlotOverrides<ProgressSlot>;
};
/**
 * Props for the ProgressLabel sub-component.
 * Wraps Base UI Progress.Label with slot overrides.
 *
 * @example
 * ```tsx
 * <ProgressLabel>Uploading files...</ProgressLabel>
 * ```
 */
export type IProgressLabelProps = React.ComponentProps<typeof ProgressPrimitives.Label> & {
    /** Partial class overrides for each visual slot. */
    slots?: SlotOverrides<ProgressSlot>;
};
/**
 * Props for the ProgressValue sub-component.
 * Combines Base UI Progress.Value with CountingNumber for animated numeric display.
 *
 * @example
 * ```tsx
 * <ProgressValue transition={{ stiffness: 80, damping: 20 }} />
 * ```
 */
export type IProgressValueProps = Omit<React.ComponentProps<typeof ProgressPrimitives.Value>, 'render'> & Omit<ICountingNumberProps, 'number'> & {
    /** Partial class overrides for each visual slot. */
    slots?: SlotOverrides<ProgressSlot>;
};
//# sourceMappingURL=Progress.types.d.ts.map