@urbicon-ui/design-content 6.1.8

package/content/blocks/primitives/spinner/llm.txt

@@ -0,0 +1,46 @@
+
+---
+
+## Spinner
+Animated loading indicator with multiple animation styles and semantic intents.
+
+**Import:** `import { Spinner } from '@urbicon-ui/blocks';`
+
+### Examples
+```svelte
+<Spinner size="md" intent="primary" />
+```
+
+```svelte
+<Spinner variant="bars" speed="fast" intent="success" />
+```
+
+### Variants
+- intent: current, danger, neutral, primary, secondary, success, warning (default: primary)
+- variant: bars, default, dots, pulse, ring (default: default)
+- size: lg, md, sm, xl, xs (default: md)
+- speed: fast, normal, slow (default: normal)
+
+### Api
+| Prop | Type | Required | Default | Description |
+| --- | --- | :---: | --- | --- |
+| ...HTMLAttributes<HTMLDivElement> | `HTMLAttributes` | no |  | HTML attributes (excluding: 'children') |
+| ...SpinnerVariants | `VariantProps` | no |  | Styling variants from SpinnerVariants |
+| children | `Snippet` | no |  | Optional content rendered beside the spinner (e.g. loading text). |
+| class | `string` | no |  | Extra classes merged onto the root element. |
+| intent | `SpinnerVariants['intent']` | no |  | Semantic color applied via `text-*` token. |
+| label | `string` | no |  | Accessible label announced by screen readers. Defaults to "Loading...". |
+| preset | `string` | no |  | Apply a named preset registered via `<BlocksProvider presets={{ Spinner: {...} }}>`. 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. |
+| size | `SpinnerVariants['size']` | no |  | Physical dimensions from `xs` (16 px) to `xl` (40 px). |
+| slotClasses | `Partial<Record<'base' | 'svg' | 'svgCircle' | 'svgPath' | 'dots' | 'dot' | 'pulse' | 'pulseCenter' | 'pulseRing' | 'ring' | 'ringElement' | 'bars' | 'bar' | 'content' | 'srOnly', string>>` | no |  | Per-slot class overrides merged with (or replacing, when `unstyled`) tv() output. |
+| speed | `SpinnerVariants['speed']` | no |  | Animation speed — controls `--spinner-speed` custom property. |
+| unstyled | `boolean` | no |  | Strip all default tv() classes. Combine with `slotClasses` for full control. |
+| variant | `SpinnerVariants['variant']` | no |  | Animation style. `default` is an SVG arc, `dots` bounces three dots, `pulse` radiates a sonar ping, `ring` spins cascading borders, `bars` animates vertical equalizer bars. |
+| visible | `boolean` | no |  | When false the spinner is removed from the DOM. |
+
+Inherited from:
+- SpinnerVariants (external)
+- Omit<HTMLAttributes<HTMLDivElement>, 'children'> (omit-pattern)
+
+### Slots (slotClasses keys)
+`base`, `svg`, `svgCircle`, `svgPath`, `dots`, `dot`, `pulse`, `pulseCenter`, `pulseRing`, `ring`, `ringElement`, `bars`, `bar`, `content`, `srOnly`

package/content/blocks/primitives/stepper/llm.txt

@@ -0,0 +1,60 @@
+
+---
+
+## Stepper
+Multi-step progress indicator with horizontal/vertical layout,
+clickable navigation, and per-step state overrides (error, warning).
+
+**Import:** `import { Stepper } from '@urbicon-ui/blocks';`
+
+### Examples
+```svelte
+<Stepper activeStep={1}>
+  <StepperStep label="Account" description="Create your account" />
+  <StepperStep label="Profile" description="Set up your profile" />
+  <StepperStep label="Review" description="Review and submit" />
+</Stepper>
+```
+
+```svelte
+<Stepper activeStep={0} orientation="vertical" clickable>
+  <StepperStep label="Details" description="Enter your information">
+    <p>Form content here...</p>
+  </StepperStep>
+  <StepperStep label="Confirm" description="Verify and submit" />
+</Stepper>
+```
+
+### Variants
+- variant: default, minimal, outlined (default: default)
+- size: lg, md, sm (default: md)
+- orientation: horizontal, vertical (default: horizontal)
+- tier: commit, modify (default: commit)
+
+### Api
+| Prop | Type | Required | Default | Description |
+| --- | --- | :---: | --- | --- |
+| children | `Snippet` | yes |  | StepperStep children. |
+| ...HTMLAttributes<HTMLOListElement> | `HTMLAttributes` | no |  | HTML attributes (excluding: 'children') |
+| ...StepperVariants | `VariantProps` | no |  | Styling variants from StepperVariants |
+| activeStep | `number` | no | 0 | Current active step index (0-based). Supports bind:activeStep. |
+| class | `string` | no |  | Extra classes merged onto the root element. |
+| clickable | `boolean` | no | false | Allow clicking step indicators to navigate between steps. |
+| disabled | `boolean` | no | false | Disable all steps and prevent navigation. |
+| linear | `boolean` | no | false | Restrict navigation to sequential order — only completed steps and the next step are clickable. |
+| onStepChange | `(step: number) => void` | no |  | Fires when a step is activated via click. Passes the new step index. |
+| orientation | `'horizontal' | 'vertical'` | no | 'horizontal' | Orientation property for the Stepper component |
+| preset | `string` | no |  | Apply a named preset registered via `<BlocksProvider presets={{ Stepper: {...} }}>`. 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. |
+| responsive | `boolean | { breakpoint?: number }` | no | false | Container-responsive mode: when the Stepper's container is narrower than `breakpoint`, automatically switch to `orientation="vertical"` and `variant="minimal"` so the steps stay readable.  - `false` (default): never auto-switch. - `true`: switch below 640 px container width. - `{ breakpoint: 480 }`: switch below 480 px.  Uses `ResizeObserver` on the root element — works inside Drawers, Cards, or split layouts where viewport-based media queries miss the actual available width. |
+| size | `'sm' | 'md' | 'lg'` | no | 'md' | Size variant that controls dimensions and spacing of the Stepper |
+| slotClasses | `Partial<Record<'base' | 'stepItem' | 'step' | 'indicatorColumn' | 'indicator' | 'labelGroup' | 'label' | 'description' | 'separator' | 'content', string>>` | no |  | Per-slot class overrides. |
+| tier | `InteractiveTier` | no | 'commit' | Semantic radius tier propagated to every StepperStep. Default `commit` — step indicators read as identity circles. Set to `modify` (or inherit via TierContext from a wrapping `<Toolbar tier="modify">`) to render a compact soft-rectangle stepper for inline wizards. |
+| unstyled | `boolean` | no |  | Remove all default tv() classes. |
+| variant | `'default' | 'outlined' | 'minimal'` | no | 'default' | Visual style of step indicators. |
+
+Inherited from:
+- Omit<StepperVariants, 'stepState' | 'clickable' | 'stepDisabled' | 'separatorComplete'> (omit-pattern)
+- Omit<HTMLAttributes<HTMLOListElement>, 'children'> (omit-pattern)
+
+### Slots (slotClasses keys)
+`base`, `stepItem`, `step`, `indicatorColumn`, `indicator`, `labelGroup`, `label`, `description`, `separator`, `content`

package/content/blocks/primitives/tab/llm.txt

@@ -0,0 +1,72 @@
+
+---
+
+## Tab
+Tab container that manages tab switching and content display.
+Supports horizontal/vertical orientation, visual variants, and keyboard navigation.
+
+**Import:** `import { Tab } from '@urbicon-ui/blocks';`
+
+### Examples
+```svelte
+<Tab
+  tabs={[
+    { value: 'overview', label: 'Overview' },
+    { value: 'settings', label: 'Settings' },
+    { value: 'billing', label: 'Billing' }
+  ]}
+  bind:value={activeTab}
+>
+  {#snippet panels()}
+    {#if activeTab === 'overview'}<p>Overview content</p>{/if}
+    {#if activeTab === 'settings'}<p>Settings content</p>{/if}
+    {#if activeTab === 'billing'}<p>Billing content</p>{/if}
+  {/snippet}
+</Tab>
+```
+
+```svelte
+<Tab
+  tabs={[
+    { value: 'code', label: 'Code' },
+    { value: 'preview', label: 'Preview' }
+  ]}
+  variant="underline"
+  size="sm"
+  defaultValue="code"
+>
+  {#snippet panels()}
+    <div>Tab panel content</div>
+  {/snippet}
+</Tab>
+```
+
+### Variants
+- variant: enclosed, line, pills, solid (default: line)
+- size: lg, md, sm (default: md)
+- fullWidth: true (default: false)
+- orientation: horizontal, vertical (default: horizontal)
+- tier: commit, modify (default: modify)
+
+### Api
+| Prop | Type | Required | Default | Description |
+| --- | --- | :---: | --- | --- |
+| class | `string` | no |  | Additional CSS class merged onto the root element. |
+| defaultValue | `string` | no |  | Default active tab for uncontrolled mode. Ignored when `value` is set. |
+| disabled | `boolean` | no | false | Disables all tabs, preventing interaction and dimming the UI. |
+| fullWidth | `boolean` | no | false | Stretch triggers to fill the available width. Only meaningful on horizontal tabs. |
+| mint | `MintProp` | no | 'none' | Micro-interaction animation applied to each tab trigger (per-item, not the container). |
+| onValueChange | `(value: string) => void` | no |  | Fires when the active tab changes. Receives the new tab value string. |
+| orientation | `'horizontal' | 'vertical'` | no | 'horizontal' | Tab strip axis. Determines whether triggers stack horizontally or vertically. |
+| panels | `Snippet` | no |  | Snippet containing TabPanel components for the content area. |
+| preset | `string` | no |  | Apply a named preset registered via `<BlocksProvider presets={{ Tab: {...} }}>`. 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. |
+| slotClasses | `Partial<Record<'base' | 'list' | 'trigger' | 'panel' | 'indicator', string>>` | no |  | Per-slot class overrides merged with (or replacing when unstyled) tv() styles. |
+| tabs | `Snippet` | no |  | Snippet containing TabItem components for the tab strip. |
+| tier | `InteractiveTier` | no | 'modify' | Semantic radius tier propagated to every TabItem. Default `modify` — tabs read as navigation tap surfaces. Set to `commit` (or inherit via TierContext from a wrapping `<Toolbar tier="commit">`) for full-pill tab strips in marketing/product-overview contexts. Only the `pills`, `solid`, and `enclosed` variants render a visible corner; `line` is radius-agnostic. |
+| unstyled | `boolean` | no |  | Strip all default tv() styles from the container and children. |
+| value | `string` | no |  | Controlled active tab value. Use with `bind:value` for two-way binding. When set, the component is controlled — you must handle `onValueChange` to update it. |
+| variant | `'enclosed' | 'line' | 'pills' | 'solid'` | no | line | Controls the visual style and presentation of the Tab. Determines the component's visual treatment. Available options: enclosed, line, pills, solid. |
+| size | `'lg' | 'md' | 'sm'` | no | md | Controls the dimensions, padding, and text size of the Tab. Affects the component's physical footprint. Available options: lg, md, sm. |
+
+### Slots (slotClasses keys)
+`base`, `list`, `trigger`, `panel`, `indicator`

package/content/blocks/primitives/textarea/llm.txt

@@ -0,0 +1,61 @@
+
+---
+
+## Textarea
+Multi-line text input with auto-resize, character counter, and validation states.
+Shares the same variant/intent/size system as Input for visual consistency.
+
+**Import:** `import { Textarea } from '@urbicon-ui/blocks';`
+
+### Examples
+```svelte
+<Textarea label="Description" placeholder="Tell us more..." bind:value={text} />
+```
+
+```svelte
+<Textarea label="Bio" maxlength={280} showCounter autoResize />
+```
+
+### Variants
+- intent: danger, default, success, warning (default: default)
+- size: lg, md, sm (default: md)
+- autoResize: true (default: false)
+- disabled: true (default: false)
+- messageType: error, helper (default: helper)
+- readonly: true (default: false)
+- required: true (default: false)
+- tier: commit, modify (default: modify)
+
+### Api
+| Prop | Type | Required | Default | Description |
+| --- | --- | :---: | --- | --- |
+| ...HTMLTextareaAttributes | `HTMLAttributes` | no |  | HTML attributes (excluding: 'size' | 'class' | 'children') |
+| ...TextareaVariants | `VariantProps` | no |  | Styling variants from TextareaVariants |
+| autoResize | `boolean` | no | false | Automatically grow the textarea height to fit content. Disables manual resize handle. |
+| class | `string` | no |  | Extra classes merged onto the root wrapper element. |
+| counterWarningThreshold | `number` | no | 0.9 | Character threshold (percentage of maxlength) at which the counter turns warning color. |
+| disabled | `boolean` | no | false | Whether the Textarea is disabled and non-interactive |
+| error | `string` | no |  | Error message below the textarea. Overrides `helper` and forces danger border styling. |
+| helper | `string` | no |  | Helper text below the textarea. Hidden when `error` is set. |
+| label | `string` | no |  | Label text displayed above the textarea, auto-linked via `for`/`id`. |
+| maxRows | `number` | no |  | Maximum number of visible text rows when autoResize is enabled. |
+| minRows | `number` | no | 3 | Minimum number of visible text rows. |
+| mint | `MintProp` | no | 'none' | Micro-interaction preset applied to the textarea element. |
+| preset | `string` | no |  | Apply a named preset registered via `<BlocksProvider presets={{ Textarea: {...} }}>`. 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. |
+| readonly | `boolean` | no | false | Readonly property for the Textarea component |
+| required | `boolean` | no | false | Adds a required asterisk to the label and sets the native `required` attribute. |
+| showCounter | `boolean` | no |  | Show a live character counter. Requires `maxlength` to display remaining count. |
+| slotClasses | `Partial<Record<'wrapper' | 'base' | 'label' | 'footer' | 'message' | 'counter', string>>` | no |  | Per-slot class overrides merged with tv() styles. |
+| unstyled | `boolean` | no |  | Remove all default tv() classes. Only user-provided classes apply. |
+| variant | `TextareaVariants['variant']` | no | 'outlined' | Visual style. - `outlined` (default) — visible border, surface-base background - `filled` — surface-interactive fill, no border - `ghost` — transparent until hover/focus - `underline` — bottom-line only, no border-box (editorial style) |
+| intent | `'danger' | 'default' | 'success' | 'warning'` | no | default | Controls the color theme and semantic meaning of the Textarea. Affects the overall appearance and user perception. Available options: danger, default, success, warning. |
+| size | `'lg' | 'md' | 'sm'` | no | md | Controls the dimensions, padding, and text size of the Textarea. Affects the component's physical footprint. Available options: lg, md, sm. |
+| messageType | `'error' | 'helper'` | no | helper | Controls the messageType behavior and appearance of the Textarea component. Available options: error, helper. |
+| tier | `'commit' | 'modify'` | no | modify | Controls the tier behavior and appearance of the Textarea component. Available options: commit, modify. |
+
+Inherited from:
+- Omit<TextareaVariants, 'error' | 'counterState' | 'variant'> (omit-pattern)
+- Omit<HTMLTextareaAttributes, 'size' | 'class' | 'children'> (omit-pattern)
+
+### Slots (slotClasses keys)
+`wrapper`, `base`, `label`, `footer`, `message`, `counter`

package/content/blocks/primitives/toast/llm.txt

@@ -0,0 +1,45 @@
+
+---
+
+## Toast
+Container that renders and manages toast notifications.
+Place once in your root layout. Use the toaster store to trigger toasts from anywhere.
+
+**Import:** `import { Toast } from '@urbicon-ui/blocks';`
+
+### Examples
+```svelte
+<!-- +layout.svelte -->
+<Toaster placement="bottom-right" />
+```
+
+```svelte
+<script>
+  import { toaster } from '@urbicon-ui/blocks';
+
+  toaster.success('Saved!', { description: 'Changes applied.' });
+  toaster.danger('Error', { description: 'Something went wrong.', duration: 8000 });
+</script>
+```
+
+### Variants
+- intent: danger, info, neutral, primary, success, warning (default: neutral)
+- placement: bottom-center, bottom-left, bottom-right, top-center, top-left, top-right (default: bottom-right)
+
+### Api
+| Prop | Type | Required | Default | Description |
+| --- | --- | :---: | --- | --- |
+| ...HTMLAttributes<HTMLDivElement> | `HTMLAttributes` | no |  | HTML attributes (excluding: 'children') |
+| class | `string` | no |  | Extra classes merged onto the container element. |
+| max | `number` | no | 5 | Maximum number of toasts visible at once. Oldest are hidden first. |
+| placement | `ToastPlacement` | no | 'bottom-right' | Screen corner where toasts stack. |
+| preset | `string` | no |  | Apply a named preset registered via `<BlocksProvider presets={{ Toaster: {...} }}>`. 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. |
+| slotClasses | `Partial<Record<'container' | 'toast' | 'icon' | 'content' | 'title' | 'description' | 'dismissButton' | 'progress', string>>` | no |  | Per-slot class overrides merged with (or replacing, when `unstyled`) the default styles. |
+| unstyled | `boolean` | no |  | Strip all default tv classes. Use with `slotClasses` for a fully custom look. |
+| intent | `'danger' | 'info' | 'neutral' | 'primary' | 'success' | 'warning'` | no | neutral | Controls the color theme and semantic meaning of the Toast. Affects the overall appearance and user perception. Available options: danger, info, neutral, and 3 more. |
+
+Inherited from:
+- Omit<HTMLAttributes<HTMLDivElement>, 'children'> (omit-pattern)
+
+### Slots (slotClasses keys)
+`container`, `toast`, `icon`, `content`, `title`, `description`, `dismissButton`, `progress`

package/content/blocks/primitives/toggle/llm.txt

@@ -0,0 +1,62 @@
+
+---
+
+## Toggle
+Accessible switch control for boolean on/off states.
+Built on a hidden native input with semantic intents and Mint micro-interactions.
+
+**Import:** `import { Toggle } from '@urbicon-ui/blocks';`
+
+### Examples
+```svelte
+<Toggle label="Enable notifications" bind:checked />
+```
+
+```svelte
+<Toggle
+  intent="success"
+  size="lg"
+  withBorder
+  onCheckedChange={(val) => console.log('toggled', val)}
+/>
+```
+
+### Variants
+- intent: danger, neutral, primary, secondary, success, warning (default: primary)
+- size: lg, md, sm, xs (default: md)
+- appearance: default, dot (default: default)
+- disabled: true (default: false)
+- tier: commit, modify (default: commit)
+- withBorder: false, true (default: false)
+
+### Api
+| Prop | Type | Required | Default | Description |
+| --- | --- | :---: | --- | --- |
+| ...HTMLInputAttributes | `HTMLAttributes` | no |  | HTML attributes (excluding: 'type' | 'size' | 'checked' | 'class' | 'children') |
+| ...ToggleVariants | `VariantProps` | no |  | Styling variants from ToggleVariants |
+| appearance | `ToggleVariants['appearance']` | no | 'default' | Visual style. `default` renders a classic Switch-Pill (track + sliding thumb). `dot` renders a small monochrome circular indicator instead — outline-only when off, filled in the intent colour when on. Use `dot` for dense settings rows, inline-toolbars, or anywhere the Switch-Pill is visually too loud. |
+| checked | `boolean` | no |  | Current on/off state. Supports two-way binding via `bind:checked`. |
+| class | `string` | no |  | Extra classes merged onto the outermost wrapper element. |
+| disabled | `boolean` | no |  | Prevent interaction and dim the control. |
+| helper | `string` | no |  | Hint text shown below the control. Useful for explaining side-effects of the toggle. |
+| id | `string` | no |  | Explicit `id` to link `<label>` and `<input>`. Auto-generated if omitted. |
+| label | `string` | no |  | Text label displayed to the right of the toggle track. |
+| mint | `MintProp` | no |  | Micro-interaction preset applied to the control area on hover/click. |
+| name | `string` | no |  | The `name` attribute of the underlying `<input>`. Used for form submission. |
+| onCheckedChange | `(checked: boolean) => void` | no |  | Fired after the checked state changes. Receives the new `checked` value. |
+| preset | `string` | no |  | Apply a named preset registered via `<BlocksProvider presets={{ Toggle: {...} }}>`. 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. |
+| required | `boolean` | no |  | Mark the native input as required for form validation. |
+| slotClasses | `Partial<Record<'wrapper' | 'control' | 'track' | 'thumb' | 'label' | 'message', string>>` | no |  | Per-slot class overrides merged with (or replacing, when `unstyled`) the default styles. |
+| tier | `InteractiveTier` | no |  | Semantic radius tier. Default `commit` — a toggle declares status (on/off identity), and reads as a pill. Set to `modify` (usually via a wrapping `<Toolbar tier="modify">` propagating through TierContext) for inline-toolbar contexts where the Pill feels oversized — the track and thumb shrink to a soft-rectangle.  Inherited from TierContext when omitted; falls back to `commit` outside of any tier-aware container. |
+| unstyled | `boolean` | no |  | Strip all default tailwind-variants classes. Use with `slotClasses` for a fully custom look. The track exposes `data-state` for conditional styling. |
+| value | `string` | no |  | The value submitted when checked. Defaults to `'on'`. |
+| withBorder | `boolean` | no |  | Draw a subtle border around the track. Helps distinguish the control on busy backgrounds. |
+| intent | `'danger' | 'neutral' | 'primary' | 'secondary' | 'success' | 'warning'` | no | primary | Controls the color theme and semantic meaning of the Toggle. Affects the overall appearance and user perception. Available options: danger, neutral, primary, and 3 more. |
+| size | `'lg' | 'md' | 'sm' | 'xs'` | no | md | Controls the dimensions, padding, and text size of the Toggle. Affects the component's physical footprint. Available options: lg, md, sm, xs. |
+
+Inherited from:
+- Omit<ToggleVariants, 'checked'> (omit-pattern)
+- Omit<HTMLInputAttributes, 'type' | 'size' | 'checked' | 'class' | 'children'> (omit-pattern)
+
+### Slots (slotClasses keys)
+`wrapper`, `control`, `track`, `thumb`, `label`, `message`

package/content/blocks/primitives/toolbar/llm.txt

@@ -0,0 +1,60 @@
+
+---
+
+## Toolbar
+Container for grouping related controls in a horizontal or vertical bar.
+Renders with role="toolbar" and auto-sets aria-orientation.
+
+**Import:** `import { Toolbar } from '@urbicon-ui/blocks';`
+
+### Examples
+```svelte
+<Toolbar aria-label="Text formatting">
+  <Button variant="ghost" size="sm">B</Button>
+  <Button variant="ghost" size="sm">I</Button>
+  <Separator orientation="vertical" size="sm" />
+  <Button variant="ghost" size="sm">Left</Button>
+  <Button variant="ghost" size="sm">Center</Button>
+</Toolbar>
+```
+
+```svelte
+<Toolbar aria-label="Actions" orientation="horizontal">
+  <ButtonGroup connected size="sm" variant="ghost">
+    <Button value="undo">Undo</Button>
+    <Button value="redo">Redo</Button>
+  </ButtonGroup>
+  <Separator orientation="vertical" />
+  <Button variant="ghost" size="sm" intent="danger">Delete</Button>
+</Toolbar>
+```
+
+### Variants
+- variant: elevated, ghost, outlined, quiet (default: quiet)
+- gap: lg, md, sm, xl, xs (default: sm)
+- orientation: horizontal, vertical (default: horizontal)
+- padding: lg, md, sm, xl, xs (default: sm)
+
+### Api
+| Prop | Type | Required | Default | Description |
+| --- | --- | :---: | --- | --- |
+| aria-label | `string` | yes |  | Accessible label describing the toolbar's purpose (e.g. "Formatting toolbar"). Required. |
+| children | `Snippet` | yes |  | Toolbar content — typically Buttons, Toggles, Separators, or ButtonGroups. |
+| ...HTMLAttributes<HTMLDivElement> | `HTMLAttributes` | no |  | HTML attributes (excluding: 'children') |
+| ...ToolbarVariants | `VariantProps` | no |  | Styling variants from ToolbarVariants |
+| class | `string` | no |  | Additional CSS class applied to the root element. |
+| preset | `string` | no |  | Apply a named preset registered via `<BlocksProvider presets={{ Toolbar: {...} }}>`. 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. |
+| slotClasses | `Partial<Record<'base', string>>` | no |  | Per-slot class overrides merged with (or replacing when `unstyled`) the default classes. |
+| tier | `InteractiveTier` | no | 'modify' | Semantic radius tier propagated to tier-aware children (Buttons, Badges, Inputs, …). The Toolbar's own surface stays `r-structure` regardless of this prop.  Default `modify` — toolbars typically hold compact, icon-only actions where pill-shaped buttons read as tags. Set to `commit` for marketing or hero toolbars with full CTAs. |
+| unstyled | `boolean` | no |  | Remove all default tv() classes. Combine with `slotClasses` to restyle from scratch. |
+| variant | `'elevated' | 'ghost' | 'outlined' | 'quiet'` | no | quiet | Controls the visual style and presentation of the Toolbar. Determines the component's visual treatment. Available options: elevated, ghost, outlined, quiet. |
+| gap | `'lg' | 'md' | 'sm' | 'xl' | 'xs'` | no | sm | Controls the gap behavior and appearance of the Toolbar component. Available options: lg, md, sm, and 2 more. |
+| orientation | `'horizontal' | 'vertical'` | no | horizontal | Controls the orientation behavior and appearance of the Toolbar component. Available options: horizontal, vertical. |
+| padding | `'lg' | 'md' | 'sm' | 'xl' | 'xs'` | no | sm | Controls the padding behavior and appearance of the Toolbar component. Available options: lg, md, sm, and 2 more. |
+
+Inherited from:
+- ToolbarVariants (external)
+- Omit<HTMLAttributes<HTMLDivElement>, 'children'> (omit-pattern)
+
+### Slots (slotClasses keys)
+`base`

package/content/blocks/primitives/tooltip/llm.txt

@@ -0,0 +1,54 @@
+
+---
+
+## 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<'base' | 'arrow', 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)
+
+### Slots (slotClasses keys)
+`base`, `arrow`