/**
 * Output from {@link parseEmailAddress}.
 *
 * Note that {@link parseEmailAddress} will return `undefined` instead of this if its input is not a
 * valid email address.
 */
export type ParsedEmailAddress = {
    /**
     * The "user" or "local" part of an email address. (Everything to the left of the unquoted `@`.)
     *
     * @example
     *
     * 'simple' from 'simple@example.org'
     */
    user: string;
    /**
     * The "domain" or "address" part of the email address. (Everything to the right of the unquoted
     * `@`.)
     *
     * @example
     *
     * 'example.org' from 'simple@example.org'
     */
    domain: string;
    /**
     * The entire original email address.
     *
     * @example
     *
     * 'simple@example.org' from 'simple@example.org'
     */
    full: string;
};
/**
 * Parse an email address into parts.
 *
 * This uses `parse` from [`smtp-address-parser`
 * v1.1.0](https://www.npmjs.com/package/smtp-address-parser/v/1.1.0).
 *
 * @example
 *
 * ```ts
 * import {parseEmailAddress} from 'parse-email-address';
 *
 * const result1 = parseEmailAddress('simple@example.org');
 * // result1 is `{user: 'simple', domain: 'example.org', full: 'simple@example.org'}`
 *
 * const result2 = parseEmailAddress('tld-too-short@foo.x');
 * // result2 is `undefined`
 * ```
 *
 * @returns `undefined` if the given email address is invalid.
 * @throws Nothing, this will never throw an error.
 */
export declare function parseEmailAddress(emailAddress: string | undefined): ParsedEmailAddress | undefined;
/**
 * Normalizes an email address for string comparisons. It is discouraged to use the output of this
 * for sending email as even the weird parts of a valid email address may be required for the user's
 * specific email server to properly handle emails.
 *
 * This uses `canonicalize` from [`smtp-address-parser`
 * v1.1.0](https://www.npmjs.com/package/smtp-address-parser/v/1.1.0) and converts the entire string
 * to lowercase.
 *
 * @example
 *
 * ```ts
 * import {normalizeEmailAddress} from 'parse-email-address';
 *
 * const result1 = normalizeEmailAddress('SIMPLE@EXAMPLE.ORG');
 * // result1 is `'simple@example.org'`
 *
 * const result2 = normalizeEmailAddress('tld-too-short@foo.x');
 * // result2 is `undefined`
 * ```
 *
 * @returns `undefined` if the given email address is invalid.
 * @throws Nothing, this will never throw an error.
 */
export declare function normalizeEmailAddress(emailAddress: string | undefined): string | undefined;
/**
 * Checks if the given email address is valid.
 *
 * This uses `parse` from [`smtp-address-parser`
 * v1.1.0](https://www.npmjs.com/package/smtp-address-parser/v/1.1.0).
 *
 * @example
 *
 * ```ts
 * import {isValidEmailAddress} from 'parse-email-address';
 *
 * const result1 = isValidEmailAddress('simple@example.org');
 * // result1 is `true`
 *
 * const result2 = isValidEmailAddress('SIMPLE@EXAMPLE.ORG');
 * // result2 is `true`
 *
 * const result3 = isValidEmailAddress('tld-too-short@foo.x');
 * // result3 is `false`
 * ```
 *
 * @throws Nothing, this will never throw an error.
 */
export declare function isValidEmailAddress(emailAddress: string | undefined): boolean;