@wizeworks/silicaui-mcp 0.41.0 → 0.43.0

package/dist/data/components.json

@@ -3981,14 +3981,22 @@
     "package": "@wizeworks/silicaui-react",
     "category": "Data input",
     "sourceFile": "silicaui-react/src/form.tsx",
-    "description": "Silica Form — a `<form>` that coordinates its Fields' validation. Behavior from Base UI: it runs each Field's validation on submit, focuses the first invalid control, and accepts server-returned `errors` keyed by field `name`. Presentational only otherwise — lay it out with `Field`s and utilities. <Form errors={serverErrors} onSubmit={…}> <Field name=\"email\">…</Field> <Button type=\"submit\">Save</Button> </Form>",
+    "description": "Silica Form — a `<form>` that coordinates its Fields' validation. Behavior from Base UI: it runs each Field's validation on submit, moves focus to the first invalid control, and accepts server-returned `errors` keyed by field `name`. Presentational only otherwise — lay it out with `Field`s and utilities. <Form errors={serverErrors} onSubmit={…}> <Field name=\"email\">…</Field> <Button type=\"submit\">Save</Button> </Form> Silica narrows the focus move, which is unconditional and un-opt-out-able upstream: it never selects the control's existing value, and never takes the caret from a text control the user is typing in when a late `errors` update arrives. Use `focusOnError` to soften it further: <Form focusOnError=\"scroll\" errors={serverErrors}>…</Form> // reveal, don't focus <Form focusOnError={false} errors={serverErrors}>…</Form> // leave focus alone",
     "props": [
       {
         "name": "FormProps",
-        "members": []
+        "extends": "extends React.ComponentPropsWithoutRef<typeof BaseForm>",
+        "members": [
+          {
+            "name": "focusOnError",
+            "optional": true,
+            "type": "FormFocusOnError",
+            "doc": "How an invalid submit (or a late `errors` update) treats focus. Defaults to `true`."
+          }
+        ]
       }
     ],
-    "usageExample": null
+    "usageExample": "import { useState } from \"react\";\nimport {\n    Button,\n    Field,\n    FieldControl,\n    FieldError,\n    FieldLabel,\n    Form,\n    PasswordInput,\n    ToggleGroup,\n    ToggleGroupItem,\n} from \"@wizeworks/silicaui-react\";\nimport type { FormFocusOnError } from \"@wizeworks/silicaui-react\";\nimport { Section, Stack } from \"../lib/Section\";\n\ntype Errors = Record<string, string>;\n\n/**\n * `Form` runs each Field's validation on submit and moves focus to the first\n * invalid control. `focusOnError` decides how far that goes — the sign-in shape\n * below is where it matters, because the rejection arrives from a server long\n * after the user has moved on to the next field.\n */\nexport function FormDemo() {\n    const [focusOnError, setFocusOnError] = useState<FormFocusOnError>(true);\n    const [errors, setErrors] = useState<Errors>({});\n    const [pending, setPending] = useState(false);\n\n    function onSubmit(event: React.FormEvent<HTMLFormElement>) {\n        event.preventDefault();\n        setErrors({});\n        setPending(true);\n        // Stands in for a sign-in round trip. Type into the password field while\n        // it runs: the caret has to stay put when the rejection lands.\n        window.setTimeout(() => {\n            setPending(false);\n            setErrors({ email: \"That address isn't registered.\" });\n        }, 1500);\n    }\n\n    return (\n        <>\n            <Section title=\"focusOnError\">\n                <Stack className=\"max-w-sm\">\n                    <ToggleGroup\n                        size=\"sm\"\n                        value={[String(focusOnError)]}\n                        onValueChange={(v) => {\n                            const next = v[0];\n                            if (next == null) return; // clicking the active item can't clear it\n                            setFocusOnError(\n                                next === \"false\" ? false : next === \"scroll\" ? \"scroll\" : true,\n                            );\n                        }}\n                    >\n                        <ToggleGroupItem value=\"true\">true</ToggleGroupItem>\n                        <ToggleGroupItem value=\"scroll\">scroll</ToggleGroupItem>\n                        <ToggleGroupItem value=\"false\">false</ToggleGroupItem>\n                    </ToggleGroup>\n                    <p className=\"text-sm\">\n                        Submit with an invalid email to see the client-side path. For the\n                        async path, submit a <em>valid</em> address and keep typing your\n                        password during the 1.5s round trip — the rejection must not take\n                        the caret.\n                    </p>\n                </Stack>\n            </Section>\n\n            <Section title=\"Sign in\">\n                <Form\n                    errors={errors}\n                    focusOnError={focusOnError}\n                    onSubmit={onSubmit}\n                    className=\"grid max-w-sm gap-4\"\n                >\n                    <Field name=\"email\">\n                        <FieldLabel required>Email</FieldLabel>\n                        <FieldControl\n                            type=\"email\"\n                            required\n                            placeholder=\"you@example.com\"\n                            data-testid=\"demo-email\"\n                        />\n                        <FieldError />\n                    </Field>\n                    <Field\n                        name=\"password\"\n                        validate={(v) =>\n                            String(v ?? \"\").length >= 8 ? null : \"Use at least 8 characters.\"\n                        }\n                    >\n                        <FieldLabel required>Password</FieldLabel>\n                        <FieldControl\n                            required\n                            render={<PasswordInput data-testid=\"demo-password\" />}\n                        />\n                        <FieldError />\n                    </Field>\n                    <Button type=\"submit\" color=\"primary\" loading={pending}>\n                        {pending ? \"Signing in…\" : \"Sign in\"}\n                    </Button>\n                </Form>\n            </Section>\n        </>\n    );\n}"
   },
   {
     "name": "Input",
@@ -10922,6 +10930,8 @@
       "alert-warning",
       "alert-error"
     ],
+    "colorPattern": "alert-<color>",
+    "colorNote": "The eight above are the DEFAULT roles, not the whole set — `alert-<color>` accepts any color the app registers (see get_tokens → customColors). `alert-brand` is as real as `alert-primary` once `brand` is declared.",
     "compoundSelectors": [
       ".alert-dismiss[data-closed]"
     ]
@@ -11024,6 +11034,8 @@
       "avatar-warning",
       "avatar-error"
     ],
+    "colorPattern": "avatar-<color>",
+    "colorNote": "The eight above are the DEFAULT roles, not the whole set — `avatar-<color>` accepts any color the app registers (see get_tokens → customColors). `avatar-brand` is as real as `avatar-primary` once `brand` is declared.",
     "compoundSelectors": [
       ".avatar-online::after, .avatar-offline::after",
       ".avatar-online::after",
@@ -11069,6 +11081,8 @@
       "badge-warning",
       "badge-error"
     ],
+    "colorPattern": "badge-<color>",
+    "colorNote": "The eight above are the DEFAULT roles, not the whole set — `badge-<color>` accepts any color the app registers (see get_tokens → customColors). `badge-brand` is as real as `badge-primary` once `brand` is declared.",
     "compoundSelectors": [
       ".badge:has(svg)"
     ]
@@ -11127,6 +11141,8 @@
       "btn-warning",
       "btn-error"
     ],
+    "colorPattern": "btn-<color>",
+    "colorNote": "The eight above are the DEFAULT roles, not the whole set — `btn-<color>` accepts any color the app registers (see get_tokens → customColors). `btn-brand` is as real as `btn-primary` once `brand` is declared.",
     "compoundSelectors": [
       ".btn:has(svg)"
     ]
@@ -11172,6 +11188,8 @@
       "calendar-warning",
       "calendar-error"
     ],
+    "colorPattern": "calendar-<color>",
+    "colorNote": "The eight above are the DEFAULT roles, not the whole set — `calendar-<color>` accepts any color the app registers (see get_tokens → customColors). `calendar-brand` is as real as `calendar-primary` once `brand` is declared.",
     "compoundSelectors": [
       ".date-field[data-placeholder] .date-field-value"
     ]
@@ -11288,6 +11306,18 @@
       "chat-header",
       "chat-image"
     ],
+    "colorVariants": [
+      "chat-bubble-primary",
+      "chat-bubble-secondary",
+      "chat-bubble-accent",
+      "chat-bubble-neutral",
+      "chat-bubble-info",
+      "chat-bubble-success",
+      "chat-bubble-warning",
+      "chat-bubble-error"
+    ],
+    "colorPattern": "chat-bubble-<color>",
+    "colorNote": "The eight above are the DEFAULT roles, not the whole set — `chat-bubble-<color>` accepts any color the app registers (see get_tokens → customColors). `chat-bubble-brand` is as real as `chat-bubble-primary` once `brand` is declared.",
     "compoundSelectors": [
       ".chat > *:not(.chat-image)",
       ".chat-end > *:not(.chat-image)",
@@ -11340,7 +11370,9 @@
       "checkbox-success",
       "checkbox-warning",
       "checkbox-error"
-    ]
+    ],
+    "colorPattern": "checkbox-<color>",
+    "colorNote": "The eight above are the DEFAULT roles, not the whole set — `checkbox-<color>` accepts any color the app registers (see get_tokens → customColors). `checkbox-brand` is as real as `checkbox-primary` once `brand` is declared."
   },
   {
     "name": "collapse",
@@ -11506,6 +11538,8 @@
       "data-table-warning",
       "data-table-error"
     ],
+    "colorPattern": "data-table-<color>",
+    "colorNote": "The eight above are the DEFAULT roles, not the whole set — `data-table-<color>` accepts any color the app registers (see get_tokens → customColors). `data-table-brand` is as real as `data-table-primary` once `brand` is declared.",
     "compoundSelectors": [
       ".data-table-sticky .data-table-scroll",
       ".data-table-sticky thead th",
@@ -11596,7 +11630,9 @@
       "dock-success",
       "dock-warning",
       "dock-error"
-    ]
+    ],
+    "colorPattern": "dock-<color>",
+    "colorNote": "The eight above are the DEFAULT roles, not the whole set — `dock-<color>` accepts any color the app registers (see get_tokens → customColors). `dock-brand` is as real as `dock-primary` once `brand` is declared."
   },
   {
     "name": "drawer",
@@ -11696,9 +11732,6 @@
       "select",
       "textarea"
     ],
-    "colorVariants": [
-      "field-error"
-    ],
     "compoundSelectors": [
       ".input[data-invalid], .select[data-invalid], .textarea[data-invalid]",
       ".input[data-status=\"error\"], .select[data-status=\"error\"], .textarea[data-status=\"error\"]",
@@ -11791,7 +11824,9 @@
       "filter-success",
       "filter-warning",
       "filter-error"
-    ]
+    ],
+    "colorPattern": "filter-<color>",
+    "colorNote": "The eight above are the DEFAULT roles, not the whole set — `filter-<color>` accepts any color the app registers (see get_tokens → customColors). `filter-brand` is as real as `filter-primary` once `brand` is declared."
   },
   {
     "name": "footer",
@@ -11889,7 +11924,9 @@
       "input-success",
       "input-warning",
       "input-error"
-    ]
+    ],
+    "colorPattern": "input-<color>",
+    "colorNote": "The eight above are the DEFAULT roles, not the whole set — `input-<color>` accepts any color the app registers (see get_tokens → customColors). `input-brand` is as real as `input-primary` once `brand` is declared."
   },
   {
     "name": "join",
@@ -11996,7 +12033,9 @@
       "link-success",
       "link-warning",
       "link-error"
-    ]
+    ],
+    "colorPattern": "link-<color>",
+    "colorNote": "The eight above are the DEFAULT roles, not the whole set — `link-<color>` accepts any color the app registers (see get_tokens → customColors). `link-brand` is as real as `link-primary` once `brand` is declared."
   },
   {
     "name": "list",
@@ -12137,6 +12176,8 @@
       "meter-warning",
       "meter-error"
     ],
+    "colorPattern": "meter-<color>",
+    "colorNote": "The eight above are the DEFAULT roles, not the whole set — `meter-<color>` accepts any color the app registers (see get_tokens → customColors). `meter-brand` is as real as `meter-primary` once `brand` is declared.",
     "compoundSelectors": [
       ".meter-xs .meter-track",
       ".meter-sm .meter-track",
@@ -12203,6 +12244,8 @@
       "multi-select-warning",
       "multi-select-error"
     ],
+    "colorPattern": "multi-select-<color>",
+    "colorNote": "The eight above are the DEFAULT roles, not the whole set — `multi-select-<color>` accepts any color the app registers (see get_tokens → customColors). `multi-select-brand` is as real as `multi-select-primary` once `brand` is declared.",
     "compoundSelectors": [
       ".multi-select:focus-within",
       ".multi-select[data-disabled]"
@@ -12339,7 +12382,9 @@
       "pagination-success",
       "pagination-warning",
       "pagination-error"
-    ]
+    ],
+    "colorPattern": "pagination-<color>",
+    "colorNote": "The eight above are the DEFAULT roles, not the whole set — `pagination-<color>` accepts any color the app registers (see get_tokens → customColors). `pagination-brand` is as real as `pagination-primary` once `brand` is declared."
   },
   {
     "name": "phone-input",
@@ -12375,7 +12420,19 @@
       "pin-input-cell-warning",
       "pin-input-cell-xl",
       "pin-input-cell-xs"
-    ]
+    ],
+    "colorVariants": [
+      "pin-input-cell-primary",
+      "pin-input-cell-secondary",
+      "pin-input-cell-accent",
+      "pin-input-cell-neutral",
+      "pin-input-cell-info",
+      "pin-input-cell-success",
+      "pin-input-cell-warning",
+      "pin-input-cell-error"
+    ],
+    "colorPattern": "pin-input-cell-<color>",
+    "colorNote": "The eight above are the DEFAULT roles, not the whole set — `pin-input-cell-<color>` accepts any color the app registers (see get_tokens → customColors). `pin-input-cell-brand` is as real as `pin-input-cell-primary` once `brand` is declared."
   },
   {
     "name": "popover",
@@ -12480,7 +12537,9 @@
       "progress-success",
       "progress-warning",
       "progress-error"
-    ]
+    ],
+    "colorPattern": "progress-<color>",
+    "colorNote": "The eight above are the DEFAULT roles, not the whole set — `progress-<color>` accepts any color the app registers (see get_tokens → customColors). `progress-brand` is as real as `progress-primary` once `brand` is declared."
   },
   {
     "name": "prose",
@@ -12555,7 +12614,9 @@
       "radio-success",
       "radio-warning",
       "radio-error"
-    ]
+    ],
+    "colorPattern": "radio-<color>",
+    "colorNote": "The eight above are the DEFAULT roles, not the whole set — `radio-<color>` accepts any color the app registers (see get_tokens → customColors). `radio-brand` is as real as `radio-primary` once `brand` is declared."
   },
   {
     "name": "range",
@@ -12589,6 +12650,8 @@
       "range-warning",
       "range-error"
     ],
+    "colorPattern": "range-<color>",
+    "colorNote": "The eight above are the DEFAULT roles, not the whole set — `range-<color>` accepts any color the app registers (see get_tokens → customColors). `range-brand` is as real as `range-primary` once `brand` is declared.",
     "compoundSelectors": [
       ".range[data-disabled] .range-thumb"
     ]
@@ -12628,6 +12691,8 @@
       "rating-warning",
       "rating-error"
     ],
+    "colorPattern": "rating-<color>",
+    "colorNote": "The eight above are the DEFAULT roles, not the whole set — `rating-<color>` accepts any color the app registers (see get_tokens → customColors). `rating-brand` is as real as `rating-primary` once `brand` is declared.",
     "compoundSelectors": [
       ".rating-readonly .rating-item"
     ]
@@ -12748,6 +12813,8 @@
       "segment-field-warning",
       "segment-field-error"
     ],
+    "colorPattern": "segment-field-<color>",
+    "colorNote": "The eight above are the DEFAULT roles, not the whole set — `segment-field-<color>` accepts any color the app registers (see get_tokens → customColors). `segment-field-brand` is as real as `segment-field-primary` once `brand` is declared.",
     "compoundSelectors": [
       ".segment-field:focus-within",
       ".segment-field[data-disabled]"
@@ -12811,7 +12878,9 @@
       "select-success",
       "select-warning",
       "select-error"
-    ]
+    ],
+    "colorPattern": "select-<color>",
+    "colorNote": "The eight above are the DEFAULT roles, not the whole set — `select-<color>` accepts any color the app registers (see get_tokens → customColors). `select-brand` is as real as `select-primary` once `brand` is declared."
   },
   {
     "name": "selection-list",
@@ -12873,6 +12942,8 @@
       "sidebar-warning",
       "sidebar-error"
     ],
+    "colorPattern": "sidebar-<color>",
+    "colorNote": "The eight above are the DEFAULT roles, not the whole set — `sidebar-<color>` accepts any color the app registers (see get_tokens → customColors). `sidebar-brand` is as real as `sidebar-primary` once `brand` is declared.",
     "compoundSelectors": [
       ".sidebar[data-side=\"right\"]",
       ".sidebar[data-collapsed]",
@@ -12939,6 +13010,8 @@
       "slider-warning",
       "slider-error"
     ],
+    "colorPattern": "slider-<color>",
+    "colorNote": "The eight above are the DEFAULT roles, not the whole set — `slider-<color>` accepts any color the app registers (see get_tokens → customColors). `slider-brand` is as real as `slider-primary` once `brand` is declared.",
     "compoundSelectors": [
       ".slider[data-orientation=\"vertical\"]",
       ".slider-control[data-orientation=\"vertical\"]",
@@ -13034,6 +13107,8 @@
       "status-warning",
       "status-error"
     ],
+    "colorPattern": "status-<color>",
+    "colorNote": "The eight above are the DEFAULT roles, not the whole set — `status-<color>` accepts any color the app registers (see get_tokens → customColors). `status-brand` is as real as `status-primary` once `brand` is declared.",
     "compoundSelectors": [
       "@keyframes silica-ping",
       "@media (prefers-reduced-motion: reduce)"
@@ -13068,6 +13143,8 @@
       "step-warning",
       "step-error"
     ],
+    "colorPattern": "step-<color>",
+    "colorNote": "The eight above are the DEFAULT roles, not the whole set — `step-<color>` accepts any color the app registers (see get_tokens → customColors). `step-brand` is as real as `step-primary` once `brand` is declared.",
     "compoundSelectors": [
       ".step::before",
       ".step[data-content]::before",
@@ -13137,6 +13214,8 @@
       "switch-warning",
       "switch-error"
     ],
+    "colorPattern": "switch-<color>",
+    "colorNote": "The eight above are the DEFAULT roles, not the whole set — `switch-<color>` accepts any color the app registers (see get_tokens → customColors). `switch-brand` is as real as `switch-primary` once `brand` is declared.",
     "compoundSelectors": [
       ".switch[data-checked] .switch-thumb"
     ]
@@ -13193,6 +13272,8 @@
       "tabs-warning",
       "tabs-error"
     ],
+    "colorPattern": "tabs-<color>",
+    "colorNote": "The eight above are the DEFAULT roles, not the whole set — `tabs-<color>` accepts any color the app registers (see get_tokens → customColors). `tabs-brand` is as real as `tabs-primary` once `brand` is declared.",
     "compoundSelectors": [
       ".tabs-boxed .tabs-list",
       ".tabs-boxed .tabs-tab",
@@ -13241,6 +13322,8 @@
       "tag-input-warning",
       "tag-input-error"
     ],
+    "colorPattern": "tag-input-<color>",
+    "colorNote": "The eight above are the DEFAULT roles, not the whole set — `tag-input-<color>` accepts any color the app registers (see get_tokens → customColors). `tag-input-brand` is as real as `tag-input-primary` once `brand` is declared.",
     "compoundSelectors": [
       ".tag-input:focus-within",
       ".tag-input[data-disabled]"
@@ -13278,7 +13361,9 @@
       "textarea-success",
       "textarea-warning",
       "textarea-error"
-    ]
+    ],
+    "colorPattern": "textarea-<color>",
+    "colorNote": "The eight above are the DEFAULT roles, not the whole set — `textarea-<color>` accepts any color the app registers (see get_tokens → customColors). `textarea-brand` is as real as `textarea-primary` once `brand` is declared."
   },
   {
     "name": "timeline",
@@ -13333,6 +13418,18 @@
       "toast-title",
       "toast-viewport"
     ],
+    "colorVariants": [
+      "toast[data-type=\"primary\"]",
+      "toast[data-type=\"secondary\"]",
+      "toast[data-type=\"accent\"]",
+      "toast[data-type=\"neutral\"]",
+      "toast[data-type=\"info\"]",
+      "toast[data-type=\"success\"]",
+      "toast[data-type=\"warning\"]",
+      "toast[data-type=\"error\"]"
+    ],
+    "colorPattern": "toast[data-type=\"<color>\"]",
+    "colorNote": "The eight above are the DEFAULT roles, not the whole set — `toast[data-type=\"<color>\"]` accepts any color the app registers (see get_tokens → customColors). `toast[data-type=\"brand\"]` is as real as `toast[data-type=\"primary\"]` once `brand` is declared.",
     "compoundSelectors": [
       ".toast[data-type=\"primary\"]",
       ".toast[data-type=\"secondary\"]",
@@ -13378,6 +13475,8 @@
       "toggle-group-warning",
       "toggle-group-error"
     ],
+    "colorPattern": "toggle-group-<color>",
+    "colorNote": "The eight above are the DEFAULT roles, not the whole set — `toggle-group-<color>` accepts any color the app registers (see get_tokens → customColors). `toggle-group-brand` is as real as `toggle-group-primary` once `brand` is declared.",
     "compoundSelectors": [
       ".toggle-group-xs .toggle-group-item",
       ".toggle-group-sm .toggle-group-item",
@@ -13418,7 +13517,9 @@
       "toggle-success",
       "toggle-warning",
       "toggle-error"
-    ]
+    ],
+    "colorPattern": "toggle-<color>",
+    "colorNote": "The eight above are the DEFAULT roles, not the whole set — `toggle-<color>` accepts any color the app registers (see get_tokens → customColors). `toggle-brand` is as real as `toggle-primary` once `brand` is declared."
   },
   {
     "name": "toolbar",
@@ -13576,6 +13677,8 @@
       "wizard-warning",
       "wizard-error"
     ],
+    "colorPattern": "wizard-<color>",
+    "colorNote": "The eight above are the DEFAULT roles, not the whole set — `wizard-<color>` accepts any color the app registers (see get_tokens → customColors). `wizard-brand` is as real as `wizard-primary` once `brand` is declared.",
     "compoundSelectors": [
       ".wizard-step[data-clickable]",
       ".wizard-step[data-disabled]",
@@ -13618,7 +13721,9 @@
       "wordmark-success",
       "wordmark-warning",
       "wordmark-error"
-    ]
+    ],
+    "colorPattern": "wordmark-<color>",
+    "colorNote": "The eight above are the DEFAULT roles, not the whole set — `wordmark-<color>` accepts any color the app registers (see get_tokens → customColors). `wordmark-brand` is as real as `wordmark-primary` once `brand` is declared."
   },
   {
     "name": "color-utilities",

package/dist/data/tokens.json

@@ -9,6 +9,60 @@
     "warning",
     "error"
   ],
+  "semanticColorsNote": "These eight are the DEFAULT roles, not a closed list — see customColors. An app can register any number of extra roles, and they work everywhere a built-in one does.",
+  "customColors": {
+    "summary": "Silica's core promise: N named colors cascade through everything. A color you register gets the full utility trio AND every component variant, with no codegen step and no safelist.",
+    "howToDeclare": "@plugin \"@wizeworks/silicaui\" { colors: primary, secondary, accent, neutral, info, success, warning, error, brand; }\n@theme { --color-brand: #7c3aed; }",
+    "declareNote": "The `colors:` list REPLACES the default set, so re-list the built-ins you still want. Using a `*-brand` class without registering `brand` leaves it unstyled; the plugin warns at build time (warn-unregistered-colors.js).",
+    "contentNote": "`--color-brand-content` (the legible ink ON brand) is optional — omit it and Silica auto-derives black/white by measured contrast. Declare it only to override that choice.",
+    "utilities": [
+      "text-<color>",
+      "bg-<color>",
+      "border-<color>",
+      "text-<color>-content",
+      "bg-<color>-content",
+      "border-<color>-content"
+    ],
+    "componentPatterns": [
+      "alert-<color>",
+      "avatar-<color>",
+      "badge-<color>",
+      "btn-<color>",
+      "calendar-<color>",
+      "chat-bubble-<color>",
+      "checkbox-<color>",
+      "data-table-<color>",
+      "dock-<color>",
+      "filter-<color>",
+      "input-<color>",
+      "link-<color>",
+      "meter-<color>",
+      "multi-select-<color>",
+      "pagination-<color>",
+      "pin-input-cell-<color>",
+      "progress-<color>",
+      "radio-<color>",
+      "range-<color>",
+      "rating-<color>",
+      "segment-field-<color>",
+      "select-<color>",
+      "sidebar-<color>",
+      "slider-<color>",
+      "status-<color>",
+      "step-<color>",
+      "switch-<color>",
+      "tabs-<color>",
+      "tag-input-<color>",
+      "textarea-<color>",
+      "toast[data-type=\"<color>\"]",
+      "toggle-<color>",
+      "toggle-group-<color>",
+      "wizard-<color>",
+      "wordmark-<color>"
+    ],
+    "componentPatternsNote": "Every colorable component, as a selector template — substitute a registered color name. Most are `<root>-<color>`; chat, pin-input and toast are not, so read the pattern rather than assuming.",
+    "builderNote": "In @wizeworks/silicaui-builder, a color invented live in the theme editor is generated at runtime (scoped to the canvas) from these same patterns, so it behaves identically to a build-time-declared one without a rebuild."
+  },
   "light": {
     "base-100": "oklch(98% 0.003 250)",
     "base-200": "oklch(95% 0.004 250)",

package/dist/server.js

@@ -44,8 +44,8 @@ var INSTRUCTIONS = `Silica UI is ONE design system delivered through THREE paths
    Path 3 fails SILENTLY where the others fail loudly \u2014 an unlisted tag becomes a <div>, an unlisted attribute is dropped, an invented binding field is not persisted, and the output still looks plausible. Look it up.
 
 Rules that hold on every path:
-- Never invent a class, prop, color, or block key. Everything this server returns is extracted from Silica's source at release time \u2014 look it up rather than guessing, including when you are fairly confident.
-- Colors are semantic tokens (get_tokens), never hex. An app can declare extra color roles; those work everywhere a built-in one does.
+- Never invent a class, prop, or block key. Everything this server returns is extracted from Silica's source at release time \u2014 look it up rather than guessing, including when you are fairly confident.
+- Colors are semantic tokens (get_tokens), never hex \u2014 but the eight built-in roles are a DEFAULT, not a closed set. Silica's core promise is that N named colors cascade through everything: an app registers extra roles (get_tokens \u2192 customColors for the two-line syntax) and each works everywhere a built-in does, so \`btn-brand\` is exactly as real as \`btn-primary\`. Read a component's \`colorPattern\` (get_component) and substitute the registered name \u2014 most are \`<root>-<color>\`, but chat, pin-input and toast are not. A REGISTERED color is the one name you may use that this catalog does not list literally; an unregistered one is still an invention, and renders unstyled.
 - Do not re-skin a component with inline styles or arbitrary hex \u2014 it defeats theming and light/dark.
 - The same name can exist on more than one path with a different shape. get_component with no \`package\` returns every path's answer at once; pass \`package\` to narrow.
 - Don't know the name? search_docs first. Unsure what to install? list_packages.
@@ -209,7 +209,7 @@ function createServer() {
     "get_tokens",
     {
       title: "Get Silica UI design tokens",
-      description: "Get the semantic color list and their light/dark OKLCH values, the typography token model, and the scalar theme tokens (radius/border/depth/noise/focus/disabled-opacity) with defaults, ranges, and what each one actually affects.",
+      description: "Get the semantic color list and their light/dark OKLCH values, the typography token model, and the scalar theme tokens (radius/border/depth/noise/focus/disabled-opacity) with defaults, ranges, and what each one actually affects. Also returns `customColors`: how to register extra color roles beyond the built-in eight, and the selector pattern for every component a registered color reaches \u2014 call this before concluding a color like `brand` is unavailable.",
       inputSchema: {}
     },
     async () => ({ content: [{ type: "text", text: JSON.stringify(tokens, null, 2) }] })
@@ -416,6 +416,31 @@ function createServer() {
         ([component, classes]) => classes.filter((cls) => cls.toLowerCase().includes(q)).map((cls) => ({ kind: "class", component, class: cls }))
       );
       const matchedTokens = tokens.semanticColors.filter((name) => name.toLowerCase().includes(q)).map((name) => ({ kind: "token", name }));
+      const COLOR_CONCEPT = [
+        "custom color",
+        "custom colors",
+        "color role",
+        "n-color",
+        "brand",
+        "register",
+        "registered",
+        "declare",
+        "@plugin",
+        "plugin",
+        "@theme",
+        "palette",
+        "extra color",
+        "new color"
+      ];
+      const matchedColorConcept = COLOR_CONCEPT.some((k) => k.includes(q) || q.includes(k)) ? [
+        {
+          kind: "concept",
+          name: "custom colors (N-color)",
+          summary: tokens.customColors.summary,
+          tool: "get_tokens",
+          field: "customColors"
+        }
+      ] : [];
       const matchedBindings = schema.dataBindings.filter(
         (b) => b.kind.toLowerCase().includes(q) || b.doc.toLowerCase().includes(q) || b.fields.some((f) => f.name.toLowerCase().includes(q))
       ).map((b) => ({ kind: "data-binding", binding: b.kind, tool: "get_node_schema" }));
@@ -433,6 +458,7 @@ function createServer() {
         ...matchedBehaviors,
         ...matchedClasses,
         ...matchedTokens,
+        ...matchedColorConcept,
         ...matchedBindings,
         ...matchedNodeKinds,
         ...matchedTags,

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/server.ts"],"names":[],"mappings":"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","file":"server.js","sourcesContent":["import { readFileSync } from \"node:fs\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { z } from \"zod\";\n\nconst here = path.dirname(fileURLToPath(import.meta.url));\nconst dataDir = path.join(here, \"data\");\n\nfunction loadJson<T>(name: string): T {\n  return JSON.parse(readFileSync(path.join(dataDir, `${name}.json`), \"utf8\")) as T;\n}\n\n/**\n * The version this catalog documents, read from our OWN package.json at\n * startup rather than baked into the generated catalog.\n *\n * Every package in the family is released in lockstep — they're all listed in\n * `fixed` in .changeset/config.json, so their versions are identical by\n * construction — which makes our own version the right answer for all of them.\n *\n * This used to be snapshotted into `packages.json` at catalog-generation time,\n * but `gen` isn't part of `build` or the release, so the number froze at\n * whichever version happened to be current the last time someone ran it by\n * hand, and the server reported 0.26.0 while npm served 0.29.0. Reading it at\n * runtime makes that drift structurally impossible instead of a step someone\n * has to remember.\n */\nfunction readOwnVersion(): string {\n  // `here` is dist/ in a build and src/ in dev; package.json sits one level up\n  // from both, and npm always includes it in the published tarball.\n  try {\n    const pkg = JSON.parse(\n      readFileSync(path.join(here, \"..\", \"package.json\"), \"utf8\"),\n    ) as { version?: unknown };\n    if (typeof pkg.version === \"string\" && pkg.version) return pkg.version;\n    console.error(\n      \"[silicaui-mcp] package.json has no usable `version`; reporting 'unknown'.\",\n    );\n  } catch (err) {\n    console.error(\n      `[silicaui-mcp] could not read own package.json (${(err as Error).message}); reporting 'unknown'.`,\n    );\n  }\n  return \"unknown\";\n}\n\nconst VERSION = readOwnVersion();\n\ninterface PackageMeta {\n  name: string;\n  purpose: string;\n  install: string | null;\n  private?: boolean;\n}\n\ninterface TokensData {\n  semanticColors: string[];\n  light: Record<string, string>;\n  dark: Record<string, string>;\n  typography: { baseFontSize: string; fontFamilyTokens: string[]; note: string };\n}\n\ninterface PropMember {\n  name: string;\n  optional: boolean;\n  type: string;\n  doc: string;\n}\n\ninterface PropsInterface {\n  name: string;\n  extends?: string;\n  members: PropMember[];\n}\n\n/**\n * The routing preamble every connecting client receives from `initialize`,\n * before it calls a single tool.\n *\n * Silica ships one design system through three delivery paths, and the choice\n * between them is made BEFORE any tool call — by which point per-tool\n * descriptions are too late to help. Without this, an agent got ten tools in a\n * bag and inferred the architecture from their names; the standard failure was\n * reaching for `@wizeworks/silicaui-react` while emitting non-React output, or\n * shipping node-tree markup with no behavior runtime and wondering why nothing\n * opened.\n *\n * Deliberately names no counts and no version — those drift. Package names are\n * asserted against the real catalog by verify.mjs.\n */\nconst INSTRUCTIONS = `Silica UI is ONE design system delivered through THREE paths. Decide which path matches the code you are writing BEFORE writing any markup — the paths share a class vocabulary but are not interchangeable, and mixing them is the most common way an integration breaks.\n\n1. CSS — \\`@wizeworks/silicaui\\`\n   A Tailwind v4 plugin. You write plain HTML and put Silica's classes on it: \\`<button class=\"btn btn-primary\">\\`. No JavaScript ships, so nothing is interactive — a dialog styled this way will not open. Use it for static markup, server-rendered templates (Rails, Django, PHP, Go, …), email, or any framework at all. It is the floor the other two paths stand on.\n   → get_component(name, package \"@wizeworks/silicaui\") for a family's root class, its parts, and its color variants; list_classes for the literal names.\n\n2. React — \\`@wizeworks/silicaui-react\\`\n   Typed React components over those same classes, with Base UI supplying real behavior and accessibility: \\`<Button color=\"primary\" size=\"lg\">\\`. Use it whenever the output is React or Next.js.\n   → get_component(name, package \"@wizeworks/silicaui-react\") for real props (extracted from the TypeScript source) and a working usage example.\n\n3. HTML / node-tree — \\`@wizeworks/silicaui-html\\` + \\`@wizeworks/silicaui-behaviors\\`\n   A framework-neutral node-tree schema that projects to HTML — for generated or user-authored documents: site builders, CMS output, static export. Component macros expand to element subtrees carrying \\`data-sui-*\\` markers, which the zero-dependency \\`@wizeworks/silicaui-behaviors\\` runtime hydrates at load. That runtime is what makes path 3 interactive; without it you have path 1.\n   → get_node_schema FIRST for the tree's own shape: the node kinds, the data-binding vocabulary (how a node draws live content, repeats over a collection, or hides itself), the resolution contract, and the tag/attribute allowlist \\`toHtml\\` enforces. Then get_component(name, package \"@wizeworks/silicaui-html\") for the macro; list_blocks / get_block for composed sections; list_behaviors for the marker contract.\n   Path 3 fails SILENTLY where the others fail loudly — an unlisted tag becomes a <div>, an unlisted attribute is dropped, an invented binding field is not persisted, and the output still looks plausible. Look it up.\n\nRules that hold on every path:\n- Never invent a class, prop, color, or block key. Everything this server returns is extracted from Silica's source at release time — look it up rather than guessing, including when you are fairly confident.\n- Colors are semantic tokens (get_tokens), never hex. An app can declare extra color roles; those work everywhere a built-in one does.\n- Do not re-skin a component with inline styles or arbitrary hex — it defeats theming and light/dark.\n- The same name can exist on more than one path with a different shape. get_component with no \\`package\\` returns every path's answer at once; pass \\`package\\` to narrow.\n- Don't know the name? search_docs first. Unsure what to install? list_packages.\n\nAuthoring an EMAIL through \\`@wizeworks/silicaui-builder/email\\`? That is a separate surface, not a fourth path: a CLOSED document schema of typed nodes that projects to table-based inline-styled HTML. Its kinds, fields, and nesting rules are enforced — an invented kind or an illegal nesting is dropped silently, with no error to read — so call list_email_nodes / get_email_node rather than reasoning from the paths above. Classes and components do not apply there; colors are literal hex.\n\nSigns you are on the wrong path: importing @wizeworks/silicaui-react into output that is not React; hand-writing \\`data-sui-*\\` markers (they come from macro expansion, never from you); shipping path-3 markup without loading @wizeworks/silicaui-behaviors; expecting path 1 alone to open a dialog.`;\n\ninterface ComponentData {\n  name: string;\n  package: string;\n  category: string;\n  sourceFile: string;\n  /** silicaui-react entries: extracted from source via TS AST. silicaui-html\n   *  macros carry no static description (never hand-authored — see label/icon\n   *  instead) and omit these two fields. */\n  description?: string;\n  props?: PropsInterface[];\n  usageExample?: string | null;\n  /** silicaui-html macros only: palette label/icon, whether it's a container,\n   *  and the BehaviorType(s) its expansion carries (found by actually calling\n   *  expand(), not guessed — see get_behavior for the marker contract). */\n  label?: string;\n  icon?: string;\n  container?: boolean;\n  behaviors?: string[];\n  /** silicaui (CSS) entries only: the family's root class (null when it has\n   *  none — see familyPrefix/rootNote), every literal class it generates, its\n   *  color variants, and any compound selector that reveals required structure. */\n  root?: string | null;\n  familyPrefix?: string;\n  rootNote?: string;\n  classes?: string[];\n  colorVariants?: string[];\n  compoundSelectors?: string[];\n}\n\ninterface BlockSlot {\n  name: string;\n  [key: string]: unknown;\n}\n\ninterface BlockData {\n  key: string;\n  name: string;\n  category: string;\n  version: string;\n  description: string;\n  tags?: string[];\n  colors: string[];\n  behaviors: string[];\n  emailEligible: boolean;\n  slots: BlockSlot[];\n  root: unknown;\n  preview?: unknown;\n}\n\ninterface BehaviorData {\n  type: string;\n  description: string;\n}\n\ninterface EmailFieldData {\n  name: string;\n  optional: boolean;\n  type: string;\n  doc: string;\n}\n\ninterface EmailKindData {\n  kind: string;\n  typeName: string;\n  doc: string;\n  isContent: boolean;\n  container: boolean;\n  holds: string[];\n  allowedParents: string[];\n  fields: EmailFieldData[];\n  binding: { default?: string; fields: Record<string, string> } | null;\n  sourceFile: string;\n}\n\ninterface EmailData {\n  entrypoint: string;\n  reactEntrypoint: string;\n  note: string;\n  sharedFields: EmailFieldData[];\n  bindingNote: string;\n  /** The envelope around the node tree — EmailDocument/EmailProject/\n   *  EmailColorDefaults and friends. A kind list alone can't answer \"what do I\n   *  wrap this in\". */\n  documentTypes: Array<{ typeName: string; doc: string; fields: EmailFieldData[] }>;\n  kinds: EmailKindData[];\n  palette: Array<{ key: string; label: string; hint: string; icon: string; kind: string }>;\n}\n\ninterface FieldData {\n  name: string;\n  optional: boolean;\n  type: string;\n  doc: string;\n}\n\n/** Path 3's DOCUMENT schema — the node tree itself, as opposed to what you put\n *  in it. Generated from silicaui-html's own source; see gen-catalog's\n *  schema.json section for why each part is extracted rather than described. */\ninterface SchemaData {\n  entrypoint: string;\n  behaviorRuntime: string;\n  sourceFile: string;\n  note: string;\n  child: string;\n  nodeBase: FieldData[];\n  kinds: Array<{ kind: string; typeName: string; doc: string; sharedFields: boolean; fields: FieldData[] }>;\n  bindingNote: string;\n  dataBindings: Array<{ kind: string; doc: string; fields: Array<{ name: string; optional: boolean; type: string }> }>;\n  resolution: {\n    note: string;\n    honesty: string;\n    host: FieldData[];\n    resolved: FieldData[];\n    scope: FieldData[];\n    options: FieldData[];\n    diagnostic: FieldData[];\n  };\n  elementFloor: {\n    note: string;\n    globalAttrs: string[];\n    tags: Array<{ tag: string; group: string; void: boolean; attrs: string[] }>;\n  };\n}\n\nconst packages = loadJson<PackageMeta[]>(\"packages\");\nconst tokens = loadJson<TokensData>(\"tokens\");\nconst classesByComponent = loadJson<Record<string, string[]>>(\"classes\");\nconst blocks = loadJson<BlockData[]>(\"blocks\");\nconst behaviors = loadJson<BehaviorData[]>(\"behaviors\");\nconst components = loadJson<ComponentData[]>(\"components\");\nconst email = loadJson<EmailData>(\"email\");\nconst schema = loadJson<SchemaData>(\"schema\");\n\n/** CSS → React → HTML: the order the instructions introduce the paths in, so a\n *  multi-path get_component answer reads the same way every time. Packages not\n *  listed (the wrappers) sort last via indexOf's -1... which sorts them FIRST,\n *  so map those to a large index instead. */\nconst PATH_ORDER_LIST = [\n  \"@wizeworks/silicaui\",\n  \"@wizeworks/silicaui-react\",\n  \"@wizeworks/silicaui-html\",\n];\nconst PATH_ORDER = {\n  indexOf(pkg: string): number {\n    const i = PATH_ORDER_LIST.indexOf(pkg);\n    return i === -1 ? PATH_ORDER_LIST.length : i;\n  },\n};\n\nfunction toKebab(name: string): string {\n  return name\n    .replace(/([a-z0-9])([A-Z])/g, \"$1-$2\")\n    .toLowerCase();\n}\n\nfunction blockSummary(b: BlockData) {\n  const { root: _root, ...summary } = b;\n  return summary;\n}\n\nexport function createServer(): McpServer {\n  const server = new McpServer(\n    {\n      name: \"@wizeworks/silicaui-mcp\",\n      version: VERSION,\n    },\n    { instructions: INSTRUCTIONS },\n  );\n\n  server.registerTool(\n    \"list_packages\",\n    {\n      title: \"List Silica UI packages\",\n      description:\n        \"List every package in the Silica UI family (@wizeworks/silicaui, @wizeworks/silicaui-react, @wizeworks/silicaui-html, @wizeworks/silicaui-behaviors, and the wrapper packages), with purpose, install command, and version.\",\n      inputSchema: {},\n    },\n    async () => ({\n      content: [\n        {\n          type: \"text\",\n          // Version is stamped here, not stored in the catalog — see VERSION.\n          text: JSON.stringify(\n            packages.map((p) => ({ ...p, version: VERSION })),\n            null,\n            2,\n          ),\n        },\n      ],\n    }),\n  );\n\n  server.registerTool(\n    \"list_components\",\n    {\n      title: \"List Silica UI components\",\n      description:\n        \"List component names, categories, and source packages — spans ALL THREE delivery paths: @wizeworks/silicaui (CSS class families for plain HTML), @wizeworks/silicaui-react (typed React components), and @wizeworks/silicaui-html (framework-neutral ComponentDef macros for generated/non-React output). The same component usually exists on more than one path with a completely different shape; get_component returns every path's answer unless you pass a package. Filter here with the package param (e.g. '@wizeworks/silicaui', '@wizeworks/silicaui-react', '@wizeworks/silicaui-html', '@wizeworks/silicaui-charts').\",\n      inputSchema: {\n        package: z.string().optional().describe(\"Filter to one package name, e.g. '@wizeworks/silicaui-react'.\"),\n      },\n    },\n    async ({ package: pkg }) => {\n      const filtered = pkg ? components.filter((c) => c.package === pkg) : components;\n      const summary = filtered.map(({ name, package: p, category, sourceFile }) => ({\n        name,\n        package: p,\n        category,\n        sourceFile,\n      }));\n      return { content: [{ type: \"text\", text: JSON.stringify(summary, null, 2) }] };\n    },\n  );\n\n  server.registerTool(\n    \"get_component\",\n    {\n      title: \"Get a Silica UI component's real shape\",\n      description:\n        \"Get a component's real definition on whichever delivery path you're building on — for @wizeworks/silicaui (CSS): the family's root class, every literal class it generates, its color variants, and any compound selector that reveals required markup structure; for @wizeworks/silicaui-react: props (name, type, optional, doc — extracted from its actual TypeScript source) plus a real, working usage example; for @wizeworks/silicaui-html: its palette category/label/icon, whether it's a container, and the BehaviorType(s) it carries (cross-reference get_behavior for the marker contract). Use this instead of guessing class names, prop names, or shapes. Omit package to see every path's answer side by side; pass it to get just one.\",\n      inputSchema: {\n        name: z.string().describe(\"Component name, e.g. 'Button', 'DataTable', 'Dialog'.\"),\n        package: z.string().optional().describe(\"Disambiguate when the name exists in more than one package, e.g. '@wizeworks/silicaui-html'.\"),\n      },\n    },\n    async ({ name, package: pkg }) => {\n      let matches = components.filter((c) => c.name.toLowerCase() === name.toLowerCase());\n      if (pkg) matches = matches.filter((c) => c.package === pkg);\n      if (!matches.length) {\n        return {\n          content: [\n            {\n              type: \"text\",\n              text: `No component named \"${name}\"${pkg ? ` in ${pkg}` : \"\"}. Call list_components to see valid names.`,\n            },\n          ],\n          isError: true,\n        };\n      }\n      // A name on more than one path used to be an isError telling the caller\n      // to pick a package — which costs a round trip and, worse, asks for a\n      // choice the caller can't make yet: it doesn't know how the shapes\n      // differ, which is the very thing it's asking about. Returning all of\n      // them answers the question AND demonstrates the three paths at the one\n      // moment the distinction actually matters.\n      if (matches.length > 1) {\n        const ordered = [...matches].sort(\n          (a, b) => PATH_ORDER.indexOf(a.package) - PATH_ORDER.indexOf(b.package),\n        );\n        return {\n          content: [\n            {\n              type: \"text\",\n              text: JSON.stringify(\n                {\n                  name: ordered[0]?.name ?? name,\n                  note:\n                    `\"${name}\" exists on ${ordered.length} delivery paths, listed below with their real (different) shapes: ` +\n                    `${ordered.map((c) => c.package).join(\", \")}. Use the one matching the code you're writing — ` +\n                    `they are not interchangeable. Pass \\`package\\` to get just one.`,\n                  paths: ordered,\n                },\n                null,\n                2,\n              ),\n            },\n          ],\n        };\n      }\n      return { content: [{ type: \"text\", text: JSON.stringify(matches[0], null, 2) }] };\n    },\n  );\n\n  server.registerTool(\n    \"list_classes\",\n    {\n      title: \"List real Silica UI CSS class names\",\n      description:\n        \"List the exact, literal CSS class names Silica UI generates for a core component (e.g. 'button', 'card', 'badge') — or all components if none given. These are extracted directly from the class generators, so they are never hallucinated. Also covers 'color-utilities' (text-*/bg-*/border-* for every declared color). This returns a flat list; for the CSS path's STRUCTURE — which class is the root, which are its parts, which are color variants — call get_component with package '@wizeworks/silicaui'.\",\n      inputSchema: {\n        component: z\n          .string()\n          .optional()\n          .describe(\"A core @wizeworks/silicaui component name, e.g. 'button'. Omit to list every component's classes.\"),\n      },\n    },\n    async ({ component }) => {\n      if (!component) {\n        return { content: [{ type: \"text\", text: JSON.stringify(classesByComponent, null, 2) }] };\n      }\n      const key = toKebab(component);\n      const classes = classesByComponent[key];\n      if (!classes) {\n        return {\n          content: [\n            {\n              type: \"text\",\n              text: `No class data for \"${component}\". Known components: ${Object.keys(classesByComponent).join(\", \")}`,\n            },\n          ],\n          isError: true,\n        };\n      }\n      return { content: [{ type: \"text\", text: JSON.stringify({ component: key, classes }, null, 2) }] };\n    },\n  );\n\n  server.registerTool(\n    \"get_tokens\",\n    {\n      title: \"Get Silica UI design tokens\",\n      description:\n        \"Get the semantic color list and their light/dark OKLCH values, the typography token model, and the scalar theme tokens (radius/border/depth/noise/focus/disabled-opacity) with defaults, ranges, and what each one actually affects.\",\n      inputSchema: {},\n    },\n    async () => ({ content: [{ type: \"text\", text: JSON.stringify(tokens, null, 2) }] }),\n  );\n\n  server.registerTool(\n    \"list_blocks\",\n    {\n      title: \"List Silica UI composed blocks\",\n      description:\n        \"List composed page blocks from @wizeworks/silicaui-html (hero sections, FAQs, feature grids, …) without their full node tree. Optionally filter by category or tag.\",\n      inputSchema: {\n        category: z.string().optional(),\n        tag: z.string().optional(),\n      },\n    },\n    async ({ category, tag }) => {\n      const filtered = blocks.filter(\n        (b) => (!category || b.category === category) && (!tag || (b.tags ?? []).includes(tag)),\n      );\n      return { content: [{ type: \"text\", text: JSON.stringify(filtered.map(blockSummary), null, 2) }] };\n    },\n  );\n\n  server.registerTool(\n    \"get_block\",\n    {\n      title: \"Get a Silica UI block's full node tree\",\n      description:\n        \"Get one composed block's full definition, including its node tree — the real, validated structure to reuse or adapt, not a guess.\",\n      inputSchema: {\n        key: z.string().describe(\"The block's stable key, e.g. 'hero_split_cta'.\"),\n      },\n    },\n    async ({ key }) => {\n      const block = blocks.find((b) => b.key === key);\n      if (!block) {\n        return {\n          content: [\n            {\n              type: \"text\",\n              text: `No block \"${key}\". Known keys: ${blocks.map((b) => b.key).join(\", \")}`,\n            },\n          ],\n          isError: true,\n        };\n      }\n      return { content: [{ type: \"text\", text: JSON.stringify(block, null, 2) }] };\n    },\n  );\n\n  server.registerTool(\n    \"list_behaviors\",\n    {\n      title: \"List Silica UI behavior types\",\n      description:\n        \"List the closed set of interactive behaviors that @wizeworks/silicaui-behaviors hydrates from data-sui-* markers (the vanilla-JS runtime for non-React output). Each type is also the BehaviorType a @wizeworks/silicaui-html ComponentDef macro carries — cross-reference with get_component. Call this to see the current set rather than assuming a fixed list; it grows over time.\",\n      inputSchema: {},\n    },\n    async () => ({ content: [{ type: \"text\", text: JSON.stringify(behaviors, null, 2) }] }),\n  );\n\n  server.registerTool(\n    \"get_behavior\",\n    {\n      title: \"Get one Silica UI behavior's contract\",\n      description: \"Get the marker contract and semantics for one behavior type.\",\n      inputSchema: {\n        type: z.string().describe(\"Behavior type, e.g. 'disclosure'.\"),\n      },\n    },\n    async ({ type }) => {\n      const behavior = behaviors.find((b) => b.type === type);\n      if (!behavior) {\n        return {\n          content: [\n            {\n              type: \"text\",\n              text: `No behavior \"${type}\". Known types: ${behaviors.map((b) => b.type).join(\", \")}`,\n            },\n          ],\n          isError: true,\n        };\n      }\n      return { content: [{ type: \"text\", text: JSON.stringify(behavior, null, 2) }] };\n    },\n  );\n\n  server.registerTool(\n    \"list_email_nodes\",\n    {\n      title: \"List the email builder's node kinds\",\n      description:\n        \"List every node kind an email document can contain (@wizeworks/silicaui-builder/email) with its nesting rules — what each kind may HOLD and which kinds may hold IT — plus the insertable palette presets. This schema is CLOSED and enforced: `EmailEditor.insert` returns undefined for an illegal kind or nesting, silently, so check here rather than assuming a site/HTML structure carries over. Email nodes carry typed fields, not classes, and literal hex colors, not tokens. Call get_email_node for one kind's real fields.\",\n      inputSchema: {},\n    },\n    async () => ({\n      content: [\n        {\n          type: \"text\",\n          text: JSON.stringify(\n            {\n              entrypoint: email.entrypoint,\n              reactEntrypoint: email.reactEntrypoint,\n              note: email.note,\n              bindingNote: email.bindingNote,\n              kinds: email.kinds.map(({ kind, typeName, isContent, container, holds, allowedParents, binding }) => ({\n                kind,\n                typeName,\n                isContent,\n                container,\n                holds,\n                allowedParents,\n                bindableFields: binding ? Object.keys(binding.fields) : [],\n                defaultBindTarget: binding?.default ?? null,\n              })),\n              palette: email.palette,\n              // The envelope, in full: it's small, and a caller that has the\n              // kinds but not `EmailDocument` still can't produce a document.\n              documentTypes: email.documentTypes,\n            },\n            null,\n            2,\n          ),\n        },\n      ],\n    }),\n  );\n\n  server.registerTool(\n    \"get_email_node\",\n    {\n      title: \"Get an email node kind's real fields\",\n      description:\n        \"Get one email node kind's full definition: every typed field with its TypeScript type, whether it's optional, and its source doc comment; the fields shared by every node (id/ord/data/locked); its nesting rules; and its data-binding contract — which `attr` a `value` bind may target and which one a bind with no `attr` fills. Use this instead of guessing field names: an unknown field is dropped by the engine and an unknown bind target is inert, neither with an error.\",\n      inputSchema: {\n        kind: z.string().describe(\"Node kind, e.g. 'link', 'image', 'section'. See list_email_nodes.\"),\n      },\n    },\n    async ({ kind }) => {\n      const node = email.kinds.find((k) => k.kind === kind.toLowerCase());\n      if (!node) {\n        return {\n          content: [\n            {\n              type: \"text\",\n              text: `No email node kind \"${kind}\". Known kinds: ${email.kinds.map((k) => k.kind).join(\", \")}`,\n            },\n          ],\n          isError: true,\n        };\n      }\n      return {\n        content: [\n          {\n            type: \"text\",\n            text: JSON.stringify(\n              {\n                ...node,\n                sharedFields: email.sharedFields,\n                bindingNote: email.bindingNote,\n                palette: email.palette.filter((p) => p.kind === node.kind),\n              },\n              null,\n              2,\n            ),\n          },\n        ],\n      };\n    },\n  );\n\n  server.registerTool(\n    \"get_node_schema\",\n    {\n      title: \"Get the Silica UI node-tree schema (path 3)\",\n      description:\n        \"Get the DOCUMENT schema for @wizeworks/silicaui-html — the shape of the tree itself, as opposed to what you put in it. Covers the four node kinds and their fields, the typed system-metadata band every node carries (data / slot / behavior / part / locked / instanceOf), the DATA-BINDING vocabulary with every field, the resolution contract a host implements, and the raw-element/attribute allowlist `toHtml` enforces. Call this before authoring or generating a node tree: the failures here are SILENT — an unlisted tag is downgraded to <div>, an unlisted attribute is dropped, an invented binding field is not persisted — so none of it can be inferred from output that looks like it worked. Not needed for path 1 (CSS classes on your own HTML) or path 2 (React).\",\n      inputSchema: {\n        section: z\n          .enum([\"all\", \"nodes\", \"bindings\", \"resolution\", \"elements\"])\n          .optional()\n          .describe(\n            \"Narrow the answer: 'nodes' (kinds + the shared metadata band), 'bindings' (the data vocabulary), 'resolution' (the host hooks and their honesty contract), 'elements' (the tag/attribute floor). Omit for everything.\",\n          ),\n      },\n    },\n    async ({ section }) => {\n      const head = {\n        entrypoint: schema.entrypoint,\n        behaviorRuntime: schema.behaviorRuntime,\n        sourceFile: schema.sourceFile,\n        note: schema.note,\n      };\n      const sections: Record<string, unknown> = {\n        nodes: { child: schema.child, nodeBase: schema.nodeBase, kinds: schema.kinds },\n        bindings: { bindingNote: schema.bindingNote, dataBindings: schema.dataBindings },\n        resolution: schema.resolution,\n        elements: schema.elementFloor,\n      };\n      const body =\n        !section || section === \"all\"\n          ? { ...sections.nodes as object, ...sections.bindings as object, resolution: schema.resolution, elementFloor: schema.elementFloor }\n          : sections[section];\n      return { content: [{ type: \"text\", text: JSON.stringify({ ...head, ...(body as object) }, null, 2) }] };\n    },\n  );\n\n  server.registerTool(\n    \"search_docs\",\n    {\n      title: \"Search Silica UI catalog data\",\n      description:\n        \"Full-text search across everything this server knows: component names/descriptions, block names/descriptions, behavior descriptions, literal CSS class names, design tokens, and the email builder's node kinds + their fields. Use this when you don't know the exact name to look up.\",\n      inputSchema: {\n        query: z.string().describe(\"Search term, case-insensitive.\"),\n      },\n    },\n    async ({ query }) => {\n      const q = query.toLowerCase();\n      const matchedComponents = components\n        .filter((c) => c.name.toLowerCase().includes(q) || (c.description ?? \"\").toLowerCase().includes(q) || (c.label ?? \"\").toLowerCase().includes(q))\n        .map((c) => ({ kind: \"component\", name: c.name, package: c.package }));\n      const matchedBlocks = blocks\n        .filter((b) => b.name.toLowerCase().includes(q) || b.description.toLowerCase().includes(q))\n        .map((b) => ({ kind: \"block\", key: b.key, name: b.name }));\n      const matchedBehaviors = behaviors\n        .filter((b) => b.type.toLowerCase().includes(q) || b.description.toLowerCase().includes(q))\n        .map((b) => ({ kind: \"behavior\", type: b.type }));\n      const matchedClasses = Object.entries(classesByComponent).flatMap(([component, classes]) =>\n        classes\n          .filter((cls) => cls.toLowerCase().includes(q))\n          .map((cls) => ({ kind: \"class\" as const, component, class: cls })),\n      );\n      const matchedTokens = tokens.semanticColors\n        .filter((name) => name.toLowerCase().includes(q))\n        .map((name) => ({ kind: \"token\" as const, name }));\n      // The node-tree vocabulary. Without this, \"repeat\", \"limit\", \"srcset\" and\n      // \"conditional\" found nothing here and an agent concluded the concept did\n      // not exist — the exact failure a searchable catalog is meant to prevent.\n      const matchedBindings = schema.dataBindings\n        .filter(\n          (b) =>\n            b.kind.toLowerCase().includes(q) ||\n            b.doc.toLowerCase().includes(q) ||\n            b.fields.some((f) => f.name.toLowerCase().includes(q)),\n        )\n        .map((b) => ({ kind: \"data-binding\" as const, binding: b.kind, tool: \"get_node_schema\" }));\n      const matchedNodeKinds = schema.kinds\n        .filter((k) => k.kind.toLowerCase().includes(q) || k.typeName.toLowerCase().includes(q) || k.doc.toLowerCase().includes(q))\n        .map((k) => ({ kind: \"node-kind\" as const, node: k.kind, tool: \"get_node_schema\" }));\n      const matchedTags = schema.elementFloor.tags\n        .filter((t) => t.tag.toLowerCase() === q || t.attrs.some((a) => a.toLowerCase() === q))\n        .map((t) => ({ kind: \"element-tag\" as const, tag: t.tag, group: t.group, tool: \"get_node_schema\" }));\n      // Email node kinds match on their own name, their doc, or any field they\n      // declare — \"href\" should find the `link` group even though no component\n      // or class is called that.\n      const matchedEmail = email.kinds\n        .filter(\n          (k) =>\n            k.kind.includes(q) ||\n            k.typeName.toLowerCase().includes(q) ||\n            k.doc.toLowerCase().includes(q) ||\n            k.fields.some((f) => f.name.toLowerCase().includes(q)),\n        )\n        .map((k) => ({ kind: \"email-node\" as const, node: k.kind, typeName: k.typeName }));\n      const matchedEmailTypes = email.documentTypes\n        .filter(\n          (t) =>\n            t.typeName.toLowerCase().includes(q) ||\n            t.doc.toLowerCase().includes(q) ||\n            t.fields.some((f) => f.name.toLowerCase().includes(q)),\n        )\n        .map((t) => ({ kind: \"email-type\" as const, typeName: t.typeName }));\n      const results = [\n        ...matchedComponents,\n        ...matchedBlocks,\n        ...matchedBehaviors,\n        ...matchedClasses,\n        ...matchedTokens,\n        ...matchedBindings,\n        ...matchedNodeKinds,\n        ...matchedTags,\n        ...matchedEmail,\n        ...matchedEmailTypes,\n      ];\n      return { content: [{ type: \"text\", text: JSON.stringify(results, null, 2) }] };\n    },\n  );\n\n  return server;\n}\n\nexport async function main(): Promise<void> {\n  const server = createServer();\n  const transport = new StdioServerTransport();\n  await server.connect(transport);\n}\n"]}
+{"version":3,"sources":["../src/server.ts"],"names":[],"mappings":"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","file":"server.js","sourcesContent":["import { readFileSync } from \"node:fs\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { z } from \"zod\";\n\nconst here = path.dirname(fileURLToPath(import.meta.url));\nconst dataDir = path.join(here, \"data\");\n\nfunction loadJson<T>(name: string): T {\n  return JSON.parse(readFileSync(path.join(dataDir, `${name}.json`), \"utf8\")) as T;\n}\n\n/**\n * The version this catalog documents, read from our OWN package.json at\n * startup rather than baked into the generated catalog.\n *\n * Every package in the family is released in lockstep — they're all listed in\n * `fixed` in .changeset/config.json, so their versions are identical by\n * construction — which makes our own version the right answer for all of them.\n *\n * This used to be snapshotted into `packages.json` at catalog-generation time,\n * but `gen` isn't part of `build` or the release, so the number froze at\n * whichever version happened to be current the last time someone ran it by\n * hand, and the server reported 0.26.0 while npm served 0.29.0. Reading it at\n * runtime makes that drift structurally impossible instead of a step someone\n * has to remember.\n */\nfunction readOwnVersion(): string {\n  // `here` is dist/ in a build and src/ in dev; package.json sits one level up\n  // from both, and npm always includes it in the published tarball.\n  try {\n    const pkg = JSON.parse(\n      readFileSync(path.join(here, \"..\", \"package.json\"), \"utf8\"),\n    ) as { version?: unknown };\n    if (typeof pkg.version === \"string\" && pkg.version) return pkg.version;\n    console.error(\n      \"[silicaui-mcp] package.json has no usable `version`; reporting 'unknown'.\",\n    );\n  } catch (err) {\n    console.error(\n      `[silicaui-mcp] could not read own package.json (${(err as Error).message}); reporting 'unknown'.`,\n    );\n  }\n  return \"unknown\";\n}\n\nconst VERSION = readOwnVersion();\n\ninterface PackageMeta {\n  name: string;\n  purpose: string;\n  install: string | null;\n  private?: boolean;\n}\n\ninterface TokensData {\n  semanticColors: string[];\n  /** How an app registers extra color roles, and everything one reaches once declared. */\n  customColors: {\n    summary: string;\n    howToDeclare: string;\n    declareNote: string;\n    contentNote: string;\n    utilities: string[];\n    componentPatterns: string[];\n    componentPatternsNote: string;\n    builderNote: string;\n  };\n  light: Record<string, string>;\n  dark: Record<string, string>;\n  typography: { baseFontSize: string; fontFamilyTokens: string[]; note: string };\n}\n\ninterface PropMember {\n  name: string;\n  optional: boolean;\n  type: string;\n  doc: string;\n}\n\ninterface PropsInterface {\n  name: string;\n  extends?: string;\n  members: PropMember[];\n}\n\n/**\n * The routing preamble every connecting client receives from `initialize`,\n * before it calls a single tool.\n *\n * Silica ships one design system through three delivery paths, and the choice\n * between them is made BEFORE any tool call — by which point per-tool\n * descriptions are too late to help. Without this, an agent got ten tools in a\n * bag and inferred the architecture from their names; the standard failure was\n * reaching for `@wizeworks/silicaui-react` while emitting non-React output, or\n * shipping node-tree markup with no behavior runtime and wondering why nothing\n * opened.\n *\n * Deliberately names no counts and no version — those drift. Package names are\n * asserted against the real catalog by verify.mjs.\n */\nconst INSTRUCTIONS = `Silica UI is ONE design system delivered through THREE paths. Decide which path matches the code you are writing BEFORE writing any markup — the paths share a class vocabulary but are not interchangeable, and mixing them is the most common way an integration breaks.\n\n1. CSS — \\`@wizeworks/silicaui\\`\n   A Tailwind v4 plugin. You write plain HTML and put Silica's classes on it: \\`<button class=\"btn btn-primary\">\\`. No JavaScript ships, so nothing is interactive — a dialog styled this way will not open. Use it for static markup, server-rendered templates (Rails, Django, PHP, Go, …), email, or any framework at all. It is the floor the other two paths stand on.\n   → get_component(name, package \"@wizeworks/silicaui\") for a family's root class, its parts, and its color variants; list_classes for the literal names.\n\n2. React — \\`@wizeworks/silicaui-react\\`\n   Typed React components over those same classes, with Base UI supplying real behavior and accessibility: \\`<Button color=\"primary\" size=\"lg\">\\`. Use it whenever the output is React or Next.js.\n   → get_component(name, package \"@wizeworks/silicaui-react\") for real props (extracted from the TypeScript source) and a working usage example.\n\n3. HTML / node-tree — \\`@wizeworks/silicaui-html\\` + \\`@wizeworks/silicaui-behaviors\\`\n   A framework-neutral node-tree schema that projects to HTML — for generated or user-authored documents: site builders, CMS output, static export. Component macros expand to element subtrees carrying \\`data-sui-*\\` markers, which the zero-dependency \\`@wizeworks/silicaui-behaviors\\` runtime hydrates at load. That runtime is what makes path 3 interactive; without it you have path 1.\n   → get_node_schema FIRST for the tree's own shape: the node kinds, the data-binding vocabulary (how a node draws live content, repeats over a collection, or hides itself), the resolution contract, and the tag/attribute allowlist \\`toHtml\\` enforces. Then get_component(name, package \"@wizeworks/silicaui-html\") for the macro; list_blocks / get_block for composed sections; list_behaviors for the marker contract.\n   Path 3 fails SILENTLY where the others fail loudly — an unlisted tag becomes a <div>, an unlisted attribute is dropped, an invented binding field is not persisted, and the output still looks plausible. Look it up.\n\nRules that hold on every path:\n- Never invent a class, prop, or block key. Everything this server returns is extracted from Silica's source at release time — look it up rather than guessing, including when you are fairly confident.\n- Colors are semantic tokens (get_tokens), never hex — but the eight built-in roles are a DEFAULT, not a closed set. Silica's core promise is that N named colors cascade through everything: an app registers extra roles (get_tokens → customColors for the two-line syntax) and each works everywhere a built-in does, so \\`btn-brand\\` is exactly as real as \\`btn-primary\\`. Read a component's \\`colorPattern\\` (get_component) and substitute the registered name — most are \\`<root>-<color>\\`, but chat, pin-input and toast are not. A REGISTERED color is the one name you may use that this catalog does not list literally; an unregistered one is still an invention, and renders unstyled.\n- Do not re-skin a component with inline styles or arbitrary hex — it defeats theming and light/dark.\n- The same name can exist on more than one path with a different shape. get_component with no \\`package\\` returns every path's answer at once; pass \\`package\\` to narrow.\n- Don't know the name? search_docs first. Unsure what to install? list_packages.\n\nAuthoring an EMAIL through \\`@wizeworks/silicaui-builder/email\\`? That is a separate surface, not a fourth path: a CLOSED document schema of typed nodes that projects to table-based inline-styled HTML. Its kinds, fields, and nesting rules are enforced — an invented kind or an illegal nesting is dropped silently, with no error to read — so call list_email_nodes / get_email_node rather than reasoning from the paths above. Classes and components do not apply there; colors are literal hex.\n\nSigns you are on the wrong path: importing @wizeworks/silicaui-react into output that is not React; hand-writing \\`data-sui-*\\` markers (they come from macro expansion, never from you); shipping path-3 markup without loading @wizeworks/silicaui-behaviors; expecting path 1 alone to open a dialog.`;\n\ninterface ComponentData {\n  name: string;\n  package: string;\n  category: string;\n  sourceFile: string;\n  /** silicaui-react entries: extracted from source via TS AST. silicaui-html\n   *  macros carry no static description (never hand-authored — see label/icon\n   *  instead) and omit these two fields. */\n  description?: string;\n  props?: PropsInterface[];\n  usageExample?: string | null;\n  /** silicaui-html macros only: palette label/icon, whether it's a container,\n   *  and the BehaviorType(s) its expansion carries (found by actually calling\n   *  expand(), not guessed — see get_behavior for the marker contract). */\n  label?: string;\n  icon?: string;\n  container?: boolean;\n  behaviors?: string[];\n  /** silicaui (CSS) entries only: the family's root class (null when it has\n   *  none — see familyPrefix/rootNote), every literal class it generates, its\n   *  color variants, and any compound selector that reveals required structure. */\n  root?: string | null;\n  familyPrefix?: string;\n  rootNote?: string;\n  classes?: string[];\n  colorVariants?: string[];\n  /** Selector template for the color axis, e.g. `btn-<color>` — substitute any registered color. */\n  colorPattern?: string;\n  colorNote?: string;\n  compoundSelectors?: string[];\n}\n\ninterface BlockSlot {\n  name: string;\n  [key: string]: unknown;\n}\n\ninterface BlockData {\n  key: string;\n  name: string;\n  category: string;\n  version: string;\n  description: string;\n  tags?: string[];\n  colors: string[];\n  behaviors: string[];\n  emailEligible: boolean;\n  slots: BlockSlot[];\n  root: unknown;\n  preview?: unknown;\n}\n\ninterface BehaviorData {\n  type: string;\n  description: string;\n}\n\ninterface EmailFieldData {\n  name: string;\n  optional: boolean;\n  type: string;\n  doc: string;\n}\n\ninterface EmailKindData {\n  kind: string;\n  typeName: string;\n  doc: string;\n  isContent: boolean;\n  container: boolean;\n  holds: string[];\n  allowedParents: string[];\n  fields: EmailFieldData[];\n  binding: { default?: string; fields: Record<string, string> } | null;\n  sourceFile: string;\n}\n\ninterface EmailData {\n  entrypoint: string;\n  reactEntrypoint: string;\n  note: string;\n  sharedFields: EmailFieldData[];\n  bindingNote: string;\n  /** The envelope around the node tree — EmailDocument/EmailProject/\n   *  EmailColorDefaults and friends. A kind list alone can't answer \"what do I\n   *  wrap this in\". */\n  documentTypes: Array<{ typeName: string; doc: string; fields: EmailFieldData[] }>;\n  kinds: EmailKindData[];\n  palette: Array<{ key: string; label: string; hint: string; icon: string; kind: string }>;\n}\n\ninterface FieldData {\n  name: string;\n  optional: boolean;\n  type: string;\n  doc: string;\n}\n\n/** Path 3's DOCUMENT schema — the node tree itself, as opposed to what you put\n *  in it. Generated from silicaui-html's own source; see gen-catalog's\n *  schema.json section for why each part is extracted rather than described. */\ninterface SchemaData {\n  entrypoint: string;\n  behaviorRuntime: string;\n  sourceFile: string;\n  note: string;\n  child: string;\n  nodeBase: FieldData[];\n  kinds: Array<{ kind: string; typeName: string; doc: string; sharedFields: boolean; fields: FieldData[] }>;\n  bindingNote: string;\n  dataBindings: Array<{ kind: string; doc: string; fields: Array<{ name: string; optional: boolean; type: string }> }>;\n  resolution: {\n    note: string;\n    honesty: string;\n    host: FieldData[];\n    resolved: FieldData[];\n    scope: FieldData[];\n    options: FieldData[];\n    diagnostic: FieldData[];\n  };\n  elementFloor: {\n    note: string;\n    globalAttrs: string[];\n    tags: Array<{ tag: string; group: string; void: boolean; attrs: string[] }>;\n  };\n}\n\nconst packages = loadJson<PackageMeta[]>(\"packages\");\nconst tokens = loadJson<TokensData>(\"tokens\");\nconst classesByComponent = loadJson<Record<string, string[]>>(\"classes\");\nconst blocks = loadJson<BlockData[]>(\"blocks\");\nconst behaviors = loadJson<BehaviorData[]>(\"behaviors\");\nconst components = loadJson<ComponentData[]>(\"components\");\nconst email = loadJson<EmailData>(\"email\");\nconst schema = loadJson<SchemaData>(\"schema\");\n\n/** CSS → React → HTML: the order the instructions introduce the paths in, so a\n *  multi-path get_component answer reads the same way every time. Packages not\n *  listed (the wrappers) sort last via indexOf's -1... which sorts them FIRST,\n *  so map those to a large index instead. */\nconst PATH_ORDER_LIST = [\n  \"@wizeworks/silicaui\",\n  \"@wizeworks/silicaui-react\",\n  \"@wizeworks/silicaui-html\",\n];\nconst PATH_ORDER = {\n  indexOf(pkg: string): number {\n    const i = PATH_ORDER_LIST.indexOf(pkg);\n    return i === -1 ? PATH_ORDER_LIST.length : i;\n  },\n};\n\nfunction toKebab(name: string): string {\n  return name\n    .replace(/([a-z0-9])([A-Z])/g, \"$1-$2\")\n    .toLowerCase();\n}\n\nfunction blockSummary(b: BlockData) {\n  const { root: _root, ...summary } = b;\n  return summary;\n}\n\nexport function createServer(): McpServer {\n  const server = new McpServer(\n    {\n      name: \"@wizeworks/silicaui-mcp\",\n      version: VERSION,\n    },\n    { instructions: INSTRUCTIONS },\n  );\n\n  server.registerTool(\n    \"list_packages\",\n    {\n      title: \"List Silica UI packages\",\n      description:\n        \"List every package in the Silica UI family (@wizeworks/silicaui, @wizeworks/silicaui-react, @wizeworks/silicaui-html, @wizeworks/silicaui-behaviors, and the wrapper packages), with purpose, install command, and version.\",\n      inputSchema: {},\n    },\n    async () => ({\n      content: [\n        {\n          type: \"text\",\n          // Version is stamped here, not stored in the catalog — see VERSION.\n          text: JSON.stringify(\n            packages.map((p) => ({ ...p, version: VERSION })),\n            null,\n            2,\n          ),\n        },\n      ],\n    }),\n  );\n\n  server.registerTool(\n    \"list_components\",\n    {\n      title: \"List Silica UI components\",\n      description:\n        \"List component names, categories, and source packages — spans ALL THREE delivery paths: @wizeworks/silicaui (CSS class families for plain HTML), @wizeworks/silicaui-react (typed React components), and @wizeworks/silicaui-html (framework-neutral ComponentDef macros for generated/non-React output). The same component usually exists on more than one path with a completely different shape; get_component returns every path's answer unless you pass a package. Filter here with the package param (e.g. '@wizeworks/silicaui', '@wizeworks/silicaui-react', '@wizeworks/silicaui-html', '@wizeworks/silicaui-charts').\",\n      inputSchema: {\n        package: z.string().optional().describe(\"Filter to one package name, e.g. '@wizeworks/silicaui-react'.\"),\n      },\n    },\n    async ({ package: pkg }) => {\n      const filtered = pkg ? components.filter((c) => c.package === pkg) : components;\n      const summary = filtered.map(({ name, package: p, category, sourceFile }) => ({\n        name,\n        package: p,\n        category,\n        sourceFile,\n      }));\n      return { content: [{ type: \"text\", text: JSON.stringify(summary, null, 2) }] };\n    },\n  );\n\n  server.registerTool(\n    \"get_component\",\n    {\n      title: \"Get a Silica UI component's real shape\",\n      description:\n        \"Get a component's real definition on whichever delivery path you're building on — for @wizeworks/silicaui (CSS): the family's root class, every literal class it generates, its color variants, and any compound selector that reveals required markup structure; for @wizeworks/silicaui-react: props (name, type, optional, doc — extracted from its actual TypeScript source) plus a real, working usage example; for @wizeworks/silicaui-html: its palette category/label/icon, whether it's a container, and the BehaviorType(s) it carries (cross-reference get_behavior for the marker contract). Use this instead of guessing class names, prop names, or shapes. Omit package to see every path's answer side by side; pass it to get just one.\",\n      inputSchema: {\n        name: z.string().describe(\"Component name, e.g. 'Button', 'DataTable', 'Dialog'.\"),\n        package: z.string().optional().describe(\"Disambiguate when the name exists in more than one package, e.g. '@wizeworks/silicaui-html'.\"),\n      },\n    },\n    async ({ name, package: pkg }) => {\n      let matches = components.filter((c) => c.name.toLowerCase() === name.toLowerCase());\n      if (pkg) matches = matches.filter((c) => c.package === pkg);\n      if (!matches.length) {\n        return {\n          content: [\n            {\n              type: \"text\",\n              text: `No component named \"${name}\"${pkg ? ` in ${pkg}` : \"\"}. Call list_components to see valid names.`,\n            },\n          ],\n          isError: true,\n        };\n      }\n      // A name on more than one path used to be an isError telling the caller\n      // to pick a package — which costs a round trip and, worse, asks for a\n      // choice the caller can't make yet: it doesn't know how the shapes\n      // differ, which is the very thing it's asking about. Returning all of\n      // them answers the question AND demonstrates the three paths at the one\n      // moment the distinction actually matters.\n      if (matches.length > 1) {\n        const ordered = [...matches].sort(\n          (a, b) => PATH_ORDER.indexOf(a.package) - PATH_ORDER.indexOf(b.package),\n        );\n        return {\n          content: [\n            {\n              type: \"text\",\n              text: JSON.stringify(\n                {\n                  name: ordered[0]?.name ?? name,\n                  note:\n                    `\"${name}\" exists on ${ordered.length} delivery paths, listed below with their real (different) shapes: ` +\n                    `${ordered.map((c) => c.package).join(\", \")}. Use the one matching the code you're writing — ` +\n                    `they are not interchangeable. Pass \\`package\\` to get just one.`,\n                  paths: ordered,\n                },\n                null,\n                2,\n              ),\n            },\n          ],\n        };\n      }\n      return { content: [{ type: \"text\", text: JSON.stringify(matches[0], null, 2) }] };\n    },\n  );\n\n  server.registerTool(\n    \"list_classes\",\n    {\n      title: \"List real Silica UI CSS class names\",\n      description:\n        \"List the exact, literal CSS class names Silica UI generates for a core component (e.g. 'button', 'card', 'badge') — or all components if none given. These are extracted directly from the class generators, so they are never hallucinated. Also covers 'color-utilities' (text-*/bg-*/border-* for every declared color). This returns a flat list; for the CSS path's STRUCTURE — which class is the root, which are its parts, which are color variants — call get_component with package '@wizeworks/silicaui'.\",\n      inputSchema: {\n        component: z\n          .string()\n          .optional()\n          .describe(\"A core @wizeworks/silicaui component name, e.g. 'button'. Omit to list every component's classes.\"),\n      },\n    },\n    async ({ component }) => {\n      if (!component) {\n        return { content: [{ type: \"text\", text: JSON.stringify(classesByComponent, null, 2) }] };\n      }\n      const key = toKebab(component);\n      const classes = classesByComponent[key];\n      if (!classes) {\n        return {\n          content: [\n            {\n              type: \"text\",\n              text: `No class data for \"${component}\". Known components: ${Object.keys(classesByComponent).join(\", \")}`,\n            },\n          ],\n          isError: true,\n        };\n      }\n      return { content: [{ type: \"text\", text: JSON.stringify({ component: key, classes }, null, 2) }] };\n    },\n  );\n\n  server.registerTool(\n    \"get_tokens\",\n    {\n      title: \"Get Silica UI design tokens\",\n      description:\n        \"Get the semantic color list and their light/dark OKLCH values, the typography token model, and the scalar theme tokens (radius/border/depth/noise/focus/disabled-opacity) with defaults, ranges, and what each one actually affects. Also returns `customColors`: how to register extra color roles beyond the built-in eight, and the selector pattern for every component a registered color reaches — call this before concluding a color like `brand` is unavailable.\",\n      inputSchema: {},\n    },\n    async () => ({ content: [{ type: \"text\", text: JSON.stringify(tokens, null, 2) }] }),\n  );\n\n  server.registerTool(\n    \"list_blocks\",\n    {\n      title: \"List Silica UI composed blocks\",\n      description:\n        \"List composed page blocks from @wizeworks/silicaui-html (hero sections, FAQs, feature grids, …) without their full node tree. Optionally filter by category or tag.\",\n      inputSchema: {\n        category: z.string().optional(),\n        tag: z.string().optional(),\n      },\n    },\n    async ({ category, tag }) => {\n      const filtered = blocks.filter(\n        (b) => (!category || b.category === category) && (!tag || (b.tags ?? []).includes(tag)),\n      );\n      return { content: [{ type: \"text\", text: JSON.stringify(filtered.map(blockSummary), null, 2) }] };\n    },\n  );\n\n  server.registerTool(\n    \"get_block\",\n    {\n      title: \"Get a Silica UI block's full node tree\",\n      description:\n        \"Get one composed block's full definition, including its node tree — the real, validated structure to reuse or adapt, not a guess.\",\n      inputSchema: {\n        key: z.string().describe(\"The block's stable key, e.g. 'hero_split_cta'.\"),\n      },\n    },\n    async ({ key }) => {\n      const block = blocks.find((b) => b.key === key);\n      if (!block) {\n        return {\n          content: [\n            {\n              type: \"text\",\n              text: `No block \"${key}\". Known keys: ${blocks.map((b) => b.key).join(\", \")}`,\n            },\n          ],\n          isError: true,\n        };\n      }\n      return { content: [{ type: \"text\", text: JSON.stringify(block, null, 2) }] };\n    },\n  );\n\n  server.registerTool(\n    \"list_behaviors\",\n    {\n      title: \"List Silica UI behavior types\",\n      description:\n        \"List the closed set of interactive behaviors that @wizeworks/silicaui-behaviors hydrates from data-sui-* markers (the vanilla-JS runtime for non-React output). Each type is also the BehaviorType a @wizeworks/silicaui-html ComponentDef macro carries — cross-reference with get_component. Call this to see the current set rather than assuming a fixed list; it grows over time.\",\n      inputSchema: {},\n    },\n    async () => ({ content: [{ type: \"text\", text: JSON.stringify(behaviors, null, 2) }] }),\n  );\n\n  server.registerTool(\n    \"get_behavior\",\n    {\n      title: \"Get one Silica UI behavior's contract\",\n      description: \"Get the marker contract and semantics for one behavior type.\",\n      inputSchema: {\n        type: z.string().describe(\"Behavior type, e.g. 'disclosure'.\"),\n      },\n    },\n    async ({ type }) => {\n      const behavior = behaviors.find((b) => b.type === type);\n      if (!behavior) {\n        return {\n          content: [\n            {\n              type: \"text\",\n              text: `No behavior \"${type}\". Known types: ${behaviors.map((b) => b.type).join(\", \")}`,\n            },\n          ],\n          isError: true,\n        };\n      }\n      return { content: [{ type: \"text\", text: JSON.stringify(behavior, null, 2) }] };\n    },\n  );\n\n  server.registerTool(\n    \"list_email_nodes\",\n    {\n      title: \"List the email builder's node kinds\",\n      description:\n        \"List every node kind an email document can contain (@wizeworks/silicaui-builder/email) with its nesting rules — what each kind may HOLD and which kinds may hold IT — plus the insertable palette presets. This schema is CLOSED and enforced: `EmailEditor.insert` returns undefined for an illegal kind or nesting, silently, so check here rather than assuming a site/HTML structure carries over. Email nodes carry typed fields, not classes, and literal hex colors, not tokens. Call get_email_node for one kind's real fields.\",\n      inputSchema: {},\n    },\n    async () => ({\n      content: [\n        {\n          type: \"text\",\n          text: JSON.stringify(\n            {\n              entrypoint: email.entrypoint,\n              reactEntrypoint: email.reactEntrypoint,\n              note: email.note,\n              bindingNote: email.bindingNote,\n              kinds: email.kinds.map(({ kind, typeName, isContent, container, holds, allowedParents, binding }) => ({\n                kind,\n                typeName,\n                isContent,\n                container,\n                holds,\n                allowedParents,\n                bindableFields: binding ? Object.keys(binding.fields) : [],\n                defaultBindTarget: binding?.default ?? null,\n              })),\n              palette: email.palette,\n              // The envelope, in full: it's small, and a caller that has the\n              // kinds but not `EmailDocument` still can't produce a document.\n              documentTypes: email.documentTypes,\n            },\n            null,\n            2,\n          ),\n        },\n      ],\n    }),\n  );\n\n  server.registerTool(\n    \"get_email_node\",\n    {\n      title: \"Get an email node kind's real fields\",\n      description:\n        \"Get one email node kind's full definition: every typed field with its TypeScript type, whether it's optional, and its source doc comment; the fields shared by every node (id/ord/data/locked); its nesting rules; and its data-binding contract — which `attr` a `value` bind may target and which one a bind with no `attr` fills. Use this instead of guessing field names: an unknown field is dropped by the engine and an unknown bind target is inert, neither with an error.\",\n      inputSchema: {\n        kind: z.string().describe(\"Node kind, e.g. 'link', 'image', 'section'. See list_email_nodes.\"),\n      },\n    },\n    async ({ kind }) => {\n      const node = email.kinds.find((k) => k.kind === kind.toLowerCase());\n      if (!node) {\n        return {\n          content: [\n            {\n              type: \"text\",\n              text: `No email node kind \"${kind}\". Known kinds: ${email.kinds.map((k) => k.kind).join(\", \")}`,\n            },\n          ],\n          isError: true,\n        };\n      }\n      return {\n        content: [\n          {\n            type: \"text\",\n            text: JSON.stringify(\n              {\n                ...node,\n                sharedFields: email.sharedFields,\n                bindingNote: email.bindingNote,\n                palette: email.palette.filter((p) => p.kind === node.kind),\n              },\n              null,\n              2,\n            ),\n          },\n        ],\n      };\n    },\n  );\n\n  server.registerTool(\n    \"get_node_schema\",\n    {\n      title: \"Get the Silica UI node-tree schema (path 3)\",\n      description:\n        \"Get the DOCUMENT schema for @wizeworks/silicaui-html — the shape of the tree itself, as opposed to what you put in it. Covers the four node kinds and their fields, the typed system-metadata band every node carries (data / slot / behavior / part / locked / instanceOf), the DATA-BINDING vocabulary with every field, the resolution contract a host implements, and the raw-element/attribute allowlist `toHtml` enforces. Call this before authoring or generating a node tree: the failures here are SILENT — an unlisted tag is downgraded to <div>, an unlisted attribute is dropped, an invented binding field is not persisted — so none of it can be inferred from output that looks like it worked. Not needed for path 1 (CSS classes on your own HTML) or path 2 (React).\",\n      inputSchema: {\n        section: z\n          .enum([\"all\", \"nodes\", \"bindings\", \"resolution\", \"elements\"])\n          .optional()\n          .describe(\n            \"Narrow the answer: 'nodes' (kinds + the shared metadata band), 'bindings' (the data vocabulary), 'resolution' (the host hooks and their honesty contract), 'elements' (the tag/attribute floor). Omit for everything.\",\n          ),\n      },\n    },\n    async ({ section }) => {\n      const head = {\n        entrypoint: schema.entrypoint,\n        behaviorRuntime: schema.behaviorRuntime,\n        sourceFile: schema.sourceFile,\n        note: schema.note,\n      };\n      const sections: Record<string, unknown> = {\n        nodes: { child: schema.child, nodeBase: schema.nodeBase, kinds: schema.kinds },\n        bindings: { bindingNote: schema.bindingNote, dataBindings: schema.dataBindings },\n        resolution: schema.resolution,\n        elements: schema.elementFloor,\n      };\n      const body =\n        !section || section === \"all\"\n          ? { ...sections.nodes as object, ...sections.bindings as object, resolution: schema.resolution, elementFloor: schema.elementFloor }\n          : sections[section];\n      return { content: [{ type: \"text\", text: JSON.stringify({ ...head, ...(body as object) }, null, 2) }] };\n    },\n  );\n\n  server.registerTool(\n    \"search_docs\",\n    {\n      title: \"Search Silica UI catalog data\",\n      description:\n        \"Full-text search across everything this server knows: component names/descriptions, block names/descriptions, behavior descriptions, literal CSS class names, design tokens, and the email builder's node kinds + their fields. Use this when you don't know the exact name to look up.\",\n      inputSchema: {\n        query: z.string().describe(\"Search term, case-insensitive.\"),\n      },\n    },\n    async ({ query }) => {\n      const q = query.toLowerCase();\n      const matchedComponents = components\n        .filter((c) => c.name.toLowerCase().includes(q) || (c.description ?? \"\").toLowerCase().includes(q) || (c.label ?? \"\").toLowerCase().includes(q))\n        .map((c) => ({ kind: \"component\", name: c.name, package: c.package }));\n      const matchedBlocks = blocks\n        .filter((b) => b.name.toLowerCase().includes(q) || b.description.toLowerCase().includes(q))\n        .map((b) => ({ kind: \"block\", key: b.key, name: b.name }));\n      const matchedBehaviors = behaviors\n        .filter((b) => b.type.toLowerCase().includes(q) || b.description.toLowerCase().includes(q))\n        .map((b) => ({ kind: \"behavior\", type: b.type }));\n      const matchedClasses = Object.entries(classesByComponent).flatMap(([component, classes]) =>\n        classes\n          .filter((cls) => cls.toLowerCase().includes(q))\n          .map((cls) => ({ kind: \"class\" as const, component, class: cls })),\n      );\n      const matchedTokens = tokens.semanticColors\n        .filter((name) => name.toLowerCase().includes(q))\n        .map((name) => ({ kind: \"token\" as const, name }));\n      // Custom colors are a CONCEPT, not a literal name, so nothing above could\n      // ever match them: \"brand\", \"custom color\", \"register\" and \"@plugin\" all\n      // returned empty and an agent reasonably concluded the 8 semantic roles\n      // were the whole set — then refused to write `badge-brand`. Same failure\n      // mode the data-binding entry below was added for.\n      const COLOR_CONCEPT = [\n        \"custom color\",\n        \"custom colors\",\n        \"color role\",\n        \"n-color\",\n        \"brand\",\n        \"register\",\n        \"registered\",\n        \"declare\",\n        \"@plugin\",\n        \"plugin\",\n        \"@theme\",\n        \"palette\",\n        \"extra color\",\n        \"new color\",\n      ];\n      const matchedColorConcept = COLOR_CONCEPT.some((k) => k.includes(q) || q.includes(k))\n        ? [\n            {\n              kind: \"concept\" as const,\n              name: \"custom colors (N-color)\",\n              summary: tokens.customColors.summary,\n              tool: \"get_tokens\",\n              field: \"customColors\",\n            },\n          ]\n        : [];\n      // The node-tree vocabulary. Without this, \"repeat\", \"limit\", \"srcset\" and\n      // \"conditional\" found nothing here and an agent concluded the concept did\n      // not exist — the exact failure a searchable catalog is meant to prevent.\n      const matchedBindings = schema.dataBindings\n        .filter(\n          (b) =>\n            b.kind.toLowerCase().includes(q) ||\n            b.doc.toLowerCase().includes(q) ||\n            b.fields.some((f) => f.name.toLowerCase().includes(q)),\n        )\n        .map((b) => ({ kind: \"data-binding\" as const, binding: b.kind, tool: \"get_node_schema\" }));\n      const matchedNodeKinds = schema.kinds\n        .filter((k) => k.kind.toLowerCase().includes(q) || k.typeName.toLowerCase().includes(q) || k.doc.toLowerCase().includes(q))\n        .map((k) => ({ kind: \"node-kind\" as const, node: k.kind, tool: \"get_node_schema\" }));\n      const matchedTags = schema.elementFloor.tags\n        .filter((t) => t.tag.toLowerCase() === q || t.attrs.some((a) => a.toLowerCase() === q))\n        .map((t) => ({ kind: \"element-tag\" as const, tag: t.tag, group: t.group, tool: \"get_node_schema\" }));\n      // Email node kinds match on their own name, their doc, or any field they\n      // declare — \"href\" should find the `link` group even though no component\n      // or class is called that.\n      const matchedEmail = email.kinds\n        .filter(\n          (k) =>\n            k.kind.includes(q) ||\n            k.typeName.toLowerCase().includes(q) ||\n            k.doc.toLowerCase().includes(q) ||\n            k.fields.some((f) => f.name.toLowerCase().includes(q)),\n        )\n        .map((k) => ({ kind: \"email-node\" as const, node: k.kind, typeName: k.typeName }));\n      const matchedEmailTypes = email.documentTypes\n        .filter(\n          (t) =>\n            t.typeName.toLowerCase().includes(q) ||\n            t.doc.toLowerCase().includes(q) ||\n            t.fields.some((f) => f.name.toLowerCase().includes(q)),\n        )\n        .map((t) => ({ kind: \"email-type\" as const, typeName: t.typeName }));\n      const results = [\n        ...matchedComponents,\n        ...matchedBlocks,\n        ...matchedBehaviors,\n        ...matchedClasses,\n        ...matchedTokens,\n        ...matchedColorConcept,\n        ...matchedBindings,\n        ...matchedNodeKinds,\n        ...matchedTags,\n        ...matchedEmail,\n        ...matchedEmailTypes,\n      ];\n      return { content: [{ type: \"text\", text: JSON.stringify(results, null, 2) }] };\n    },\n  );\n\n  return server;\n}\n\nexport async function main(): Promise<void> {\n  const server = createServer();\n  const transport = new StdioServerTransport();\n  await server.connect(transport);\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wizeworks/silicaui-mcp",
-  "version": "0.41.0",
+  "version": "0.43.0",
   "description": "A local MCP server that lets AI coding assistants query the Silica UI design system — real class names, component props, blocks, and behaviors — instead of guessing.",
   "type": "module",
   "license": "MIT",