@actioneer/ads 1.0.6 → 1.0.8

package/lib/icons.js

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

package/llms.txt

@@ -70,8 +70,8 @@ Reference semantic roles, never raw color/dimension literals (ads-lint rejects l
 - `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.
+- `ring` — Focus ring and scrim, both translucent neutral ink.
+- `overlay` — Focus ring and scrim, both translucent neutral ink.
 
 ## Design principles
 
@@ -89,17 +89,16 @@ Delineate SURFACES (cards, panels, sidebars, page regions) with color contrast,
 - 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. Shadow only by request [judgment]
+### 2. Five shadows, floating layers only [judgment]
 
-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.
+ADS has five shadow tokens: shadow-0 (flat, the default), shadow-float, shadow-overlay, and the two table scroll-hint smudges. Only a layer that floats above the page may carry float or overlay; everything in the page is flat.
 
-- 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.
+- Do: Keep cards, panels, chips, buttons, tabs, fields, thumbs, and other in-page surfaces at shadow-0; separate them with fill, border, or spacing.
+- Do: Use shadow-float for floating layers that sit over content: toasts, toolbars, the chat composer dock, and any menu or popover that needs lift beyond its border.
+- Do: Use shadow-overlay for modals, dialogs, and overlay drawers, so a dialog always reads above a menu.
+- Don't: Put a shadow on an in-page surface for decoration or to signal that it is clickable.
+- Don't: Use raw shadow values, inset glows, or the removed numbered levels and elevation hook.
+- Don't: Invent a third floating level; stack order comes from float vs overlay.
 
 ### 3. Motion follows the interaction [lint: unbounded-transition, sluggish-easing, zero-scale-entrance, undersized-zoom-entrance, raw-spring-config]
 
@@ -188,9 +187,9 @@ A page-level Back control sits immediately before the page title in the leading
 
 ### 11. Tabs lead; scoped search trails [judgment]
 
-When tabs and a search field control the same content, they share one responsive control row: the tab track hugs its labels at the leading edge and search sits at the trailing edge. Stack only when the container cannot fit both.
+When tabs and a search field control the same content, they share one responsive control row: the tab list leads with its triggers left-aligned at their natural width over a baseline that fades from WG3 to transparent, and search sits at the trailing edge. Stack only when the container cannot fit both.
 
-- Do: Keep the horizontal TabList content-width, then place the scoped search field opposite it in the same toolbar.
+- Do: Keep tab triggers left-aligned at their natural width, then place the scoped search field opposite them in the same toolbar.
 - Do: On constrained containers, stack tabs first and search second while preserving their relationship.
 - Don't: Stretch the tab track to fill the space between its labels and the search field.
 - Don't: Put a scoped search field on a separate row above its tabs when both controls fit side by side.
@@ -254,7 +253,7 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [Field] — Wrap any form control (Input, Select, NumberField, Textarea, etc.) with a label plus optional description or error footer. [docs](https://ads.actioneer.dev/#/field)
 - [FieldDescription] — component [docs](https://ads.actioneer.dev/#/field)
 - [FieldError] — component [docs](https://ads.actioneer.dev/#/field)
-- [FileDropzone] — component (variants: isDragging: true|false; isDisabled: true|false) [docs](https://ads.actioneer.dev/#/review/file-dropzone)
+- [FileDropzone] — component (variants: hasFiles: true|false; isDragging: true|false; isDisabled: true|false) [docs](https://ads.actioneer.dev/#/review/file-dropzone)
 - [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)
@@ -269,6 +268,7 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [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)
 - [Tooltip] — Use to label a single hover/focus-triggered element (icon-only buttons, avatars, truncated text) with a short informational hint — not for actions or content that needs to stay open. [docs](https://ads.actioneer.dev/#/tooltip)
+- [AudioWaveformLook] — TypeScript type
 - [AudioWaveformProps] — TypeScript type
 - [ButtonProps] — TypeScript type
 - [CodeBlockProps] — TypeScript type
@@ -456,7 +456,7 @@ Before using any component below, preserve its built-in motion and apply the mot
 - [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: 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 (14px / 20px); only clearly secondary metadata inside a cell may opt down to text-s. Give a whole-row action an onClick and aria-label: TableRow then adds hover/focus feedback, a pointer cursor, and Enter/Space activation. The consumer decides whether that action navigates or opens a panel; TableRow owns neither destination. Display-only rows stay static; selection rows toggle when clicked. Keep normal row geometry without a brand tint or hover-only corner rounding. Nested controls keep their own actions. 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)
+- [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 (14px / 20px); only clearly secondary metadata inside a cell may opt down to text-s. Give a whole-row action an onClick and aria-label: TableRow then adds hover/focus feedback, a pointer cursor, and Enter/Space activation. The consumer decides whether that action navigates or opens a panel; TableRow owns neither destination. Display-only rows stay static. Single selection uses grouped radio buttons and keeps the chosen row selected; multiple selection uses checkboxes. Selecting or clearing a parent cascades through all descendants, including collapsed rows; partial groups show a mixed checkbox. Selection callbacks include the complete selected key set. Selected row fills fade from full soft-teal tint at the visible left edge to no tint at the right edge, including pinned cells. Use TableRow.childRows for collapsible hierarchies, expanded/defaultExpanded and onExpandedChange for disclosure, and stable rowKey values. Child rows open below their parent without shifting columns; the caret and parent label share one transparent disclosure button, separate from selection, and both turn the primary-action text color on hover. Sorting keeps child rows with their parent. Keep normal row geometry without a brand tint or hover-only corner rounding. Nested controls keep their own actions. 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)
@@ -650,7 +650,7 @@ Before using any component below, preserve its built-in motion and apply the mot
 
 ### Feedback
 
-- [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)
+- [Alert] — Use for inline status messaging in an outlined white container. Neutral 14px text leads, a softly tinted icon carries status, and actions align below the description. 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)
 - [BrandMark] — component [docs](https://ads.actioneer.dev/#/brand-loader)