@actioneer/ads-mcp 1.0.5 → 1.0.8

package/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "@actioneer/ads",
-  "version": "1.0.5",
+  "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",
@@ -3613,7 +3627,7 @@
       "kind": "component",
       "importPath": "@actioneer/ads",
       "module": "table",
-      "description": "Use Table for structured tabular data that may need row selection, column sorting, sticky columns, or a paginated footer — not for simple key-value lists. 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.",
+      "description": "Use Table for structured tabular data that may need row selection, column sorting, sticky columns, or a paginated footer — not for simple key-value lists. 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.",
       "showcaseUrl": "https://ads.actioneer.dev/#/table",
       "props": [
         "wrapperClassName",
@@ -3710,6 +3724,11 @@
       "showcaseUrl": "https://ads.actioneer.dev/#/table",
       "props": [
         "rowKey",
+        "childRows",
+        "expanded",
+        "defaultExpanded",
+        "onExpandedChange",
+        "disclosureLabel",
         "isInteractive"
       ]
     },
@@ -5128,7 +5147,7 @@
       "kind": "component",
       "importPath": "@actioneer/ads",
       "module": "alert",
-      "description": "Use for inline status messaging on a raised white surface. Add duration for a temporary announcement with a countdown bar; otherwise it remains persistent.",
+      "description": "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.",
       "showcaseUrl": "https://ads.actioneer.dev/#/alert",
       "variants": {
         "variant": {
@@ -5141,7 +5160,7 @@
           ],
           "default": "default",
           "options": {
-            "default": "Neutral heads-up with no status implication, foreground-colored icon/title, 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.",
@@ -8432,32 +8451,12 @@
         "value": "none"
       },
       {
-        "name": "100",
-        "value": "0 1px 0 0 rgb(32 32 32 / 0.07)"
+        "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": "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": "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",
@@ -8563,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
     },
@@ -8732,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": [
@@ -9500,7 +9498,22 @@
           },
           {
             "id": "row-selected",
-            "description": "Selected row wash.",
+            "description": "Selected row fill fades from full tint at the left to no tint at the right of the viewport.",
+            "required": true
+          },
+          {
+            "id": "row-partially-selected",
+            "description": "Parent checkbox is mixed when only some descendants are selected.",
+            "required": true
+          },
+          {
+            "id": "collapsed",
+            "description": "Parent row visible with its child rows hidden.",
+            "required": true
+          },
+          {
+            "id": "expanded",
+            "description": "Indented child rows open below their parent without changing column widths.",
             "required": true
           },
           {
@@ -9517,6 +9530,18 @@
           [
             "sorted",
             "row-focus"
+          ],
+          [
+            "expanded",
+            "row-selected"
+          ],
+          [
+            "expanded",
+            "row-partially-selected"
+          ],
+          [
+            "sorted",
+            "expanded"
           ]
         ]
       },
@@ -9619,14 +9644,26 @@
         [
           "sorted",
           "row-focus"
+        ],
+        [
+          "expanded",
+          "row-selected"
+        ],
+        [
+          "expanded",
+          "row-partially-selected"
+        ],
+        [
+          "sorted",
+          "expanded"
         ]
       ]
     },
     "counts": {
-      "nodes": 803,
-      "edges": 545,
+      "nodes": 808,
+      "edges": 550,
       "component": 323,
-      "state": 458,
+      "state": 463,
       "principle": 11,
       "production": 9,
       "layout": 2
@@ -9902,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",
@@ -14037,7 +14098,7 @@
         "family": "Data display",
         "module": "table",
         "showcaseUrl": "https://ads.actioneer.dev/#/table",
-        "description": "Use Table for structured tabular data that may need row selection, column sorting, sticky columns, or a paginated footer — not for simple key-value lists. 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."
+        "description": "Use Table for structured tabular data that may need row selection, column sorting, sticky columns, or a paginated footer — not for simple key-value lists. 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."
       },
       {
         "id": "component:TableAnswer",
@@ -14502,7 +14563,7 @@
         "family": "Feedback",
         "module": "alert",
         "showcaseUrl": "https://ads.actioneer.dev/#/alert",
-        "description": "Use for inline status messaging on a raised white surface. Add duration for a temporary announcement with a countdown bar; otherwise it remains persistent."
+        "description": "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."
       },
       {
         "id": "state:Alert:variant=default",
@@ -14514,7 +14575,7 @@
         "required": false,
         "derived": true,
         "isDefault": true,
-        "description": "Neutral heads-up with no status implication, foreground-colored icon/title, no urgency signaled."
+        "description": "Neutral heads-up with a neutral icon and no urgency signaled."
       },
       {
         "id": "state:Alert:variant=success",
@@ -17457,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",
@@ -17522,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",
@@ -17929,7 +17990,40 @@
         "value": "row-selected",
         "required": true,
         "derived": false,
-        "description": "Selected row wash."
+        "description": "Selected row fill fades from full tint at the left to no tint at the right of the viewport."
+      },
+      {
+        "id": "state:Table:interaction=row-partially-selected",
+        "kind": "state",
+        "label": "row-partially-selected",
+        "component": "Table",
+        "axis": "interaction",
+        "value": "row-partially-selected",
+        "required": true,
+        "derived": false,
+        "description": "Parent checkbox is mixed when only some descendants are selected."
+      },
+      {
+        "id": "state:Table:interaction=collapsed",
+        "kind": "state",
+        "label": "collapsed",
+        "component": "Table",
+        "axis": "interaction",
+        "value": "collapsed",
+        "required": true,
+        "derived": false,
+        "description": "Parent row visible with its child rows hidden."
+      },
+      {
+        "id": "state:Table:interaction=expanded",
+        "kind": "state",
+        "label": "expanded",
+        "component": "Table",
+        "axis": "interaction",
+        "value": "expanded",
+        "required": true,
+        "derived": false,
+        "description": "Indented child rows open below their parent without changing column widths."
       },
       {
         "id": "state:Table:interaction=horizontal-overflow",
@@ -18352,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",
@@ -20938,6 +21044,24 @@
         "target": "state:Table:interaction=row-selected",
         "relation": "supports-state"
       },
+      {
+        "id": "component:Table:supports-state:state:Table:interaction=row-partially-selected:global",
+        "source": "component:Table",
+        "target": "state:Table:interaction=row-partially-selected",
+        "relation": "supports-state"
+      },
+      {
+        "id": "component:Table:supports-state:state:Table:interaction=collapsed:global",
+        "source": "component:Table",
+        "target": "state:Table:interaction=collapsed",
+        "relation": "supports-state"
+      },
+      {
+        "id": "component:Table:supports-state:state:Table:interaction=expanded:global",
+        "source": "component:Table",
+        "target": "state:Table:interaction=expanded",
+        "relation": "supports-state"
+      },
       {
         "id": "component:Table:supports-state:state:Table:interaction=horizontal-overflow:global",
         "source": "component:Table",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@actioneer/ads-mcp",
-  "version": "1.0.5",
+  "version": "1.0.8",
   "description": "ADS MCP server: lets an agent in Claude Code / Cursor discover and import the Actioneer Design System",
   "type": "module",
   "bin": {

package/src/tools.mjs

@@ -52,7 +52,7 @@ export function createTools({ manifest }) {
       description:
         "Get the ADS semantic token(s) for a role or purpose (e.g. 'brand', 'muted-foreground', " +
         "'bg-danger', 'primary text'). Also resolves the non-colour scales: type roles " +
-        "('body', 'label'), radius steps ('md'), the numbered shadow ladder ('shadow-300'), " +
+        "('body', 'label'), radius steps ('md'), the shadow tokens ('shadow-float'), " +
         "and the named motion presets ('springDialog') with their spring values and purpose. " +
         "Reference the returned token/utilities instead of a raw " +
         "color literal — ads-lint rejects literals.",
@@ -183,7 +183,7 @@ export function createTools({ manifest }) {
       return text(
         `No ADS token or scale matches "${raw}". Try a colour role ('brand', ` +
           `'muted-foreground'), a type role ('body'), a radius step ('md'), a shadow ` +
-          `('shadow-300'), or a motion preset ('springDialog').`,
+          `('shadow-float'), or a motion preset ('springDialog').`,
         true
       );
     },