Capabilities

1{
2  "schemaVersion": "component-capabilities/1",
3  "component": {
4    "name": "button",
5    "revision": "shadcn-default-ac60ef5"
6  },
7  "contract": {
8    "name": "button",
9    "version": "button/v1"
10  },
11  "axes": [
12    {
13      "name": "variant",
14      "values": ["default", "destructive", "outline", "secondary", "ghost", "link"],
15      "default": "default",
16      "description": "Visual emphasis encoded by the component variant prop."
17    },
18    {
19      "name": "size",
20      "values": ["default", "sm", "lg", "icon"],
21      "default": "default",
22      "description": "Control dimensions encoded by the component size prop."
23    }
24  ],
25  "slots": [
26    { "name": "label", "kind": "text", "description": "Visible accessible button or link text." },
27    { "name": "icon", "kind": "icon", "description": "Optional source-backed or approved icon content." },
28    { "name": "accessibleName", "kind": "text", "description": "Accessible name required when visible text is absent." },
29    { "name": "href", "kind": "url", "description": "Preserved destination for the as-link composition." }
30  ],
31  "states": ["rest", "hover", "focus-visible", "disabled"],
32  "defaultComposition": "text",
33  "compositions": [
34    { "name": "text", "requiredSlots": ["label"], "description": "Text-only native button." },
35    { "name": "leading-icon", "requiredSlots": ["label", "icon"], "description": "Icon before visible text." },
36    { "name": "trailing-icon", "requiredSlots": ["label", "icon"], "description": "Icon after visible text." },
37    { "name": "icon-only", "requiredSlots": ["icon", "accessibleName"], "description": "Square icon button with a non-visible accessible name." },
38    { "name": "as-link", "requiredSlots": ["label", "href"], "description": "Native anchor rendered with button variants through Radix Slot." }
39  ],
40  "unsupportedCompositions": [
41    { "name": "loading-spinner", "reason": "Requires a separately approved spinner component and loading-state contract." },
42    { "name": "button-group", "reason": "Requires a separately approved group component and group semantics." },
43    { "name": "client-managed-toggle", "reason": "This revision is approved only as a statically rendered native control without hydrated state." }
44  ],
45  "constraints": [
46    {
47      "id": "icon-only-accessible-name",
48      "description": "An icon-only button must retain an evidence-backed accessible name.",
49      "appliesTo": ["composition:icon-only"],
50      "requires": ["slot:accessibleName"]
51    },
52    {
53      "id": "native-link-semantics",
54      "description": "A button-styled link must preserve its source href and native anchor semantics.",
55      "appliesTo": ["composition:as-link"],
56      "requires": ["slot:href", "slot:label"]
57    }
58  ],
59  "evidenceRefs": ["contract.md"]
60}