@actioneer/ads 0.5.6 → 0.5.7

package/components/textarea.js

@@ -11,8 +11,7 @@ const n = o.forwardRef(
       "aria-invalid": r || void 0,
       className: s(
         m,
-        // Multi-line: the pill radius single-line controls use would clip
-        // the first/last lines oddly, so textareas stay softly rounded.
+        // Multi-line controls use the 4px surface radius.
         "min-h-20 resize-y rounded-lg py-2 text-xs",
         e
       ),

package/components/tooltip.js

@@ -127,7 +127,7 @@ function Y({
               {
                 "aria-hidden": !0,
                 className: S(
-                  "absolute size-2 rotate-45 rounded-[1px] bg-foreground",
+                  "absolute size-2 rotate-45 rounded-sm bg-foreground",
                   V[a]
                 )
               }

package/components/ui/tooltip.js

@@ -2,7 +2,7 @@
 import { jsx as i, jsxs as n } from "react/jsx-runtime";
 import { Tooltip as o } from "radix-ui";
 import { cn as d } from "../../lib/cn.js";
-function f({
+function m({
   delayDuration: t = 0,
   ...r
 }) {
@@ -15,7 +15,7 @@ function f({
     }
   );
 }
-function m({
+function p({
   ...t
 }) {
   return /* @__PURE__ */ i(o.Root, { "data-slot": "tooltip", ...t });
@@ -43,14 +43,14 @@ function u({
       ...a,
       children: [
         e,
-        /* @__PURE__ */ i(o.Arrow, { className: "z-50 size-2.5 translate-y-[calc(-50%_-_2px)] rotate-45 rounded-[2px] bg-foreground fill-foreground" })
+        /* @__PURE__ */ i(o.Arrow, { className: "z-50 size-2.5 translate-y-[calc(-50%_-_2px)] rotate-45 rounded-sm bg-foreground fill-foreground" })
       ]
     }
   ) });
 }
 export {
-  m as Tooltip,
+  p as Tooltip,
   u as TooltipContent,
-  f as TooltipProvider,
+  m as TooltipProvider,
   c as TooltipTrigger
 };

package/lib/icons.d.ts

@@ -273,6 +273,14 @@ export declare const Table: React.ForwardRefExoticComponent<Omit<import('@phosph
     /** Legacy Hugeicons prop — `>= 2` maps to weight="bold", else ignored. */
     strokeWidth?: number;
 } & React.RefAttributes<SVGSVGElement>>;
+export declare const Filter: React.ForwardRefExoticComponent<Omit<import('@phosphor-icons/react').IconProps, "ref"> & {
+    /** Legacy Hugeicons prop — `>= 2` maps to weight="bold", else ignored. */
+    strokeWidth?: number;
+} & React.RefAttributes<SVGSVGElement>>;
+export declare const Archive: React.ForwardRefExoticComponent<Omit<import('@phosphor-icons/react').IconProps, "ref"> & {
+    /** Legacy Hugeicons prop — `>= 2` maps to weight="bold", else ignored. */
+    strokeWidth?: number;
+} & React.RefAttributes<SVGSVGElement>>;
 export declare const File: React.ForwardRefExoticComponent<Omit<import('@phosphor-icons/react').IconProps, "ref"> & {
     /** Legacy Hugeicons prop — `>= 2` maps to weight="bold", else ignored. */
     strokeWidth?: number;

package/lib/icons.js

@@ -1,7 +1,7 @@
 "use client";
 import { jsx as h } from "react/jsx-runtime";
 import * as C from "react";
-import { ArrowUpRight as g, Code as p, Check as u, Copy as $, FileText as f, X as k, UploadSimple as w, EyeSlash as d, Eye as S, Minus as P, Plus as A, CaretDown as L, MagnifyingGlass as T, Info as m, WarningCircle as M, Warning as y, CheckCircle as U, ChatCircle as O, CaretUp as B, ArrowsDownUp as b, Clock as D, Database as R, CaretLeft as I, CaretRight as F, CornersOut as x, Magnet as H, Tray as v, ArrowLeft as G, DotsThree as W, User as E, XCircle as z, CircleDashed as V, ArrowsClockwise as N, Paperclip as Q, Quotes as q, At as X, Lightning as j, Table as J, Sparkle as K, File as Y, DownloadSimple as Z, Image as s, BracketsCurly as _, MusicNotes as oo, VideoCamera as eo, ImageBroken as to, CircleNotch as so, Pulse as no, ArrowDown as ao, ArrowRight as ro, ArrowUp as co, Scroll as io, Stack as lo, BookOpen as ho, Brain as Co, CalendarBlank as go, Phone as po, ListChecks as uo, Cube as $o, ArrowSquareOut as fo, Folder as ko, FolderOpen as wo, Gauge as So, GitBranch as Po, Hash as Ao, ClockCounterClockwise as Lo, House as To, SquaresFour as mo, Leaf as Mo, Lightbulb as yo, Link as Uo, SignOut as Oo, Envelope as Bo, Microphone as bo, MicrophoneSlash as Do, DotsThreeVertical as Ro, Palette as Io, SidebarSimple as Fo, Pause as xo, PencilSimple as Ho, PhoneSlash as vo, ChartPie as Go, Play as Wo, Plug as Eo, Rocket as zo, Gear as Vo, Shapes as No, ShareNetwork as Qo, Star as qo, Stop as Xo, ArrowsLeftRight as jo, Target as Jo, Binoculars as Ko, TextT as Yo, ToggleRight as Zo, Trash as _o, Users as oe, Wrench as ee } from "@phosphor-icons/react";
+import { ArrowUpRight as g, Code as p, Check as u, Copy as $, FileText as f, X as k, UploadSimple as w, EyeSlash as d, Eye as S, Minus as A, Plus as P, CaretDown as L, MagnifyingGlass as T, Info as m, WarningCircle as M, Warning as y, CheckCircle as U, ChatCircle as O, CaretUp as B, ArrowsDownUp as F, Clock as b, Database as D, ArrowSquareOut as R, Table as I, CaretLeft as v, CaretRight as x, CornersOut as H, Magnet as G, Tray as W, ArrowLeft as E, DotsThree as z, User as V, XCircle as N, CircleDashed as Q, ArrowsClockwise as q, Paperclip as X, Quotes as j, At as J, Lightning as K, Sparkle as Y, File as Z, DownloadSimple as _, Image as s, BracketsCurly as oo, MusicNotes as eo, VideoCamera as to, ImageBroken as so, CircleNotch as no, Pulse as ao, Archive as ro, ArrowDown as co, ArrowRight as io, ArrowUp as lo, Scroll as ho, Stack as Co, BookOpen as go, Brain as po, CalendarBlank as uo, Phone as $o, ListChecks as fo, Cube as ko, Funnel as wo, Folder as So, FolderOpen as Ao, Gauge as Po, GitBranch as Lo, Hash as To, ClockCounterClockwise as mo, House as Mo, SquaresFour as yo, Leaf as Uo, Lightbulb as Oo, Link as Bo, SignOut as Fo, Envelope as bo, Microphone as Do, MicrophoneSlash as Ro, DotsThreeVertical as Io, Palette as vo, SidebarSimple as xo, Pause as Ho, PencilSimple as Go, PhoneSlash as Wo, ChartPie as Eo, Play as zo, Plug as Vo, Rocket as No, Gear as Qo, Shapes as qo, ShareNetwork as Xo, Star as jo, Stop as Jo, ArrowsLeftRight as Ko, Target as Yo, Binoculars as Zo, TextT as _o, ToggleRight as oe, Trash as ee, Users as te, Wrench as se } from "@phosphor-icons/react";
 function o(n, a) {
   const e = C.forwardRef(function({ strokeWidth: t, weight: r, ...c }, i) {
     const l = r ?? (t != null && t >= 2 ? "bold" : "regular");
@@ -9,105 +9,107 @@ function o(n, a) {
   });
   return e.displayName = a, e;
 }
-const ae = o(ao, "ArrowDown"), re = o(G, "ArrowLeft"), ce = o(ro, "ArrowRight"), ie = o(co, "ArrowUp"), le = o(g, "ArrowUpRight"), he = o(L, "ChevronDown"), Ce = o(I, "ChevronLeft"), ge = o(F, "ChevronRight"), pe = o(B, "ChevronUp"), ue = o(b, "SortIcon"), $e = o(jo, "SwapHorizontal"), fe = o(fo, "ExternalLink"), ke = o(Fo, "PanelLeft"), we = o(X, "At"), de = o(po, "Call"), Se = o(k, "Close"), Pe = o(z, "CloseCircle"), Ae = o($, "Copy"), Le = o(Z, "Download"), Te = o(Oo, "LogOut"), me = o(bo, "Mic"), Me = o(Do, "MicOff"), ye = o(vo, "PhoneOff"), Ue = o(Ho, "Pencil"), Oe = o(q, "Quote"), Be = o(S, "Eye"), be = o(d, "EyeOff"), De = o(Ao, "Hash"), Re = o(s, "ImageUpload"), Ie = o(w, "Upload"), Fe = o(Yo, "TextFont"), xe = o(Zo, "ToggleOn"), He = o(go, "Calendar"), ve = o(D, "Clock"), Ge = o(p, "Code"), We = o(Xo, "Stop"), Ee = o(H, "Magnet"), ze = o(x, "Maximize"), Ve = o(P, "Minus"), Ne = o(W, "MoreHorizontal"), Qe = o(Ro, "MoreVertical"), qe = o(Uo, "Link"), Xe = o(A, "Plus"), je = o(N, "Refresh"), Je = o(io, "AuditTrail"), Ke = o(T, "Search"), Ye = o(Qo, "Share"), Ze = o(_o, "Trash"), _e = o(u, "Check"), ot = o(so, "Loader"), et = o(U, "CheckCircle"), tt = o(m, "Info"), st = o(y, "Warning"), nt = o(M, "WarningCircle"), at = o(no, "Activity"), rt = o(O, "AgentChat"), ct = o(j, "Bolt"), it = o(ho, "BookOpen"), lt = o(Co, "Brain"), ht = o(uo, "CheckList"), Ct = o($o, "Component"), gt = o(R, "Database"), pt = o(J, "Table"), ut = o(Y, "File"), $t = o(f, "FileText"), ft = o(ko, "Folder"), kt = o(s, "Image"), wt = o(to, "ImageOff"), dt = o(oo, "Music"), St = o(eo, "Video"), Pt = o(_, "Braces"), At = o(wo, "FolderOpen"), Lt = o(So, "Gauge"), Tt = o(Po, "GitBranch"), mt = o(Lo, "HistoryClock"), Mt = o(To, "Home"), yt = o(lo, "Blocks"), Ut = o(v, "Inbox"), Ot = o(yo, "Lightbulb"), Bt = o(Mo, "Leaf"), bt = o(mo, "LayoutGrid"), Dt = o(Bo, "Mail"), Rt = o(Io, "Palette"), It = o(Go, "PieChart"), Ft = o(Eo, "Plug"), xt = o(zo, "Rocket"), Ht = o(Vo, "Settings"), vt = o(No, "Shapes"), Gt = o(K, "Sparkles"), Wt = o(qo, "Star"), Et = o(Ko, "Telescope"), zt = o(Jo, "Target"), Vt = o(E, "User"), Nt = o(oe, "Users"), Qt = o(Wo, "Play"), qt = o(xo, "Pause"), Xt = o(Q, "Paperclip"), jt = o(V, "CircleDashed"), Jt = o(ee, "Wrench");
+const ce = o(co, "ArrowDown"), ie = o(E, "ArrowLeft"), le = o(io, "ArrowRight"), he = o(lo, "ArrowUp"), Ce = o(g, "ArrowUpRight"), ge = o(L, "ChevronDown"), pe = o(v, "ChevronLeft"), ue = o(x, "ChevronRight"), $e = o(B, "ChevronUp"), fe = o(F, "SortIcon"), ke = o(Ko, "SwapHorizontal"), we = o(R, "ExternalLink"), de = o(xo, "PanelLeft"), Se = o(J, "At"), Ae = o($o, "Call"), Pe = o(k, "Close"), Le = o(N, "CloseCircle"), Te = o($, "Copy"), me = o(_, "Download"), Me = o(Fo, "LogOut"), ye = o(Do, "Mic"), Ue = o(Ro, "MicOff"), Oe = o(Wo, "PhoneOff"), Be = o(Go, "Pencil"), Fe = o(j, "Quote"), be = o(S, "Eye"), De = o(d, "EyeOff"), Re = o(To, "Hash"), Ie = o(s, "ImageUpload"), ve = o(w, "Upload"), xe = o(_o, "TextFont"), He = o(oe, "ToggleOn"), Ge = o(uo, "Calendar"), We = o(b, "Clock"), Ee = o(p, "Code"), ze = o(Jo, "Stop"), Ve = o(G, "Magnet"), Ne = o(H, "Maximize"), Qe = o(A, "Minus"), qe = o(z, "MoreHorizontal"), Xe = o(Io, "MoreVertical"), je = o(Bo, "Link"), Je = o(P, "Plus"), Ke = o(q, "Refresh"), Ye = o(ho, "AuditTrail"), Ze = o(T, "Search"), _e = o(Xo, "Share"), ot = o(ee, "Trash"), et = o(u, "Check"), tt = o(no, "Loader"), st = o(U, "CheckCircle"), nt = o(m, "Info"), at = o(y, "Warning"), rt = o(M, "WarningCircle"), ct = o(ao, "Activity"), it = o(O, "AgentChat"), lt = o(K, "Bolt"), ht = o(go, "BookOpen"), Ct = o(po, "Brain"), gt = o(fo, "CheckList"), pt = o(ko, "Component"), ut = o(D, "Database"), $t = o(I, "Table"), ft = o(wo, "Filter"), kt = o(ro, "Archive"), wt = o(Z, "File"), dt = o(f, "FileText"), St = o(So, "Folder"), At = o(s, "Image"), Pt = o(so, "ImageOff"), Lt = o(eo, "Music"), Tt = o(to, "Video"), mt = o(oo, "Braces"), Mt = o(Ao, "FolderOpen"), yt = o(Po, "Gauge"), Ut = o(Lo, "GitBranch"), Ot = o(mo, "HistoryClock"), Bt = o(Mo, "Home"), Ft = o(Co, "Blocks"), bt = o(W, "Inbox"), Dt = o(Oo, "Lightbulb"), Rt = o(Uo, "Leaf"), It = o(yo, "LayoutGrid"), vt = o(bo, "Mail"), xt = o(vo, "Palette"), Ht = o(Eo, "PieChart"), Gt = o(Vo, "Plug"), Wt = o(No, "Rocket"), Et = o(Qo, "Settings"), zt = o(qo, "Shapes"), Vt = o(Y, "Sparkles"), Nt = o(jo, "Star"), Qt = o(Zo, "Telescope"), qt = o(Yo, "Target"), Xt = o(V, "User"), jt = o(te, "Users"), Jt = o(zo, "Play"), Kt = o(Ho, "Pause"), Yt = o(X, "Paperclip"), Zt = o(Q, "CircleDashed"), _t = o(se, "Wrench");
 export {
-  at as Activity,
-  rt as AgentChat,
-  ae as ArrowDown,
-  re as ArrowLeft,
-  ce as ArrowRight,
-  ie as ArrowUp,
-  le as ArrowUpRight,
-  we as At,
-  Je as AuditTrail,
-  yt as Blocks,
-  ct as Bolt,
-  it as BookOpen,
-  Pt as Braces,
-  lt as Brain,
-  He as Calendar,
-  de as Call,
-  _e as Check,
-  et as CheckCircle,
-  ht as CheckList,
-  he as ChevronDown,
-  Ce as ChevronLeft,
-  ge as ChevronRight,
-  pe as ChevronUp,
-  jt as CircleDashed,
-  ve as Clock,
-  Se as Close,
-  Pe as CloseCircle,
-  Ge as Code,
-  Ct as Component,
-  Ae as Copy,
-  gt as Database,
-  Le as Download,
-  fe as ExternalLink,
-  Be as Eye,
-  be as EyeOff,
-  ut as File,
-  $t as FileText,
-  ft as Folder,
-  At as FolderOpen,
-  Lt as Gauge,
-  Tt as GitBranch,
-  De as Hash,
-  mt as HistoryClock,
-  Mt as Home,
-  kt as Image,
-  wt as ImageOff,
-  Re as ImageUpload,
-  Ut as Inbox,
-  tt as Info,
-  bt as LayoutGrid,
-  Bt as Leaf,
-  Ot as Lightbulb,
-  qe as Link,
-  ot as Loader,
-  Te as LogOut,
-  Ee as Magnet,
-  Dt as Mail,
-  ze as Maximize,
-  me as Mic,
-  Me as MicOff,
-  Ve as Minus,
-  Ne as MoreHorizontal,
-  Qe as MoreVertical,
-  dt as Music,
-  Rt as Palette,
-  ke as PanelLeft,
-  Xt as Paperclip,
-  qt as Pause,
-  Ue as Pencil,
-  ye as PhoneOff,
-  It as PieChart,
-  Qt as Play,
-  Ft as Plug,
-  Xe as Plus,
-  Oe as Quote,
-  je as Refresh,
-  xt as Rocket,
-  Ke as Search,
-  Ht as Settings,
-  vt as Shapes,
-  Ye as Share,
-  ue as SortIcon,
-  Gt as Sparkles,
-  Wt as Star,
-  We as Stop,
-  $e as SwapHorizontal,
-  pt as Table,
-  zt as Target,
-  Et as Telescope,
-  Fe as TextFont,
-  xe as ToggleOn,
-  Ze as Trash,
-  Ie as Upload,
-  Vt as User,
-  Nt as Users,
-  St as Video,
-  st as Warning,
-  nt as WarningCircle,
-  Jt as Wrench
+  ct as Activity,
+  it as AgentChat,
+  kt as Archive,
+  ce as ArrowDown,
+  ie as ArrowLeft,
+  le as ArrowRight,
+  he as ArrowUp,
+  Ce as ArrowUpRight,
+  Se as At,
+  Ye as AuditTrail,
+  Ft as Blocks,
+  lt as Bolt,
+  ht as BookOpen,
+  mt as Braces,
+  Ct as Brain,
+  Ge as Calendar,
+  Ae as Call,
+  et as Check,
+  st as CheckCircle,
+  gt as CheckList,
+  ge as ChevronDown,
+  pe as ChevronLeft,
+  ue as ChevronRight,
+  $e as ChevronUp,
+  Zt as CircleDashed,
+  We as Clock,
+  Pe as Close,
+  Le as CloseCircle,
+  Ee as Code,
+  pt as Component,
+  Te as Copy,
+  ut as Database,
+  me as Download,
+  we as ExternalLink,
+  be as Eye,
+  De as EyeOff,
+  wt as File,
+  dt as FileText,
+  ft as Filter,
+  St as Folder,
+  Mt as FolderOpen,
+  yt as Gauge,
+  Ut as GitBranch,
+  Re as Hash,
+  Ot as HistoryClock,
+  Bt as Home,
+  At as Image,
+  Pt as ImageOff,
+  Ie as ImageUpload,
+  bt as Inbox,
+  nt as Info,
+  It as LayoutGrid,
+  Rt as Leaf,
+  Dt as Lightbulb,
+  je as Link,
+  tt as Loader,
+  Me as LogOut,
+  Ve as Magnet,
+  vt as Mail,
+  Ne as Maximize,
+  ye as Mic,
+  Ue as MicOff,
+  Qe as Minus,
+  qe as MoreHorizontal,
+  Xe as MoreVertical,
+  Lt as Music,
+  xt as Palette,
+  de as PanelLeft,
+  Yt as Paperclip,
+  Kt as Pause,
+  Be as Pencil,
+  Oe as PhoneOff,
+  Ht as PieChart,
+  Jt as Play,
+  Gt as Plug,
+  Je as Plus,
+  Fe as Quote,
+  Ke as Refresh,
+  Wt as Rocket,
+  Ze as Search,
+  Et as Settings,
+  zt as Shapes,
+  _e as Share,
+  fe as SortIcon,
+  Vt as Sparkles,
+  Nt as Star,
+  ze as Stop,
+  ke as SwapHorizontal,
+  $t as Table,
+  qt as Target,
+  Qt as Telescope,
+  xe as TextFont,
+  He as ToggleOn,
+  ot as Trash,
+  ve as Upload,
+  Xt as User,
+  jt as Users,
+  Tt as Video,
+  at as Warning,
+  rt as WarningCircle,
+  _t as Wrench
 };

package/llms.txt

@@ -27,10 +27,10 @@ Reference semantic roles, never raw color/dimension literals (ads-lint rejects l
 - `muted-foreground`
 - `card`
 - `card-foreground`
-- `brand` — Brand (Sage green) — used for solid fills / primary actions, not body text
-- `brand-foreground` — Brand (Sage green) — used for solid fills / primary actions, not body text
-- `brand-hover` — Brand (Sage green) — used for solid fills / primary actions, not body text
-- `brand-text` — Brand (Sage green) — used for solid fills / primary actions, not body text
+- `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
@@ -124,12 +124,13 @@ Every UI decision stays synchronized with ADS. Before making a new screen/contro
 
 ### 8. Minimal information per screen [judgment]
 
-A screen carries ONLY what the user needs to move forward: one title, at most one short supporting line, the inputs, one primary action. Never maximalist. Promote the one message that matters typographically instead of appending muted fine print.
+A screen carries ONLY what the user needs to move forward: one title, the inputs, one primary action. Page, section, panel, modal, dialog, drawer, and popover headers are title-only by default; add a description only when the user explicitly asks for one. Never maximalist.
 
 - 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: 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: Nest panel/step-rail chrome inside a multi-step flow.
 
 ### 9. Responsive = container-fluid components, shells own the width [judgment]
@@ -311,6 +312,10 @@ When tabs and a search field control the same content, they share one responsive
 - [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 separate white shell-level panel beside the answer when a source chip is selected; close and unmount it when the selection clears. [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)
 - [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)
@@ -396,6 +401,10 @@ When tabs and a search field control the same content, they share one responsive
 - [AnswerRendererProps] — TypeScript type
 - [AnswerSkeletonProps] — TypeScript type
 - [AnswerSource] — TypeScript type
+- [AnswerSourceChipProps] — TypeScript type
+- [AnswerSourceInspectorProps] — TypeScript type
+- [AnswerSourceItemProps] — TypeScript type
+- [AnswerSourcesProps] — TypeScript type
 - [AnswerSpec] — TypeScript type
 - [AnswerTone] — TypeScript type
 - [AreaChartProps] — TypeScript type
@@ -601,7 +610,7 @@ When tabs and a search field control the same content, they share one responsive
 - [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)
 - [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 the app's left navigation rail — compose it from SidebarHeader/SidebarBrand, SidebarNav (sections of SidebarItems), optional SidebarHistory, and a SidebarFooter with SidebarAccount, with an opt-in collapsed icon-rail mode (⌘B/Ctrl-B) that every sub-part reads automatically. [docs](https://ads.actioneer.dev/#/sidebar)
+- [Sidebar] — Use as the app's left navigation rail. The canonical Actioneer shell composes SidebarBrand with persistent header actions, SidebarAction above grouped SidebarItems, optional attention counts and SidebarHistory, then SidebarAccount in a pinned footer. Its opt-in collapsed icon-rail mode (⌘B/Ctrl-B) is shared automatically by every sub-part. [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)
@@ -879,8 +888,8 @@ When tabs and a search field control the same content, they share one responsive
 - [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] — component [docs](https://ads.actioneer.dev/#/demo/ask)
-- [FollowUpSuggestion] — 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)

package/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "@actioneer/ads",
-  "version": "0.5.6",
+  "version": "0.5.7",
   "importPath": "@actioneer/ads",
   "styleImport": "@import \"@actioneer/ads/styles.css\";",
   "families": [
@@ -16,9 +16,9 @@
     "Chat"
   ],
   "counts": {
-    "total": 784,
-    "component": 353,
-    "type": 343,
+    "total": 792,
+    "component": 357,
+    "type": 347,
     "hook": 10,
     "util": 78
   },
@@ -148,7 +148,7 @@
         "text-brand",
         "border-brand"
       ],
-      "description": "Brand (Sage green) — used for solid fills / primary actions, not body text"
+      "description": "Compatibility action role — neutral ink, never a colored primary hue."
     },
     {
       "name": "--color-brand-foreground",
@@ -157,7 +157,7 @@
         "text-brand-foreground",
         "bg-brand-foreground"
       ],
-      "description": "Brand (Sage green) — used for solid fills / primary actions, not body text"
+      "description": "Compatibility action role — neutral ink, never a colored primary hue."
     },
     {
       "name": "--color-brand-hover",
@@ -167,7 +167,7 @@
         "text-brand-hover",
         "border-brand-hover"
       ],
-      "description": "Brand (Sage green) — used for solid fills / primary actions, not body text"
+      "description": "Compatibility action role — neutral ink, never a colored primary hue."
     },
     {
       "name": "--color-brand-text",
@@ -177,7 +177,7 @@
         "text-brand-text",
         "border-brand-text"
       ],
-      "description": "Brand (Sage green) — used for solid fills / primary actions, not body text"
+      "description": "Compatibility action role — neutral ink, never a colored primary hue."
     },
     {
       "name": "--color-fill",
@@ -2068,6 +2068,63 @@
         "kind"
       ]
     },
+    {
+      "name": "AnswerSourceChip",
+      "family": "Data display",
+      "kind": "component",
+      "importPath": "@actioneer/ads",
+      "module": "answer-sources",
+      "description": "Use the blue connector/source chip inside AnswerSources to open only the referenced nodes represented by that chip in the shell's inspector.",
+      "showcaseUrl": "https://ads.actioneer.dev/#/ai/sources",
+      "props": [
+        "icon",
+        "count",
+        "children"
+      ]
+    },
+    {
+      "name": "AnswerSourceInspector",
+      "family": "Data display",
+      "kind": "component",
+      "importPath": "@actioneer/ads",
+      "module": "answer-sources",
+      "description": "Render as a separate white shell-level panel beside the answer when a source chip is selected; close and unmount it when the selection clears.",
+      "showcaseUrl": "https://ads.actioneer.dev/#/ai/sources",
+      "props": [
+        "description",
+        "title",
+        "children"
+      ]
+    },
+    {
+      "name": "AnswerSourceItem",
+      "family": "Data display",
+      "kind": "component",
+      "importPath": "@actioneer/ads",
+      "module": "answer-sources",
+      "description": "Use as an outlined clickable row inside AnswerSourceInspector for one referenced table or node, including its parent source, read state, and optional status.",
+      "showcaseUrl": "https://ads.actioneer.dev/#/ai/sources",
+      "props": [
+        "name",
+        "source",
+        "description",
+        "status",
+        "icon"
+      ]
+    },
+    {
+      "name": "AnswerSources",
+      "family": "Data display",
+      "kind": "component",
+      "importPath": "@actioneer/ads",
+      "module": "answer-sources",
+      "description": "Place immediately above an answer's follow-up questions to summarize the referenced nodes and group them into clickable AnswerSourceChips.",
+      "showcaseUrl": "https://ads.actioneer.dev/#/ai/sources",
+      "props": [
+        "count",
+        "label"
+      ]
+    },
     {
       "name": "AreaChart",
       "family": "Data display",
@@ -3042,6 +3099,7 @@
         "actionColumnWidth",
         "sortDescriptor",
         "onSortChange",
+        "allowsSorting",
         "isStatic"
       ]
     },
@@ -3086,7 +3144,8 @@
       "showcaseUrl": "https://ads.actioneer.dev/#/table",
       "props": [
         "align",
-        "sticky"
+        "sticky",
+        "sortValue"
       ]
     },
     {
@@ -3099,7 +3158,9 @@
       "props": [
         "align",
         "sticky",
-        "sortKey"
+        "sortKey",
+        "allowsSorting",
+        "_sortColumnIndex"
       ]
     },
     {
@@ -3466,6 +3527,34 @@
       "importPath": "@actioneer/ads",
       "module": "answer"
     },
+    {
+      "name": "AnswerSourceChipProps",
+      "family": "Data display",
+      "kind": "type",
+      "importPath": "@actioneer/ads",
+      "module": "answer-sources"
+    },
+    {
+      "name": "AnswerSourceInspectorProps",
+      "family": "Data display",
+      "kind": "type",
+      "importPath": "@actioneer/ads",
+      "module": "answer-sources"
+    },
+    {
+      "name": "AnswerSourceItemProps",
+      "family": "Data display",
+      "kind": "type",
+      "importPath": "@actioneer/ads",
+      "module": "answer-sources"
+    },
+    {
+      "name": "AnswerSourcesProps",
+      "family": "Data display",
+      "kind": "type",
+      "importPath": "@actioneer/ads",
+      "module": "answer-sources"
+    },
     {
       "name": "AnswerSpec",
       "family": "Data display",
@@ -4766,6 +4855,7 @@
         "mask",
         "motion",
         "motionMode",
+        "interactionColor",
         "hero"
       ]
     },
@@ -5090,7 +5180,7 @@
       "kind": "component",
       "importPath": "@actioneer/ads",
       "module": "sidebar",
-      "description": "Use as the app's left navigation rail — compose it from SidebarHeader/SidebarBrand, SidebarNav (sections of SidebarItems), optional SidebarHistory, and a SidebarFooter with SidebarAccount, with an opt-in collapsed icon-rail mode (⌘B/Ctrl-B) that every sub-part reads automatically.",
+      "description": "Use as the app's left navigation rail. The canonical Actioneer shell composes SidebarBrand with persistent header actions, SidebarAction above grouped SidebarItems, optional attention counts and SidebarHistory, then SidebarAccount in a pinned footer. Its opt-in collapsed icon-rail mode (⌘B/Ctrl-B) is shared automatically by every sub-part.",
       "showcaseUrl": "https://ads.actioneer.dev/#/sidebar",
       "props": [
         "collapsed",
@@ -7657,7 +7747,8 @@
       "module": "follow-up-suggestions",
       "vendored": true,
       "note": "Vendored assistant-ui component. Props follow upstream assistant-ui, not ADS conventions; the chat family needs an <AssistantRuntimeProvider> (chat runtime) and a <TooltipProvider> ancestor. Import from \"@actioneer/ads\" like any ADS export.",
-      "showcaseUrl": "https://ads.actioneer.dev/#/demo/ask"
+      "description": "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.",
+      "showcaseUrl": "https://ads.actioneer.dev/#/ai/follow-up-suggestions"
     },
     {
       "name": "FollowUpSuggestion",
@@ -7667,7 +7758,8 @@
       "module": "follow-up-suggestions",
       "vendored": true,
       "note": "Vendored assistant-ui component. Props follow upstream assistant-ui, not ADS conventions; the chat family needs an <AssistantRuntimeProvider> (chat runtime) and a <TooltipProvider> ancestor. Import from \"@actioneer/ads\" like any ADS export.",
-      "showcaseUrl": "https://ads.actioneer.dev/#/demo/ask"
+      "description": "Use only for compact runtime suggestion chips above the composer; use FollowUpQuestion for the larger answer-ending question rows.",
+      "showcaseUrl": "https://ads.actioneer.dev/#/ai/follow-up-suggestions"
     },
     {
       "name": "Image",
@@ -8701,7 +8793,7 @@
       "id": "minimal-information",
       "number": 8,
       "title": "Minimal information per screen",
-      "rule": "A screen carries ONLY what the user needs to move forward: one title, at most one short supporting line, the inputs, one primary action. Never maximalist. Promote the one message that matters typographically instead of appending muted fine print.",
+      "rule": "A screen carries ONLY what the user needs to move forward: one title, the inputs, one primary action. Page, section, panel, modal, dialog, drawer, and popover headers are title-only by default; add a description only when the user explicitly asks for one. Never maximalist.",
       "do": [
         "Prefer more, smaller steps over dense ones; ask one thing at a time.",
         "Derive instead of asking whenever possible (a name from a work email, the company from its domain).",
@@ -8709,6 +8801,7 @@
       ],
       "dont": [
         "Add section eyebrows above a title that already names the screen, or helper text that restates the obvious / duplicates a disabled button's meaning.",
+        "Add any header description unless the user explicitly requested supporting copy for that page, section, panel, modal, dialog, drawer, or popover.",
         "Nest panel/step-rail chrome inside a multi-step flow."
       ],
       "enforcedByLint": false

package/package.json

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