---

## Tooltip
Contextual overlay that displays brief, supplementary text on hover or focus.
Built with Floating UI for precise positioning and accessibility support.

**Import:** `import { Tooltip } from '@urbicon-ui/blocks';`

### Examples
```svelte
<Tooltip label="Save your changes">
  <Button>Save</Button>
</Tooltip>
```

```svelte
<Tooltip label="Copy to clipboard" placement="right" arrow showDelay={100}>
  <Button variant="ghost" size="sm" onclick={handleCopy}>Copy</Button>
</Tooltip>
```

### Variants
- intent: danger, info, neutral, primary, secondary, success, warning (default: neutral)
- size: lg, md, sm (default: md)
- visible: false, true (default: false)

### Api
| Prop | Type | Required | Default | Description |
| --- | --- | :---: | --- | --- |
| children | `Snippet` | yes |  | The trigger element(s) that activate the tooltip. |
| label | `string` | yes |  | Text displayed inside the tooltip bubble. |
| ...HTMLAttributes<HTMLDivElement> | `HTMLAttributes` | no |  | HTML attributes (excluding: 'children') |
| ...TooltipVariants | `VariantProps` | no |  | Styling variants from TooltipVariants |
| arrow | `boolean` | no | true | Whether to show a directional arrow pointing at the trigger. |
| class | `string` | no |  | Additional CSS class for the tooltip panel. |
| disabled | `boolean` | no | false | Prevent the tooltip from appearing regardless of hover/focus. |
| hideDelay | `number` | no | 100 | Milliseconds before the tooltip disappears after leaving the trigger. |
| onVisibleChange | `(visible: boolean) => void` | no |  | Fires when tooltip visibility changes (hover in/out, Escape key). |
| placement | `Placement` | no | 'top' | Where the tooltip appears relative to the trigger. Auto-flips when clipped. |
| preset | `string` | no |  | Apply a named preset registered via `<BlocksProvider presets={{ Tooltip: {...} }}>`. Prefer this over `class` overrides when the requested look falls outside the semantic intent palette — presets keep hover/active/dark-mode logic coherent and make the custom look reusable across the project. |
| showDelay | `number` | no | 200 | Milliseconds before the tooltip appears after hover/focus. Prevents accidental activation. |
| slotClasses | `Partial<Record<TooltipSlots, string>>` | no |  | Per-slot class overrides merged with (or replacing, when unstyled) tv styles. |
| unstyled | `boolean` | no |  | Remove default tv classes; only consumer classes apply. |
| intent | `'danger' | 'info' | 'neutral' | 'primary' | 'secondary' | 'success' | 'warning'` | no | neutral | Controls the color theme and semantic meaning of the Tooltip. Affects the overall appearance and user perception. Available options: danger, info, neutral, and 4 more. |
| size | `'lg' | 'md' | 'sm'` | no | md | Controls the dimensions, padding, and text size of the Tooltip. Affects the component's physical footprint. Available options: lg, md, sm. |
| visible | `'false' | 'true'` | no | false | Controls the visible behavior and appearance of the Tooltip component. Available options: false, true. |

Inherited from:
- TooltipVariants (external)
- Omit<HTMLAttributes<HTMLDivElement>, 'children'> (omit-pattern)