@urbicon-ui/design-content 6.1.8

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

@@ -0,0 +1,66 @@
+
+---
+
+## Collapsible
+A single expand/collapse panel with animated content, trigger button,
+and full ARIA support. Can be used standalone or as the foundation for compound
+components like Accordion.
+
+**Import:** `import { Collapsible } from '@urbicon-ui/blocks';`
+
+### Examples
+```svelte
+<Collapsible title="Show details">
+  <p>Hidden content revealed when expanded.</p>
+</Collapsible>
+```
+
+```svelte
+<Collapsible bind:open={isOpen} variant="card">
+  {#snippet trigger({ open, toggle })}
+    <button onclick={toggle}>
+      {open ? 'Hide' : 'Show'} settings
+    </button>
+  {/snippet}
+  <SettingsForm />
+</Collapsible>
+```
+
+### Variants
+- variant: card, default, ghost (default: default)
+- size: lg, md, sm (default: md)
+
+### Api
+| Prop | Type | Required | Default | Description |
+| --- | --- | :---: | --- | --- |
+| children | `Snippet` | yes |  | Content to render inside the Collapsible component |
+| ...CollapsibleVariants | `VariantProps` | no |  | Styling variants from CollapsibleVariants |
+| ...HTMLAttributes<HTMLDivElement> | `HTMLAttributes` | no |  | HTML attributes (excluding: 'children') |
+| class | `string` | no |  | Additional CSS classes to apply to the Collapsible component |
+| defaultOpen | `boolean` | no | false | Initial open state for uncontrolled usage |
+| disabled | `boolean` | no | false | Whether the Collapsible is disabled and non-interactive |
+| name | `string` | no |  | Base name for generating ARIA IDs. Defaults to auto-generated. |
+| onOpenChange | `(open: boolean) => void` | no |  | Callback fired when open state changes |
+| open | `boolean` | no |  | Whether the content is visible. Supports bind:open. |
+| preset | `string` | no |  | Apply a named preset registered via `<BlocksProvider presets={{ Collapsible: {...} }}>`. 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' | 'trigger' | 'chevron' | 'content' | 'contentInner', string>>` | no |  | Per-slot class overrides |
+| title | `string` | no |  | Trigger label text (used by the default trigger) |
+| trigger | `Snippet<[
+      {
+        open: boolean;
+        toggle: () => void;
+        disabled: boolean;
+        triggerId: string;
+        contentId: string;
+      }
+    ]>` | no |  | Custom trigger snippet — receives open state, toggle fn, disabled flag, and ARIA IDs |
+| unstyled | `boolean` | no |  | Remove default styles |
+| variant | `'card' | 'default' | 'ghost'` | no | default | Controls the visual style and presentation of the Collapsible. Determines the component's visual treatment. Available options: card, default, ghost. |
+| size | `'lg' | 'md' | 'sm'` | no | md | Controls the dimensions, padding, and text size of the Collapsible. Affects the component's physical footprint. Available options: lg, md, sm. |
+
+Inherited from:
+- CollapsibleVariants (external)
+- Omit<HTMLAttributes<HTMLDivElement>, 'children'> (omit-pattern)
+
+### Slots (slotClasses keys)
+`base`, `trigger`, `chevron`, `content`, `contentInner`

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

@@ -0,0 +1,86 @@
+
+---
+
+## Combobox
+Searchable menu (autocomplete) combining a text input with a
+filterable option list. Implements the ARIA combobox pattern with
+keyboard navigation, custom filtering, and two-way bindable state.
+
+**Import:** `import { Combobox } from '@urbicon-ui/blocks';`
+
+### Examples
+```svelte
+<Combobox
+  options={[
+    { label: 'Apple', value: 'apple' },
+    { label: 'Banana', value: 'banana' },
+    { label: 'Cherry', value: 'cherry' }
+  ]}
+  bind:value={selected}
+  placeholder="Search fruit…"
+/>
+```
+
+```svelte
+<Combobox
+options={tenants.map((t) => ({ label: t.name, value: t.id }))}
+bind:value={tenantId}
+/>
+```
+
+```svelte
+<Combobox
+  options={countries}
+  bind:value={country}
+  filter={(option, query) => option.label.toLowerCase().startsWith(query.toLowerCase())}
+  clearable
+  size="lg"
+/>
+```
+
+### Variants
+- size: lg, md, sm (default: md)
+- disabled: true (default: false)
+- open: true (default: false)
+- tier: commit, modify (default: modify)
+
+### Api
+| Prop | Type | Required | Default | Description |
+| --- | --- | :---: | --- | --- |
+| options | `ComboboxOption<T>[]` | yes |  | Array of selectable options. Each needs a unique `value`. |
+| ...ComboboxVariants | `VariantProps` | no |  | Styling variants from ComboboxVariants |
+| ...HTMLAttributes<HTMLDivElement> | `HTMLAttributes` | no |  | HTML attributes (excluding: 'children') |
+| class | `string` | no |  | Extra classes merged onto the root wrapper element. |
+| clearable | `boolean` | no | false | Show a clear button when a value is selected. Click or press Escape to reset. |
+| closeOnClickOutside | `boolean` | no |  | Whether the listbox closes on outside click. Default `true`. Set to `false` to pin the listbox open while the consumer manages dismissal explicitly. |
+| closeOnEscape | `boolean` | no |  | Whether the listbox closes on Escape key. Default `true`. Set to `false` for inline contexts where Escape should be intercepted by an outer widget (e.g. a row editor that wants to revert on Escape). |
+| customOption | `Snippet<[ComboboxOption<T>, boolean]>` | no |  | Custom option renderer. Receives the option and whether it is selected. |
+| disabled | `boolean` | no | false | Disable the entire combobox. |
+| error | `string` | no |  | Error message — replaces helper text and flags the field as invalid. |
+| filter | `(option: ComboboxOption<T>, query: string) => boolean` | no |  | Custom filter replacing the built-in case-insensitive label match. Return `true` to include an option. |
+| helper | `string` | no |  | Helper text shown below the field. Hidden when an error is set. |
+| id | `string` | no |  | Deterministic HTML `id` for the component. Auto-generated when omitted. |
+| label | `string` | no |  | Field label rendered above the input. |
+| mint | `MintProp` | no | 'none' | Micro-interaction preset. Form controls default to 'none' for a clean feel. |
+| name | `string` | no |  | Shared `name` for a hidden input for native form submission. |
+| noResultsText | `string` | no | 'No results found' | Text displayed when the filter produces no matches. |
+| onClickOutside | `() => void` | no |  | Fires after an outside click closes the listbox. Use for analytics or side-effects on dismiss. Does NOT control whether the listbox closes — that is governed by `closeOnClickOutside`. |
+| onEscape | `() => void` | no |  | Fires after Escape closes the listbox. Use for analytics or to clear ephemeral state on dismiss. Does NOT control whether the listbox closes — that is governed by `closeOnEscape`. |
+| onValueChange | `(value: T | null) => void` | no |  | Fires after the selected value changes. Receives the new value or `null` on clear. |
+| open | `boolean` | no | false | Controls the open state of the listbox. Supports `bind:open`. |
+| placeholder | `string` | no | 'Search…' | Placeholder shown when the input is empty. |
+| preset | `string` | no |  | Apply a named preset registered via `<BlocksProvider presets={{ Combobox: {...} }}>`. 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. |
+| query | `string` | no |  | Current search query text. Supports `bind:query` for external control (e.g. server-side filtering). |
+| required | `boolean` | no | false | Marks the field as required. Adds the asterisk on the label. |
+| slotClasses | `Partial<Record<'base' | 'label' | 'requiredMark' | 'inputWrapper' | 'input' | 'message' | 'hint' | 'listbox' | 'option' | 'optionActive' | 'optionSelected' | 'noResults' | 'clear' | 'chevron', string>>` | no |  | Per-slot class overrides merged with tv() styles. |
+| unstyled | `boolean` | no | false | Remove all default tv() classes — only user-provided classes apply. |
+| value | `T | null` | no |  | Currently selected value. Supports `bind:value` for two-way binding. |
+| size | `'lg' | 'md' | 'sm'` | no | md | Controls the dimensions, padding, and text size of the Combobox. Affects the component's physical footprint. Available options: lg, md, sm. |
+| tier | `'commit' | 'modify'` | no | modify | Controls the tier behavior and appearance of the Combobox component. Available options: commit, modify. |
+
+Inherited from:
+- ComboboxVariants (external)
+- Omit<HTMLAttributes<HTMLDivElement>, 'children'> (omit-pattern)
+
+### Slots (slotClasses keys)
+`base`, `label`, `requiredMark`, `inputWrapper`, `input`, `message`, `hint`, `listbox`, `option`, `optionActive`, `optionSelected`, `noResults`, `clear`, `chevron`

package/content/blocks/primitives/confirm-dialog/llm.txt

@@ -0,0 +1,47 @@
+
+---
+
+## ConfirmDialog
+Pre-configured Dialog for confirming a single, often
+destructive action. Replaces the native `window.confirm()` with a
+styleable, focus-trapped, keyboard-accessible modal that matches the
+design system's intent palette.
+
+`onConfirm` may be `async`; while the returned promise is pending the
+dialog locks itself (no backdrop dismiss, no escape, confirm button
+shows a spinner). Auto-closes on resolve.
+
+**Import:** `import { ConfirmDialog } from '@urbicon-ui/blocks';`
+
+### Examples
+```svelte
+<script>
+  let confirmOpen = $state(false);
+</script>
+<Button intent="danger" onclick={() => (confirmOpen = true)}>Delete</Button>
+<ConfirmDialog
+  bind:open={confirmOpen}
+  title="Delete project?"
+  description="This cannot be undone."
+  intent="danger"
+  confirmLabel="Delete"
+  onConfirm={async () => { await deleteProject(id); }}
+/>
+```
+
+### Api
+| Prop | Type | Required | Default | Description |
+| --- | --- | :---: | --- | --- |
+| title | `string` | yes |  | Heading shown in the dialog header. |
+| cancelLabel | `string` | no |  | Label of the cancel button. Defaults to the localized `button.cancel`. |
+| children | `Snippet` | no |  | Optional richer markup rendered below `description`. |
+| closeOnBackdropClick | `boolean` | no | true | Whether the backdrop click cancels. |
+| closeOnEscape | `boolean` | no | true | Whether Escape cancels. |
+| confirmIntent | `ConfirmIntent` | no |  | Override for the confirm button intent. Defaults to , with `neutral` upgraded to `primary` for visual affordance. |
+| confirmLabel | `string` | no |  | Label of the confirm button. Defaults to the localized `button.confirm`. |
+| description | `string` | no |  | Description rendered above the footer. Use `children` for richer markup. |
+| intent | `DialogIntent` | no | 'danger' | Accent on the dialog header strip. Drives the default `confirmIntent`. |
+| loading | `boolean` | no | false | Externally controlled loading flag. Combined with the internal `busy` flag from an async `onConfirm`. While truthy, both buttons are disabled and dismissal is blocked. |
+| onCancel | `() => void` | no |  | Fired when the user cancels (button, backdrop, or Escape). |
+| onConfirm | `() => void | Promise<void>` | no |  | Confirm handler. May return a promise — the dialog stays open and shows a loading state while it resolves, then auto-closes on success. |
+| open | `boolean` | no |  | Controls visibility. Supports bind:open. |

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

@@ -0,0 +1,59 @@
+
+---
+
+## Dialog
+Overlay dialog built on native dialog element. Can be used as a simple
+content-agnostic overlay or as a structured dialog with title, footer, and intent accent.
+
+**Import:** `import { Dialog } from '@urbicon-ui/blocks';`
+
+### Examples
+```svelte
+<Dialog bind:open>
+<p>Are you sure?</p>
+<Button onclick={() => (open = false)}>Close</Button>
+</Dialog>
+```
+
+```svelte
+<Dialog bind:open title="Confirm deletion" intent="danger">
+<p>This action cannot be undone.</p>
+{#snippet footer()}
+<Button variant="ghost" onclick={() => (open = false)}>Cancel</Button>
+<Button intent="danger" onclick={handleDelete}>Delete</Button>
+{/snippet}
+</Dialog>
+```
+
+### Variants
+- intent: danger, neutral, primary, secondary, success, warning (default: neutral)
+- size: full, fullscreen, lg, md, sm, xl (default: sm)
+- placement: center, top (default: center)
+
+### Api
+| Prop | Type | Required | Default | Description |
+| --- | --- | :---: | --- | --- |
+| children | `Snippet` | yes |  | Dialog body content. When `title` is omitted the content fills the entire panel. |
+| ...HTMLDialogAttributes | `HTMLAttributes` | no |  | HTML attributes (excluding: 'children' | 'open') |
+| class | `string` | no |  | Additional CSS classes applied to the dialog panel. |
+| closeOnBackdropClick | `boolean` | no | true | Whether clicking the backdrop dismisses the dialog. |
+| closeOnEscape | `boolean` | no | true | Whether pressing Escape dismisses the dialog. |
+| footer | `Snippet` | no |  | Action buttons rendered in a footer bar. Only rendered when provided. |
+| hideCloseButton | `boolean` | no | false | Hides the built-in close button. Only takes effect when `title` is also set — the close button only renders in the structured (titled) header. Without a title, no close button exists to hide. |
+| intent | `DialogVariants['intent']` | no | 'neutral' | Semantic purpose marker (e.g. `danger` for destructive actions). After the Lighter-Refactor, the Dialog itself no longer paints an accent bar — the value is exposed on the panel as `data-intent="…"` so consumers can hook presets, CSS overrides, or icon/title color via their own snippets. |
+| onClose | `() => void` | no |  | Fires when the dialog is dismissed via Escape, backdrop click, or close button. |
+| open | `boolean` | no |  | Controls whether the dialog is visible. Supports bind:open. |
+| placement | `DialogVariants['placement']` | no | 'center' | Vertical placement within the viewport. Use 'top' for command-palette style positioning. |
+| preset | `string` | no |  | Apply a named preset registered via `<BlocksProvider presets={{ Dialog: {...} }}>`. 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 | `DialogVariants['size']` | no | 'sm' | Controls the maximum width of the dialog panel. |
+| slotClasses | `Partial<Record<'dialog' | 'backdrop' | 'panel' | 'content' | 'header' | 'title' | 'body' | 'footer', string>>` | no |  | Per-slot class overrides merged with variant styles. |
+| title | `string` | no |  | Heading displayed in a header bar. Enables the structured header/body/footer layout. |
+| transitionDuration | `number` | no |  | Override the enter/exit animation duration in milliseconds. Defaults to the overlay token `--blocks-overlay-enter-duration` / `--blocks-overlay-exit-duration` (200ms / 180ms). Set globally via the CSS custom properties or per-instance via this prop. Respects `prefers-reduced-motion`. |
+| transitionEasing | `(t: number) => number` | no |  | Override the enter/exit easing function. Defaults to the overlay token easing (`quintOut`). |
+| unstyled | `boolean` | no |  | Strip all default styles. Combine with slotClasses for fully custom appearance. |
+
+Inherited from:
+- Omit<HTMLDialogAttributes, 'children' | 'open'> (omit-pattern)
+
+### Slots (slotClasses keys)
+`dialog`, `backdrop`, `panel`, `content`, `header`, `title`, `body`, `footer`

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

@@ -0,0 +1,54 @@
+
+---
+
+## Drawer
+Slide-in panel overlay from any edge of the viewport.
+Uses native dialog with focus trap, backdrop click dismiss, and Escape key support.
+
+**Import:** `import { Drawer } from '@urbicon-ui/blocks';`
+
+### Examples
+```svelte
+<Drawer bind:open title="Settings" placement="right">
+  <p>Drawer content here</p>
+</Drawer>
+```
+
+```svelte
+<Drawer bind:open title="Menu" placement="left" size="sm">
+  <nav>...</nav>
+</Drawer>
+```
+
+### Variants
+- intent: danger, neutral, primary, secondary, success, warning (default: neutral)
+- size: full, lg, md, sm, xl (default: md)
+- placement: bottom, left, right, top (default: right)
+
+### Api
+| Prop | Type | Required | Default | Description |
+| --- | --- | :---: | --- | --- |
+| children | `Snippet` | yes |  | Content rendered inside the drawer body. |
+| ...HTMLDialogAttributes | `HTMLAttributes` | no |  | HTML attributes (excluding: 'children' | 'open') |
+| class | `string` | no |  | Additional CSS classes applied to the drawer panel. |
+| closeOnBackdropClick | `boolean` | no | true | Whether clicking the backdrop closes the drawer. |
+| closeOnEscape | `boolean` | no | true | Whether pressing Escape closes the drawer. |
+| footer | `Snippet` | no |  | Action buttons rendered in the drawer footer. |
+| hideCloseButton | `boolean` | no | false | Hides the built-in close button in the header. |
+| intent | `DrawerVariants['intent']` | no | 'neutral' | Semantic purpose marker (mirrors Dialog). After the Lighter-Refactor, the Drawer itself no longer paints an accent border — the value is exposed on the panel as `data-intent="…"` so consumers can hook presets, CSS overrides, or icon/title color via their own snippets. |
+| onClose | `() => void` | no |  | Fires when the drawer is dismissed via Escape, backdrop click, or close button. |
+| open | `boolean` | no |  | Controls whether the drawer is visible. Supports `bind:open`. |
+| placement | `DrawerVariants['placement']` | no | 'right' | Edge of the viewport from which the drawer slides in. |
+| preset | `string` | no |  | Apply a named preset registered via `<BlocksProvider presets={{ Drawer: {...} }}>`. 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 | `DrawerVariants['size']` | no | 'md' | Width (for left/right) or height (for top/bottom) of the drawer panel. |
+| slotClasses | `Partial<Record<'dialog' | 'backdrop' | 'panel' | 'header' | 'title' | 'body' | 'footer', string>>` | no |  | Per-slot class overrides merged with variant styles. |
+| title | `string` | no |  | Heading displayed in the drawer header. |
+| transitionDuration | `number` | no |  | Override the enter/exit animation duration in milliseconds. Defaults to the overlay token `--blocks-overlay-enter-duration` / `--blocks-overlay-exit-duration` (200ms / 180ms). Respects `prefers-reduced-motion`. |
+| transitionEasing | `(t: number) => number` | no |  | Override the enter/exit easing function. Defaults to the overlay token easing (`quintOut`). |
+| unstyled | `boolean` | no |  | Strip all default styles. Combine with slotClasses for fully custom appearance. |
+
+Inherited from:
+- Omit<HTMLDialogAttributes, 'children' | 'open'> (omit-pattern)
+
+### Slots (slotClasses keys)
+`dialog`, `backdrop`, `panel`, `header`, `title`, `body`, `footer`

package/content/blocks/primitives/form-field/llm.txt

@@ -0,0 +1,43 @@
+
+---
+
+## FormField
+Layout wrapper for composite form fields that need a label,
+helper text, and error message but cannot rely on the built-in slots of
+primitives like  or . Examples:
+a custom file picker, a slider/number-input pair, a media uploader.
+
+The `id` is auto-generated and forwarded to the slot via the `for`
+snippet parameter so the rendered control can wire `aria-describedby`
+and `aria-invalid` correctly.
+
+**Import:** `import { FormField } from '@urbicon-ui/blocks';`
+
+### Examples
+```svelte
+<FormField label="Document" required error={fileError} hint="PDF, JPG, PNG — max 10 MB">
+  {#snippet children({ id, describedBy, invalid })}
+    <FileUpload {id} aria-describedby={describedBy} aria-invalid={invalid} bind:files />
+  {/snippet}
+</FormField>
+```
+
+### Api
+| Prop | Type | Required | Default | Description |
+| --- | --- | :---: | --- | --- |
+| children | `Snippet<[FormFieldSlotContext]>` | yes |  | Snippet receiving wiring metadata (`id`, `describedBy`, `invalid`, `required`, `disabled`). The wrapped control should spread or apply these to itself for accessibility. |
+| ...HTMLAttributes<HTMLDivElement> | `HTMLAttributes` | no |  | HTML attributes (excluding: 'children') |
+| class | `string` | no |  | Extra classes merged onto the wrapper element. |
+| disabled | `boolean` | no | false | Disables visual emphasis. Pass through to the slot's control as needed. |
+| error | `string` | no |  | Error message shown below the control. Replaces the helper text and propagates `invalid: true` to the slot for ARIA wiring. |
+| hint | `string` | no |  | Helper text shown below the control. Hidden when `error` is present. |
+| id | `string` | no |  | Explicit HTML `id` for the control. Auto-generated when omitted, then forwarded to the slot. Caller may use it to attach external `<label for>`. |
+| label | `string` | no |  | Label rendered above the control. Auto-linked to the slot via the generated `id`. |
+| required | `boolean` | no | false | Adds a required asterisk to the label and propagates `required: true` to the slot. Does **not** apply the native `required` attribute — the slot's control is responsible for that. |
+| slotClasses | `Partial<Record<'wrapper' | 'label' | 'message' | 'hint', string>>` | no |  | Per-slot class overrides. |
+
+Inherited from:
+- Omit<HTMLAttributes<HTMLDivElement>, 'children'> (omit-pattern)
+
+### Slots (slotClasses keys)
+`wrapper`, `label`, `message`, `hint`

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

@@ -0,0 +1,73 @@
+
+---
+
+## Input
+Text input with labels, validation states, icons, and clearable functionality.
+Supports outlined, filled, and ghost visual variants with automatic ARIA linking.
+
+**Import:** `import { Input } from '@urbicon-ui/blocks';`
+
+### Examples
+```svelte
+<Input label="Email" placeholder="name@example.com" required />
+```
+
+### Variants
+- intent: danger, default, success, warning (default: default)
+- variant: filled, ghost, outlined, underline (default: outlined)
+- size: lg, md, sm, xl, xs (default: md)
+- disabled: true (default: false)
+- hasLeftIcon: true (default: false)
+- hasRightIcon: true (default: false)
+- iconPosition: left, right (default: left)
+- messageType: error, helper (default: helper)
+- readonly: true (default: false)
+- required: true (default: false)
+- tier: commit, modify (default: modify)
+
+### Api
+| Prop | Type | Required | Default | Description |
+| --- | --- | :---: | --- | --- |
+| ...HTMLInputAttributes | `HTMLAttributes` | no |  | HTML attributes (excluding: 'size' | 'class' | 'disabled' | 'readonly' | 'children') |
+| ...InputVariants | `VariantProps` | no |  | Styling variants from InputVariants |
+| autoComplete | `string` | no |  | HTML autocomplete hint for browser autofill. |
+| children | `Snippet` | no |  | Snippet content rendered below the input for advanced layouts. |
+| class | `string` | no |  | Extra classes merged onto the root wrapper element. |
+| clearable | `boolean` | no | false | Show a clear button when the input has a value. Press Escape or click the button to clear. Fires `onClear` after clearing. |
+| disabled | `boolean` | no | false | Whether the Input is disabled and non-interactive |
+| error | `string` | no |  | Error message below the input. When set, overrides `helper` and forces danger border styling regardless of `intent`. |
+| helper | `string` | no |  | Helper text below the input — hidden when `error` is present. |
+| label | `string` | no |  | Label text displayed above the input, auto-linked via `for`/`id`. |
+| leftIcon | `Snippet` | no |  | Icon snippet rendered on the left side of the input field. |
+| leftIconAriaLabel | `string` | no |  | Accessible label for the clickable left icon button. Required when `onLeftIconClick` is set so screen-reader users hear a name for the button (icons inside are `aria-hidden`). |
+| mint | `MintProp` | no | 'none' | Micro-interaction preset applied to the input element. |
+| onClear | `() => void` | no |  | Fired after the value is cleared via the clear button or Escape key. |
+| onLeftIconClick | `() => void` | no |  | When provided, the left icon becomes a clickable button. |
+| onRightIconClick | `() => void` | no |  | When provided, the right icon becomes a clickable button. |
+| persistDebounceMs | `number` | no | 300 | Debounce interval (ms) for storage writes. |
+| persistKey | `string` | no |  | Key for persisting the input value to storage. |
+| persistNamespace | `string` | no |  | Namespace (e.g. user id) to scope the persist key. |
+| persistStorage | `'localStorage' | 'sessionStorage'` | no | 'localStorage' | Storage backend for persistence. |
+| persistVersion | `number` | no | 1 | Version stamp included in the storage key. |
+| preset | `string` | no |  | Apply a named preset registered via `<BlocksProvider presets={{ Input: {...} }}>`. 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 Input component |
+| required | `boolean` | no | false | Adds a required asterisk to the label and sets the native `required` attribute. |
+| rightIcon | `Snippet` | no |  | Icon snippet rendered on the right side of the input field. |
+| rightIconAriaLabel | `string` | no |  | Accessible label for the clickable right icon button. Required when `onRightIconClick` is set so screen-reader users hear a name for the button (icons inside are `aria-hidden`). |
+| slotClasses | `Partial<Record<'wrapper' | 'container' | 'base' | 'label' | 'message' | 'iconContainer', string>>` | no |  | Per-slot class overrides merged with tv() styles. |
+| unstyled | `boolean` | no |  | Remove all default tv() classes — only user-provided classes apply. |
+| intent | `'danger' | 'default' | 'success' | 'warning'` | no | default | Controls the color theme and semantic meaning of the Input. Affects the overall appearance and user perception. Available options: danger, default, success, warning. |
+| variant | `'filled' | 'ghost' | 'outlined' | 'underline'` | no | outlined | Controls the visual style and presentation of the Input. Determines the component's visual treatment. Available options: filled, ghost, outlined, underline. |
+| size | `'lg' | 'md' | 'sm' | 'xl' | 'xs'` | no | md | Controls the dimensions, padding, and text size of the Input. Affects the component's physical footprint. Available options: lg, md, sm, and 2 more. |
+| hasLeftIcon | `'true'` | no | false | Controls the hasLeftIcon behavior and appearance of the Input component. Available options: true. |
+| hasRightIcon | `'true'` | no | false | Controls the hasRightIcon behavior and appearance of the Input component. Available options: true. |
+| iconPosition | `'left' | 'right'` | no | left | Controls the iconPosition behavior and appearance of the Input component. Available options: left, right. |
+| messageType | `'error' | 'helper'` | no | helper | Controls the messageType behavior and appearance of the Input component. Available options: error, helper. |
+| tier | `'commit' | 'modify'` | no | modify | Controls the tier behavior and appearance of the Input component. Available options: commit, modify. |
+
+Inherited from:
+- Omit<InputVariants, 'error'> (omit-pattern)
+- Omit<HTMLInputAttributes, 'size' | 'class' | 'disabled' | 'readonly' | 'children'> (omit-pattern)
+
+### Slots (slotClasses keys)
+`wrapper`, `container`, `base`, `label`, `message`, `iconContainer`

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

@@ -0,0 +1,81 @@
+
+---
+
+## Menu
+Action menu triggered by a button with nested items, icons, separators, and keyboard navigation.
+
+**Import:** `import { Menu } from '@urbicon-ui/blocks';`
+
+### Examples
+```svelte
+<Menu placeholder="Actions" items={[
+  { label: 'Edit', onSelect: () => edit() },
+  { label: 'Duplicate', onSelect: () => duplicate() },
+  { type: 'section', label: 'Danger' },
+  { label: 'Delete', onSelect: () => confirmDelete() }
+]} />
+```
+
+```svelte
+<Menu placeholder="More">
+  <MenuSection label="Edit" />
+  <MenuItem onSelect={() => rename()}>Rename</MenuItem>
+  <MenuItem onSelect={() => duplicate()}>Duplicate</MenuItem>
+  <MenuDivider />
+  <MenuItem onSelect={() => confirmDelete()}>Delete</MenuItem>
+</Menu>
+```
+
+```svelte
+<Menu items={actionItems}>
+  {#snippet customTrigger(toggle, open)}
+    <Button
+      variant="ghost"
+      aria-label="Actions"
+      aria-haspopup="menu"
+      aria-expanded={open}
+      onclick={toggle}
+    >
+      <MoreHorizontalIcon />
+    </Button>
+  {/snippet}
+</Menu>
+```
+
+### Variants
+- chevronAnimation: fade, none, rotate, translate (default: rotate)
+- disabled: true
+- itemSize: lg, md, sm (default: md)
+- open: true (default: false)
+- placement: bottom, bottom-end, bottom-start, top, top-end, top-start (default: bottom-start)
+- syncWidth: false, true (default: true)
+- tier: commit, modify (default: commit)
+- usePortal: false, true (default: true)
+
+### Api
+| Prop | Type | Required | Default | Description |
+| --- | --- | :---: | --- | --- |
+| ...AnimationProps | `inherited` | no |  | Properties inherited from AnimationProps |
+| ...HTMLAttributes<HTMLDivElement> | `HTMLAttributes` | no |  | HTML attributes (excluding: 'children' | 'class' | 'placeholder') |
+| ...MenuVariants | `VariantProps` | no |  | Styling variants from MenuVariants |
+| class | `string` | no |  | Additional CSS classes to apply to the Menu component |
+| customFooter | `Snippet` | no |  | Optional custom footer rendered below the items list. |
+| customHeader | `Snippet` | no |  | Optional custom header rendered above the items list. |
+| customItem | `Snippet<[TItem]>` | no |  | Custom per-item content. **Render visible content only** — the outer `role="menuitem"` button is provided by Menu and handles the click / keyboard activation. Putting an interactive element (`<button>`, `<a>`) inside the snippet creates nested-interactive HTML and triggers the item's action twice via event bubbling.  Positional arg: `(item)`. To dispatch from outside the normal click (e.g. a "Recent" entry that needs to activate from a parent shortcut), call the item's own `onSelect` directly. |
+| customTrigger | `Snippet<[() => void, boolean, () => void]>` | no |  | Replace the default trigger button (chevron + label) with a custom element. Positional args: `(toggle, open, dismiss)`.  - `toggle`: flips the open state — wire this to your custom trigger's   click handler so the menu can be opened from the consumer's element. - `open`: current open state — useful for `aria-expanded`. - `dismiss`: closes the menu without changing toggle history; rarely   needed but provided for symmetry.  The consumer's element should bind its `onclick` to `toggle` and set `aria-expanded={open}` + `aria-haspopup="menu"` for ARIA correctness. |
+| id | `string` | no |  | Id property for the Menu component |
+| chevronAnimation | `'fade' | 'none' | 'rotate' | 'translate'` | no | rotate | Controls the chevronAnimation behavior and appearance of the Menu component. Available options: fade, none, rotate, translate. |
+| disabled | `'true'` | no |  | Controls the disabled behavior and appearance of the Menu component. Available options: true. |
+| itemSize | `'lg' | 'md' | 'sm'` | no | md | Controls the itemSize behavior and appearance of the Menu component. Available options: lg, md, sm. |
+| open | `'true'` | no | false | Controls the open behavior and appearance of the Menu component. Available options: true. |
+| placement | `'bottom' | 'bottom-end' | 'bottom-start' | 'top' | 'top-end' | 'top-start'` | no | bottom-start | Controls the positioning and alignment of the Menu relative to its container or trigger element. Available options: bottom, bottom-end, bottom-start, and 3 more. |
+| syncWidth | `'false' | 'true'` | no | true | Controls the syncWidth behavior and appearance of the Menu component. Available options: false, true. |
+| tier | `'commit' | 'modify'` | no | commit | Controls the tier behavior and appearance of the Menu component. Available options: commit, modify. |
+| usePortal | `'false' | 'true'` | no | true | Controls the usePortal behavior and appearance of the Menu component. Available options: false, true. |
+
+Inherited from:
+- MenuVariants (external)
+- Omit<MenuSpecificProps<TItem>, keyof MenuVariants> (omit-pattern)
+- MenuCustomSlots (local-interface)
+- AnimationProps (external)
+- Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'class' | 'placeholder'> (omit-pattern)

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

@@ -0,0 +1,68 @@
+
+---
+
+## Pagination
+Navigation control for paged data sets.
+Supports multiple layouts, intents, button variants, and configurable ellipsis behaviour.
+
+**Import:** `import { Pagination } from '@urbicon-ui/blocks';`
+
+### Examples
+```svelte
+<Pagination
+  currentPage={page}
+  totalPages={20}
+  onPageChange={(p) => page = p}
+/>
+```
+
+### Variants
+- size: lg, md, sm (default: md)
+- layout: default, minimal, navigation, table (default: default)
+
+### Api
+| Prop | Type | Required | Default | Description |
+| --- | --- | :---: | --- | --- |
+| currentPage | `number` | yes |  | 1-based index of the currently active page. |
+| totalPages | `number` | yes |  | Total number of pages in the data set. |
+| ...HTMLAttributes<HTMLElement> | `HTMLAttributes` | no |  | HTML attributes (excluding: 'class') |
+| ...PaginationVariants | `VariantProps` | no |  | Styling variants from PaginationVariants |
+| class | `string` | no |  | Additional CSS classes merged onto the root `<nav>` element. |
+| disabled | `boolean` | no |  | Disables all buttons and dims the component. |
+| endItem | `number` | no |  | Override the calculated end item number for the info text. |
+| firstIcon | `Snippet` | no |  | Custom icon rendered inside the "First" button. |
+| firstLabel | `string` | no |  | Label for the "First" button. Falls back to i18n key `pagination.first`. |
+| infoText | `string` | no |  | Override the auto-generated info text with a fully custom string. |
+| intent | `'primary' | 'secondary' | 'success' | 'warning' | 'danger' | 'neutral'` | no |  | Semantic color applied to every pagination button. |
+| itemsPerPage | `number` | no |  | Items shown per page. Used by the table layout to compute "Showing X to Y of Z". |
+| lastIcon | `Snippet` | no |  | Custom icon rendered inside the "Last" button. |
+| lastLabel | `string` | no |  | Label for the "Last" button. Falls back to i18n key `pagination.last`. |
+| loading | `boolean` | no |  | Shows a loading state with reduced opacity. |
+| mint | `MintProp` | no |  | Micro-interaction animation applied to the pagination container. |
+| nextIcon | `Snippet` | no |  | Custom icon rendered inside the "Next" button. |
+| nextLabel | `string` | no |  | Label for the "Next" button. Falls back to i18n key `pagination.next`. |
+| onPageChange | `(page: number) => void` | no |  | Fires when the user selects a different page. Receives the 1-based page number. |
+| pageLabel | `string` | no |  | Prefix for the info text (e.g. "Page"). Falls back to i18n key `pagination.page`. |
+| preset | `string` | no |  | Apply a named preset registered via `<BlocksProvider presets={{ Pagination: {...} }}>`. 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. |
+| previousIcon | `Snippet` | no |  | Custom icon rendered inside the "Previous" button. |
+| previousLabel | `string` | no |  | Label for the "Previous" button. Falls back to i18n key `pagination.previous`. |
+| showFirstLast | `boolean` | no |  | Show "First" / "Last" boundary buttons when the current page is far from the edges. |
+| showInfo | `boolean` | no |  | Show a text summary such as "Page 3 of 10" beneath the controls. |
+| showNumbers | `boolean` | no |  | Show numbered page buttons. Set to false for a compact prev/next-only bar. |
+| showPreviousNext | `boolean` | no |  | Show "Previous" / "Next" navigation buttons. |
+| size | `'sm' | 'md' | 'lg'` | no |  | Button dimensions. Affects page numbers, prev/next, and first/last. |
+| slotClasses | `Partial<Record<'base' | 'info' | 'controls' | 'ellipsis', string>>` | no |  | Per-slot class overrides merged with (or replacing, when unstyled) tv styles. Slots: base, info, controls, ellipsis. |
+| startItem | `number` | no |  | Override the calculated start item number for the info text. |
+| tier | `InteractiveTier` | no |  | Semantic radius tier forwarded to pagination buttons. |
+| totalItems | `number` | no |  | Total number of items across all pages. Used by the table layout info text. |
+| unstyled | `boolean` | no |  | Strip all default tailwind-variants classes for a fully custom build. |
+| variant | `'outlined' | 'filled' | 'ghost'` | no |  | Visual weight of pagination buttons. |
+| visiblePages | `number` | no |  | Maximum number of page buttons shown between the ellipsis indicators. |
+| layout | `'default' | 'minimal' | 'navigation' | 'table'` | no | default | Controls the layout behavior and appearance of the Pagination component. Available options: default, minimal, navigation, table. |
+
+Inherited from:
+- Omit<PaginationVariants, 'disabled' | 'loading'> (omit-pattern)
+- Omit<HTMLAttributes<HTMLElement>, 'class'> (omit-pattern)
+
+### Slots (slotClasses keys)
+`base`, `info`, `controls`, `ellipsis`