import * as react from 'react';
import { CSSProperties } from 'react';

type ErrorCorrectionLevel = 'L' | 'M' | 'Q' | 'H';
interface QRMatrix {
    modules: boolean[][];
    size: number;
}
declare function generateMatrix(value: string, level?: ErrorCorrectionLevel): QRMatrix;

type ModuleShape = 'square' | 'rounded' | 'extra-rounded' | 'circle' | 'dot' | 'diamond' | 'hexagon' | 'star';
type CornerStyle = 'square' | 'rounded' | 'circle' | 'soft-rounded' | 'modern';
type EyeShape = 'square' | 'rounded' | 'circle' | 'diamond' | 'modern';

type QRAnimation = 'pulse' | 'zoom' | 'bounce' | 'rotate' | 'fade' | 'wave' | 'glow' | 'breathing' | 'scan';
/**
 * Returns a `<style>` element body containing the keyframe + class for the
 * given animation. Designed to be embedded inside an `<svg>` so the QR is
 * self-contained (no global stylesheet required).
 *
 * The class to apply is `.qrm-anim`.
 */
declare function getAnimationCSS(animation: QRAnimation): string;

interface QRGradient {
    type: 'linear' | 'radial' | 'conic';
    /** Two or more colour stops, evenly distributed. */
    colors: string[];
    /** Linear/conic rotation in degrees. Ignored for radial. */
    rotation?: number;
}

type QRThemeName = 'light' | 'dark' | 'neon' | 'corporate' | 'glassmorphism' | 'gradient' | 'modern' | 'minimal' | 'cyberpunk' | 'premium';
interface QRTheme {
    fgColor?: string;
    bgColor?: string;
    shape?: ModuleShape;
    cornerStyle?: CornerStyle;
    eyeShape?: EyeShape;
    eyeColor?: string;
    gradient?: QRGradient;
    animation?: QRAnimation;
}
declare const THEMES: Record<QRThemeName, QRTheme>;

type LabelStyle = 'banner' | 'pill' | 'plain';
type LabelPosition = 'top' | 'bottom';

interface QRCodeProps {
    value: string;
    size?: number;
    fgColor?: string;
    bgColor?: string;
    /** Quiet-zone margin in module units. Defaults to 4. */
    margin?: number;
    /**
     * Error-correction level. Defaults to `'M'`, but auto-bumps to `'H'` when a
     * `logo` is provided (so a centred logo doesn't break scanning). Pass an
     * explicit level to opt out of the auto-bump.
     */
    level?: ErrorCorrectionLevel;
    /** URL or data URI of the logo (PNG / SVG / JPG / WEBP). */
    logo?: string;
    /** Fraction of the QR size (0..0.5). Defaults to 0.2. */
    logoSize?: number;
    /** Padding around the logo in module units. Defaults to 1. */
    logoPadding?: number;
    /** Logo cut-out shape. Defaults to 'square'. */
    logoShape?: 'square' | 'rounded' | 'circle';
    /**
     * How the logo sits in the QR:
     *   - 'foreground' (default) — small overlay with bgColor box behind it
     *   - 'embedded' — small overlay with NO box (modules continue through)
     *   - 'background' — image fills the entire QR; modules render on top
     */
    logoMode?: 'foreground' | 'embedded' | 'background';
    /** Logo placement (ignored when logoMode === 'background'). Defaults to 'center'. */
    logoPosition?: 'center' | 'top' | 'bottom' | 'left' | 'right';
    /** Border colour around the logo. Disabled when undefined. */
    logoBorderColor?: string;
    /** Border thickness in module units. Defaults to 0.5 when borderColor is set. */
    logoBorderWidth?: number;
    /** Outer QR frame shape. 'rounded' rounds the bg corners; safe inside the quiet zone. */
    frame?: 'square' | 'rounded';
    /**
     * Short call-to-action text drawn with the QR, e.g. "SCAN ME". The SVG keeps
     * `size` as its width and grows taller to fit the label. Long text shrinks
     * to fit the width.
     */
    label?: string;
    /**
     * How the label is drawn:
     *   - 'banner' (default) — coloured frame around the QR, text in a band
     *   - 'pill' — text in a rounded button next to the QR
     *   - 'plain' — text only
     */
    labelStyle?: LabelStyle;
    /** Side of the QR the label sits on. Defaults to 'bottom'. */
    labelPosition?: LabelPosition;
    /** Text colour. Defaults to bgColor for 'banner' / 'pill', fgColor for 'plain'. */
    labelColor?: string;
    /** Frame / pill colour. Defaults to fgColor (the first colour of a gradient). */
    labelBackground?: string;
    /** CSS font-family of the label. Defaults to a bold system sans-serif. */
    labelFont?: string;
    /** Apply a preset theme. Individual props override theme values. */
    theme?: QRThemeName;
    /** Data-module shape. */
    shape?: ModuleShape;
    /** Outer ring of the 3 finder patterns ("eyes"). */
    cornerStyle?: CornerStyle;
    /** Inner pupil of the 3 finder patterns. */
    eyeShape?: EyeShape;
    /** Override colour of the finder patterns. Defaults to fgColor/gradient. */
    eyeColor?: string;
    /** Linear, radial, or conic gradient. Conic uses CSS via foreignObject. */
    gradient?: QRGradient;
    /** CSS animation applied to the QR. */
    animation?: QRAnimation;
    /** Spacing between modules (0..0.5). 0 = no gap, 0.5 = maximum gap. */
    moduleSpacing?: number;
    className?: string;
    style?: CSSProperties;
    id?: string;
    title?: string;
}
declare const QRCode: react.ForwardRefExoticComponent<QRCodeProps & react.RefAttributes<SVGSVGElement>>;

interface WebsiteQRProps extends Omit<QRCodeProps, 'value'> {
    url: string;
}
declare const WebsiteQR: react.ForwardRefExoticComponent<WebsiteQRProps & react.RefAttributes<SVGSVGElement>>;

interface TextQRProps extends Omit<QRCodeProps, 'value'> {
    text: string;
}
declare const TextQR: react.ForwardRefExoticComponent<TextQRProps & react.RefAttributes<SVGSVGElement>>;

type WiFiEncryption = 'WPA' | 'WPA2' | 'WPA3' | 'WEP' | 'nopass';
interface WiFiPayload {
    ssid: string;
    password?: string;
    /** Defaults to 'WPA'. WPA2/WPA3 are normalised to 'WPA' per the WIFI: URI scheme. */
    encryption?: WiFiEncryption;
    hidden?: boolean;
}
declare function encodeWiFi({ ssid, password, encryption, hidden, }: WiFiPayload): string;
interface EmailPayload {
    to: string;
    subject?: string;
    body?: string;
    cc?: string;
    bcc?: string;
}
declare function encodeEmail({ to, subject, body, cc, bcc }: EmailPayload): string;
interface PhonePayload {
    phoneNumber: string;
}
declare function encodePhone({ phoneNumber }: PhonePayload): string;
interface SMSPayload {
    phoneNumber: string;
    message?: string;
}
declare function encodeSMS({ phoneNumber, message }: SMSPayload): string;
interface WhatsAppPayload {
    /** Digits only. Country code without leading +. E.g. "14155552671". */
    phoneNumber: string;
    message?: string;
}
declare function encodeWhatsApp({ phoneNumber, message }: WhatsAppPayload): string;
interface ContactAddress {
    street?: string;
    city?: string;
    region?: string;
    postalCode?: string;
    country?: string;
}
interface ContactPayload {
    firstName?: string;
    lastName?: string;
    fullName?: string;
    organization?: string;
    title?: string;
    phone?: string;
    mobile?: string;
    workPhone?: string;
    email?: string;
    website?: string;
    address?: ContactAddress;
    note?: string;
}
declare function encodeContact(c: ContactPayload): string;
interface LocationPayload {
    latitude: number;
    longitude: number;
    /** Optional uncertainty in metres. */
    accuracy?: number;
    /** Optional query/label appended as `?q=`. Honoured by many parsers. */
    query?: string;
}
declare function encodeLocation({ latitude, longitude, accuracy, query, }: LocationPayload): string;
interface GoogleMapsPayload {
    /** Either `query` (place name/address) or both `latitude` and `longitude`. */
    query?: string;
    latitude?: number;
    longitude?: number;
}
declare function encodeGoogleMaps({ query, latitude, longitude, }: GoogleMapsPayload): string;
interface EventPayload {
    title: string;
    start: Date | string;
    /** Defaults to start + 1 hour. */
    end?: Date | string;
    allDay?: boolean;
    location?: string;
    description?: string;
    url?: string;
    organizer?: string;
}
declare function encodeEvent(p: EventPayload): string;
interface UPIPayload {
    /** Payee VPA, e.g. "merchant@upi". */
    payeeVPA: string;
    payeeName: string;
    /** Amount in INR. String is preferred to preserve formatting (e.g. "10.00"). */
    amount?: number | string;
    /** Transaction note shown to the user. */
    note?: string;
    /** Merchant transaction reference ID. */
    transactionRef?: string;
    /** Merchant category code. */
    merchantCode?: string;
    /** Currency code. Defaults to "INR" per the UPI spec. */
    currency?: string;
}
declare function encodeUPI({ payeeVPA, payeeName, amount, note, transactionRef, merchantCode, currency, }: UPIPayload): string;
type CryptoCoin = 'bitcoin' | 'ethereum' | 'solana' | 'polygon' | 'usdt';
interface CryptoPayload {
    coin: CryptoCoin;
    address: string;
    /** Amount in the coin's display unit (BTC, ETH, MATIC, SOL, USDT). */
    amount?: number | string;
    label?: string;
    message?: string;
    /** ERC-20 token contract address. Required when `coin: 'usdt'`. */
    tokenAddress?: string;
}
declare function encodeCrypto(p: CryptoPayload): string;
type SocialPlatform = 'facebook' | 'instagram' | 'linkedin' | 'x' | 'twitter' | 'youtube' | 'tiktok' | 'github' | 'discord';
interface SocialPayload {
    platform: SocialPlatform;
    /** Username/handle, or a full URL (in which case it is returned as-is). */
    username: string;
}
declare function encodeSocial({ platform, username }: SocialPayload): string;

interface WiFiQRProps extends Omit<QRCodeProps, 'value'>, WiFiPayload {
}
declare const WiFiQR: react.ForwardRefExoticComponent<WiFiQRProps & react.RefAttributes<SVGSVGElement>>;

interface EmailQRProps extends Omit<QRCodeProps, 'value'>, EmailPayload {
}
declare const EmailQR: react.ForwardRefExoticComponent<EmailQRProps & react.RefAttributes<SVGSVGElement>>;

interface PhoneQRProps extends Omit<QRCodeProps, 'value'>, PhonePayload {
}
declare const PhoneQR: react.ForwardRefExoticComponent<PhoneQRProps & react.RefAttributes<SVGSVGElement>>;

interface SMSQRProps extends Omit<QRCodeProps, 'value'>, SMSPayload {
}
declare const SMSQR: react.ForwardRefExoticComponent<SMSQRProps & react.RefAttributes<SVGSVGElement>>;

interface WhatsAppQRProps extends Omit<QRCodeProps, 'value'>, WhatsAppPayload {
}
declare const WhatsAppQR: react.ForwardRefExoticComponent<WhatsAppQRProps & react.RefAttributes<SVGSVGElement>>;

interface ContactQRProps extends Omit<QRCodeProps, 'value' | 'title'>, ContactPayload {
}
declare const ContactQR: react.ForwardRefExoticComponent<ContactQRProps & react.RefAttributes<SVGSVGElement>>;

interface GoogleMapsQRProps extends Omit<QRCodeProps, 'value'>, GoogleMapsPayload {
}
declare const GoogleMapsQR: react.ForwardRefExoticComponent<GoogleMapsQRProps & react.RefAttributes<SVGSVGElement>>;

interface LocationQRProps extends Omit<QRCodeProps, 'value'>, LocationPayload {
}
declare const LocationQR: react.ForwardRefExoticComponent<LocationQRProps & react.RefAttributes<SVGSVGElement>>;

interface EventQRProps extends Omit<QRCodeProps, 'value' | 'title'>, EventPayload {
}
declare const EventQR: react.ForwardRefExoticComponent<EventQRProps & react.RefAttributes<SVGSVGElement>>;

/**
 * CalendarQR encodes an iCalendar VEVENT — same wire format as EventQR but
 * with optional recurrence. Scanners that recognise VCALENDAR will offer to
 * add the event (and any recurrence) to the user's calendar.
 */
interface CalendarQRProps extends Omit<QRCodeProps, 'value' | 'title'>, EventPayload {
    /** iCal RRULE (e.g. "FREQ=WEEKLY;BYDAY=MO,WE,FR"). Appended to the VEVENT. */
    recurrence?: string;
}
declare const CalendarQR: react.ForwardRefExoticComponent<CalendarQRProps & react.RefAttributes<SVGSVGElement>>;

interface UPIQRProps extends Omit<QRCodeProps, 'value'>, UPIPayload {
}
declare const UPIQR: react.ForwardRefExoticComponent<UPIQRProps & react.RefAttributes<SVGSVGElement>>;

interface CryptoQRProps extends Omit<QRCodeProps, 'value'>, CryptoPayload {
}
declare const CryptoQR: react.ForwardRefExoticComponent<CryptoQRProps & react.RefAttributes<SVGSVGElement>>;

interface SocialQRProps extends Omit<QRCodeProps, 'value'>, SocialPayload {
}
declare const SocialQR: react.ForwardRefExoticComponent<SocialQRProps & react.RefAttributes<SVGSVGElement>>;

type TemplateCategory = 'business' | 'restaurant' | 'portfolio' | 'wedding' | 'event' | 'education' | 'real-estate' | 'healthcare' | 'ecommerce' | 'startup' | 'agency';
interface QRTemplate {
    id: string;
    name: string;
    category: TemplateCategory;
    description: string;
    /** Preset props applied to <QRCode/>. */
    preset: Omit<QRCodeProps, 'value'>;
    /** Sample value used for the preview. */
    sampleValue: string;
}
declare const TEMPLATES: QRTemplate[];

export { CalendarQR, type CalendarQRProps, type ContactAddress, type ContactPayload, ContactQR, type ContactQRProps, type CornerStyle, type CryptoCoin, type CryptoPayload, CryptoQR, type CryptoQRProps, type EmailPayload, EmailQR, type EmailQRProps, type ErrorCorrectionLevel, type EventPayload, EventQR, type EventQRProps, type EyeShape, type GoogleMapsPayload, GoogleMapsQR, type GoogleMapsQRProps, type LabelPosition, type LabelStyle, type LocationPayload, LocationQR, type LocationQRProps, type ModuleShape, type PhonePayload, PhoneQR, type PhoneQRProps, type QRAnimation, QRCode, type QRCodeProps, type QRGradient, type QRMatrix, type QRTemplate, type QRTheme, type QRThemeName, type SMSPayload, SMSQR, type SMSQRProps, type SocialPayload, type SocialPlatform, SocialQR, type SocialQRProps, TEMPLATES, THEMES, type TemplateCategory, TextQR, type TextQRProps, type UPIPayload, UPIQR, type UPIQRProps, WebsiteQR, type WebsiteQRProps, type WhatsAppPayload, WhatsAppQR, type WhatsAppQRProps, type WiFiEncryption, type WiFiPayload, WiFiQR, type WiFiQRProps, encodeContact, encodeCrypto, encodeEmail, encodeEvent, encodeGoogleMaps, encodeLocation, encodePhone, encodeSMS, encodeSocial, encodeUPI, encodeWhatsApp, encodeWiFi, generateMatrix, getAnimationCSS };