import * as React from 'react';

type Mask = string | Array<string | RegExp>;
type Transform = "uppercase" | "lowercase" | ((char: string, position: number) => string);
type FormatChars = Record<string, RegExp>;
interface Selection {
    start: number | null;
    end: number | null;
    length?: number;
}
interface InputState {
    value: string;
    selection: Selection;
}
type BeforeMaskedStateChangeFn = (states: {
    previousState?: InputState;
    currentState?: InputState;
    nextState: InputState;
}) => InputState;
/**
 * Legacy (react-input-mask v2) signature for the before-change hook.
 * @deprecated Use BeforeMaskedStateChangeFn with beforeMaskedStateChange.
 */
type BeforeMaskedValueChangeFn = (newState: InputState, oldState: InputState | null, userInput: string | null, maskOptions: V2MaskOptions) => InputState;
/** Mask options shape passed to the legacy beforeMaskedValueChange callback. */
interface V2MaskOptions {
    mask?: Mask;
    maskChar: string | null;
    alwaysShowMask: boolean;
    formatChars: Record<string, RegExp | string>;
    permanents: number[];
}
interface InputMaskProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, "children"> {
    /**
     * Mask format. Either a string (9 = 0-9, a = A-Za-z, * = A-Za-z0-9,
     * backslash escapes) or an array of constant characters and RegExps.
     */
    mask?: Mask;
    /** Character(s) to cover unfilled parts. Default "_", null — empty. */
    maskPlaceholder?: string | null;
    /** Show mask even when input is empty and unfocused. */
    alwaysShowMask?: boolean;
    /** Modify masked value and cursor position before they are applied. */
    beforeMaskedStateChange?: BeforeMaskedStateChangeFn;
    /** Normalize each entered character. "uppercase" | "lowercase" | (char, position) => char. Must be pure. */
    transform?: Transform;
    /** Custom input component. */
    children?: React.ReactElement;
    /** @deprecated Use maskPlaceholder. */
    maskChar?: string | null;
    /**
     * Map of custom mask tokens to character classes. Prefer RegExp values
     * (e.g. `{ "#": /[0-9]/ }`); a ready-made `extendedFormatChars` is exported.
     * String values are a deprecated legacy form and emit a one-time warning.
     */
    formatChars?: Record<string, RegExp | string>;
    /** @deprecated Use beforeMaskedStateChange. */
    beforeMaskedValueChange?: BeforeMaskedValueChangeFn;
}
interface UseMaskOptions {
    /** Mask format — same grammar as InputMask's `mask`. */
    mask?: Mask | null;
    /** Character(s) to cover unfilled parts. Default "_", null — empty. */
    maskPlaceholder?: string | null;
    /** Show mask even when input is empty and unfocused. */
    alwaysShowMask?: boolean;
    /** Map of custom mask tokens to character classes. Prefer RegExp values. */
    formatChars?: Record<string, RegExp | string>;
    /** Normalize each entered character. Must be pure. */
    transform?: Transform;
    /** Modify masked value and cursor position before they are applied. */
    beforeMaskedStateChange?: BeforeMaskedStateChangeFn;
    /** @deprecated Use beforeMaskedStateChange. */
    beforeMaskedValueChange?: BeforeMaskedValueChangeFn;
}

export type { BeforeMaskedStateChangeFn as B, FormatChars as F, InputMaskProps as I, Mask as M, Selection as S, Transform as T, UseMaskOptions as U, BeforeMaskedValueChangeFn as a, InputState as b };