@c2n/framework-types 0.0.9 → 0.0.11

package/dist/web-types.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://raw.githubusercontent.com/JetBrains/web-types/master/schema/web-types.json",
   "name": "@c2n/framework-types",
-  "version": "0.0.9",
+  "version": "0.0.11",
   "description": "GENERATED by @c2n/framework-types. Do not edit by hand.",
   "description-markup": "markdown",
   "contributions": {
@@ -650,6 +650,77 @@
             ]
           }
         },
+        {
+          "name": "c2-avatar-group",
+          "description": "Responsive stack of `c2-avatar` elements. It observes its rendered width and each avatar's actual size, then hides\nthe avatars that no longer fit and replaces them with a count. The host fills the available inline space up to\n`--c2-avatar-group--max-width`, so it also reacts when its parent becomes narrower.\n\n`@c2n/avatar`",
+          "attributes": [
+            {
+              "name": "max-visible",
+              "description": "Optional hard cap in addition to the automatically calculated responsive limit. Zero means no hard cap.",
+              "default": "0",
+              "value": {
+                "type": "number",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "count-mode",
+              "description": "Whether the overflow indicator shows `+hidden` or the total number of avatars.",
+              "default": "'hidden'",
+              "value": {
+                "type": "AvatarGroupCountMode",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "aria-label",
+              "description": "Accessible name for the group.",
+              "default": "'Avatar group'",
+              "value": {
+                "type": "string",
+                "kind": "expression"
+              }
+            }
+          ],
+          "js": {
+            "properties": [
+              {
+                "name": "maxVisible",
+                "description": "Optional hard cap in addition to the automatically calculated responsive limit. Zero means no hard cap.",
+                "value": {
+                  "type": "number",
+                  "kind": "expression"
+                }
+              },
+              {
+                "name": "countMode",
+                "description": "Whether the overflow indicator shows `+hidden` or the total number of avatars.",
+                "value": {
+                  "type": "AvatarGroupCountMode",
+                  "kind": "expression"
+                }
+              },
+              {
+                "name": "ariaLabel",
+                "description": "Accessible name for the group.",
+                "value": {
+                  "type": "string",
+                  "kind": "expression"
+                }
+              }
+            ],
+            "events": [
+              {
+                "name": "overflow-change",
+                "description": "Fired when resizing changes the visible or hidden counts.",
+                "value": {
+                  "type": "CustomEvent<AvatarGroupOverflowDetail>",
+                  "kind": "expression"
+                }
+              }
+            ]
+          }
+        },
         {
           "name": "c2-badge",
           "description": "Small status label: a tinted pill with text, a number or an icon, or a plain dot. Six `tone`s carry meaning\n(neutral, primary, success, warning, danger, info); each is a pair of CSS variables so a design system can recolour\nthem without touching the markup. Give it a `count` to show a number clamped at `max` (`99+`), or `dot` for a\npresence indicator that can `pulse`. Put an element in the `anchor` slot and the badge pins itself to one of its\ncorners (`placement`), for example a notification count on an icon button; `overlap=\"circular\"` moves it onto the\nedge of a round anchor such as an avatar.\n\n`@c2n/badge`",
@@ -741,6 +812,52 @@
             "events": []
           }
         },
+        {
+          "name": "c2-border-beam",
+          "description": "Decorative overlay that sends one or more soft highlights around the border of its containing block. Place it as\na direct child of a positioned container. The component inherits the container radius and uses a border mask, so\nthe highlight sits on the real border instead of drawing a second, offset outline.\n\n`@c2n/border-beam`",
+          "attributes": [
+            {
+              "name": "count",
+              "description": "Number of beams distributed evenly around the perimeter.",
+              "default": "1",
+              "value": {
+                "type": "number",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "side",
+              "description": "Border followed by the beam. `all` loops around the perimeter; one edge moves forward then backward.",
+              "default": "'all'",
+              "value": {
+                "type": "BorderBeamSide",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "reverse",
+              "description": "Sends the beams around the perimeter in the opposite direction.",
+              "default": "false",
+              "value": {
+                "type": "boolean",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "paused",
+              "description": "Freezes the beams at their current positions.",
+              "default": "false",
+              "value": {
+                "type": "boolean",
+                "kind": "expression"
+              }
+            }
+          ],
+          "js": {
+            "properties": [],
+            "events": []
+          }
+        },
         {
           "name": "c2-breadcrumb",
           "description": "Navigation trail. Every light-DOM child is one item, typically a `c2-link-button` with an `href`, and the last one\nis the current page: it is marked `aria-current=\"page\"` (through `selected` on a link button) and styled as text.\nA separator is drawn between items, a chevron by default or whatever is placed in the `separator` slot. The trail\nstays on one row: when the items do not fit the available width, some collapse behind an ellipsis, in priority\norder: the current page is always shown, then the first item, then the items closest to the current page while room\nremains. `max-items` caps how many are shown even when there is room. Clicking the ellipsis reveals every item\n(wrapping if needed).\n\n`@c2n/breadcrumb`",
@@ -4794,6 +4911,226 @@
             ]
           }
         },
+        {
+          "name": "c2-code-editor",
+          "description": "Source-code field built on CodeMirror 6, which is an **optional peer dependency**: nothing is imported until an\neditor mounts, and when the peer is absent the element degrades to a plain `<textarea>` carrying the same value,\nthe same events and the same form behaviour — only without highlighting. Install what you need alongside it:\n\n`@c2n/code-editor`",
+          "attributes": [
+            {
+              "name": "value",
+              "description": "The source code. Assigning it replaces the document without losing scroll position or undo history.",
+              "default": "''",
+              "value": {
+                "type": "string",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "language",
+              "description": "Language id: one of `BUILT_IN_LANGUAGES`, anything `languageLoader` resolves, or empty for no highlighting.",
+              "default": "''",
+              "value": {
+                "type": "string",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "name",
+              "description": "Form field name.",
+              "default": "''",
+              "value": {
+                "type": "string",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "label",
+              "description": "Label above the editor, when the `label` slot is empty.",
+              "default": "''",
+              "value": {
+                "type": "string",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "aria-label",
+              "description": "Accessible name when nothing visible labels the editor.",
+              "default": "null",
+              "value": {
+                "type": "string | null",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "placeholder",
+              "description": "Text shown while the document is empty.",
+              "default": "''",
+              "value": {
+                "type": "string",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "readonly",
+              "description": "The document cannot be edited, but is still selectable and focusable.",
+              "default": "false",
+              "value": {
+                "type": "boolean",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "disabled",
+              "description": "Blocks interaction entirely and dims the editor.",
+              "default": "false",
+              "value": {
+                "type": "boolean",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "required",
+              "description": "The form is invalid while the value is empty.",
+              "default": "false",
+              "value": {
+                "type": "boolean",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "line-numbers",
+              "description": "Show the line-number gutter.",
+              "default": "false",
+              "value": {
+                "type": "boolean",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "wrap",
+              "description": "Wrap long lines instead of scrolling horizontally.",
+              "default": "false",
+              "value": {
+                "type": "boolean",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "autocomplete",
+              "description": "Offer completions while typing (identifiers, and whatever the grammar contributes).",
+              "default": "false",
+              "value": {
+                "type": "boolean",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "tab-size",
+              "description": "Width of a tab stop, in characters.",
+              "default": "2",
+              "value": {
+                "type": "number",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "error",
+              "description": "Renders the error styling; `error-text` replaces the supporting text.",
+              "default": "false",
+              "value": {
+                "type": "boolean",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "error-text",
+              "description": "Message shown in place of the supporting text while `error` is set.",
+              "default": "''",
+              "value": {
+                "type": "string",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "help",
+              "description": "Help text under the editor, when the `supporting-text` slot is empty.",
+              "default": "''",
+              "value": {
+                "type": "string",
+                "kind": "expression"
+              }
+            }
+          ],
+          "js": {
+            "properties": [
+              {
+                "name": "ariaLabel",
+                "description": "Accessible name when nothing visible labels the editor.",
+                "value": {
+                  "type": "string | null",
+                  "kind": "expression"
+                }
+              },
+              {
+                "name": "readOnly",
+                "description": "The document cannot be edited, but is still selectable and focusable.",
+                "value": {
+                  "type": "boolean",
+                  "kind": "expression"
+                }
+              },
+              {
+                "name": "lineNumbers",
+                "description": "Show the line-number gutter.",
+                "value": {
+                  "type": "boolean",
+                  "kind": "expression"
+                }
+              },
+              {
+                "name": "tabSize",
+                "description": "Width of a tab stop, in characters.",
+                "value": {
+                  "type": "number",
+                  "kind": "expression"
+                }
+              },
+              {
+                "name": "errorText",
+                "description": "Message shown in place of the supporting text while `error` is set.",
+                "value": {
+                  "type": "string",
+                  "kind": "expression"
+                }
+              }
+            ],
+            "events": [
+              {
+                "name": "ready",
+                "description": "The engine settled, so tests and hosts can wait for it. Does not bubble.",
+                "value": {
+                  "type": "CustomEvent<{ engine: 'codemirror' | 'basic' }>",
+                  "kind": "expression"
+                }
+              },
+              {
+                "name": "input",
+                "description": "The document changed. Fires on every edit.",
+                "value": {
+                  "type": "Event",
+                  "kind": "expression"
+                }
+              },
+              {
+                "name": "change",
+                "description": "The value was committed: the editor lost focus after an edit, as a native control does.",
+                "value": {
+                  "type": "Event",
+                  "kind": "expression"
+                }
+              }
+            ]
+          }
+        },
         {
           "name": "c2-code-viewer",
           "description": "Syntax-highlighted source code powered by shiki. Grammars and themes are loaded on demand into one shared\nhighlighter, so many viewers on a page cost one engine. The raw code renders immediately as plain text (also on the\nserver) and is upgraded in place once highlighted.\n\n`@c2n/code-viewer`",
@@ -5233,6 +5570,287 @@
             ]
           }
         },
+        {
+          "name": "c2-dash-card",
+          "description": "One pane of a `c2-dashboard`. It owns its place in the grid (`col`, `row`, `col-span`, `row-span`), the drag\nhandles on the edges it shares with a neighbour, and the optional expand controls; it draws no surface of its\nown, so put a `c2-card` — or any markup — in the default slot.\n\n`@c2n/dashboard`",
+          "attributes": [
+            {
+              "name": "card-id",
+              "description": "Identifier the grid's `layout` record is keyed by.",
+              "default": "undefined",
+              "value": {
+                "type": "string | undefined",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "col",
+              "description": "1-based column the card starts in.",
+              "default": "1",
+              "value": {
+                "type": "number",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "row",
+              "description": "1-based row the card starts in.",
+              "default": "1",
+              "value": {
+                "type": "number",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "col-span",
+              "description": "Number of columns the card occupies.",
+              "default": "1",
+              "value": {
+                "type": "number",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "row-span",
+              "description": "Number of rows the card occupies.",
+              "default": "1",
+              "value": {
+                "type": "number",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "min-width",
+              "description": "Smallest width in pixels the card accepts; it raises the minimum of every column it covers.",
+              "default": "0",
+              "value": {
+                "type": "number",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "min-height",
+              "description": "Smallest height in pixels the card accepts; it raises the minimum of every row it covers.",
+              "default": "0",
+              "value": {
+                "type": "number",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "resize",
+              "description": "Which edges carry a drag handle.",
+              "default": "'both'",
+              "value": {
+                "type": "DashCardResize",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "expand-width",
+              "description": "Offers a control that expands the card across every column.",
+              "default": "false",
+              "value": {
+                "type": "boolean",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "expand-height",
+              "description": "Offers a control that expands the card across every row.",
+              "default": "false",
+              "value": {
+                "type": "boolean",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "expand-full",
+              "description": "Offers a control that expands the card over the whole grid.",
+              "default": "false",
+              "value": {
+                "type": "boolean",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "expanded",
+              "description": "How far the card is currently expanded. Settable, so an app can expand a card from its own control.",
+              "default": "'none'",
+              "value": {
+                "type": "DashCardExpanded",
+                "kind": "expression"
+              }
+            }
+          ],
+          "js": {
+            "properties": [
+              {
+                "name": "cardId",
+                "description": "Identifier the grid's `layout` record is keyed by.",
+                "value": {
+                  "type": "string | undefined",
+                  "kind": "expression"
+                }
+              },
+              {
+                "name": "colSpan",
+                "description": "Number of columns the card occupies.",
+                "value": {
+                  "type": "number",
+                  "kind": "expression"
+                }
+              },
+              {
+                "name": "rowSpan",
+                "description": "Number of rows the card occupies.",
+                "value": {
+                  "type": "number",
+                  "kind": "expression"
+                }
+              },
+              {
+                "name": "minWidth",
+                "description": "Smallest width in pixels the card accepts; it raises the minimum of every column it covers.",
+                "value": {
+                  "type": "number",
+                  "kind": "expression"
+                }
+              },
+              {
+                "name": "minHeight",
+                "description": "Smallest height in pixels the card accepts; it raises the minimum of every row it covers.",
+                "value": {
+                  "type": "number",
+                  "kind": "expression"
+                }
+              },
+              {
+                "name": "expandWidth",
+                "description": "Offers a control that expands the card across every column.",
+                "value": {
+                  "type": "boolean",
+                  "kind": "expression"
+                }
+              },
+              {
+                "name": "expandHeight",
+                "description": "Offers a control that expands the card across every row.",
+                "value": {
+                  "type": "boolean",
+                  "kind": "expression"
+                }
+              },
+              {
+                "name": "expandFull",
+                "description": "Offers a control that expands the card over the whole grid.",
+                "value": {
+                  "type": "boolean",
+                  "kind": "expression"
+                }
+              }
+            ],
+            "events": [
+              {
+                "name": "expand-change",
+                "description": "The card was expanded or collapsed through one of its own controls. Does not bubble: listen on the element.",
+                "value": {
+                  "type": "CustomEvent<DashCardExpandChangeDetail>",
+                  "kind": "expression"
+                }
+              }
+            ]
+          }
+        },
+        {
+          "name": "c2-dashboard",
+          "description": "Grid of resizable panes. The children are `c2-dash-card` elements, placed by their `col`/`row` attributes; each\none draws drag handles on the edges it shares with a neighbour, and dragging one resizes the whole track, so the\ncards on either side stay aligned. `columns` and `rows` take a track count (`columns=\"3\"` is three equal columns)\nor an explicit track list (`columns=\"320px 1fr\"`); a track is switched to pixels the first time it is dragged, and\nthe `fr` tracks around it give up the space in proportion to their weight, down to the minimums. With a\n`storage-key` the sizes survive a reload.\n\n`@c2n/dashboard`",
+          "attributes": [
+            {
+              "name": "columns",
+              "description": "Column count (`3`) or an explicit track list (`'320px 1fr'`). Each entry must be one simple size.",
+              "default": "2",
+              "value": {
+                "type": "number | string | string[]",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "rows",
+              "description": "Row count (`2`) or an explicit track list (`'auto 1fr'`).",
+              "default": "1",
+              "value": {
+                "type": "number | string | string[]",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "min-column-width",
+              "description": "Floor for every column, in pixels. A card's own `min-width` raises it for the tracks that card covers.",
+              "default": "50",
+              "value": {
+                "type": "number",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "min-row-height",
+              "description": "Floor for every row, in pixels. A card's own `min-height` raises it for the tracks that card covers.",
+              "default": "50",
+              "value": {
+                "type": "number",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "storage-key",
+              "description": "`localStorage` key the track sizes are stored under. Without it the grid starts from the authored tracks.",
+              "default": "undefined",
+              "value": {
+                "type": "string | undefined",
+                "kind": "expression"
+              }
+            }
+          ],
+          "js": {
+            "properties": [
+              {
+                "name": "minColumnWidth",
+                "description": "Floor for every column, in pixels. A card's own `min-width` raises it for the tracks that card covers.",
+                "value": {
+                  "type": "number",
+                  "kind": "expression"
+                }
+              },
+              {
+                "name": "minRowHeight",
+                "description": "Floor for every row, in pixels. A card's own `min-height` raises it for the tracks that card covers.",
+                "value": {
+                  "type": "number",
+                  "kind": "expression"
+                }
+              },
+              {
+                "name": "storageKey",
+                "description": "`localStorage` key the track sizes are stored under. Without it the grid starts from the authored tracks.",
+                "value": {
+                  "type": "string | undefined",
+                  "kind": "expression"
+                }
+              }
+            ],
+            "events": [
+              {
+                "name": "layout-change",
+                "description": "The track sizes changed and the gesture ended. Does not bubble: listen on the element.",
+                "value": {
+                  "type": "CustomEvent<DashboardLayoutChangeDetail>",
+                  "kind": "expression"
+                }
+              }
+            ]
+          }
+        },
         {
           "name": "c2-date-input",
           "description": "A form-associated single-date field backed by a native `<input type=\"date\">`. Values, `min` and `max` use local\ncalendar ISO strings (`YYYY-MM-DD`). The native picker and keyboard editing remain available while the component\nadds a consistent field, calendar affordance, helper text, error state and theming surface.\n\n`@c2n/date-input`",
@@ -40290,6 +40908,134 @@
             "events": []
           }
         },
+        {
+          "name": "c2-step",
+          "description": "One row of a Steps list: a marker, a label with optional dimmed `detail`, and `trailing` text at the end\nof the row — a duration, a count, a timestamp.\n\n`@c2n/steps`",
+          "attributes": [
+            {
+              "name": "status",
+              "description": "State of the step. Drives the marker glyph and the accent colour, and reopens a folded group.",
+              "default": "'pending'",
+              "value": {
+                "type": "StepStatus",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "label",
+              "description": "Primary text, when the `label` slot is empty.",
+              "default": "''",
+              "value": {
+                "type": "string",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "detail",
+              "description": "Dimmed secondary text beside the label, when the `detail` slot is empty.",
+              "default": "''",
+              "value": {
+                "type": "string",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "trailing",
+              "description": "Text at the end of the row, when the `trailing` slot is empty.",
+              "default": "''",
+              "value": {
+                "type": "string",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "collapsed",
+              "description": "Whether this group is folded away. A group is expanded by default — every step in the list is a row you can\nsee — and only the reader, the markup or a reopening status ever changes that.",
+              "default": "false",
+              "value": {
+                "type": "boolean",
+                "kind": "expression"
+              }
+            }
+          ],
+          "js": {
+            "properties": [],
+            "events": [
+              {
+                "name": "step-toggle",
+                "description": "A group was folded away or brought back. Bubbles.",
+                "value": {
+                  "type": "CustomEvent<StepToggleEventDetail>",
+                  "kind": "expression"
+                }
+              }
+            ]
+          }
+        },
+        {
+          "name": "c2-steps",
+          "description": "A vertical list of steps: the trace of a task as it runs, or a wizard's progress. Each row is a marker, a label,\nan optional dimmed `detail` beside it and `trailing` text at the end — a duration, a count, a timestamp.\n\n`@c2n/steps`",
+          "attributes": [
+            {
+              "name": "marker",
+              "description": "How each marker is drawn: a status glyph, the step's number, or nothing.",
+              "default": "'icon'",
+              "value": {
+                "type": "StepsMarker",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "current",
+              "description": "Index of the active step, for a wizard. `-1` (the default) leaves every status alone; otherwise a top-level\nstep with neither an explicit `status` nor sub-steps becomes `success` before this index, `current` at it and\n`pending` after it.",
+              "default": "-1",
+              "value": {
+                "type": "number",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "steps",
+              "description": "The steps as data, instead of `c2-step` children. Takes precedence over the slot.",
+              "default": "undefined",
+              "value": {
+                "type": "StepNode[] | undefined",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "aria-label",
+              "description": "Accessible name for the list.",
+              "default": "null",
+              "value": {
+                "type": "string | null",
+                "kind": "expression"
+              }
+            }
+          ],
+          "js": {
+            "properties": [
+              {
+                "name": "ariaLabel",
+                "description": "Accessible name for the list.",
+                "value": {
+                  "type": "string | null",
+                  "kind": "expression"
+                }
+              }
+            ],
+            "events": [
+              {
+                "name": "step-toggle",
+                "description": "Fired by a `c2-step` when a group opens or closes, and bubbling to here. `event.target` is the step; `detail.path` says where it sits.",
+                "value": {
+                  "type": "CustomEvent<StepToggleEventDetail>",
+                  "kind": "expression"
+                }
+              }
+            ]
+          }
+        },
         {
           "name": "c2-switch",
           "description": "On/off toggle built on a native `<input type=\"checkbox\" role=\"switch\">`, so keyboard activation (Space), form value\nand the `switch` role come from the browser. The thumb can also be dragged: it follows the pointer and the side it is\nreleased on decides the state. The whole row is the label: text in the default slot and an optional `description`\nsit beside the track, and clicking them toggles it. Icons for either state can ride inside the thumb.\n\n`@c2n/switch`",
@@ -41676,6 +42422,190 @@
             ]
           }
         },
+        {
+          "name": "c2-theme-select",
+          "description": "Colour-theme switcher. The trigger shows the icon of the mode currently in effect and clicking it steps to the next\none, wrapping around — a two-state control is therefore a plain light/dark toggle. With three or more modes the\ntrigger also opens a menu on hover (or focus, or ArrowDown) so any mode can be picked directly, while the click-to-\nadvance behaviour keeps working.\n\n`@c2n/theme-select`",
+          "attributes": [
+            {
+              "name": "modes",
+              "description": "The states to cycle through: `\"system,light,dark\"`, a JSON array, or objects from script.",
+              "default": "['system', 'light', 'dark']",
+              "value": {
+                "type": "Array<string | ThemeSelectMode>",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "value",
+              "description": "The mode in effect. Assigning it selects that mode silently; `select()` and `next()` report the change.",
+              "default": "''",
+              "value": {
+                "type": "string",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "menu",
+              "description": "When to offer the dropdown: `auto` (three or more modes), `always`, or `never`.",
+              "default": "'auto'",
+              "value": {
+                "type": "'auto' | 'always' | 'never'",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "placement",
+              "description": "Preferred placement of the menu (floating-ui names).",
+              "default": "'bottom'",
+              "value": {
+                "type": "Placement",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "show-label",
+              "description": "Show the current mode's label beside its icon.",
+              "default": "false",
+              "value": {
+                "type": "boolean",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "disabled",
+              "description": "Blocks interaction and dims the control.",
+              "default": "false",
+              "value": {
+                "type": "boolean",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "manual",
+              "description": "Do not touch the document or storage; the host applies the theme itself from `theme-change`.",
+              "default": "false",
+              "value": {
+                "type": "boolean",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "target",
+              "description": "Element the scheme is written to, or the id of one. Defaults to `<html>`.",
+              "default": "undefined",
+              "value": {
+                "type": "string | HTMLElement | undefined",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "theme-attribute",
+              "description": "Attribute written on the target, `data-theme` by default.",
+              "default": "'data-theme'",
+              "value": {
+                "type": "string",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "storage-key",
+              "description": "`localStorage` key the chosen mode is remembered under. Empty disables persistence.",
+              "default": "'c2n-theme'",
+              "value": {
+                "type": "string",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "open-delay",
+              "description": "Milliseconds the pointer must rest on the trigger before the menu opens.",
+              "default": "150",
+              "value": {
+                "type": "number",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "close-delay",
+              "description": "Milliseconds the menu stays open after the pointer leaves, so it can be crossed into.",
+              "default": "200",
+              "value": {
+                "type": "number",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "aria-label",
+              "description": "Accessible name of the trigger. Defaults to `Theme: <current label>`.",
+              "value": {
+                "type": "string",
+                "kind": "expression"
+              }
+            }
+          ],
+          "js": {
+            "properties": [
+              {
+                "name": "showLabel",
+                "description": "Show the current mode's label beside its icon.",
+                "value": {
+                  "type": "boolean",
+                  "kind": "expression"
+                }
+              },
+              {
+                "name": "themeAttribute",
+                "description": "Attribute written on the target, `data-theme` by default.",
+                "value": {
+                  "type": "string",
+                  "kind": "expression"
+                }
+              },
+              {
+                "name": "storageKey",
+                "description": "`localStorage` key the chosen mode is remembered under. Empty disables persistence.",
+                "value": {
+                  "type": "string",
+                  "kind": "expression"
+                }
+              },
+              {
+                "name": "openDelay",
+                "description": "Milliseconds the pointer must rest on the trigger before the menu opens.",
+                "value": {
+                  "type": "number",
+                  "kind": "expression"
+                }
+              },
+              {
+                "name": "closeDelay",
+                "description": "Milliseconds the menu stays open after the pointer leaves, so it can be crossed into.",
+                "value": {
+                  "type": "number",
+                  "kind": "expression"
+                }
+              },
+              {
+                "name": "ariaLabel",
+                "description": "Accessible name of the trigger. Defaults to `Theme: <current label>`.",
+                "value": {
+                  "type": "string",
+                  "kind": "expression"
+                }
+              }
+            ],
+            "events": [
+              {
+                "name": "theme-change",
+                "description": "The scheme in effect changed: a mode was picked, or the OS preference moved while `system` was selected. `detail.value` is the mode, `detail.theme` the scheme it resolves to. Does not bubble; assigning `value` from script is silent.",
+                "value": {
+                  "type": "CustomEvent<ThemeSelectChangeDetail>",
+                  "kind": "expression"
+                }
+              }
+            ]
+          }
+        },
         {
           "name": "c2-toast",
           "description": "A notification card. Use c2-toast-region to manage stacking, queueing and timed dismissal.\n\n`@c2n/toast`",