import { type ComponentPropsWithoutRef } from 'react';
export type SignatureFieldState = 'unsigned' | 'signing' | 'signed';
export interface SignatureFieldProps extends Omit<ComponentPropsWithoutRef<'button'>, 'onClick' | 'children' | 'aria-label' | 'disabled'> {
    /** Lifecycle state. Drives both the visual treatment and the accessible name. */
    state?: SignatureFieldState;
    /**
     * Percent offset of the field's logical start edge within the overlay box.
     * Applied as a runtime-computed `inset-inline-start: {n}%`.
     */
    insetInlineStart?: number;
    /** Percent offset of the field's logical top edge. `inset-block-start: {n}%`. */
    insetBlockStart?: number;
    /** Percent of the overlay's logical inline size — the field width. */
    inlineSize?: number;
    /** Percent of the overlay's logical block size — the field height. */
    blockSize?: number;
    /** Called when an unsigned (or signed) field is activated by click / keyboard. */
    onActivate?: () => void;
    /** Captured signature image (PNG data URL or URL) shown when `state="signed"`. */
    signedImageSrc?: string;
    /**
     * Caption shown in the unsigned prompt and used as the accessible name
     * (e.g. "Sign here", "Date", "Initial here"). Falls back to the
     * translated default prompt.
     */
    label?: string;
    /**
     * Visually hide the caption, leaving only a state glyph (the Signature
     * squiggle unsigned / check signed / spinner signing) — for small or
     * densely placed fields where a long label would overflow the box. The
     * `label` still forms the accessible name.
     */
    hideLabel?: boolean;
    /** Hard-disable the field (non-activatable, dimmed). Distinct from `state="signing"`. */
    disabled?: boolean;
    /**
     * Marks the field as the one currently targeted by field-to-field navigation
     * (Next / Previous signature). Renders a **persistent** selection ring — not
     * the transient `:focus-visible` ring — so the signer can see which field
     * they're on as they step through, even after focus moves or is programmatic.
     */
    active?: boolean;
}
declare const signatureFieldVariants: (props?: ({
    state?: "signed" | "signing" | "unsigned" | null | undefined;
    active?: boolean | null | undefined;
} & import("class-variance-authority/types").ClassProp) | undefined) => string;
export declare const SignatureField: import("react").ForwardRefExoticComponent<SignatureFieldProps & import("react").RefAttributes<HTMLButtonElement>>;
export { signatureFieldVariants };
//# sourceMappingURL=signature-field.d.ts.map