@riverty/web-components 6.3.0 → 6.3.1

package/dist/collection/components/popover/popover.js

@@ -0,0 +1,741 @@
+import { Host, h } from "@stencil/core";
+export class Popover {
+    constructor() {
+        /**
+         * Defines the behavior of the popover's dismissing.
+         * - `auto`: The popover can be dismissed by clicking outside or pressing Esc.
+         * - `manual`: The popover requires explicit user action to close.
+         * @default "auto"
+         */
+        this.dismissMode = 'auto';
+        /**
+         * Defines the action that will be triggered when the trigger is clicked.
+         * - `toggle`: Toggle the popover open/closed state
+         * - `show`: Only show the popover
+         * - `hide`: Only hide the popover
+         * @default "toggle"
+         */
+        this.triggerAction = 'toggle';
+        /**
+         * Defines preferred placement vertically relative to the trigger.
+         * - `top`: Position above the trigger
+         * - `bottom`: Position below the trigger
+         * - `middle`: Position to the side of the trigger
+         * @default "bottom"
+         */
+        this.vertical = 'bottom';
+        /**
+         * Defines preferred placement horizontally relative to the trigger.
+         * - `left`: Align to the left of the trigger
+         * - `center`: Center align with the trigger
+         * - `right`: Align to the right of the trigger
+         * @default "center"
+         */
+        this.horizontal = 'center';
+        /** Indicates if popover is shown */
+        this.isOpen = false;
+        this._focusOnElement = element => {
+            var _a, _b;
+            if (!element) {
+                return;
+            }
+            if (typeof element.setFocus === 'function') {
+                (_a = element === null || element === void 0 ? void 0 : element.setFocus) === null || _a === void 0 ? void 0 : _a.call(element);
+                return;
+            }
+            (_b = element === null || element === void 0 ? void 0 : element.focus) === null || _b === void 0 ? void 0 : _b.call(element);
+            this.focusPopover.emit();
+            return this;
+        };
+        this.uniqueId = `r-popover-${Date.now().toString(16)}${Math.random().toString(32)}`.replace(/\./g, '');
+        this.onToggle = event => {
+            if (event.newState === 'open') {
+                this.isOpen = true;
+                requestAnimationFrame(() => {
+                    this.renderPosition();
+                    this.setFocus();
+                });
+                return this;
+            }
+            this.isOpen = false;
+            requestAnimationFrame(() => {
+                this.setBlur();
+                const interactiveElement = this.getInteractiveElement(this.activeElement || this.triggerElement);
+                interactiveElement === null || interactiveElement === void 0 ? void 0 : interactiveElement.focus();
+            });
+        };
+        this.onClickDismiss = () => {
+            this.hide();
+        };
+        this.updateTriggerAttributes = () => {
+            const interactiveElement = this.getInteractiveElement(this.activeElement);
+            interactiveElement === null || interactiveElement === void 0 ? void 0 : interactiveElement.setAttribute('aria-expanded', `${this.isOpen}`);
+        };
+        this.onKeyDown = async (event) => {
+            if (event.key === 'Tab') {
+                event.preventDefault();
+                const target = event.target;
+                const filteredElements = await this._getFocusable();
+                const id = filteredElements.indexOf(target);
+                if (event.shiftKey) {
+                    // Shift+Tab - move focus backwards
+                    const elementToFocus = id ? filteredElements[id - 1] : filteredElements[filteredElements.length - 1];
+                    this._focusOnElement(elementToFocus);
+                }
+                else {
+                    // Tab - move focus forwards
+                    const elementToFocus = id < filteredElements.length - 1 ? filteredElements[id + 1] : filteredElements[0];
+                    this._focusOnElement(elementToFocus);
+                }
+            }
+        };
+    }
+    /**
+     * Method to show the popover.
+     * Opens the popover, positions it correctly, and sets focus to appropriate element.
+     * @returns Promise that resolves when the popover is shown
+     */
+    async show() {
+        this.isOpen = true;
+    }
+    /**
+     * Method to hide the popover.
+     * Closes the popover and emits hide event.
+     * @returns Promise that resolves when the popover is hidden
+     */
+    async hide() {
+        this.isOpen = false;
+    }
+    /**
+     * Toggle popover visibility.
+     * Shows the popover if hidden, hides it if shown.
+     * @returns Promise that resolves when the toggle action is complete
+     */
+    async toggle() {
+        this.isOpen ? this.hide() : this.show();
+    }
+    /**
+     * Set focus inside the popover to the most appropriate element.
+     * Priority order:
+     * 1. Dismiss button (if present)
+     * 2. Action element (if present)
+     * 3. Content element (if present)
+     * 4. Host element as fallback
+     * @returns Promise that resolves to the popover instance for chaining
+     */
+    async setFocus() {
+        if (!this.isOpen)
+            return this;
+        const filteredElements = await this._getFocusable();
+        this._focusOnElement(filteredElements[0]);
+        return this;
+    }
+    async _getFocusable() {
+        const { dismissElement } = this;
+        const contentElement = this.host.querySelector('r-popover-content');
+        const actionElement = this.host.querySelector('r-popover-action');
+        const elements = [dismissElement, ...await contentElement.getActiveElements(), ...await actionElement.getActiveElements()];
+        return elements.filter(element => element !== undefined);
+    }
+    /**
+     * Remove focus from all focusable elements within the popover.
+     * Calls setBlur on all child components and the host element.
+     * @returns Promise that resolves to the popover instance for chaining
+     */
+    async setBlur() {
+        if (!this.isOpen)
+            return this;
+        const { dismissElement } = this;
+        const contentElement = this.host.querySelector('r-popover-content');
+        const actionElement = this.host.querySelector('r-popover-action');
+        const triggerElement = this.host.querySelector('r-popover-trigger');
+        dismissElement === null || dismissElement === void 0 ? void 0 : dismissElement.setBlur();
+        contentElement === null || contentElement === void 0 ? void 0 : contentElement.setBlur();
+        actionElement === null || actionElement === void 0 ? void 0 : actionElement.setBlur();
+        triggerElement === null || triggerElement === void 0 ? void 0 : triggerElement.setBlur();
+        this.host.blur();
+        return this;
+    }
+    handleOpenChange() {
+        this.open ? this.show() : this.hide();
+    }
+    watchOpen() {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+        if (this.isOpen) {
+            (_b = (_a = this.boardElement) === null || _a === void 0 ? void 0 : _a.showPopover) === null || _b === void 0 ? void 0 : _b.call(_a);
+            (_d = (_c = this.showPopover) === null || _c === void 0 ? void 0 : _c.emit) === null || _d === void 0 ? void 0 : _d.call(_c);
+        }
+        else {
+            (_f = (_e = this.boardElement) === null || _e === void 0 ? void 0 : _e.hidePopover) === null || _f === void 0 ? void 0 : _f.call(_e);
+            (_h = (_g = this.hidePopover) === null || _g === void 0 ? void 0 : _g.emit) === null || _h === void 0 ? void 0 : _h.call(_g);
+        }
+        (_k = (_j = this.popoverOpenChange) === null || _j === void 0 ? void 0 : _j.emit) === null || _k === void 0 ? void 0 : _k.call(_j);
+        this.updateTriggerAttributes();
+    }
+    handlePreferredPositionChange() {
+        this.renderPosition();
+    }
+    onKeyup(event) {
+        if (!this.isOpen)
+            return this;
+        if (event.key === 'Escape')
+            this.hide();
+    }
+    onResize() {
+        if (this.isOpen)
+            this.renderPosition();
+    }
+    onScroll() {
+        if (this.isOpen)
+            this.renderPosition();
+    }
+    get hasDismiss() {
+        return this.dismissMode === 'manual';
+    }
+    get triggerRect() {
+        var _a;
+        return (_a = this.triggerElement) === null || _a === void 0 ? void 0 : _a.getBoundingClientRect();
+    }
+    get boardRect() {
+        var _a;
+        return (_a = this.boardElement) === null || _a === void 0 ? void 0 : _a.getBoundingClientRect();
+    }
+    get activeElement() {
+        var _a;
+        return (_a = this.host.querySelector('r-popover-trigger')) === null || _a === void 0 ? void 0 : _a.querySelector('r-button, r-icon-button, a, button, [tabindex]:not([tabindex="-1"])');
+    }
+    get headlineSlotContent() {
+        var _a;
+        const el = this.host.querySelector('[slot="headline"]');
+        return (_a = el === null || el === void 0 ? void 0 : el.textContent) === null || _a === void 0 ? void 0 : _a.trim();
+    }
+    /**
+     * Gets the actual interactive element (button/link) from within r-button or r-icon-button shadow DOM,
+     * or returns the element itself if it's already interactive
+     */
+    getInteractiveElement(element) {
+        if (!element)
+            return null;
+        if (element.tagName === 'R-BUTTON' || element.tagName === 'R-ICON-BUTTON') {
+            const shadowRoot = element.shadowRoot;
+            if (shadowRoot) {
+                return shadowRoot.querySelector('button, a');
+            }
+        }
+        return element;
+    }
+    /** Position logic */
+    renderPosition() {
+        if (!this.triggerRect)
+            return this;
+        const { triggerRect, boardRect, vertical, horizontal } = this;
+        // Hide if trigger completely out of viewport
+        const viewportW = window.innerWidth;
+        const viewportH = window.innerHeight;
+        const isTriggerOutOfView = triggerRect.bottom < 0 || triggerRect.right < 0 || triggerRect.top > viewportH || triggerRect.left > viewportW;
+        if (isTriggerOutOfView) {
+            this.hide();
+            return this;
+        }
+        // Update CSS variables
+        this.host.setAttribute('style', `
+      --r-popover--trigger--width: ${triggerRect.width}px;
+      --r-popover--trigger--height: ${triggerRect.height}px;
+      --r-popover--trigger--left: ${triggerRect.left}px;
+      --r-popover--trigger--top: ${triggerRect.top}px;
+    `);
+        // Available space
+        const space = {
+            top: triggerRect.top,
+            right: viewportW - triggerRect.right,
+            bottom: viewportH - triggerRect.bottom,
+            left: triggerRect.left
+        };
+        const cssValue = varName => getComputedStyle(this.host).getPropertyValue(varName);
+        const remInPixels = value => value.includes('rem') ? parseFloat(value) * parseFloat(getComputedStyle(document.documentElement).fontSize) : parseFloat(value);
+        const BOARD_SHIFT = remInPixels(cssValue('--board--shift')) || 0;
+        const POINTER_HEIGHT = remInPixels(cssValue('--pointer--height')) || 0;
+        const spaceBoardOccupiesVertically = boardRect.height + POINTER_HEIGHT;
+        let spaceBoardOccupiesHorizontally = boardRect.width - triggerRect.width - BOARD_SHIFT;
+        const hasPossiblePosition = object => Object.values(object).filter(Boolean).length > 0;
+        const getPossiblePosition = object => Object.keys(object).find(pos => object[pos]);
+        const fits = {
+            vertical: {},
+            horizontal: {}
+        };
+        fits['vertical'] = {
+            top: space.top >= spaceBoardOccupiesVertically,
+            bottom: space.bottom >= spaceBoardOccupiesVertically,
+            middle: space.bottom > (boardRect.height - triggerRect.height - POINTER_HEIGHT) / 2 && space.top > (boardRect.height - triggerRect.height) / 2
+        };
+        if (fits['vertical'].middle || !hasPossiblePosition(fits.vertical)) {
+            spaceBoardOccupiesHorizontally = boardRect.width + BOARD_SHIFT;
+        }
+        fits['horizontal'] = {
+            left: space.left >= spaceBoardOccupiesHorizontally,
+            right: space.right > boardRect.width - triggerRect.width - BOARD_SHIFT,
+            center: space.left > boardRect.width / 2 && space.right > boardRect.width / 2
+        };
+        // Let cover be a "backup"
+        let verticalPosition = 'cover';
+        if (fits.vertical[vertical]) {
+            verticalPosition = vertical;
+        }
+        else if (hasPossiblePosition(fits.vertical)) {
+            verticalPosition = getPossiblePosition(fits.vertical);
+        }
+        // Let cover be a "backup"
+        let horizontalPosition = 'cover';
+        if (fits.horizontal[horizontal]) {
+            horizontalPosition = horizontal;
+        }
+        else if (hasPossiblePosition(fits.horizontal)) {
+            horizontalPosition = getPossiblePosition(fits.horizontal);
+        }
+        if (verticalPosition === 'cover') {
+            const triggerBottom = this.triggerRect.top + this.triggerRect.height;
+            if (triggerBottom > this.boardRect.height) {
+                // When vertical position is 'cover', center the popover vertically on the trigger
+                const boardTop = triggerBottom - this.boardRect.height;
+                this.host.style.setProperty('--r-popover--board--top', `${boardTop}px`);
+                this.host.style.setProperty('--r-popover--pointer--top', `${this.triggerRect.top + this.triggerRect.height / 2 - POINTER_HEIGHT / 2 - boardTop}px`);
+            }
+        }
+        // Apply attributes for CSS
+        this.host.setAttribute('data-vertical', verticalPosition);
+        this.host.setAttribute('data-horizontal', horizontalPosition);
+        return this;
+    }
+    setTriggerInitialAttributes() {
+        const interactiveElement = this.getInteractiveElement(this.activeElement);
+        interactiveElement === null || interactiveElement === void 0 ? void 0 : interactiveElement.setAttribute('aria-haspopup', 'dialog');
+        interactiveElement === null || interactiveElement === void 0 ? void 0 : interactiveElement.setAttribute('aria-expanded', `${this.isOpen}`);
+    }
+    componentDidLoad() {
+        var _a;
+        this.open ? this.show() : this.hide();
+        this.setTriggerInitialAttributes();
+        (_a = this.activeElement) === null || _a === void 0 ? void 0 : _a.addEventListener('click', () => {
+            this.toggle();
+        });
+    }
+    render() {
+        const TAG = !this.activeElement ? 'button' : 'div';
+        return (h(Host, { key: '655880fb3d3f069e13bc7025f932abc192df8918', id: this.uniqueId, "data-position": this.positionState, "data-open": `${this.isOpen}`, open: this.isOpen }, h("div", { key: '6617392de14d78a1a53172fc689245749f01909a', class: "r-popover" }, h(TAG, { key: '87dc99d5ab380b7f288fa9fba0e861feacff6e20', class: "r-popover--trigger", "aria-label": !this.activeElement ? this.triggerAriaLabel : null, ref: el => this.triggerElement = el, "aria-haspopup": "dialog", popoverTarget: !this.activeElement ? `${this.uniqueId}-board` : null, popoverTargetAction: !this.activeElement ? this.triggerAction : null }, h("slot", { key: '51c875b84c1311e40292cf7fe80f7753fcd15abf', name: "trigger" })), h("div", { key: '24a2d6a90d0fe9167a08328e80ed6164c94170f0', class: "r-popover--board", id: `${this.uniqueId}-board`, role: "dialog", "aria-label": this.headlineSlotContent, popover: this.dismissMode, ref: el => this.boardElement = el, onToggle: this.onToggle, onKeyDown: this.onKeyDown }, this.hasDismiss &&
+            h("r-icon-button", { key: '51e2563b582c5300eff1a032829bfdfb4947bdb6', ref: el => this.dismissElement = el, class: "r-popover--dismiss", name: "cross", onClick: this.onClickDismiss, label: this.dismissAriaLabel }), h("div", { key: '6abf0772e1b45c1c6be7eeeb5a0b37469e17c4de', class: "r-popover--board-content" }, h("slot", { key: 'd4af6923192d72fb77e0591dbc9f163965fdb9b7', name: "headline" }), h("slot", { key: '469fb95a09ce36ad41b7a76e3f09c8834c4e7e14', name: "content" }), h("slot", { key: '17145240e43b06ae7186ad8d46a3d10b7996d3f2', name: "action" })), h("div", { key: '68e7ce9cdbe5c5b765d5866d9ea6c80d6b830630', class: "r-popover--board-pointer", "aria-hidden": "true" }, h("svg", { key: '55d0e368d2af54a082fc8323b9b1e40457a5a62b', width: "16", height: "8", viewBox: "0 0 16 8", fill: "none", xmlns: "http://www.w3.org/2000/svg" }, h("path", { key: '86db95e48bed58187dea614c81527f6bd7ef9f3e', d: "M8 8L0 0L16 0L8 8Z", fill: "currentColor" })))))));
+    }
+    static get is() { return "r-popover"; }
+    static get encapsulation() { return "shadow"; }
+    static get originalStyleUrls() {
+        return {
+            "$": ["popover.css"]
+        };
+    }
+    static get styleUrls() {
+        return {
+            "$": ["popover.css"]
+        };
+    }
+    static get properties() {
+        return {
+            "open": {
+                "type": "boolean",
+                "attribute": "open",
+                "mutable": false,
+                "complexType": {
+                    "original": "boolean",
+                    "resolved": "boolean",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [{
+                            "name": "default",
+                            "text": "false"
+                        }],
+                    "text": "Defines initial state of the popover visibility."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": true
+            },
+            "dismissMode": {
+                "type": "string",
+                "attribute": "dismiss-mode",
+                "mutable": false,
+                "complexType": {
+                    "original": "PopoverDismissMode",
+                    "resolved": "\"auto\" | \"manual\"",
+                    "references": {
+                        "PopoverDismissMode": {
+                            "location": "import",
+                            "path": "./exports",
+                            "id": "src/components/popover/exports.ts::PopoverDismissMode"
+                        }
+                    }
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [{
+                            "name": "default",
+                            "text": "\"auto\""
+                        }],
+                    "text": "Defines the behavior of the popover's dismissing.\n- `auto`: The popover can be dismissed by clicking outside or pressing Esc.\n- `manual`: The popover requires explicit user action to close."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": true,
+                "defaultValue": "'auto'"
+            },
+            "dismissAriaLabel": {
+                "type": "string",
+                "attribute": "dismiss-aria-label",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": "Defines `aria-label` content for the dismiss button.\nUsed for accessibility when dismiss button is present."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false
+            },
+            "triggerAction": {
+                "type": "string",
+                "attribute": "trigger-action",
+                "mutable": false,
+                "complexType": {
+                    "original": "PopoverTriggerAction",
+                    "resolved": "\"hide\" | \"show\" | \"toggle\"",
+                    "references": {
+                        "PopoverTriggerAction": {
+                            "location": "import",
+                            "path": "../popover-trigger/exports",
+                            "id": "src/components/popover-trigger/exports.ts::PopoverTriggerAction"
+                        }
+                    }
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [{
+                            "name": "default",
+                            "text": "\"toggle\""
+                        }],
+                    "text": "Defines the action that will be triggered when the trigger is clicked.\n- `toggle`: Toggle the popover open/closed state\n- `show`: Only show the popover\n- `hide`: Only hide the popover"
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": true,
+                "defaultValue": "'toggle'"
+            },
+            "triggerAriaLabel": {
+                "type": "string",
+                "attribute": "trigger-aria-label",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": "Defines `aria-label` content for the popover trigger.\nUsed for accessibility to describe the trigger button."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false
+            },
+            "vertical": {
+                "type": "string",
+                "attribute": "vertical",
+                "mutable": false,
+                "complexType": {
+                    "original": "PopoverVertical",
+                    "resolved": "\"bottom\" | \"cover\" | \"middle\" | \"top\"",
+                    "references": {
+                        "PopoverVertical": {
+                            "location": "import",
+                            "path": "./exports",
+                            "id": "src/components/popover/exports.ts::PopoverVertical"
+                        }
+                    }
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [{
+                            "name": "default",
+                            "text": "\"bottom\""
+                        }],
+                    "text": "Defines preferred placement vertically relative to the trigger.\n- `top`: Position above the trigger\n- `bottom`: Position below the trigger\n- `middle`: Position to the side of the trigger"
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "defaultValue": "'bottom'"
+            },
+            "horizontal": {
+                "type": "string",
+                "attribute": "horizontal",
+                "mutable": false,
+                "complexType": {
+                    "original": "PopoverHorizontal",
+                    "resolved": "\"center\" | \"cover\" | \"left\" | \"right\"",
+                    "references": {
+                        "PopoverHorizontal": {
+                            "location": "import",
+                            "path": "./exports",
+                            "id": "src/components/popover/exports.ts::PopoverHorizontal"
+                        }
+                    }
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [{
+                            "name": "default",
+                            "text": "\"center\""
+                        }],
+                    "text": "Defines preferred placement horizontally relative to the trigger.\n- `left`: Align to the left of the trigger\n- `center`: Center align with the trigger\n- `right`: Align to the right of the trigger"
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "defaultValue": "'center'"
+            }
+        };
+    }
+    static get states() {
+        return {
+            "positionState": {},
+            "isOpen": {}
+        };
+    }
+    static get events() {
+        return [{
+                "method": "popoverOpenChange",
+                "name": "popoverOpenChange",
+                "bubbles": true,
+                "cancelable": true,
+                "composed": true,
+                "docs": {
+                    "tags": [],
+                    "text": "Emits when open state changes"
+                },
+                "complexType": {
+                    "original": "{ open: boolean }",
+                    "resolved": "{ open: boolean; }",
+                    "references": {}
+                }
+            }, {
+                "method": "hidePopover",
+                "name": "hidePopover",
+                "bubbles": true,
+                "cancelable": true,
+                "composed": true,
+                "docs": {
+                    "tags": [],
+                    "text": "Emits when popover is hidden"
+                },
+                "complexType": {
+                    "original": "void",
+                    "resolved": "void",
+                    "references": {}
+                }
+            }, {
+                "method": "showPopover",
+                "name": "showPopover",
+                "bubbles": true,
+                "cancelable": true,
+                "composed": true,
+                "docs": {
+                    "tags": [],
+                    "text": "Emits when popover is shown"
+                },
+                "complexType": {
+                    "original": "void",
+                    "resolved": "void",
+                    "references": {}
+                }
+            }, {
+                "method": "focusPopover",
+                "name": "focusPopover",
+                "bubbles": true,
+                "cancelable": true,
+                "composed": true,
+                "docs": {
+                    "tags": [],
+                    "text": "Emits when popover focus is set"
+                },
+                "complexType": {
+                    "original": "void",
+                    "resolved": "void",
+                    "references": {}
+                }
+            }];
+    }
+    static get methods() {
+        return {
+            "show": {
+                "complexType": {
+                    "signature": "() => Promise<void>",
+                    "parameters": [],
+                    "references": {
+                        "Promise": {
+                            "location": "global",
+                            "id": "global::Promise"
+                        }
+                    },
+                    "return": "Promise<void>"
+                },
+                "docs": {
+                    "text": "Method to show the popover.\nOpens the popover, positions it correctly, and sets focus to appropriate element.",
+                    "tags": [{
+                            "name": "returns",
+                            "text": "Promise that resolves when the popover is shown"
+                        }]
+                }
+            },
+            "hide": {
+                "complexType": {
+                    "signature": "() => Promise<void>",
+                    "parameters": [],
+                    "references": {
+                        "Promise": {
+                            "location": "global",
+                            "id": "global::Promise"
+                        }
+                    },
+                    "return": "Promise<void>"
+                },
+                "docs": {
+                    "text": "Method to hide the popover.\nCloses the popover and emits hide event.",
+                    "tags": [{
+                            "name": "returns",
+                            "text": "Promise that resolves when the popover is hidden"
+                        }]
+                }
+            },
+            "toggle": {
+                "complexType": {
+                    "signature": "() => Promise<void>",
+                    "parameters": [],
+                    "references": {
+                        "Promise": {
+                            "location": "global",
+                            "id": "global::Promise"
+                        }
+                    },
+                    "return": "Promise<void>"
+                },
+                "docs": {
+                    "text": "Toggle popover visibility.\nShows the popover if hidden, hides it if shown.",
+                    "tags": [{
+                            "name": "returns",
+                            "text": "Promise that resolves when the toggle action is complete"
+                        }]
+                }
+            },
+            "setFocus": {
+                "complexType": {
+                    "signature": "() => Promise<this>",
+                    "parameters": [],
+                    "references": {
+                        "Promise": {
+                            "location": "global",
+                            "id": "global::Promise"
+                        }
+                    },
+                    "return": "Promise<this>"
+                },
+                "docs": {
+                    "text": "Set focus inside the popover to the most appropriate element.\nPriority order:\n1. Dismiss button (if present)\n2. Action element (if present)\n3. Content element (if present)\n4. Host element as fallback",
+                    "tags": [{
+                            "name": "returns",
+                            "text": "Promise that resolves to the popover instance for chaining"
+                        }]
+                }
+            },
+            "setBlur": {
+                "complexType": {
+                    "signature": "() => Promise<this>",
+                    "parameters": [],
+                    "references": {
+                        "Promise": {
+                            "location": "global",
+                            "id": "global::Promise"
+                        },
+                        "HTMLRPopoverContentElement": {
+                            "location": "global",
+                            "id": "global::HTMLRPopoverContentElement"
+                        },
+                        "HTMLRPopoverActionElement": {
+                            "location": "global",
+                            "id": "global::HTMLRPopoverActionElement"
+                        },
+                        "HTMLRPopoverTriggerElement": {
+                            "location": "global",
+                            "id": "global::HTMLRPopoverTriggerElement"
+                        }
+                    },
+                    "return": "Promise<this>"
+                },
+                "docs": {
+                    "text": "Remove focus from all focusable elements within the popover.\nCalls setBlur on all child components and the host element.",
+                    "tags": [{
+                            "name": "returns",
+                            "text": "Promise that resolves to the popover instance for chaining"
+                        }]
+                }
+            }
+        };
+    }
+    static get elementRef() { return "host"; }
+    static get watchers() {
+        return [{
+                "propName": "open",
+                "methodName": "handleOpenChange"
+            }, {
+                "propName": "isOpen",
+                "methodName": "watchOpen"
+            }, {
+                "propName": "horizontal",
+                "methodName": "handlePreferredPositionChange"
+            }, {
+                "propName": "vertical",
+                "methodName": "handlePreferredPositionChange"
+            }];
+    }
+    static get listeners() {
+        return [{
+                "name": "keyup",
+                "method": "onKeyup",
+                "target": "window",
+                "capture": false,
+                "passive": false
+            }, {
+                "name": "resize",
+                "method": "onResize",
+                "target": "window",
+                "capture": false,
+                "passive": true
+            }, {
+                "name": "scroll",
+                "method": "onScroll",
+                "target": "window",
+                "capture": false,
+                "passive": true
+            }];
+    }
+}