@tatchi-xyz/sdk 0.21.0 → 0.31.0

package/dist/esm/react/sdk/src/core/WalletIframe/client/on-events-progress-bus.js

@@ -1,208 +0,0 @@
-import { AccountRecoveryPhase, ActionPhase, DeviceLinkingPhase, EmailRecoveryPhase, LoginPhase, RegistrationPhase, init_sdkSentEvents } from "../../types/sdkSentEvents.js";
-
-//#region src/core/WalletIframe/client/on-events-progress-bus.ts
-init_sdkSentEvents();
-const SHOW_PHASES = new Set([
-	ActionPhase.STEP_2_USER_CONFIRMATION,
-	ActionPhase.STEP_2_USER_CONFIRMATION,
-	ActionPhase.STEP_3_WEBAUTHN_AUTHENTICATION,
-	ActionPhase.STEP_3_WEBAUTHN_AUTHENTICATION,
-	RegistrationPhase.STEP_1_WEBAUTHN_VERIFICATION,
-	EmailRecoveryPhase.STEP_2_TOUCH_ID_REGISTRATION,
-	DeviceLinkingPhase.STEP_3_AUTHORIZATION,
-	DeviceLinkingPhase.STEP_6_REGISTRATION,
-	AccountRecoveryPhase.STEP_2_WEBAUTHN_AUTHENTICATION,
-	LoginPhase.STEP_2_WEBAUTHN_ASSERTION
-]);
-const HIDE_PHASES = new Set([
-	ActionPhase.STEP_4_AUTHENTICATION_COMPLETE,
-	ActionPhase.STEP_5_TRANSACTION_SIGNING_PROGRESS,
-	ActionPhase.STEP_6_TRANSACTION_SIGNING_COMPLETE,
-	ActionPhase.STEP_7_BROADCASTING,
-	ActionPhase.STEP_8_ACTION_COMPLETE,
-	DeviceLinkingPhase.STEP_7_LINKING_COMPLETE,
-	DeviceLinkingPhase.REGISTRATION_ERROR,
-	DeviceLinkingPhase.LOGIN_ERROR,
-	DeviceLinkingPhase.DEVICE_LINKING_ERROR,
-	RegistrationPhase.STEP_5_CONTRACT_REGISTRATION,
-	RegistrationPhase.STEP_8_REGISTRATION_COMPLETE,
-	RegistrationPhase.REGISTRATION_ERROR,
-	LoginPhase.STEP_3_VRF_UNLOCK,
-	LoginPhase.STEP_4_LOGIN_COMPLETE,
-	LoginPhase.LOGIN_ERROR,
-	AccountRecoveryPhase.STEP_4_AUTHENTICATOR_SAVED,
-	AccountRecoveryPhase.STEP_5_ACCOUNT_RECOVERY_COMPLETE,
-	AccountRecoveryPhase.ERROR,
-	EmailRecoveryPhase.STEP_5_FINALIZING_REGISTRATION,
-	EmailRecoveryPhase.STEP_6_COMPLETE,
-	EmailRecoveryPhase.ERROR
-]);
-var OnEventsProgressBus = class {
-	subs = /* @__PURE__ */ new Map();
-	logger;
-	overlay;
-	heuristic;
-	overlayDemands = /* @__PURE__ */ new Map();
-	constructor(overlay, heuristic, logger) {
-		this.overlay = overlay;
-		this.heuristic = heuristic;
-		this.logger = logger;
-	}
-	/**
-	* Register a subscriber for a requestId.
-	* Initializes demand tracking to 'none' (neutral) until phases arrive.
-	*/
-	register({ requestId, onProgress, sticky = false }) {
-		this.subs.set(requestId, {
-			onProgress,
-			sticky,
-			stats: {
-				count: 0,
-				lastPhase: null,
-				lastAt: null
-			}
-		});
-		this.overlayDemands.set(requestId, "none");
-		this.log("register", {
-			requestId,
-			sticky
-		});
-	}
-	/**
-	* Unregister a subscriber and clear its overlay demand.
-	* If no remaining requests demand 'show', the overlay is hidden.
-	*/
-	unregister(requestId) {
-		if (this.subs.delete(requestId)) this.log("unregister", { requestId });
-		this.overlayDemands.delete(requestId);
-		if (!this.wantsVisible()) try {
-			this.overlay.hide();
-		} catch {}
-	}
-	/**
-	* Remove all subscribers and demands; overlay demand set is cleared.
-	*/
-	clearAll() {
-		this.subs.clear();
-		this.overlayDemands.clear();
-		this.log("clearAll");
-	}
-	isSticky(requestId) {
-		const sub = this.subs.get(requestId);
-		return !!sub?.sticky;
-	}
-	/**
-	* Dispatch a progress payload to a request's subscriber and update
-	* the aggregate overlay demand based on the phase heuristic.
-	*/
-	dispatch({ requestId, payload }) {
-		const phase = String((payload || {}).phase || "");
-		const action = this.heuristic(payload);
-		this.overlayDemands.set(requestId, action);
-		if (action === "show") try {
-			this.overlay.show();
-		} catch {}
-		else if (action === "hide") {
-			if (!this.wantsVisible()) try {
-				this.overlay.hide();
-			} catch {}
-		}
-		const sub = this.subs.get(requestId);
-		if (sub) {
-			this.bumpStats(sub, phase);
-			try {
-				sub.onProgress?.(payload);
-			} catch {}
-			this.log("dispatch", {
-				requestId,
-				phase,
-				sticky: sub.sticky
-			});
-			return true;
-		}
-		const sticky = this.findSticky(requestId);
-		if (sticky) {
-			this.bumpStats(sticky, phase);
-			try {
-				sticky.onProgress?.(payload);
-			} catch {}
-			this.log("dispatch-sticky", {
-				requestId,
-				phase
-			});
-			return true;
-		}
-		this.log("dispatch-miss", {
-			requestId,
-			phase
-		});
-		return false;
-	}
-	getStats(requestId) {
-		const sub = this.subs.get(requestId);
-		return sub ? sub.stats : null;
-	}
-	/**
-	* Returns true if any tracked request currently demands the overlay be visible.
-	* Useful for higher layers (router) to avoid premature hides on completion/timeout.
-	*/
-	wantsVisible() {
-		for (const v of this.overlayDemands.values()) if (v === "show") return true;
-		return false;
-	}
-	findSticky(requestId) {
-		const sub = this.subs.get(requestId);
-		if (sub && sub.sticky) return sub;
-		return null;
-	}
-	bumpStats(sub, phase) {
-		sub.stats.count += 1;
-		sub.stats.lastPhase = phase || null;
-		sub.stats.lastAt = Date.now();
-	}
-	log(msg, data) {
-		try {
-			this.logger?.(msg, data);
-		} catch {}
-	}
-};
-/**
-* defaultPhaseHeuristics
-*
-* Decides when to expand or contract the invisible wallet iframe overlay
-* based on incoming progress events (phases). Returning:
-*  - 'show' → expands the iframe to a full-screen, invisible layer that captures
-*             user activation (e.g., TouchID / WebAuthn prompts) and pointer events.
-*  - 'hide' → immediately contracts the iframe back to 0×0 so it no longer blocks clicks.
-*  - 'none' → no change.
-*
-* Important UX constraint: the overlay covers the entire viewport and is
-* intentionally invisible. While expanded, it will intercept clicks and can
-* block interactions with the app. Therefore, we must minimize the time it is
-* expanded and only show it during the brief windows where user activation is
-* required (e.g., when the TouchID prompt is about to appear or the modal is
-* mounting and needs focus/activation in the iframe context). As soon as
-* activation completes (e.g., authentication-complete), we hide it again.
-*
-* If new phases are introduced that require user activation, add them to
-* SHOW_PHASES; if phases become non-interactive post-activation, add them to
-* HIDE_PHASES. The goal is to keep the overlay up for the minimum possible time.
-*/
-const defaultPhaseHeuristics = (payload) => {
-	try {
-		const phase = String((payload || {}).phase || "");
-		if (!phase) return "none";
-		if (SHOW_PHASES.has(phase)) return "show";
-		if (HIDE_PHASES.has(phase)) return "hide";
-		const raw = phase.toLowerCase();
-		if (raw === "user-confirmation-complete") return "hide";
-		if (raw === "cancelled") return "hide";
-		return "none";
-	} catch {
-		return "none";
-	}
-};
-
-//#endregion
-export { OnEventsProgressBus, defaultPhaseHeuristics };
-//# sourceMappingURL=on-events-progress-bus.js.map

package/dist/esm/react/sdk/src/core/WalletIframe/client/on-events-progress-bus.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"on-events-progress-bus.js","names":["DelegateActionPhase","defaultPhaseHeuristics: PhaseHeuristics"],"sources":["../../../../../../../../src/core/WalletIframe/client/on-events-progress-bus.ts"],"sourcesContent":["/**\n * OnEventsProgressBus - Client-Side Communication Layer\n *\n * Manages progress event routing and overlay visibility *intents* for the wallet\n * iframe. It never manipulates the iframe directly; instead it calls the\n * injected OverlayController interface (show/hide), and WalletIframeRouter\n * owns the concrete OverlayController that knows how to display the iframe.\n *\n * Key Responsibilities:\n * - Progress Routing: Dispatches typed progress payloads to per-request subscribers\n * - Overlay Intents: Applies SHOW/HIDE based on phase heuristics, leaving actual\n *   DOM/CSS work to WalletIframeRouter + OverlayController\n * - Concurrent Aggregation: Tracks overlay demand per requestId and only hides\n *   when no request still requires SHOW (multi-request safe)\n * - Sticky Subscriptions: Supports long-running subscriptions that persist after completion\n * - Phase Heuristics: Pluggable logic to map phases → 'show' | 'hide' | 'none'\n * - Event Statistics: Tracks counts/timestamps for debugging\n */\n\nimport type { ProgressPayload as MessageProgressPayload } from '../shared/messages';\nimport {\n  ActionPhase,\n  DeviceLinkingPhase,\n  AccountRecoveryPhase,\n  RegistrationPhase,\n  LoginPhase,\n  EmailRecoveryPhase,\n  DelegateActionPhase,\n} from '../../types/sdkSentEvents';\n\n// Phases that should temporarily SHOW the overlay (to capture activation)\n// IMPORTANT: STEP_2_USER_CONFIRMATION must remain in this list. Without it,\n// modal confirmation with behavior: 'requireClick' will never be visible in\n// iframe mode, because the wallet iframe is still 0×0 when the modal mounts.\nconst SHOW_PHASES = new Set<string>([\n  // Gate overlay to moments of imminent activation only.\n  // Show early during user confirmation so the modal inside the wallet iframe is visible\n  // and can capture the required click when behavior === 'requireClick'.\n  ActionPhase.STEP_2_USER_CONFIRMATION,\n  DelegateActionPhase.STEP_2_USER_CONFIRMATION,\n  ActionPhase.STEP_3_WEBAUTHN_AUTHENTICATION,\n  DelegateActionPhase.STEP_3_WEBAUTHN_AUTHENTICATION,\n  // Registration requires a WebAuthn create() ceremony at step 1\n  RegistrationPhase.STEP_1_WEBAUTHN_VERIFICATION,\n  // Email recovery: TouchID registration uses WebAuthn create()\n  EmailRecoveryPhase.STEP_2_TOUCH_ID_REGISTRATION,\n  // Device1: TouchID authorization (host needs overlay to capture activation)\n  DeviceLinkingPhase.STEP_3_AUTHORIZATION,\n  // Device2: Registration inside wallet host (collects passkey via ModalTxConfirmer)\n  // Show overlay so the wallet iframe is visible and focused for WebAuthn\n  DeviceLinkingPhase.STEP_6_REGISTRATION,\n  AccountRecoveryPhase.STEP_2_WEBAUTHN_AUTHENTICATION,\n  LoginPhase.STEP_2_WEBAUTHN_ASSERTION,\n]);\n\n// Phases that should HIDE the overlay asap (post-activation, non-interactive)\nconst HIDE_PHASES = new Set<string>([\n  ActionPhase.STEP_4_AUTHENTICATION_COMPLETE,\n  ActionPhase.STEP_5_TRANSACTION_SIGNING_PROGRESS,\n  ActionPhase.STEP_6_TRANSACTION_SIGNING_COMPLETE,\n  ActionPhase.STEP_7_BROADCASTING,\n  ActionPhase.STEP_8_ACTION_COMPLETE,\n  // Device linking: hide when the flow has finished or errored\n  DeviceLinkingPhase.STEP_7_LINKING_COMPLETE,\n  DeviceLinkingPhase.REGISTRATION_ERROR,\n  DeviceLinkingPhase.LOGIN_ERROR,\n  DeviceLinkingPhase.DEVICE_LINKING_ERROR,\n  // Registration: hide once contract work starts or flow completes/errors\n  RegistrationPhase.STEP_5_CONTRACT_REGISTRATION,\n  RegistrationPhase.STEP_8_REGISTRATION_COMPLETE,\n  RegistrationPhase.REGISTRATION_ERROR,\n  // Login: hide after assertion leads to VRF unlock or completion/errors\n  LoginPhase.STEP_3_VRF_UNLOCK,\n  LoginPhase.STEP_4_LOGIN_COMPLETE,\n  LoginPhase.LOGIN_ERROR,\n  // Account recovery: hide after authentication completes or on completion/errors\n  AccountRecoveryPhase.STEP_4_AUTHENTICATOR_SAVED,\n  AccountRecoveryPhase.STEP_5_ACCOUNT_RECOVERY_COMPLETE,\n  AccountRecoveryPhase.ERROR,\n  // Email recovery: hide after finalization/complete or on error\n  EmailRecoveryPhase.STEP_5_FINALIZING_REGISTRATION,\n  EmailRecoveryPhase.STEP_6_COMPLETE,\n  EmailRecoveryPhase.ERROR,\n]);\n\nexport type ProgressPayload = MessageProgressPayload;\n\n// Minimal overlay control interface used by ProgressBus.\n// Implemented by WalletIframeRouter via an adapter object that calls\n// into the concrete OverlayToggler (fullscreen/anchored) as needed.\nexport interface OverlayToggler {\n  show: () => void;\n  hide: () => void;\n}\n\nexport type PhaseHeuristics = (payload: ProgressPayload) => 'show' | 'hide' | 'none';\n\nexport interface ProgressSubscriber {\n  onProgress?: (payload: ProgressPayload) => void;\n  sticky: boolean;\n  stats: { count: number; lastPhase: string | null; lastAt: number | null };\n}\n\nexport class OnEventsProgressBus {\n  private subs = new Map<string, ProgressSubscriber>();\n  private logger?: (msg: string, data?: Record<string, unknown>) => void;\n  private overlay: OverlayToggler;\n  private heuristic: PhaseHeuristics;\n  // Track the most recent overlay intent per requestId so that we can\n  // aggregate visibility across concurrent requests. If any request's\n  // latest intent is 'show', we keep the overlay visible.\n  private overlayDemands = new Map<string, 'show' | 'hide' | 'none'>();\n\n  constructor(overlay: OverlayToggler, heuristic: PhaseHeuristics, logger?: (msg: string, data?: Record<string, unknown>) => void) {\n    this.overlay = overlay;\n    this.heuristic = heuristic;\n    this.logger = logger;\n  }\n\n  /**\n   * Register a subscriber for a requestId.\n   * Initializes demand tracking to 'none' (neutral) until phases arrive.\n   */\n  register({ requestId, onProgress, sticky = false }: {\n    requestId: string,\n    sticky: boolean,\n    onProgress?: (p: ProgressPayload) => void,\n  }): void {\n    this.subs.set(requestId, {\n      onProgress,\n      sticky,\n      stats: { count: 0, lastPhase: null, lastAt: null }\n    });\n    // Initialize demand tracking for this request as neutral\n    this.overlayDemands.set(requestId, 'none');\n    this.log('register', { requestId, sticky });\n  }\n\n  /**\n   * Unregister a subscriber and clear its overlay demand.\n   * If no remaining requests demand 'show', the overlay is hidden.\n   */\n  unregister(requestId: string): void {\n    if (this.subs.delete(requestId)) this.log('unregister', { requestId });\n    // Remove any overlay demand for this request\n    this.overlayDemands.delete(requestId);\n    // If no remaining requests demand 'show', we can safely hide\n    if (!this.wantsVisible()) {\n      try { this.overlay.hide(); } catch {}\n    }\n  }\n\n  /**\n   * Remove all subscribers and demands; overlay demand set is cleared.\n   */\n  clearAll(): void {\n    this.subs.clear();\n    this.overlayDemands.clear();\n    this.log('clearAll');\n  }\n\n  isSticky(requestId: string): boolean {\n    const sub = this.subs.get(requestId);\n    return !!sub?.sticky;\n  }\n\n  /**\n   * Dispatch a progress payload to a request's subscriber and update\n   * the aggregate overlay demand based on the phase heuristic.\n   */\n  dispatch({ requestId, payload }: {\n    requestId: string,\n    payload: ProgressPayload\n  }): boolean {\n\n    const phase = String((payload || {}).phase || '');\n    const action = this.heuristic(payload);\n\n    // Update the latest demand for this request\n    this.overlayDemands.set(requestId, action);\n\n    // Apply aggregated overlay visibility:\n    // - If any request currently demands 'show', ensure overlay is visible\n    // - Only hide when no outstanding 'show' demands remain\n    if (action === 'show') {\n      try { this.overlay.show(); } catch {}\n    } else if (action === 'hide') {\n      if (!this.wantsVisible()) {\n        try { this.overlay.hide(); } catch {}\n      }\n    }\n\n    const sub = this.subs.get(requestId);\n    if (sub) {\n      this.bumpStats(sub, phase);\n      try { sub.onProgress?.(payload); } catch {}\n      this.log('dispatch', { requestId, phase, sticky: sub.sticky });\n      return true;\n    }\n\n    // Deliver to sticky-only subscriber if present (e.g., flow finished but status updates continue)\n    const sticky = this.findSticky(requestId);\n    if (sticky) {\n      this.bumpStats(sticky, phase);\n      try { sticky.onProgress?.(payload); } catch {}\n      this.log('dispatch-sticky', { requestId, phase });\n      return true;\n    }\n    this.log('dispatch-miss', { requestId, phase });\n    return false;\n  }\n\n  getStats(requestId: string): {\n    count: number;\n    lastPhase: string | null;\n    lastAt: number | null\n  } | null {\n    const sub = this.subs.get(requestId);\n    return sub ? sub.stats : null;\n  }\n\n  /**\n   * Returns true if any tracked request currently demands the overlay be visible.\n   * Useful for higher layers (router) to avoid premature hides on completion/timeout.\n   */\n  wantsVisible(): boolean {\n    for (const v of this.overlayDemands.values()) {\n      if (v === 'show') return true;\n    }\n    return false;\n  }\n\n  private findSticky(requestId: string): ProgressSubscriber | null {\n    const sub = this.subs.get(requestId);\n    if (sub && sub.sticky) return sub;\n    // sticky subscribers are keyed by the same requestId in this design\n    return null;\n  }\n\n  private bumpStats(sub: ProgressSubscriber, phase: string) {\n    sub.stats.count += 1;\n    sub.stats.lastPhase = phase || null;\n    sub.stats.lastAt = Date.now();\n  }\n\n  private log(msg: string, data?: Record<string, unknown>) {\n    try { this.logger?.(msg, data); } catch {}\n  }\n}\n\n// Default phase heuristic used by the client\n/**\n * defaultPhaseHeuristics\n *\n * Decides when to expand or contract the invisible wallet iframe overlay\n * based on incoming progress events (phases). Returning:\n *  - 'show' → expands the iframe to a full-screen, invisible layer that captures\n *             user activation (e.g., TouchID / WebAuthn prompts) and pointer events.\n *  - 'hide' → immediately contracts the iframe back to 0×0 so it no longer blocks clicks.\n *  - 'none' → no change.\n *\n * Important UX constraint: the overlay covers the entire viewport and is\n * intentionally invisible. While expanded, it will intercept clicks and can\n * block interactions with the app. Therefore, we must minimize the time it is\n * expanded and only show it during the brief windows where user activation is\n * required (e.g., when the TouchID prompt is about to appear or the modal is\n * mounting and needs focus/activation in the iframe context). As soon as\n * activation completes (e.g., authentication-complete), we hide it again.\n *\n * If new phases are introduced that require user activation, add them to\n * SHOW_PHASES; if phases become non-interactive post-activation, add them to\n * HIDE_PHASES. The goal is to keep the overlay up for the minimum possible time.\n */\nexport const defaultPhaseHeuristics: PhaseHeuristics = (payload: ProgressPayload) => {\n  try {\n    const phase = String((payload || {}).phase || '');\n    if (!phase) return 'none';\n\n    // Step 1: Check if this phase requires showing the overlay for user activation\n    if (SHOW_PHASES.has(phase)) return 'show';\n\n    // Step 2: Check if this phase indicates we should hide the overlay (post-activation)\n    if (HIDE_PHASES.has(phase)) return 'hide';\n\n    // Step 3: Handle legacy/custom completion markers\n    const raw = phase.toLowerCase();\n    if (raw === 'user-confirmation-complete') return 'hide';\n\n    // Step 4: Extra hardening - hide overlay on explicit cancellation\n    if (raw === 'cancelled') return 'hide';\n\n    // Step 5: Default to no change for unknown phases\n    return 'none';\n  } catch { return 'none'; }\n};\n"],"mappings":"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"}

package/dist/esm/react/sdk/src/core/WalletIframe/client/overlay-controller.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"overlay-controller.js","names":[],"sources":["../../../../../../../../src/core/WalletIframe/client/overlay-controller.ts"],"sourcesContent":["/**\n * OverlayController - Client-Side Communication Layer\n *\n * This module is the centralized controller for managing the wallet iframe's overlay\n * visibility and positioning. It provides a clean abstraction over the complex CSS\n * manipulations needed to show/hide the iframe for WebAuthn user activation.\n *\n * Key Responsibilities:\n * - Overlay Visibility Management: Controls when the iframe is visible vs hidden\n * - Positioning Modes: Supports fullscreen and anchored positioning modes\n * - Sticky Behavior: Prevents overlay from being hidden during critical operations\n * - CSS State Management: Handles all iframe styling for different overlay states\n * - Accessibility: Manages ARIA attributes and tabindex for screen readers\n * - Coordinate Handling: Converts DOMRect coordinates to CSS positioning\n *\n * Architecture:\n * - Single source of truth for iframe overlay state\n * - Mode-based positioning (hidden, fullscreen, anchored)\n * - Sticky mode prevents premature hiding during operations\n * - Clean separation between positioning logic and iframe management\n *\n * Overlay Modes:\n * - hidden: iframe is invisible with no footprint (0x0, pointer-events: none)\n * - fullscreen: iframe covers entire viewport for WebAuthn activation\n * - anchored: iframe positioned at specific coordinates (for inline UI components)\n *\n * Security Considerations:\n * - Uses high z-index (2147483646) to ensure overlay is above other content\n * - Controls pointer-events to avoid blocking page interaction when hidden\n * - Properly manages ARIA attributes for accessibility compliance\n * - Performs basic clamping (non-negative top/left, min size) but does not\n *   guarantee content stays fully within the viewport\n *\n * Usage Pattern:\n * 1. Create controller with iframe reference\n * 2. Set sticky mode for operations that need persistent overlay\n * 3. Show overlay (fullscreen or anchored) for user activation\n * 4. Hide overlay when activation is complete\n * 5. Clear sticky mode to allow normal hiding behavior\n */\n\nexport type DOMRectLike = { top: number; left: number; width: number; height: number };\nimport { setAnchored, setFullscreen, setHidden } from './overlay-styles';\n\ntype Mode = 'hidden' | 'fullscreen' | 'anchored';\n\nexport class OverlayController {\n  private ensureIframe: () => HTMLIFrameElement;\n  private mode: Mode = 'hidden';\n  private visible = false;\n  private sticky = false;\n  private rect: DOMRectLike | null = null;\n\n  constructor(opts: { ensureIframe: () => HTMLIFrameElement }) {\n    this.ensureIframe = opts.ensureIframe;\n  }\n\n  /**\n   * Set sticky mode - prevents overlay from being hidden during critical operations\n   * When sticky=true, hide() calls are ignored to maintain overlay visibility\n   */\n  setSticky(v: boolean): void { this.sticky = !!v; }\n\n  /**\n   * Show overlay in fullscreen mode - covers the viewport\n   * Used for WebAuthn activation where user needs to interact with TouchID/FaceID\n   * This mode allows the iframe to receive user activation events\n   */\n  showFullscreen(): void {\n    const iframe = this.ensureIframe();\n    this.visible = true;\n    this.mode = 'fullscreen';\n    this.rect = null;\n\n    // Apply fullscreen via CSS classes (CSP-safe)\n    setFullscreen(iframe);\n\n    // Step 3: Set accessibility attributes\n    iframe.setAttribute('aria-hidden', 'false');\n    iframe.removeAttribute('tabindex');\n  }\n\n  /**\n   * Show overlay in anchored mode - positioned at specific coordinates\n   * Used for inline UI components that need to appear at a specific location\n   * Coordinates are viewport-relative (from getBoundingClientRect()); values are\n   * clamped to non-negative top/left and minimum width/height\n   */\n  showAnchored(rect: DOMRectLike): void {\n    const iframe = this.ensureIframe();\n    this.visible = true;\n    this.mode = 'anchored';\n    this.rect = { ...rect };\n\n    // Apply anchored geometry via dynamic rule + classes (CSP-safe)\n    setAnchored(iframe, rect);\n\n    // Step 4: Set accessibility attributes\n    iframe.setAttribute('aria-hidden', 'false');\n    iframe.removeAttribute('tabindex');\n  }\n\n  /**\n   * Update anchored rectangle coordinates\n   * If overlay is currently in anchored mode, immediately apply new position\n   */\n  setAnchoredRect(rect: DOMRectLike): void {\n    this.rect = { ...rect };\n    if (this.visible && this.mode === 'anchored') this.showAnchored(this.rect);\n  }\n\n  /**\n   * Show overlay preferring anchored mode when a rect is available.\n   * Falls back to fullscreen when no anchored rect has been set yet.\n   * Safe to call repeatedly; it will re-apply current state.\n   */\n  showPreferAnchored(): void {\n    if (this.rect) {\n      this.showAnchored(this.rect);\n    } else {\n      this.showFullscreen();\n    }\n  }\n\n  /**\n   * Clear anchored rectangle - removes stored coordinates\n   */\n  clearAnchoredRect(): void { this.rect = null; }\n\n  /**\n   * Hide overlay - makes iframe invisible with no footprint\n   * Respects sticky mode - won't hide if sticky=true\n   * Used when WebAuthn activation is complete or operation is cancelled\n   */\n  hide(): void {\n    // Step 1: Check sticky mode - don't hide if operation is still in progress\n    if (this.sticky) return;\n\n    const iframe = this.ensureIframe();\n    this.visible = false;\n    this.mode = 'hidden';\n\n    // Apply hidden state via classes (CSP-safe)\n    setHidden(iframe);\n\n    // Step 3: Set accessibility attributes for hidden state\n    iframe.setAttribute('aria-hidden', 'true');\n    iframe.setAttribute('tabindex', '-1');\n  }\n\n  getState(): { visible: boolean; mode: Mode; sticky: boolean; rect?: DOMRectLike } {\n    return { visible: this.visible, mode: this.mode, sticky: this.sticky, rect: this.rect || undefined };\n  }\n}\n\nexport default OverlayController;\n"],"mappings":";;;AA8CA,IAAa,oBAAb,MAA+B;CAC7B,AAAQ;CACR,AAAQ,OAAa;CACrB,AAAQ,UAAU;CAClB,AAAQ,SAAS;CACjB,AAAQ,OAA2B;CAEnC,YAAY,MAAiD;AAC3D,OAAK,eAAe,KAAK;;;;;;CAO3B,UAAU,GAAkB;AAAE,OAAK,SAAS,CAAC,CAAC;;;;;;;CAO9C,iBAAuB;EACrB,MAAM,SAAS,KAAK;AACpB,OAAK,UAAU;AACf,OAAK,OAAO;AACZ,OAAK,OAAO;AAGZ,gBAAc;AAGd,SAAO,aAAa,eAAe;AACnC,SAAO,gBAAgB;;;;;;;;CASzB,aAAa,MAAyB;EACpC,MAAM,SAAS,KAAK;AACpB,OAAK,UAAU;AACf,OAAK,OAAO;AACZ,OAAK,OAAO,EAAE,GAAG;AAGjB,cAAY,QAAQ;AAGpB,SAAO,aAAa,eAAe;AACnC,SAAO,gBAAgB;;;;;;CAOzB,gBAAgB,MAAyB;AACvC,OAAK,OAAO,EAAE,GAAG;AACjB,MAAI,KAAK,WAAW,KAAK,SAAS,WAAY,MAAK,aAAa,KAAK;;;;;;;CAQvE,qBAA2B;AACzB,MAAI,KAAK,KACP,MAAK,aAAa,KAAK;MAEvB,MAAK;;;;;CAOT,oBAA0B;AAAE,OAAK,OAAO;;;;;;;CAOxC,OAAa;AAEX,MAAI,KAAK,OAAQ;EAEjB,MAAM,SAAS,KAAK;AACpB,OAAK,UAAU;AACf,OAAK,OAAO;AAGZ,YAAU;AAGV,SAAO,aAAa,eAAe;AACnC,SAAO,aAAa,YAAY;;CAGlC,WAAkF;AAChF,SAAO;GAAE,SAAS,KAAK;GAAS,MAAM,KAAK;GAAM,QAAQ,KAAK;GAAQ,MAAM,KAAK,QAAQ;;;;AAI7F,iCAAe"}

package/dist/esm/react/sdk/src/core/WalletIframe/client/overlay-styles.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"overlay-styles.js","names":["state: {\n  baseSheet: CSSStyleSheet | null;\n  // For fallback path, a dedicated <style> tag for dynamic anchored rules\n  dynStyleEl: HTMLStyleElement | null;\n  // Map element id -> rule index (constructable path)\n  ruleIndex: Map<string, number>;\n  // Cached support flag\n  supportConstructable: boolean | null;\n}"],"sources":["../../../../../../../../src/core/WalletIframe/client/overlay-styles.ts"],"sourcesContent":["/**\n * OverlayStyles - CSP-safe stylesheet manager for the wallet overlay iframe.\n *\n * Design goals:\n * - Zero inline style attributes (CSP style-src-attr 'none' compliant)\n * - Small, maintainable API: setHidden, setFullscreen, setAnchored\n * - Prefer constructable stylesheets; fall back to a nonce'd <style> for browsers\n *   without adoptedStyleSheets (mainly older Firefox/WebViews). Fallback is still\n *   important for broad compatibility unless you restrict supported browsers.\n */\n\nexport type DOMRectLike = { top: number; left: number; width: number; height: number };\n\nconst CLASS_BASE = 'w3a-wallet-overlay';\nconst CLASS_HIDDEN = 'is-hidden';\nconst CLASS_FULLSCREEN = 'is-fullscreen';\nconst CLASS_ANCHORED = 'is-anchored';\n\ntype GlobalWithNonce = typeof window & { litNonce?: string; w3aNonce?: string };\n\n// Singleton state for the base stylesheet and dynamic anchored rules\nconst state: {\n  baseSheet: CSSStyleSheet | null;\n  // For fallback path, a dedicated <style> tag for dynamic anchored rules\n  dynStyleEl: HTMLStyleElement | null;\n  // Map element id -> rule index (constructable path)\n  ruleIndex: Map<string, number>;\n  // Cached support flag\n  supportConstructable: boolean | null;\n} = {\n  baseSheet: null,\n  dynStyleEl: null,\n  ruleIndex: new Map(),\n  supportConstructable: null,\n};\n\nfunction supportsConstructable(): boolean {\n  if (state.supportConstructable != null) return state.supportConstructable;\n  state.supportConstructable = (typeof CSSStyleSheet !== 'undefined') && ('adoptedStyleSheets' in document);\n  return state.supportConstructable;\n}\n\nfunction getNonce(): string | undefined {\n  const w = window as GlobalWithNonce;\n  return w.w3aNonce || w.litNonce || undefined;\n}\n\nfunction installBaseStyles(): void {\n  if (state.baseSheet || state.dynStyleEl) return;\n  const css = `\n    .${CLASS_BASE} { position: fixed; border: none; box-sizing: border-box; background: transparent; color-scheme: normal; transform: none; right: auto; bottom: auto; inset: auto; top: auto; left: auto; z-index: var(--w3a-wallet-overlay-z, 2147483646); }\n    .${CLASS_BASE}.${CLASS_HIDDEN} { width: 0px; height: 0px; opacity: 0; pointer-events: none; z-index: auto; }\n    .${CLASS_BASE}.${CLASS_FULLSCREEN} { top: 0; left: 0; right: 0; bottom: 0; inset: 0; opacity: 1; pointer-events: auto; }\n    @supports (width: 100dvw) { .${CLASS_BASE}.${CLASS_FULLSCREEN} { width: 100dvw; height: 100dvh; } }\n    @supports not (width: 100dvw) { .${CLASS_BASE}.${CLASS_FULLSCREEN} { width: 100vw; height: 100vh; } }\n    .${CLASS_BASE}.${CLASS_ANCHORED} { opacity: 1; pointer-events: auto; }\n  `;\n\n  if (supportsConstructable()) {\n    try {\n      state.baseSheet = new CSSStyleSheet();\n      state.baseSheet.replaceSync(css);\n      const current = (document.adoptedStyleSheets || []) as CSSStyleSheet[];\n      document.adoptedStyleSheets = [...current, state.baseSheet];\n      return;\n    } catch {}\n  }\n  // Fallback: <style> tag (requires CSP nonce if style-src blocks inline)\n  const styleEl = document.createElement('style');\n  const nonce = getNonce();\n  if (nonce) try { styleEl.setAttribute('nonce', nonce); } catch {}\n  styleEl.textContent = css;\n  document.head.appendChild(styleEl);\n  // Dynamic anchored rules will use a separate tag to keep base CSS stable\n}\n\nfunction ensureDynStyleEl(): HTMLStyleElement {\n  if (state.dynStyleEl) return state.dynStyleEl;\n  const el = document.createElement('style');\n  const nonce = getNonce();\n  if (nonce) try { el.setAttribute('nonce', nonce); } catch {}\n  el.setAttribute('data-w3a-overlay-dyn', '');\n  document.head.appendChild(el);\n  state.dynStyleEl = el;\n  return el;\n}\n\nfunction asId(el: HTMLElement): string {\n  if (el.id && el.id.startsWith('w3a-overlay-')) return el.id;\n  const id = `w3a-overlay-${Math.random().toString(36).slice(2, 9)}`;\n  try { el.id = id; } catch {}\n  return id;\n}\n\nexport function ensureOverlayBase(el: HTMLElement): void {\n  installBaseStyles();\n  try { el.classList.add(CLASS_BASE); } catch {}\n}\n\nexport function setHidden(el: HTMLElement): void {\n  ensureOverlayBase(el);\n  try {\n    el.classList.add(CLASS_HIDDEN);\n    el.classList.remove(CLASS_FULLSCREEN);\n    el.classList.remove(CLASS_ANCHORED);\n  } catch {}\n}\n\nexport function setFullscreen(el: HTMLElement): void {\n  ensureOverlayBase(el);\n  try {\n    el.classList.add(CLASS_FULLSCREEN);\n    el.classList.remove(CLASS_HIDDEN);\n    el.classList.remove(CLASS_ANCHORED);\n  } catch {}\n}\n\nexport function setAnchored(el: HTMLElement, rect: DOMRectLike): void {\n  ensureOverlayBase(el);\n  const id = asId(el);\n  const top = Math.max(0, Math.round(rect.top));\n  const left = Math.max(0, Math.round(rect.left));\n  const width = Math.max(1, Math.round(rect.width));\n  const height = Math.max(1, Math.round(rect.height));\n  const rule = `#${id}.${CLASS_ANCHORED}{ top:${top}px; left:${left}px; width:${width}px; height:${height}px; }`;\n\n  if (supportsConstructable() && state.baseSheet) {\n    const s = state.baseSheet;\n    const prev = state.ruleIndex.get(id);\n    try {\n      if (typeof prev === 'number') { try { s.deleteRule(prev); } catch {} }\n      const idx = s.insertRule(rule, s.cssRules.length);\n      state.ruleIndex.set(id, idx);\n    } catch {}\n  } else {\n    const elDyn = ensureDynStyleEl();\n    const lines = (elDyn.textContent || '').split('\\n').filter(Boolean);\n    const prefix = `#${id}.`;\n    const rest = lines.filter(l => !l.startsWith(prefix));\n    rest.push(rule);\n    elDyn.textContent = rest.join('\\n');\n  }\n\n  try {\n    el.classList.add(CLASS_ANCHORED);\n    el.classList.remove(CLASS_HIDDEN);\n    el.classList.remove(CLASS_FULLSCREEN);\n  } catch {}\n}\n\nexport const OverlayStyleClasses = {\n  BASE: CLASS_BASE,\n  HIDDEN: CLASS_HIDDEN,\n  FULLSCREEN: CLASS_FULLSCREEN,\n  ANCHORED: CLASS_ANCHORED,\n};\n"],"mappings":"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"}