@spectrum-web-components/tooltip 0.0.0-20241209155954

package/README.md

@@ -0,0 +1,133 @@
+## Description
+
+`sp-tooltip` allow users to get contextual help or information about specific components when hovering or focusing on them.
+
+### Usage
+
+[![See it on NPM!](https://img.shields.io/npm/v/@spectrum-web-components/tooltip?style=for-the-badge)](https://www.npmjs.com/package/@spectrum-web-components/tooltip)
+[![How big is this package in your project?](https://img.shields.io/bundlephobia/minzip/@spectrum-web-components/tooltip?style=for-the-badge)](https://bundlephobia.com/result?p=@spectrum-web-components/tooltip)
+[![Try it on webcomponents.dev](https://img.shields.io/badge/Try%20it%20on-webcomponents.dev-green?style=for-the-badge)](https://webcomponents.dev/edit/collection/fO75441E1Q5ZlI0e9pgq/VmbuRedDUMmN4amLK7ie/src/index.ts)
+
+```
+yarn add @spectrum-web-components/tooltip
+```
+
+Import the side effectful registration of `<sp-tooltip>` via:
+
+```
+import '@spectrum-web-components/tooltip/sp-tooltip.js';
+```
+
+When looking to leverage the `Tooltip` base class as a type and/or for extension purposes, do so via:
+
+```
+import { Tooltip } from '@spectrum-web-components/tooltip';
+```
+
+## Example
+
+Tooltips can be top, bottom, left, or right.
+
+```html
+<sp-tooltip open placement="top">Label</sp-tooltip>
+<br />
+<br />
+<sp-tooltip open placement="bottom">Label</sp-tooltip>
+<br />
+<br />
+<sp-tooltip open placement="left">Label</sp-tooltip>
+<br />
+<br />
+<sp-tooltip open placement="right">Label</sp-tooltip>
+```
+
+### Self-managed overlays
+
+By default, Tooltip provides styling without behavior.
+You must combine it with an [Overlay Trigger](https://opensource.adobe.com/spectrum-web-components/components/overlay-trigger/#%22hover%22-content-only) in order to manage its overlay behavior.
+
+You can use the tooltip as the descendant of an interactive element, such as [Action Button](https://opensource.adobe.com/spectrum-web-components/components/action-button/), by applying the `self-managed` attribute which automatically binds the Tooltip to its first interactive ancestor element's focus/hover interactions:
+
+```html
+<sp-action-button>
+    Trigger
+    <sp-tooltip self-managed>Content</sp-tooltip>
+</sp-action-button>
+```
+
+This is especially useful when inserting an intermediate `<overlay-trigger>` would interfere with
+parent/child relationships, such as between `<sp-action-group>` and `<sp-action-button>`.
+
+Note that an interactive element is an element that can receive focus during tab navigation, such as `sp-action-button`, `sp-action-menu`, `sp-field-label` etc.
+
+Given that tooltip is not focusable by itself, it would not show up during tab navigation. Thus a tooltip would not be accessible if used with a non-interactive element, such as `<sp-icon-*>`.
+
+The correct way to make it accessible would be to wrap it under an interactive element, such as `sp-action-button`:
+
+```html
+<sp-action-button size="s">
+    <sp-icon-info slot="icon"></sp-icon-info>
+    <sp-tooltip self-managed placement="right">
+        Display something here
+    </sp-tooltip>
+</sp-action-button>
+```
+
+## Variants
+
+### Informative
+
+This is the informative or info variant of Tooltip
+
+```html
+<sp-tooltip open placement="top" variant="info">Label</sp-tooltip>
+<sp-tooltip open placement="top" variant="info">
+    Lorem ipsum dolor sit amet, consectetur adipiscing elit
+</sp-tooltip>
+<sp-tooltip open placement="top" variant="info">
+    <sp-icon-info slot="icon" size="s"></sp-icon-info>
+    Label
+</sp-tooltip>
+<sp-tooltip open placement="top" variant="info">
+    <sp-icon-info slot="icon" size="s"></sp-icon-info>
+    Lorem ipsum dolor sit amet, consectetur adipiscing elit
+</sp-tooltip>
+```
+
+### Positive
+
+This is the postive (a.k.a.) success variant of Tooltip
+
+```html
+<sp-tooltip open placement="top" variant="positive">Label</sp-tooltip>
+<sp-tooltip open placement="top" variant="positive">
+    Lorem ipsum dolor sit amet, consectetur adipiscing elit
+</sp-tooltip>
+<sp-tooltip open placement="top" variant="positive">
+    <sp-icon-checkmark-circle slot="icon" size="s"></sp-icon-checkmark-circle>
+    Label
+</sp-tooltip>
+<sp-tooltip open placement="top" variant="positive">
+    <sp-icon-checkmark-circle slot="icon" size="s"></sp-icon-checkmark-circle>
+    Lorem ipsum dolor sit amet, consectetur adipiscing elit
+</sp-tooltip>
+```
+
+### Negative
+
+This is the negative a.k.a. error variant of Tooltip
+
+```html
+<sp-tooltip open placement="top" variant="negative">Label</sp-tooltip>
+<sp-tooltip open placement="top" variant="negative">
+    Lorem ipsum dolor sit amet, consectetur adipiscing elit
+</sp-tooltip>
+<sp-tooltip open placement="top" variant="negative">
+    <sp-icon-alert slot="icon" size="s"></sp-icon-alert>
+    Label
+</sp-tooltip>
+<sp-tooltip open placement="top" variant="negative">
+    <sp-icon-alert slot="icon" size="s"></sp-icon-alert>
+    Lorem ipsum dolor sit amet, consectetur adipiscing elit
+</sp-tooltip>
+```

package/package.json

@@ -0,0 +1,79 @@
+{
+    "name": "@spectrum-web-components/tooltip",
+    "version": "0.0.0-20241209155954",
+    "publishConfig": {
+        "access": "public"
+    },
+    "description": "",
+    "license": "Apache-2.0",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/adobe/spectrum-web-components.git",
+        "directory": "packages/tooltip"
+    },
+    "author": "",
+    "homepage": "https://opensource.adobe.com/spectrum-web-components/components/tooltip",
+    "bugs": {
+        "url": "https://github.com/adobe/spectrum-web-components/issues"
+    },
+    "main": "./src/index.js",
+    "module": "./src/index.js",
+    "type": "module",
+    "exports": {
+        ".": {
+            "development": "./src/index.dev.js",
+            "default": "./src/index.js"
+        },
+        "./package.json": "./package.json",
+        "./src/Tooltip.js": {
+            "development": "./src/Tooltip.dev.js",
+            "default": "./src/Tooltip.js"
+        },
+        "./src/index.js": {
+            "development": "./src/index.dev.js",
+            "default": "./src/index.js"
+        },
+        "./src/tooltip-directive.js": {
+            "development": "./src/tooltip-directive.dev.js",
+            "default": "./src/tooltip-directive.js"
+        },
+        "./src/tooltip-overrides.css.js": "./src/tooltip-overrides.css.js",
+        "./src/tooltip.css.js": "./src/tooltip.css.js",
+        "./sp-tooltip.js": {
+            "development": "./sp-tooltip.dev.js",
+            "default": "./sp-tooltip.js"
+        }
+    },
+    "scripts": {
+        "test": "echo \"Error: run tests from mono-repo root.\" && exit 1"
+    },
+    "files": [
+        "**/*.d.ts",
+        "**/*.js",
+        "**/*.js.map",
+        "custom-elements.json",
+        "!stories/",
+        "!test/"
+    ],
+    "keywords": [
+        "spectrum css",
+        "web components",
+        "lit-element",
+        "lit-html"
+    ],
+    "dependencies": {
+        "@spectrum-web-components/base": "0.0.0-20241209155954",
+        "@spectrum-web-components/overlay": "0.0.0-20241209155954",
+        "@spectrum-web-components/reactive-controllers": "0.0.0-20241209155954",
+        "@spectrum-web-components/shared": "0.0.0-20241209155954"
+    },
+    "devDependencies": {
+        "@spectrum-css/tooltip": "^7.0.0-s2-foundations.15"
+    },
+    "types": "./src/index.d.ts",
+    "customElements": "custom-elements.json",
+    "sideEffects": [
+        "./sp-*.js",
+        "./**/*.dev.js"
+    ]
+}

package/sp-tooltip.d.ts

@@ -0,0 +1,6 @@
+import { Tooltip } from './src/Tooltip.js';
+declare global {
+    interface HTMLElementTagNameMap {
+        'sp-tooltip': Tooltip;
+    }
+}

package/sp-tooltip.dev.js

@@ -0,0 +1,5 @@
+"use strict";
+import { Tooltip } from "./src/Tooltip.dev.js";
+import { defineElement } from "@spectrum-web-components/base/src/define-element.js";
+defineElement("sp-tooltip", Tooltip);
+//# sourceMappingURL=sp-tooltip.dev.js.map

package/sp-tooltip.dev.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["sp-tooltip.ts"],
+  "sourcesContent": ["/*\nCopyright 2020 Adobe. All rights reserved.\nThis file is licensed to you under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License. You may obtain a copy\nof the License at http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software distributed under\nthe License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\nOF ANY KIND, either express or implied. See the License for the specific language\ngoverning permissions and limitations under the License.\n*/\nimport { Tooltip } from './src/Tooltip.dev.js'\nimport { defineElement } from '@spectrum-web-components/base/src/define-element.js';\n\ndefineElement('sp-tooltip', Tooltip);\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'sp-tooltip': Tooltip;\n    }\n}\n"],
+  "mappings": ";AAWA,SAAS,eAAe;AACxB,SAAS,qBAAqB;AAE9B,cAAc,cAAc,OAAO;",
+  "names": []
+}

package/sp-tooltip.js

@@ -0,0 +1,2 @@
+"use strict";import{Tooltip as o}from"./src/Tooltip.js";import{defineElement as e}from"@spectrum-web-components/base/src/define-element.js";e("sp-tooltip",o);
+//# sourceMappingURL=sp-tooltip.js.map

package/sp-tooltip.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["sp-tooltip.ts"],
+  "sourcesContent": ["/*\nCopyright 2020 Adobe. All rights reserved.\nThis file is licensed to you under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License. You may obtain a copy\nof the License at http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software distributed under\nthe License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\nOF ANY KIND, either express or implied. See the License for the specific language\ngoverning permissions and limitations under the License.\n*/\nimport { Tooltip } from './src/Tooltip.js';\nimport { defineElement } from '@spectrum-web-components/base/src/define-element.js';\n\ndefineElement('sp-tooltip', Tooltip);\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'sp-tooltip': Tooltip;\n    }\n}\n"],
+  "mappings": "aAWA,OAAS,WAAAA,MAAe,mBACxB,OAAS,iBAAAC,MAAqB,sDAE9BA,EAAc,aAAcD,CAAO",
+  "names": ["Tooltip", "defineElement"]
+}

package/src/Tooltip.d.ts

@@ -0,0 +1,48 @@
+import { CSSResultArray, SpectrumElement, TemplateResult } from '@spectrum-web-components/base';
+import type { Overlay, Placement } from '@spectrum-web-components/overlay';
+/**
+ * @element sp-tooltip
+ *
+ * @slot icon - the icon element appearing at the start of the label
+ * @slot - the text label of the Tooltip
+ */
+export declare class Tooltip extends SpectrumElement {
+    static get styles(): CSSResultArray;
+    /**
+     * A Tooltip that is `delayed` will its Overlay wait until a warm-up period of
+     * 1000ms has completed before opening. Once the warmup period has completed, all
+     * subsequent Overlays will open immediately. When no Overlays are opened, a
+     * cooldown period of 1000ms will begin. Once the cooldown has completed, the next
+     * Overlay to be opened will be subject to the warm-up period if provided that option.
+     */
+    delayed: boolean;
+    private dependencyManager;
+    /**
+     * Whether to prevent a self-managed Tooltip from responding to user input.
+     */
+    disabled: boolean;
+    /**
+     * Automatically bind to the parent element of the assigned `slot` or the parent element of the `sp-tooltip`.
+     * Without this, you must provide your own `overlay-trigger`.
+     */
+    selfManaged: boolean;
+    offset: number;
+    open: boolean;
+    overlayElement?: Overlay;
+    /**
+     * @type {"top" | "top-start" | "top-end" | "right" | "right-start" | "right-end" | "bottom" | "bottom-start" | "bottom-end" | "left" | "left-start" | "left-end"}
+     * @attr
+     */
+    placement?: Placement;
+    tipElement: HTMLSpanElement;
+    tipPadding?: number;
+    private _variant;
+    get variant(): string;
+    set variant(variant: string);
+    private handleOpenOverlay;
+    protected handleCloseOverlay: () => void;
+    protected forwardTransitionEvent(event: TransitionEvent): void;
+    private get triggerElement();
+    render(): TemplateResult;
+    connectedCallback(): void;
+}

package/src/Tooltip.dev.js

@@ -0,0 +1,259 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result) __defProp(target, key, result);
+  return result;
+};
+import {
+  html,
+  SpectrumElement
+} from "@spectrum-web-components/base";
+import {
+  property,
+  query
+} from "@spectrum-web-components/base/src/decorators.js";
+import { ifDefined } from "@spectrum-web-components/base/src/directives.js";
+import tooltipStyles from "./tooltip.css.js";
+import { focusableSelector } from "@spectrum-web-components/shared/src/focusable-selectors.js";
+import { DependencyManagerController } from "@spectrum-web-components/reactive-controllers/src/DependencyManger.js";
+class TooltipOpenable extends HTMLElement {
+  constructor() {
+    super();
+    this._open = false;
+    this._placement = "top";
+    this.addEventListener("sp-opened", this.redispatchEvent);
+    this.addEventListener("sp-closed", this.redispatchEvent);
+  }
+  redispatchEvent(event) {
+    event.stopPropagation();
+    this.tooltip.dispatchEvent(
+      new CustomEvent(event.type, {
+        bubbles: event.bubbles,
+        composed: event.composed,
+        detail: event.detail
+      })
+    );
+  }
+  get tooltip() {
+    return this.getRootNode().host;
+  }
+  static get observedAttributes() {
+    return ["open", "placement"];
+  }
+  attributeChangedCallback(name, _oldValue, newValue) {
+    switch (name) {
+      case "open":
+        this.open = newValue !== null;
+        break;
+      case "placement":
+        this.placement = newValue;
+        break;
+    }
+  }
+  set open(open) {
+    this._open = open;
+    const { tooltip } = this;
+    if (!tooltip) {
+      return;
+    }
+    tooltip.open = open;
+  }
+  /* c8 ignore next 3 */
+  get open() {
+    return this._open;
+  }
+  /**
+   * @type {"top" | "top-start" | "top-end" | "right" | "right-start" | "right-end" | "bottom" | "bottom-start" | "bottom-end" | "left" | "left-start" | "left-end"}
+   * @attr
+   */
+  set placement(placement) {
+    this._placement = placement;
+    const { tooltip } = this;
+    if (!tooltip) {
+      return;
+    }
+    tooltip.placement = placement;
+  }
+  /* c8 ignore next 3 */
+  get placement() {
+    return this._placement;
+  }
+  get tipElement() {
+    return this.tooltip.tipElement;
+  }
+}
+if (!customElements.get("sp-tooltip-openable")) {
+  customElements.define("sp-tooltip-openable", TooltipOpenable);
+}
+export class Tooltip extends SpectrumElement {
+  constructor() {
+    super(...arguments);
+    this.delayed = false;
+    this.dependencyManager = new DependencyManagerController(this);
+    this.disabled = false;
+    this.selfManaged = false;
+    this.offset = 0;
+    this.open = false;
+    /* Ensure that a '' value for `variant` removes the attribute instead of a blank value */
+    this._variant = "";
+    this.handleOpenOverlay = () => {
+      this.open = true;
+    };
+    this.handleCloseOverlay = () => {
+      this.open = false;
+    };
+  }
+  static get styles() {
+    return [tooltipStyles];
+  }
+  get variant() {
+    return this._variant;
+  }
+  set variant(variant) {
+    if (variant === this.variant) {
+      return;
+    }
+    if (["info", "positive", "negative"].includes(variant)) {
+      this.setAttribute("variant", variant);
+      this._variant = variant;
+      return;
+    }
+    this.removeAttribute("variant");
+    this._variant = "";
+  }
+  forwardTransitionEvent(event) {
+    this.dispatchEvent(
+      new TransitionEvent(event.type, {
+        bubbles: true,
+        composed: true,
+        propertyName: event.propertyName
+      })
+    );
+  }
+  get triggerElement() {
+    var _a;
+    let start = this.assignedSlot || this;
+    let root = start.getRootNode();
+    if (root === document) {
+      if (true) {
+        window.__swc.warn(
+          this,
+          `Self managed <${this.localName}> elements walk up the composed tree to acquire a trigger element. No trigger element was found before the document.`,
+          "https://opensource.adobe.com/spectrum-web-components/components/tooltip#self-managed-overlays",
+          {
+            level: "high"
+          }
+        );
+      }
+      return null;
+    }
+    let triggerElement = start.parentElement || root.host || /* c8 ignore next 1 */
+    root;
+    while (!((_a = triggerElement == null ? void 0 : triggerElement.matches) == null ? void 0 : _a.call(triggerElement, focusableSelector))) {
+      start = triggerElement.assignedSlot || triggerElement;
+      root = start.getRootNode();
+      if (root === document) {
+        if (true) {
+          window.__swc.warn(
+            this,
+            `Self managed <${this.localName}> elements walk up the composed tree to acquire a trigger element. No trigger element was found before the document.`,
+            "https://opensource.adobe.com/spectrum-web-components/components/tooltip#self-managed-overlays",
+            {
+              level: "high"
+            }
+          );
+        }
+        return null;
+      }
+      triggerElement = start.parentElement || root.host || /* c8 ignore next 1 */
+      root;
+    }
+    return triggerElement;
+  }
+  render() {
+    const tooltip = html`
+            <sp-tooltip-openable
+                id="tooltip"
+                placement=${ifDefined(this.placement)}
+                @transitionrun=${this.forwardTransitionEvent}
+                @transitionend=${this.forwardTransitionEvent}
+                @transitioncancel=${this.forwardTransitionEvent}
+            >
+                <slot name="icon"></slot>
+                <span id="label"><slot></slot></span>
+                <span id="tip" aria-hidden="true"></span>
+            </sp-tooltip-openable>
+        `;
+    if (this.selfManaged) {
+      this.dependencyManager.add("sp-overlay");
+      import("@spectrum-web-components/overlay/sp-overlay.js");
+      return html`
+                <sp-overlay
+                    ?open=${this.open && !this.disabled && this.dependencyManager.loaded}
+                    ?delayed=${this.delayed}
+                    ?disabled=${this.disabled}
+                    offset=${this.offset}
+                    .placement=${this.placement}
+                    type="hint"
+                    .tipPadding=${this.tipPadding}
+                    .triggerInteraction=${"hover"}
+                    @sp-opened=${this.handleOpenOverlay}
+                    @sp-closed=${this.handleCloseOverlay}
+                >
+                    ${tooltip}
+                </sp-overlay>
+            `;
+    } else {
+      return tooltip;
+    }
+  }
+  connectedCallback() {
+    super.connectedCallback();
+    this.updateComplete.then(() => {
+      if (!this.selfManaged) {
+        return;
+      }
+      const overlayElement = this.overlayElement;
+      if (overlayElement) {
+        const triggerElement = this.triggerElement;
+        overlayElement.triggerElement = triggerElement;
+      }
+    });
+  }
+}
+__decorateClass([
+  property({ type: Boolean })
+], Tooltip.prototype, "delayed", 2);
+__decorateClass([
+  property({ type: Boolean })
+], Tooltip.prototype, "disabled", 2);
+__decorateClass([
+  property({ type: Boolean, attribute: "self-managed" })
+], Tooltip.prototype, "selfManaged", 2);
+__decorateClass([
+  property({ type: Number })
+], Tooltip.prototype, "offset", 2);
+__decorateClass([
+  property({ type: Boolean, reflect: true })
+], Tooltip.prototype, "open", 2);
+__decorateClass([
+  query("sp-overlay")
+], Tooltip.prototype, "overlayElement", 2);
+__decorateClass([
+  property({ reflect: true })
+], Tooltip.prototype, "placement", 2);
+__decorateClass([
+  query("#tip")
+], Tooltip.prototype, "tipElement", 2);
+__decorateClass([
+  property({ type: Number })
+], Tooltip.prototype, "tipPadding", 2);
+__decorateClass([
+  property({ type: String })
+], Tooltip.prototype, "variant", 1);
+//# sourceMappingURL=Tooltip.dev.js.map

package/src/Tooltip.dev.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["Tooltip.ts"],
+  "sourcesContent": ["/*\nCopyright 2020 Adobe. All rights reserved.\nThis file is licensed to you under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License. You may obtain a copy\nof the License at http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software distributed under\nthe License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\nOF ANY KIND, either express or implied. See the License for the specific language\ngoverning permissions and limitations under the License.\n*/\n\nimport {\n    CSSResultArray,\n    html,\n    SpectrumElement,\n    TemplateResult,\n} from '@spectrum-web-components/base';\nimport {\n    property,\n    query,\n} from '@spectrum-web-components/base/src/decorators.js';\nimport { ifDefined } from '@spectrum-web-components/base/src/directives.js';\nimport type {\n    Overlay,\n    OverlayOpenCloseDetail,\n    Placement,\n} from '@spectrum-web-components/overlay';\n\nimport tooltipStyles from './tooltip.css.js';\nimport { focusableSelector } from '@spectrum-web-components/shared/src/focusable-selectors.js';\nimport { DependencyManagerController } from '@spectrum-web-components/reactive-controllers/src/DependencyManger.js';\n\nclass TooltipOpenable extends HTMLElement {\n    constructor() {\n        super();\n        this.addEventListener('sp-opened', this.redispatchEvent);\n        this.addEventListener('sp-closed', this.redispatchEvent);\n    }\n    redispatchEvent(event: Event): void {\n        event.stopPropagation();\n        this.tooltip.dispatchEvent(\n            new CustomEvent<OverlayOpenCloseDetail>(event.type, {\n                bubbles: event.bubbles,\n                composed: event.composed,\n                detail: (event as CustomEvent<OverlayOpenCloseDetail>).detail,\n            })\n        );\n    }\n    get tooltip(): Tooltip {\n        return (this.getRootNode() as ShadowRoot).host as Tooltip;\n    }\n    static get observedAttributes(): string[] {\n        return ['open', 'placement'];\n    }\n    attributeChangedCallback(\n        name: 'open' | 'placement',\n        _oldValue: string,\n        newValue: 'string'\n    ): void {\n        switch (name) {\n            // API generally sets `open` as a property\n            /* c8 ignore next 3 */\n            case 'open':\n                this.open = newValue !== null;\n                break;\n            case 'placement':\n                this.placement = newValue as Placement;\n                break;\n        }\n    }\n    set open(open: boolean) {\n        this._open = open;\n        const { tooltip } = this;\n        /* c8 ignore next 3 */\n        if (!tooltip) {\n            return;\n        }\n        tooltip.open = open;\n    }\n    /* c8 ignore next 3 */\n    get open(): boolean {\n        return this._open;\n    }\n    private _open = false;\n    /**\n     * @type {\"top\" | \"top-start\" | \"top-end\" | \"right\" | \"right-start\" | \"right-end\" | \"bottom\" | \"bottom-start\" | \"bottom-end\" | \"left\" | \"left-start\" | \"left-end\"}\n     * @attr\n     */\n    set placement(placement: Placement) {\n        this._placement = placement;\n        const { tooltip } = this;\n        if (!tooltip) {\n            return;\n        }\n        tooltip.placement = placement;\n    }\n    /* c8 ignore next 3 */\n    get placement(): Placement {\n        return this._placement;\n    }\n    private _placement: Placement = 'top';\n    get tipElement(): HTMLElement {\n        return this.tooltip.tipElement;\n    }\n}\n\nif (!customElements.get('sp-tooltip-openable')) {\n    customElements.define('sp-tooltip-openable', TooltipOpenable);\n}\n\n/**\n * @element sp-tooltip\n *\n * @slot icon - the icon element appearing at the start of the label\n * @slot - the text label of the Tooltip\n */\nexport class Tooltip extends SpectrumElement {\n    public static override get styles(): CSSResultArray {\n        return [tooltipStyles];\n    }\n\n    /**\n     * A Tooltip that is `delayed` will its Overlay wait until a warm-up period of\n     * 1000ms has completed before opening. Once the warmup period has completed, all\n     * subsequent Overlays will open immediately. When no Overlays are opened, a\n     * cooldown period of 1000ms will begin. Once the cooldown has completed, the next\n     * Overlay to be opened will be subject to the warm-up period if provided that option.\n     */\n    @property({ type: Boolean })\n    delayed = false;\n\n    private dependencyManager = new DependencyManagerController(this);\n\n    /**\n     * Whether to prevent a self-managed Tooltip from responding to user input.\n     */\n    @property({ type: Boolean })\n    disabled = false;\n\n    /**\n     * Automatically bind to the parent element of the assigned `slot` or the parent element of the `sp-tooltip`.\n     * Without this, you must provide your own `overlay-trigger`.\n     */\n    @property({ type: Boolean, attribute: 'self-managed' })\n    public selfManaged = false;\n\n    @property({ type: Number })\n    public offset = 0;\n\n    @property({ type: Boolean, reflect: true })\n    public open = false;\n\n    @query('sp-overlay')\n    public overlayElement?: Overlay;\n\n    /**\n     * @type {\"top\" | \"top-start\" | \"top-end\" | \"right\" | \"right-start\" | \"right-end\" | \"bottom\" | \"bottom-start\" | \"bottom-end\" | \"left\" | \"left-start\" | \"left-end\"}\n     * @attr\n     */\n    @property({ reflect: true })\n    public placement?: Placement;\n\n    @query('#tip')\n    public tipElement!: HTMLSpanElement;\n\n    @property({ type: Number })\n    public tipPadding?: number;\n\n    /* Ensure that a '' value for `variant` removes the attribute instead of a blank value */\n    private _variant = '';\n\n    @property({ type: String })\n    public get variant(): string {\n        return this._variant;\n    }\n    public set variant(variant: string) {\n        if (variant === this.variant) {\n            return;\n        }\n        if (['info', 'positive', 'negative'].includes(variant)) {\n            this.setAttribute('variant', variant);\n            this._variant = variant;\n            return;\n        }\n        this.removeAttribute('variant');\n        this._variant = '';\n    }\n\n    private handleOpenOverlay = (): void => {\n        this.open = true;\n    };\n\n    protected handleCloseOverlay = (): void => {\n        this.open = false;\n    };\n\n    protected forwardTransitionEvent(event: TransitionEvent): void {\n        this.dispatchEvent(\n            new TransitionEvent(event.type, {\n                bubbles: true,\n                composed: true,\n                propertyName: event.propertyName,\n            })\n        );\n    }\n\n    private get triggerElement(): HTMLElement | null {\n        // Resolve the parent element of the assigned slot (if one exists) or of the Tooltip.\n        let start: HTMLElement = this.assignedSlot || this;\n        let root = start.getRootNode();\n        if (root === document) {\n            if (window.__swc.DEBUG) {\n                window.__swc.warn(\n                    this,\n                    `Self managed <${this.localName}> elements walk up the composed tree to acquire a trigger element. No trigger element was found before the document.`,\n                    'https://opensource.adobe.com/spectrum-web-components/components/tooltip#self-managed-overlays',\n                    {\n                        level: 'high',\n                    }\n                );\n            }\n            return null;\n        }\n        let triggerElement = (start.parentElement ||\n            (root as ShadowRoot).host ||\n            /* c8 ignore next 1 */\n            root) as HTMLElement;\n        while (!triggerElement?.matches?.(focusableSelector)) {\n            start =\n                triggerElement.assignedSlot || (triggerElement as HTMLElement);\n            root = start.getRootNode();\n            /* c8 ignore next 13 */\n            if (root === document) {\n                if (window.__swc.DEBUG) {\n                    window.__swc.warn(\n                        this,\n                        `Self managed <${this.localName}> elements walk up the composed tree to acquire a trigger element. No trigger element was found before the document.`,\n                        'https://opensource.adobe.com/spectrum-web-components/components/tooltip#self-managed-overlays',\n                        {\n                            level: 'high',\n                        }\n                    );\n                }\n                return null;\n            }\n            triggerElement = (start.parentElement ||\n                (root as ShadowRoot).host ||\n                /* c8 ignore next 1 */\n                root) as HTMLElement;\n        }\n        return triggerElement;\n    }\n\n    override render(): TemplateResult {\n        const tooltip = html`\n            <sp-tooltip-openable\n                id=\"tooltip\"\n                placement=${ifDefined(this.placement)}\n                @transitionrun=${this.forwardTransitionEvent}\n                @transitionend=${this.forwardTransitionEvent}\n                @transitioncancel=${this.forwardTransitionEvent}\n            >\n                <slot name=\"icon\"></slot>\n                <span id=\"label\"><slot></slot></span>\n                <span id=\"tip\" aria-hidden=\"true\"></span>\n            </sp-tooltip-openable>\n        `;\n        if (this.selfManaged) {\n            this.dependencyManager.add('sp-overlay');\n            import('@spectrum-web-components/overlay/sp-overlay.js');\n            return html`\n                <sp-overlay\n                    ?open=${this.open &&\n                    !this.disabled &&\n                    this.dependencyManager.loaded}\n                    ?delayed=${this.delayed}\n                    ?disabled=${this.disabled}\n                    offset=${this.offset}\n                    .placement=${this.placement}\n                    type=\"hint\"\n                    .tipPadding=${this.tipPadding}\n                    .triggerInteraction=${'hover'}\n                    @sp-opened=${this.handleOpenOverlay}\n                    @sp-closed=${this.handleCloseOverlay}\n                >\n                    ${tooltip}\n                </sp-overlay>\n            `;\n        } else {\n            return tooltip;\n        }\n    }\n\n    public override connectedCallback(): void {\n        super.connectedCallback();\n\n        this.updateComplete.then(() => {\n            if (!this.selfManaged) {\n                return;\n            }\n            const overlayElement = this.overlayElement;\n            if (overlayElement) {\n                const triggerElement = this.triggerElement;\n                overlayElement.triggerElement = triggerElement;\n            }\n        });\n    }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/src/Tooltip.js

@@ -0,0 +1,29 @@
+"use strict";var c=Object.defineProperty;var m=Object.getOwnPropertyDescriptor;var o=(r,s,e,t)=>{for(var n=t>1?void 0:t?m(s,e):s,i=r.length-1,l;i>=0;i--)(l=r[i])&&(n=(t?l(s,e,n):l(n))||n);return t&&n&&c(s,e,n),n};import{html as p,SpectrumElement as h}from"@spectrum-web-components/base";import{property as a,query as d}from"@spectrum-web-components/base/src/decorators.js";import{ifDefined as u}from"@spectrum-web-components/base/src/directives.js";import v from"./tooltip.css.js";import{focusableSelector as b}from"@spectrum-web-components/shared/src/focusable-selectors.js";import{DependencyManagerController as f}from"@spectrum-web-components/reactive-controllers/src/DependencyManger.js";class g extends HTMLElement{constructor(){super();this._open=!1;this._placement="top";this.addEventListener("sp-opened",this.redispatchEvent),this.addEventListener("sp-closed",this.redispatchEvent)}redispatchEvent(e){e.stopPropagation(),this.tooltip.dispatchEvent(new CustomEvent(e.type,{bubbles:e.bubbles,composed:e.composed,detail:e.detail}))}get tooltip(){return this.getRootNode().host}static get observedAttributes(){return["open","placement"]}attributeChangedCallback(e,t,n){switch(e){case"open":this.open=n!==null;break;case"placement":this.placement=n;break}}set open(e){this._open=e;const{tooltip:t}=this;t&&(t.open=e)}get open(){return this._open}set placement(e){this._placement=e;const{tooltip:t}=this;t&&(t.placement=e)}get placement(){return this._placement}get tipElement(){return this.tooltip.tipElement}}customElements.get("sp-tooltip-openable")||customElements.define("sp-tooltip-openable",g);export class Tooltip extends h{constructor(){super(...arguments);this.delayed=!1;this.dependencyManager=new f(this);this.disabled=!1;this.selfManaged=!1;this.offset=0;this.open=!1;this._variant="";this.handleOpenOverlay=()=>{this.open=!0};this.handleCloseOverlay=()=>{this.open=!1}}static get styles(){return[v]}get variant(){return this._variant}set variant(e){if(e!==this.variant){if(["info","positive","negative"].includes(e)){this.setAttribute("variant",e),this._variant=e;return}this.removeAttribute("variant"),this._variant=""}}forwardTransitionEvent(e){this.dispatchEvent(new TransitionEvent(e.type,{bubbles:!0,composed:!0,propertyName:e.propertyName}))}get triggerElement(){var i;let e=this.assignedSlot||this,t=e.getRootNode();if(t===document)return null;let n=e.parentElement||t.host||t;for(;!((i=n==null?void 0:n.matches)!=null&&i.call(n,b));){if(e=n.assignedSlot||n,t=e.getRootNode(),t===document)return null;n=e.parentElement||t.host||t}return n}render(){const e=p`
+            <sp-tooltip-openable
+                id="tooltip"
+                placement=${u(this.placement)}
+                @transitionrun=${this.forwardTransitionEvent}
+                @transitionend=${this.forwardTransitionEvent}
+                @transitioncancel=${this.forwardTransitionEvent}
+            >
+                <slot name="icon"></slot>
+                <span id="label"><slot></slot></span>
+                <span id="tip" aria-hidden="true"></span>
+            </sp-tooltip-openable>
+        `;return this.selfManaged?(this.dependencyManager.add("sp-overlay"),import("@spectrum-web-components/overlay/sp-overlay.js"),p`
+                <sp-overlay
+                    ?open=${this.open&&!this.disabled&&this.dependencyManager.loaded}
+                    ?delayed=${this.delayed}
+                    ?disabled=${this.disabled}
+                    offset=${this.offset}
+                    .placement=${this.placement}
+                    type="hint"
+                    .tipPadding=${this.tipPadding}
+                    .triggerInteraction=${"hover"}
+                    @sp-opened=${this.handleOpenOverlay}
+                    @sp-closed=${this.handleCloseOverlay}
+                >
+                    ${e}
+                </sp-overlay>
+            `):e}connectedCallback(){super.connectedCallback(),this.updateComplete.then(()=>{if(!this.selfManaged)return;const e=this.overlayElement;if(e){const t=this.triggerElement;e.triggerElement=t}})}}o([a({type:Boolean})],Tooltip.prototype,"delayed",2),o([a({type:Boolean})],Tooltip.prototype,"disabled",2),o([a({type:Boolean,attribute:"self-managed"})],Tooltip.prototype,"selfManaged",2),o([a({type:Number})],Tooltip.prototype,"offset",2),o([a({type:Boolean,reflect:!0})],Tooltip.prototype,"open",2),o([d("sp-overlay")],Tooltip.prototype,"overlayElement",2),o([a({reflect:!0})],Tooltip.prototype,"placement",2),o([d("#tip")],Tooltip.prototype,"tipElement",2),o([a({type:Number})],Tooltip.prototype,"tipPadding",2),o([a({type:String})],Tooltip.prototype,"variant",1);
+//# sourceMappingURL=Tooltip.js.map