@lostgradient/cinder 0.1.0

package/components.json

@@ -0,0 +1,3417 @@
+{
+  "$schema": "./src/schemas/manifest.schema.json",
+  "manifestVersion": 1,
+  "package": {
+    "name": "@lostgradient/cinder",
+    "version": "0.1.0",
+    "framework": "svelte",
+    "frameworkVersionRange": ">=5.55.0 <6",
+    "classPrefix": "cinder-",
+    "cssVarPrefix": "--cinder-",
+    "tokenNamespaces": ["color", "space", "radius", "ring", "type", "motion", "shadow"],
+    "stylesEntry": "@lostgradient/cinder/styles",
+    "schemaDialect": "https://json-schema.org/draft/2020-12/schema"
+  },
+  "categories": {
+    "action": {
+      "label": "Actions",
+      "description": "Controls that trigger operations, submit data, or navigate."
+    },
+    "overlay": {
+      "label": "Overlays",
+      "description": "Floating surfaces that layer above page content and require user dismissal."
+    },
+    "form": {
+      "label": "Forms",
+      "description": "Input controls and layout primitives for collecting structured user data."
+    },
+    "feedback": {
+      "label": "Feedback",
+      "description": "Non-interactive indicators that communicate status, progress, or results."
+    },
+    "navigation": {
+      "label": "Navigation",
+      "description": "Wayfinding controls that move users between views, sections, or steps."
+    },
+    "data-display": {
+      "label": "Data Display",
+      "description": "Read-only presentational components for structured data and content."
+    },
+    "layout": {
+      "label": "Layout",
+      "description": "Structural primitives that control spacing, containment, and composition."
+    },
+    "typography": {
+      "label": "Typography",
+      "description": "Text-rendering components that enforce hierarchy and typographic conventions."
+    },
+    "domain": {
+      "label": "Domain",
+      "description": "Application-specific components that encode product-level business concepts."
+    }
+  },
+  "statusLevels": {
+    "stable": "Public API under semver protection; breaking changes require a major version bump.",
+    "beta": "API is near-final but may have breaking changes in minor versions before promotion.",
+    "alpha": "Experimental; no stability guarantee and subject to removal or significant redesign.",
+    "domain-suite": "A cohesive set of domain-specific components shipped together as a named suite with its own versioning cadence."
+  },
+  "overlapFamilies": {
+    "overlay": ["modal", "drawer", "sheet", "popover", "alert-dialog"],
+    "notice": ["banner", "alert", "callout"],
+    "selection": ["toggle", "checkbox", "segmented-control"],
+    "hover": ["tooltip", "popover", "hover-card"],
+    "tabs": ["tabs", "segmented-control"]
+  },
+  "components": [
+    {
+      "name": "Accordion",
+      "id": "accordion",
+      "import": "@lostgradient/cinder/accordion",
+      "exportName": "Accordion",
+      "category": "data-display",
+      "status": "stable",
+      "purpose": "Composite root that coordinates a stack of collapsible accordion-item panels with single or multiple expansion.",
+      "tags": ["disclosure", "collapsible"],
+      "useWhen": [
+        "Progressively disclosing several sections of content that share a parent heading.",
+        "Letting the consumer expand one or multiple panels at once via the multiple prop."
+      ],
+      "avoidWhen": [
+        "Switching between mutually exclusive views of the same region — use tabs instead.",
+        "Hiding a single optional region — use a plain disclosure or details element."
+      ],
+      "related": ["accordion-item", "tabs", "tree"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/accordion/schema",
+        "variables": "@lostgradient/cinder/accordion/variables",
+        "examples": "@lostgradient/cinder/accordion/examples"
+      }
+    },
+    {
+      "name": "AccordionItem",
+      "id": "accordion-item",
+      "import": "@lostgradient/cinder/accordion-item",
+      "exportName": "AccordionItem",
+      "category": "data-display",
+      "status": "stable",
+      "purpose": "Collapsible panel within an accordion that toggles its content visibility under a heading button.",
+      "tags": ["disclosure", "collapsible"],
+      "useWhen": [
+        "Rendering one expandable section inside an accordion parent.",
+        "Disabling a single section while leaving siblings interactive via the disabled prop."
+      ],
+      "avoidWhen": [
+        "Standing alone outside an accordion — it requires the accordion context to function."
+      ],
+      "related": ["accordion"],
+      "hasConstraints": false,
+      "hasExamples": false,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/accordion-item/schema",
+        "variables": "@lostgradient/cinder/accordion-item/variables"
+      }
+    },
+    {
+      "name": "Alert",
+      "id": "alert",
+      "import": "@lostgradient/cinder/alert",
+      "exportName": "Alert",
+      "category": "feedback",
+      "status": "stable",
+      "purpose": "Inline status message with assertive role for surfacing time-sensitive feedback about a nearby action or region.",
+      "tags": ["feedback", "notice"],
+      "useWhen": [
+        "Surfacing the result of a just-completed action such as a save failure or success.",
+        "Calling out a transient condition the user must notice immediately within a specific region."
+      ],
+      "avoidWhen": [
+        "Communicating a page- or app-wide notice that persists across views — use a banner instead.",
+        "Providing supplemental commentary or guidance inline with content — use a callout instead."
+      ],
+      "related": ["banner", "callout", "toast-region"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/alert/schema",
+        "variables": "@lostgradient/cinder/alert/variables",
+        "examples": "@lostgradient/cinder/alert/examples"
+      }
+    },
+    {
+      "name": "AlertDialog",
+      "id": "alert-dialog",
+      "import": "@lostgradient/cinder/alert-dialog",
+      "exportName": "AlertDialog",
+      "category": "overlay",
+      "status": "stable",
+      "purpose": "Sticky alert dialog for urgent acknowledgement that cannot be dismissed by backdrop click or Escape.",
+      "tags": ["overlay", "dialog"],
+      "useWhen": [
+        "Requiring acknowledgement of a blocking warning before the user can continue.",
+        "Presenting a destructive or high-risk message that needs an explicit OK action."
+      ],
+      "avoidWhen": [
+        "Asking a reversible yes/no question — use confirm-dialog.",
+        "Collecting rich form input — compose modal instead."
+      ],
+      "related": ["modal", "confirm-dialog", "drawer"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/alert-dialog/schema",
+        "variables": "@lostgradient/cinder/alert-dialog/variables",
+        "examples": "@lostgradient/cinder/alert-dialog/examples"
+      }
+    },
+    {
+      "name": "AreaChart",
+      "id": "area-chart",
+      "import": "@lostgradient/cinder/area-chart",
+      "exportName": "AreaChart",
+      "category": "data-display",
+      "status": "stable",
+      "purpose": "Filled SVG area chart for showing magnitude and cumulative trends across an ordered x domain.",
+      "tags": ["chart", "area", "analytics"],
+      "useWhen": [
+        "Showing magnitude under a trend line.",
+        "Comparing cumulative or stacked contribution over an ordered domain."
+      ],
+      "avoidWhen": [
+        "Exact point comparison matters more than area magnitude — use line-chart instead.",
+        "Comparing discrete category totals — use bar-chart instead."
+      ],
+      "related": ["line-chart", "bar-chart", "table", "stat"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/area-chart/schema",
+        "variables": "@lostgradient/cinder/area-chart/variables",
+        "examples": "@lostgradient/cinder/area-chart/examples"
+      }
+    },
+    {
+      "name": "AspectRatio",
+      "id": "aspect-ratio",
+      "import": "@lostgradient/cinder/aspect-ratio",
+      "exportName": "AspectRatio",
+      "category": "layout",
+      "status": "stable",
+      "purpose": "Generic media box that enforces a fixed aspect ratio for arbitrary embedded content using the native CSS aspect-ratio property.",
+      "tags": ["layout", "media"],
+      "useWhen": [
+        "Reserving stable space for embedded media, previews, or art-directed content before it loads.",
+        "You need a generic ratio wrapper for iframe, video, canvas, or custom content rather than an image-specific primitive."
+      ],
+      "avoidWhen": [
+        "The child already owns its sizing contract and should determine its own height naturally.",
+        "Supporting legacy browsers that lack native aspect-ratio support."
+      ],
+      "related": ["image", "card"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/aspect-ratio/schema",
+        "variables": "@lostgradient/cinder/aspect-ratio/variables",
+        "examples": "@lostgradient/cinder/aspect-ratio/examples"
+      }
+    },
+    {
+      "name": "Autocomplete",
+      "id": "autocomplete",
+      "import": "@lostgradient/cinder/autocomplete",
+      "exportName": "Autocomplete",
+      "category": "form",
+      "status": "stable",
+      "purpose": "Free-form text input with asynchronous suggestion hints rendered in a listbox popover.",
+      "tags": ["form", "autocomplete"],
+      "useWhen": [
+        "Accepting arbitrary text while offering completions from a local or remote source.",
+        "Keeping the user's text as the committed value while suggestions remain optional hints."
+      ],
+      "avoidWhen": [
+        "Requiring the final value to come from a fixed option list — use combobox instead."
+      ],
+      "related": ["combobox", "search-field", "popover"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/autocomplete/schema",
+        "variables": "@lostgradient/cinder/autocomplete/variables",
+        "examples": "@lostgradient/cinder/autocomplete/examples"
+      }
+    },
+    {
+      "name": "Avatar",
+      "id": "avatar",
+      "import": "@lostgradient/cinder/avatar",
+      "exportName": "Avatar",
+      "category": "data-display",
+      "status": "stable",
+      "purpose": "Profile graphic that renders a user image with automatic initials fallback when the source is missing or fails to load.",
+      "tags": ["identity", "image"],
+      "useWhen": [
+        "Representing a person or account next to their name or activity.",
+        "Displaying initials when no avatar image is available."
+      ],
+      "avoidWhen": ["Showing a small status or count indicator — use badge or status-dot instead."],
+      "related": ["badge", "status-dot", "image"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/avatar/schema",
+        "variables": "@lostgradient/cinder/avatar/variables",
+        "examples": "@lostgradient/cinder/avatar/examples"
+      }
+    },
+    {
+      "name": "AvatarGroup",
+      "id": "avatar-group",
+      "import": "@lostgradient/cinder/avatar-group",
+      "exportName": "AvatarGroup",
+      "category": "data-display",
+      "status": "stable",
+      "purpose": "Overlapping collaborator avatar stack built on the Avatar primitive with focusable names and overflow count.",
+      "tags": ["identity", "collaboration"],
+      "useWhen": [
+        "Showing who is present, assigned, or collaborating in a compact surface.",
+        "Summarizing a bounded set of people with a visible overflow count."
+      ],
+      "avoidWhen": [
+        "Rendering a single person — use avatar instead.",
+        "Showing status, counts, or metadata labels unrelated to people — use badge, chip, or status-dot instead."
+      ],
+      "related": ["avatar", "badge", "tooltip", "status-dot"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/avatar-group/schema",
+        "variables": "@lostgradient/cinder/avatar-group/variables",
+        "examples": "@lostgradient/cinder/avatar-group/examples"
+      }
+    },
+    {
+      "name": "Backdrop",
+      "id": "backdrop",
+      "import": "@lostgradient/cinder/backdrop",
+      "exportName": "Backdrop",
+      "category": "overlay",
+      "status": "beta",
+      "purpose": "Full-viewport fixed scrim primitive for custom overlay patterns such as loading dimmers and image lightboxes.",
+      "tags": ["overlay", "scrim"],
+      "useWhen": [
+        "Providing a full-screen dimming layer behind a custom overlay that is not modal, drawer, or sheet.",
+        "Building a loading state that dims the full viewport while an async operation runs."
+      ],
+      "avoidWhen": [
+        "Interrupting the user for a decision — use modal or alert-dialog which manage focus and Escape automatically.",
+        "Showing a side panel — use drawer instead.",
+        "Showing structured content in a dialog — use modal, drawer, or sheet, which render their own native `<dialog>::backdrop` scrim."
+      ],
+      "related": ["modal", "drawer", "sheet"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/backdrop/schema",
+        "variables": "@lostgradient/cinder/backdrop/variables",
+        "examples": "@lostgradient/cinder/backdrop/examples"
+      }
+    },
+    {
+      "name": "Badge",
+      "id": "badge",
+      "import": "@lostgradient/cinder/badge",
+      "exportName": "Badge",
+      "category": "data-display",
+      "status": "stable",
+      "purpose": "Compact non-interactive label that annotates an adjacent element with a short status, count, or category.",
+      "tags": ["label", "indicator"],
+      "useWhen": [
+        "Annotating a value with a short status word like \"new\" or \"beta\".",
+        "Displaying a numeric count next to an icon or title."
+      ],
+      "avoidWhen": [
+        "The label must be interactive or removable — use chip instead.",
+        "Showing only a colored dot for presence — use status-dot instead."
+      ],
+      "related": ["chip", "status-dot"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/badge/schema",
+        "variables": "@lostgradient/cinder/badge/variables",
+        "examples": "@lostgradient/cinder/badge/examples"
+      }
+    },
+    {
+      "name": "Banner",
+      "id": "banner",
+      "import": "@lostgradient/cinder/banner",
+      "exportName": "Banner",
+      "category": "feedback",
+      "status": "stable",
+      "purpose": "Page-level dismissible region landmark that surfaces a persistent informational, success, warning, or danger message.",
+      "tags": ["feedback", "notice"],
+      "useWhen": [
+        "Communicating a persistent page-level status the user can dismiss, such as a maintenance window or trial expiry.",
+        "Pinning a non-urgent message above page content that should remain readable until acknowledged."
+      ],
+      "avoidWhen": [
+        "Announcing an urgent, time-sensitive message — use alert so assistive tech reads it immediately.",
+        "Highlighting an inline aside next to related prose — use callout instead."
+      ],
+      "related": ["alert", "callout", "toast-region"],
+      "hasConstraints": false,
+      "hasExamples": false,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/banner/schema",
+        "variables": "@lostgradient/cinder/banner/variables"
+      }
+    },
+    {
+      "name": "BarChart",
+      "id": "bar-chart",
+      "import": "@lostgradient/cinder/bar-chart",
+      "exportName": "BarChart",
+      "category": "data-display",
+      "status": "stable",
+      "purpose": "Responsive SVG bar chart for grouped or stacked category comparisons.",
+      "tags": ["chart", "bar", "analytics"],
+      "useWhen": [
+        "Comparing discrete category totals or grouped category breakdowns.",
+        "Showing stacked contribution across known categories."
+      ],
+      "avoidWhen": [
+        "Showing a continuous ordered trend — use line-chart instead.",
+        "Showing magnitude under a trend — use area-chart instead."
+      ],
+      "related": ["line-chart", "area-chart", "table", "stat"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/bar-chart/schema",
+        "variables": "@lostgradient/cinder/bar-chart/variables",
+        "examples": "@lostgradient/cinder/bar-chart/examples"
+      }
+    },
+    {
+      "name": "Breadcrumbs",
+      "id": "breadcrumbs",
+      "import": "@lostgradient/cinder/breadcrumbs",
+      "exportName": "Breadcrumbs",
+      "category": "navigation",
+      "status": "stable",
+      "purpose": "Hierarchical wayfinding trail showing the ancestor path of the current page with the final entry marked as aria-current.",
+      "tags": ["navigation", "wayfinding"],
+      "useWhen": [
+        "Surfacing where the user sits inside a deep, nested hierarchy.",
+        "Letting the user jump back to any ancestor view in one click."
+      ],
+      "avoidWhen": [
+        "Switching between sibling sections at the same level — use navigation-bar or tabs.",
+        "Showing an ordered task progression — use steps instead."
+      ],
+      "related": ["navigation-bar", "side-navigation", "steps"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/breadcrumbs/schema",
+        "variables": "@lostgradient/cinder/breadcrumbs/variables",
+        "examples": "@lostgradient/cinder/breadcrumbs/examples"
+      }
+    },
+    {
+      "name": "Button",
+      "id": "button",
+      "import": "@lostgradient/cinder/button",
+      "exportName": "Button",
+      "category": "action",
+      "status": "stable",
+      "purpose": "Primary interactive control for triggering actions or rendering an anchor styled as a button via href.",
+      "tags": ["action", "cta"],
+      "useWhen": [
+        "Triggering a discrete action such as submit, save, or delete.",
+        "Rendering a link that should look and behave like a button by passing href."
+      ],
+      "avoidWhen": [
+        "Toggling a binary on or off state — use toggle instead.",
+        "Selecting one of a small fixed set of options — use segmented-control instead."
+      ],
+      "related": ["button-group", "copy-button"],
+      "hasConstraints": true,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/button/schema",
+        "variables": "@lostgradient/cinder/button/variables",
+        "examples": "@lostgradient/cinder/button/examples",
+        "constraints": "@lostgradient/cinder/button/constraints"
+      }
+    },
+    {
+      "name": "ButtonGroup",
+      "id": "button-group",
+      "import": "@lostgradient/cinder/button-group",
+      "exportName": "ButtonGroup",
+      "category": "action",
+      "status": "stable",
+      "purpose": "Visual and semantic grouping of related buttons that share a single accessible label and present as one connected control.",
+      "tags": ["action", "grouping"],
+      "useWhen": [
+        "Clustering related actions such as align-left/center/right that read as a single toolset.",
+        "Visually joining multiple buttons into a single segmented bar without implying selection."
+      ],
+      "avoidWhen": [
+        "Selecting exactly one option from a fixed set — use segmented-control instead.",
+        "Rendering a single button — use button on its own."
+      ],
+      "related": ["button", "segmented-control"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/button-group/schema",
+        "variables": "@lostgradient/cinder/button-group/variables",
+        "examples": "@lostgradient/cinder/button-group/examples"
+      }
+    },
+    {
+      "name": "Callout",
+      "id": "callout",
+      "import": "@lostgradient/cinder/callout",
+      "exportName": "Callout",
+      "category": "feedback",
+      "status": "stable",
+      "purpose": "Inline aside that highlights supporting commentary alongside body content without claiming live-region urgency.",
+      "tags": ["feedback", "notice"],
+      "useWhen": [
+        "Drawing attention to tangential information nested inside prose, documentation, or article content.",
+        "Calling out a tip, note, or caveat that belongs next to the content it qualifies."
+      ],
+      "avoidWhen": [
+        "Announcing a transient or urgent status — use alert or banner instead.",
+        "Communicating a page-wide system message — use banner so it reads as a landmark region."
+      ],
+      "related": ["alert", "banner"],
+      "hasConstraints": false,
+      "hasExamples": false,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/callout/schema",
+        "variables": "@lostgradient/cinder/callout/variables"
+      }
+    },
+    {
+      "name": "Card",
+      "id": "card",
+      "import": "@lostgradient/cinder/card",
+      "exportName": "Card",
+      "category": "layout",
+      "status": "stable",
+      "purpose": "Surface container that groups related content with optional header, title, description, and footer regions.",
+      "tags": ["layout", "container"],
+      "useWhen": [
+        "Grouping a self-contained unit of content such as a summary, preview, or settings panel.",
+        "Composing a list of comparable items where each needs its own framed region."
+      ],
+      "avoidWhen": [
+        "Rendering a bare visual surface without slotted regions — use surface instead.",
+        "Presenting a single key metric — use stat or stat-group instead."
+      ],
+      "related": ["surface", "stat", "stacked-list-item", "section-heading"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/card/schema",
+        "variables": "@lostgradient/cinder/card/variables",
+        "examples": "@lostgradient/cinder/card/examples"
+      }
+    },
+    {
+      "name": "Chat",
+      "id": "chat",
+      "import": "@lostgradient/cinder/chat",
+      "exportName": "Chat",
+      "category": "domain",
+      "status": "domain-suite",
+      "purpose": "Opinionated conversation surface bundling message list, composer, attachments, and scroll affordances for AI or support transcripts.",
+      "tags": ["chat", "conversation", "domain-suite"],
+      "useWhen": [
+        "Shipping a full chat surface with composer, scroll-anchor, unread indicator, and attachments bundled as one heavyweight drop-in.",
+        "Building an AI assistant or support thread where conversation state is modeled as a transcript of role-tagged messages."
+      ],
+      "avoidWhen": [
+        "Rendering a one-off message list — compose lighter primitives directly instead of pulling the full suite.",
+        "The transcript is read-only and needs no composer — a simple list of message bubbles is a better fit."
+      ],
+      "related": ["markdown-editor"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/chat/schema",
+        "variables": "@lostgradient/cinder/chat/variables",
+        "examples": "@lostgradient/cinder/chat/examples"
+      }
+    },
+    {
+      "name": "Checkbox",
+      "id": "checkbox",
+      "import": "@lostgradient/cinder/checkbox",
+      "exportName": "Checkbox",
+      "category": "form",
+      "status": "stable",
+      "purpose": "Binary or tri-state selection control with bindable checked and indeterminate state for forms and lists.",
+      "tags": ["form", "selection"],
+      "useWhen": [
+        "Selecting zero or more independent options from a list.",
+        "Representing a parent state that aggregates child selections via indeterminate."
+      ],
+      "avoidWhen": [
+        "Flipping a single setting on or off with immediate effect — use toggle instead.",
+        "Picking exactly one option from a small fixed set — use RadioGroup or segmented-control instead."
+      ],
+      "related": ["checkbox-group", "radio-group", "toggle", "segmented-control"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/checkbox/schema",
+        "variables": "@lostgradient/cinder/checkbox/variables",
+        "examples": "@lostgradient/cinder/checkbox/examples"
+      }
+    },
+    {
+      "name": "CheckboxGroup",
+      "id": "checkbox-group",
+      "import": "@lostgradient/cinder/checkbox-group",
+      "exportName": "CheckboxGroup",
+      "category": "form",
+      "status": "stable",
+      "purpose": "Fieldset wrapper that groups independent checkboxes under a shared legend, description, and group-level error.",
+      "tags": ["form", "group"],
+      "useWhen": [
+        "Presenting several unrelated checkboxes that share a common heading or validation message.",
+        "Cascading a disabled state to every child checkbox via native fieldset propagation."
+      ],
+      "avoidWhen": ["Picking exactly one option from a fixed set — use radio-group instead."],
+      "related": ["checkbox", "radio-group", "form-field"],
+      "hasConstraints": false,
+      "hasExamples": false,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/checkbox-group/schema",
+        "variables": "@lostgradient/cinder/checkbox-group/variables"
+      }
+    },
+    {
+      "name": "Chip",
+      "id": "chip",
+      "import": "@lostgradient/cinder/chip",
+      "exportName": "Chip",
+      "category": "data-display",
+      "status": "stable",
+      "purpose": "Compact pill for metadata labels, applied filters, selected entities, and tag-like tokens, with optional removal or toggle interactions via its mode prop.",
+      "tags": ["tag", "filter"],
+      "useWhen": [
+        "Representing issue labels, free-form tags, applied filters, selected entities, or other metadata tokens.",
+        "Offering a small toggleable option inside a group of choices."
+      ],
+      "avoidWhen": [
+        "Showing a numeric count, short status, or compact category annotation next to another element — use badge instead.",
+        "Picking one of a small fixed set — use segmented-control instead."
+      ],
+      "related": ["badge", "status-dot"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/chip/schema",
+        "variables": "@lostgradient/cinder/chip/variables",
+        "examples": "@lostgradient/cinder/chip/examples"
+      }
+    },
+    {
+      "name": "ClickAwayListener",
+      "id": "click-away-listener",
+      "import": "@lostgradient/cinder/click-away-listener",
+      "exportName": "ClickAwayListener",
+      "category": "overlay",
+      "status": "beta",
+      "purpose": "Headless utility that calls a function when the user clicks or taps outside a subtree.",
+      "tags": ["overlay", "utility"],
+      "useWhen": [
+        "Building a custom inline-edit field, custom dropdown, or any overlay that should close on outside interaction."
+      ],
+      "avoidWhen": ["Using Popover, Dropdown, or Modal — those handle click-away internally."],
+      "related": ["focus-trap", "popover", "portal"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/click-away-listener/schema",
+        "variables": "@lostgradient/cinder/click-away-listener/variables",
+        "examples": "@lostgradient/cinder/click-away-listener/examples"
+      }
+    },
+    {
+      "name": "CodeBlock",
+      "id": "code-block",
+      "import": "@lostgradient/cinder/code-block",
+      "exportName": "CodeBlock",
+      "category": "data-display",
+      "status": "stable",
+      "purpose": "Block container for multi-line source code with automatic syntax highlighting and a copy-to-clipboard control.",
+      "tags": ["code", "snippet"],
+      "useWhen": [
+        "Displaying a multi-line code sample or terminal transcript inside documentation or chat.",
+        "Letting the reader copy a snippet to the clipboard via the copyable prop."
+      ],
+      "avoidWhen": [
+        "Annotating a single inline keystroke or shortcut — use kbd instead.",
+        "Rendering rich prose that happens to include code — embed it in markdown instead."
+      ],
+      "related": ["kbd", "copy-button"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/code-block/schema",
+        "variables": "@lostgradient/cinder/code-block/variables",
+        "examples": "@lostgradient/cinder/code-block/examples"
+      }
+    },
+    {
+      "name": "Collapsible",
+      "id": "collapsible",
+      "import": "@lostgradient/cinder/collapsible",
+      "exportName": "Collapsible",
+      "category": "data-display",
+      "status": "stable",
+      "purpose": "Single-panel disclosure that toggles one region with an animated height.",
+      "tags": ["disclosure", "collapsible"],
+      "useWhen": [
+        "Hiding a single optional region behind a labeled trigger.",
+        "You need controlled or uncontrolled show/hide with an accessible toggle."
+      ],
+      "avoidWhen": [
+        "Coordinating multiple sections where opening one may close others — use accordion."
+      ],
+      "related": ["accordion", "accordion-item"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/collapsible/schema",
+        "variables": "@lostgradient/cinder/collapsible/variables",
+        "examples": "@lostgradient/cinder/collapsible/examples"
+      }
+    },
+    {
+      "name": "ColorField",
+      "id": "color-field",
+      "import": "@lostgradient/cinder/color-field",
+      "exportName": "ColorField",
+      "category": "form",
+      "status": "stable",
+      "purpose": "Text input that validates and normalizes hex, rgb(), and hsl() color strings into a canonical hex value emitted on blur.",
+      "tags": ["form", "color"],
+      "useWhen": [
+        "Accepting an exact color value via keyboard entry, including pasted hex, rgb(), or hsl() strings.",
+        "Pairing with color-picker for combined visual selection and text-based entry."
+      ],
+      "avoidWhen": [
+        "Letting users graze visually across a color space — use color-picker instead.",
+        "Constraining selection to a fixed brand palette — use color-swatch-picker instead."
+      ],
+      "related": ["color-picker", "color-swatch-picker", "input", "form-field"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/color-field/schema",
+        "variables": "@lostgradient/cinder/color-field/variables",
+        "examples": "@lostgradient/cinder/color-field/examples"
+      }
+    },
+    {
+      "name": "ColorPicker",
+      "id": "color-picker",
+      "import": "@lostgradient/cinder/color-picker",
+      "exportName": "ColorPicker",
+      "category": "form",
+      "status": "stable",
+      "purpose": "Interactive saturation, hue, and alpha control for picking an arbitrary color and emitting a normalized hex value.",
+      "tags": ["form", "color"],
+      "useWhen": [
+        "Letting users pick any color from the full spectrum with optional alpha.",
+        "Composing a custom color with a fallback palette of preset swatches."
+      ],
+      "avoidWhen": [
+        "Constraining selection to a fixed brand palette — use color-swatch-picker instead."
+      ],
+      "related": ["color-swatch-picker", "input"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/color-picker/schema",
+        "variables": "@lostgradient/cinder/color-picker/variables",
+        "examples": "@lostgradient/cinder/color-picker/examples"
+      }
+    },
+    {
+      "name": "ColorSwatchPicker",
+      "id": "color-swatch-picker",
+      "import": "@lostgradient/cinder/color-swatch-picker",
+      "exportName": "ColorSwatchPicker",
+      "category": "form",
+      "status": "stable",
+      "purpose": "Keyboard-navigable listbox of preset color swatches that constrains selection to a curated palette.",
+      "tags": ["form", "color"],
+      "useWhen": [
+        "Restricting color choice to a fixed brand or theme palette.",
+        "Pairing with color-picker as a shortcut for common values."
+      ],
+      "avoidWhen": [
+        "Letting users author arbitrary colors across the spectrum — use color-picker instead."
+      ],
+      "related": ["color-picker"],
+      "hasConstraints": false,
+      "hasExamples": false,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/color-swatch-picker/schema",
+        "variables": "@lostgradient/cinder/color-swatch-picker/variables"
+      }
+    },
+    {
+      "name": "Combobox",
+      "id": "combobox",
+      "import": "@lostgradient/cinder/combobox",
+      "exportName": "Combobox",
+      "category": "form",
+      "status": "stable",
+      "purpose": "Single-select input that filters a fixed option list as the user types, combining free-text search with constrained values.",
+      "tags": ["form", "autocomplete"],
+      "useWhen": [
+        "Choosing one value from a long list where typing is faster than scrolling.",
+        "Letting users narrow options by substring while still requiring a constrained selection."
+      ],
+      "avoidWhen": [
+        "Picking from a short fixed list with no need to filter — use select instead.",
+        "Querying remote data or accepting free-text submissions — use search-field instead."
+      ],
+      "related": ["select", "search-field", "dropdown"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/combobox/schema",
+        "variables": "@lostgradient/cinder/combobox/variables",
+        "examples": "@lostgradient/cinder/combobox/examples"
+      }
+    },
+    {
+      "name": "CommandItem",
+      "id": "command-item",
+      "import": "@lostgradient/cinder/command-item",
+      "exportName": "CommandItem",
+      "category": "action",
+      "status": "stable",
+      "purpose": "Single selectable row inside a command palette or inline command menu that registers itself with the parent command list.",
+      "tags": ["action", "command"],
+      "useWhen": [
+        "Declaring an individual command, action, or result row inside a command-palette or command-menu.",
+        "Composing a custom palette layout via children rather than the items prop."
+      ],
+      "avoidWhen": [
+        "Used outside a command-palette or command-menu ancestor — the component throws at construction.",
+        "Rendering a generic dropdown choice — use dropdown-item instead."
+      ],
+      "related": ["command-palette", "command-menu", "dropdown-item"],
+      "hasConstraints": false,
+      "hasExamples": false,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/command-item/schema",
+        "variables": "@lostgradient/cinder/command-item/variables"
+      }
+    },
+    {
+      "name": "CommandMenu",
+      "id": "command-menu",
+      "import": "@lostgradient/cinder/command-menu",
+      "exportName": "CommandMenu",
+      "category": "overlay",
+      "status": "stable",
+      "purpose": "Inline caret-anchored slash-command list for textareas and single-line text inputs.",
+      "tags": ["overlay", "command"],
+      "useWhen": [
+        "Showing a contextual command list at the caret while a user types in a textarea or input.",
+        "Building slash-command insertion flows where the host owns text replacement."
+      ],
+      "avoidWhen": [
+        "Exposing a global app launcher — use command-palette instead.",
+        "Selecting from a static form option list — use combobox instead."
+      ],
+      "related": ["command-palette", "command-item", "popover", "combobox"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/command-menu/schema",
+        "variables": "@lostgradient/cinder/command-menu/variables",
+        "examples": "@lostgradient/cinder/command-menu/examples"
+      }
+    },
+    {
+      "name": "CommandPalette",
+      "id": "command-palette",
+      "import": "@lostgradient/cinder/command-palette",
+      "exportName": "CommandPalette",
+      "category": "overlay",
+      "status": "stable",
+      "purpose": "Modal search overlay for keyboard-first command launching and navigation. Filtering is consumer-owned: the `items` snippet receives `{ query }` and renders only the matching rows.",
+      "tags": ["overlay", "command"],
+      "useWhen": [
+        "Exposing a global keyboard-first launcher for power-user actions and navigation.",
+        "Letting users search across heterogeneous results such as commands, pages, and records in one input."
+      ],
+      "avoidWhen": [
+        "Picking a single value bound to a form field — use combobox instead.",
+        "Showing a contextual action menu attached to a trigger — use dropdown instead."
+      ],
+      "related": ["combobox", "dropdown", "command-item"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/command-palette/schema",
+        "variables": "@lostgradient/cinder/command-palette/variables",
+        "examples": "@lostgradient/cinder/command-palette/examples"
+      }
+    },
+    {
+      "name": "ConfirmDialog",
+      "id": "confirm-dialog",
+      "import": "@lostgradient/cinder/confirm-dialog",
+      "exportName": "ConfirmDialog",
+      "category": "overlay",
+      "status": "stable",
+      "purpose": "Modal-backed confirmation prompt with cancel and confirm actions, including a destructive variant for irreversible operations.",
+      "tags": ["overlay", "dialog"],
+      "useWhen": [
+        "Requiring an explicit yes/no acknowledgement before performing a destructive or irreversible action.",
+        "Asking the user to confirm a discrete decision with two clear outcomes."
+      ],
+      "avoidWhen": [
+        "Collecting structured input or multiple fields — compose a modal with form controls instead.",
+        "Announcing a non-blocking result — use toast-region or banner."
+      ],
+      "related": ["modal", "drawer", "sheet"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/confirm-dialog/schema",
+        "variables": "@lostgradient/cinder/confirm-dialog/variables",
+        "examples": "@lostgradient/cinder/confirm-dialog/examples"
+      }
+    },
+    {
+      "name": "ConnectionIndicator",
+      "id": "connection-indicator",
+      "import": "@lostgradient/cinder/connection-indicator",
+      "exportName": "ConnectionIndicator",
+      "category": "feedback",
+      "status": "stable",
+      "purpose": "Live-status pill pairing a semantic dot with a label to communicate real-time WebSocket, SSE, or polling connection state.",
+      "tags": ["connection", "status", "realtime"],
+      "useWhen": [
+        "Surfacing whether a realtime channel is connected, connecting, disconnected, or errored on a dashboard or app chrome.",
+        "Giving operators an at-a-glance health signal for a long-lived transport."
+      ],
+      "avoidWhen": [
+        "Communicating generic semantic state with no realtime connection backing it — status-dot is the lower-level primitive."
+      ],
+      "related": ["status-dot", "spinner"],
+      "hasConstraints": false,
+      "hasExamples": false,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/connection-indicator/schema",
+        "variables": "@lostgradient/cinder/connection-indicator/variables"
+      }
+    },
+    {
+      "name": "Container",
+      "id": "container",
+      "import": "@lostgradient/cinder/container",
+      "exportName": "Container",
+      "category": "layout",
+      "status": "stable",
+      "purpose": "Centered content-width wrapper for the narrow-column reading pattern, capping inline size at a configurable width token.",
+      "tags": ["layout"],
+      "useWhen": [
+        "Centering article or long-form content in a readable, max-width-capped column.",
+        "Constraining a section of a page to a named content width without app-shell chrome."
+      ],
+      "avoidWhen": [
+        "Building an app shell with header, breadcrumbs, or action regions — write a hand-rolled page scaffold directly."
+      ],
+      "related": ["aspect-ratio"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/container/schema",
+        "variables": "@lostgradient/cinder/container/variables",
+        "examples": "@lostgradient/cinder/container/examples"
+      }
+    },
+    {
+      "name": "ContextMenu",
+      "id": "context-menu",
+      "import": "@lostgradient/cinder/context-menu",
+      "exportName": "ContextMenu",
+      "category": "overlay",
+      "status": "stable",
+      "purpose": "Right-click and long-press menu positioned at the user's pointer while reusing dropdown menu parts.",
+      "tags": ["overlay", "menu"],
+      "useWhen": [
+        "Providing contextual actions for a canvas, list row, file, or selected item.",
+        "Opening a menu from a pointer location instead of a visible dropdown trigger."
+      ],
+      "avoidWhen": [
+        "The menu should open from a button — use dropdown.",
+        "Showing arbitrary rich content rather than menu actions — use popover."
+      ],
+      "related": ["dropdown", "dropdown-menu", "dropdown-item"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/context-menu/schema",
+        "variables": "@lostgradient/cinder/context-menu/variables",
+        "examples": "@lostgradient/cinder/context-menu/examples"
+      }
+    },
+    {
+      "name": "ContextMenuTrigger",
+      "id": "context-menu-trigger",
+      "import": "@lostgradient/cinder/context-menu-trigger",
+      "exportName": "ContextMenuTrigger",
+      "category": "overlay",
+      "status": "stable",
+      "purpose": "Compose-only trigger region that opens a context-menu on right-click or touch long-press.",
+      "tags": ["overlay", "menu"],
+      "useWhen": [
+        "Wrapping the region that should own contextual actions inside ContextMenu.",
+        "Pairing pointer-positioned menu behavior with dropdown menu items."
+      ],
+      "avoidWhen": [
+        "Used outside context-menu — it requires the ContextMenu provider.",
+        "Opening a normal click menu from a visible button — use dropdown-trigger."
+      ],
+      "related": ["context-menu", "dropdown-trigger"],
+      "hasConstraints": false,
+      "hasExamples": false,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/context-menu-trigger/schema",
+        "variables": "@lostgradient/cinder/context-menu-trigger/variables"
+      }
+    },
+    {
+      "name": "CopyButton",
+      "id": "copy-button",
+      "import": "@lostgradient/cinder/copy-button",
+      "exportName": "CopyButton",
+      "category": "action",
+      "status": "stable",
+      "purpose": "Button that writes a string value to the clipboard and flips to a confirmation state for a short window after a successful copy.",
+      "tags": ["action", "clipboard"],
+      "useWhen": [
+        "Offering one-click copy of a token, snippet, share link, or code sample.",
+        "Pairing with code-block so readers can grab the rendered source."
+      ],
+      "avoidWhen": [
+        "Triggering a generic non-clipboard action — use button instead.",
+        "Copying long-form rich content that needs format preservation — handle clipboard logic directly."
+      ],
+      "related": ["button", "code-block"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/copy-button/schema",
+        "variables": "@lostgradient/cinder/copy-button/variables",
+        "examples": "@lostgradient/cinder/copy-button/examples"
+      }
+    },
+    {
+      "name": "DataList",
+      "id": "data-list",
+      "import": "@lostgradient/cinder/data-list",
+      "exportName": "DataList",
+      "category": "data-display",
+      "status": "stable",
+      "purpose": "Semantic list container for homogeneous record rows, with a styled empty state and an optional list-level density.",
+      "tags": ["list", "iterator"],
+      "useWhen": [
+        "Rendering a vertical list of like records where each row shares the same layout.",
+        "Pairing with StackedListItem rows for leading/title/description/meta/trailing content.",
+        "Showing a dedicated empty state when the collection has no items."
+      ],
+      "avoidWhen": [
+        "Presenting key-value metadata for a single entity — use description-list instead.",
+        "Rendering tabular data with rows and columns — use table instead."
+      ],
+      "related": ["stacked-list-item", "description-list", "table"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/data-list/schema",
+        "variables": "@lostgradient/cinder/data-list/variables",
+        "examples": "@lostgradient/cinder/data-list/examples"
+      }
+    },
+    {
+      "name": "DescriptionList",
+      "id": "description-list",
+      "import": "@lostgradient/cinder/description-list",
+      "exportName": "DescriptionList",
+      "category": "data-display",
+      "status": "stable",
+      "purpose": "Renders an ordered set of term and value pairs that describe attributes of a single entity.",
+      "tags": ["metadata", "key-value"],
+      "useWhen": [
+        "Summarizing the properties of one record such as a user profile or order detail.",
+        "Switching between stacked and inline term layouts via the variant prop."
+      ],
+      "avoidWhen": [
+        "Iterating over a homogenous collection of records — use data-list or table instead."
+      ],
+      "related": ["data-list", "table"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/description-list/schema",
+        "variables": "@lostgradient/cinder/description-list/variables",
+        "examples": "@lostgradient/cinder/description-list/examples"
+      }
+    },
+    {
+      "name": "DiffStatistics",
+      "id": "diff-statistics",
+      "import": "@lostgradient/cinder/diff-statistics",
+      "exportName": "DiffStatistics",
+      "category": "domain",
+      "status": "domain-suite",
+      "purpose": "Compact added, removed, and modified line-count summary that accompanies a Markdown diff view.",
+      "tags": ["diff", "statistics", "domain-suite"],
+      "useWhen": [
+        "Surfacing a quick numeric summary of changes alongside or in lieu of a full diff surface.",
+        "Annotating a list of files or pull requests with line-change counts as part of the diff-viewer suite."
+      ],
+      "avoidWhen": [
+        "Rendering the actual hunked diff content — pair with diff-viewer for the full document comparison.",
+        "Generic numeric badges that have nothing to do with diffs — reach for stat or badge instead."
+      ],
+      "related": ["diff-viewer"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/diff-statistics/schema",
+        "variables": "@lostgradient/cinder/diff-statistics/variables",
+        "examples": "@lostgradient/cinder/diff-statistics/examples"
+      }
+    },
+    {
+      "name": "DiffViewer",
+      "id": "diff-viewer",
+      "import": "@lostgradient/cinder/diff-viewer",
+      "exportName": "DiffViewer",
+      "category": "domain",
+      "status": "domain-suite",
+      "purpose": "Side-by-side or unified Markdown diff surface with hunk grouping, word-level inline changes, and size-based debounce gating.",
+      "tags": ["diff", "markdown", "domain-suite"],
+      "useWhen": [
+        "Comparing two Markdown documents and wanting the bundled toolbar, view-mode toggle, front-matter handling, and large-payload safeguards.",
+        "Building a review workflow that needs hunked, line-anchored Markdown diffs out of the box as a heavyweight suite."
+      ],
+      "avoidWhen": [
+        "Showing only a counts summary — use diff-statistics on its own for a lightweight presentation.",
+        "Diffing non-Markdown source code where syntax-aware highlighting matters more than prose-aware rendering."
+      ],
+      "related": ["diff-statistics", "code-block"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/diff-viewer/schema",
+        "variables": "@lostgradient/cinder/diff-viewer/variables",
+        "examples": "@lostgradient/cinder/diff-viewer/examples"
+      }
+    },
+    {
+      "name": "Divider",
+      "id": "divider",
+      "import": "@lostgradient/cinder/divider",
+      "exportName": "Divider",
+      "category": "layout",
+      "status": "stable",
+      "purpose": "Thin decorative or semantic separator between content regions, with optional vertical orientation and tonal variants.",
+      "tags": ["layout", "separator"],
+      "useWhen": [
+        "Visually separating sections of a card, list, or toolbar without adding heading-level structure.",
+        "Splitting a row of inline controls (e.g. a button-group toolbar) with a vertical rule."
+      ],
+      "avoidWhen": [
+        "The split between sections deserves a heading — use section-heading instead.",
+        "Wrapping the entire viewport edge — use surface or page-layout instead."
+      ],
+      "related": ["surface", "section-heading"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/divider/schema",
+        "variables": "@lostgradient/cinder/divider/variables",
+        "examples": "@lostgradient/cinder/divider/examples"
+      }
+    },
+    {
+      "name": "Drawer",
+      "id": "drawer",
+      "import": "@lostgradient/cinder/drawer",
+      "exportName": "Drawer",
+      "category": "overlay",
+      "status": "stable",
+      "purpose": "Side-anchored modal panel built on the native dialog element for secondary navigation, settings, or long-form supporting content.",
+      "tags": ["overlay", "dialog"],
+      "useWhen": [
+        "Showing supplementary navigation, filters, or settings that should slide in from a page edge.",
+        "Presenting long-form content that benefits from a side panel without leaving the current view."
+      ],
+      "avoidWhen": [
+        "Interrupting the user for a focused decision — use modal so the surface is centered and task-scoped.",
+        "Anchoring a small surface to a trigger — use popover or sheet instead."
+      ],
+      "related": ["modal", "sheet", "popover"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/drawer/schema",
+        "variables": "@lostgradient/cinder/drawer/variables",
+        "examples": "@lostgradient/cinder/drawer/examples"
+      }
+    },
+    {
+      "name": "Dropdown",
+      "id": "dropdown",
+      "import": "@lostgradient/cinder/dropdown",
+      "exportName": "Dropdown",
+      "category": "overlay",
+      "status": "stable",
+      "purpose": "Root container that wires a trigger to a popover-backed menu and coordinates open state, keyboard navigation, and CSS Anchor Positioning for descendant menu parts.",
+      "tags": ["overlay", "menu"],
+      "useWhen": [
+        "Composing a menu of actions or links revealed by clicking a button trigger.",
+        "Building a custom dropdown layout from dropdown-trigger, dropdown-menu, dropdown-item, dropdown-label, and dropdown-separator parts."
+      ],
+      "avoidWhen": [
+        "Selecting a value from a list of options — use select or combobox instead.",
+        "Showing supplementary content rather than a menu of choices — use popover."
+      ],
+      "related": [
+        "dropdown-trigger",
+        "dropdown-menu",
+        "dropdown-item",
+        "dropdown-label",
+        "dropdown-separator"
+      ],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/dropdown/schema",
+        "variables": "@lostgradient/cinder/dropdown/variables",
+        "examples": "@lostgradient/cinder/dropdown/examples"
+      }
+    },
+    {
+      "name": "DropdownGroup",
+      "id": "dropdown-group",
+      "import": "@lostgradient/cinder/dropdown-group",
+      "exportName": "DropdownGroup",
+      "category": "overlay",
+      "status": "stable",
+      "purpose": "Accessible group boundary that clusters related dropdown-item rows inside a dropdown-menu.",
+      "tags": ["overlay", "menu"],
+      "useWhen": [
+        "Grouping related dropdown actions under one accessible heading.",
+        "Pairing dropdown-label with a role='group' container inside dropdown-menu."
+      ],
+      "avoidWhen": [
+        "Rendering a clickable row — use dropdown-item.",
+        "Separating sections without a group label — use dropdown-separator."
+      ],
+      "related": [
+        "dropdown",
+        "dropdown-menu",
+        "dropdown-item",
+        "dropdown-label",
+        "dropdown-separator"
+      ],
+      "hasConstraints": false,
+      "hasExamples": false,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/dropdown-group/schema",
+        "variables": "@lostgradient/cinder/dropdown-group/variables"
+      }
+    },
+    {
+      "name": "DropdownItem",
+      "id": "dropdown-item",
+      "import": "@lostgradient/cinder/dropdown-item",
+      "exportName": "DropdownItem",
+      "category": "overlay",
+      "status": "stable",
+      "purpose": "Selectable menuitem inside a dropdown-menu that handles activation, keyboard support, and optional close-on-select behavior.",
+      "tags": ["overlay", "menu"],
+      "useWhen": [
+        "Rendering an individual action or link row inside a dropdown-menu.",
+        "Composing menu rows that should close the parent dropdown after selection unless closeOnSelect is disabled."
+      ],
+      "avoidWhen": [
+        "Used outside a dropdown context — it requires the dropdown provider and will throw otherwise.",
+        "Grouping a static heading row above menu items — use dropdown-label."
+      ],
+      "related": ["dropdown", "dropdown-menu", "dropdown-label", "dropdown-separator"],
+      "hasConstraints": false,
+      "hasExamples": false,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/dropdown-item/schema",
+        "variables": "@lostgradient/cinder/dropdown-item/variables"
+      }
+    },
+    {
+      "name": "DropdownLabel",
+      "id": "dropdown-label",
+      "import": "@lostgradient/cinder/dropdown-label",
+      "exportName": "DropdownLabel",
+      "category": "overlay",
+      "status": "stable",
+      "purpose": "Non-interactive heading row that groups related dropdown-item rows inside a dropdown-menu.",
+      "tags": ["overlay", "menu"],
+      "useWhen": [
+        "Labeling a group of related menu items with a short heading.",
+        "Providing a visual section title above a cluster of dropdown-item rows."
+      ],
+      "avoidWhen": [
+        "Rendering a selectable row — use dropdown-item.",
+        "Visually dividing groups without a heading — use dropdown-separator."
+      ],
+      "related": ["dropdown", "dropdown-menu", "dropdown-item", "dropdown-separator"],
+      "hasConstraints": false,
+      "hasExamples": false,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/dropdown-label/schema",
+        "variables": "@lostgradient/cinder/dropdown-label/variables"
+      }
+    },
+    {
+      "name": "DropdownMenu",
+      "id": "dropdown-menu",
+      "import": "@lostgradient/cinder/dropdown-menu",
+      "exportName": "DropdownMenu",
+      "category": "overlay",
+      "status": "stable",
+      "purpose": "Popover-backed menu surface that hosts dropdown-item rows and owns arrow-key, Home, End, and Escape navigation.",
+      "tags": ["overlay", "menu"],
+      "useWhen": [
+        "Rendering the floating panel that holds a dropdown's menu items.",
+        "Composing a dropdown's body from dropdown-item, dropdown-label, and dropdown-separator children."
+      ],
+      "avoidWhen": [
+        "Used outside a dropdown context — it requires the dropdown provider and will throw otherwise.",
+        "Showing arbitrary non-menu content — use popover."
+      ],
+      "related": [
+        "dropdown",
+        "dropdown-trigger",
+        "dropdown-item",
+        "dropdown-label",
+        "dropdown-separator"
+      ],
+      "hasConstraints": false,
+      "hasExamples": false,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/dropdown-menu/schema",
+        "variables": "@lostgradient/cinder/dropdown-menu/variables"
+      }
+    },
+    {
+      "name": "DropdownSeparator",
+      "id": "dropdown-separator",
+      "import": "@lostgradient/cinder/dropdown-separator",
+      "exportName": "DropdownSeparator",
+      "category": "overlay",
+      "status": "stable",
+      "purpose": "Horizontal divider with role=\"separator\" that visually segments groups of rows inside a dropdown-menu.",
+      "tags": ["overlay", "menu"],
+      "useWhen": [
+        "Visually splitting unrelated groups of dropdown-item rows without adding a heading.",
+        "Marking a boundary between primary actions and destructive or secondary actions in a menu."
+      ],
+      "avoidWhen": [
+        "Labeling a section of items — use dropdown-label so the group has an accessible heading.",
+        "Rendering an interactive row — use dropdown-item."
+      ],
+      "related": ["dropdown", "dropdown-menu", "dropdown-label", "dropdown-item"],
+      "hasConstraints": false,
+      "hasExamples": false,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/dropdown-separator/schema",
+        "variables": "@lostgradient/cinder/dropdown-separator/variables"
+      }
+    },
+    {
+      "name": "DropdownTrigger",
+      "id": "dropdown-trigger",
+      "import": "@lostgradient/cinder/dropdown-trigger",
+      "exportName": "DropdownTrigger",
+      "category": "form",
+      "status": "stable",
+      "purpose": "Button-shaped trigger that opens a dropdown menu, optionally rendering a trailing disclosure caret.",
+      "tags": ["form", "trigger"],
+      "useWhen": [
+        "Opening a dropdown-menu from a button styled to match cinder's form controls.",
+        "Pairing with dropdown to expose a custom menu from a labelled affordance."
+      ],
+      "avoidWhen": ["Triggering a discrete action with no menu — use button instead."],
+      "related": ["dropdown", "dropdown-menu"],
+      "hasConstraints": false,
+      "hasExamples": false,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/dropdown-trigger/schema",
+        "variables": "@lostgradient/cinder/dropdown-trigger/variables"
+      }
+    },
+    {
+      "name": "EmptyState",
+      "id": "empty-state",
+      "import": "@lostgradient/cinder/empty-state",
+      "exportName": "EmptyState",
+      "category": "feedback",
+      "status": "stable",
+      "purpose": "Centered placeholder with optional icon, title, description, and call-to-action for views that have no data to render.",
+      "tags": ["feedback", "empty"],
+      "useWhen": [
+        "Communicating that a list, table, or workspace has no items yet and suggesting a next step.",
+        "Replacing a primary content region after a filter or search returns no results."
+      ],
+      "avoidWhen": [
+        "Indicating that data is still loading — use skeleton or spinner instead.",
+        "Reporting a transient error — use alert, banner, or toast-region."
+      ],
+      "related": ["skeleton", "spinner"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/empty-state/schema",
+        "variables": "@lostgradient/cinder/empty-state/variables",
+        "examples": "@lostgradient/cinder/empty-state/examples"
+      }
+    },
+    {
+      "name": "Feed",
+      "id": "feed",
+      "import": "@lostgradient/cinder/feed",
+      "exportName": "Feed",
+      "category": "data-display",
+      "status": "stable",
+      "purpose": "Ordered list container for a chronological stream of feed-event entries, optionally exposed as a live region.",
+      "tags": ["timeline", "activity"],
+      "useWhen": [
+        "Rendering an activity log, audit trail, or notification timeline.",
+        "Announcing newly appended entries to assistive technology via the live prop."
+      ],
+      "avoidWhen": ["Displaying a one-off transient notice — use toast-region or banner instead."],
+      "related": ["feed-event"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/feed/schema",
+        "variables": "@lostgradient/cinder/feed/variables",
+        "examples": "@lostgradient/cinder/feed/examples"
+      }
+    },
+    {
+      "name": "FeedEvent",
+      "id": "feed-event",
+      "import": "@lostgradient/cinder/feed-event",
+      "exportName": "FeedEvent",
+      "category": "data-display",
+      "status": "stable",
+      "purpose": "Individual entry within a feed that pairs a timestamp with a content snippet and optional leading icon.",
+      "tags": ["timeline", "event"],
+      "useWhen": [
+        "Rendering a single activity or audit entry inside a feed parent.",
+        "Switching between an icon-led and a connector-led visual treatment via the variant prop."
+      ],
+      "avoidWhen": [
+        "Standing alone outside a feed — it expects the feed list semantics around it."
+      ],
+      "related": ["feed"],
+      "hasConstraints": false,
+      "hasExamples": false,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/feed-event/schema",
+        "variables": "@lostgradient/cinder/feed-event/variables"
+      }
+    },
+    {
+      "name": "FileUpload",
+      "id": "file-upload",
+      "import": "@lostgradient/cinder/file-upload",
+      "exportName": "FileUpload",
+      "category": "form",
+      "status": "stable",
+      "purpose": "File picker and drag-and-drop surface that validates files locally and can render upload progress rows.",
+      "tags": ["form", "upload"],
+      "useWhen": [
+        "Collecting one or more files while keeping the native picker available for keyboard and assistive-technology users.",
+        "Showing per-file upload progress or rejection errors below a prominent dropzone surface."
+      ],
+      "avoidWhen": ["You only need a hidden native file input with no custom UI."],
+      "related": ["form-field", "progress", "input"],
+      "hasConstraints": false,
+      "hasExamples": false,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/file-upload/schema",
+        "variables": "@lostgradient/cinder/file-upload/variables"
+      }
+    },
+    {
+      "name": "FloatingActionButton",
+      "id": "floating-action-button",
+      "import": "@lostgradient/cinder/floating-action-button",
+      "exportName": "FloatingActionButton",
+      "category": "action",
+      "status": "beta",
+      "purpose": "Circular button representing the single most important action on a screen.",
+      "tags": ["action", "button"],
+      "useWhen": ["One action dominates the page purpose (compose, add, create)."],
+      "avoidWhen": [
+        "Multiple equally-important actions exist — use a toolbar or button group.",
+        "You need it pinned to the viewport — it doesn't position itself; wrap it in your own fixed/sticky container."
+      ],
+      "related": ["button", "toolbar"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/floating-action-button/schema",
+        "variables": "@lostgradient/cinder/floating-action-button/variables",
+        "examples": "@lostgradient/cinder/floating-action-button/examples"
+      }
+    },
+    {
+      "name": "FocusTrap",
+      "id": "focus-trap",
+      "import": "@lostgradient/cinder/focus-trap",
+      "exportName": "FocusTrap",
+      "category": "overlay",
+      "status": "stable",
+      "purpose": "Headless focus-trap primitive that keeps Tab navigation within a container and restores focus on teardown.",
+      "tags": ["overlay", "accessibility"],
+      "useWhen": [
+        "Building non-native overlays or popovers that need contained keyboard focus.",
+        "Reusing the same focus-management behavior across custom floating surfaces."
+      ],
+      "avoidWhen": ["The surface already uses native dialog focus trapping."],
+      "related": ["modal", "drawer", "sheet", "popover"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/focus-trap/schema",
+        "variables": "@lostgradient/cinder/focus-trap/variables",
+        "examples": "@lostgradient/cinder/focus-trap/examples"
+      }
+    },
+    {
+      "name": "FormField",
+      "id": "form-field",
+      "import": "@lostgradient/cinder/form-field",
+      "exportName": "FormField",
+      "category": "form",
+      "status": "stable",
+      "purpose": "Wrapper primitive that pairs a single control with its label, description, and error and wires the ARIA association via context.",
+      "tags": ["form", "wrapper"],
+      "useWhen": [
+        "Composing a one-off field where the input does not own its own label rendering.",
+        "Forwarding shared required, disabled, and error state to an opted-in child control."
+      ],
+      "avoidWhen": [
+        "Grouping multiple related controls under one heading — use form-section instead."
+      ],
+      "related": ["form-section", "label", "input"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/form-field/schema",
+        "variables": "@lostgradient/cinder/form-field/variables",
+        "examples": "@lostgradient/cinder/form-field/examples"
+      }
+    },
+    {
+      "name": "FormSection",
+      "id": "form-section",
+      "import": "@lostgradient/cinder/form-section",
+      "exportName": "FormSection",
+      "category": "form",
+      "status": "stable",
+      "purpose": "Sectioning wrapper that groups related form fields under a heading or legend and applies a responsive column layout.",
+      "tags": ["form", "layout"],
+      "useWhen": [
+        "Splitting a long form into labelled segments such as \"Account\" or \"Billing\".",
+        "Rendering a fieldset with a legend for a set of tightly related inputs."
+      ],
+      "avoidWhen": ["Wrapping a single control with its label and error — use form-field instead."],
+      "related": ["form-field", "section-heading"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/form-section/schema",
+        "variables": "@lostgradient/cinder/form-section/variables",
+        "examples": "@lostgradient/cinder/form-section/examples"
+      }
+    },
+    {
+      "name": "GridList",
+      "id": "grid-list",
+      "import": "@lostgradient/cinder/grid-list",
+      "exportName": "GridList",
+      "category": "data-display",
+      "status": "stable",
+      "purpose": "Responsive grid container that arranges grid-list-item tiles into auto-sized columns.",
+      "tags": ["grid", "gallery"],
+      "useWhen": [
+        "Presenting a homogenous collection of cards that should reflow into multiple columns.",
+        "Constraining tile minimum widths per breakpoint via the minColumnWidth prop."
+      ],
+      "avoidWhen": [
+        "Comparing rows of structured data — use table instead.",
+        "Stacking dense list rows vertically — use stacked-list-item instead."
+      ],
+      "related": ["grid-list-item", "table"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/grid-list/schema",
+        "variables": "@lostgradient/cinder/grid-list/variables",
+        "examples": "@lostgradient/cinder/grid-list/examples"
+      }
+    },
+    {
+      "name": "GridListItem",
+      "id": "grid-list-item",
+      "import": "@lostgradient/cinder/grid-list-item",
+      "exportName": "GridListItem",
+      "category": "data-display",
+      "status": "stable",
+      "purpose": "Tile within a grid-list that combines an image, title, subtitle, meta, and action slots and may link via href.",
+      "tags": ["grid", "tile"],
+      "useWhen": [
+        "Rendering a single card cell inside a grid-list parent.",
+        "Turning the tile into an anchor by passing href."
+      ],
+      "avoidWhen": ["Standing alone outside a grid-list — it inherits the grid layout context."],
+      "related": ["grid-list"],
+      "hasConstraints": false,
+      "hasExamples": false,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/grid-list-item/schema",
+        "variables": "@lostgradient/cinder/grid-list-item/variables"
+      }
+    },
+    {
+      "name": "HoverCard",
+      "id": "hover-card",
+      "import": "@lostgradient/cinder/hover-card",
+      "exportName": "HoverCard",
+      "category": "overlay",
+      "status": "stable",
+      "purpose": "Hover-and-focus triggered rich preview card for non-interactive contextual content.",
+      "tags": ["overlay", "hover"],
+      "useWhen": [
+        "Showing a profile, issue, or metadata preview that is richer than a tooltip but still read-only.",
+        "Revealing supplementary preview content on pointer hover or keyboard focus without moving focus."
+      ],
+      "avoidWhen": [
+        "The floating content contains focusable controls — use popover.",
+        "The trigger needs a short accessible description — use tooltip."
+      ],
+      "related": ["tooltip", "popover"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/hover-card/schema",
+        "variables": "@lostgradient/cinder/hover-card/variables",
+        "examples": "@lostgradient/cinder/hover-card/examples"
+      }
+    },
+    {
+      "name": "Image",
+      "id": "image",
+      "import": "@lostgradient/cinder/image",
+      "exportName": "Image",
+      "category": "data-display",
+      "status": "stable",
+      "purpose": "Responsive image wrapper that handles aspect ratio, lazy loading, placeholder, and a fallback for load failures.",
+      "tags": ["image", "media"],
+      "useWhen": [
+        "Rendering content imagery with a consistent ratio and lazy-loading behavior.",
+        "Supplying a placeholder while loading and a fallback when the source errors."
+      ],
+      "avoidWhen": [
+        "Representing a person or account — use avatar instead.",
+        "Rendering a decorative icon — use an icon component instead."
+      ],
+      "related": ["avatar"],
+      "hasConstraints": false,
+      "hasExamples": false,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/image/schema",
+        "variables": "@lostgradient/cinder/image/variables"
+      }
+    },
+    {
+      "name": "Input",
+      "id": "input",
+      "import": "@lostgradient/cinder/input",
+      "exportName": "Input",
+      "category": "form",
+      "status": "stable",
+      "purpose": "Single-line text input with bound value, label, description, and error wiring for form-field accessibility.",
+      "tags": ["form", "field"],
+      "useWhen": [
+        "Collecting a single line of free-form text such as a name, email, or URL.",
+        "Composing inside a form-field with leading or trailing adornments."
+      ],
+      "avoidWhen": [
+        "Collecting multi-line prose — use textarea instead.",
+        "Collecting a numeric value with stepping controls — use number-input instead."
+      ],
+      "related": ["textarea", "number-input", "search-field", "form-field"],
+      "hasConstraints": true,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/input/schema",
+        "variables": "@lostgradient/cinder/input/variables",
+        "examples": "@lostgradient/cinder/input/examples",
+        "constraints": "@lostgradient/cinder/input/constraints"
+      }
+    },
+    {
+      "name": "JsonSchemaEditor",
+      "id": "json-schema-editor",
+      "import": "@lostgradient/cinder/json-schema-editor",
+      "exportName": "JsonSchemaEditor",
+      "category": "form",
+      "status": "stable",
+      "purpose": "Multi-view editor for authoring JSON Schema documents with form, raw JSON, and diff modes plus undo history and validation.",
+      "tags": ["form", "editor"],
+      "useWhen": [
+        "Letting users edit a JSON Schema with a guided form alongside the raw source.",
+        "Reviewing schema changes against a baseline via the built-in diff view."
+      ],
+      "avoidWhen": [
+        "Editing arbitrary free-form JSON with no schema semantics — use a plain code editor instead."
+      ],
+      "related": ["markdown-editor", "review-editor"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/json-schema-editor/schema",
+        "variables": "@lostgradient/cinder/json-schema-editor/variables",
+        "examples": "@lostgradient/cinder/json-schema-editor/examples"
+      }
+    },
+    {
+      "name": "JsonViewer",
+      "id": "json-viewer",
+      "import": "@lostgradient/cinder/json-viewer",
+      "exportName": "JsonViewer",
+      "category": "data-display",
+      "status": "stable",
+      "purpose": "Collapsible tree visualization of an arbitrary JSON value with hard depth and byte caps and a fallback for oversized payloads.",
+      "tags": ["json", "inspector", "tree"],
+      "useWhen": [
+        "Inspecting structured API responses, debug payloads, or configuration documents inside an admin or developer surface.",
+        "Rendering a JSON-serializable value with predictable initial-collapse behavior and no virtualization needs."
+      ],
+      "avoidWhen": [
+        "The payload is large enough to need search, filter, or virtualization — compose a custom viewer instead.",
+        "Showing arbitrary source code rather than a JSON value — code-block is the right surface for that."
+      ],
+      "related": ["code-block", "tree"],
+      "hasConstraints": false,
+      "hasExamples": false,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/json-viewer/schema",
+        "variables": "@lostgradient/cinder/json-viewer/variables"
+      }
+    },
+    {
+      "name": "KanbanBoard",
+      "id": "kanban-board",
+      "import": "@lostgradient/cinder/kanban-board",
+      "exportName": "KanbanBoard",
+      "category": "data-display",
+      "status": "stable",
+      "purpose": "Controlled multi-column board for reordering cards within and across workflow columns with keyboard, pointer, and live-region feedback.",
+      "tags": ["board", "kanban", "drag", "reorder"],
+      "useWhen": [
+        "Presenting a workflow board where users move cards between ordered columns.",
+        "Consumers own card rendering and need cinder to manage reorder affordances and change metadata."
+      ],
+      "avoidWhen": [
+        "Showing a single ordered list — use sortable-list instead.",
+        "Sorting by computed fields rather than direct manual placement."
+      ],
+      "related": ["sortable-list", "grid-list", "data-list"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/kanban-board/schema",
+        "variables": "@lostgradient/cinder/kanban-board/variables",
+        "examples": "@lostgradient/cinder/kanban-board/examples"
+      }
+    },
+    {
+      "name": "Kbd",
+      "id": "kbd",
+      "import": "@lostgradient/cinder/kbd",
+      "exportName": "Kbd",
+      "category": "typography",
+      "status": "stable",
+      "purpose": "Inline element that styles a single keystroke or shortcut sequence with the semantic kbd tag.",
+      "tags": ["shortcut", "inline"],
+      "useWhen": [
+        "Calling out a keyboard shortcut inline within prose or a tooltip.",
+        "Composing chorded shortcuts by rendering multiple kbd elements side by side."
+      ],
+      "avoidWhen": ["Displaying a block of source code — use code-block instead."],
+      "related": ["code-block"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/kbd/schema",
+        "variables": "@lostgradient/cinder/kbd/variables",
+        "examples": "@lostgradient/cinder/kbd/examples"
+      }
+    },
+    {
+      "name": "Label",
+      "id": "label",
+      "import": "@lostgradient/cinder/label",
+      "exportName": "Label",
+      "category": "form",
+      "status": "stable",
+      "purpose": "Standalone label primitive that associates text with a custom control via for and matches the visual treatment of built-in inputs.",
+      "tags": ["form", "primitive"],
+      "useWhen": [
+        "Building a hand-rolled field that wraps multiple inputs needing one shared label.",
+        "Matching the disabled or required visual treatment of cinder inputs on a custom control."
+      ],
+      "avoidWhen": [
+        "Labelling a built-in input that already renders its own label prop — pass label instead."
+      ],
+      "related": ["form-field", "input", "checkbox", "radio-group"],
+      "hasConstraints": false,
+      "hasExamples": false,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/label/schema",
+        "variables": "@lostgradient/cinder/label/variables"
+      }
+    },
+    {
+      "name": "LineChart",
+      "id": "line-chart",
+      "import": "@lostgradient/cinder/line-chart",
+      "exportName": "LineChart",
+      "category": "data-display",
+      "status": "stable",
+      "purpose": "Responsive SVG line chart for comparing one or more numeric series over an ordered x domain.",
+      "tags": ["chart", "line", "analytics"],
+      "useWhen": [
+        "Showing trends over time or another ordered domain.",
+        "Comparing several metric series on the same numeric axis."
+      ],
+      "avoidWhen": [
+        "Comparing discrete category totals — use bar-chart instead.",
+        "Showing cumulative filled trends — use area-chart instead."
+      ],
+      "related": ["area-chart", "bar-chart", "table", "stat"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/line-chart/schema",
+        "variables": "@lostgradient/cinder/line-chart/variables",
+        "examples": "@lostgradient/cinder/line-chart/examples"
+      }
+    },
+    {
+      "name": "Link",
+      "id": "link",
+      "import": "@lostgradient/cinder/link",
+      "exportName": "Link",
+      "category": "typography",
+      "status": "beta",
+      "purpose": "Inline text link with consistent focus ring and underline behavior.",
+      "tags": ["typography", "link"],
+      "useWhen": ["Embedding a navigable link inside body text or prose content."],
+      "avoidWhen": ["Navigating between pages in a sidebar or nav bar — use NavigationItem."],
+      "related": ["navigation-item", "button", "breadcrumbs"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/link/schema",
+        "variables": "@lostgradient/cinder/link/variables",
+        "examples": "@lostgradient/cinder/link/examples"
+      }
+    },
+    {
+      "name": "LoadMore",
+      "id": "load-more",
+      "import": "@lostgradient/cinder/load-more",
+      "exportName": "LoadMore",
+      "category": "navigation",
+      "status": "stable",
+      "purpose": "Sentinel-based infinite-scroll trigger with an always-visible button fallback and accessible status states.",
+      "tags": ["navigation", "paging"],
+      "useWhen": [
+        "Streaming results into a long list and you want the next page to load as the user approaches the end."
+      ],
+      "avoidWhen": [
+        "The dataset is bounded and benefits from discrete jumps — use `Pagination` instead."
+      ],
+      "related": ["pagination"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/load-more/schema",
+        "variables": "@lostgradient/cinder/load-more/variables",
+        "examples": "@lostgradient/cinder/load-more/examples"
+      }
+    },
+    {
+      "name": "MarkdownEditor",
+      "id": "markdown-editor",
+      "import": "@lostgradient/cinder/markdown-editor",
+      "exportName": "MarkdownEditor",
+      "category": "domain",
+      "status": "domain-suite",
+      "purpose": "Rich Markdown editing surface bundling a Milkdown-powered ProseMirror editor, toolbar, and mark or block introspection helpers.",
+      "tags": ["markdown", "editor", "domain-suite"],
+      "useWhen": [
+        "Composing or editing Markdown documents and wanting the bundled toolbar, link-aware selection, and source or WYSIWYG mode toggle.",
+        "Building writing surfaces that need an editor handle for programmatic mark or block manipulation as part of the heavyweight suite."
+      ],
+      "avoidWhen": [
+        "Authoring a simple plain-text note — a textarea is dramatically lighter than the Milkdown bundle.",
+        "The surface needs inline review threads on top of the editor — use review-editor for that composition."
+      ],
+      "related": ["review-editor", "code-block"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/markdown-editor/schema",
+        "variables": "@lostgradient/cinder/markdown-editor/variables",
+        "examples": "@lostgradient/cinder/markdown-editor/examples"
+      }
+    },
+    {
+      "name": "MenuBar",
+      "id": "menu-bar",
+      "import": "@lostgradient/cinder/menu-bar",
+      "exportName": "MenuBar",
+      "category": "navigation",
+      "status": "stable",
+      "purpose": "Command menubar for application chrome such as File, Edit, and View menus.",
+      "tags": ["navigation", "menu", "chrome"],
+      "useWhen": [
+        "Building a desktop-style command menubar with dropdown command groups.",
+        "Exposing top-level application menus that need arrow-key traversal and optional submenus."
+      ],
+      "avoidWhen": [
+        "Linking between routes or sections — use navigation-bar or side-navigation instead.",
+        "Showing one standalone trigger with a menu — use dropdown, dropdown-menu, and dropdown-item directly."
+      ],
+      "related": ["navigation-bar", "dropdown", "dropdown-menu", "dropdown-item"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/menu-bar/schema",
+        "variables": "@lostgradient/cinder/menu-bar/variables",
+        "examples": "@lostgradient/cinder/menu-bar/examples"
+      }
+    },
+    {
+      "name": "Message",
+      "id": "message",
+      "import": "@lostgradient/cinder/message",
+      "exportName": "Message",
+      "category": "data-display",
+      "status": "stable",
+      "purpose": "Chat-style bubble that renders a role label, optional timestamp, and arbitrary body content for transcript or run-stream views.",
+      "tags": ["chat", "message", "conversation"],
+      "useWhen": [
+        "Composing a transcript of user, assistant, and system turns outside the full chat suite.",
+        "Rendering AI agent runs, support threads, or audit logs where each entry has a speaker and a body."
+      ],
+      "avoidWhen": [
+        "Building a complete conversation surface with composer and scroll affordances — reach for the chat suite instead.",
+        "Communicating a single non-conversational notice — callout is more appropriate."
+      ],
+      "related": ["chat", "callout"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/message/schema",
+        "variables": "@lostgradient/cinder/message/variables",
+        "examples": "@lostgradient/cinder/message/examples"
+      }
+    },
+    {
+      "name": "Modal",
+      "id": "modal",
+      "import": "@lostgradient/cinder/modal",
+      "exportName": "Modal",
+      "category": "overlay",
+      "status": "stable",
+      "purpose": "Centered modal dialog shell built on the native dialog element with focus capture, restoration, and dismissal handling.",
+      "tags": ["overlay", "dialog"],
+      "useWhen": [
+        "Presenting rich or structured content that requires user interaction before returning to the page — forms, multi-step wizards, detail views.",
+        "Collecting structured input (forms, multi-field workflows) inside an overlay."
+      ],
+      "avoidWhen": [
+        "Only a two-action confirm/cancel prompt is needed — use confirm-dialog instead.",
+        "An urgent blocking acknowledgement is needed — use alert-dialog instead.",
+        "Showing side-anchored navigation or settings — use a drawer instead.",
+        "Presenting a small contextual surface anchored to a trigger — use a popover or sheet instead."
+      ],
+      "related": ["confirm-dialog", "alert-dialog", "drawer", "sheet", "popover"],
+      "hasConstraints": true,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/modal/schema",
+        "variables": "@lostgradient/cinder/modal/variables",
+        "examples": "@lostgradient/cinder/modal/examples",
+        "constraints": "@lostgradient/cinder/modal/constraints"
+      }
+    },
+    {
+      "name": "NavigationBar",
+      "id": "navigation-bar",
+      "import": "@lostgradient/cinder/navigation-bar",
+      "exportName": "NavigationBar",
+      "category": "navigation",
+      "status": "stable",
+      "purpose": "Top-level application header that pairs a brand mark with a horizontal set of navigation items and an optional mobile menu toggle.",
+      "tags": ["navigation", "chrome"],
+      "useWhen": [
+        "Anchoring an app shell with primary sections, branding, and account actions across the top edge.",
+        "Providing a responsive nav that collapses items behind a menu toggle below a breakpoint."
+      ],
+      "avoidWhen": [
+        "Showing the ancestor trail of the current page — use breadcrumbs instead.",
+        "Building a tall, dense sidebar of grouped sections — use side-navigation instead."
+      ],
+      "related": ["navigation-item", "breadcrumbs", "side-navigation"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/navigation-bar/schema",
+        "variables": "@lostgradient/cinder/navigation-bar/variables",
+        "examples": "@lostgradient/cinder/navigation-bar/examples"
+      }
+    },
+    {
+      "name": "NavigationItem",
+      "id": "navigation-item",
+      "import": "@lostgradient/cinder/navigation-item",
+      "exportName": "NavigationItem",
+      "category": "navigation",
+      "status": "stable",
+      "purpose": "Single wayfinding item that renders as an anchor when given href or as a button when given onclick, with active-state aria-current.",
+      "tags": ["navigation", "link"],
+      "useWhen": [
+        "Rendering one entry in a navigation bar, sidebar, or side-navigation group.",
+        "Switching the active view or section while signalling current location via aria-current."
+      ],
+      "avoidWhen": [
+        "Showing a hierarchical trail of ancestors — use breadcrumbs instead.",
+        "Triggering a generic action unrelated to navigation — use button instead."
+      ],
+      "related": ["navigation-bar", "side-navigation-item", "breadcrumbs", "tab"],
+      "hasConstraints": false,
+      "hasExamples": false,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/navigation-item/schema",
+        "variables": "@lostgradient/cinder/navigation-item/variables"
+      }
+    },
+    {
+      "name": "NumberInput",
+      "id": "number-input",
+      "import": "@lostgradient/cinder/number-input",
+      "exportName": "NumberInput",
+      "category": "form",
+      "status": "stable",
+      "purpose": "Numeric input with locale-aware formatting, min and max bounds, and step increments emitting a number or null.",
+      "tags": ["form", "numeric"],
+      "useWhen": [
+        "Collecting a bounded numeric value such as a quantity, price, or age.",
+        "Needing locale-aware display formatting on top of a native number input."
+      ],
+      "avoidWhen": [
+        "Selecting a value within a continuous range visually — use slider instead.",
+        "Collecting free-form text or non-numeric content — use input instead."
+      ],
+      "related": ["input", "slider"],
+      "hasConstraints": false,
+      "hasExamples": false,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/number-input/schema",
+        "variables": "@lostgradient/cinder/number-input/variables"
+      }
+    },
+    {
+      "name": "Pagination",
+      "id": "pagination",
+      "import": "@lostgradient/cinder/pagination",
+      "exportName": "Pagination",
+      "category": "navigation",
+      "status": "stable",
+      "purpose": "Page-number control for paged result sets that exposes previous, next, and numeric jumps with elided middle pages.",
+      "tags": ["navigation", "paging"],
+      "useWhen": [
+        "Moving through a large, ordered dataset split into discrete pages of fixed size.",
+        "Showing the current page in context of the total page count."
+      ],
+      "avoidWhen": [
+        "Switching between named sibling views — use tabs instead.",
+        "Streaming results as the user scrolls — wire up infinite scroll directly."
+      ],
+      "related": ["tabs"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/pagination/schema",
+        "variables": "@lostgradient/cinder/pagination/variables",
+        "examples": "@lostgradient/cinder/pagination/examples"
+      }
+    },
+    {
+      "name": "PhoneInput",
+      "id": "phone-input",
+      "import": "@lostgradient/cinder/phone-input",
+      "exportName": "PhoneInput",
+      "category": "form",
+      "status": "stable",
+      "purpose": "International phone-number input pairing a country-code dropdown with an as-you-type national number input and emitting E.164 values.",
+      "tags": ["form", "phone"],
+      "useWhen": [
+        "Collecting an international phone number that must be stored in a canonical E.164 form.",
+        "Letting the user pick a calling country and a national number side-by-side."
+      ],
+      "avoidWhen": [
+        "Collecting a free-form local number with no country context — use input type=\"tel\" instead.",
+        "Collecting an SMS verification code — use pin-input instead."
+      ],
+      "related": ["input", "pin-input", "form-field"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/phone-input/schema",
+        "variables": "@lostgradient/cinder/phone-input/variables",
+        "examples": "@lostgradient/cinder/phone-input/examples"
+      }
+    },
+    {
+      "name": "PinInput",
+      "id": "pin-input",
+      "import": "@lostgradient/cinder/pin-input",
+      "exportName": "PinInput",
+      "category": "form",
+      "status": "stable",
+      "purpose": "Segmented one-time-code input with auto-advance, paste distribution, and masking support for entering short security codes.",
+      "tags": ["form", "otp"],
+      "useWhen": [
+        "Collecting a short security code such as a one-time password or SMS verification code.",
+        "Letting the browser autofill a one-time-code into a visually segmented control."
+      ],
+      "avoidWhen": [
+        "Collecting a free-form string of any length — use input instead.",
+        "Collecting a numeric value that participates in arithmetic — use number-input instead."
+      ],
+      "related": ["input", "number-input", "form-field"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/pin-input/schema",
+        "variables": "@lostgradient/cinder/pin-input/variables",
+        "examples": "@lostgradient/cinder/pin-input/examples"
+      }
+    },
+    {
+      "name": "Popover",
+      "id": "popover",
+      "import": "@lostgradient/cinder/popover",
+      "exportName": "Popover",
+      "category": "overlay",
+      "status": "stable",
+      "purpose": "Anchored floating panel positioned by Floating UI that hosts non-modal contextual content beside a trigger element.",
+      "tags": ["overlay", "floating"],
+      "useWhen": [
+        "Showing rich, interactive contextual content anchored to a trigger such as a help panel, color picker, or listbox surface.",
+        "Presenting non-blocking supplementary controls that should dismiss on outside click or Escape."
+      ],
+      "avoidWhen": [
+        "Showing a short descriptive hint on hover or focus — use tooltip instead.",
+        "Interrupting the user for a focused task — use modal, drawer, or sheet so the surface is modal."
+      ],
+      "related": ["modal", "drawer", "sheet", "tooltip"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/popover/schema",
+        "variables": "@lostgradient/cinder/popover/variables",
+        "examples": "@lostgradient/cinder/popover/examples"
+      }
+    },
+    {
+      "name": "Portal",
+      "id": "portal",
+      "import": "@lostgradient/cinder/portal",
+      "exportName": "Portal",
+      "category": "overlay",
+      "status": "stable",
+      "purpose": "Headless portal primitive that moves a subtree into a target element while preserving inline rendering as an explicit opt-out.",
+      "tags": ["overlay", "utilities"],
+      "useWhen": [
+        "Rendering an overlay or floating surface outside the current stacking or overflow context.",
+        "Building a custom anchored or modal primitive that needs to append content into document.body or a named host."
+      ],
+      "avoidWhen": [
+        "The content should stay in normal document flow or inherit layout from its original parent."
+      ],
+      "related": ["popover", "modal", "drawer", "sheet"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/portal/schema",
+        "variables": "@lostgradient/cinder/portal/variables",
+        "examples": "@lostgradient/cinder/portal/examples"
+      }
+    },
+    {
+      "name": "Progress",
+      "id": "progress",
+      "import": "@lostgradient/cinder/progress",
+      "exportName": "Progress",
+      "category": "feedback",
+      "status": "stable",
+      "purpose": "Determinate or indeterminate progressbar rendered as a horizontal bar or ring with full ARIA value semantics.",
+      "tags": ["feedback", "progress"],
+      "useWhen": [
+        "Reporting measurable progress of a known task such as a file upload or multi-step import.",
+        "Showing an indeterminate work indicator when the task duration is unknown but the surface needs a progressbar role."
+      ],
+      "avoidWhen": [
+        "Showing a small inline busy state next to a control — use spinner.",
+        "Reserving placeholder space for incoming content — use skeleton."
+      ],
+      "related": ["spinner", "skeleton"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/progress/schema",
+        "variables": "@lostgradient/cinder/progress/variables",
+        "examples": "@lostgradient/cinder/progress/examples"
+      }
+    },
+    {
+      "name": "RadioGroup",
+      "id": "radio-group",
+      "import": "@lostgradient/cinder/radio-group",
+      "exportName": "RadioGroup",
+      "category": "form",
+      "status": "stable",
+      "purpose": "Fieldset that owns the bound value, shared name, and validation state for a set of mutually exclusive radio children.",
+      "tags": ["form", "selection"],
+      "useWhen": [
+        "Picking exactly one option from a small fixed set where every choice should stay visible.",
+        "Sharing a single error and description across a set of related radios."
+      ],
+      "avoidWhen": ["Selecting zero or more independent options — use checkbox-group instead."],
+      "related": ["checkbox-group"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/radio-group/schema",
+        "variables": "@lostgradient/cinder/radio-group/variables",
+        "examples": "@lostgradient/cinder/radio-group/examples"
+      }
+    },
+    {
+      "name": "Rating",
+      "id": "rating",
+      "import": "@lostgradient/cinder/rating",
+      "exportName": "Rating",
+      "category": "form",
+      "status": "stable",
+      "purpose": "Star rating control with bindable numeric value, optional half-star precision, and a non-interactive readonly display mode.",
+      "tags": ["form", "selection"],
+      "useWhen": [
+        "Letting the user score something on a small ordinal scale such as 1-5 stars.",
+        "Displaying an existing rating in readonly mode alongside a count or average."
+      ],
+      "avoidWhen": [
+        "Picking a value from a numeric continuum — use slider instead.",
+        "Capturing a binary preference — use toggle or checkbox."
+      ],
+      "related": ["slider", "segmented-control", "radio-group", "form-field"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/rating/schema",
+        "variables": "@lostgradient/cinder/rating/variables",
+        "examples": "@lostgradient/cinder/rating/examples"
+      }
+    },
+    {
+      "name": "ResizablePanels",
+      "id": "resizable-panels",
+      "import": "@lostgradient/cinder/resizable-panels",
+      "exportName": "ResizablePanels",
+      "category": "layout",
+      "status": "stable",
+      "purpose": "Measured splitter layout that renders adjacent resize handles between panes and emits persisted layout state after pointer, keyboard, and collapse interactions.",
+      "tags": ["layout", "splitter", "panels"],
+      "useWhen": [
+        "Building editor, inspector, or dashboard layouts where neighboring panes must be resized directly by dragging a separator.",
+        "Persisting a multi-pane workspace layout without coupling the component to localStorage."
+      ],
+      "avoidWhen": [
+        "You only need a static two-column or stack layout with no interactive resizing.",
+        "Content should wrap naturally instead of claiming a fixed share of a measured container."
+      ],
+      "related": ["divider", "scroll-area"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/resizable-panels/schema",
+        "variables": "@lostgradient/cinder/resizable-panels/variables",
+        "examples": "@lostgradient/cinder/resizable-panels/examples"
+      }
+    },
+    {
+      "name": "ReviewEditor",
+      "id": "review-editor",
+      "import": "@lostgradient/cinder/review-editor",
+      "exportName": "ReviewEditor",
+      "category": "domain",
+      "status": "domain-suite",
+      "purpose": "Markdown editor extended with inline review threads, anchored comments, and collaborative annotation state.",
+      "tags": ["markdown", "review", "domain-suite"],
+      "useWhen": [
+        "Building a document review experience that needs both a Markdown editor and anchored comment threads in one bundled surface.",
+        "Threading reviewer commentary against specific selections inside a long-form document."
+      ],
+      "avoidWhen": [
+        "Plain authoring with no review threads — markdown-editor is the lighter primitive.",
+        "Reviewing diffs between two documents rather than annotating one — use diff-viewer instead."
+      ],
+      "related": ["markdown-editor"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/review-editor/schema",
+        "variables": "@lostgradient/cinder/review-editor/variables",
+        "examples": "@lostgradient/cinder/review-editor/examples"
+      }
+    },
+    {
+      "name": "ScrollArea",
+      "id": "scroll-area",
+      "import": "@lostgradient/cinder/scroll-area",
+      "exportName": "ScrollArea",
+      "category": "layout",
+      "status": "stable",
+      "purpose": "Bounded scrolling container that constrains overflowing content within a max height or width while remaining keyboard-focusable.",
+      "tags": ["layout", "overflow"],
+      "useWhen": [
+        "Containing a long list or large block of content inside a fixed-size region.",
+        "Preserving keyboard scrollability for overflow content in a card or surface."
+      ],
+      "avoidWhen": [
+        "Wrapping the entire page — let the document scroll natively.",
+        "Hiding overflow without scrollbars — use plain CSS overflow utilities instead."
+      ],
+      "related": ["surface"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/scroll-area/schema",
+        "variables": "@lostgradient/cinder/scroll-area/variables",
+        "examples": "@lostgradient/cinder/scroll-area/examples"
+      }
+    },
+    {
+      "name": "SearchField",
+      "id": "search-field",
+      "import": "@lostgradient/cinder/search-field",
+      "exportName": "SearchField",
+      "category": "form",
+      "status": "stable",
+      "purpose": "Search input with a leading icon, automatic clear button, and optional keyboard shortcut hint badge.",
+      "tags": ["form", "search"],
+      "useWhen": [
+        "Capturing a free-text query that filters or queries a larger dataset.",
+        "Surfacing a global search affordance with a visible keyboard shortcut."
+      ],
+      "avoidWhen": ["Selecting from a constrained list of known options — use combobox instead."],
+      "related": ["input", "combobox"],
+      "hasConstraints": false,
+      "hasExamples": false,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/search-field/schema",
+        "variables": "@lostgradient/cinder/search-field/variables"
+      }
+    },
+    {
+      "name": "SectionHeading",
+      "id": "section-heading",
+      "import": "@lostgradient/cinder/section-heading",
+      "exportName": "SectionHeading",
+      "category": "typography",
+      "status": "stable",
+      "purpose": "Section header that renders a leveled heading with optional eyebrow label, description, actions, and tabs row.",
+      "tags": ["typography", "heading"],
+      "useWhen": [
+        "Introducing a top-level section of a page with a title and supporting metadata.",
+        "Pairing a section title with inline actions or a tab row beneath the heading."
+      ],
+      "avoidWhen": [
+        "Labelling a single form control or field — use label instead.",
+        "Rendering a page-wide header with primary navigation — use a hand-rolled page scaffold with a heading element."
+      ],
+      "related": ["card", "tab-list"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/section-heading/schema",
+        "variables": "@lostgradient/cinder/section-heading/variables",
+        "examples": "@lostgradient/cinder/section-heading/examples"
+      }
+    },
+    {
+      "name": "Segment",
+      "id": "segment",
+      "import": "@lostgradient/cinder/segment",
+      "exportName": "Segment",
+      "category": "form",
+      "status": "stable",
+      "purpose": "Individual option inside a SegmentedControl that renders the button, wires the value, and forwards leading/trailing decorations.",
+      "tags": ["form", "selection"],
+      "useWhen": [
+        "Authoring SegmentedControl children declaratively so consumers can compose icons, labels, and badges per segment.",
+        "Mixing disabled and enabled segments inside a single radiogroup/tablist where each segment carries its own metadata."
+      ],
+      "avoidWhen": [
+        "Building a standalone toggle button — use Button or Toggle instead.",
+        "Selecting one option from a long list — use Select or Combobox instead."
+      ],
+      "related": ["segmented-control", "button", "toggle"],
+      "hasConstraints": false,
+      "hasExamples": false,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/segment/schema",
+        "variables": "@lostgradient/cinder/segment/variables"
+      }
+    },
+    {
+      "name": "SegmentedControl",
+      "id": "segmented-control",
+      "import": "@lostgradient/cinder/segmented-control",
+      "exportName": "SegmentedControl",
+      "category": "form",
+      "status": "stable",
+      "purpose": "Compact radio-style selector that surfaces a small fixed set of options as a single connected bar and binds the chosen value.",
+      "tags": ["form", "selection"],
+      "useWhen": [
+        "Choosing one of two to five mutually exclusive options that all fit on screen at once.",
+        "Picking a view filter where seeing every option beats hiding them inside a toggle or tabs control."
+      ],
+      "avoidWhen": [
+        "Toggling a single binary on or off — use toggle or checkbox instead.",
+        "Switching between panels of associated content — use tabs instead."
+      ],
+      "related": ["toggle", "checkbox", "tabs", "button-group"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/segmented-control/schema",
+        "variables": "@lostgradient/cinder/segmented-control/variables",
+        "examples": "@lostgradient/cinder/segmented-control/examples"
+      }
+    },
+    {
+      "name": "Select",
+      "id": "select",
+      "import": "@lostgradient/cinder/select",
+      "exportName": "Select",
+      "category": "form",
+      "status": "stable",
+      "purpose": "Native select control with label, description, and error wiring for picking one value from a short fixed option list.",
+      "tags": ["form", "selection"],
+      "useWhen": [
+        "Picking one value from a short list where the native control's mobile behavior is desirable.",
+        "Composing inside a form with built-in label and aria-describedby plumbing."
+      ],
+      "avoidWhen": [
+        "Filtering a long list by typing — use combobox instead.",
+        "Building a custom-styled menu trigger — use dropdown instead."
+      ],
+      "related": ["combobox", "dropdown", "radio-group"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/select/schema",
+        "variables": "@lostgradient/cinder/select/variables",
+        "examples": "@lostgradient/cinder/select/examples"
+      }
+    },
+    {
+      "name": "SelectionPopover",
+      "id": "selection-popover",
+      "import": "@lostgradient/cinder/selection-popover",
+      "exportName": "SelectionPopover",
+      "category": "overlay",
+      "status": "stable",
+      "purpose": "Floating toolbar anchored to a text selection that exposes a comment-on-selection action with an inline composer.",
+      "tags": ["overlay", "selection"],
+      "useWhen": [
+        "Letting readers annotate or comment on a highlighted range of text in a document or article surface.",
+        "Surfacing selection-scoped actions such as quote, share, or comment near the user's pointer."
+      ],
+      "avoidWhen": [
+        "Anchoring generic non-selection content to a trigger — use popover.",
+        "Building a general-purpose floating toolbar unrelated to text selection — compose a popover with custom controls."
+      ],
+      "related": ["popover"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/selection-popover/schema",
+        "variables": "@lostgradient/cinder/selection-popover/variables",
+        "examples": "@lostgradient/cinder/selection-popover/examples"
+      }
+    },
+    {
+      "name": "Sheet",
+      "id": "sheet",
+      "import": "@lostgradient/cinder/sheet",
+      "exportName": "Sheet",
+      "category": "overlay",
+      "status": "stable",
+      "purpose": "Bottom-anchored modal panel built on the native dialog element with an optional drag handle for mobile-first sheet patterns.",
+      "tags": ["overlay", "dialog"],
+      "useWhen": [
+        "Presenting a focused task or set of actions that slides up from the bottom of the viewport on touch surfaces.",
+        "Showing a contextual surface that should feel anchored to the screen edge rather than centered like a modal."
+      ],
+      "avoidWhen": [
+        "Interrupting the user with a centered task or confirmation — use modal instead.",
+        "Showing supplementary side navigation or filters — use drawer or popover."
+      ],
+      "related": ["modal", "drawer", "popover"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/sheet/schema",
+        "variables": "@lostgradient/cinder/sheet/variables",
+        "examples": "@lostgradient/cinder/sheet/examples"
+      }
+    },
+    {
+      "name": "SideNavigation",
+      "id": "side-navigation",
+      "import": "@lostgradient/cinder/side-navigation",
+      "exportName": "SideNavigation",
+      "category": "navigation",
+      "status": "stable",
+      "purpose": "Vertical navigation column that hosts grouped side-navigation-item entries with a required accessible label for the landmark.",
+      "tags": ["navigation", "sidebar"],
+      "useWhen": [
+        "Building a tall, dense application sidebar with many sections and nested groups.",
+        "Pairing with sidebar so the column collapses responsively on narrow viewports."
+      ],
+      "avoidWhen": [
+        "Anchoring primary navigation across the top of the page — use navigation-bar instead.",
+        "Rendering a single flat horizontal nav row — use navigation-bar instead."
+      ],
+      "related": ["side-navigation-item", "side-navigation-group", "navigation-bar", "sidebar"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/side-navigation/schema",
+        "variables": "@lostgradient/cinder/side-navigation/variables",
+        "examples": "@lostgradient/cinder/side-navigation/examples"
+      }
+    },
+    {
+      "name": "SideNavigationGroup",
+      "id": "side-navigation-group",
+      "import": "@lostgradient/cinder/side-navigation-group",
+      "exportName": "SideNavigationGroup",
+      "category": "navigation",
+      "status": "stable",
+      "purpose": "Collapsible labelled bucket inside side-navigation that groups related side-navigation-item entries under a single heading.",
+      "tags": ["navigation", "grouping"],
+      "useWhen": [
+        "Splitting a long side-navigation column into clearly named sections.",
+        "Letting users collapse rarely used groups to reduce visual noise in the sidebar."
+      ],
+      "avoidWhen": [
+        "Used outside a side-navigation ancestor — it expects that landmark for context.",
+        "Hosting a single flat list with no grouping — place side-navigation-item entries directly."
+      ],
+      "related": ["side-navigation", "side-navigation-item"],
+      "hasConstraints": false,
+      "hasExamples": false,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/side-navigation-group/schema",
+        "variables": "@lostgradient/cinder/side-navigation-group/variables"
+      }
+    },
+    {
+      "name": "SideNavigationItem",
+      "id": "side-navigation-item",
+      "import": "@lostgradient/cinder/side-navigation-item",
+      "exportName": "SideNavigationItem",
+      "category": "navigation",
+      "status": "stable",
+      "purpose": "Single list-wrapped navigation entry tuned for the vertical layout of side-navigation, delegating rendering to navigation-item.",
+      "tags": ["navigation", "sidebar"],
+      "useWhen": [
+        "Rendering one entry inside a side-navigation column or side-navigation-group.",
+        "Keeping list semantics correct so screen readers announce sidebar entry counts."
+      ],
+      "avoidWhen": [
+        "Placing entries in a horizontal navigation-bar — use navigation-item directly.",
+        "Rendering outside a side-navigation list — use navigation-item without the list wrapper."
+      ],
+      "related": ["side-navigation", "side-navigation-group", "navigation-item"],
+      "hasConstraints": false,
+      "hasExamples": false,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/side-navigation-item/schema",
+        "variables": "@lostgradient/cinder/side-navigation-item/variables"
+      }
+    },
+    {
+      "name": "Sidebar",
+      "id": "sidebar",
+      "import": "@lostgradient/cinder/sidebar",
+      "exportName": "Sidebar",
+      "category": "layout",
+      "status": "stable",
+      "purpose": "Responsive layout shell that anchors a collapsible column beside main content and swaps to a drawer below a configurable breakpoint.",
+      "tags": ["layout", "responsive"],
+      "useWhen": [
+        "Wrapping the page chrome so a navigation column can collapse and become a mobile drawer automatically.",
+        "Sharing collapsed state between a side-navigation column and the rest of the app shell via context."
+      ],
+      "avoidWhen": [
+        "Building the page body itself rather than the surrounding shell — use a hand-rolled page scaffold instead.",
+        "Rendering navigation entries directly — place side-navigation inside the sidebar column."
+      ],
+      "related": ["side-navigation", "drawer"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/sidebar/schema",
+        "variables": "@lostgradient/cinder/sidebar/variables",
+        "examples": "@lostgradient/cinder/sidebar/examples"
+      }
+    },
+    {
+      "name": "Skeleton",
+      "id": "skeleton",
+      "import": "@lostgradient/cinder/skeleton",
+      "exportName": "Skeleton",
+      "category": "feedback",
+      "status": "stable",
+      "purpose": "Decorative placeholder block that reserves layout space while real content loads.",
+      "tags": ["feedback", "loading"],
+      "useWhen": [
+        "Reserving the rough shape of incoming content during an initial fetch to avoid layout shift.",
+        "Indicating progressive load of cards, rows, or media tiles where the final shape is known."
+      ],
+      "avoidWhen": [
+        "Indicating indeterminate background work without a known target shape — use spinner.",
+        "Communicating that a view has no data at all — use empty-state."
+      ],
+      "related": ["spinner", "empty-state", "progress"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/skeleton/schema",
+        "variables": "@lostgradient/cinder/skeleton/variables",
+        "examples": "@lostgradient/cinder/skeleton/examples"
+      }
+    },
+    {
+      "name": "Slider",
+      "id": "slider",
+      "import": "@lostgradient/cinder/slider",
+      "exportName": "Slider",
+      "category": "form",
+      "status": "stable",
+      "purpose": "Single- or two-thumb slider implementing the WAI-ARIA slider pattern for picking a value or range along a numeric scale.",
+      "tags": ["form", "numeric"],
+      "useWhen": [
+        "Picking a value within a continuous range where visual position communicates magnitude.",
+        "Selecting a low and high bound together via the range mode."
+      ],
+      "avoidWhen": [
+        "Entering a precise numeric value typed by the user — use number-input instead.",
+        "Displaying read-only completion — use progress instead."
+      ],
+      "related": ["number-input", "progress"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/slider/schema",
+        "variables": "@lostgradient/cinder/slider/variables",
+        "examples": "@lostgradient/cinder/slider/examples"
+      }
+    },
+    {
+      "name": "SortableList",
+      "id": "sortable-list",
+      "import": "@lostgradient/cinder/sortable-list",
+      "exportName": "SortableList",
+      "category": "data-display",
+      "status": "stable",
+      "purpose": "Keyboard-and-pointer reorderable list that emits onreorder when the user drags or arrow-keys an item into a new position with announcer feedback.",
+      "tags": ["data-display", "reorder"],
+      "useWhen": [
+        "Letting users manually reorder a small to medium list of items via drag handle or keyboard.",
+        "Surfacing live region announcements during a reorder for accessible feedback."
+      ],
+      "avoidWhen": [
+        "Showing a read-only list with no reorder affordance — use grid-list instead.",
+        "Sorting by a column or computed key — sort the source array and rerender."
+      ],
+      "related": ["grid-list"],
+      "hasConstraints": false,
+      "hasExamples": false,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/sortable-list/schema",
+        "variables": "@lostgradient/cinder/sortable-list/variables"
+      }
+    },
+    {
+      "name": "Spinner",
+      "id": "spinner",
+      "import": "@lostgradient/cinder/spinner",
+      "exportName": "Spinner",
+      "category": "feedback",
+      "status": "stable",
+      "purpose": "Compact role=\"status\" indicator that communicates indeterminate background work with an accessible loading label.",
+      "tags": ["feedback", "loading"],
+      "useWhen": [
+        "Showing that a short asynchronous action is in progress without a predictable completion time.",
+        "Indicating inline busy state next to a control while a request resolves."
+      ],
+      "avoidWhen": [
+        "Reserving layout space for content with a known final shape — use skeleton.",
+        "Reporting determinate progress with a measurable percentage — use progress."
+      ],
+      "related": ["skeleton", "progress"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/spinner/schema",
+        "variables": "@lostgradient/cinder/spinner/variables",
+        "examples": "@lostgradient/cinder/spinner/examples"
+      }
+    },
+    {
+      "name": "StackedListItem",
+      "id": "stacked-list-item",
+      "import": "@lostgradient/cinder/stacked-list-item",
+      "exportName": "StackedListItem",
+      "category": "data-display",
+      "status": "stable",
+      "purpose": "Dense list row with leading, title, description, meta, and trailing slots that may optionally render as an anchor.",
+      "tags": ["list", "row"],
+      "useWhen": [
+        "Listing entities vertically with consistent leading icons or avatars and trailing actions.",
+        "Linking each row to a detail view by passing href."
+      ],
+      "avoidWhen": [
+        "Comparing tabular data across columns — use table instead.",
+        "Rendering cards in a responsive grid — use grid-list instead."
+      ],
+      "related": ["grid-list-item", "table-row", "avatar"],
+      "hasConstraints": false,
+      "hasExamples": false,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/stacked-list-item/schema",
+        "variables": "@lostgradient/cinder/stacked-list-item/variables"
+      }
+    },
+    {
+      "name": "Stat",
+      "id": "stat",
+      "import": "@lostgradient/cinder/stat",
+      "exportName": "Stat",
+      "category": "data-display",
+      "status": "stable",
+      "purpose": "Single key metric with a label, formatted value, and optional change indicator that pairs into a stat-group dashboard tile.",
+      "tags": ["data-display", "metric"],
+      "useWhen": [
+        "Highlighting one important number such as revenue, signups, or error rate.",
+        "Composing a dashboard tile alongside other Stat instances inside stat-group."
+      ],
+      "avoidWhen": [
+        "Conveying status with a short label or icon — use badge instead.",
+        "Showing tabular numeric breakdowns — use table or data-list instead."
+      ],
+      "related": ["stat-group", "badge"],
+      "hasConstraints": false,
+      "hasExamples": false,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/stat/schema",
+        "variables": "@lostgradient/cinder/stat/variables"
+      }
+    },
+    {
+      "name": "StatGroup",
+      "id": "stat-group",
+      "import": "@lostgradient/cinder/stat-group",
+      "exportName": "StatGroup",
+      "category": "data-display",
+      "status": "stable",
+      "purpose": "Grid container that arranges a set of stat tiles into a responsive multi-column layout with shared labelling.",
+      "tags": ["data-display", "dashboard"],
+      "useWhen": [
+        "Showing a row of related stat tiles such as the top metrics of a dashboard.",
+        "Giving a cluster of stat entries a single accessible group label."
+      ],
+      "avoidWhen": [
+        "Rendering exactly one metric — use stat on its own.",
+        "Building a freeform card grid unrelated to numeric metrics — compose surface or grid-list directly."
+      ],
+      "related": ["stat"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/stat-group/schema",
+        "variables": "@lostgradient/cinder/stat-group/variables",
+        "examples": "@lostgradient/cinder/stat-group/examples"
+      }
+    },
+    {
+      "name": "StatusDot",
+      "id": "status-dot",
+      "import": "@lostgradient/cinder/status-dot",
+      "exportName": "StatusDot",
+      "category": "feedback",
+      "status": "stable",
+      "purpose": "Static role=\"img\" badge that communicates an entity's state through a colored dot with an accessible text label.",
+      "tags": ["feedback", "status"],
+      "useWhen": [
+        "Indicating the current state of a list row, user, deployment, or other entity alongside its name.",
+        "Communicating status compactly when many indicators appear together without triggering live-region announcements."
+      ],
+      "avoidWhen": [
+        "Counting items or showing a numeric value — use badge instead.",
+        "Announcing a transient status change — use toast-region or alert so assistive tech reads it."
+      ],
+      "related": ["badge"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/status-dot/schema",
+        "variables": "@lostgradient/cinder/status-dot/variables",
+        "examples": "@lostgradient/cinder/status-dot/examples"
+      }
+    },
+    {
+      "name": "Steps",
+      "id": "steps",
+      "import": "@lostgradient/cinder/steps",
+      "exportName": "Steps",
+      "category": "navigation",
+      "status": "stable",
+      "purpose": "Ordered progress indicator that visualizes a fixed sequence of steps with completed, current, and upcoming states.",
+      "tags": ["navigation", "progress"],
+      "useWhen": [
+        "Walking the user through a multi-step wizard or checkout flow with strict ordering.",
+        "Showing how far the user has advanced through a known number of stages."
+      ],
+      "avoidWhen": [
+        "Switching between independent peer views with no order — use tabs instead.",
+        "Showing ancestor hierarchy of the current page — use breadcrumbs instead."
+      ],
+      "related": ["tabs", "breadcrumbs", "pagination"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/steps/schema",
+        "variables": "@lostgradient/cinder/steps/variables",
+        "examples": "@lostgradient/cinder/steps/examples"
+      }
+    },
+    {
+      "name": "Surface",
+      "id": "surface",
+      "import": "@lostgradient/cinder/surface",
+      "exportName": "Surface",
+      "category": "layout",
+      "status": "stable",
+      "purpose": "Neutral background primitive that establishes a tonal layer for nested content and broadcasts its tone to descendants via context.",
+      "tags": ["layout", "container"],
+      "useWhen": [
+        "Wrapping a region in a consistent background tone such as default, raised, or sunken.",
+        "Letting nested components adapt their styling based on the surrounding surface tone."
+      ],
+      "avoidWhen": [
+        "Building a self-contained content card with padding and elevation — use card instead.",
+        "Standing up a full page scaffold with header and actions — use a hand-rolled page scaffold instead."
+      ],
+      "related": ["card"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/surface/schema",
+        "variables": "@lostgradient/cinder/surface/variables",
+        "examples": "@lostgradient/cinder/surface/examples"
+      }
+    },
+    {
+      "name": "Tab",
+      "id": "tab",
+      "import": "@lostgradient/cinder/tab",
+      "exportName": "Tab",
+      "category": "navigation",
+      "status": "stable",
+      "purpose": "Single selectable tab trigger inside a tabs composite that registers with the parent context and controls a matching tab-panel.",
+      "tags": ["navigation", "tabs"],
+      "useWhen": [
+        "Declaring one tab heading inside a tabs ancestor with a stable value identifier.",
+        "Pairing one-to-one with a tab-panel that shares the same value to wire aria-controls."
+      ],
+      "avoidWhen": [
+        "Used outside a tabs ancestor — the component throws at construction.",
+        "Rendering a generic action button — use button instead."
+      ],
+      "related": ["tabs", "tab-list", "tab-panel"],
+      "hasConstraints": false,
+      "hasExamples": false,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/tab/schema",
+        "variables": "@lostgradient/cinder/tab/variables"
+      }
+    },
+    {
+      "name": "TabList",
+      "id": "tab-list",
+      "import": "@lostgradient/cinder/tab-list",
+      "exportName": "TabList",
+      "category": "navigation",
+      "status": "stable",
+      "purpose": "Tablist container inside a tabs composite that wraps tab triggers and exposes the ARIA tablist role with orientation metadata.",
+      "tags": ["navigation", "tabs"],
+      "useWhen": [
+        "Wrapping a row or column of tab triggers inside a tabs ancestor.",
+        "Providing the accessible label or labelledby reference for the tablist landmark."
+      ],
+      "avoidWhen": [
+        "Used outside a tabs ancestor — the component throws at construction.",
+        "Rendering tab-panel content — keep panels as siblings outside the tab-list."
+      ],
+      "related": ["tabs", "tab", "tab-panel"],
+      "hasConstraints": false,
+      "hasExamples": false,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/tab-list/schema",
+        "variables": "@lostgradient/cinder/tab-list/variables"
+      }
+    },
+    {
+      "name": "TabPanel",
+      "id": "tab-panel",
+      "import": "@lostgradient/cinder/tab-panel",
+      "exportName": "TabPanel",
+      "category": "navigation",
+      "status": "stable",
+      "purpose": "Content region inside a tabs composite that becomes visible when its sibling tab with the matching value is active.",
+      "tags": ["navigation", "tabs"],
+      "useWhen": [
+        "Hosting the body content associated with a specific tab inside a tabs ancestor.",
+        "Letting the tabs context drive aria-labelledby and visibility automatically from the shared value."
+      ],
+      "avoidWhen": [
+        "Used outside a tabs ancestor — the component throws at construction.",
+        "Rendering the tab trigger itself — use tab inside a tab-list."
+      ],
+      "related": ["tabs", "tab", "tab-list"],
+      "hasConstraints": false,
+      "hasExamples": false,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/tab-panel/schema",
+        "variables": "@lostgradient/cinder/tab-panel/variables"
+      }
+    },
+    {
+      "name": "Table",
+      "id": "table",
+      "import": "@lostgradient/cinder/table",
+      "exportName": "Table",
+      "category": "data-display",
+      "status": "stable",
+      "purpose": "Composite root that establishes table semantics, density, and sort context for nested header, body, row, and cell parts.",
+      "tags": ["table", "grid"],
+      "useWhen": [
+        "Comparing rows of structured records across consistent columns.",
+        "Coordinating column sort state across header cells via the sort prop."
+      ],
+      "avoidWhen": [
+        "Rendering a responsive card grid — use grid-list instead.",
+        "Listing key-value attributes of one entity — use description-list instead."
+      ],
+      "related": ["table-header", "table-body", "table-row", "table-cell", "table-header-cell"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/table/schema",
+        "variables": "@lostgradient/cinder/table/variables",
+        "examples": "@lostgradient/cinder/table/examples"
+      }
+    },
+    {
+      "name": "TableBody",
+      "id": "table-body",
+      "import": "@lostgradient/cinder/table-body",
+      "exportName": "TableBody",
+      "category": "data-display",
+      "status": "stable",
+      "purpose": "Body section of a table that groups data rows and establishes the body section context for nested rows.",
+      "tags": ["table", "section"],
+      "useWhen": ["Wrapping the data rows of a table to distinguish them from header rows."],
+      "avoidWhen": ["Wrapping header rows — use table-header instead."],
+      "related": ["table", "table-row"],
+      "hasConstraints": false,
+      "hasExamples": false,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/table-body/schema",
+        "variables": "@lostgradient/cinder/table-body/variables"
+      }
+    },
+    {
+      "name": "TableCell",
+      "id": "table-cell",
+      "import": "@lostgradient/cinder/table-cell",
+      "exportName": "TableCell",
+      "category": "data-display",
+      "status": "stable",
+      "purpose": "Data cell within a table-row that renders one column value with configurable horizontal alignment.",
+      "tags": ["table", "cell"],
+      "useWhen": [
+        "Rendering a single value inside a body row of a table.",
+        "Aligning numeric or trailing-action columns via the align prop."
+      ],
+      "avoidWhen": ["Rendering a column header — use table-header-cell instead."],
+      "related": ["table-row", "table-header-cell"],
+      "hasConstraints": false,
+      "hasExamples": false,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/table-cell/schema",
+        "variables": "@lostgradient/cinder/table-cell/variables"
+      }
+    },
+    {
+      "name": "TableHeader",
+      "id": "table-header",
+      "import": "@lostgradient/cinder/table-header",
+      "exportName": "TableHeader",
+      "category": "data-display",
+      "status": "stable",
+      "purpose": "Header section of a table that groups column-header rows and exposes selection state to its descendants.",
+      "tags": ["table", "section"],
+      "useWhen": ["Wrapping the column-header row that labels each column of a table."],
+      "avoidWhen": ["Wrapping body data rows — use table-body instead."],
+      "related": ["table", "table-header-cell"],
+      "hasConstraints": false,
+      "hasExamples": false,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/table-header/schema",
+        "variables": "@lostgradient/cinder/table-header/variables"
+      }
+    },
+    {
+      "name": "TableHeaderCell",
+      "id": "table-header-cell",
+      "import": "@lostgradient/cinder/table-header-cell",
+      "exportName": "TableHeaderCell",
+      "category": "data-display",
+      "status": "stable",
+      "purpose": "Column header cell within a table-header that labels a column and optionally triggers sort changes when sortable.",
+      "tags": ["table", "header"],
+      "useWhen": [
+        "Labeling a column inside a table-header row.",
+        "Making a column user-sortable by setting the sortable prop and supplying a column identifier."
+      ],
+      "avoidWhen": ["Rendering a body data cell — use table-cell instead."],
+      "related": ["table-header", "table-cell"],
+      "hasConstraints": false,
+      "hasExamples": false,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/table-header-cell/schema",
+        "variables": "@lostgradient/cinder/table-header-cell/variables"
+      }
+    },
+    {
+      "name": "TableRow",
+      "id": "table-row",
+      "import": "@lostgradient/cinder/table-row",
+      "exportName": "TableRow",
+      "category": "data-display",
+      "status": "stable",
+      "purpose": "Row within a table that groups header or body cells and participates in row-selection state when configured.",
+      "tags": ["table", "row"],
+      "useWhen": [
+        "Grouping table-cell or table-header-cell children into a single horizontal record.",
+        "Wiring per-row selection by passing the selection prop in a selectable table."
+      ],
+      "avoidWhen": ["Standing alone outside a table — it requires the table section context."],
+      "related": ["table-body", "table-cell"],
+      "hasConstraints": false,
+      "hasExamples": false,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/table-row/schema",
+        "variables": "@lostgradient/cinder/table-row/variables"
+      }
+    },
+    {
+      "name": "Tabs",
+      "id": "tabs",
+      "import": "@lostgradient/cinder/tabs",
+      "exportName": "Tabs",
+      "category": "navigation",
+      "status": "stable",
+      "purpose": "Root tabs composite that owns the active value and orientation and coordinates tab, tab-list, and tab-panel descendants via context.",
+      "tags": ["navigation", "tabs"],
+      "useWhen": [
+        "Switching between several panels of related content under one heading area.",
+        "Building the WAI-ARIA tabs pattern with shared keyboard navigation and activation rules."
+      ],
+      "avoidWhen": [
+        "Picking one of two to five short values inline — use segmented-control instead.",
+        "Showing ordered progress through a wizard — use steps instead."
+      ],
+      "related": ["tab", "tab-list", "tab-panel", "segmented-control"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/tabs/schema",
+        "variables": "@lostgradient/cinder/tabs/variables",
+        "examples": "@lostgradient/cinder/tabs/examples"
+      }
+    },
+    {
+      "name": "TagInput",
+      "id": "tag-input",
+      "import": "@lostgradient/cinder/tag-input",
+      "exportName": "TagInput",
+      "category": "form",
+      "status": "stable",
+      "purpose": "Free-form token entry field that turns committed text into removable tags while keeping native input, form, and accessibility wiring intact.",
+      "tags": ["form", "tags"],
+      "useWhen": [
+        "Collecting zero or more short free-form values such as labels, emails, or technologies.",
+        "Letting users review and remove committed values inline before submitting a form."
+      ],
+      "avoidWhen": [
+        "Users must choose from a fixed option list — use combobox instead.",
+        "The value is a single free-form string rather than a list — use input instead."
+      ],
+      "related": ["combobox", "chip", "form-field", "input"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/tag-input/schema",
+        "variables": "@lostgradient/cinder/tag-input/variables",
+        "examples": "@lostgradient/cinder/tag-input/examples"
+      }
+    },
+    {
+      "name": "Textarea",
+      "id": "textarea",
+      "import": "@lostgradient/cinder/textarea",
+      "exportName": "Textarea",
+      "category": "form",
+      "status": "stable",
+      "purpose": "Multi-line text input with label, description, and error wiring plus an optional live character counter against maxlength.",
+      "tags": ["form", "field"],
+      "useWhen": [
+        "Collecting multi-line prose such as comments, descriptions, or messages.",
+        "Surfacing a remaining-character counter as the user types against a maxlength."
+      ],
+      "avoidWhen": ["Collecting a single short line of text — use input instead."],
+      "related": ["input", "markdown-editor"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/textarea/schema",
+        "variables": "@lostgradient/cinder/textarea/variables",
+        "examples": "@lostgradient/cinder/textarea/examples"
+      }
+    },
+    {
+      "name": "Timeline",
+      "id": "timeline",
+      "import": "@lostgradient/cinder/timeline",
+      "exportName": "Timeline",
+      "category": "data-display",
+      "status": "stable",
+      "purpose": "Timestamp-first event rail that renders workflow, audit, or run-history entries with grouping, tone markers, and connector continuity.",
+      "tags": ["timeline", "history", "events"],
+      "useWhen": [
+        "Visualizing an ordered sequence of dated events with a temporal rail, timestamp labels, grouping headers, and marker tones.",
+        "Displaying workflow steps, audit logs, or run histories where each entry needs connector continuity or gap breaks."
+      ],
+      "avoidWhen": [
+        "Surfacing a real-time social or activity stream — feed is the higher-affordance composition.",
+        "Guiding users through a numbered procedural flow — steps conveys progress more clearly."
+      ],
+      "related": ["timeline-item", "feed", "steps"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/timeline/schema",
+        "variables": "@lostgradient/cinder/timeline/variables",
+        "examples": "@lostgradient/cinder/timeline/examples"
+      }
+    },
+    {
+      "name": "TimelineItem",
+      "id": "timeline-item",
+      "import": "@lostgradient/cinder/timeline-item",
+      "exportName": "TimelineItem",
+      "category": "data-display",
+      "status": "stable",
+      "purpose": "Single event inside a timeline rail with a decorative tone marker, timestamp-first header, optional group header, and body content.",
+      "tags": ["timeline", "event"],
+      "useWhen": [
+        "Rendering one event along a timeline rail with consistent marker, header, connector, and body structure.",
+        "Coloring decorative markers by tone (info, success, warning, error) while keeping the meaningful status in title or content."
+      ],
+      "avoidWhen": [
+        "The entry lives in a social activity stream rather than a workflow rail — feed-event fits better."
+      ],
+      "related": ["timeline", "feed-event"],
+      "hasConstraints": false,
+      "hasExamples": false,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/timeline-item/schema",
+        "variables": "@lostgradient/cinder/timeline-item/variables"
+      }
+    },
+    {
+      "name": "ToastRegion",
+      "id": "toast-region",
+      "import": "@lostgradient/cinder/toast-region",
+      "exportName": "ToastRegion",
+      "category": "feedback",
+      "status": "stable",
+      "purpose": "Provider region that hosts polite and assertive toast stacks and exposes an imperative show/dismiss API via context.",
+      "tags": ["feedback", "toast"],
+      "useWhen": [
+        "Surfacing transient, non-blocking confirmations or errors that auto-dismiss after a short duration.",
+        "Announcing the outcome of a background action that the user does not need to acknowledge."
+      ],
+      "avoidWhen": [
+        "Communicating a persistent page-level message — use banner so it stays until dismissed.",
+        "Reporting an urgent error that must remain on screen — use alert."
+      ],
+      "related": ["alert", "banner"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/toast-region/schema",
+        "variables": "@lostgradient/cinder/toast-region/variables",
+        "examples": "@lostgradient/cinder/toast-region/examples"
+      }
+    },
+    {
+      "name": "Toggle",
+      "id": "toggle",
+      "import": "@lostgradient/cinder/toggle",
+      "exportName": "Toggle",
+      "category": "form",
+      "status": "stable",
+      "purpose": "Sliding switch implementing the WAI-ARIA switch pattern for a single on or off setting that applies immediately.",
+      "tags": ["form", "switch"],
+      "useWhen": [
+        "Flipping a single setting on or off with immediate effect such as notifications or dark mode."
+      ],
+      "avoidWhen": [
+        "Picking one option from a small fixed set — use segmented-control instead.",
+        "Collecting a deferred boolean (agreement, opt-in) in a Submit-style form — a switch implies immediate effect; use checkbox instead."
+      ],
+      "related": ["checkbox", "segmented-control"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/toggle/schema",
+        "variables": "@lostgradient/cinder/toggle/variables",
+        "examples": "@lostgradient/cinder/toggle/examples"
+      }
+    },
+    {
+      "name": "Toolbar",
+      "id": "toolbar",
+      "import": "@lostgradient/cinder/toolbar",
+      "exportName": "Toolbar",
+      "category": "action",
+      "status": "stable",
+      "purpose": "Named grouping of related controls that implements the WAI-ARIA toolbar pattern with DOM-driven roving tabindex.",
+      "tags": ["action", "grouping"],
+      "useWhen": [
+        "Rendering a row or column of related controls where the whole set should be one Tab stop and arrow keys should move between items.",
+        "Wrapping existing cinder controls such as Button, SegmentedControl, and NumberInput without adding toolbar-specific child APIs."
+      ],
+      "avoidWhen": [
+        "Building a static flex row of controls that should remain in ordinary Tab order — use inline, cluster, or button-group instead."
+      ],
+      "related": ["button-group", "segmented-control", "number-input"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/toolbar/schema",
+        "variables": "@lostgradient/cinder/toolbar/variables",
+        "examples": "@lostgradient/cinder/toolbar/examples"
+      }
+    },
+    {
+      "name": "Tooltip",
+      "id": "tooltip",
+      "import": "@lostgradient/cinder/tooltip",
+      "exportName": "Tooltip",
+      "category": "overlay",
+      "status": "stable",
+      "purpose": "Hover-and-focus triggered descriptive hint anchored to a focusable child element, wired through aria-describedby.",
+      "tags": ["overlay", "hint"],
+      "useWhen": [
+        "Showing a short non-interactive label or description for an icon-only button or terse control.",
+        "Supplementing a control with a hint that should appear on hover or keyboard focus and dismiss on Escape."
+      ],
+      "avoidWhen": [
+        "Hosting interactive content or focusable controls — use popover instead, since tooltip content is not reachable.",
+        "Communicating the only accessible name for a control — use aria-label or visible text rather than tooltip text."
+      ],
+      "related": ["popover"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/tooltip/schema",
+        "variables": "@lostgradient/cinder/tooltip/variables",
+        "examples": "@lostgradient/cinder/tooltip/examples"
+      }
+    },
+    {
+      "name": "Tree",
+      "id": "tree",
+      "import": "@lostgradient/cinder/tree",
+      "exportName": "Tree",
+      "category": "data-display",
+      "status": "stable",
+      "purpose": "Composite root that renders a hierarchical tree of tree-item nodes with keyboard navigation and selection state.",
+      "tags": ["tree", "hierarchy"],
+      "useWhen": [
+        "Presenting hierarchical data such as a file system, organization, or nested categories.",
+        "Coordinating single- or multi-select state across all descendant tree-items via the selectionMode prop."
+      ],
+      "avoidWhen": [
+        "Disclosing flat sibling sections — use accordion instead.",
+        "Switching between sibling views of the same region — use tabs instead."
+      ],
+      "related": ["tree-item", "accordion"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/tree/schema",
+        "variables": "@lostgradient/cinder/tree/variables",
+        "examples": "@lostgradient/cinder/tree/examples"
+      }
+    },
+    {
+      "name": "TreeItem",
+      "id": "tree-item",
+      "import": "@lostgradient/cinder/tree-item",
+      "exportName": "TreeItem",
+      "category": "data-display",
+      "status": "stable",
+      "purpose": "Node within a tree that exposes a label, optional children, and expand and selection state through the tree context.",
+      "tags": ["tree", "node"],
+      "useWhen": [
+        "Rendering a single branch or leaf inside a tree parent.",
+        "Nesting further tree-items as children to form a hierarchy."
+      ],
+      "avoidWhen": ["Standing alone outside a tree — it requires the tree context and registry."],
+      "related": ["tree"],
+      "hasConstraints": false,
+      "hasExamples": false,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/tree-item/schema",
+        "variables": "@lostgradient/cinder/tree-item/variables"
+      }
+    },
+    {
+      "name": "Typography",
+      "id": "typography",
+      "import": "@lostgradient/cinder/typography",
+      "exportName": "Typography",
+      "category": "typography",
+      "status": "beta",
+      "purpose": "Renders text with a named typographic variant mapped to the design token scale.",
+      "tags": ["typography", "text"],
+      "useWhen": [
+        "Applying a named typographic style (heading, body, caption) with semantic HTML."
+      ],
+      "avoidWhen": ["Rendering inline text inside a paragraph — use a plain <span> with CSS."],
+      "related": ["label", "kbd"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/typography/schema",
+        "variables": "@lostgradient/cinder/typography/variables",
+        "examples": "@lostgradient/cinder/typography/examples"
+      }
+    },
+    {
+      "name": "VisuallyHidden",
+      "id": "visually-hidden",
+      "import": "@lostgradient/cinder/visually-hidden",
+      "exportName": "VisuallyHidden",
+      "category": "typography",
+      "status": "stable",
+      "purpose": "Utility primitive that hides content visually while keeping it available to assistive technology, with an optional focusable mode for skip links.",
+      "tags": ["typography", "accessibility"],
+      "useWhen": [
+        "Exposing label or helper text only to screen readers without affecting the visual layout.",
+        "Implementing a skip-to-content link that appears on keyboard focus."
+      ],
+      "avoidWhen": [
+        "Hiding content from everyone — use the hidden attribute or display none instead.",
+        "Labelling a form control where a visible label is acceptable — use label directly."
+      ],
+      "related": ["label"],
+      "hasConstraints": false,
+      "hasExamples": true,
+      "artifacts": {
+        "schema": "@lostgradient/cinder/visually-hidden/schema",
+        "variables": "@lostgradient/cinder/visually-hidden/variables",
+        "examples": "@lostgradient/cinder/visually-hidden/examples"
+      }
+    }
+  ]
+}