@expresscsv/sdk 0.1.2 → 0.1.3

package/dist/index.d.mts

@@ -1,214 +1,3920 @@
-import { ExType, ExRow, ExRowShape, Infer } from '@expresscsv/fields';
-export { ExType, Infer, x } from '@expresscsv/fields';
-import { WidgetState, WidgetMode } from '@expresscsv/iframe-comm';
-export { WidgetMode, WidgetState } from '@expresscsv/iframe-comm';
-import { ExBaseDef } from '@expresscsv/fields/src/types';
-export { ExBaseDef } from '@expresscsv/fields/src/types';
-import { ECSVTheme, ColorModeConfig, ECSVFontSource } from '@expresscsv/theme';
-export { ColorModeConfig, ColorModePref, ECSVFontSource, ECSVTheme, TailwindThemeVars } from '@expresscsv/theme';
-import { TemplateDownloadConfig, DeepPartial, ExpressCSVLocaleInput, ExpressCSVStep } from '@expresscsv/core';
-export { DeepPartial, ExpressCSVLocaleInput, ExpressCSVStep } from '@expresscsv/core';
-
-/**
- * Error thrown when the user cancels the import operation
- */
-declare class ImportCancelledError extends Error {
-    constructor(message?: string);
-}
-
-/**
- * A chunk of records passed to the onData callback
- */
-interface RecordsChunk<T> {
-    /** The records in this chunk */
-    records: T[];
-    /** Total number of chunks */
-    totalChunks: number;
-    /** Current chunk index (0-based) */
-    currentChunkIndex: number;
-    /** Total number of records across all chunks */
-    totalRecords: number;
-}
-/**
- * Webhook configuration for remote delivery of results
- */
-interface WebhookConfig {
-    /** The URL to send webhook requests to */
-    url: string;
-    /** Optional HTTP headers to include in the request */
-    headers?: Record<string, string>;
-    /** HTTP method to use (default: 'POST') */
-    method?: 'POST' | 'PUT' | 'PATCH';
-    /** Request timeout in milliseconds (default: 30000) */
-    timeout?: number;
-    /** Number of retry attempts on failure (default: 0) */
-    retries?: number;
-    /** Arbitrary developer-provided metadata */
-    metadata?: Record<string, unknown>;
-}
-/**
- * Type helper that requires at least one of the specified keys to be present
- */
-type RequireAtLeastOne<T, Keys extends keyof T = keyof T> = Pick<T, Exclude<keyof T, Keys>> & {
-    [K in Keys]-?: Required<Pick<T, K>> & Partial<Pick<T, Exclude<Keys, K>>>;
-}[Keys];
-/**
- * Base delivery options - at least one must be provided
- */
-interface DeliveryOptionsBase<T> {
-    /** Local callback for processing chunks */
-    onData?: (chunk: RecordsChunk<T>, next: () => void) => void | Promise<void>;
-    /** Webhook configuration for remote delivery */
-    webhook?: WebhookConfig;
-}
-/**
- * Delivery options - requires at least one of onData or webhook
- */
-type DeliveryOptions<T> = RequireAtLeastOne<DeliveryOptionsBase<T>, 'onData' | 'webhook'>;
-/**
- * Options for the open() method
- * Requires at least one of onData or webhook for delivery
- */
-type OpenOptions<T> = RequireAtLeastOne<DeliveryOptionsBase<T>, 'onData' | 'webhook'> & {
-    /** Number of records per chunk (default: 1000) */
-    chunkSize?: number;
-    /** Called when all chunks have been processed */
-    onComplete?: () => void;
-    /** Called when the user cancels the import */
-    onCancel?: () => void;
-    /** Called when an error occurs */
-    onError?: (error: Error) => void;
-    /** Called when the widget opens */
-    onWidgetOpen?: () => void;
-    /** Called when the step changes in the wizard */
-    onStepChange?: (stepId: ExpressCSVStep, previousStepId?: ExpressCSVStep) => void;
-    /** Called when the widget closes */
-    onWidgetClose?: (reason: 'user_close' | 'cancel' | 'complete' | 'error') => void;
-};
-type InferCSVImporter<TSchema extends ExType<unknown, ExBaseDef, unknown>> = CSVImporter<TSchema>;
-
-interface SDKOptions<TSchema extends ExType<unknown, ExBaseDef, unknown>> {
-    schema: TSchema;
-    publishableKey: string;
-    importIdentifier: string;
-    title?: string;
-    debug?: boolean;
-    developerMode?: boolean;
-    preload?: boolean;
-    theme?: ECSVTheme;
-    colorMode?: ColorModeConfig;
-    customCSS?: string;
-    fonts?: Record<string, ECSVFontSource>;
-    stepDisplay?: 'progressBar' | 'segmented' | 'numbered';
-    previewSchemaBeforeUpload?: boolean;
-    templateDownload?: TemplateDownloadConfig;
-    saveSession?: boolean;
-    locale?: DeepPartial<ExpressCSVLocaleInput>;
-}
-declare class CSVImporter<TSchema extends ExType<unknown, ExBaseDef, unknown> = ExRow<ExRowShape>> {
-    private options;
-    private iframe;
-    private container;
-    private connection;
-    private connectionState;
-    private debug;
-    private developerMode;
-    private importIdentifier;
-    private sessionId;
-    private _destroyTimer;
-    private _beforeUnloadHandler;
-    private widgetUrl;
-    private widgetState;
-    private widgetMode;
-    private canRestart;
-    private lastError;
-    private openOptions;
-    private cachedSchemaJson;
-    private initCompletePromise;
-    private resolveInitComplete;
-    constructor(options: SDKOptions<TSchema>);
-    /**
-     * Enhanced state management
-     */
-    private setState;
-    private updateDerivedState;
-    private handleError;
-    private waitForEvent;
-    /**
-     * Open the import flow with chunk-based data processing.
-     * Automatically opens the widget if not already open.
-     *
-     * @param options Configuration including onData callback for processing chunks
-     */
-    open(options: OpenOptions<Infer<TSchema>>): void;
-    /**
-     * Create import session on backend with configuration
-     * Idempotent: safe to call multiple times with same sessionId
-     */
-    private createImportSession;
-    /**
-     * Deliver results to webhook endpoint via backend API
-     * Chunks data using SDK-determined chunk size (independent of customer's chunkSize)
-     */
-    private deliverToWebhook;
-    /**
-     * Send a single chunk to backend webhook API with retry logic
-     */
-    private sendChunkToBackend;
-    /**
-     * Process results in chunks, calling onData and/or webhook for each chunk with backpressure control
-     */
-    private processResultsInChunks;
-    /**
-     * Initialize the iframe and connection.
-     * @param hidden Whether to create the iframe hidden (for preload) or visible (for normal open)
-     */
-    private initializeIframe;
-    private log;
-    private error;
-    /**
-     * Add beforeunload event listener to warn users about losing progress
-     */
-    private addBeforeUnloadListener;
-    /**
-     * Remove beforeunload event listener
-     */
-    private removeBeforeUnloadListener;
-    private waitForIframeLoad;
-    private setupConnectionAndInit;
-    openWidget(options?: {
-        reset?: boolean;
-    }): Promise<void>;
-    /**
-     * Makes a hidden container visible for instant display of preloaded iframe
-     */
-    private makeContainerVisible;
-    private setupMessageHandlers;
-    private createAndAppendIframe;
-    private destroy;
-    close(reason?: 'user_close' | 'cancel' | 'complete' | 'error'): Promise<void>;
-    resetWidget(): Promise<void>;
-    restart(newOptions?: Partial<SDKOptions<TSchema>>): Promise<void>;
-    private handleWidgetClosed;
-    private hideContainer;
-    getConnectionStatus(): boolean;
-    getState(): WidgetState;
-    getMode(): WidgetMode;
-    getIsReady(): boolean;
-    getIsOpen(): boolean;
-    getCanRestart(): boolean;
-    getLastError(): Error | null;
-    getStatus(): {
-        state: WidgetState;
-        mode: WidgetMode;
-        isReady: boolean;
-        isOpen: boolean;
-        canRestart: boolean;
-        hasError: boolean;
-        lastError: Error | null;
-        connectionStatus: boolean;
-    };
-    getVersion(): string;
-}
-
-export { CSVImporter, type DeliveryOptions, ImportCancelledError, type InferCSVImporter, type OpenOptions, type RecordsChunk, type SDKOptions, type WebhookConfig };
+declare interface BICOptions {
+    message?: string;
+}
+
+declare type BooleanControlType = 'toggle' | 'checkbox' | 'dropdown';
+
+/**
+ * Color mode configuration
+ */
+export declare interface ColorModeConfig {
+    default?: ColorModePref;
+    persist?: boolean;
+    onChange?: (mode: ColorModePref) => void;
+}
+
+/**
+ * Color mode preference
+ */
+export declare type ColorModePref = 'light' | 'dark' | 'system';
+
+declare const Countries: readonly [{
+    readonly name: "Afghanistan";
+    readonly alpha2: "AF";
+    readonly alpha3: "AFG";
+    readonly aliases: readonly ["Afġānistān", "افغانستان"];
+}, {
+    readonly name: "Åland Islands";
+    readonly alpha2: "AX";
+    readonly alpha3: "ALA";
+    readonly aliases: readonly ["Ahvenanmaa", "Åland"];
+}, {
+    readonly name: "Albania";
+    readonly alpha2: "AL";
+    readonly alpha3: "ALB";
+    readonly aliases: readonly ["Shqipëri", "Shqipëria"];
+}, {
+    readonly name: "Algeria";
+    readonly alpha2: "DZ";
+    readonly alpha3: "DZA";
+    readonly aliases: readonly ["الجزائر", "Algérie"];
+}, {
+    readonly name: "American Samoa";
+    readonly alpha2: "AS";
+    readonly alpha3: "ASM";
+    readonly aliases: readonly ["Sāmoa Amelika", "Amelika Sāmoa"];
+}, {
+    readonly name: "Andorra";
+    readonly alpha2: "AD";
+    readonly alpha3: "AND";
+    readonly aliases: readonly ["Principat d'Andorra"];
+}, {
+    readonly name: "Angola";
+    readonly alpha2: "AO";
+    readonly alpha3: "AGO";
+    readonly aliases: readonly ["República de Angola"];
+}, {
+    readonly name: "Anguilla";
+    readonly alpha2: "AI";
+    readonly alpha3: "AIA";
+    readonly aliases: readonly [];
+}, {
+    readonly name: "Antigua and Barbuda";
+    readonly alpha2: "AG";
+    readonly alpha3: "ATG";
+    readonly aliases: readonly ["Antigua", "Barbuda"];
+}, {
+    readonly name: "Argentina";
+    readonly alpha2: "AR";
+    readonly alpha3: "ARG";
+    readonly aliases: readonly ["República Argentina", "Argentine Republic"];
+}, {
+    readonly name: "Armenia";
+    readonly alpha2: "AM";
+    readonly alpha3: "ARM";
+    readonly aliases: readonly ["Հայաստան", "Hayastan", "Republic of Armenia"];
+}, {
+    readonly name: "Aruba";
+    readonly alpha2: "AW";
+    readonly alpha3: "ABW";
+    readonly aliases: readonly [];
+}, {
+    readonly name: "Australia";
+    readonly alpha2: "AU";
+    readonly alpha3: "AUS";
+    readonly aliases: readonly ["Commonwealth of Australia", "Oz"];
+}, {
+    readonly name: "Austria";
+    readonly alpha2: "AT";
+    readonly alpha3: "AUT";
+    readonly aliases: readonly ["Österreich"];
+}, {
+    readonly name: "Azerbaijan";
+    readonly alpha2: "AZ";
+    readonly alpha3: "AZE";
+    readonly aliases: readonly ["Azərbaycan", "Republic of Azerbaijan"];
+}, {
+    readonly name: "Bahamas";
+    readonly alpha2: "BS";
+    readonly alpha3: "BHS";
+    readonly aliases: readonly ["The Bahamas", "Commonwealth of The Bahamas"];
+}, {
+    readonly name: "Bahrain";
+    readonly alpha2: "BH";
+    readonly alpha3: "BHR";
+    readonly aliases: readonly ["البحرين", "Kingdom of Bahrain"];
+}, {
+    readonly name: "Bangladesh";
+    readonly alpha2: "BD";
+    readonly alpha3: "BGD";
+    readonly aliases: readonly ["বাংলাদেশ", "People's Republic of Bangladesh"];
+}, {
+    readonly name: "Barbados";
+    readonly alpha2: "BB";
+    readonly alpha3: "BRB";
+    readonly aliases: readonly [];
+}, {
+    readonly name: "Belarus";
+    readonly alpha2: "BY";
+    readonly alpha3: "BLR";
+    readonly aliases: readonly ["Беларусь", "Republic of Belarus", "Belorussia"];
+}, {
+    readonly name: "Belgium";
+    readonly alpha2: "BE";
+    readonly alpha3: "BEL";
+    readonly aliases: readonly ["België", "Belgique", "Belgien"];
+}, {
+    readonly name: "Belize";
+    readonly alpha2: "BZ";
+    readonly alpha3: "BLZ";
+    readonly aliases: readonly [];
+}, {
+    readonly name: "Benin";
+    readonly alpha2: "BJ";
+    readonly alpha3: "BEN";
+    readonly aliases: readonly ["Republic of Benin", "République du Bénin"];
+}, {
+    readonly name: "Bermuda";
+    readonly alpha2: "BM";
+    readonly alpha3: "BMU";
+    readonly aliases: readonly [];
+}, {
+    readonly name: "Bhutan";
+    readonly alpha2: "BT";
+    readonly alpha3: "BTN";
+    readonly aliases: readonly ["འབྲུག་ཡུལ་", "Druk Yul", "Kingdom of Bhutan"];
+}, {
+    readonly name: "Bolivia";
+    readonly alpha2: "BO";
+    readonly alpha3: "BOL";
+    readonly aliases: readonly ["Bolivia", "Estado Plurinacional de Bolivia"];
+}, {
+    readonly name: "Bonaire, Sint Eustatius and Saba";
+    readonly alpha2: "BQ";
+    readonly alpha3: "BES";
+    readonly aliases: readonly ["Caribbean Netherlands"];
+}, {
+    readonly name: "Bosnia and Herzegovina";
+    readonly alpha2: "BA";
+    readonly alpha3: "BIH";
+    readonly aliases: readonly ["Bosna i Hercegovina"];
+}, {
+    readonly name: "Botswana";
+    readonly alpha2: "BW";
+    readonly alpha3: "BWA";
+    readonly aliases: readonly ["Republic of Botswana"];
+}, {
+    readonly name: "Brazil";
+    readonly alpha2: "BR";
+    readonly alpha3: "BRA";
+    readonly aliases: readonly ["Brasil", "Federative Republic of Brazil"];
+}, {
+    readonly name: "British Indian Ocean Territory";
+    readonly alpha2: "IO";
+    readonly alpha3: "IOT";
+    readonly aliases: readonly [];
+}, {
+    readonly name: "Brunei Darussalam";
+    readonly alpha2: "BN";
+    readonly alpha3: "BRN";
+    readonly aliases: readonly ["Brunei"];
+}, {
+    readonly name: "Bulgaria";
+    readonly alpha2: "BG";
+    readonly alpha3: "BGR";
+    readonly aliases: readonly ["България", "Republic of Bulgaria"];
+}, {
+    readonly name: "Burkina Faso";
+    readonly alpha2: "BF";
+    readonly alpha3: "BFA";
+    readonly aliases: readonly ["Burkina"];
+}, {
+    readonly name: "Burundi";
+    readonly alpha2: "BI";
+    readonly alpha3: "BDI";
+    readonly aliases: readonly ["Republic of Burundi", "Republika y'Uburundi"];
+}, {
+    readonly name: "Cabo Verde";
+    readonly alpha2: "CV";
+    readonly alpha3: "CPV";
+    readonly aliases: readonly ["Cape Verde"];
+}, {
+    readonly name: "Cambodia";
+    readonly alpha2: "KH";
+    readonly alpha3: "KHM";
+    readonly aliases: readonly ["កម្ពុជា", "Kingdom of Cambodia"];
+}, {
+    readonly name: "Cameroon";
+    readonly alpha2: "CM";
+    readonly alpha3: "CMR";
+    readonly aliases: readonly ["Cameroun", "Republic of Cameroon"];
+}, {
+    readonly name: "Canada";
+    readonly alpha2: "CA";
+    readonly alpha3: "CAN";
+    readonly aliases: readonly ["Kanada", "Canada (French)"];
+}, {
+    readonly name: "Cayman Islands";
+    readonly alpha2: "KY";
+    readonly alpha3: "CYM";
+    readonly aliases: readonly [];
+}, {
+    readonly name: "Central African Republic";
+    readonly alpha2: "CF";
+    readonly alpha3: "CAF";
+    readonly aliases: readonly ["République centrafricaine"];
+}, {
+    readonly name: "Chad";
+    readonly alpha2: "TD";
+    readonly alpha3: "TCD";
+    readonly aliases: readonly ["Tchad", "جمهورية تشاد"];
+}, {
+    readonly name: "Chile";
+    readonly alpha2: "CL";
+    readonly alpha3: "CHL";
+    readonly aliases: readonly ["República de Chile"];
+}, {
+    readonly name: "China";
+    readonly alpha2: "CN";
+    readonly alpha3: "CHN";
+    readonly aliases: readonly ["中华人民共和国", "中国", "Zhōngguó", "People's Republic of China", "PRC"];
+}, {
+    readonly name: "Christmas Island";
+    readonly alpha2: "CX";
+    readonly alpha3: "CXR";
+    readonly aliases: readonly [];
+}, {
+    readonly name: "Cocos (Keeling) Islands";
+    readonly alpha2: "CC";
+    readonly alpha3: "CCK";
+    readonly aliases: readonly [];
+}, {
+    readonly name: "Colombia";
+    readonly alpha2: "CO";
+    readonly alpha3: "COL";
+    readonly aliases: readonly ["República de Colombia"];
+}, {
+    readonly name: "Comoros";
+    readonly alpha2: "KM";
+    readonly alpha3: "COM";
+    readonly aliases: readonly ["جزر القمر", "Union of the Comoros"];
+}, {
+    readonly name: "Congo";
+    readonly alpha2: "CG";
+    readonly alpha3: "COG";
+    readonly aliases: readonly ["Republic of the Congo", "Congo-Brazzaville"];
+}, {
+    readonly name: "Democratic Republic of the Congo";
+    readonly alpha2: "CD";
+    readonly alpha3: "COD";
+    readonly aliases: readonly ["Democratic Republic of the Congo", "Congo-Kinshasa", "DR Congo", "DRC"];
+}, {
+    readonly name: "Cook Islands";
+    readonly alpha2: "CK";
+    readonly alpha3: "COK";
+    readonly aliases: readonly [];
+}, {
+    readonly name: "Costa Rica";
+    readonly alpha2: "CR";
+    readonly alpha3: "CRI";
+    readonly aliases: readonly ["República de Costa Rica"];
+}, {
+    readonly name: "Côte d'Ivoire";
+    readonly alpha2: "CI";
+    readonly alpha3: "CIV";
+    readonly aliases: readonly ["Ivory Coast", "République de Côte d'Ivoire"];
+}, {
+    readonly name: "Croatia";
+    readonly alpha2: "HR";
+    readonly alpha3: "HRV";
+    readonly aliases: readonly ["Hrvatska", "Republic of Croatia"];
+}, {
+    readonly name: "Cuba";
+    readonly alpha2: "CU";
+    readonly alpha3: "CUB";
+    readonly aliases: readonly ["República de Cuba"];
+}, {
+    readonly name: "Curaçao";
+    readonly alpha2: "CW";
+    readonly alpha3: "CUW";
+    readonly aliases: readonly [];
+}, {
+    readonly name: "Cyprus";
+    readonly alpha2: "CY";
+    readonly alpha3: "CYP";
+    readonly aliases: readonly ["Κύπρος", "Kıbrıs"];
+}, {
+    readonly name: "Czechia";
+    readonly alpha2: "CZ";
+    readonly alpha3: "CZE";
+    readonly aliases: readonly ["Czech Republic", "Česko"];
+}, {
+    readonly name: "Denmark";
+    readonly alpha2: "DK";
+    readonly alpha3: "DNK";
+    readonly aliases: readonly ["Danmark"];
+}, {
+    readonly name: "Djibouti";
+    readonly alpha2: "DJ";
+    readonly alpha3: "DJI";
+    readonly aliases: readonly ["جيبوتي", "Djibouti City-State"];
+}, {
+    readonly name: "Dominica";
+    readonly alpha2: "DM";
+    readonly alpha3: "DMA";
+    readonly aliases: readonly [];
+}, {
+    readonly name: "Dominican Republic";
+    readonly alpha2: "DO";
+    readonly alpha3: "DOM";
+    readonly aliases: readonly ["República Dominicana"];
+}, {
+    readonly name: "Ecuador";
+    readonly alpha2: "EC";
+    readonly alpha3: "ECU";
+    readonly aliases: readonly ["República del Ecuador"];
+}, {
+    readonly name: "Egypt";
+    readonly alpha2: "EG";
+    readonly alpha3: "EGY";
+    readonly aliases: readonly ["مصر", "Arab Republic of Egypt"];
+}, {
+    readonly name: "El Salvador";
+    readonly alpha2: "SV";
+    readonly alpha3: "SLV";
+    readonly aliases: readonly ["República de El Salvador"];
+}, {
+    readonly name: "Equatorial Guinea";
+    readonly alpha2: "GQ";
+    readonly alpha3: "GNQ";
+    readonly aliases: readonly ["República de Guinea Ecuatorial", "République de Guinée équatoriale", "República da Guiné Equatorial"];
+}, {
+    readonly name: "Eritrea";
+    readonly alpha2: "ER";
+    readonly alpha3: "ERI";
+    readonly aliases: readonly ["State of Eritrea", "ኤርትራ", "إريتريا"];
+}, {
+    readonly name: "Estonia";
+    readonly alpha2: "EE";
+    readonly alpha3: "EST";
+    readonly aliases: readonly ["Eesti"];
+}, {
+    readonly name: "Eswatini";
+    readonly alpha2: "SZ";
+    readonly alpha3: "SWZ";
+    readonly aliases: readonly ["Swaziland", "Kingdom of Eswatini"];
+}, {
+    readonly name: "Ethiopia";
+    readonly alpha2: "ET";
+    readonly alpha3: "ETH";
+    readonly aliases: readonly ["ኢትዮጵያ", "Federal Democratic Republic of Ethiopia"];
+}, {
+    readonly name: "Falkland Islands (Malvinas)";
+    readonly alpha2: "FK";
+    readonly alpha3: "FLK";
+    readonly aliases: readonly ["Islas Malvinas"];
+}, {
+    readonly name: "Faroe Islands";
+    readonly alpha2: "FO";
+    readonly alpha3: "FRO";
+    readonly aliases: readonly ["Føroyar"];
+}, {
+    readonly name: "Fiji";
+    readonly alpha2: "FJ";
+    readonly alpha3: "FJI";
+    readonly aliases: readonly ["Viti", "Fiji Islands"];
+}, {
+    readonly name: "Finland";
+    readonly alpha2: "FI";
+    readonly alpha3: "FIN";
+    readonly aliases: readonly ["Suomi"];
+}, {
+    readonly name: "France";
+    readonly alpha2: "FR";
+    readonly alpha3: "FRA";
+    readonly aliases: readonly ["République française"];
+}, {
+    readonly name: "French Guiana";
+    readonly alpha2: "GF";
+    readonly alpha3: "GUF";
+    readonly aliases: readonly ["Guyane"];
+}, {
+    readonly name: "French Polynesia";
+    readonly alpha2: "PF";
+    readonly alpha3: "PYF";
+    readonly aliases: readonly ["Polynésie française"];
+}, {
+    readonly name: "Gabon";
+    readonly alpha2: "GA";
+    readonly alpha3: "GAB";
+    readonly aliases: readonly ["République gabonaise"];
+}, {
+    readonly name: "Gambia";
+    readonly alpha2: "GM";
+    readonly alpha3: "GMB";
+    readonly aliases: readonly ["Republic of The Gambia"];
+}, {
+    readonly name: "Georgia";
+    readonly alpha2: "GE";
+    readonly alpha3: "GEO";
+    readonly aliases: readonly ["საქართველო", "Sakartvelo"];
+}, {
+    readonly name: "Germany";
+    readonly alpha2: "DE";
+    readonly alpha3: "DEU";
+    readonly aliases: readonly ["Deutschland", "Federal Republic of Germany"];
+}, {
+    readonly name: "Ghana";
+    readonly alpha2: "GH";
+    readonly alpha3: "GHA";
+    readonly aliases: readonly ["Republic of Ghana"];
+}, {
+    readonly name: "Gibraltar";
+    readonly alpha2: "GI";
+    readonly alpha3: "GIB";
+    readonly aliases: readonly [""];
+}, {
+    readonly name: "Greece";
+    readonly alpha2: "GR";
+    readonly alpha3: "GRC";
+    readonly aliases: readonly ["Ελλάδα", "Hellas", "Hellenic Republic"];
+}, {
+    readonly name: "Greenland";
+    readonly alpha2: "GL";
+    readonly alpha3: "GRL";
+    readonly aliases: readonly ["Kalaallit Nunaat"];
+}, {
+    readonly name: "Grenada";
+    readonly alpha2: "GD";
+    readonly alpha3: "GRD";
+    readonly aliases: readonly [];
+}, {
+    readonly name: "Guadeloupe";
+    readonly alpha2: "GP";
+    readonly alpha3: "GLP";
+    readonly aliases: readonly [];
+}, {
+    readonly name: "Guam";
+    readonly alpha2: "GU";
+    readonly alpha3: "GUM";
+    readonly aliases: readonly ["Guåhån"];
+}, {
+    readonly name: "Guatemala";
+    readonly alpha2: "GT";
+    readonly alpha3: "GTM";
+    readonly aliases: readonly ["República de Guatemala"];
+}, {
+    readonly name: "Guernsey";
+    readonly alpha2: "GG";
+    readonly alpha3: "GGY";
+    readonly aliases: readonly [];
+}, {
+    readonly name: "Guinea";
+    readonly alpha2: "GN";
+    readonly alpha3: "GIN";
+    readonly aliases: readonly ["République de Guinée"];
+}, {
+    readonly name: "Guinea-Bissau";
+    readonly alpha2: "GW";
+    readonly alpha3: "GNB";
+    readonly aliases: readonly ["República da Guiné-Bissau"];
+}, {
+    readonly name: "Guyana";
+    readonly alpha2: "GY";
+    readonly alpha3: "GUY";
+    readonly aliases: readonly ["Co-operative Republic of Guyana"];
+}, {
+    readonly name: "Haiti";
+    readonly alpha2: "HT";
+    readonly alpha3: "HTI";
+    readonly aliases: readonly ["République d'Haïti", "Repiblik d Ayiti"];
+}, {
+    readonly name: "Holy See";
+    readonly alpha2: "VA";
+    readonly alpha3: "VAT";
+    readonly aliases: readonly ["Vatican City", "Vatican City State", "Santa Sede"];
+}, {
+    readonly name: "Honduras";
+    readonly alpha2: "HN";
+    readonly alpha3: "HND";
+    readonly aliases: readonly ["República de Honduras"];
+}, {
+    readonly name: "Hong Kong";
+    readonly alpha2: "HK";
+    readonly alpha3: "HKG";
+    readonly aliases: readonly ["香港", "Xianggang", "Hong Kong SAR"];
+}, {
+    readonly name: "Hungary";
+    readonly alpha2: "HU";
+    readonly alpha3: "HUN";
+    readonly aliases: readonly ["Magyarország"];
+}, {
+    readonly name: "Iceland";
+    readonly alpha2: "IS";
+    readonly alpha3: "ISL";
+    readonly aliases: readonly ["Ísland"];
+}, {
+    readonly name: "India";
+    readonly alpha2: "IN";
+    readonly alpha3: "IND";
+    readonly aliases: readonly ["भारत", "Republic of India", "Bharat"];
+}, {
+    readonly name: "Indonesia";
+    readonly alpha2: "ID";
+    readonly alpha3: "IDN";
+    readonly aliases: readonly ["Republik Indonesia"];
+}, {
+    readonly name: "Iran, Islamic Republic of";
+    readonly alpha2: "IR";
+    readonly alpha3: "IRN";
+    readonly aliases: readonly ["ایران", "Islamic Republic of Iran"];
+}, {
+    readonly name: "Iraq";
+    readonly alpha2: "IQ";
+    readonly alpha3: "IRQ";
+    readonly aliases: readonly ["العراق", "Republic of Iraq"];
+}, {
+    readonly name: "Ireland";
+    readonly alpha2: "IE";
+    readonly alpha3: "IRL";
+    readonly aliases: readonly ["Éire", "Republic of Ireland"];
+}, {
+    readonly name: "Isle of Man";
+    readonly alpha2: "IM";
+    readonly alpha3: "IMN";
+    readonly aliases: readonly ["Mann", "Ellan Vannin"];
+}, {
+    readonly name: "Israel";
+    readonly alpha2: "IL";
+    readonly alpha3: "ISR";
+    readonly aliases: readonly ["יִשְׂרָאֵל", "State of Israel", "Medīnat Yisrā'el"];
+}, {
+    readonly name: "Italy";
+    readonly alpha2: "IT";
+    readonly alpha3: "ITA";
+    readonly aliases: readonly ["Italia", "Repubblica Italiana"];
+}, {
+    readonly name: "Jamaica";
+    readonly alpha2: "JM";
+    readonly alpha3: "JAM";
+    readonly aliases: readonly [];
+}, {
+    readonly name: "Japan";
+    readonly alpha2: "JP";
+    readonly alpha3: "JPN";
+    readonly aliases: readonly ["日本", "Nihon", "Nippon"];
+}, {
+    readonly name: "Jersey";
+    readonly alpha2: "JE";
+    readonly alpha3: "JEY";
+    readonly aliases: readonly [];
+}, {
+    readonly name: "Jordan";
+    readonly alpha2: "JO";
+    readonly alpha3: "JOR";
+    readonly aliases: readonly ["الأردن", "Hashemite Kingdom of Jordan"];
+}, {
+    readonly name: "Kazakhstan";
+    readonly alpha2: "KZ";
+    readonly alpha3: "KAZ";
+    readonly aliases: readonly ["Қазақстан", "Republic of Kazakhstan"];
+}, {
+    readonly name: "Kenya";
+    readonly alpha2: "KE";
+    readonly alpha3: "KEN";
+    readonly aliases: readonly ["Republic of Kenya"];
+}, {
+    readonly name: "Kiribati";
+    readonly alpha2: "KI";
+    readonly alpha3: "KIR";
+    readonly aliases: readonly [];
+}, {
+    readonly name: "North Korea";
+    readonly alpha2: "KP";
+    readonly alpha3: "PRK";
+    readonly aliases: readonly ["North Korea", "조선민주주의인민공화국", "Democratic People's Republic of Korea"];
+}, {
+    readonly name: "South Korea";
+    readonly alpha2: "KR";
+    readonly alpha3: "KOR";
+    readonly aliases: readonly ["South Korea", "대한민국", "Republic of Korea"];
+}, {
+    readonly name: "Kosovo";
+    readonly alpha2: "XK";
+    readonly alpha3: "XKS";
+    readonly aliases: readonly ["Kosova", "Косово", "Republic of Kosovo", "Republika e Kosovës"];
+}, {
+    readonly name: "Kuwait";
+    readonly alpha2: "KW";
+    readonly alpha3: "KWT";
+    readonly aliases: readonly ["الكويت", "State of Kuwait"];
+}, {
+    readonly name: "Kyrgyzstan";
+    readonly alpha2: "KG";
+    readonly alpha3: "KGZ";
+    readonly aliases: readonly ["Кыргызстан", "Kyrgyz Republic"];
+}, {
+    readonly name: "Lao People's Democratic Republic";
+    readonly alpha2: "LA";
+    readonly alpha3: "LAO";
+    readonly aliases: readonly ["Laos", "ສປປລາວ"];
+}, {
+    readonly name: "Latvia";
+    readonly alpha2: "LV";
+    readonly alpha3: "LVA";
+    readonly aliases: readonly ["Latvija"];
+}, {
+    readonly name: "Lebanon";
+    readonly alpha2: "LB";
+    readonly alpha3: "LBN";
+    readonly aliases: readonly ["لبنان", "Republic of Lebanon"];
+}, {
+    readonly name: "Lesotho";
+    readonly alpha2: "LS";
+    readonly alpha3: "LSO";
+    readonly aliases: readonly ["Kingdom of Lesotho"];
+}, {
+    readonly name: "Liberia";
+    readonly alpha2: "LR";
+    readonly alpha3: "LBR";
+    readonly aliases: readonly ["Republic of Liberia"];
+}, {
+    readonly name: "Libya";
+    readonly alpha2: "LY";
+    readonly alpha3: "LBY";
+    readonly aliases: readonly ["Libyan Arab Jamahiriya"];
+}, {
+    readonly name: "Liechtenstein";
+    readonly alpha2: "LI";
+    readonly alpha3: "LIE";
+    readonly aliases: readonly ["Fürstentum Liechtenstein"];
+}, {
+    readonly name: "Lithuania";
+    readonly alpha2: "LT";
+    readonly alpha3: "LTU";
+    readonly aliases: readonly ["Lietuva", "Republic of Lithuania"];
+}, {
+    readonly name: "Luxembourg";
+    readonly alpha2: "LU";
+    readonly alpha3: "LUX";
+    readonly aliases: readonly ["Lëtzebuerg", "Luxembourg", "Luxemburg"];
+}, {
+    readonly name: "Macao";
+    readonly alpha2: "MO";
+    readonly alpha3: "MAC";
+    readonly aliases: readonly ["澳門", "Macao SAR", "Àomén"];
+}, {
+    readonly name: "Madagascar";
+    readonly alpha2: "MG";
+    readonly alpha3: "MDG";
+    readonly aliases: readonly ["Repoblikan'i Madagasikara", "République de Madagascar"];
+}, {
+    readonly name: "Malawi";
+    readonly alpha2: "MW";
+    readonly alpha3: "MWI";
+    readonly aliases: readonly ["Republic of Malawi"];
+}, {
+    readonly name: "Malaysia";
+    readonly alpha2: "MY";
+    readonly alpha3: "MYS";
+    readonly aliases: readonly ["Malaysia", "ماليزيا"];
+}, {
+    readonly name: "Maldives";
+    readonly alpha2: "MV";
+    readonly alpha3: "MDV";
+    readonly aliases: readonly ["ދިވެހިރާއްޖޭގެ", "Dhivehi Raajje", "Republic of Maldives"];
+}, {
+    readonly name: "Mali";
+    readonly alpha2: "ML";
+    readonly alpha3: "MLI";
+    readonly aliases: readonly ["République du Mali"];
+}, {
+    readonly name: "Malta";
+    readonly alpha2: "MT";
+    readonly alpha3: "MLT";
+    readonly aliases: readonly ["Repubblika ta' Malta", "Republic of Malta"];
+}, {
+    readonly name: "Marshall Islands";
+    readonly alpha2: "MH";
+    readonly alpha3: "MHL";
+    readonly aliases: readonly ["Aolepān Aorōkin M̧ajeļ", "Republic of the Marshall Islands"];
+}, {
+    readonly name: "Martinique";
+    readonly alpha2: "MQ";
+    readonly alpha3: "MTQ";
+    readonly aliases: readonly [];
+}, {
+    readonly name: "Mauritania";
+    readonly alpha2: "MR";
+    readonly alpha3: "MRT";
+    readonly aliases: readonly ["موريتانيا", "Islamic Republic of Mauritania"];
+}, {
+    readonly name: "Mauritius";
+    readonly alpha2: "MU";
+    readonly alpha3: "MUS";
+    readonly aliases: readonly ["Republic of Mauritius", "République de Maurice"];
+}, {
+    readonly name: "Mayotte";
+    readonly alpha2: "YT";
+    readonly alpha3: "MYT";
+    readonly aliases: readonly [];
+}, {
+    readonly name: "Mexico";
+    readonly alpha2: "MX";
+    readonly alpha3: "MEX";
+    readonly aliases: readonly ["México", "Estados Unidos Mexicanos"];
+}, {
+    readonly name: "Micronesia, Federated States of";
+    readonly alpha2: "FM";
+    readonly alpha3: "FSM";
+    readonly aliases: readonly ["Micronesia", "Federated States of Micronesia"];
+}, {
+    readonly name: "Moldova";
+    readonly alpha2: "MD";
+    readonly alpha3: "MDA";
+    readonly aliases: readonly ["Moldova", "Republica Moldova"];
+}, {
+    readonly name: "Monaco";
+    readonly alpha2: "MC";
+    readonly alpha3: "MCO";
+    readonly aliases: readonly ["Principauté de Monaco"];
+}, {
+    readonly name: "Mongolia";
+    readonly alpha2: "MN";
+    readonly alpha3: "MNG";
+    readonly aliases: readonly ["Монгол улс", "Mongol Uls"];
+}, {
+    readonly name: "Montenegro";
+    readonly alpha2: "ME";
+    readonly alpha3: "MNE";
+    readonly aliases: readonly ["Црна Гора", "Crna Gora"];
+}, {
+    readonly name: "Montserrat";
+    readonly alpha2: "MS";
+    readonly alpha3: "MSR";
+    readonly aliases: readonly [];
+}, {
+    readonly name: "Morocco";
+    readonly alpha2: "MA";
+    readonly alpha3: "MAR";
+    readonly aliases: readonly ["المغرب", "Maroc", "Kingdom of Morocco"];
+}, {
+    readonly name: "Mozambique";
+    readonly alpha2: "MZ";
+    readonly alpha3: "MOZ";
+    readonly aliases: readonly ["Moçambique", "Republic of Mozambique"];
+}, {
+    readonly name: "Myanmar";
+    readonly alpha2: "MM";
+    readonly alpha3: "MMR";
+    readonly aliases: readonly ["Burma", "မြန်မာ", "Myanma"];
+}, {
+    readonly name: "Namibia";
+    readonly alpha2: "NA";
+    readonly alpha3: "NAM";
+    readonly aliases: readonly ["Republic of Namibia"];
+}, {
+    readonly name: "Nauru";
+    readonly alpha2: "NR";
+    readonly alpha3: "NRU";
+    readonly aliases: readonly ["Naoero", "Republic of Nauru"];
+}, {
+    readonly name: "Nepal";
+    readonly alpha2: "NP";
+    readonly alpha3: "NPL";
+    readonly aliases: readonly ["नेपाल", "Federal Democratic Republic of Nepal"];
+}, {
+    readonly name: "Netherlands";
+    readonly alpha2: "NL";
+    readonly alpha3: "NLD";
+    readonly aliases: readonly ["Nederland", "Holland", "Kingdom of the Netherlands"];
+}, {
+    readonly name: "New Caledonia";
+    readonly alpha2: "NC";
+    readonly alpha3: "NCL";
+    readonly aliases: readonly ["Nouvelle-Calédonie"];
+}, {
+    readonly name: "New Zealand";
+    readonly alpha2: "NZ";
+    readonly alpha3: "NZL";
+    readonly aliases: readonly ["Aotearoa"];
+}, {
+    readonly name: "Nicaragua";
+    readonly alpha2: "NI";
+    readonly alpha3: "NIC";
+    readonly aliases: readonly ["República de Nicaragua"];
+}, {
+    readonly name: "Niger";
+    readonly alpha2: "NE";
+    readonly alpha3: "NER";
+    readonly aliases: readonly ["République du Niger"];
+}, {
+    readonly name: "Nigeria";
+    readonly alpha2: "NG";
+    readonly alpha3: "NGA";
+    readonly aliases: readonly ["Federal Republic of Nigeria"];
+}, {
+    readonly name: "Niue";
+    readonly alpha2: "NU";
+    readonly alpha3: "NIU";
+    readonly aliases: readonly [];
+}, {
+    readonly name: "Norfolk Island";
+    readonly alpha2: "NF";
+    readonly alpha3: "NFK";
+    readonly aliases: readonly [];
+}, {
+    readonly name: "North Macedonia";
+    readonly alpha2: "MK";
+    readonly alpha3: "MKD";
+    readonly aliases: readonly ["Republic of North Macedonia", "Северна Македонија"];
+}, {
+    readonly name: "Northern Mariana Islands";
+    readonly alpha2: "MP";
+    readonly alpha3: "MNP";
+    readonly aliases: readonly ["Saipan", "Commonwealth of the Northern Mariana Islands"];
+}, {
+    readonly name: "Norway";
+    readonly alpha2: "NO";
+    readonly alpha3: "NOR";
+    readonly aliases: readonly ["Norge", "Noreg", "Norrige"];
+}, {
+    readonly name: "Oman";
+    readonly alpha2: "OM";
+    readonly alpha3: "OMN";
+    readonly aliases: readonly ["عمان", "Sultanate of Oman"];
+}, {
+    readonly name: "Pakistan";
+    readonly alpha2: "PK";
+    readonly alpha3: "PAK";
+    readonly aliases: readonly ["پاکستان", "Islamic Republic of Pakistan"];
+}, {
+    readonly name: "Palau";
+    readonly alpha2: "PW";
+    readonly alpha3: "PLW";
+    readonly aliases: readonly ["Beluu er a Belau", "Republic of Palau"];
+}, {
+    readonly name: "Palestine";
+    readonly alpha2: "PS";
+    readonly alpha3: "PSE";
+    readonly aliases: readonly ["فلسطين", "State of Palestine"];
+}, {
+    readonly name: "Panama";
+    readonly alpha2: "PA";
+    readonly alpha3: "PAN";
+    readonly aliases: readonly ["República de Panamá"];
+}, {
+    readonly name: "Papua New Guinea";
+    readonly alpha2: "PG";
+    readonly alpha3: "PNG";
+    readonly aliases: readonly ["Papua Niugini"];
+}, {
+    readonly name: "Paraguay";
+    readonly alpha2: "PY";
+    readonly alpha3: "PRY";
+    readonly aliases: readonly ["República del Paraguay"];
+}, {
+    readonly name: "Peru";
+    readonly alpha2: "PE";
+    readonly alpha3: "PER";
+    readonly aliases: readonly ["República del Perú"];
+}, {
+    readonly name: "Philippines";
+    readonly alpha2: "PH";
+    readonly alpha3: "PHL";
+    readonly aliases: readonly ["Pilipinas", "Republika ng Pilipinas"];
+}, {
+    readonly name: "Poland";
+    readonly alpha2: "PL";
+    readonly alpha3: "POL";
+    readonly aliases: readonly ["Polska", "Republic of Poland"];
+}, {
+    readonly name: "Portugal";
+    readonly alpha2: "PT";
+    readonly alpha3: "PRT";
+    readonly aliases: readonly ["República Portuguesa"];
+}, {
+    readonly name: "Puerto Rico";
+    readonly alpha2: "PR";
+    readonly alpha3: "PRI";
+    readonly aliases: readonly [];
+}, {
+    readonly name: "Qatar";
+    readonly alpha2: "QA";
+    readonly alpha3: "QAT";
+    readonly aliases: readonly ["قطر", "State of Qatar"];
+}, {
+    readonly name: "Réunion";
+    readonly alpha2: "RE";
+    readonly alpha3: "REU";
+    readonly aliases: readonly [];
+}, {
+    readonly name: "Romania";
+    readonly alpha2: "RO";
+    readonly alpha3: "ROU";
+    readonly aliases: readonly ["România"];
+}, {
+    readonly name: "Russian Federation";
+    readonly alpha2: "RU";
+    readonly alpha3: "RUS";
+    readonly aliases: readonly ["Russia", "Российская Федерация"];
+}, {
+    readonly name: "Rwanda";
+    readonly alpha2: "RW";
+    readonly alpha3: "RWA";
+    readonly aliases: readonly ["Repubulika y'u Rwanda", "République du Rwanda"];
+}, {
+    readonly name: "Saint Barthélemy";
+    readonly alpha2: "BL";
+    readonly alpha3: "BLM";
+    readonly aliases: readonly ["Saint-Barthélemy"];
+}, {
+    readonly name: "Saint Helena, Ascension and Tristan da Cunha";
+    readonly alpha2: "SH";
+    readonly alpha3: "SHN";
+    readonly aliases: readonly [];
+}, {
+    readonly name: "Saint Kitts and Nevis";
+    readonly alpha2: "KN";
+    readonly alpha3: "KNA";
+    readonly aliases: readonly [];
+}, {
+    readonly name: "Saint Lucia";
+    readonly alpha2: "LC";
+    readonly alpha3: "LCA";
+    readonly aliases: readonly [];
+}, {
+    readonly name: "Saint Martin (French part)";
+    readonly alpha2: "MF";
+    readonly alpha3: "MAF";
+    readonly aliases: readonly [];
+}, {
+    readonly name: "Saint Pierre and Miquelon";
+    readonly alpha2: "PM";
+    readonly alpha3: "SPM";
+    readonly aliases: readonly [];
+}, {
+    readonly name: "Saint Vincent and the Grenadines";
+    readonly alpha2: "VC";
+    readonly alpha3: "VCT";
+    readonly aliases: readonly [];
+}, {
+    readonly name: "Samoa";
+    readonly alpha2: "WS";
+    readonly alpha3: "WSM";
+    readonly aliases: readonly ["Sāmoa", "Independent State of Samoa"];
+}, {
+    readonly name: "San Marino";
+    readonly alpha2: "SM";
+    readonly alpha3: "SMR";
+    readonly aliases: readonly ["Serenissima Repubblica di San Marino"];
+}, {
+    readonly name: "Sao Tome and Principe";
+    readonly alpha2: "ST";
+    readonly alpha3: "STP";
+    readonly aliases: readonly ["São Tomé e Príncipe"];
+}, {
+    readonly name: "Saudi Arabia";
+    readonly alpha2: "SA";
+    readonly alpha3: "SAU";
+    readonly aliases: readonly ["المملكة العربية السعودية", "Kingdom of Saudi Arabia", "KSA"];
+}, {
+    readonly name: "Senegal";
+    readonly alpha2: "SN";
+    readonly alpha3: "SEN";
+    readonly aliases: readonly ["République du Sénégal"];
+}, {
+    readonly name: "Serbia";
+    readonly alpha2: "RS";
+    readonly alpha3: "SRB";
+    readonly aliases: readonly ["Србија", "Srbija", "Republic of Serbia"];
+}, {
+    readonly name: "Seychelles";
+    readonly alpha2: "SC";
+    readonly alpha3: "SYC";
+    readonly aliases: readonly ["Repiblik Sesel", "République des Seychelles"];
+}, {
+    readonly name: "Sierra Leone";
+    readonly alpha2: "SL";
+    readonly alpha3: "SLE";
+    readonly aliases: readonly ["Republic of Sierra Leone"];
+}, {
+    readonly name: "Singapore";
+    readonly alpha2: "SG";
+    readonly alpha3: "SGP";
+    readonly aliases: readonly ["新加坡", "Singapura", "Republic of Singapore"];
+}, {
+    readonly name: "Sint Maarten (Dutch part)";
+    readonly alpha2: "SX";
+    readonly alpha3: "SXM";
+    readonly aliases: readonly [];
+}, {
+    readonly name: "Slovakia";
+    readonly alpha2: "SK";
+    readonly alpha3: "SVK";
+    readonly aliases: readonly ["Slovensko", "Slovak Republic"];
+}, {
+    readonly name: "Slovenia";
+    readonly alpha2: "SI";
+    readonly alpha3: "SVN";
+    readonly aliases: readonly ["Slovenija"];
+}, {
+    readonly name: "Solomon Islands";
+    readonly alpha2: "SB";
+    readonly alpha3: "SLB";
+    readonly aliases: readonly [];
+}, {
+    readonly name: "Somalia";
+    readonly alpha2: "SO";
+    readonly alpha3: "SOM";
+    readonly aliases: readonly ["Soomaaliya", "جمهورية الصومال", "Federal Republic of Somalia"];
+}, {
+    readonly name: "South Africa";
+    readonly alpha2: "ZA";
+    readonly alpha3: "ZAF";
+    readonly aliases: readonly ["RSA", "Republic of South Africa"];
+}, {
+    readonly name: "South Sudan";
+    readonly alpha2: "SS";
+    readonly alpha3: "SSD";
+    readonly aliases: readonly ["Republic of South Sudan"];
+}, {
+    readonly name: "Spain";
+    readonly alpha2: "ES";
+    readonly alpha3: "ESP";
+    readonly aliases: readonly ["España", "Reino de España"];
+}, {
+    readonly name: "Sri Lanka";
+    readonly alpha2: "LK";
+    readonly alpha3: "LKA";
+    readonly aliases: readonly ["ශ්‍රී ලංකාව", "இலங்கை", "Democratic Socialist Republic of Sri Lanka"];
+}, {
+    readonly name: "Sudan";
+    readonly alpha2: "SD";
+    readonly alpha3: "SDN";
+    readonly aliases: readonly ["السودان", "Republic of the Sudan"];
+}, {
+    readonly name: "Suriname";
+    readonly alpha2: "SR";
+    readonly alpha3: "SUR";
+    readonly aliases: readonly ["Republiek Suriname"];
+}, {
+    readonly name: "Svalbard and Jan Mayen";
+    readonly alpha2: "SJ";
+    readonly alpha3: "SJM";
+    readonly aliases: readonly [];
+}, {
+    readonly name: "Sweden";
+    readonly alpha2: "SE";
+    readonly alpha3: "SWE";
+    readonly aliases: readonly ["Sverige", "Kingdom of Sweden"];
+}, {
+    readonly name: "Switzerland";
+    readonly alpha2: "CH";
+    readonly alpha3: "CHE";
+    readonly aliases: readonly ["Schweiz", "Suisse", "Svizzera", "Svizra", "Swiss Confederation"];
+}, {
+    readonly name: "Syrian Arab Republic";
+    readonly alpha2: "SY";
+    readonly alpha3: "SYR";
+    readonly aliases: readonly ["سوريا", "Syria"];
+}, {
+    readonly name: "Taiwan, Province of China";
+    readonly alpha2: "TW";
+    readonly alpha3: "TWN";
+    readonly aliases: readonly ["台灣", "臺灣", "Taiwan", "Republic of China", "ROC"];
+}, {
+    readonly name: "Tajikistan";
+    readonly alpha2: "TJ";
+    readonly alpha3: "TJK";
+    readonly aliases: readonly ["Тоҷикистон", "Republic of Tajikistan"];
+}, {
+    readonly name: "Tanzania, United Republic of";
+    readonly alpha2: "TZ";
+    readonly alpha3: "TZA";
+    readonly aliases: readonly ["Tanzania", "Jamhuri ya Muungano wa Tanzania"];
+}, {
+    readonly name: "Thailand";
+    readonly alpha2: "TH";
+    readonly alpha3: "THA";
+    readonly aliases: readonly ["ประเทศไทย", "Prathet Thai", "Kingdom of Thailand"];
+}, {
+    readonly name: "Timor-Leste";
+    readonly alpha2: "TL";
+    readonly alpha3: "TLS";
+    readonly aliases: readonly ["East Timor", "República Democrática de Timor-Leste"];
+}, {
+    readonly name: "Togo";
+    readonly alpha2: "TG";
+    readonly alpha3: "TGO";
+    readonly aliases: readonly ["République Togolaise"];
+}, {
+    readonly name: "Tokelau";
+    readonly alpha2: "TK";
+    readonly alpha3: "TKL";
+    readonly aliases: readonly [];
+}, {
+    readonly name: "Tonga";
+    readonly alpha2: "TO";
+    readonly alpha3: "TON";
+    readonly aliases: readonly ["Puleʻanga Fakatuʻi ʻo Tonga", "Kingdom of Tonga"];
+}, {
+    readonly name: "Trinidad and Tobago";
+    readonly alpha2: "TT";
+    readonly alpha3: "TTO";
+    readonly aliases: readonly [];
+}, {
+    readonly name: "Tunisia";
+    readonly alpha2: "TN";
+    readonly alpha3: "TUN";
+    readonly aliases: readonly ["تونس", "Republic of Tunisia"];
+}, {
+    readonly name: "Türkiye";
+    readonly alpha2: "TR";
+    readonly alpha3: "TUR";
+    readonly aliases: readonly ["Turkey", "Türkiye Cumhuriyeti", "Republic of Türkiye"];
+}, {
+    readonly name: "Turkmenistan";
+    readonly alpha2: "TM";
+    readonly alpha3: "TKM";
+    readonly aliases: readonly ["Türkmenistan"];
+}, {
+    readonly name: "Turks and Caicos Islands";
+    readonly alpha2: "TC";
+    readonly alpha3: "TCA";
+    readonly aliases: readonly [];
+}, {
+    readonly name: "Tuvalu";
+    readonly alpha2: "TV";
+    readonly alpha3: "TUV";
+    readonly aliases: readonly [];
+}, {
+    readonly name: "Uganda";
+    readonly alpha2: "UG";
+    readonly alpha3: "UGA";
+    readonly aliases: readonly ["Republic of Uganda"];
+}, {
+    readonly name: "Ukraine";
+    readonly alpha2: "UA";
+    readonly alpha3: "UKR";
+    readonly aliases: readonly ["Україна"];
+}, {
+    readonly name: "United Arab Emirates";
+    readonly alpha2: "AE";
+    readonly alpha3: "ARE";
+    readonly aliases: readonly ["الإمارات العربية المتحدة", "UAE"];
+}, {
+    readonly name: "United Kingdom";
+    readonly alpha2: "GB";
+    readonly alpha3: "GBR";
+    readonly aliases: readonly ["United Kingdom", "UK", "Britain", "Great Britain"];
+}, {
+    readonly name: "United States of America";
+    readonly alpha2: "US";
+    readonly alpha3: "USA";
+    readonly aliases: readonly ["United States", "USA", "America", "US"];
+}, {
+    readonly name: "Uruguay";
+    readonly alpha2: "UY";
+    readonly alpha3: "URY";
+    readonly aliases: readonly ["República Oriental del Uruguay"];
+}, {
+    readonly name: "Uzbekistan";
+    readonly alpha2: "UZ";
+    readonly alpha3: "UZB";
+    readonly aliases: readonly ["Oʻzbekiston", "Republic of Uzbekistan"];
+}, {
+    readonly name: "Vanuatu";
+    readonly alpha2: "VU";
+    readonly alpha3: "VUT";
+    readonly aliases: readonly ["Ripablik blong Vanuatu"];
+}, {
+    readonly name: "Venezuela";
+    readonly alpha2: "VE";
+    readonly alpha3: "VEN";
+    readonly aliases: readonly ["Venezuela", "República Bolivariana de Venezuela"];
+}, {
+    readonly name: "Vietnam";
+    readonly alpha2: "VN";
+    readonly alpha3: "VNM";
+    readonly aliases: readonly ["Việt Nam", "Socialist Republic of Vietnam"];
+}, {
+    readonly name: "Virgin Islands (British)";
+    readonly alpha2: "VG";
+    readonly alpha3: "VGB";
+    readonly aliases: readonly ["British Virgin Islands"];
+}, {
+    readonly name: "Virgin Islands (U.S.)";
+    readonly alpha2: "VI";
+    readonly alpha3: "VIR";
+    readonly aliases: readonly ["U.S. Virgin Islands"];
+}, {
+    readonly name: "Wallis and Futuna";
+    readonly alpha2: "WF";
+    readonly alpha3: "WLF";
+    readonly aliases: readonly [];
+}, {
+    readonly name: "Western Sahara";
+    readonly alpha2: "EH";
+    readonly alpha3: "ESH";
+    readonly aliases: readonly ["الصحراء الغربية", "Sahara Occidental"];
+}, {
+    readonly name: "Yemen";
+    readonly alpha2: "YE";
+    readonly alpha3: "YEM";
+    readonly aliases: readonly ["اليمن", "Republic of Yemen"];
+}, {
+    readonly name: "Zambia";
+    readonly alpha2: "ZM";
+    readonly alpha3: "ZMB";
+    readonly aliases: readonly ["Republic of Zambia"];
+}, {
+    readonly name: "Zimbabwe";
+    readonly alpha2: "ZW";
+    readonly alpha3: "ZWE";
+    readonly aliases: readonly ["Republic of Zimbabwe"];
+}];
+
+declare interface CountryOptions {
+    output?: CountryOutput;
+    message?: string;
+}
+
+declare type CountryOutput = 'name' | '2-letter' | '3-letter';
+
+declare type CountryTwoLetterCode = (typeof Countries)[number]['alpha2'];
+
+export declare class CSVImporter<TSchema extends ExType<unknown, ExBaseDef, unknown> = ExRow<ExRowShape>> {
+    private options;
+    private iframe;
+    private container;
+    private connection;
+    private connectionState;
+    private debug;
+    private developerMode;
+    private importIdentifier;
+    private sessionId;
+    private _destroyTimer;
+    private _beforeUnloadHandler;
+    private widgetUrl;
+    private widgetState;
+    private widgetMode;
+    private canRestart;
+    private lastError;
+    private openOptions;
+    private cachedSchemaJson;
+    private initCompletePromise;
+    private resolveInitComplete;
+    constructor(options: SDKOptions<TSchema>);
+    /**
+     * Enhanced state management
+     */
+    private setState;
+    private updateDerivedState;
+    private handleError;
+    private waitForEvent;
+    /**
+     * Open the import flow with chunk-based data processing.
+     * Automatically opens the widget if not already open.
+     *
+     * @param options Configuration including onData callback for processing chunks
+     */
+    open(options: OpenOptions<Infer<TSchema>>): void;
+    /**
+     * Create import session on backend with configuration
+     * Idempotent: safe to call multiple times with same sessionId
+     */
+    private createImportSession;
+    /**
+     * Deliver results to webhook endpoint via backend API
+     * Chunks data using SDK-determined chunk size (independent of customer's chunkSize)
+     */
+    private deliverToWebhook;
+    /**
+     * Send a single chunk to backend webhook API with retry logic
+     */
+    private sendChunkToBackend;
+    /**
+     * Process results in chunks, calling onData and/or webhook for each chunk with backpressure control
+     */
+    private processResultsInChunks;
+    /**
+     * Initialize the iframe and connection.
+     * @param hidden Whether to create the iframe hidden (for preload) or visible (for normal open)
+     */
+    private initializeIframe;
+    private log;
+    private error;
+    /**
+     * Add beforeunload event listener to warn users about losing progress
+     */
+    private addBeforeUnloadListener;
+    /**
+     * Remove beforeunload event listener
+     */
+    private removeBeforeUnloadListener;
+    private waitForIframeLoad;
+    private setupConnectionAndInit;
+    openWidget(options?: {
+        reset?: boolean;
+    }): Promise<void>;
+    /**
+     * Makes a hidden container visible for instant display of preloaded iframe
+     */
+    private makeContainerVisible;
+    private setupMessageHandlers;
+    private createAndAppendIframe;
+    private destroy;
+    close(reason?: 'user_close' | 'cancel' | 'complete' | 'error'): Promise<void>;
+    resetWidget(): Promise<void>;
+    restart(newOptions?: Partial<SDKOptions<TSchema>>): Promise<void>;
+    private handleWidgetClosed;
+    private hideContainer;
+    getConnectionStatus(): boolean;
+    getState(): WidgetState;
+    getMode(): WidgetMode;
+    getIsReady(): boolean;
+    getIsOpen(): boolean;
+    getCanRestart(): boolean;
+    getLastError(): Error | null;
+    getStatus(): {
+        state: WidgetState;
+        mode: WidgetMode;
+        isReady: boolean;
+        isOpen: boolean;
+        canRestart: boolean;
+        hasError: boolean;
+        lastError: Error | null;
+        connectionStatus: boolean;
+    };
+    getVersion(): string;
+}
+
+/**
+ * ISO 4217 Currency Codes
+ *
+ * This file contains the list of all valid currency codes according to ISO 4217 standard.
+ * Each currency has a 3-letter code, a name, and a numeric code.
+ */
+declare type CurrencyCode = (typeof CurrencyCodes)[number]['code'];
+
+declare interface CurrencyCodeOptions {
+    allowedCurrencies?: CurrencyCode[];
+    message?: string;
+}
+
+declare const CurrencyCodes: readonly [{
+    readonly code: "AED";
+    readonly name: "United Arab Emirates dirham";
+    readonly numeric: "784";
+}, {
+    readonly code: "AFN";
+    readonly name: "Afghan afghani";
+    readonly numeric: "971";
+}, {
+    readonly code: "ALL";
+    readonly name: "Albanian lek";
+    readonly numeric: "008";
+}, {
+    readonly code: "AMD";
+    readonly name: "Armenian dram";
+    readonly numeric: "051";
+}, {
+    readonly code: "ANG";
+    readonly name: "Netherlands Antillean guilder";
+    readonly numeric: "532";
+}, {
+    readonly code: "AOA";
+    readonly name: "Angolan kwanza";
+    readonly numeric: "973";
+}, {
+    readonly code: "ARS";
+    readonly name: "Argentine peso";
+    readonly numeric: "032";
+}, {
+    readonly code: "AUD";
+    readonly name: "Australian dollar";
+    readonly numeric: "036";
+}, {
+    readonly code: "AWG";
+    readonly name: "Aruban florin";
+    readonly numeric: "533";
+}, {
+    readonly code: "AZN";
+    readonly name: "Azerbaijani manat";
+    readonly numeric: "944";
+}, {
+    readonly code: "BAM";
+    readonly name: "Bosnia and Herzegovina convertible mark";
+    readonly numeric: "977";
+}, {
+    readonly code: "BBD";
+    readonly name: "Barbados dollar";
+    readonly numeric: "052";
+}, {
+    readonly code: "BDT";
+    readonly name: "Bangladeshi taka";
+    readonly numeric: "050";
+}, {
+    readonly code: "BGN";
+    readonly name: "Bulgarian lev";
+    readonly numeric: "975";
+}, {
+    readonly code: "BHD";
+    readonly name: "Bahraini dinar";
+    readonly numeric: "048";
+}, {
+    readonly code: "BIF";
+    readonly name: "Burundian franc";
+    readonly numeric: "108";
+}, {
+    readonly code: "BMD";
+    readonly name: "Bermudian dollar";
+    readonly numeric: "060";
+}, {
+    readonly code: "BND";
+    readonly name: "Brunei dollar";
+    readonly numeric: "096";
+}, {
+    readonly code: "BOB";
+    readonly name: "Boliviano";
+    readonly numeric: "068";
+}, {
+    readonly code: "BRL";
+    readonly name: "Brazilian real";
+    readonly numeric: "986";
+}, {
+    readonly code: "BSD";
+    readonly name: "Bahamian dollar";
+    readonly numeric: "044";
+}, {
+    readonly code: "BTN";
+    readonly name: "Bhutanese ngultrum";
+    readonly numeric: "064";
+}, {
+    readonly code: "BWP";
+    readonly name: "Botswana pula";
+    readonly numeric: "072";
+}, {
+    readonly code: "BYN";
+    readonly name: "Belarusian ruble";
+    readonly numeric: "933";
+}, {
+    readonly code: "BZD";
+    readonly name: "Belize dollar";
+    readonly numeric: "084";
+}, {
+    readonly code: "CAD";
+    readonly name: "Canadian dollar";
+    readonly numeric: "124";
+}, {
+    readonly code: "CDF";
+    readonly name: "Congolese franc";
+    readonly numeric: "976";
+}, {
+    readonly code: "CHF";
+    readonly name: "Swiss franc";
+    readonly numeric: "756";
+}, {
+    readonly code: "CLP";
+    readonly name: "Chilean peso";
+    readonly numeric: "152";
+}, {
+    readonly code: "CNY";
+    readonly name: "Chinese yuan";
+    readonly numeric: "156";
+}, {
+    readonly code: "COP";
+    readonly name: "Colombian peso";
+    readonly numeric: "170";
+}, {
+    readonly code: "CRC";
+    readonly name: "Costa Rican colon";
+    readonly numeric: "188";
+}, {
+    readonly code: "CUC";
+    readonly name: "Cuban convertible peso";
+    readonly numeric: "931";
+}, {
+    readonly code: "CUP";
+    readonly name: "Cuban peso";
+    readonly numeric: "192";
+}, {
+    readonly code: "CVE";
+    readonly name: "Cape Verdean escudo";
+    readonly numeric: "132";
+}, {
+    readonly code: "CZK";
+    readonly name: "Czech koruna";
+    readonly numeric: "203";
+}, {
+    readonly code: "DJF";
+    readonly name: "Djiboutian franc";
+    readonly numeric: "262";
+}, {
+    readonly code: "DKK";
+    readonly name: "Danish krone";
+    readonly numeric: "208";
+}, {
+    readonly code: "DOP";
+    readonly name: "Dominican peso";
+    readonly numeric: "214";
+}, {
+    readonly code: "DZD";
+    readonly name: "Algerian dinar";
+    readonly numeric: "012";
+}, {
+    readonly code: "EGP";
+    readonly name: "Egyptian pound";
+    readonly numeric: "818";
+}, {
+    readonly code: "ERN";
+    readonly name: "Eritrean nakfa";
+    readonly numeric: "232";
+}, {
+    readonly code: "ETB";
+    readonly name: "Ethiopian birr";
+    readonly numeric: "230";
+}, {
+    readonly code: "EUR";
+    readonly name: "Euro";
+    readonly numeric: "978";
+}, {
+    readonly code: "FJD";
+    readonly name: "Fiji dollar";
+    readonly numeric: "242";
+}, {
+    readonly code: "FKP";
+    readonly name: "Falkland Islands pound";
+    readonly numeric: "238";
+}, {
+    readonly code: "GBP";
+    readonly name: "Pound sterling";
+    readonly numeric: "826";
+}, {
+    readonly code: "GEL";
+    readonly name: "Georgian lari";
+    readonly numeric: "981";
+}, {
+    readonly code: "GHS";
+    readonly name: "Ghanaian cedi";
+    readonly numeric: "936";
+}, {
+    readonly code: "GIP";
+    readonly name: "Gibraltar pound";
+    readonly numeric: "292";
+}, {
+    readonly code: "GMD";
+    readonly name: "Gambian dalasi";
+    readonly numeric: "270";
+}, {
+    readonly code: "GNF";
+    readonly name: "Guinean franc";
+    readonly numeric: "324";
+}, {
+    readonly code: "GTQ";
+    readonly name: "Guatemalan quetzal";
+    readonly numeric: "320";
+}, {
+    readonly code: "GYD";
+    readonly name: "Guyanese dollar";
+    readonly numeric: "328";
+}, {
+    readonly code: "HKD";
+    readonly name: "Hong Kong dollar";
+    readonly numeric: "344";
+}, {
+    readonly code: "HNL";
+    readonly name: "Honduran lempira";
+    readonly numeric: "340";
+}, {
+    readonly code: "HRK";
+    readonly name: "Croatian kuna";
+    readonly numeric: "191";
+}, {
+    readonly code: "HTG";
+    readonly name: "Haitian gourde";
+    readonly numeric: "332";
+}, {
+    readonly code: "HUF";
+    readonly name: "Hungarian forint";
+    readonly numeric: "348";
+}, {
+    readonly code: "IDR";
+    readonly name: "Indonesian rupiah";
+    readonly numeric: "360";
+}, {
+    readonly code: "ILS";
+    readonly name: "Israeli new shekel";
+    readonly numeric: "376";
+}, {
+    readonly code: "INR";
+    readonly name: "Indian rupee";
+    readonly numeric: "356";
+}, {
+    readonly code: "IQD";
+    readonly name: "Iraqi dinar";
+    readonly numeric: "368";
+}, {
+    readonly code: "IRR";
+    readonly name: "Iranian rial";
+    readonly numeric: "364";
+}, {
+    readonly code: "ISK";
+    readonly name: "Icelandic króna";
+    readonly numeric: "352";
+}, {
+    readonly code: "JMD";
+    readonly name: "Jamaican dollar";
+    readonly numeric: "388";
+}, {
+    readonly code: "JOD";
+    readonly name: "Jordanian dinar";
+    readonly numeric: "400";
+}, {
+    readonly code: "JPY";
+    readonly name: "Japanese yen";
+    readonly numeric: "392";
+}, {
+    readonly code: "KES";
+    readonly name: "Kenyan shilling";
+    readonly numeric: "404";
+}, {
+    readonly code: "KGS";
+    readonly name: "Kyrgyzstani som";
+    readonly numeric: "417";
+}, {
+    readonly code: "KHR";
+    readonly name: "Cambodian riel";
+    readonly numeric: "116";
+}, {
+    readonly code: "KMF";
+    readonly name: "Comoro franc";
+    readonly numeric: "174";
+}, {
+    readonly code: "KPW";
+    readonly name: "North Korean won";
+    readonly numeric: "408";
+}, {
+    readonly code: "KRW";
+    readonly name: "South Korean won";
+    readonly numeric: "410";
+}, {
+    readonly code: "KWD";
+    readonly name: "Kuwaiti dinar";
+    readonly numeric: "414";
+}, {
+    readonly code: "KYD";
+    readonly name: "Cayman Islands dollar";
+    readonly numeric: "136";
+}, {
+    readonly code: "KZT";
+    readonly name: "Kazakhstani tenge";
+    readonly numeric: "398";
+}, {
+    readonly code: "LAK";
+    readonly name: "Lao kip";
+    readonly numeric: "418";
+}, {
+    readonly code: "LBP";
+    readonly name: "Lebanese pound";
+    readonly numeric: "422";
+}, {
+    readonly code: "LKR";
+    readonly name: "Sri Lankan rupee";
+    readonly numeric: "144";
+}, {
+    readonly code: "LRD";
+    readonly name: "Liberian dollar";
+    readonly numeric: "430";
+}, {
+    readonly code: "LSL";
+    readonly name: "Lesotho loti";
+    readonly numeric: "426";
+}, {
+    readonly code: "LYD";
+    readonly name: "Libyan dinar";
+    readonly numeric: "434";
+}, {
+    readonly code: "MAD";
+    readonly name: "Moroccan dirham";
+    readonly numeric: "504";
+}, {
+    readonly code: "MDL";
+    readonly name: "Moldovan leu";
+    readonly numeric: "498";
+}, {
+    readonly code: "MGA";
+    readonly name: "Malagasy ariary";
+    readonly numeric: "969";
+}, {
+    readonly code: "MKD";
+    readonly name: "Macedonian denar";
+    readonly numeric: "807";
+}, {
+    readonly code: "MMK";
+    readonly name: "Myanmar kyat";
+    readonly numeric: "104";
+}, {
+    readonly code: "MNT";
+    readonly name: "Mongolian tögrög";
+    readonly numeric: "496";
+}, {
+    readonly code: "MOP";
+    readonly name: "Macanese pataca";
+    readonly numeric: "446";
+}, {
+    readonly code: "MRU";
+    readonly name: "Mauritanian ouguiya";
+    readonly numeric: "929";
+}, {
+    readonly code: "MUR";
+    readonly name: "Mauritian rupee";
+    readonly numeric: "480";
+}, {
+    readonly code: "MVR";
+    readonly name: "Maldivian rufiyaa";
+    readonly numeric: "462";
+}, {
+    readonly code: "MWK";
+    readonly name: "Malawian kwacha";
+    readonly numeric: "454";
+}, {
+    readonly code: "MXN";
+    readonly name: "Mexican peso";
+    readonly numeric: "484";
+}, {
+    readonly code: "MYR";
+    readonly name: "Malaysian ringgit";
+    readonly numeric: "458";
+}, {
+    readonly code: "MZN";
+    readonly name: "Mozambican metical";
+    readonly numeric: "943";
+}, {
+    readonly code: "NAD";
+    readonly name: "Namibian dollar";
+    readonly numeric: "516";
+}, {
+    readonly code: "NGN";
+    readonly name: "Nigerian naira";
+    readonly numeric: "566";
+}, {
+    readonly code: "NIO";
+    readonly name: "Nicaraguan córdoba";
+    readonly numeric: "558";
+}, {
+    readonly code: "NOK";
+    readonly name: "Norwegian krone";
+    readonly numeric: "578";
+}, {
+    readonly code: "NPR";
+    readonly name: "Nepalese rupee";
+    readonly numeric: "524";
+}, {
+    readonly code: "NZD";
+    readonly name: "New Zealand dollar";
+    readonly numeric: "554";
+}, {
+    readonly code: "OMR";
+    readonly name: "Omani rial";
+    readonly numeric: "512";
+}, {
+    readonly code: "PAB";
+    readonly name: "Panamanian balboa";
+    readonly numeric: "590";
+}, {
+    readonly code: "PEN";
+    readonly name: "Peruvian sol";
+    readonly numeric: "604";
+}, {
+    readonly code: "PGK";
+    readonly name: "Papua New Guinean kina";
+    readonly numeric: "598";
+}, {
+    readonly code: "PHP";
+    readonly name: "Philippine peso";
+    readonly numeric: "608";
+}, {
+    readonly code: "PKR";
+    readonly name: "Pakistani rupee";
+    readonly numeric: "586";
+}, {
+    readonly code: "PLN";
+    readonly name: "Polish złoty";
+    readonly numeric: "985";
+}, {
+    readonly code: "PYG";
+    readonly name: "Paraguayan guaraní";
+    readonly numeric: "600";
+}, {
+    readonly code: "QAR";
+    readonly name: "Qatari riyal";
+    readonly numeric: "634";
+}, {
+    readonly code: "RON";
+    readonly name: "Romanian leu";
+    readonly numeric: "946";
+}, {
+    readonly code: "RSD";
+    readonly name: "Serbian dinar";
+    readonly numeric: "941";
+}, {
+    readonly code: "RUB";
+    readonly name: "Russian ruble";
+    readonly numeric: "643";
+}, {
+    readonly code: "RWF";
+    readonly name: "Rwandan franc";
+    readonly numeric: "646";
+}, {
+    readonly code: "SAR";
+    readonly name: "Saudi riyal";
+    readonly numeric: "682";
+}, {
+    readonly code: "SBD";
+    readonly name: "Solomon Islands dollar";
+    readonly numeric: "090";
+}, {
+    readonly code: "SCR";
+    readonly name: "Seychelles rupee";
+    readonly numeric: "690";
+}, {
+    readonly code: "SDG";
+    readonly name: "Sudanese pound";
+    readonly numeric: "938";
+}, {
+    readonly code: "SEK";
+    readonly name: "Swedish krona";
+    readonly numeric: "752";
+}, {
+    readonly code: "SGD";
+    readonly name: "Singapore dollar";
+    readonly numeric: "702";
+}, {
+    readonly code: "SHP";
+    readonly name: "Saint Helena pound";
+    readonly numeric: "654";
+}, {
+    readonly code: "SLL";
+    readonly name: "Sierra Leonean leone";
+    readonly numeric: "694";
+}, {
+    readonly code: "SOS";
+    readonly name: "Somali shilling";
+    readonly numeric: "706";
+}, {
+    readonly code: "SRD";
+    readonly name: "Surinamese dollar";
+    readonly numeric: "968";
+}, {
+    readonly code: "SSP";
+    readonly name: "South Sudanese pound";
+    readonly numeric: "728";
+}, {
+    readonly code: "STN";
+    readonly name: "São Tomé and Príncipe dobra";
+    readonly numeric: "930";
+}, {
+    readonly code: "SVC";
+    readonly name: "Salvadoran colón";
+    readonly numeric: "222";
+}, {
+    readonly code: "SYP";
+    readonly name: "Syrian pound";
+    readonly numeric: "760";
+}, {
+    readonly code: "SZL";
+    readonly name: "Swazi lilangeni";
+    readonly numeric: "748";
+}, {
+    readonly code: "THB";
+    readonly name: "Thai baht";
+    readonly numeric: "764";
+}, {
+    readonly code: "TJS";
+    readonly name: "Tajikistani somoni";
+    readonly numeric: "972";
+}, {
+    readonly code: "TMT";
+    readonly name: "Turkmenistan manat";
+    readonly numeric: "934";
+}, {
+    readonly code: "TND";
+    readonly name: "Tunisian dinar";
+    readonly numeric: "788";
+}, {
+    readonly code: "TOP";
+    readonly name: "Tongan paʻanga";
+    readonly numeric: "776";
+}, {
+    readonly code: "TRY";
+    readonly name: "Turkish lira";
+    readonly numeric: "949";
+}, {
+    readonly code: "TTD";
+    readonly name: "Trinidad and Tobago dollar";
+    readonly numeric: "780";
+}, {
+    readonly code: "TWD";
+    readonly name: "New Taiwan dollar";
+    readonly numeric: "901";
+}, {
+    readonly code: "TZS";
+    readonly name: "Tanzanian shilling";
+    readonly numeric: "834";
+}, {
+    readonly code: "UAH";
+    readonly name: "Ukrainian hryvnia";
+    readonly numeric: "980";
+}, {
+    readonly code: "UGX";
+    readonly name: "Ugandan shilling";
+    readonly numeric: "800";
+}, {
+    readonly code: "USD";
+    readonly name: "United States dollar";
+    readonly numeric: "840";
+}, {
+    readonly code: "UYU";
+    readonly name: "Uruguayan peso";
+    readonly numeric: "858";
+}, {
+    readonly code: "UZS";
+    readonly name: "Uzbekistan som";
+    readonly numeric: "860";
+}, {
+    readonly code: "VES";
+    readonly name: "Venezuelan bolívar soberano";
+    readonly numeric: "928";
+}, {
+    readonly code: "VND";
+    readonly name: "Vietnamese đồng";
+    readonly numeric: "704";
+}, {
+    readonly code: "VUV";
+    readonly name: "Vanuatu vatu";
+    readonly numeric: "548";
+}, {
+    readonly code: "WST";
+    readonly name: "Samoan tala";
+    readonly numeric: "882";
+}, {
+    readonly code: "XAF";
+    readonly name: "CFA franc BEAC";
+    readonly numeric: "950";
+}, {
+    readonly code: "XCD";
+    readonly name: "East Caribbean dollar";
+    readonly numeric: "951";
+}, {
+    readonly code: "XOF";
+    readonly name: "CFA franc BCEAO";
+    readonly numeric: "952";
+}, {
+    readonly code: "XPF";
+    readonly name: "CFP franc";
+    readonly numeric: "953";
+}, {
+    readonly code: "YER";
+    readonly name: "Yemeni rial";
+    readonly numeric: "886";
+}, {
+    readonly code: "ZAR";
+    readonly name: "South African rand";
+    readonly numeric: "710";
+}, {
+    readonly code: "ZMW";
+    readonly name: "Zambian kwacha";
+    readonly numeric: "967";
+}, {
+    readonly code: "ZWL";
+    readonly name: "Zimbabwean dollar";
+    readonly numeric: "932";
+}];
+
+declare interface DatetimeOptions {
+    message?: string;
+}
+
+export declare type DeepPartial<T> = {
+    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
+};
+
+/**
+ * Delivery options - requires at least one of onData or webhook
+ */
+export declare type DeliveryOptions<T> = RequireAtLeastOne<DeliveryOptionsBase<T>, 'onData' | 'webhook'>;
+
+/**
+ * Base delivery options - at least one must be provided
+ */
+declare interface DeliveryOptionsBase<T> {
+    /** Local callback for processing chunks */
+    onData?: (chunk: RecordsChunk<T>, next: () => void) => void | Promise<void>;
+    /** Webhook configuration for remote delivery */
+    webhook?: WebhookConfig;
+}
+
+/**
+ * Font source configuration for custom fonts
+ */
+export declare type ECSVFontSource = {
+    source: 'google';
+    name: string;
+    weights?: (number | string)[];
+} | {
+    source: 'custom';
+    url: string;
+    format?: 'woff2' | 'woff';
+};
+
+/**
+ * Theme - can be either dual-mode (light/dark) or single-mode (applies to both)
+ */
+export declare type ECSVTheme = ECSVThemeWithModes | ECSVThemeSingle;
+
+/**
+ * Single theme that applies to both light and dark modes
+ */
+declare type ECSVThemeSingle = TailwindThemeVars;
+
+/**
+ * Theme with light and dark mode support
+ */
+declare interface ECSVThemeWithModes {
+    modes: {
+        light: TailwindThemeVars;
+        dark: TailwindThemeVars;
+    };
+}
+
+export declare interface ExBaseDef {
+    typeName: string;
+}
+
+/**
+ * Boolean field type that validates true/false values.
+ *
+ * When parsing strings (all comparisons are case-insensitive):
+ * - The following values are considered false:
+ *   "" (empty cell), "0", "off", "n", "no", "false", "disabled"
+ * - Cross characters are considered false: "×", "✗", "✘", "x"
+ * - Check characters are considered true: "✓", "✔", "☑", "✅"
+ * - All other string values are considered true
+ *
+ * When parsing numbers:
+ * - 0 is considered false
+ * - All other numbers are considered true
+ */
+declare class ExBoolean extends PrimitiveExType<boolean, ExBooleanDef> {
+    /**
+     * Factory method to create an ExBoolean validator
+     *
+     * @param options - Configuration options
+     * @param options.control - UI control type to use ('toggle', 'checkbox', 'dropdown')
+     * @param options.message - Optional custom error message for validation failures
+     * @returns A new ExBoolean instance
+     */
+    static create(options?: {
+        control?: BooleanControlType;
+        message?: string;
+    }): ExBoolean;
+    /**
+     * Creates an optional version of this type
+     *
+     * @returns An optional version of this type
+     */
+    optional(): ExOptionalBoolean;
+}
+
+declare interface ExBooleanDef extends PrimitiveExBaseDef {
+    typeName: 'ExBoolean';
+    control?: BooleanControlType;
+    message?: string;
+    checks: ValidatorCheck[];
+}
+
+declare class ExCurrencyNumber extends ExNumberBase<ExCurrencyNumber> {
+    /**
+     * Creates an optional version of this type
+     *
+     * @returns An optional version of this type
+     */
+    optional(): ExOptionalCurrencyNumber;
+    /**
+     * Updates the currency code for this currency number
+     * This allows chaining multiple currency() calls with "last call wins" behavior
+     *
+     * @param currencyCode - ISO 4217 currency code (e.g., 'USD', 'EUR', 'JPY')
+     * @returns The instance for method chaining
+     */
+    currency(currencyCode: CurrencyCode): ExCurrencyNumber;
+}
+
+declare class ExDate extends PrimitiveExType<string, ExDateDef> {
+    /**
+     * Factory method to create an ExDate validator
+     *
+     * @param options - Configuration options
+     * @param options.message - Optional custom error message for validation failures
+     * @returns A new ExDate instance
+     */
+    static create(options?: {
+        message?: string;
+    }): ExDate;
+    /**
+     * Creates an optional version of this type
+     *
+     * @returns An optional version of this type
+     */
+    optional(): ExOptionalDate;
+    /**
+     * Sets a custom output format for the date
+     *
+     * @param template - Format template string for output
+     * @returns The ExDate instance for method chaining
+     */
+    output(template: string): this;
+}
+
+declare interface ExDateDef extends PrimitiveExBaseDef {
+    typeName: 'ExDate';
+    message?: string;
+    outputFormat?: string;
+    internalValue?: {
+        year: number;
+        month: number;
+        day: number;
+    };
+}
+
+declare class ExDatetime extends PrimitiveExType<string, ExDatetimeDef> {
+    /**
+     * Factory method to create an ExDatetime validator
+     *
+     * @param options - Configuration options
+     * @param options.message - Optional custom error message for validation failures
+     * @returns A new ExDatetime instance
+     */
+    static create(options?: DatetimeOptions): ExDatetime;
+    /**
+     * Creates an optional version of this type
+     *
+     * @returns An optional version of this type
+     */
+    optional(): ExOptionalDatetime;
+    /**
+     * Sets a custom output format for the datetime
+     *
+     * @param template - Format template string for output
+     * @returns The ExDatetime instance for method chaining
+     */
+    output(template: string): this;
+    /**
+     * Allows timezone offsets in the datetime string
+     *
+     * @param options - Configuration options
+     * @param options.message - Custom error message for validation failures
+     * @returns The ExDatetime instance for method chaining
+     */
+    allowOffset(options?: {
+        message?: string;
+    }): this;
+    private _getDatetimeCheck;
+}
+
+declare interface ExDatetimeDef extends PrimitiveExBaseDef {
+    typeName: 'ExDatetime';
+    checks: ValidatorCheck[];
+    outputFormat?: string;
+    internalValue?: string;
+}
+
+declare class ExMultiselect<TValue extends string | number = string | number> extends PrimitiveExType<TValue[], ExMultiselectDef<TValue>> {
+    /**
+     * Factory method to create an ExMultiselect validator for multiple selection
+     *
+     * @param options - Array of select options with labels and values
+     * @param config - Configuration options
+     * @param config.enforceCaseSensitiveMatch - Whether to enforce case-sensitive matching
+     * @param config.message - Custom error message for validation failures
+     * @returns A new ExMultiselect instance
+     */
+    static create<const T extends readonly (SelectOption & {
+        value: string | number;
+    })[]>(options: T, config?: MultiselectOptions): ExMultiselect<T[number]['value']>;
+    /**
+     * Creates an optional version of this multiselect type
+     *
+     * @returns An optional version of this multiselect type
+     */
+    optional(): ExOptionalMultiselect<TValue>;
+    /**
+     * Sets case sensitive matching for option values
+     *
+     * @param enabled - Whether to enable case-sensitive matching
+     * @returns The ExMultiselect instance for method chaining
+     */
+    caseSensitive(enabled?: boolean): this;
+    /**
+     * Sets minimum number of selections required
+     *
+     * @param min - Minimum number of selections (must be at least 1)
+     * @param message - Custom error message for minimum validation
+     * @returns The ExMultiselect instance for method chaining
+     */
+    min(min: number, message?: string): this;
+    /**
+     * Sets maximum number of selections allowed
+     *
+     * @param max - Maximum number of selections
+     * @param message - Custom error message for maximum validation
+     * @returns The ExMultiselect instance for method chaining
+     */
+    max(max: number, message?: string): this;
+}
+
+declare interface ExMultiselectDef<TValue extends string | number = string | number> extends PrimitiveExBaseDef {
+    typeName: 'ExMultiselect';
+    options: SelectOption<TValue>[];
+    config: {
+        enforceCaseSensitiveMatch: boolean;
+        allowCustom?: boolean;
+    };
+    checks: ValidatorCheck[];
+    _value?: TValue[];
+    message?: string;
+}
+
+declare class ExNumber extends ExNumberBase<ExNumber> {
+    /**
+     * Factory method to create an ExNumber validator
+     *
+     * @param options - Configuration options
+     * @param options.message - Optional custom error message for validation failures
+     * @returns A new ExNumber instance
+     */
+    static create(options?: {
+        message?: string;
+    }): ExNumber;
+    /**
+     * Creates an optional version of this type
+     *
+     * @returns An optional version of this type
+     */
+    optional(): ExOptionalNumber;
+    /**
+     * Marks the number as a percentage value for presentation purposes.
+     * This flag tells the cell editor to display the number with a percentage symbol.
+     * No input or output transformation is performed - values are stored as-is.
+     *
+     * @returns A specialized percentage number type
+     */
+    percentage(): ExPercentageNumber;
+    /**
+     * Marks the number as a currency value, associating it with a specific currency code
+     * The number will be formatted for the specified currency
+     *
+     * @param currencyCode - ISO 4217 currency code (e.g., 'USD', 'EUR', 'JPY')
+     * @returns A specialized currency number type
+     */
+    currency(currencyCode: CurrencyCode): ExCurrencyNumber;
+}
+
+declare abstract class ExNumberBase<T extends ExNumberBase<T>> extends PrimitiveExType<number, ExNumberDef> {
+    /**
+     * Validates that the number is greater than or equal to the specified minimum value
+     *
+     * @param value - Minimum allowed value
+     * @param options - Configuration options
+     * @param options.message - Custom error message for validation failures
+     * @returns The instance for method chaining
+     */
+    min(value: number, options?: {
+        message?: string;
+    }): this;
+    /**
+     * Validates that the number is less than or equal to the specified maximum value
+     *
+     * @param value - Maximum allowed value
+     * @param options - Configuration options
+     * @param options.message - Custom error message for validation failures
+     * @returns The instance for method chaining
+     */
+    max(value: number, options?: {
+        message?: string;
+    }): this;
+    /**
+     * Validates that the number is an integer (no decimal places)
+     *
+     * @param options - Configuration options
+     * @param options.message - Custom error message for validation failures
+     * @returns The instance for method chaining
+     */
+    integer(options?: {
+        message?: string;
+    }): this;
+    /**
+     * Validates that the number is a multiple of the specified value
+     *
+     * @param value - The number that the validated value must be a multiple of
+     * @param options - Configuration options
+     * @param options.message - Custom error message for validation failures
+     * @returns The instance for method chaining
+     */
+    multipleOf(value: number, options?: {
+        message?: string;
+    }): this;
+}
+
+declare interface ExNumberDef extends PrimitiveExBaseDef {
+    typeName: 'ExNumber';
+    checks: ValidatorCheck[];
+    isPercentage?: boolean;
+    currencyCode?: CurrencyCode;
+}
+
+declare class ExOptional<T extends ExType<unknown, ExBaseDef, unknown>> extends PrimitiveExType<T extends ExType<infer O, ExBaseDef, unknown> ? O | null : never, ExOptionalDef<T>> {
+    /**
+     * Factory method to create an ExOptional wrapper around a type
+     *
+     * @param type - The type to make optional
+     * @param options - Configuration options
+     * @param options.when - Function that determines when the field is allowed to be null/optional
+     * @returns A new ExOptional instance
+     */
+    static create<T extends ExType<unknown, ExBaseDef, unknown>>(type: T, options?: {
+        /**
+         * Function that determines when the field is allowed to be null/optional.
+         *
+         * @param rowData The row data being validated
+         * @returns true if the field can be null, false if the field is required
+         *
+         * For example, if a field should only be required when another field has a specific value:
+         * ```
+         * when: (row) => row.isEmployed === false // Company is optional when not employed
+         * ```
+         */
+        when?: (rowData: Record<string, unknown>) => boolean;
+    }): ExOptional<T>;
+    /**
+     * Unwraps the optional type to get the inner type
+     *
+     * @returns The inner type
+     */
+    unwrap(): T;
+    /**
+     * Creates an optional version of this type (returns self since already optional)
+     *
+     * @returns This instance (self-reference)
+     */
+    optional(): this;
+    /**
+     * Sets a default value to use when the value is null or undefined
+     *
+     * @param defaultValue - The default value or function that returns the default value
+     * @returns The ExOptional instance for method chaining
+     */
+    default<T1 extends T extends ExType<infer O, ExBaseDef, unknown> ? O | null : never>(defaultValue: T1 | (() => T1 | Promise<T1>)): this;
+}
+
+/**
+ * Specialized optional wrapper for boolean fields
+ */
+declare class ExOptionalBoolean extends ExOptional<ExBoolean> {
+}
+
+/**
+ * Specialized optional wrapper for currency number fields
+ */
+declare class ExOptionalCurrencyNumber extends ExOptional<ExCurrencyNumber> {
+    /**
+     * Validates that the number is greater than or equal to the specified minimum value
+     *
+     * @param value - Minimum allowed value
+     * @param options - Configuration options
+     * @param options.message - Custom error message for validation failures
+     * @returns The instance for method chaining
+     */
+    min(value: number, options?: {
+        message?: string;
+    }): this;
+    /**
+     * Validates that the number is less than or equal to the specified maximum value
+     *
+     * @param value - Maximum allowed value
+     * @param options - Configuration options
+     * @param options.message - Custom error message for validation failures
+     * @returns The instance for method chaining
+     */
+    max(value: number, options?: {
+        message?: string;
+    }): this;
+    /**
+     * Validates that the number is an integer (no decimal places)
+     *
+     * @param options - Configuration options
+     * @param options.message - Custom error message for validation failures
+     * @returns The instance for method chaining
+     */
+    integer(options?: {
+        message?: string;
+    }): this;
+    /**
+     * Validates that the number is a multiple of the specified value
+     *
+     * @param value - The number that the validated value must be a multiple of
+     * @param options - Configuration options
+     * @param options.message - Custom error message for validation failures
+     * @returns The instance for method chaining
+     */
+    multipleOf(value: number, options?: {
+        message?: string;
+    }): this;
+    /**
+     * Updates the currency code for this optional currency number
+     * This allows chaining multiple currency() calls with "last call wins" behavior
+     *
+     * @param currencyCode - ISO 4217 currency code (e.g., 'USD', 'EUR', 'JPY')
+     * @returns The instance for method chaining
+     */
+    currency(currencyCode: CurrencyCode): this;
+}
+
+/**
+ * Specialized optional wrapper for date fields
+ */
+declare class ExOptionalDate extends ExOptional<ExDate> {
+    /**
+     * Specifies the output format for the date
+     *
+     * @param template - The format template
+     * @returns The instance for method chaining
+     */
+    output(template: string): this;
+}
+
+/**
+ * Specialized optional wrapper for datetime fields
+ */
+declare class ExOptionalDatetime extends ExOptional<ExDatetime> {
+    /**
+     * Specifies the output format for the datetime
+     *
+     * @param template - The format template
+     * @returns The instance for method chaining
+     */
+    output(template: string): this;
+}
+
+declare interface ExOptionalDef<T extends ExType<unknown, ExBaseDef, unknown>> extends PrimitiveExBaseDef {
+    typeName: 'ExOptional';
+    innerType: T;
+    when?: (rowData: Record<string, unknown>) => boolean;
+    checks?: ValidatorCheck[];
+    outputFormat?: string;
+}
+
+/**
+ * Specialized optional wrapper for multiselect fields
+ */
+declare class ExOptionalMultiselect<TValue extends string | number = string | number> extends ExOptional<ExMultiselect<TValue>> {
+    /**
+     * Specifies whether the multiselect options should be case-sensitive
+     *
+     * @param enabled - Whether case sensitivity is enabled
+     * @returns The instance for method chaining
+     */
+    caseSensitive(enabled?: boolean): this;
+    /**
+     * Sets minimum number of selections required
+     *
+     * @param min - Minimum number of selections
+     * @param message - Custom error message for minimum validation
+     * @returns The instance for method chaining
+     */
+    min(min: number, message?: string): this;
+    /**
+     * Sets maximum number of selections allowed
+     *
+     * @param max - Maximum number of selections
+     * @param message - Custom error message for maximum validation
+     * @returns The instance for method chaining
+     */
+    max(max: number, message?: string): this;
+}
+
+/**
+ * Specialized optional wrapper for number fields
+ */
+declare class ExOptionalNumber extends ExOptional<ExNumber> {
+    /**
+     * Validates that the number is greater than or equal to the specified minimum value
+     *
+     * @param value - Minimum allowed value
+     * @param options - Configuration options
+     * @param options.message - Custom error message for validation failures
+     * @returns The instance for method chaining
+     */
+    min(value: number, options?: {
+        message?: string;
+    }): this;
+    /**
+     * Validates that the number is less than or equal to the specified maximum value
+     *
+     * @param value - Maximum allowed value
+     * @param options - Configuration options
+     * @param options.message - Custom error message for validation failures
+     * @returns The instance for method chaining
+     */
+    max(value: number, options?: {
+        message?: string;
+    }): this;
+    /**
+     * Validates that the number is an integer (no decimal places)
+     *
+     * @param options - Configuration options
+     * @param options.message - Custom error message for validation failures
+     * @returns The instance for method chaining
+     */
+    integer(options?: {
+        message?: string;
+    }): this;
+    /**
+     * Validates that the number is a multiple of the specified value
+     *
+     * @param value - The number that the validated value must be a multiple of
+     * @param options - Configuration options
+     * @param options.message - Custom error message for validation failures
+     * @returns The instance for method chaining
+     */
+    multipleOf(value: number, options?: {
+        message?: string;
+    }): this;
+    /**
+     * Marks the number as a percentage value
+     *
+     * @returns A specialized percentage number type that cannot be combined with currency
+     */
+    percentage(): ExOptionalPercentageNumber;
+    /**
+     * Marks the number as a currency value, associating it with a specific currency code
+     *
+     * @param currencyCode - ISO 4217 currency code (e.g., 'USD', 'EUR', 'JPY')
+     * @returns A specialized currency number type that cannot be combined with percentage
+     */
+    currency(currencyCode: CurrencyCode): ExOptionalCurrencyNumber;
+}
+
+/**
+ * Specialized optional wrapper for percentage number fields
+ */
+declare class ExOptionalPercentageNumber extends ExOptional<ExPercentageNumber> {
+    /**
+     * Validates that the number is greater than or equal to the specified minimum value
+     *
+     * @param value - Minimum allowed value
+     * @param options - Configuration options
+     * @param options.message - Custom error message for validation failures
+     * @returns The instance for method chaining
+     */
+    min(value: number, options?: {
+        message?: string;
+    }): this;
+    /**
+     * Validates that the number is less than or equal to the specified maximum value
+     *
+     * @param value - Maximum allowed value
+     * @param options - Configuration options
+     * @param options.message - Custom error message for validation failures
+     * @returns The instance for method chaining
+     */
+    max(value: number, options?: {
+        message?: string;
+    }): this;
+    /**
+     * Validates that the number is an integer (no decimal places)
+     *
+     * @param options - Configuration options
+     * @param options.message - Custom error message for validation failures
+     * @returns The instance for method chaining
+     */
+    integer(options?: {
+        message?: string;
+    }): this;
+    /**
+     * Validates that the number is a multiple of the specified value
+     *
+     * @param value - The number that the validated value must be a multiple of
+     * @param options - Configuration options
+     * @param options.message - Custom error message for validation failures
+     * @returns The instance for method chaining
+     */
+    multipleOf(value: number, options?: {
+        message?: string;
+    }): this;
+}
+
+declare type ExOptionalPrimitiveType = ExOptionalString | ExOptionalNumber | ExOptionalCurrencyNumber | ExOptionalPercentageNumber | ExOptionalBoolean | ExOptionalDate | ExOptionalDatetime | ExOptionalTime | ExOptionalSelect<string | number> | ExOptionalMultiselect<string | number>;
+
+/**
+ * Specialized optional wrapper for select fields
+ */
+declare class ExOptionalSelect<TValue extends string | number = string | number> extends ExOptional<ExSelect<TValue>> {
+    /**
+     * Specifies whether the select options should be case-sensitive
+     *
+     * @param enabled - Whether case sensitivity is enabled
+     * @returns The instance for method chaining
+     */
+    caseSensitive(enabled?: boolean): this;
+}
+
+declare class ExOptionalString extends ExOptional<ExString> {
+    /**
+     * Validates that the string is a valid UUID
+     *
+     * @param options - Configuration options
+     * @param options.version - The specific UUID version to validate against
+     * @param options.message - Custom error message for validation failures
+     * @returns The instance for method chaining
+     */
+    uuid(options?: {
+        version?: UUIDVersion;
+        message?: string;
+    }): this;
+    /**
+     * Validates that the string is a valid IP address
+     *
+     * @param options - Configuration options
+     * @param options.version - Specific IP version to validate against
+     * @param options.message - Custom error message for validation failures
+     * @returns The instance for method chaining
+     */
+    ip(options?: {
+        version?: IPAddressVersion;
+        message?: string;
+    }): this;
+    /**
+     * Validates that the string is a valid URL
+     *
+     * @param options - Configuration options
+     * @returns The instance for method chaining
+     */
+    url(options?: URLOptions): this;
+    /**
+     * Validates that the string is a valid email address
+     *
+     * @param options - Configuration options
+     * @param options.message - Custom error message for validation failures
+     * @returns The instance for method chaining
+     */
+    email(options?: {
+        message?: string;
+    }): this;
+    /**
+     * Validates that the string is a valid phone number
+     *
+     * @param options - Configuration options
+     * @returns The instance for method chaining
+     */
+    phone(options?: PhoneOptions): this;
+    /**
+     * Validates that the string is a valid country code
+     *
+     * @param options - Configuration options
+     * @returns The instance for method chaining
+     */
+    country(options?: CountryOptions): this;
+    /**
+     * Validates that the string does not exceed the specified maximum length
+     *
+     * @param maxLength - Maximum allowed length
+     * @param options - Configuration options
+     * @param options.message - Custom error message for validation failures
+     * @returns The instance for method chaining
+     */
+    max(maxLength: number, options?: {
+        message?: string;
+    }): this;
+    /**
+     * Validates that the string meets or exceeds the specified minimum length
+     *
+     * @param minLength - Minimum allowed length
+     * @param options - Configuration options
+     * @param options.message - Custom error message for validation failures
+     * @returns The instance for method chaining
+     */
+    min(minLength: number, options?: {
+        message?: string;
+    }): this;
+    /**
+     * Validates that the string is exactly the specified length
+     *
+     * @param exactLength - Exact required length
+     * @param options - Configuration options
+     * @param options.message - Custom error message for validation failures
+     * @returns The instance for method chaining
+     */
+    length(exactLength: number, options?: {
+        message?: string;
+    }): this;
+    /**
+     * Validates that the string includes the specified substring
+     *
+     * @param substring - The substring that must be included
+     * @param options - Configuration options
+     * @param options.message - Custom error message for validation failures
+     * @returns The instance for method chaining
+     */
+    includes(substring: string, options?: {
+        message?: string;
+    }): this;
+    /**
+     * Validates that the string starts with the specified prefix
+     *
+     * @param prefix - The required starting prefix
+     * @param options - Configuration options
+     * @param options.message - Custom error message for validation failures
+     * @returns The instance for method chaining
+     */
+    startsWith(prefix: string, options?: {
+        message?: string;
+    }): this;
+    /**
+     * Validates that the string ends with the specified suffix
+     *
+     * @param suffix - The required ending suffix
+     * @param options - Configuration options
+     * @param options.message - Custom error message for validation failures
+     * @returns The instance for method chaining
+     */
+    endsWith(suffix: string, options?: {
+        message?: string;
+    }): this;
+    /**
+     * Validates that the string matches the specified regular expression pattern
+     *
+     * @param pattern - The regex pattern to match against
+     * @param options - Configuration options
+     * @param options.message - Custom error message for validation failures
+     * @returns The instance for method chaining
+     */
+    regex(pattern: RegExp, options?: {
+        message?: string;
+    }): this;
+    /**
+     * Validates that the string contains only alphabetical characters
+     *
+     * @param options - Configuration options
+     * @param options.message - Custom error message for validation failures
+     * @returns The instance for method chaining
+     */
+    alphabetical(options?: {
+        message?: string;
+    }): this;
+    /**
+     * Validates that the string contains only alphanumerical characters
+     *
+     * @param options - Configuration options
+     * @param options.message - Custom error message for validation failures
+     * @returns The instance for method chaining
+     */
+    alphanumerical(options?: {
+        message?: string;
+    }): this;
+    /**
+     * Validates that the string contains only numerical characters
+     *
+     * @param options - Configuration options
+     * @param options.message - Custom error message for validation failures
+     * @returns The instance for method chaining
+     */
+    numerical(options?: {
+        message?: string;
+    }): this;
+    /**
+     * Validates that the string is a valid IBAN (International Bank Account Number)
+     *
+     * @param options - Configuration options
+     * @returns The instance for method chaining
+     */
+    iban(options?: IbanOptions): this;
+    /**
+     * Validates that the string is a valid BIC (Bank Identifier Code)
+     *
+     * @param options - Configuration options
+     * @returns The instance for method chaining
+     */
+    bic(options?: BICOptions): this;
+    /**
+     * Validates that the string is a valid GTIN (Global Trade Item Number)
+     *
+     * @param options - Configuration options
+     * @returns The instance for method chaining
+     */
+    gtin(options?: GTINOptions): this;
+    /**
+     * Validates that the string is a valid currency code
+     *
+     * @param options - Configuration options
+     * @returns The instance for method chaining
+     */
+    currencyCode(options?: CurrencyCodeOptions): this;
+}
+
+/**
+ * Specialized optional wrapper for time fields
+ */
+declare class ExOptionalTime extends ExOptional<ExTime> {
+    /**
+     * Specifies the decimal precision for the time field
+     *
+     * @param precision - The number of decimal places
+     * @param options - Configuration options
+     * @param options.message - Custom error message for validation failures
+     * @returns The instance for method chaining
+     */
+    precision(precision: number, options?: {
+        message?: string;
+    }): this;
+}
+
+declare class ExPercentageNumber extends ExNumberBase<ExPercentageNumber> {
+    /**
+     * Creates an optional version of this type
+     *
+     * @returns An optional version of this type
+     */
+    optional(): ExOptionalPercentageNumber;
+}
+
+declare interface ExpressCSVLocale {
+    general: {
+        cancel: string;
+        back: string;
+        next: string;
+        finish: string;
+        required: string;
+        optional: string;
+        matched: string;
+        unmatched: string;
+        custom: string;
+    };
+    widget: {
+        title: string;
+        loading: string;
+        closeConfirmTitle: string;
+        closeConfirmDescription: string;
+        closeConfirmCancel: string;
+        closeConfirmContinue: string;
+        errorTitle: string;
+        startOver: string;
+    };
+    sessionRecovery: {
+        message: string;
+        discard: string;
+        resume: string;
+    };
+    dropzone: {
+        ariaLabel: string;
+        clearAriaLabel: string;
+        clearTooltip: string;
+        clearConfirmTitle: string;
+        clearConfirmDescription: string;
+        processing: string;
+        restoredSession: string;
+        prompt: string;
+        or: string;
+        browse: string;
+    };
+    upload: {
+        expectedColumns: string;
+        templatePrompt: string;
+        templateCSV: string;
+        templateXLSX: string;
+        templateGenerating: string;
+        /** Available: {format} */
+        templateDownloadFormat: TemplateString<'format'>;
+        templateDownload: string;
+    };
+    selectSheet: {
+        title: string;
+        subtitle: string;
+        noWorksheets: string;
+        preview: string;
+        /** Available: {count} */
+        columnCount: TemplateString<'count'>;
+        /** Available: {count} */
+        rowCount: TemplateString<'count'>;
+        /** Available: {name} */
+        inSheet: TemplateString<'name'>;
+        sheetSelected: string;
+        noColumns: string;
+        needsMoreRows: string;
+    };
+    selectHeader: {
+        loading: string;
+        noData: string;
+        noDataDescription: string;
+        title: string;
+        subtitle: string;
+        validHeader: string;
+        /** Available: {count} */
+        emptyColumns: TemplateString<'count'>;
+        allColumnsEmpty: string;
+        emptyColumnsTooltip: string;
+        /** Available: {displayed}, {total} */
+        showingRows: TemplateString<'displayed' | 'total'>;
+        showAll: string;
+        moveUp: string;
+        moveDown: string;
+    };
+    matchColumns: {
+        loading: string;
+        autoMatching: string;
+        title: string;
+        subtitle: string;
+        csvColumnHeader: string;
+        matchFieldHeader: string;
+        selectFieldPlaceholder: string;
+        searchFieldsPlaceholder: string;
+        noFieldsFound: string;
+        unmatchAll: string;
+        unmatchAllConfirmTitle: string;
+        unmatchAllConfirmDescription: string;
+        allRequiredMatched: string;
+        /** Available: {count} */
+        matchingConflicts: TemplateString<'count'>;
+        validationIssuesFound: string;
+        goToNextConflict: string;
+        /** Available: {count} */
+        unmatchedRequiredFields: TemplateString<'count'>;
+        requiredFieldsNotMatched: string;
+        goToUnmatchedFields: string;
+        /** Available: {count} */
+        validationIssues: TemplateString<'count'>;
+        goToNextIssue: string;
+        addEmptyColumnsForRequired: string;
+        /** Available: {fieldName} */
+        createEmptyColumn: TemplateString<'fieldName'>;
+        requiredFieldsNotAssigned: string;
+        addEmptyColumnTooltip: string;
+        previewTooltip: string;
+        /** Available: {rowCount}, {columnName} */
+        previewShowing: TemplateString<'rowCount' | 'columnName'>;
+    };
+    matchOptions: {
+        loading: string;
+        title: string;
+        subtitle: string;
+        csvValueHeader: string;
+        matchOptionHeader: string;
+        selectOptionPlaceholder: string;
+        searchOptionsPlaceholder: string;
+        noOptionsFound: string;
+        optionalBadge: string;
+        customValuesHint: string;
+        /** Available: {count}, {remaining} */
+        showMore: TemplateString<'count' | 'remaining'>;
+        /** Available: {value} */
+        useCustomValue: TemplateString<'value'>;
+        allValuesMatched: string;
+        /** Available: {count} */
+        unmatchedValues: TemplateString<'count'>;
+        unmatchedValuesFound: string;
+        goToNextUnmatched: string;
+        /** Available: {count} */
+        valueCount: TemplateString<'count'>;
+    };
+    review: {
+        completing: string;
+        loading: string;
+        title: string;
+        subtitle: string;
+        validating: string;
+        noRecords: string;
+        validatingCells: string;
+        /** Available: {count} */
+        allRecordsValid: TemplateString<'count'>;
+        /** Available: {count} */
+        recordCount: TemplateString<'count'>;
+        filterAll: string;
+        filterValid: string;
+        filterInvalid: string;
+        clearFilters: string;
+        noInvalidRows: string;
+        applyAutofix: string;
+        invalidValue: string;
+        undo: string;
+        redo: string;
+        /** Available: {count} */
+        autofixCount: TemplateString<'count'>;
+        /** Available: {count} */
+        applyAllAutofixes: TemplateString<'count'>;
+        /** Available: {description}, {count} */
+        autofixItem: TemplateString<'description' | 'count'>;
+        filter: string;
+        actions: string;
+        addRecord: string;
+        /** Available: {count} */
+        deleteSelectedRecords: TemplateString<'count'>;
+        /** Available: {count} */
+        exportSelectedRecords: TemplateString<'count'>;
+        /** Available: {count} */
+        exportFilteredRecords: TemplateString<'count'>;
+        /** Available: {count} */
+        exportAllRecords: TemplateString<'count'>;
+        exportCSV: string;
+        exportXLSX: string;
+        sortAZ: string;
+        sortZA: string;
+        sortLowHigh: string;
+        sortHighLow: string;
+        sortOldestNewest: string;
+        sortNewestOldest: string;
+        sortEarlyLate: string;
+        sortLateEarly: string;
+        sortFalseTrue: string;
+        sortTrueFalse: string;
+        sortAscending: string;
+        sortDescending: string;
+        removeSort: string;
+        unpinColumn: string;
+        pinColumn: string;
+        clearColumn: string;
+        /** Available: {description} */
+        columnAutofix: TemplateString<'description'>;
+        applyAllColumnAutofixes: string;
+        removeFilter: string;
+        columnMenu: string;
+        emptyDataTitle: string;
+        emptyDataDescription: string;
+        editFilter: string;
+        filteredColumns: string;
+        unfilteredColumns: string;
+        columnsLabel: string;
+        transformTooltip: string;
+        transformTitle: string;
+        transformClose: string;
+        transformCloseDiscardTooltip: string;
+        transformCloseTooltip: string;
+        transformError: string;
+        transformPlaceholder: string;
+        transformGenerating: string;
+        transformApplying: string;
+        transformDiscard: string;
+        transformApply: string;
+        transformUnappliedTitle: string;
+        transformUnappliedDescription: string;
+        transformKeepEditing: string;
+        transformDiscardClose: string;
+        transformAbortTitle: string;
+        transformAbortDescription: string;
+        transformAbortClose: string;
+        transformSubmit: string;
+    };
+    phantomColumn: {
+        /** Available: {number} */
+        defaultName: TemplateString<'number'>;
+        remove: string;
+        removeTooltip: string;
+    };
+    validation: {
+        showOtherMatch: string;
+    };
+    steps: {
+        upload: string;
+        selectSheet: string;
+        selectHeader: string;
+        matchColumns: string;
+        matchOptions: string;
+        review: string;
+        /** Available: {currentStep}, {totalSteps} */
+        progress: TemplateString<'currentStep' | 'totalSteps'>;
+    };
+}
+
+/** User-facing locale type where every leaf is a plain `string`. */
+export declare type ExpressCSVLocaleInput = StripBrand<ExpressCSVLocale>;
+
+/**
+ * Core step identifiers for the CSV import wizard
+ */
+export declare type ExpressCSVStep = 'upload' | 'select-sheet' | 'select-header' | 'match-columns' | 'match-options' | 'review';
+
+declare type ExPrimitiveType = ExString | ExNumber | ExCurrencyNumber | ExPercentageNumber | ExBoolean | ExDate | ExTime | ExDatetime | ExSelect<string | number> | ExMultiselect<string | number> | ExOptionalPrimitiveType;
+
+declare class ExRow<T extends ExRowShape> extends ExType<{
+    [K in keyof T]: T[K] extends ExType<infer O, ExBaseDef, unknown> ? K extends string ? T['optionalColumnConfig'] extends {
+        columns: Array<infer C>;
+    } ? C extends K ? O | null : O : O : O : never;
+}, ExRowDef<T>> {
+    /**
+     * Factory method to create an ExRow validator for a row of data
+     *
+     * @param shape - Object defining the structure of fields in the row
+     * @returns A new ExRow instance
+     */
+    static create<T extends ExRowShape>(shape: T): ExRow<T>;
+    /**
+     * Specifies columns that can be null/optional with conditional logic
+     *
+     * @param columns - Array of column keys to make optional
+     * @param options - Configuration options
+     * @param options.when - Optional function to determine when columns should be optional
+     * @returns The ExRow instance with optional columns configuration
+     */
+    optionalColumns<K extends keyof T>(columns: K[], options?: {
+        when?: (row: {
+            [P in keyof T]: T[P] extends ExType<infer O, ExBaseDef, unknown> ? O : never;
+        }) => boolean | Promise<boolean>;
+    }): ExRowWithOptionalColumns<T, K>;
+    /**
+     * Specifies unique constraints on columns in the row
+     *
+     * @param columns - Array of column keys or a single column key that form the unique constraint
+     * @param options - Configuration options
+     * @param options.key - Optional function to generate a unique key from column values
+     * @returns The ExRow instance for method chaining
+     */
+    unique<K extends keyof T>(columns: K[] | K, options?: {
+        key?: (values: {
+            [P in K]: T[P] extends ExType<infer O, ExBaseDef, unknown> ? O | null : never;
+        }) => string | Promise<string>;
+    }): this;
+    /**
+     * Adds metadata to the row definition
+     *
+     * @param metadata - Metadata object
+     * @param metadata.description - Optional description of the row
+     * @returns The ExRow instance for method chaining
+     */
+    meta(metadata: {
+        description?: string;
+    }): this;
+    /**
+     * Sets the minimum number of rows required
+     *
+     * @param count - Minimum number of rows (must be a non-negative integer)
+     * @returns The ExRow instance for method chaining
+     */
+    minRows(count: number): this;
+    /**
+     * Sets the maximum number of rows allowed
+     *
+     * @param count - Maximum number of rows (must be a positive integer)
+     * @returns The ExRow instance for method chaining
+     */
+    maxRows(count: number): this;
+}
+
+declare interface ExRowDef<T extends ExRowShape> extends ExBaseDef {
+    typeName: 'ExRow';
+    shape: T;
+    meta?: {
+        description?: string;
+    };
+    rowCountConfig?: {
+        minRows?: number;
+        maxRows?: number;
+    };
+    optionalColumnConfig?: {
+        columns: Array<keyof T>;
+        when?: (row: {
+            [K in keyof T]: T[K] extends ExType<infer O, ExBaseDef, unknown> ? O : never;
+        }) => boolean | Promise<boolean>;
+        whenMap?: Record<string, (row: {
+            [K in keyof T]: T[K] extends ExType<infer O, ExBaseDef, unknown> ? O : never;
+        }) => boolean | Promise<boolean>>;
+    };
+    uniqueColumnConfig?: {
+        uniqueConstraints: Array<{
+            id: string;
+            columns: Array<keyof T>;
+            key?: (values: {
+                [K in keyof T]: T[K] extends ExType<infer O, ExBaseDef, unknown> ? O | null : never;
+            }) => string | Promise<string>;
+        }>;
+    };
+}
+
+declare type ExRowShape = Record<string, ExPrimitiveType>;
+
+declare type ExRowWithOptionalColumns<T extends ExRowShape, K extends keyof T> = ExType<{
+    [P in keyof T]: P extends K ? T[P] extends ExType<infer O, ExBaseDef, unknown> ? O | null : never : T[P] extends ExType<infer O, ExBaseDef, unknown> ? O : never;
+}, ExRowDef<T>> & {
+    optionalColumns<J extends keyof T>(columns: J[], options?: {
+        when?: (row: {
+            [P in keyof T]: T[P] extends ExType<infer O, ExBaseDef, unknown> ? O : never;
+        }) => boolean | Promise<boolean>;
+    }): ExRowWithOptionalColumns<T, J | K>;
+    unique<J extends keyof T>(columns: J[] | J, options?: {
+        key?: (values: {
+            [P in J]: T[P] extends ExType<infer O, ExBaseDef, unknown> ? O | null : never;
+        }) => string | Promise<string>;
+    }): ExRowWithOptionalColumns<T, K>;
+    meta(metadata: {
+        description?: string;
+    }): ExRowWithOptionalColumns<T, K>;
+    minRows(count: number): ExRowWithOptionalColumns<T, K>;
+    maxRows(count: number): ExRowWithOptionalColumns<T, K>;
+};
+
+declare class ExSelect<TValue extends string | number = string | number> extends PrimitiveExType<TValue, ExSelectDef<TValue>> {
+    /**
+     * Factory method to create an ExSelect validator for single selection
+     *
+     * @param options - Array of select options with labels and values
+     * @param config - Configuration options
+     * @param config.enforceCaseSensitiveMatch - Whether to enforce case-sensitive matching
+     * @param config.allowCustom - When true, allows custom values not in the options list
+     * @param config.message - Custom error message for validation failures
+     * @returns A new ExSelect instance
+     */
+    static create<const T extends readonly (SelectOption & {
+        value: string | number;
+    })[], TAllowCustom extends boolean = false>(options: T, config?: SelectOptions & {
+        allowCustom?: TAllowCustom;
+    }): TAllowCustom extends true ? ExSelect<string | number> : ExSelect<T[number]['value']>;
+    /**
+     * Creates an optional version of this select type
+     *
+     * @returns An optional version of this select type
+     */
+    optional(): ExOptionalSelect<TValue>;
+    /**
+     * Sets case sensitive matching for option values
+     *
+     * @param enabled - Whether to enable case-sensitive matching
+     * @returns The ExSelect instance for method chaining
+     */
+    caseSensitive(enabled?: boolean): this;
+}
+
+declare interface ExSelectDef<TValue extends string | number = string | number> extends PrimitiveExBaseDef {
+    typeName: 'ExSelect';
+    options: SelectOption<TValue>[];
+    config: {
+        enforceCaseSensitiveMatch: boolean;
+        allowCustom?: boolean;
+    };
+    checks: ValidatorCheck[];
+    _value?: TValue;
+    message?: string;
+}
+
+declare class ExString extends PrimitiveExType<string, ExStringDef> {
+    /**
+     * Factory method to create an ExString validator
+     *
+     * @param options - Configuration options
+     * @param options.message - Optional custom error message for validation failures
+     * @returns A new ExString instance
+     */
+    static create(options?: {
+        message?: string;
+    }): ExString;
+    /**
+     * Creates an optional version of this type
+     *
+     * @returns An optional version of this type
+     */
+    optional(): ExOptionalString;
+    /**
+     * Validates that the string is a valid UUID
+     *
+     * @param options - Configuration options
+     * @param options.version - UUID version to validate against ('v1', 'v4', 'v5', 'all')
+     * @param options.message - Custom error message for validation failures
+     * @returns The ExString instance for method chaining
+     */
+    uuid(options?: {
+        version?: UUIDVersion;
+        message?: string;
+    }): this;
+    /**
+     * Validates that the string is a valid IP address
+     *
+     * @param options - Configuration options
+     * @param options.version - IP version to validate against ('v4', 'v6', 'all')
+     * @param options.message - Custom error message for validation failures
+     * @returns The ExString instance for method chaining
+     */
+    ip(options?: {
+        version?: IPAddressVersion;
+        message?: string;
+    }): this;
+    /**
+     * Validates that the string is a valid URL
+     *
+     * @param options - Configuration options for URL validation
+     * @param options.allowedProtocols - List of allowed protocols
+     * @param options.allowedDomains - List of allowed domains
+     * @param options.allowSubdomains - Whether to allow subdomains
+     * @param options.allowPaths - Whether to allow paths
+     * @param options.allowQueryParams - Whether to allow query parameters
+     * @param options.message - Custom error message
+     * @returns The ExString instance for method chaining
+     */
+    url(options?: URLOptions): this;
+    /**
+     * Validates that the string is a valid email address
+     *
+     * @param options - Configuration options
+     * @param options.message - Custom error message for validation failures
+     * @returns The ExString instance for method chaining
+     */
+    email(options?: {
+        message?: string;
+    }): this;
+    /**
+     * Validates that the string is a valid phone number
+     *
+     * @param options - Configuration options for phone validation
+     * @param options.allowedCountries - Array of ISO 3166-1 alpha-2 country codes (e.g., ["US", "FR"])
+     * @param options.format - The expected input format ("international", "national", or "both")
+     * @param options.output - How the phone number should be normalized ("e164", "formatted", or "digits")
+     * @param options.message - Custom error message
+     * @returns The ExString instance for method chaining
+     */
+    phone(options?: PhoneOptions): this;
+    /**
+     * Validates that the string represents a valid country
+     *
+     * @param options - Configuration options for country validation
+     * @param options.output - The format to output the country ("name", "2-letter", or "3-letter")
+     * @param options.message - Custom error message
+     * @returns The ExString instance for method chaining
+     */
+    country(options?: CountryOptions): this;
+    /**
+     * Validates that the string length is at most maxLength
+     *
+     * @param maxLength - Maximum allowed length
+     * @param options - Configuration options
+     * @param options.message - Custom error message for validation failures
+     * @returns The ExString instance for method chaining
+     */
+    max(maxLength: number, options?: {
+        message?: string;
+    }): this;
+    /**
+     * Validates that the string length is at least minLength
+     *
+     * @param minLength - Minimum allowed length
+     * @param options - Configuration options
+     * @param options.message - Custom error message for validation failures
+     * @returns The ExString instance for method chaining
+     */
+    min(minLength: number, options?: {
+        message?: string;
+    }): this;
+    /**
+     * Validates that the string has exactly the specified length
+     *
+     * @param exactLength - Required exact length
+     * @param options - Configuration options
+     * @param options.message - Custom error message for validation failures
+     * @returns The ExString instance for method chaining
+     */
+    length(exactLength: number, options?: {
+        message?: string;
+    }): this;
+    /**
+     * Validates that the string includes the specified substring
+     *
+     * @param substring - Substring that must be included
+     * @param options - Configuration options
+     * @param options.message - Custom error message for validation failures
+     * @returns The ExString instance for method chaining
+     */
+    includes(substring: string, options?: {
+        message?: string;
+    }): this;
+    /**
+     * Validates that the string starts with the specified prefix
+     *
+     * @param prefix - Required starting prefix
+     * @param options - Configuration options
+     * @param options.message - Custom error message for validation failures
+     * @returns The ExString instance for method chaining
+     */
+    startsWith(prefix: string, options?: {
+        message?: string;
+    }): this;
+    /**
+     * Validates that the string ends with the specified suffix
+     *
+     * @param suffix - Required ending suffix
+     * @param options - Configuration options
+     * @param options.message - Custom error message for validation failures
+     * @returns The ExString instance for method chaining
+     */
+    endsWith(suffix: string, options?: {
+        message?: string;
+    }): this;
+    /**
+     * Validates that the string matches the specified regular expression
+     *
+     * @param pattern - Regular expression pattern to match
+     * @param options - Configuration options
+     * @param options.message - Custom error message for validation failures
+     * @returns The ExString instance for method chaining
+     */
+    regex(pattern: RegExp, options?: {
+        message?: string;
+    }): this;
+    /**
+     * Validates that the string contains only alphabetical characters
+     *
+     * @param options - Configuration options
+     * @param options.message - Custom error message for validation failures
+     * @returns The ExString instance for method chaining
+     */
+    alphabetical(options?: {
+        message?: string;
+    }): this;
+    /**
+     * Validates that the string contains only alphanumeric characters
+     *
+     * @param options - Configuration options
+     * @param options.message - Custom error message for validation failures
+     * @returns The ExString instance for method chaining
+     */
+    alphanumerical(options?: {
+        message?: string;
+    }): this;
+    /**
+     * Validates that the string represents a numeric value
+     *
+     * @param options - Configuration options
+     * @param options.message - Custom error message for validation failures
+     * @returns The ExString instance for method chaining
+     */
+    numerical(options?: {
+        message?: string;
+    }): this;
+    /**
+     * Validates that the string is a valid IBAN (International Bank Account Number)
+     *
+     * @param options - Configuration options for IBAN validation
+     * @param options.allowedCountries - Array of country codes to restrict validation to (e.g., ["DE", "FR"])
+     * @param options.message - Custom error message
+     * @returns The ExString instance for method chaining
+     */
+    iban(options?: IbanOptions): this;
+    /**
+     * Validates that the string is a valid BIC/SWIFT code
+     *
+     * @param options - Configuration options for BIC validation
+     * @param options.message - Custom error message
+     * @returns The ExString instance for method chaining
+     */
+    bic(options?: BICOptions): this;
+    /**
+     * Validates that the string is a valid GTIN (Global Trade Item Number)
+     * Supports GTIN-8, GTIN-12, GTIN-13, or GTIN-14 formats
+     *
+     * @param options - Configuration options for GTIN validation
+     * @param options.message - Custom error message
+     * @returns The ExString instance for method chaining
+     */
+    gtin(options?: GTINOptions): this;
+    /**
+     * Validates that the string is a valid ISO 4217 currency code
+     *
+     * @param options - Configuration options for currency code validation
+     * @param options.allowedCurrencies - Array of specific currency codes to limit validation to
+     * @param options.message - Custom error message
+     * @returns The ExString instance for method chaining
+     */
+    currencyCode(options?: CurrencyCodeOptions): this;
+}
+
+declare interface ExStringDef extends PrimitiveExBaseDef {
+    typeName: 'ExString';
+    checks: ValidatorCheck[];
+}
+
+declare class ExTime extends PrimitiveExType<string, ExTimeDef> {
+    /**
+     * Factory method to create an ExTime validator
+     *
+     * @param options - Configuration options
+     * @param options.message - Optional custom error message for validation failures
+     * @returns A new ExTime instance
+     */
+    static create(options?: TimeOptions): ExTime;
+    /**
+     * Creates an optional version of this type
+     *
+     * @returns An optional version of this type
+     */
+    optional(): ExOptionalTime;
+    /**
+     * Sets precision for milliseconds in the time
+     *
+     * @param precision - Number of millisecond decimal places
+     * @param options - Configuration options
+     * @param options.message - Custom error message for validation failures
+     * @returns The ExTime instance for method chaining
+     */
+    precision(precision: number, options?: {
+        message?: string;
+    }): this;
+}
+
+declare interface ExTimeDef extends PrimitiveExBaseDef {
+    typeName: 'ExTime';
+    precision?: number | null;
+    message?: string;
+    checks: ValidatorCheck[];
+}
+
+export declare abstract class ExType<Output, Def extends ExBaseDef, Input = Output> {
+    _def: Def;
+    _output: Output;
+    _input: Input;
+    /**
+     * Creates a new ExType instance
+     *
+     * @param def - Definition object for this type
+     */
+    constructor(def: Def);
+    /**
+     * Protected method to create a validation check
+     *
+     * @param type - Type of check
+     * @param params - Parameters for the check
+     * @param message - Optional error message
+     * @returns A ValidatorCheck object
+     */
+    protected _addCheck(type: string, params?: Record<string, unknown>, message?: string): ValidatorCheck;
+}
+
+declare interface GTINOptions {
+    message?: string;
+}
+
+declare interface IbanOptions {
+    allowedCountries?: CountryTwoLetterCode[];
+    message?: string;
+}
+
+/**
+ * Error thrown when the user cancels the import operation
+ */
+export declare class ImportCancelledError extends Error {
+    constructor(message?: string);
+}
+
+export declare type Infer<T extends ExType<unknown, ExBaseDef, unknown>> = T extends ExType<infer Output, ExBaseDef, unknown> ? Output : never;
+
+export declare type InferCSVImporter<TSchema extends ExType<unknown, ExBaseDef, unknown>> = CSVImporter<TSchema>;
+
+declare type IPAddressVersion = 'v4' | 'v6' | 'all';
+
+declare interface MultiselectOptions {
+    enforceCaseSensitiveMatch?: boolean;
+    message?: string;
+}
+
+/**
+ * Options for the open() method
+ * Requires at least one of onData or webhook for delivery
+ */
+export declare type OpenOptions<T> = RequireAtLeastOne<DeliveryOptionsBase<T>, 'onData' | 'webhook'> & {
+    /** Number of records per chunk (default: 1000) */
+    chunkSize?: number;
+    /** Called when all chunks have been processed */
+    onComplete?: () => void;
+    /** Called when the user cancels the import */
+    onCancel?: () => void;
+    /** Called when an error occurs */
+    onError?: (error: Error) => void;
+    /** Called when the widget opens */
+    onWidgetOpen?: () => void;
+    /** Called when the step changes in the wizard */
+    onStepChange?: (stepId: ExpressCSVStep, previousStepId?: ExpressCSVStep) => void;
+    /** Called when the widget closes */
+    onWidgetClose?: (reason: 'user_close' | 'cancel' | 'complete' | 'error') => void;
+};
+
+declare type PhoneNumberFormat = 'international' | 'national' | 'both';
+
+declare type PhoneNumberOutput = 'e164' | 'formatted' | 'digits';
+
+declare interface PhoneOptions {
+    allowedCountries?: CountryTwoLetterCode[];
+    format?: PhoneNumberFormat;
+    output?: PhoneNumberOutput;
+    message?: string;
+}
+
+declare interface PrimitiveExBaseDef extends ExBaseDef {
+    columnNameAliases?: string[];
+    description?: string;
+    label?: string;
+    example?: string;
+    message?: string;
+    checks?: ValidatorCheck[];
+    defaultValue?: unknown | (() => unknown);
+}
+
+declare abstract class PrimitiveExType<Output, Def extends PrimitiveExBaseDef, Input = Output> extends ExType<Output, Def, Input> {
+    /**
+     * Sets column name aliases for this field
+     *
+     * @param aliases - Array of alternative column names that can map to this field
+     * @returns The type instance for method chaining
+     */
+    columnNameAliases(aliases: string[]): this;
+    /**
+     * Sets a description for this field
+     *
+     * @param text - Description text
+     * @returns The type instance for method chaining
+     */
+    description(text: string): this;
+    /**
+     * Sets a display label for this field
+     *
+     * @param text - Label text
+     * @returns The type instance for method chaining
+     */
+    label(text: string): this;
+    /**
+     * Sets an example value for this field
+     *
+     * @param text - Example text
+     * @returns The type instance for method chaining
+     */
+    example(text: string): this;
+    /**
+     * Adds a custom refinement validator to this field.
+     *
+     * Supports two calling styles:
+     * 1. Boolean validator with optional params:
+     *    `.refine((value) => value > 0, { message: 'Must be positive' })`
+     * 2. Object-returning validator (like refineBatch for a single value):
+     *    `.refine((value) => ({ valid: value > 0, message: 'Must be positive', suggestedFix: {...} }))`
+     *
+     * @param validator - Function or RegExp that validates the data
+     * @param params - Additional parameters or function that returns parameters (only for boolean validators)
+     * @returns The type instance for method chaining
+     */
+    refine<T extends Output>(validator: ((data: NonNullable<T>) => RefineResultItem | Promise<RefineResultItem> | unknown | Promise<unknown>) | RegExp, params?: RefineParams | ((data: NonNullable<T>) => RefineParams)): this;
+    /**
+     * Adds a batch refinement validator that validates all column values at once
+     *
+     * @param validator - Function that receives all values and returns validation results, or RegExp for per-value validation
+     * @param params - Additional parameters including fallback error message
+     * @returns The type instance for method chaining
+     */
+    refineBatch<T extends Output>(validator: ((data: NonNullable<T>[]) => RefineBatchResultItem[] | Promise<RefineBatchResultItem[]>) | RegExp, params?: RefineParams): this;
+    /**
+     * Protected method to find an existing check by type
+     *
+     * @param type - Type of check to find
+     * @returns Object with the check, its index, and whether it was found
+     */
+    protected _findExistingCheck(type: string): {
+        check: ValidatorCheck | undefined;
+        index: number;
+        found: boolean;
+    };
+    /**
+     * Protected method to replace an existing check or add a new one
+     *
+     * @param check - The check to add or replace with
+     * @param existingIndex - Index of existing check, or -1 if none exists
+     */
+    protected _replaceOrAddCheck(check: ValidatorCheck, existingIndex: number): void;
+}
+
+declare type Protocol = 'http' | 'https' | 'ftp' | 'sftp' | 'file' | 'mailto' | 'tel';
+
+/**
+ * A chunk of records passed to the onData callback
+ */
+export declare interface RecordsChunk<T> {
+    /** The records in this chunk */
+    records: T[];
+    /** Total number of chunks */
+    totalChunks: number;
+    /** Current chunk index (0-based) */
+    currentChunkIndex: number;
+    /** Total number of records across all chunks */
+    totalRecords: number;
+}
+
+declare type RefineBatchResultItem = {
+    valid: boolean;
+    message?: string;
+    suggestedFix?: {
+        id: string;
+        value: unknown;
+        description: string;
+    };
+};
+
+declare type RefineParams = {
+    message?: string;
+    suggestedFix?: {
+        id: string;
+        value: unknown;
+        description: string;
+    };
+};
+
+declare type RefineResultItem = {
+    valid: boolean;
+    message?: string;
+    suggestedFix?: {
+        id: string;
+        value: unknown;
+        description: string;
+    };
+};
+
+/**
+ * Type helper that requires at least one of the specified keys to be present
+ */
+declare type RequireAtLeastOne<T, Keys extends keyof T = keyof T> = Pick<T, Exclude<keyof T, Keys>> & {
+    [K in Keys]-?: Required<Pick<T, K>> & Partial<Pick<T, Exclude<Keys, K>>>;
+}[Keys];
+
+export declare interface SDKOptions<TSchema extends ExType<unknown, ExBaseDef, unknown>> {
+    schema: TSchema;
+    publishableKey: string;
+    importIdentifier: string;
+    title?: string;
+    debug?: boolean;
+    developerMode?: boolean;
+    preload?: boolean;
+    theme?: ECSVTheme;
+    colorMode?: ColorModeConfig;
+    customCSS?: string;
+    fonts?: Record<string, ECSVFontSource>;
+    stepDisplay?: 'progressBar' | 'segmented' | 'numbered';
+    previewSchemaBeforeUpload?: boolean;
+    templateDownload?: TemplateDownloadConfig;
+    saveSession?: boolean;
+    locale?: DeepPartial<ExpressCSVLocaleInput>;
+}
+
+declare interface SelectOption<TValue extends string | number = string | number> {
+    label: string;
+    value: TValue;
+    alsoMatches?: (string | RegExp)[];
+}
+
+declare interface SelectOptions {
+    enforceCaseSensitiveMatch?: boolean;
+    allowCustom?: boolean;
+    message?: string;
+}
+
+declare type StripBrand<T> = {
+    [K in keyof T]: T[K] extends TemplateString<string> ? string : T[K] extends object ? StripBrand<T[K]> : T[K];
+};
+
+/**
+ * Tailwind CSS variables for theming
+ * These variables override :root values in globals.css when scoped to .ecsv
+ */
+export declare interface TailwindThemeVars {
+    radius?: string;
+    background?: string;
+    foreground?: string;
+    card?: string;
+    'card-foreground'?: string;
+    popover?: string;
+    'popover-foreground'?: string;
+    primary?: string;
+    'primary-foreground'?: string;
+    secondary?: string;
+    'secondary-foreground'?: string;
+    muted?: string;
+    'muted-foreground'?: string;
+    accent?: string;
+    'accent-foreground'?: string;
+    destructive?: string;
+    'destructive-foreground'?: string;
+    success?: string;
+    'success-foreground'?: string;
+    warning?: string;
+    'warning-foreground'?: string;
+    border?: string;
+    input?: string;
+    ring?: string;
+    'font-title'?: string;
+    'font-body'?: string;
+}
+
+/**
+ * Configuration for template download in the upload step.
+ * When `source` is `"generate"`, a header-only template file is created
+ * client-side from the schema column names.
+ */
+declare interface TemplateDownloadConfig {
+    source: 'generate';
+    formats?: TemplateDownloadFormat[];
+}
+
+/**
+ * Template download format
+ */
+declare type TemplateDownloadFormat = 'csv' | 'xlsx';
+
+/**
+ * A branded string type for locale entries that require interpolation via `{variable}` syntax.
+ * Widget code cannot render a `TemplateString` directly in JSX — it must go through the `t()` function.
+ * The generic `TVars` encodes the expected variable names so `t()` enforces the correct vars argument.
+ */
+declare type TemplateString<TVars extends string = string> = string & {
+    readonly __brand: 'TemplateString';
+    readonly __vars: TVars;
+};
+
+/**
+ * Time validation options
+ */
+declare interface TimeOptions {
+    message?: string;
+}
+
+declare interface URLOptions {
+    allowedProtocols?: Protocol[];
+    allowedDomains?: string[];
+    allowSubdomains?: boolean;
+    allowPaths?: boolean;
+    allowQueryParams?: boolean;
+    message?: string;
+}
+
+declare type UUIDVersion = 'v1' | 'v4' | 'v5' | 'all';
+
+declare interface ValidatorCheck {
+    type: string;
+    params?: Record<string, unknown>;
+    message?: string;
+}
+
+/**
+ * Webhook configuration for remote delivery of results
+ */
+export declare interface WebhookConfig {
+    /** The URL to send webhook requests to */
+    url: string;
+    /** Optional HTTP headers to include in the request */
+    headers?: Record<string, string>;
+    /** HTTP method to use (default: 'POST') */
+    method?: 'POST' | 'PUT' | 'PATCH';
+    /** Request timeout in milliseconds (default: 30000) */
+    timeout?: number;
+    /** Number of retry attempts on failure (default: 0) */
+    retries?: number;
+    /** Arbitrary developer-provided metadata */
+    metadata?: Record<string, unknown>;
+}
+
+/**
+ * Widget mode enumeration
+ */
+export declare enum WidgetMode {
+    NORMAL = "normal",
+    PRELOAD = "preload"
+}
+
+/**
+ * Widget state enumeration for consistent state management
+ */
+export declare enum WidgetState {
+    UNINITIALIZED = "uninitialized",
+    INITIALIZING = "initializing",
+    READY = "ready",
+    OPENING = "opening",
+    OPEN = "open",
+    CLOSING = "closing",
+    RESETTING = "resetting",
+    ERROR = "error",
+    DESTROYED = "destroyed"
+}
+
+export declare const x: {
+    string: typeof ExString.create;
+    number: typeof ExNumber.create;
+    boolean: typeof ExBoolean.create;
+    date: typeof ExDate.create;
+    time: typeof ExTime.create;
+    datetime: typeof ExDatetime.create;
+    row: typeof ExRow.create;
+    select: typeof ExSelect.create;
+    multiselect: typeof ExMultiselect.create;
+    infer: <T extends ExType<unknown, ExBaseDef, unknown>>(_schema: T) => Infer<T>;
+};
+
+export { }