@actioneer/ads 0.5.0 → 0.5.2

package/lib/icons.js

@@ -1,109 +1,111 @@
 "use client";
-import { jsx as r } from "react/jsx-runtime";
-import { HugeiconsIcon as s } from "@hugeicons/react";
-import { Tick02Icon as a, Copy01Icon as i, File02Icon as I, Cancel01Icon as l, Upload01Icon as h, ViewOffIcon as C, ViewIcon as g, MinusSignIcon as p, PlusSignIcon as f, ArrowDown01Icon as d, Search01Icon as u, InformationCircleIcon as k, AlertCircleIcon as w, Alert02Icon as A, CheckmarkCircle02Icon as L, ArrowLeft01Icon as m, ArrowRight01Icon as S, DatabaseIcon as M, Maximize01Icon as O, Magnet01Icon as P, ArrowUp01Icon as T, ArrowUpDownIcon as U, InboxIcon as B, ArrowLeft02Icon as D, MoreHorizontalIcon as y, SparklesIcon as F, Wrench01Icon as R, CancelCircleIcon as b, Clock01Icon as x, CircleDashedIcon as H, RefreshIcon as v, Attachment01Icon as G, QuoteDownIcon as V, BrainIcon as z, Loading03Icon as E, AtIcon as W, BoltIcon as N, Table01Icon as Q, File01Icon as j, Download01Icon as q, Image01Icon as J, BracesIcon as K, MusicNote01Icon as X, Video01Icon as Y, ImageNotFound01Icon as Z, Activity01Icon as _, AiChat02Icon as $, ArrowDown02Icon as oo, ArrowRight02Icon as no, ArrowUp02Icon as co, Route01Icon as eo, BlocksIcon as to, BookOpen01Icon as ro, Calendar01Icon as so, Call02Icon as ao, CheckListIcon as io, CodeIcon as Io, ComponentIcon as lo, LinkSquare02Icon as ho, Folder01Icon as Co, FolderOpenIcon as go, DashboardSpeed01Icon as po, GitBranchIcon as fo, HashtagIcon as uo, HistoryIcon as ko, Home01Icon as wo, ImageUploadIcon as Ao, GridViewIcon as Lo, Leaf01Icon as mo, Idea01Icon as So, Link01Icon as Mo, Logout01Icon as Oo, Mail01Icon as Po, Mic01Icon as To, MicOff01Icon as Uo, MoreVerticalIcon as Bo, PaintBoardIcon as Do, SidebarLeftIcon as yo, PencilEdit02Icon as Fo, PhoneOff01Icon as Ro, PieChartIcon as bo, PlugSocketIcon as xo, RocketIcon as Ho, Settings01Icon as vo, ShapesIcon as Go, Share01Icon as Vo, StarIcon as zo, StopIcon as Eo, Target01Icon as Wo, Telescope01Icon as No, TextFontIcon as Qo, ToggleOnIcon as jo, Delete02Icon as qo, UserIcon as Jo, UserGroupIcon as Ko, ArrowUpRight01Icon as Xo } from "@hugeicons/core-free-icons";
+import { jsx as s } from "react/jsx-runtime";
+import { HugeiconsIcon as r } from "@hugeicons/react";
+import { Tick02Icon as a, Copy01Icon as i, File02Icon as I, Cancel01Icon as l, Upload01Icon as h, ViewOffIcon as C, ViewIcon as g, MinusSignIcon as p, PlusSignIcon as f, ArrowDown01Icon as d, Search01Icon as u, InformationCircleIcon as k, AlertCircleIcon as w, Alert02Icon as A, CheckmarkCircle02Icon as L, ArrowLeft01Icon as m, ArrowRight01Icon as S, DatabaseIcon as P, Maximize01Icon as M, Magnet01Icon as O, ArrowUp01Icon as T, ArrowUpDownIcon as U, InboxIcon as y, ArrowLeft02Icon as B, MoreHorizontalIcon as D, SparklesIcon as F, Wrench01Icon as R, CancelCircleIcon as b, Clock01Icon as x, CircleDashedIcon as H, RefreshIcon as v, Attachment01Icon as G, QuoteDownIcon as V, BrainIcon as z, Loading03Icon as E, AtIcon as W, BoltIcon as N, Table01Icon as Q, File01Icon as j, Download01Icon as q, Image01Icon as J, BracesIcon as K, MusicNote01Icon as X, Video01Icon as Y, ImageNotFound01Icon as Z, Activity01Icon as _, AiChat02Icon as $, ArrowDown02Icon as oo, ArrowRight02Icon as no, ArrowUp02Icon as co, Route01Icon as eo, BlocksIcon as to, BookOpen01Icon as so, Calendar01Icon as ro, Call02Icon as ao, CheckListIcon as io, CodeIcon as Io, ComponentIcon as lo, LinkSquare02Icon as ho, Folder01Icon as Co, FolderOpenIcon as go, DashboardSpeed01Icon as po, GitBranchIcon as fo, HashtagIcon as uo, HistoryIcon as ko, Home01Icon as wo, ImageUploadIcon as Ao, GridViewIcon as Lo, Leaf01Icon as mo, Idea01Icon as So, Link01Icon as Po, Logout01Icon as Mo, Mail01Icon as Oo, Mic01Icon as To, MicOff01Icon as Uo, MoreVerticalIcon as yo, PaintBoardIcon as Bo, SidebarLeftIcon as Do, PauseIcon as Fo, PencilEdit02Icon as Ro, PhoneOff01Icon as bo, PieChartIcon as xo, PlayIcon as Ho, PlugSocketIcon as vo, RocketIcon as Go, Settings01Icon as Vo, ShapesIcon as zo, Share01Icon as Eo, StarIcon as Wo, StopIcon as No, Target01Icon as Qo, Telescope01Icon as jo, TextFontIcon as qo, ToggleOnIcon as Jo, Delete02Icon as Ko, UserIcon as Xo, UserGroupIcon as Yo, ArrowUpRight01Icon as Zo } from "@hugeicons/core-free-icons";
 function o(c, e) {
   function n(t) {
-    return /* @__PURE__ */ r(s, { icon: c, size: "1em", ...t });
+    return /* @__PURE__ */ s(r, { icon: c, size: "1em", ...t });
   }
   return n.displayName = e, n;
 }
-const $o = o(oo, "ArrowDown"), on = o(D, "ArrowLeft"), nn = o(no, "ArrowRight"), cn = o(co, "ArrowUp"), en = o(Xo, "ArrowUpRight"), tn = o(d, "ChevronDown"), rn = o(m, "ChevronLeft"), sn = o(S, "ChevronRight"), an = o(T, "ChevronUp"), In = o(U, "SortIcon"), ln = o(ho, "ExternalLink"), hn = o(yo, "PanelLeft"), Cn = o(W, "At"), gn = o(ao, "Call"), pn = o(l, "Close"), fn = o(b, "CloseCircle"), dn = o(i, "Copy"), un = o(q, "Download"), kn = o(Oo, "LogOut"), wn = o(To, "Mic"), An = o(Uo, "MicOff"), Ln = o(Ro, "PhoneOff"), mn = o(Fo, "Pencil"), Sn = o(V, "Quote"), Mn = o(g, "Eye"), On = o(C, "EyeOff"), Pn = o(uo, "Hash"), Tn = o(Ao, "ImageUpload"), Un = o(h, "Upload"), Bn = o(Qo, "TextFont"), Dn = o(jo, "ToggleOn"), yn = o(so, "Calendar"), Fn = o(x, "Clock"), Rn = o(Io, "Code"), bn = o(Eo, "Stop"), xn = o(P, "Magnet"), Hn = o(O, "Maximize"), vn = o(p, "Minus"), Gn = o(y, "MoreHorizontal"), Vn = o(Bo, "MoreVertical"), zn = o(Mo, "Link"), En = o(f, "Plus"), Wn = o(v, "Refresh"), Nn = o(eo, "AuditTrail"), Qn = o(u, "Search"), jn = o(Vo, "Share"), qn = o(qo, "Trash"), Jn = o(a, "Check"), Kn = o(E, "Loader"), Xn = o(L, "CheckCircle"), Yn = o(k, "Info"), Zn = o(A, "Warning"), _n = o(w, "WarningCircle"), $n = o(_, "Activity"), oc = o($, "AgentChat"), nc = o(N, "Bolt"), cc = o(ro, "BookOpen"), ec = o(z, "Brain"), tc = o(io, "CheckList"), rc = o(lo, "Component"), sc = o(M, "Database"), ac = o(Q, "Table"), ic = o(j, "File"), Ic = o(I, "FileText"), lc = o(Co, "Folder"), hc = o(J, "Image"), Cc = o(Z, "ImageOff"), gc = o(X, "Music"), pc = o(Y, "Video"), fc = o(K, "Braces"), dc = o(go, "FolderOpen"), uc = o(po, "Gauge"), kc = o(fo, "GitBranch"), wc = o(ko, "HistoryClock"), Ac = o(wo, "Home"), Lc = o(to, "Blocks"), mc = o(B, "Inbox"), Sc = o(So, "Lightbulb"), Mc = o(mo, "Leaf"), Oc = o(Lo, "LayoutGrid"), Pc = o(Po, "Mail"), Tc = o(Do, "Palette"), Uc = o(bo, "PieChart"), Bc = o(xo, "Plug"), Dc = o(Ho, "Rocket"), yc = o(vo, "Settings"), Fc = o(Go, "Shapes"), Rc = o(F, "Sparkles"), bc = o(zo, "Star"), xc = o(No, "Telescope"), Hc = o(Wo, "Target"), vc = o(Jo, "User"), Gc = o(Ko, "Users"), Vc = o(G, "Paperclip"), zc = o(H, "CircleDashed"), Ec = o(R, "Wrench");
+const nn = o(oo, "ArrowDown"), cn = o(B, "ArrowLeft"), en = o(no, "ArrowRight"), tn = o(co, "ArrowUp"), sn = o(Zo, "ArrowUpRight"), rn = o(d, "ChevronDown"), an = o(m, "ChevronLeft"), In = o(S, "ChevronRight"), ln = o(T, "ChevronUp"), hn = o(U, "SortIcon"), Cn = o(ho, "ExternalLink"), gn = o(Do, "PanelLeft"), pn = o(W, "At"), fn = o(ao, "Call"), dn = o(l, "Close"), un = o(b, "CloseCircle"), kn = o(i, "Copy"), wn = o(q, "Download"), An = o(Mo, "LogOut"), Ln = o(To, "Mic"), mn = o(Uo, "MicOff"), Sn = o(bo, "PhoneOff"), Pn = o(Ro, "Pencil"), Mn = o(V, "Quote"), On = o(g, "Eye"), Tn = o(C, "EyeOff"), Un = o(uo, "Hash"), yn = o(Ao, "ImageUpload"), Bn = o(h, "Upload"), Dn = o(qo, "TextFont"), Fn = o(Jo, "ToggleOn"), Rn = o(ro, "Calendar"), bn = o(x, "Clock"), xn = o(Io, "Code"), Hn = o(No, "Stop"), vn = o(O, "Magnet"), Gn = o(M, "Maximize"), Vn = o(p, "Minus"), zn = o(D, "MoreHorizontal"), En = o(yo, "MoreVertical"), Wn = o(Po, "Link"), Nn = o(f, "Plus"), Qn = o(v, "Refresh"), jn = o(eo, "AuditTrail"), qn = o(u, "Search"), Jn = o(Eo, "Share"), Kn = o(Ko, "Trash"), Xn = o(a, "Check"), Yn = o(E, "Loader"), Zn = o(L, "CheckCircle"), _n = o(k, "Info"), $n = o(A, "Warning"), oc = o(w, "WarningCircle"), nc = o(_, "Activity"), cc = o($, "AgentChat"), ec = o(N, "Bolt"), tc = o(so, "BookOpen"), sc = o(z, "Brain"), rc = o(io, "CheckList"), ac = o(lo, "Component"), ic = o(P, "Database"), Ic = o(Q, "Table"), lc = o(j, "File"), hc = o(I, "FileText"), Cc = o(Co, "Folder"), gc = o(J, "Image"), pc = o(Z, "ImageOff"), fc = o(X, "Music"), dc = o(Y, "Video"), uc = o(K, "Braces"), kc = o(go, "FolderOpen"), wc = o(po, "Gauge"), Ac = o(fo, "GitBranch"), Lc = o(ko, "HistoryClock"), mc = o(wo, "Home"), Sc = o(to, "Blocks"), Pc = o(y, "Inbox"), Mc = o(So, "Lightbulb"), Oc = o(mo, "Leaf"), Tc = o(Lo, "LayoutGrid"), Uc = o(Oo, "Mail"), yc = o(Bo, "Palette"), Bc = o(xo, "PieChart"), Dc = o(vo, "Plug"), Fc = o(Go, "Rocket"), Rc = o(Vo, "Settings"), bc = o(zo, "Shapes"), xc = o(F, "Sparkles"), Hc = o(Wo, "Star"), vc = o(jo, "Telescope"), Gc = o(Qo, "Target"), Vc = o(Xo, "User"), zc = o(Yo, "Users"), Ec = o(Ho, "Play"), Wc = o(Fo, "Pause"), Nc = o(G, "Paperclip"), Qc = o(H, "CircleDashed"), jc = o(R, "Wrench");
 export {
-  $n as Activity,
-  oc as AgentChat,
-  $o as ArrowDown,
-  on as ArrowLeft,
-  nn as ArrowRight,
-  cn as ArrowUp,
-  en as ArrowUpRight,
-  Cn as At,
-  Nn as AuditTrail,
-  Lc as Blocks,
-  nc as Bolt,
-  cc as BookOpen,
-  fc as Braces,
-  ec as Brain,
-  yn as Calendar,
-  gn as Call,
-  Jn as Check,
-  Xn as CheckCircle,
-  tc as CheckList,
-  tn as ChevronDown,
-  rn as ChevronLeft,
-  sn as ChevronRight,
-  an as ChevronUp,
-  zc as CircleDashed,
-  Fn as Clock,
-  pn as Close,
-  fn as CloseCircle,
-  Rn as Code,
-  rc as Component,
-  dn as Copy,
-  sc as Database,
-  un as Download,
-  ln as ExternalLink,
-  Mn as Eye,
-  On as EyeOff,
-  ic as File,
-  Ic as FileText,
-  lc as Folder,
-  dc as FolderOpen,
-  uc as Gauge,
-  kc as GitBranch,
-  Pn as Hash,
-  wc as HistoryClock,
-  Ac as Home,
-  hc as Image,
-  Cc as ImageOff,
-  Tn as ImageUpload,
-  mc as Inbox,
-  Yn as Info,
-  Oc as LayoutGrid,
-  Mc as Leaf,
-  Sc as Lightbulb,
-  zn as Link,
-  Kn as Loader,
-  kn as LogOut,
-  xn as Magnet,
-  Pc as Mail,
-  Hn as Maximize,
-  wn as Mic,
-  An as MicOff,
-  vn as Minus,
-  Gn as MoreHorizontal,
-  Vn as MoreVertical,
-  gc as Music,
-  Tc as Palette,
-  hn as PanelLeft,
-  Vc as Paperclip,
-  mn as Pencil,
-  Ln as PhoneOff,
-  Uc as PieChart,
-  Bc as Plug,
-  En as Plus,
-  Sn as Quote,
-  Wn as Refresh,
-  Dc as Rocket,
-  Qn as Search,
-  yc as Settings,
-  Fc as Shapes,
-  jn as Share,
-  In as SortIcon,
-  Rc as Sparkles,
-  bc as Star,
-  bn as Stop,
-  ac as Table,
-  Hc as Target,
-  xc as Telescope,
-  Bn as TextFont,
-  Dn as ToggleOn,
-  qn as Trash,
-  Un as Upload,
-  vc as User,
-  Gc as Users,
-  pc as Video,
-  Zn as Warning,
-  _n as WarningCircle,
-  Ec as Wrench
+  nc as Activity,
+  cc as AgentChat,
+  nn as ArrowDown,
+  cn as ArrowLeft,
+  en as ArrowRight,
+  tn as ArrowUp,
+  sn as ArrowUpRight,
+  pn as At,
+  jn as AuditTrail,
+  Sc as Blocks,
+  ec as Bolt,
+  tc as BookOpen,
+  uc as Braces,
+  sc as Brain,
+  Rn as Calendar,
+  fn as Call,
+  Xn as Check,
+  Zn as CheckCircle,
+  rc as CheckList,
+  rn as ChevronDown,
+  an as ChevronLeft,
+  In as ChevronRight,
+  ln as ChevronUp,
+  Qc as CircleDashed,
+  bn as Clock,
+  dn as Close,
+  un as CloseCircle,
+  xn as Code,
+  ac as Component,
+  kn as Copy,
+  ic as Database,
+  wn as Download,
+  Cn as ExternalLink,
+  On as Eye,
+  Tn as EyeOff,
+  lc as File,
+  hc as FileText,
+  Cc as Folder,
+  kc as FolderOpen,
+  wc as Gauge,
+  Ac as GitBranch,
+  Un as Hash,
+  Lc as HistoryClock,
+  mc as Home,
+  gc as Image,
+  pc as ImageOff,
+  yn as ImageUpload,
+  Pc as Inbox,
+  _n as Info,
+  Tc as LayoutGrid,
+  Oc as Leaf,
+  Mc as Lightbulb,
+  Wn as Link,
+  Yn as Loader,
+  An as LogOut,
+  vn as Magnet,
+  Uc as Mail,
+  Gn as Maximize,
+  Ln as Mic,
+  mn as MicOff,
+  Vn as Minus,
+  zn as MoreHorizontal,
+  En as MoreVertical,
+  fc as Music,
+  yc as Palette,
+  gn as PanelLeft,
+  Nc as Paperclip,
+  Wc as Pause,
+  Pn as Pencil,
+  Sn as PhoneOff,
+  Bc as PieChart,
+  Ec as Play,
+  Dc as Plug,
+  Nn as Plus,
+  Mn as Quote,
+  Qn as Refresh,
+  Fc as Rocket,
+  qn as Search,
+  Rc as Settings,
+  bc as Shapes,
+  Jn as Share,
+  hn as SortIcon,
+  xc as Sparkles,
+  Hc as Star,
+  Hn as Stop,
+  Ic as Table,
+  Gc as Target,
+  vc as Telescope,
+  Dn as TextFont,
+  Fn as ToggleOn,
+  Kn as Trash,
+  Bn as Upload,
+  Vc as User,
+  zc as Users,
+  dc as Video,
+  $n as Warning,
+  oc as WarningCircle,
+  jc as Wrench
 };

package/llms.txt

@@ -57,7 +57,7 @@ The house rules for every ADS UI. `[lint]` = `@actioneer/ads-lint` auto-checks i
 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.
 
 - Do: Separate regions by fill color first: bg-background → bg-surface → bg-card/bg-elevated → bg-muted.
-- Do: Keep a subtle border-input/border-border on form controls (input, select, textarea, checkbox, radio, segmented-control track) and floating menus (dropdown, popover, listboxes).
+- 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: Give a filled control no stroke on the tinted canvas — it disappears; it needs a crisp edge.
@@ -167,6 +167,7 @@ When tabs and a search field control the same content, they share one responsive
 
 ### 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)
 - [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 a snippet that owns its own line — a query, config, or tool payload — with an optional filename/language header and copy control; use the inline Code for a token inside a sentence. (variants: variant: soft|plain) [docs](https://ads.actioneer.dev/#/code-block)
@@ -189,6 +190,7 @@ When tabs and a search field control the same content, they share one responsive
 - [Spinner] — Use for an indeterminate loading state (e.g. inside a Button's isLoading, or standalone while content is fetching) — not for measurable/determinate progress. (variants: size: sm|md|lg; color: current|primary|muted) [docs](https://ads.actioneer.dev/#/spinner)
 - [Stepper] — component (variants: status: complete|current|upcoming|error; size: sm|md) [docs](https://ads.actioneer.dev/#/review/stepper)
 - [Text] — Use Text for any body copy, caption, or inline run of prose instead of a raw p/span tag. [docs](https://ads.actioneer.dev/#/typography)
+- [AudioWaveformProps] — TypeScript type
 - [ButtonProps] — TypeScript type
 - [CodeBlockProps] — TypeScript type
 - [DividerProps] — TypeScript type
@@ -252,7 +254,7 @@ When tabs and a search field control the same content, they share one responsive
 ### Overlays
 
 - [CommandPalette] — component [docs](https://ads.actioneer.dev/#/command-palette)
-- [Drawer] — Use the portaled Drawer for a focused, blocking task (form, details, settings) that slides in over the page with a backdrop and focus trap; use InlineDrawer instead for a contextual panel that must stay in-flow beside content the user still needs. The inline Drawer is a flat white panel (bg-card, no shadow, no border) that reads ONLY by fill contrast, so it MUST sit as a sibling of its content inside a bg-surface flex row — on a white (bg-background) parent it is invisible. If it doesn't read, tint the ground; never add a border or shadow to force it. (variants: side: right|left|bottom; size: sm|md|lg|xl) [docs](https://ads.actioneer.dev/#/drawer)
+- [Drawer] — Use the portaled Drawer for a focused, blocking task (form, details, settings) that slides in over the page with a backdrop and focus trap; use InlineDrawer instead for a contextual panel that must stay in-flow beside content the user still needs. The inline Drawer is a flat white panel (bg-card, no shadow, no border) that reads ONLY by fill contrast, so it MUST sit as a sibling of its content inside a bg-surface flex row — on a white (bg-background) parent it is invisible. If it doesn't read, tint the ground; never add a border or shadow to force it. SELECTION-DRIVEN DETAIL RAILS (inspector/detail panels tied to a selected row, node, or category) are CLOSED BY DEFAULT: the slot mounts only while a selection exists and unmounts on deselect. Never render a placeholder rail ('Select a row to see details') — an empty rail is chrome that claims space and implies a selection the user hasn't made. Header anatomy when open: uppercase kicker (what kind of thing is selected) + title + close affordance, then a scrollable body. Never hand-roll the panel with translate-x + backdrop — that's this component. (variants: side: right|left|bottom; size: sm|md|lg|xl) [docs](https://ads.actioneer.dev/#/drawer)
 - [DrawerBody] — component (variants: side: right|left|bottom; size: sm|md|lg|xl) [docs](https://ads.actioneer.dev/#/drawer)
 - [DrawerFooter] — component (variants: side: right|left|bottom; size: sm|md|lg|xl) [docs](https://ads.actioneer.dev/#/drawer)
 - [DrawerHeader] — component (variants: side: right|left|bottom; size: sm|md|lg|xl) [docs](https://ads.actioneer.dev/#/drawer)
@@ -343,7 +345,7 @@ When tabs and a search field control the same content, they share one responsive
 - [ScatterChart] — component [docs](https://ads.actioneer.dev/#/ai/chart)
 - [StatusAnswer] — component (variants: tone: default|primary|success|warning|danger|info) [docs](https://ads.actioneer.dev/#/ai/answer)
 - [Tab] — component (variants: variant: primary|secondary; 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. [docs](https://ads.actioneer.dev/#/table)
+- [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)
 - [TableBody] — component [docs](https://ads.actioneer.dev/#/table)
 - [TableCell] — component [docs](https://ads.actioneer.dev/#/table)
 - [TableColumn] — component [docs](https://ads.actioneer.dev/#/table)
@@ -498,7 +500,7 @@ When tabs and a search field control the same content, they share one responsive
 ### Navigation
 
 - [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. [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)
@@ -623,6 +625,7 @@ When tabs and a search field control the same content, they share one responsive
 - [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)
+- [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)
@@ -720,6 +723,9 @@ When tabs and a search field control the same content, they share one responsive
 - [ToolOutputProps] — TypeScript type
 - [ToolProps] — TypeScript type
 - [ToolState] — TypeScript type
+- [TranscriptProps] — TypeScript type
+- [TranscriptTone] — TypeScript type
+- [TranscriptTurn] — TypeScript type
 - [VoiceConnectButtonProps] — TypeScript type
 - [VoiceControlProps] — TypeScript type
 - [VoiceDisconnectButtonProps] — TypeScript type

package/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "@actioneer/ads",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "importPath": "@actioneer/ads",
   "styleImport": "@import \"@actioneer/ads/styles.css\";",
   "families": [
@@ -16,9 +16,9 @@
     "Chat"
   ],
   "counts": {
-    "total": 678,
-    "component": 327,
-    "type": 288,
+    "total": 684,
+    "component": 329,
+    "type": 292,
     "hook": 10,
     "util": 53
   },
@@ -362,6 +362,24 @@
       "importPath": "@actioneer/ads",
       "module": "interactive"
     },
+    {
+      "name": "AudioWaveform",
+      "family": "Foundations",
+      "kind": "component",
+      "importPath": "@actioneer/ads",
+      "module": "audio-waveform",
+      "showcaseUrl": "https://ads.actioneer.dev/#/audio-waveform",
+      "props": [
+        "src",
+        "durationSeconds",
+        "contentType",
+        "channels",
+        "topLabel",
+        "bottomLabel",
+        "downloadName",
+        "className"
+      ]
+    },
     {
       "name": "Button",
       "family": "Foundations",
@@ -756,6 +774,13 @@
         "as"
       ]
     },
+    {
+      "name": "AudioWaveformProps",
+      "family": "Foundations",
+      "kind": "type",
+      "importPath": "@actioneer/ads",
+      "module": "audio-waveform"
+    },
     {
       "name": "ButtonProps",
       "family": "Foundations",
@@ -1318,7 +1343,7 @@
       "kind": "component",
       "importPath": "@actioneer/ads",
       "module": "drawer",
-      "description": "Use the portaled Drawer for a focused, blocking task (form, details, settings) that slides in over the page with a backdrop and focus trap; use InlineDrawer instead for a contextual panel that must stay in-flow beside content the user still needs. The inline Drawer is a flat white panel (bg-card, no shadow, no border) that reads ONLY by fill contrast, so it MUST sit as a sibling of its content inside a bg-surface flex row — on a white (bg-background) parent it is invisible. If it doesn't read, tint the ground; never add a border or shadow to force it.",
+      "description": "Use the portaled Drawer for a focused, blocking task (form, details, settings) that slides in over the page with a backdrop and focus trap; use InlineDrawer instead for a contextual panel that must stay in-flow beside content the user still needs. The inline Drawer is a flat white panel (bg-card, no shadow, no border) that reads ONLY by fill contrast, so it MUST sit as a sibling of its content inside a bg-surface flex row — on a white (bg-background) parent it is invisible. If it doesn't read, tint the ground; never add a border or shadow to force it. SELECTION-DRIVEN DETAIL RAILS (inspector/detail panels tied to a selected row, node, or category) are CLOSED BY DEFAULT: the slot mounts only while a selection exists and unmounts on deselect. Never render a placeholder rail ('Select a row to see details') — an empty rail is chrome that claims space and implies a selection the user hasn't made. Header anatomy when open: uppercase kicker (what kind of thing is selected) + title + close affordance, then a scrollable body. Never hand-roll the panel with translate-x + backdrop — that's this component.",
       "showcaseUrl": "https://ads.actioneer.dev/#/drawer",
       "variants": {
         "side": {
@@ -2600,7 +2625,7 @@
       "kind": "component",
       "importPath": "@actioneer/ads",
       "module": "table",
-      "description": "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.",
+      "description": "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.",
       "showcaseUrl": "https://ads.actioneer.dev/#/table",
       "props": [
         "wrapperClassName",
@@ -2609,6 +2634,8 @@
         "selectedKeys",
         "onSelectionChange",
         "rowKeys",
+        "elevatedActionColumn",
+        "actionColumnWidth",
         "sortDescriptor",
         "onSortChange"
       ]
@@ -3986,7 +4013,7 @@
       "kind": "component",
       "importPath": "@actioneer/ads",
       "module": "breadcrumbs",
-      "description": "Use to show a page's location in a hierarchy as a trail of parent links ending in the current page.",
+      "description": "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.",
       "showcaseUrl": "https://ads.actioneer.dev/#/breadcrumbs"
     },
     {
@@ -5399,6 +5426,20 @@
       "module": "tool",
       "showcaseUrl": "https://ads.actioneer.dev/#/ai/tool"
     },
+    {
+      "name": "Transcript",
+      "family": "AI Elements",
+      "kind": "component",
+      "importPath": "@actioneer/ads",
+      "module": "transcript",
+      "showcaseUrl": "https://ads.actioneer.dev/#/ai/transcript",
+      "props": [
+        "turns",
+        "agentLabel",
+        "userLabel",
+        "emptyMessage"
+      ]
+    },
     {
       "name": "Voice",
       "family": "AI Elements",
@@ -6124,6 +6165,27 @@
       "importPath": "@actioneer/ads",
       "module": "tool"
     },
+    {
+      "name": "TranscriptProps",
+      "family": "AI Elements",
+      "kind": "type",
+      "importPath": "@actioneer/ads",
+      "module": "transcript"
+    },
+    {
+      "name": "TranscriptTone",
+      "family": "AI Elements",
+      "kind": "type",
+      "importPath": "@actioneer/ads",
+      "module": "transcript"
+    },
+    {
+      "name": "TranscriptTurn",
+      "family": "AI Elements",
+      "kind": "type",
+      "importPath": "@actioneer/ads",
+      "module": "transcript"
+    },
     {
       "name": "VoiceConnectButtonProps",
       "family": "AI Elements",
@@ -7462,7 +7524,7 @@
       "rule": "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.",
       "do": [
         "Separate regions by fill color first: bg-background → bg-surface → bg-card/bg-elevated → bg-muted.",
-        "Keep a subtle border-input/border-border on form controls (input, select, textarea, checkbox, radio, segmented-control track) and floating menus (dropdown, popover, listboxes).",
+        "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).",
         "Keep strokes on focus rings, the outline Button/Badge/Chip variants, Kbd, Divider, the Tree connector rail, and functional color swatches."
       ],
       "dont": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@actioneer/ads",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "Actioneer Design System 1.0 — React 19 + Tailwind v4 component library.",
   "type": "module",
   "sideEffects": [

package/styles.css

@@ -296,16 +296,28 @@
   --color-overlay: var(--overlay);
 
   /*
-   * shadcn-compat aliases — consumed ONLY by the vendored chat components
-   * (src/components/ui, src/components/assistant-ui). ADS UI never uses
-   * these; they map shadcn's expected roles onto ADS tokens.
+   * shadcn-compat aliases — map shadcn's expected color roles onto ADS tokens.
+   * ADS's own UI never uses these; they exist for the vendored chat components
+   * (src/components/ui, src/components/assistant-ui) AND for downstream shadcn
+   * consumers, so a shadcn Sidebar/Popover picks up the ADS palette instead of
+   * shadcn's grey/black defaults. The raw --sidebar-*/--popover values live in
+   * :root below.
    */
   --color-primary-foreground: var(--brand-foreground);
   --color-secondary-foreground: #ffffff;
   --color-destructive: var(--color-danger-600);
   --color-destructive-foreground: #ffffff;
-  --color-popover: var(--elevated);
-  --color-popover-foreground: var(--foreground);
+  --color-popover: var(--popover);
+  --color-popover-foreground: var(--popover-foreground);
+
+  --color-sidebar: var(--sidebar);
+  --color-sidebar-foreground: var(--sidebar-foreground);
+  --color-sidebar-primary: var(--sidebar-primary);
+  --color-sidebar-primary-foreground: var(--sidebar-primary-foreground);
+  --color-sidebar-accent: var(--sidebar-accent);
+  --color-sidebar-accent-foreground: var(--sidebar-accent-foreground);
+  --color-sidebar-border: var(--sidebar-border);
+  --color-sidebar-ring: var(--sidebar-ring);
 }
 
 /* ---- Theme (light only) ---- */
@@ -333,6 +345,12 @@
   --brand-foreground: #ffffff;
   --brand-hover: #2c5724;
 
+  /* Table interaction fills are pre-composited and opaque. Sticky edge cells
+     therefore cover horizontally scrolled content while preserving the
+     original quiet bg-card/40-over-muted row hover. */
+  --table-row-hover: color-mix(in srgb, var(--card) 40%, var(--muted));
+  --table-row-selected: color-mix(in srgb, var(--card) 10%, var(--muted));
+
   /* Quiet fill */
   --fill: #e7e7e1;
   --fill-foreground: #1a1a17;
@@ -345,6 +363,22 @@
   --input: #c7c6be;
   --ring: rgb(63 122 52 / 0.5);
   --overlay: rgb(26 26 23 / 0.5);
+
+  /* shadcn-compat raw surfaces — so a downstream shadcn Sidebar / Popover
+     (or an inline `var(--sidebar)` / `var(--popover)`) resolves to the ADS
+     palette instead of shadcn's grey/black defaults. The sidebar reads as the
+     warm greige canvas; its active item takes Sage. A consumer that had
+     hard-coded these can now delete its overrides and inherit from here. */
+  --sidebar: var(--surface);
+  --sidebar-foreground: var(--foreground);
+  --sidebar-primary: var(--brand);
+  --sidebar-primary-foreground: var(--brand-foreground);
+  --sidebar-accent: var(--muted);
+  --sidebar-accent-foreground: var(--foreground);
+  --sidebar-border: var(--border);
+  --sidebar-ring: var(--ring);
+  --popover: var(--elevated);
+  --popover-foreground: var(--foreground);
 }
 /* ---- Base, keyframes & component helpers ---- */
 /* Hide scrollbars app-wide but keep scrollability. The demo UI is filled

package/theme.css

@@ -269,16 +269,28 @@
   --color-overlay: var(--overlay);
 
   /*
-   * shadcn-compat aliases — consumed ONLY by the vendored chat components
-   * (src/components/ui, src/components/assistant-ui). ADS UI never uses
-   * these; they map shadcn's expected roles onto ADS tokens.
+   * shadcn-compat aliases — map shadcn's expected color roles onto ADS tokens.
+   * ADS's own UI never uses these; they exist for the vendored chat components
+   * (src/components/ui, src/components/assistant-ui) AND for downstream shadcn
+   * consumers, so a shadcn Sidebar/Popover picks up the ADS palette instead of
+   * shadcn's grey/black defaults. The raw --sidebar-*/--popover values live in
+   * :root below.
    */
   --color-primary-foreground: var(--brand-foreground);
   --color-secondary-foreground: #ffffff;
   --color-destructive: var(--color-danger-600);
   --color-destructive-foreground: #ffffff;
-  --color-popover: var(--elevated);
-  --color-popover-foreground: var(--foreground);
+  --color-popover: var(--popover);
+  --color-popover-foreground: var(--popover-foreground);
+
+  --color-sidebar: var(--sidebar);
+  --color-sidebar-foreground: var(--sidebar-foreground);
+  --color-sidebar-primary: var(--sidebar-primary);
+  --color-sidebar-primary-foreground: var(--sidebar-primary-foreground);
+  --color-sidebar-accent: var(--sidebar-accent);
+  --color-sidebar-accent-foreground: var(--sidebar-accent-foreground);
+  --color-sidebar-border: var(--sidebar-border);
+  --color-sidebar-ring: var(--sidebar-ring);
 }
 
 /* ---- Theme (light only) ---- */
@@ -306,6 +318,12 @@
   --brand-foreground: #ffffff;
   --brand-hover: #2c5724;
 
+  /* Table interaction fills are pre-composited and opaque. Sticky edge cells
+     therefore cover horizontally scrolled content while preserving the
+     original quiet bg-card/40-over-muted row hover. */
+  --table-row-hover: color-mix(in srgb, var(--card) 40%, var(--muted));
+  --table-row-selected: color-mix(in srgb, var(--card) 10%, var(--muted));
+
   /* Quiet fill */
   --fill: #e7e7e1;
   --fill-foreground: #1a1a17;
@@ -318,4 +336,20 @@
   --input: #c7c6be;
   --ring: rgb(63 122 52 / 0.5);
   --overlay: rgb(26 26 23 / 0.5);
+
+  /* shadcn-compat raw surfaces — so a downstream shadcn Sidebar / Popover
+     (or an inline `var(--sidebar)` / `var(--popover)`) resolves to the ADS
+     palette instead of shadcn's grey/black defaults. The sidebar reads as the
+     warm greige canvas; its active item takes Sage. A consumer that had
+     hard-coded these can now delete its overrides and inherit from here. */
+  --sidebar: var(--surface);
+  --sidebar-foreground: var(--foreground);
+  --sidebar-primary: var(--brand);
+  --sidebar-primary-foreground: var(--brand-foreground);
+  --sidebar-accent: var(--muted);
+  --sidebar-accent-foreground: var(--foreground);
+  --sidebar-border: var(--border);
+  --sidebar-ring: var(--ring);
+  --popover: var(--elevated);
+  --popover-foreground: var(--foreground);
 }