@iyulab/components 1.36.0 → 1.37.1

package/dist/react/UIcon.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { UIcon as UIconElement } from '../components/icon/UIcon.js';
+import { UIcon as UIconElement } from '@iyulab/components/dist/components/icon/UIcon.js';
 
 export const UIcon = createComponent({
   react: React,

package/dist/react/UIconButton.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { UIconButton as UIconButtonElement } from '../components/icon-button/UIconButton';
+import { UIconButton as UIconButtonElement } from '@iyulab/components/dist/components/icon-button/UIconButton.js';
 
 export declare const UIconButton: React.ForwardRefExoticComponent<
   Omit<Partial<UIconButtonElement>, keyof React.HTMLAttributes<UIconButtonElement>>

package/dist/react/UIconButton.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { UIconButton as UIconButtonElement } from '../components/icon-button/UIconButton.js';
+import { UIconButton as UIconButtonElement } from '@iyulab/components/dist/components/icon-button/UIconButton.js';
 
 export const UIconButton = createComponent({
   react: React,

package/dist/react/UInput.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { UInput as UInputElement } from '../components/input/UInput';
+import { UInput as UInputElement } from '@iyulab/components/dist/components/input/UInput.js';
 
 export declare const UInput: React.ForwardRefExoticComponent<
   Omit<Partial<UInputElement>, keyof React.HTMLAttributes<UInputElement>>

package/dist/react/UInput.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { UInput as UInputElement } from '../components/input/UInput.js';
+import { UInput as UInputElement } from '@iyulab/components/dist/components/input/UInput.js';
 
 export const UInput = createComponent({
   react: React,

package/dist/react/UMenu.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { UMenu as UMenuElement } from '../components/menu/UMenu';
+import { UMenu as UMenuElement } from '@iyulab/components/dist/components/menu/UMenu.js';
 
 export declare const UMenu: React.ForwardRefExoticComponent<
   Omit<Partial<UMenuElement>, keyof React.HTMLAttributes<UMenuElement>>

package/dist/react/UMenu.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { UMenu as UMenuElement } from '../components/menu/UMenu.js';
+import { UMenu as UMenuElement } from '@iyulab/components/dist/components/menu/UMenu.js';
 
 export const UMenu = createComponent({
   react: React,

package/dist/react/UMenuItem.d.ts

@@ -1,6 +1,6 @@
 import React from 'react';
-import { UMenuItem as UMenuItemElement } from '../components/menu-item/UMenuItem';
-import { type PickEventDetail } from '../events/PickEvent';
+import { UMenuItem as UMenuItemElement } from '@iyulab/components/dist/components/menu-item/UMenuItem.js';
+import { type PickEventDetail } from '@iyulab/components/dist/events/PickEvent.js';
 
 export declare const UMenuItem: React.ForwardRefExoticComponent<
   Omit<Partial<UMenuItemElement>, keyof React.HTMLAttributes<UMenuItemElement>>

package/dist/react/UMenuItem.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { UMenuItem as UMenuItemElement } from '../components/menu-item/UMenuItem.js';
+import { UMenuItem as UMenuItemElement } from '@iyulab/components/dist/components/menu-item/UMenuItem.js';
 
 export const UMenuItem = createComponent({
   react: React,

package/dist/react/UOption.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { UOption as UOptionElement } from '../components/option/UOption';
+import { UOption as UOptionElement } from '@iyulab/components/dist/components/option/UOption.js';
 
 export declare const UOption: React.ForwardRefExoticComponent<
   Omit<Partial<UOptionElement>, keyof React.HTMLAttributes<UOptionElement>>

package/dist/react/UOption.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { UOption as UOptionElement } from '../components/option/UOption.js';
+import { UOption as UOptionElement } from '@iyulab/components/dist/components/option/UOption.js';
 
 export const UOption = createComponent({
   react: React,

package/dist/react/UPanel.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { UPanel as UPanelElement } from '../components/panel/UPanel';
+import { UPanel as UPanelElement } from '@iyulab/components/dist/components/panel/UPanel.js';
 
 export declare const UPanel: React.ForwardRefExoticComponent<
   Omit<Partial<UPanelElement>, keyof React.HTMLAttributes<UPanelElement>>

package/dist/react/UPanel.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { UPanel as UPanelElement } from '../components/panel/UPanel.js';
+import { UPanel as UPanelElement } from '@iyulab/components/dist/components/panel/UPanel.js';
 
 export const UPanel = createComponent({
   react: React,

package/dist/react/UPopover.d.ts

@@ -1,7 +1,7 @@
 import React from 'react';
-import { UPopover as UPopoverElement } from '../components/popover/UPopover';
-import { type ShowEventDetail } from '../events/ShowEvent';
-import { type HideEventDetail } from '../events/HideEvent';
+import { UPopover as UPopoverElement } from '@iyulab/components/dist/components/popover/UPopover.js';
+import { type ShowEventDetail } from '@iyulab/components/dist/events/ShowEvent.js';
+import { type HideEventDetail } from '@iyulab/components/dist/events/HideEvent.js';
 
 export declare const UPopover: React.ForwardRefExoticComponent<
   Omit<Partial<UPopoverElement>, keyof React.HTMLAttributes<UPopoverElement>>

package/dist/react/UPopover.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { UPopover as UPopoverElement } from '../components/popover/UPopover.js';
+import { UPopover as UPopoverElement } from '@iyulab/components/dist/components/popover/UPopover.js';
 
 export const UPopover = createComponent({
   react: React,

package/dist/react/UProgressBar.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { UProgressBar as UProgressBarElement } from '../components/progress-bar/UProgressBar';
+import { UProgressBar as UProgressBarElement } from '@iyulab/components/dist/components/progress-bar/UProgressBar.js';
 
 export declare const UProgressBar: React.ForwardRefExoticComponent<
   Omit<Partial<UProgressBarElement>, keyof React.HTMLAttributes<UProgressBarElement>>

package/dist/react/UProgressBar.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { UProgressBar as UProgressBarElement } from '../components/progress-bar/UProgressBar.js';
+import { UProgressBar as UProgressBarElement } from '@iyulab/components/dist/components/progress-bar/UProgressBar.js';
 
 export const UProgressBar = createComponent({
   react: React,

package/dist/react/UProgressRing.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { UProgressRing as UProgressRingElement } from '../components/progress-ring/UProgressRing';
+import { UProgressRing as UProgressRingElement } from '@iyulab/components/dist/components/progress-ring/UProgressRing.js';
 
 export declare const UProgressRing: React.ForwardRefExoticComponent<
   Omit<Partial<UProgressRingElement>, keyof React.HTMLAttributes<UProgressRingElement>>

package/dist/react/UProgressRing.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { UProgressRing as UProgressRingElement } from '../components/progress-ring/UProgressRing.js';
+import { UProgressRing as UProgressRingElement } from '@iyulab/components/dist/components/progress-ring/UProgressRing.js';
 
 export const UProgressRing = createComponent({
   react: React,

package/dist/react/URadio.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { URadio as URadioElement } from '../components/radio/URadio';
+import { URadio as URadioElement } from '@iyulab/components/dist/components/radio/URadio.js';
 
 export declare const URadio: React.ForwardRefExoticComponent<
   Omit<Partial<URadioElement>, keyof React.HTMLAttributes<URadioElement>>

package/dist/react/URadio.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { URadio as URadioElement } from '../components/radio/URadio.js';
+import { URadio as URadioElement } from '@iyulab/components/dist/components/radio/URadio.js';
 
 export const URadio = createComponent({
   react: React,

package/dist/react/URating.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { URating as URatingElement } from '../components/rating/URating';
+import { URating as URatingElement } from '@iyulab/components/dist/components/rating/URating.js';
 
 export declare const URating: React.ForwardRefExoticComponent<
   Omit<Partial<URatingElement>, keyof React.HTMLAttributes<URatingElement>>

package/dist/react/URating.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { URating as URatingElement } from '../components/rating/URating.js';
+import { URating as URatingElement } from '@iyulab/components/dist/components/rating/URating.js';
 
 export const URating = createComponent({
   react: React,

package/dist/react/USelect.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { USelect as USelectElement } from '../components/select/USelect';
+import { USelect as USelectElement } from '@iyulab/components/dist/components/select/USelect.js';
 
 export declare const USelect: React.ForwardRefExoticComponent<
   Omit<Partial<USelectElement>, keyof React.HTMLAttributes<USelectElement>>

package/dist/react/USelect.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { USelect as USelectElement } from '../components/select/USelect.js';
+import { USelect as USelectElement } from '@iyulab/components/dist/components/select/USelect.js';
 
 export const USelect = createComponent({
   react: React,

package/dist/react/USkeleton.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { USkeleton as USkeletonElement } from '../components/skeleton/USkeleton';
+import { USkeleton as USkeletonElement } from '@iyulab/components/dist/components/skeleton/USkeleton.js';
 
 export declare const USkeleton: React.ForwardRefExoticComponent<
   Omit<Partial<USkeletonElement>, keyof React.HTMLAttributes<USkeletonElement>>

package/dist/react/USkeleton.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { USkeleton as USkeletonElement } from '../components/skeleton/USkeleton.js';
+import { USkeleton as USkeletonElement } from '@iyulab/components/dist/components/skeleton/USkeleton.js';
 
 export const USkeleton = createComponent({
   react: React,

package/dist/react/USlider.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { USlider as USliderElement } from '../components/slider/USlider';
+import { USlider as USliderElement } from '@iyulab/components/dist/components/slider/USlider.js';
 
 export declare const USlider: React.ForwardRefExoticComponent<
   Omit<Partial<USliderElement>, keyof React.HTMLAttributes<USliderElement>>

package/dist/react/USlider.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { USlider as USliderElement } from '../components/slider/USlider.js';
+import { USlider as USliderElement } from '@iyulab/components/dist/components/slider/USlider.js';
 
 export const USlider = createComponent({
   react: React,

package/dist/react/USpinner.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { USpinner as USpinnerElement } from '../components/spinner/USpinner';
+import { USpinner as USpinnerElement } from '@iyulab/components/dist/components/spinner/USpinner.js';
 
 export declare const USpinner: React.ForwardRefExoticComponent<
   Omit<Partial<USpinnerElement>, keyof React.HTMLAttributes<USpinnerElement>>

package/dist/react/USpinner.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { USpinner as USpinnerElement } from '../components/spinner/USpinner.js';
+import { USpinner as USpinnerElement } from '@iyulab/components/dist/components/spinner/USpinner.js';
 
 export const USpinner = createComponent({
   react: React,

package/dist/react/USplitPanel.d.ts

@@ -1,6 +1,6 @@
 import React from 'react';
-import { USplitPanel as USplitPanelElement } from '../components/split-panel/USplitPanel';
-import { type ShiftEventDetail } from '../events/ShiftEvent';
+import { USplitPanel as USplitPanelElement } from '@iyulab/components/dist/components/split-panel/USplitPanel.js';
+import { type ShiftEventDetail } from '@iyulab/components/dist/events/ShiftEvent.js';
 
 export declare const USplitPanel: React.ForwardRefExoticComponent<
   Omit<Partial<USplitPanelElement>, keyof React.HTMLAttributes<USplitPanelElement>>

package/dist/react/USplitPanel.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { USplitPanel as USplitPanelElement } from '../components/split-panel/USplitPanel.js';
+import { USplitPanel as USplitPanelElement } from '@iyulab/components/dist/components/split-panel/USplitPanel.js';
 
 export const USplitPanel = createComponent({
   react: React,

package/dist/react/USwitch.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { USwitch as USwitchElement } from '../components/switch/USwitch';
+import { USwitch as USwitchElement } from '@iyulab/components/dist/components/switch/USwitch.js';
 
 export declare const USwitch: React.ForwardRefExoticComponent<
   Omit<Partial<USwitchElement>, keyof React.HTMLAttributes<USwitchElement>>

package/dist/react/USwitch.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { USwitch as USwitchElement } from '../components/switch/USwitch.js';
+import { USwitch as USwitchElement } from '@iyulab/components/dist/components/switch/USwitch.js';
 
 export const USwitch = createComponent({
   react: React,

package/dist/react/UTab.d.ts

@@ -1,6 +1,6 @@
 import React from 'react';
-import { UTab as UTabElement } from '../components/tab/UTab';
-import { type RemoveEventDetail } from '../events/RemoveEvent';
+import { UTab as UTabElement } from '@iyulab/components/dist/components/tab/UTab.js';
+import { type RemoveEventDetail } from '@iyulab/components/dist/events/RemoveEvent.js';
 
 export declare const UTab: React.ForwardRefExoticComponent<
   Omit<Partial<UTabElement>, keyof React.HTMLAttributes<UTabElement>>

package/dist/react/UTab.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { UTab as UTabElement } from '../components/tab/UTab.js';
+import { UTab as UTabElement } from '@iyulab/components/dist/components/tab/UTab.js';
 
 export const UTab = createComponent({
   react: React,

package/dist/react/UTabPanel.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { UTabPanel as UTabPanelElement } from '../components/tab-panel/UTabPanel';
+import { UTabPanel as UTabPanelElement } from '@iyulab/components/dist/components/tab-panel/UTabPanel.js';
 
 export declare const UTabPanel: React.ForwardRefExoticComponent<
   Omit<Partial<UTabPanelElement>, keyof React.HTMLAttributes<UTabPanelElement>>

package/dist/react/UTabPanel.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { UTabPanel as UTabPanelElement } from '../components/tab-panel/UTabPanel.js';
+import { UTabPanel as UTabPanelElement } from '@iyulab/components/dist/components/tab-panel/UTabPanel.js';
 
 export const UTabPanel = createComponent({
   react: React,

package/dist/react/UTag.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { UTag as UTagElement } from '../components/tag/UTag';
+import { UTag as UTagElement } from '@iyulab/components/dist/components/tag/UTag.js';
 
 export declare const UTag: React.ForwardRefExoticComponent<
   Omit<Partial<UTagElement>, keyof React.HTMLAttributes<UTagElement>>

package/dist/react/UTag.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { UTag as UTagElement } from '../components/tag/UTag.js';
+import { UTag as UTagElement } from '@iyulab/components/dist/components/tag/UTag.js';
 
 export const UTag = createComponent({
   react: React,

package/dist/react/UText.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { UText as UTextElement } from '../components/text/UText';
+import { UText as UTextElement } from '@iyulab/components/dist/components/text/UText.js';
 
 export declare const UText: React.ForwardRefExoticComponent<
   Omit<Partial<UTextElement>, keyof React.HTMLAttributes<UTextElement>>

package/dist/react/UText.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { UText as UTextElement } from '../components/text/UText.js';
+import { UText as UTextElement } from '@iyulab/components/dist/components/text/UText.js';
 
 export const UText = createComponent({
   react: React,

package/dist/react/UTextarea.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { UTextarea as UTextareaElement } from '../components/textarea/UTextarea';
+import { UTextarea as UTextareaElement } from '@iyulab/components/dist/components/textarea/UTextarea.js';
 
 export declare const UTextarea: React.ForwardRefExoticComponent<
   Omit<Partial<UTextareaElement>, keyof React.HTMLAttributes<UTextareaElement>>

package/dist/react/UTextarea.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { UTextarea as UTextareaElement } from '../components/textarea/UTextarea.js';
+import { UTextarea as UTextareaElement } from '@iyulab/components/dist/components/textarea/UTextarea.js';
 
 export const UTextarea = createComponent({
   react: React,

package/dist/react/UTooltip.d.ts

@@ -1,7 +1,7 @@
 import React from 'react';
-import { UTooltip as UTooltipElement } from '../components/tooltip/UTooltip';
-import { type ShowEventDetail } from '../events/ShowEvent';
-import { type HideEventDetail } from '../events/HideEvent';
+import { UTooltip as UTooltipElement } from '@iyulab/components/dist/components/tooltip/UTooltip.js';
+import { type ShowEventDetail } from '@iyulab/components/dist/events/ShowEvent.js';
+import { type HideEventDetail } from '@iyulab/components/dist/events/HideEvent.js';
 
 export declare const UTooltip: React.ForwardRefExoticComponent<
   Omit<Partial<UTooltipElement>, keyof React.HTMLAttributes<UTooltipElement>>

package/dist/react/UTooltip.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { UTooltip as UTooltipElement } from '../components/tooltip/UTooltip.js';
+import { UTooltip as UTooltipElement } from '@iyulab/components/dist/components/tooltip/UTooltip.js';
 
 export const UTooltip = createComponent({
   react: React,

package/dist/react/UTree.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { UTree as UTreeElement } from '../components/tree/UTree';
+import { UTree as UTreeElement } from '@iyulab/components/dist/components/tree/UTree.js';
 
 export declare const UTree: React.ForwardRefExoticComponent<
   Omit<Partial<UTreeElement>, keyof React.HTMLAttributes<UTreeElement>>

package/dist/react/UTree.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { UTree as UTreeElement } from '../components/tree/UTree.js';
+import { UTree as UTreeElement } from '@iyulab/components/dist/components/tree/UTree.js';
 
 export const UTree = createComponent({
   react: React,

package/dist/react/UTreeItem.d.ts

@@ -1,9 +1,9 @@
 import React from 'react';
-import { UTreeItem as UTreeItemElement } from '../components/tree-item/UTreeItem';
-import { type ExpandEventDetail } from '../events/ExpandEvent';
-import { type CollapseEventDetail } from '../events/CollapseEvent';
-import { type PickEventDetail } from '../events/PickEvent';
-import { type CheckEventDetail } from '../events/CheckEvent';
+import { UTreeItem as UTreeItemElement } from '@iyulab/components/dist/components/tree-item/UTreeItem.js';
+import { type ExpandEventDetail } from '@iyulab/components/dist/events/ExpandEvent.js';
+import { type CollapseEventDetail } from '@iyulab/components/dist/events/CollapseEvent.js';
+import { type PickEventDetail } from '@iyulab/components/dist/events/PickEvent.js';
+import { type CheckEventDetail } from '@iyulab/components/dist/events/CheckEvent.js';
 
 export declare const UTreeItem: React.ForwardRefExoticComponent<
   Omit<Partial<UTreeItemElement>, keyof React.HTMLAttributes<UTreeItemElement>>

package/dist/react/UTreeItem.js

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent } from '@lit/react';
-import { UTreeItem as UTreeItemElement } from '../components/tree-item/UTreeItem.js';
+import { UTreeItem as UTreeItemElement } from '@iyulab/components/dist/components/tree-item/UTreeItem.js';
 
 export const UTreeItem = createComponent({
   react: React,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@iyulab/components",
   "description": "web-components library based on lit-element made by iyulab",
-  "version": "1.36.0",
+  "version": "1.37.1",
   "keywords": [
     "iyulab",
     "components",
@@ -90,6 +90,7 @@
     "eslint": "^9.39.4",
     "eslint-plugin-lit": "^2.3.1",
     "globals": "^17.7.0",
+    "happy-dom": "^20.10.6",
     "react": "^19.2.7",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.64.0",

package/skills/iyulab-components/references/components/popover.md

@@ -40,7 +40,7 @@ Inherits all `UFloatingElement` properties (see [floating.md](../extensions/floa
 | `disabled` | `boolean` | `false` | ✓ | Disable opening |
 | `placement` | `Placement` | — | — | Preferred placement (`top`, `bottom`, `left`, `right`, `*-start`, `*-end`) |
 | `offset` | `OffsetOptions` | `0` | — | Distance from anchor |
-| `shift` | `boolean` | `false` | — | Auto-shift to stay in viewport |
+| `shift` | `boolean` | `false` | — | Correct the cross-axis position *within* the placed side (see note below) |
 | `arrow` | `boolean` | `false` | — | Show arrow pointing to anchor |
 | `showDelay` | `number` | `0` | — | Open delay in ms |
 | `hideDelay` | `number` | `0` | — | Close delay in ms |
@@ -48,6 +48,16 @@ Inherits all `UFloatingElement` properties (see [floating.md](../extensions/floa
 | `dismiss` | `string[]` | `['click','escape','scroll','resize']` | ✓ | Close triggers — see note below |
 | `autofocus` | `boolean` | `false` | ✓ | Focus first focusable element on open |
 
+> **Placement fallback**: whenever `placement` is set, floating-ui's `flip` middleware is
+> always applied — if the placed side has no room, the element switches to another side.
+> The opposite side on the same axis is tried first; only when that is also out of room does
+> it move to the perpendicular axis, so `right-end` falls back through `left-end` to
+> `top-end`/`bottom-end`. That last step is what a full-width trigger needs — with room on
+> neither the left nor the right, staying on the horizontal axis means going off-screen.
+> `shift` is a separate, narrower correction: it nudges the element along the cross axis
+> *within* whichever side ended up being used. Neither can be turned off independently.
+
+
 ### `dismiss` semantics
 
 `click` and `escape` express user intent and always close the popover.

package/skills/iyulab-components/references/components/tooltip.md

@@ -43,13 +43,23 @@ Inherits all `UFloatingElement` properties (see [floating.md](../extensions/floa
 | `open` | `boolean` | `false` | ✓ | Visibility state |
 | `placement` | `Placement` | — | — | Preferred placement |
 | `offset` | `OffsetOptions` | `0` | — | Gap from target |
-| `shift` | `boolean` | `false` | — | Auto-shift to stay in viewport |
+| `shift` | `boolean` | `false` | — | Correct the cross-axis position *within* the placed side (see note below) |
 | `arrow` | `boolean` | `false` | — | Show pointing arrow |
 | `showDelay` | `number` | `0` | — | Open delay in ms |
 | `hideDelay` | `number` | `0` | — | Close delay in ms |
 | `interactive` | `boolean` | `false` | ✓ | Keep open when mouse is over tooltip |
 | `tracking` | `boolean` | `false` | ✓ | Follow mouse cursor position |
 
+> **Placement fallback**: whenever `placement` is set, floating-ui's `flip` middleware is
+> always applied — if the placed side has no room, the element switches to another side.
+> The opposite side on the same axis is tried first; only when that is also out of room does
+> it move to the perpendicular axis, so `right-end` falls back through `left-end` to
+> `top-end`/`bottom-end`. That last step is what a full-width trigger needs — with room on
+> neither the left nor the right, staying on the horizontal axis means going off-screen.
+> `shift` is a separate, narrower correction: it nudges the element along the cross axis
+> *within* whichever side ended up being used. Neither can be turned off independently.
+
+
 ## Events
 
 | Event | Cancelable | Description |