@lostgradient/cinder 0.5.0 → 0.6.0

package/src/components/chat/chat.schema.json

@@ -0,0 +1,250 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "id": {
+      "type": "string",
+      "description": "Unique identifier used to scope accessibility attributes across the chat surface."
+    },
+    "atBottom": {
+      "type": "boolean",
+      "description": "Whether the message viewport is scrolled to the bottom. Bindable; updated automatically as the user scrolls. Default `true`."
+    },
+    "unreadCount": {
+      "type": "number",
+      "description": "Number of messages received while the viewport was scrolled away from the bottom. Bindable; resets to `0` when the user scrolls to the bottom. Default `0`."
+    },
+    "newMessageIndicatorVisible": {
+      "type": "boolean",
+      "description": "Whether the \"new messages\" indicator is currently visible above the composer. Bindable; cleared automatically when the viewport reaches the bottom. Default `false`."
+    },
+    "class": {
+      "type": "string",
+      "description": "Additional class name merged onto the `.chat-container` root element."
+    },
+    "surfaceMode": {
+      "enum": ["default", "transparent"],
+      "description": "Controls the background of the chat surface. Use `'transparent'` to inherit the host element's background when embedding chat inside a card or panel. Default `'default'`."
+    },
+    "density": {
+      "enum": ["comfortable", "compact"],
+      "description": "Controls spacing density of the message timeline.\n- `'comfortable'` (default): standard padding and gap.\n- `'compact'`: tighter spacing for data-dense contexts (e.g., embedded panels).\n  Action buttons keep `min-height: var(--cinder-touch-target-min)` regardless."
+    },
+    "variant": {
+      "enum": ["bubble", "flat"],
+      "description": "Visual treatment for message bubbles.\n- `'bubble'` (default): colored backgrounds differentiate user from assistant.\n- `'flat'`: no bubble backgrounds; role is communicated via alignment and role label.\n  Text-on-surface contrast meets WCAG AA via `--cinder-text` on `--cinder-surface-inset`."
+    },
+    "bottomThreshold": {
+      "type": "number",
+      "description": "Distance in pixels from the bottom of the scroll viewport within which the chat is considered \"at bottom\" and will auto-scroll on new messages. Default `150`."
+    },
+    "jumpThreshold": {
+      "type": "number",
+      "description": "Distance in pixels scrolled up from the bottom required before the jump-to-latest button appears. Must be greater than `bottomThreshold` to prevent button flickering. Default `200`."
+    },
+    "streaming": {
+      "type": "boolean",
+      "description": "Whether a streaming response is currently in progress. When `true`, the composer is disabled and a stop-generating button is shown. Default `false`."
+    },
+    "streamingStatus": {
+      "type": "string",
+      "description": "Optional status label displayed in the typing indicator while `streaming` is `true` and no streaming content has arrived yet (e.g. `\"Thinking…\"` or `\"Analyzing file…\"`). When omitted, three animated dots are shown."
+    },
+    "virtualized": {
+      "type": "boolean",
+      "description": "Use the virtualized message render path for long transcripts. The complete `ConversationHistory` remains unchanged; only the DOM window is reduced. Default `false`."
+    },
+    "virtualizationEstimatedRowHeight": {
+      "type": "number",
+      "description": "Estimated row height in pixels for virtualized message rows. Default `88`."
+    },
+    "virtualizationOverscan": {
+      "type": "number",
+      "description": "Number of extra virtual rows rendered before and after the viewport. Default `3`."
+    },
+    "virtualizationInitialHeight": {
+      "type": "number",
+      "description": "Initial virtualized viewport height used before measurement. Default `640`."
+    },
+    "moreHistoryAvailable": {
+      "type": "boolean",
+      "description": "Whether the explicit \"Load earlier messages\" trigger is shown when a load handler exists. Default `true`."
+    },
+    "loadEarlierLabel": {
+      "type": "string",
+      "description": "Label for the history pagination trigger. Default `\"Load earlier messages\"`."
+    },
+    "loadingEarlierLabel": {
+      "type": "string",
+      "description": "Status text while older messages are loading. Default `\"Loading earlier messages\"`."
+    },
+    "emptyPrompts": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "List of suggested starter prompt strings shown as clickable buttons in the default empty state. Clicking a prompt submits it immediately as a user message. Has no effect when a custom `empty` snippet is provided."
+    }
+  },
+  "additionalProperties": false,
+  "required": ["id"],
+  "metadata": {
+    "unsupportedProps": [
+      {
+        "name": "adapter",
+        "reason": "unknown-shape",
+        "description": "Optional command/transport boundary around `conversation`. Its methods take\nprecedence over the matching callback props (e.g. `sendMessage` over\n`onsubmit`); omit it and Chat behaves exactly as with plain callbacks."
+      },
+      {
+        "name": "capabilities",
+        "reason": "unknown-shape",
+        "description": "Feature-capability flags. Pass a `ChatCapabilities` object to enable or disable\nindividual Chat features (attachments, search, copy, editing, retry) as a group\nrather than as five separate boolean props."
+      },
+      {
+        "name": "conversation",
+        "reason": "unknown-shape",
+        "required": true,
+        "description": "The conversation transcript to render. Pass a {@link ConversationHistory}\nsnapshot; consumers holding a stateful conversation object pass its current\nsnapshot (e.g. `conversation.current`)."
+      },
+      {
+        "name": "empty",
+        "reason": "function-or-snippet"
+      },
+      {
+        "name": "header",
+        "reason": "function-or-snippet"
+      },
+      {
+        "name": "messageActions",
+        "reason": "function-or-snippet"
+      },
+      {
+        "name": "messagePart",
+        "reason": "function-or-snippet",
+        "description": "Per-message-part override. Replaces the rendering of an individual body part\n(markdown, tool call, tool result) while delegating the rest to the built-ins\nvia the `renderDefault` snippet it receives. Image parts are excluded — they\nrender through the grouped attachment grid, not this override."
+      },
+      {
+        "name": "messageReasoning",
+        "reason": "function-or-snippet",
+        "description": "Override or supplement the reasoning text for a message. Called per-message;\nreturn a non-empty string to show a reasoning block, `undefined` to fall back\nto `message.metadata['cinder:reasoning']`, empty string to suppress reasoning."
+      },
+      {
+        "name": "messageStatus",
+        "reason": "function-or-snippet"
+      },
+      {
+        "name": "messageSteps",
+        "reason": "function-or-snippet",
+        "description": "Override or supplement the step list for a message. Called per-message;\nreturn an array to show step indicators, `undefined` to fall back to\n`message.metadata['cinder:steps']`. An empty array suppresses steps."
+      },
+      {
+        "name": "messageSuggestions",
+        "reason": "function-or-snippet",
+        "description": "Override or supplement the suggestion list for a message. Called\nper-message; return an array of label strings to show suggestion chips,\n`undefined` to fall back to `message.metadata['cinder:suggestions']`. An\nempty array suppresses suggestions."
+      },
+      {
+        "name": "onadaptererror",
+        "reason": "function-or-snippet",
+        "description": "Called when an adapter command fails — either a rejected promise or a synchronous throw from the method."
+      },
+      {
+        "name": "onapprove",
+        "reason": "function-or-snippet",
+        "description": "Called when the user approves an action-required tool call. The\nconsumer is responsible for updating its transcript (e.g. calling\nconversationalist to unblock the pending tool) and triggering a new\ngeneration. When an adapter is also wired, Chat calls\n`adapter.approveToolCall(toolCallId)` first and then this callback."
+      },
+      {
+        "name": "onattachmentadd",
+        "reason": "function-or-snippet"
+      },
+      {
+        "name": "onattachmentfailure",
+        "reason": "function-or-snippet"
+      },
+      {
+        "name": "onattachmentremove",
+        "reason": "function-or-snippet"
+      },
+      {
+        "name": "ondeny",
+        "reason": "function-or-snippet",
+        "description": "Called when the user denies an action-required tool call. When an\nadapter is also wired, Chat calls `adapter.denyToolCall(toolCallId)` first\nand then this callback."
+      },
+      {
+        "name": "onedit",
+        "reason": "function-or-snippet"
+      },
+      {
+        "name": "onexpandedchange",
+        "reason": "function-or-snippet"
+      },
+      {
+        "name": "onjumptolatest",
+        "reason": "function-or-snippet"
+      },
+      {
+        "name": "onloadhistory",
+        "reason": "function-or-snippet",
+        "description": "Called when the explicit history trigger is activated. The consumer prepends compatible messages into `conversation`."
+      },
+      {
+        "name": "onpushmessage",
+        "reason": "function-or-snippet",
+        "description": "Forwarded from the adapter's real-time `onMessage` push (consumer owns the transcript)."
+      },
+      {
+        "name": "onreadreceipt",
+        "reason": "function-or-snippet",
+        "description": "Forwarded from the adapter's real-time `onReadReceipt` push."
+      },
+      {
+        "name": "onretry",
+        "reason": "function-or-snippet"
+      },
+      {
+        "name": "onscrollstatechange",
+        "reason": "function-or-snippet"
+      },
+      {
+        "name": "onstopgenerating",
+        "reason": "function-or-snippet"
+      },
+      {
+        "name": "onsubmit",
+        "reason": "function-or-snippet"
+      },
+      {
+        "name": "onsuggestionselect",
+        "reason": "function-or-snippet",
+        "description": "Called when the user selects a suggestion chip. The label string is\npassed back. The consumer is responsible for submitting it as a new user\nmessage."
+      },
+      {
+        "name": "ontypingchange",
+        "reason": "function-or-snippet",
+        "description": "Forwarded from the adapter's real-time `onTypingChange` push."
+      },
+      {
+        "name": "onunreadindicatorchange",
+        "reason": "function-or-snippet"
+      },
+      {
+        "name": "readReceipts",
+        "reason": "unknown-shape",
+        "description": "Per-message read receipt state. Out-of-band UI state — NOT stored on `Message`.\nPass a `Map` keyed by message id with a {@link ReadReceipt} value; the\ncomponent renders a receipt badge on USER messages only. The adapter's\n`onReadReceipt` push handler populates the same state when an adapter is wired.\nDefault `undefined` (no receipts shown)."
+      },
+      {
+        "name": "row",
+        "reason": "function-or-snippet",
+        "description": "Full-row override. Renders an entire message row; receives the message and\na `renderDefault` snippet for the built-in row (inversion of control), so a\nconsumer can wrap or fully replace specific rows."
+      },
+      {
+        "name": "typingParticipants",
+        "reason": "unknown-shape",
+        "description": "Participants who are currently typing. Out-of-band UI state — NOT stored on\n`Message`. Pass an array of {@link TypingParticipant} objects; the component\nrenders a per-participant typing indicator above the input. The adapter's\n`onTypingChange` push handler feeds the same indicator when an adapter is\nwired. Default `undefined` (indicator hidden)."
+      },
+      {
+        "name": "viewportAttachment",
+        "reason": "function-or-snippet"
+      }
+    ]
+  }
+}

package/src/components/chat/chat.variables.json

@@ -0,0 +1 @@
+[]

package/src/components/chat-conversation-header/chat-conversation-header.schema.json

@@ -0,0 +1,34 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "headingLevel": {
+      "enum": [2, 3, 4],
+      "description": "Heading level for the conversation title. Default `2`."
+    },
+    "showExportActions": {
+      "type": "boolean",
+      "description": "Whether to render the built-in conversation export actions. Default `true`."
+    },
+    "class": {
+      "type": "string",
+      "description": "Additional class name merged with `.cinder-chat-conversation-header`."
+    }
+  },
+  "additionalProperties": false,
+  "metadata": {
+    "unsupportedProps": [
+      {
+        "name": "actions",
+        "reason": "function-or-snippet",
+        "description": "Additional action controls rendered after the built-in export actions."
+      },
+      {
+        "name": "conversation",
+        "reason": "unknown-shape",
+        "required": true,
+        "description": "Active compatible conversation snapshot."
+      }
+    ]
+  }
+}

package/src/components/chat-conversation-header/chat-conversation-header.variables.json

@@ -0,0 +1 @@
+[]

package/src/components/chat-conversation-list/chat-conversation-list.schema.json

@@ -0,0 +1,45 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "activeConversationId": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "description": "Currently active conversation id."
+    },
+    "ariaLabel": {
+      "type": "string",
+      "description": "Accessible name for the conversations navigation landmark. Default `\"Conversations\"`."
+    },
+    "emptyText": {
+      "type": "string",
+      "description": "Empty state text when no conversations are present. Default `\"No conversations\"`."
+    },
+    "class": {
+      "type": "string",
+      "description": "Additional class name merged with `.cinder-chat-conversation-list`."
+    }
+  },
+  "additionalProperties": false,
+  "metadata": {
+    "unsupportedProps": [
+      {
+        "name": "conversations",
+        "reason": "unknown-shape",
+        "required": true,
+        "description": "Conversation summaries to render. Sorts by latest message/update time descending."
+      },
+      {
+        "name": "onselectconversation",
+        "reason": "function-or-snippet",
+        "description": "Called when a conversation is selected."
+      }
+    ]
+  }
+}

package/src/components/chat-conversation-list/chat-conversation-list.variables.json

@@ -0,0 +1 @@
+[]

package/src/components/checkbox/checkbox.examples.json

@@ -15,6 +15,12 @@
       "description": "Disabled state for both unchecked and checked checkboxes.",
       "code": "<script lang=\"ts\">\n  import { Checkbox } from '@lostgradient/cinder/checkbox';\n</script>\n\n<div style=\"display: flex; flex-direction: column; gap: 0.75rem;\">\n  <Checkbox id=\"checkbox-disabled-off\" label=\"Disabled, unchecked\" disabled />\n  <Checkbox id=\"checkbox-disabled-on\" label=\"Disabled, checked\" disabled checked />\n</div>\n"
     },
+    {
+      "id": "external-row-label",
+      "title": "External row label",
+      "description": "A control-only checkbox associated with a rich row label.",
+      "code": "<script lang=\"ts\">\n  import { Checkbox } from '@lostgradient/cinder/checkbox';\n\n  let selected = $state(false);\n</script>\n\n<div\n  style=\"display: grid; grid-template-columns: auto 1fr; align-items: start; gap: 0.75rem; max-width: 26rem;\"\n>\n  <Checkbox id=\"repository-main\" fieldClass=\"repository-checkbox\" bind:checked={selected} />\n  <label\n    for=\"repository-main\"\n    style=\"display: flex; justify-content: space-between; gap: 1rem; cursor: pointer;\"\n  >\n    <span style=\"display: flex; flex-direction: column; gap: 0.125rem;\">\n      <strong>lostgradient/cinder</strong>\n      <span style=\"color: var(--cinder-text-muted);\">Component library</span>\n    </span>\n    <span\n      style=\"align-self: start; border: 1px solid var(--cinder-border); border-radius: var(--cinder-radius-sm); padding: 0.125rem 0.375rem; font-size: var(--cinder-text-xs);\"\n    >\n      Public\n    </span>\n  </label>\n</div>\n"
+    },
     {
       "id": "indeterminate",
       "title": "Indeterminate checkbox",

package/src/components/checkbox/checkbox.schema.json

@@ -0,0 +1,53 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "checked": {
+      "type": "boolean",
+      "description": "Bound checked state."
+    },
+    "disabled": {
+      "type": "boolean",
+      "description": "Disables the checkbox."
+    },
+    "indeterminate": {
+      "type": "boolean",
+      "description": "Bound indeterminate state. Mutually exclusive with `checked` visually."
+    },
+    "id": {
+      "type": "string",
+      "description": "Unique identifier for label association and ARIA wiring. Optional: when omitted,\na stable id is generated via `$props.id()` (or inherited from a FormField context),\nmatching Input/Autocomplete. Provide it when you need a known id to reference."
+    },
+    "label": {
+      "type": "string",
+      "description": "Visible label rendered in a `<label>` element associated via `for`."
+    },
+    "description": {
+      "type": "string",
+      "description": "Helper text displayed below the checkbox; wired via `aria-describedby`."
+    },
+    "error": {
+      "type": "string",
+      "description": "Validation error message; sets `aria-invalid=\"true\"` and `aria-describedby`."
+    },
+    "fieldClass": {
+      "type": "string",
+      "description": "Extra class names merged with the outer checkbox field wrapper."
+    }
+  },
+  "additionalProperties": false,
+  "metadata": {
+    "unsupportedProps": [
+      {
+        "name": "class",
+        "reason": "unknown-shape",
+        "description": "Extra class names merged with `.cinder-checkbox`."
+      },
+      {
+        "name": "onValueChange",
+        "reason": "function-or-snippet",
+        "description": "Intercept a proposed checked state before the bindable value is written. Return a replacement value to transform it."
+      }
+    ]
+  }
+}

package/src/components/checkbox/checkbox.variables.json

@@ -0,0 +1 @@
+[]

package/src/components/checkbox-group/checkbox-group.schema.json

@@ -0,0 +1,45 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "label": {
+      "type": "string",
+      "description": "Visible group caption. Rendered as a `<legend>` inside the `<fieldset>`.\nNamed `label` for consistency with every other form control — the element\nis a `<legend>` because the group is a fieldset."
+    },
+    "description": {
+      "type": "string",
+      "description": "Helper text below the group; wired via `aria-describedby` on the fieldset."
+    },
+    "error": {
+      "type": "string",
+      "description": "Group-level validation message. Rendered as a polite live region and\nreferenced by the fieldset's `aria-describedby`. Also sets\n`aria-invalid=\"true\"` on the fieldset itself as a supplementary signal.\n\nNote: fieldset-level `aria-describedby` is not reliably re-announced as\nfocus moves between descendants. This is best-effort supplemental context\n— if a specific control must announce as invalid on focus, pass `error`\nto that `<Checkbox>` directly."
+    },
+    "disabled": {
+      "type": "boolean",
+      "description": "Disables every native form control inside via the fieldset's built-in\ncascade. Renders as the native `disabled` attribute on `<fieldset>`."
+    },
+    "required": {
+      "type": "boolean",
+      "description": "Marks the group required: sets `aria-required=\"true\"` and\n`data-cinder-required` on the fieldset and renders the required asterisk in\nthe legend.\n\nIt does NOT set `required` on any child `<input>` and does NOT enforce\nnative constraint validation. Per-control `required` must be set on the\nindividual `<Checkbox>`."
+    },
+    "variant": {
+      "enum": ["default", "card"],
+      "description": "Layout variant. `'default'` is a stacked column. `'card'` styles each\ndirect child `.cinder-checkbox-field` as a bordered card row.\n\nAlways emitted as `data-variant` on the fieldset. Card variant assumes\neach direct child of the items container is a single `<Checkbox>`."
+    },
+    "class": {
+      "type": "string",
+      "description": "Additional class names merged with `.cinder-checkbox-group`."
+    }
+  },
+  "additionalProperties": false,
+  "metadata": {
+    "unsupportedProps": [
+      {
+        "name": "children",
+        "reason": "function-or-snippet",
+        "required": true,
+        "description": "Checkbox children."
+      }
+    ]
+  }
+}

package/src/components/checkbox-group/checkbox-group.variables.json

@@ -0,0 +1 @@
+[]

package/src/components/chip/chip.schema.json

@@ -0,0 +1,60 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "mode": {
+      "enum": ["display", "toggle", "removable"],
+      "description": "Rendering and interaction mode. Default `\"display\"`."
+    },
+    "label": {
+      "type": "string",
+      "description": "Visible text content of the chip."
+    },
+    "variant": {
+      "enum": ["neutral", "success", "warning", "danger", "info", "accent"],
+      "description": "Color variant applied to the chip. Default `\"neutral\"`."
+    },
+    "size": {
+      "enum": ["sm", "md"],
+      "description": "Size of the chip. Default `\"md\"`."
+    },
+    "density": {
+      "const": "toolbar",
+      "description": "When set to `\"toolbar\"`, opts the chip into compact toolbar sizing to align with sibling toolbar controls."
+    },
+    "class": {
+      "type": "string",
+      "description": "Additional class names merged onto the chip element."
+    },
+    "pressed": {
+      "type": "boolean",
+      "description": "Toggle mode only. Whether the chip is currently in the pressed (selected) state. Reflected as `aria-pressed`."
+    },
+    "disabled": {
+      "type": "boolean",
+      "description": "Toggle mode only. When true, disables the toggle button and prevents interaction."
+    },
+    "removeAriaLabel": {
+      "type": "string",
+      "description": "Removable mode only. Accessible label for the remove button. Defaults to `Remove` followed by the chip's `label`."
+    }
+  },
+  "additionalProperties": false,
+  "required": ["label"],
+  "metadata": {
+    "unsupportedProps": [
+      {
+        "name": "leadingIcon",
+        "reason": "function-or-snippet"
+      },
+      {
+        "name": "onpressedchange",
+        "reason": "function-or-snippet"
+      },
+      {
+        "name": "onremove",
+        "reason": "function-or-snippet"
+      }
+    ]
+  }
+}

package/src/components/chip/chip.variables.json

@@ -0,0 +1 @@
+[]

package/src/components/choice-grid/choice-grid.schema.json

@@ -0,0 +1,64 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "value": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "description": "The currently selected value (single-select mode). Bindable.\nPass `null` or omit to start with no selection."
+    },
+    "values": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Currently selected values (multi-select mode). Bindable. Only used when\n`multiple` is `true` — set `multiple` explicitly to switch modes; binding\n`values` alone does NOT enable multi-select."
+    },
+    "multiple": {
+      "type": "boolean",
+      "description": "When true the grid allows multiple simultaneous selections and reads/writes\n`values` instead of `value`. The ARIA role switches to `group` (items become\n`checkbox`); single-select uses `radiogroup` (items become `radio`)."
+    },
+    "columns": {
+      "enum": ["responsive", 1, 2, 3, 4],
+      "description": "Column layout.\n- `'responsive'` — `auto-fill` at a minimum cell width (default).\n- `1 | 2 | 3 | 4` — fixed number of columns."
+    },
+    "minColumnWidth": {
+      "type": "string",
+      "description": "Minimum cell width for `columns=\"responsive\"`. Accepts any CSS\n`<length>` (e.g. `\"12rem\"`, `\"200px\"`). Default: `\"10rem\"`."
+    },
+    "ariaLabel": {
+      "type": "string",
+      "description": "Accessible label for the grid (required unless `ariaLabelledby` is set)."
+    },
+    "ariaLabelledby": {
+      "type": "string",
+      "description": "Id of an external element that labels this grid."
+    },
+    "disabled": {
+      "type": "boolean",
+      "description": "Disables all items in the grid."
+    }
+  },
+  "additionalProperties": false,
+  "metadata": {
+    "unsupportedProps": [
+      {
+        "name": "children",
+        "reason": "function-or-snippet",
+        "required": true,
+        "description": "`ChoiceGridItem` children."
+      },
+      {
+        "name": "class",
+        "reason": "unknown-shape",
+        "description": "Additional class names merged with `.cinder-choice-grid`."
+      }
+    ]
+  }
+}

package/src/components/choice-grid/choice-grid.variables.json

@@ -0,0 +1 @@
+[]

package/src/components/choice-grid-item/choice-grid-item.schema.json

@@ -0,0 +1,34 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "value": {
+      "type": "string",
+      "description": "The value this item represents. Used as the key for selection state,\nroving tabindex registration, and ARIA attributes."
+    },
+    "state": {
+      "enum": ["neutral", "correct", "incorrect", "pending"],
+      "description": "Feedback state for assessment / quiz usage. Defaults to `'neutral'`.\nLayout dimensions do NOT change across states (stable cell sizing guarantee)."
+    },
+    "disabled": {
+      "type": "boolean",
+      "description": "When true this item cannot be selected or focused."
+    },
+    "class": {
+      "type": "string",
+      "description": "Additional class names merged with `.cinder-choice-grid-item`."
+    }
+  },
+  "additionalProperties": false,
+  "required": ["value"],
+  "metadata": {
+    "unsupportedProps": [
+      {
+        "name": "children",
+        "reason": "function-or-snippet",
+        "required": true,
+        "description": "Item content — label text, an icon, or richer markup."
+      }
+    ]
+  }
+}

package/src/components/choice-grid-item/choice-grid-item.variables.json

@@ -0,0 +1 @@
+[]