@basis-theory/web-elements 2.11.2 → 3.0.0-beta.3

package/dist/web-elements/src/BasisTheory.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @basis-theory/web-elements
+ * Main SDK factory function
+ */
+import type { BasisTheorySDK, SDKOptions } from './types';
+/**
+ * Queued command from loader
+ * Commands are queued before SDK loads, then replayed
+ */
+interface QueuedCommand {
+    method: 'createElement' | 'tokenize' | 'updateThemeMode';
+    args: any[];
+    resolve: (result: any) => void;
+    reject: (error: Error) => void;
+}
+/**
+ * Creates a BasisTheory SDK instance
+ * Factory function (no class, pure functional approach)
+ *
+ * @param apiKey - Your Basis Theory public API key (starts with 'pk_')
+ * @param options - SDK configuration options
+ * @param queuedCommands - Optional: Commands queued by loader before SDK loaded
+ * @returns SDK instance with methods to create and tokenize elements
+ *
+ * @example
+ * ```typescript
+ * import BasisTheory from '@basis-theory/web-elements';
+ *
+ * const bt = BasisTheory('pk_test_YOUR_API_KEY');
+ *
+ * const cardNumber = bt.createElement('cardNumber', {
+ *   placeholder: '4111 1111 1111 1111'
+ * });
+ *
+ * await cardNumber.mount('#card-number');
+ * ```
+ */
+declare const BasisTheory: (apiKey: string, options?: SDKOptions, queuedCommands?: QueuedCommand[]) => BasisTheorySDK;
+declare global {
+    interface Window {
+        BasisTheory?: typeof BasisTheory;
+    }
+}
+export default BasisTheory;
+export { BasisTheory };
+export type { BasisTheorySDK, CardElement, ChangeEventDetail, Element, ElementOptions, ElementType, ErrorEventDetail, EventListener, EventType, ReadyEventDetail, SDKOptions, TokenizeInput, TokenizeResult, } from './types';
+//# sourceMappingURL=BasisTheory.d.ts.map

package/dist/web-elements/src/BasisTheory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BasisTheory.d.ts","sourceRoot":"","sources":["../../../src/BasisTheory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAiBH,OAAO,KAAK,EACV,cAAc,EAOd,UAAU,EAQX,MAAM,SAAS,CAAC;AAMjB;;;GAGG;AACH,UAAU,aAAa;IACrB,MAAM,EAAE,eAAe,GAAG,UAAU,GAAG,iBAAiB,CAAC;IACzD,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,OAAO,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,IAAI,CAAC;IAC/B,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,QAAA,MAAM,WAAW,GACf,QAAQ,MAAM,EACd,UAAS,UAAe,EACxB,iBAAiB,aAAa,EAAE,KAC/B,cAi2BF,CAAC;AAMF,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,WAAW,CAAC,EAAE,OAAO,WAAW,CAAC;KAClC;CACF;AAgBD,eAAe,WAAW,CAAC;AAG3B,OAAO,EAAE,WAAW,EAAE,CAAC;AAGvB,YAAY,EACV,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,OAAO,EACP,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,cAAc,GACf,MAAM,SAAS,CAAC"}

package/dist/web-elements/src/basis-theory.d.ts

@@ -0,0 +1,62 @@
+/**
+ * BasisTheory SDK Loader
+ *
+ * Ultra-minimal loader that:
+ * 1. Attaches to window.BasisTheory immediately (<10ms)
+ * 2. Queues API calls until the full SDK loads
+ * 3. Asynchronously loads the full SDK
+ * 4. Replays queued commands when SDK is ready
+ *
+ * Target Size: 2-4 KB minified+gzipped
+ */
+type QueuedCommand = {
+    type: 'init';
+    apiKey: string;
+    options?: any;
+    timestamp: number;
+} | {
+    type: 'createElement';
+    args: any[];
+    timestamp: number;
+} | {
+    type: 'tokenize';
+    args: any[];
+    timestamp: number;
+} | {
+    type: 'updateThemeMode';
+    args: any[];
+    timestamp: number;
+};
+type LoaderAPI = {
+    createElement: (...args: any[]) => any;
+    tokenize: (...args: any[]) => Promise<any>;
+    updateThemeMode: (...args: any[]) => void;
+    tokens: {
+        create: (...args: any[]) => Promise<any>;
+        retrieve: (...args: any[]) => Promise<any>;
+        update: (...args: any[]) => Promise<any>;
+        encrypt: (...args: any[]) => Promise<any>;
+    };
+    tokenIntents: {
+        create: (...args: any[]) => Promise<any>;
+        get: (...args: any[]) => Promise<any>;
+    };
+    sessions: {
+        create: (...args: any[]) => Promise<any>;
+    };
+    __queue?: QueuedCommand[];
+    __loaderVersion?: string;
+};
+/**
+ * Loader Factory
+ * Creates the minimal facade that gets attached to window.BasisTheory
+ */
+export declare function createLoader(config: {
+    sdkUrl: string;
+    version?: string;
+    onSdkReady?: () => void;
+    debug?: boolean;
+    sdkSriHash?: string;
+}): (apiKey: string, options?: any) => LoaderAPI;
+export {};
+//# sourceMappingURL=basis-theory.d.ts.map

package/dist/web-elements/src/basis-theory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"basis-theory.d.ts","sourceRoot":"","sources":["../../../src/basis-theory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,KAAK,aAAa,GACd;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,GAAG,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAClE;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,IAAI,EAAE,GAAG,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,GAAG,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,IAAI,EAAE,GAAG,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhE,KAAK,SAAS,GAAG;IACf,aAAa,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;IACvC,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3C,eAAe,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IAC1C,MAAM,EAAE;QACN,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;QACzC,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;QAC3C,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;QACzC,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;KAC3C,CAAC;IACF,YAAY,EAAE;QACZ,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;QACzC,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;KACvC,CAAC;IACF,QAAQ,EAAE;QACR,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;KAC1C,CAAC;IAEF,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,KAAK,SAAS,CA+Z/C"}

package/dist/web-elements/src/elements/create-card-number.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Card Number Element Factory
+ */
+import type { Element, ElementOptions, SDKConfig } from '../types';
+/**
+ * Factory function to create a card number element
+ * No class, pure functional approach with closure-based state
+ *
+ * PERFORMANCE OPTIMIZATION (Step 3):
+ * Now receives LAZY coordinator initializer - mount() calls it when needed
+ */
+export declare const createCardNumberElement: (apiKey: string, sdkConfig: SDKConfig, options: ElementOptions | undefined, coordinatorElementId: string, // Unique ID (now generated locally)
+ensureCoordinatorReady: () => Promise<void>) => Element;
+//# sourceMappingURL=create-card-number.d.ts.map

package/dist/web-elements/src/elements/create-card-number.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-card-number.d.ts","sourceRoot":"","sources":["../../../../src/elements/create-card-number.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EACV,OAAO,EAEP,cAAc,EAGd,SAAS,EACV,MAAM,UAAU,CAAC;AAIlB;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,GAClC,QAAQ,MAAM,EACd,WAAW,SAAS,EACpB,SAAS,cAAc,YAAK,EAC5B,sBAAsB,MAAM,EAAE,oCAAoC;AAClE,wBAAwB,MAAM,OAAO,CAAC,IAAI,CAAC,KAC1C,OAgSF,CAAC"}

package/dist/web-elements/src/elements/create-card.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Card Element Factory (Unified)
+ */
+import type { CardElement, SDKConfig } from '../types';
+/**
+ * Card element options
+ */
+export interface CardElementOptions {
+    /** CSS styling */
+    style?: Record<string, any>;
+    /** Placeholder text for each sub-field */
+    placeholder?: {
+        cardNumber?: string;
+        expiryDate?: string;
+        cvc?: string;
+    };
+    /** Accessibility label */
+    ariaLabel?: string;
+    /** Disabled state (applies to all 3 sub-fields) */
+    disabled?: boolean;
+    /** Read-only state (applies to all 3 sub-fields) */
+    readOnly?: boolean;
+    /** Layout mode */
+    layout?: 'row' | 'column' | 'auto';
+    /** Stack threshold in pixels (only applies when layout: 'auto') */
+    stackAt?: number;
+    /** Icon position */
+    iconPosition?: 'left' | 'right' | 'none';
+    /** Restrict accepted card brands */
+    cardBrands?: string[];
+}
+/**
+ * Factory function to create a unified card element
+ * No class, pure functional approach with closure-based state
+ */
+export declare const createCardElement: (apiKey: string, sdkConfig: SDKConfig, options: CardElementOptions | undefined, coordinatorElementId: string, ensureCoordinatorReady: () => Promise<void>) => CardElement;
+//# sourceMappingURL=create-card.d.ts.map

package/dist/web-elements/src/elements/create-card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-card.d.ts","sourceRoot":"","sources":["../../../../src/elements/create-card.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EACV,WAAW,EAKX,SAAS,EAEV,MAAM,UAAU,CAAC;AAUlB;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE5B,0CAA0C;IAC1C,WAAW,CAAC,EAAE;QACZ,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;IAEF,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,kBAAkB;IAClB,MAAM,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAEnC,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,oBAAoB;IACpB,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IAEzC,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,MAAM,EACd,WAAW,SAAS,EACpB,SAAS,kBAAkB,YAAK,EAChC,sBAAsB,MAAM,EAC5B,wBAAwB,MAAM,OAAO,CAAC,IAAI,CAAC,KAC1C,WAiTF,CAAC"}

package/dist/web-elements/src/elements/create-cvv.d.ts

@@ -0,0 +1,10 @@
+/**
+ * CVV Element Factory
+ */
+import type { Element, ElementOptions, SDKConfig } from '../types';
+/**
+ * Factory function to create a CVV element
+ */
+export declare const createCVVElement: (apiKey: string, sdkConfig: SDKConfig, options: ElementOptions | undefined, coordinatorElementId: string, // Unique ID (now generated locally)
+ensureCoordinatorReady: () => Promise<void>) => Element;
+//# sourceMappingURL=create-cvv.d.ts.map

package/dist/web-elements/src/elements/create-cvv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-cvv.d.ts","sourceRoot":"","sources":["../../../../src/elements/create-cvv.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EACV,OAAO,EAEP,cAAc,EAGd,SAAS,EACV,MAAM,UAAU,CAAC;AAIlB;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,MAAM,EACd,WAAW,SAAS,EACpB,SAAS,cAAc,YAAK,EAC5B,sBAAsB,MAAM,EAAE,oCAAoC;AAClE,wBAAwB,MAAM,OAAO,CAAC,IAAI,CAAC,KAC1C,OA8QF,CAAC"}

package/dist/web-elements/src/elements/create-expiry.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Expiry Date Element Factory
+ */
+import type { Element, ElementOptions, SDKConfig } from '../types';
+/**
+ * Factory function to create an expiry date element
+ */
+export declare const createExpiryElement: (apiKey: string, sdkConfig: SDKConfig, options: ElementOptions | undefined, coordinatorElementId: string, // Unique ID (now generated locally)
+ensureCoordinatorReady: () => Promise<void>) => Element;
+//# sourceMappingURL=create-expiry.d.ts.map

package/dist/web-elements/src/elements/create-expiry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-expiry.d.ts","sourceRoot":"","sources":["../../../../src/elements/create-expiry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EACV,OAAO,EAEP,cAAc,EAGd,SAAS,EACV,MAAM,UAAU,CAAC;AAIlB;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAC9B,QAAQ,MAAM,EACd,WAAW,SAAS,EACpB,SAAS,cAAc,YAAK,EAC5B,sBAAsB,MAAM,EAAE,oCAAoC;AAClE,wBAAwB,MAAM,OAAO,CAAC,IAAI,CAAC,KAC1C,OA0QF,CAAC"}

package/dist/web-elements/src/elements/create-text.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Text Element Factory
+ *
+ * General-purpose text input with optional validation and masking
+ * Follows same pattern as CVV/Expiry elements
+ */
+import type { Element, ElementOptions, SDKConfig } from '../types';
+/**
+ * Factory function to create a text element
+ */
+export declare const createTextElement: (apiKey: string, sdkConfig: SDKConfig, options: ElementOptions | undefined, coordinatorElementId: string, // Unique ID (now generated locally)
+ensureCoordinatorReady: () => Promise<void>) => Element;
+//# sourceMappingURL=create-text.d.ts.map

package/dist/web-elements/src/elements/create-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-text.d.ts","sourceRoot":"","sources":["../../../../src/elements/create-text.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EACV,OAAO,EAEP,cAAc,EAGd,SAAS,EACV,MAAM,UAAU,CAAC;AAIlB;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,MAAM,EACd,WAAW,SAAS,EACpB,SAAS,cAAc,YAAK,EAC5B,sBAAsB,MAAM,EAAE,oCAAoC;AAClE,wBAAwB,MAAM,OAAO,CAAC,IAAI,CAAC,KAC1C,OA8TF,CAAC"}

package/dist/web-elements/src/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @basis-theory/web-elements
+ * Secure, PCI-compliant SDK for creating payment input elements
+ *
+ * @example ESM (bundlers)
+ * ```typescript
+ * import BasisTheory from '@basis-theory/web-elements';
+ *
+ * const bt = BasisTheory('pk_test_YOUR_API_KEY');
+ * const cardNumber = bt.createElement('cardNumber');
+ * await cardNumber.mount('#card-number');
+ * ```
+ *
+ * @example UMD (script tags)
+ * ```html
+ * <script src="https://cdn.basistheory.com/elements/index.umd.js"></script>
+ * <script>
+ *   const bt = window.BasisTheory('pk_test_YOUR_API_KEY');
+ *   const cardNumber = bt.createElement('cardNumber');
+ *   cardNumber.mount('#card-number');
+ * </script>
+ * ```
+ */
+export { default } from './BasisTheory';
+export { version, buildDate } from './version';
+export type { BaseEventDetail, BasisTheorySDK, BlurEventDetail, CardElement, CardElementChangeEventDetail, CardElementOptions, CardNumberChangeEventDetail, ChangeEventDetail, Element, ElementInputArray, ElementInputObject, ElementLeaf, ElementOptions, ElementType, EncryptedToken, EncryptToken, ErrorCode, ErrorEventDetail, EventListener, EventType, FocusEventDetail, ReadyEventDetail, SDKOptions, Session, SubElementRef, TokenCreateRequest, TokenIntent, TokenIntentRequest, TokenizeInput, TokenizeResult, TokenUpdateRequest, ValidationError, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/web-elements/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAS/C,YAAY,EACV,eAAe,EACf,cAAc,EACd,eAAe,EACf,WAAW,EACX,4BAA4B,EAC5B,kBAAkB,EAClB,2BAA2B,EAC3B,iBAAiB,EACjB,OAAO,EACP,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACX,cAAc,EACd,WAAW,EACX,cAAc,EACd,YAAY,EACZ,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,OAAO,EACP,aAAa,EACb,kBAAkB,EAClB,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,eAAe,GAChB,MAAM,SAAS,CAAC"}

package/dist/web-elements/src/mounter/create-mounter.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Element Mounter Factory
+ * Handles DOM mounting/unmounting of iframes
+ */
+import type { ElementMounter } from '../types';
+/**
+ * Factory function to create an element mounter
+ * Handles DOM mounting/unmounting of iframes
+ */
+export declare const createMounter: () => ElementMounter;
+//# sourceMappingURL=create-mounter.d.ts.map

package/dist/web-elements/src/mounter/create-mounter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-mounter.d.ts","sourceRoot":"","sources":["../../../../src/mounter/create-mounter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,UAAU,CAAC;AAE5D;;;GAGG;AACH,eAAO,MAAM,aAAa,QAAO,cAkChC,CAAC"}

package/dist/web-elements/src/theme/default-theme.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Default Theme
+ * Provides sensible defaults for all theme tokens
+ */
+import type { ThemeTokens } from '../types/theme';
+/**
+ * Default light theme
+ * Inspired by Tailwind CSS color system + Inter font
+ */
+export declare const DEFAULT_THEME: ThemeTokens;
+/**
+ * Default dark theme
+ * Optimized for dark mode with high contrast
+ */
+export declare const DEFAULT_DARK_THEME: ThemeTokens;
+/**
+ * Merge user theme with default theme
+ * User values take precedence, missing values use defaults
+ * Handles nested color groups (text, background, border)
+ */
+export declare const mergeWithDefaultTheme: (userTheme?: Partial<ThemeTokens>) => ThemeTokens;
+//# sourceMappingURL=default-theme.d.ts.map

package/dist/web-elements/src/theme/default-theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-theme.d.ts","sourceRoot":"","sources":["../../../../src/theme/default-theme.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,WA8E3B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,WA6EhC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAChC,YAAY,OAAO,CAAC,WAAW,CAAC,KAC/B,WAmDF,CAAC"}

package/dist/web-elements/src/theme/inject-theme-dark.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Dark Theme Support Utilities
+ * Generates theme CSS with light/dark mode support via prefers-color-scheme
+ */
+import type { ThemeMode, ThemeTokens } from '../types/theme';
+/**
+ * Generate complete CSS with light and dark theme support
+ * @param lightTheme - Theme for light mode
+ * @param darkTheme - Theme for dark mode (optional, uses adjusted light theme if not provided)
+ * @param themeMode - 'light', 'dark', or 'auto' (uses prefers-color-scheme)
+ */
+export declare const generateThemeCSS: (lightTheme?: ThemeTokens, darkTheme?: ThemeTokens, themeMode?: ThemeMode) => string;
+//# sourceMappingURL=inject-theme-dark.d.ts.map

package/dist/web-elements/src/theme/inject-theme-dark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-theme-dark.d.ts","sourceRoot":"","sources":["../../../../src/theme/inject-theme-dark.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7D;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAC3B,aAAY,WAA2B,EACvC,YAAY,WAAW,EACvB,YAAW,SAAkB,KAC5B,MA8KF,CAAC"}

package/dist/web-elements/src/theme/inject-theme.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Theme Injection Utilities
+ * Injects CSS variables into iframe for theme support
+ * Supports light/dark themes via prefers-color-scheme media query
+ */
+import type { ThemeTokens } from '../types/theme';
+/**
+ * Generate CSS variable declarations from theme tokens
+ * Flattens nested structure (e.g., colors.text.primary → --bt-color-text-primary)
+ */
+export declare const generateCSSVariables: (theme: ThemeTokens) => string;
+/**
+ * Inject theme CSS variables into iframe
+ */
+export declare const injectTheme: (iframe: HTMLIFrameElement, theme: ThemeTokens) => void;
+/**
+ * Update theme dynamically (e.g., for dark mode)
+ */
+export declare const updateTheme: (iframe: HTMLIFrameElement, updates: Partial<ThemeTokens>) => void;
+//# sourceMappingURL=inject-theme.d.ts.map

package/dist/web-elements/src/theme/inject-theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-theme.d.ts","sourceRoot":"","sources":["../../../../src/theme/inject-theme.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAAI,OAAO,WAAW,KAAG,MAoLzD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,GACtB,QAAQ,iBAAiB,EACzB,OAAO,WAAW,KACjB,IAgBF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,GACtB,QAAQ,iBAAiB,EACzB,SAAS,OAAO,CAAC,WAAW,CAAC,KAC5B,IAWF,CAAC"}

package/dist/web-elements/src/types/events.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Event type definitions for Basis Theory Elements v3
+ * All events follow a consistent contract with base metadata
+ */
+/**
+ * Element types
+ */
+export type ElementType = 'cardNumber' | 'cvv' | 'expiry' | 'text' | 'card';
+/**
+ * Base event detail - all element events include this metadata
+ */
+export interface BaseEventDetail {
+    /** Element type that fired this event */
+    elementType: ElementType;
+    /** Unique element ID (for distinguishing multiple elements) */
+    elementId: string;
+    /** Event timestamp (Unix milliseconds) */
+    timestamp: number;
+}
+/**
+ * Ready event - fired when element iframe loads and is ready for interaction
+ */
+export interface ReadyEventDetail extends BaseEventDetail {
+}
+/**
+ * Validation error structure
+ */
+export interface ValidationError {
+    /** Machine-readable error code */
+    code: string;
+    /** Human-readable error message */
+    message: string;
+}
+/**
+ * Base change event detail - common to all element types
+ */
+export interface ChangeEventDetail extends BaseEventDetail {
+    /** Whether the current value is valid */
+    isValid: boolean;
+    /** Whether the input is empty */
+    isEmpty: boolean;
+    /** Validation error (null if valid) */
+    error: ValidationError | null;
+}
+/**
+ * Card number specific change event detail
+ * Extends base with card brand detection metadata
+ */
+export interface CardNumberChangeEventDetail extends ChangeEventDetail {
+    /** Detected card brand (Visa, Mastercard, etc.) */
+    cardBrand?: string;
+    /** Last 4 digits (PCI-safe, for display) */
+    last4?: string | null;
+    /** BIN (Bank Identification Number) - first 6-8 digits */
+    bin?: string | null;
+    /** CVV lengths for detected brand (for coordinating with CVV element) */
+    cvvLengths?: number[] | null;
+    /** All brands that could potentially match */
+    potentialBrands?: string[];
+    /** Match confidence (0-1, higher = more confident) */
+    matchStrength?: number;
+}
+/**
+ * Card element specific change event detail (unified card element)
+ * Extends base with unified card state for all 3 sub-fields
+ */
+export interface CardElementChangeEventDetail extends ChangeEventDetail {
+    /** Detected card brand (Visa, Mastercard, etc.) */
+    cardBrand?: string;
+    /** Last 4 digits (PCI-safe, for display) */
+    last4?: string | null;
+    /** BIN (Bank Identification Number) - first 6-8 digits */
+    bin?: string | null;
+    /** Validation errors from all sub-fields (cardNumber, expirationDate, cvc) */
+    errors?: Array<{
+        field: string;
+        code: string;
+        message: string;
+    }> | null;
+}
+/**
+ * Focus event - fired when element receives focus
+ */
+export interface FocusEventDetail extends BaseEventDetail {
+}
+/**
+ * Blur event - fired when element loses focus
+ */
+export interface BlurEventDetail extends BaseEventDetail {
+}
+/**
+ * Error codes
+ */
+export type ErrorCode = 'MOUNT_ERROR' | 'POSTMESSAGE_TIMEOUT' | 'IFRAME_LOAD_ERROR' | 'INITIALIZATION_ERROR' | 'API_ERROR' | 'NETWORK_ERROR' | 'VALIDATION_ERROR' | 'INVALID_CONFIGURATION' | 'UNKNOWN_ERROR';
+/**
+ * Error event detail - fired when errors occur during element operations
+ */
+export interface ErrorEventDetail extends BaseEventDetail {
+    /** Machine-readable error code */
+    code: ErrorCode;
+    /** Human-readable error message */
+    message: string;
+    /** HTTP status code (for API errors) */
+    status?: number;
+    /** Field-level validation errors from API */
+    validationErrors?: Record<string, string[]>;
+    /** Additional error context */
+    metadata?: {
+        /** Error source (e.g., 'tokenize', 'mount') */
+        source?: string;
+        /** Number of retry attempts */
+        retryCount?: number;
+        /** Full API response body (for debugging) */
+        body?: unknown;
+        /** Original error object */
+        originalError?: Error;
+    };
+}
+/**
+ * Union of all event types
+ */
+export type ElementEventType = 'ready' | 'change' | 'focus' | 'blur' | 'error';
+/**
+ * Map of event types to their detail types
+ */
+export interface ElementEventDetailMap {
+    ready: ReadyEventDetail;
+    change: ChangeEventDetail | CardNumberChangeEventDetail | CardElementChangeEventDetail;
+    focus: FocusEventDetail;
+    blur: BlurEventDetail;
+    error: ErrorEventDetail;
+}
+/**
+ * Type-safe event listener signature
+ */
+export type ElementEventListener<T extends ElementEventType> = (event: CustomEvent<ElementEventDetailMap[T]>) => void;
+//# sourceMappingURL=events.d.ts.map

package/dist/web-elements/src/types/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../../src/types/events.ts"],"names":[],"mappings":"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"}

package/dist/web-elements/src/types/theme.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Theme System Types
+ * Implements Hybrid approach: CSS variables for theming + property overrides
+ *
+ * Uses semantic nesting for better DX:
+ * - Magnitude scales: fontSize.sm/base/lg
+ * - State variants: border.default/hover/focus
+ * - Semantic groups: text.primary/secondary/placeholder
+ *
+ * Supports light/dark themes via prefers-color-scheme or explicit theme prop
+ */
+export type ThemeMode = 'light' | 'dark' | 'auto';
+export interface ThemeTokens {
+    colors: {
+        primary: string;
+        error: string;
+        success: string;
+        text: {
+            primary: string;
+            secondary?: string;
+            placeholder?: string;
+            disabled?: string;
+        };
+        background: {
+            default: string;
+            hover?: string;
+            focus?: string;
+            disabled?: string;
+        };
+        border: {
+            default: string;
+            hover?: string;
+            focus?: string;
+            error?: string;
+        };
+    };
+    typography: {
+        fontFamily: string;
+        fontSize: {
+            sm?: string;
+            base: string;
+            lg?: string;
+        };
+        fontWeight: {
+            normal: string;
+            medium?: string;
+            semibold?: string;
+        };
+        lineHeight?: {
+            tight?: string;
+            normal?: string;
+            relaxed?: string;
+        };
+    };
+    spacing: {
+        xs?: string;
+        sm: string;
+        md: string;
+        lg: string;
+        xl?: string;
+    };
+    borders: {
+        radius: {
+            none?: string;
+            sm?: string;
+            base: string;
+            md?: string;
+            lg?: string;
+            full?: string;
+        };
+        width: {
+            thin?: string;
+            base: string;
+            thick?: string;
+        };
+    };
+    shadows?: {
+        none?: string;
+        sm?: string;
+        base?: string;
+        md?: string;
+        lg?: string;
+        focus?: string;
+    };
+    transitions?: {
+        fast?: string;
+        base?: string;
+        slow?: string;
+    };
+}
+//# sourceMappingURL=theme.d.ts.map

package/dist/web-elements/src/types/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../../../src/types/theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAElD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE;QAEN,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAGhB,IAAI,EAAE;YACJ,OAAO,EAAE,MAAM,CAAC;YAChB,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;SACnB,CAAC;QAGF,UAAU,EAAE;YACV,OAAO,EAAE,MAAM,CAAC;YAChB,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,QAAQ,CAAC,EAAE,MAAM,CAAC;SACnB,CAAC;QAGF,MAAM,EAAE;YACN,OAAO,EAAE,MAAM,CAAC;YAChB,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,KAAK,CAAC,EAAE,MAAM,CAAC;SAChB,CAAC;KACH,CAAC;IACF,UAAU,EAAE;QACV,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE;YACR,EAAE,CAAC,EAAE,MAAM,CAAC;YACZ,IAAI,EAAE,MAAM,CAAC;YACb,EAAE,CAAC,EAAE,MAAM,CAAC;SACb,CAAC;QACF,UAAU,EAAE;YACV,MAAM,EAAE,MAAM,CAAC;YACf,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;SACnB,CAAC;QACF,UAAU,CAAC,EAAE;YACX,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,OAAO,CAAC,EAAE,MAAM,CAAC;SAClB,CAAC;KACH,CAAC;IACF,OAAO,EAAE;QACP,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,EAAE,EAAE,MAAM,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;QACX,EAAE,CAAC,EAAE,MAAM,CAAC;KACb,CAAC;IACF,OAAO,EAAE;QACP,MAAM,EAAE;YACN,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,EAAE,CAAC,EAAE,MAAM,CAAC;YACZ,IAAI,EAAE,MAAM,CAAC;YACb,EAAE,CAAC,EAAE,MAAM,CAAC;YACZ,EAAE,CAAC,EAAE,MAAM,CAAC;YACZ,IAAI,CAAC,EAAE,MAAM,CAAC;SACf,CAAC;QACF,KAAK,EAAE;YACL,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,IAAI,EAAE,MAAM,CAAC;YACb,KAAK,CAAC,EAAE,MAAM,CAAC;SAChB,CAAC;KACH,CAAC;IACF,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,WAAW,CAAC,EAAE;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH"}