@kubex/zinc 1.1.12 → 1.1.14

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.12",
+  "version": "1.1.14",
   "description-markup": "markdown",
   "contributions": {
     "html": {
@@ -15,6 +15,28 @@
           "events": [],
           "js": { "properties": [], "events": [] }
         },
+        {
+          "name": "zn-action-bar",
+          "description": "Short summary of the component's intended use.\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### **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.",
@@ -78,28 +100,6 @@
             ]
           }
         },
-        {
-          "name": "zn-action-bar",
-          "description": "Short summary of the component's intended use.\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### **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",
@@ -633,6 +633,241 @@
             "events": []
           }
         },
+        {
+          "name": "zn-channel-tile",
+          "description": "A channel/queue slot tile with two faces: an active (occupied) state\nshowing an in-progress item, and an available (empty) state advertising\ncapacity — optionally reserving an incoming item with an auto-accept countdown.\n---\n\n\n### **Events:**\n - **zn-accept** - Emitted when an available tile is accepted (click or auto-accept). Cancelable — call `preventDefault()` to suppress the built-in `accept-uri` fetch.\n- **zn-reject** - Emitted when the reject control is pressed.\n\n### **Slots:**\n - **leading** - Replaces the leading icon in the active state.\n- **action** - Action content for the available state (e.g. a form). Falls back to a default accept button.\n- **footer** - Trailing content (e.g. status badges) in the active state.\n\n### **CSS Properties:**\n - **--channel-tile-color** - Resolved accent color (set from the `color` property). _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **progress** - The progress indicator (incoming countdown overlay or active progress bar).",
+          "doc-url": "",
+          "attributes": [
+            {
+              "name": "available",
+              "description": "Renders the empty/available face instead of the active face.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "incoming",
+              "description": "(Available only) the tile is reserving an incoming item awaiting acceptance.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "variant",
+              "description": "Free-form grouping/theming key (reflected so consumers can query/style by it).",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "header",
+              "description": "Top-bar text (e.g. brand).",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "icon",
+              "description": "Leading icon (active state).",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "color",
+              "description": "Accent color driving the leading icon and `--channel-tile-color`.",
+              "value": { "type": "ChannelTileColor", "default": "'default'" }
+            },
+            {
+              "name": "title",
+              "description": "Primary line. Defaults to \"Available\" in the available state when unset.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "subtitle",
+              "description": "Secondary line.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "progress",
+              "description": "(Active only) progress bar fill, 0–100.",
+              "value": { "type": "number", "default": "0" }
+            },
+            {
+              "name": "progress-color",
+              "description": "(Active only) CSS color for the progress bar fill.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "item-id",
+              "description": "Identifier carried in `zn-accept` / `zn-reject` event details.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "accept-uri",
+              "description": "(Available only) when set, accepting fetches this URI unless `zn-accept` is canceled.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "reserved-until",
+              "description": "(Available/incoming) epoch (seconds or millis) at which the reservation window ends.",
+              "value": { "type": "number", "default": "0" }
+            },
+            {
+              "name": "auto-accept-delay",
+              "description": "(Available/incoming) auto-accept window length in milliseconds.",
+              "value": { "type": "number", "default": "0" }
+            },
+            {
+              "name": "rejectable",
+              "description": "(Available/incoming) whether a reject control is offered.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "accept-icon",
+              "description": "Icon for the built-in accept button.",
+              "value": { "type": "string", "default": "'plus@lu'" }
+            },
+            {
+              "name": "accept-gaid",
+              "description": "Optional analytics id forwarded to the built-in accept button.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "reject-icon",
+              "description": "Icon for the reject control.",
+              "value": { "type": "string", "default": "'call_end'" }
+            },
+            {
+              "name": "reject-label",
+              "description": "Accessible label for the reject control.",
+              "value": { "type": "string", "default": "'Reject'" }
+            }
+          ],
+          "slots": [
+            {
+              "name": "leading",
+              "description": "Replaces the leading icon in the active state."
+            },
+            {
+              "name": "action",
+              "description": "Action content for the available state (e.g. a form). Falls back to a default accept button."
+            },
+            {
+              "name": "footer",
+              "description": "Trailing content (e.g. status badges) in the active state."
+            }
+          ],
+          "events": [
+            {
+              "name": "zn-accept",
+              "description": "Emitted when an available tile is accepted (click or auto-accept). Cancelable — call `preventDefault()` to suppress the built-in `accept-uri` fetch."
+            },
+            {
+              "name": "zn-reject",
+              "description": "Emitted when the reject control is pressed."
+            }
+          ],
+          "js": {
+            "properties": [
+              {
+                "name": "available",
+                "description": "Renders the empty/available face instead of the active face.",
+                "type": "boolean"
+              },
+              {
+                "name": "incoming",
+                "description": "(Available only) the tile is reserving an incoming item awaiting acceptance.",
+                "type": "boolean"
+              },
+              {
+                "name": "variant",
+                "description": "Free-form grouping/theming key (reflected so consumers can query/style by it).",
+                "type": "string"
+              },
+              {
+                "name": "header",
+                "description": "Top-bar text (e.g. brand).",
+                "type": "string"
+              },
+              {
+                "name": "icon",
+                "description": "Leading icon (active state).",
+                "type": "string"
+              },
+              {
+                "name": "color",
+                "description": "Accent color driving the leading icon and `--channel-tile-color`.",
+                "type": "ChannelTileColor"
+              },
+              {
+                "name": "title",
+                "description": "Primary line. Defaults to \"Available\" in the available state when unset.",
+                "type": "string"
+              },
+              {
+                "name": "subtitle",
+                "description": "Secondary line.",
+                "type": "string"
+              },
+              {
+                "name": "progress",
+                "description": "(Active only) progress bar fill, 0–100.",
+                "type": "number"
+              },
+              {
+                "name": "progressColor",
+                "description": "(Active only) CSS color for the progress bar fill.",
+                "type": "string"
+              },
+              {
+                "name": "itemId",
+                "description": "Identifier carried in `zn-accept` / `zn-reject` event details.",
+                "type": "string"
+              },
+              {
+                "name": "acceptUri",
+                "description": "(Available only) when set, accepting fetches this URI unless `zn-accept` is canceled.",
+                "type": "string"
+              },
+              {
+                "name": "reservedUntil",
+                "description": "(Available/incoming) epoch (seconds or millis) at which the reservation window ends.",
+                "type": "number"
+              },
+              {
+                "name": "autoAcceptDelay",
+                "description": "(Available/incoming) auto-accept window length in milliseconds.",
+                "type": "number"
+              },
+              {
+                "name": "rejectable",
+                "description": "(Available/incoming) whether a reject control is offered.",
+                "type": "boolean"
+              },
+              {
+                "name": "acceptIcon",
+                "description": "Icon for the built-in accept button.",
+                "type": "string"
+              },
+              {
+                "name": "acceptGaid",
+                "description": "Optional analytics id forwarded to the built-in accept button.",
+                "type": "string"
+              },
+              {
+                "name": "rejectIcon",
+                "description": "Icon for the reject control.",
+                "type": "string"
+              },
+              {
+                "name": "rejectLabel",
+                "description": "Accessible label for the reject control.",
+                "type": "string"
+              }
+            ],
+            "events": [
+              {
+                "name": "zn-accept",
+                "description": "Emitted when an available tile is accepted (click or auto-accept). Cancelable — call `preventDefault()` to suppress the built-in `accept-uri` fetch."
+              },
+              {
+                "name": "zn-reject",
+                "description": "Emitted when the reject control is pressed."
+              }
+            ]
+          }
+        },
         {
           "name": "zn-chart",
           "description": "Chart component powered by Apache ECharts.\n---\n\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
@@ -719,7 +954,7 @@
         },
         {
           "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### **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- **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 colour. _(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- **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### **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.",
           "doc-url": "",
           "attributes": [
             {
@@ -767,6 +1002,10 @@
               "name": "badge",
               "description": "Rendered in the header after the sender and time (e.g. an INTERNAL NOTE chip)."
             },
+            {
+              "name": "attachments",
+              "description": "Attachments displayed beneath the message content. Use `zn-chat-message-attachment`, which auto-assigns itself to this slot."
+            },
             {
               "name": "edit-dialog-trigger",
               "description": "Action rendered at the end of the bubble (e.g. a remove icon button)."
@@ -818,6 +1057,75 @@
             "events": []
           }
         },
+        {
+          "name": "zn-chat-message-attachment",
+          "description": "A single file or link attachment for a `zn-chat-message`. Renders an\nicon and a label as a link, styled to match the message's attachments row. It is\nintended to be used only inside a `zn-chat-message` and is automatically placed in\nthat component's `attachments` slot.\n---\n\n\n### **Slots:**\n - _default_ - The attachment label. Falls back to the `name` attribute when empty.\n\n### **CSS Parts:**\n - **base** - The attachment link.\n- **icon** - The leading icon.\n- **label** - The attachment label.",
+          "doc-url": "",
+          "attributes": [
+            {
+              "name": "href",
+              "description": "The URL the attachment links to.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "name",
+              "description": "The attachment label (e.g. the file name). Used when the default slot is empty.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "icon",
+              "description": "The leading icon name.",
+              "value": { "type": "string", "default": "'attach_file'" }
+            },
+            {
+              "name": "target",
+              "description": "Where to open the link. Defaults to a new tab.",
+              "value": { "type": "string", "default": "'_blank'" }
+            },
+            {
+              "name": "download",
+              "description": "Prompt a download rather than navigating to the link.",
+              "value": { "type": "boolean", "default": "false" }
+            }
+          ],
+          "slots": [
+            {
+              "name": "",
+              "description": "The attachment label. Falls back to the `name` attribute when empty."
+            }
+          ],
+          "events": [],
+          "js": {
+            "properties": [
+              {
+                "name": "href",
+                "description": "The URL the attachment links to.",
+                "type": "string"
+              },
+              {
+                "name": "name",
+                "description": "The attachment label (e.g. the file name). Used when the default slot is empty.",
+                "type": "string"
+              },
+              {
+                "name": "icon",
+                "description": "The leading icon name.",
+                "type": "string"
+              },
+              {
+                "name": "target",
+                "description": "Where to open the link. Defaults to a new tab.",
+                "type": "string"
+              },
+              {
+                "name": "download",
+                "description": "Prompt a download rather than navigating to the link.",
+                "type": "boolean"
+              }
+            ],
+            "events": []
+          }
+        },
         {
           "name": "zn-checkbox",
           "description": "Short summary of the component's intended use.\n---\n\n\n### **Events:**\n - **zn-blur** - Emitted when the checkbox loses focus.\n- **zn-change** - Emitted when the checked state changes.\n- **zn-focus** - Emitted when the checkbox gains focus.\n- **zn-input** - Emitted when the checkbox 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 checkbox.\n- **focus(options: _FocusOptions_)** - Sets focus on the checkbox.\n- **blur()** - Removes focus from the checkbox.\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 checkbox's label.\n- **description** - A description of the checkbox's label. Serves as help text for a checkbox item. Alternatively, you can use the `description` attribute.\n- **selected-content** - Use to nest rich content (like an input) inside a selected checkbox item. Use only with the contained style.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **control** - The square container that wraps the checkbox's checked state.\n- **control--checked** - Matches the control part when the checkbox is checked.\n- **control--indeterminate** - Matches the control part when the checkbox is indeterminate.\n- **checked-icon** - The checked icon, an `<zn-icon>` element.\n- **unchecked-icon** - The unchecked icon, an `<zn-icon>` element.\n- **indeterminate-icon** - The indeterminate icon, an `<zn-icon>` element.\n- **label** - The container that wraps the checkbox's label.\n- **description** - The container that wraps the checkbox's description.\n- **selected-content** - The container that wraps optional content that appears when a checkbox is checked.",
@@ -5721,198 +6029,14 @@
           }
         },
         {
-          "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### **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-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.",
+          "name": "zn-popup",
+          "description": "Short summary of the component's intended use.\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Methods:**\n - **reposition()** - Forces the popup to recalculate and 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": "name",
-              "description": "The name prefix for form submission. Each item generates a hidden input named `{name}[{itemValue}]`\nwith the priority number as its value.",
-              "value": { "type": "string", "default": "''" }
-            },
-            {
-              "name": "value",
-              "description": "The current ordered list of item keys, reflecting the visual order. This is the source of truth for ordering.\nEach entry should match a `value` attribute on a slotted child element.",
-              "value": { "type": "string[]" }
-            },
-            {
-              "name": "label",
-              "description": "The component's label. Required for proper accessibility.",
-              "value": { "type": "string", "default": "''" }
-            },
-            {
-              "name": "label-tooltip",
-              "description": "Text that appears in a tooltip next to the label.",
-              "value": { "type": "string", "default": "''" }
-            },
-            {
-              "name": "help-text",
-              "description": "Help text that describes how to use the component.",
-              "value": { "type": "string", "default": "''" }
-            },
-            {
-              "name": "form",
-              "description": "Associates the control with a form by id. The form must be in the same document or shadow root.",
-              "value": { "type": "string", "default": "''" }
-            },
-            {
-              "name": "size",
-              "description": "The size of the list items.",
-              "value": {
-                "type": "'small' | 'medium' | 'large'",
-                "default": "'medium'"
-              }
-            },
-            {
-              "name": "disabled",
-              "description": "Whether the priority list is disabled.",
-              "value": { "type": "boolean", "default": "false" }
-            },
-            {
-              "name": "required",
-              "description": "Ensures the form control has a value before allowing submission.",
-              "value": { "type": "boolean", "default": "false" }
-            },
-            {
-              "name": "priority-start",
-              "description": "The starting priority number. Defaults to 1.",
-              "value": { "type": "number", "default": "1" }
-            },
-            {
-              "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.",
-              "value": { "type": "string" }
-            },
-            {
-              "name": "order",
-              "description": "A comma-separated list of item keys defining the initial display order.\nKeys must match the `value` attributes on slotted children.\nAny slotted items not listed are appended at the end in DOM order.",
-              "value": { "type": "string", "default": "''" }
-            }
-          ],
-          "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)."
-            },
-            {
-              "name": "label",
-              "description": "The component's label. Required for proper accessibility. Alternatively, use the `label` attribute."
-            },
-            {
-              "name": "label-tooltip",
-              "description": "Used to add text displayed in a tooltip next to the label."
-            },
-            {
-              "name": "help-text",
-              "description": "Text that describes how to use the component. Alternatively, use the `help-text` attribute."
-            }
-          ],
-          "events": [
-            {
-              "name": "zn-change",
-              "description": "Emitted when the order of items changes."
-            },
-            {
-              "name": "zn-reorder",
-              "description": "Emitted when items are reordered. Call `getPriorityMap()` on the component to get the updated `{ key: string, priority: number }[]` array."
-            }
-          ],
-          "js": {
-            "properties": [
-              { "name": "hiddenInputsContainer", "type": "HTMLDivElement" },
-              {
-                "name": "name",
-                "description": "The name prefix for form submission. Each item generates a hidden input named `{name}[{itemValue}]`\nwith the priority number as its value.",
-                "type": "string"
-              },
-              {
-                "name": "value",
-                "description": "The current ordered list of item keys, reflecting the visual order. This is the source of truth for ordering.\nEach entry should match a `value` attribute on a slotted child element.",
-                "type": "string[]"
-              },
-              { "name": "defaultValue", "type": "string[]" },
-              {
-                "name": "label",
-                "description": "The component's label. Required for proper accessibility.",
-                "type": "string"
-              },
-              {
-                "name": "labelTooltip",
-                "description": "Text that appears in a tooltip next to the label.",
-                "type": "string"
-              },
-              {
-                "name": "helpText",
-                "description": "Help text that describes how to use the component.",
-                "type": "string"
-              },
-              {
-                "name": "form",
-                "description": "Associates the control with a form by id. The form must be in the same document or shadow root.",
-                "type": "string"
-              },
-              {
-                "name": "size",
-                "description": "The size of the list items.",
-                "type": "'small' | 'medium' | 'large'"
-              },
-              {
-                "name": "disabled",
-                "description": "Whether the priority list is disabled.",
-                "type": "boolean"
-              },
-              {
-                "name": "required",
-                "description": "Ensures the form control has a value before allowing submission.",
-                "type": "boolean"
-              },
-              {
-                "name": "priorityStart",
-                "description": "The starting priority number. Defaults to 1.",
-                "type": "number"
-              },
-              {
-                "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.",
-                "type": "string"
-              },
-              {
-                "name": "order",
-                "description": "A comma-separated list of item keys defining the initial display order.\nKeys must match the `value` attributes on slotted children.\nAny slotted items not listed are appended at the end in DOM order.",
-                "type": "string"
-              },
-              {
-                "name": "validity",
-                "description": "Gets the validity state object.",
-                "type": "ValidityState"
-              },
-              {
-                "name": "validationMessage",
-                "description": "Gets the validation message.",
-                "type": "string"
-              }
-            ],
-            "events": [
-              {
-                "name": "zn-change",
-                "description": "Emitted when the order of items changes."
-              },
-              {
-                "name": "zn-reorder",
-                "description": "Emitted when items are reordered. Call `getPriorityMap()` on the component to get the updated `{ key: string, priority: number }[]` array."
-              }
-            ]
-          }
-        },
-        {
-          "name": "zn-popup",
-          "description": "Short summary of the component's intended use.\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Methods:**\n - **reposition()** - Forces the popup to recalculate and 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": "anchor",
-              "description": "The element the popup will be anchored to. If the anchor lives outside of the popup, you can provide the anchor\nelement `id`, a DOM element reference, or a `VirtualElement`. If the anchor lives inside the popup, use the\n`anchor` slot instead.",
-              "value": { "type": "Element | string | VirtualElement" }
+              "name": "anchor",
+              "description": "The element the popup will be anchored to. If the anchor lives outside of the popup, you can provide the anchor\nelement `id`, a DOM element reference, or a `VirtualElement`. If the anchor lives inside the popup, use the\n`anchor` slot instead.",
+              "value": { "type": "Element | string | VirtualElement" }
             },
             {
               "name": "active",
@@ -6163,6 +6287,190 @@
             ]
           }
         },
+        {
+          "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### **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-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": [
+            {
+              "name": "name",
+              "description": "The name prefix for form submission. Each item generates a hidden input named `{name}[{itemValue}]`\nwith the priority number as its value.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "value",
+              "description": "The current ordered list of item keys, reflecting the visual order. This is the source of truth for ordering.\nEach entry should match a `value` attribute on a slotted child element.",
+              "value": { "type": "string[]" }
+            },
+            {
+              "name": "label",
+              "description": "The component's label. Required for proper accessibility.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "label-tooltip",
+              "description": "Text that appears in a tooltip next to the label.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "help-text",
+              "description": "Help text that describes how to use the component.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "form",
+              "description": "Associates the control with a form by id. The form must be in the same document or shadow root.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "size",
+              "description": "The size of the list items.",
+              "value": {
+                "type": "'small' | 'medium' | 'large'",
+                "default": "'medium'"
+              }
+            },
+            {
+              "name": "disabled",
+              "description": "Whether the priority list is disabled.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "required",
+              "description": "Ensures the form control has a value before allowing submission.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "priority-start",
+              "description": "The starting priority number. Defaults to 1.",
+              "value": { "type": "number", "default": "1" }
+            },
+            {
+              "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.",
+              "value": { "type": "string" }
+            },
+            {
+              "name": "order",
+              "description": "A comma-separated list of item keys defining the initial display order.\nKeys must match the `value` attributes on slotted children.\nAny slotted items not listed are appended at the end in DOM order.",
+              "value": { "type": "string", "default": "''" }
+            }
+          ],
+          "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)."
+            },
+            {
+              "name": "label",
+              "description": "The component's label. Required for proper accessibility. Alternatively, use the `label` attribute."
+            },
+            {
+              "name": "label-tooltip",
+              "description": "Used to add text displayed in a tooltip next to the label."
+            },
+            {
+              "name": "help-text",
+              "description": "Text that describes how to use the component. Alternatively, use the `help-text` attribute."
+            }
+          ],
+          "events": [
+            {
+              "name": "zn-change",
+              "description": "Emitted when the order of items changes."
+            },
+            {
+              "name": "zn-reorder",
+              "description": "Emitted when items are reordered. Call `getPriorityMap()` on the component to get the updated `{ key: string, priority: number }[]` array."
+            }
+          ],
+          "js": {
+            "properties": [
+              { "name": "hiddenInputsContainer", "type": "HTMLDivElement" },
+              {
+                "name": "name",
+                "description": "The name prefix for form submission. Each item generates a hidden input named `{name}[{itemValue}]`\nwith the priority number as its value.",
+                "type": "string"
+              },
+              {
+                "name": "value",
+                "description": "The current ordered list of item keys, reflecting the visual order. This is the source of truth for ordering.\nEach entry should match a `value` attribute on a slotted child element.",
+                "type": "string[]"
+              },
+              { "name": "defaultValue", "type": "string[]" },
+              {
+                "name": "label",
+                "description": "The component's label. Required for proper accessibility.",
+                "type": "string"
+              },
+              {
+                "name": "labelTooltip",
+                "description": "Text that appears in a tooltip next to the label.",
+                "type": "string"
+              },
+              {
+                "name": "helpText",
+                "description": "Help text that describes how to use the component.",
+                "type": "string"
+              },
+              {
+                "name": "form",
+                "description": "Associates the control with a form by id. The form must be in the same document or shadow root.",
+                "type": "string"
+              },
+              {
+                "name": "size",
+                "description": "The size of the list items.",
+                "type": "'small' | 'medium' | 'large'"
+              },
+              {
+                "name": "disabled",
+                "description": "Whether the priority list is disabled.",
+                "type": "boolean"
+              },
+              {
+                "name": "required",
+                "description": "Ensures the form control has a value before allowing submission.",
+                "type": "boolean"
+              },
+              {
+                "name": "priorityStart",
+                "description": "The starting priority number. Defaults to 1.",
+                "type": "number"
+              },
+              {
+                "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.",
+                "type": "string"
+              },
+              {
+                "name": "order",
+                "description": "A comma-separated list of item keys defining the initial display order.\nKeys must match the `value` attributes on slotted children.\nAny slotted items not listed are appended at the end in DOM order.",
+                "type": "string"
+              },
+              {
+                "name": "validity",
+                "description": "Gets the validity state object.",
+                "type": "ValidityState"
+              },
+              {
+                "name": "validationMessage",
+                "description": "Gets the validation message.",
+                "type": "string"
+              }
+            ],
+            "events": [
+              {
+                "name": "zn-change",
+                "description": "Emitted when the order of items changes."
+              },
+              {
+                "name": "zn-reorder",
+                "description": "Emitted when items are reordered. Call `getPriorityMap()` on the component to get the updated `{ key: string, priority: number }[]` array."
+              }
+            ]
+          }
+        },
         {
           "name": "zn-progress-bar",
           "description": "Progress bars provide visual feedback about the completion status of a task or process.\n---\n\n\n### **CSS Properties:**\n - **--zn-border-color** - The color of the progress bar background track. _(default: undefined)_\n- **--zn-progress-bar-color** - The color of the progress bar fill. _(default: undefined)_\n- **--zn-text-heading** - The color of the caption text. _(default: undefined)_\n- **--zn-text** - The color of the progress percentage and description text. _(default: undefined)_\n- **--zn-spacing-x-small** - The spacing between header/footer and the progress bar. _(default: undefined)_\n\n### **CSS Parts:**\n - **header** - The header container that contains the caption and progress text.\n- **caption** - The caption text element.\n- **progress** - The progress percentage text element.\n- **bar** - The SVG element containing the progress bar.\n- **track** - The background track of the progress bar.\n- **fill** - The filled portion of the progress bar indicating progress.\n- **footer** - The footer container that contains the description.\n- **info** - The description text element.",