@aceshooting/lyra-ui 4.2.0 → 5.0.0

package/dist/components/overlays/overlay/popover.class.d.ts

@@ -0,0 +1,91 @@
+import { type PropertyValues, type TemplateResult } from 'lit';
+import type { Placement } from '@floating-ui/dom';
+import { LyraElement } from '../../../internal/lyra-element.js';
+export interface LyraPopoverEventMap {
+    'lr-show': CustomEvent<undefined>;
+    'lr-hide': CustomEvent<undefined>;
+}
+/**
+ * `<lr-popover>` — a click-triggered, light-dismiss floating surface.
+ *
+ * @customElement lr-popover
+ * @slot trigger - The interactive element that toggles the popover.
+ * @slot - Popover content.
+ * @event lr-show - The popover opened.
+ * @event lr-hide - The popover closed.
+ * @csspart trigger - The trigger wrapper.
+ * @csspart popup - The positioned popup.
+ * @csspart content - The content wrapper.
+ * @cssprop --lr-overlay-max-inline-size - Maximum inline size of the popup (default `--lr-size-20rem`).
+ */
+export declare class LyraPopover extends LyraElement<LyraPopoverEventMap> {
+    static styles: import("lit").CSSResultGroup[];
+    open: boolean;
+    placement: Placement;
+    /** Anchor-offset distance (px) passed to Floating UI's `offset()` middleware. Can legitimately
+     *  be negative (overlaps the popup with the trigger); NaN/non-finite falls back to the default. */
+    distance: number;
+    accessibleLabel: string;
+    /** Semantic role used by the popup. Dropdown subclasses set this to `menu`. */
+    popupRole: 'dialog' | 'menu';
+    private trigger?;
+    /** The virtual anchor set by `showAt()`, taking priority over `trigger` for positioning while
+     *  set. Cleared whenever the popover closes, so a later `open = true` with no fresh `showAt()`
+     *  call reverts to plain trigger-based behavior. */
+    private virtualAnchor?;
+    /** `options.returnFocusTo` from the `showAt()` call that opened the popover, if any -- see
+     *  `showAt()`'s doc comment and `onVirtualAnchorKeyDown`. */
+    private returnFocusTo?;
+    private cleanup?;
+    private readonly popupId;
+    private firstUpdate;
+    protected updated(changed: PropertyValues): void;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    /**
+     * Opens the popover anchored to an arbitrary rectangle instead of the slotted `trigger` -- for
+     * anchoring to a graph node, a canvas pixel, a chart datum, or any other non-DOM location.
+     * `width`/`height` default to `0` (a point). Positions exactly as `place()` would against a real
+     * element (flip/shift/RTL all apply unchanged).
+     *
+     * A virtual anchor has no DOM node, so `autoUpdate()` can't track it moving on its own -- call
+     * `showAt()` again with fresh coordinates to re-anchor an already-open popover (e.g. on a graph
+     * pan/zoom tick); the popover stays open across such a call, it does not toggle. Pass
+     * `rect.contextElement` (a real, still-connected element near the virtual point) when available
+     * so `autoUpdate()` has something to observe for ancestor-scroll/resize tracking; omitting it
+     * still works, it just means only explicit re-`showAt()` calls keep the popover anchored.
+     *
+     * A virtual anchor also has no `.focus()`. Escape and light-dismiss return focus to
+     * `options.returnFocusTo` when supplied, or skip focus-return entirely otherwise -- refocusing
+     * the right place after a virtual anchor closes is the host's responsibility, since Lyra can't
+     * assume how e.g. a graph node's own keyboard model wants focus back.
+     */
+    showAt(rect: {
+        x: number;
+        y: number;
+        width?: number;
+        height?: number;
+        contextElement?: Element;
+    }, options?: {
+        returnFocusTo?: HTMLElement;
+    }): void;
+    private position;
+    private syncTriggerA11y;
+    private onTriggerSlotChange;
+    private onTriggerClick;
+    private onTriggerKeyDown;
+    private onPopupKeyDown;
+    /** Escape handling for a popover opened via `showAt()` -- bound at the document level (not
+     *  scoped to the trigger/popup elements) while such a popover is open, since a virtual anchor
+     *  has no slotted trigger or (typically) focused popup content for `onTriggerKeyDown`/
+     *  `onPopupKeyDown` above to catch Escape through. */
+    private onVirtualAnchorKeyDown;
+    private onDocumentPointer;
+    render(): TemplateResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'lr-popover': LyraPopover;
+    }
+}
+//# sourceMappingURL=popover.class.d.ts.map

package/dist/components/overlays/overlay/popover.class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"popover.class.d.ts","sourceRoot":"","sources":["../../../../src/components/overlays/overlay/popover.class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAErE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAUhE,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;IAClC,SAAS,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;CACnC;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,WAAY,SAAQ,WAAW,CAAC,mBAAmB,CAAC;IAC/D,MAAM,CAAC,MAAM,iCAAgC;IACD,IAAI,UAAS;IAC5B,SAAS,EAAE,SAAS,CAAkB;IACnE;uGACmG;IACvE,QAAQ,SAAoB;IACjB,eAAe,SAAM;IAC5D,+EAA+E;IACxC,SAAS,EAAE,QAAQ,GAAG,MAAM,CAAY;IACtE,OAAO,CAAC,OAAO,CAAC,CAAc;IACvC;;wDAEoD;IACpD,OAAO,CAAC,aAAa,CAAC,CAAgB;IACtC;iEAC6D;IAC7D,OAAO,CAAC,aAAa,CAAC,CAAc;IACpC,OAAO,CAAC,OAAO,CAAC,CAAa;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,WAAW,CAAQ;IAE3B,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CA4B/C;IACD,iBAAiB,IAAI,IAAI,CAYxB;IACD,oBAAoB,IAAI,IAAI,CAM3B;IACD;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CACJ,IAAI,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,OAAO,CAAA;KAAE,EACzF,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,WAAW,CAAA;KAAE,GACxC,IAAI,CAKN;IACD,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,mBAAmB,CAIzB;IACF,OAAO,CAAC,cAAc,CAA2C;IACjE,OAAO,CAAC,gBAAgB,CAEtB;IACF,OAAO,CAAC,cAAc,CAEpB;IACF;;;0DAGsD;IACtD,OAAO,CAAC,sBAAsB,CAM5B;IACF,OAAO,CAAC,iBAAiB,CAEvB;IACF,MAAM,IAAI,cAAc,CAiBvB;CACF;AACD,OAAO,CAAC,MAAM,CAAC;IAAE,UAAU,qBAAqB;QAAG,YAAY,EAAE,WAAW,CAAC;KAAE;CAAE"}

package/dist/components/overlays/overlay/popover.class.js

@@ -0,0 +1,216 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { html } from 'lit';
+import { property, state } from 'lit/decorators.js';
+import { LyraElement } from '../../../internal/lyra-element.js';
+import { nextId } from '../../../internal/a11y.js';
+import { place, virtualAnchorFromRect } from '../../../internal/positioner.js';
+import { rtlAwarePlacement } from '../../../internal/rtl.js';
+import { finiteNumber } from '../../../internal/numbers.js';
+import { styles } from './overlay.styles.js';
+/** Default anchor-offset distance (px), passed to Floating UI's `offset()` middleware. */
+const DEFAULT_DISTANCE = 4;
+/**
+ * `<lr-popover>` — a click-triggered, light-dismiss floating surface.
+ *
+ * @customElement lr-popover
+ * @slot trigger - The interactive element that toggles the popover.
+ * @slot - Popover content.
+ * @event lr-show - The popover opened.
+ * @event lr-hide - The popover closed.
+ * @csspart trigger - The trigger wrapper.
+ * @csspart popup - The positioned popup.
+ * @csspart content - The content wrapper.
+ * @cssprop --lr-overlay-max-inline-size - Maximum inline size of the popup (default `--lr-size-20rem`).
+ */
+export class LyraPopover extends LyraElement {
+    constructor() {
+        super(...arguments);
+        this.open = false;
+        this.placement = 'bottom-start';
+        /** Anchor-offset distance (px) passed to Floating UI's `offset()` middleware. Can legitimately
+         *  be negative (overlaps the popup with the trigger); NaN/non-finite falls back to the default. */
+        this.distance = DEFAULT_DISTANCE;
+        this.accessibleLabel = '';
+        /** Semantic role used by the popup. Dropdown subclasses set this to `menu`. */
+        this.popupRole = 'dialog';
+        this.popupId = nextId('popover');
+        this.firstUpdate = true;
+        this.onTriggerSlotChange = (event) => {
+            this.trigger = event.target.assignedElements({ flatten: true })[0];
+            this.syncTriggerA11y();
+            if (this.open)
+                this.position();
+        };
+        this.onTriggerClick = () => { this.open = !this.open; };
+        this.onTriggerKeyDown = (event) => {
+            if (event.key === 'Escape' && this.open) {
+                event.preventDefault();
+                this.open = false;
+                this.trigger?.focus();
+            }
+        };
+        this.onPopupKeyDown = (event) => {
+            if (event.key === 'Escape') {
+                event.preventDefault();
+                this.open = false;
+                this.trigger?.focus();
+            }
+        };
+        /** Escape handling for a popover opened via `showAt()` -- bound at the document level (not
+         *  scoped to the trigger/popup elements) while such a popover is open, since a virtual anchor
+         *  has no slotted trigger or (typically) focused popup content for `onTriggerKeyDown`/
+         *  `onPopupKeyDown` above to catch Escape through. */
+        this.onVirtualAnchorKeyDown = (event) => {
+            if (event.key !== 'Escape')
+                return;
+            event.preventDefault();
+            const returnFocusTarget = this.returnFocusTo;
+            this.open = false;
+            returnFocusTarget?.focus();
+        };
+        this.onDocumentPointer = (event) => {
+            if (!event.composedPath().includes(this))
+                this.open = false;
+        };
+    }
+    static { this.styles = [LyraElement.styles, styles]; }
+    updated(changed) {
+        if (changed.has('open') || changed.has('placement') || changed.has('distance')) {
+            this.cleanup?.();
+            this.cleanup = undefined;
+            if (this.open)
+                this.position();
+            // Scoped to a real open/close transition -- a placement/distance-only
+            // change re-runs this whole block to reposition, but must not re-emit
+            // lr-show/lr-hide or toggle the document listener when `open`
+            // itself didn't change.
+            if (changed.has('open')) {
+                if (this.open) {
+                    document.addEventListener('pointerdown', this.onDocumentPointer);
+                    // A virtual anchor has no slotted trigger and (typically) no focused popup content for
+                    // the existing trigger-/popup-scoped keydown handlers below to catch Escape through --
+                    // bind a document-level Escape listener for that path specifically.
+                    if (this.virtualAnchor)
+                        document.addEventListener('keydown', this.onVirtualAnchorKeyDown);
+                    if (!this.firstUpdate)
+                        this.emit('lr-show');
+                }
+                else {
+                    document.removeEventListener('pointerdown', this.onDocumentPointer);
+                    document.removeEventListener('keydown', this.onVirtualAnchorKeyDown);
+                    this.virtualAnchor = undefined;
+                    this.returnFocusTo = undefined;
+                    if (!this.firstUpdate)
+                        this.emit('lr-hide');
+                }
+            }
+            this.syncTriggerA11y();
+        }
+        this.firstUpdate = false;
+    }
+    connectedCallback() {
+        super.connectedCallback();
+        // A reconnect (e.g. a drag-and-drop reparent keeping this same element
+        // instance) fires disconnectedCallback then connectedCallback
+        // synchronously with no update in between, so updated() never reruns to
+        // notice `open` is still true -- restore the light-dismiss listener and
+        // the Floating UI positioner subscription it dropped.
+        if (this.hasUpdated && this.open) {
+            document.addEventListener('pointerdown', this.onDocumentPointer);
+            if (this.virtualAnchor)
+                document.addEventListener('keydown', this.onVirtualAnchorKeyDown);
+            this.position();
+        }
+    }
+    disconnectedCallback() {
+        this.cleanup?.();
+        this.cleanup = undefined;
+        document.removeEventListener('pointerdown', this.onDocumentPointer);
+        document.removeEventListener('keydown', this.onVirtualAnchorKeyDown);
+        super.disconnectedCallback();
+    }
+    /**
+     * Opens the popover anchored to an arbitrary rectangle instead of the slotted `trigger` -- for
+     * anchoring to a graph node, a canvas pixel, a chart datum, or any other non-DOM location.
+     * `width`/`height` default to `0` (a point). Positions exactly as `place()` would against a real
+     * element (flip/shift/RTL all apply unchanged).
+     *
+     * A virtual anchor has no DOM node, so `autoUpdate()` can't track it moving on its own -- call
+     * `showAt()` again with fresh coordinates to re-anchor an already-open popover (e.g. on a graph
+     * pan/zoom tick); the popover stays open across such a call, it does not toggle. Pass
+     * `rect.contextElement` (a real, still-connected element near the virtual point) when available
+     * so `autoUpdate()` has something to observe for ancestor-scroll/resize tracking; omitting it
+     * still works, it just means only explicit re-`showAt()` calls keep the popover anchored.
+     *
+     * A virtual anchor also has no `.focus()`. Escape and light-dismiss return focus to
+     * `options.returnFocusTo` when supplied, or skip focus-return entirely otherwise -- refocusing
+     * the right place after a virtual anchor closes is the host's responsibility, since Lyra can't
+     * assume how e.g. a graph node's own keyboard model wants focus back.
+     */
+    showAt(rect, options) {
+        this.virtualAnchor = virtualAnchorFromRect(rect);
+        this.returnFocusTo = options?.returnFocusTo;
+        if (this.open)
+            this.position();
+        else
+            this.open = true;
+    }
+    position() {
+        const popup = this.renderRoot.querySelector('[part="popup"]');
+        const anchor = this.virtualAnchor ?? this.trigger;
+        if (!this.open || !anchor || !popup)
+            return;
+        this.cleanup = place(anchor, popup, {
+            placement: rtlAwarePlacement(this.placement, this),
+            offset: finiteNumber(this.distance, DEFAULT_DISTANCE),
+        });
+    }
+    syncTriggerA11y() {
+        if (!this.trigger)
+            return;
+        this.trigger.setAttribute('aria-haspopup', this.popupRole);
+        this.trigger.setAttribute('aria-expanded', this.open ? 'true' : 'false');
+        this.trigger.setAttribute('aria-controls', this.popupId);
+    }
+    render() {
+        // The accessible-name fallback follows the popup's actual semantic role --
+        // a `popupRole="menu"` popup (e.g. <lr-dropdown>) is announced as a menu,
+        // not as a generic "Popover", so its translation is looked up under the
+        // same key <lr-menu> uses for its own default name.
+        const label = this.getAttribute('aria-label') ||
+            this.accessibleLabel ||
+            this.localize(this.popupRole === 'menu' ? 'menuLabel' : 'popover');
+        return html `
+      <span part="trigger" @click=${this.onTriggerClick} @keydown=${this.onTriggerKeyDown}>
+        <slot name="trigger" @slotchange=${this.onTriggerSlotChange}></slot>
+      </span>
+      <div id=${this.popupId} part="popup" role=${this.popupRole} aria-label=${label} ?data-hidden=${!this.open} @keydown=${this.onPopupKeyDown}>
+        <div part="content"><slot></slot></div>
+      </div>
+    `;
+    }
+}
+__decorate([
+    property({ type: Boolean, reflect: true })
+], LyraPopover.prototype, "open", void 0);
+__decorate([
+    property({ reflect: true })
+], LyraPopover.prototype, "placement", void 0);
+__decorate([
+    property({ type: Number })
+], LyraPopover.prototype, "distance", void 0);
+__decorate([
+    property({ attribute: 'aria-label' })
+], LyraPopover.prototype, "accessibleLabel", void 0);
+__decorate([
+    property({ attribute: 'popup-role' })
+], LyraPopover.prototype, "popupRole", void 0);
+__decorate([
+    state()
+], LyraPopover.prototype, "trigger", void 0);
+//# sourceMappingURL=popover.class.js.map

package/dist/components/overlays/overlay/popover.class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"popover.class.js","sourceRoot":"","sources":["../../../../src/components/overlays/overlay/popover.class.ts"],"names":[],"mappings":"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"}

package/dist/components/overlays/overlay/popover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"popover.d.ts","sourceRoot":"","sources":["../../../../src/components/overlays/overlay/popover.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}

package/dist/components/overlays/overlay/popover.js

@@ -0,0 +1,5 @@
+export * from './popover.class.js';
+import { LyraPopover } from './popover.class.js';
+import { defineElement } from '../../../internal/prefix.js';
+defineElement('popover', LyraPopover);
+//# sourceMappingURL=popover.js.map

package/dist/components/overlays/overlay/popover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"popover.js","sourceRoot":"","sources":["../../../../src/components/overlays/overlay/popover.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,aAAa,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC"}

package/dist/components/overlays/overlay/tooltip.class.d.ts

@@ -0,0 +1,95 @@
+import { type PropertyValues, type TemplateResult } from 'lit';
+import type { Placement } from '@floating-ui/dom';
+import { LyraElement } from '../../../internal/lyra-element.js';
+/**
+ * `<lr-tooltip>` — a localized, hover/focus tooltip for a consumer-owned trigger.
+ *
+ * @customElement lr-tooltip
+ * @slot trigger - The element that receives hover/focus listeners.
+ * @slot - Tooltip content.
+ * @csspart trigger - The trigger wrapper.
+ * @csspart popup - The tooltip popup.
+ * @cssprop --lr-tooltip-max-inline-size - Maximum inline size of the tooltip (default `--lr-size-20rem`).
+ * @cssprop --lr-tooltip-background - Tooltip background color (default `--lr-color-neutral`).
+ * @cssprop --lr-tooltip-color - Tooltip text color (default `--lr-color-on-neutral`).
+ */
+export declare class LyraTooltip extends LyraElement {
+    static styles: import("lit").CSSResultGroup[];
+    open: boolean;
+    manual: boolean;
+    /** Show/hide timer delay (ms) -- see `setOpen()`. NaN/negative/oversized all normalize through
+     *  `finiteDuration`. */
+    delay: number;
+    placement: Placement;
+    /** Anchor-offset distance (px) passed to Floating UI's `offset()` middleware -- identical
+     *  semantics to `<lr-popover>.distance` (can legitimately be negative for overlap). */
+    distance: number;
+    content: string;
+    accessibleLabel: string;
+    private trigger?;
+    /** The virtual anchor set by `showAt()`, taking priority over `trigger` for positioning while
+     *  set. Cleared whenever the tooltip closes, so a later `open = true` with no fresh `showAt()`
+     *  call reverts to plain trigger-based behavior. */
+    private virtualAnchor?;
+    /** `options.returnFocusTo` from the `showAt()` call that opened the tooltip, if any -- see
+     *  `showAt()`'s doc comment and `onVirtualAnchorKeyDown`. */
+    private returnFocusTo?;
+    private cleanup?;
+    private timer?;
+    private readonly tooltipId;
+    protected updated(changed: PropertyValues): void;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    /**
+     * Opens the tooltip anchored to an arbitrary rectangle instead of the slotted `trigger` -- for
+     * anchoring to a graph node, a canvas pixel, a chart datum, or any other non-DOM location.
+     * `width`/`height` default to `0` (a point). Positions exactly as `place()` would against a real
+     * element (flip/shift/RTL all apply unchanged). Opens immediately, bypassing `delay`/`manual`
+     * (both are hover-debounce concerns for a slotted trigger, not relevant to a deliberate
+     * programmatic `showAt()` call).
+     *
+     * A virtual anchor has no DOM node, so `autoUpdate()` can't track it moving on its own -- call
+     * `showAt()` again with fresh coordinates to re-anchor an already-open tooltip (e.g. on a graph
+     * pan/zoom tick); the tooltip stays open across such a call, it does not toggle. Close it the
+     * same way any tooltip closes: set `open = false` (there is no separate `hide()`). Pass
+     * `rect.contextElement` (a real, still-connected element near the virtual point) when available
+     * so `autoUpdate()` has something to observe for ancestor-scroll/resize tracking; omitting it
+     * still works, it just means only explicit re-`showAt()` calls keep the tooltip anchored.
+     *
+     * A virtual anchor also has no `.focus()`. Escape returns focus to `options.returnFocusTo` when
+     * supplied, or skips focus-return entirely otherwise -- refocusing the right place after a
+     * virtual anchor closes is the host's responsibility, since Lyra can't assume how e.g. a graph
+     * node's own keyboard model wants focus back.
+     */
+    showAt(rect: {
+        x: number;
+        y: number;
+        width?: number;
+        height?: number;
+        contextElement?: Element;
+    }, options?: {
+        returnFocusTo?: HTMLElement;
+    }): void;
+    private position;
+    private syncTriggerA11y;
+    private setOpen;
+    private bindTrigger;
+    private unbindTrigger;
+    private onTriggerSlotChange;
+    private onEnter;
+    private onLeave;
+    private onTriggerKeyDown;
+    /** Escape handling for a tooltip opened via `showAt()` -- bound at the document level while
+     *  such a tooltip is open, since a virtual anchor has no slotted trigger for `onTriggerKeyDown`
+     *  above to catch Escape through (that listener is only ever bound to a real trigger element via
+     *  `bindTrigger()`). Only ever attached while `virtualAnchor` is set, so this never runs for a
+     *  normal trigger-driven tooltip. */
+    private onVirtualAnchorKeyDown;
+    render(): TemplateResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'lr-tooltip': LyraTooltip;
+    }
+}
+//# sourceMappingURL=tooltip.class.d.ts.map

package/dist/components/overlays/overlay/tooltip.class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tooltip.class.d.ts","sourceRoot":"","sources":["../../../../src/components/overlays/overlay/tooltip.class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAE9E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAahE;;;;;;;;;;;GAWG;AACH,qBAAa,WAAY,SAAQ,WAAW;IAC1C,MAAM,CAAC,MAAM,iCAAuC;IACR,IAAI,UAAS;IAC5B,MAAM,UAAS;IAC5C;4BACwB;IACI,KAAK,SAAiB;IACrB,SAAS,EAAE,SAAS,CAAS;IAC1D;2FACuF;IAC3D,QAAQ,SAAoB;IAC5C,OAAO,SAAM;IACc,eAAe,SAAM;IACnD,OAAO,CAAC,OAAO,CAAC,CAAc;IACvC;;wDAEoD;IACpD,OAAO,CAAC,aAAa,CAAC,CAAgB;IACtC;iEAC6D;IAC7D,OAAO,CAAC,aAAa,CAAC,CAAc;IACpC,OAAO,CAAC,OAAO,CAAC,CAAa;IAC7B,OAAO,CAAC,KAAK,CAAC,CAAgC;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAE/C,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAoB/C;IACD,iBAAiB,IAAI,IAAI,CAaxB;IACD,oBAAoB,IAAI,IAAI,CAM3B;IACD;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,MAAM,CACJ,IAAI,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,OAAO,CAAA;KAAE,EACzF,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,WAAW,CAAA;KAAE,GACxC,IAAI,CAKN;IACD,OAAO,CAAC,QAAQ;IAUhB,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,OAAO;IAMf,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,mBAAmB,CAYzB;IACF,OAAO,CAAC,OAAO,CAAyD;IACxE,OAAO,CAAC,OAAO,CAA0D;IACzE,OAAO,CAAC,gBAAgB,CAStB;IACF;;;;yCAIqC;IACrC,OAAO,CAAC,sBAAsB,CAM5B;IACF,MAAM,IAAI,cAAc,CAQvB;CACF;AACD,OAAO,CAAC,MAAM,CAAC;IAAE,UAAU,qBAAqB;QAAG,YAAY,EAAE,WAAW,CAAC;KAAE;CAAE"}