@actioneer/ads-mcp 0.7.0 → 0.8.1

package/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "@actioneer/ads",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "importPath": "@actioneer/ads",
   "styleImport": "@import \"@actioneer/ads/styles.css\";",
   "families": [
@@ -16,9 +16,9 @@
     "Chat"
   ],
   "counts": {
-    "total": 743,
-    "component": 323,
-    "type": 312,
+    "total": 740,
+    "component": 322,
+    "type": 310,
     "hook": 10,
     "util": 98
   },
@@ -31,7 +31,7 @@
         "text-background",
         "border-background"
       ],
-      "description": ""
+      "description": "The shell canvas and its ink: the ground between top-level panels."
     },
     {
       "name": "--color-foreground",
@@ -41,7 +41,7 @@
         "text-foreground",
         "border-foreground"
       ],
-      "description": ""
+      "description": "The shell canvas and its ink: the ground between top-level panels."
     },
     {
       "name": "--color-on-white-primary",
@@ -141,7 +141,7 @@
         "text-surface",
         "border-surface"
       ],
-      "description": ""
+      "description": "One continuous recess inside a white surface, never a screen-level ground."
     },
     {
       "name": "--color-surface-foreground",
@@ -150,7 +150,7 @@
         "text-surface-foreground",
         "bg-surface-foreground"
       ],
-      "description": ""
+      "description": "One continuous recess inside a white surface, never a screen-level ground."
     },
     {
       "name": "--color-elevated",
@@ -160,7 +160,7 @@
         "text-elevated",
         "border-elevated"
       ],
-      "description": ""
+      "description": "One continuous recess inside a white surface, never a screen-level ground."
     },
     {
       "name": "--color-muted",
@@ -170,7 +170,7 @@
         "text-muted",
         "border-muted"
       ],
-      "description": ""
+      "description": "The hover and row-state wash: interaction, not a default item background."
     },
     {
       "name": "--color-muted-foreground",
@@ -179,7 +179,7 @@
         "text-muted-foreground",
         "bg-muted-foreground"
       ],
-      "description": ""
+      "description": "The hover and row-state wash: interaction, not a default item background."
     },
     {
       "name": "--color-card",
@@ -189,7 +189,7 @@
         "text-card",
         "border-card"
       ],
-      "description": ""
+      "description": "The white working plane that sits on the canvas, and the specimen hairline."
     },
     {
       "name": "--color-card-foreground",
@@ -198,7 +198,7 @@
         "text-card-foreground",
         "bg-card-foreground"
       ],
-      "description": ""
+      "description": "The white working plane that sits on the canvas, and the specimen hairline."
     },
     {
       "name": "--color-specimen-stroke",
@@ -208,7 +208,7 @@
         "text-specimen-stroke",
         "border-specimen-stroke"
       ],
-      "description": ""
+      "description": "The white working plane that sits on the canvas, and the specimen hairline."
     },
     {
       "name": "--color-action-primary",
@@ -335,7 +335,7 @@
         "text-table-shell",
         "border-table-shell"
       ],
-      "description": "Quiet fill — avatars, chips, and disabled controls"
+      "description": "Table surfaces: the white tray, its hairlines, and header ink."
     },
     {
       "name": "--color-table-stroke",
@@ -345,7 +345,7 @@
         "text-table-stroke",
         "border-table-stroke"
       ],
-      "description": "Quiet fill — avatars, chips, and disabled controls"
+      "description": "Table surfaces: the white tray, its hairlines, and header ink."
     },
     {
       "name": "--color-table-header-foreground",
@@ -354,7 +354,7 @@
         "text-table-header-foreground",
         "bg-table-header-foreground"
       ],
-      "description": "Quiet fill — avatars, chips, and disabled controls"
+      "description": "Table surfaces: the white tray, its hairlines, and header ink."
     },
     {
       "name": "--color-artifact-canvas",
@@ -364,7 +364,7 @@
         "text-artifact-canvas",
         "border-artifact-canvas"
       ],
-      "description": ""
+      "description": "The artifact sheet: white warmed by a trace of the brand mark."
     },
     {
       "name": "--color-accent",
@@ -374,7 +374,7 @@
         "text-accent",
         "border-accent"
       ],
-      "description": ""
+      "description": "The active and selected wash, one step above hover."
     },
     {
       "name": "--color-accent-foreground",
@@ -383,7 +383,7 @@
         "text-accent-foreground",
         "bg-accent-foreground"
       ],
-      "description": ""
+      "description": "The active and selected wash, one step above hover."
     },
     {
       "name": "--color-success",
@@ -393,7 +393,7 @@
         "text-success",
         "border-success"
       ],
-      "description": "Lichen success-700 clears AA on White and both success soft fills;"
+      "description": "Lichen success-700 clears AA on White and both success soft fills; success-600 is reserved for non-text marks because its 3.73:1 contrast on White does not clear body-text AA."
     },
     {
       "name": "--color-success-foreground",
@@ -402,7 +402,7 @@
         "text-success-foreground",
         "bg-success-foreground"
       ],
-      "description": "Lichen success-700 clears AA on White and both success soft fills;"
+      "description": "Lichen success-700 clears AA on White and both success soft fills; success-600 is reserved for non-text marks because its 3.73:1 contrast on White does not clear body-text AA."
     },
     {
       "name": "--color-warning",
@@ -412,7 +412,7 @@
         "text-warning",
         "border-warning"
       ],
-      "description": "Amber-500 fill kept (it IS the caution signal); dark ink foreground"
+      "description": "Amber-500 fill kept (it IS the caution signal); dark ink foreground instead of white = 6.94:1 (white on amber was 2.35:1, failed even 3:1)."
     },
     {
       "name": "--color-warning-foreground",
@@ -421,7 +421,7 @@
         "text-warning-foreground",
         "bg-warning-foreground"
       ],
-      "description": "Amber-500 fill kept (it IS the caution signal); dark ink foreground"
+      "description": "Amber-500 fill kept (it IS the caution signal); dark ink foreground instead of white = 6.94:1 (white on amber was 2.35:1, failed even 3:1)."
     },
     {
       "name": "--color-danger",
@@ -431,7 +431,7 @@
         "text-danger",
         "border-danger"
       ],
-      "description": "Amber-500 fill kept (it IS the caution signal); dark ink foreground"
+      "description": "Danger and info: solid semantic fills carrying white foregrounds."
     },
     {
       "name": "--color-danger-foreground",
@@ -440,7 +440,7 @@
         "text-danger-foreground",
         "bg-danger-foreground"
       ],
-      "description": "Amber-500 fill kept (it IS the caution signal); dark ink foreground"
+      "description": "Danger and info: solid semantic fills carrying white foregrounds."
     },
     {
       "name": "--color-info",
@@ -450,7 +450,7 @@
         "text-info",
         "border-info"
       ],
-      "description": "Amber-500 fill kept (it IS the caution signal); dark ink foreground"
+      "description": "Danger and info: solid semantic fills carrying white foregrounds."
     },
     {
       "name": "--color-info-foreground",
@@ -459,7 +459,7 @@
         "text-info-foreground",
         "bg-info-foreground"
       ],
-      "description": "Amber-500 fill kept (it IS the caution signal); dark ink foreground"
+      "description": "Danger and info: solid semantic fills carrying white foregrounds."
     },
     {
       "name": "--color-border-primary",
@@ -469,7 +469,7 @@
         "text-border-primary",
         "border-border-primary"
       ],
-      "description": ""
+      "description": "The neutral stroke ladder: every 1px UI border stays within WG3 to WG5."
     },
     {
       "name": "--color-border-secondary",
@@ -479,7 +479,7 @@
         "text-border-secondary",
         "border-border-secondary"
       ],
-      "description": ""
+      "description": "The neutral stroke ladder: every 1px UI border stays within WG3 to WG5."
     },
     {
       "name": "--color-border-tertiary",
@@ -489,7 +489,7 @@
         "text-border-tertiary",
         "border-border-tertiary"
       ],
-      "description": ""
+      "description": "The neutral stroke ladder: every 1px UI border stays within WG3 to WG5."
     },
     {
       "name": "--color-border",
@@ -499,7 +499,7 @@
         "text-border",
         "border-border"
       ],
-      "description": ""
+      "description": "The neutral stroke ladder: every 1px UI border stays within WG3 to WG5."
     },
     {
       "name": "--color-border-strong",
@@ -509,7 +509,7 @@
         "text-border-strong",
         "border-border-strong"
       ],
-      "description": ""
+      "description": "The neutral stroke ladder: every 1px UI border stays within WG3 to WG5."
     },
     {
       "name": "--color-input",
@@ -519,7 +519,7 @@
         "text-input",
         "border-input"
       ],
-      "description": ""
+      "description": "The neutral stroke ladder: every 1px UI border stays within WG3 to WG5."
     },
     {
       "name": "--color-menu-stroke",
@@ -529,7 +529,7 @@
         "text-menu-stroke",
         "border-menu-stroke"
       ],
-      "description": ""
+      "description": "The neutral stroke ladder: every 1px UI border stays within WG3 to WG5."
     },
     {
       "name": "--color-toast-stroke",
@@ -539,7 +539,7 @@
         "text-toast-stroke",
         "border-toast-stroke"
       ],
-      "description": ""
+      "description": "The neutral stroke ladder: every 1px UI border stays within WG3 to WG5."
     },
     {
       "name": "--color-tree-stroke",
@@ -549,7 +549,7 @@
         "text-tree-stroke",
         "border-tree-stroke"
       ],
-      "description": ""
+      "description": "The neutral stroke ladder: every 1px UI border stays within WG3 to WG5."
     },
     {
       "name": "--color-ring",
@@ -557,7 +557,7 @@
       "utilities": [
         "ring-ring"
       ],
-      "description": ""
+      "description": "Focus ring and scrim, both translucent warm ink."
     },
     {
       "name": "--color-overlay",
@@ -567,7 +567,7 @@
         "text-overlay",
         "border-overlay"
       ],
-      "description": ""
+      "description": "Focus ring and scrim, both translucent warm ink."
     }
   ],
   "exports": [
@@ -1838,7 +1838,6 @@
       "props": [
         "open",
         "onOpenChange",
-        "appearance",
         "dismissible",
         "containerClassName",
         "className",
@@ -2021,33 +2020,6 @@
         "children"
       ]
     },
-    {
-      "name": "FloatingDrawer",
-      "family": "Overlays",
-      "kind": "component",
-      "importPath": "@actioneer/ads",
-      "module": "drawer",
-      "showcaseUrl": "https://ads.actioneer.dev/#/drawer",
-      "variants": {
-        "side": {
-          "values": [
-            "right",
-            "left",
-            "bottom"
-          ],
-          "default": "right"
-        },
-        "size": {
-          "values": [
-            "sm",
-            "md",
-            "lg",
-            "xl"
-          ],
-          "default": "md"
-        }
-      }
-    },
     {
       "name": "InlineDrawer",
       "family": "Overlays",
@@ -2413,13 +2385,6 @@
       "importPath": "@actioneer/ads",
       "module": "command-palette"
     },
-    {
-      "name": "DrawerAppearance",
-      "family": "Overlays",
-      "kind": "type",
-      "importPath": "@actioneer/ads",
-      "module": "drawer"
-    },
     {
       "name": "DrawerProps",
       "family": "Overlays",
@@ -2455,13 +2420,6 @@
       "importPath": "@actioneer/ads",
       "module": "dropdown"
     },
-    {
-      "name": "FloatingDrawerProps",
-      "family": "Overlays",
-      "kind": "type",
-      "importPath": "@actioneer/ads",
-      "module": "drawer"
-    },
     {
       "name": "InlineDrawerProps",
       "family": "Overlays",
@@ -3630,7 +3588,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. Interactive rows inherit the shared soft neutral hover/focus sink and keep their normal table geometry; do not add a brand tint or hover-only corner rounding. 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 (15px / 22px); only clearly secondary metadata inside a cell may opt down to text-s. Interactive rows inherit the shared soft neutral hover/focus sink and keep their normal table geometry; do not add a brand tint or hover-only corner rounding. 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",
@@ -8396,6 +8354,168 @@
       "note": "Vendored assistant-ui component. Props follow upstream assistant-ui, not ADS conventions; the chat family needs an <AssistantRuntimeProvider> (chat runtime) and a <TooltipProvider> ancestor. Import from \"@actioneer/ads\" like any ADS export."
     }
   ],
+  "scales": {
+    "typography": {
+      "display": {
+        "fontFamily": "\"Aribau Grotesk\", ui-sans-serif, system-ui, -apple-system, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif",
+        "fontSize": "31px",
+        "fontWeight": 500,
+        "lineHeight": "38px"
+      },
+      "title": {
+        "fontFamily": "\"Aribau Grotesk\", ui-sans-serif, system-ui, -apple-system, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif",
+        "fontSize": "25px",
+        "fontWeight": 500,
+        "lineHeight": "32px"
+      },
+      "headline": {
+        "fontFamily": "\"Aribau Grotesk\", ui-sans-serif, system-ui, -apple-system, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif",
+        "fontSize": "19px",
+        "fontWeight": 500,
+        "lineHeight": "26px"
+      },
+      "body": {
+        "fontFamily": "\"Aribau Grotesk\", ui-sans-serif, system-ui, -apple-system, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif",
+        "fontSize": "15px",
+        "fontWeight": 400,
+        "lineHeight": "22px"
+      },
+      "label": {
+        "fontFamily": "\"Aribau Grotesk\", ui-sans-serif, system-ui, -apple-system, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif",
+        "fontSize": "13px",
+        "fontWeight": 400,
+        "lineHeight": "18px"
+      },
+      "mono": {
+        "fontFamily": "\"JetBrains Mono Variable\", ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, \"Liberation Mono\", \"Courier New\", monospace",
+        "fontSize": "13px",
+        "fontWeight": 400,
+        "lineHeight": "18px"
+      }
+    },
+    "radius": {
+      "xs": "2px",
+      "sm": "4px",
+      "md": "6px",
+      "lg": "8px",
+      "xl": "12px",
+      "full": "9999px"
+    },
+    "shadow": [
+      {
+        "name": "0",
+        "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": "elevation",
+        "value": "none"
+      },
+      {
+        "name": "table-smudge-left",
+        "value": "8px 0 24px -14px rgb(32 32 32 / 0.05)"
+      },
+      {
+        "name": "table-smudge-right",
+        "value": "-8px 0 24px -14px rgb(32 32 32 / 0.05)"
+      }
+    ],
+    "motion": [
+      {
+        "name": "springEffect",
+        "purpose": "Fade/slide effects: Animate UI Effect, Fade, Slide, Blur, and Zoom.",
+        "value": "type: \"spring\", stiffness: 200, damping: 20"
+      },
+      {
+        "name": "springControl",
+        "purpose": "Selection highlights: Animate UI Tabs and Toggle Group.",
+        "value": "type: \"spring\", stiffness: 200, damping: 25"
+      },
+      {
+        "name": "springOverlay",
+        "purpose": "Floating UI: Animate UI Popover, Tooltip, Hover Card, and Preview Card.",
+        "value": "type: \"spring\", stiffness: 300, damping: 25"
+      },
+      {
+        "name": "springDialog",
+        "purpose": "Modal surfaces: Animate UI Dialog and Alert Dialog.",
+        "value": "type: \"spring\", stiffness: 150, damping: 25"
+      },
+      {
+        "name": "springSheet",
+        "purpose": "Side panels: Animate UI Sheet.",
+        "value": "type: \"spring\", stiffness: 150, damping: 22"
+      },
+      {
+        "name": "springDisclosure",
+        "purpose": "Auto-sized content: Animate UI Auto Height and animated tab panels.",
+        "value": "type: \"spring\", stiffness: 300, damping: 30, bounce: 0, restDelta: 0.01"
+      },
+      {
+        "name": "springHighlight",
+        "purpose": "Menus and active-item highlights: Animate UI Menu and Highlight.",
+        "value": "type: \"spring\", stiffness: 350, damping: 35"
+      },
+      {
+        "name": "springProgress",
+        "purpose": "Determinate value changes: Animate UI Progress.",
+        "value": "type: \"spring\", stiffness: 100, damping: 30"
+      },
+      {
+        "name": "springSwitch",
+        "purpose": "Switch thumbs: Animate UI Switch.",
+        "value": "type: \"spring\", stiffness: 300, damping: 25"
+      },
+      {
+        "name": "springRadio",
+        "purpose": "Radio indicators: Animate UI Radio Group.",
+        "value": "type: \"spring\", stiffness: 200, damping: 16"
+      },
+      {
+        "name": "springCarousel",
+        "purpose": "Carousel tracks: Animate UI Carousel.",
+        "value": "type: \"spring\", stiffness: 240, damping: 24"
+      },
+      {
+        "name": "springSidebar",
+        "purpose": "Collapsible application rails: Animate UI Sidebar.",
+        "value": "type: \"spring\", stiffness: 350, damping: 35"
+      },
+      {
+        "name": "checkDrawTransition",
+        "purpose": "Checkbox mark drawing: Animate UI Checkbox.",
+        "value": "duration: 0.2, ease: \"easeOut\""
+      },
+      {
+        "name": "fadeTransition",
+        "purpose": "Animate UI's backdrop treatment for dialogs and sheets.",
+        "value": "duration: 0.2, ease: \"easeInOut\""
+      }
+    ]
+  },
   "principles": [
     {
       "id": "fills-over-strokes",
@@ -8427,7 +8547,7 @@
       ],
       "dont": [
         "Infer permission to use a shadow from actionability, floating placement, or component type.",
-        "Use raw shadow values or legacy shadow-sm/md/lg/xl utilities.",
+        "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."
       ],
@@ -8461,18 +8581,18 @@
       ]
     },
     {
-      "id": "icons-hugeicons-stroke",
+      "id": "icons-phosphor-regular",
       "number": 4,
-      "title": "Icons: Hugeicons, stroke only",
-      "rule": "All icons come from Hugeicons in the Stroke Rounded style only. Components import named icons from the @/lib/icons registry — never from an icon package directly — so a free→Pro swap or a restyle touches one file.",
+      "title": "Icons: Phosphor, regular weight (fill for active)",
+      "rule": "All icons come from Phosphor Icons at the regular weight — the stroke-led icon language of ADS. Components import named icons from the @/lib/icons registry — never from an icon package directly — so swapping the underlying set touches one file.",
       "do": [
-        "Import icons from the @/lib/icons registry; add a new one there (stroke variant) before using it.",
+        "Import icons from the @/lib/icons registry; wrap a new Phosphor component with createIcon there before using it.",
         "Let icons default to size='1em' so they scale with text; size with a size prop or size-* class.",
-        "Keep stroke weight at the drawn 1.5; strokeWidth={2} is the one sanctioned emphasis step."
+        "Render weight='fill' for the active or selected state, and weight='bold' for the rare heavier stroke."
       ],
       "dont": [
-        "Import from an icon package directly, or use solid/duotone/twotone/fill variants.",
-        "Use a stroke weight thinner than 1.5."
+        "Import from an icon package directly, or install a second icon set.",
+        "Leave an active nav item's icon at the regular stroke weight."
       ],
       "enforcedByLint": true,
       "lintRules": [
@@ -8510,15 +8630,19 @@
       "id": "ads-first",
       "number": 7,
       "title": "ADS-first UI: use the library; extend only when asked",
-      "rule": "Every UI decision stays synchronized with ADS. Before making a new screen/control/pattern, check the ADS component suite first and use the exact exported name from the public barrel. Do not hand-roll, alias, deep-import, or import external UI libraries.",
+      "rule": "Every UI decision stays synchronized with ADS. Search the full catalog before deciding a component is missing, and use the exact exported name from the public barrel. When the barrel genuinely has no primitive, the sanctioned fallback is a shadcn/ui component vendored into src/components/ui through the repo's components.json recipe — never a hand-rolled control and never a UI library imported at a call site.",
       "do": [
         "Use an existing ADS component by its exact exported name from the package barrel; compose existing components for layout-only patterns.",
-        "Ask the user before extending ADS; only an explicit request authorizes new library work.",
+        "Search the whole catalog before concluding a component is missing — the documented specimens are a sample, not the inventory.",
+        "Fall back to shadcn/ui when the barrel has no primitive: vendor it with npx shadcn add into src/components/ui, import cn from @/lib/utils, and swap its lucide icons for @/lib/icons.",
+        "Let a vendored shadcn component inherit the ADS palette through the shadcn-compat aliases in theme.css rather than restyling it by hand.",
+        "Ask the user before promoting a vendored component into the public barrel; only an explicit request authorizes new library work.",
         "When authorized, add the component to the right family, export its exact name through the barrel, and document it."
       ],
       "dont": [
         "Deep-import, alias, default/namespace-import, or hand-roll a local copy of a component.",
-        "Import a visual component directly from the web or an npm UI library."
+        "Import a visual component directly from the web or an npm UI library at a call site.",
+        "Reach for the shadcn fallback before searching the catalog, or install a second component library beside it."
       ],
       "enforcedByLint": true,
       "lintRules": [
@@ -9473,10 +9597,10 @@
       ]
     },
     "counts": {
-      "nodes": 810,
-      "edges": 552,
-      "component": 323,
-      "state": 465,
+      "nodes": 802,
+      "edges": 545,
+      "component": 322,
+      "state": 458,
       "principle": 11,
       "production": 9,
       "layout": 2
@@ -10880,99 +11004,6 @@
         "showcaseUrl": "https://ads.actioneer.dev/#/dropdown",
         "description": ""
       },
-      {
-        "id": "component:FloatingDrawer",
-        "kind": "component",
-        "label": "FloatingDrawer",
-        "family": "Overlays",
-        "module": "drawer",
-        "showcaseUrl": "https://ads.actioneer.dev/#/drawer",
-        "description": ""
-      },
-      {
-        "id": "state:FloatingDrawer:side=right",
-        "kind": "state",
-        "label": "side=right",
-        "component": "FloatingDrawer",
-        "axis": "side",
-        "value": "right",
-        "required": false,
-        "derived": true,
-        "isDefault": true,
-        "description": ""
-      },
-      {
-        "id": "state:FloatingDrawer:side=left",
-        "kind": "state",
-        "label": "side=left",
-        "component": "FloatingDrawer",
-        "axis": "side",
-        "value": "left",
-        "required": false,
-        "derived": true,
-        "isDefault": false,
-        "description": ""
-      },
-      {
-        "id": "state:FloatingDrawer:side=bottom",
-        "kind": "state",
-        "label": "side=bottom",
-        "component": "FloatingDrawer",
-        "axis": "side",
-        "value": "bottom",
-        "required": false,
-        "derived": true,
-        "isDefault": false,
-        "description": ""
-      },
-      {
-        "id": "state:FloatingDrawer:size=sm",
-        "kind": "state",
-        "label": "size=sm",
-        "component": "FloatingDrawer",
-        "axis": "size",
-        "value": "sm",
-        "required": false,
-        "derived": true,
-        "isDefault": false,
-        "description": ""
-      },
-      {
-        "id": "state:FloatingDrawer:size=md",
-        "kind": "state",
-        "label": "size=md",
-        "component": "FloatingDrawer",
-        "axis": "size",
-        "value": "md",
-        "required": false,
-        "derived": true,
-        "isDefault": true,
-        "description": ""
-      },
-      {
-        "id": "state:FloatingDrawer:size=lg",
-        "kind": "state",
-        "label": "size=lg",
-        "component": "FloatingDrawer",
-        "axis": "size",
-        "value": "lg",
-        "required": false,
-        "derived": true,
-        "isDefault": false,
-        "description": ""
-      },
-      {
-        "id": "state:FloatingDrawer:size=xl",
-        "kind": "state",
-        "label": "size=xl",
-        "component": "FloatingDrawer",
-        "axis": "size",
-        "value": "xl",
-        "required": false,
-        "derived": true,
-        "isDefault": false,
-        "description": ""
-      },
       {
         "id": "component:InlineDrawer",
         "kind": "component",
@@ -13971,7 +14002,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. Interactive rows inherit the shared soft neutral hover/focus sink and keep their normal table geometry; do not add a brand tint or hover-only corner rounding. 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 (15px / 22px); only clearly secondary metadata inside a cell may opt down to text-s. Interactive rows inherit the shared soft neutral hover/focus sink and keep their normal table geometry; do not add a brand tint or hover-only corner rounding. 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",
@@ -17403,11 +17434,11 @@
         "rule": "Component motion follows the closest Animate UI interaction pattern, using role-specific presets defined in src/lib/motion.ts and exported from the ADS root barrel. Direct manipulation stays immediate, small CSS feedback stays local, and reduced motion is respected everywhere."
       },
       {
-        "id": "principle:icons-hugeicons-stroke",
+        "id": "principle:icons-phosphor-regular",
         "kind": "principle",
-        "label": "Icons: Hugeicons, stroke only",
+        "label": "Icons: Phosphor, regular weight (fill for active)",
         "number": 4,
-        "rule": "All icons come from Hugeicons in the Stroke Rounded style only. Components import named icons from the @/lib/icons registry — never from an icon package directly — so a free→Pro swap or a restyle touches one file."
+        "rule": "All icons come from Phosphor Icons at the regular weight — the stroke-led icon language of ADS. Components import named icons from the @/lib/icons registry — never from an icon package directly — so swapping the underlying set touches one file."
       },
       {
         "id": "principle:shell-owns-the-frame",
@@ -17428,7 +17459,7 @@
         "kind": "principle",
         "label": "ADS-first UI: use the library; extend only when asked",
         "number": 7,
-        "rule": "Every UI decision stays synchronized with ADS. Before making a new screen/control/pattern, check the ADS component suite first and use the exact exported name from the public barrel. Do not hand-roll, alias, deep-import, or import external UI libraries."
+        "rule": "Every UI decision stays synchronized with ADS. Search the full catalog before deciding a component is missing, and use the exact exported name from the public barrel. When the barrel genuinely has no primitive, the sanctioned fallback is a shadcn/ui component vendored into src/components/ui through the repo's components.json recipe — never a hand-rolled control and never a UI library imported at a call site."
       },
       {
         "id": "principle:minimal-information",
@@ -18669,48 +18700,6 @@
         "target": "state:DrawerTitle:size=xl",
         "relation": "supports-state"
       },
-      {
-        "id": "component:FloatingDrawer:supports-state:state:FloatingDrawer:side=right:global",
-        "source": "component:FloatingDrawer",
-        "target": "state:FloatingDrawer:side=right",
-        "relation": "supports-state"
-      },
-      {
-        "id": "component:FloatingDrawer:supports-state:state:FloatingDrawer:side=left:global",
-        "source": "component:FloatingDrawer",
-        "target": "state:FloatingDrawer:side=left",
-        "relation": "supports-state"
-      },
-      {
-        "id": "component:FloatingDrawer:supports-state:state:FloatingDrawer:side=bottom:global",
-        "source": "component:FloatingDrawer",
-        "target": "state:FloatingDrawer:side=bottom",
-        "relation": "supports-state"
-      },
-      {
-        "id": "component:FloatingDrawer:supports-state:state:FloatingDrawer:size=sm:global",
-        "source": "component:FloatingDrawer",
-        "target": "state:FloatingDrawer:size=sm",
-        "relation": "supports-state"
-      },
-      {
-        "id": "component:FloatingDrawer:supports-state:state:FloatingDrawer:size=md:global",
-        "source": "component:FloatingDrawer",
-        "target": "state:FloatingDrawer:size=md",
-        "relation": "supports-state"
-      },
-      {
-        "id": "component:FloatingDrawer:supports-state:state:FloatingDrawer:size=lg:global",
-        "source": "component:FloatingDrawer",
-        "target": "state:FloatingDrawer:size=lg",
-        "relation": "supports-state"
-      },
-      {
-        "id": "component:FloatingDrawer:supports-state:state:FloatingDrawer:size=xl:global",
-        "source": "component:FloatingDrawer",
-        "target": "state:FloatingDrawer:size=xl",
-        "relation": "supports-state"
-      },
       {
         "id": "component:InlineDrawer:supports-state:state:InlineDrawer:side=right:global",
         "source": "component:InlineDrawer",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@actioneer/ads-mcp",
-  "version": "0.7.0",
+  "version": "0.8.1",
   "description": "ADS MCP server: lets an agent in Claude Code / Cursor discover and import the Actioneer Design System",
   "type": "module",
   "bin": {
@@ -24,7 +24,7 @@
   },
   "dependencies": {
     "@actioneer/ads-lint": "^0.2.0",
-    "@actioneer/ads-manifest": "^0.2.0"
+    "@actioneer/ads-manifest": "^0.3.0"
   },
   "peerDependencies": {
     "@actioneer/ads": "*",

package/src/tools.mjs

@@ -8,6 +8,7 @@ import {
   searchComponents,
   getComponent,
   getToken,
+  getScale,
   getPrinciples,
   getUiGrammar,
   getDesignGraph,
@@ -50,7 +51,10 @@ export function createTools({ manifest }) {
       name: "get_token",
       description:
         "Get the ADS semantic token(s) for a role or purpose (e.g. 'brand', 'muted-foreground', " +
-        "'bg-danger', 'primary text'). Reference the returned token/utilities instead of a raw " +
+        "'bg-danger', 'primary text'). Also resolves the non-colour scales: type roles " +
+        "('body', 'label'), radius steps ('md'), the numbered shadow ladder ('shadow-300'), " +
+        "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.",
       inputSchema: {
         type: "object",
@@ -154,11 +158,34 @@ export function createTools({ manifest }) {
     },
 
     get_token: (args) => {
-      const tokens = getToken(manifest, args.role ?? "");
-      if (tokens.length === 0) {
-        return text(`No ADS token matches "${args.role}". Use a semantic role like 'brand' or 'muted-foreground'.`, true);
-      }
-      return json(tokens);
+      const raw = args.role ?? "";
+      const q = String(raw).trim().toLowerCase().replace(/^(bg|text|border|ring)-/, "");
+      const tokens = getToken(manifest, raw);
+      const scales = getScale(manifest, raw);
+
+      // Rank exact matches above fuzzy ones, colour first. getToken's fuzzy pass
+      // also searches token DESCRIPTIONS, so without this an exact scale key
+      // loses to a colour that merely mentions the word: "body" returned
+      // --color-success, whose description reads "...does not clear body-text AA".
+      const exactToken = tokens.filter((t) => t.role === q);
+      if (exactToken.length > 0) return json(exactToken);
+
+      const exactScale = scales.filter(
+        (s) =>
+          String(s.key).toLowerCase() === q ||
+          `${s.scale}-${String(s.key)}`.toLowerCase() === q ||
+          s.scale.toLowerCase() === q
+      );
+      if (exactScale.length > 0) return json(exactScale);
+
+      if (tokens.length > 0) return json(tokens);
+      if (scales.length > 0) return json(scales);
+      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').`,
+        true
+      );
     },
 
     get_principles: (args) => {