kanto-ds 1.4.0 → 1.5.2

package/dist/custom-elements.json

@@ -4220,8 +4220,96 @@
               "type": {
                 "text": "number"
               },
+              "default": "1",
+              "description": "The page on screen, from 1. Set it to open on another page.",
+              "attribute": "page"
+            },
+            {
+              "kind": "field",
+              "name": "manual",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "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.",
+              "attribute": "manual",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "virtual",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "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.",
+              "attribute": "virtual",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "scrollOffset",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0",
+              "description": "How far the scroller is scrolled. Not `scrollTop`, which the host already has."
+            },
+            {
+              "kind": "field",
+              "name": "viewportHeight",
+              "type": {
+                "text": "number"
+              },
               "privacy": "private",
-              "default": "1"
+              "default": "0",
+              "description": "The scroller's height, and the header's inside it, in px."
+            },
+            {
+              "kind": "field",
+              "name": "headerHeight",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0"
+            },
+            {
+              "kind": "field",
+              "name": "rowHeight",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0",
+              "description": "A body row's height, in px; 0 until one has been measured."
+            },
+            {
+              "kind": "field",
+              "name": "resizeObserver",
+              "type": {
+                "text": "ResizeObserver | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "observed",
+              "type": {
+                "text": "Element | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "totalRows",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "In manual mode, how many rows the server holds — what the pager counts.",
+              "attribute": "total-rows"
             },
             {
               "kind": "field",
@@ -4351,15 +4439,52 @@
               "description": "Accessible name for the table.",
               "attribute": "label"
             },
+            {
+              "kind": "field",
+              "name": "locale",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "BCP 47 locale text is sorted in. Empty means the page's `<html lang>`,\nthen the browser's language.",
+              "attribute": "locale"
+            },
+            {
+              "kind": "field",
+              "name": "sortCache",
+              "type": {
+                "text": "| {\n        data: readonly KtTableRow[];\n        key: string | null;\n        direction: KtSortDirection;\n        locale: string;\n        rows: readonly KtTableRow[];\n      }\n    | undefined"
+              },
+              "privacy": "private",
+              "description": "The last sort, and what it was computed from."
+            },
             {
               "kind": "field",
               "name": "sortedRows",
               "type": {
                 "text": "readonly KtTableRow[]"
               },
-              "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.",
               "readonly": true
             },
+            {
+              "kind": "method",
+              "name": "sort",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "readonly KtTableRow[]"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "collator",
+                  "type": {
+                    "text": "Intl.Collator"
+                  }
+                }
+              ]
+            },
             {
               "kind": "field",
               "name": "totalPages",
@@ -4452,6 +4577,40 @@
               "description": "The selected rows themselves, not just their identities.",
               "readonly": true
             },
+            {
+              "kind": "field",
+              "name": "isVirtual",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "description": "Virtual rendering, unless a page size pages the rows instead.",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "onScroll",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "observe",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "scroller",
+                  "type": {
+                    "text": "HTMLElement | undefined"
+                  }
+                }
+              ],
+              "description": "Follows the scroller's height, which the page can change at any time."
+            },
             {
               "kind": "method",
               "name": "onPageChange",
@@ -4516,6 +4675,31 @@
                   "text": "TemplateResult"
                 }
               }
+            },
+            {
+              "kind": "method",
+              "name": "renderRow",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "TemplateResult"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "row",
+                  "type": {
+                    "text": "KtTableRow"
+                  }
+                },
+                {
+                  "name": "index",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "description": "`index` counts from the first row of the data, not of the rows rendered."
             }
           ],
           "events": [
@@ -4537,6 +4721,42 @@
             }
           ],
           "attributes": [
+            {
+              "name": "page",
+              "type": {
+                "text": "number"
+              },
+              "default": "1",
+              "description": "The page on screen, from 1. Set it to open on another page.",
+              "fieldName": "page"
+            },
+            {
+              "name": "manual",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "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.",
+              "fieldName": "manual"
+            },
+            {
+              "name": "virtual",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "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.",
+              "fieldName": "virtual"
+            },
+            {
+              "name": "total-rows",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "In manual mode, how many rows the server holds — what the pager counts.",
+              "fieldName": "totalRows"
+            },
             {
               "name": "selectable",
               "type": {
@@ -4618,6 +4838,15 @@
               "default": "''",
               "description": "Accessible name for the table.",
               "fieldName": "label"
+            },
+            {
+              "name": "locale",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "BCP 47 locale text is sorted in. Empty means the page's `<html lang>`,\nthen the browser's language.",
+              "fieldName": "locale"
             }
           ],
           "superclass": {
@@ -4639,6 +4868,40 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "dist/components/data/kt-table/window.js",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "rowWindow",
+          "return": {
+            "type": {
+              "text": "{ start: number; end: number }"
+            }
+          },
+          "parameters": [
+            {
+              "name": "{\n  rowCount,\n  rowHeight,\n  viewportHeight,\n  scrollTop,\n  overscan,\n}",
+              "type": {
+                "text": "RowWindowInput"
+              }
+            }
+          ],
+          "description": "Rows `start` (inclusive) to `end` (exclusive)."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "rowWindow",
+          "declaration": {
+            "name": "rowWindow",
+            "module": "dist/components/data/kt-table/window.js"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "dist/components/data/kt-timeline/kt-timeline.js",
@@ -5962,6 +6225,14 @@
               "privacy": "private",
               "default": "false"
             },
+            {
+              "kind": "field",
+              "name": "bubble",
+              "type": {
+                "text": "HTMLElement"
+              },
+              "privacy": "private"
+            },
             {
               "kind": "field",
               "name": "text",
@@ -5978,9 +6249,21 @@
                 "text": "KtTooltipPlacement"
               },
               "default": "'top'",
+              "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.",
               "attribute": "placement",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "open",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "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.",
+              "attribute": "open",
+              "reflects": true
+            },
             {
               "kind": "field",
               "name": "disabled",
@@ -5992,6 +6275,37 @@
               "attribute": "disabled",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "shown",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "description": "Hovered, focused or held open — and something to say.",
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "openBubble",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Opens the bubble in the top layer, then places it: it has to be open to be\nmeasured. Where popovers are missing — a test DOM — it stays in place."
+            },
+            {
+              "kind": "method",
+              "name": "closeBubble",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
             {
               "kind": "method",
               "name": "syncDescription",
@@ -6035,8 +6349,18 @@
                 "text": "KtTooltipPlacement"
               },
               "default": "'top'",
+              "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.",
               "fieldName": "placement"
             },
+            {
+              "name": "open",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "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.",
+              "fieldName": "open"
+            },
             {
               "name": "disabled",
               "type": {
@@ -6068,138 +6392,137 @@
     },
     {
       "kind": "javascript-module",
-      "path": "dist/components/forms/kt-checkbox/kt-checkbox.js",
+      "path": "dist/components/forms/kt-calendar/kt-calendar.js",
       "declarations": [
         {
           "kind": "class",
-          "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>`.",
-          "name": "KtCheckbox",
+          "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.",
+          "name": "KtCalendar",
           "cssParts": [
             {
-              "description": "The `<label>` around box and text.",
+              "description": "The calendar.",
               "name": "base"
             },
             {
-              "description": "The native checkbox.",
-              "name": "input"
-            },
-            {
-              "description": "The drawn box.",
-              "name": "box"
-            }
-          ],
-          "slots": [
-            {
-              "description": "The label, clickable.",
-              "name": ""
+              "description": "A day cell.",
+              "name": "day"
             }
           ],
           "members": [
             {
               "kind": "field",
-              "name": "formAssociated",
+              "name": "liveId",
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "focusCell",
               "type": {
                 "text": "boolean"
               },
-              "static": true,
-              "readonly": true,
-              "default": "true"
+              "privacy": "private",
+              "default": "false"
             },
             {
               "kind": "field",
-              "name": "input",
+              "name": "committing",
               "type": {
-                "text": "HTMLInputElement | undefined"
+                "text": "boolean"
               },
-              "privacy": "private"
+              "privacy": "private",
+              "default": "false",
+              "description": "Set while the calendar writes its own value, which should not move it."
             },
             {
               "kind": "field",
-              "name": "internals",
+              "name": "view",
               "type": {
-                "text": "UsableInternals | null"
+                "text": "KtCalendarView"
               },
               "privacy": "private",
-              "default": "null"
+              "default": "'day'"
             },
             {
               "kind": "field",
-              "name": "defaultChecked",
+              "name": "month",
               "type": {
-                "text": "boolean"
+                "text": "PlainDate"
               },
               "privacy": "private",
-              "default": "false"
+              "default": "{ ...today(), day: 1 }",
+              "description": "First day of the month the day view shows."
             },
             {
               "kind": "field",
-              "name": "checked",
+              "name": "focused",
               "type": {
-                "text": "boolean"
+                "text": "PlainDate"
               },
-              "default": "false",
-              "attribute": "checked",
-              "reflects": true
+              "privacy": "private",
+              "description": "The day, month or year holding the grid's one tab stop."
             },
             {
               "kind": "field",
-              "name": "indeterminate",
+              "name": "anchor",
               "type": {
-                "text": "boolean"
+                "text": "PlainDate | null"
               },
-              "default": "false",
-              "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.",
-              "attribute": "indeterminate",
-              "reflects": true
+              "privacy": "private",
+              "default": "null",
+              "description": "In a period: the first end chosen, while the second is pending."
             },
             {
               "kind": "field",
-              "name": "disabled",
+              "name": "value",
               "type": {
-                "text": "boolean"
+                "text": "string | null"
               },
-              "default": "false",
-              "attribute": "disabled",
+              "default": "null",
+              "description": "ISO date, or `start/end` interval with `range`. `null` when empty.",
+              "attribute": "value",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "required",
+              "name": "range",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "attribute": "required",
+              "description": "Choose a period — two dates — instead of one day.",
+              "attribute": "range",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "size",
+              "name": "min",
               "type": {
-                "text": "KtCheckboxSize"
+                "text": "string"
               },
-              "default": "'medium'",
-              "attribute": "size",
-              "reflects": true
+              "default": "''",
+              "description": "Earliest date that can be chosen, ISO.",
+              "attribute": "min"
             },
             {
               "kind": "field",
-              "name": "name",
+              "name": "max",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "attribute": "name"
+              "description": "Latest date that can be chosen, ISO.",
+              "attribute": "max"
             },
             {
               "kind": "field",
-              "name": "value",
+              "name": "locale",
               "type": {
                 "text": "string"
               },
-              "default": "'on'",
-              "description": "Submitted when checked, as for a native checkbox.",
-              "attribute": "value"
+              "default": "''",
+              "description": "BCP 47 language tag for names and the first day of the week. Empty: the\npage's `lang`, then the browser's language.",
+              "attribute": "locale"
             },
             {
               "kind": "field",
@@ -6208,32 +6531,158 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "Accessible name, when nothing is slotted.",
+              "description": "Accessible name of the calendar. Defaults to the strings registry.",
               "attribute": "label"
             },
+            {
+              "kind": "method",
+              "name": "focus",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Focuses the grid's current cell — the chosen day, or today."
+            },
             {
               "kind": "field",
-              "name": "error",
+              "name": "resolvedLocale",
               "type": {
                 "text": "string"
               },
-              "default": "''",
-              "description": "Error message. A non-empty value puts the box in its error state.",
-              "attribute": "error",
-              "reflects": true
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "selection",
+              "type": {
+                "text": "{ start: PlainDate | null; end: PlainDate | null }"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "bounds",
+              "type": {
+                "text": "{ min: PlainDate | null; max: PlainDate | null }"
+              },
+              "privacy": "private",
+              "readonly": true
             },
             {
               "kind": "method",
-              "name": "formResetCallback",
+              "name": "clamp",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "PlainDate"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "date",
+                  "type": {
+                    "text": "PlainDate"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "isOutOfBounds",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "date",
+                  "type": {
+                    "text": "PlainDate"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "isSpanOutOfBounds",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "first",
+                  "type": {
+                    "text": "PlainDate"
+                  }
+                },
+                {
+                  "name": "last",
+                  "type": {
+                    "text": "PlainDate"
+                  }
+                }
+              ],
+              "description": "A month or a year is unavailable only when every day of it is."
+            },
+            {
+              "kind": "method",
+              "name": "format",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "options",
+                  "type": {
+                    "text": "Intl.DateTimeFormatOptions"
+                  }
+                },
+                {
+                  "name": "date",
+                  "type": {
+                    "text": "PlainDate"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "jumpTo",
+              "privacy": "private",
               "return": {
                 "type": {
                   "text": "void"
                 }
-              }
+              },
+              "parameters": [
+                {
+                  "name": "date",
+                  "type": {
+                    "text": "PlainDate"
+                  }
+                },
+                {
+                  "name": "focus",
+                  "default": "true"
+                }
+              ],
+              "description": "Moves the tab stop, and the day view with it when it leaves the month."
             },
             {
               "kind": "method",
-              "name": "formStateRestoreCallback",
+              "name": "setView",
+              "privacy": "private",
               "return": {
                 "type": {
                   "text": "void"
@@ -6241,16 +6690,1047 @@
               },
               "parameters": [
                 {
-                  "name": "state",
+                  "name": "view",
                   "type": {
-                    "text": "string | null"
+                    "text": "KtCalendarView"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "chooseDay",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "date",
+                  "type": {
+                    "text": "PlainDate"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "commit",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "value",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "chooseMonth",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "month",
+                  "type": {
+                    "text": "number"
                   }
                 }
               ]
             },
             {
               "kind": "method",
-              "name": "focus",
+              "name": "chooseYear",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "year",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "onDayKeyDown",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "KeyboardEvent"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "onPickerKeyDown",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "KeyboardEvent"
+                  }
+                }
+              ],
+              "description": "Months and years share one model: a list of cells, three to a row."
+            },
+            {
+              "kind": "method",
+              "name": "renderHeader",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "TemplateResult"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "renderDay",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "TemplateResult"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "date",
+                  "type": {
+                    "text": "PlainDate"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "renderDays",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "TemplateResult"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "renderPicker",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "TemplateResult"
+                }
+              },
+              "description": "The month or year grid: twelve cells, three to a row."
+            }
+          ],
+          "events": [
+            {
+              "description": "A day, or a whole period, was chosen. `detail: { value }`.",
+              "name": "kt-change"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "value",
+              "type": {
+                "text": "string | null"
+              },
+              "default": "null",
+              "description": "ISO date, or `start/end` interval with `range`. `null` when empty.",
+              "fieldName": "value"
+            },
+            {
+              "name": "range",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Choose a period — two dates — instead of one day.",
+              "fieldName": "range"
+            },
+            {
+              "name": "min",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Earliest date that can be chosen, ISO.",
+              "fieldName": "min"
+            },
+            {
+              "name": "max",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Latest date that can be chosen, ISO.",
+              "fieldName": "max"
+            },
+            {
+              "name": "locale",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "BCP 47 language tag for names and the first day of the week. Empty: the\npage's `lang`, then the browser's language.",
+              "fieldName": "locale"
+            },
+            {
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Accessible name of the calendar. Defaults to the strings registry.",
+              "fieldName": "label"
+            }
+          ],
+          "superclass": {
+            "name": "KtElement",
+            "module": "dist/components/forms/kt-calendar/kt-calendar.js"
+          },
+          "tagName": "kt-calendar",
+          "customElement": true
+        },
+        {
+          "kind": "variable",
+          "name": "month"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "KtCalendar",
+          "declaration": {
+            "name": "KtCalendar",
+            "module": "dist/components/forms/kt-calendar/kt-calendar.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "dist/components/forms/kt-checkbox/kt-checkbox.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "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>`.",
+          "name": "KtCheckbox",
+          "cssParts": [
+            {
+              "description": "The `<label>` around box and text.",
+              "name": "base"
+            },
+            {
+              "description": "The native checkbox.",
+              "name": "input"
+            },
+            {
+              "description": "The drawn box.",
+              "name": "box"
+            }
+          ],
+          "slots": [
+            {
+              "description": "The label, clickable.",
+              "name": ""
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "formAssociated",
+              "type": {
+                "text": "boolean"
+              },
+              "static": true,
+              "readonly": true,
+              "default": "true"
+            },
+            {
+              "kind": "field",
+              "name": "input",
+              "type": {
+                "text": "HTMLInputElement | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "internals",
+              "type": {
+                "text": "UsableInternals | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "defaultChecked",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "checked",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "checked",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "indeterminate",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "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.",
+              "attribute": "indeterminate",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "disabled",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "formDisabled",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Disabled by an enclosing `<fieldset>`, which leaves `disabled` alone."
+            },
+            {
+              "kind": "field",
+              "name": "inactive",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "description": "Whether the control is off, by its own `disabled` or by its form.",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "required",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "required",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "size",
+              "type": {
+                "text": "KtCheckboxSize"
+              },
+              "default": "'medium'",
+              "attribute": "size",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "name",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "attribute": "name"
+            },
+            {
+              "kind": "field",
+              "name": "value",
+              "type": {
+                "text": "string"
+              },
+              "default": "'on'",
+              "description": "Submitted when checked, as for a native checkbox.",
+              "attribute": "value"
+            },
+            {
+              "kind": "field",
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Accessible name, when nothing is slotted.",
+              "attribute": "label"
+            },
+            {
+              "kind": "field",
+              "name": "error",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Error message. A non-empty value puts the box in its error state.",
+              "attribute": "error",
+              "reflects": true
+            },
+            {
+              "kind": "method",
+              "name": "formResetCallback",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "formDisabledCallback",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "disabled",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ],
+              "description": "Called by the platform when the control's disabled state changes — its\nown `disabled`, or an ancestor `<fieldset disabled>` it cannot see."
+            },
+            {
+              "kind": "method",
+              "name": "formStateRestoreCallback",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "state",
+                  "type": {
+                    "text": "string | null"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "focus",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "options",
+                  "optional": true,
+                  "type": {
+                    "text": "FocusOptions"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "onChange",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ]
+            }
+          ],
+          "events": [
+            {
+              "description": "The box was checked or unchecked. `detail: { checked }`.",
+              "name": "kt-change"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "checked",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "checked"
+            },
+            {
+              "name": "indeterminate",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "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.",
+              "fieldName": "indeterminate"
+            },
+            {
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "disabled"
+            },
+            {
+              "name": "required",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "required"
+            },
+            {
+              "name": "size",
+              "type": {
+                "text": "KtCheckboxSize"
+              },
+              "default": "'medium'",
+              "fieldName": "size"
+            },
+            {
+              "name": "name",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "name"
+            },
+            {
+              "name": "value",
+              "type": {
+                "text": "string"
+              },
+              "default": "'on'",
+              "description": "Submitted when checked, as for a native checkbox.",
+              "fieldName": "value"
+            },
+            {
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Accessible name, when nothing is slotted.",
+              "fieldName": "label"
+            },
+            {
+              "name": "error",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Error message. A non-empty value puts the box in its error state.",
+              "fieldName": "error"
+            }
+          ],
+          "superclass": {
+            "name": "KtElement",
+            "module": "dist/components/forms/kt-checkbox/kt-checkbox.js"
+          },
+          "tagName": "kt-checkbox",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "KtCheckbox",
+          "declaration": {
+            "name": "KtCheckbox",
+            "module": "dist/components/forms/kt-checkbox/kt-checkbox.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "dist/components/forms/kt-date-picker/kt-date-picker.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "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.",
+          "name": "KtDatePicker",
+          "cssParts": [
+            {
+              "description": "The field.",
+              "name": "trigger"
+            },
+            {
+              "description": "The calendar popup.",
+              "name": "panel"
+            },
+            {
+              "description": "The `<kt-calendar>` inside it.",
+              "name": "calendar"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "formAssociated",
+              "type": {
+                "text": "boolean"
+              },
+              "static": true,
+              "readonly": true,
+              "default": "true"
+            },
+            {
+              "kind": "field",
+              "name": "trigger",
+              "type": {
+                "text": "HTMLButtonElement | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "calendar",
+              "type": {
+                "text": "KtCalendar | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "internals",
+              "type": {
+                "text": "UsableInternals | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "defaultValue",
+              "type": {
+                "text": "string | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "panelId",
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "open",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "placement",
+              "type": {
+                "text": "'bottom' | 'top'"
+              },
+              "privacy": "private",
+              "default": "'bottom'"
+            },
+            {
+              "kind": "field",
+              "name": "floating",
+              "privacy": "private",
+              "default": "new FloatingController(this, { panel: () => this.shadowRoot?.querySelector<HTMLElement>('.panel'), anchor: () => this.shadowRoot?.querySelector('.trigger'), onPlace: (side) => { this.placement = side === 'top' ? 'top' : 'bottom'; }, })"
+            },
+            {
+              "kind": "field",
+              "name": "value",
+              "type": {
+                "text": "string | null"
+              },
+              "default": "null",
+              "description": "ISO date, or `start/end` interval with `range`. `null` when empty.",
+              "attribute": "value",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "range",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Choose a period — two dates — instead of one day.",
+              "attribute": "range",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "min",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Earliest date that can be chosen, ISO.",
+              "attribute": "min"
+            },
+            {
+              "kind": "field",
+              "name": "max",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Latest date that can be chosen, ISO.",
+              "attribute": "max"
+            },
+            {
+              "kind": "field",
+              "name": "name",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "attribute": "name"
+            },
+            {
+              "kind": "field",
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Accessible name, when no `<kt-label-input>` wraps the field.",
+              "attribute": "label"
+            },
+            {
+              "kind": "field",
+              "name": "placeholder",
+              "type": {
+                "text": "string | undefined"
+              },
+              "default": "undefined",
+              "description": "Shown while empty. Defaults to the strings registry.",
+              "attribute": "placeholder"
+            },
+            {
+              "kind": "field",
+              "name": "locale",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "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.",
+              "attribute": "locale"
+            },
+            {
+              "kind": "field",
+              "name": "size",
+              "type": {
+                "text": "KtDatePickerSize"
+              },
+              "default": "'medium'",
+              "attribute": "size",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "disabled",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "formDisabled",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Disabled by an enclosing `<fieldset>`, which leaves `disabled` alone."
+            },
+            {
+              "kind": "field",
+              "name": "inactive",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "description": "Whether the control is off, by its own `disabled` or by its form.",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "required",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "required",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "clearable",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "description": "Shows a button that empties the field once it holds a value.",
+              "attribute": "clearable"
+            },
+            {
+              "kind": "field",
+              "name": "error",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Error message. A non-empty value puts the field in its error state.",
+              "attribute": "error",
+              "reflects": true
+            },
+            {
+              "kind": "method",
+              "name": "formResetCallback",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "formDisabledCallback",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "disabled",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ],
+              "description": "Called by the platform when the control's disabled state changes — its\nown `disabled`, or an ancestor `<fieldset disabled>` it cannot see."
+            },
+            {
+              "kind": "method",
+              "name": "formStateRestoreCallback",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "state",
+                  "type": {
+                    "text": "string | null"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "focus",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "options",
+                  "optional": true,
+                  "type": {
+                    "text": "FocusOptions"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "field",
+              "name": "resolvedLocale",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "selection",
+              "type": {
+                "text": "{ start: PlainDate | null; end: PlainDate | null }"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "isComplete",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "display",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string | null"
+                }
+              }
+            },
+            {
+              "kind": "field",
+              "name": "onDocumentPointerDown",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "onFocusOut",
+              "privacy": "private",
+              "description": "Tabbing out of the calendar closes it; moving within it does not."
+            },
+            {
+              "kind": "method",
+              "name": "show",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "close",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "returnFocus",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "toggle",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "onCalendarChange",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "CustomEvent<{ value: string }>"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "clear",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "onTriggerKeyDown",
+              "privacy": "private",
               "return": {
                 "type": {
                   "text": "void"
@@ -6258,17 +7738,16 @@
               },
               "parameters": [
                 {
-                  "name": "options",
-                  "optional": true,
+                  "name": "event",
                   "type": {
-                    "text": "FocusOptions"
+                    "text": "KeyboardEvent"
                   }
                 }
               ]
             },
             {
               "kind": "method",
-              "name": "onChange",
+              "name": "onPanelKeyDown",
               "privacy": "private",
               "return": {
                 "type": {
@@ -6279,7 +7758,7 @@
                 {
                   "name": "event",
                   "type": {
-                    "text": "Event"
+                    "text": "KeyboardEvent"
                   }
                 }
               ]
@@ -6287,77 +7766,114 @@
           ],
           "events": [
             {
-              "description": "The box was checked or unchecked. `detail: { checked }`.",
+              "description": "A date or a whole period was chosen, or the value cleared. `detail: { value }` — the ISO date or interval, or `null`.",
               "name": "kt-change"
             }
           ],
           "attributes": [
             {
-              "name": "checked",
+              "name": "value",
               "type": {
-                "text": "boolean"
+                "text": "string | null"
               },
-              "default": "false",
-              "fieldName": "checked"
+              "default": "null",
+              "description": "ISO date, or `start/end` interval with `range`. `null` when empty.",
+              "fieldName": "value"
             },
             {
-              "name": "indeterminate",
+              "name": "range",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "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.",
-              "fieldName": "indeterminate"
+              "description": "Choose a period — two dates — instead of one day.",
+              "fieldName": "range"
             },
             {
-              "name": "disabled",
+              "name": "min",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "fieldName": "disabled"
+              "default": "''",
+              "description": "Earliest date that can be chosen, ISO.",
+              "fieldName": "min"
             },
             {
-              "name": "required",
+              "name": "max",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "fieldName": "required"
+              "default": "''",
+              "description": "Latest date that can be chosen, ISO.",
+              "fieldName": "max"
             },
             {
-              "name": "size",
+              "name": "name",
               "type": {
-                "text": "KtCheckboxSize"
+                "text": "string"
               },
-              "default": "'medium'",
-              "fieldName": "size"
+              "default": "''",
+              "fieldName": "name"
             },
             {
-              "name": "name",
+              "name": "label",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "fieldName": "name"
+              "description": "Accessible name, when no `<kt-label-input>` wraps the field.",
+              "fieldName": "label"
             },
             {
-              "name": "value",
+              "name": "placeholder",
               "type": {
-                "text": "string"
+                "text": "string | undefined"
               },
-              "default": "'on'",
-              "description": "Submitted when checked, as for a native checkbox.",
-              "fieldName": "value"
+              "default": "undefined",
+              "description": "Shown while empty. Defaults to the strings registry.",
+              "fieldName": "placeholder"
             },
             {
-              "name": "label",
+              "name": "locale",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "description": "Accessible name, when nothing is slotted.",
-              "fieldName": "label"
+              "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.",
+              "fieldName": "locale"
+            },
+            {
+              "name": "size",
+              "type": {
+                "text": "KtDatePickerSize"
+              },
+              "default": "'medium'",
+              "fieldName": "size"
+            },
+            {
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "disabled"
+            },
+            {
+              "name": "required",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "required"
+            },
+            {
+              "name": "clearable",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "description": "Shows a button that empties the field once it holds a value.",
+              "fieldName": "clearable"
             },
             {
               "name": "error",
@@ -6365,25 +7881,25 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "Error message. A non-empty value puts the box in its error state.",
+              "description": "Error message. A non-empty value puts the field in its error state.",
               "fieldName": "error"
             }
           ],
           "superclass": {
             "name": "KtElement",
-            "module": "dist/components/forms/kt-checkbox/kt-checkbox.js"
+            "module": "dist/components/forms/kt-date-picker/kt-date-picker.js"
           },
-          "tagName": "kt-checkbox",
+          "tagName": "kt-date-picker",
           "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "KtCheckbox",
+          "name": "KtDatePicker",
           "declaration": {
-            "name": "KtCheckbox",
-            "module": "dist/components/forms/kt-checkbox/kt-checkbox.js"
+            "name": "KtDatePicker",
+            "module": "dist/components/forms/kt-date-picker/kt-date-picker.js"
           }
         }
       ]
@@ -6521,6 +8037,26 @@
               "attribute": "disabled",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "formDisabled",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Disabled by an enclosing `<fieldset>`, which leaves `disabled` alone."
+            },
+            {
+              "kind": "field",
+              "name": "inactive",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "description": "Whether the control is off, by its own `disabled` or by its form.",
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "name",
@@ -6560,6 +8096,24 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "formDisabledCallback",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "disabled",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ],
+              "description": "Called by the platform when the control's disabled state changes — its\nown `disabled`, or an ancestor `<fieldset disabled>` it cannot see."
+            },
             {
               "kind": "method",
               "name": "formStateRestoreCallback",
@@ -7108,6 +8662,32 @@
               "privacy": "private",
               "default": "''"
             },
+            {
+              "kind": "field",
+              "name": "focused",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "The field has focus: the error tooltip shows for keyboard users too."
+            },
+            {
+              "kind": "field",
+              "name": "errorDismissed",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Escape put the error tooltip away until the field is focused again."
+            },
+            {
+              "kind": "field",
+              "name": "floating",
+              "privacy": "private",
+              "default": "new FloatingController(this, { panel: () => this.shadowRoot?.querySelector<HTMLElement>('.country-panel'), anchor: () => this.shadowRoot?.querySelector('.field'), })"
+            },
             {
               "kind": "field",
               "name": "value",
@@ -7167,6 +8747,26 @@
               "attribute": "disabled",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "formDisabled",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Disabled by an enclosing `<fieldset>`, which leaves `disabled` alone."
+            },
+            {
+              "kind": "field",
+              "name": "inactive",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "description": "Whether the control is off, by its own `disabled` or by its form.",
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "readonly",
@@ -7204,7 +8804,7 @@
                 "text": "string"
               },
               "default": "''",
-              "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.",
               "attribute": "error",
               "reflects": true
             },
@@ -7294,6 +8894,24 @@
               },
               "description": "Called by the platform when the enclosing form is reset."
             },
+            {
+              "kind": "method",
+              "name": "formDisabledCallback",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "disabled",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ],
+              "description": "Called by the platform when the control's disabled state changes — its\nown `disabled`, or an ancestor `<fieldset disabled>` it cannot see."
+            },
             {
               "kind": "method",
               "name": "formStateRestoreCallback",
@@ -7378,6 +8996,36 @@
               "description": "What the form receives. In phone mode that is the full international\nnumber — submitting national digits alone would throw away the country\nthe user picked.",
               "readonly": true
             },
+            {
+              "kind": "field",
+              "name": "formState",
+              "type": {
+                "text": "string | undefined"
+              },
+              "privacy": "private",
+              "description": "What the browser saves for a restore. The international number cannot be\nsplit back into country and digits — `+1` is both the US and Canada — so\nphone mode saves the two apart.",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "phoneError",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "description": "Phone mode: a number typed with the prefix only dialled at home.",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "shownError",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "description": "The message on show: the application's first, then the field's own.",
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "displayValue",
@@ -7475,14 +9123,62 @@
               ]
             },
             {
-              "kind": "method",
-              "name": "renderCountryPicker",
+              "kind": "method",
+              "name": "renderCountryPicker",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "TemplateResult"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "onFocus",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "onBlur",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "onControlKeyDown",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "KeyboardEvent"
+                  }
+                }
+              ],
+              "description": "WCAG 1.4.13: content shown on focus can be dismissed without moving it."
+            },
+            {
+              "kind": "field",
+              "name": "errorTooltipOpen",
+              "type": {
+                "text": "boolean"
+              },
               "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "TemplateResult"
-                }
-              }
+              "readonly": true
             },
             {
               "kind": "method",
@@ -7540,6 +9236,17 @@
                 }
               ],
               "description": "Clicking the padding around the input should focus it, as on a native field."
+            },
+            {
+              "kind": "method",
+              "name": "renderPasswordToggle",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "TemplateResult"
+                }
+              },
+              "description": "Both buttons are out of the tab order, so their tooltips are for the pointer."
             }
           ],
           "events": [
@@ -7639,7 +9346,7 @@
                 "text": "string"
               },
               "default": "''",
-              "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.",
               "fieldName": "error"
             },
             {
@@ -7782,6 +9489,22 @@
               "privacy": "private",
               "default": "false"
             },
+            {
+              "kind": "field",
+              "name": "placement",
+              "type": {
+                "text": "Side"
+              },
+              "privacy": "private",
+              "default": "'bottom'",
+              "description": "The side the list opened on, for the direction of its entrance."
+            },
+            {
+              "kind": "field",
+              "name": "floating",
+              "privacy": "private",
+              "default": "new FloatingController(this, { panel: () => this.shadowRoot?.querySelector<HTMLElement>('.popup'), anchor: () => this.shadowRoot?.querySelector('.control'), matchWidth: true, onPlace: (side) => { this.placement = side; }, })"
+            },
             {
               "kind": "field",
               "name": "query",
@@ -7845,6 +9568,26 @@
               "attribute": "disabled",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "formDisabled",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Disabled by an enclosing `<fieldset>`, which leaves `disabled` alone."
+            },
+            {
+              "kind": "field",
+              "name": "inactive",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "description": "Whether the control is off, by its own `disabled` or by its form.",
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "required",
@@ -7892,6 +9635,24 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "formDisabledCallback",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "disabled",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ],
+              "description": "Called by the platform when the control's disabled state changes — its\nown `disabled`, or an ancestor `<fieldset disabled>` it cannot see."
+            },
             {
               "kind": "method",
               "name": "formStateRestoreCallback",
@@ -8547,6 +10308,26 @@
               "attribute": "disabled",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "formDisabled",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Disabled by an enclosing `<fieldset>`, which leaves `disabled` alone."
+            },
+            {
+              "kind": "field",
+              "name": "inactive",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "description": "Whether the control is off, by its own `disabled` or by its form.",
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "required",
@@ -8587,6 +10368,24 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "formDisabledCallback",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "disabled",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ],
+              "description": "Called by the platform when the control's disabled state changes — its\nown `disabled`, or an ancestor `<fieldset disabled>` it cannot see."
+            },
             {
               "kind": "method",
               "name": "formStateRestoreCallback",
@@ -8828,6 +10627,22 @@
               "privacy": "private",
               "default": "false"
             },
+            {
+              "kind": "field",
+              "name": "placement",
+              "type": {
+                "text": "Side"
+              },
+              "privacy": "private",
+              "default": "'bottom'",
+              "description": "The side the list opened on, for the direction of its entrance."
+            },
+            {
+              "kind": "field",
+              "name": "floating",
+              "privacy": "private",
+              "default": "new FloatingController(this, { panel: () => this.shadowRoot?.querySelector<HTMLElement>('.popup'), anchor: () => this.shadowRoot?.querySelector('.trigger'), matchWidth: true, onPlace: (side) => { this.placement = side; }, })"
+            },
             {
               "kind": "field",
               "name": "activeIndex",
@@ -8895,6 +10710,26 @@
               "attribute": "disabled",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "formDisabled",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Disabled by an enclosing `<fieldset>`, which leaves `disabled` alone."
+            },
+            {
+              "kind": "field",
+              "name": "inactive",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "description": "Whether the control is off, by its own `disabled` or by its form.",
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "required",
@@ -8955,6 +10790,24 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "formDisabledCallback",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "disabled",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ],
+              "description": "Called by the platform when the control's disabled state changes — its\nown `disabled`, or an ancestor `<fieldset disabled>` it cannot see."
+            },
             {
               "kind": "method",
               "name": "formStateRestoreCallback",
@@ -9340,6 +11193,26 @@
               "attribute": "disabled",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "formDisabled",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Disabled by an enclosing `<fieldset>`, which leaves `disabled` alone."
+            },
+            {
+              "kind": "field",
+              "name": "inactive",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "description": "Whether the control is off, by its own `disabled` or by its form.",
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "readonly",
@@ -9401,6 +11274,24 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "formDisabledCallback",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "disabled",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ],
+              "description": "Called by the platform when the control's disabled state changes — its\nown `disabled`, or an ancestor `<fieldset disabled>` it cannot see."
+            },
             {
               "kind": "method",
               "name": "formStateRestoreCallback",
@@ -9680,6 +11571,26 @@
               "attribute": "disabled",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "formDisabled",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Disabled by an enclosing `<fieldset>`, which leaves `disabled` alone."
+            },
+            {
+              "kind": "field",
+              "name": "inactive",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "description": "Whether the control is off, by its own `disabled` or by its form.",
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "size",
@@ -9738,6 +11649,24 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "formDisabledCallback",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "disabled",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ],
+              "description": "Called by the platform when the control's disabled state changes — its\nown `disabled`, or an ancestor `<fieldset disabled>` it cannot see."
+            },
             {
               "kind": "method",
               "name": "formStateRestoreCallback",
@@ -10390,6 +12319,26 @@
               "attribute": "disabled",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "formDisabled",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Disabled by an enclosing `<fieldset>`, which leaves `disabled` alone."
+            },
+            {
+              "kind": "field",
+              "name": "inactive",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "description": "Whether the control is off, by its own `disabled` or by its form.",
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "label",
@@ -10428,6 +12377,24 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "formDisabledCallback",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "disabled",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ],
+              "description": "Called by the platform when the control's disabled state changes — its\nown `disabled`, or an ancestor `<fieldset disabled>` it cannot see."
+            },
             {
               "kind": "method",
               "name": "formStateRestoreCallback",
@@ -11946,6 +13913,12 @@
               "default": "'bottom'",
               "description": "Where the panel actually landed, after checking the room available."
             },
+            {
+              "kind": "field",
+              "name": "floating",
+              "privacy": "private",
+              "default": "new FloatingController(this, { panel: () => this.shadowRoot?.querySelector<HTMLElement>('.panel'), anchor: () => this.triggerWrapper, side: () => this.preferredPlacement, align: () => this.align, onPlace: (side) => { this.placement = side === 'top' ? 'top' : 'bottom'; }, })"
+            },
             {
               "kind": "field",
               "name": "options",
@@ -12015,10 +13988,23 @@
               "readonly": true
             },
             {
-              "kind": "field",
-              "name": "reposition",
+              "kind": "method",
+              "name": "listen",
               "privacy": "private",
-              "description": "Flips the panel above the trigger when there is not enough room below,\npreferring whichever side has more space if neither fits."
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "on",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ],
+              "description": "The outside click and Escape a panel reacts to — only while it is\nopen. A page of closed menus should not run a handler per menu on every\nclick and keystroke."
             },
             {
               "kind": "field",