@w3payments/common 1.1.2 → 1.2.1

package/dist/index.d.ts

@@ -83,6 +83,11 @@ export declare interface CheckoutSession {
     metadata?: Record<string, any>;
 }
 
+/**
+ * Copy text to clipboard (browser utility)
+ */
+export declare function copyToClipboard(text: string): Promise<boolean>;
+
 export declare type CreatePaymentOptions = {
     /** Unique payment intent ID */
     id: string;
@@ -297,6 +302,21 @@ export declare function formatNumberDisplay(value: string | number, decimals: nu
  */
 export declare function formatUSD(value: number): string;
 
+/**
+ * Generate QR code as data URL for payment addresses
+ */
+export declare function generatePaymentQR(address: string, symbol?: string, amount?: string, options?: QRCodeOptions): Promise<string>;
+
+/**
+ * Generate simple QR code for text/addresses
+ */
+export declare function generateQRCode(data: string, options?: QRCodeOptions): Promise<string>;
+
+/**
+ * Generate QR code as SVG string
+ */
+export declare function generateQRCodeSVG(data: string, options?: Omit<QRCodeOptions, 'type' | 'quality'>): Promise<string>;
+
 export declare function getCurrencyIcon(code: string): string | undefined;
 
 export declare function getExchangeIcon(exchange: string): string | undefined;
@@ -578,6 +598,27 @@ export declare interface PaymentResult {
  */
 export declare type PaymentStatus = 'pending' | 'processing' | 'completed' | 'failed' | 'cancelled';
 
+/**
+ * QR Code Utilities for Payment Addresses
+ */
+export declare interface QRCodeOptions {
+    /** Error correction level */
+    errorCorrectionLevel?: 'L' | 'M' | 'Q' | 'H';
+    /** QR code type */
+    type?: 'image/png' | 'image/jpeg' | 'image/webp';
+    /** Quality (0-1) for JPEG */
+    quality?: number;
+    /** Margin around QR code */
+    margin?: number;
+    /** Color options */
+    color?: {
+        dark?: string;
+        light?: string;
+    };
+    /** Width/height in pixels */
+    width?: number;
+}
+
 /**
  * Truncate value to currency's maximum decimal places
  */
@@ -588,6 +629,11 @@ export declare function truncateToCurrencyDecimals(value: string, currency: Curr
  */
 export declare function validateCurrencyDecimals(value: string, currency: Currency): boolean;
 
+/**
+ * Validate if a string can be encoded as QR code
+ */
+export declare function validateQRData(data: string): boolean;
+
 /**
  * Standard vendor adapter interface
  */