@c2n/framework-types 0.0.9 → 0.0.10

package/dist/html-custom-data.json

@@ -1,6 +1,6 @@
 {
   "version": 1.1,
-  "$comment": "GENERATED by @c2n/framework-types@0.0.9. Do not edit by hand.",
+  "$comment": "GENERATED by @c2n/framework-types@0.0.10. Do not edit by hand.",
   "tags": [
     {
       "name": "c2-accordion",
@@ -270,6 +270,30 @@
         }
       ]
     },
+    {
+      "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`",
+      "references": [
+        {
+          "name": "@c2n/avatar on npm",
+          "url": "https://www.npmjs.com/package/@c2n/avatar"
+        }
+      ],
+      "attributes": [
+        {
+          "name": "max-visible",
+          "description": "Optional hard cap in addition to the automatically calculated responsive limit. Zero means no hard cap.\n\nDefault: `0`"
+        },
+        {
+          "name": "count-mode",
+          "description": "Whether the overflow indicator shows `+hidden` or the total number of avatars.\n\nDefault: `'hidden'`"
+        },
+        {
+          "name": "aria-label",
+          "description": "Accessible name for the group.\n\nDefault: `'Avatar group'`"
+        }
+      ]
+    },
     {
       "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`",
@@ -314,6 +338,34 @@
         }
       ]
     },
+    {
+      "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`",
+      "references": [
+        {
+          "name": "@c2n/border-beam on npm",
+          "url": "https://www.npmjs.com/package/@c2n/border-beam"
+        }
+      ],
+      "attributes": [
+        {
+          "name": "count",
+          "description": "Number of beams distributed evenly around the perimeter.\n\nDefault: `1`"
+        },
+        {
+          "name": "side",
+          "description": "Border followed by the beam. `all` loops around the perimeter; one edge moves forward then backward.\n\nDefault: `'all'`"
+        },
+        {
+          "name": "reverse",
+          "description": "Sends the beams around the perimeter in the opposite direction.\n\nDefault: `false`"
+        },
+        {
+          "name": "paused",
+          "description": "Freezes the beams at their current positions.\n\nDefault: `false`"
+        }
+      ]
+    },
     {
       "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`",
@@ -2460,6 +2512,82 @@
         }
       ]
     },
+    {
+      "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`",
+      "references": [
+        {
+          "name": "@c2n/code-editor on npm",
+          "url": "https://www.npmjs.com/package/@c2n/code-editor"
+        }
+      ],
+      "attributes": [
+        {
+          "name": "value",
+          "description": "The source code. Assigning it replaces the document without losing scroll position or undo history.\n\nDefault: `''`"
+        },
+        {
+          "name": "language",
+          "description": "Language id: one of `BUILT_IN_LANGUAGES`, anything `languageLoader` resolves, or empty for no highlighting.\n\nDefault: `''`"
+        },
+        {
+          "name": "name",
+          "description": "Form field name.\n\nDefault: `''`"
+        },
+        {
+          "name": "label",
+          "description": "Label above the editor, when the `label` slot is empty.\n\nDefault: `''`"
+        },
+        {
+          "name": "aria-label",
+          "description": "Accessible name when nothing visible labels the editor.\n\nDefault: `null`"
+        },
+        {
+          "name": "placeholder",
+          "description": "Text shown while the document is empty.\n\nDefault: `''`"
+        },
+        {
+          "name": "readonly",
+          "description": "The document cannot be edited, but is still selectable and focusable.\n\nDefault: `false`"
+        },
+        {
+          "name": "disabled",
+          "description": "Blocks interaction entirely and dims the editor.\n\nDefault: `false`"
+        },
+        {
+          "name": "required",
+          "description": "The form is invalid while the value is empty.\n\nDefault: `false`"
+        },
+        {
+          "name": "line-numbers",
+          "description": "Show the line-number gutter.\n\nDefault: `false`"
+        },
+        {
+          "name": "wrap",
+          "description": "Wrap long lines instead of scrolling horizontally.\n\nDefault: `false`"
+        },
+        {
+          "name": "autocomplete",
+          "description": "Offer completions while typing (identifiers, and whatever the grammar contributes).\n\nDefault: `false`"
+        },
+        {
+          "name": "tab-size",
+          "description": "Width of a tab stop, in characters.\n\nDefault: `2`"
+        },
+        {
+          "name": "error",
+          "description": "Renders the error styling; `error-text` replaces the supporting text.\n\nDefault: `false`"
+        },
+        {
+          "name": "error-text",
+          "description": "Message shown in place of the supporting text while `error` is set.\n\nDefault: `''`"
+        },
+        {
+          "name": "help",
+          "description": "Help text under the editor, when the `supporting-text` slot is empty.\n\nDefault: `''`"
+        }
+      ]
+    },
     {
       "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`",
@@ -31586,6 +31714,66 @@
         }
       ]
     },
+    {
+      "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`",
+      "references": [
+        {
+          "name": "@c2n/steps on npm",
+          "url": "https://www.npmjs.com/package/@c2n/steps"
+        }
+      ],
+      "attributes": [
+        {
+          "name": "status",
+          "description": "State of the step. Drives the marker glyph and the accent colour, and reopens a folded group.\n\nDefault: `'pending'`"
+        },
+        {
+          "name": "label",
+          "description": "Primary text, when the `label` slot is empty.\n\nDefault: `''`"
+        },
+        {
+          "name": "detail",
+          "description": "Dimmed secondary text beside the label, when the `detail` slot is empty.\n\nDefault: `''`"
+        },
+        {
+          "name": "trailing",
+          "description": "Text at the end of the row, when the `trailing` slot is empty.\n\nDefault: `''`"
+        },
+        {
+          "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.\n\nDefault: `false`"
+        }
+      ]
+    },
+    {
+      "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`",
+      "references": [
+        {
+          "name": "@c2n/steps on npm",
+          "url": "https://www.npmjs.com/package/@c2n/steps"
+        }
+      ],
+      "attributes": [
+        {
+          "name": "marker",
+          "description": "How each marker is drawn: a status glyph, the step's number, or nothing.\n\nDefault: `'icon'`"
+        },
+        {
+          "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.\n\nDefault: `-1`"
+        },
+        {
+          "name": "steps",
+          "description": "The steps as data, instead of `c2-step` children. Takes precedence over the slot.\n\nDefault: `undefined`"
+        },
+        {
+          "name": "aria-label",
+          "description": "Accessible name for the list.\n\nDefault: `null`"
+        }
+      ]
+    },
     {
       "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`",
@@ -32123,6 +32311,81 @@
         }
       ]
     },
+    {
+      "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`",
+      "references": [
+        {
+          "name": "@c2n/theme-select on npm",
+          "url": "https://www.npmjs.com/package/@c2n/theme-select"
+        }
+      ],
+      "attributes": [
+        {
+          "name": "modes",
+          "description": "The states to cycle through: `\"system,light,dark\"`, a JSON array, or objects from script.\n\nDefault: `['system', 'light', 'dark']`"
+        },
+        {
+          "name": "value",
+          "description": "The mode in effect. Assigning it selects that mode silently; `select()` and `next()` report the change.\n\nDefault: `''`"
+        },
+        {
+          "name": "menu",
+          "description": "When to offer the dropdown: `auto` (three or more modes), `always`, or `never`.\n\nDefault: `'auto'`",
+          "values": [
+            {
+              "name": "auto"
+            },
+            {
+              "name": "always"
+            },
+            {
+              "name": "never"
+            }
+          ]
+        },
+        {
+          "name": "placement",
+          "description": "Preferred placement of the menu (floating-ui names).\n\nDefault: `'bottom'`"
+        },
+        {
+          "name": "show-label",
+          "description": "Show the current mode's label beside its icon.\n\nDefault: `false`"
+        },
+        {
+          "name": "disabled",
+          "description": "Blocks interaction and dims the control.\n\nDefault: `false`"
+        },
+        {
+          "name": "manual",
+          "description": "Do not touch the document or storage; the host applies the theme itself from `theme-change`.\n\nDefault: `false`"
+        },
+        {
+          "name": "target",
+          "description": "Element the scheme is written to, or the id of one. Defaults to `<html>`.\n\nDefault: `undefined`"
+        },
+        {
+          "name": "theme-attribute",
+          "description": "Attribute written on the target, `data-theme` by default.\n\nDefault: `'data-theme'`"
+        },
+        {
+          "name": "storage-key",
+          "description": "`localStorage` key the chosen mode is remembered under. Empty disables persistence.\n\nDefault: `'c2n-theme'`"
+        },
+        {
+          "name": "open-delay",
+          "description": "Milliseconds the pointer must rest on the trigger before the menu opens.\n\nDefault: `150`"
+        },
+        {
+          "name": "close-delay",
+          "description": "Milliseconds the menu stays open after the pointer leaves, so it can be crossed into.\n\nDefault: `200`"
+        },
+        {
+          "name": "aria-label",
+          "description": "Accessible name of the trigger. Defaults to `Theme: <current label>`."
+        }
+      ]
+    },
     {
       "name": "c2-toast",
       "description": "A notification card. Use c2-toast-region to manage stacking, queueing and timed dismissal.\n\n`@c2n/toast`",

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.10",
   "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`",
@@ -40290,6 +40627,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 +42141,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`",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c2n/framework-types",
-  "version": "0.0.9",
+  "version": "0.0.10",
   "description": "Editor metadata for the c2n web components: VS Code / Volar HTML custom data and JetBrains web-types, generated from the custom-elements manifests",
   "type": "module",
   "exports": {
@@ -51,5 +51,5 @@
       "command": "node scripts/framework-types/index.ts"
     }
   },
-  "gitHead": "e4768cce5e0fbd5bc3165cd493a1e8d57cf0fff4"
+  "gitHead": "8d57710b3345fcb01cdb4cb15d2d43ba8bf21642"
 }

package/tsconfig.vue.json

@@ -1,5 +1,5 @@
 {
-  "$comment": "GENERATED by @c2n/framework-types@0.0.9. Do not edit by hand. Add to a Vue app's tsconfig: \"extends\": [\"@c2n/config/tsconfig.lib.json\", \"@c2n/framework-types/tsconfig.vue.json\"] — and declare no \"vueCompilerOptions\" of your own, because a local one replaces the inherited object rather than merging with it.",
+  "$comment": "GENERATED by @c2n/framework-types@0.0.10. Do not edit by hand. Add to a Vue app's tsconfig: \"extends\": [\"@c2n/config/tsconfig.lib.json\", \"@c2n/framework-types/tsconfig.vue.json\"] — and declare no \"vueCompilerOptions\" of your own, because a local one replaces the inherited object rather than merging with it.",
   "vueCompilerOptions": {
     "strictTemplates": true,
     "experimentalModelPropName": {
@@ -15,6 +15,7 @@
         "c2-autocomplete": true,
         "c2-cascader": true,
         "c2-chat-input": true,
+        "c2-code-editor": true,
         "c2-date-input": true,
         "c2-number-input": true,
         "c2-radio-group": true,