@actioneer/ads 1.0.7 → 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, CaretRight as U, CaretUp as x, ArrowsDownUp as I, ChatCircle as M, ArrowUpRight as D, Clock as O, Database as F, ArrowSquareOut as b, Table as R, CaretLeft 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(D, "ArrowUpRight"), fo = e(A, "ChevronDown"), wo = e(v, "ChevronLeft"), To = e(U, "ChevronRight"), Ao = e(x, "ChevronUp"), Lo = e(I, "SortIcon"), mo = e(_e, "SwapHorizontal"), yo = e(b, "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(O, "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(M, "AgentChat"), Lt = e(K, "Bolt"), mt = e(ge, "BookOpen"), yt = e(pe, "Brain"), Bt = e(de, "CheckList"), Ut = e(Se, "Component"), xt = e(F, "Database"), It = e(R, "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

package/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "@actioneer/ads",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "importPath": "@actioneer/ads",
   "styleImport": "@import \"@actioneer/ads/styles.css\";",
   "families": [
@@ -16,9 +16,9 @@
     "Chat"
   ],
   "counts": {
-    "total": 742,
+    "total": 743,
     "component": 323,
-    "type": 311,
+    "type": 312,
     "hook": 10,
     "util": 98
   },
@@ -557,7 +557,7 @@
       "utilities": [
         "ring-ring"
       ],
-      "description": "Focus ring and scrim, both translucent warm ink."
+      "description": "Focus ring and scrim, both translucent neutral ink."
     },
     {
       "name": "--color-overlay",
@@ -567,7 +567,7 @@
         "text-overlay",
         "border-overlay"
       ],
-      "description": "Focus ring and scrim, both translucent warm ink."
+      "description": "Focus ring and scrim, both translucent neutral ink."
     }
   ],
   "exports": [
@@ -776,6 +776,7 @@
         "topLabel",
         "bottomLabel",
         "downloadName",
+        "look",
         "className"
       ]
     },
@@ -920,6 +921,12 @@
       "module": "file-dropzone",
       "showcaseUrl": "https://ads.actioneer.dev/#/review/file-dropzone",
       "variants": {
+        "hasFiles": {
+          "values": [
+            "true",
+            "false"
+          ]
+        },
         "isDragging": {
           "values": [
             "true",
@@ -1172,6 +1179,13 @@
         "className"
       ]
     },
+    {
+      "name": "AudioWaveformLook",
+      "family": "Foundations",
+      "kind": "type",
+      "importPath": "@actioneer/ads",
+      "module": "audio-waveform"
+    },
     {
       "name": "AudioWaveformProps",
       "family": "Foundations",
@@ -5146,7 +5160,7 @@
           ],
           "default": "default",
           "options": {
-            "default": "Neutral heads-up with a warm-grey icon tile and no urgency signaled.",
+            "default": "Neutral heads-up with a neutral icon and no urgency signaled.",
             "success": "Grass green confirms a completed or positive outcome.",
             "warning": "Flags a non-blocking risk or upcoming issue (e.g. scheduled maintenance), amber accent.",
             "danger": "Signals a failure or blocking problem (e.g. connection error) needing attention, red accent.",
@@ -8437,32 +8451,12 @@
         "value": "none"
       },
       {
-        "name": "100",
-        "value": "0 1px 0 0 rgb(32 32 32 / 0.07)"
-      },
-      {
-        "name": "200",
-        "value": "0 3px 1px -1px rgb(32 32 32 / 0.07)"
-      },
-      {
-        "name": "300",
-        "value": "0 4px 6px -2px rgb(32 32 32 / 0.2)"
-      },
-      {
-        "name": "400",
-        "value": "0 8px 16px -4px rgb(32 32 32 / 0.22)"
-      },
-      {
-        "name": "500",
-        "value": "0 12px 20px -8px rgb(32 32 32 / 0.24)"
-      },
-      {
-        "name": "600",
-        "value": "0 20px 20px -8px rgb(32 32 32 / 0.28)"
+        "name": "float",
+        "value": "0 0 0 1px rgb(32 32 32 / 0.04), 0 2px 4px rgb(32 32 32 / 0.04), 0 8px 20px -4px rgb(32 32 32 / 0.10)"
       },
       {
-        "name": "elevation",
-        "value": "none"
+        "name": "overlay",
+        "value": "0 0 0 1px rgb(32 32 32 / 0.04), 0 4px 8px rgb(32 32 32 / 0.04), 0 16px 36px -8px rgb(32 32 32 / 0.14)"
       },
       {
         "name": "table-smudge-left",
@@ -8568,18 +8562,17 @@
     {
       "id": "elevation-is-actionability",
       "number": 2,
-      "title": "Shadow only by request",
-      "rule": "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.",
+      "title": "Five shadows, floating layers only",
+      "rule": "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.",
-        "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.",
-        "Reserve shadow-500 and shadow-600 for rare higher stacked layers; the legacy shadow-elevation hook resolves to shadow-0."
+        "Keep cards, panels, chips, buttons, tabs, fields, thumbs, and other in-page surfaces at shadow-0; separate them with fill, border, or spacing.",
+        "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.",
+        "Use shadow-overlay for modals, dialogs, and overlay drawers, so a dialog always reads above a menu."
       ],
       "dont": [
-        "Infer permission to use a shadow from actionability, floating placement, or component type.",
-        "Use raw shadow values or legacy named shadow utilities.",
-        "Put a shadow on a non-interactive surface for decoration.",
-        "Use shadow-500 or shadow-600 as a routine default."
+        "Put a shadow on an in-page surface for decoration or to signal that it is clickable.",
+        "Use raw shadow values, inset glows, or the removed numbered levels and elevation hook.",
+        "Invent a third floating level; stack order comes from float vs overlay."
       ],
       "enforcedByLint": false
     },
@@ -8737,9 +8730,9 @@
       "id": "tabs-search-opposed",
       "number": 11,
       "title": "Tabs lead; scoped search trails",
-      "rule": "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.",
+      "rule": "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.",
+        "Keep tab triggers left-aligned at their natural width, then place the scoped search field opposite them in the same toolbar.",
         "On constrained containers, stack tabs first and search second while preserving their relationship."
       ],
       "dont": [
@@ -9667,10 +9660,10 @@
       ]
     },
     "counts": {
-      "nodes": 806,
-      "edges": 548,
+      "nodes": 808,
+      "edges": 550,
       "component": 323,
-      "state": 461,
+      "state": 463,
       "principle": 11,
       "production": 9,
       "layout": 2
@@ -9946,6 +9939,30 @@
         "showcaseUrl": "https://ads.actioneer.dev/#/review/file-dropzone",
         "description": ""
       },
+      {
+        "id": "state:FileDropzone:hasFiles=true",
+        "kind": "state",
+        "label": "hasFiles=true",
+        "component": "FileDropzone",
+        "axis": "hasFiles",
+        "value": "true",
+        "required": false,
+        "derived": true,
+        "isDefault": false,
+        "description": ""
+      },
+      {
+        "id": "state:FileDropzone:hasFiles=false",
+        "kind": "state",
+        "label": "hasFiles=false",
+        "component": "FileDropzone",
+        "axis": "hasFiles",
+        "value": "false",
+        "required": false,
+        "derived": true,
+        "isDefault": false,
+        "description": ""
+      },
       {
         "id": "state:FileDropzone:isDragging=true",
         "kind": "state",
@@ -14558,7 +14575,7 @@
         "required": false,
         "derived": true,
         "isDefault": true,
-        "description": "Neutral heads-up with a warm-grey icon tile and no urgency signaled."
+        "description": "Neutral heads-up with a neutral icon and no urgency signaled."
       },
       {
         "id": "state:Alert:variant=success",
@@ -17501,9 +17518,9 @@
       {
         "id": "principle:elevation-is-actionability",
         "kind": "principle",
-        "label": "Shadow only by request",
+        "label": "Five shadows, floating layers only",
         "number": 2,
-        "rule": "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."
+        "rule": "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."
       },
       {
         "id": "principle:motion-follows-guide",
@@ -17566,7 +17583,7 @@
         "kind": "principle",
         "label": "Tabs lead; scoped search trails",
         "number": 11,
-        "rule": "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."
+        "rule": "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."
       },
       {
         "id": "state:Button:interaction=default",
@@ -18429,6 +18446,18 @@
         "target": "state:CodeBlock:variant=plain",
         "relation": "supports-state"
       },
+      {
+        "id": "component:FileDropzone:supports-state:state:FileDropzone:hasFiles=true:global",
+        "source": "component:FileDropzone",
+        "target": "state:FileDropzone:hasFiles=true",
+        "relation": "supports-state"
+      },
+      {
+        "id": "component:FileDropzone:supports-state:state:FileDropzone:hasFiles=false:global",
+        "source": "component:FileDropzone",
+        "target": "state:FileDropzone:hasFiles=false",
+        "relation": "supports-state"
+      },
       {
         "id": "component:FileDropzone:supports-state:state:FileDropzone:isDragging=true:global",
         "source": "component:FileDropzone",