@kubex/zinc 1.1.12 → 1.1.13

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.13",
   "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": "fid",
+              "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": "fid",
+                "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.",
@@ -5721,248 +5956,64 @@
           }
         },
         {
-          "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": "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": "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": "active",
+              "description": "Activates the positioning logic and shows the popup. When this attribute is removed, the positioning logic is torn\ndown and the popup will be hidden.",
+              "value": { "type": "boolean", "default": "false" }
             },
             {
-              "name": "label",
-              "description": "The component's label. Required for proper accessibility.",
-              "value": { "type": "string", "default": "''" }
+              "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.",
+              "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'"
+              }
             },
             {
-              "name": "label-tooltip",
-              "description": "Text that appears in a tooltip next to the label.",
-              "value": { "type": "string", "default": "''" }
+              "name": "strategy",
+              "description": "Determines how the popup is positioned. The `absolute` strategy works well in most cases, but if overflow is\nclipped, using a `fixed` position strategy can often workaround it.",
+              "value": { "type": "'absolute' | 'fixed'", "default": "'fixed'" }
             },
             {
-              "name": "help-text",
-              "description": "Help text that describes how to use the component.",
-              "value": { "type": "string", "default": "''" }
+              "name": "distance",
+              "description": "The distance in pixels from which to offset the panel away from its anchor.",
+              "value": { "type": "number", "default": "0" }
             },
             {
-              "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": "skidding",
+              "description": "The distance in pixels from which to offset the panel along its anchor.",
+              "value": { "type": "number", "default": "0" }
             },
             {
-              "name": "size",
-              "description": "The size of the list items.",
+              "name": "arrow",
+              "description": "Attaches an arrow to the popup. The arrow's size and color can be customized using the `--arrow-size` and\n`--arrow-color` custom properties. For additional customizations, you can also target the arrow using\n`::part(arrow)` in your stylesheet.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "arrow-placement",
+              "description": "The placement of the arrow. The default is `anchor`, which will align the arrow as close to the center of the\nanchor as possible, considering available space and `arrow-padding`. A value of `start`, `end`, or `center` will\nalign the arrow to the start, end, or center of the popover instead.",
               "value": {
-                "type": "'small' | 'medium' | 'large'",
-                "default": "'medium'"
+                "type": "'start' | 'end' | 'center' | 'anchor'",
+                "default": "'anchor'"
               }
             },
             {
-              "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": "active",
-              "description": "Activates the positioning logic and shows the popup. When this attribute is removed, the positioning logic is torn\ndown and the popup will be hidden.",
-              "value": { "type": "boolean", "default": "false" }
-            },
-            {
-              "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.",
-              "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'"
-              }
-            },
-            {
-              "name": "strategy",
-              "description": "Determines how the popup is positioned. The `absolute` strategy works well in most cases, but if overflow is\nclipped, using a `fixed` position strategy can often workaround it.",
-              "value": { "type": "'absolute' | 'fixed'", "default": "'fixed'" }
-            },
-            {
-              "name": "distance",
-              "description": "The distance in pixels from which to offset the panel away from its anchor.",
-              "value": { "type": "number", "default": "0" }
-            },
-            {
-              "name": "skidding",
-              "description": "The distance in pixels from which to offset the panel along its anchor.",
-              "value": { "type": "number", "default": "0" }
-            },
-            {
-              "name": "arrow",
-              "description": "Attaches an arrow to the popup. The arrow's size and color can be customized using the `--arrow-size` and\n`--arrow-color` custom properties. For additional customizations, you can also target the arrow using\n`::part(arrow)` in your stylesheet.",
-              "value": { "type": "boolean", "default": "false" }
-            },
-            {
-              "name": "arrow-placement",
-              "description": "The placement of the arrow. The default is `anchor`, which will align the arrow as close to the center of the\nanchor as possible, considering available space and `arrow-padding`. A value of `start`, `end`, or `center` will\nalign the arrow to the start, end, or center of the popover instead.",
-              "value": {
-                "type": "'start' | 'end' | 'center' | 'anchor'",
-                "default": "'anchor'"
-              }
-            },
-            {
-              "name": "arrow-padding",
-              "description": "The amount of padding between the arrow and the edges of the popup. If the popup has a border-radius, for example,\nthis will prevent it from overflowing the corners.",
-              "value": { "type": "number", "default": "10" }
-            },
-            {
-              "name": "flip",
-              "description": "When set, placement of the popup will flip to the opposite site to keep it in view. You can use\n`flipFallbackPlacements` to further configure how the fallback placement is determined.",
+              "name": "arrow-padding",
+              "description": "The amount of padding between the arrow and the edges of the popup. If the popup has a border-radius, for example,\nthis will prevent it from overflowing the corners.",
+              "value": { "type": "number", "default": "10" }
+            },
+            {
+              "name": "flip",
+              "description": "When set, placement of the popup will flip to the opposite site to keep it in view. You can use\n`flipFallbackPlacements` to further configure how the fallback placement is determined.",
               "value": { "type": "boolean", "default": "false" }
             },
             {
@@ -6163,6 +6214,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.",