@actioneer/ads 0.6.0 → 0.8.0

package/llms.txt

@@ -16,47 +16,62 @@
 ## Tokens
 
 Reference semantic roles, never raw color/dimension literals (ads-lint rejects literals). Each role produces `bg-/text-/border-<role>` utilities:
-- `background`
-- `foreground`
-- `primary` — Text hierarchy — three accessible levels (all ≥ AA on --background)
-- `secondary` — Text hierarchy — three accessible levels (all ≥ AA on --background)
-- `tertiary` — Text hierarchy — three accessible levels (all ≥ AA on --background)
-- `surface`
-- `surface-foreground`
-- `elevated`
-- `muted`
-- `muted-foreground`
-- `card`
-- `card-foreground`
+- `background` — The shell canvas and its ink: the ground between top-level panels.
+- `foreground` — The shell canvas and its ink: the ground between top-level panels.
+- `on-white-primary` — Contextual text hierarchies — three accessible levels per surface.
+- `on-white-secondary` — Contextual text hierarchies — three accessible levels per surface.
+- `on-white-tertiary` — Contextual text hierarchies — three accessible levels per surface.
+- `on-warm-grey-primary` — Contextual text hierarchies — three accessible levels per surface.
+- `on-warm-grey-secondary` — Contextual text hierarchies — three accessible levels per surface.
+- `on-warm-grey-tertiary` — Contextual text hierarchies — three accessible levels per surface.
+- `primary` — Context-free compatibility aliases remain conservative.
+- `secondary` — Context-free compatibility aliases remain conservative.
+- `tertiary` — Context-free compatibility aliases remain conservative.
+- `surface` — One continuous recess inside a white surface, never a screen-level ground.
+- `surface-foreground` — One continuous recess inside a white surface, never a screen-level ground.
+- `elevated` — One continuous recess inside a white surface, never a screen-level ground.
+- `muted` — The hover and row-state wash: interaction, not a default item background.
+- `muted-foreground` — The hover and row-state wash: interaction, not a default item background.
+- `card` — The white working plane that sits on the canvas, and the specimen hairline.
+- `card-foreground` — The white working plane that sits on the canvas, and the specimen hairline.
+- `specimen-stroke` — The white working plane that sits on the canvas, and the specimen hairline.
 - `action-primary` — Primary CTA role — restrained Studio green, used sparingly.
 - `action-primary-foreground` — Primary CTA role — restrained Studio green, used sparingly.
 - `action-primary-hover` — Primary CTA role — restrained Studio green, used sparingly.
+- `action-primary-text` — Primary CTA role — restrained Studio green, used sparingly.
+- `action-primary-soft` — Primary CTA role — restrained Studio green, used sparingly.
+- `field-focus` — Primary CTA role — restrained Studio green, used sparingly.
 - `brand` — Compatibility action role — neutral ink, never a colored primary hue.
 - `brand-foreground` — Compatibility action role — neutral ink, never a colored primary hue.
 - `brand-hover` — Compatibility action role — neutral ink, never a colored primary hue.
 - `brand-text` — Compatibility action role — neutral ink, never a colored primary hue.
-- `fill` — Quiet fill — secondary buttons, avatars, chips
-- `fill-foreground` — Quiet fill — secondary buttons, avatars, chips
-- `table-shell` — Quiet fill — secondary buttons, avatars, chips
-- `artifact-canvas`
-- `accent`
-- `accent-foreground`
-- `success` — success-700 on white = 5.48:1 (600 was 3.77:1, failed AA).
-- `success-foreground` — success-700 on white = 5.48:1 (600 was 3.77:1, failed AA).
-- `warning` — Amber-500 fill kept (it IS the caution signal); dark ink foreground
-- `warning-foreground` — Amber-500 fill kept (it IS the caution signal); dark ink foreground
-- `danger` — Amber-500 fill kept (it IS the caution signal); dark ink foreground
-- `danger-foreground` — Amber-500 fill kept (it IS the caution signal); dark ink foreground
-- `info` — Amber-500 fill kept (it IS the caution signal); dark ink foreground
-- `info-foreground` — Amber-500 fill kept (it IS the caution signal); dark ink foreground
-- `border-primary`
-- `border-secondary`
-- `border-tertiary`
-- `border`
-- `border-strong`
-- `input`
-- `ring`
-- `overlay`
+- `fill` — Quiet fill — avatars, chips, and disabled controls
+- `fill-foreground` — Quiet fill — avatars, chips, and disabled controls
+- `table-shell` — Table surfaces: the white tray, its hairlines, and header ink.
+- `table-stroke` — Table surfaces: the white tray, its hairlines, and header ink.
+- `table-header-foreground` — Table surfaces: the white tray, its hairlines, and header ink.
+- `artifact-canvas` — The artifact sheet: white warmed by a trace of the brand mark.
+- `accent` — The active and selected wash, one step above hover.
+- `accent-foreground` — The active and selected wash, one step above hover.
+- `success` — Lichen success-700 clears AA on White and both success soft fills; success-600 is reserved for non-text marks because its 3.73:1 contrast on White does not clear body-text AA.
+- `success-foreground` — Lichen success-700 clears AA on White and both success soft fills; success-600 is reserved for non-text marks because its 3.73:1 contrast on White does not clear body-text AA.
+- `warning` — Amber-500 fill kept (it IS the caution signal); dark ink foreground instead of white = 6.94:1 (white on amber was 2.35:1, failed even 3:1).
+- `warning-foreground` — Amber-500 fill kept (it IS the caution signal); dark ink foreground instead of white = 6.94:1 (white on amber was 2.35:1, failed even 3:1).
+- `danger` — Danger and info: solid semantic fills carrying white foregrounds.
+- `danger-foreground` — Danger and info: solid semantic fills carrying white foregrounds.
+- `info` — Danger and info: solid semantic fills carrying white foregrounds.
+- `info-foreground` — Danger and info: solid semantic fills carrying white foregrounds.
+- `border-primary` — The neutral stroke ladder: every 1px UI border stays within WG3 to WG5.
+- `border-secondary` — The neutral stroke ladder: every 1px UI border stays within WG3 to WG5.
+- `border-tertiary` — The neutral stroke ladder: every 1px UI border stays within WG3 to WG5.
+- `border` — The neutral stroke ladder: every 1px UI border stays within WG3 to WG5.
+- `border-strong` — The neutral stroke ladder: every 1px UI border stays within WG3 to WG5.
+- `input` — The neutral stroke ladder: every 1px UI border stays within WG3 to WG5.
+- `menu-stroke` — The neutral stroke ladder: every 1px UI border stays within WG3 to WG5.
+- `toast-stroke` — The neutral stroke ladder: every 1px UI border stays within WG3 to WG5.
+- `tree-stroke` — The neutral stroke ladder: every 1px UI border stays within WG3 to WG5.
+- `ring` — Focus ring and scrim, both translucent warm ink.
+- `overlay` — Focus ring and scrim, both translucent warm ink.
 
 ## Design principles
 
@@ -64,23 +79,27 @@ The house rules for every ADS UI. `[lint]` = `@actioneer/ads-lint` auto-checks i
 
 ### 1. Prefer fills & elevation over strokes — but keep a balance (~75/25) [judgment]
 
-Delineate SURFACES (cards, panels, sidebars, page regions) with color contrast, elevation, and spacing — not borders. Aim for ~75% shadow/fill, 25% strokes: form controls and floating menus keep a subtle border so they read as interactive; surfaces do not.
+Delineate SURFACES (cards, panels, sidebars, page regions) with color contrast, elevation, and spacing — not borders. Keep no more than two persistent neutral layers in one composition: panels establish hierarchy; embedded items express state. Aim for ~75% shadow/fill, 25% strokes: form controls and floating menus keep a subtle border so they read as interactive; surfaces do not.
 
-- Do: Separate regions by fill color first: bg-background → bg-surface → bg-card/bg-elevated → bg-muted.
+- Do: Establish hierarchy with at most two persistent layers: bg-background for the screen ground and bg-card/bg-elevated for the primary surface.
+- Do: Inside a white Panel or Card, keep rows and items transparent at rest; group them with spacing or inset dividers, use bg-muted for hover/selection, and reserve bg-surface for one continuous semantic recess such as an editor or table tray.
 - Do: Use border-border for outline buttons and lightweight action rows; reserve border-input for form controls (input, select, textarea, checkbox, radio, segmented-control track) and floating menus (dropdown, popover, listboxes).
 - Do: Keep strokes on focus rings, the outline Button/Badge/Chip variants, Kbd, Divider, the Tree connector rail, and functional color swatches.
 - Don't: Add a border to a surface to separate or group it — use fill/elevation/spacing instead.
+- Don't: Alternate persistent neutral fills inside one panel (for example white Panel → grey item → white child); flatten the item or promote the recess to the container.
 - Don't: Give a filled control no stroke on the tinted canvas — it disappears; it needs a crisp edge.
 
-### 2. Elevation = actionability [judgment]
+### 2. Shadow only by request [judgment]
 
-The single shadow-elevation token is an affordance: it goes ONLY on surfaces the user can act on. Never elevate something that can't be clicked. There is no shadow scale.
+Every surface defaults to shadow-0. Use the numbered elevation ladder only when the user explicitly requests a shadow for the named surface; the legacy shadow-elevation hook remains flat.
 
-- Do: Elevate actionable surfaces: pressable/hoverable cards, primary CTAs, control thumbs (Switch, Slider, active tab segments), and interactive floating layers (Modal, Drawer, Popover, Dropdown, listboxes, Toast).
-- Do: Keep static surfaces flat: Panel, plain Card, Kbd, Navbar, headers, rails, docs boxes, Tooltip, InlineDrawer — they read by fill/color.
-- Do: Ask 'can the user click this surface?' — if no, it's flat.
-- Don't: Reintroduce a shadow scale (shadow-xs/sm/md/lg/xl) — there is one token only, shadow-elevation.
+- Do: Keep controls, cards, menus, overlays, panels, and other surfaces at shadow-0 unless the user specifically requests elevation.
+- Do: When requested, use shadow-100 for controls, shadow-200 for raised surfaces and pressable cards, shadow-300 for menus, popovers, listboxes, and toasts, and shadow-400 for dialogs and overlay drawers.
+- Do: Reserve shadow-500 and shadow-600 for rare higher stacked layers; the legacy shadow-elevation hook resolves to shadow-0.
+- Don't: Infer permission to use a shadow from actionability, floating placement, or component type.
+- Don't: Use raw shadow values or legacy named shadow utilities.
 - Don't: Put a shadow on a non-interactive surface for decoration.
+- Don't: Use shadow-500 or shadow-600 as a routine default.
 
 ### 3. Motion follows the interaction [lint: unbounded-transition, sluggish-easing, zero-scale-entrance, undersized-zoom-entrance, raw-spring-config]
 
@@ -96,15 +115,15 @@ Component motion follows the closest Animate UI interaction pattern, using role-
 - Don't: Animate keyboard-initiated or 100×/day actions (e.g. a command-palette toggle).
 - Don't: Add motion to a component only because it is visible; static structure and decorative chrome stay still.
 
-### 4. Icons: Hugeicons, stroke only [lint: icon-package-import]
+### 4. Icons: Phosphor, regular weight (fill for active) [lint: icon-package-import]
 
-All icons come from Hugeicons in the Stroke Rounded style only. Components import named icons from the @/lib/icons registry — never from an icon package directly — so a free→Pro swap or a restyle touches one file.
+All icons come from Phosphor Icons at the regular weight — the stroke-led icon language of ADS. Components import named icons from the @/lib/icons registry — never from an icon package directly — so swapping the underlying set touches one file.
 
-- Do: Import icons from the @/lib/icons registry; add a new one there (stroke variant) before using it.
+- Do: Import icons from the @/lib/icons registry; wrap a new Phosphor component with createIcon there before using it.
 - Do: Let icons default to size='1em' so they scale with text; size with a size prop or size-* class.
-- Do: Keep stroke weight at the drawn 1.5; strokeWidth={2} is the one sanctioned emphasis step.
-- Don't: Import from an icon package directly, or use solid/duotone/twotone/fill variants.
-- Don't: Use a stroke weight thinner than 1.5.
+- Do: Render weight='fill' for the active or selected state, and weight='bold' for the rare heavier stroke.
+- Don't: Import from an icon package directly, or install a second icon set.
+- Don't: Leave an active nav item's icon at the regular stroke weight.
 
 ### 5. Demo screens: the shell owns the frame [judgment]
 
@@ -123,13 +142,17 @@ Indicator/status dots (Badge & Chip dot variants, ConnectionStatus, chart legend
 
 ### 7. ADS-first UI: use the library; extend only when asked [lint: deep-import, barrel-aliased-import, barrel-default-import, barrel-namespace-import, external-ui-import]
 
-Every UI decision stays synchronized with ADS. Before making a new screen/control/pattern, check the ADS component suite first and use the exact exported name from the public barrel. Do not hand-roll, alias, deep-import, or import external UI libraries.
+Every UI decision stays synchronized with ADS. Search the full catalog before deciding a component is missing, and use the exact exported name from the public barrel. When the barrel genuinely has no primitive, the sanctioned fallback is a shadcn/ui component vendored into src/components/ui through the repo's components.json recipe — never a hand-rolled control and never a UI library imported at a call site.
 
 - Do: Use an existing ADS component by its exact exported name from the package barrel; compose existing components for layout-only patterns.
-- Do: Ask the user before extending ADS; only an explicit request authorizes new library work.
+- Do: Search the whole catalog before concluding a component is missing — the documented specimens are a sample, not the inventory.
+- Do: Fall back to shadcn/ui when the barrel has no primitive: vendor it with npx shadcn add into src/components/ui, import cn from @/lib/utils, and swap its lucide icons for @/lib/icons.
+- Do: Let a vendored shadcn component inherit the ADS palette through the shadcn-compat aliases in theme.css rather than restyling it by hand.
+- Do: Ask the user before promoting a vendored component into the public barrel; only an explicit request authorizes new library work.
 - Do: When authorized, add the component to the right family, export its exact name through the barrel, and document it.
 - Don't: Deep-import, alias, default/namespace-import, or hand-roll a local copy of a component.
-- Don't: Import a visual component directly from the web or an npm UI library.
+- Don't: Import a visual component directly from the web or an npm UI library at a call site.
+- Don't: Reach for the shadcn fallback before searching the catalog, or install a second component library beside it.
 
 ### 8. Minimal information per screen [judgment]
 
@@ -137,9 +160,11 @@ A screen carries ONLY what the user needs to move forward: one title, the inputs
 
 - Do: Prefer more, smaller steps over dense ones; ask one thing at a time.
 - Do: Derive instead of asking whenever possible (a name from a work email, the company from its domain).
+- Do: Prefer clear text-only buttons; add an icon only when it communicates essential meaning the label cannot carry alone, or for a compact conventional icon-only control.
 - Do: Render multi-step flows full-screen — a single content container that holds the inputs and its own Back/Continue is fine.
 - Don't: Add section eyebrows above a title that already names the screen, or helper text that restates the obvious / duplicates a disabled button's meaning.
 - Don't: Add any header description unless the user explicitly requested supporting copy for that page, section, panel, modal, dialog, drawer, or popover.
+- Don't: Decorate a labeled button with a redundant leading or trailing icon.
 - Don't: Nest panel/step-rail chrome inside a multi-step flow.
 
 ### 9. Responsive = container-fluid components, shells own the width [judgment]
@@ -147,7 +172,7 @@ A screen carries ONLY what the user needs to move forward: one title, the inputs
 ADS targets landscape tablet (1024) → laptop (1440) → wide display (1920+); phone/portrait is out of scope. Components adapt to their CONTAINER via container queries; shells and pages decide pane widths through width tokens. Design against under-utilization, not cramping.
 
 - Do: Use @container on the pane and @lg:/@xl: variants on children inside components.
-- Do: Set pane widths in shells/pages through width tokens (--thread-max-width, --sidebar-width, --aside-width, --connector-card-min/-max).
+- Do: Set pane widths in shells/pages through width tokens (thread-max-width, sidebar-width, aside-width, connector-card-min/-max).
 - Do: Cap prose at its measure; let tables/charts/tool cards break out wider. Use auto-fill + minmax(min, 1fr) for grids.
 - Don't: Use sm:/md: viewport variants inside src/components, or hardcode a pane width there.
 - Don't: Cap a grid at a hard column count so it stops growing on wide displays.
@@ -176,7 +201,7 @@ When tabs and a search field control the same content, they share one responsive
 Before composing a screen, match its intent to one production below, preserve the named JSX tree, then query the design graph for required component states. State axes are independent; render only the representative combinations named by the graph instead of a Cartesian product.
 
 - `standard-screen` — Standard screen: One shell-owned screen frame containing a single primary Panel. (intents: screen, page, workspace, editor, detail page; Storybook: ADS/Components/Layout/Panel)
-- `browse-with-detail` — Browse with selection-driven detail: A primary browse Panel and an inline Drawer mounted as shell-level siblings. (intents: browse, records, list detail, inspector, audit log; Storybook: ADS/Recipes/Immersive detail view)
+- `browse-with-detail` — Browse with selection-driven detail: A primary browse Panel and an inline Drawer mounted as shell-level siblings. (intents: browse, records, list detail, inspector, audit log; Storybook: ADS/Components/Navigation/Sidebar)
 - `data-table` — Structured data table: Semantic table anatomy with matching header and body rows. (intents: table, records, comparison, sorting, selection; Storybook: ADS/Components/Data display/Table)
 - `tabbed-results` — Tabbed results with scoped search: Tabs lead and a scoped search trails in one responsive control row. (intents: tabs, filter, search, results, segmented views; Storybook: ADS/Components/Data display/Tabs)
 - `modal-task` — Blocking modal task: A focused interruption with one title, body, and decisive footer. (intents: modal, confirmation, short form, blocking task, destructive action; Storybook: ADS/Components/Overlays/Modal)
@@ -222,7 +247,7 @@ Before using any component below, preserve its built-in motion and apply the mot
 ### Foundations
 
 - [AudioWaveform] — component [docs](https://ads.actioneer.dev/#/audio-waveform)
-- [Button] — Use Button for any pressable action — a primary CTA, secondary action, or icon-only control — choosing variant by emphasis and size by context. (variants: variant: solid|secondary|outline|ghost|soft|link|danger; size: xs|sm|md|lg|icon|icon-sm|icon-xs) [docs](https://ads.actioneer.dev/#/button)
+- [Button] — Use Button for any pressable action and prefer a clear text-only label. Add an icon only when it communicates essential meaning the label cannot carry alone; reserve icon-only buttons for compact, repeated controls with universally understood symbols and an accessible label. (variants: variant: solid|secondary|outline|ghost|link|danger; size: xs|sm|md|lg|icon|icon-sm|icon-xs) [docs](https://ads.actioneer.dev/#/button)
 - [Code] — Use inline within a Text/paragraph to mark a literal token — a command, filename, variable, or short snippet — never as a block-level code display. [docs](https://ads.actioneer.dev/#/typography)
 - [CodeBlock] — Show multi-line source — a query, config, or tool payload — by passing it as a string child. The default treatment is an unfilled outlined filename toolbar above a white outlined source surface, separated by the toolbar's bottom stroke. Line numbers are on by default; add language for syntax highlighting and dedicated props for highlighted, added, or removed lines. Use inline Code for a token inside a sentence. (variants: variant: soft|plain) [docs](https://ads.actioneer.dev/#/code-block)
 - [Divider] — Separate grouped content or inline clusters with a thin rule instead of adding a border to the container. [docs](https://ads.actioneer.dev/#/divider)
@@ -233,7 +258,6 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [Heading] — Use Heading for semantic h1–h4 titles above a page, section, or card, sized by document level via `level` (never a `size` prop). [docs](https://ads.actioneer.dev/#/typography)
 - [Kbd] — Use to display a keyboard shortcut or key name, inline in text or trailing a label in a shortcut list. [docs](https://ads.actioneer.dev/#/kbd)
 - [Label] — component [docs](https://ads.actioneer.dev/#/field)
-- [Link] — Use Link for inline or standalone anchor navigation; add isExternal for links that leave the app. [docs](https://ads.actioneer.dev/#/link)
 - [ResizablePanel] — component [docs](https://ads.actioneer.dev/#/review/resizable-panel)
 - [Reveal] — Choreograph a data surface's entrance instead of a skeleton swap: wrap the shell, labels, values, and charts in ordered Reveals so the layout lands instantly and the content draws itself in. [docs](https://ads.actioneer.dev/#/reveal)
 - [RevealGroup] — component [docs](https://ads.actioneer.dev/#/reveal)
@@ -253,7 +277,6 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [FileDropzoneProps] — TypeScript type
 - [HeadingProps] — TypeScript type
 - [KbdProps] — TypeScript type
-- [LinkProps] — TypeScript type
 - [ResizablePanelProps] — TypeScript type
 - [RevealGroupProps] — TypeScript type
 - [RevealProps] — TypeScript type
@@ -299,6 +322,7 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [CheckboxProps] — TypeScript type
 - [DateRangePickerProps] — TypeScript type
 - [DateRangeValue] — TypeScript type
+- [DropdownOptionsProps] — TypeScript type
 - [InputFieldProps] — TypeScript type
 - [InputProps] — TypeScript type
 - [NumberFieldProps] — TypeScript type
@@ -311,6 +335,7 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [SliderProps] — TypeScript type
 - [SwitchProps] — TypeScript type
 - [TextareaProps] — TypeScript type
+- [DropdownOptions] — utility
 
 ### Overlays
 
@@ -327,13 +352,15 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [DropdownSeparator] — component [docs](https://ads.actioneer.dev/#/dropdown)
 - [DropdownTrigger] — component [docs](https://ads.actioneer.dev/#/dropdown)
 - [InlineDrawer] — component (variants: side: right|left|bottom; size: sm|md|lg|xl) [docs](https://ads.actioneer.dev/#/drawer)
-- [Modal] — Use for a blocking, focused task or confirmation that must interrupt the page until resolved (portaled, focus-trapped, Escape/backdrop dismissible). (variants: size: sm|md|lg|xl) [docs](https://ads.actioneer.dev/#/modal)
-- [ModalBody] — component (variants: size: sm|md|lg|xl) [docs](https://ads.actioneer.dev/#/modal)
-- [ModalDescription] — component (variants: size: sm|md|lg|xl) [docs](https://ads.actioneer.dev/#/modal)
+- [Modal] — Use for a blocking, focused task or confirmation that must interrupt the page until resolved (portaled, focus-trapped, Escape/backdrop dismissible). (variants: size: sm|md|lg|xl|full; position: center|top) [docs](https://ads.actioneer.dev/#/modal)
+- [ModalBody] — component (variants: size: sm|md|lg|xl|full; position: center|top) [docs](https://ads.actioneer.dev/#/modal)
+- [ModalClose] — component (variants: size: sm|md|lg|xl|full; position: center|top) [docs](https://ads.actioneer.dev/#/modal)
+- [ModalDescription] — component (variants: size: sm|md|lg|xl|full; position: center|top) [docs](https://ads.actioneer.dev/#/modal)
 - [ModalDrawer] — component (variants: side: right|left|bottom; size: sm|md|lg|xl) [docs](https://ads.actioneer.dev/#/drawer)
-- [ModalFooter] — component (variants: size: sm|md|lg|xl) [docs](https://ads.actioneer.dev/#/modal)
-- [ModalHeader] — component (variants: size: sm|md|lg|xl) [docs](https://ads.actioneer.dev/#/modal)
-- [ModalTitle] — component (variants: size: sm|md|lg|xl) [docs](https://ads.actioneer.dev/#/modal)
+- [ModalFooter] — component (variants: size: sm|md|lg|xl|full; position: center|top) [docs](https://ads.actioneer.dev/#/modal)
+- [ModalHeader] — component (variants: size: sm|md|lg|xl|full; position: center|top) [docs](https://ads.actioneer.dev/#/modal)
+- [ModalSection] — component (variants: size: sm|md|lg|xl|full; position: center|top) [docs](https://ads.actioneer.dev/#/modal)
+- [ModalTitle] — component (variants: size: sm|md|lg|xl|full; position: center|top) [docs](https://ads.actioneer.dev/#/modal)
 - [Popover] — Use Popover for a portaled, dismissible panel anchored to a trigger — quick settings, a profile card, or a short inline form — that closes on outside click or Escape. [docs](https://ads.actioneer.dev/#/popover)
 - [PopoverContent] — component [docs](https://ads.actioneer.dev/#/popover)
 - [PopoverTrigger] — component [docs](https://ads.actioneer.dev/#/popover)
@@ -346,6 +373,7 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [DropdownProps] — TypeScript type
 - [DropdownTriggerProps] — TypeScript type
 - [InlineDrawerProps] — TypeScript type
+- [ModalBodyProps] — TypeScript type
 - [ModalDrawerProps] — TypeScript type
 - [ModalProps] — TypeScript type
 - [PopoverContentProps] — TypeScript type
@@ -365,14 +393,14 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [AccordionItem] — component [docs](https://ads.actioneer.dev/#/accordion)
 - [AnswerRenderer] — component (variants: tone: default|primary|success|warning|danger|info) [docs](https://ads.actioneer.dev/#/ai/answer)
 - [AnswerSkeleton] — component (variants: tone: default|primary|success|warning|danger|info) [docs](https://ads.actioneer.dev/#/ai/answer)
-- [AnswerSourceChip] — Use the blue connector/source chip inside AnswerSources to open only the referenced nodes represented by that chip in the shell's inspector. [docs](https://ads.actioneer.dev/#/ai/sources)
-- [AnswerSourceInspector] — Render as a persistent right-side sibling when a source or node is selected, then unmount it when that context clears. Execution contract: use a transparent split wrapper with an 8px gap; keep the inspector fixed at 320px and shrink-0 while the primary panel stays min-w-0; use a bg-background canvas, bg-card panels, bg-surface detail rows, independent border-border strokes, text-primary/text-secondary/text-tertiary text, and bg-action-primary CTAs (bg-action-primary-hover on hover); apply the 2/4/6/8px radius scale with 8px on panels and rows, 24px panel padding, and no panel shadow; keep the immersive outer shell transparent, borderless, shadowless, and square; never fill the gutter or draw one shared border around both panels. [docs](https://ads.actioneer.dev/#/ai/sources)
-- [AnswerSourceItem] — Use as an outlined clickable row inside AnswerSourceInspector for one referenced table or node, including its parent source, read state, and optional status. [docs](https://ads.actioneer.dev/#/ai/sources)
-- [AnswerSources] — Place immediately above an answer's follow-up questions to summarize the referenced nodes and group them into clickable AnswerSourceChips. [docs](https://ads.actioneer.dev/#/ai/sources)
+- [AnswerSourceChip] — Use the blue connector/source chip inside AnswerSources to open only the referenced nodes represented by that chip in the shell's inspector. [docs](https://ads.actioneer.dev/#/ai/answer)
+- [AnswerSourceInspector] — Render as a persistent right-side sibling when a source or node is selected, then unmount it when that context clears. Execution contract: use a transparent split wrapper with an 8px gap; keep the inspector fixed at 320px and shrink-0 while the primary panel stays min-w-0; use a bg-background canvas, bg-card panels, bg-surface detail rows, independent border-border strokes, text-primary/text-secondary/text-tertiary text, and bg-action-primary CTAs (bg-action-primary-hover on hover); apply the 2/4/6/8px radius scale with 8px on panels and rows, 24px panel padding, and no panel shadow; keep the split workspace wrapper transparent, borderless, shadowless, and square; never fill the gutter or draw one shared border around both panels. [docs](https://ads.actioneer.dev/#/ai/answer)
+- [AnswerSourceItem] — Use as an outlined clickable row inside AnswerSourceInspector for one referenced table or node, including its parent source, read state, and optional status. [docs](https://ads.actioneer.dev/#/ai/answer)
+- [AnswerSources] — Place immediately above an answer's follow-up questions to summarize the referenced nodes and group them into clickable AnswerSourceChips. [docs](https://ads.actioneer.dev/#/ai/answer)
 - [AreaChart] — component [docs](https://ads.actioneer.dev/#/ai/chart)
 - [Avatar] — Use to represent a person or entity as a compact photo-or-initials glyph, standalone or stacked in an AvatarGroup. [docs](https://ads.actioneer.dev/#/avatar)
 - [AvatarGroup] — component [docs](https://ads.actioneer.dev/#/avatar)
-- [Badge] — Use Badge for a small inline label — status, counts, or tags — attached to text or a row. (variants: variant: solid|soft|outline|dot; color: default|primary|success|warning|danger|info) [docs](https://ads.actioneer.dev/#/badge)
+- [Badge] — Use Badge for a small inline label — status, counts, or tags — attached to text or a row. [docs](https://ads.actioneer.dev/#/badge)
 - [BarChart] — component [docs](https://ads.actioneer.dev/#/ai/chart)
 - [BaseEdge] — component [docs](https://ads.actioneer.dev/#/infinite-canvas)
 - [BreakdownAnswer] — component (variants: tone: default|primary|success|warning|danger|info) [docs](https://ads.actioneer.dev/#/ai/answer)
@@ -388,7 +416,7 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [CarouselItem] — component [docs](https://ads.actioneer.dev/#/carousel)
 - [CarouselNext] — component [docs](https://ads.actioneer.dev/#/carousel)
 - [CarouselPrevious] — component [docs](https://ads.actioneer.dev/#/carousel)
-- [Chip] — A compact pill for statuses, tags, or metadata, with an optional leading icon/avatar or a dismiss control. (variants: variant: solid|soft|outline|dot; color: default|primary|success|warning|danger|info) [docs](https://ads.actioneer.dev/#/chip)
+- [Chip] — A compact pill for statuses, tags, or metadata, with an optional leading icon/avatar or a dismiss control. (variants: variant: solid|outline; color: default|primary|success|warning|danger|info) [docs](https://ads.actioneer.dev/#/chip)
 - [ClarificationAnswer] — component (variants: tone: default|primary|success|warning|danger|info) [docs](https://ads.actioneer.dev/#/ai/answer)
 - [ComboChart] — component [docs](https://ads.actioneer.dev/#/ai/chart)
 - [ComparisonAnswer] — component (variants: tone: default|primary|success|warning|danger|info) [docs](https://ads.actioneer.dev/#/ai/answer)
@@ -402,6 +430,7 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [ErrorAnswer] — component (variants: tone: default|primary|success|warning|danger|info) [docs](https://ads.actioneer.dev/#/ai/answer)
 - [ExplanationAnswer] — component (variants: tone: default|primary|success|warning|danger|info) [docs](https://ads.actioneer.dev/#/ai/answer)
 - [FactAnswer] — component (variants: tone: default|primary|success|warning|danger|info) [docs](https://ads.actioneer.dev/#/ai/answer)
+- [FollowUpQuestion] — Use for the two or three full-width next-question rows that close a structured answer, immediately after its source strip; show the exact prompt that clicking will send. (variants: tone: default|primary|success|warning|danger|info) [docs](https://ads.actioneer.dev/#/ai/answer)
 - [FunnelBarsHorizontal] — component [docs](https://ads.actioneer.dev/#/viz-charts)
 - [FunnelChart] — component [docs](https://ads.actioneer.dev/#/ai/chart)
 - [FunnelViz] — component [docs](https://ads.actioneer.dev/#/viz-charts)
@@ -424,18 +453,18 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [ScatterChart] — component [docs](https://ads.actioneer.dev/#/ai/chart)
 - [SeriesChart] — component [docs](https://ads.actioneer.dev/#/viz-charts)
 - [StatusAnswer] — component (variants: tone: default|primary|success|warning|danger|info) [docs](https://ads.actioneer.dev/#/ai/answer)
-- [Tab] — component (variants: variant: primary|secondary|pill; orientation: horizontal|vertical; size: sm|md|lg; selected: true|false) [docs](https://ads.actioneer.dev/#/tabs)
-- [Table] — Use Table for structured tabular data that may need row selection, column sorting, sticky columns, or a paginated footer — not for simple key-value lists. Interactive rows inherit the shared soft neutral hover/focus sink and keep their normal table geometry; do not add a brand tint or hover-only corner rounding. Primary record links stay text-only in every state: never reveal an arrow, chevron, or other directional icon only on hover. Persistent row actions use a final sticky-right column plus elevatedActionColumn so one body-column shadow lifts the action surface instead of repeating on individual cells. The empty matching header cell remains transparent and non-sticky. [docs](https://ads.actioneer.dev/#/table)
+- [Tab] — component (variants: orientation: horizontal|vertical; selected: true|false) [docs](https://ads.actioneer.dev/#/tabs)
+- [Table] — Use Table for structured tabular data that may need row selection, column sorting, sticky columns, or a paginated footer — not for simple key-value lists. Every primary body-cell value defaults to text-m (15px / 22px); only clearly secondary metadata inside a cell may opt down to text-s. Interactive rows inherit the shared soft neutral hover/focus sink and keep their normal table geometry; do not add a brand tint or hover-only corner rounding. Primary record links stay text-only in every state: never reveal an arrow, chevron, or other directional icon only on hover. Persistent row actions use a final sticky-right column plus elevatedActionColumn so one body-column shadow lifts the action surface instead of repeating on individual cells. The empty matching header cell remains transparent and non-sticky. [docs](https://ads.actioneer.dev/#/table)
 - [TableAnswer] — component (variants: tone: default|primary|success|warning|danger|info) [docs](https://ads.actioneer.dev/#/ai/answer)
 - [TableBody] — component [docs](https://ads.actioneer.dev/#/table)
 - [TableCell] — component [docs](https://ads.actioneer.dev/#/table)
 - [TableColumn] — component [docs](https://ads.actioneer.dev/#/table)
 - [TableHeader] — component [docs](https://ads.actioneer.dev/#/table)
 - [TableRow] — component [docs](https://ads.actioneer.dev/#/table)
-- [TabList] — component (variants: variant: primary|secondary|pill; orientation: horizontal|vertical; size: sm|md|lg) [docs](https://ads.actioneer.dev/#/tabs)
-- [TabPanel] — component (variants: variant: primary|secondary|pill; orientation: horizontal|vertical; size: sm|md|lg; selected: true|false) [docs](https://ads.actioneer.dev/#/tabs)
-- [Tabs] — Use Tabs to switch between mutually exclusive views/sections that share the same page context, not for page-level navigation. Always reach for the primary recessed-track variant — it is the default; use secondary only when explicitly asked for it. Tab radius follows control size (4px sm, 8px md/lg), never rounded-full. When Tabs and a scoped search field coexist, compose one responsive control row with tabs leading and search trailing; do not stack search above tabs at widths where both fit. (variants: variant: primary|secondary|pill; orientation: horizontal|vertical; size: sm|md|lg; selected: true|false) [docs](https://ads.actioneer.dev/#/tabs)
-- [TabSeparator] — component (variants: variant: primary|secondary|pill; orientation: horizontal|vertical; size: sm|md|lg; selected: true|false) [docs](https://ads.actioneer.dev/#/tabs)
+- [TabList] — component (variants: orientation: horizontal|vertical) [docs](https://ads.actioneer.dev/#/tabs)
+- [TabPanel] — component (variants: orientation: horizontal|vertical; selected: true|false) [docs](https://ads.actioneer.dev/#/tabs)
+- [Tabs] — Use Tabs to switch between mutually exclusive views/sections that share the same page context, not for page-level navigation. Always reach for the primary recessed-track variant — it is the default; use secondary only when explicitly asked for it. Tab radius follows control size: 4px at sm and 8px at md/lg, never rounded-full. When Tabs and a scoped search field coexist, compose one responsive control row with tabs leading and search trailing; do not stack search above tabs at widths where both fit. (variants: orientation: horizontal|vertical; selected: true|false) [docs](https://ads.actioneer.dev/#/tabs)
+- [TabSeparator] — component (variants: orientation: horizontal|vertical; selected: true|false) [docs](https://ads.actioneer.dev/#/tabs)
 - [Timeline] — Use for a vertical rail of dated events — version history, audit trails, activity/status feeds. [docs](https://ads.actioneer.dev/#/timeline)
 - [TimelineItem] — component [docs](https://ads.actioneer.dev/#/timeline)
 - [Tree] — component [docs](https://ads.actioneer.dev/#/tree)
@@ -484,6 +513,7 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [ChartTooltipItem] — TypeScript type
 - [ChartTooltipRenderer] — TypeScript type
 - [ChartXScale] — TypeScript type
+- [ChipInteraction] — TypeScript type
 - [ChipProps] — TypeScript type
 - [ClarificationAnswerProps] — TypeScript type
 - [ClarificationAnswerSpec] — TypeScript type
@@ -514,6 +544,7 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [ExplanationAnswerSpec] — TypeScript type
 - [FactAnswerProps] — TypeScript type
 - [FactAnswerSpec] — TypeScript type
+- [FollowUpQuestionProps] — TypeScript type
 - [FunnelBarsHorizontalProps] — TypeScript type
 - [FunnelChartProps] — TypeScript type
 - [FunnelLabelContext] — TypeScript type
@@ -568,6 +599,7 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [TreeItemProps] — TypeScript type
 - [TreemapChartProps] — TypeScript type
 - [TreemapDatum] — TypeScript type
+- [TreeProps] — TypeScript type
 - [TrendAnswerProps] — TypeScript type
 - [TrendAnswerSpec] — TypeScript type
 - [Viewport] — TypeScript type
@@ -616,11 +648,9 @@ Before using any component below, preserve its built-in motion and apply the mot
 
 ### Feedback
 
-- [AgentIcon] — component [docs](https://ads.actioneer.dev/#/agent-icon)
-- [Alert] — Use for persistent inline status messaging on a page (not toasts) — a neutral surface where only the icon and title carry variant color. (variants: variant: default|success|warning|danger|info) [docs](https://ads.actioneer.dev/#/alert)
+- [Alert] — Use for inline status messaging on a raised white surface. Add duration for a temporary announcement with a countdown bar; otherwise it remains persistent. (variants: variant: default|success|warning|danger|info) [docs](https://ads.actioneer.dev/#/alert)
 - [AlertDescription] — component (variants: variant: default|success|warning|danger|info) [docs](https://ads.actioneer.dev/#/alert)
 - [AlertTitle] — component (variants: variant: default|success|warning|danger|info) [docs](https://ads.actioneer.dev/#/alert)
-- [BrandLoader] — Use for a branded loading/generating indicator (inline in a text row or as a standalone full-screen moment) instead of a generic spinner. [docs](https://ads.actioneer.dev/#/brand-loader)
 - [BrandMark] — component [docs](https://ads.actioneer.dev/#/brand-loader)
 - [BrandTexture] — Place the ambient halftone wash behind a welcome or hero surface inside a relative container; set lifted when real content takes over so the field dissolves upward, and paused a beat later to stop the shader clock. [docs](https://ads.actioneer.dev/#/brand-texture)
 - [BrandTextureField] — component [docs](https://ads.actioneer.dev/#/brand-texture)
@@ -630,41 +660,31 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [EmptySearch] — component [docs](https://ads.actioneer.dev/#/empty-state)
 - [EmptyState] — Use as the centered placeholder inside a list, table, or panel that currently has nothing to show. [docs](https://ads.actioneer.dev/#/empty-state)
 - [PixelBlastSVG] — component [docs](https://ads.actioneer.dev/#/pixel-blast-svg)
-- [PixelIcon] — component [docs](https://ads.actioneer.dev/#/pixel-icon)
 - [Progress] — Use for a determinate or indeterminate bar showing task completion, driven by a value/max (default 100). [docs](https://ads.actioneer.dev/#/progress)
 - [ProgressCircle] — Use for a compact circular loading/progress indicator (determinate or indeterminate) where a linear bar doesn't fit, e.g. inline with a caption or a small avatar-sized control. [docs](https://ads.actioneer.dev/#/progress-circle)
 - [Ripple] — component [docs](https://ads.actioneer.dev/#/ripple)
 - [Skeleton] — Placeholder the shape of content that's still loading — size it via className and pair with circle for avatars. [docs](https://ads.actioneer.dev/#/skeleton)
-- [AgentIconColorPreset] — TypeScript type
-- [AgentIconName] — TypeScript type
-- [AgentIconProps] — TypeScript type
-- [AgentIconState] — TypeScript type
+- [SurfaceLoader] — Use for any whole panel, modal, or page that is temporarily blocked; it owns the ADS surface spinner, visible status, spacing, and busy semantics. [docs](https://ads.actioneer.dev/#/surface-loader)
 - [AlertProps] — TypeScript type
-- [BrandLoaderProps] — TypeScript type
 - [BrandMarkProps] — TypeScript type
 - [BrandTextureProps] — TypeScript type
 - [EmptyStateProps] — TypeScript type
 - [PixelBlastSVGProps] — TypeScript type
-- [PixelIconMask] — TypeScript type
-- [PixelIconProps] — TypeScript type
 - [ProgressCircleProps] — TypeScript type
 - [ProgressProps] — TypeScript type
 - [RippleProps] — TypeScript type
 - [SkeletonProps] — TypeScript type
-- [AGENT_ICON_NAMES] — utility
-- [AGENT_ICONS] — utility
+- [SurfaceLoaderProps] — TypeScript type
 
 ### Navigation
 
+- [BodyPageHeader] — component [docs](https://ads.actioneer.dev/#/body-page-header)
 - [BreadcrumbItem] — component [docs](https://ads.actioneer.dev/#/breadcrumbs)
 - [Breadcrumbs] — Use to show a page's location in a hierarchy as a trail of parent links ending in the current page. Keep item labels text-only; the component supplies right-chevron separators. Each drill-down level gets a full-width 48px bar with a subtle bottom stroke. [docs](https://ads.actioneer.dev/#/breadcrumbs)
-- [Navbar] — Use for a sticky top-of-page nav shell with a brand slot, justified link/action groups, and active-state item links. (variants: justify: start|center|end) [docs](https://ads.actioneer.dev/#/navbar)
-- [NavbarBrand] — component (variants: justify: start|center|end) [docs](https://ads.actioneer.dev/#/navbar)
-- [NavbarContent] — component (variants: justify: start|center|end) [docs](https://ads.actioneer.dev/#/navbar)
-- [NavbarItem] — component (variants: justify: start|center|end) [docs](https://ads.actioneer.dev/#/navbar)
-- [PageHeader] — Use for every page title row; supply onBack to anchor an icon-only back arrow immediately before the title, never in the trailing actions area. [docs](https://ads.actioneer.dev/#/page-header)
+- [CollectionHeader] — Use for a top-level sidebar destination or collection. Supply the destination icon, keep search and secondary controls before one compact primary action, and place collection content below its built-in separator. [docs](https://ads.actioneer.dev/#/collection-header)
+- [PageHeader] — Use for detail, create, and edit page title rows; supply onBack to anchor an icon-only back arrow immediately before the title. Use CollectionHeader for top-level sidebar destinations and collections. [docs](https://ads.actioneer.dev/#/page-header)
 - [Pagination] — Use for navigating multi-page numbered content — table footers, search results, or any list too long for one screen. [docs](https://ads.actioneer.dev/#/pagination)
-- [Sidebar] — Use as an app's vertical navigation rail. The canonical Actioneer shell pairs one collapsible global product rail with one fixed contextual Sidebar inside the shared workspace Panel; only the global rail owns a collapse control. Compose SidebarBrand, grouped SidebarItems, optional SidebarHistory, and SidebarAccount as the area requires. [docs](https://ads.actioneer.dev/#/sidebar)
+- [Sidebar] — Use as an app's vertical navigation rail. The canonical Actioneer shell uses one collapsible Sidebar for product areas and the active area's grouped internal options. Compose SidebarBrand, grouped SidebarItems, optional SidebarHistory, and SidebarAccount as the area requires. [docs](https://ads.actioneer.dev/#/sidebar)
 - [SidebarAccount] — component [docs](https://ads.actioneer.dev/#/sidebar)
 - [SidebarAction] — component [docs](https://ads.actioneer.dev/#/sidebar)
 - [SidebarBrand] — component [docs](https://ads.actioneer.dev/#/sidebar)
@@ -676,10 +696,10 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [SidebarNav] — component [docs](https://ads.actioneer.dev/#/sidebar)
 - [SidebarSection] — component [docs](https://ads.actioneer.dev/#/sidebar)
 - [SidebarTrigger] — component [docs](https://ads.actioneer.dev/#/sidebar)
+- [BodyPageHeaderProps] — TypeScript type
 - [BreadcrumbItemProps] — TypeScript type
 - [BreadcrumbsProps] — TypeScript type
-- [NavbarContentProps] — TypeScript type
-- [NavbarItemProps] — TypeScript type
+- [CollectionHeaderProps] — TypeScript type
 - [PageHeaderProps] — TypeScript type
 - [PaginationProps] — TypeScript type
 - [SidebarAccountProps] — TypeScript type
@@ -697,6 +717,7 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [Collapsible] — Reach for it to build a single disclosure row, detail panel, or FAQ item that expands/collapses in place — compose several instances for a list since ADS has no accordion-group wrapper. [docs](https://ads.actioneer.dev/#/collapsible)
 - [CollapsibleContent] — component [docs](https://ads.actioneer.dev/#/collapsible)
 - [CollapsibleTrigger] — component [docs](https://ads.actioneer.dev/#/collapsible)
+- [PageBody] — component [docs](https://ads.actioneer.dev/#/page-body)
 - [Panel] — Use Panel for app-frame regions (editors, previews, side columns, tool windows) that need a fixed header/footer around independently scrolling body content. [docs](https://ads.actioneer.dev/#/panel)
 - [PanelBody] — component [docs](https://ads.actioneer.dev/#/panel)
 - [PanelFooter] — component [docs](https://ads.actioneer.dev/#/panel)
@@ -705,6 +726,7 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [PanelToolbar] — component [docs](https://ads.actioneer.dev/#/panel)
 - [SelectionActionBar] — Render it above a selectable list or table once selectedCount is greater than zero, to summarize the selection and expose bulk actions plus a clear control. [docs](https://ads.actioneer.dev/#/selection-action-bar)
 - [SelectionActionBarAction] — component [docs](https://ads.actioneer.dev/#/selection-action-bar)
+- [PageBodyProps] — TypeScript type
 - [SelectionActionBarProps] — TypeScript type
 
 ### AI Elements
@@ -724,20 +746,20 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [ChainOfThoughtSearchResults] — component [docs](https://ads.actioneer.dev/#/ai/chain-of-thought)
 - [ChainOfThoughtStep] — component [docs](https://ads.actioneer.dev/#/ai/chain-of-thought)
 - [ChainOfThoughtTrigger] — component [docs](https://ads.actioneer.dev/#/ai/chain-of-thought)
-- [InlineCitation] — component [docs](https://ads.actioneer.dev/#/ai/inline-citation)
-- [InlineCitationCard] — component [docs](https://ads.actioneer.dev/#/ai/inline-citation)
-- [InlineCitationCardBody] — component [docs](https://ads.actioneer.dev/#/ai/inline-citation)
-- [InlineCitationCardTrigger] — component [docs](https://ads.actioneer.dev/#/ai/inline-citation)
-- [InlineCitationCarousel] — component [docs](https://ads.actioneer.dev/#/ai/inline-citation)
-- [InlineCitationCarouselContent] — component [docs](https://ads.actioneer.dev/#/ai/inline-citation)
-- [InlineCitationCarouselHeader] — component [docs](https://ads.actioneer.dev/#/ai/inline-citation)
-- [InlineCitationCarouselIndex] — component [docs](https://ads.actioneer.dev/#/ai/inline-citation)
-- [InlineCitationCarouselItem] — component [docs](https://ads.actioneer.dev/#/ai/inline-citation)
-- [InlineCitationCarouselNext] — component [docs](https://ads.actioneer.dev/#/ai/inline-citation)
-- [InlineCitationCarouselPrev] — component [docs](https://ads.actioneer.dev/#/ai/inline-citation)
-- [InlineCitationQuote] — component [docs](https://ads.actioneer.dev/#/ai/inline-citation)
-- [InlineCitationSource] — component [docs](https://ads.actioneer.dev/#/ai/inline-citation)
-- [InlineCitationText] — component [docs](https://ads.actioneer.dev/#/ai/inline-citation)
+- [InlineCitation] — component [docs](https://ads.actioneer.dev/#/inline-citation)
+- [InlineCitationCard] — component [docs](https://ads.actioneer.dev/#/inline-citation)
+- [InlineCitationCardBody] — component [docs](https://ads.actioneer.dev/#/inline-citation)
+- [InlineCitationCardTrigger] — component [docs](https://ads.actioneer.dev/#/inline-citation)
+- [InlineCitationCarousel] — component [docs](https://ads.actioneer.dev/#/inline-citation)
+- [InlineCitationCarouselContent] — component [docs](https://ads.actioneer.dev/#/inline-citation)
+- [InlineCitationCarouselHeader] — component [docs](https://ads.actioneer.dev/#/inline-citation)
+- [InlineCitationCarouselIndex] — component [docs](https://ads.actioneer.dev/#/inline-citation)
+- [InlineCitationCarouselItem] — component [docs](https://ads.actioneer.dev/#/inline-citation)
+- [InlineCitationCarouselNext] — component [docs](https://ads.actioneer.dev/#/inline-citation)
+- [InlineCitationCarouselPrev] — component [docs](https://ads.actioneer.dev/#/inline-citation)
+- [InlineCitationQuote] — component [docs](https://ads.actioneer.dev/#/inline-citation)
+- [InlineCitationSource] — component [docs](https://ads.actioneer.dev/#/inline-citation)
+- [InlineCitationText] — component [docs](https://ads.actioneer.dev/#/inline-citation)
 - [Message] — component (variants: align: start|end) [docs](https://ads.actioneer.dev/#/ai/message)
 - [MessageAction] — component (variants: align: start|end; variant: contained|flat|plain|request) [docs](https://ads.actioneer.dev/#/ai/message)
 - [MessageActions] — component (variants: align: start|end; variant: contained|flat|plain|request) [docs](https://ads.actioneer.dev/#/ai/message)
@@ -754,43 +776,14 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [MessageMeta] — component (variants: align: start|end; variant: contained|flat|plain|request) [docs](https://ads.actioneer.dev/#/ai/message)
 - [MessageResponse] — component (variants: align: start|end; variant: contained|flat|plain|request) [docs](https://ads.actioneer.dev/#/ai/message)
 - [MessageToolbar] — component (variants: align: start|end; variant: contained|flat|plain|request) [docs](https://ads.actioneer.dev/#/ai/message)
-- [Queue] — component [docs](https://ads.actioneer.dev/#/ai/queue)
-- [QueueItem] — component [docs](https://ads.actioneer.dev/#/ai/queue)
-- [QueueItemAction] — component [docs](https://ads.actioneer.dev/#/ai/queue)
-- [QueueItemActions] — component [docs](https://ads.actioneer.dev/#/ai/queue)
-- [QueueItemAttachment] — component [docs](https://ads.actioneer.dev/#/ai/queue)
-- [QueueItemContent] — component [docs](https://ads.actioneer.dev/#/ai/queue)
-- [QueueItemDescription] — component [docs](https://ads.actioneer.dev/#/ai/queue)
-- [QueueItemFile] — component [docs](https://ads.actioneer.dev/#/ai/queue)
-- [QueueItemImage] — component [docs](https://ads.actioneer.dev/#/ai/queue)
-- [QueueItemIndicator] — component [docs](https://ads.actioneer.dev/#/ai/queue)
-- [QueueList] — component [docs](https://ads.actioneer.dev/#/ai/queue)
-- [QueueSection] — component [docs](https://ads.actioneer.dev/#/ai/queue)
-- [QueueSectionContent] — component [docs](https://ads.actioneer.dev/#/ai/queue)
-- [QueueSectionLabel] — component [docs](https://ads.actioneer.dev/#/ai/queue)
-- [QueueSectionTrigger] — component [docs](https://ads.actioneer.dev/#/ai/queue)
 - [ResearchActivity] — Wrap a multi-step research trace that may run for minutes; pass activity so the run reads as one morphing live line with the full trace a click away, then settle into its source count, duration, and first-insight time. (variants: status: active|complete) [docs](https://ads.actioneer.dev/#/ai/research-activity)
-- [Shimmer] — component [docs](https://ads.actioneer.dev/#/ai/shimmer)
-- [SpeechInput] — component [docs](https://ads.actioneer.dev/#/ai/speech-input)
-- [Task] — component [docs](https://ads.actioneer.dev/#/ai/task)
-- [TaskContent] — component [docs](https://ads.actioneer.dev/#/ai/task)
-- [TaskItem] — component [docs](https://ads.actioneer.dev/#/ai/task)
-- [TaskItemFile] — component [docs](https://ads.actioneer.dev/#/ai/task)
-- [TaskProgress] — Keep a multi-step answer’s current task, elapsed time, completed work, and pending work visible in a collapsible dock above the chat composer. (variants: isSticky: true|false) [docs](https://ads.actioneer.dev/#/ai/task-progress)
-- [TaskProgressDock] — component (variants: isSticky: true|false) [docs](https://ads.actioneer.dev/#/ai/task-progress)
-- [TaskTrigger] — component [docs](https://ads.actioneer.dev/#/ai/task)
+- [Shimmer] — component [docs](https://ads.actioneer.dev/#/shimmer)
 - [ToolContent] — component [docs](https://ads.actioneer.dev/#/ai/tool)
 - [ToolHeader] — component [docs](https://ads.actioneer.dev/#/ai/tool)
 - [ToolInput] — component [docs](https://ads.actioneer.dev/#/ai/tool)
 - [ToolOutput] — component [docs](https://ads.actioneer.dev/#/ai/tool)
 - [TraceStateIcon] — component [docs](https://ads.actioneer.dev/#/chain-of-thought-icon)
 - [Transcript] — component [docs](https://ads.actioneer.dev/#/ai/transcript)
-- [Voice] — component [docs](https://ads.actioneer.dev/#/ai/voice)
-- [VoiceConnectButton] — component [docs](https://ads.actioneer.dev/#/ai/voice)
-- [VoiceControl] — component [docs](https://ads.actioneer.dev/#/ai/voice)
-- [VoiceDisconnectButton] — component [docs](https://ads.actioneer.dev/#/ai/voice)
-- [VoiceMuteButton] — component [docs](https://ads.actioneer.dev/#/ai/voice)
-- [VoiceStatusDot] — component [docs](https://ads.actioneer.dev/#/ai/voice)
 - [ActiveChainOfThoughtState] — TypeScript type
 - [AgentTraceCall] — TypeScript type
 - [AgentTraceProps] — TypeScript type
@@ -848,36 +841,8 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [MessageResponseProps] — TypeScript type
 - [MessageRole] — TypeScript type
 - [MessageToolbarProps] — TypeScript type
-- [QueueItemActionProps] — TypeScript type
-- [QueueItemActionsProps] — TypeScript type
-- [QueueItemAttachmentProps] — TypeScript type
-- [QueueItemContentProps] — TypeScript type
-- [QueueItemDescriptionProps] — TypeScript type
-- [QueueItemFileProps] — TypeScript type
-- [QueueItemImageProps] — TypeScript type
-- [QueueItemIndicatorProps] — TypeScript type
-- [QueueItemProps] — TypeScript type
-- [QueueListProps] — TypeScript type
-- [QueueMessage] — TypeScript type
-- [QueueMessagePart] — TypeScript type
-- [QueueProps] — TypeScript type
-- [QueueSectionContentProps] — TypeScript type
-- [QueueSectionLabelProps] — TypeScript type
-- [QueueSectionProps] — TypeScript type
-- [QueueSectionTriggerProps] — TypeScript type
-- [QueueTodo] — TypeScript type
 - [ResearchActivityProps] — TypeScript type
 - [ResearchActivityStatus] — TypeScript type
-- [SpeechInputProps] — TypeScript type
-- [TaskContentProps] — TypeScript type
-- [TaskItemFileProps] — TypeScript type
-- [TaskItemProps] — TypeScript type
-- [TaskProgressDockProps] — TypeScript type
-- [TaskProgressProps] — TypeScript type
-- [TaskProgressStatus] — TypeScript type
-- [TaskProgressStep] — TypeScript type
-- [TaskProps] — TypeScript type
-- [TaskTriggerProps] — TypeScript type
 - [TextShimmerProps] — TypeScript type
 - [ToolContentProps] — TypeScript type
 - [ToolHeaderProps] — TypeScript type
@@ -889,24 +854,11 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [TranscriptProps] — TypeScript type
 - [TranscriptTone] — TypeScript type
 - [TranscriptTurn] — TypeScript type
-- [VoiceConnectButtonProps] — TypeScript type
-- [VoiceControlProps] — TypeScript type
-- [VoiceDisconnectButtonProps] — TypeScript type
-- [VoiceMuteButtonProps] — TypeScript type
-- [VoiceOrbPalette] — TypeScript type
-- [VoicePalette] — TypeScript type
-- [VoiceProps] — TypeScript type
-- [VoiceState] — TypeScript type
-- [VoiceStatusDotProps] — TypeScript type
-- [VoiceVariant] — TypeScript type
 - [aiChartVariants] — utility
 - [CHAIN_OF_THOUGHT_DESCRIPTIONS] — utility
 - [CHAIN_OF_THOUGHT_STATES] — utility
 - [resolveTraceState] — utility
 - [Tool] — utility
-- [VOICE_PALETTES] — utility
-- [VOICE_STATES] — utility
-- [VOICE_VARIANTS] — utility
 
 ### Chat
 
@@ -914,7 +866,6 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [AssistantMessage] — component [docs](https://ads.actioneer.dev/#/demo/ask)
 - [AssistantRuntimeProvider] — component [docs](https://ads.actioneer.dev/#/demo/ask)
 - [AttachmentPrimitive] — component [docs](https://ads.actioneer.dev/#/demo/ask)
-- [BranchPicker] — component [docs](https://ads.actioneer.dev/#/demo/ask)
 - [Composer] — component [docs](https://ads.actioneer.dev/#/demo/ask)
 - [ComposerAddAttachment] — component [docs](https://ads.actioneer.dev/#/demo/ask)
 - [ComposerAddDocument] — component [docs](https://ads.actioneer.dev/#/demo/ask)
@@ -942,8 +893,6 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [FileName] — component [docs](https://ads.actioneer.dev/#/demo/ask)
 - [FileRoot] — component [docs](https://ads.actioneer.dev/#/demo/ask)
 - [FileSize] — component [docs](https://ads.actioneer.dev/#/demo/ask)
-- [FollowUpQuestion] — Use for the two or three full-width next-question rows that close a structured answer, immediately after its source strip; show the exact prompt that clicking will send. [docs](https://ads.actioneer.dev/#/ai/follow-up-suggestions)
-- [FollowUpSuggestion] — Use only for compact runtime suggestion chips above the composer; use FollowUpQuestion for the larger answer-ending question rows. [docs](https://ads.actioneer.dev/#/ai/follow-up-suggestions)
 - [Image] — component [docs](https://ads.actioneer.dev/#/demo/ask)
 - [ImageActions] — component [docs](https://ads.actioneer.dev/#/demo/ask)
 - [ImageContentFilterError] — component [docs](https://ads.actioneer.dev/#/demo/ask)
@@ -971,11 +920,8 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [Sources] — component [docs](https://ads.actioneer.dev/#/demo/ask)
 - [SourceTitle] — component [docs](https://ads.actioneer.dev/#/demo/ask)
 - [Thread] — component [docs](https://ads.actioneer.dev/#/demo/ask)
-- [ThreadFollowupSuggestions] — component [docs](https://ads.actioneer.dev/#/demo/ask)
 - [ThreadMessage] — component [docs](https://ads.actioneer.dev/#/demo/ask)
 - [ThreadPrimitive] — component [docs](https://ads.actioneer.dev/#/demo/ask)
-- [ThreadSuggestionItem] — component [docs](https://ads.actioneer.dev/#/demo/ask)
-- [ThreadSuggestions] — component [docs](https://ads.actioneer.dev/#/demo/ask)
 - [ToolFallback] — component [docs](https://ads.actioneer.dev/#/demo/ask)
 - [ToolFallbackApproval] — component [docs](https://ads.actioneer.dev/#/demo/ask)
 - [ToolFallbackArgs] — component [docs](https://ads.actioneer.dev/#/demo/ask)
@@ -997,8 +943,6 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [CreateDirectiveTextOptions] — TypeScript type
 - [DeepResearchState] — TypeScript type
 - [FileRootProps] — TypeScript type
-- [FollowUpQuestionProps] — TypeScript type
-- [FollowUpSuggestionProps] — TypeScript type
 - [ImageActionsProps] — TypeScript type
 - [ImageRootProps] — TypeScript type
 - [LocalRuntimeOptions] — TypeScript type