@tlglobal/ui 2.0.0

package/dist/AI_CONTEXT.md

@@ -0,0 +1,621 @@
+<!-- Generated by scripts/generate-ai-context.mjs — do not edit by hand. -->
+# @tlglobal/ui v2.0.0 — AI context
+
+Complete generated reference for an agent working in a repo that consumes this package.
+Usage rules, setup and known limits live in `CONSUMING.md` — read that first; this file is
+the inventory only.
+
+Props listed are each component's own. "Also accepts" means it additionally takes all standard
+attributes of that DOM interface (`className`, `onClick`, `aria-*`, and so on).
+
+## Components (66)
+
+### Accordion
+
+`import { Accordion } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/accordion`
+
+**Parts:** `Accordion.Root`, `Accordion.Item`, `Accordion.Trigger`, `Accordion.Content`
+
+### Alert
+
+`import { Alert } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/alert`
+
+**Also accepts:** `HTMLAttributes<HTMLDivElement>`
+
+| Prop | Type | Required |
+|---|---|---|
+| `tone` | `"neutral" \| "success" \| "warning" \| "danger"` |  |
+| `title` | `ReactNode` |  |
+
+### AlertDialog
+
+`import { AlertDialog } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/alert-dialog`
+
+**Parts:** `AlertDialog.Root`, `AlertDialog.Trigger`, `AlertDialog.Content`, `AlertDialog.Title`, `AlertDialog.Description`, `AlertDialog.Footer`, `AlertDialog.Action`, `AlertDialog.Cancel`
+
+### AspectRatio
+
+`import { AspectRatio } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/aspect-ratio`
+
+### Attachment
+
+`import { Attachment } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/attachment`
+
+**Parts:** `Attachment.Root`, `Attachment.List`, `Attachment.Preview`, `Attachment.Icon`, `Attachment.Info`, `Attachment.Name`, `Attachment.Meta`, `Attachment.Remove`
+
+**Also accepts:** `LiHTMLAttributes<HTMLLIElement>`
+
+| Prop | Type | Required |
+|---|---|---|
+| `uploading` — Dims the chip and shows a spinner while the file is still uploading. | `boolean` |  |
+
+### Avatar
+
+`import { Avatar } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/avatar`
+
+| Prop | Type | Required |
+|---|---|---|
+| `src` | `string` |  |
+| `alt` | `string` |  |
+| `fallback` | `ReactNode` |  |
+| `size` | `"sm" \| "md" \| "lg"` |  |
+| `className` | `string` |  |
+
+### Badge
+
+`import { Badge } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/badge`
+
+**Also accepts:** `HTMLAttributes<HTMLSpanElement>`
+
+| Prop | Type | Required |
+|---|---|---|
+| `tone` | `"neutral" \| "accent" \| "success" \| "warning" \| "danger"` |  |
+
+### Breadcrumb
+
+`import { Breadcrumb } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/breadcrumb`
+
+**Parts:** `Breadcrumb.Root`, `Breadcrumb.List`, `Breadcrumb.Item`, `Breadcrumb.Link`, `Breadcrumb.Page`, `Breadcrumb.Separator`
+
+### Bubble
+
+`import { Bubble } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/bubble`
+
+**Also accepts:** `HTMLAttributes<HTMLDivElement>`
+
+| Prop | Type | Required |
+|---|---|---|
+| `direction` — Overrides the nearest Direction.Provider. | `MessageDirection` |  |
+| `tone` — `tone` deliberately overrides the direction colours — an error should read as an error first. | `"default" \| "muted" \| "danger"` |  |
+| `size` | `"sm" \| "md" \| "lg"` |  |
+| `loading` — Replaces children with an animated typing indicator. | `boolean` |  |
+
+### Button
+
+`import { Button } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/button`
+
+**Also accepts:** `ButtonHTMLAttributes<HTMLButtonElement>`
+
+| Prop | Type | Required |
+|---|---|---|
+| `variant` | `"primary" \| "secondary" \| "ghost" \| "danger"` |  |
+| `size` | `"sm" \| "md" \| "lg"` |  |
+| `iconLeft` | `ReactNode` |  |
+| `iconRight` | `ReactNode` |  |
+
+### ButtonGroup
+
+`import { ButtonGroup } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/button-group`
+
+### Calendar
+
+`import { Calendar } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/calendar`
+
+### Card
+
+`import { Card } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/card`
+
+**Also accepts:** `HTMLAttributes<HTMLDivElement>`
+
+| Prop | Type | Required |
+|---|---|---|
+| `padding` | `"none" \| "sm" \| "md" \| "lg"` |  |
+
+### Carousel
+
+`import { Carousel } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/carousel`
+
+**Parts:** `Carousel.Root`, `Carousel.Content`, `Carousel.Item`, `Carousel.Previous`, `Carousel.Next`
+
+**Requires:** must be used within `Carousel.Root`
+
+**Also accepts:** `HTMLAttributes<HTMLDivElement>`
+
+| Prop | Type | Required |
+|---|---|---|
+| `orientation` | `"horizontal" \| "vertical"` |  |
+| `opts` | `EmblaOptionsType` |  |
+| `children` | `ReactNode` |  |
+
+### Chart
+
+`import { Chart } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/chart`
+
+**Parts:** `Chart.Container`, `Chart.Tooltip`, `Chart.TooltipContent`, `Chart.Legend`, `Chart.LegendContent`
+
+**Requires:** must be used within `Chart.Container`
+
+### Checkbox
+
+`import { Checkbox } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/checkbox`
+
+**Also accepts:** `Omit<ComponentPropsWithoutRef<typeof RadixCheckbox.Root>, "asChild">`
+
+| Prop | Type | Required |
+|---|---|---|
+| `label` | `string` |  |
+
+### Collapsible
+
+`import { Collapsible } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/collapsible`
+
+**Parts:** `Collapsible.Root`, `Collapsible.Trigger`, `Collapsible.Content`
+
+### Combobox
+
+`import { Combobox } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/combobox`
+
+| Prop | Type | Required |
+|---|---|---|
+| `options` | `ComboboxOption[]` | yes |
+| `value` | `string` |  |
+| `onValueChange` | `(value: string \| undefined) => void` |  |
+| `placeholder` | `string` |  |
+| `searchPlaceholder` | `string` |  |
+| `emptyMessage` | `string` |  |
+| `disabled` | `boolean` |  |
+| `className` | `string` |  |
+
+### Command
+
+`import { Command } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/command`
+
+**Parts:** `Command.Root`, `Command.Input`, `Command.List`, `Command.Empty`, `Command.Group`, `Command.Item`, `Command.Separator`, `Command.Dialog`
+
+### ContextMenu
+
+`import { ContextMenu } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/context-menu`
+
+**Parts:** `ContextMenu.Root`, `ContextMenu.Trigger`, `ContextMenu.Content`, `ContextMenu.Item`, `ContextMenu.CheckboxItem`, `ContextMenu.RadioGroup`, `ContextMenu.RadioItem`, `ContextMenu.Label`, `ContextMenu.Separator`, `ContextMenu.Shortcut`, `ContextMenu.Group`, `ContextMenu.Sub`, `ContextMenu.SubTrigger`, `ContextMenu.SubContent`
+
+### DatePicker
+
+`import { DatePicker } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/date-picker`
+
+| Prop | Type | Required |
+|---|---|---|
+| `value` | `Date` |  |
+| `onValueChange` | `(date: Date \| undefined) => void` |  |
+| `placeholder` | `string` |  |
+| `disabled` | `boolean` |  |
+| `className` | `string` |  |
+
+### Dialog
+
+`import { Dialog } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/dialog`
+
+**Parts:** `Dialog.Root`, `Dialog.Trigger`, `Dialog.Close`, `Dialog.Content`, `Dialog.Title`, `Dialog.Description`, `Dialog.Footer`
+
+### Direction
+
+`import { Direction } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/direction`
+
+**Parts:** `Direction.Provider`
+
+### Drawer
+
+`import { Drawer } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/drawer`
+
+**Parts:** `Drawer.Root`, `Drawer.Trigger`, `Drawer.Close`, `Drawer.Content`, `Drawer.Title`, `Drawer.Description`, `Drawer.Footer`
+
+### DropdownMenu
+
+`import { DropdownMenu } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/dropdown-menu`
+
+**Parts:** `DropdownMenu.Root`, `DropdownMenu.Trigger`, `DropdownMenu.Content`, `DropdownMenu.Item`, `DropdownMenu.CheckboxItem`, `DropdownMenu.RadioGroup`, `DropdownMenu.RadioItem`, `DropdownMenu.Label`, `DropdownMenu.Separator`, `DropdownMenu.Shortcut`, `DropdownMenu.Group`, `DropdownMenu.Sub`, `DropdownMenu.SubTrigger`, `DropdownMenu.SubContent`
+
+### Empty
+
+`import { Empty } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/empty`
+
+**Also accepts:** `HTMLAttributes<HTMLDivElement>`
+
+| Prop | Type | Required |
+|---|---|---|
+| `icon` | `ReactNode` |  |
+| `title` | `ReactNode` |  |
+| `description` | `ReactNode` |  |
+| `action` | `ReactNode` |  |
+
+### Field
+
+`import { Field } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/field`
+
+**Also accepts:** `Omit<HTMLAttributes<HTMLDivElement>, "children">`
+
+| Prop | Type | Required |
+|---|---|---|
+| `label` | `string` |  |
+| `error` | `string` |  |
+| `hint` | `string` |  |
+| `id` | `string` |  |
+| `children` | `ReactNode \| ((controlProps: FieldControlProps) => ReactNode)` | yes |
+
+### HoverCard
+
+`import { HoverCard } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/hover-card`
+
+**Parts:** `HoverCard.Root`, `HoverCard.Trigger`, `HoverCard.Content`
+
+### IconButton
+
+`import { IconButton } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/icon-button`
+
+**Also accepts:** `Omit<ButtonHTMLAttributes<HTMLButtonElement>, "aria-label">`
+
+| Prop | Type | Required |
+|---|---|---|
+| `variant` | `"primary" \| "secondary" \| "ghost"` |  |
+| `size` | `"sm" \| "md" \| "lg"` |  |
+| `icon` | `ReactNode` | yes |
+| `aria-label` | `string` | yes |
+
+### Input
+
+`import { Input } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/input`
+
+**Also accepts:** `Omit<InputHTMLAttributes<HTMLInputElement>, "size">`
+
+| Prop | Type | Required |
+|---|---|---|
+| `label` | `string` |  |
+| `error` | `string` |  |
+| `hint` | `string` |  |
+| `size` | `"sm" \| "md" \| "lg"` |  |
+
+### InputGroup
+
+`import { InputGroup } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/input-group`
+
+**Parts:** `InputGroup.Root`, `InputGroup.Addon`, `InputGroup.Input`
+
+### InputOTP
+
+`import { InputOTP } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/input-otp`
+
+**Parts:** `InputOTP.Root`, `InputOTP.Group`, `InputOTP.Slot`, `InputOTP.Separator`
+
+### Item
+
+`import { Item } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/item`
+
+**Also accepts:** `HTMLAttributes<HTMLDivElement>`
+
+| Prop | Type | Required |
+|---|---|---|
+| `leading` | `ReactNode` |  |
+| `trailing` | `ReactNode` |  |
+| `title` | `ReactNode` |  |
+| `description` | `ReactNode` |  |
+
+### Kbd
+
+`import { Kbd } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/kbd`
+
+### Label
+
+`import { Label } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/label`
+
+### Marker
+
+`import { Marker } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/marker`
+
+**Also accepts:** `HTMLAttributes<HTMLDivElement>`
+
+| Prop | Type | Required |
+|---|---|---|
+| `tone` | `"neutral" \| "accent" \| "danger"` |  |
+| `align` — Which side(s) the rule is drawn on. "center" draws both. Defaults to "center". | `"start" \| "center" \| "end"` |  |
+
+### Menubar
+
+`import { Menubar } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/menubar`
+
+**Parts:** `Menubar.Root`, `Menubar.Menu`, `Menubar.Trigger`, `Menubar.Content`, `Menubar.Item`, `Menubar.CheckboxItem`, `Menubar.RadioGroup`, `Menubar.RadioItem`, `Menubar.Separator`, `Menubar.Shortcut`, `Menubar.Group`, `Menubar.Sub`, `Menubar.SubTrigger`, `Menubar.SubContent`
+
+### Message
+
+`import { Message } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/message`
+
+**Parts:** `Message.Root`, `Message.Avatar`, `Message.Body`, `Message.Header`, `Message.Author`, `Message.Time`, `Message.Content`, `Message.Actions`, `Message.Footer`
+
+**Also accepts:** `HTMLAttributes<HTMLDivElement>`
+
+| Prop | Type | Required |
+|---|---|---|
+| `direction` — Also provides this direction to every descendant via Direction.Provider. | `MessageDirection` |  |
+
+### MessageScroller
+
+`import { MessageScroller } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/message-scroller`
+
+**Parts:** `MessageScroller.Root`, `MessageScroller.Viewport`, `MessageScroller.Content`, `MessageScroller.JumpToLatest`
+
+**Requires:** must be used within `MessageScroller.Root`
+
+**Also accepts:** `HTMLAttributes<HTMLDivElement>`
+
+| Prop | Type | Required |
+|---|---|---|
+| `threshold` — Distance from the bottom, in px, still counted as "pinned". Defaults to 32. | `number` |  |
+
+### NativeSelect
+
+`import { NativeSelect } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/native-select`
+
+**Also accepts:** `Omit<SelectHTMLAttributes<HTMLSelectElement>, "size">`
+
+| Prop | Type | Required |
+|---|---|---|
+| `label` | `string` |  |
+| `error` | `string` |  |
+| `hint` | `string` |  |
+| `size` | `"sm" \| "md" \| "lg"` |  |
+| `options` | `NativeSelectOption[]` | yes |
+| `placeholder` | `string` |  |
+
+### NavigationMenu
+
+`import { NavigationMenu } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/navigation-menu`
+
+**Parts:** `NavigationMenu.Root`, `NavigationMenu.List`, `NavigationMenu.Item`, `NavigationMenu.Trigger`, `NavigationMenu.Content`, `NavigationMenu.Link`
+
+### Pagination
+
+`import { Pagination } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/pagination`
+
+**Parts:** `Pagination.Root`, `Pagination.Item`, `Pagination.Ellipsis`, `Pagination.Previous`, `Pagination.Next`
+
+### Popover
+
+`import { Popover } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/popover`
+
+**Parts:** `Popover.Root`, `Popover.Trigger`, `Popover.Anchor`, `Popover.Content`, `Popover.Close`
+
+### Progress
+
+`import { Progress } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/progress`
+
+**Also accepts:** `Omit<HTMLAttributes<HTMLDivElement>, "value">`
+
+| Prop | Type | Required |
+|---|---|---|
+| `value` | `number` |  |
+| `max` | `number` |  |
+
+### Questionnaire
+
+`import { Questionnaire } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/questionnaire`
+
+**Parts:** `Questionnaire.Root`, `Questionnaire.Prompt`, `Questionnaire.Options`, `Questionnaire.Option`
+
+**Requires:** must be used within `Questionnaire.Root`
+
+**Also accepts:** `HTMLAttributes<HTMLDivElement>`
+
+| Prop | Type | Required |
+|---|---|---|
+| `multiple` — Multi-select renders Options as a `group` of toggle buttons (`aria-pressed`); single-select renders a `radiogroup` of radios (`aria-checked`). Defaults to false. | `boolean` |  |
+
+### RadioGroup
+
+`import { RadioGroup } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/radio-group`
+
+### RadioGroupItem
+
+`import { RadioGroupItem } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/radio-group`
+
+**Also accepts:** `Omit<ComponentPropsWithoutRef<typeof RadixRadioGroup.Item>, "asChild">`
+
+| Prop | Type | Required |
+|---|---|---|
+| `label` | `string` |  |
+
+### Resizable
+
+`import { Resizable } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/resizable`
+
+**Parts:** `Resizable.Group`, `Resizable.Panel`, `Resizable.Separator`
+
+### ScrollArea
+
+`import { ScrollArea } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/scroll-area`
+
+### Select
+
+`import { Select } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/select`
+
+| Prop | Type | Required |
+|---|---|---|
+| `label` | `string` |  |
+| `error` | `string` |  |
+| `hint` | `string` |  |
+| `size` | `"sm" \| "md" \| "lg"` |  |
+| `disabled` | `boolean` |  |
+| `options` | `SelectOption[]` | yes |
+| `placeholder` | `string` |  |
+| `value` | `string` |  |
+| `defaultValue` | `string` |  |
+| `onValueChange` | `(value: string) => void` |  |
+| `className` | `string` |  |
+| `id` | `string` |  |
+
+### Separator
+
+`import { Separator } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/separator`
+
+### Sheet
+
+`import { Sheet } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/sheet`
+
+**Parts:** `Sheet.Root`, `Sheet.Trigger`, `Sheet.Close`, `Sheet.Content`, `Sheet.Title`, `Sheet.Description`, `Sheet.Footer`
+
+### Sidebar
+
+`import { Sidebar } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/sidebar`
+
+**Parts:** `Sidebar.Provider`, `Sidebar.Root`, `Sidebar.Inset`, `Sidebar.Trigger`, `Sidebar.Rail`, `Sidebar.Header`, `Sidebar.Footer`, `Sidebar.Content`, `Sidebar.Separator`, `Sidebar.Input`, `Sidebar.Group`, `Sidebar.GroupLabel`, `Sidebar.GroupAction`, `Sidebar.GroupContent`, `Sidebar.Menu`, `Sidebar.MenuItem`, `Sidebar.MenuButton`, `Sidebar.MenuAction`, `Sidebar.MenuBadge`, `Sidebar.MenuSkeleton`, `Sidebar.MenuSub`, `Sidebar.MenuSubItem`, `Sidebar.MenuSubButton`
+
+**Requires:** must be used within `Sidebar.Provider`
+
+**Also accepts:** `HTMLAttributes<HTMLDivElement>`
+
+| Prop | Type | Required |
+|---|---|---|
+| `side` | `"left" \| "right"` |  |
+| `variant` | `"sidebar" \| "floating" \| "inset"` |  |
+| `collapsible` | `"offcanvas" \| "icon" \| "none"` |  |
+| `mobileTitle` — Screen-reader title for the mobile Sheet. Defaults to "Sidebar". | `string` |  |
+| `children` | `ReactNode` |  |
+
+### Skeleton
+
+`import { Skeleton } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/skeleton`
+
+### Slider
+
+`import { Slider } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/slider`
+
+### Spinner
+
+`import { Spinner } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/spinner`
+
+**Also accepts:** `SVGAttributes<SVGSVGElement>`
+
+| Prop | Type | Required |
+|---|---|---|
+| `size` | `number \| string` |  |
+
+### Switch
+
+`import { Switch } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/switch`
+
+**Also accepts:** `Omit<ComponentPropsWithoutRef<typeof RadixSwitch.Root>, "asChild">`
+
+| Prop | Type | Required |
+|---|---|---|
+| `label` | `string` |  |
+
+### Table
+
+`import { Table } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/table`
+
+**Parts:** `Table.Root`, `Table.Header`, `Table.Body`, `Table.Footer`, `Table.Row`, `Table.Head`, `Table.Cell`, `Table.Caption`
+
+### Tabs
+
+`import { Tabs } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/tabs`
+
+**Parts:** `Tabs.Root`, `Tabs.List`, `Tabs.Trigger`, `Tabs.Content`
+
+### Tag
+
+`import { Tag } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/tag`
+
+**Also accepts:** `HTMLAttributes<HTMLSpanElement>`
+
+| Prop | Type | Required |
+|---|---|---|
+| `onRemove` | `() => void` |  |
+
+### Textarea
+
+`import { Textarea } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/textarea`
+
+**Also accepts:** `TextareaHTMLAttributes<HTMLTextAreaElement>`
+
+| Prop | Type | Required |
+|---|---|---|
+| `label` | `string` |  |
+| `error` | `string` |  |
+| `hint` | `string` |  |
+
+### Toaster
+
+`import { Toaster } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/toast`
+
+### Toggle
+
+`import { Toggle } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/toggle`
+
+**Also accepts:** `ComponentPropsWithoutRef<typeof RadixToggle.Root>`
+
+| Prop | Type | Required |
+|---|---|---|
+| `variant` | `"default" \| "outline"` |  |
+| `size` | `"sm" \| "md" \| "lg"` |  |
+
+### ToggleGroup
+
+`import { ToggleGroup } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/toggle-group`
+
+### ToggleGroupItem
+
+`import { ToggleGroupItem } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/toggle-group`
+
+**Also accepts:** `ComponentPropsWithoutRef<typeof RadixToggleGroup.Item>`
+
+| Prop | Type | Required |
+|---|---|---|
+| `variant` | `"default" \| "outline"` |  |
+| `size` | `"sm" \| "md" \| "lg"` |  |
+
+### Tooltip
+
+`import { Tooltip } from "@tlglobal/ui"`  ·  subpath `@tlglobal/ui/tooltip`
+
+| Prop | Type | Required |
+|---|---|---|
+| `label` | `ReactNode` | yes |
+| `children` | `ReactElement` | yes |
+| `side` | `"top" \| "right" \| "bottom" \| "left"` |  |
+| `className` | `string` |  |
+
+## Tokens
+
+CSS custom properties, available once `@tlglobal/ui/styles.css` is imported.
+In Tailwind they surface as same-named utilities: `--bg-surface` → `bg-bg-surface`.
+
+### Semantic — 15 (prefer these; they re-aim under `[data-theme="dark"]`)
+
+| Token | Light value |
+|---|---|
+| `--bg-page` | `var(--neutral-0)` |
+| `--bg-surface` | `var(--neutral-100)` |
+| `--bg-surface-hover` | `var(--neutral-200)` |
+| `--bg-inverse` | `var(--neutral-900)` |
+| `--text-primary` | `var(--neutral-900)` |
+| `--text-secondary` | `var(--neutral-500)` |
+| `--text-muted` | `var(--neutral-400)` |
+| `--text-inverse` | `var(--neutral-0)` |
+| `--text-link` | `var(--accent-500)` |
+| `--border-default` | `var(--neutral-200)` |
+| `--border-strong` | `var(--neutral-300)` |
+| `--border-focus` | `var(--accent-500)` |
+| `--accent` | `var(--accent-500)` |
+| `--accent-hover` | `var(--accent-600)` |
+| `--accent-active` | `var(--accent-700)` |
+
+### Raw palette — 77 (fixed in both themes)
+
+`--neutral-0`, `--neutral-50`, `--neutral-100`, `--neutral-200`, `--neutral-300`, `--neutral-400`, `--neutral-500`, `--neutral-600`, `--neutral-700`, `--neutral-800`, `--neutral-900`, `--neutral-950`, `--accent-50`, `--accent-100`, `--accent-200`, `--accent-300`, `--accent-400`, `--accent-500`, `--accent-600`, `--accent-700`, `--accent-800`, `--success-500`, `--success-100`, `--success-700`, `--warning-500`, `--warning-100`, `--warning-700`, `--danger-500`, `--danger-100`, `--danger-700`, `--space-1`, `--space-2`, `--space-3`, `--space-4`, `--space-5`, `--space-6`, `--space-7`, `--space-8`, `--space-9`, `--space-10`, `--space-11`, `--space-12`, `--space-13`, `--space-14`, `--radius-sm`, `--radius-md`, `--radius-lg`, `--radius-xl`, `--radius-full`, `--shadow-xs`, `--shadow-sm`, `--shadow-md`, `--shadow-focus-ring`, `--shadow-danger-ring`, `--text-xs`, `--text-sm`, `--text-base`, `--text-md`, `--text-lg`, `--text-xl`, `--text-2xl`, `--text-3xl`, `--text-4xl`, `--text-5xl`, `--text-6xl`, `--lh-tight`, `--lh-snug`, `--lh-normal`, `--lh-relaxed`, `--fw-regular`, `--fw-medium`, `--fw-semibold`, `--fw-bold`, `--fw-extrabold`, `--tracking-tight`, `--tracking-normal`, `--tracking-wide`

package/dist/AI_INVENTORY.md

@@ -0,0 +1,85 @@
+<!-- Generated by scripts/generate-ai-context.mjs — do not edit by hand. -->
+# @tlglobal/ui v2.0.0 — inventory
+
+66 components, 4 hooks. Full props: `AI_CONTEXT.md` in this same
+directory, or `dist/index.d.ts`. **Only these names exist — do not invent components.**
+
+## Components
+- Accordion (Root, Item, Trigger, Content)
+- Alert
+- AlertDialog (Root, Trigger, Content, Title, Description, Footer, Action, Cancel)
+- AspectRatio
+- Attachment (Root, List, Preview, Icon, Info, Name, Meta, Remove)
+- Avatar
+- Badge
+- Breadcrumb (Root, List, Item, Link, Page, Separator)
+- Bubble
+- Button
+- ButtonGroup
+- Calendar
+- Card
+- Carousel (Root, Content, Item, Previous, Next)
+- Chart (Container, Tooltip, TooltipContent, Legend, LegendContent)
+- Checkbox
+- Collapsible (Root, Trigger, Content)
+- Combobox
+- Command (Root, Input, List, Empty, Group, Item, Separator, Dialog)
+- ContextMenu (Root, Trigger, Content, Item, CheckboxItem, RadioGroup, RadioItem, Label, Separator, Shortcut, Group, Sub, SubTrigger, SubContent)
+- DatePicker
+- Dialog (Root, Trigger, Close, Content, Title, Description, Footer)
+- Direction (Provider)
+- Drawer (Root, Trigger, Close, Content, Title, Description, Footer)
+- DropdownMenu (Root, Trigger, Content, Item, CheckboxItem, RadioGroup, RadioItem, Label, Separator, Shortcut, Group, Sub, SubTrigger, SubContent)
+- Empty
+- Field
+- HoverCard (Root, Trigger, Content)
+- IconButton
+- Input
+- InputGroup (Root, Addon, Input)
+- InputOTP (Root, Group, Slot, Separator)
+- Item
+- Kbd
+- Label
+- Marker
+- Menubar (Root, Menu, Trigger, Content, Item, CheckboxItem, RadioGroup, RadioItem, Separator, Shortcut, Group, Sub, SubTrigger, SubContent)
+- Message (Root, Avatar, Body, Header, Author, Time, Content, Actions, Footer)
+- MessageScroller (Root, Viewport, Content, JumpToLatest)
+- NativeSelect
+- NavigationMenu (Root, List, Item, Trigger, Content, Link)
+- Pagination (Root, Item, Ellipsis, Previous, Next)
+- Popover (Root, Trigger, Anchor, Content, Close)
+- Progress
+- Questionnaire (Root, Prompt, Options, Option)
+- RadioGroup
+- RadioGroupItem
+- Resizable (Group, Panel, Separator)
+- ScrollArea
+- Select
+- Separator
+- Sheet (Root, Trigger, Close, Content, Title, Description, Footer)
+- Sidebar (Provider, Root, Inset, Trigger, Rail, Header, Footer, Content, Separator, Input, Group, GroupLabel, GroupAction, GroupContent, Menu, MenuItem, MenuButton, MenuAction, MenuBadge, MenuSkeleton, MenuSub, MenuSubItem, MenuSubButton)
+- Skeleton
+- Slider
+- Spinner
+- Switch
+- Table (Root, Header, Body, Footer, Row, Head, Cell, Caption)
+- Tabs (Root, List, Trigger, Content)
+- Tag
+- Textarea
+- Toaster
+- Toggle
+- ToggleGroup
+- ToggleGroupItem
+- Tooltip
+
+## Hooks
+- useDirection()
+- useMessageScroller()
+- useSidebar()
+- useToast()
+
+## Semantic tokens (flip in dark mode — prefer these)
+--bg-page, --bg-surface, --bg-surface-hover, --bg-inverse, --text-primary, --text-secondary, --text-muted, --text-inverse, --text-link, --border-default, --border-strong, --border-focus, --accent, --accent-hover, --accent-active
+
+## Raw palette (fixed in both themes)
+--neutral-0, --neutral-50, --neutral-100, --neutral-200, --neutral-300, --neutral-400, --neutral-500, --neutral-600, --neutral-700, --neutral-800, --neutral-900, --neutral-950, --accent-50, --accent-100, --accent-200, --accent-300, --accent-400, --accent-500, --accent-600, --accent-700, --accent-800, --success-500, --success-100, --success-700, --warning-500, --warning-100, --warning-700, --danger-500, --danger-100, --danger-700, --space-1, --space-2, --space-3, --space-4, --space-5, --space-6, --space-7, --space-8, --space-9, --space-10, --space-11, --space-12, --space-13, --space-14, --radius-sm, --radius-md, --radius-lg, --radius-xl, --radius-full, --shadow-xs, --shadow-sm, --shadow-md, --shadow-focus-ring, --shadow-danger-ring, --text-xs, --text-sm, --text-base, --text-md, --text-lg, --text-xl, --text-2xl, --text-3xl, --text-4xl, --text-5xl, --text-6xl, --lh-tight, --lh-snug, --lh-normal, --lh-relaxed, --fw-regular, --fw-medium, --fw-semibold, --fw-bold, --fw-extrabold, --tracking-tight, --tracking-normal, --tracking-wide