@actioneer/ads-mcp 1.0.7 → 1.0.8

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",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@actioneer/ads-mcp",
-  "version": "1.0.7",
+  "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
       );
     },