@urbicon-ui/design-content 6.2.0 → 6.3.3

package/content/auth/components/register-page/llm.txt

@@ -18,6 +18,7 @@ Sends POST to `apiPath` (default `/api/auth/register`). Pair with `createRegiste
 | apiPath | `string` | no | '/api/auth/register' | ApiPath property for the RegisterPage component |
 | class | `string` | no |  | Extra classes on the root element. |
 | csrf | `CsrfClientOptions` | no |  | CSRF cookie/header names — only needed when the server overrides the defaults via `config.csrf`. Mutating requests echo the token automatically. |
+| defaultEmail | `string` | no | '' | Pre-fills the email field. Pass the `?email=` query param from the invitation link (`createInvitationHandlers` builds `/auth/register?email=<invitee>`) so an invited user lands on a ready-to-submit form instead of retyping — and a typo can't trigger the opaque "invitation required" 403. Following the same explicit-prop pattern as `ResetPasswordPage`/`VerifyEmailPage`'s `token`, read it from the page in your route (SSR-safe), e.g. `defaultEmail={page.url.searchParams.get('email') ?? ''}`. |
 | fetcher | `typeof globalThis.fetch` | no |  | Custom fetch implementation for all API calls. Defaults to the global `fetch`. Useful for mock backends in demos/tests or custom retry/auth layers. |
 | footer | `Snippet` | no |  | Content rendered below the form, above links (e.g. terms checkbox). |
 | header | `Snippet` | no |  | Content rendered above the form (e.g. social login buttons). |

package/content/blocks/components/calendar/llm.txt

@@ -88,7 +88,7 @@ buckets your own domain content (meals, shifts, bookings) per day, use `Planner`
 | showViewSwitcher | `boolean` | no | true | Show the view switcher in the header. |
 | showWeekNumbers | `boolean` | no | false | Show ISO week numbers in the left margin. |
 | size | `'sm' | 'md' | 'lg'` | no | 'md' | Size variant that controls dimensions and spacing of the Calendar |
-| slotClasses | `Partial<Record<CalendarSlotName, string>>` | no |  | Per-slot class overrides. |
+| slotClasses | `Partial<Record<CalendarSlots, string>>` | no |  | Per-slot class overrides. |
 | swipeable | `boolean` | no | true | Enable swipe gestures for touch navigation. |
 | timeGridEndHour | `number` | no | 20 | Last visible hour in time grid (exclusive). |
 | timeGridInterval | `30 | 60` | no | 60 | Time slot interval in minutes. |

package/content/blocks/components/command-palette/llm.txt

@@ -53,8 +53,5 @@ Open via bind:open or the built-in Cmd+K shortcut.
 | shortcut | `string | false` | no | 'mod+k' (Cmd+K / Ctrl+K) | Register a global keyboard shortcut that toggles the palette. Set to `false` to disable. |
 | showFooter | `boolean` | no | true | Show keyboard-shortcut hints in the footer. |
 | size | `CommandPaletteVariants['size']` | no | 'md' | Maximum width of the palette panel. |
-| slotClasses | `Partial<Record<'wrapper' | 'input' | 'inputIcon' | 'clearButton' | 'list' | 'group' | 'groupLabel' | 'item' | 'itemHighlighted' | 'itemDefault' | 'itemDisabled' | 'itemIcon' | 'itemLabel' | 'itemShortcut' | 'empty' | 'footer' | 'kbd', string>>` | no |  | Per-slot class overrides. |
+| slotClasses | `Partial<Record<CommandPaletteSlots, string>>` | no |  | Per-slot class overrides. |
 | unstyled | `boolean` | no | false | Strip all default styles. |
-
-### Slots (slotClasses keys)
-`wrapper`, `input`, `inputIcon`, `clearButton`, `list`, `group`, `groupLabel`, `item`, `itemHighlighted`, `itemDefault`, `itemDisabled`, `itemIcon`, `itemLabel`, `itemShortcut`, `empty`, `footer`, `kbd`

package/content/blocks/components/composition-bar/llm.txt

@@ -52,7 +52,7 @@ sync. Tooltip content is fully overridable via the `tooltip` snippet.
 | showPercentages | `boolean` | no | true | Show percentages in legend and tooltip. |
 | showTotal | `boolean` | no | false | Render the total value after the legend. |
 | showValues | `boolean` | no | false | Render the value directly inside the bar segment (in addition to the legend). Narrow segments are skipped automatically to prevent overflow — only segments with sufficient width (≥ 8% or ~40 px) show their value. Useful for print, PDF attachments, or dense dashboards where hover tooltips are not enough. |
-| slotClasses | `Partial<Record<'wrapper' | 'barWrapper' | 'bar' | 'segment' | 'segmentRest' | 'tooltip' | 'tooltipLabel' | 'tooltipDetail' | 'legend' | 'legendItem' | 'legendDot' | 'legendLabel' | 'legendValue' | 'total' | 'totalLabel', string>>` | no |  | Per-slot class overrides. |
+| slotClasses | `Partial<Record<CompositionBarSlots, string>>` | no |  | Per-slot class overrides. |
 | tooltip | `Snippet<[item: CompositionItem, percent: number]>` | no |  | Custom tooltip content. Replaces the default layout (label, value, percent). |
 | total | `number` | no |  | Optional fixed total value. Default: Σ items.value. If the explicit total exceeds the sum, the remaining area is rendered neutrally ("unaccounted share"). If it is below the sum, segments are scaled to 100% and a console warning is emitted. |
 | totalLabel | `string` | no |  | Label rendered before the total. Defaults to the localized "Total" label from the blocks i18n bundle. |
@@ -64,6 +64,3 @@ sync. Tooltip content is fully overridable via the `tooltip` snippet.
 Inherited from:
 - Omit<CompositionBarVariants, 'isHovered'> (omit-pattern)
 - Omit<HTMLAttributes<HTMLDivElement>, 'children'> (omit-pattern)
-
-### Slots (slotClasses keys)
-`wrapper`, `barWrapper`, `bar`, `segment`, `segmentRest`, `tooltip`, `tooltipLabel`, `tooltipDetail`, `legend`, `legendItem`, `legendDot`, `legendLabel`, `legendValue`, `total`, `totalLabel`

package/content/blocks/components/date-range-picker/llm.txt

@@ -0,0 +1,49 @@
+
+---
+
+## DateRangePicker
+Date range picker with a dual-calendar popup for selecting a start and end date — min/max constraints, disabled dates, and native form submission via paired hidden inputs.
+
+**Import:** `import { DateRangePicker } from '@urbicon-ui/blocks';`
+
+### Api
+| Prop | Type | Required | Default | Description |
+| --- | --- | :---: | --- | --- |
+| ...HTMLAttributes<HTMLDivElement> | `HTMLAttributes` | no |  | HTML attributes (excluding: 'children') |
+| calendarVariant | `'default' | 'bordered' | 'ghost'` | no |  | calendarVariant property |
+| class | `string` | no |  | Additional CSS classes to apply to the DateRangePicker component |
+| clearable | `boolean` | no |  | Clearable property for the DateRangePicker component |
+| closeOnClickOutside | `boolean` | no | true | Whether the popover closes on outside click. |
+| closeOnEscape | `boolean` | no | true | Whether the popover closes on Escape key. |
+| closeOnSelect | `boolean` | no | true | Close popover after selecting both dates. |
+| defaultMonth | `MonthIndex` | no |  | Default month shown when the picker opens without a value. `0`–`11`. |
+| defaultYear | `number` | no |  | Default year shown when the picker opens without a value. |
+| disabled | `boolean` | no |  | Whether the DateRangePicker is disabled and non-interactive |
+| disabledDates | `Date[]` | no |  | disabledDates property |
+| displayFormat | `DateFormatOptions` | no |  | Intl.DateTimeFormat options for displayed dates. |
+| error | `string` | no |  | Error property for the DateRangePicker component |
+| fixedWeeks | `boolean` | no |  | FixedWeeks property for the DateRangePicker component |
+| helper | `string` | no |  | Helper property for the DateRangePicker component |
+| inputVariant | `'outlined' | 'filled' | 'ghost' | 'underline'` | no |  | inputVariant property |
+| isDateDisabled | `(date: Date) => boolean` | no |  | Predicate that disables specific dates. Throws are caught and logged; the date is then treated as allowed. |
+| label | `string` | no |  | Label above the input. |
+| locale | `string` | no |  | Locale property for the DateRangePicker component |
+| maxDate | `Date` | no |  | MaxDate property for the DateRangePicker component |
+| minDate | `Date` | no |  | MinDate property for the DateRangePicker component |
+| mint | `MintProp` | no |  | Micro-interaction configuration for enhanced user experience |
+| name | `string` | no |  | Shared base `name` for native form submission. When set, two hidden inputs are rendered — `{name}_start` and `{name}_end` — each carrying the serialized date, so the visible input's locale-formatted display string is never submitted instead.  Empty range submits both halves as `""`. The `_start` / `_end` convention reflects the picker's domain language — date ranges read naturally as start/end rather than min/max. |
+| onClickOutside | `() => void` | no |  | Notification only — does NOT govern close behavior. |
+| onEscape | `() => void` | no |  | Notification only — does NOT govern close behavior. |
+| onOpenChange | `(open: boolean) => void` | no |  | onOpenChange property |
+| onValueChange | `(value: DateRange | undefined) => void` | no |  | Fires when the selected range changes. During calendar selection the user clicks twice — once to set the start, once to set the end. `onValueChange` only fires when the range is *complete* (start ≠ end); the intermediate `{ start: d, end: d }` state does NOT fire this callback. Use `bind:value` if you need the in-progress state. |
+| placeholder | `string` | no |  | Placeholder when no range is selected. |
+| required | `boolean` | no |  | Required property for the DateRangePicker component |
+| showOutsideDays | `boolean` | no |  | showOutsideDays property |
+| showWeekNumbers | `boolean` | no |  | showWeekNumbers property |
+| size | `'xs' | 'sm' | 'md' | 'lg' | 'xl'` | no |  | Size variant that controls dimensions and spacing of the DateRangePicker |
+| value | `DateRange` | no |  | Currently selected date range. Supports bind:value. |
+| valueFormat | `'date' | 'iso'` | no | 'date' | Format used to serialise both range halves. See  for semantics. |
+| weekStartsOn | `WeekdayIndex` | no |  | weekStartsOn property |
+
+Inherited from:
+- Omit<HTMLAttributes<HTMLDivElement>, 'children'> (omit-pattern)

package/content/blocks/components/empty-state/llm.txt

@@ -36,7 +36,7 @@ optional call-to-action slot.
 | description | `string` | no |  | Supporting paragraph below the title. |
 | icon | `Component<IconProps>` | no |  | Icon component rendered above the title. Pass any icon from `@urbicon-ui/blocks/icons` (or a compatible stroke icon). |
 | preset | `string` | no |  | Apply a named preset registered via `<BlocksProvider presets={{ EmptyState: {...} }}>`. Prefer this over `class` overrides when the same look should be reused across the project. |
-| slotClasses | `Partial<Record<EmptyStateSlot, string>>` | no |  | Per-slot class overrides. |
+| slotClasses | `Partial<Record<EmptyStateSlots, string>>` | no |  | Per-slot class overrides. Slots: base | iconWrapper | title | description | children | cta |
 | unstyled | `boolean` | no |  | Remove all default tv classes. |
 
 Inherited from:

package/content/blocks/components/file-upload/llm.txt

@@ -64,7 +64,7 @@ Drag-and-drop file upload with validation, image previews, progress tracking, an
 | preset | `string` | no |  | Apply a named preset registered via `<BlocksProvider presets={{ FileUpload: {...} }}>`. 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. |
 | preventDocumentDrop | `boolean` | no | true | Prevent browser navigation when files are dropped outside the zone. |
 | required | `boolean` | no |  | Mark as required for form validation. |
-| slotClasses | `Partial<Record<FileUploadSlotName, string>>` | no |  | Per-slot class overrides. |
+| slotClasses | `Partial<Record<FileUploadSlots, string>>` | no |  | Per-slot class overrides. |
 | title | `string` | no |  | Dropzone title text. |
 | unstyled | `boolean` | no |  | Strip all default styles. |
 | validate | `(file: File) => FileUploadError[] | null` | no |  | Custom validation function. Return errors array or null. |

package/content/blocks/components/guide/llm.txt

@@ -42,8 +42,5 @@ renders centered over a full scrim. Renders inert without a `GuideProvider`.
 | placement | `Placement` | no | 'bottom' | Preferred bubble placement when a step omits its own `placement`. |
 | preset | `string` | no |  | Apply a named preset registered via `<BlocksProvider presets={{ Guide: {...} }}>`. |
 | radius | `number` | no |  | Spotlight hole corner radius in px. When omitted, it follows the target's own border-radius (plus `padding`), clamped to the hole size. Set a number to force it. |
-| slotClasses | `Partial<Record<'container' | 'scrim' | 'bubble' | 'arrow' | 'title' | 'body' | 'progress' | 'dots' | 'dot' | 'dotActive' | 'stepText' | 'footer' | 'spacer' | 'skip' | 'prev' | 'next', string>>` | no |  | Per-slot class overrides. |
+| slotClasses | `Partial<Record<GuideTourSlots | 'skip' | 'prev' | 'next', string>>` | no |  | Per-slot class overrides. Beyond the tour's own `tv()` slots, `skip` / `prev` / `next` forward to the footer's nested `<Button>`s (which own their internal markup). |
 | unstyled | `boolean` | no | false | Strip all default styles. |
-
-### Slots (slotClasses keys)
-`container`, `scrim`, `bubble`, `arrow`, `title`, `body`, `progress`, `dots`, `dot`, `dotActive`, `stepText`, `footer`, `spacer`, `skip`, `prev`, `next`

package/content/blocks/components/guide-article/llm.txt

@@ -23,8 +23,5 @@ list (by `title`) and renders its content only when it is the active article
 | children | `Snippet` | no |  | Content to render inside the GuideArticle component |
 | class | `string` | no |  | Additional classes on the article root. |
 | preset | `string` | no |  | Apply a named preset registered via `<BlocksProvider presets={{ GuideArticle: {...} }}>`. |
-| slotClasses | `Partial<Record<'article', string>>` | no |  | Per-slot class overrides. |
+| slotClasses | `Partial<Record<GuideArticleSlots, string>>` | no |  | Per-slot class overrides. |
 | unstyled | `boolean` | no | false | Strip all default styles. |
-
-### Slots (slotClasses keys)
-`article`

package/content/blocks/components/guide-beacon/llm.txt

@@ -30,9 +30,6 @@ halts under `prefers-reduced-motion` (static dot). Renders inert without a `Guid
 | once | `boolean` | no | true | Hide the beacon once its `tour` has been seen (and while that tour is running). Needs `tour`. |
 | preset | `string` | no |  | Apply a named preset registered via `<BlocksProvider presets={{ GuideBeacon: {...} }}>`. |
 | size | `GuideBeaconVariants['size']` | no | 'md' | Visual size of the hotspot. |
-| slotClasses | `Partial<Record<'beacon' | 'ping' | 'dot', string>>` | no |  | Per-slot class overrides. |
+| slotClasses | `Partial<Record<GuideBeaconSlots, string>>` | no |  | Per-slot class overrides. |
 | tour | `GuideTour` | no |  | The tour to start when the beacon is activated. When set, the beacon also hides itself once the tour has been seen (subject to `once`). Omit to drive everything from `onActivate`. |
 | unstyled | `boolean` | no | false | Strip all default styles. |
-
-### Slots (slotClasses keys)
-`beacon`, `ping`, `dot`

package/content/blocks/components/guide-hint/llm.txt

@@ -32,10 +32,7 @@ tour is open. Dismissable; announces itself via `aria-live`. Renders inert witho
 | placement | `Placement` | no | 'bottom' | Preferred placement relative to the target. |
 | preset | `string` | no |  | Apply a named preset registered via `<BlocksProvider presets={{ GuideHint: {...} }}>`. |
 | seenId | `string` | no | the `for` id | Persistence key for the "seen once" state, decoupled from the anchor (this is *not* a DOM id — the popover gets none). Override only to track two hints on one element independently, or to keep a stable key across a renamed anchor. |
-| slotClasses | `Partial<Record<'hint' | 'title' | 'body' | 'dismiss' | 'arrow', string>>` | no |  | Per-slot class overrides. |
+| slotClasses | `Partial<Record<GuideHintSlots, string>>` | no |  | Per-slot class overrides. |
 | title | `string` | no |  | Optional bold heading above the body. |
 | trigger | `'mount' | 'manual'` | no | 'mount' | When the hint may appear: `'mount'` shows it as soon as it mounts; `'manual'` waits for `open` to become `true` (the consumer's route/condition logic). |
 | unstyled | `boolean` | no | false | Strip all default styles. |
-
-### Slots (slotClasses keys)
-`hint`, `title`, `body`, `dismiss`, `arrow`

package/content/blocks/components/guide-marker/llm.txt

@@ -29,8 +29,5 @@ or when the topic's direction excludes UI→Guide (`'to-ui'`).
 | label | `string` | no | i18n `guide.infoAbout` (with the topic's label) or `guide.info` | Accessible label for the icon button. |
 | preset | `string` | no |  | Apply a named preset registered via `<BlocksProvider presets={{ GuideMarker: {...} }}>`. |
 | size | `GuideMarkerVariants['size']` | no | 'md' | Size variant that controls dimensions and spacing of the GuideMarker |
-| slotClasses | `Partial<Record<'marker' | 'icon', string>>` | no |  | Per-slot class overrides. |
+| slotClasses | `Partial<Record<GuideMarkerSlots, string>>` | no |  | Per-slot class overrides. |
 | unstyled | `boolean` | no | false | Strip all default styles. |
-
-### Slots (slotClasses keys)
-`marker`, `icon`

package/content/blocks/components/guide-mention/llm.txt

@@ -24,8 +24,5 @@ view (reduced-motion-aware). A real `<button>`; degrades to plain inline text wi
 | direction | `GuideDirection` | no | the topic's `direction`, or `'both'` | Override the topic's link direction. The mention is interactive unless this resolves to `'to-guide'`. |
 | preset | `string` | no |  | Apply a named preset registered via `<BlocksProvider presets={{ GuideMention: {...} }}>`. |
 | scroll | `boolean` | no | true | Scroll the target into view on click (reduced-motion-aware). |
-| slotClasses | `Partial<Record<'mention', string>>` | no |  | Per-slot class overrides. |
+| slotClasses | `Partial<Record<GuideMentionSlots, string>>` | no |  | Per-slot class overrides. |
 | unstyled | `boolean` | no | false | Strip all default styles. |
-
-### Slots (slotClasses keys)
-`mention`

package/content/blocks/components/guide-panel/llm.txt

@@ -34,9 +34,6 @@ inside: the panel shows a list of them, or the active article's content with a b
 | placement | `GuidePanelVariants['placement']` | no | 'right' | Side the panel docks to. |
 | preset | `string` | no |  | Apply a named preset registered via `<BlocksProvider presets={{ GuidePanel: {...} }}>`. |
 | size | `GuidePanelVariants['size']` | no | 'md' | Size variant that controls dimensions and spacing of the GuidePanel |
-| slotClasses | `Partial<Record<'panel' | 'header' | 'backButton' | 'title' | 'closeButton' | 'body' | 'list' | 'listItem' | 'footer', string>>` | no |  | Per-slot class overrides. |
+| slotClasses | `Partial<Record<GuidePanelSlots, string>>` | no |  | Per-slot class overrides. |
 | title | `string` | no | i18n `guide.openHelp` | Heading shown when no article is open. |
 | unstyled | `boolean` | no | false | Strip all default styles. |
-
-### Slots (slotClasses keys)
-`panel`, `header`, `backButton`, `title`, `closeButton`, `body`, `list`, `listItem`, `footer`

package/content/blocks/components/planner/llm.txt

@@ -54,7 +54,7 @@ bind:value={referenceDate} onNavigate={(_, range) => loadWeek(range.start)}>
 | selectedDate | `Date` | no |  | The active highlighted day. Supports `bind:selectedDate`. |
 | showWeekNumber | `boolean` | no | false | Show the ISO week-number column on the left. |
 | size | `'sm' | 'md' | 'lg'` | no | 'md' | Density of the grid and header. |
-| slotClasses | `Partial<Record<PlannerSlotName, string>>` | no |  | Per-slot class overrides merged with tv() styles. |
+| slotClasses | `Partial<Record<PlannerSlots, string>>` | no |  | Per-slot class overrides merged with tv() styles. Slots: base | header | headerTitle | nav | navButton | grid | weekdayHeader | weekday | weekNumber | week | cell | cellHeader | cellWeekday | cellDate | cellItems | empty |
 | sort | `(a: T, b: T) => number` | no |  | Comparator for items within a day cell (e.g. by meal type or start label). |
 | swipeable | `boolean` | no | true | Enable horizontal swipe-to-navigate on touch. |
 | unstyled | `boolean` | no | false | Remove all default tv() classes — only user-provided classes apply. |

package/content/blocks/components/sankey/llm.txt

@@ -59,7 +59,7 @@ sr-only table provides a screen-reader fallback with source/target/value.
 | onNodeClick | `(node: SankeyLaidOutNodeWithMeta) => void` | no |  | Click callback for a node. |
 | preset | `string` | no |  | Preset property for the Sankey component |
 | showValues | `boolean` | no | false | Persistently display values next to node labels (instead of only in the hover tooltip). Useful for print, PDF attachments, static screenshots, or tenant- and client-facing statements where hovering is not possible. Uses `formatValue` for formatting. |
-| slotClasses | `Partial<Record<'wrapper' | 'svg' | 'node' | 'nodeRect' | 'nodeLabel' | 'nodeValue' | 'link' | 'tooltip' | 'tooltipLabel' | 'tooltipDetail', string>>` | no |  | Per-slot class overrides. |
+| slotClasses | `Partial<Record<SankeySlots, string>>` | no |  | Per-slot class overrides. |
 | tooltip | `Snippet<[datum: SankeyLaidOutNodeWithMeta | SankeyLaidOutLinkWithMeta, kind: 'node' | 'link']>` | no |  | Custom tooltip content for node or path. |
 | unstyled | `boolean` | no |  | Remove default classes. |
 | width | `number` | no |  | Optional fixed width. Default: derived from the container via ResizeObserver. Set a value only if you need SSR-stable layouts and are willing to give up responsiveness. |
@@ -67,6 +67,3 @@ sr-only table provides a screen-reader fallback with source/target/value.
 Inherited from:
 - Omit<SankeyVariants, never> (omit-pattern)
 - Omit<HTMLAttributes<HTMLDivElement>, 'children'> (omit-pattern)
-
-### Slots (slotClasses keys)
-`wrapper`, `svg`, `node`, `nodeRect`, `nodeLabel`, `nodeValue`, `link`, `tooltip`, `tooltipLabel`, `tooltipDetail`

package/content/blocks/components/theme-switcher/llm.txt

@@ -2,8 +2,10 @@
 ---
 
 ## ThemeSwitcher
-Cycles between light, dark, and system color schemes.
-Applies light/dark classes on the html element and persists to localStorage.
+Cycles between light, dark, and system color schemes. Sets a
+`light`/`dark` class on the `<html>` element for explicit choices and clears
+it in system mode (so the CSS `light-dark()` function follows the OS natively).
+Persists the choice to localStorage.
 
 **Import:** `import { ThemeSwitcher } from '@urbicon-ui/blocks';`
 
@@ -29,12 +31,9 @@ Applies light/dark classes on the html element and persists to localStorage.
 | onThemeChange | `(theme: Theme) => void` | no |  | Called after the theme changes. |
 | preset | `string` | no |  | Apply a named preset registered via `<BlocksProvider presets={{ ThemeSwitcher: {...} }}>`. 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 | `ThemeSwitcherVariants['size']` | no | 'md' | Size variant that controls dimensions and spacing of the ThemeSwitcher |
-| slotClasses | `Partial<Record<'button' | 'icon', string>>` | no |  | Per-slot class overrides. |
+| slotClasses | `Partial<Record<ThemeSwitcherSlots, string>>` | no |  | Per-slot class overrides. |
 | storageKey | `string | false` | no | 'urbicon-theme' | `localStorage` key for persistence. Set to `false` to disable. |
 | strategy | `'cycle' | 'toggle'` | no | 'cycle' | Interaction mode. - `'cycle'` — single button cycling light → dark → system (default) - `'toggle'` — single button toggling light ↔ dark (no system option) |
 | theme | `Theme` | no | 'system' | Current theme. Supports `bind:theme`. |
 | unstyled | `boolean` | no | false | Strip all default styles. |
 | variant | `ThemeSwitcherVariants['variant']` | no | 'ghost' | Visual style of the button. |
-
-### Slots (slotClasses keys)
-`button`, `icon`

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

@@ -14,7 +14,7 @@ Supports single or multiple open items, keyboard navigation, and ARIA accordion
     A Svelte 5 component library with built-in i18n and design tokens.
   </AccordionItem>
   <AccordionItem value="faq-2" title="How does dark mode work?">
-    Semantic tokens automatically handle light/dark via prefers-color-scheme.
+    Semantic tokens automatically handle light/dark via the CSS light-dark() function.
   </AccordionItem>
 </Accordion>
 ```
@@ -43,7 +43,7 @@ Supports single or multiple open items, keyboard navigation, and ARIA accordion
 | onValueChange | `(value: string | string[]) => void` | no |  | Callback when open items change |
 | preset | `string` | no |  | Apply a named preset registered via `<BlocksProvider presets={{ Accordion: {...} }}>`. 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 | `'sm' | 'md' | 'lg'` | no | 'md' | Size variant that controls dimensions and spacing of the Accordion |
-| slotClasses | `Partial<Record<'base' | 'item' | 'trigger' | 'chevron' | 'content' | 'contentInner', string>>` | no |  | Per-slot class overrides |
+| slotClasses | `Partial<Record<AccordionSlots, string>>` | no |  | Per-slot class overrides. Slots: base | item | trigger | chevron | content | contentInner |
 | type | `'single' | 'multiple'` | no | 'single' | Allow single or multiple items open at once |
 | unstyled | `boolean` | no |  | Remove default styles |
 | value | `string | string[]` | no |  | Controlled open item(s) – string for single, string[] for multiple |
@@ -52,6 +52,3 @@ Supports single or multiple open items, keyboard navigation, and ARIA accordion
 Inherited from:
 - AccordionVariants (external)
 - Omit<HTMLAttributes<HTMLDivElement>, 'children'> (omit-pattern)
-
-### Slots (slotClasses keys)
-`base`, `item`, `trigger`, `chevron`, `content`, `contentInner`

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

@@ -41,7 +41,7 @@ or informational messages. Supports icons, titles, descriptions, actions, and di
 | onDismiss | `() => void` | no |  | Callback when dismissed |
 | preset | `string` | no |  | Apply a named preset registered via `<BlocksProvider presets={{ Alert: {...} }}>`. 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 | `'sm' | 'md' | 'lg'` | no | 'md' | Size variant that controls dimensions and spacing of the Alert |
-| slotClasses | `Partial<Record<'base' | 'icon' | 'content' | 'title' | 'description' | 'actions' | 'dismissButton', string>>` | no |  | Per-slot class overrides |
+| slotClasses | `Partial<Record<AlertSlots, string>>` | no |  | Per-slot class overrides. Slots: base | icon | content | title | description | actions | dismissButton |
 | title | `string` | no |  | Alert title (bold header text) |
 | unstyled | `boolean` | no |  | Remove default styles |
 | variant | `'soft' | 'inline' | 'filled'` | no | 'soft' | Visual style variant for the Alert component |
@@ -49,6 +49,3 @@ or informational messages. Supports icons, titles, descriptions, actions, and di
 Inherited from:
 - AlertVariants (external)
 - Omit<HTMLAttributes<HTMLDivElement>, 'title' | 'children'> (omit-pattern)
-
-### Slots (slotClasses keys)
-`base`, `icon`, `content`, `title`, `description`, `actions`, `dismissButton`

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

@@ -41,7 +41,7 @@ User profile image component with fallback initials, multiple sizes, and interac
 | preset | `string` | no |  | Apply a named preset registered via `<BlocksProvider presets={{ Avatar: {...} }}>`. 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. |
 | randomColor | `boolean` | no |  | Derive a deterministic background color from `name`. The same name always produces the same color, making it easy to visually distinguish users without images. Overrides `intent`. |
 | ringColor | `string` | no |  | Custom ring color (CSS value). Overrides `ringIntent` when set. |
-| slotClasses | `Partial<Record<'base' | 'image' | 'fallback' | 'status', string>>` | no |  | Per-slot class overrides merged with tv styles. |
+| slotClasses | `Partial<Record<AvatarSlots, string>>` | no |  | Per-slot class overrides merged with tv styles. Slots: base | image | fallback | status |
 | src | `string` | no |  | Image URL. Falls back to initials or `children` when empty or on load error. |
 | unstyled | `boolean` | no |  | Remove all default tv classes. |
 | intent | `'danger' | 'neutral' | 'primary' | 'secondary' | 'success' | 'warning'` | no | neutral | Controls the color theme and semantic meaning of the Avatar. Affects the overall appearance and user perception. Available options: danger, neutral, primary, and 3 more. |
@@ -56,6 +56,3 @@ User profile image component with fallback initials, multiple sizes, and interac
 Inherited from:
 - AvatarVariants (external)
 - Omit<HTMLAttributes<HTMLDivElement>, 'children'> (omit-pattern)
-
-### Slots (slotClasses keys)
-`base`, `image`, `fallback`, `status`

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

@@ -49,12 +49,9 @@ Compact label for status, categories, counters, and notifications.
 | pulse | `boolean` | no |  | Add a pulsing animation to draw attention (e.g. for live indicators). |
 | removable | `boolean` | no |  | Show a remove (×) button. |
 | role | `'status' | 'alert' | 'badge'` | no |  | ARIA role. Defaults to `"status"`. Use `"alert"` for time-sensitive notifications. |
-| slotClasses | `Partial<Record<'base' | 'content' | 'removeButton' | 'removeIcon', string>>` | no |  | Per-slot class overrides merged with tv styles. |
+| slotClasses | `Partial<Record<BadgeSlots, string>>` | no |  | Per-slot class overrides merged with tv styles. |
 | unstyled | `boolean` | no |  | Remove all default tv classes. |
 | variant | `'dot' | 'filled' | 'outlined' | 'soft'` | no | 'filled' | Visual variant. `dot` renders a pure indicator (content hidden); the label variants accept the full surface. |
 | intent | `'danger' | 'neutral' | 'primary' | 'secondary' | 'success' | 'warning'` | no | primary | Controls the color theme and semantic meaning of the Badge. 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 Badge. Affects the component's physical footprint. Available options: lg, md, sm, xs. |
 | tier | `'commit' | 'modify'` | no | commit | Controls the tier behavior and appearance of the Badge component. Available options: commit, modify. |
-
-### Slots (slotClasses keys)
-`base`, `content`, `removeButton`, `removeIcon`

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

@@ -36,12 +36,9 @@ Renders an accessible nav with structured items and customizable separators.
 | preset | `string` | no |  | Apply a named preset registered via `<BlocksProvider presets={{ Breadcrumb: {...} }}>`. 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. |
 | separator | `Snippet` | no |  | Custom separator snippet (default: "/") |
 | size | `'sm' | 'md' | 'lg'` | no | 'md' | Size variant that controls dimensions and spacing of the Breadcrumb |
-| slotClasses | `Partial<Record<'nav' | 'list' | 'item' | 'link' | 'currentPage' | 'separator', string>>` | no |  | Per-slot class overrides |
+| slotClasses | `Partial<Record<BreadcrumbSlots, string>>` | no |  | Per-slot class overrides |
 | unstyled | `boolean` | no |  | Remove default styles |
 
 Inherited from:
 - BreadcrumbVariants (external)
 - Omit<HTMLAttributes<HTMLElement>, 'children'> (omit-pattern)
-
-### Slots (slotClasses keys)
-`nav`, `list`, `item`, `link`, `currentPage`, `separator`

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

@@ -63,7 +63,7 @@ slotClasses: {
 | onclick | `(event: MouseEvent) => void` | no |  | Onclick property for the Button component |
 | preset | `string` | no |  | Apply a named preset registered via `<BlocksProvider presets={{ Button: {...} }}>`. Prefer this over `class="bg-…!"` overrides when the requested look is outside the semantic intent palette — presets keep hover/active/dark-mode logic coherent and make the custom look reusable across the project. |
 | pressed | `boolean` | no | false | Whether the button is pressed (for toggle buttons) |
-| slotClasses | `Partial<Record<'base' | 'content' | 'spinner', string>>` | no |  | Per-slot class overrides merged with tv styles: base | content | spinner |
+| slotClasses | `Partial<Record<ButtonSlots, string>>` | no |  | Per-slot class overrides merged with tv styles. Slots: base | content | spinner |
 | unstyled | `boolean` | no |  | Remove default tailwind-variants classes. Only user classes apply. |
 | value | `string` | no |  | The value associated with the button (useful in ButtonGroups) |
 | intent | `'danger' | 'neutral' | 'primary' | 'secondary' | 'success' | 'warning'` | no | neutral | Controls the color theme and semantic meaning of the Button. Affects the overall appearance and user perception. Available options: danger, neutral, primary, and 3 more. |
@@ -75,6 +75,3 @@ slotClasses: {
 Inherited from:
 - ButtonVariants (external)
 - Omit<HTMLButtonAttributes, 'children'> (omit-pattern)
-
-### Slots (slotClasses keys)
-`base`, `content`, `spinner`

package/content/blocks/primitives/button-group/llm.txt

@@ -52,7 +52,7 @@ Supports single-select (radio), multi-select (checkbox), or no selection.
 | preset | `string` | no |  | Apply a named preset registered via `<BlocksProvider presets={{ ButtonGroup: {...} }}>`. 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. |
 | selection | `ButtonGroupSelection` | no |  | Selection mode. `"single"` = radio-group, `"multiple"` = checkbox-group, `"none"` = no selection. |
 | size | `ComponentSize` | no |  | Size propagated to child Buttons (unless a Button sets its own). |
-| slotClasses | `Partial<Record<'base', string>>` | no |  | Per-slot class overrides. |
+| slotClasses | `Partial<Record<ButtonGroupSlots, string>>` | no |  | Per-slot class overrides. Slots: base |
 | tier | `InteractiveTier` | no |  | Semantic radius tier propagated to child Buttons. `commit` (default) → pill caps for the group; `modify` → soft caps. Inherits from a wrapping Toolbar via TierContext when not set explicitly. |
 | unstyled | `boolean` | no |  | Remove all default tv classes. |
 | value | `ButtonGroupValue` | no |  | Current selection value. Bind with `bind:value` for two-way sync. String for single, string[] for multiple. |
@@ -60,6 +60,3 @@ Supports single-select (radio), multi-select (checkbox), or no selection.
 
 Inherited from:
 - Omit<HTMLAttributes<HTMLDivElement>, 'children'> (omit-pattern)
-
-### Slots (slotClasses keys)
-`base`

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

@@ -53,7 +53,7 @@ and interactive states. Renders as div, button, or anchor depending on the provi
 | onclick | `(event: MouseEvent) => void` | no |  | Click handler. When provided, the card renders as `<button>` and gains interactive styles. |
 | onHover | `(hovered: boolean) => void` | no |  | Called when hover state changes. Receives `true` on mouse-enter, `false` on mouse-leave. |
 | preset | `string` | no |  | Apply a named preset registered via `<BlocksProvider presets={{ Card: {...} }}>`. 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' | 'header' | 'content' | 'footer', string>>` | no |  | Per-slot class overrides. |
+| slotClasses | `Partial<Record<CardSlots, string>>` | no |  | Per-slot class overrides. Slots: base | header | content | footer |
 | unstyled | `boolean` | no |  | Remove all default tv classes. |
 | variant | `'elevated' | 'floating' | 'outlined' | 'quiet'` | no | quiet | Controls the visual style and presentation of the Card. Determines the component's visual treatment. Available options: elevated, floating, outlined, quiet. |
 | disabled | `'true'` | no | false | Controls the disabled behavior and appearance of the Card component. Available options: true. |
@@ -63,6 +63,3 @@ and interactive states. Renders as div, button, or anchor depending on the provi
 Inherited from:
 - Omit<CardVariants, 'elementType' | 'interactive'> (omit-pattern)
 - Omit<HTMLAttributes<HTMLElement>, 'children'> (omit-pattern)
-
-### Slots (slotClasses keys)
-`base`, `header`, `content`, `footer`

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

@@ -45,7 +45,7 @@ Uses a hidden native input for correct form behavior and ARIA semantics.
 | 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={{ Checkbox: {...} }}>`. 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' | 'box' | 'icon' | 'label' | 'message', string>>` | no |  | Per-slot class overrides merged with (or replacing, when `unstyled`) the default styles. |
+| slotClasses | `Partial<Record<CheckboxSlots, string>>` | no |  | Per-slot class overrides merged with (or replacing, when `unstyled`) the default styles. Slots: wrapper (root — what `class` also targets) | control | box | icon | label | message. |
 | tier | `InteractiveTier` | no |  | Semantic radius tier. Default `modify` — checkbox is an input-tap surface. Inherited from TierContext when omitted; falls back to `modify` outside of any tier-aware container. |
 | unstyled | `boolean` | no |  | Strip all default tailwind-variants classes. Use with `slotClasses` for a fully custom look. The box exposes `data-state` for conditional styling. |
 | value | `string` | no |  | The value submitted when checked. Defaults to `'on'`. |
@@ -56,6 +56,3 @@ Uses a hidden native input for correct form behavior and ARIA semantics.
 Inherited from:
 - Omit<CheckboxVariants, 'error' | 'checked' | 'indeterminate'> (omit-pattern)
 - Omit<HTMLInputAttributes, 'type' | 'size' | 'checked' | 'class' | 'children'> (omit-pattern)
-
-### Slots (slotClasses keys)
-`wrapper`, `control`, `box`, `icon`, `label`, `message`

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

@@ -43,7 +43,7 @@ components like Accordion.
 | 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 |
+| slotClasses | `Partial<Record<CollapsibleSlots, string>>` | no |  | Per-slot class overrides. Slots: base | trigger | chevron | content | contentInner |
 | title | `string` | no |  | Trigger label text (used by the default trigger) |
 | trigger | `Snippet<[
       {
@@ -61,6 +61,3 @@ components like Accordion.
 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

@@ -72,7 +72,7 @@ bind:value={tenantId}
 | 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. |
+| slotClasses | `Partial<Record<ComboboxSlots, string>>` | no |  | Per-slot class overrides merged with tv() styles. Slots: base | label | requiredMark | inputWrapper | input | message | hint | listbox | option | optionActive | optionSelected | noResults | clear | chevron |
 | 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. |
@@ -81,6 +81,3 @@ bind:value={tenantId}
 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/dialog/llm.txt

@@ -46,7 +46,7 @@ content-agnostic overlay or as a structured dialog with title, footer, and inten
 | 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. |
+| slotClasses | `Partial<Record<DialogSlots, 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`). |
@@ -54,6 +54,3 @@ content-agnostic overlay or as a structured dialog with title, footer, and inten
 
 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

@@ -41,7 +41,7 @@ Uses native dialog with focus trap, backdrop click dismiss, and Escape key suppo
 | 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. |
+| slotClasses | `Partial<Record<DrawerSlots, 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`). |
@@ -49,6 +49,3 @@ Uses native dialog with focus trap, backdrop click dismiss, and Escape key suppo
 
 Inherited from:
 - Omit<HTMLDialogAttributes, 'children' | 'open'> (omit-pattern)
-
-### Slots (slotClasses keys)
-`dialog`, `backdrop`, `panel`, `header`, `title`, `body`, `footer`

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

@@ -54,7 +54,7 @@ Supports outlined, filled, and ghost visual variants with automatic ARIA linking
 | 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. |
+| slotClasses | `Partial<Record<InputSlots, string>>` | no |  | Per-slot class overrides merged with tv() styles. Slots: wrapper (root — what `class` also targets) | container | base (the `<input>` element) | label | message | iconContainer | iconButton | iconDecoration. |
 | 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. |
@@ -68,6 +68,3 @@ Supports outlined, filled, and ghost visual variants with automatic ARIA linking
 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/pagination/llm.txt

@@ -51,7 +51,7 @@ Supports multiple layouts, intents, button variants, and configurable ellipsis b
 | 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. |
+| slotClasses | `Partial<Record<PaginationSlots, 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. |
@@ -63,6 +63,3 @@ Supports multiple layouts, intents, button variants, and configurable ellipsis b
 Inherited from:
 - Omit<PaginationVariants, 'disabled' | 'loading'> (omit-pattern)
 - Omit<HTMLAttributes<HTMLElement>, 'class'> (omit-pattern)
-
-### Slots (slotClasses keys)
-`base`, `info`, `controls`, `ellipsis`

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

@@ -38,7 +38,7 @@ Supports linear bar and circular ring variants with semantic intents and animati
 | preset | `string` | no |  | Apply a named preset registered via `<BlocksProvider presets={{ Progress: {...} }}>`. 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. |
 | shape | `'linear' | 'circular'` | no | 'linear' | Shape of the progress indicator. |
 | showValue | `boolean` | no | false | Show the numeric value (percentage or absolute) next to the label. |
-| slotClasses | `Partial<Record<'wrapper' | 'header' | 'label' | 'valueText' | 'track' | 'fill' | 'circularWrapper' | 'circularTrack' | 'circularFill' | 'circularLabel', string>>` | no |  | Per-slot class overrides merged with tv() styles. |
+| slotClasses | `Partial<Record<ProgressSlots, string>>` | no |  | Per-slot class overrides merged with tv() styles. Slots: wrapper (linear root — what `class` targets in linear shape) | header | label | valueText | track | fill | circularWrapper (circular root — what `class` targets in circular shape) | circularTrack | circularFill | circularLabel. |
 | striped | `boolean` | no | false | Display striped pattern on the fill. |
 | strokeWidth | `number` | no | 6 | Stroke width of the circular indicator in pixels. |
 | unstyled | `boolean` | no |  | Remove all default tv() classes. |
@@ -50,6 +50,3 @@ Supports linear bar and circular ring variants with semantic intents and animati
 Inherited from:
 - ProgressVariants (external)
 - Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'class'> (omit-pattern)
-
-### Slots (slotClasses keys)
-`wrapper`, `header`, `label`, `valueText`, `track`, `fill`, `circularWrapper`, `circularTrack`, `circularFill`, `circularLabel`

package/content/blocks/primitives/radio-group/llm.txt

@@ -40,7 +40,7 @@ Uses native radio inputs for correct form behavior and ARIA semantics with keybo
 | preset | `string` | no |  | Apply a named preset registered via `<BlocksProvider presets={{ RadioGroup: {...} }}>`. 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 group as required for form validation. Adds an asterisk to the label. |
 | size | `RadioItemVariants['size']` | no | 'md' | Visual size propagated to all child RadioItems. |
-| slotClasses | `Partial<Record<'root' | 'group' | 'label' | 'message', string>>` | no |  | Per-slot class overrides merged with tv() styles. |
+| slotClasses | `Partial<Record<RadioGroupSlots, string>>` | no |  | Per-slot class overrides merged with tv() styles. |
 | tier | `InteractiveTier` | no | 'commit' | Semantic radius tier propagated to every RadioItem. Default `commit` — radio indicators read as identity circles. Set to `modify` (or inherit via TierContext from a wrapping `<Toolbar tier="modify">`) for inline-toolbar contexts where a circle feels oversized. |
 | unstyled | `boolean` | no |  | Remove all default tv() classes. Only user-provided classes apply. |
 | value | `string` | no |  | Currently selected value. Supports two-way binding via `bind:value`. |
@@ -48,6 +48,3 @@ Uses native radio inputs for correct form behavior and ARIA semantics with keybo
 
 Inherited from:
 - Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'class'> (omit-pattern)
-
-### Slots (slotClasses keys)
-`root`, `group`, `label`, `message`