@kubex/zinc 1.1.184 → 2.0.0

package/dist/web-types.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://raw.githubusercontent.com/JetBrains/web-types/master/schema/web-types.json",
   "name": "@kubex/zinc",
-  "version": "1.1.184",
+  "version": "2.0.0",
   "description-markup": "markdown",
   "contributions": {
     "html": {
@@ -15,34 +15,17 @@
           "events": [],
           "js": { "properties": [], "events": [] }
         },
-        {
-          "name": "zn-action-bar",
-          "description": "Short summary of the component's intended use.\n\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
-          "doc-url": "",
-          "attributes": [],
-          "slots": [
-            { "name": "", "description": "The default slot." },
-            { "name": "example", "description": "An example slot." }
-          ],
-          "events": [
-            { "name": "zn-event-name", "description": "Emitted as an example." }
-          ],
-          "js": {
-            "properties": [],
-            "events": [
-              {
-                "name": "zn-event-name",
-                "description": "Emitted as an example."
-              }
-            ]
-          }
-        },
         {
           "name": "zn-alert",
           "description": "Short summary of the component's intended use.\n\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
           "doc-url": "",
           "attributes": [
             { "name": "icon", "value": { "type": "string", "default": "''" } },
+            {
+              "name": "icon-size",
+              "description": "The status icon's size in pixels.",
+              "value": { "type": "number", "default": "24" }
+            },
             {
               "name": "caption",
               "value": { "type": "string", "default": "''" }
@@ -60,8 +43,9 @@
             },
             {
               "name": "level",
+              "description": "`ai` marks AI-generated content only.",
               "value": {
-                "type": "'primary' | 'error' | 'info' | 'success' | 'warning' | 'note' | 'cosmic'",
+                "type": "'primary' | 'error' | 'info' | 'success' | 'warning' | 'note' | 'cosmic' | 'ai'",
                 "default": "'info'"
               }
             },
@@ -87,12 +71,18 @@
           "js": {
             "properties": [
               { "name": "icon", "type": "string" },
+              {
+                "name": "iconSize",
+                "description": "The status icon's size in pixels.",
+                "type": "number"
+              },
               { "name": "caption", "type": "string" },
               { "name": "collapse", "type": "boolean" },
               { "name": "appearance", "type": "'transparent' | 'solid'" },
               {
                 "name": "level",
-                "type": "'primary' | 'error' | 'info' | 'success' | 'warning' | 'note' | 'cosmic'"
+                "description": "`ai` marks AI-generated content only.",
+                "type": "'primary' | 'error' | 'info' | 'success' | 'warning' | 'note' | 'cosmic' | 'ai'"
               },
               { "name": "center", "type": "boolean" },
               { "name": "size", "type": "'small' | 'medium' | 'large'" }
@@ -105,6 +95,28 @@
             ]
           }
         },
+        {
+          "name": "zn-action-bar",
+          "description": "Short summary of the component's intended use.\n\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
+          "doc-url": "",
+          "attributes": [],
+          "slots": [
+            { "name": "", "description": "The default slot." },
+            { "name": "example", "description": "An example slot." }
+          ],
+          "events": [
+            { "name": "zn-event-name", "description": "Emitted as an example." }
+          ],
+          "js": {
+            "properties": [],
+            "events": [
+              {
+                "name": "zn-event-name",
+                "description": "Emitted as an example."
+              }
+            ]
+          }
+        },
         {
           "name": "zn-animated-button",
           "description": "\n\n---\n\n\n### **Methods:**\n - **purchase(): _void_** - Programmatically trigger the purchase flow\n- **setSuccess(): _void_** - Set the button to success state manually\n- **setFailure(message): _void_** - Set the button to failure state manually with optional error message\n- **reset(): _void_** - Reset the button to idle state",
@@ -250,6 +262,35 @@
             "events": []
           }
         },
+        {
+          "name": "zn-avatar-group",
+          "description": "Overlapping avatars that show each person's name on hover, collapsing any past `max` into a \"+N\" count.\n\n---\n\n\n### **Slots:**\n - _default_ - `zn-icon` avatars. Each one's tooltip shows its `alt`, or its `src` when it has none.\n\n### **CSS Properties:**\n - **--zn-avatar-ring-color** - The ring that separates overlapping avatars; defaults to the panel surface. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **overflow** - The \"+N\" count standing in for the avatars past `max`.",
+          "doc-url": "",
+          "attributes": [
+            {
+              "name": "max",
+              "description": "The most avatars to show; the rest are counted in a \"+N\" avatar whose tooltip lists them. 0 shows them all.",
+              "value": { "type": "number", "default": "0" }
+            }
+          ],
+          "slots": [
+            {
+              "name": "",
+              "description": "`zn-icon` avatars. Each one's tooltip shows its `alt`, or its `src` when it has none."
+            }
+          ],
+          "events": [],
+          "js": {
+            "properties": [
+              {
+                "name": "max",
+                "description": "The most avatars to show; the rest are counted in a \"+N\" avatar whose tooltip lists them. 0 shows them all.",
+                "type": "number"
+              }
+            ],
+            "events": []
+          }
+        },
         {
           "name": "zn-background",
           "description": "Composes a colour, decorative image, image strength, optional motion and contrast overlay behind slotted content.\n\n---\n\n\n### **Slots:**\n - _default_ - Content displayed above the background layers.\n\n### **CSS Properties:**\n - **--zn-background-color** - Fallback colour when the `color` attribute is not set. _(default: undefined)_\n- **--zn-background-image-position** - Position of the background image. Defaults to `center`. _(default: undefined)_\n- **--zn-background-overlay-angle** - Direction of the overlay gradient. Defaults to `110deg`. _(default: undefined)_\n- **--zn-background-floating-icon-color** - Colour of the floating icons. Defaults to `currentColor`. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's full-size background canvas.\n- **image** - The decorative background image.\n- **overlay** - The contrast overlay between the image and content.\n- **floating-icons** - The non-interactive layer containing the floating icons.\n- **floating-icon** - Each floating `zn-icon`.\n- **content** - The wrapper around the default slot.",
@@ -352,6 +393,58 @@
             "events": []
           }
         },
+        {
+          "name": "zn-badge",
+          "description": "Badges label the status or category of a record, such as \"Active\" or \"Past due\".\n\n---\n\n\n### **Slots:**\n - _default_ - The badge's label.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
+          "doc-url": "",
+          "attributes": [
+            {
+              "name": "type",
+              "description": "`ai` marks AI-generated content only.",
+              "value": {
+                "type": "'neutral' | 'success' | 'warning' | 'danger' | 'info' | 'ai'",
+                "default": "'neutral'"
+              }
+            },
+            {
+              "name": "size",
+              "value": { "type": "'medium' | 'large'", "default": "'medium'" }
+            },
+            {
+              "name": "solid",
+              "description": "Fills the badge with its type colour.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "dot",
+              "description": "Leads the label with a dot in the type colour.",
+              "value": { "type": "boolean", "default": "false" }
+            }
+          ],
+          "slots": [{ "name": "", "description": "The badge's label." }],
+          "events": [],
+          "js": {
+            "properties": [
+              {
+                "name": "type",
+                "description": "`ai` marks AI-generated content only.",
+                "type": "'neutral' | 'success' | 'warning' | 'danger' | 'info' | 'ai'"
+              },
+              { "name": "size", "type": "'medium' | 'large'" },
+              {
+                "name": "solid",
+                "description": "Fills the badge with its type colour.",
+                "type": "boolean"
+              },
+              {
+                "name": "dot",
+                "description": "Leads the label with a dot in the type colour.",
+                "type": "boolean"
+              }
+            ],
+            "events": []
+          }
+        },
         {
           "name": "zn-bulk-actions",
           "description": "Short summary of the component's intended use.\n\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
@@ -392,16 +485,24 @@
         },
         {
           "name": "zn-button",
-          "description": "Buttons represent actions that are available to the user.\n\n---\n\n\n### **Events:**\n - **zn-blur** - Emitted when the button loses focus.\n- **zn-focus** - Emitted when the button gains focus.\n- **zn-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Slots:**\n - _default_ - The button's label.\n- **prefix** - A presentational prefix icon or similar element.\n- **suffix** - A presentational suffix icon or similar element.\n- **cancel** - Slot for custom cancel button/content when autoClick is active.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **prefix** - The container that wraps the prefix.\n- **label** - The button's label.\n- **suffix** - The container that wraps the suffix.\n- **caret** - The button's caret icon, an `<zn-icon>` element.\n- **spinner** - The spinner that shows when the button is in the loading state.",
+          "description": "Buttons represent actions that are available to the user.\n\n---\n\n\n### **Events:**\n - **zn-blur** - Emitted when the button loses focus.\n- **zn-focus** - Emitted when the button gains focus.\n- **zn-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\n - **showMenu()** - Opens the advanced options in the `menu` slot.\n- **hideMenu()** - Closes the advanced options in the `menu` slot.\n\n### **Slots:**\n - _default_ - The button's label.\n- **prefix** - A presentational prefix icon or similar element.\n- **suffix** - A presentational suffix icon or similar element.\n- **cancel** - Slot for custom cancel button/content when autoClick is active.\n- **menu** - A `<zn-menu>` of advanced options, opened by a long press, a right click, or ArrowDown on the button.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **prefix** - The container that wraps the prefix.\n- **label** - The button's label.\n- **suffix** - The container that wraps the suffix.\n- **caret** - The button's caret icon, an `<zn-icon>` element.\n- **spinner** - The spinner that shows when the button is in the loading state.",
           "doc-url": "",
           "attributes": [
             {
               "name": "color",
+              "description": "`ai` is reserved for actions that invoke or act on AI-generated content.",
               "value": {
-                "type": "'default' | 'primary' | 'secondary' | 'error' | 'info' | 'success' | 'warning' |\n    'transparent' | 'star' | (string & Record<never, never>)",
+                "type": "'default' | 'primary' | 'secondary' | 'error' | 'info' | 'success' | 'warning' | 'ai' |\n    'transparent' | 'star' | (string & Record<never, never>)",
                 "default": "'default'"
               }
             },
+            {
+              "name": "size",
+              "value": {
+                "type": "'small' | 'medium' | 'large'",
+                "default": "'medium'"
+              }
+            },
             { "name": "hover-color", "value": { "type": "string" } },
             {
               "name": "text",
@@ -411,6 +512,11 @@
               "name": "outline",
               "value": { "type": "boolean", "default": "false" }
             },
+            {
+              "name": "solid",
+              "description": "Keeps the filled look where a container forces `text`, such as a page header's action menu.",
+              "value": { "type": "boolean", "default": "false" }
+            },
             {
               "name": "disabled",
               "value": { "type": "boolean", "default": "false" }
@@ -450,6 +556,19 @@
               "name": "panel-bg",
               "value": { "type": "boolean", "default": "false" }
             },
+            {
+              "name": "long-press-delay",
+              "description": "How long, in milliseconds, the button must be held to open the `menu` slot.",
+              "value": { "type": "number", "default": "500" }
+            },
+            {
+              "name": "menu-placement",
+              "description": "Where the `menu` slot opens relative to the button.",
+              "value": {
+                "type": "'top' | 'top-start' | 'top-end' | 'right' | 'right-start' |\n    'right-end' | 'bottom' | 'bottom-start' | 'bottom-end' | 'left' | 'left-start' | 'left-end'",
+                "default": "'bottom-start'"
+              }
+            },
             {
               "name": "dropdown-closer",
               "value": { "type": "boolean", "default": "false" }
@@ -525,6 +644,16 @@
               "description": "Toggle state, forwarded to the inner button's `aria-pressed`.",
               "value": { "type": "'true' | 'false' | 'mixed'" }
             },
+            {
+              "name": "aria-expanded",
+              "description": "Popup state, forwarded to the inner button's `aria-expanded`.",
+              "value": { "type": "'true' | 'false'" }
+            },
+            {
+              "name": "aria-haspopup",
+              "description": "Popup type, forwarded to the inner button's `aria-haspopup`.",
+              "value": { "type": "string" }
+            },
             {
               "name": "auto-click",
               "value": { "type": "boolean", "default": "false" }
@@ -547,6 +676,16 @@
             {
               "name": "loading",
               "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "processing",
+              "description": "Shows a spinner and ignores clicks, e.g. while a request is in flight.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "processing-text",
+              "description": "Replaces the label while processing.",
+              "value": { "type": "string", "default": "''" }
             }
           ],
           "slots": [
@@ -562,6 +701,10 @@
             {
               "name": "cancel",
               "description": "Slot for custom cancel button/content when autoClick is active."
+            },
+            {
+              "name": "menu",
+              "description": "A `<zn-menu>` of advanced options, opened by a long press, a right click, or ArrowDown on the button."
             }
           ],
           "events": [
@@ -581,14 +724,22 @@
           "js": {
             "properties": [
               { "name": "button", "type": "HTMLButtonElement" },
+              { "name": "menuDropdown", "type": "ZnDropdown" },
               { "name": "countdownContainer", "type": "HTMLElement[]" },
               {
                 "name": "color",
-                "type": "'default' | 'primary' | 'secondary' | 'error' | 'info' | 'success' | 'warning' |\n    'transparent' | 'star' | (string & Record<never, never>)"
+                "description": "`ai` is reserved for actions that invoke or act on AI-generated content.",
+                "type": "'default' | 'primary' | 'secondary' | 'error' | 'info' | 'success' | 'warning' | 'ai' |\n    'transparent' | 'star' | (string & Record<never, never>)"
               },
+              { "name": "size", "type": "'small' | 'medium' | 'large'" },
               { "name": "hoverColor", "type": "string" },
               { "name": "text", "type": "boolean" },
               { "name": "outline", "type": "boolean" },
+              {
+                "name": "solid",
+                "description": "Keeps the filled look where a container forces `text`, such as a page header's action menu.",
+                "type": "boolean"
+              },
               { "name": "disabled", "type": "boolean" },
               { "name": "grow", "type": "boolean" },
               { "name": "square", "type": "boolean" },
@@ -613,6 +764,16 @@
                 "type": "boolean"
               },
               { "name": "panelBackground", "type": "boolean" },
+              {
+                "name": "longPressDelay",
+                "description": "How long, in milliseconds, the button must be held to open the `menu` slot.",
+                "type": "number"
+              },
+              {
+                "name": "menuPlacement",
+                "description": "Where the `menu` slot opens relative to the button.",
+                "type": "'top' | 'top-start' | 'top-end' | 'right' | 'right-start' |\n    'right-end' | 'bottom' | 'bottom-start' | 'bottom-end' | 'left' | 'left-start' | 'left-end'"
+              },
               { "name": "dropdownCloser", "type": "boolean" },
               { "name": "notification", "type": "number" },
               { "name": "mutedNotifications", "type": "boolean" },
@@ -658,6 +819,16 @@
                 "description": "Toggle state, forwarded to the inner button's `aria-pressed`.",
                 "type": "'true' | 'false' | 'mixed'"
               },
+              {
+                "name": "expanded",
+                "description": "Popup state, forwarded to the inner button's `aria-expanded`.",
+                "type": "'true' | 'false'"
+              },
+              {
+                "name": "hasPopup",
+                "description": "Popup type, forwarded to the inner button's `aria-haspopup`.",
+                "type": "string"
+              },
               { "name": "autoClick", "type": "boolean" },
               { "name": "autoClickDelay", "type": "number" },
               { "name": "loadingText", "type": "string" },
@@ -666,6 +837,16 @@
                 "type": "'left' | 'right' | 'center' | string"
               },
               { "name": "loading", "type": "boolean" },
+              {
+                "name": "processing",
+                "description": "Shows a spinner and ignores clicks, e.g. while a request is in flight.",
+                "type": "boolean"
+              },
+              {
+                "name": "processingText",
+                "description": "Replaces the label while processing.",
+                "type": "string"
+              },
               { "name": "validity" },
               { "name": "validationMessage" },
               { "name": "handleClick" }
@@ -748,7 +929,7 @@
         },
         {
           "name": "zn-button-menu",
-          "description": "Automatically hides buttons in a menu when the screen is too small.\n\n---\n\n\n### **Slots:**\n - _default_ - The default slot.",
+          "description": "Automatically hides buttons in a menu when the screen is too small.\n\n---\n\n\n### **Slots:**\n - _default_ - The default slot.\n- **prefix** - Controls shown just before the inline buttons, such as a segmented toggle. Their width is kept free when working out which buttons fit.",
           "doc-url": "",
           "attributes": [
             { "name": "max-width", "value": { "type": "number" } },
@@ -760,12 +941,18 @@
             },
             {
               "name": "icon-size",
-              "value": { "type": "number", "default": "20" }
+              "value": { "type": "number", "default": "16" }
             },
             { "name": "no-gap", "value": { "type": "boolean" } },
             { "name": "no-padding", "value": { "type": "boolean" } }
           ],
-          "slots": [{ "name": "", "description": "The default slot." }],
+          "slots": [
+            { "name": "", "description": "The default slot." },
+            {
+              "name": "prefix",
+              "description": "Controls shown just before the inline buttons, such as a segmented toggle. Their width is kept free when working out which buttons fit."
+            }
+          ],
           "events": [],
           "js": {
             "properties": [
@@ -1025,7 +1212,7 @@
         },
         {
           "name": "zn-chart",
-          "description": "Chart component powered by Apache ECharts.\n\n---\n\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
+          "description": "Chart component powered by Apache ECharts.\n\n---\n\n\n### **Events:**\n - **zn-chart-click** - Emitted when a data point, bar or slice is clicked.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
           "doc-url": "",
           "attributes": [
             {
@@ -1063,6 +1250,7 @@
             },
             {
               "name": "data-url",
+              "description": "JSON series polled with `live`; otherwise fetched once, as a series array or `{categories, data}`.",
               "value": { "type": "string", "default": "''" }
             },
             {
@@ -1110,12 +1298,22 @@
             },
             { "name": "min-value", "value": { "type": "number | undefined" } },
             { "name": "max-value", "value": { "type": "number | undefined" } },
+            {
+              "name": "mark-latest",
+              "description": "On line and area charts, marks each series' latest point and hides the rest.",
+              "value": { "type": "boolean", "default": "false" }
+            },
             {
               "name": "scale",
               "value": { "type": "boolean | number", "default": "false" }
             }
           ],
-          "events": [],
+          "events": [
+            {
+              "name": "zn-chart-click",
+              "description": "Emitted when a data point, bar or slice is clicked."
+            }
+          ],
           "js": {
             "properties": [
               { "name": "type", "type": "ChartType" },
@@ -1130,7 +1328,11 @@
               { "name": "datapointSize", "type": "number" },
               { "name": "stacked", "type": "boolean" },
               { "name": "live", "type": "boolean" },
-              { "name": "dataUrl", "type": "string" },
+              {
+                "name": "dataUrl",
+                "description": "JSON series polled with `live`; otherwise fetched once, as a series array or `{categories, data}`.",
+                "type": "string"
+              },
               { "name": "streamUrl", "type": "string" },
               { "name": "liveRenewUrl", "type": "string" },
               { "name": "hideZero", "type": "boolean" },
@@ -1146,14 +1348,24 @@
               { "name": "showLabels", "type": "boolean | undefined" },
               { "name": "minValue", "type": "number | undefined" },
               { "name": "maxValue", "type": "number | undefined" },
+              {
+                "name": "markLatest",
+                "description": "On line and area charts, marks each series' latest point and hides the rest.",
+                "type": "boolean"
+              },
               { "name": "scale", "type": "boolean | number" }
             ],
-            "events": []
+            "events": [
+              {
+                "name": "zn-chart-click",
+                "description": "Emitted when a data point, bar or slice is clicked."
+              }
+            ]
           }
         },
         {
           "name": "zn-chat-message",
-          "description": "A single message in a chat-style conversation: avatar, sender,\ntime, optional badge, and a message bubble with optional actions. Also renders\nsystem events (connections, transfers, etc.) as a centred card.\n\n---\n\n\n### **Slots:**\n - _default_ - The message content. Ignored when the `message` attribute is set.\n- **badge** - Rendered in the header after the sender and time (e.g. an INTERNAL NOTE chip).\n- **attachments** - Attachments displayed beneath the message content. Use `zn-chat-message-attachment`, which auto-assigns itself to this slot.\n- **edit-dialog-trigger** - Action rendered at the end of the bubble (e.g. a remove icon button).\n- **edit-dialog** - Pass-through for an associated dialog element.\n\n### **CSS Properties:**\n - **--message-background** - The bubble's background color. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **avatar** - The avatar column.\n- **body** - The header and bubble column.\n- **header** - The sender/time/badge row.\n- **bubble** - The message bubble.\n- **content** - The message content within the bubble.\n- **attachments** - The attachments row beneath the message content.\n- **system-card** - The card rendered for system action types.",
+          "description": "A single message in a chat-style conversation: avatar, sender,\ntime, optional badge, and a message bubble with optional actions. Also renders\nsystem events (connections, transfers, etc.) as a centred card.\n\n---\n\n\n### **Slots:**\n - _default_ - The message content. Ignored when the `message` attribute is set.\n- **badge** - Rendered in the header after the sender and time (e.g. an INTERNAL NOTE chip).\n- **attachments** - Attachments displayed beneath the message content. Use `zn-chat-message-attachment`, which auto-assigns itself to this slot.\n- **footer** - Content beneath the bubble, such as reactions or a thread summary.\n- **edit-dialog-trigger** - Action rendered at the end of the bubble (e.g. a remove icon button).\n- **edit-dialog** - Pass-through for an associated dialog element.\n\n### **CSS Properties:**\n - **--message-background** - The bubble's background color. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **avatar** - The avatar column.\n- **body** - The header and bubble column.\n- **header** - The sender/time/badge row.\n- **bubble** - The message bubble.\n- **content** - The message content within the bubble.\n- **attachments** - The attachments row beneath the message content.\n- **footer** - The row beneath the bubble.\n- **system-card** - The card rendered for system action types.",
           "doc-url": "",
           "attributes": [
             {
@@ -1210,6 +1422,10 @@
               "name": "attachments",
               "description": "Attachments displayed beneath the message content. Use `zn-chat-message-attachment`, which auto-assigns itself to this slot."
             },
+            {
+              "name": "footer",
+              "description": "Content beneath the bubble, such as reactions or a thread summary."
+            },
             {
               "name": "edit-dialog-trigger",
               "description": "Action rendered at the end of the bubble (e.g. a remove icon button)."
@@ -1394,6 +1610,11 @@
               "description": "Squares off the corners of the container drawn by `contained`, which is rounded by default.",
               "value": { "type": "boolean", "default": "false" }
             },
+            {
+              "name": "centered",
+              "description": "Centres the text of a contained checkbox that has no image or `card-title`.",
+              "value": { "type": "boolean", "default": "false" }
+            },
             {
               "name": "src",
               "description": "URL for the image shown in a contained checkbox.",
@@ -1414,7 +1635,7 @@
             },
             {
               "name": "control-position",
-              "description": "Places the checkbox indicator within a contained card. Use `none` to hide the indicator so the card itself\nshows the selected state. Requires `contained`.",
+              "description": "Places the checkbox indicator within a contained card. A contained checkbox without an image or `card-title` hides it\nat `start`, as does `none`. Requires `contained`.",
               "value": {
                 "type": "SelectionCardControlPosition",
                 "default": "'start'"
@@ -1459,7 +1680,7 @@
             },
             {
               "name": "unchecked-icon",
-              "description": "The icon to show when the checkbox is unchecked.",
+              "description": "The icon to show when the checkbox is unchecked. Defaults to a muted `checked-icon`.",
               "value": { "type": "string", "default": "''" }
             },
             {
@@ -1518,6 +1739,7 @@
           "js": {
             "properties": [
               { "name": "input", "type": "HTMLInputElement" },
+              { "name": "control", "type": "HTMLElement" },
               { "name": "title", "type": "string" },
               {
                 "name": "name",
@@ -1569,6 +1791,11 @@
                 "description": "Squares off the corners of the container drawn by `contained`, which is rounded by default.",
                 "type": "boolean"
               },
+              {
+                "name": "centered",
+                "description": "Centres the text of a contained checkbox that has no image or `card-title`.",
+                "type": "boolean"
+              },
               {
                 "name": "src",
                 "description": "URL for the image shown in a contained checkbox.",
@@ -1586,7 +1813,7 @@
               },
               {
                 "name": "controlPosition",
-                "description": "Places the checkbox indicator within a contained card. Use `none` to hide the indicator so the card itself\nshows the selected state. Requires `contained`.",
+                "description": "Places the checkbox indicator within a contained card. A contained checkbox without an image or `card-title` hides it\nat `start`, as does `none`. Requires `contained`.",
                 "type": "SelectionCardControlPosition"
               },
               {
@@ -1633,7 +1860,7 @@
               },
               {
                 "name": "uncheckedIcon",
-                "description": "The icon to show when the checkbox is unchecked.",
+                "description": "The icon to show when the checkbox is unchecked. Defaults to a muted `checked-icon`.",
                 "type": "string"
               },
               {
@@ -1738,6 +1965,11 @@
               "description": "Squares off the corners of every contained checkbox in the group, which are rounded by default.",
               "value": { "type": "boolean", "default": "false" }
             },
+            {
+              "name": "centered",
+              "description": "Centres the text of every contained checkbox in the group.",
+              "value": { "type": "boolean", "default": "false" }
+            },
             {
               "name": "wrap",
               "description": "Lays horizontal contained checkboxes out as a wrapping row instead of an equal-width grid, so each one sizes from\n`--zn-checkbox-group-column-width` (set it to `auto` to size from content) and wraps onto a new line when needed.",
@@ -1835,6 +2067,11 @@
                 "description": "Squares off the corners of every contained checkbox in the group, which are rounded by default.",
                 "type": "boolean"
               },
+              {
+                "name": "centered",
+                "description": "Centres the text of every contained checkbox in the group.",
+                "type": "boolean"
+              },
               {
                 "name": "wrap",
                 "description": "Lays horizontal contained checkboxes out as a wrapping row instead of an equal-width grid, so each one sizes from\n`--zn-checkbox-group-column-width` (set it to `auto` to size from content) and wraps onto a new line when needed.",
@@ -1891,11 +2128,22 @@
             },
             {
               "name": "type",
+              "description": "`ai` marks AI-generated content only.",
               "value": {
-                "type": "'info' | 'success' | 'warning' | 'error' | 'primary' |\n    'transparent' | 'custom' | 'neutral'",
+                "type": "'info' | 'success' | 'warning' | 'error' | 'primary' | 'ai' |\n    'transparent' | 'custom' | 'neutral'",
                 "default": "'neutral'"
               }
             },
+            {
+              "name": "solid",
+              "description": "Fills the chip with its type colour.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "dot",
+              "description": "Leads the label with a dot in the type colour.",
+              "value": { "type": "boolean", "default": "false" }
+            },
             {
               "name": "flush",
               "value": { "type": "boolean", "default": "false" }
@@ -1923,7 +2171,18 @@
               { "name": "iconSize", "type": "number" },
               {
                 "name": "type",
-                "type": "'info' | 'success' | 'warning' | 'error' | 'primary' |\n    'transparent' | 'custom' | 'neutral'"
+                "description": "`ai` marks AI-generated content only.",
+                "type": "'info' | 'success' | 'warning' | 'error' | 'primary' | 'ai' |\n    'transparent' | 'custom' | 'neutral'"
+              },
+              {
+                "name": "solid",
+                "description": "Fills the chip with its type colour.",
+                "type": "boolean"
+              },
+              {
+                "name": "dot",
+                "description": "Leads the label with a dot in the type colour.",
+                "type": "boolean"
               },
               { "name": "flush", "type": "boolean" },
               { "name": "flushX", "type": "boolean" },
@@ -1998,11 +2257,61 @@
               { "name": "numberOfItems", "type": "number" },
               { "name": "handleCaptionToggle" },
               { "name": "handleCollapse" },
+              { "name": "handleHeaderKeyDown" },
               { "name": "recalculateNumberOfItems" }
             ],
             "events": []
           }
         },
+        {
+          "name": "zn-color-picker",
+          "description": "A colour panel: a saturation/brightness area, a hue slider and the colour's HEX, RGB, HSL and OKLCH values.\n\n---\n\n\n### **Events:**\n - **zn-input** - Emitted when the colour or the format being worked in changes.\n\n### **Methods:**\n - **focus(options: _FocusOptions_)** - Moves focus to the colour area.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
+          "doc-url": "",
+          "attributes": [
+            {
+              "name": "value",
+              "description": "The colour, in any CSS colour syntax. Reads back as `#RRGGBB`.",
+              "value": { "type": "string", "default": "'#000000'" }
+            },
+            {
+              "name": "format",
+              "description": "The format being worked in. Focusing or editing a row switches to that row's format.",
+              "value": { "type": "ColorFormat", "default": "'hex'" }
+            },
+            {
+              "name": "label",
+              "value": { "type": "string", "default": "'Colour'" }
+            }
+          ],
+          "events": [
+            {
+              "name": "zn-input",
+              "description": "Emitted when the colour or the format being worked in changes."
+            }
+          ],
+          "js": {
+            "properties": [
+              { "name": "area", "type": "HTMLElement" },
+              {
+                "name": "value",
+                "description": "The colour, in any CSS colour syntax. Reads back as `#RRGGBB`.",
+                "type": "string"
+              },
+              {
+                "name": "format",
+                "description": "The format being worked in. Focusing or editing a row switches to that row's format.",
+                "type": "ColorFormat"
+              },
+              { "name": "label", "type": "string" }
+            ],
+            "events": [
+              {
+                "name": "zn-input",
+                "description": "Emitted when the colour or the format being worked in changes."
+              }
+            ]
+          }
+        },
         {
           "name": "zn-color-select",
           "description": "A simple color picker. The dropdown lists color swatches with names; the closed control shows only the selected color's swatch.\n\n---\n\n\n### **Events:**\n - **zn-input** - Emitted when the selected color changes.\n- **zn-clear** - Emitted when the clear button is activated.\n\n### **CSS Parts:**\n - **swatch** - The color swatch shown in the closed control.\n- **combobox** - The container that wraps the swatch and expand button (forwarded from zn-select).\n- **form-control-help-text** - The help text's wrapper (forwarded from zn-select).\n- **form-control-input** - The select's wrapper (forwarded from zn-select).",
@@ -2123,9 +2432,14 @@
             },
             { "name": "mc", "value": { "type": "number", "default": "0" } },
             {
-              "name": "no-gap",
-              "value": { "type": "boolean", "default": "false" }
-            },
+              "name": "basis",
+              "description": "Minimum width in px of a one-unit column before the row wraps; a column of layout `n` asks for n times this. Defaults to 250.",
+              "value": { "type": "number" }
+            },
+            {
+              "name": "no-gap",
+              "value": { "type": "boolean", "default": "false" }
+            },
             {
               "name": "border",
               "value": { "type": "boolean", "default": "false" }
@@ -2154,6 +2468,11 @@
                 "type": "string"
               },
               { "name": "maxColumns", "type": "number" },
+              {
+                "name": "basis",
+                "description": "Minimum width in px of a one-unit column before the row wraps; a column of layout `n` asks for n times this. Defaults to 250.",
+                "type": "number"
+              },
               { "name": "noGap", "type": "boolean" },
               { "name": "border", "type": "boolean" },
               { "name": "pad", "type": "boolean" },
@@ -2216,15 +2535,15 @@
               "value": { "type": "string", "default": "''" }
             },
             {
-              "name": "confirmText",
+              "name": "confirm-text",
               "value": { "type": "string", "default": "\"Confirm\"" }
             },
             {
-              "name": "cancelText",
+              "name": "cancel-text",
               "value": { "type": "string", "default": "\"Cancel\"" }
             },
             {
-              "name": "closeText",
+              "name": "close-text",
               "value": { "type": "string", "default": "\"Close\"" }
             },
             {
@@ -2383,7 +2702,7 @@
               "value": { "type": "string", "default": "''" }
             },
             { "name": "src", "value": { "type": "string", "default": "''" } },
-            { "name": "size", "value": { "type": "number", "default": "24" } },
+            { "name": "size", "value": { "type": "number", "default": "16" } },
             {
               "name": "from",
               "description": "An id that references an element in the same document from which data will be copied. If both this and `value` are\npresent, this value will take precedence. By default, the target element's `textContent` will be copied. To copy an\nattribute, append the attribute name wrapped in square brackets, e.g. `from=\"el[value]\"`. To copy a property,\nappend a dot and the property name, e.g. `from=\"el.value\"`.",
@@ -2766,6 +3085,40 @@
               "name": "empty-state-icon",
               "value": { "type": "string", "default": "\"data_alert\"" }
             },
+            {
+              "name": "total-label",
+              "description": "Unit for the row total shown with the caption: \"publishers\" reads \"16 publishers\".",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "total-label-singular",
+              "description": "Unit used when the total is exactly one: \"publisher\" reads \"1 publisher\". Falls back to `total-label`.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "tabs",
+              "description": "Tabs rendered inside the table. The selected tab's value is sent as `tab-param` with every request.",
+              "value": { "type": "TableTab[]", "default": "[]" }
+            },
+            {
+              "name": "tab-param",
+              "value": { "type": "string", "default": "'tab'" }
+            },
+            {
+              "name": "pill-tabs",
+              "description": "Draws the tabs as a segmented control: a grey track with a pill that slides to the selected tab.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "active-tab",
+              "description": "The selected tab's value; the first tab when empty.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "filter-fields",
+              "description": "Fields for the funnel's filter builder. When set, the table renders its own zn-data-table-filter in the\nheader, in place of the `filter` slot, and the applied rules show as chips under the tabs. Rules are sent\nas `filter`.",
+              "value": { "type": "FilterField[]", "default": "[]" }
+            },
             { "name": "filters", "value": { "type": "[]", "default": "[]" } },
             {
               "name": "method",
@@ -2873,6 +3226,37 @@
               { "name": "caption", "type": "string" },
               { "name": "emptyStateCaption", "type": "string" },
               { "name": "emptyStateIcon", "type": "string" },
+              {
+                "name": "totalLabel",
+                "description": "Unit for the row total shown with the caption: \"publishers\" reads \"16 publishers\".",
+                "type": "string"
+              },
+              {
+                "name": "totalLabelSingular",
+                "description": "Unit used when the total is exactly one: \"publisher\" reads \"1 publisher\". Falls back to `total-label`.",
+                "type": "string"
+              },
+              {
+                "name": "tabs",
+                "description": "Tabs rendered inside the table. The selected tab's value is sent as `tab-param` with every request.",
+                "type": "TableTab[]"
+              },
+              { "name": "tabParam", "type": "string" },
+              {
+                "name": "pillTabs",
+                "description": "Draws the tabs as a segmented control: a grey track with a pill that slides to the selected tab.",
+                "type": "boolean"
+              },
+              {
+                "name": "tab",
+                "description": "The selected tab's value; the first tab when empty.",
+                "type": "string"
+              },
+              {
+                "name": "filterFields",
+                "description": "Fields for the funnel's filter builder. When set, the table renders its own zn-data-table-filter in the\nheader, in place of the `filter` slot, and the applied rules show as chips under the tabs. Rules are sent\nas `filter`.",
+                "type": "FilterField[]"
+              },
               { "name": "filters", "type": "[]" },
               { "name": "method", "type": "'GET' | 'POST'" },
               { "name": "noInitialLoad", "type": "boolean" },
@@ -2890,7 +3274,6 @@
               { "name": "groups", "type": "string" },
               { "name": "itemsPerPage", "type": "number" },
               { "name": "requestParams", "type": "Record<string, any>" },
-              { "name": "filterClearListener" },
               { "name": "filterChangeListener" },
               { "name": "searchChangeListener" }
             ],
@@ -2899,12 +3282,12 @@
         },
         {
           "name": "zn-data-table-filter",
-          "description": "An inline filter bar for data tables. Each active filter is a pill whose dropdown sets its value.\n\n---\n\n\n### **Events:**\n - **zn-filter-change** - Emitted when the active filters change. Read the encoded query off `value`.\n\n### **Methods:**\n - **clear()** - Removes every active filter.",
+          "description": "The filter for data tables: a funnel that opens a field / operator / value builder, and chips for the\nrules that apply.\n\n---\n\n\n### **Events:**\n - **zn-filter-change** - Emitted when the applied rules change. Read the encoded query off `value`.\n- **zn-clear** - Emitted when `clear()` removes every rule.\n\n### **Methods:**\n - **show()** - Opens the filter builder.\n- **hide()** - Closes the filter builder.\n- **clear()** - Removes every rule.",
           "doc-url": "",
           "attributes": [
             {
               "name": "filters",
-              "value": { "type": "QueryBuilderData", "default": "[]" }
+              "value": { "type": "FilterField[]", "default": "[]" }
             },
             {
               "name": "name",
@@ -2913,43 +3296,56 @@
             { "name": "value", "value": { "type": "string", "default": "''" } },
             {
               "name": "default-filters",
-              "description": "Filter keys to show a pill for before the user adds any.",
+              "description": "Fields to offer an empty rule for when the builder opens with nothing applied.",
               "value": { "type": "string", "default": "''" }
             }
           ],
           "events": [
             {
               "name": "zn-filter-change",
-              "description": "Emitted when the active filters change. Read the encoded query off `value`."
+              "description": "Emitted when the applied rules change. Read the encoded query off `value`."
+            },
+            {
+              "name": "zn-clear",
+              "description": "Emitted when `clear()` removes every rule."
             }
           ],
           "js": {
             "properties": [
-              { "name": "filters", "type": "QueryBuilderData" },
+              { "name": "filters", "type": "FilterField[]" },
               { "name": "name", "type": "string" },
               { "name": "value", "type": "string" },
               {
                 "name": "defaultFilters",
-                "description": "Filter keys to show a pill for before the user adds any.",
+                "description": "Fields to offer an empty rule for when the builder opens with nothing applied.",
                 "type": "string"
               },
               {
                 "name": "suggestions",
-                "description": "Typeahead values per filter key. `zn-data-table` fills this from the rows it has loaded.",
+                "description": "Typeahead values per field. `zn-data-table` fills this from the rows it has loaded.",
                 "type": "Record<string, string[]>"
               },
+              {
+                "name": "source",
+                "description": "Another filter to show the chips of. This element then renders only that filter's chips, and that filter stops\nrendering its own, so a table can keep the funnel in its header and the chips under it.",
+                "type": "ZnDataTableFilter | null"
+              },
               { "name": "validationMessage", "type": "string" },
               { "name": "validity", "type": "ValidityState" },
               {
                 "name": "activeCount",
-                "description": "Number of filters with a value set.",
+                "description": "Number of rules that apply.",
                 "type": "number"
               }
             ],
             "events": [
               {
                 "name": "zn-filter-change",
-                "description": "Emitted when the active filters change. Read the encoded query off `value`."
+                "description": "Emitted when the applied rules change. Read the encoded query off `value`."
+              },
+              {
+                "name": "zn-clear",
+                "description": "Emitted when `clear()` removes every rule."
               }
             ]
           }
@@ -3070,106 +3466,111 @@
           }
         },
         {
-          "name": "zn-defined-label",
-          "description": "This component provides a labeled input with support for predefined and custom labels,\nallowing users to select or enter label-value pairs within a dropdown interface.\n\n---\n\n\n### **CSS Parts:**\n - **input** - The component's main input.\n- **input-value** - The label's value inputs.",
+          "name": "zn-date-range",
+          "description": "A button showing a date range that opens a two-month calendar with quick ranges.\n\n---\n\n\n### **Events:**\n - **zn-change** - Emitted when a range is applied, with `{from, to}` as its detail.\n\n### **Methods:**\n - **show()** - Opens the picker.\n- **hide()** - Closes the picker without applying.\n\n### **CSS Parts:**\n - **trigger** - The button that opens the picker.\n- **popover** - The picker popover.",
           "doc-url": "",
           "attributes": [
             {
-              "name": "value",
-              "description": "The selected label key. Also acts as the filter while typing.",
+              "name": "from",
+              "description": "The first day of the range, `YYYY-MM-DD`. Defaults to today.",
               "value": { "type": "string", "default": "''" }
             },
             {
-              "name": "inputValue",
-              "description": "The value entered for the selected label. Submitted as `label:value` when present.",
+              "name": "to",
+              "description": "The last day of the range, `YYYY-MM-DD`. Defaults to today.",
               "value": { "type": "string", "default": "''" }
             },
             {
-              "name": "input-size",
-              "description": "The size of the main input.",
-              "value": {
-                "type": "'x-small' | 'small' | 'medium' | 'large'",
-                "default": "'medium'"
-              }
+              "name": "min",
+              "description": "The earliest day that can be picked.",
+              "value": { "type": "string", "default": "''" }
             },
             {
-              "name": "name",
-              "description": "The name of the control. Used for form submission.",
-              "value": { "type": "string", "default": "'label'" }
+              "name": "max",
+              "description": "The latest day that can be picked.",
+              "value": { "type": "string", "default": "''" }
             },
             {
-              "name": "title",
-              "description": "The title of the main input.",
-              "value": { "type": "string" }
+              "name": "presets",
+              "description": "Quick ranges as a JSON array of `{label, from, to}`, replacing the default ones.",
+              "value": { "type": "DatePreset[] | undefined" }
             },
             {
-              "name": "disabled",
-              "description": "Disables the control.",
-              "value": { "type": "boolean", "default": "false" }
+              "name": "note",
+              "description": "A short line shown under the calendar, such as how the range is used.",
+              "value": { "type": "string", "default": "''" }
             },
             {
-              "name": "allow-custom",
-              "description": "Allows labels that aren't in the predefined list.",
-              "value": { "type": "boolean", "default": "false" }
+              "name": "name",
+              "description": "Submits `name[from]` and `name[to]` with the form.",
+              "value": { "type": "string", "default": "''" }
             },
             {
-              "name": "predefined-labels",
-              "description": "The predefined labels. Entries are either a string or `{name, options}`.",
+              "name": "size",
+              "description": "The trigger button's size.",
               "value": {
-                "type": "(PredefinedLabel | string)[]",
-                "default": "[]"
+                "type": "'small' | 'medium' | 'large'",
+                "default": "'small'"
               }
             }
           ],
-          "events": [],
+          "events": [
+            {
+              "name": "zn-change",
+              "type": "CustomEvent",
+              "description": "Emitted when a range is applied, with `{from, to}` as its detail."
+            }
+          ],
           "js": {
             "properties": [
-              { "name": "input", "type": "ZnInput" },
-              { "name": "dropdown", "type": "ZnDropdown" },
               {
-                "name": "value",
-                "description": "The selected label key. Also acts as the filter while typing.",
+                "name": "from",
+                "description": "The first day of the range, `YYYY-MM-DD`. Defaults to today.",
                 "type": "string"
               },
               {
-                "name": "inputValue",
-                "description": "The value entered for the selected label. Submitted as `label:value` when present.",
+                "name": "to",
+                "description": "The last day of the range, `YYYY-MM-DD`. Defaults to today.",
                 "type": "string"
               },
               {
-                "name": "inputSize",
-                "description": "The size of the main input.",
-                "type": "'x-small' | 'small' | 'medium' | 'large'"
-              },
-              {
-                "name": "name",
-                "description": "The name of the control. Used for form submission.",
+                "name": "min",
+                "description": "The earliest day that can be picked.",
                 "type": "string"
               },
               {
-                "name": "title",
-                "description": "The title of the main input.",
+                "name": "max",
+                "description": "The latest day that can be picked.",
                 "type": "string"
               },
               {
-                "name": "disabled",
-                "description": "Disables the control.",
-                "type": "boolean"
+                "name": "presets",
+                "description": "Quick ranges as a JSON array of `{label, from, to}`, replacing the default ones.",
+                "type": "DatePreset[] | undefined"
               },
               {
-                "name": "allowCustom",
-                "description": "Allows labels that aren't in the predefined list.",
-                "type": "boolean"
+                "name": "note",
+                "description": "A short line shown under the calendar, such as how the range is used.",
+                "type": "string"
               },
               {
-                "name": "predefinedLabels",
-                "description": "The predefined labels. Entries are either a string or `{name, options}`.",
-                "type": "(PredefinedLabel | string)[]"
+                "name": "name",
+                "description": "Submits `name[from]` and `name[to]` with the form.",
+                "type": "string"
               },
-              { "name": "validationMessage" },
-              { "name": "validity" }
+              {
+                "name": "size",
+                "description": "The trigger button's size.",
+                "type": "'small' | 'medium' | 'large'"
+              }
             ],
-            "events": []
+            "events": [
+              {
+                "name": "zn-change",
+                "type": "CustomEvent",
+                "description": "Emitted when a range is applied, with `{from, to}` as its detail."
+              }
+            ]
           }
         },
         {
@@ -3253,6 +3654,11 @@
               "description": "Makes the input a required field.",
               "value": { "type": "boolean", "default": "false" }
             },
+            {
+              "name": "label-note",
+              "description": "Short text shown next to the label, styled like the help text, e.g. `optional`.",
+              "value": { "type": "string", "default": "''" }
+            },
             {
               "name": "clearable",
               "description": "Adds a clear button to the calendar for removing a selected date. *",
@@ -3426,6 +3832,11 @@
                 "description": "Makes the input a required field.",
                 "type": "boolean"
               },
+              {
+                "name": "labelNote",
+                "description": "Short text shown next to the label, styled like the help text, e.g. `optional`.",
+                "type": "string"
+              },
               {
                 "name": "clearable",
                 "description": "Adds a clear button to the calendar for removing a selected date. *",
@@ -3506,9 +3917,112 @@
             ]
           }
         },
+        {
+          "name": "zn-defined-label",
+          "description": "This component provides a labeled input with support for predefined and custom labels,\nallowing users to select or enter label-value pairs within a dropdown interface.\n\n---\n\n\n### **CSS Parts:**\n - **input** - The component's main input.\n- **input-value** - The label's value inputs.",
+          "doc-url": "",
+          "attributes": [
+            {
+              "name": "value",
+              "description": "The selected label key. Also acts as the filter while typing.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "inputValue",
+              "description": "The value entered for the selected label. Submitted as `label:value` when present.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "input-size",
+              "description": "The size of the main input.",
+              "value": {
+                "type": "'x-small' | 'small' | 'medium' | 'large'",
+                "default": "'medium'"
+              }
+            },
+            {
+              "name": "name",
+              "description": "The name of the control. Used for form submission.",
+              "value": { "type": "string", "default": "'label'" }
+            },
+            {
+              "name": "title",
+              "description": "The title of the main input.",
+              "value": { "type": "string" }
+            },
+            {
+              "name": "disabled",
+              "description": "Disables the control.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "allow-custom",
+              "description": "Allows labels that aren't in the predefined list.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "predefined-labels",
+              "description": "The predefined labels. Entries are either a string or `{name, options}`.",
+              "value": {
+                "type": "(PredefinedLabel | string)[]",
+                "default": "[]"
+              }
+            }
+          ],
+          "events": [],
+          "js": {
+            "properties": [
+              { "name": "input", "type": "ZnInput" },
+              { "name": "dropdown", "type": "ZnDropdown" },
+              {
+                "name": "value",
+                "description": "The selected label key. Also acts as the filter while typing.",
+                "type": "string"
+              },
+              {
+                "name": "inputValue",
+                "description": "The value entered for the selected label. Submitted as `label:value` when present.",
+                "type": "string"
+              },
+              {
+                "name": "inputSize",
+                "description": "The size of the main input.",
+                "type": "'x-small' | 'small' | 'medium' | 'large'"
+              },
+              {
+                "name": "name",
+                "description": "The name of the control. Used for form submission.",
+                "type": "string"
+              },
+              {
+                "name": "title",
+                "description": "The title of the main input.",
+                "type": "string"
+              },
+              {
+                "name": "disabled",
+                "description": "Disables the control.",
+                "type": "boolean"
+              },
+              {
+                "name": "allowCustom",
+                "description": "Allows labels that aren't in the predefined list.",
+                "type": "boolean"
+              },
+              {
+                "name": "predefinedLabels",
+                "description": "The predefined labels. Entries are either a string or `{name, options}`.",
+                "type": "(PredefinedLabel | string)[]"
+              },
+              { "name": "validationMessage" },
+              { "name": "validity" }
+            ],
+            "events": []
+          }
+        },
         {
           "name": "zn-dialog",
-          "description": "Short summary of the component's intended use.\n\n---\n\n\n### **Events:**\n - **zn-show** - Emitted when the dialog is opens.\n- **zn-close** - Emitted when the dialog is closed.\n- **zn-request-close** - Emitted when the user attempts to close the dialog by clicking the close button, clicking the overlay, or pressing escape. Calling `event.preventDefault()` will keep the dialog open. Avoid using this unless closing the dialog will result in destructive behavior such as data loss.\n\n### **Methods:**\n - **show()** - Shows the dialog.\n- **hide()** - Hides the dialog.\n\n### **Slots:**\n - _default_ - The default slot.\n- **label** - The dialog's label. Alternatively you can use the `label` attribute.\n- **header-icon** - Optional icon to add to the left of the dialog's label (title). A color will be applied to the icon depending on the dialog variant.\n- **announcement-intro** - Optional Intro text to display below the icon, when using the variant `announcement`.\n- **header-actions** - Optional actions to add to the header. Works best with `<zn-button>` elements.\n- **footer** - The dialog's footer. This is typically used for buttons representing various options.\n- **footer-text** - Optional text to include below the footer buttons, when using the variant `announcement`.\n\n### **CSS Properties:**\n - **--width** - The preferred width of the dialog. Note the dialog will shrink to accommodate smaller screens. _(default: undefined)_\n- **--header-spacing** - The amount of padding to use for the header. _(default: undefined)_\n- **--body-spacing** - The amount of padding to use for the body. _(default: undefined)_\n- **--footer-spacing** - The amount of padding to use for the footer. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **header** - The dialog's header. This element wraps the title and header actions.\n- **header-actions** - Optional actions to add to the header. Works best with `<zn-button>` elements.\n- **title** - The dialog's title.\n- **close-button** - The dialog's close button.\n- **close-button__base** - The close buttons exported `base` part.\n- **body** - The dialog's body.\n- **footer** - The dialog's footer.",
+          "description": "A modal that appears above the page for a decision that blocks the flow.\n\n---\n\n\n### **Events:**\n - **zn-show** - Emitted when the dialog opens.\n- **zn-close** - Emitted when the dialog is closed.\n- **zn-request-close** - Emitted when the user attempts to close the dialog by clicking the close button, clicking the overlay, or pressing escape. Calling `event.preventDefault()` will keep the dialog open. Avoid using this unless closing the dialog will result in destructive behavior such as data loss.\n\n### **Methods:**\n - **show()** - Shows the dialog.\n- **hide()** - Hides the dialog.\n\n### **Slots:**\n - _default_ - The default slot.\n- **label** - The dialog's label. Alternatively you can use the `label` attribute.\n- **header-icon** - Optional icon to add to the left of the dialog's label (title). A color will be applied to the icon depending on the dialog variant.\n- **announcement-intro** - Optional intro text to display below the icon, when using the variant `announcement`.\n- **header-actions** - Optional actions to add to the header. Works best with `<zn-button>` elements.\n- **footer** - The dialog's footer. This is typically used for buttons representing various options.\n- **footer-text** - Optional text to include below the footer buttons, when using the variant `announcement`.\n\n### **CSS Properties:**\n - **--width** - The preferred width of a `size=\"custom\"` dialog. The dialog shrinks to fit smaller screens. _(default: undefined)_\n- **--header-spacing** - The amount of padding to use for the header. _(default: undefined)_\n- **--body-spacing** - The amount of padding to use for the body. _(default: undefined)_\n- **--footer-spacing** - The amount of padding to use for the footer. _(default: undefined)_\n- **--zn-dialog-width-small** - Theme token: the width of `size=\"small\"`. _(default: undefined)_\n- **--zn-dialog-width-medium** - Theme token: the width of `size=\"medium\"`. _(default: undefined)_\n- **--zn-dialog-width-large** - Theme token: the width of `size=\"large\"`. _(default: undefined)_\n- **--zn-dialog-border-radius** - Theme token: the dialog's corner radius. _(default: undefined)_\n- **--zn-dialog-backdrop** - Theme token: the backdrop behind the dialog. _(default: undefined)_\n- **--zn-dialog-body-color** - Theme token: the body text colour. _(default: undefined)_\n- **--zn-dialog-icon-background** - Theme token: the fill behind a default or warning header icon. _(default: undefined)_\n- **--zn-dialog-close-color** - Theme token: the close button's icon colour. _(default: undefined)_\n- **--zn-dialog-close-icon-size** - Theme token: the close button's icon size, read when the dialog opens. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **header** - The dialog's header. This element wraps the title and header actions.\n- **header-actions** - Optional actions to add to the header. Works best with `<zn-button>` elements.\n- **title** - The dialog's title.\n- **close-button** - The dialog's close button.\n- **close-button__base** - The close button's exported `base` part.\n- **body** - The dialog's body.\n- **footer** - The dialog's footer.",
           "doc-url": "",
           "attributes": [
             {
@@ -3564,7 +4078,7 @@
             },
             {
               "name": "announcement-intro",
-              "description": "Optional Intro text to display below the icon, when using the variant `announcement`."
+              "description": "Optional intro text to display below the icon, when using the variant `announcement`."
             },
             {
               "name": "header-actions",
@@ -3582,7 +4096,7 @@
           "events": [
             {
               "name": "zn-show",
-              "description": "Emitted when the dialog is opens."
+              "description": "Emitted when the dialog opens."
             },
             {
               "name": "zn-close",
@@ -3633,7 +4147,7 @@
             "events": [
               {
                 "name": "zn-show",
-                "description": "Emitted when the dialog is opens."
+                "description": "Emitted when the dialog opens."
               },
               {
                 "name": "zn-close",
@@ -3648,13 +4162,150 @@
           }
         },
         {
-          "name": "zn-dropdown",
-          "description": "Short summary of the component's intended use.\n\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Methods:**\n - **show()** - Opens the dropdown\n- **hide()** - Closes the dropdown\n- **reposition()** - Instructs the dropdown to reposition itself\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
+          "name": "zn-diff",
+          "description": "A side-by-side comparison of two versions of something, one column each, built from `zn-diff-row`s.\n\n---\n\n\n### **Slots:**\n - _default_ - The `zn-diff-row`s.\n- **before** - Inline content after the left heading, such as a status badge.\n- **after** - Inline content after the right heading, such as a status badge.\n\n### **CSS Properties:**\n - **--zn-diff-head-background** - The heading row's background. _(default: undefined)_\n- **--zn-diff-sticky-top** - How far from the top of its scroll container the heading row sticks. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The table.\n- **head** - The sticky row of column headings.",
           "doc-url": "",
           "attributes": [
             {
-              "name": "open",
-              "description": "Indicates whether the dropdown is open",
+              "name": "before-caption",
+              "description": "The left column's heading, such as the older version.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "before-description",
+              "description": "A line under the left heading.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "after-caption",
+              "description": "The right column's heading, such as the newer version.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "after-description",
+              "description": "A line under the right heading.",
+              "value": { "type": "string", "default": "''" }
+            }
+          ],
+          "slots": [
+            { "name": "", "description": "The `zn-diff-row`s." },
+            {
+              "name": "before",
+              "description": "Inline content after the left heading, such as a status badge."
+            },
+            {
+              "name": "after",
+              "description": "Inline content after the right heading, such as a status badge."
+            }
+          ],
+          "events": [],
+          "js": {
+            "properties": [
+              {
+                "name": "beforeCaption",
+                "description": "The left column's heading, such as the older version.",
+                "type": "string"
+              },
+              {
+                "name": "beforeDescription",
+                "description": "A line under the left heading.",
+                "type": "string"
+              },
+              {
+                "name": "afterCaption",
+                "description": "The right column's heading, such as the newer version.",
+                "type": "string"
+              },
+              {
+                "name": "afterDescription",
+                "description": "A line under the right heading.",
+                "type": "string"
+              }
+            ],
+            "events": []
+          }
+        },
+        {
+          "name": "zn-diff-row",
+          "description": "One aligned row of a `zn-diff`: the same item in both versions, tinted by how it changed.\n\n---\n\n\n### **Slots:**\n - **before** - The item's details in the older version.\n- **after** - The item's details in the newer version.\n\n### **CSS Properties:**\n - **--zn-diff-row-border** - The line below the row. _(default: undefined)_\n\n### **CSS Parts:**\n - **row** - The row.\n- **before** - The left cell.\n- **after** - The right cell.",
+          "doc-url": "",
+          "attributes": [
+            {
+              "name": "caption",
+              "description": "The item's name, shown in both columns.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "change",
+              "description": "How the item changed: `changed`, `added` or `removed`. Unchanged when empty.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "heading",
+              "description": "When true, the row is a heading spanning both columns, such as a section name.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "before-placeholder",
+              "description": "Shown in the left column when the item was added.",
+              "value": { "type": "string", "default": "'Not in this version'" }
+            },
+            {
+              "name": "after-placeholder",
+              "description": "Shown in the right column when the item was removed.",
+              "value": { "type": "string", "default": "'Not in this version'" }
+            }
+          ],
+          "slots": [
+            {
+              "name": "before",
+              "description": "The item's details in the older version."
+            },
+            {
+              "name": "after",
+              "description": "The item's details in the newer version."
+            }
+          ],
+          "events": [],
+          "js": {
+            "properties": [
+              {
+                "name": "caption",
+                "description": "The item's name, shown in both columns.",
+                "type": "string"
+              },
+              {
+                "name": "change",
+                "description": "How the item changed: `changed`, `added` or `removed`. Unchanged when empty.",
+                "type": "string"
+              },
+              {
+                "name": "heading",
+                "description": "When true, the row is a heading spanning both columns, such as a section name.",
+                "type": "boolean"
+              },
+              {
+                "name": "beforePlaceholder",
+                "description": "Shown in the left column when the item was added.",
+                "type": "string"
+              },
+              {
+                "name": "afterPlaceholder",
+                "description": "Shown in the right column when the item was removed.",
+                "type": "string"
+              }
+            ],
+            "events": []
+          }
+        },
+        {
+          "name": "zn-dropdown",
+          "description": "Short summary of the component's intended use.\n\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Methods:**\n - **show()** - Opens the dropdown\n- **hide()** - Closes the dropdown\n- **reposition()** - Instructs the dropdown to reposition itself\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
+          "doc-url": "",
+          "attributes": [
+            {
+              "name": "open",
+              "description": "Indicates whether the dropdown is open",
               "value": { "type": "boolean", "default": "false" }
             },
             {
@@ -3678,7 +4329,7 @@
             {
               "name": "distance",
               "description": "The distance in pixels from which to offset the panel away from the trigger",
-              "value": { "type": "number", "default": "0" }
+              "value": { "type": "number", "default": "4" }
             },
             {
               "name": "skidding",
@@ -3763,7 +4414,9 @@
               },
               { "name": "uri", "type": "string" },
               { "name": "fetchedContent", "type": "string" },
-              { "name": "handlePanelSelect", "description": "Events" }
+              { "name": "handlePanelSelect", "description": "Events" },
+              { "name": "handleKeyDown" },
+              { "name": "handleDocumentKeyDown" }
             ],
             "events": [
               {
@@ -3775,12 +4428,49 @@
         },
         {
           "name": "zn-editor",
-          "description": "Short summary of the component's intended use.\n\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
+          "description": "Short summary of the component's intended use.\n\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n- **help-text** - Text under the editor. Alternatively, use the `help-text` attribute.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
           "doc-url": "",
           "attributes": [
             { "name": "id", "value": { "type": "string" } },
             { "name": "name", "value": { "type": "string" } },
             { "name": "value", "value": { "type": "string" } },
+            {
+              "name": "placeholder",
+              "value": {
+                "type": "string",
+                "default": "'Compose your reply...'"
+              }
+            },
+            {
+              "name": "compact",
+              "description": "Draws the editor as a form field: a bordered, resizable box under a small toolbar of bold, italic, link and lists.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "source",
+              "description": "Adds a Source button that switches to editing the raw HTML, which is submitted as written.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "document-mode",
+              "description": "Edits the HTML in place as a whole document, keeping layout the editor can't hold, such as a designed email.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "readonly",
+              "description": "Shows only the content, without a toolbar or box, such as the source beside a translation.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "prefix",
+              "description": "With `compact`, a short label inside the box ahead of the content, such as a language code.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "help-text",
+              "description": "Text under the editor that describes how to use it. If you need to display HTML, use the `help-text` slot instead.",
+              "value": { "type": "string", "default": "''" }
+            },
             {
               "name": "interaction-type",
               "value": { "type": "'ticket' | 'chat'", "default": "'chat'" }
@@ -3826,6 +4516,11 @@
               "name": "ai",
               "value": { "type": "boolean", "default": "false" }
             },
+            {
+              "name": "merge-fields",
+              "description": "Shows `{{token}}` replacements as highlighted chips, labelled from the matching `context-items`\nquick action. The value still holds the raw tokens.",
+              "value": { "type": "boolean", "default": "false" }
+            },
             {
               "name": "ai-path",
               "value": { "type": "string", "default": "''" }
@@ -3848,7 +4543,11 @@
           ],
           "slots": [
             { "name": "", "description": "The default slot." },
-            { "name": "example", "description": "An example slot." }
+            { "name": "example", "description": "An example slot." },
+            {
+              "name": "help-text",
+              "description": "Text under the editor. Alternatively, use the `help-text` attribute."
+            }
           ],
           "events": [
             { "name": "zn-event-name", "description": "Emitted as an example." }
@@ -3858,6 +4557,37 @@
               { "name": "id", "type": "string" },
               { "name": "name", "type": "string" },
               { "name": "value", "type": "string" },
+              { "name": "placeholder", "type": "string" },
+              {
+                "name": "compact",
+                "description": "Draws the editor as a form field: a bordered, resizable box under a small toolbar of bold, italic, link and lists.",
+                "type": "boolean"
+              },
+              {
+                "name": "sourceEnabled",
+                "description": "Adds a Source button that switches to editing the raw HTML, which is submitted as written.",
+                "type": "boolean"
+              },
+              {
+                "name": "documentMode",
+                "description": "Edits the HTML in place as a whole document, keeping layout the editor can't hold, such as a designed email.",
+                "type": "boolean"
+              },
+              {
+                "name": "readonly",
+                "description": "Shows only the content, without a toolbar or box, such as the source beside a translation.",
+                "type": "boolean"
+              },
+              {
+                "name": "prefix",
+                "description": "With `compact`, a short label inside the box ahead of the content, such as a language code.",
+                "type": "string"
+              },
+              {
+                "name": "helpText",
+                "description": "Text under the editor that describes how to use it. If you need to display HTML, use the `help-text` slot instead.",
+                "type": "string"
+              },
               { "name": "interactionType", "type": "'ticket' | 'chat'" },
               { "name": "uploadAttachmentUrl", "type": "string" },
               { "name": "codeBlocksEnabled", "type": "boolean" },
@@ -3870,6 +4600,11 @@
               { "name": "emojisEnabled", "type": "boolean" },
               { "name": "codeEnabled", "type": "boolean" },
               { "name": "aiEnabled", "type": "boolean" },
+              {
+                "name": "mergeFieldsEnabled",
+                "description": "Shows `{{token}}` replacements as highlighted chips, labelled from the matching `context-items`\nquick action. The value still holds the raw tokens.",
+                "type": "boolean"
+              },
               { "name": "aiPath", "type": "string" },
               {
                 "name": "storeKey",
@@ -3921,6 +4656,11 @@
             {
               "name": "padded",
               "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "tile",
+              "description": "Draws the icon small inside a tinted, rounded tile rather than as a large glyph.",
+              "value": { "type": "boolean", "default": "false" }
             }
           ],
           "slots": [
@@ -3936,7 +4676,12 @@
               { "name": "caption", "type": "string" },
               { "name": "description", "type": "string" },
               { "name": "type", "type": "'error' | 'info' | 'primary' | ''" },
-              { "name": "padded", "type": "boolean" }
+              { "name": "padded", "type": "boolean" },
+              {
+                "name": "tile",
+                "description": "Draws the icon small inside a tinted, rounded tile rather than as a large glyph.",
+                "type": "boolean"
+              }
             ],
             "events": [
               {
@@ -4121,6 +4866,11 @@
               "name": "upload-url",
               "description": "When set, a chosen file is immediately POSTed (multipart, field `file`) to this URL.\nThe endpoint must respond with JSON `{\"url\": \"...\"}`; that URL becomes the control's\nvalue (and `src` preview) in place of the file bytes, so the control works inside\nJSON-serialising hosts such as `zn-page-builder`. Emits `zn-error` when the upload fails.",
               "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "max-size",
+              "description": "The largest each file can be, in megabytes. A bigger file makes the control invalid. 0 for no limit.",
+              "value": { "type": "number", "default": "0" }
             }
           ],
           "slots": [
@@ -4277,6 +5027,11 @@
                 "description": "When set, a chosen file is immediately POSTed (multipart, field `file`) to this URL.\nThe endpoint must respond with JSON `{\"url\": \"...\"}`; that URL becomes the control's\nvalue (and `src` preview) in place of the file bytes, so the control works inside\nJSON-serialising hosts such as `zn-page-builder`. Emits `zn-error` when the upload fails.",
                 "type": "string"
               },
+              {
+                "name": "maxSize",
+                "description": "The largest each file can be, in megabytes. A bigger file makes the control invalid. 0 for no limit.",
+                "type": "number"
+              },
               {
                 "name": "validity",
                 "description": "Gets the validity state object"
@@ -4354,6 +5109,16 @@
             {
               "name": "button",
               "value": { "type": "string", "default": "'Filter'" }
+            },
+            {
+              "name": "submit-on-enter",
+              "description": "Submits the filters when Enter is pressed in a text field.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "loading-text",
+              "description": "Shown on the submit button while results load.",
+              "value": { "type": "string", "default": "'Searching...'" }
             }
           ],
           "slots": [
@@ -4366,7 +5131,18 @@
           "js": {
             "properties": [
               { "name": "button", "type": "string" },
-              { "name": "handleSubmit" }
+              {
+                "name": "submitOnEnter",
+                "description": "Submits the filters when Enter is pressed in a text field.",
+                "type": "boolean"
+              },
+              {
+                "name": "loadingText",
+                "description": "Shown on the submit button while results load.",
+                "type": "string"
+              },
+              { "name": "handleSubmit" },
+              { "name": "handleKeyDown" }
             ],
             "events": [
               {
@@ -4544,6 +5320,11 @@
               "name": "form",
               "description": "The id of the form to act on. If omitted, the closest containing form is used.",
               "value": { "type": "string" }
+            },
+            {
+              "name": "loading-on-submit",
+              "description": "Shows the submit button loading and ignores further submits until the console reports the request finished,\nso a slow save such as an upload can't be sent twice. Only for forms the console submits.",
+              "value": { "type": "boolean", "default": "false" }
             }
           ],
           "slots": [
@@ -4604,6 +5385,11 @@
                 "name": "form",
                 "description": "The id of the form to act on. If omitted, the closest containing form is used.",
                 "type": "string"
+              },
+              {
+                "name": "loadingOnSubmit",
+                "description": "Shows the submit button loading and ignores further submits until the console reports the request finished,\nso a slow save such as an upload can't be sent twice. Only for forms the console submits.",
+                "type": "boolean"
               }
             ],
             "events": [
@@ -4642,6 +5428,11 @@
               "name": "layout",
               "value": { "type": "string", "default": "\"1,2\"" }
             },
+            {
+              "name": "compact",
+              "description": "Labels the group like one of its fields and keeps it tight to them, for a section inside a form or dialog.",
+              "value": { "type": "boolean", "default": "false" }
+            },
             {
               "name": "pad",
               "value": { "type": "boolean", "default": "false" }
@@ -4674,6 +5465,11 @@
               },
               { "name": "forceCols", "type": "boolean" },
               { "name": "layout", "type": "string" },
+              {
+                "name": "compact",
+                "description": "Labels the group like one of its fields and keeps it tight to them, for a section inside a form or dialog.",
+                "type": "boolean"
+              },
               { "name": "pad", "type": "boolean" }
             ],
             "events": []
@@ -4692,6 +5488,16 @@
               "value": { "type": "boolean", "default": "false" }
             },
             { "name": "caption", "value": { "type": "string" } },
+            {
+              "name": "description",
+              "description": "A line of muted text under the caption.",
+              "value": { "type": "string" }
+            },
+            {
+              "name": "inline-description",
+              "description": "Sets the description beside the caption rather than under it, e.g. a row count.",
+              "value": { "type": "boolean", "default": "false" }
+            },
             { "name": "icon", "value": { "type": "string" } },
             {
               "name": "navigation",
@@ -4719,6 +5525,16 @@
               { "name": "entityIdShow", "type": "boolean" },
               { "name": "transparent", "type": "boolean" },
               { "name": "caption", "type": "string" },
+              {
+                "name": "description",
+                "description": "A line of muted text under the caption.",
+                "type": "string"
+              },
+              {
+                "name": "inlineDescription",
+                "description": "Sets the description beside the caption rather than under it, e.g. a row count.",
+                "type": "boolean"
+              },
               { "name": "icon", "type": "string" },
               { "name": "navigation", "type": "array" },
               { "name": "fullWidth", "type": "boolean" },
@@ -4841,12 +5657,16 @@
         },
         {
           "name": "zn-icon",
-          "description": "Short summary of the component's intended use.\n\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
+          "description": "\n\n---\n",
           "doc-url": "",
           "attributes": [
             { "name": "src", "value": { "type": "string" } },
             { "name": "alt", "value": { "type": "string" } },
-            { "name": "size", "value": { "type": "number", "default": "24" } },
+            {
+              "name": "size",
+              "description": "Size in pixels, or one of the avatar sizes `sm` (22), `md` (28), `lg` (40) and `xl` (56).",
+              "value": { "type": "number", "default": "24" }
+            },
             {
               "name": "round",
               "value": { "type": "boolean", "default": "false" }
@@ -4873,20 +5693,28 @@
             {
               "name": "squared",
               "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "presence",
+              "description": "A live-status dot on an avatar: `online`, `away`, `busy`, `meeting` or `offline`.",
+              "value": { "type": "AvatarPresence" }
+            },
+            {
+              "name": "solid",
+              "description": "Draws an avatar as a solid circle even where the theme tints avatars.",
+              "value": { "type": "boolean", "default": "false" }
             }
           ],
-          "slots": [
-            { "name": "", "description": "The default slot." },
-            { "name": "example", "description": "An example slot." }
-          ],
-          "events": [
-            { "name": "zn-event-name", "description": "Emitted as an example." }
-          ],
+          "events": [],
           "js": {
             "properties": [
               { "name": "src", "type": "string" },
               { "name": "alt", "type": "string" },
-              { "name": "size", "type": "number" },
+              {
+                "name": "size",
+                "description": "Size in pixels, or one of the avatar sizes `sm` (22), `md` (28), `lg` (40) and `xl` (56).",
+                "type": "number"
+              },
               { "name": "round", "type": "boolean" },
               { "name": "tile", "type": "boolean" },
               { "name": "depth", "type": "boolean" },
@@ -4896,15 +5724,20 @@
               { "name": "padded", "type": "boolean" },
               { "name": "blink", "type": "boolean" },
               { "name": "squared", "type": "boolean" },
+              {
+                "name": "presence",
+                "description": "A live-status dot on an avatar: `online`, `away`, `busy`, `meeting` or `offline`.",
+                "type": "AvatarPresence"
+              },
+              {
+                "name": "solid",
+                "description": "Draws an avatar as a solid circle even where the theme tints avatars.",
+                "type": "boolean"
+              },
               { "name": "gravatarOptions", "type": "string" },
               { "name": "defaultLibrary", "type": "IconLibrary" }
             ],
-            "events": [
-              {
-                "name": "zn-event-name",
-                "description": "Emitted as an example."
-              }
-            ]
+            "events": []
           }
         },
         {
@@ -4994,7 +5827,7 @@
         },
         {
           "name": "zn-inline-edit",
-          "description": "Short summary of the component's intended use.\n\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - Default slot. When `input-type` is `select`, accepts `zn-option` elements to define select options. If provided, takes precedence over the `options` property.\n- **example** - An example slot.\n- **help-text** - Text that describes how to use the input. Alternatively, you can use the `help-text` attribute.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
+          "description": "Short summary of the component's intended use.\n\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - Default slot. When `input-type` is `select`, accepts `zn-option` elements to define select options. If provided, takes precedence over the `options` property.\n- **example** - An example slot.\n- **help-text** - Text that describes how to use the input. Alternatively, you can use the `help-text` attribute.\n\n### **CSS Properties:**\n - **--zn-inline-edit-hover-background** - The fill behind a field while hovered or focused. _(default: undefined)_\n- **--zn-inline-edit-bleed** - How far the hover fill extends past the left edge of the value. _(default: undefined)_\n- **--zn-inline-edit-underline-color** - The dotted underline marking an editable value at rest. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
           "doc-url": "",
           "attributes": [
             {
@@ -5255,6 +6088,7 @@
               { "name": "defaultValue", "type": "string | string[]" },
               { "name": "validity", "type": "ValidityState" },
               { "name": "validationMessage", "type": "string" },
+              { "name": "updateTextScrolledToEnd" },
               { "name": "mouseEventHandler" },
               { "name": "escKeyHandler" },
               { "name": "submitKeyHandler" },
@@ -5277,7 +6111,7 @@
         },
         {
           "name": "zn-input",
-          "description": "Short summary of the component's intended use.\n\n---\n\n\n### **Events:**\n - **zn-blur** - Emitted when the control loses focus.\n- **zn-change** - Emitted when an alteration to the control's value is committed by the user.\n- **zn-clear** - Emitted when the clear button is activated.\n- **zn-focus** - Emitted when the control gains focus.\n- **zn-input** - Emitted when the control receives input.\n- **zn-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n- **zn-slash-select** - Emitted when a slash menu item is chosen. Cancelable — call `preventDefault()` to suppress the insertion and handle the item yourself.\n- **zn-slash-insert** - Emitted after a slash menu item's value has been inserted.\n\n### **Methods:**\n - **resolveSlashItems(search): _Promise<SlashMenuItem[]>_** - The insertions the slash menu offers, gathered from every source, in the order they were declared.\n- **showSlashMenu()** - Opens the slash menu at the caret, inserting the trigger if it isn't already there.\n- **hideSlashMenu()** - Closes the slash menu.\n- **focus(options: _FocusOptions_)** - Sets focus on the input.\n- **blur()** - Removes focus from the input.\n- **select()** - Selects all the text in the input.\n- **setSelectionRange(selectionStart: _number_, selectionEnd: _number_, selectionDirection: _'forward' | 'backward' | 'none'_)** - Sets the start and end positions of the text selection (0-based).\n- **setRangeText(replacement: _string_, start: _number_, end: _number_, selectMode: _'select' | 'start' | 'end' | 'preserve'_)** - Replaces a range of text with a new string.\n- **showPicker()** - Displays the browser picker for an input element (only works if the browser supports it for the input type).\n- **stepUp()** - Increments the value of a numeric input type by the value of the step attribute.\n- **stepDown()** - Decrements the value of a numeric input type by the value of the step attribute.\n- **checkValidity(): _boolean_** - Checks the validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.\n\n### **Slots:**\n - **label** - The input's label. Alternatively, you can use the `label` attribute.\n- **label-tooltip** - Used to add text that is displayed in a tooltip next to the label. Alternatively, you can use the `label-tooltip` attribute.\n- **context-note** - Used to add contextual text that is displayed above the input, on the right. Alternatively, you can use the `context-note` attribute. Range inputs display their live value here unless this is set.\n- **prefix** - Used to prepend a presentational icon or similar element to the input.\n- **suffix** - Used to append a presentational icon or similar element to the input.\n- **clear-icon** - An icon to use in lieu of the default clear icon.\n- **show-password-icon** - An icon to use in lieu of the default show password icon.\n- **hide-password-icon** - An icon to use in lieu of the default hide password icon.\n- **help-text** - Text that describes how to use the input. Alternatively, you can use the `help-text` attribute.\n- **slash-items** - `<zn-slash-item>` elements describing the insertions offered by the slash menu. Items are picked up wherever they sit inside the input, so this slot name is optional.\n- **slash-menu** - A `<zn-slash-menu>` to use instead of the built-in one, so its heading, sizing and styling can be set in markup. Any `<zn-slash-item>` children of it become the menu's items.\n\n### **CSS Properties:**\n - **--zn-range-track-height** - The height of a range input's track. _(default: undefined)_\n- **--zn-range-track-color** - The color of a range input's track. _(default: undefined)_\n- **--zn-range-thumb-size** - The diameter of a range input's thumb. _(default: undefined)_\n- **--zn-range-thumb-color** - The color of a range input's thumb. _(default: undefined)_\n- **--zn-range-thumb-ring-width** - The width of the ring drawn around a range input's thumb. _(default: undefined)_\n\n### **CSS Parts:**\n - **form-control** - The form control that wraps the label, input, and help text.\n- **slash-menu** - The slash menu shown at the caret.\n- **form-control-label** - The label's wrapper.\n- **form-control-input** - The input's wrapper.\n- **form-control-help-text** - The help text's wrapper.\n- **base** - The component's base wrapper.\n- **input** - The internal `<input>` control.\n- **prefix** - The container that wraps the prefix.\n- **clear-button** - The clear button.\n- **password-toggle-button** - The password toggle button.\n- **suffix** - The container that wraps the suffix.",
+          "description": "Short summary of the component's intended use.\n\n---\n\n\n### **Events:**\n - **zn-blur** - Emitted when the control loses focus.\n- **zn-change** - Emitted when an alteration to the control's value is committed by the user.\n- **zn-clear** - Emitted when the clear button is activated.\n- **zn-focus** - Emitted when the control gains focus.\n- **zn-input** - Emitted when the control receives input.\n- **zn-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n- **zn-slash-select** - Emitted when a slash menu item is chosen. Cancelable — call `preventDefault()` to suppress the insertion and handle the item yourself.\n- **zn-slash-insert** - Emitted after a slash menu item's value has been inserted.\n\n### **Methods:**\n - **resolveSlashItems(search): _Promise<SlashMenuItem[]>_** - The insertions the slash menu offers, gathered from every source, in the order they were declared.\n- **showSlashMenu()** - Opens the slash menu at the caret, inserting the trigger if it isn't already there.\n- **hideSlashMenu()** - Closes the slash menu.\n- **focus(options: _FocusOptions_)** - Sets focus on the input.\n- **blur()** - Removes focus from the input.\n- **select()** - Selects all the text in the input.\n- **setSelectionRange(selectionStart: _number_, selectionEnd: _number_, selectionDirection: _'forward' | 'backward' | 'none'_)** - Sets the start and end positions of the text selection (0-based).\n- **setRangeText(replacement: _string_, start: _number_, end: _number_, selectMode: _'select' | 'start' | 'end' | 'preserve'_)** - Replaces a range of text with a new string.\n- **showPicker()** - Displays the browser picker for an input element (only works if the browser supports it for the input type).\n- **stepUp()** - Increments the value of a numeric input type by the value of the step attribute.\n- **stepDown()** - Decrements the value of a numeric input type by the value of the step attribute.\n- **checkValidity(): _boolean_** - Checks the validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.\n\n### **Slots:**\n - **label** - The input's label. Alternatively, you can use the `label` attribute.\n- **label-tooltip** - Used to add text that is displayed in a tooltip next to the label. Alternatively, you can use the `label-tooltip` attribute.\n- **context-note** - Used to add contextual text that is displayed above the input, on the right. Alternatively, you can use the `context-note` attribute. Range inputs display their live value here unless this is set.\n- **prefix** - Used to prepend a presentational icon or similar element to the input.\n- **suffix** - Used to append a presentational icon or similar element to the input.\n- **clear-icon** - An icon to use in lieu of the default clear icon.\n- **show-password-icon** - An icon to use in lieu of the default show password icon.\n- **hide-password-icon** - An icon to use in lieu of the default hide password icon.\n- **help-text** - Text that describes how to use the input. Alternatively, you can use the `help-text` attribute.\n- **slash-items** - `<zn-slash-item>` elements describing the insertions offered by the slash menu. Items are picked up wherever they sit inside the input, so this slot name is optional.\n- **slash-menu** - A `<zn-slash-menu>` to use instead of the built-in one, so its heading, sizing and styling can be set in markup. Any `<zn-slash-item>` children of it become the menu's items.\n\n### **CSS Properties:**\n - **--zn-range-track-height** - The height of a range input's track. _(default: undefined)_\n- **--zn-range-track-color** - The color of a range input's track. _(default: undefined)_\n- **--zn-range-thumb-size** - The diameter of a range input's thumb. _(default: undefined)_\n- **--zn-range-thumb-color** - The color of a range input's thumb. _(default: undefined)_\n- **--zn-range-thumb-ring-width** - The width of the ring drawn around a range input's thumb. _(default: undefined)_\n\n### **CSS Parts:**\n - **form-control** - The form control that wraps the label, input, and help text.\n- **slash-menu** - The slash menu shown at the caret.\n- **form-control-label** - The label's wrapper.\n- **form-control-input** - The input's wrapper.\n- **form-control-help-text** - The help text's wrapper.\n- **base** - The component's base wrapper.\n- **input** - The internal `<input>` control.\n- **prefix** - The container that wraps the prefix.\n- **clear-button** - The clear button.\n- **password-toggle-button** - The password toggle button.\n- **suffix** - The container that wraps the suffix.\n- **color-swatch** - The swatch that opens the colour panel on colour inputs.\n- **color-picker** - The colour panel.",
           "doc-url": "",
           "attributes": [
             {
@@ -5382,11 +6216,8 @@
             },
             {
               "name": "color-format",
-              "description": "The color format to display for color inputs. Only applies when type is 'color'. *",
-              "value": {
-                "type": "'hex' | 'rgb' | 'hsl' | 'oklch'",
-                "default": "'hex'"
-              }
+              "description": "The format a colour input writes its value in. Typing a colour in another format, or working in another format's\nrow of the colour panel, switches to that format. Only applies when type is 'color'.",
+              "value": { "type": "ColorFormat", "default": "'hex'" }
             },
             {
               "name": "value-suffix",
@@ -5403,6 +6234,11 @@
               "description": "Makes the input a required field.",
               "value": { "type": "boolean", "default": "false" }
             },
+            {
+              "name": "label-note",
+              "description": "Short text shown next to the label, styled like the help text, e.g. `optional`.",
+              "value": { "type": "string", "default": "''" }
+            },
             {
               "name": "pattern",
               "description": "A regular expression pattern to validate input against.",
@@ -5593,7 +6429,9 @@
           "js": {
             "properties": [
               { "name": "input", "type": "HTMLInputElement" },
-              { "name": "colorPicker", "type": "HTMLInputElement" },
+              { "name": "colorSwatch", "type": "HTMLButtonElement" },
+              { "name": "colorPanel", "type": "ZnColorPicker" },
+              { "name": "colorPopup", "type": "ZnPopup" },
               { "name": "slashMenuElement", "type": "ZnSlashMenu | null" },
               { "name": "title", "type": "string" },
               {
@@ -5693,8 +6531,8 @@
               },
               {
                 "name": "colorFormat",
-                "description": "The color format to display for color inputs. Only applies when type is 'color'. *",
-                "type": "'hex' | 'rgb' | 'hsl' | 'oklch'"
+                "description": "The format a colour input writes its value in. Typing a colour in another format, or working in another format's\nrow of the colour panel, switches to that format. Only applies when type is 'color'.",
+                "type": "ColorFormat"
               },
               {
                 "name": "valueSuffix",
@@ -5711,6 +6549,11 @@
                 "description": "Makes the input a required field.",
                 "type": "boolean"
               },
+              {
+                "name": "labelNote",
+                "description": "Short text shown next to the label, styled like the help text, e.g. `optional`.",
+                "type": "string"
+              },
               {
                 "name": "pattern",
                 "description": "A regular expression pattern to validate input against.",
@@ -5922,10 +6765,25 @@
             { "name": "description", "value": { "type": "string" } },
             { "name": "stacked", "value": { "type": "boolean" } },
             {
-              "name": "size",
-              "value": {
-                "type": "'small' | 'medium' | 'large'",
-                "default": "'medium'"
+              "name": "fact",
+              "description": "A fact in a grid of headline attributes: a small muted caption above the value, without padding.",
+              "value": { "type": "boolean" }
+            },
+            {
+              "name": "key-value",
+              "description": "A row in a key–value list: a small muted caption beside a right-aligned value, on a compact row.",
+              "value": { "type": "boolean" }
+            },
+            {
+              "name": "mono",
+              "description": "Shows the value in the monospace font, for identifiers and codes.",
+              "value": { "type": "boolean" }
+            },
+            {
+              "name": "size",
+              "value": {
+                "type": "'small' | 'medium' | 'large'",
+                "default": "'medium'"
               }
             },
             { "name": "edit-on-hover", "value": { "type": "boolean" } },
@@ -5955,6 +6813,21 @@
               { "name": "caption", "type": "string" },
               { "name": "description", "type": "string" },
               { "name": "stacked", "type": "boolean" },
+              {
+                "name": "fact",
+                "description": "A fact in a grid of headline attributes: a small muted caption above the value, without padding.",
+                "type": "boolean"
+              },
+              {
+                "name": "keyValue",
+                "description": "A row in a key–value list: a small muted caption beside a right-aligned value, on a compact row.",
+                "type": "boolean"
+              },
+              {
+                "name": "mono",
+                "description": "Shows the value in the monospace font, for identifiers and codes.",
+                "type": "boolean"
+              },
               { "name": "size", "type": "'small' | 'medium' | 'large'" },
               { "name": "editOnHover", "type": "boolean" },
               { "name": "helpTooltip", "type": "string" },
@@ -6079,6 +6952,92 @@
             ]
           }
         },
+        {
+          "name": "zn-key-value",
+          "description": "Edits a list of name and value pairs, submitted as a JSON object.\n\n---\n\n\n### **Events:**\n - **zn-change** - Emitted when a pair is added, removed or edited.\n\n### **Slots:**\n - **label** - The label. Alternatively, use the `label` attribute.\n- **help-text** - Text under the pairs. Alternatively, use the `help-text` attribute.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **row** - Each name and value pair.",
+          "doc-url": "",
+          "attributes": [
+            { "name": "name", "value": { "type": "string", "default": "''" } },
+            {
+              "name": "value",
+              "description": "The pairs as a JSON object, such as `{\"1\": \"{{recipient.firstName}}\"}`.",
+              "value": { "type": "string", "default": "'{}'" }
+            },
+            { "name": "label", "value": { "type": "string", "default": "''" } },
+            {
+              "name": "help-text",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "key-label",
+              "value": { "type": "string", "default": "'Name'" }
+            },
+            {
+              "name": "value-label",
+              "value": { "type": "string", "default": "'Value'" }
+            },
+            {
+              "name": "add-text",
+              "value": { "type": "string", "default": "'Add'" }
+            },
+            {
+              "name": "slash-items",
+              "description": "Passed to each value input, so its slash menu can insert merge fields.",
+              "value": { "type": "string", "default": "''" }
+            },
+            { "name": "form", "value": { "type": "string", "default": "''" } },
+            {
+              "name": "disabled",
+              "value": { "type": "boolean", "default": "false" }
+            }
+          ],
+          "slots": [
+            {
+              "name": "label",
+              "description": "The label. Alternatively, use the `label` attribute."
+            },
+            {
+              "name": "help-text",
+              "description": "Text under the pairs. Alternatively, use the `help-text` attribute."
+            }
+          ],
+          "events": [
+            {
+              "name": "zn-change",
+              "description": "Emitted when a pair is added, removed or edited."
+            }
+          ],
+          "js": {
+            "properties": [
+              { "name": "name", "type": "string" },
+              {
+                "name": "value",
+                "description": "The pairs as a JSON object, such as `{\"1\": \"{{recipient.firstName}}\"}`.",
+                "type": "string"
+              },
+              { "name": "label", "type": "string" },
+              { "name": "helpText", "type": "string" },
+              { "name": "keyLabel", "type": "string" },
+              { "name": "valueLabel", "type": "string" },
+              { "name": "addText", "type": "string" },
+              {
+                "name": "slashItems",
+                "description": "Passed to each value input, so its slash menu can insert merge fields.",
+                "type": "string"
+              },
+              { "name": "form", "type": "string" },
+              { "name": "disabled", "type": "boolean" },
+              { "name": "validity", "type": "ValidityState" },
+              { "name": "validationMessage", "type": "string" }
+            ],
+            "events": [
+              {
+                "name": "zn-change",
+                "description": "Emitted when a pair is added, removed or edited."
+              }
+            ]
+          }
+        },
         {
           "name": "zn-linked-select",
           "description": "Short summary of the component's intended use.\n\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
@@ -6188,7 +7147,7 @@
         },
         {
           "name": "zn-markdown-editor",
-          "description": "A markdown editor with live preview, split view, and a fullscreen mode.\n\n---\n\n\n### **Events:**\n - **zn-view-mode-change** - Emitted when the user switches between editor / split / preview.\n- **zn-change** - Emitted when the markdown content changes.\n- **zn-input** - Emitted on each keystroke in the editor.\n\n### **Methods:**\n - **focus(options: _FocusOptions_)** - Sets focus on the editor.\n- **blur()** - Removes focus from the editor.\n\n### **Slots:**\n - **label** - The editor label. Alternatively, use the `label` attribute.\n- **help-text** - Help text shown below the editor. Alternatively, use the `help-text` attribute.\n- _default_ - The panel's main content.\n- **actions** - Actions displayed in the panel header (buttons, chips, etc).\n- **footer** - Content displayed in the panel footer.\n\n### **CSS Properties:**\n - **--zn-panel-basis** - The flex-basis of the panel. Can be set using the basis-px attribute. _(default: undefined)_\n- **--zn-panel-header-padding** - Padding around the header row. Defaults to `--zn-base-gap`. _(default: undefined)_\n- **--zn-panel-footer-padding** - Padding around the footer row. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **toolbar** - The toolbar containing the view-mode and fullscreen controls.\n- **editor** - The textarea wrapper.\n- **preview** - The rendered markdown preview.\n- **header** - The header region, when a caption or actions are given.\n- **header-content** - The padded row inside the header, forwarded from zn-header.\n- **footer** - The footer region, when the footer slot is filled.",
+          "description": "A markdown editor with live preview, split view, and a fullscreen mode.\n\n---\n\n\n### **Events:**\n - **zn-view-mode-change** - Emitted when the user switches between editor / split / preview.\n- **zn-change** - Emitted when the markdown content changes.\n- **zn-input** - Emitted on each keystroke in the editor.\n\n### **Methods:**\n - **focus(options: _FocusOptions_)** - Sets focus on the editor.\n- **blur()** - Removes focus from the editor.\n\n### **Slots:**\n - **label** - The editor label. Alternatively, use the `label` attribute.\n- **help-text** - Help text shown below the editor. Alternatively, use the `help-text` attribute.\n- _default_ - The panel's main content.\n- **actions** - Actions displayed in the panel header (buttons, chips, etc).\n- **footer** - Content displayed in the panel footer.\n\n### **CSS Properties:**\n - **--zn-panel-basis** - The flex-basis of the panel. Can be set using the basis-px attribute. _(default: undefined)_\n- **--zn-panel-header-padding** - Padding around the header row. Defaults to `--zn-base-gap`. _(default: undefined)_\n- **--zn-panel-footer-padding** - Padding around the footer row. _(default: undefined)_\n- **--zn-panel-padding** - Padding around the body. Defaults to `--zn-base-gap`. _(default: undefined)_\n- **--zn-panel-shadow** - Resting shadow. Defaults to none. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **toolbar** - The toolbar containing the view-mode and fullscreen controls.\n- **editor** - The textarea wrapper.\n- **preview** - The rendered markdown preview.\n- **header** - The header region, when a caption or actions are given.\n- **header-content** - The padded row inside the header, forwarded from zn-header.\n- **header-left** - The caption and description, forwarded from zn-header.\n- **footer** - The footer region, when the footer slot is filled.",
           "doc-url": "",
           "attributes": [
             {
@@ -6259,6 +7218,16 @@
             },
             { "name": "basis-px", "value": { "type": "number" } },
             { "name": "caption", "value": { "type": "string" } },
+            {
+              "name": "description",
+              "description": "Help text under the caption, in the panel's header.",
+              "value": { "type": "string" }
+            },
+            {
+              "name": "inline-description",
+              "description": "Sets the description beside the caption rather than under it.",
+              "value": { "type": "boolean", "default": "false" }
+            },
             { "name": "icon", "value": { "type": "string" } },
             { "name": "tabbed", "value": { "type": "boolean" } },
             { "name": "header-borderless", "value": { "type": "boolean" } },
@@ -6377,6 +7346,16 @@
               { "name": "validationMessage", "type": "string" },
               { "name": "basis", "type": "number" },
               { "name": "caption", "type": "string" },
+              {
+                "name": "description",
+                "description": "Help text under the caption, in the panel's header.",
+                "type": "string"
+              },
+              {
+                "name": "inlineDescription",
+                "description": "Sets the description beside the caption rather than under it.",
+                "type": "boolean"
+              },
               { "name": "icon", "type": "string" },
               { "name": "tabbed", "type": "boolean" },
               { "name": "headerBorderless", "type": "boolean" },
@@ -6447,7 +7426,7 @@
         },
         {
           "name": "zn-menu-item",
-          "description": "Short summary of the component's intended use.\n\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Methods:**\n - **getTextLabel()** - Returns a text label based on the contents of the menu item's default slot.\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
+          "description": "Short summary of the component's intended use.\n\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Methods:**\n - **getTextLabel()** - Returns a text label based on the contents of the menu item's default slot.\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **shortcut** - The key cap showing the item's `shortcut`.",
           "doc-url": "",
           "attributes": [
             {
@@ -6541,6 +7520,11 @@
               "name": "active",
               "description": "Marks the menu item as currently active/selected.",
               "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "shortcut",
+              "description": "A keyboard shortcut shown as a key cap at the end of the item, such as `E` or `⌘K`.",
+              "value": { "type": "string" }
             }
           ],
           "slots": [
@@ -6625,6 +7609,11 @@
                 "name": "active",
                 "description": "Marks the menu item as currently active/selected.",
                 "type": "boolean"
+              },
+              {
+                "name": "shortcut",
+                "description": "A keyboard shortcut shown as a key cap at the end of the item, such as `E` or `⌘K`.",
+                "type": "string"
               }
             ],
             "events": [
@@ -6635,9 +7624,187 @@
             ]
           }
         },
+        {
+          "name": "zn-menu-label",
+          "description": "A heading for a group of items in a `zn-menu`. It is skipped by the menu's keyboard navigation.\n\n---\n\n\n### **Slots:**\n - _default_ - The label text.\n\n### **CSS Properties:**\n - **--zn-menu-label-padding** - Space around the label. _(default: undefined)_\n- **--zn-menu-label-color** - The label's text colour. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
+          "doc-url": "",
+          "attributes": [],
+          "slots": [{ "name": "", "description": "The label text." }],
+          "events": [],
+          "js": { "properties": [], "events": [] }
+        },
+        {
+          "name": "zn-nav-item",
+          "description": "A selectable row in a `zn-nav-list`, with an optional description and count.\n\n---\n\n\n### **Slots:**\n - _default_ - The item's label.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **label** - The label, truncated with an ellipsis.\n- **description** - The description shown below the label.\n- **count** - The count shown at the end of the row.\n- **handle** - The drag handle, shown when the list is sortable.",
+          "doc-url": "",
+          "attributes": [
+            {
+              "name": "count",
+              "description": "A count shown at the end of the row, such as the number of entries in the group.",
+              "value": { "type": "string" }
+            },
+            {
+              "name": "description",
+              "description": "A line of detail shown below the label.",
+              "value": { "type": "string" }
+            }
+          ],
+          "slots": [{ "name": "", "description": "The item's label." }],
+          "events": [],
+          "js": {
+            "properties": [
+              {
+                "name": "count",
+                "description": "A count shown at the end of the row, such as the number of entries in the group.",
+                "type": "string"
+              },
+              {
+                "name": "description",
+                "description": "A line of detail shown below the label.",
+                "type": "string"
+              },
+              { "name": "selected" }
+            ],
+            "events": []
+          }
+        },
+        {
+          "name": "zn-nav-list",
+          "description": "The list side of a master–detail layout: a card of selectable groups shown beside the selected group's\ncontents. Place it in the `left` slot of `<zn-tabs gap>`, which switches the detail panels.\n\n---\n\n\n### **Events:**\n - **zn-change** - Emitted when a sortable list's items have been moved.\n- **zn-reorder** - Emitted when a sortable list's items have been moved.\n\n### **Methods:**\n - **getPriorityMap()** - The order as `{key, priority}` pairs, counting from 1.\n\n### **Slots:**\n - _default_ - `zn-nav-item` elements.\n- **actions** - Actions in the card's header, beside the caption.\n\n### **CSS Properties:**\n - **--zn-nav-list-width** - The width of the card beside the detail. _(default: undefined)_\n- **--zn-nav-list-max-height** - Caps the card's height; the list scrolls beyond it. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **header** - The header holding the caption and actions.\n- **search** - The wrapper around the search input.\n- **list** - The scrolling list of items.\n- **empty** - The message shown when the search matches nothing.",
+          "doc-url": "",
+          "attributes": [
+            {
+              "name": "searchable",
+              "description": "Shows a search input that filters the items by their label.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "search-placeholder",
+              "value": { "type": "string", "default": "'Search'" }
+            },
+            {
+              "name": "empty-label",
+              "description": "Shown when the search matches no items.",
+              "value": { "type": "string", "default": "'No matches'" }
+            },
+            {
+              "name": "caption",
+              "description": "A heading for the card, shown with the `actions` slot above the items.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "divide",
+              "description": "Draws the items as full-width rows split by dividers, marking the selected one with a bar on its edge.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "sortable",
+              "description": "Lets the items be dragged, or moved with Alt+Arrow keys, into a new order.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "name",
+              "description": "Submits the order as `[{key, priority}]` JSON, keyed by each item's `value` (or `tab`), counting from 1.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "form",
+              "description": "Associates the list with a form by id.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "disabled",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "formaction",
+              "description": "When set, the form is submitted after each reorder, to this URL or, when empty, the form's own action.",
+              "value": { "type": "string" }
+            }
+          ],
+          "slots": [
+            { "name": "", "description": "`zn-nav-item` elements." },
+            {
+              "name": "actions",
+              "description": "Actions in the card's header, beside the caption."
+            }
+          ],
+          "events": [
+            {
+              "name": "zn-change",
+              "description": "Emitted when a sortable list's items have been moved."
+            },
+            {
+              "name": "zn-reorder",
+              "description": "Emitted when a sortable list's items have been moved."
+            }
+          ],
+          "js": {
+            "properties": [
+              {
+                "name": "searchable",
+                "description": "Shows a search input that filters the items by their label.",
+                "type": "boolean"
+              },
+              { "name": "searchPlaceholder", "type": "string" },
+              {
+                "name": "emptyLabel",
+                "description": "Shown when the search matches no items.",
+                "type": "string"
+              },
+              {
+                "name": "caption",
+                "description": "A heading for the card, shown with the `actions` slot above the items.",
+                "type": "string"
+              },
+              {
+                "name": "divide",
+                "description": "Draws the items as full-width rows split by dividers, marking the selected one with a bar on its edge.",
+                "type": "boolean"
+              },
+              {
+                "name": "sortable",
+                "description": "Lets the items be dragged, or moved with Alt+Arrow keys, into a new order.",
+                "type": "boolean"
+              },
+              {
+                "name": "name",
+                "description": "Submits the order as `[{key, priority}]` JSON, keyed by each item's `value` (or `tab`), counting from 1.",
+                "type": "string"
+              },
+              {
+                "name": "form",
+                "description": "Associates the list with a form by id.",
+                "type": "string"
+              },
+              { "name": "disabled", "type": "boolean" },
+              {
+                "name": "formAction",
+                "description": "When set, the form is submitted after each reorder, to this URL or, when empty, the form's own action.",
+                "type": "string"
+              },
+              { "name": "validity", "type": "ValidityState" },
+              { "name": "validationMessage", "type": "string" },
+              {
+                "name": "value",
+                "description": "The order as `[{key, priority}]` JSON."
+              }
+            ],
+            "events": [
+              {
+                "name": "zn-change",
+                "description": "Emitted when a sortable list's items have been moved."
+              },
+              {
+                "name": "zn-reorder",
+                "description": "Emitted when a sortable list's items have been moved."
+              }
+            ]
+          }
+        },
         {
           "name": "zn-navbar",
-          "description": "Short summary of the component's intended use.\n\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - The default slot.\n- **expand** - Expanding action panels rendered alongside the navbar items.\n- **bottom** - Content rendered below the navbar row (e.g. chips, filters).\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
+          "description": "Short summary of the component's intended use.\n\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - The default slot.\n- **expand** - Expanding action panels rendered alongside the navbar items.\n- **bottom** - Content rendered below the navbar row (e.g. chips, filters).\n\n### **CSS Properties:**\n - **--zn-navbar-tab-indicator-slide** - `1` shows the sliding indicator in place of each tab's own line. _(default: undefined)_\n- **--zn-navbar-tab-indicator-duration** - Duration of the indicator's leading edge (default 300ms). _(default: undefined)_\n- **--zn-navbar-tab-indicator-easing** - Easing of both indicator edges. _(default: undefined)_\n- **--zn-navbar-tab-indicator-trail-duration** - Duration of the trailing edge; longer than the lead stretches the indicator. _(default: undefined)_\n- **--zn-navbar-tab-indicator-trail-easing** - Easing of the trailing edge; defaults to `--zn-navbar-tab-indicator-easing`. _(default: undefined)_\n- **--zn-navbar-tab-indicator-trail-delay** - Delay before the trailing edge follows (default 0ms). _(default: undefined)_\n- **--zn-navbar-tab-indicator-delay** - Delay before the indicator starts to move (default 0ms). _(default: undefined)_\n- **--zn-navbar-tab-indicator-squash** - Vertical scale the indicator squishes to before it travels (default 1, off). _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **indicator** - The active-tab indicator that slides between tabs. Exposes `--zn-navbar-indicator-top` / `--zn-navbar-indicator-height` (the active tab's box) for styles that fill the tab.",
           "doc-url": "",
           "attributes": [
             {
@@ -6657,6 +7824,21 @@
               "name": "gutter",
               "value": { "type": "boolean", "default": "false" }
             },
+            {
+              "name": "pill",
+              "description": "Draws the tabs as a segmented control: a grey track with a pill that slides to the active tab.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "size",
+              "description": "With `pill`, `small` draws a shorter track to sit with small controls, such as above a form field.",
+              "value": { "type": "'small' | 'medium'", "default": "'medium'" }
+            },
+            {
+              "name": "tabs",
+              "description": "The id of a zn-tabs elsewhere on the page that this navbar's tabs switch, such as one below a page header.",
+              "value": { "type": "string" }
+            },
             { "name": "stacked", "value": { "type": "boolean" } },
             {
               "name": "dropdown",
@@ -6708,6 +7890,21 @@
               { "name": "hideOne", "type": "boolean" },
               { "name": "flush", "type": "boolean" },
               { "name": "gutter", "type": "boolean" },
+              {
+                "name": "pill",
+                "description": "Draws the tabs as a segmented control: a grey track with a pill that slides to the active tab.",
+                "type": "boolean"
+              },
+              {
+                "name": "size",
+                "description": "With `pill`, `small` draws a shorter track to sit with small controls, such as above a form field.",
+                "type": "'small' | 'medium'"
+              },
+              {
+                "name": "tabs",
+                "description": "The id of a zn-tabs elsewhere on the page that this navbar's tabs switch, such as one below a page header.",
+                "type": "string"
+              },
               { "name": "stacked", "type": "boolean" },
               { "name": "dropdown", "type": "array" },
               { "name": "noPad", "type": "false" },
@@ -6885,7 +8082,7 @@
         },
         {
           "name": "zn-page",
-          "description": "Combines a page header with tab navigation and tab panels.\n\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Methods:**\n \n\n\n### **Slots:**\n - _default_ - Page content. Use zn-tab for named tabs and header-action/header-actions for header actions. Clicking an element in the content with `tab=\"<tab id>\"` opens that tab.\n- **description** - Rich subtitle/description content. Falls back to the `summary` attribute when empty.\n- **bottom** - Content rendered below the navbar row (e.g. chips, filters). Forwarded to the navbar's bottom slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
+          "description": "Combines a page header with tab navigation and tab panels.\n\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Methods:**\n \n\n\n### **Slots:**\n - _default_ - Page content. Use zn-tab for named tabs; without any, the content is shown as the page's only view. A zn-tab holding zn-tabs shows them as a second tab set, drawn as pills. Use header-action/header-actions for header actions. Clicking an element in the content with `tab=\"<tab id>\"` opens that tab.\n- **caption-badges** - Badges shown beside the caption, wrapping onto the next line as one group.\n- **description** - Rich subtitle/description content. Falls back to the `summary` attribute when empty.\n- **bottom** - Content rendered below the navbar row (e.g. chips, filters). Forwarded to the navbar's bottom slot.\n- **footer** - Actions pinned below the content, such as a form's `zn-form-actions`. In a modal page it takes the dialog footer's styling.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **footer** - The footer wrapping the footer slot.\n- **base** - The component's base wrapper.",
           "doc-url": "",
           "attributes": [
             { "name": "caption", "value": { "type": "string" } },
@@ -6900,6 +8097,11 @@
               "name": "nested",
               "value": { "type": "boolean", "default": "false" }
             },
+            {
+              "name": "navigation-style",
+              "description": "The tab design: `tabs` (the default), `pills` for a second tab set below a main tab bar, shown without the page\nheader, or `sidebar` when the tabs are shown outside the page, which hides the tab bar unless it has bottom content.",
+              "value": { "type": "'tabs' | 'pills' | 'sidebar' | undefined" }
+            },
             {
               "name": "primary",
               "value": { "type": "boolean", "default": "false" }
@@ -6949,6 +8151,16 @@
               "name": "padded",
               "value": { "type": "boolean", "default": "false" }
             },
+            {
+              "name": "select-added",
+              "description": "With `store-key`, opens a tab that has appeared since the page was last shown, such as one for an item just\nadded, in place of the remembered tab.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "gap",
+              "description": "Spaces a left or right slot from the content, for side navigation laid out as its own card.",
+              "value": { "type": "boolean", "default": "false" }
+            },
             {
               "name": "fetch-style",
               "value": { "type": "string", "default": "\"\"" }
@@ -6967,7 +8179,11 @@
           "slots": [
             {
               "name": "",
-              "description": "Page content. Use zn-tab for named tabs and header-action/header-actions for header actions. Clicking an element in the content with `tab=\"<tab id>\"` opens that tab."
+              "description": "Page content. Use zn-tab for named tabs; without any, the content is shown as the page's only view. A zn-tab holding zn-tabs shows them as a second tab set, drawn as pills. Use header-action/header-actions for header actions. Clicking an element in the content with `tab=\"<tab id>\"` opens that tab."
+            },
+            {
+              "name": "caption-badges",
+              "description": "Badges shown beside the caption, wrapping onto the next line as one group."
             },
             {
               "name": "description",
@@ -6977,6 +8193,10 @@
               "name": "bottom",
               "description": "Content rendered below the navbar row (e.g. chips, filters). Forwarded to the navbar's bottom slot."
             },
+            {
+              "name": "footer",
+              "description": "Actions pinned below the content, such as a form's `zn-form-actions`. In a modal page it takes the dialog footer's styling."
+            },
             { "name": "example", "description": "An example slot." }
           ],
           "events": [
@@ -6990,6 +8210,11 @@
               { "name": "fullLocation", "type": "string" },
               { "name": "modal", "type": "boolean" },
               { "name": "nested", "type": "boolean" },
+              {
+                "name": "navigationStyle",
+                "description": "The tab design: `tabs` (the default), `pills` for a second tab set below a main tab bar, shown without the page\nheader, or `sidebar` when the tabs are shown outside the page, which hides the tab bar unless it has bottom content.",
+                "type": "'tabs' | 'pills' | 'sidebar' | undefined"
+              },
               { "name": "primary", "type": "boolean" },
               { "name": "previousPath", "type": "string" },
               { "name": "previousTarget", "type": "string" },
@@ -7010,6 +8235,16 @@
               { "name": "storeKey", "type": "string" },
               { "name": "storeTtl", "type": "number" },
               { "name": "padded", "type": "boolean" },
+              {
+                "name": "selectAdded",
+                "description": "With `store-key`, opens a tab that has appeared since the page was last shown, such as one for an item just\nadded, in place of the remembered tab.",
+                "type": "boolean"
+              },
+              {
+                "name": "gap",
+                "description": "Spaces a left or right slot from the content, for side navigation laid out as its own card.",
+                "type": "boolean"
+              },
               { "name": "fetchStyle", "type": "string" },
               { "name": "fullWidth", "type": "boolean" },
               { "name": "paddedRight", "type": "boolean" },
@@ -7233,6 +8468,16 @@
               "name": "padded",
               "value": { "type": "boolean", "default": "false" }
             },
+            {
+              "name": "select-added",
+              "description": "With `store-key`, opens a tab that has appeared since the page was last shown, such as one for an item just\nadded, in place of the remembered tab.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "gap",
+              "description": "Spaces a left or right slot from the content, for side navigation laid out as its own card.",
+              "value": { "type": "boolean", "default": "false" }
+            },
             {
               "name": "fetch-style",
               "value": { "type": "string", "default": "\"\"" }
@@ -7275,6 +8520,16 @@
               { "name": "storeKey", "type": "string" },
               { "name": "storeTtl", "type": "number" },
               { "name": "padded", "type": "boolean" },
+              {
+                "name": "selectAdded",
+                "description": "With `store-key`, opens a tab that has appeared since the page was last shown, such as one for an item just\nadded, in place of the remembered tab.",
+                "type": "boolean"
+              },
+              {
+                "name": "gap",
+                "description": "Spaces a left or right slot from the content, for side navigation laid out as its own card.",
+                "type": "boolean"
+              },
               { "name": "fetchStyle", "type": "string" },
               { "name": "fullWidth", "type": "boolean" },
               { "name": "paddedRight", "type": "boolean" },
@@ -7337,11 +8592,21 @@
         },
         {
           "name": "zn-panel",
-          "description": "Panels are versatile containers that provide structure for organizing content with optional headers and footers.\n\n---\n\n\n### **Slots:**\n - _default_ - The panel's main content.\n- **actions** - Actions displayed in the panel header (buttons, chips, etc).\n- **footer** - Content displayed in the panel footer.\n\n### **CSS Properties:**\n - **--zn-panel-basis** - The flex-basis of the panel. Can be set using the basis-px attribute. _(default: undefined)_\n- **--zn-panel-header-padding** - Padding around the header row. Defaults to `--zn-base-gap`. _(default: undefined)_\n- **--zn-panel-footer-padding** - Padding around the footer row. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **header** - The header region, when a caption or actions are given.\n- **header-content** - The padded row inside the header, forwarded from zn-header.\n- **footer** - The footer region, when the footer slot is filled.",
+          "description": "Panels are versatile containers that provide structure for organizing content with optional headers and footers.\n\n---\n\n\n### **Slots:**\n - _default_ - The panel's main content.\n- **actions** - Actions displayed in the panel header (buttons, chips, etc).\n- **footer** - Content displayed in the panel footer.\n\n### **CSS Properties:**\n - **--zn-panel-basis** - The flex-basis of the panel. Can be set using the basis-px attribute. _(default: undefined)_\n- **--zn-panel-header-padding** - Padding around the header row. Defaults to `--zn-base-gap`. _(default: undefined)_\n- **--zn-panel-footer-padding** - Padding around the footer row. _(default: undefined)_\n- **--zn-panel-padding** - Padding around the body. Defaults to `--zn-base-gap`. _(default: undefined)_\n- **--zn-panel-shadow** - Resting shadow. Defaults to none. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **header** - The header region, when a caption or actions are given.\n- **header-content** - The padded row inside the header, forwarded from zn-header.\n- **header-left** - The caption and description, forwarded from zn-header.\n- **footer** - The footer region, when the footer slot is filled.",
           "doc-url": "",
           "attributes": [
             { "name": "basis-px", "value": { "type": "number" } },
             { "name": "caption", "value": { "type": "string" } },
+            {
+              "name": "description",
+              "description": "Help text under the caption, in the panel's header.",
+              "value": { "type": "string" }
+            },
+            {
+              "name": "inline-description",
+              "description": "Sets the description beside the caption rather than under it.",
+              "value": { "type": "boolean", "default": "false" }
+            },
             { "name": "icon", "value": { "type": "string" } },
             { "name": "tabbed", "value": { "type": "boolean" } },
             { "name": "header-borderless", "value": { "type": "boolean" } },
@@ -7369,6 +8634,16 @@
             "properties": [
               { "name": "basis", "type": "number" },
               { "name": "caption", "type": "string" },
+              {
+                "name": "description",
+                "description": "Help text under the caption, in the panel's header.",
+                "type": "string"
+              },
+              {
+                "name": "inlineDescription",
+                "description": "Sets the description beside the caption rather than under it.",
+                "type": "boolean"
+              },
               { "name": "icon", "type": "string" },
               { "name": "tabbed", "type": "boolean" },
               { "name": "headerBorderless", "type": "boolean" },
@@ -7400,7 +8675,7 @@
             },
             {
               "name": "placement",
-              "description": "The preferred placement of the popup. Note that the actual placement will vary as configured to keep the\npanel inside of the viewport.",
+              "description": "The preferred placement of the popup. Note that the actual placement will vary as configured to keep the\npanel inside the viewport.",
               "value": {
                 "type": "| 'top'\n    | 'top-start'\n    | 'top-end'\n    | 'bottom'\n    | 'bottom-start'\n    | 'bottom-end'\n    | 'right'\n    | 'right-start'\n    | 'right-end'\n    | 'left'\n    | 'left-start'\n    | 'left-end'",
                 "default": "'top'"
@@ -7537,7 +8812,7 @@
               },
               {
                 "name": "placement",
-                "description": "The preferred placement of the popup. Note that the actual placement will vary as configured to keep the\npanel inside of the viewport.",
+                "description": "The preferred placement of the popup. Note that the actual placement will vary as configured to keep the\npanel inside the viewport.",
                 "type": "| 'top'\n    | 'top-start'\n    | 'top-end'\n    | 'bottom'\n    | 'bottom-start'\n    | 'bottom-end'\n    | 'right'\n    | 'right-start'\n    | 'right-end'\n    | 'left'\n    | 'left-start'\n    | 'left-end'"
               },
               {
@@ -7791,7 +9066,7 @@
         },
         {
           "name": "zn-priority-list",
-          "description": "A reorderable list where each item receives a numerical priority based on its position. Supports drag-and-drop\nand keyboard reordering. Priority values are submitted as form data via hidden inputs.\n\n---\n\n\n### **Events:**\n - **zn-change** - Emitted when the order of items changes.\n- **zn-reorder** - Emitted when items are reordered. Call `getPriorityMap()` on the component to get the updated `{ key: string, priority: number }[]` array.\n\n### **Methods:**\n - **getPriorityMap(): _PriorityItem[]_** - Returns the priority map: an array of { key, priority } objects.\n- **checkValidity(): _boolean_** - Checks for validity but does not show a validation message.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity(): _boolean_** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(_message)** - Sets a custom validation message. Pass an empty string to restore validity.\n\n### **Slots:**\n - _default_ - The default slot where list items are placed. Each slotted element must have a `value` attribute that uniquely identifies the item. The component automatically assigns slot names to project each item into the correct position. The item's position in the list determines its priority (top = `priority-start`, incrementing).\n- **label** - The component's label. Required for proper accessibility. Alternatively, use the `label` attribute.\n- **label-tooltip** - Used to add text displayed in a tooltip next to the label.\n- **help-text** - Text that describes how to use the component. Alternatively, use the `help-text` attribute.\n\n### **CSS Properties:**\n - **--zn-priority-list-item-gap** - The gap between list items. Defaults to `var(--zn-spacing-2x-small)`. _(default: undefined)_\n- **--zn-priority-list-item-padding** - The padding inside each item. Defaults to `var(--zn-spacing-small) var(--zn-spacing-medium)`. _(default: undefined)_\n- **--zn-priority-list-actions-gap** - The gap between an item's slotted actions. Defaults to `var(--zn-spacing-x-small)`. _(default: undefined)_\n- **--zn-priority-list-handle-color** - The color of the drag handle. Defaults to `var(--zn-color-neutral-500)`. _(default: undefined)_\n- **--zn-priority-list-priority-color** - The color of the priority number. Defaults to `var(--zn-color-neutral-600)`. _(default: undefined)_\n\n### **CSS Parts:**\n - **form-control** - The form control wrapper.\n- **form-control-label** - The label wrapper.\n- **form-control-input** - The input area wrapper.\n- **form-control-help-text** - The help text wrapper.\n- **list** - The list container.\n- **item** - An individual list item row.\n- **drag-handle** - The drag handle icon.\n- **priority** - The priority number badge.\n- **content** - The content area of an item.",
+          "description": "A reorderable list where each item receives a numerical priority based on its position. Supports drag-and-drop\nand keyboard reordering. Priority values are submitted as form data via hidden inputs.\n\n---\n\n\n### **Events:**\n - **zn-change** - Emitted when the order of items changes.\n- **zn-reorder** - Emitted when items are reordered. Call `getPriorityMap()` on the component to get the updated `{ key: string, priority: number }[]` array.\n\n### **Methods:**\n - **getPriorityMap(): _PriorityItem[]_** - Returns the priority map: an array of { key, priority } objects.\n- **checkValidity(): _boolean_** - Checks for validity but does not show a validation message.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity(): _boolean_** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(_message)** - Sets a custom validation message. Pass an empty string to restore validity.\n\n### **Slots:**\n - _default_ - The default slot where list items are placed. Each slotted element must have a `value` attribute that uniquely identifies the item. The component automatically assigns slot names to project each item into the correct position. The item's position in the list determines its priority (top = `priority-start`, incrementing). Use `zn-tile` items for titled rows with their own actions. Set `locked` on an item to pin it where it is.\n- **action-{value}** - Controls shown at the end of the item with that `value`.\n- **label** - The component's label. Required for proper accessibility. Alternatively, use the `label` attribute.\n- **label-tooltip** - Used to add text displayed in a tooltip next to the label.\n- **help-text** - Text that describes how to use the component. Alternatively, use the `help-text` attribute.\n\n### **CSS Properties:**\n - **--zn-priority-list-item-gap** - The gap between list items. Defaults to `var(--zn-spacing-2x-small)`. _(default: undefined)_\n- **--zn-priority-list-item-padding** - The padding inside each item. Defaults to `var(--zn-spacing-small) var(--zn-spacing-medium)`. _(default: undefined)_\n- **--zn-priority-list-actions-gap** - The gap between an item's slotted actions. Defaults to `var(--zn-spacing-x-small)`. _(default: undefined)_\n- **--zn-priority-list-handle-color** - The color of the drag handle. Defaults to `var(--zn-color-neutral-500)`. _(default: undefined)_\n- **--zn-priority-list-priority-color** - The color of the priority number. Defaults to `var(--zn-color-neutral-600)`. _(default: undefined)_\n\n### **CSS Parts:**\n - **form-control** - The form control wrapper.\n- **form-control-label** - The label wrapper.\n- **form-control-input** - The input area wrapper.\n- **form-control-help-text** - The help text wrapper.\n- **list** - The list container.\n- **item** - An individual list item row.\n- **drag-handle** - The drag handle icon.\n- **priority** - The priority number badge.\n- **content** - The content area of an item.",
           "doc-url": "",
           "attributes": [
             {
@@ -7847,6 +9122,31 @@
               "description": "The starting priority number. Defaults to 1.",
               "value": { "type": "number", "default": "1" }
             },
+            {
+              "name": "flush",
+              "description": "Draws the items as rows divided edge to edge, for a list filling a flush panel; the label is kept for\nscreen readers only.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "selectable",
+              "description": "Lets a click or Enter select an item as well as drag it, for a list that doubles as navigation. The click is\npassed on to the item, so a `tab` or link on it acts as if clicked.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "selected",
+              "description": "The selected item's value. An item marked active by zn-tabs takes precedence, so the list follows its tabs.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "hide-priority",
+              "description": "Hides each item's priority number, for lists where the order shows the priority.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "move-buttons",
+              "description": "Shows move up and move down buttons on each item.",
+              "value": { "type": "boolean", "default": "false" }
+            },
             {
               "name": "formaction",
               "description": "When set, the associated form will be submitted with the given action URL whenever items are reordered.\nIf set to an empty string, the form will be submitted using its existing action.",
@@ -7861,7 +9161,11 @@
           "slots": [
             {
               "name": "",
-              "description": "The default slot where list items are placed. Each slotted element must have a `value` attribute that uniquely identifies the item. The component automatically assigns slot names to project each item into the correct position. The item's position in the list determines its priority (top = `priority-start`, incrementing)."
+              "description": "The default slot where list items are placed. Each slotted element must have a `value` attribute that uniquely identifies the item. The component automatically assigns slot names to project each item into the correct position. The item's position in the list determines its priority (top = `priority-start`, incrementing). Use `zn-tile` items for titled rows with their own actions. Set `locked` on an item to pin it where it is."
+            },
+            {
+              "name": "action-{value}",
+              "description": "Controls shown at the end of the item with that `value`."
             },
             {
               "name": "label",
@@ -7940,6 +9244,31 @@
                 "description": "The starting priority number. Defaults to 1.",
                 "type": "number"
               },
+              {
+                "name": "flush",
+                "description": "Draws the items as rows divided edge to edge, for a list filling a flush panel; the label is kept for\nscreen readers only.",
+                "type": "boolean"
+              },
+              {
+                "name": "selectable",
+                "description": "Lets a click or Enter select an item as well as drag it, for a list that doubles as navigation. The click is\npassed on to the item, so a `tab` or link on it acts as if clicked.",
+                "type": "boolean"
+              },
+              {
+                "name": "selected",
+                "description": "The selected item's value. An item marked active by zn-tabs takes precedence, so the list follows its tabs.",
+                "type": "string"
+              },
+              {
+                "name": "hidePriority",
+                "description": "Hides each item's priority number, for lists where the order shows the priority.",
+                "type": "boolean"
+              },
+              {
+                "name": "moveButtons",
+                "description": "Shows move up and move down buttons on each item.",
+                "type": "boolean"
+              },
               {
                 "name": "formAction",
                 "description": "When set, the associated form will be submitted with the given action URL whenever items are reordered.\nIf set to an empty string, the form will be submitted using its existing action.",
@@ -8068,6 +9397,16 @@
             {
               "name": "show-values",
               "value": { "type": "string[]", "default": "[]" }
+            },
+            {
+              "name": "rules",
+              "description": "Rules to start with, in the shape the builder submits.",
+              "value": { "type": "QueryBuilderRule[]", "default": "[]" }
+            },
+            {
+              "name": "repeatable",
+              "description": "Allows a filter to be added more than once, e.g. for a date range.",
+              "value": { "type": "boolean", "default": "false" }
             }
           ],
           "slots": [
@@ -8085,6 +9424,16 @@
               { "name": "name", "type": "string" },
               { "name": "value", "type": "PropertyKey" },
               { "name": "showValues", "type": "string[]" },
+              {
+                "name": "rules",
+                "description": "Rules to start with, in the shape the builder submits.",
+                "type": "QueryBuilderRule[]"
+              },
+              {
+                "name": "repeatable",
+                "description": "Allows a filter to be added more than once, e.g. for a date range.",
+                "type": "boolean"
+              },
               { "name": "validationMessage", "type": "string" },
               { "name": "validity", "type": "ValidityState" }
             ],
@@ -8093,7 +9442,7 @@
         },
         {
           "name": "zn-radio",
-          "description": "Short summary of the component's intended use.\n\n---\n\n\n### **Events:**\n - **zn-blur** - Emitted when the radio loses focus.\n- **zn-change** - Emitted when the checked state changes.\n- **zn-focus** - Emitted when the radio gains focus.\n- **zn-input** - Emitted when the radio receives input.\n- **zn-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\n - **click()** - Simulates a click on the radio.\n- **focus(options: _FocusOptions_)** - Sets focus on the radio.\n- **blur()** - Removes focus from the radio.\n- **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. The value provided will be shown to the user when the form is submitted. To clear\nthe custom validation message, call this method with an empty string.\n\n### **Slots:**\n - _default_ - The radio's label.\n- **image** - Replaces the built-in image used by contained radios.\n- **description** - A description of the radio's label. Serves as help text for a radio item. Alternatively, you can use the `description` attribute.\n- **selected-content** - Use to nest rich content (like an input) inside a selected radio item. Use only with the contained style.\n\n### **CSS Properties:**\n - **--zn-selection-card-image-width** - Width of the built-in card image. _(default: undefined)_\n- **--zn-selection-card-image-height** - Height of the built-in card image. _(default: undefined)_\n- **--zn-selection-card-min-height** - Minimum height of a contained radio with an image. _(default: undefined)_\n- **--zn-selection-card-content-min-width** - Width the card text keeps before it wraps below the image. _(default: undefined)_\n- **--zn-selection-card-title-font-size** - Font size of a selection card title. _(default: undefined)_\n- **--zn-selection-card-padding** - Equal inset around the contents of a selection card. _(default: undefined)_\n- **--zn-selection-card-gap** - Space between the image, title, and indicator gutter. _(default: undefined)_\n- **--zn-selection-card-control-offset** - Distance between a positioned control and the card edge. _(default: undefined)_\n- **--zn-selection-card-border-radius** - Corner radius of a contained container. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **control** - The square container that wraps the radio's checked state.\n- **control--checked** - Matches the control part when the radio is checked.\n- **checked-icon** - The checked icon, an `<zn-icon>` element.\n- **image-container** - The wrapper around the built-in image or image slot.\n- **image** - The built-in image.\n- **card-title** - The title inside a selection card.\n- **label** - The container that wraps the radio's label.\n- **description** - The container that wraps the radio's description.\n- **selected-content** - The container that wraps optional content that appears when a radio is checked.",
+          "description": "Short summary of the component's intended use.\n\n---\n\n\n### **Events:**\n - **zn-blur** - Emitted when the radio loses focus.\n- **zn-change** - Emitted when the checked state changes.\n- **zn-focus** - Emitted when the radio gains focus.\n- **zn-input** - Emitted when the radio receives input.\n- **zn-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\n - **click()** - Simulates a click on the radio.\n- **focus(options: _FocusOptions_)** - Sets focus on the radio.\n- **blur()** - Removes focus from the radio.\n- **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. The value provided will be shown to the user when the form is submitted. To clear\nthe custom validation message, call this method with an empty string.\n\n### **Slots:**\n - _default_ - The radio's label.\n- **image** - Replaces the built-in image used by contained radios.\n- **description** - A description of the radio's label. Serves as help text for a radio item. Alternatively, you can use the `description` attribute.\n- **selected-content** - Use to nest rich content (like an input) inside a selected radio item. Use only with the contained style.\n\n### **CSS Properties:**\n - **--zn-selection-card-image-width** - Width of the built-in card image. _(default: undefined)_\n- **--zn-selection-card-image-height** - Height of the built-in card image. _(default: undefined)_\n- **--zn-selection-card-min-height** - Minimum height of a contained radio with an image. _(default: undefined)_\n- **--zn-selection-card-content-min-width** - Width the card text keeps before it wraps below the image. _(default: undefined)_\n- **--zn-selection-card-title-font-size** - Font size of a selection card title. _(default: undefined)_\n- **--zn-selection-card-padding** - Equal inset around the contents of a selection card. _(default: undefined)_\n- **--zn-selection-card-gap** - Space between the image, title, and indicator gutter. _(default: undefined)_\n- **--zn-selection-card-control-offset** - Distance between a positioned control and the card edge. _(default: undefined)_\n- **--zn-selection-card-border-radius** - Corner radius of a contained container. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **control** - The square container that wraps the radio's checked state.\n- **control--checked** - Matches the control part when the radio is checked.\n- **checked-icon** - The checked dot, a `<span>` element.\n- **image-container** - The wrapper around the built-in image or image slot.\n- **image** - The built-in image.\n- **card-title** - The title inside a selection card.\n- **label** - The container that wraps the radio's label.\n- **description** - The container that wraps the radio's description.\n- **selected-content** - The container that wraps optional content that appears when a radio is checked.",
           "doc-url": "",
           "attributes": [
             { "name": "title", "value": { "type": "string", "default": "''" } },
@@ -8140,6 +9489,11 @@
               "description": "Squares off the corners of the container drawn by `contained`, which is rounded by default.",
               "value": { "type": "boolean", "default": "false" }
             },
+            {
+              "name": "centered",
+              "description": "Centres the text of a contained radio that has no image or `card-title`.",
+              "value": { "type": "boolean", "default": "false" }
+            },
             {
               "name": "src",
               "description": "URL for the image shown in a contained radio.",
@@ -8160,15 +9514,25 @@
             },
             {
               "name": "control-position",
-              "description": "Places the radio indicator within a contained card. Use `none` to hide the indicator so the card itself\nshows the selected state. Requires `contained`.",
+              "description": "Places the radio indicator within a contained card. A contained radio without an image or `card-title` hides it\nat `start`, as does `none`. Requires `contained`.",
               "value": {
                 "type": "SelectionCardControlPosition",
                 "default": "'start'"
               }
             },
             {
-              "name": "horizontal",
-              "description": "Applies styles relevant to radios in a horizontal layout.",
+              "name": "horizontal",
+              "description": "Applies styles relevant to radios in a horizontal layout.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "scale",
+              "description": "Draws the radio as one segment of a scale. Set by a radio group with `scale`.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "filled",
+              "description": "Fills a scale segment, as one at or before the group's checked radio. Set by a radio group with `scale`.",
               "value": { "type": "boolean", "default": "false" }
             },
             {
@@ -8229,6 +9593,7 @@
           "js": {
             "properties": [
               { "name": "input", "type": "HTMLInputElement" },
+              { "name": "control", "type": "HTMLElement" },
               { "name": "title", "type": "string" },
               {
                 "name": "name",
@@ -8270,6 +9635,11 @@
                 "description": "Squares off the corners of the container drawn by `contained`, which is rounded by default.",
                 "type": "boolean"
               },
+              {
+                "name": "centered",
+                "description": "Centres the text of a contained radio that has no image or `card-title`.",
+                "type": "boolean"
+              },
               {
                 "name": "src",
                 "description": "URL for the image shown in a contained radio.",
@@ -8287,7 +9657,7 @@
               },
               {
                 "name": "controlPosition",
-                "description": "Places the radio indicator within a contained card. Use `none` to hide the indicator so the card itself\nshows the selected state. Requires `contained`.",
+                "description": "Places the radio indicator within a contained card. A contained radio without an image or `card-title` hides it\nat `start`, as does `none`. Requires `contained`.",
                 "type": "SelectionCardControlPosition"
               },
               {
@@ -8295,6 +9665,16 @@
                 "description": "Applies styles relevant to radios in a horizontal layout.",
                 "type": "boolean"
               },
+              {
+                "name": "scale",
+                "description": "Draws the radio as one segment of a scale. Set by a radio group with `scale`.",
+                "type": "boolean"
+              },
+              {
+                "name": "filled",
+                "description": "Fills a scale segment, as one at or before the group's checked radio. Set by a radio group with `scale`.",
+                "type": "boolean"
+              },
               {
                 "name": "defaultChecked",
                 "description": "The default value of the form control. Primarily used for resetting the form control.",
@@ -8403,11 +9783,21 @@
               "description": "Squares off the corners of every contained radio in the group, which are rounded by default.",
               "value": { "type": "boolean", "default": "false" }
             },
+            {
+              "name": "centered",
+              "description": "Centres the text of every contained radio in the group.",
+              "value": { "type": "boolean", "default": "false" }
+            },
             {
               "name": "wrap",
               "description": "Lays horizontal contained radios out as a wrapping row instead of an equal-width grid, so each one sizes from\n`--zn-radio-group-column-width` (set it to `auto` to size from content) and wraps onto a new line when needed.",
               "value": { "type": "boolean", "default": "false" }
             },
+            {
+              "name": "scale",
+              "description": "Lays the radios out as a segmented scale, in document order, filling every segment up to the checked one. Suits\nordered answers such as 1 to 10, and unlike a range input it has no value until one is picked.",
+              "value": { "type": "boolean", "default": "false" }
+            },
             {
               "name": "form",
               "description": "By default, form controls are associated with the nearest containing `<form>` element. This attribute allows you\nto place the form control outside a form and associate it with the form that has this `id`. The form must be in\nthe same document or shadow root for this to work.",
@@ -8476,11 +9866,21 @@
                 "description": "Squares off the corners of every contained radio in the group, which are rounded by default.",
                 "type": "boolean"
               },
+              {
+                "name": "centered",
+                "description": "Centres the text of every contained radio in the group.",
+                "type": "boolean"
+              },
               {
                 "name": "wrap",
                 "description": "Lays horizontal contained radios out as a wrapping row instead of an equal-width grid, so each one sizes from\n`--zn-radio-group-column-width` (set it to `auto` to size from content) and wraps onto a new line when needed.",
                 "type": "boolean"
               },
+              {
+                "name": "scale",
+                "description": "Lays the radios out as a segmented scale, in document order, filling every segment up to the checked one. Suits\nordered answers such as 1 to 10, and unlike a range input it has no value until one is picked.",
+                "type": "boolean"
+              },
               {
                 "name": "form",
                 "description": "By default, form controls are associated with the nearest containing `<form>` element. This attribute allows you\nto place the form control outside a form and associate it with the form that has this `id`. The form must be in\nthe same document or shadow root for this to work.",
@@ -8752,6 +10152,179 @@
             ]
           }
         },
+        {
+          "name": "zn-report-table",
+          "description": "A grouped report: one row per value of a dimension, read column by column, with a total row.\n\n---\n\n\n### **Events:**\n - **zn-report-change** - Emitted when the type, group by, date range or filter is changed, before the report is fetched again.\n\n### **Slots:**\n - **inputs** - Inputs whose name and value are sent with every request (csrf tokens and similar).\n- **empty-state** - Replaces the default empty state.",
+          "doc-url": "",
+          "attributes": [
+            { "name": "data-uri", "value": { "type": "string" } },
+            {
+              "name": "method",
+              "value": { "type": "'GET' | 'POST'", "default": "'POST'" }
+            },
+            {
+              "name": "caption",
+              "value": { "type": "string", "default": "''" }
+            },
+            { "name": "type", "value": { "type": "string", "default": "''" } },
+            {
+              "name": "group-by",
+              "value": { "type": "string", "default": "''" }
+            },
+            { "name": "from", "value": { "type": "string", "default": "''" } },
+            { "name": "to", "value": { "type": "string", "default": "''" } },
+            {
+              "name": "filter",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "currency",
+              "value": { "type": "string", "default": "'USD'" }
+            },
+            { "name": "locale", "value": { "type": "string" } },
+            {
+              "name": "types",
+              "description": "Report types, shown as tabs when there are two or more. `type` defaults to the first.",
+              "value": { "type": "ReportOption[]", "default": "[]" }
+            },
+            {
+              "name": "group-bys",
+              "description": "Group by options; those with a `category` are listed under its heading.",
+              "value": { "type": "ReportOption[]", "default": "[]" }
+            },
+            {
+              "name": "filter-fields",
+              "description": "Fields for the funnel's filter builder. The funnel is hidden when there are none.",
+              "value": { "type": "ReportFilterField[]", "default": "[]" }
+            },
+            {
+              "name": "presets",
+              "description": "Quick ranges for the date range, replacing the default ones.",
+              "value": { "type": "DatePreset[] | undefined" }
+            },
+            {
+              "name": "max-date",
+              "description": "The latest day that can be picked. Defaults to today.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "date-note",
+              "description": "A short line shown under the date range's calendar.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "search-placeholder",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "sharable",
+              "description": "Mirrors the type, group by, dates, filter and search to the URL query string, and reads them back on load.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "hide-empty-columns",
+              "description": "Leaves out columns that are zero or empty in every row, and groups left without columns.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "selectable",
+              "description": "Gives each row a tick box that highlights it, with one in the heading for every row shown.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "heatmap",
+              "description": "Shades number cells by their size against the largest in their column.",
+              "value": { "type": "boolean", "default": "false" }
+            }
+          ],
+          "slots": [
+            {
+              "name": "inputs",
+              "description": "Inputs whose name and value are sent with every request (csrf tokens and similar)."
+            },
+            {
+              "name": "empty-state",
+              "description": "Replaces the default empty state."
+            }
+          ],
+          "events": [
+            {
+              "name": "zn-report-change",
+              "description": "Emitted when the type, group by, date range or filter is changed, before the report is fetched again."
+            }
+          ],
+          "js": {
+            "properties": [
+              { "name": "dataUri", "type": "string" },
+              { "name": "method", "type": "'GET' | 'POST'" },
+              { "name": "caption", "type": "string" },
+              { "name": "type", "type": "string" },
+              { "name": "groupBy", "type": "string" },
+              { "name": "from", "type": "string" },
+              { "name": "to", "type": "string" },
+              { "name": "filter", "type": "string" },
+              { "name": "currency", "type": "string" },
+              { "name": "locale", "type": "string" },
+              {
+                "name": "types",
+                "description": "Report types, shown as tabs when there are two or more. `type` defaults to the first.",
+                "type": "ReportOption[]"
+              },
+              {
+                "name": "groupBys",
+                "description": "Group by options; those with a `category` are listed under its heading.",
+                "type": "ReportOption[]"
+              },
+              {
+                "name": "filterFields",
+                "description": "Fields for the funnel's filter builder. The funnel is hidden when there are none.",
+                "type": "ReportFilterField[]"
+              },
+              {
+                "name": "presets",
+                "description": "Quick ranges for the date range, replacing the default ones.",
+                "type": "DatePreset[] | undefined"
+              },
+              {
+                "name": "maxDate",
+                "description": "The latest day that can be picked. Defaults to today.",
+                "type": "string"
+              },
+              {
+                "name": "dateNote",
+                "description": "A short line shown under the date range's calendar.",
+                "type": "string"
+              },
+              { "name": "searchPlaceholder", "type": "string" },
+              {
+                "name": "sharable",
+                "description": "Mirrors the type, group by, dates, filter and search to the URL query string, and reads them back on load.",
+                "type": "boolean"
+              },
+              {
+                "name": "hideEmptyColumns",
+                "description": "Leaves out columns that are zero or empty in every row, and groups left without columns.",
+                "type": "boolean"
+              },
+              {
+                "name": "selectable",
+                "description": "Gives each row a tick box that highlights it, with one in the heading for every row shown.",
+                "type": "boolean"
+              },
+              {
+                "name": "heatmap",
+                "description": "Shades number cells by their size against the largest in their column.",
+                "type": "boolean"
+              }
+            ],
+            "events": [
+              {
+                "name": "zn-report-change",
+                "description": "Emitted when the type, group by, date range or filter is changed, before the report is fetched again."
+              }
+            ]
+          }
+        },
         {
           "name": "zn-reveal",
           "description": "Short summary of the component's intended use.\n\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
@@ -9255,6 +10828,11 @@
               "description": "The select's required attribute.",
               "value": { "type": "boolean", "default": "false" }
             },
+            {
+              "name": "label-note",
+              "description": "Short text shown next to the label, styled like the help text, e.g. `optional`.",
+              "value": { "type": "string", "default": "''" }
+            },
             {
               "name": "cache-key",
               "value": { "type": "string", "default": "\"\"" }
@@ -9528,6 +11106,11 @@
                 "description": "The select's required attribute.",
                 "type": "boolean"
               },
+              {
+                "name": "labelNote",
+                "description": "Short text shown next to the label, styled like the help text, e.g. `optional`.",
+                "type": "string"
+              },
               { "name": "cacheKey", "type": "string" },
               { "name": "triggerSubmit", "type": "boolean" },
               {
@@ -9801,8 +11384,8 @@
             },
             {
               "name": "radius",
-              "description": "Border radius of the skeleton element. Default: \"4px\"",
-              "value": { "type": "string", "default": "'4px'" }
+              "description": "Border radius of the skeleton element. Defaults to the theme's `--zn-skeleton-border-radius` (4px).",
+              "value": { "type": "string", "default": "''" }
             }
           ],
           "events": [],
@@ -9825,7 +11408,7 @@
               },
               {
                 "name": "radius",
-                "description": "Border radius of the skeleton element. Default: \"4px\"",
+                "description": "Border radius of the skeleton element. Defaults to the theme's `--zn-skeleton-border-radius` (4px).",
                 "type": "string"
               }
             ],
@@ -10527,12 +12110,45 @@
             },
             {
               "name": "layout",
-              "description": "`value-first` puts the amount under the caption with the description beneath it, and tints the amount rather\nthan the description with `color`.",
+              "description": "`value-first` puts the amount under the caption with the description beneath it, and tints the amount rather\nthan the description with `color`. `tile` is a self-contained card: caption, amount, a footer with the delta and\n`description`, an optional sparkline, and the default slot beneath.",
               "value": {
-                "type": "'default' | 'value-first'",
+                "type": "'default' | 'value-first' | 'tile'",
                 "default": "'default'"
               }
             },
+            {
+              "name": "spark",
+              "description": "Comma-separated values drawn as a sparkline under a `tile`.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "spark-color",
+              "description": "The sparkline's colour: a tone (`primary`, `info`, `success`, `warning`, `danger`, `ai`) or any CSS colour.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "invert-delta",
+              "description": "Treats a rise as bad news, so an increase is coloured as a loss (declines, refunds, failures).",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "tone",
+              "description": "A coloured dot before a `tile`'s caption.",
+              "value": {
+                "type": "'' | 'info' | 'success' | 'warning' | 'danger' | 'neutral'",
+                "default": "''"
+              }
+            },
+            {
+              "name": "selectable",
+              "description": "Renders a `tile` as a toggle button, for tiles that filter the content below them.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "selected",
+              "description": "Whether a `selectable` tile is pressed, or a linked tile marks the view the page is showing.",
+              "value": { "type": "boolean", "default": "false" }
+            },
             {
               "name": "delta-format",
               "description": "How `show-delta` compares with `previous`: the relative change, or the difference in points.",
@@ -10560,6 +12176,23 @@
               "name": "padded",
               "description": "Pads the stat, for stats laid edge to edge in a flush container such as `zn-cols no-gap divide`.",
               "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "href",
+              "description": "Makes the whole stat a link, marked with an arrow in its corner.",
+              "value": { "type": "string" }
+            },
+            { "name": "data-target", "value": { "type": "string" } },
+            { "name": "gaid", "value": { "type": "string" } },
+            {
+              "name": "data-url",
+              "description": "JSON fetched once to fill the stat: any of `caption`, `amount`, `description`, `previous`, `spark` and\n`sparkColor`. The stat's own attributes show until it loads.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "loading",
+              "description": "Shows a `tile` as a placeholder. Set while `data-url` loads; the sparkline draws in once it clears.",
+              "value": { "type": "boolean", "default": "false" }
             }
           ],
           "events": [],
@@ -10578,8 +12211,38 @@
               },
               {
                 "name": "layout",
-                "description": "`value-first` puts the amount under the caption with the description beneath it, and tints the amount rather\nthan the description with `color`.",
-                "type": "'default' | 'value-first'"
+                "description": "`value-first` puts the amount under the caption with the description beneath it, and tints the amount rather\nthan the description with `color`. `tile` is a self-contained card: caption, amount, a footer with the delta and\n`description`, an optional sparkline, and the default slot beneath.",
+                "type": "'default' | 'value-first' | 'tile'"
+              },
+              {
+                "name": "spark",
+                "description": "Comma-separated values drawn as a sparkline under a `tile`.",
+                "type": "string"
+              },
+              {
+                "name": "sparkColor",
+                "description": "The sparkline's colour: a tone (`primary`, `info`, `success`, `warning`, `danger`, `ai`) or any CSS colour.",
+                "type": "string"
+              },
+              {
+                "name": "invertDelta",
+                "description": "Treats a rise as bad news, so an increase is coloured as a loss (declines, refunds, failures).",
+                "type": "boolean"
+              },
+              {
+                "name": "tone",
+                "description": "A coloured dot before a `tile`'s caption.",
+                "type": "'' | 'info' | 'success' | 'warning' | 'danger' | 'neutral'"
+              },
+              {
+                "name": "selectable",
+                "description": "Renders a `tile` as a toggle button, for tiles that filter the content below them.",
+                "type": "boolean"
+              },
+              {
+                "name": "selected",
+                "description": "Whether a `selectable` tile is pressed, or a linked tile marks the view the page is showing.",
+                "type": "boolean"
               },
               {
                 "name": "deltaFormat",
@@ -10605,6 +12268,23 @@
                 "name": "padded",
                 "description": "Pads the stat, for stats laid edge to edge in a flush container such as `zn-cols no-gap divide`.",
                 "type": "boolean"
+              },
+              {
+                "name": "href",
+                "description": "Makes the whole stat a link, marked with an arrow in its corner.",
+                "type": "string"
+              },
+              { "name": "dataTarget", "type": "string" },
+              { "name": "gaid", "type": "string" },
+              {
+                "name": "dataUrl",
+                "description": "JSON fetched once to fill the stat: any of `caption`, `amount`, `description`, `previous`, `spark` and\n`sparkColor`. The stat's own attributes show until it loads.",
+                "type": "string"
+              },
+              {
+                "name": "loading",
+                "description": "Shows a `tile` as a placeholder. Set while `data-url` loads; the sparkline draws in once it clears.",
+                "type": "boolean"
               }
             ],
             "events": []
@@ -10815,6 +12495,7 @@
           "doc-url": "",
           "attributes": [
             { "name": "caption", "value": { "type": "string" } },
+            { "name": "icon", "value": { "type": "string" } },
             { "name": "priority", "value": { "type": "number" } },
             { "name": "uri", "value": { "type": "string" } },
             {
@@ -10828,6 +12509,7 @@
           "js": {
             "properties": [
               { "name": "caption", "type": "string" },
+              { "name": "icon", "type": "string" },
               { "name": "priority", "type": "number" },
               { "name": "uri", "type": "string" },
               {
@@ -10937,6 +12619,16 @@
               "name": "padded",
               "value": { "type": "boolean", "default": "false" }
             },
+            {
+              "name": "select-added",
+              "description": "With `store-key`, opens a tab that has appeared since the page was last shown, such as one for an item just\nadded, in place of the remembered tab.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "gap",
+              "description": "Spaces a left or right slot from the content, for side navigation laid out as its own card.",
+              "value": { "type": "boolean", "default": "false" }
+            },
             {
               "name": "fetch-style",
               "value": { "type": "string", "default": "\"\"" }
@@ -10977,6 +12669,16 @@
               { "name": "storeKey", "type": "string" },
               { "name": "storeTtl", "type": "number" },
               { "name": "padded", "type": "boolean" },
+              {
+                "name": "selectAdded",
+                "description": "With `store-key`, opens a tab that has appeared since the page was last shown, such as one for an item just\nadded, in place of the remembered tab.",
+                "type": "boolean"
+              },
+              {
+                "name": "gap",
+                "description": "Spaces a left or right slot from the content, for side navigation laid out as its own card.",
+                "type": "boolean"
+              },
               { "name": "fetchStyle", "type": "string" },
               { "name": "fullWidth", "type": "boolean" },
               { "name": "paddedRight", "type": "boolean" },
@@ -11080,6 +12782,11 @@
               "description": "Makes the textarea a required field.",
               "value": { "type": "boolean", "default": "false" }
             },
+            {
+              "name": "label-note",
+              "description": "Short text shown next to the label, styled like the help text, e.g. `optional`.",
+              "value": { "type": "string", "default": "''" }
+            },
             {
               "name": "minlength",
               "description": "The minimum length of input that will be considered valid.",
@@ -11300,6 +13007,11 @@
                 "description": "Makes the textarea a required field.",
                 "type": "boolean"
               },
+              {
+                "name": "labelNote",
+                "description": "Short text shown next to the label, styled like the help text, e.g. `optional`.",
+                "type": "string"
+              },
               {
                 "name": "minlength",
                 "description": "The minimum length of input that will be considered valid.",
@@ -12068,11 +13780,24 @@
         },
         {
           "name": "zn-tile",
-          "description": "Short summary of the component's intended use.\n\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
+          "description": "Short summary of the component's intended use.\n\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n- **--zn-tile-hover-caption-color** - The caption color while a linked tile is hovered. _(default: undefined)_\n- **--zn-tile-hover-caption-decoration** - The caption text decoration while a linked tile is hovered. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **icon** - The tinted square around the icon.",
           "doc-url": "",
           "attributes": [
             { "name": "caption", "value": { "type": "string" } },
             { "name": "description", "value": { "type": "string" } },
+            {
+              "name": "icon",
+              "description": "Shows the icon in a tinted square before the caption.",
+              "value": { "type": "string" }
+            },
+            {
+              "name": "icon-color",
+              "description": "The tint of the icon square: `success`, `warning`, `danger`, `info`, `ai` or `neutral`.",
+              "value": {
+                "type": "'success' | 'warning' | 'danger' | 'info' | 'ai' | 'neutral'",
+                "default": "'neutral'"
+              }
+            },
             { "name": "href", "value": { "type": "string" } },
             { "name": "data-target", "value": { "type": "string" } },
             { "name": "gaid", "value": { "type": "string" } },
@@ -12108,6 +13833,16 @@
             "properties": [
               { "name": "caption", "type": "string" },
               { "name": "description", "type": "string" },
+              {
+                "name": "icon",
+                "description": "Shows the icon in a tinted square before the caption.",
+                "type": "string"
+              },
+              {
+                "name": "iconColor",
+                "description": "The tint of the icon square: `success`, `warning`, `danger`, `info`, `ai` or `neutral`.",
+                "type": "'success' | 'warning' | 'danger' | 'info' | 'ai' | 'neutral'"
+              },
               { "name": "href", "type": "string" },
               { "name": "dataTarget", "type": "string" },
               { "name": "gaid", "type": "string" },
@@ -12225,7 +13960,7 @@
         },
         {
           "name": "zn-toggle",
-          "description": "Toggles allow the user to switch an option on or off.\n\n---\n\n\n### **Events:**\n - **zn-input** - Emitted when the toggle receives input.\n\n### **Slots:**\n - _default_ - The toggle's label.\n- **description** - A description of the toggle's label. Alternatively, you can use the `description` attribute.\n- **help-text** - Text that describes how to use the toggle. Alternatively, you can use the `help-text` attribute.\n\n### **CSS Properties:**\n - **--zn-toggle-margin** - The margin around the toggle switch. Defaults to `8px 0`. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper containing the toggle switch.\n- **control** - The toggle switch control (the circular button that slides).\n- **label** - The toggle's label.\n- **description** - The container that wraps the toggle's description.",
+          "description": "Toggles allow the user to switch an option on or off.\n\n---\n\n\n### **Events:**\n - **zn-input** - Emitted when the toggle receives input.\n- **zn-change** - Emitted when the toggle is switched on or off.\n\n### **Slots:**\n - _default_ - The toggle's label.\n- **description** - A description of the toggle's label. Alternatively, you can use the `description` attribute.\n- **help-text** - Text that describes how to use the toggle. Alternatively, you can use the `help-text` attribute.\n\n### **CSS Properties:**\n - **--zn-toggle-margin** - The margin around the toggle switch. Defaults to `8px 0`. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper containing the toggle switch.\n- **control** - The toggle switch control (the circular button that slides).\n- **label** - The toggle's label.\n- **description** - The container that wraps the toggle's description.",
           "doc-url": "",
           "attributes": [
             {
@@ -12311,11 +14046,16 @@
             {
               "name": "zn-input",
               "description": "Emitted when the toggle receives input."
+            },
+            {
+              "name": "zn-change",
+              "description": "Emitted when the toggle is switched on or off."
             }
           ],
           "js": {
             "properties": [
               { "name": "input", "type": "HTMLInputElement" },
+              { "name": "knob", "type": "HTMLElement" },
               { "name": "hasFocus", "type": "boolean" },
               { "name": "title", "type": "string" },
               { "name": "name", "type": "string" },
@@ -12350,6 +14090,10 @@
               {
                 "name": "zn-input",
                 "description": "Emitted when the toggle receives input."
+              },
+              {
+                "name": "zn-change",
+                "description": "Emitted when the toggle is switched on or off."
               }
             ]
           }
@@ -12457,9 +14201,186 @@
             ]
           }
         },
+        {
+          "name": "zn-translation-field",
+          "description": "A field's source text beside the control that translates it.\n\n---\n\n\n### **Slots:**\n - _default_ - The control the translation is written in, such as a `zn-input` with the language code as its prefix.\n- **source** - The source text, shown read-only.\n- **actions** - Actions beside the label.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **source** - The box holding the source.",
+          "doc-url": "",
+          "attributes": [
+            { "name": "label", "value": { "type": "string", "default": "''" } },
+            {
+              "name": "source-code",
+              "description": "The source's language code, shown beside it.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "multiline",
+              "description": "For source text that runs over several lines, such as a message body.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "offset",
+              "description": "Lines the source up with a control that has a toolbar above it, such as a compact `zn-editor`.",
+              "value": { "type": "boolean", "default": "false" }
+            }
+          ],
+          "slots": [
+            {
+              "name": "",
+              "description": "The control the translation is written in, such as a `zn-input` with the language code as its prefix."
+            },
+            {
+              "name": "source",
+              "description": "The source text, shown read-only."
+            },
+            { "name": "actions", "description": "Actions beside the label." }
+          ],
+          "events": [],
+          "js": {
+            "properties": [
+              { "name": "label", "type": "string" },
+              {
+                "name": "sourceCode",
+                "description": "The source's language code, shown beside it.",
+                "type": "string"
+              },
+              {
+                "name": "multiline",
+                "description": "For source text that runs over several lines, such as a message body.",
+                "type": "boolean"
+              },
+              {
+                "name": "offset",
+                "description": "Lines the source up with a control that has a toolbar above it, such as a compact `zn-editor`.",
+                "type": "boolean"
+              }
+            ],
+            "events": []
+          }
+        },
+        {
+          "name": "zn-translation-fields",
+          "description": "Lays out `zn-translation-field`s with their source beside or above the translation, chosen by the viewer.\n\n---\n\n\n### **Slots:**\n - _default_ - The `zn-translation-field`s.\n- **actions** - Actions level with the layout switch.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
+          "doc-url": "",
+          "attributes": [
+            {
+              "name": "layout",
+              "value": {
+                "type": "TranslationFieldsLayout",
+                "default": "'split'"
+              }
+            },
+            {
+              "name": "store-key",
+              "description": "Remembers the viewer's layout under this key in `localStorage`; leave empty to forget it.",
+              "value": {
+                "type": "string",
+                "default": "'zn-translation-fields-layout'"
+              }
+            }
+          ],
+          "slots": [
+            { "name": "", "description": "The `zn-translation-field`s." },
+            {
+              "name": "actions",
+              "description": "Actions level with the layout switch."
+            }
+          ],
+          "events": [],
+          "js": {
+            "properties": [
+              { "name": "layout", "type": "TranslationFieldsLayout" },
+              {
+                "name": "storeKey",
+                "description": "Remembers the viewer's layout under this key in `localStorage`; leave empty to forget it.",
+                "type": "string"
+              }
+            ],
+            "events": []
+          }
+        },
+        {
+          "name": "zn-translation-grid",
+          "description": "Shows how far each language's translation has got, with a column per language to choose and enable it,\nand optionally a row per translated field.\n\n---\n\n\n### **Slots:**\n - _default_ - Help text under the legend.\n- **enable-{code}** - The control that enables the language with that code, such as a `zn-checkbox` in a form. The Enable row only shows when at least one is given.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
+          "doc-url": "",
+          "attributes": [
+            {
+              "name": "languages",
+              "description": "The languages, in column order, as a JSON array of `{code, label, status, href}`.",
+              "value": { "type": "TranslationGridLanguage[]", "default": "[]" }
+            },
+            {
+              "name": "fields",
+              "description": "A row per translated field, as a JSON array of `{key, label, cells}`; without it there is one Translation row.",
+              "value": { "type": "TranslationGridField[]", "default": "[]" }
+            },
+            {
+              "name": "selected",
+              "description": "The code of the language being edited.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "selected-field",
+              "description": "The key of the field being edited, when there are `fields`.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "link-target",
+              "description": "Where the language links open, as a console `data-target`; `self` replaces the content they sit in.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "source-label",
+              "description": "Names the source in the legend, such as \"English changed\".",
+              "value": { "type": "string", "default": "'English'" }
+            }
+          ],
+          "slots": [
+            { "name": "", "description": "Help text under the legend." },
+            {
+              "name": "enable-{code}",
+              "description": "The control that enables the language with that code, such as a `zn-checkbox` in a form. The Enable row only shows when at least one is given."
+            }
+          ],
+          "events": [],
+          "js": {
+            "properties": [
+              {
+                "name": "languages",
+                "description": "The languages, in column order, as a JSON array of `{code, label, status, href}`.",
+                "type": "TranslationGridLanguage[]"
+              },
+              {
+                "name": "fields",
+                "description": "A row per translated field, as a JSON array of `{key, label, cells}`; without it there is one Translation row.",
+                "type": "TranslationGridField[]"
+              },
+              {
+                "name": "selected",
+                "description": "The code of the language being edited.",
+                "type": "string"
+              },
+              {
+                "name": "selectedField",
+                "description": "The key of the field being edited, when there are `fields`.",
+                "type": "string"
+              },
+              {
+                "name": "linkTarget",
+                "description": "Where the language links open, as a console `data-target`; `self` replaces the content they sit in.",
+                "type": "string"
+              },
+              {
+                "name": "sourceLabel",
+                "description": "Names the source in the legend, such as \"English changed\".",
+                "type": "string"
+              }
+            ],
+            "events": []
+          }
+        },
         {
           "name": "zn-translation-group",
-          "description": "Puts several zn-translations fields behind one language select, so a whole form's worth of copy is\ntranslated a language at a time.\n\n---\n\n\n### **Events:**\n - **zn-language-change** - Emitted when the active language changes. Detail: `{ language: string }`.\n\n### **Slots:**\n - _default_ - The `zn-translations` fields the select drives.\n- **actions** - Buttons for the bottom of the panel, on the white body rather than the grey footer. They sit on the right, as zinc's form action rows do; `align=\"start\"` moves one to the left. Write them in the order they should be read — the sides are set by CSS ordering, so markup order is what a keyboard follows.\n- **footer** - Content displayed in the grey panel footer.\n\n### **CSS Properties:**\n - **--zn-panel-basis** - The flex-basis of the panel. Can be set using the basis-px attribute. _(default: undefined)_\n- **--zn-panel-header-padding** - Padding around the header row. Defaults to `--zn-base-gap`. _(default: undefined)_\n- **--zn-panel-footer-padding** - Padding around the footer row. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **form-group** - The form group holding the caption, the language select and the fields.\n- **actions** - The row of buttons at the bottom of the body.\n- **language-field** - The select that chooses the language every child is editing, in the group's chip slot.\n- **language-select** - The select itself.\n- **header** - The header region, when a caption or actions are given.\n- **header-content** - The padded row inside the header, forwarded from zn-header.\n- **footer** - The footer region, when the footer slot is filled.",
+          "description": "Puts several zn-translations fields behind one language select, so a whole form's worth of copy is\ntranslated a language at a time.\n\n---\n\n\n### **Events:**\n - **zn-language-change** - Emitted when the active language changes. Detail: `{ language: string }`.\n\n### **Slots:**\n - _default_ - The `zn-translations` fields the select drives.\n- **actions** - Buttons for the bottom of the panel, on the white body rather than the grey footer. They sit on the right, as zinc's form action rows do; `align=\"start\"` moves one to the left. Write them in the order they should be read — the sides are set by CSS ordering, so markup order is what a keyboard follows.\n- **footer** - Content displayed in the grey panel footer.\n\n### **CSS Properties:**\n - **--zn-panel-basis** - The flex-basis of the panel. Can be set using the basis-px attribute. _(default: undefined)_\n- **--zn-panel-header-padding** - Padding around the header row. Defaults to `--zn-base-gap`. _(default: undefined)_\n- **--zn-panel-footer-padding** - Padding around the footer row. _(default: undefined)_\n- **--zn-panel-padding** - Padding around the body. Defaults to `--zn-base-gap`. _(default: undefined)_\n- **--zn-panel-shadow** - Resting shadow. Defaults to none. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **form-group** - The form group holding the caption, the language select and the fields.\n- **actions** - The row of buttons at the bottom of the body.\n- **language-field** - The select that chooses the language every child is editing, in the group's chip slot.\n- **language-select** - The select itself.\n- **header** - The header region, when a caption or actions are given.\n- **header-content** - The padded row inside the header, forwarded from zn-header.\n- **header-left** - The caption and description, forwarded from zn-header.\n- **footer** - The footer region, when the footer slot is filled.",
           "doc-url": "",
           "attributes": [
             {
@@ -12492,6 +14413,16 @@
             },
             { "name": "basis-px", "value": { "type": "number" } },
             { "name": "caption", "value": { "type": "string" } },
+            {
+              "name": "description",
+              "description": "Help text under the caption, in the panel's header.",
+              "value": { "type": "string" }
+            },
+            {
+              "name": "inline-description",
+              "description": "Sets the description beside the caption rather than under it.",
+              "value": { "type": "boolean", "default": "false" }
+            },
             { "name": "icon", "value": { "type": "string" } },
             { "name": "tabbed", "value": { "type": "boolean" } },
             { "name": "header-borderless", "value": { "type": "boolean" } },
@@ -12552,6 +14483,16 @@
               },
               { "name": "basis", "type": "number" },
               { "name": "caption", "type": "string" },
+              {
+                "name": "description",
+                "description": "Help text under the caption, in the panel's header.",
+                "type": "string"
+              },
+              {
+                "name": "inlineDescription",
+                "description": "Sets the description beside the caption rather than under it.",
+                "type": "boolean"
+              },
               { "name": "icon", "type": "string" },
               { "name": "tabbed", "type": "boolean" },
               { "name": "headerBorderless", "type": "boolean" },
@@ -12860,9 +14801,53 @@
             ]
           }
         },
+        {
+          "name": "zn-well",
+          "description": "Short summary of the component's intended use.\n\n---\n\n\n### **Slots:**\n - _default_ - The default slot.\n- **action** - Content displayed on the right hand side of the well.",
+          "doc-url": "",
+          "attributes": [
+            { "name": "icon", "value": { "type": "string", "default": "''" } },
+            { "name": "inline", "value": { "type": "boolean" } },
+            {
+              "name": "pre",
+              "description": "Renders the default slot inside a `pre` element, preserving whitespace using a monospace font.",
+              "value": { "type": "boolean" }
+            },
+            {
+              "name": "break-long",
+              "description": "Breaks long unbroken words, so they wrap instead of forcing the well wider.",
+              "value": { "type": "boolean" }
+            }
+          ],
+          "slots": [
+            { "name": "", "description": "The default slot." },
+            {
+              "name": "action",
+              "description": "Content displayed on the right hand side of the well."
+            }
+          ],
+          "events": [],
+          "js": {
+            "properties": [
+              { "name": "icon", "type": "string" },
+              { "name": "inline", "type": "boolean" },
+              {
+                "name": "pre",
+                "description": "Renders the default slot inside a `pre` element, preserving whitespace using a monospace font.",
+                "type": "boolean"
+              },
+              {
+                "name": "breakLong",
+                "description": "Breaks long unbroken words, so they wrap instead of forcing the well wider.",
+                "type": "boolean"
+              }
+            ],
+            "events": []
+          }
+        },
         {
           "name": "zn-vertical-stepper",
-          "description": "Vertical steppers display a sequence of steps in a vertical layout with descriptions and optional icons.\n\n---\n\n\n### **Slots:**\n - **icon** - Optional slot for adding an icon or indicator before the step content.\n\n### **CSS Parts:**\n - **vs** - The main container for the vertical stepper.\n- **vs__left** - The left section containing the icon and connecting line.\n- **vs__icon** - The icon container.\n- **vs__line** - The vertical connecting line between steps.\n- **vs__right** - The right section containing caption and description text.\n- **vs__caption** - The caption/title text element.\n- **vs__description** - The description text element.",
+          "description": "Vertical steppers display a sequence of steps in a vertical layout with descriptions and optional icons.\n\n---\n\n\n### **Slots:**\n - _default_ - Content below the caption and description, such as metadata or chips.\n- **icon** - Optional slot for adding an icon or indicator before the step content.\n- **suffix** - Inline content after the caption and description, such as status chips.\n- **actions** - Controls aligned to the end of the step.\n\n### **CSS Parts:**\n - **vs** - The main container for the vertical stepper.\n- **vs__left** - The left section containing the icon and connecting line.\n- **vs__icon** - The icon container.\n- **vs__line** - The vertical connecting line between steps.\n- **vs__right** - The right section containing caption and description text.\n- **vs__caption** - The caption/title text element.\n- **vs__description** - The description text element.\n- **vs__content** - The container for the default slot.\n- **vs__actions** - The container for the actions slot.",
           "doc-url": "",
           "attributes": [
             {
@@ -12889,12 +14874,44 @@
               "name": "caption",
               "description": "The main label/title for this step.",
               "value": { "type": "string" }
+            },
+            {
+              "name": "type",
+              "description": "Marker colour: neutral, primary, success, error, warning, info or ai (AI-generated steps only). Overrides `active`.",
+              "value": { "type": "string" }
+            },
+            {
+              "name": "selected",
+              "description": "When true, rings the marker to show the step is picked.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "dashed",
+              "description": "When true, draws the marker's border dashed, for a step that is not yet final.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "highlight-line",
+              "description": "When true, colours the line below this step's marker, joining it to the next step.",
+              "value": { "type": "boolean", "default": "false" }
             }
           ],
           "slots": [
+            {
+              "name": "",
+              "description": "Content below the caption and description, such as metadata or chips."
+            },
             {
               "name": "icon",
               "description": "Optional slot for adding an icon or indicator before the step content."
+            },
+            {
+              "name": "suffix",
+              "description": "Inline content after the caption and description, such as status chips."
+            },
+            {
+              "name": "actions",
+              "description": "Controls aligned to the end of the step."
             }
           ],
           "events": [],
@@ -12924,49 +14941,25 @@
                 "name": "caption",
                 "description": "The main label/title for this step.",
                 "type": "string"
-              }
-            ],
-            "events": []
-          }
-        },
-        {
-          "name": "zn-well",
-          "description": "Short summary of the component's intended use.\n\n---\n\n\n### **Slots:**\n - _default_ - The default slot.\n- **action** - Content displayed on the right hand side of the well.",
-          "doc-url": "",
-          "attributes": [
-            { "name": "icon", "value": { "type": "string", "default": "''" } },
-            { "name": "inline", "value": { "type": "boolean" } },
-            {
-              "name": "pre",
-              "description": "Renders the default slot inside a `pre` element, preserving whitespace using a monospace font.",
-              "value": { "type": "boolean" }
-            },
-            {
-              "name": "break-long",
-              "description": "Breaks long unbroken words, so they wrap instead of forcing the well wider.",
-              "value": { "type": "boolean" }
-            }
-          ],
-          "slots": [
-            { "name": "", "description": "The default slot." },
-            {
-              "name": "action",
-              "description": "Content displayed on the right hand side of the well."
-            }
-          ],
-          "events": [],
-          "js": {
-            "properties": [
-              { "name": "icon", "type": "string" },
-              { "name": "inline", "type": "boolean" },
+              },
               {
-                "name": "pre",
-                "description": "Renders the default slot inside a `pre` element, preserving whitespace using a monospace font.",
+                "name": "type",
+                "description": "Marker colour: neutral, primary, success, error, warning, info or ai (AI-generated steps only). Overrides `active`.",
+                "type": "string"
+              },
+              {
+                "name": "selected",
+                "description": "When true, rings the marker to show the step is picked.",
                 "type": "boolean"
               },
               {
-                "name": "breakLong",
-                "description": "Breaks long unbroken words, so they wrap instead of forcing the well wider.",
+                "name": "dashed",
+                "description": "When true, draws the marker's border dashed, for a step that is not yet final.",
+                "type": "boolean"
+              },
+              {
+                "name": "highlightLine",
+                "description": "When true, colours the line below this step's marker, joining it to the next step.",
                 "type": "boolean"
               }
             ],