aural-ui 3.0.1 → 3.0.4

package/README.md

@@ -116,12 +116,12 @@ The **aural-ui MCP server** exposes the design system by reading from aural-ui s
 
 ### Setup in Cursor
 
-Add **aural-ui** in `.cursor/mcp.json` (or Cursor Settings → MCP). Start the MCP server first (e.g. `npx tsx mcp/src/index.ts` from the aural-ui repo root, or run the Docker image), then point Cursor at the streamable HTTP endpoint:
+Add the server in `.cursor/mcp.json` (or Cursor Settings → MCP). Start the MCP server first (e.g. `npx tsx mcp/src/index.ts` from the aural-ui repo root, or run the Docker image), then point Cursor at the streamable HTTP endpoint:
 
 ```json
 {
   "mcpServers": {
-    "aural-ui-mcp": {
+    "aural-ui": {
       "type": "streamableHttp",
       "url": "http://localhost:3000/mcp"
     }
@@ -129,23 +129,24 @@ Add **aural-ui** in `.cursor/mcp.json` (or Cursor Settings → MCP). Start the M
 }
 ```
 
-Use the same URL when the server runs in Docker or elsewhere (e.g. `http://your-host:3000/mcp`).
+The server identifies as **aural-ui** so agents match user phrases like "add aural-ui btn". Use the same URL when the server runs in Docker or elsewhere (e.g. `http://your-host:3000/mcp`).
 
 - **Config:** All MCP server settings are in `mcp/src/lib/env.ts` (no .env). You can set `AURAL_UI_SRC` there to the aural-ui repo `src` path if the workspace is not the aural-ui repo.
 
 **HTTP / Docker:** When running the MCP server over HTTP (e.g. in Docker):
 - **GET /health** — Returns `200` and `{ "ok": true, "server": "aural-ui" }` for load balancers and orchestrators (no MCP session required).
 - **GET /metrics** — Returns Prometheus-format metrics: `mcp_sessions_active`, `mcp_sessions_max`, `mcp_tool_calls_total{tool="..."}` (no MCP session required).
-- **Settings** (in `mcp/src/lib/env.ts`): `PORT` (default `3000`), `MCP_MAX_SESSIONS` (default `100`; 0 = unlimited), `MCP_SESSION_IDLE_TIMEOUT_MS` (default 15 min), `MCP_ALLOWED_PROJECT_ROOTS`, `MCP_LIST_CACHE_TTL_MS` (list cache TTL).
+- **Settings** (in `mcp/src/lib/env.ts`): `PORT` (default `3000`), `MCP_MAX_SESSIONS` (default `100`; 0 = unlimited), `MCP_SESSION_IDLE_TIMEOUT_MS` (default 15 min), `MCP_LIST_CACHE_TTL_MS` (list cache TTL).
 
-To have Cursor install Aural UI components in your project (instead of writing code manually), ask it to use **`add_aural_components`** with the component names (e.g. `["button", "card", "dialog"]`). The tool will run `npx aural-ui init --yes` if needed, then `npx aural-ui add ...`.
+To have Cursor install Aural UI components in your project (instead of writing code manually), ask it to use **`add_aural_components`** with the component names (e.g. `["button", "card", "dialog"]`). The agent must run the returned CLI steps first on the user machine; use componentSources only if the CLI fails. Do not pass `--yes` to `add`; only `init` supports it.
 
 ### MCP tools
 
 | Tool | Description |
 |------|-------------|
-| `add_aural_components` | **Runs the CLI:** init if needed, then `npx aural-ui add <components>`. Only use component names that exist; if the user's request is unclear or doesn't match, call `list_components` first and show available names—do not guess and add a different component. |
-| `init_aural_ui` | **Runs the CLI:** runs `npx aural-ui init --yes` in the workspace. Use when the project has no aural-ui.json yet. |
+| `add_aural_components` | **Returns instructions:** run the returned CLI steps first on the user machine (init if needed, then `npx aural-ui add <components>`); use componentSources only if CLI fails. Only use component names that exist; call `list_components` first if unclear. The MCP does not run the CLI. |
+| `init_aural_ui` | **Returns instructions:** step to run `npx aural-ui init --yes` in the project root on the user machine. Use when the project has no aural-ui.json yet. The MCP does not run the CLI. |
+| `ensure_aural_components` | **Returns instructions:** run the returned CLI steps first (init if needed, then add); use componentSources only if CLI fails. Only missing components are added by the CLI. The MCP does not run the CLI. |
 | `get_aural_ui_status` | Where aural-ui source is resolved (env, repo, node_modules). |
 | `get_aural_ui_version` | Returns the aural-ui design system version from the resolved source (package.json). |
 | `list_components` / `list_icons` / `list_hooks` | **Call first when unsure:** returns available component, icon, or hook names. Use when the user asks for a component/hook that might not exist so you can show the list instead of guessing. |

package/dist/components/button/Button.stories.tsx

@@ -67,7 +67,7 @@ export const Secondary: Story = {
     variant: "secondary",
     children: "Secondary Button",
     size: "md",
-    noise: "medium",
+    noise: "low",
   },
 }
 
@@ -242,9 +242,7 @@ export const AllVariants: Story = {
         <Button variant="primary" noise="medium">
           Primary
         </Button>
-        <Button variant="secondary" noise="medium">
-          Secondary
-        </Button>
+        <Button variant="secondary">Secondary</Button>
         <Button variant="outline" noise="none">
           Outline
         </Button>
@@ -287,13 +285,12 @@ export const WithToolTip: Story = {
       </Button>
       <Button
         variant="secondary"
-        tooltip="Secondary Variant with Low Noise"
+        tooltip="Secondary (default: low noise)"
         tooltipContentProps={{
           align: "center",
           side: "bottom",
           sideOffset: 10,
         }}
-        noise="low"
       >
         Secondary
       </Button>

package/dist/components/button/index.tsx

@@ -133,7 +133,7 @@ export const innerButtonVariants = cva(
       variant: "primary",
       disabled: "default",
       size: "md",
-      noise: "medium",
+      noise: "none",
     },
   }
 )
@@ -156,7 +156,7 @@ export const RawButton = forwardRef<HTMLButtonElement, ButtonProps>(
     {
       variant = "primary",
       size = "md",
-      noise = "medium",
+      noise: noiseProp,
       children,
       className = "",
       innerClassName = "",
@@ -168,6 +168,14 @@ export const RawButton = forwardRef<HTMLButtonElement, ButtonProps>(
     },
     ref
   ) => {
+    const noise =
+      noiseProp ??
+      (variant === "primary"
+        ? "medium"
+        : variant === "secondary"
+          ? "low"
+          : "none")
+
     const iconColor = isDisabled
       ? "var(--icon-fm-inactive)"
       : variant === "text"

package/dist/components/input/index.tsx

@@ -32,7 +32,7 @@ interface InputComponent extends ForwardRefExoticComponent<
 // CVA for input variants
 export const inputVariants = cva(
   // Base styles
-  "block w-full focus:outline-none transition-all duration-200 border-solid tracking-wide placeholder:text-fm-placeholder font-fm-text text-fm-primary",
+  "block w-full focus:outline-none transition-all duration-200 border-solid tracking-wide placeholder:text-fm-tertiary font-fm-text text-fm-primary",
   {
     variants: {
       variant: {

package/dist/components/slider/index.tsx

@@ -157,7 +157,7 @@ function Slider({
           key={index}
           aria-label={getThumbAriaLabel(index, _values[index])}
           className={cn(
-            "block shrink-0 transition-[color,box-shadow] hover:ring-2 focus-visible:ring-2 focus-visible:outline-hidden disabled:pointer-events-none disabled:opacity-50",
+            "block shrink-0 cursor-pointer transition-[color,box-shadow] hover:ring-2 focus-visible:ring-2 focus-visible:outline-hidden disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50",
             sliderThumbVariants({ size, variant }),
             classes?.thumb
           )}