kanto-ds 1.3.0 → 1.5.1

package/dist/web-types.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://raw.githubusercontent.com/JetBrains/web-types/master/schema/web-types.json",
   "name": "kanto-ds",
-  "version": "1.3.0",
+  "version": "1.5.1",
   "description-markup": "markdown",
   "contributions": {
     "html": {
@@ -1033,6 +1033,26 @@
           "description": "A data table: tri-state sorting, single or multiple selection, paging.\n\n---\n\n\n### **Events:**\n - **kt-sort-change** - Sorting changed. `detail: { key, direction }`.\n- **kt-selection-change** - Selection changed. `detail: { selected, rows }`.\n- **kt-row-click** - A row was clicked. `detail: { row, index }`.\n- **kt-page-change** - The page changed. `detail: { page }`.\n\n### **CSS Parts:**\n - **table** - The `<table>`.\n- **header-cell** - A `<th>`.\n- **row** - A `<tr>`.\n- **cell** - A `<td>`.",
           "doc-url": "",
           "attributes": [
+            {
+              "name": "page",
+              "description": "The page on screen, from 1. Set it to open on another page.",
+              "value": { "type": "number", "default": "1" }
+            },
+            {
+              "name": "manual",
+              "description": "For data sorted and paged on a server: `data` is the current page, shown\nas given. Headers and the pager still update the state and fire their\nevents, and the application loads what they ask for.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "virtual",
+              "description": "Renders only the rows in view, for thousands of rows without paging. The\ntable scrolls inside its own box: give it a height (`kt-table { height:\n480px }`). Every row must be the same height — the first one rendered is\nmeasured. A page size takes precedence.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "total-rows",
+              "description": "In manual mode, how many rows the server holds — what the pager counts.",
+              "value": { "type": "number", "default": "0" }
+            },
             {
               "name": "selectable",
               "value": { "type": "boolean", "default": "false" }
@@ -1077,6 +1097,11 @@
               "name": "label",
               "description": "Accessible name for the table.",
               "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "locale",
+              "description": "BCP 47 locale text is sorted in. Empty means the page's `<html lang>`,\nthen the browser's language.",
+              "value": { "type": "string", "default": "''" }
             }
           ],
           "events": [
@@ -1099,6 +1124,26 @@
           ],
           "js": {
             "properties": [
+              {
+                "name": "page",
+                "description": "The page on screen, from 1. Set it to open on another page.",
+                "type": "number"
+              },
+              {
+                "name": "manual",
+                "description": "For data sorted and paged on a server: `data` is the current page, shown\nas given. Headers and the pager still update the state and fire their\nevents, and the application loads what they ask for.",
+                "type": "boolean"
+              },
+              {
+                "name": "virtual",
+                "description": "Renders only the rows in view, for thousands of rows without paging. The\ntable scrolls inside its own box: give it a height (`kt-table { height:\n480px }`). Every row must be the same height — the first one rendered is\nmeasured. A page size takes precedence.",
+                "type": "boolean"
+              },
+              {
+                "name": "totalRows",
+                "description": "In manual mode, how many rows the server holds — what the pager counts.",
+                "type": "number"
+              },
               { "name": "columns", "type": "readonly KtTableColumn[]" },
               { "name": "data", "type": "readonly KtTableRow[]" },
               { "name": "selectable", "type": "boolean" },
@@ -1129,9 +1174,14 @@
                 "description": "Accessible name for the table.",
                 "type": "string"
               },
+              {
+                "name": "locale",
+                "description": "BCP 47 locale text is sorted in. Empty means the page's `<html lang>`,\nthen the browser's language.",
+                "type": "string"
+              },
               {
                 "name": "sortedRows",
-                "description": "The rows after sorting, before paging.",
+                "description": "The rows after sorting, before paging.\n\nSorted once per change of `data`, `sortKey`, `sortDirection` or locale, not on\nevery render: hovering a row or ticking a box re-renders the table, and\nre-sorting a few thousand rows each time is what made that lag. Assign a\nnew array to `data` rather than changing it in place.",
                 "type": "readonly KtTableRow[]"
               },
               { "name": "totalPages", "type": "number" },
@@ -1625,8 +1675,14 @@
             { "name": "text", "value": { "type": "string", "default": "''" } },
             {
               "name": "placement",
+              "description": "The side the bubble prefers. It takes the opposite one when this one has\nno room — \"top\" on a trigger at the top of the page shows below it.",
               "value": { "type": "KtTooltipPlacement", "default": "'top'" }
             },
+            {
+              "name": "open",
+              "description": "Shows the bubble whatever the pointer and focus do — for a trigger that\ncannot take focus itself, like an icon beside a field, whose owner shows\nit while the field is focused.",
+              "value": { "type": "boolean", "default": "false" }
+            },
             {
               "name": "disabled",
               "description": "Suppresses the tooltip without removing it from the markup.",
@@ -1638,7 +1694,16 @@
           "js": {
             "properties": [
               { "name": "text", "type": "string" },
-              { "name": "placement", "type": "KtTooltipPlacement" },
+              {
+                "name": "placement",
+                "description": "The side the bubble prefers. It takes the opposite one when this one has\nno room — \"top\" on a trigger at the top of the page shows below it.",
+                "type": "KtTooltipPlacement"
+              },
+              {
+                "name": "open",
+                "description": "Shows the bubble whatever the pointer and focus do — for a trigger that\ncannot take focus itself, like an icon beside a field, whose owner shows\nit while the field is focused.",
+                "type": "boolean"
+              },
               {
                 "name": "disabled",
                 "description": "Suppresses the tooltip without removing it from the markup.",
@@ -1648,9 +1713,308 @@
             "events": []
           }
         },
+        {
+          "name": "kt-calendar",
+          "description": "A month calendar to pick a day or a period from, shown in the page.\n\nThe same calendar `<kt-date-picker>` opens in its popup, for when the\ncalendar is the interface rather than a way to fill a field: a booking\npage, a dashboard's date filter, a planning view.\n\nThe header's month and year are buttons. The month opens a grid of the\ntwelve months, the year a grid of twelve years, so reaching a date years\naway takes three clicks rather than paging month by month.\n\nKeyboard, in the day grid (the WAI-ARIA date grid pattern): arrows by day\nand week, Home/End to the week's ends, Page Up/Down by month and with Shift\nby year, Enter to choose. In the month and year grids: arrows, Page Up/Down\nby year or by twelve years, Enter to choose, Escape back to the days.\n\n---\n\n\n### **Events:**\n - **kt-change** - A day, or a whole period, was chosen. `detail: { value }`.\n\n### **Methods:**\n - **focus(): _void_** - Focuses the grid's current cell — the chosen day, or today.\n\n### **CSS Parts:**\n - **base** - The calendar.\n- **day** - A day cell.",
+          "doc-url": "",
+          "attributes": [
+            {
+              "name": "value",
+              "description": "ISO date, or `start/end` interval with `range`. `null` when empty.",
+              "value": { "type": "string | null", "default": "null" }
+            },
+            {
+              "name": "range",
+              "description": "Choose a period — two dates — instead of one day.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "min",
+              "description": "Earliest date that can be chosen, ISO.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "max",
+              "description": "Latest date that can be chosen, ISO.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "locale",
+              "description": "BCP 47 language tag for names and the first day of the week. Empty: the\npage's `lang`, then the browser's language.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "label",
+              "description": "Accessible name of the calendar. Defaults to the strings registry.",
+              "value": { "type": "string", "default": "''" }
+            }
+          ],
+          "events": [
+            {
+              "name": "kt-change",
+              "description": "A day, or a whole period, was chosen. `detail: { value }`."
+            }
+          ],
+          "js": {
+            "properties": [
+              {
+                "name": "value",
+                "description": "ISO date, or `start/end` interval with `range`. `null` when empty.",
+                "type": "string | null"
+              },
+              {
+                "name": "range",
+                "description": "Choose a period — two dates — instead of one day.",
+                "type": "boolean"
+              },
+              {
+                "name": "min",
+                "description": "Earliest date that can be chosen, ISO.",
+                "type": "string"
+              },
+              {
+                "name": "max",
+                "description": "Latest date that can be chosen, ISO.",
+                "type": "string"
+              },
+              {
+                "name": "locale",
+                "description": "BCP 47 language tag for names and the first day of the week. Empty: the\npage's `lang`, then the browser's language.",
+                "type": "string"
+              },
+              {
+                "name": "label",
+                "description": "Accessible name of the calendar. Defaults to the strings registry.",
+                "type": "string"
+              }
+            ],
+            "events": [
+              {
+                "name": "kt-change",
+                "description": "A day, or a whole period, was chosen. `detail: { value }`."
+              }
+            ]
+          }
+        },
+        {
+          "name": "kt-checkbox",
+          "description": "A checkbox: a choice that applies when the form is submitted.\n\nBuilt on a real `<input type=\"checkbox\">`, laid invisibly over the drawn\nbox, so the keyboard, the label click, the indeterminate state and what a\nscreen reader announces all come from the platform rather than a\nreimplementation of it.\n\nFor a setting that takes effect the moment it is flipped, use\n`<kt-toggle>`; for one choice among several, `<kt-radio-group>`.\n\n---\n\n\n### **Events:**\n - **kt-change** - The box was checked or unchecked. `detail: { checked }`.\n\n### **Methods:**\n - **formDisabledCallback(disabled: _boolean_): _void_** - Called by the platform when the control's disabled state changes — its\nown `disabled`, or an ancestor `<fieldset disabled>` it cannot see.\n\n### **Slots:**\n - _default_ - The label, clickable.\n\n### **CSS Parts:**\n - **base** - The `<label>` around box and text.\n- **input** - The native checkbox.\n- **box** - The drawn box.",
+          "doc-url": "",
+          "attributes": [
+            {
+              "name": "checked",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "indeterminate",
+              "description": "Neither checked nor unchecked — for a \"select all\" over a partial\nselection. Cleared as soon as the user clicks, as on a native checkbox.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "disabled",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "required",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "size",
+              "value": { "type": "KtCheckboxSize", "default": "'medium'" }
+            },
+            { "name": "name", "value": { "type": "string", "default": "''" } },
+            {
+              "name": "value",
+              "description": "Submitted when checked, as for a native checkbox.",
+              "value": { "type": "string", "default": "'on'" }
+            },
+            {
+              "name": "label",
+              "description": "Accessible name, when nothing is slotted.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "error",
+              "description": "Error message. A non-empty value puts the box in its error state.",
+              "value": { "type": "string", "default": "''" }
+            }
+          ],
+          "slots": [{ "name": "", "description": "The label, clickable." }],
+          "events": [
+            {
+              "name": "kt-change",
+              "description": "The box was checked or unchecked. `detail: { checked }`."
+            }
+          ],
+          "js": {
+            "properties": [
+              { "name": "checked", "type": "boolean" },
+              {
+                "name": "indeterminate",
+                "description": "Neither checked nor unchecked — for a \"select all\" over a partial\nselection. Cleared as soon as the user clicks, as on a native checkbox.",
+                "type": "boolean"
+              },
+              { "name": "disabled", "type": "boolean" },
+              { "name": "required", "type": "boolean" },
+              { "name": "size", "type": "KtCheckboxSize" },
+              { "name": "name", "type": "string" },
+              {
+                "name": "value",
+                "description": "Submitted when checked, as for a native checkbox.",
+                "type": "string"
+              },
+              {
+                "name": "label",
+                "description": "Accessible name, when nothing is slotted.",
+                "type": "string"
+              },
+              {
+                "name": "error",
+                "description": "Error message. A non-empty value puts the box in its error state.",
+                "type": "string"
+              }
+            ],
+            "events": [
+              {
+                "name": "kt-change",
+                "description": "The box was checked or unchecked. `detail: { checked }`."
+              }
+            ]
+          }
+        },
+        {
+          "name": "kt-date-picker",
+          "description": "A date field with a calendar, for one day or a period.\n\nThe value is ISO 8601 text, the format a server and a `<input type=\"date\">`\nalready speak: `2026-09-25`, or `2026-09-01/2026-09-25` for a period. What\nthe field shows is the same date formatted for the reader's language, and\nthe calendar starts its weeks on the day their region does.\n\nThe popup is a `<kt-calendar>`, with its keyboard model and its month and\nyear views: the WAI-ARIA date picker dialog pattern, where Escape closes the\ndialog and hands focus back to the field, and tabbing out closes it too.\n\n---\n\n\n### **Events:**\n - **kt-change** - A date or a whole period was chosen, or the value cleared. `detail: { value }` — the ISO date or interval, or `null`.\n\n### **Methods:**\n - **formDisabledCallback(disabled: _boolean_): _void_** - Called by the platform when the control's disabled state changes — its\nown `disabled`, or an ancestor `<fieldset disabled>` it cannot see.\n\n### **CSS Parts:**\n - **trigger** - The field.\n- **panel** - The calendar popup.\n- **calendar** - The `<kt-calendar>` inside it.",
+          "doc-url": "",
+          "attributes": [
+            {
+              "name": "value",
+              "description": "ISO date, or `start/end` interval with `range`. `null` when empty.",
+              "value": { "type": "string | null", "default": "null" }
+            },
+            {
+              "name": "range",
+              "description": "Choose a period — two dates — instead of one day.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "min",
+              "description": "Earliest date that can be chosen, ISO.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "max",
+              "description": "Latest date that can be chosen, ISO.",
+              "value": { "type": "string", "default": "''" }
+            },
+            { "name": "name", "value": { "type": "string", "default": "''" } },
+            {
+              "name": "label",
+              "description": "Accessible name, when no `<kt-label-input>` wraps the field.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "placeholder",
+              "description": "Shown while empty. Defaults to the strings registry.",
+              "value": { "type": "string | undefined", "default": "undefined" }
+            },
+            {
+              "name": "locale",
+              "description": "BCP 47 language tag for formatting and for the first day of the week.\nEmpty: the page's `lang`, then the browser's language.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "size",
+              "value": { "type": "KtDatePickerSize", "default": "'medium'" }
+            },
+            {
+              "name": "disabled",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "required",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "clearable",
+              "description": "Shows a button that empties the field once it holds a value.",
+              "value": { "type": "boolean", "default": "true" }
+            },
+            {
+              "name": "error",
+              "description": "Error message. A non-empty value puts the field in its error state.",
+              "value": { "type": "string", "default": "''" }
+            }
+          ],
+          "events": [
+            {
+              "name": "kt-change",
+              "description": "A date or a whole period was chosen, or the value cleared. `detail: { value }` — the ISO date or interval, or `null`."
+            }
+          ],
+          "js": {
+            "properties": [
+              {
+                "name": "value",
+                "description": "ISO date, or `start/end` interval with `range`. `null` when empty.",
+                "type": "string | null"
+              },
+              {
+                "name": "range",
+                "description": "Choose a period — two dates — instead of one day.",
+                "type": "boolean"
+              },
+              {
+                "name": "min",
+                "description": "Earliest date that can be chosen, ISO.",
+                "type": "string"
+              },
+              {
+                "name": "max",
+                "description": "Latest date that can be chosen, ISO.",
+                "type": "string"
+              },
+              { "name": "name", "type": "string" },
+              {
+                "name": "label",
+                "description": "Accessible name, when no `<kt-label-input>` wraps the field.",
+                "type": "string"
+              },
+              {
+                "name": "placeholder",
+                "description": "Shown while empty. Defaults to the strings registry.",
+                "type": "string | undefined"
+              },
+              {
+                "name": "locale",
+                "description": "BCP 47 language tag for formatting and for the first day of the week.\nEmpty: the page's `lang`, then the browser's language.",
+                "type": "string"
+              },
+              { "name": "size", "type": "KtDatePickerSize" },
+              { "name": "disabled", "type": "boolean" },
+              { "name": "required", "type": "boolean" },
+              {
+                "name": "clearable",
+                "description": "Shows a button that empties the field once it holds a value.",
+                "type": "boolean"
+              },
+              {
+                "name": "error",
+                "description": "Error message. A non-empty value puts the field in its error state.",
+                "type": "string"
+              }
+            ],
+            "events": [
+              {
+                "name": "kt-change",
+                "description": "A date or a whole period was chosen, or the value cleared. `detail: { value }` — the ISO date or interval, or `null`."
+              }
+            ]
+          }
+        },
         {
           "name": "kt-drag-drop",
-          "description": "A file drop zone.\n\nAccepts a drop or a click, lists what was picked with sizes and types, and\nlets each entry be removed. It holds the files in memory and reports them —\nuploading is the application's business.\n\n---\n\n\n### **Events:**\n - **kt-files-change** - The selection changed. `detail: { files }`.\n- **kt-files-rejected** - Files were refused. `detail: { files, reason }`.\n\n### **Methods:**\n - **clear(): _void_** - Empties the selection without firing a rejection.\n\n### **CSS Parts:**\n - **base** - The dashed drop zone.\n- **list** - The list of chosen files.",
+          "description": "A file drop zone.\n\nAccepts a drop or a click, lists what was picked with sizes and types, and\nlets each entry be removed. It holds the files in memory and reports them —\nuploading is the application's business.\n\n---\n\n\n### **Events:**\n - **kt-files-change** - The selection changed. `detail: { files }`.\n- **kt-files-rejected** - Files were refused. `detail: { files, reason }`.\n\n### **Methods:**\n - **formDisabledCallback(disabled: _boolean_): _void_** - Called by the platform when the control's disabled state changes — its\nown `disabled`, or an ancestor `<fieldset disabled>` it cannot see.\n- **clear(): _void_** - Empties the selection without firing a rejection.\n\n### **CSS Parts:**\n - **base** - The dashed drop zone.\n- **list** - The list of chosen files.",
           "doc-url": "",
           "attributes": [
             {
@@ -1830,7 +2194,7 @@
         },
         {
           "name": "kt-input",
-          "description": "A single-line text field.\n\nBorderless by design: the field is a fill on `--color-dark-12` that gains a\n2px *outline* — grey on hover, primary on focus, danger on error. An outline\nsits outside the box, so nothing reflows when the state changes.\n\nThe element is form-associated: it serialises into `FormData` under its\n`name`, resets with the form, and reports validity like a native input.\n\n---\n\n\n### **Events:**\n - **kt-input** - On every keystroke. `detail: { value }`.\n- **kt-change** - When the value is committed (blur or Enter). `detail: { value }`.\n- **kt-clear** - The clear button was pressed.\n\n### **Methods:**\n - **formResetCallback(): _void_** - Called by the platform when the enclosing form is reset.\n- **formStateRestoreCallback(state: _string_): _void_** - Called by the platform when the browser restores a session.\n- **select(): _void_** - Selects the field's contents, as `HTMLInputElement.select()` does.\n\n### **CSS Parts:**\n - **base** - The field container.\n- **control** - The native `<input>`.\n- **actions** - The trailing icon row.",
+          "description": "A single-line text field.\n\nBorderless by design: the field is a fill on `--color-dark-12` that gains a\n2px *outline* — grey on hover, primary on focus, danger on error. An outline\nsits outside the box, so nothing reflows when the state changes.\n\nThe element is form-associated: it serialises into `FormData` under its\n`name`, resets with the form, and reports validity like a native input.\n\n---\n\n\n### **Events:**\n - **kt-input** - On every keystroke. `detail: { value }`.\n- **kt-change** - When the value is committed (blur or Enter). `detail: { value }`.\n- **kt-clear** - The clear button was pressed.\n\n### **Methods:**\n - **formResetCallback(): _void_** - Called by the platform when the enclosing form is reset.\n- **formDisabledCallback(disabled: _boolean_): _void_** - Called by the platform when the control's disabled state changes — its\nown `disabled`, or an ancestor `<fieldset disabled>` it cannot see.\n- **formStateRestoreCallback(state: _string_): _void_** - Called by the platform when the browser restores a session.\n- **select(): _void_** - Selects the field's contents, as `HTMLInputElement.select()` does.\n\n### **CSS Parts:**\n - **base** - The field container.\n- **control** - The native `<input>`.\n- **actions** - The trailing icon row.",
           "doc-url": "",
           "attributes": [
             {
@@ -1872,7 +2236,7 @@
             },
             {
               "name": "error",
-              "description": "Error message. A non-empty value puts the field in its error state.",
+              "description": "Error message. A non-empty value puts the field in its error state, and\nwins over the field's own checks.",
               "value": { "type": "string", "default": "''" }
             },
             {
@@ -1939,7 +2303,7 @@
               },
               {
                 "name": "error",
-                "description": "Error message. A non-empty value puts the field in its error state.",
+                "description": "Error message. A non-empty value puts the field in its error state, and\nwins over the field's own checks.",
                 "type": "string"
               },
               {
@@ -1983,7 +2347,7 @@
         },
         {
           "name": "kt-input-menu",
-          "description": "A combobox: type to narrow the list, then pick.\n\nReach for it over `<kt-select>` once the list is long enough that scanning it\nis slower than typing three letters — somewhere around twenty options.\n\n---\n\n\n### **Events:**\n - **kt-change** - An option was chosen or cleared. `detail: { value, option }`.\n- **kt-filter** - The query changed. `detail: { query }`.\n\n### **CSS Parts:**\n - **control** - The field.\n- **input** - The native `<input>`.\n- **popup** - The option list.\n- **option** - An option row.",
+          "description": "A combobox: type to narrow the list, then pick.\n\nReach for it over `<kt-select>` once the list is long enough that scanning it\nis slower than typing three letters — somewhere around twenty options.\n\n---\n\n\n### **Events:**\n - **kt-change** - An option was chosen or cleared. `detail: { value, option }`.\n- **kt-filter** - The query changed. `detail: { query }`.\n\n### **Methods:**\n - **formDisabledCallback(disabled: _boolean_): _void_** - Called by the platform when the control's disabled state changes — its\nown `disabled`, or an ancestor `<fieldset disabled>` it cannot see.\n\n### **CSS Parts:**\n - **control** - The field.\n- **input** - The native `<input>`.\n- **popup** - The option list.\n- **option** - An option row.",
           "doc-url": "",
           "attributes": [
             {
@@ -2081,9 +2445,147 @@
             "events": []
           }
         },
+        {
+          "name": "kt-radio",
+          "description": "One option of a `<kt-radio-group>`.\n\nIt draws itself and carries `role=\"radio\"`; the group owns the selection,\nthe tab stop and the keyboard. A `<kt-radio>` outside a group does nothing\nuseful.\n\n---\n\n\n### **Slots:**\n - _default_ - The label.\n\n### **CSS Parts:**\n - **base** - The `role=\"radio\"` row.\n- **circle** - The drawn circle.",
+          "doc-url": "",
+          "attributes": [
+            {
+              "name": "value",
+              "description": "Submitted by the group when this option is chosen.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "disabled",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "checked",
+              "description": "Set by the group.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "invalid",
+              "description": "Set by the group while it reports an error.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "group-disabled",
+              "description": "Set by the group while the whole group is disabled.",
+              "value": { "type": "boolean", "default": "false" }
+            }
+          ],
+          "slots": [{ "name": "", "description": "The label." }],
+          "events": [],
+          "js": {
+            "properties": [
+              {
+                "name": "value",
+                "description": "Submitted by the group when this option is chosen.",
+                "type": "string"
+              },
+              { "name": "disabled", "type": "boolean" },
+              {
+                "name": "checked",
+                "description": "Set by the group.",
+                "type": "boolean"
+              },
+              {
+                "name": "tabbable",
+                "description": "Set by the group: whether this option holds the group's one tab stop.",
+                "type": "boolean"
+              },
+              {
+                "name": "invalid",
+                "description": "Set by the group while it reports an error.",
+                "type": "boolean"
+              },
+              {
+                "name": "groupDisabled",
+                "description": "Set by the group while the whole group is disabled.",
+                "type": "boolean"
+              }
+            ],
+            "events": []
+          }
+        },
+        {
+          "name": "kt-radio-group",
+          "description": "One choice among a few, all visible at once.\n\nReach for it over `<kt-select>` when there are few enough options to show\nthem all — seeing every option is the point — and over\n`<kt-segmented-control>` when the options need a sentence each, or the\nchoice belongs in a form rather than a toolbar.\n\nNative radios cannot form a group across shadow roots, so this is the ARIA\nradio group pattern: one tab stop for the whole group, arrow keys move and\nselect, disabled options are skipped.\n\n---\n\n\n### **Events:**\n - **kt-change** - An option was chosen. `detail: { value }`.\n\n### **Methods:**\n - **formDisabledCallback(disabled: _boolean_): _void_** - Called by the platform when the control's disabled state changes — its\nown `disabled`, or an ancestor `<fieldset disabled>` it cannot see.\n\n### **Slots:**\n - _default_ - The `<kt-radio>` options.\n\n### **CSS Parts:**\n - **base** - The `role=\"radiogroup\"` container.",
+          "doc-url": "",
+          "attributes": [
+            {
+              "name": "value",
+              "description": "The chosen option's value, or `null`.",
+              "value": { "type": "string | null", "default": "null" }
+            },
+            { "name": "name", "value": { "type": "string", "default": "''" } },
+            {
+              "name": "label",
+              "description": "Accessible name of the group.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "disabled",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "required",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "orientation",
+              "value": {
+                "type": "KtRadioGroupOrientation",
+                "default": "'vertical'"
+              }
+            },
+            {
+              "name": "error",
+              "description": "Error message. A non-empty value puts the group in its error state.",
+              "value": { "type": "string", "default": "''" }
+            }
+          ],
+          "slots": [{ "name": "", "description": "The `<kt-radio>` options." }],
+          "events": [
+            {
+              "name": "kt-change",
+              "description": "An option was chosen. `detail: { value }`."
+            }
+          ],
+          "js": {
+            "properties": [
+              {
+                "name": "value",
+                "description": "The chosen option's value, or `null`.",
+                "type": "string | null"
+              },
+              { "name": "name", "type": "string" },
+              {
+                "name": "label",
+                "description": "Accessible name of the group.",
+                "type": "string"
+              },
+              { "name": "disabled", "type": "boolean" },
+              { "name": "required", "type": "boolean" },
+              { "name": "orientation", "type": "KtRadioGroupOrientation" },
+              {
+                "name": "error",
+                "description": "Error message. A non-empty value puts the group in its error state.",
+                "type": "string"
+              }
+            ],
+            "events": [
+              {
+                "name": "kt-change",
+                "description": "An option was chosen. `detail: { value }`."
+              }
+            ]
+          }
+        },
         {
           "name": "kt-select",
-          "description": "A single-choice dropdown.\n\nUnlike the trigger-plus-div it replaces, this is a real listbox: arrow keys\nmove an active descendant, Home and End jump to the ends, Enter commits,\nEscape closes without changing anything, and disabled options are skipped\nrather than merely unclickable.\n\n---\n\n\n### **Events:**\n - **kt-change** - An option was chosen or cleared. `detail: { value, option }`.\n\n### **CSS Parts:**\n - **trigger** - The button that opens the list.\n- **popup** - The option list.\n- **option** - An option row.",
+          "description": "A single-choice dropdown.\n\nUnlike the trigger-plus-div it replaces, this is a real listbox: arrow keys\nmove an active descendant, Home and End jump to the ends, Enter commits,\nEscape closes without changing anything, and disabled options are skipped\nrather than merely unclickable.\n\n---\n\n\n### **Events:**\n - **kt-change** - An option was chosen or cleared. `detail: { value, option }`.\n\n### **Methods:**\n - **formDisabledCallback(disabled: _boolean_): _void_** - Called by the platform when the control's disabled state changes — its\nown `disabled`, or an ancestor `<fieldset disabled>` it cannot see.\n\n### **CSS Parts:**\n - **trigger** - The button that opens the list.\n- **popup** - The option list.\n- **option** - An option row.",
           "doc-url": "",
           "attributes": [
             {
@@ -2188,7 +2690,7 @@
         },
         {
           "name": "kt-textarea",
-          "description": "A multi-line text field, with the same borderless fill and outline states as\n`<kt-input>`.\n\nA character counter appears whenever `maxlength` is set — the field tells\nthe user where the limit is before the browser silently stops accepting\nkeystrokes.\n\n---\n\n\n### **Events:**\n - **kt-input** - On every keystroke. `detail: { value }`.\n- **kt-change** - When the value is committed. `detail: { value }`.\n\n### **CSS Parts:**\n - **base** - The field container.\n- **control** - The native `<textarea>`.\n- **counter** - The character counter.",
+          "description": "A multi-line text field, with the same borderless fill and outline states as\n`<kt-input>`.\n\nA character counter appears whenever `maxlength` is set — the field tells\nthe user where the limit is before the browser silently stops accepting\nkeystrokes.\n\n---\n\n\n### **Events:**\n - **kt-input** - On every keystroke. `detail: { value }`.\n- **kt-change** - When the value is committed. `detail: { value }`.\n\n### **Methods:**\n - **formDisabledCallback(disabled: _boolean_): _void_** - Called by the platform when the control's disabled state changes — its\nown `disabled`, or an ancestor `<fieldset disabled>` it cannot see.\n\n### **CSS Parts:**\n - **base** - The field container.\n- **control** - The native `<textarea>`.\n- **counter** - The character counter.",
           "doc-url": "",
           "attributes": [
             { "name": "value", "value": { "type": "string", "default": "''" } },
@@ -2277,7 +2779,7 @@
         },
         {
           "name": "kt-toggle",
-          "description": "An on/off switch.\n\nSized off the button heights so a toggle lines up with the controls beside\nit: the track is 1.8× the field height, the thumb is inset by 12% of it.\nChange `--button-height` and the switch follows.\n\n---\n\n\n### **Events:**\n - **kt-change** - The state changed. `detail: { checked }`.\n\n### **Slots:**\n - _default_ - Optional label, rendered beside the switch and clickable.\n\n### **CSS Parts:**\n - **base** - The button carrying `role=\"switch\"`.\n- **track** - The track.\n- **thumb** - The sliding thumb.",
+          "description": "An on/off switch.\n\nSized off the button heights so a toggle lines up with the controls beside\nit: the track is 1.8× the field height, the thumb is inset by 12% of it.\nChange `--button-height` and the switch follows.\n\n---\n\n\n### **Events:**\n - **kt-change** - The state changed. `detail: { checked }`.\n\n### **Methods:**\n - **formDisabledCallback(disabled: _boolean_): _void_** - Called by the platform when the control's disabled state changes — its\nown `disabled`, or an ancestor `<fieldset disabled>` it cannot see.\n\n### **Slots:**\n - _default_ - Optional label, rendered beside the switch and clickable.\n\n### **CSS Parts:**\n - **base** - The button carrying `role=\"switch\"`.\n- **track** - The track.\n- **thumb** - The sliding thumb.",
           "doc-url": "",
           "attributes": [
             {
@@ -2516,7 +3018,7 @@
         },
         {
           "name": "kt-segmented-control",
-          "description": "A small set of mutually exclusive choices, shown as one inset track with the\nselected segment raised out of it.\n\nUse it for two to five options that all fit on screen — a view switch, a date\nrange. Past that, `<kt-select>`.\n\nImplemented as a radio group: one tab stop for the whole control, arrows to\nmove between segments. That is what a keyboard user expects here, and it\nkeeps a five-option control from adding five tab stops to the page.\n\n---\n\n\n### **Events:**\n - **kt-change** - A segment was chosen. `detail: { value, option }`.\n\n### **CSS Parts:**\n - **base** - The track.\n- **option** - A segment.",
+          "description": "A small set of mutually exclusive choices, shown as one inset track with the\nselected segment raised out of it.\n\nUse it for two to five options that all fit on screen — a view switch, a date\nrange. Past that, `<kt-select>`.\n\nImplemented as a radio group: one tab stop for the whole control, arrows to\nmove between segments. That is what a keyboard user expects here, and it\nkeeps a five-option control from adding five tab stops to the page.\n\n---\n\n\n### **Events:**\n - **kt-change** - A segment was chosen. `detail: { value, option }`.\n\n### **Methods:**\n - **formDisabledCallback(disabled: _boolean_): _void_** - Called by the platform when the control's disabled state changes — its\nown `disabled`, or an ancestor `<fieldset disabled>` it cannot see.\n\n### **CSS Parts:**\n - **base** - The track.\n- **option** - A segment.",
           "doc-url": "",
           "attributes": [
             {