@actioneer/ads 0.5.8 → 0.6.0

package/lib/icons.js

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

package/llms.txt

@@ -28,6 +28,9 @@ Reference semantic roles, never raw color/dimension literals (ads-lint rejects l
 - `muted-foreground`
 - `card`
 - `card-foreground`
+- `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.
 - `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.
@@ -168,6 +171,20 @@ When tabs and a search field control the same content, they share one responsive
 - Don't: Put a scoped search field on a separate row above its tabs when both controls fit side by side.
 - Don't: Place search before tabs in the reading or keyboard order.
 
+## UI grammar
+
+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)
+- `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)
+- `settings-card` — Settings card: A compact settings surface with grouped SettingRows and one save action. (intents: settings, preferences, configuration, toggles; Storybook: ADS/Recipes/Settings panel)
+- `research-trace` — Inspectable research trace: ResearchActivity owns the run summary and contains the canonical ChainOfThought tree. (intents: agent trace, research, tool activity, sources, long-running task; Storybook: ADS/Components/AI Elements/Research Activity)
+- `typed-answer` — Typed research answer: A request/answer turn where structured output flows through AnswerRenderer. (intents: answer, research result, citations, follow-up, assistant response; Storybook: ADS/Components/AI Elements/Message)
+- `workflow-canvas` — Workflow canvas: InfiniteCanvas owns pan, zoom, grid, edges, controls, and responsive canvas chrome. (intents: workflow, node graph, canvas, diagram, flow builder; Storybook: ADS/Components/Data display/InfiniteCanvas)
+
 ## Components
 
 Before using any component below, preserve its built-in motion and apply the motion contract in Setup step 5.
@@ -265,12 +282,13 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [Autocomplete] — Use for a single-select text field that filters a known list of options as the user types, with keyboard navigation and a selected-match checkmark. [docs](https://ads.actioneer.dev/#/autocomplete)
 - [Checkbox] — Use for a standalone boolean toggle or a multi-select list item — including a tri-state "select all" via `indeterminate`. [docs](https://ads.actioneer.dev/#/checkbox)
 - [CheckboxGroup] — component [docs](https://ads.actioneer.dev/#/checkbox)
+- [DateRangePicker] — component [docs](https://ads.actioneer.dev/#/date-range-picker)
 - [Input] — Use for any single-line text value, wrapped in `Field` for label/description/error and `startContent`/`endContent` for icons or inline actions. [docs](https://ads.actioneer.dev/#/input)
 - [InputField] — component [docs](https://ads.actioneer.dev/#/input-field)
 - [NumberField] — Use for a bounded numeric quantity (e.g. seats, width, count) that benefits from stepper buttons and min/max clamping, not free-form numeric text entry. [docs](https://ads.actioneer.dev/#/number-field)
 - [Radio] — Use for choosing exactly one option from a small, fully visible set — wrap Radio options in a RadioGroup that owns the shared name and controlled value. [docs](https://ads.actioneer.dev/#/radio)
 - [RadioGroup] — component [docs](https://ads.actioneer.dev/#/radio)
-- [SegmentedControl] — Use for a small set (2-4) of mutually exclusive, always-visible options — like a range or view-mode switcher — not for navigation or long lists. Radius follows control size: 4px at sm and 8px at md/lg; tracks and options are never fully rounded. (variants: size: sm|md|lg; selected: true|false) [docs](https://ads.actioneer.dev/#/segmented)
+- [SegmentedControl] — Use for a small set (2-4) of mutually exclusive, always-visible options — like a range or view-mode switcher — not for navigation or long lists. Radius follows control size: 4px at sm and 6px at md/lg; tracks and options are never fully rounded. (variants: size: sm|md|lg; selected: true|false) [docs](https://ads.actioneer.dev/#/segmented)
 - [Select] — Use for a single choice from a closed list of options in a form, especially when pairing with Field for a labeled control. (variants: size: sm|md|lg) [docs](https://ads.actioneer.dev/#/select)
 - [Slider] — Use for a single controlled numeric value picked from a bounded range (volume, brightness, threshold) — pair with Field or Label/Text for an accessible, labeled control. [docs](https://ads.actioneer.dev/#/slider)
 - [Switch] — Use for a single binary on/off preference that applies immediately, not as part of a form submitted later. [docs](https://ads.actioneer.dev/#/switch)
@@ -279,6 +297,8 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [AutocompleteProps] — TypeScript type
 - [CheckboxGroupProps] — TypeScript type
 - [CheckboxProps] — TypeScript type
+- [DateRangePickerProps] — TypeScript type
+- [DateRangeValue] — TypeScript type
 - [InputFieldProps] — TypeScript type
 - [InputProps] — TypeScript type
 - [NumberFieldProps] — TypeScript type
@@ -346,7 +366,7 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [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)
+- [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)
 - [AreaChart] — component [docs](https://ads.actioneer.dev/#/ai/chart)
@@ -644,7 +664,7 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [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. 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)
+- [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)
 - [SidebarAccount] — component [docs](https://ads.actioneer.dev/#/sidebar)
 - [SidebarAction] — component [docs](https://ads.actioneer.dev/#/sidebar)
 - [SidebarBrand] — component [docs](https://ads.actioneer.dev/#/sidebar)