@signal9/era-ui 26.1.1 → 28.0.0

package/dist/generated-docs/llms-full.txt

@@ -86,7 +86,7 @@ Classes, not components — they need no import beyond the stylesheet. Reach for
 - `bg-well · text-well · border-well · bg-elevated · text-elevated · border-elevated · bg-highlight · text-highlight · … (12 in all)` — Surface fills — bg-well is the surface's own resting fill (pairs with
 - `p-gutter · px-gutter · py-gutter · gap-gutter · p-panel · px-panel · py-panel · gap-panel · … (24 in all)` — THE SPACING SCALE — one entry per token, from which Tailwind derives the
 - `p-inset-pill · px-inset-pill · py-inset-pill · gap-inset-pill · p-inset-chip · px-inset-chip · py-inset-chip · gap-inset-chip · … (12 in all)` — text-symmetric content padding — (tier − text)/2, the inset that vertically centres body text in its tier; px-inset-control is a text button's side padding, p-inset-control a code block's.
-- `p-icon-inset-pill · px-icon-inset-pill · py-icon-inset-pill · gap-icon-inset-pill · p-icon-inset-chip · px-icon-inset-chip · py-icon-inset-chip · gap-icon-inset-chip · … (32 in all)` — the concentric inset for a nested pair — (h-container − h-child)/2, the gap that makes a child control sit evenly inside its container, and the radius step that keeps their corners concentric. Named for the pair it joins: gap-icon-inset-control seats an icon in a control.
+- `p-icon-inset-pill · px-icon-inset-pill · py-icon-inset-pill · gap-icon-inset-pill · p-icon-inset-chip · px-icon-inset-chip · py-icon-inset-chip · gap-icon-inset-chip · … (36 in all)` — the concentric inset for a nested pair — (h-container − h-child)/2, the gap that makes a child control sit evenly inside its container, and the radius step that keeps their corners concentric. Named for the pair it joins: gap-icon-inset-control seats an icon in a control.
 - `p-glyph-icon · px-glyph-icon · py-glyph-icon · gap-glyph-icon · p-glyph-pill · px-glyph-pill · py-glyph-pill · gap-glyph-pill` — the glyph size for a tier — the INK inside the box, not the box (size-glyph-pill is the dismiss × in a pill, size-pill is the pill).
 - `bg-field · text-field · border-field · bg-field-highlight · text-field-highlight · border-field-highlight` — the recessed field fill — bg-field is a text input's resting well, bg-field-highlight its focused/hovered face.
 - `ease-base` — Motion — bare transition utilities default to the motion axis, so
@@ -105,6 +105,14 @@ What era ui is — density, surface, corners, type, and colour as orthogonal axe
 
 <!-- end: getting-started -->
 
+<!-- begin: todo -->
+
+# Todo
+
+An agent's plan board — a collapsible checklist whose header still shows the active item.
+
+<!-- end: todo -->
+
 <!-- begin: spacing -->
 
 # Spacing
@@ -233,7 +241,7 @@ source uses it where a name exists.
 | `bg-well` `text-well` `border-well` `bg-elevated` `text-elevated` `border-elevated` `bg-highlight` `text-highlight` `border-highlight` `bg-overlay` `text-overlay` `border-overlay` | — |
 | `p-gutter` `px-gutter` `py-gutter` `gap-gutter` `p-panel` `px-panel` `py-panel` `gap-panel` `p-card` `px-card` `py-card` `gap-card` `p-content` `px-content` `py-content` `gap-content` `p-menu` `px-menu` `py-menu` `gap-menu` `p-field` `px-field` `py-field` `gap-field` | — |
 | `p-inset-pill` `px-inset-pill` `py-inset-pill` `gap-inset-pill` `p-inset-chip` `px-inset-chip` `py-inset-chip` `gap-inset-chip` `p-inset-control` `px-inset-control` `py-inset-control` `gap-inset-control` | text-symmetric content padding — (tier − text)/2, the inset that vertically centres body text in its tier; px-inset-control is a text button's side padding, p-inset-control a code block's. |
-| `p-icon-inset-pill` `px-icon-inset-pill` `py-icon-inset-pill` `gap-icon-inset-pill` `p-icon-inset-chip` `px-icon-inset-chip` `py-icon-inset-chip` `gap-icon-inset-chip` `p-icon-inset-control` `px-icon-inset-control` `py-icon-inset-control` `gap-icon-inset-control` `p-icon-inset-bar` `px-icon-inset-bar` `py-icon-inset-bar` `gap-icon-inset-bar` `p-pill-inset-chip` `px-pill-inset-chip` `py-pill-inset-chip` `gap-pill-inset-chip` `p-pill-inset-control` `px-pill-inset-control` `py-pill-inset-control` `gap-pill-inset-control` `p-chip-inset-control` `px-chip-inset-control` `py-chip-inset-control` `gap-chip-inset-control` `p-chip-inset-bar` `px-chip-inset-bar` `py-chip-inset-bar` `gap-chip-inset-bar` | the concentric inset for a nested pair — (h-container − h-child)/2, the gap that makes a child control sit evenly inside its container, and the radius step that keeps their corners concentric. Named for the pair it joins: gap-icon-inset-control seats an icon in a control. |
+| `p-icon-inset-pill` `px-icon-inset-pill` `py-icon-inset-pill` `gap-icon-inset-pill` `p-icon-inset-chip` `px-icon-inset-chip` `py-icon-inset-chip` `gap-icon-inset-chip` `p-icon-inset-control` `px-icon-inset-control` `py-icon-inset-control` `gap-icon-inset-control` `p-icon-inset-bar` `px-icon-inset-bar` `py-icon-inset-bar` `gap-icon-inset-bar` `p-pill-inset-chip` `px-pill-inset-chip` `py-pill-inset-chip` `gap-pill-inset-chip` `p-pill-inset-control` `px-pill-inset-control` `py-pill-inset-control` `gap-pill-inset-control` `p-pill-inset-bar` `px-pill-inset-bar` `py-pill-inset-bar` `gap-pill-inset-bar` `p-chip-inset-control` `px-chip-inset-control` `py-chip-inset-control` `gap-chip-inset-control` `p-chip-inset-bar` `px-chip-inset-bar` `py-chip-inset-bar` `gap-chip-inset-bar` | the concentric inset for a nested pair — (h-container − h-child)/2, the gap that makes a child control sit evenly inside its container, and the radius step that keeps their corners concentric. Named for the pair it joins: gap-icon-inset-control seats an icon in a control. |
 | `p-glyph-icon` `px-glyph-icon` `py-glyph-icon` `gap-glyph-icon` `p-glyph-pill` `px-glyph-pill` `py-glyph-pill` `gap-glyph-pill` | the glyph size for a tier — the INK inside the box, not the box (size-glyph-pill is the dismiss × in a pill, size-pill is the pill). |
 | `bg-field` `text-field` `border-field` `bg-field-highlight` `text-field-highlight` `border-field-highlight` | the recessed field fill — bg-field is a text input's resting well, bg-field-highlight its focused/hovered face. |
 | `ease-base` | — |
@@ -1107,7 +1115,7 @@ Declared in `index.css`.
 }
 ```
 
-## p-icon-inset-pill · px-icon-inset-pill · py-icon-inset-pill · gap-icon-inset-pill · p-icon-inset-chip · px-icon-inset-chip · py-icon-inset-chip · gap-icon-inset-chip · … (32 in all)
+## p-icon-inset-pill · px-icon-inset-pill · py-icon-inset-pill · gap-icon-inset-pill · p-icon-inset-chip · px-icon-inset-chip · py-icon-inset-chip · gap-icon-inset-chip · … (36 in all)
 
 **Use it for:** the concentric inset for a nested pair — (h-container − h-child)/2, the gap that makes a child control sit evenly inside its container, and the radius step that keeps their corners concentric. Named for the pair it joins: gap-icon-inset-control seats an icon in a control.
 
@@ -1121,6 +1129,7 @@ Declared in `index.css`.
 	--spacing-icon-inset-bar: var(--era-icon-inset-bar);
 	--spacing-pill-inset-chip: var(--era-pill-inset-chip);
 	--spacing-pill-inset-control: var(--era-pill-inset-control);
+	--spacing-pill-inset-bar: var(--era-pill-inset-bar);
 	--spacing-chip-inset-control: var(--era-chip-inset-control);
 	--spacing-chip-inset-bar: var(--era-chip-inset-bar);
 }
@@ -1491,6 +1500,72 @@ the compact pairing (pills/fields in an sm or md bar). |
 
 <!-- end: bar -->
 
+<!-- begin: nav -->
+
+# Nav
+
+A navigation landmark and its items — the current one announces itself, and that announcement is what paints it.
+
+## Import
+
+```ts
+import * as Nav from "@signal9/era-ui/nav";
+```
+
+Composed from sub-components — compose explicitly at the call site:
+
+- `Nav.Bar`
+- `Nav.Item`
+
+## Nav.Bar
+
+Inherits all props from `HTMLAttributes<HTMLElement>`.
+
+| Prop | Type | Default | Notes |
+|------|------|---------|-------|
+| `ref?` | `HTMLElement \| null` | `null` | bindable |
+| `size?` | `'chip' \| 'control' \| 'bar'` | `'bar'` | Height tier, exactly as Bar's — the geometry is Bar's, not a second copy. |
+| `content?` | `'tier' \| 'pill'` | `'tier'` | Tier of the items inside, so the wall stays concentric to them. |
+| `divider?` | `boolean` | `false` | Draw Bar's flush cap-a-panel rule beneath the bar. Off by default,
+because a nav that sits in a page already has whatever separation the
+layout gives it — and a link-variant nav in particular reads as text,
+where an unasked-for rule is chrome. Turn it on rather than reaching for
+a Separator underneath, so the line is the bar's own and stays with it. |
+| `label?` | `string` | `'Main'` | The accessible name for this landmark. A page may hold several
+navigations (primary, breadcrumb, pagination, footer) and a screen
+reader lists them all by name — unnamed, they read as "navigation",
+"navigation", "navigation". Defaults to "Main" rather than nothing so
+the common case is named without anyone having to know this. |
+| `children?` | `Snippet` | — | — |
+
+## Nav.Item
+
+Inherits all props from `HTMLAnchorAttributes`.
+
+| Prop | Type | Default | Notes |
+|------|------|---------|-------|
+| `ref?` | `HTMLAnchorElement \| null` | `null` | bindable |
+| `href` | `string` | — | — |
+| `variant?` | `'filled' \| 'link'` | `'filled'` | `filled` (default) is a control on a rung — a bar of buttons. `link`
+drops the chrome entirely and renders running text, for a primary nav
+that should read as links rather than a row of raised keycaps. Existing
+bars are byte-identical. |
+| `current?` | `boolean` | `false` | Whether this item points at the page you are on.
+There is deliberately no `active` prop beside this one. `active` would
+be a second source of truth for one fact, and the two drift the moment
+a route changes and someone updates the styling flag but not the
+announcement — leaving a tab that LOOKS current to sighted users and
+announces nothing to a screen reader, or the reverse. This sets
+`aria-current="page"`, and the styling below keys off that attribute,
+so the look and the announcement cannot disagree: there is one fact
+and it is the accessible one. |
+| `size?` | `'control' \| 'chip' \| 'pill' \| 'icon'` | `'control'` | Tier, matching Button's rungs so an item nests in a bar the same way. |
+| `lead?` | `Snippet` | — | Icon before the label, outside it — same contract as Button's. |
+| `trail?` | `Snippet` | — | Icon after the label, outside it. |
+| `children?` | `Snippet` | — | — |
+
+<!-- end: nav -->
+
 <!-- begin: button -->
 
 # Button
@@ -1988,7 +2063,7 @@ Inherits all props from `Accordion.HeaderProps`.
 
 ## Accordion.Trigger
 
-Inherits all props from `PartProps<Accordion.TriggerProps>`.
+Inherits all props from `OwnedPartProps<Accordion.TriggerProps>`.
 
 | Prop | Type | Default | Notes |
 |------|------|---------|-------|
@@ -2018,6 +2093,7 @@ import * as AlertDialog from "@signal9/era-ui/alert-dialog";
 
 Composed from sub-components — compose explicitly at the call site:
 
+- `AlertDialog.Root`
 - `AlertDialog.Trigger`
 - `AlertDialog.Content`
 - `AlertDialog.Overlay`
@@ -2026,6 +2102,15 @@ Composed from sub-components — compose explicitly at the call site:
 - `AlertDialog.Cancel`
 - `AlertDialog.Action`
 
+## AlertDialog.Root
+
+Inherits all props from `AlertDialog.RootProps`.
+
+| Prop | Type | Default | Notes |
+|------|------|---------|-------|
+| `children?` | `Snippet` | — | — |
+| `open?` | `(forwarded)` | `false` | bindable |
+
 ## AlertDialog.Trigger
 
 Inherits all props from `WithoutChildrenOrChild<AlertDialog.TriggerProps>`.
@@ -2038,7 +2123,7 @@ Inherits all props from `ButtonVariants`.
 
 ## AlertDialog.Content
 
-Inherits all props from `PartProps<AlertDialog.ContentProps>`.
+Inherits all props from `OwnedPartProps<AlertDialog.ContentProps>`.
 
 | Prop | Type | Default | Notes |
 |------|------|---------|-------|
@@ -2335,7 +2420,7 @@ Inherits all props from `Combobox.InputProps`.
 
 ## Combobox.Trigger
 
-Inherits all props from `PartProps<Combobox.TriggerProps>`.
+Inherits all props from `OwnedPartProps<Combobox.TriggerProps>`.
 
 | Prop | Type | Default | Notes |
 |------|------|---------|-------|
@@ -2552,7 +2637,7 @@ Inherits all props from `Collapsible.RootProps`.
 
 ## Step.Summary
 
-Inherits all props from `PartProps<Collapsible.TriggerProps>`.
+Inherits all props from `OwnedPartProps<Collapsible.TriggerProps>`.
 
 | Prop | Type | Default | Notes |
 |------|------|---------|-------|
@@ -2560,7 +2645,7 @@ Inherits all props from `PartProps<Collapsible.TriggerProps>`.
 
 ## Step.Content
 
-Inherits all props from `PartProps<Collapsible.ContentProps>`.
+Inherits all props from `OwnedPartProps<Collapsible.ContentProps>`.
 
 | Prop | Type | Default | Notes |
 |------|------|---------|-------|
@@ -2591,6 +2676,7 @@ import * as ContextMenu from "@signal9/era-ui/context-menu";
 
 Composed from sub-components — compose explicitly at the call site:
 
+- `ContextMenu.Root`
 - `ContextMenu.Trigger`
 - `ContextMenu.Content`
 - `ContextMenu.Item`
@@ -2601,6 +2687,15 @@ Composed from sub-components — compose explicitly at the call site:
 - `ContextMenu.SubContent`
 - `ContextMenu.GroupHeading`
 
+## ContextMenu.Root
+
+Inherits all props from `ContextMenu.RootProps`.
+
+| Prop | Type | Default | Notes |
+|------|------|---------|-------|
+| `children?` | `Snippet` | — | — |
+| `open?` | `(forwarded)` | `false` | bindable |
+
 ## ContextMenu.Trigger
 
 Inherits all props from `ContextMenu.TriggerProps`.
@@ -2611,7 +2706,7 @@ Inherits all props from `ContextMenu.TriggerProps`.
 
 ## ContextMenu.Content
 
-Inherits all props from `PartProps<ContextMenu.ContentProps>`.
+Inherits all props from `OwnedPartProps<ContextMenu.ContentProps>`.
 
 | Prop | Type | Default | Notes |
 |------|------|---------|-------|
@@ -2652,7 +2747,7 @@ Inherits all props from `ContextMenu.SeparatorProps`.
 
 ## ContextMenu.SubTrigger
 
-Inherits all props from `PartProps<ContextMenu.SubTriggerProps>`.
+Inherits all props from `OwnedPartProps<ContextMenu.SubTriggerProps>`.
 
 | Prop | Type | Default | Notes |
 |------|------|---------|-------|
@@ -2660,7 +2755,7 @@ Inherits all props from `PartProps<ContextMenu.SubTriggerProps>`.
 
 ## ContextMenu.SubContent
 
-Inherits all props from `PartProps<ContextMenu.SubContentProps>`.
+Inherits all props from `OwnedPartProps<ContextMenu.SubContentProps>`.
 
 | Prop | Type | Default | Notes |
 |------|------|---------|-------|
@@ -2799,7 +2894,7 @@ Inherits all props from `DatePicker.SegmentProps`.
 
 ## DatePicker.Trigger
 
-Inherits all props from `PartProps<DatePicker.TriggerProps>`.
+Inherits all props from `OwnedPartProps<DatePicker.TriggerProps>`.
 
 | Prop | Type | Default | Notes |
 |------|------|---------|-------|
@@ -3039,7 +3134,7 @@ Inherits all props from `DateRangePicker.SegmentProps`.
 
 ## DateRangePicker.Trigger
 
-Inherits all props from `PartProps<DateRangePicker.TriggerProps>`.
+Inherits all props from `OwnedPartProps<DateRangePicker.TriggerProps>`.
 
 | Prop | Type | Default | Notes |
 |------|------|---------|-------|
@@ -3169,6 +3264,7 @@ import * as Dialog from "@signal9/era-ui/dialog";
 
 Composed from sub-components — compose explicitly at the call site:
 
+- `Dialog.Root`
 - `Dialog.Trigger`
 - `Dialog.Content`
 - `Dialog.Overlay`
@@ -3177,6 +3273,15 @@ Composed from sub-components — compose explicitly at the call site:
 - `Dialog.Close`
 - `Dialog.Header`
 
+## Dialog.Root
+
+Inherits all props from `Dialog.RootProps`.
+
+| Prop | Type | Default | Notes |
+|------|------|---------|-------|
+| `children?` | `Snippet` | — | — |
+| `open?` | `(forwarded)` | `false` | bindable |
+
 ## Dialog.Trigger
 
 Inherits all props from `WithoutChildrenOrChild<Dialog.TriggerProps>`.
@@ -3189,7 +3294,7 @@ Inherits all props from `ButtonVariants`.
 
 ## Dialog.Content
 
-Inherits all props from `PartProps<Dialog.ContentProps>`.
+Inherits all props from `OwnedPartProps<Dialog.ContentProps>`.
 
 | Prop | Type | Default | Notes |
 |------|------|---------|-------|
@@ -3258,6 +3363,7 @@ import * as DropdownMenu from "@signal9/era-ui/dropdown-menu";
 
 Composed from sub-components — compose explicitly at the call site:
 
+- `DropdownMenu.Root`
 - `DropdownMenu.Trigger`
 - `DropdownMenu.Content`
 - `DropdownMenu.Item`
@@ -3268,9 +3374,18 @@ Composed from sub-components — compose explicitly at the call site:
 - `DropdownMenu.SubContent`
 - `DropdownMenu.GroupHeading`
 
+## DropdownMenu.Root
+
+Inherits all props from `DropdownMenu.RootProps`.
+
+| Prop | Type | Default | Notes |
+|------|------|---------|-------|
+| `children?` | `Snippet` | — | — |
+| `open?` | `(forwarded)` | `false` | bindable |
+
 ## DropdownMenu.Trigger
 
-Inherits all props from `PartProps<DropdownMenu.TriggerProps>`.
+Inherits all props from `OwnedPartProps<DropdownMenu.TriggerProps>`.
 
 | Prop | Type | Default | Notes |
 |------|------|---------|-------|
@@ -3278,7 +3393,7 @@ Inherits all props from `PartProps<DropdownMenu.TriggerProps>`.
 
 ## DropdownMenu.Content
 
-Inherits all props from `PartProps<DropdownMenu.ContentProps>`.
+Inherits all props from `OwnedPartProps<DropdownMenu.ContentProps>`.
 
 | Prop | Type | Default | Notes |
 |------|------|---------|-------|
@@ -3319,7 +3434,7 @@ Inherits all props from `DropdownMenu.SeparatorProps`.
 
 ## DropdownMenu.SubTrigger
 
-Inherits all props from `PartProps<DropdownMenu.SubTriggerProps>`.
+Inherits all props from `OwnedPartProps<DropdownMenu.SubTriggerProps>`.
 
 | Prop | Type | Default | Notes |
 |------|------|---------|-------|
@@ -3327,7 +3442,7 @@ Inherits all props from `PartProps<DropdownMenu.SubTriggerProps>`.
 
 ## DropdownMenu.SubContent
 
-Inherits all props from `PartProps<DropdownMenu.SubContentProps>`.
+Inherits all props from `OwnedPartProps<DropdownMenu.SubContentProps>`.
 
 | Prop | Type | Default | Notes |
 |------|------|---------|-------|
@@ -3478,9 +3593,19 @@ import * as LinkPreview from "@signal9/era-ui/link-preview";
 
 Composed from sub-components — compose explicitly at the call site:
 
+- `LinkPreview.Root`
 - `LinkPreview.Trigger`
 - `LinkPreview.Content`
 
+## LinkPreview.Root
+
+Inherits all props from `LinkPreview.RootProps`.
+
+| Prop | Type | Default | Notes |
+|------|------|---------|-------|
+| `children?` | `Snippet` | — | — |
+| `open?` | `(forwarded)` | `false` | bindable |
+
 ## LinkPreview.Trigger
 
 Inherits all props from `PartProps<LinkPreview.TriggerProps>`.
@@ -3491,7 +3616,7 @@ Inherits all props from `PartProps<LinkPreview.TriggerProps>`.
 
 ## LinkPreview.Content
 
-Inherits all props from `PartProps<LinkPreview.ContentProps>`.
+Inherits all props from `OwnedPartProps<LinkPreview.ContentProps>`.
 
 | Prop | Type | Default | Notes |
 |------|------|---------|-------|
@@ -3598,6 +3723,7 @@ Inherits all props from `Menubar.RootProps`.
 | Prop | Type | Default | Notes |
 |------|------|---------|-------|
 | `ref?` | `(forwarded)` | `null` | bindable |
+| `value?` | `(forwarded)` | `''` | bindable |
 
 ## Menubar.Trigger
 
@@ -3609,7 +3735,7 @@ Inherits all props from `PartProps<Menubar.TriggerProps>`.
 
 ## Menubar.Content
 
-Inherits all props from `PartProps<Menubar.ContentProps>`.
+Inherits all props from `OwnedPartProps<Menubar.ContentProps>`.
 
 | Prop | Type | Default | Notes |
 |------|------|---------|-------|
@@ -3650,7 +3776,7 @@ Inherits all props from `Menubar.SeparatorProps`.
 
 ## Menubar.SubTrigger
 
-Inherits all props from `PartProps<Menubar.SubTriggerProps>`.
+Inherits all props from `OwnedPartProps<Menubar.SubTriggerProps>`.
 
 | Prop | Type | Default | Notes |
 |------|------|---------|-------|
@@ -3658,7 +3784,7 @@ Inherits all props from `PartProps<Menubar.SubTriggerProps>`.
 
 ## Menubar.SubContent
 
-Inherits all props from `PartProps<Menubar.SubContentProps>`.
+Inherits all props from `OwnedPartProps<Menubar.SubContentProps>`.
 
 | Prop | Type | Default | Notes |
 |------|------|---------|-------|
@@ -3692,6 +3818,12 @@ Inherits all props from `Meter.RootProps`.
 
 | Prop | Type | Default | Notes |
 |------|------|---------|-------|
+| `tone?` | `'default' \| 'accent' \| 'destructive' \| 'success' \| 'warning'` | `'default'` | The band this reading falls in. Tone is the fill's colour only — the
+track stays neutral, because the well belongs to the control and the
+fill belongs to the value.
+Tone carries no semantics on its own: a meter in the destructive band
+still needs an accessible label saying what has run out. Pair it with
+`aria-label` / a visible label, never rely on the hue alone. |
 | `ref?` | `(forwarded)` | `null` | bindable |
 
 <!-- end: meter -->
@@ -4018,7 +4150,7 @@ Composed from sub-components — compose explicitly at the call site:
 
 ## Select.Trigger
 
-Inherits all props from `PartProps<Select.TriggerProps>`.
+Inherits all props from `OwnedPartProps<Select.TriggerProps>`.
 
 | Prop | Type | Default | Notes |
 |------|------|---------|-------|
@@ -4035,7 +4167,7 @@ Inherits all props from `WithoutChildrenOrChild<Select.ValueProps>`.
 
 ## Select.Content
 
-Inherits all props from `PartProps<Select.ContentProps>`.
+Inherits all props from `OwnedPartProps<Select.ContentProps>`.
 
 | Prop | Type | Default | Notes |
 |------|------|---------|-------|
@@ -4446,6 +4578,7 @@ Inherits all props from `PartProps<ToggleGroup.RootProps>`.
 
 | Prop | Type | Default | Notes |
 |------|------|---------|-------|
+| `variant?` | `ToggleGroupVariant` | `'plain'` | — |
 | `ref?` | `(forwarded)` | `null` | bindable |
 
 ## ToggleGroup.Item
@@ -4458,6 +4591,84 @@ Inherits all props from `ToggleGroup.ItemProps`.
 
 <!-- end: toggle-group -->
 
+<!-- begin: timeline -->
+
+# Timeline
+
+A staged progress bar where each segment's width is how long that step took.
+
+## Import
+
+```ts
+import * as Timeline from "@signal9/era-ui/timeline";
+```
+
+Composed from sub-components — compose explicitly at the call site:
+
+- `Timeline.Root`
+- `Timeline.Step`
+
+## Timeline.Root
+
+| Prop | Type | Default | Notes |
+|------|------|---------|-------|
+| `steps?` | `TimelineStep[]` | `[]` | — |
+| `tick?` | `number` | `100` | Live counter interval in ms. 0 stops the clock (the counter freezes). |
+| `showClock?` | `boolean` | `true` | — |
+| `children?` | `Snippet` | — | — |
+| `class?` | `string` | — | — |
+
+## Timeline.Step
+
+| Prop | Type | Default | Notes |
+|------|------|---------|-------|
+| `step` | `TimelineStep` | — | — |
+| `showClock?` | `boolean` | `true` | — |
+| `class?` | `string` | — | — |
+
+<!-- end: timeline -->
+
+<!-- begin: tree -->
+
+# Tree
+
+A disclosure hierarchy with real tree semantics — roving focus, and selection separate from expansion.
+
+## Import
+
+```ts
+import * as Tree from "@signal9/era-ui/tree";
+```
+
+Composed from sub-components — compose explicitly at the call site:
+
+- `Tree.Root`
+- `Tree.Item`
+
+## Tree.Root
+
+Inherits all props from `HTMLAttributes<HTMLUListElement>`.
+
+| Prop | Type | Default | Notes |
+|------|------|---------|-------|
+| `ref?` | `HTMLUListElement \| null` | `null` | bindable |
+| `nodes?` | `TreeNode[]` | `[]` | — |
+| `expanded?` | `string[]` | `[]` | bindable — Controlled: bind it, or drive it from the URL. |
+| `selected?` | `string \| null` | `null` | bindable |
+| `label?` | `string` | `'Tree'` | Accessible name for the tree landmark. |
+| `item?` | `Snippet<[FlatNode]>` | — | Render your own row. Omitted, the default row is used. |
+| `trailing?` | `Snippet<[FlatNode]>` | — | End-of-row slot on the default row — a count badge, a status dot. |
+
+## Tree.Item
+
+| Prop | Type | Default | Notes |
+|------|------|---------|-------|
+| `item` | `FlatNode` | — | — |
+| `trailing?` | `Snippet<[FlatNode]>` | — | Rendered at the end of the row — a count badge, a status dot. |
+| `class?` | `string` | — | — |
+
+<!-- end: tree -->
+
 <!-- begin: toolbar -->
 
 # Toolbar
@@ -4566,9 +4777,19 @@ import * as Tooltip from "@signal9/era-ui/tooltip";
 
 Composed from sub-components — compose explicitly at the call site:
 
+- `Tooltip.Root`
 - `Tooltip.Trigger`
 - `Tooltip.Content`
 
+## Tooltip.Root
+
+Inherits all props from `Tooltip.RootProps`.
+
+| Prop | Type | Default | Notes |
+|------|------|---------|-------|
+| `children?` | `Snippet` | — | — |
+| `open?` | `(forwarded)` | `false` | bindable |
+
 ## Tooltip.Trigger
 
 Inherits all props from `Tooltip.TriggerProps`.
@@ -4579,7 +4800,7 @@ Inherits all props from `Tooltip.TriggerProps`.
 
 ## Tooltip.Content
 
-Inherits all props from `PartProps<Tooltip.ContentProps>`.
+Inherits all props from `OwnedPartProps<Tooltip.ContentProps>`.
 
 | Prop | Type | Default | Notes |
 |------|------|---------|-------|

package/dist/generated-docs/llms.txt

@@ -86,7 +86,7 @@ Full concatenated reference: `{{ORIGIN}}/llms-full.txt`.
 
 ## Components
 
-getting-started, spacing, surfaces, measurements, text, utilities, draggable, os, changelog, llm-shell, notes, aspect-ratio, badge, avatar, bar, button, button-group, pane, card, chip, code-block, copy-button, cycle, kv, separator, sheet, skeleton, switch, toggle, accordion, alert-dialog, calendar, checkbox, collapsible, combobox, command, command-bar, step, context-menu, date-field, date-picker, date-range-field, date-range-picker, dialog, dropdown-menu, file-upload, scroll-area, input, link-preview, label, logo, menu, menubar, meter, navigation-menu, mode, pagination, pin-input, popover, progress, range-calendar, radio-group, rating-group, select, slider, table, tabs, time-field, time-range-field, toggle-group, toolbar, video-player, tooltip
+getting-started, todo, spacing, surfaces, measurements, text, utilities, draggable, os, changelog, llm-shell, notes, aspect-ratio, badge, avatar, bar, nav, button, button-group, pane, card, chip, code-block, copy-button, cycle, kv, separator, sheet, skeleton, switch, toggle, accordion, alert-dialog, calendar, checkbox, collapsible, combobox, command, command-bar, step, context-menu, date-field, date-picker, date-range-field, date-range-picker, dialog, dropdown-menu, file-upload, scroll-area, input, link-preview, label, logo, menu, menubar, meter, navigation-menu, mode, pagination, pin-input, popover, progress, range-calendar, radio-group, rating-group, select, slider, table, tabs, time-field, time-range-field, toggle-group, timeline, tree, toolbar, video-player, tooltip
 
 ## CSS utilities
 
@@ -124,7 +124,7 @@ Classes, not components — they need no import beyond the stylesheet. Reach for
 - `bg-well · text-well · border-well · bg-elevated · text-elevated · border-elevated · bg-highlight · text-highlight · … (12 in all)` — Surface fills — bg-well is the surface's own resting fill (pairs with
 - `p-gutter · px-gutter · py-gutter · gap-gutter · p-panel · px-panel · py-panel · gap-panel · … (24 in all)` — THE SPACING SCALE — one entry per token, from which Tailwind derives the
 - `p-inset-pill · px-inset-pill · py-inset-pill · gap-inset-pill · p-inset-chip · px-inset-chip · py-inset-chip · gap-inset-chip · … (12 in all)` — text-symmetric content padding — (tier − text)/2, the inset that vertically centres body text in its tier; px-inset-control is a text button's side padding, p-inset-control a code block's.
-- `p-icon-inset-pill · px-icon-inset-pill · py-icon-inset-pill · gap-icon-inset-pill · p-icon-inset-chip · px-icon-inset-chip · py-icon-inset-chip · gap-icon-inset-chip · … (32 in all)` — the concentric inset for a nested pair — (h-container − h-child)/2, the gap that makes a child control sit evenly inside its container, and the radius step that keeps their corners concentric. Named for the pair it joins: gap-icon-inset-control seats an icon in a control.
+- `p-icon-inset-pill · px-icon-inset-pill · py-icon-inset-pill · gap-icon-inset-pill · p-icon-inset-chip · px-icon-inset-chip · py-icon-inset-chip · gap-icon-inset-chip · … (36 in all)` — the concentric inset for a nested pair — (h-container − h-child)/2, the gap that makes a child control sit evenly inside its container, and the radius step that keeps their corners concentric. Named for the pair it joins: gap-icon-inset-control seats an icon in a control.
 - `p-glyph-icon · px-glyph-icon · py-glyph-icon · gap-glyph-icon · p-glyph-pill · px-glyph-pill · py-glyph-pill · gap-glyph-pill` — the glyph size for a tier — the INK inside the box, not the box (size-glyph-pill is the dismiss × in a pill, size-pill is the pill).
 - `bg-field · text-field · border-field · bg-field-highlight · text-field-highlight · border-field-highlight` — the recessed field fill — bg-field is a text input's resting well, bg-field-highlight its focused/hovered face.
 - `ease-base` — Motion — bare transition utilities default to the motion axis, so