@aquera/nile-elements 1.2.7-beta-1.0 → 1.2.7-beta-1.1

package/package.json

@@ -3,7 +3,7 @@
   "description": "Webcomponent nile-elements following open-wc recommendations",
   "license": "MIT",
   "author": "nile-elements",
-  "version": "1.2.7-beta-1.0",
+  "version": "1.2.7-beta-1.1",
   "main": "dist/src/index.js",
   "type": "module",
   "module": "dist/src/index.js",

package/src/nile-light-tooltip/nile-light-tooltip.ts

@@ -1,18 +1,15 @@
-/**
- * Copyright Aquera Inc 2025
- *
- * This source code is licensed under the BSD-3-Clause license found in the
- * LICENSE file in the root directory of this source tree.
- */
-
-import { html, CSSResultArray, TemplateResult, PropertyValues } from 'lit';
 import { customElement, property } from 'lit/decorators.js';
+import { CSSResultArray, PropertyValues } from 'lit';
 import { styles } from './nile-light-tooltip.css';
 import NileElement from '../internal/nile-element';
-import tippy, { Instance, Props } from 'tippy.js';
+import tippy, { Instance, Props, followCursor, roundArrow } from 'tippy.js';
+import { parseFollowCursor, parseDuration } from './utils';
 
 /**
  * Nile light-tooltip component.
+ *	
+ * Supports wrapper and sibling (for) modes.
+ * Aligns with Tippy.js props and Nile design system.
  *
  * @tag nile-light-tooltip
  */
@@ -23,84 +20,277 @@ export class NileLightTooltip extends NileElement {
   }
 
   protected createRenderRoot() {
-    // Keep tooltip in the light DOM
-    return this;
+    return this; // Light DOM
   }
 
-  /** Tooltip text content */
-  @property({ type: String }) content = '';
+  // ───────────── Props ─────────────
+  /** ID of the target element (for sibling mode) */
+  @property({ type: String, attribute: 'for' }) for: string | null = null;
+
+  /** Tooltip content text or HTML */
+  @property({ type: String, reflect: true }) content = '';
+
+  /** Tooltip size (applies CSS class) */
+  @property({ type: String, reflect: true }) size: 'small' | 'large' = 'small';
+
+ /** Animation duration for show/hide (ms). Can be a single value or [show, hide]. */
+@property({ type: String, reflect: true }) duration: string | number | [number, number] = 200;
+
+
+
+  /** Placement of the tooltip */
+  @property({ type: String })
+  placement:
+    | 'top'
+    | 'top-start'
+    | 'top-end'
+    | 'right'
+    | 'right-start'
+    | 'right-end'
+    | 'bottom'
+    | 'bottom-start'
+    | 'bottom-end'
+    | 'left'
+    | 'left-start'
+    | 'left-end'
+    | 'auto'
+    | 'auto-start'
+    | 'auto-end' = 'top';
+
+  /** Disabled state */
+  @property({ type: Boolean }) disabled = false;
+
+  /** Distance (Popper offset Y or main axis) */
+  @property({ type: Number }) distance = 8;
 
-  /** Placement of the tooltip (top, right, bottom, left) */
-  @property({ type: String }) placement: Props['placement'] = 'top';
+  /** Skidding (Popper offset X or cross axis) */
+  @property({ type: Number }) skidding = 0;
 
-  /** Whether tooltip should show on hover or click */
+  /** Whether tooltip is open (controlled mode) */
+  @property({ type: Boolean, reflect: true }) open = false;
+
+  /** Trigger behavior */
   @property({ type: String }) trigger: Props['trigger'] = 'mouseenter focus';
 
-  private tooltipInstance?: Instance[];
+  /** Hoist the tooltip to body (avoid clipping) */
+  @property({ type: Boolean, reflect: true }) hoist = false;
+
+  /** Allow HTML content rendering */
+  @property({ type: Boolean, reflect: true }) allowHTML = false;
+
+  /** Cursor following mode */
+  @property({ type: String, reflect: true, attribute: true })
+  followCursor:
+    | boolean
+    | 'initial'
+    | 'horizontal'
+    | 'vertical'
+    | 'true'
+    | 'false' = false;
+
+  /** Arrow type for tooltip */
+  @property({ type: String, reflect: true, attribute: true })
+  arrow: 'default' | 'round' | 'large' | 'small' | 'wide' | 'narrow' | 'none' =
+    'default';
+
+  private tooltipInstances?: Instance[];
+  private singleInstance?: Instance;
+  private targetEl?: HTMLElement | null;
+  private generatedId?: string;
+  private prevDescribedby?: string | null;
 
   constructor() {
     super();
     this.injectTippyStyles();
   }
 
-  /**
-   * Injects Tippy.js base styles into the Light DOM (document.head)
-   * if not already present.
-   */
+  // Inject custom styles for tooltips
   private injectTippyStyles(): void {
-    const STYLE_ID = 'nile-tippy-styles';
-    if (document.getElementById(STYLE_ID)) return; // avoid duplicates
+    const STYLE_ID = 'nile-light-tooltip-styles';
+    if (document.getElementById(STYLE_ID)) return;
 
     const style = document.createElement('style');
     style.id = STYLE_ID;
     style.textContent = `
-      .tippy-box[data-animation=fade][data-state=hidden]{opacity:0}
-      [data-tippy-root]{max-width:calc(100vw - 10px)}
-      .tippy-box{position:relative;background-color:#333;color:#fff;border-radius:4px;font-size:14px;line-height:1.4;white-space:normal;outline:0;transition-property:transform,visibility,opacity}
-      .tippy-box[data-placement^=top]>.tippy-arrow{bottom:0}
-      .tippy-box[data-placement^=top]>.tippy-arrow:before{bottom:-7px;left:0;border-width:8px 8px 0;border-top-color:initial;transform-origin:center top}
-      .tippy-box[data-placement^=bottom]>.tippy-arrow{top:0}
-      .tippy-box[data-placement^=bottom]>.tippy-arrow:before{top:-7px;left:0;border-width:0 8px 8px;border-bottom-color:initial;transform-origin:center bottom}
-      .tippy-box[data-placement^=left]>.tippy-arrow{right:0}
-      .tippy-box[data-placement^=left]>.tippy-arrow:before{border-width:8px 0 8px 8px;border-left-color:initial;right:-7px;transform-origin:center left}
-      .tippy-box[data-placement^=right]>.tippy-arrow{left:0}
-      .tippy-box[data-placement^=right]>.tippy-arrow:before{left:-7px;border-width:8px 8px 8px 0;border-right-color:initial;transform-origin:center right}
-      .tippy-box[data-inertia][data-state=visible]{transition-timing-function:cubic-bezier(.54,1.5,.38,1.11)}
-      .tippy-arrow{width:16px;height:16px;color:#333}
-      .tippy-arrow:before{content:"";position:absolute;border-color:transparent;border-style:solid}
-      .tippy-content{position:relative;padding:5px 9px;z-index:1}
+      .tippy-box[data-animation=fade][data-state=hidden] { opacity: 0; }
+      [data-tippy-root] { max-width: calc(100vw - 10px); }
+      .tippy-box {
+        position: relative;
+        background-color: #333;
+        color: #fff;
+        border-radius: 4px;
+        font-size: 14px;
+        line-height: 1.4;
+        white-space: normal;
+        outline: 0;
+        transition-property: transform, visibility, opacity;
+      }
+
+      /* Placement-specific arrows */
+      .tippy-box[data-placement^=top] > .tippy-arrow { bottom: 0; }
+      .tippy-box[data-placement^=top] > .tippy-arrow:before {
+        bottom: -7px;
+        border-width: 8px 8px 0;
+        border-top-color: initial;
+      }
+
+      .tippy-box[data-placement^=bottom] > .tippy-arrow { top: 0; }
+      .tippy-box[data-placement^=bottom] > .tippy-arrow:before {
+        top: -7px;
+        border-width: 0 8px 8px;
+        border-bottom-color: initial;
+      }
+
+      .tippy-box[data-placement^=left] > .tippy-arrow { right: 0; }
+      .tippy-box[data-placement^=left] > .tippy-arrow:before {
+        right: -7px;
+        border-width: 8px 0 8px 8px;
+        border-left-color: initial;
+      }
+
+      .tippy-box[data-placement^=right] > .tippy-arrow { left: 0; }
+      .tippy-box[data-placement^=right] > .tippy-arrow:before {
+        left: -7px;
+        border-width: 8px 8px 8px 0;
+        border-right-color: initial;
+      }
+
+      .tippy-box[data-inertia][data-state=visible] {
+        transition-timing-function: cubic-bezier(.54, 1.5, .38, 1.11);
+      }
+
+      .tippy-box.large { font-size: 16px; padding: 8px 12px; }
+      .tippy-arrow { width: 16px; height: 16px; color: #333; }
+      .tippy-arrow:before {
+        content: "";
+        position: absolute;
+        border-color: transparent;
+        border-style: solid;
+      }
+
+      .tippy-content {
+        position: relative;
+        padding: 5px 9px;
+        z-index: 1;
+      }
+		.tippy-box[data-placement^=top]>.tippy-svg-arrow{bottom:0}.tippy-box[data-placement^=top]>.tippy-svg-arrow:after,.tippy-box[data-placement^=top]>.tippy-svg-arrow>svg{top:16px;transform:rotate(180deg)}.tippy-box[data-placement^=bottom]>.tippy-svg-arrow{top:0}.tippy-box[data-placement^=bottom]>.tippy-svg-arrow>svg{bottom:16px}.tippy-box[data-placement^=left]>.tippy-svg-arrow{right:0}.tippy-box[data-placement^=left]>.tippy-svg-arrow:after,.tippy-box[data-placement^=left]>.tippy-svg-arrow>svg{transform:rotate(90deg);top:calc(50% - 3px);left:11px}.tippy-box[data-placement^=right]>.tippy-svg-arrow{left:0}.tippy-box[data-placement^=right]>.tippy-svg-arrow:after,.tippy-box[data-placement^=right]>.tippy-svg-arrow>svg{transform:rotate(-90deg);top:calc(50% - 3px);right:11px}.tippy-svg-arrow{width:16px;height:16px;fill:#333;text-align:initial}.tippy-svg-arrow,.tippy-svg-arrow>svg{position:absolute}
     `;
     document.head.appendChild(style);
   }
 
   firstUpdated(): void {
-    const assignedNodes = this.querySelectorAll('*');
-    if (assignedNodes.length > 0) {
-      this.tooltipInstance = tippy(assignedNodes, {
-        content: this.content,
-        placement: this.placement,
-        trigger: this.trigger,
-        theme: 'light',
-        animation: 'fade',
-      });
+    this.attachTooltip();
+  }
+
+ 
+
+
+  private attachTooltip(): void {
+    this.destroyTooltips();
+    if (this.disabled) return;
+
+    const options: Partial<Props> = {
+      content: this.content,
+      placement: this.placement,
+      trigger: this.trigger,
+      offset: [this.skidding, this.distance],
+      theme: 'light',
+      animation: 'fade',
+	  duration: parseDuration(this.duration),
+      allowHTML: this.allowHTML,
+      appendTo: this.hoist ? document.body : undefined,
+      followCursor: parseFollowCursor(this.followCursor),
+      plugins: parseFollowCursor(this.followCursor) ? [followCursor] : [],
+      arrow: roundArrow,
+      onShow: instance => { this.open = true; return undefined; },
+      onHide: instance => { this.open = false; return undefined; }
+    };
+
+    // Sibling mode
+    if (this.for) {
+      this.targetEl = document.getElementById(this.for);
+      if (!this.targetEl) return;
+
+      if (!this.id) {
+        this.generatedId = `nile-tooltip-${Math.random().toString(36).slice(2, 9)}`;
+        this.id = this.generatedId;
+      }
+
+      this.prevDescribedby = this.targetEl.getAttribute('aria-describedby');
+      const describedby = this.prevDescribedby
+        ? `${this.prevDescribedby} ${this.id}`
+        : this.id;
+      this.targetEl.setAttribute('aria-describedby', describedby);
+
+      this.singleInstance = tippy(this.targetEl, options);
+      if (this.size)
+        this.singleInstance.popper
+          .querySelector('.tippy-box')
+          ?.classList.add(this.size);
+		  if (this.open) {
+			queueMicrotask(() => this.singleInstance?.show());
+		  }		  
+      return;
+    }
+
+    // Wrapper mode
+    const children = this.querySelectorAll('*');
+    if (children.length > 0) {
+      this.tooltipInstances = tippy(children, options);
+      this.tooltipInstances.forEach(t =>
+        t.popper.querySelector('.tippy-box')?.classList.add(this.size)
+      );
+      if (this.open) this.tooltipInstances.forEach(t => t.show());
+    }
+  }
+
+  private destroyTooltips(): void {
+    this.tooltipInstances?.forEach(t => t.destroy());
+    this.singleInstance?.destroy();
+    this.tooltipInstances = undefined;
+    this.singleInstance = undefined;
+
+    if (this.targetEl && this.id) {
+      const current = this.targetEl
+        .getAttribute('aria-describedby')
+        ?.split(' ')
+        .filter(id => id !== this.id)
+        .join(' ')
+        .trim();
+      if (current) {
+        this.targetEl.setAttribute('aria-describedby', current);
+      } else {
+        this.targetEl.removeAttribute('aria-describedby');
+      }
     }
   }
 
   disconnectedCallback(): void {
     super.disconnectedCallback();
-    this.tooltipInstance?.forEach((t) => t.destroy());
+    this.destroyTooltips();
   }
 
-  updated(changedProperties: PropertyValues): void {
-    super.updated(changedProperties);
-    if (changedProperties.has('content')) {
-      this.tooltipInstance?.forEach((t) => (t.setContent(this.content)));
+  updated(changed: PropertyValues): void {
+    super.updated(changed);
+
+    if (
+      ['for', 'content', 'placement', 'distance', 'skidding', 'trigger', 'disabled', 'hoist', 'size', 'arrow']
+        .some(p => changed.has(p))
+    ) {
+      this.attachTooltip();
     }
-	 
-  }
- 
 
- 
+    // Controlled open/close
+    if (changed.has('open')) {
+      if (this.open) {
+        this.singleInstance?.show();
+        this.tooltipInstances?.forEach(t => t.show());
+      } else {
+        this.singleInstance?.hide();
+        this.tooltipInstances?.forEach(t => t.hide());
+      }
+    }
+  }
 }
 
 export default NileLightTooltip;

package/src/nile-light-tooltip/utils.ts

@@ -0,0 +1,33 @@
+ 
+export function parseFollowCursor(
+  value: boolean | 'initial' | 'horizontal' | 'vertical' | 'true' | 'false'
+): boolean | 'initial' | 'horizontal' | 'vertical' {
+  if (value === true || value === 'true') return true;
+  if (value === false || value === 'false') return false;
+  if (['initial', 'horizontal', 'vertical'].includes(String(value))) {
+    return value as 'initial' | 'horizontal' | 'vertical';
+  }
+  return false;
+}
+
+
+export function parseDuration(
+    value: string | number | [number, number] | undefined
+  ): number | [number, number] {
+    if (Array.isArray(value)) return value;
+    if (typeof value === 'number') return value;
+  
+    if (typeof value === 'string') {
+      // Handle comma-separated (e.g. "200,100")
+      if (value.includes(',')) {
+        const parts = value.split(',').map(v => parseInt(v.trim(), 10));
+        return parts as [number, number];
+      }
+  
+      // Single numeric string
+      const num = parseInt(value, 10);
+      if (!isNaN(num)) return num;
+    }
+  
+    return 200; // default fallback
+  }

package/vscode-html-custom-data.json

@@ -2550,15 +2550,37 @@
     },
     {
       "name": "nile-light-tooltip",
-      "description": "Nile light-tooltip component.\n\nAttributes:\n\n  * `content` {`string`} - Tooltip text content\n\n  * `placement` {`Placement`} - Placement of the tooltip (top, right, bottom, left)\n\n  * `trigger` {`string`} - Whether tooltip should show on hover or click\n\nProperties:\n\n  * `content` {`string`} - Tooltip text content\n\n  * `placement` {`Placement`} - Placement of the tooltip (top, right, bottom, left)\n\n  * `trigger` {`string`} - Whether tooltip should show on hover or click\n\n  * `tooltipInstance` {`Instance<Props>[] | undefined`} - \n\n  * `BUBBLES` {`boolean`} - \n\n  * `COMPOSED` {`boolean`} - \n\n  * `CANCELABLE` {`boolean`} - ",
+      "description": "Nile light-tooltip component.\n\nSupports wrapper and sibling (for) modes.\nAligns with Tippy.js props and Nile design system.\n\nAttributes:\n\n  * `for` {`string | null`} - ID of the target element (for sibling mode)\n\n  * `content` {`string`} - Tooltip content text or HTML\n\n  * `size` {`\"small\" | \"large\"`} - Tooltip size (applies CSS class)\n\n  * `duration` {`string | number | [number, number]`} - Animation duration for show/hide (ms). Can be a single value or [show, hide].\n\n  * `placement` {`\"left\" | \"right\" | \"top\" | \"top-start\" | \"top-end\" | \"right-start\" | \"right-end\" | \"bottom\" | \"bottom-start\" | \"bottom-end\" | \"left-start\" | \"left-end\" | \"auto\" | \"auto-start\" | \"auto-end\"`} - Placement of the tooltip\n\n  * `disabled` {`boolean`} - Disabled state\n\n  * `distance` {`number`} - Distance (Popper offset Y or main axis)\n\n  * `skidding` {`number`} - Skidding (Popper offset X or cross axis)\n\n  * `open` {`boolean`} - Whether tooltip is open (controlled mode)\n\n  * `trigger` {`string`} - Trigger behavior\n\n  * `hoist` {`boolean`} - Hoist the tooltip to body (avoid clipping)\n\n  * `allowHTML` {`boolean`} - Allow HTML content rendering\n\n  * `followCursor` {`boolean | \"false\" | \"true\" | \"initial\" | \"horizontal\" | \"vertical\"`} - Cursor following mode\n\n  * `arrow` {`\"small\" | \"none\" | \"large\" | \"narrow\" | \"default\" | \"round\" | \"wide\"`} - Arrow type for tooltip\n\nProperties:\n\n  * `for` {`string | null`} - ID of the target element (for sibling mode)\n\n  * `content` {`string`} - Tooltip content text or HTML\n\n  * `size` {`\"small\" | \"large\"`} - Tooltip size (applies CSS class)\n\n  * `duration` {`string | number | [number, number]`} - Animation duration for show/hide (ms). Can be a single value or [show, hide].\n\n  * `placement` {`\"left\" | \"right\" | \"top\" | \"top-start\" | \"top-end\" | \"right-start\" | \"right-end\" | \"bottom\" | \"bottom-start\" | \"bottom-end\" | \"left-start\" | \"left-end\" | \"auto\" | \"auto-start\" | \"auto-end\"`} - Placement of the tooltip\n\n  * `disabled` {`boolean`} - Disabled state\n\n  * `distance` {`number`} - Distance (Popper offset Y or main axis)\n\n  * `skidding` {`number`} - Skidding (Popper offset X or cross axis)\n\n  * `open` {`boolean`} - Whether tooltip is open (controlled mode)\n\n  * `trigger` {`string`} - Trigger behavior\n\n  * `hoist` {`boolean`} - Hoist the tooltip to body (avoid clipping)\n\n  * `allowHTML` {`boolean`} - Allow HTML content rendering\n\n  * `followCursor` {`boolean | \"false\" | \"true\" | \"initial\" | \"horizontal\" | \"vertical\"`} - Cursor following mode\n\n  * `arrow` {`\"small\" | \"none\" | \"large\" | \"narrow\" | \"default\" | \"round\" | \"wide\"`} - Arrow type for tooltip\n\n  * `tooltipInstances` {`Instance<Props>[] | undefined`} - \n\n  * `singleInstance` {`Instance<Props> | undefined`} - \n\n  * `targetEl` {`HTMLElement | null | undefined`} - \n\n  * `generatedId` {`string | undefined`} - \n\n  * `prevDescribedby` {`string | null | undefined`} - \n\n  * `BUBBLES` {`boolean`} - \n\n  * `COMPOSED` {`boolean`} - \n\n  * `CANCELABLE` {`boolean`} - ",
       "attributes": [
+        {
+          "name": "for",
+          "description": "`for` {`string | null`} - ID of the target element (for sibling mode)\n\nProperty: for\n\nDefault: null",
+          "values": []
+        },
         {
           "name": "content",
-          "description": "`content` {`string`} - Tooltip text content\n\nProperty: content\n\nDefault: "
+          "description": "`content` {`string`} - Tooltip content text or HTML\n\nProperty: content\n\nDefault: "
+        },
+        {
+          "name": "size",
+          "description": "`size` {`\"small\" | \"large\"`} - Tooltip size (applies CSS class)\n\nProperty: size\n\nDefault: small",
+          "values": [
+            {
+              "name": "small"
+            },
+            {
+              "name": "large"
+            }
+          ]
+        },
+        {
+          "name": "duration",
+          "description": "`duration` {`string | number | [number, number]`} - Animation duration for show/hide (ms). Can be a single value or [show, hide].\n\nProperty: duration\n\nDefault: 200",
+          "values": []
         },
         {
           "name": "placement",
-          "description": "`placement` {`Placement`} - Placement of the tooltip (top, right, bottom, left)\n\nProperty: placement\n\nDefault: top",
+          "description": "`placement` {`\"left\" | \"right\" | \"top\" | \"top-start\" | \"top-end\" | \"right-start\" | \"right-end\" | \"bottom\" | \"bottom-start\" | \"bottom-end\" | \"left-start\" | \"left-end\" | \"auto\" | \"auto-start\" | \"auto-end\"`} - Placement of the tooltip\n\nProperty: placement\n\nDefault: top",
           "values": [
             {
               "name": "left"
@@ -2607,9 +2629,85 @@
             }
           ]
         },
+        {
+          "name": "disabled",
+          "description": "`disabled` {`boolean`} - Disabled state\n\nProperty: disabled\n\nDefault: false",
+          "valueSet": "v"
+        },
+        {
+          "name": "distance",
+          "description": "`distance` {`number`} - Distance (Popper offset Y or main axis)\n\nProperty: distance\n\nDefault: 8"
+        },
+        {
+          "name": "skidding",
+          "description": "`skidding` {`number`} - Skidding (Popper offset X or cross axis)\n\nProperty: skidding\n\nDefault: 0"
+        },
+        {
+          "name": "open",
+          "description": "`open` {`boolean`} - Whether tooltip is open (controlled mode)\n\nProperty: open\n\nDefault: false",
+          "valueSet": "v"
+        },
         {
           "name": "trigger",
-          "description": "`trigger` {`string`} - Whether tooltip should show on hover or click\n\nProperty: trigger\n\nDefault: mouseenter focus"
+          "description": "`trigger` {`string`} - Trigger behavior\n\nProperty: trigger\n\nDefault: mouseenter focus"
+        },
+        {
+          "name": "hoist",
+          "description": "`hoist` {`boolean`} - Hoist the tooltip to body (avoid clipping)\n\nProperty: hoist\n\nDefault: false",
+          "valueSet": "v"
+        },
+        {
+          "name": "allowHTML",
+          "description": "`allowHTML` {`boolean`} - Allow HTML content rendering\n\nProperty: allowHTML\n\nDefault: false",
+          "valueSet": "v"
+        },
+        {
+          "name": "followCursor",
+          "description": "`followCursor` {`boolean | \"false\" | \"true\" | \"initial\" | \"horizontal\" | \"vertical\"`} - Cursor following mode\n\nProperty: followCursor\n\nDefault: false",
+          "values": [
+            {
+              "name": "false"
+            },
+            {
+              "name": "true"
+            },
+            {
+              "name": "initial"
+            },
+            {
+              "name": "horizontal"
+            },
+            {
+              "name": "vertical"
+            }
+          ]
+        },
+        {
+          "name": "arrow",
+          "description": "`arrow` {`\"small\" | \"none\" | \"large\" | \"narrow\" | \"default\" | \"round\" | \"wide\"`} - Arrow type for tooltip\n\nProperty: arrow\n\nDefault: default",
+          "values": [
+            {
+              "name": "small"
+            },
+            {
+              "name": "none"
+            },
+            {
+              "name": "large"
+            },
+            {
+              "name": "narrow"
+            },
+            {
+              "name": "default"
+            },
+            {
+              "name": "round"
+            },
+            {
+              "name": "wide"
+            }
+          ]
         }
       ]
     },
@@ -2991,7 +3089,7 @@
     },
     {
       "name": "nile-popup",
-      "description": "Nile icon component.\n\nAttributes:\n\n  * `anchor` {`string | Element`} - The element the popup will be anchored to. If the anchor lives outside of the popup, you can provide its `id` or a\nreference to it here. If the anchor lives inside the popup, use the `anchor` slot instead.\n\n  * `active` {`boolean`} - Activates the positioning logic and shows the popup. When this attribute is removed, the positioning logic is torn\ndown and the popup will be hidden.\n\n  * `placement` {`TooltipPosition`} - The preferred placement of the popup. Note that the actual placement will vary as configured to keep the\npanel inside of the viewport.\n\n  * `strategy` {`\"absolute\" | \"fixed\"`} - Determines how the popup is positioned. The `absolute` strategy works well in most cases, but if overflow is\nclipped, using a `fixed` position strategy can often workaround it.\n\n  * `distance` {`number`} - The distance in pixels from which to offset the panel away from its anchor.\n\n  * `skidding` {`number`} - The distance in pixels from which to offset the panel along its anchor.\n\n  * `arrow` {`boolean`} - Attaches an arrow to the popup. The arrow's size and color can be customized using the `--arrow-size` and\n`--arrow-color` custom properties. For additional customizations, you can also target the arrow using\n`::part(arrow)` in your stylesheet.\n\n  * `arrow-placement` {`\"end\" | \"start\" | \"center\" | \"anchor\"`} - The placement of the arrow. The default is `anchor`, which will align the arrow as close to the center of the\nanchor as possible, considering available space and `arrow-padding`. A value of `start`, `end`, or `center` will\nalign the arrow to the start, end, or center of the popover instead.\n\n  * `arrow-padding` {`number`} - The amount of padding between the arrow and the edges of the popup. If the popup has a border-radius, for example,\nthis will prevent it from overflowing the corners.\n\n  * `flip` {`boolean`} - When set, placement of the popup will flip to the opposite site to keep it in view. You can use\n`flipFallbackPlacements` to further configure how the fallback placement is determined.\n\n  * `flip-fallback-placements` {`string`} - If the preferred placement doesn't fit, popup will be tested in these fallback placements until one fits. Must be a\nstring of any number of placements separated by a space, e.g. \"top bottom left\". If no placement fits, the flip\nfallback strategy will be used instead.\n\n  * `flip-fallback-strategy` {`\"best-fit\" | \"initial\"`} - When neither the preferred placement nor the fallback placements fit, this value will be used to determine whether\nthe popup should be positioned using the best available fit based on available space or as it was initially\npreferred.\n\n  * `flipBoundary` {`Element | Element[]`} - The flip boundary describes clipping element(s) that overflow will be checked relative to when flipping. By\ndefault, the boundary includes overflow ancestors that will cause the element to be clipped. If needed, you can\nchange the boundary by passing a reference to one or more elements to this property.\n\n  * `flip-padding` {`number`} - The amount of padding, in pixels, to exceed before the flip behavior will occur.\n\n  * `shift` {`boolean`} - Moves the popup along the axis to keep it in view when clipped.\n\n  * `shiftBoundary` {`Element | Element[]`} - The shift boundary describes clipping element(s) that overflow will be checked relative to when shifting. By\ndefault, the boundary includes overflow ancestors that will cause the element to be clipped. If needed, you can\nchange the boundary by passing a reference to one or more elements to this property.\n\n  * `shift-padding` {`number`} - The amount of padding, in pixels, to exceed before the shift behavior will occur.\n\n  * `auto-size` {`\"both\" | \"horizontal\" | \"vertical\"`} - When set, this will cause the popup to automatically resize itself to prevent it from overflowing.\n\n  * `sync` {`\"width\" | \"height\" | \"both\"`} - Syncs the popup's width or height to that of the anchor element.\n\n  * `autoSizeBoundary` {`Element | Element[]`} - The auto-size boundary describes clipping element(s) that overflow will be checked relative to when resizing. By\ndefault, the boundary includes overflow ancestors that will cause the element to be clipped. If needed, you can\nchange the boundary by passing a reference to one or more elements to this property.\n\n  * `auto-size-padding` {`number`} - The amount of padding, in pixels, to exceed before the auto-size behavior will occur.\n\nProperties:\n\n  * `styles` - \n\n  * `anchorEl` {`Element | null`} - \n\n  * `cleanup` - \n\n  * `popup` {`HTMLElement`} - A reference to the internal popup container. Useful for animating and styling the popup with JavaScript.\n\n  * `arrowEl` {`HTMLElement`} - \n\n  * `anchor` {`string | Element`} - The element the popup will be anchored to. If the anchor lives outside of the popup, you can provide its `id` or a\nreference to it here. If the anchor lives inside the popup, use the `anchor` slot instead.\n\n  * `active` {`boolean`} - Activates the positioning logic and shows the popup. When this attribute is removed, the positioning logic is torn\ndown and the popup will be hidden.\n\n  * `placement` {`TooltipPosition`} - The preferred placement of the popup. Note that the actual placement will vary as configured to keep the\npanel inside of the viewport.\n\n  * `strategy` {`\"absolute\" | \"fixed\"`} - Determines how the popup is positioned. The `absolute` strategy works well in most cases, but if overflow is\nclipped, using a `fixed` position strategy can often workaround it.\n\n  * `distance` {`number`} - The distance in pixels from which to offset the panel away from its anchor.\n\n  * `skidding` {`number`} - The distance in pixels from which to offset the panel along its anchor.\n\n  * `arrow` {`boolean`} - Attaches an arrow to the popup. The arrow's size and color can be customized using the `--arrow-size` and\n`--arrow-color` custom properties. For additional customizations, you can also target the arrow using\n`::part(arrow)` in your stylesheet.\n\n  * `arrowPlacement` {`\"end\" | \"start\" | \"center\" | \"anchor\"`} - The placement of the arrow. The default is `anchor`, which will align the arrow as close to the center of the\nanchor as possible, considering available space and `arrow-padding`. A value of `start`, `end`, or `center` will\nalign the arrow to the start, end, or center of the popover instead.\n\n  * `arrowPadding` {`number`} - The amount of padding between the arrow and the edges of the popup. If the popup has a border-radius, for example,\nthis will prevent it from overflowing the corners.\n\n  * `flip` {`boolean`} - When set, placement of the popup will flip to the opposite site to keep it in view. You can use\n`flipFallbackPlacements` to further configure how the fallback placement is determined.\n\n  * `flipFallbackPlacements` {`string`} - If the preferred placement doesn't fit, popup will be tested in these fallback placements until one fits. Must be a\nstring of any number of placements separated by a space, e.g. \"top bottom left\". If no placement fits, the flip\nfallback strategy will be used instead.\n\n  * `flipFallbackStrategy` {`\"best-fit\" | \"initial\"`} - When neither the preferred placement nor the fallback placements fit, this value will be used to determine whether\nthe popup should be positioned using the best available fit based on available space or as it was initially\npreferred.\n\n  * `flipBoundary` {`Element | Element[]`} - The flip boundary describes clipping element(s) that overflow will be checked relative to when flipping. By\ndefault, the boundary includes overflow ancestors that will cause the element to be clipped. If needed, you can\nchange the boundary by passing a reference to one or more elements to this property.\n\n  * `flipPadding` {`number`} - The amount of padding, in pixels, to exceed before the flip behavior will occur.\n\n  * `shift` {`boolean`} - Moves the popup along the axis to keep it in view when clipped.\n\n  * `shiftBoundary` {`Element | Element[]`} - The shift boundary describes clipping element(s) that overflow will be checked relative to when shifting. By\ndefault, the boundary includes overflow ancestors that will cause the element to be clipped. If needed, you can\nchange the boundary by passing a reference to one or more elements to this property.\n\n  * `shiftPadding` {`number`} - The amount of padding, in pixels, to exceed before the shift behavior will occur.\n\n  * `autoSize` {`\"both\" | \"horizontal\" | \"vertical\"`} - When set, this will cause the popup to automatically resize itself to prevent it from overflowing.\n\n  * `sync` {`\"width\" | \"height\" | \"both\"`} - Syncs the popup's width or height to that of the anchor element.\n\n  * `autoSizeBoundary` {`Element | Element[]`} - The auto-size boundary describes clipping element(s) that overflow will be checked relative to when resizing. By\ndefault, the boundary includes overflow ancestors that will cause the element to be clipped. If needed, you can\nchange the boundary by passing a reference to one or more elements to this property.\n\n  * `autoSizePadding` {`number`} - The amount of padding, in pixels, to exceed before the auto-size behavior will occur.\n\n  * `BUBBLES` {`boolean`} - \n\n  * `COMPOSED` {`boolean`} - \n\n  * `CANCELABLE` {`boolean`} - ",
+      "description": "Nile icon component.\n\nAttributes:\n\n  * `anchor` {`string | Element`} - The element the popup will be anchored to. If the anchor lives outside of the popup, you can provide its `id` or a\nreference to it here. If the anchor lives inside the popup, use the `anchor` slot instead.\n\n  * `active` {`boolean`} - Activates the positioning logic and shows the popup. When this attribute is removed, the positioning logic is torn\ndown and the popup will be hidden.\n\n  * `placement` {`TooltipPosition`} - The preferred placement of the popup. Note that the actual placement will vary as configured to keep the\npanel inside of the viewport.\n\n  * `strategy` {`\"absolute\" | \"fixed\"`} - Determines how the popup is positioned. The `absolute` strategy works well in most cases, but if overflow is\nclipped, using a `fixed` position strategy can often workaround it.\n\n  * `distance` {`number`} - The distance in pixels from which to offset the panel away from its anchor.\n\n  * `skidding` {`number`} - The distance in pixels from which to offset the panel along its anchor.\n\n  * `arrow` {`boolean`} - Attaches an arrow to the popup. The arrow's size and color can be customized using the `--arrow-size` and\n`--arrow-color` custom properties. For additional customizations, you can also target the arrow using\n`::part(arrow)` in your stylesheet.\n\n  * `arrow-placement` {`\"end\" | \"start\" | \"center\" | \"anchor\"`} - The placement of the arrow. The default is `anchor`, which will align the arrow as close to the center of the\nanchor as possible, considering available space and `arrow-padding`. A value of `start`, `end`, or `center` will\nalign the arrow to the start, end, or center of the popover instead.\n\n  * `arrow-padding` {`number`} - The amount of padding between the arrow and the edges of the popup. If the popup has a border-radius, for example,\nthis will prevent it from overflowing the corners.\n\n  * `flip` {`boolean`} - When set, placement of the popup will flip to the opposite site to keep it in view. You can use\n`flipFallbackPlacements` to further configure how the fallback placement is determined.\n\n  * `flip-fallback-placements` {`string`} - If the preferred placement doesn't fit, popup will be tested in these fallback placements until one fits. Must be a\nstring of any number of placements separated by a space, e.g. \"top bottom left\". If no placement fits, the flip\nfallback strategy will be used instead.\n\n  * `flip-fallback-strategy` {`\"initial\" | \"best-fit\"`} - When neither the preferred placement nor the fallback placements fit, this value will be used to determine whether\nthe popup should be positioned using the best available fit based on available space or as it was initially\npreferred.\n\n  * `flipBoundary` {`Element | Element[]`} - The flip boundary describes clipping element(s) that overflow will be checked relative to when flipping. By\ndefault, the boundary includes overflow ancestors that will cause the element to be clipped. If needed, you can\nchange the boundary by passing a reference to one or more elements to this property.\n\n  * `flip-padding` {`number`} - The amount of padding, in pixels, to exceed before the flip behavior will occur.\n\n  * `shift` {`boolean`} - Moves the popup along the axis to keep it in view when clipped.\n\n  * `shiftBoundary` {`Element | Element[]`} - The shift boundary describes clipping element(s) that overflow will be checked relative to when shifting. By\ndefault, the boundary includes overflow ancestors that will cause the element to be clipped. If needed, you can\nchange the boundary by passing a reference to one or more elements to this property.\n\n  * `shift-padding` {`number`} - The amount of padding, in pixels, to exceed before the shift behavior will occur.\n\n  * `auto-size` {`\"both\" | \"horizontal\" | \"vertical\"`} - When set, this will cause the popup to automatically resize itself to prevent it from overflowing.\n\n  * `sync` {`\"width\" | \"height\" | \"both\"`} - Syncs the popup's width or height to that of the anchor element.\n\n  * `autoSizeBoundary` {`Element | Element[]`} - The auto-size boundary describes clipping element(s) that overflow will be checked relative to when resizing. By\ndefault, the boundary includes overflow ancestors that will cause the element to be clipped. If needed, you can\nchange the boundary by passing a reference to one or more elements to this property.\n\n  * `auto-size-padding` {`number`} - The amount of padding, in pixels, to exceed before the auto-size behavior will occur.\n\nProperties:\n\n  * `styles` - \n\n  * `anchorEl` {`Element | null`} - \n\n  * `cleanup` - \n\n  * `popup` {`HTMLElement`} - A reference to the internal popup container. Useful for animating and styling the popup with JavaScript.\n\n  * `arrowEl` {`HTMLElement`} - \n\n  * `anchor` {`string | Element`} - The element the popup will be anchored to. If the anchor lives outside of the popup, you can provide its `id` or a\nreference to it here. If the anchor lives inside the popup, use the `anchor` slot instead.\n\n  * `active` {`boolean`} - Activates the positioning logic and shows the popup. When this attribute is removed, the positioning logic is torn\ndown and the popup will be hidden.\n\n  * `placement` {`TooltipPosition`} - The preferred placement of the popup. Note that the actual placement will vary as configured to keep the\npanel inside of the viewport.\n\n  * `strategy` {`\"absolute\" | \"fixed\"`} - Determines how the popup is positioned. The `absolute` strategy works well in most cases, but if overflow is\nclipped, using a `fixed` position strategy can often workaround it.\n\n  * `distance` {`number`} - The distance in pixels from which to offset the panel away from its anchor.\n\n  * `skidding` {`number`} - The distance in pixels from which to offset the panel along its anchor.\n\n  * `arrow` {`boolean`} - Attaches an arrow to the popup. The arrow's size and color can be customized using the `--arrow-size` and\n`--arrow-color` custom properties. For additional customizations, you can also target the arrow using\n`::part(arrow)` in your stylesheet.\n\n  * `arrowPlacement` {`\"end\" | \"start\" | \"center\" | \"anchor\"`} - The placement of the arrow. The default is `anchor`, which will align the arrow as close to the center of the\nanchor as possible, considering available space and `arrow-padding`. A value of `start`, `end`, or `center` will\nalign the arrow to the start, end, or center of the popover instead.\n\n  * `arrowPadding` {`number`} - The amount of padding between the arrow and the edges of the popup. If the popup has a border-radius, for example,\nthis will prevent it from overflowing the corners.\n\n  * `flip` {`boolean`} - When set, placement of the popup will flip to the opposite site to keep it in view. You can use\n`flipFallbackPlacements` to further configure how the fallback placement is determined.\n\n  * `flipFallbackPlacements` {`string`} - If the preferred placement doesn't fit, popup will be tested in these fallback placements until one fits. Must be a\nstring of any number of placements separated by a space, e.g. \"top bottom left\". If no placement fits, the flip\nfallback strategy will be used instead.\n\n  * `flipFallbackStrategy` {`\"initial\" | \"best-fit\"`} - When neither the preferred placement nor the fallback placements fit, this value will be used to determine whether\nthe popup should be positioned using the best available fit based on available space or as it was initially\npreferred.\n\n  * `flipBoundary` {`Element | Element[]`} - The flip boundary describes clipping element(s) that overflow will be checked relative to when flipping. By\ndefault, the boundary includes overflow ancestors that will cause the element to be clipped. If needed, you can\nchange the boundary by passing a reference to one or more elements to this property.\n\n  * `flipPadding` {`number`} - The amount of padding, in pixels, to exceed before the flip behavior will occur.\n\n  * `shift` {`boolean`} - Moves the popup along the axis to keep it in view when clipped.\n\n  * `shiftBoundary` {`Element | Element[]`} - The shift boundary describes clipping element(s) that overflow will be checked relative to when shifting. By\ndefault, the boundary includes overflow ancestors that will cause the element to be clipped. If needed, you can\nchange the boundary by passing a reference to one or more elements to this property.\n\n  * `shiftPadding` {`number`} - The amount of padding, in pixels, to exceed before the shift behavior will occur.\n\n  * `autoSize` {`\"both\" | \"horizontal\" | \"vertical\"`} - When set, this will cause the popup to automatically resize itself to prevent it from overflowing.\n\n  * `sync` {`\"width\" | \"height\" | \"both\"`} - Syncs the popup's width or height to that of the anchor element.\n\n  * `autoSizeBoundary` {`Element | Element[]`} - The auto-size boundary describes clipping element(s) that overflow will be checked relative to when resizing. By\ndefault, the boundary includes overflow ancestors that will cause the element to be clipped. If needed, you can\nchange the boundary by passing a reference to one or more elements to this property.\n\n  * `autoSizePadding` {`number`} - The amount of padding, in pixels, to exceed before the auto-size behavior will occur.\n\n  * `BUBBLES` {`boolean`} - \n\n  * `COMPOSED` {`boolean`} - \n\n  * `CANCELABLE` {`boolean`} - ",
       "attributes": [
         {
           "name": "anchor",
@@ -3103,13 +3201,13 @@
         },
         {
           "name": "flip-fallback-strategy",
-          "description": "`flip-fallback-strategy` {`\"best-fit\" | \"initial\"`} - When neither the preferred placement nor the fallback placements fit, this value will be used to determine whether\nthe popup should be positioned using the best available fit based on available space or as it was initially\npreferred.\n\nProperty: flipFallbackStrategy\n\nDefault: best-fit",
+          "description": "`flip-fallback-strategy` {`\"initial\" | \"best-fit\"`} - When neither the preferred placement nor the fallback placements fit, this value will be used to determine whether\nthe popup should be positioned using the best available fit based on available space or as it was initially\npreferred.\n\nProperty: flipFallbackStrategy\n\nDefault: best-fit",
           "values": [
             {
-              "name": "best-fit"
+              "name": "initial"
             },
             {
-              "name": "initial"
+              "name": "best-fit"
             }
           ]
         },