specs/<component>/ containing a closed token contract, required ARIA attributes, and interaction state definitions. Components earn an AI-Ready status only after all five spec gates pass — until then they carry Draft status and should be treated as unverified.
Component Status
AI-Ready vs Draft
AI-Ready means all five spec gates pass:aria_correct— required ARIA attributes are documented and implemented correctlystructure_correct— semantic HTML structure matches the specstates_complete— every interaction state is defined with tokenstokens_valid— every token reference resolves through the 3-tier cascade without a gapno_invented_styles— no hardcoded hex values or out-of-contract color bindings
Installation
Install the package and import components directly from@clementine-ds/ui:
ClementineDSProvider to apply the Clementine theme:
Components
Button
Primary action trigger. AI-Ready with 4 variants, 3 sizes, and 15 component tokens.
Badge
Inline status and risk level labels with 8 intent variants including 4 risk tiers.
TextInput
Single-line text entry backed by Mantine TextInput with Clementine token bindings.
Textarea
Multi-line text entry for longer free-form content.
Select
Accessible dropdown selection for choosing one option from a list.
Checkbox
Binary toggle for boolean choices in forms and settings.
Radio
Single selection from a mutually exclusive group of options.
Switch
On/off toggle for immediately applied settings. Prefer over Checkbox for live changes.
Tabs
Tabbed content navigation for switching between related views or sections.
Modal
Overlay dialog for confirmations, forms, and focused sub-tasks.