@omnipad/core 0.4.5 → 0.6.0

package/dist/dom/index.d.ts

@@ -0,0 +1,375 @@
+import { f as IPointerHandler, S as StickyProvider, a as IElementObserver } from '../sticky-d_z_GU83.js';
+import { L as LayoutBox, a as AbstractRect, P as ParsedLength, G as GamepadMappingConfig } from '../index-Dd0aHJaA.js';
+
+/**
+ * Forcefully focuses an element.
+ * Automatically handles the 'tabindex' attribute to ensure non-focusable elements (like Canvas)
+ * can receive focus.
+ *
+ * @param el - The target HTMLElement to focus.
+ */
+declare const focusElement: (el: HTMLElement) => void;
+/**
+ * Dispatches a synthetic KeyboardEvent to the window object.
+ *
+ * @param type - The event type, e.g., 'keydown' or 'keyup'.
+ * @param payload - Key mapping data including key, code, and legacy keyCode.
+ */
+declare const dispatchKeyboardEvent: (type: string, payload: {
+    key: string;
+    code: string;
+    keyCode: number;
+}) => void;
+/**
+ * Dispatches a high-fidelity sequence of Pointer and Mouse events at specific pixel coordinates.
+ * Finds the target element dynamically at the moment of dispatch.
+ *
+ * @param type - The event type (should start with 'pointer' for best compatibility).
+ * @param x - Viewport X coordinate (px).
+ * @param y - Viewport Y coordinate (px).
+ * @param opts - Additional PointerEvent options (button, pressure, etc.).
+ */
+declare const dispatchPointerEventAtPos: (type: string, x: number, y: number, opts: {
+    button: number;
+    buttons: number;
+    pressure: number;
+}) => void;
+/**
+ * Reclaims browser focus for the element located at the specified viewport coordinates.
+ *
+ * This utility identifies the deepest element (penetrating Shadow DOM) at the given position
+ * and ensures it becomes the active element. It is essential for ensuring that
+ * game engines (like Ruffle) receive keyboard events immediately after a virtual interaction.
+ *
+ * @param x - The horizontal coordinate relative to the viewport.
+ * @param y - The vertical coordinate relative to the viewport.
+ * @returns True if the focus was successfully moved to the target; false if it was already focused or no target found.
+ */
+declare const reclaimFocusAtPos: (x: number, y: number, callback: () => void) => void;
+
+/**
+ * Creates a standardized bridge between native DOM PointerEvents and Core abstract handlers.
+ * Handles event prevention, stop propagation, pointer capture, and multi-touch filtering.
+ *
+ * @param coreHandler - The logic core instance that implements IPointerHandler.
+ * @param getElement - A getter function to retrieve the DOM element for pointer capture.
+ * @returns An object containing mapped event handlers for Vue/React template binding.
+ */
+declare function createPointerBridge(coreHandler: IPointerHandler & {
+    activePointerId?: number | null;
+}, options?: {
+    /** Respond only to direct clicks (without responding to events bubbled up from child elements) */
+    requireDirectHit?: boolean;
+}): {
+    /**
+     * Entry point for a pointer interaction.
+     * Establishes capture and initializes core logic.
+     */
+    onPointerDown(e: PointerEvent): void;
+    /**
+     * Continuous movement handling.
+     * Throttling should be handled within the core implementation.
+     */
+    onPointerMove(e: PointerEvent): void;
+    /**
+     * Successful interaction completion.
+     * Filters by pointerId to ensure only the capturing finger triggers release.
+     */
+    onPointerUp(e: PointerEvent): void;
+    /**
+     * System-level interaction cancellation (e.g., alert popups, browser gestures).
+     */
+    onPointerCancel(e: PointerEvent): void;
+};
+
+/**
+ * Safely sets pointer capture on an element.
+ *
+ * @param el - The target element to capture the pointer.
+ * @param pointerId - The unique ID of the pointer (from PointerEvent).
+ */
+declare const safeSetCapture: (el: EventTarget | null, pointerId: number) => void;
+/**
+ * Safely releases pointer capture from an element.
+ * Checks for current capture state and wraps in try-catch to prevent crashes.
+ *
+ * @param el - The target element.
+ * @param pointerId - The unique ID of the pointer to release.
+ */
+declare const safeReleaseCapture: (el: EventTarget | null, pointerId: number) => void;
+
+declare const supportsContainerQueries: () => boolean;
+
+/**
+ * Converts various CSS units into absolute pixel values based on the browser environment.
+ *
+ * Supports: `px`, `%` (relative to `baseSize`), `vw`, `vh`, `vmin`, `vmax`, `rem`, and `em`.
+ *
+ * **Note:** `rem` and `em` are both resolved using the root element's font size for simplicity.
+ *
+ * @param p - The parsed length object containing the value and unit.
+ * @param baseSize - The reference dimension (width or height) used to resolve percentage (%) values.
+ * @returns The computed numerical value in pixels.
+ */
+declare function toAbsolutePx(p: ParsedLength | undefined, baseSize: number): number;
+/**
+ * Flattens a relative layout into the coordinate system of its reference rectangle.
+ *
+ * **Core Logic:**
+ * This function takes a layout that is defined relative to `refRect` (the "guest" space)
+ * and calculates its equivalent position in the coordinate space that `refRect`
+ * itself inhabits (the "host" space).
+ *
+ * It resolves mixed units, calculates dimensions based on directional constraints
+ * (like stretching via left+right), and returns a normalized box where all values
+ * are absolute pixel strings.
+ *
+ * @param layout - The layout properties relative to the reference rectangle.
+ * @param refRect - The host rectangle defining the reference coordinate system.
+ * @returns A normalized `LayoutBox` with pixel-based `left`, `top`, `width`, and `height`.
+ */
+declare function flattenToHostLayout(layout: LayoutBox, refRect: AbstractRect): LayoutBox;
+
+/**
+ * Recursively penetrates Shadow DOM boundaries to find the deepest element at the
+ * specified viewport coordinates.
+ *
+ * @param x - Viewport X coordinate (px)
+ * @param y - Viewport Y coordinate (px)
+ * @param ignoreClass - Style class of DOM elements to be ignored
+ * @returns The deepmost Element or null if none found at the position.
+ */
+declare const getDeepElement: (x: number, y: number, ignoreClass?: string) => Element | null;
+/**
+ * Recursively finds the truly focused element by traversing Shadow DOM boundaries.
+ *
+ * @returns The deepmost active Element in focus or null.
+ */
+declare const getDeepActiveElement: () => Element | null;
+/**
+ * A robust wrapper for selecting a single DOM element.
+ *
+ *
+ * @param selector - A string containing one or more selectors to match.
+ * @returns The first {@link Element} that matches the specified selector, or `null` if no matches are found or the selector is invalid.
+ *
+ * @example
+ * // Handles special characters in IDs gracefully
+ * smartQuerySelector('#my.id$with:special-chars');
+ * // Falls back to standard CSS selectors
+ * smartQuerySelector('.container > div:first-child');
+ */
+declare const smartQuerySelector: (selector: string) => Element | null;
+
+/**
+ * Creates a StickyProvider pre-configured for the Web environment.
+ */
+declare const createWebStickyProvider: (selector: string) => StickyProvider<Element>;
+
+/**
+ * A centralized observation pool for DOM elements.
+ *
+ * This class provides a high-performance wrapper around `ResizeObserver` (RO) and
+ * `IntersectionObserver` (IO). By pooling all element observations into single
+ * native observer instances and utilizing `requestAnimationFrame` (rAF) throttling,
+ * it significantly reduces memory footprint and prevents layout thrashing.
+ *
+ * It supports deterministic unregistration via UIDs, making it ideal for
+ * framework adapters (like Vue or React) where DOM references may become unstable
+ * during unmounting.
+ */
+declare class ElementObserver implements IElementObserver<Element> {
+    private _ro;
+    private _roRegistry;
+    private _elToRoCb;
+    private _io;
+    private _ioRegistry;
+    private _elToIoCb;
+    private constructor();
+    static getInstance(): ElementObserver;
+    observeResize(uid: string, el: Element, cb: () => void): void;
+    unobserveResize(uid: string): void;
+    observeIntersect(uid: string, el: Element, cb: (isIntersecting: boolean) => void): void;
+    unobserveIntersect(uid: string): void;
+    disconnect(uid: string): void;
+}
+
+/**
+ * GamepadManager
+ *
+ * A singleton service that polls the browser Gamepad API via requestAnimationFrame.
+ * It translates physical hardware inputs into programmatic signals sent to
+ * virtual entities registered in the system.
+ *
+ * Handles:
+ * 1. Button edge detection (Down/Up).
+ * 2. D-Pad to vector conversion.
+ * 3. Analog stick deadzone processing.
+ */
+declare class GamepadManager {
+    private isRunning;
+    private config;
+    private lastButtonStates;
+    private constructor();
+    /**
+     * Retrieves the global singleton instance of the GamepadManager.
+     */
+    static getInstance(): GamepadManager;
+    /**
+     * Updates the current gamepad mapping configuration.
+     *
+     * @param config - The mapping of physical inputs to virtual component IDs (UID).
+     */
+    setConfig(config: GamepadMappingConfig[]): void;
+    /** Return the current gamepad mapping configuration. */
+    getConfig(): Readonly<GamepadMappingConfig[] | null>;
+    /**
+     * Starts the polling loop and listens for gamepad connection events.
+     */
+    start(): void;
+    /**
+     * Stops the polling loop.
+     */
+    stop(): void;
+    /**
+     * The core polling loop executing at the browser's refresh rate.
+     */
+    private loop;
+    /**
+     * Process binary button inputs with edge detection.
+     */
+    private processButtons;
+    /**
+     * Translates physical D-Pad buttons into a normalized vector.
+     */
+    private processDPad;
+    /**
+     * Process analog stick movements with deadzone logic.
+     */
+    private processAxes;
+    /**
+     * Locates a virtual entity and triggers its programmatic interface.
+     *
+     * @param uid - The Entity ID (UID) of the target.
+     * @param action - The type of trigger ('down', 'up', or 'vector').
+     * @param payload - Optional data for vector movements.
+     */
+    private triggerVirtualEntity;
+}
+
+/**
+ * Global Iframe Manager.
+ *
+ * Manages cross-origin communication between the host page and embedded iframes.
+ * Handles coordinate transformation, security whitelisting, and spatial tracking.
+ */
+declare class IframeManager {
+    /** Whitelist of trusted origins for postMessage communication */
+    private trustedOrigins;
+    /** Cache for verified and managed iframes mapping Element -> Metadata */
+    private managedIframes;
+    /** Use WeakSet to track denied iframes to avoid repeated parsing and prevent memory leaks */
+    private deniedIframes;
+    private constructor();
+    /**
+     * Retrieves the global singleton instance of IframeManager.
+     */
+    static getInstance(): IframeManager;
+    /**
+     * Adds a domain to the trusted whitelist.
+     *
+     * @param origin - The origin to trust (e.g., "https://example.com").
+     */
+    addTrustedOrigin(origin: string): void;
+    /**
+     * Core admission logic: Checks cache -> Validates whitelist -> Starts monitoring.
+     *
+     * @internal
+     * @param iframe - The iframe element to verify.
+     * @returns Verified cache data or null if untrusted/invalid.
+     */
+    private getVerifiedIframeData;
+    /**
+     * Transforms and forwards a pointer event to the target iframe.
+     *
+     * @param iframe - The destination iframe.
+     * @param type - Event type (e.g., 'pointermove').
+     * @param globalX - X coordinate in the host viewport.
+     * @param globalY - Y coordinate in the host viewport.
+     * @param opts - Original event options.
+     */
+    forwardPointerEvent(iframe: HTMLIFrameElement, type: string, globalX: number, globalY: number, opts: any): void;
+    /**
+     * Forwards a keyboard event to the target iframe.
+     *
+     * @param iframe - The destination iframe.
+     * @param type - Event type (e.g., 'keydown').
+     * @param payload - Key mapping data.
+     */
+    forwardKeyboardEvent(iframe: HTMLIFrameElement, type: string, payload: any): void;
+    private captureRect;
+    private getSecureOrigin;
+    /**
+     * Forcefully invalidates and refreshes all cached iframe rectangles.
+     * Called during global window resize or scroll events.
+     */
+    markAllRectDirty(): void;
+    /**
+     * Unregisters an iframe and disconnects its observers.
+     *
+     * @param iframe - The element to remove.
+     * @param uid - The unique ID associated with the iframe.
+     */
+    private unmanageIframe;
+    /**
+     * Fully clears the manager state.
+     */
+    clearAll(): void;
+}
+
+/**
+ * Global Input Manager Singleton.
+ *
+ * Responsible for monitoring global browser events (resize, blur, visibility)
+ * and coordinating system-wide resets to prevent stuck inputs.
+ */
+declare class WindowManager {
+    /** Internal flag to prevent multiple event registrations */
+    private _isListening;
+    /** A throttled version of the reset logic */
+    private throttledReset;
+    private constructor();
+    /**
+     * Retrieves the global instance of the WindowManager.
+     * Ensures uniqueness across multiple bundles or modules.
+     */
+    static getInstance(): WindowManager;
+    /**
+     * Manually triggers a system-wide input reset via Registry.
+     */
+    private handleGlobalReset;
+    private handleResizeReset;
+    private handleBlurReset;
+    private handleScrollReset;
+    private handleVisibilityChangeReset;
+    /**
+     * Initializes global safety listeners.
+     * Should be called once at the root component lifecycle (e.g., VirtualLayer).
+     */
+    init(): void;
+    /**
+     * Toggle full-screen state of the page.
+     * @param element Target HTMLElement
+     */
+    toggleFullscreen(element?: HTMLElement): Promise<void>;
+    /**
+     * Full-screen status query provided to the UI layer.
+     */
+    isFullscreen(): boolean;
+    /**
+     * Detaches all global listeners.
+     */
+    destroy(): void;
+}
+
+export { ElementObserver, GamepadManager, IframeManager, WindowManager, createPointerBridge, createWebStickyProvider, dispatchKeyboardEvent, dispatchPointerEventAtPos, flattenToHostLayout, focusElement, getDeepActiveElement, getDeepElement, reclaimFocusAtPos, safeReleaseCapture, safeSetCapture, smartQuerySelector, supportsContainerQueries, toAbsolutePx };

package/dist/dom/index.mjs

@@ -0,0 +1 @@
+import {c,e,b as b$2}from'../chunk-YAS6LFBF.mjs';import {a as a$1}from'../chunk-J5SVBM6K.mjs';import {g,c as c$1,O}from'../chunk-EYKCVOUA.mjs';import {b as b$1,e as e$1,a as a$2,g as g$1,c as c$2}from'../chunk-6XY2ZHZ3.mjs';export{b as getDeepActiveElement,a as getDeepElement,c as smartQuerySelector}from'../chunk-6XY2ZHZ3.mjs';import {a,b}from'../chunk-HQNUZXP5.mjs';var I=Symbol.for("omnipad.element_observer.instance"),m=class r{constructor(){a(this,"_ro");a(this,"_roRegistry",new Map);a(this,"_elToRoCb",new WeakMap);a(this,"_io");a(this,"_ioRegistry",new Map);a(this,"_elToIoCb",new WeakMap);let e$1=e(t=>{for(let n of t)this._elToRoCb.get(n.target)?.();});this._ro=new ResizeObserver(t=>{e$1(t);}),this._io=new IntersectionObserver(t=>{for(let n of t)this._elToIoCb.get(n.target)?.(n.isIntersecting);},{threshold:0});}static getInstance(){let e=globalThis;return e[I]||(e[I]=new r),e[I]}observeResize(e,t,n){this.unobserveResize(e),this._roRegistry.set(e,t),this._elToRoCb.set(t,n),this._ro.observe(t);}unobserveResize(e){let t=this._roRegistry.get(e);t&&(this._ro.unobserve(t),this._elToRoCb.delete(t),this._roRegistry.delete(e));}observeIntersect(e,t,n){this.unobserveIntersect(e),this._ioRegistry.set(e,t),this._elToIoCb.set(t,n),this._io.observe(t);}unobserveIntersect(e){let t=this._ioRegistry.get(e);t&&(this._io.unobserve(t),this._elToIoCb.delete(t),this._ioRegistry.delete(e));}disconnect(e){this.unobserveResize(e),this.unobserveIntersect(e);}};var R=Symbol.for("omnipad.iframe_manager.instance"),u=class r{constructor(){a(this,"trustedOrigins",new Set);a(this,"managedIframes",new Map);a(this,"deniedIframes",new WeakSet);this.trustedOrigins.add(window.location.origin);}static getInstance(){let e=globalThis;return e[R]||(e[R]=new r),e[R]}addTrustedOrigin(e){e==="*"&&import.meta.env?.DEV&&console.warn('[OmniPad-Security] Wildcard origin "*" is dangerous!'),this.trustedOrigins.add(e);}getVerifiedIframeData(e){let t=this.managedIframes.get(e);if(t)return t;if(this.deniedIframes.has(e))return null;let n=this.getSecureOrigin(e);if(!(this.trustedOrigins.has("*")||this.trustedOrigins.has(n)))return import.meta.env?.DEV&&console.warn(`[OmniPad-Security] Blocking untrusted iframe from origin: ${n}`),this.deniedIframes.add(e),null;let s=g("iframe-proxy"),a=this.captureRect(e),c={uid:s,rect:a,origin:n,isVisible:true};this.managedIframes.set(e,c);let l=m.getInstance();return l.observeResize(s,e,()=>{c.rect=this.captureRect(e);}),l.observeIntersect(s,e,g=>{c.isVisible=g,g||(import.meta.env?.DEV&&console.debug(`[OmniPad-IPC] Iframe ${s} hidden, sending safety reset.`),this.forwardKeyboardEvent(e,c$1.KEYUP,{all:true}));}),c}forwardPointerEvent(e,t,n,i,s){if(!e.contentWindow||!Number.isFinite(n)||!Number.isFinite(i))return;let a=this.getVerifiedIframeData(e);if(!a)return;let c=n-a.rect.left,l=i-a.rect.top;e.contentWindow.postMessage({signature:b,type:"pointer",action:t,payload:{x:c,y:l,opts:s}},a.origin);}forwardKeyboardEvent(e,t,n){if(!e.contentWindow)return;let i=this.getVerifiedIframeData(e);i&&e.contentWindow.postMessage({signature:b,type:"keyboard",action:t,payload:n},i.origin);}captureRect(e){let t=e.getBoundingClientRect();return a$1(t)}getSecureOrigin(e){try{if(!e.src)return "null";let t=new URL(e.src,window.location.href);return ["about:","blob:","data:"].includes(t.protocol)?"null":t.origin}catch{return "null"}}markAllRectDirty(){import.meta.env?.DEV&&console.debug("[OmniPad-IPC] Refreshing all iframe rects due to environment change."),this.managedIframes.forEach((e,t)=>{if(!document.contains(t)){this.unmanageIframe(t,e.uid);return}e.rect=this.captureRect(t);});}unmanageIframe(e,t){m.getInstance().disconnect(t),this.managedIframes.set(e,void 0),this.managedIframes.delete(e),this.deniedIframes.delete(e);}clearAll(){this.managedIframes.forEach((e,t)=>{this.unmanageIframe(t,e.uid);});}};var V=r=>{b$1()!==r&&(r.hasAttribute("tabindex")||r.setAttribute("tabindex","-1"),r.focus());},J=(r,e)=>{let t=b$1();if(t&&t.tagName.toLowerCase()==="iframe"){u.getInstance().forwardKeyboardEvent(t,r,e);return}e$1(r,e);},Z=(r,e,t,n)=>{let i=a$2(e,t);if(i){if(i.tagName.toLowerCase()==="iframe"){u.getInstance().forwardPointerEvent(i,r,e,t,n);return}g$1(i,r,e,t,n);}},ee=(r,e,t)=>{let n=a$2(r,e);if(!n)return;b$1()!==n&&(V(n),t());};var _=(r,e)=>{if(r instanceof Element)try{r.setPointerCapture(e);}catch(t){import.meta.env?.DEV&&console.warn("[OmniPad-DOM] Failed to set pointer capture:",t);}},w=(r,e)=>{if(r instanceof Element&&r.hasPointerCapture(e))try{r.releasePointerCapture(e);}catch{}};function ie(r,e={}){return {onPointerDown(t){if(!t.isTrusted||e?.requireDirectHit&&t.target!==t.currentTarget||r.activePointerId!=null)return;t.cancelable&&t.preventDefault(),t.stopPropagation();let n=t.currentTarget;n&&_(n,t.pointerId),r.onPointerDown(t);},onPointerMove(t){t.isTrusted&&(r.activePointerId!=null&&r.activePointerId!==t.pointerId||(t.cancelable&&t.preventDefault(),r.onPointerMove(t)));},onPointerUp(t){if(!t.isTrusted||r.activePointerId!=null&&r.activePointerId!==t.pointerId)return;t.cancelable&&t.preventDefault();let n=t.currentTarget;n&&w(n,t.pointerId),r.onPointerUp(t);},onPointerCancel(t){if(!t.isTrusted||r.activePointerId!=null&&r.activePointerId!==t.pointerId)return;let n=t.currentTarget;n&&w(n,t.pointerId),r.onPointerCancel(t);}}}var v,se=()=>(v!==void 0||(v=typeof window<"u"&&!!window.CSS?.supports?.("width: 1cqw")),v);function B(r,e){if(!r)return 0;switch(r.unit){case "px":return r.value;case "%":return r.value/100*e;case "vw":return r.value/100*window.innerWidth;case "vh":return r.value/100*window.innerHeight;case "vmin":return r.value/100*Math.min(window.innerWidth,window.innerHeight);case "vmax":return r.value/100*Math.max(window.innerWidth,window.innerHeight);case "rem":case "em":{let t=parseFloat(getComputedStyle(document.documentElement).fontSize)||16;return r.value*t}default:return r.value}}function le(r,e){return O(r,e,B)}var fe=r=>new c(r,e=>c$2(e),e=>{let t=e.getBoundingClientRect();return a$1(t)},e=>document.contains(e));var y=Symbol.for("omnipad.gamepad_manager.instance"),G={A:0,B:1,X:2,Y:3,LB:4,RB:5,LT:6,RT:7,Select:8,Start:9,L3:10,R3:11,Up:12,Down:13,Left:14,Right:15},D=class r{constructor(){a(this,"isRunning",false);a(this,"config",null);a(this,"lastButtonStates",[]);a(this,"loop",()=>{if(!this.isRunning)return;let e=navigator.getGamepads();this.config?.forEach((t,n)=>{let i=e[n];i&&i.connected&&t&&(this.lastButtonStates[n]||(this.lastButtonStates[n]=[]),this.processButtons(i,t,n),this.processDPad(i,t),this.processAxes(i,t));}),requestAnimationFrame(this.loop);});}static getInstance(){let e=globalThis;return e[y]||(e[y]=new r),e[y]}setConfig(e){this.config=e;}getConfig(){return this.config}start(){this.isRunning||(this.isRunning=true,window.addEventListener("gamepadconnected",e=>{import.meta.env?.DEV&&console.log("[OmniPad-DOM] Gamepad Connected:",e.gamepad.id);}),window.addEventListener("gamepaddisconnected",()=>{import.meta.env?.DEV&&console.log("[OmniPad-DOM] Gamepad disconnected.");}),this.loop());}stop(){this.isRunning=false;}processButtons(e,t,n){t.buttons&&Object.entries(t.buttons).forEach(([i,s])=>{let a=G[i];if(a===void 0||!e.buttons[a])return;let c=e.buttons[a].pressed,l=this.lastButtonStates[n][a]||false;c&&!l?this.triggerVirtualEntity(s,"down"):!c&&l&&this.triggerVirtualEntity(s,"up"),this.lastButtonStates[n][a]=c;});}processDPad(e,t){let n=t?.dpad;if(!n)return;let i=e.buttons[12]?.pressed?-1:0,s=e.buttons[13]?.pressed?1:0,a=e.buttons[14]?.pressed?-1:0,c=e.buttons[15]?.pressed?1:0,l=a+c,g=i+s;this.triggerVirtualEntity(n,"vector",{x:l,y:g});}processAxes(e,t){let n=t?.deadzone??.1;if(t?.leftStick){let i=Math.abs(e.axes[0])>n?e.axes[0]:0,s=Math.abs(e.axes[1])>n?e.axes[1]:0;this.triggerVirtualEntity(t.leftStick,"vector",{x:i,y:s});}if(t?.rightStick){let i=Math.abs(e.axes[2])>n?e.axes[2]:0,s=Math.abs(e.axes[3])>n?e.axes[3]:0;this.triggerVirtualEntity(t.rightStick,"vector",{x:i,y:s});}}triggerVirtualEntity(e,t,n){let i=b$2.getInstance().getEntity(e);!i||i.activePointerId!=null||(t==="down"&&typeof i.triggerDown=="function"&&i.triggerDown(),t==="up"&&typeof i.triggerUp=="function"&&i.triggerUp(),t==="vector"&&typeof i.triggerVector=="function"&&n&&i.triggerVector(n.x,n.y));}};var P=Symbol.for("omnipad.window_manager.instance"),A=class r{constructor(){a(this,"_isListening",false);a(this,"throttledReset");a(this,"handleGlobalReset",()=>{import.meta.env?.DEV&&console.debug("[OmniPad-DOM] Safety reset triggered by environment change."),b$2.getInstance().resetAll(),b$2.getInstance().markAllRectDirty(),u.getInstance().markAllRectDirty();});a(this,"handleResizeReset",()=>{this.throttledReset(null);});a(this,"handleBlurReset",()=>{this.handleGlobalReset();});a(this,"handleScrollReset",()=>{this.throttledReset(null);});a(this,"handleVisibilityChangeReset",()=>{document.visibilityState==="hidden"&&this.handleGlobalReset();});this.throttledReset=e(()=>{this.handleGlobalReset();});}static getInstance(){let e=globalThis;return e[P]||(e[P]=new r),e[P]}init(){this._isListening||(window.addEventListener("resize",this.handleResizeReset),window.addEventListener("blur",this.handleBlurReset),window.addEventListener("scroll",this.handleScrollReset,{capture:true,passive:true}),document.addEventListener("visibilitychange",this.handleVisibilityChangeReset),this._isListening=true,import.meta.env?.DEV&&console.log("[OmniPad-DOM] Global WindowManager monitoring started."));}async toggleFullscreen(e){let t=e||document.documentElement;try{document.fullscreenElement?(this.handleGlobalReset(),await document.exitFullscreen()):(this.handleGlobalReset(),await t.requestFullscreen());}catch(n){console.error("[OmniPad-DOM] Fullscreen toggle failed:",n);}}isFullscreen(){return !!document.fullscreenElement}destroy(){window.removeEventListener("resize",this.handleResizeReset),window.removeEventListener("blur",this.handleBlurReset),window.removeEventListener("scroll",this.handleScrollReset,{capture:true}),window.removeEventListener("visibilitychange",this.handleVisibilityChangeReset),this._isListening=false;}};export{m as ElementObserver,D as GamepadManager,u as IframeManager,A as WindowManager,ie as createPointerBridge,fe as createWebStickyProvider,J as dispatchKeyboardEvent,Z as dispatchPointerEventAtPos,le as flattenToHostLayout,V as focusElement,ee as reclaimFocusAtPos,w as safeReleaseCapture,_ as safeSetCapture,se as supportsContainerQueries,B as toAbsolutePx};

package/dist/guest/index.cjs

@@ -0,0 +1 @@
+'use strict';var chunk42WBUPM3_cjs=require('../chunk-42WBUPM3.cjs'),chunkHCOFKHVV_cjs=require('../chunk-HCOFKHVV.cjs');var d=false,t=[];function g(c){d||(t=c.allowedOrigins,d=true,window.addEventListener("message",r=>{if(t!=="*"){if(!t.includes(r.origin)){undefined?.DEV&&console.warn(`[OmniPad-IPC] Blocked message from unauthorized origin: ${r.origin}`);return}}else if(!undefined?.DEV)throw new Error("Security Risk: Origin wildcard '*' is forbidden in production.");let e=r.data;if(e?.signature===chunkHCOFKHVV_cjs.b)try{if(e.type==="pointer"){let{x:i,y:o,opts:l}=e.payload;if(!Number.isFinite(i)||!Number.isFinite(o))return;chunk42WBUPM3_cjs.f(e.action,i,o,l);}else e.type==="keyboard"&&chunk42WBUPM3_cjs.d(e.action,e.payload);}catch(i){console.error("[OmniPad-IPC] Error dispatching guest event:",i);}}),undefined?.DEV&&console.log("[OmniPad-IPC] Iframe receiver active and listening for Host commands."));}exports.initIframeReceiver=g;

package/dist/guest/index.d.cts

@@ -0,0 +1,21 @@
+/**
+ * Options for configuring the Iframe receiver security.
+ */
+interface ReceiverOptions {
+    /**
+     * A whitelist of allowed parent origins.
+     * Only messages from these origins will be processed.
+     * Use '*' to allow all (not recommended for production).
+     * @example ['https://your-main-site.com', 'http://localhost:5173']
+     */
+    allowedOrigins: string[] | '*';
+}
+/**
+ * Initializes the Iframe IPC receiver.
+ * Must be executed within the context of the guest iframe.
+ *
+ * @param options - Security configuration for the receiver.
+ */
+declare function initIframeReceiver(options: ReceiverOptions): void;
+
+export { type ReceiverOptions, initIframeReceiver };

package/dist/guest/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Options for configuring the Iframe receiver security.
+ */
+interface ReceiverOptions {
+    /**
+     * A whitelist of allowed parent origins.
+     * Only messages from these origins will be processed.
+     * Use '*' to allow all (not recommended for production).
+     * @example ['https://your-main-site.com', 'http://localhost:5173']
+     */
+    allowedOrigins: string[] | '*';
+}
+/**
+ * Initializes the Iframe IPC receiver.
+ * Must be executed within the context of the guest iframe.
+ *
+ * @param options - Security configuration for the receiver.
+ */
+declare function initIframeReceiver(options: ReceiverOptions): void;
+
+export { type ReceiverOptions, initIframeReceiver };

package/dist/guest/index.mjs

@@ -0,0 +1 @@
+import {f,d as d$1}from'../chunk-6XY2ZHZ3.mjs';import {b}from'../chunk-HQNUZXP5.mjs';var d=false,t=[];function g(c){d||(t=c.allowedOrigins,d=true,window.addEventListener("message",r=>{if(t!=="*"){if(!t.includes(r.origin)){import.meta.env?.DEV&&console.warn(`[OmniPad-IPC] Blocked message from unauthorized origin: ${r.origin}`);return}}else if(!import.meta.env?.DEV)throw new Error("Security Risk: Origin wildcard '*' is forbidden in production.");let e=r.data;if(e?.signature===b)try{if(e.type==="pointer"){let{x:i,y:o,opts:l}=e.payload;if(!Number.isFinite(i)||!Number.isFinite(o))return;f(e.action,i,o,l);}else e.type==="keyboard"&&d$1(e.action,e.payload);}catch(i){console.error("[OmniPad-IPC] Error dispatching guest event:",i);}}),import.meta.env?.DEV&&console.log("[OmniPad-IPC] Iframe receiver active and listening for Host commands."));}export{g as initIframeReceiver};