npm - @kubex/zinc - Versions diffs - 1.1.11 → 1.1.12 - Mend

@kubex/zinc 1.1.11 → 1.1.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (6) hide show

package/dist/custom-elements.json +766 -766
package/dist/vscode.html-custom-data.json +87 -87
package/dist/web-types.json +207 -207
package/dist/zn.min.js +1 -1
package/package.json +1 -1
package/src/components/tooltip/tooltip.scss +2 -2

package/dist/custom-elements.json CHANGED Viewed

@@ -47,79 +47,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "components/action-bar/action-bar.js",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "",
-          "name": "ZnActionBar",
-          "cssProperties": [
-            {
-              "description": "An example CSS custom property.",
-              "name": "--example"
-            }
-          ],
-          "cssParts": [
-            {
-              "description": "The component's base wrapper.",
-              "name": "base"
-            }
-          ],
-          "slots": [
-            {
-              "description": "The default slot.",
-              "name": ""
-            },
-            {
-              "description": "An example slot.",
-              "name": "example"
-            }
-          ],
-          "members": [
-            {
-              "kind": "field",
-              "name": "localize",
-              "privacy": "private",
-              "readonly": true,
-              "default": "new LocalizeController(this)"
-            }
-          ],
-          "events": [
-            {
-              "description": "Emitted as an example.",
-              "name": "zn-event-name"
-            }
-          ],
-          "superclass": {
-            "name": "ZincElement",
-            "module": "/src/internal/zinc-element"
-          },
-          "summary": "Short summary of the component's intended use.",
-          "tagNameWithoutPrefix": "action-bar",
-          "tagName": "zn-action-bar",
-          "customElement": true,
-          "jsDoc": "/**\n * @summary Short summary of the component's intended use.\n * @documentation https://zinc.style/components/action-bar\n * @status experimental\n * @since 1.0\n *\n * @dependency zn-example\n *\n * @event zn-event-name - Emitted as an example.\n *\n * @slot - The default slot.\n * @slot example - An example slot.\n *\n * @csspart base - The component's base wrapper.\n *\n * @cssproperty --example - An example CSS custom property.\n */",
-          "documentation": "https://zinc.style/components/action-bar",
-          "status": "experimental",
-          "since": "1.0",
-          "dependencies": [
-            "zn-example"
-          ]
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "default",
-          "declaration": {
-            "name": "ZnActionBar",
-            "module": "components/action-bar/action-bar.js"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "components/alert/alert.js",
@@ -296,6 +223,79 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "components/action-bar/action-bar.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "ZnActionBar",
+          "cssProperties": [
+            {
+              "description": "An example CSS custom property.",
+              "name": "--example"
+            }
+          ],
+          "cssParts": [
+            {
+              "description": "The component's base wrapper.",
+              "name": "base"
+            }
+          ],
+          "slots": [
+            {
+              "description": "The default slot.",
+              "name": ""
+            },
+            {
+              "description": "An example slot.",
+              "name": "example"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "localize",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new LocalizeController(this)"
+            }
+          ],
+          "events": [
+            {
+              "description": "Emitted as an example.",
+              "name": "zn-event-name"
+            }
+          ],
+          "superclass": {
+            "name": "ZincElement",
+            "module": "/src/internal/zinc-element"
+          },
+          "summary": "Short summary of the component's intended use.",
+          "tagNameWithoutPrefix": "action-bar",
+          "tagName": "zn-action-bar",
+          "customElement": true,
+          "jsDoc": "/**\n * @summary Short summary of the component's intended use.\n * @documentation https://zinc.style/components/action-bar\n * @status experimental\n * @since 1.0\n *\n * @dependency zn-example\n *\n * @event zn-event-name - Emitted as an example.\n *\n * @slot - The default slot.\n * @slot example - An example slot.\n *\n * @csspart base - The component's base wrapper.\n *\n * @cssproperty --example - An example CSS custom property.\n */",
+          "documentation": "https://zinc.style/components/action-bar",
+          "status": "experimental",
+          "since": "1.0",
+          "dependencies": [
+            "zn-example"
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "ZnActionBar",
+            "module": "components/action-bar/action-bar.js"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "components/animated-button/animated-button.js",
@@ -23357,534 +23357,639 @@
     },
     {
       "kind": "javascript-module",
-      "path": "components/popup/popup.js",
+      "path": "components/priority-list/priority-list.js",
       "declarations": [
         {
           "kind": "class",
           "description": "",
-          "name": "ZnPopup",
+          "name": "ZnPriorityList",
           "cssProperties": [
             {
-              "description": "An example CSS custom property.",
-              "name": "--example"
+              "description": "The gap between list items. Defaults to `var(--zn-spacing-2x-small)`.",
+              "name": "--zn-priority-list-item-gap"
+            },
+            {
+              "description": "The padding inside each item. Defaults to `var(--zn-spacing-small) var(--zn-spacing-medium)`.",
+              "name": "--zn-priority-list-item-padding"
+            },
+            {
+              "description": "The color of the drag handle. Defaults to `var(--zn-color-neutral-500)`.",
+              "name": "--zn-priority-list-handle-color"
+            },
+            {
+              "description": "The color of the priority number. Defaults to `var(--zn-color-neutral-600)`.",
+              "name": "--zn-priority-list-priority-color"
             }
           ],
           "cssParts": [
             {
-              "description": "The component's base wrapper.",
-              "name": "base"
+              "description": "The form control wrapper.",
+              "name": "form-control"
+            },
+            {
+              "description": "The label wrapper.",
+              "name": "form-control-label"
+            },
+            {
+              "description": "The input area wrapper.",
+              "name": "form-control-input"
+            },
+            {
+              "description": "The help text wrapper.",
+              "name": "form-control-help-text"
+            },
+            {
+              "description": "The list container.",
+              "name": "list"
+            },
+            {
+              "description": "An individual list item row.",
+              "name": "item"
+            },
+            {
+              "description": "The drag handle icon.",
+              "name": "drag-handle"
+            },
+            {
+              "description": "The priority number badge.",
+              "name": "priority"
+            },
+            {
+              "description": "The content area of an item.",
+              "name": "content"
             }
           ],
           "slots": [
             {
-              "description": "The default slot.",
+              "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": ""
             },
             {
-              "description": "An example slot.",
-              "name": "example"
+              "description": "The component's label. Required for proper accessibility. Alternatively, use the `label` attribute.",
+              "name": "label"
+            },
+            {
+              "description": "Used to add text displayed in a tooltip next to the label.",
+              "name": "label-tooltip"
+            },
+            {
+              "description": "Text that describes how to use the component. Alternatively, use the `help-text` attribute.",
+              "name": "help-text"
             }
           ],
           "members": [
             {
               "kind": "field",
-              "name": "anchorEl",
+              "name": "dependencies",
               "type": {
-                "text": "Element | VirtualElement | null"
+                "text": "object"
               },
-              "privacy": "private"
+              "static": true,
+              "default": "{ 'zn-icon': ZnIcon, }"
             },
             {
               "kind": "field",
-              "name": "cleanup",
-              "type": {
-                "text": "ReturnType<typeof autoUpdate> | undefined"
-              },
-              "privacy": "private"
+              "name": "formControlController",
+              "privacy": "protected",
+              "readonly": true,
+              "default": "new FormControlController(this, { value: (control: ZnPriorityList) => { return JSON.stringify(control.getPriorityMap()); }, defaultValue: (control: ZnPriorityList) => control.defaultValue, setValue: (control: ZnPriorityList, value: string) => { if (value) { try { const parsed: unknown = JSON.parse(value); if (Array.isArray(parsed) && parsed.every((item: unknown): item is string => typeof item === 'string')) { control.value = parsed as string[]; } } catch { // ignore parse errors } } }, })"
             },
             {
               "kind": "field",
-              "name": "popup",
-              "type": {
-                "text": "HTMLElement"
-              },
-              "description": "A reference to the internal popup container. Useful for animating and styling the popup with JavaScript."
+              "name": "hasSlotController",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new HasSlotController(this, 'help-text', 'label')"
             },
             {
               "kind": "field",
-              "name": "arrowEl",
+              "name": "hiddenInputsContainer",
               "type": {
-                "text": "HTMLElement"
-              },
-              "privacy": "private"
+                "text": "HTMLDivElement"
+              }
             },
             {
               "kind": "field",
-              "name": "anchor",
+              "name": "name",
               "type": {
-                "text": "Element | string | VirtualElement"
+                "text": "string"
               },
-              "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.",
-              "attribute": "anchor"
+              "default": "''",
+              "description": "The name prefix for form submission. Each item generates a hidden input named `{name}[{itemValue}]`\nwith the priority number as its value.",
+              "attribute": "name"
             },
             {
               "kind": "field",
-              "name": "active",
+              "name": "value",
               "type": {
-                "text": "boolean"
+                "text": "string[]"
               },
-              "default": "false",
-              "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.",
-              "attribute": "active",
-              "reflects": true
+              "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.",
+              "attribute": "value"
             },
             {
               "kind": "field",
-              "name": "placement",
+              "name": "_value",
               "type": {
-                "text": "| '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'"
+                "text": "string[]"
               },
-              "default": "'top'",
-              "description": "The preferred placement of the popup. Note that the actual placement will vary as configured to keep the\npanel inside of the viewport.",
-              "attribute": "placement",
-              "reflects": true
+              "privacy": "private",
+              "default": "[]"
             },
             {
               "kind": "field",
-              "name": "strategy",
+              "name": "defaultValue",
               "type": {
-                "text": "'absolute' | 'fixed'"
+                "text": "string[]"
               },
-              "default": "'fixed'",
-              "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.",
-              "attribute": "strategy",
-              "reflects": true
+              "default": "[]"
             },
             {
               "kind": "field",
-              "name": "distance",
+              "name": "label",
               "type": {
-                "text": "number"
+                "text": "string"
               },
-              "default": "0",
-              "description": "The distance in pixels from which to offset the panel away from its anchor.",
-              "attribute": "distance"
+              "default": "''",
+              "description": "The component's label. Required for proper accessibility.",
+              "attribute": "label"
             },
             {
               "kind": "field",
-              "name": "skidding",
+              "name": "labelTooltip",
               "type": {
-                "text": "number"
+                "text": "string"
               },
-              "default": "0",
-              "description": "The distance in pixels from which to offset the panel along its anchor.",
-              "attribute": "skidding"
+              "default": "''",
+              "description": "Text that appears in a tooltip next to the label.",
+              "attribute": "label-tooltip"
             },
             {
               "kind": "field",
-              "name": "arrow",
+              "name": "helpText",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "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.",
-              "attribute": "arrow"
+              "default": "''",
+              "description": "Help text that describes how to use the component.",
+              "attribute": "help-text"
             },
             {
               "kind": "field",
-              "name": "arrowPlacement",
+              "name": "form",
               "type": {
-                "text": "'start' | 'end' | 'center' | 'anchor'"
+                "text": "string"
               },
-              "default": "'anchor'",
-              "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.",
-              "attribute": "arrow-placement"
+              "default": "''",
+              "description": "Associates the control with a form by id. The form must be in the same document or shadow root.",
+              "attribute": "form",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "arrowPadding",
+              "name": "size",
               "type": {
-                "text": "number"
+                "text": "'small' | 'medium' | 'large'"
               },
-              "default": "10",
-              "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.",
-              "attribute": "arrow-padding"
+              "default": "'medium'",
+              "description": "The size of the list items.",
+              "attribute": "size",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "flip",
+              "name": "disabled",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "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.",
-              "attribute": "flip"
-            },
-            {
-              "kind": "field",
-              "name": "flipFallbackPlacements",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "description": "If the preferred placement doesn't fit, popup will be tested in these fallback placements until one fits. Must be a\nstring of any number of placements separated by a space, e.g. \"top bottom left\". If no placement fits, the flip\nfallback strategy will be used instead.",
-              "attribute": "flip-fallback-placements"
+              "description": "Whether the priority list is disabled.",
+              "attribute": "disabled",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "flipFallbackStrategy",
+              "name": "required",
               "type": {
-                "text": "'best-fit' | 'initial'"
+                "text": "boolean"
               },
-              "default": "'best-fit'",
-              "description": "When neither the preferred placement nor the fallback placements fit, this value will be used to determine whether\nthe popup should be positioned using the best available fit based on available space or as it was initially\npreferred.",
-              "attribute": "flip-fallback-strategy"
+              "default": "false",
+              "description": "Ensures the form control has a value before allowing submission.",
+              "attribute": "required",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "flipBoundary",
+              "name": "priorityStart",
               "type": {
-                "text": "Element | Element[]"
+                "text": "number"
               },
-              "description": "The flip boundary describes clipping element(s) that overflow will be checked relative to when flipping. By\ndefault, the boundary includes overflow ancestors that will cause the element to be clipped. If needed, you can\nchange the boundary by passing a reference to one or more elements to this property.",
-              "attribute": "flipBoundary"
+              "default": "1",
+              "description": "The starting priority number. Defaults to 1.",
+              "attribute": "priority-start"
             },
             {
               "kind": "field",
-              "name": "flipPadding",
+              "name": "formAction",
               "type": {
-                "text": "number"
+                "text": "string"
               },
-              "default": "0",
-              "description": "The amount of padding, in pixels, to exceed before the flip behavior will occur.",
-              "attribute": "flip-padding"
+              "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.",
+              "attribute": "formaction"
             },
             {
               "kind": "field",
-              "name": "shift",
+              "name": "order",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "description": "Moves the popup along the axis to keep it in view when clipped.",
-              "attribute": "shift"
+              "default": "''",
+              "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.",
+              "attribute": "order"
             },
             {
               "kind": "field",
-              "name": "shiftBoundary",
+              "name": "draggedKey",
               "type": {
-                "text": "Element | Element[]"
+                "text": "string | null"
               },
-              "description": "The shift boundary describes clipping element(s) that overflow will be checked relative to when shifting. By\ndefault, the boundary includes overflow ancestors that will cause the element to be clipped. If needed, you can\nchange the boundary by passing a reference to one or more elements to this property.",
-              "attribute": "shiftBoundary"
+              "privacy": "private",
+              "default": "null"
             },
             {
               "kind": "field",
-              "name": "shiftPadding",
+              "name": "isDragging",
               "type": {
-                "text": "number"
+                "text": "boolean"
               },
-              "default": "0",
-              "description": "The amount of padding, in pixels, to exceed before the shift behavior will occur.",
-              "attribute": "shift-padding"
+              "privacy": "private",
+              "default": "false"
             },
             {
               "kind": "field",
-              "name": "autoSize",
+              "name": "dragOverKey",
               "type": {
-                "text": "'horizontal' | 'vertical' | 'both'"
+                "text": "string | null"
               },
-              "description": "When set, this will cause the popup to automatically resize itself to prevent it from overflowing.",
-              "attribute": "auto-size"
+              "privacy": "private",
+              "default": "null"
             },
             {
               "kind": "field",
-              "name": "sync",
+              "name": "validity",
               "type": {
-                "text": "'width' | 'height' | 'both'"
+                "text": "ValidityState"
               },
-              "description": "Syncs the popup's width or height to that of the anchor element.",
-              "attribute": "sync"
+              "description": "Gets the validity state object.",
+              "readonly": true
             },
             {
               "kind": "field",
-              "name": "autoSizeBoundary",
+              "name": "validationMessage",
               "type": {
-                "text": "Element | Element[]"
+                "text": "string"
               },
-              "description": "The auto-size boundary describes clipping element(s) that overflow will be checked relative to when resizing. By\ndefault, the boundary includes overflow ancestors that will cause the element to be clipped. If needed, you can\nchange the boundary by passing a reference to one or more elements to this property.",
-              "attribute": "autoSizeBoundary"
+              "description": "Gets the validation message.",
+              "readonly": true
             },
             {
-              "kind": "field",
-              "name": "autoSizePadding",
-              "type": {
-                "text": "number"
-              },
-              "default": "0",
-              "description": "The amount of padding, in pixels, to exceed before the auto-size behavior will occur.",
-              "attribute": "auto-size-padding"
+              "kind": "method",
+              "name": "_initializeOrderFromSlot",
+              "privacy": "private",
+              "description": "Initialize item order from slotted children if no explicit value was provided.\nIf an `order` attribute is set, use it to define the initial order,\nappending any slotted items not listed in the order at the end."
             },
             {
-              "kind": "field",
-              "name": "hoverBridge",
-              "type": {
-                "text": "boolean"
+              "kind": "method",
+              "name": "_getSlottedItems",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "HTMLElement[]"
+                }
               },
-              "default": "false",
-              "description": "When a gap exists between the anchor and the popup element, this option will add a \"hover bridge\" that fills the\ngap using an invisible element. This makes listening for events such as `mouseenter` and `mouseleave` more sane\nbecause the pointer never technically leaves the element. The hover bridge will only be drawn when the popover is\nactive.",
-              "attribute": "hover-bridge"
+              "description": "Gets all direct children with a `value` attribute (excluding those in reserved slots)."
             },
             {
               "kind": "method",
-              "name": "handleAnchorChange",
-              "privacy": "private"
+              "name": "_assignSlotNames",
+              "privacy": "private",
+              "description": "Assigns `slot` attributes to light DOM children based on their `value` attribute,\nso they project into the correct named slot in the shadow DOM."
             },
             {
-              "kind": "field",
-              "name": "handleAnchorHover",
-              "privacy": "public"
+              "kind": "method",
+              "name": "getPriorityMap",
+              "return": {
+                "type": {
+                  "text": "PriorityItem[]"
+                }
+              },
+              "description": "Returns the priority map: an array of { key, priority } objects."
             },
             {
               "kind": "method",
-              "name": "start",
-              "privacy": "private"
+              "name": "_syncHiddenInputs",
+              "privacy": "private",
+              "description": "Syncs hidden inputs so form data includes priority values."
             },
             {
               "kind": "method",
-              "name": "stop",
+              "name": "_moveItem",
               "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "Promise<void>"
+              "parameters": [
+                {
+                  "name": "fromIndex",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "toIndex",
+                  "type": {
+                    "text": "number"
+                  }
                 }
-              }
+              ],
+              "description": "Moves an item from one index to another."
             },
             {
               "kind": "method",
-              "name": "reposition",
-              "description": "Forces the popup to recalculate and reposition itself."
+              "name": "_submitForm",
+              "privacy": "private",
+              "description": "Submits the associated form if a `formaction` attribute is set."
             },
             {
-              "kind": "field",
-              "name": "updateHoverBridge",
-              "privacy": "private"
-            }
-          ],
-          "events": [
-            {
-              "description": "Emitted as an example.",
-              "name": "zn-event-name"
-            }
-          ],
-          "attributes": [
+              "kind": "method",
+              "name": "_handleDragStart",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "DragEvent"
+                  }
+                },
+                {
+                  "name": "key",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
             {
-              "name": "anchor",
-              "type": {
-                "text": "Element | string | VirtualElement"
-              },
-              "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.",
-              "fieldName": "anchor"
+              "kind": "method",
+              "name": "_handleDragEnd",
+              "privacy": "private"
             },
             {
-              "name": "active",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "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.",
-              "fieldName": "active"
+              "kind": "method",
+              "name": "_handleDragOver",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "DragEvent"
+                  }
+                },
+                {
+                  "name": "key",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
             },
             {
-              "name": "placement",
-              "type": {
-                "text": "| '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'",
-              "description": "The preferred placement of the popup. Note that the actual placement will vary as configured to keep the\npanel inside of the viewport.",
-              "fieldName": "placement"
+              "kind": "method",
+              "name": "_handleDragLeave",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "DragEvent"
+                  }
+                },
+                {
+                  "name": "key",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
             },
             {
-              "name": "strategy",
-              "type": {
-                "text": "'absolute' | 'fixed'"
-              },
-              "default": "'fixed'",
-              "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.",
-              "fieldName": "strategy"
+              "kind": "method",
+              "name": "_handleDrop",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "DragEvent"
+                  }
+                }
+              ]
             },
             {
-              "name": "distance",
-              "type": {
-                "text": "number"
-              },
-              "default": "0",
-              "description": "The distance in pixels from which to offset the panel away from its anchor.",
-              "fieldName": "distance"
+              "kind": "method",
+              "name": "_handleKeyDown",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "KeyboardEvent"
+                  }
+                },
+                {
+                  "name": "key",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
             },
             {
-              "name": "skidding",
-              "type": {
-                "text": "number"
-              },
-              "default": "0",
-              "description": "The distance in pixels from which to offset the panel along its anchor.",
-              "fieldName": "skidding"
+              "kind": "method",
+              "name": "_handleSlotChange",
+              "privacy": "private"
             },
             {
-              "name": "arrow",
-              "type": {
-                "text": "boolean"
+              "kind": "method",
+              "name": "checkValidity",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
               },
-              "default": "false",
-              "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.",
-              "fieldName": "arrow"
+              "description": "Checks for validity but does not show a validation message."
             },
             {
-              "name": "arrow-placement",
-              "type": {
-                "text": "'start' | 'end' | 'center' | 'anchor'"
+              "kind": "method",
+              "name": "getForm",
+              "return": {
+                "type": {
+                  "text": "HTMLFormElement | null"
+                }
               },
-              "default": "'anchor'",
-              "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.",
-              "fieldName": "arrowPlacement"
+              "description": "Gets the associated form, if one exists."
             },
             {
-              "name": "arrow-padding",
-              "type": {
-                "text": "number"
+              "kind": "method",
+              "name": "reportValidity",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
               },
-              "default": "10",
-              "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.",
-              "fieldName": "arrowPadding"
+              "description": "Checks for validity and shows the browser's validation message if the control is invalid."
             },
             {
-              "name": "flip",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "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.",
-              "fieldName": "flip"
+              "kind": "method",
+              "name": "setCustomValidity",
+              "parameters": [
+                {
+                  "name": "_message",
+                  "default": "''"
+                }
+              ],
+              "description": "Sets a custom validation message. Pass an empty string to restore validity."
+            }
+          ],
+          "events": [
+            {
+              "description": "Emitted when the order of items changes.",
+              "name": "zn-change"
             },
             {
-              "name": "flip-fallback-placements",
+              "description": "Emitted when items are reordered. Call `getPriorityMap()` on the component to get the updated `{ key: string, priority: number }[]` array.",
+              "name": "zn-reorder"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "name",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "description": "If the preferred placement doesn't fit, popup will be tested in these fallback placements until one fits. Must be a\nstring of any number of placements separated by a space, e.g. \"top bottom left\". If no placement fits, the flip\nfallback strategy will be used instead.",
-              "fieldName": "flipFallbackPlacements"
+              "description": "The name prefix for form submission. Each item generates a hidden input named `{name}[{itemValue}]`\nwith the priority number as its value.",
+              "fieldName": "name"
             },
             {
-              "name": "flip-fallback-strategy",
+              "name": "value",
               "type": {
-                "text": "'best-fit' | 'initial'"
+                "text": "string[]"
               },
-              "default": "'best-fit'",
-              "description": "When neither the preferred placement nor the fallback placements fit, this value will be used to determine whether\nthe popup should be positioned using the best available fit based on available space or as it was initially\npreferred.",
-              "fieldName": "flipFallbackStrategy"
+              "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.",
+              "fieldName": "value"
             },
             {
-              "name": "flipBoundary",
+              "name": "label",
               "type": {
-                "text": "Element | Element[]"
+                "text": "string"
               },
-              "description": "The flip boundary describes clipping element(s) that overflow will be checked relative to when flipping. By\ndefault, the boundary includes overflow ancestors that will cause the element to be clipped. If needed, you can\nchange the boundary by passing a reference to one or more elements to this property.",
-              "fieldName": "flipBoundary"
+              "default": "''",
+              "description": "The component's label. Required for proper accessibility.",
+              "fieldName": "label"
             },
             {
-              "name": "flip-padding",
+              "name": "label-tooltip",
               "type": {
-                "text": "number"
+                "text": "string"
               },
-              "default": "0",
-              "description": "The amount of padding, in pixels, to exceed before the flip behavior will occur.",
-              "fieldName": "flipPadding"
+              "default": "''",
+              "description": "Text that appears in a tooltip next to the label.",
+              "fieldName": "labelTooltip"
             },
             {
-              "name": "shift",
+              "name": "help-text",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "description": "Moves the popup along the axis to keep it in view when clipped.",
-              "fieldName": "shift"
+              "default": "''",
+              "description": "Help text that describes how to use the component.",
+              "fieldName": "helpText"
             },
             {
-              "name": "shiftBoundary",
+              "name": "form",
               "type": {
-                "text": "Element | Element[]"
+                "text": "string"
               },
-              "description": "The shift boundary describes clipping element(s) that overflow will be checked relative to when shifting. By\ndefault, the boundary includes overflow ancestors that will cause the element to be clipped. If needed, you can\nchange the boundary by passing a reference to one or more elements to this property.",
-              "fieldName": "shiftBoundary"
+              "default": "''",
+              "description": "Associates the control with a form by id. The form must be in the same document or shadow root.",
+              "fieldName": "form"
             },
             {
-              "name": "shift-padding",
+              "name": "size",
               "type": {
-                "text": "number"
+                "text": "'small' | 'medium' | 'large'"
               },
-              "default": "0",
-              "description": "The amount of padding, in pixels, to exceed before the shift behavior will occur.",
-              "fieldName": "shiftPadding"
+              "default": "'medium'",
+              "description": "The size of the list items.",
+              "fieldName": "size"
             },
             {
-              "name": "auto-size",
+              "name": "disabled",
               "type": {
-                "text": "'horizontal' | 'vertical' | 'both'"
+                "text": "boolean"
               },
-              "description": "When set, this will cause the popup to automatically resize itself to prevent it from overflowing.",
-              "fieldName": "autoSize"
+              "default": "false",
+              "description": "Whether the priority list is disabled.",
+              "fieldName": "disabled"
             },
             {
-              "name": "sync",
+              "name": "required",
               "type": {
-                "text": "'width' | 'height' | 'both'"
+                "text": "boolean"
               },
-              "description": "Syncs the popup's width or height to that of the anchor element.",
-              "fieldName": "sync"
+              "default": "false",
+              "description": "Ensures the form control has a value before allowing submission.",
+              "fieldName": "required"
             },
             {
-              "name": "autoSizeBoundary",
+              "name": "priority-start",
               "type": {
-                "text": "Element | Element[]"
+                "text": "number"
               },
-              "description": "The auto-size boundary describes clipping element(s) that overflow will be checked relative to when resizing. By\ndefault, the boundary includes overflow ancestors that will cause the element to be clipped. If needed, you can\nchange the boundary by passing a reference to one or more elements to this property.",
-              "fieldName": "autoSizeBoundary"
+              "default": "1",
+              "description": "The starting priority number. Defaults to 1.",
+              "fieldName": "priorityStart"
             },
             {
-              "name": "auto-size-padding",
+              "name": "formaction",
               "type": {
-                "text": "number"
+                "text": "string"
               },
-              "default": "0",
-              "description": "The amount of padding, in pixels, to exceed before the auto-size behavior will occur.",
-              "fieldName": "autoSizePadding"
+              "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.",
+              "fieldName": "formAction"
             },
             {
-              "name": "hover-bridge",
+              "name": "order",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "description": "When a gap exists between the anchor and the popup element, this option will add a \"hover bridge\" that fills the\ngap using an invisible element. This makes listening for events such as `mouseenter` and `mouseleave` more sane\nbecause the pointer never technically leaves the element. The hover bridge will only be drawn when the popover is\nactive.",
-              "fieldName": "hoverBridge"
+              "default": "''",
+              "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.",
+              "fieldName": "order"
             }
           ],
           "superclass": {
             "name": "ZincElement",
             "module": "/src/internal/zinc-element"
           },
-          "summary": "Short summary of the component's intended use.",
-          "tagNameWithoutPrefix": "popup",
-          "tagName": "zn-popup",
+          "summary": "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.",
+          "tagNameWithoutPrefix": "priority-list",
+          "tagName": "zn-priority-list",
           "customElement": true,
-          "jsDoc": "/**\n * @summary Short summary of the component's intended use.\n * @documentation https://zinc.style/components/popup\n * @status experimental\n * @since 1.0\n *\n * @dependency zn-example\n *\n * @event zn-event-name - Emitted as an example.\n *\n * @slot - The default slot.\n * @slot example - An example slot.\n *\n * @csspart base - The component's base wrapper.\n *\n * @cssproperty --example - An example CSS custom property.\n */",
-          "documentation": "https://zinc.style/components/popup",
+          "jsDoc": "/**\n * @summary A reorderable list where each item receives a numerical priority based on its position. Supports drag-and-drop\n *   and keyboard reordering. Priority values are submitted as form data via hidden inputs.\n *\n * @documentation https://zinc.style/components/priority-list\n * @status experimental\n * @since 1.0\n *\n * @dependency zn-icon\n *\n * @slot - The default slot where list items are placed. Each slotted element must have a `value` attribute that\n *   uniquely identifies the item. The component automatically assigns slot names to project each item into the\n *   correct position. The item's position in the list determines its priority (top = `priority-start`, incrementing).\n * @slot label - The component's label. Required for proper accessibility. Alternatively, use the `label` attribute.\n * @slot label-tooltip - Used to add text displayed in a tooltip next to the label.\n * @slot help-text - Text that describes how to use the component. Alternatively, use the `help-text` attribute.\n *\n * @event zn-change - Emitted when the order of items changes.\n * @event zn-reorder - Emitted when items are reordered. Call `getPriorityMap()` on the component to get\n *   the updated `{ key: string, priority: number }[]` array.\n *\n * @csspart form-control - The form control wrapper.\n * @csspart form-control-label - The label wrapper.\n * @csspart form-control-input - The input area wrapper.\n * @csspart form-control-help-text - The help text wrapper.\n * @csspart list - The list container.\n * @csspart item - An individual list item row.\n * @csspart drag-handle - The drag handle icon.\n * @csspart priority - The priority number badge.\n * @csspart content - The content area of an item.\n *\n * @cssproperty --zn-priority-list-item-gap - The gap between list items. Defaults to `var(--zn-spacing-2x-small)`.\n * @cssproperty --zn-priority-list-item-padding - The padding inside each item. Defaults to `var(--zn-spacing-small) var(--zn-spacing-medium)`.\n * @cssproperty --zn-priority-list-handle-color - The color of the drag handle. Defaults to `var(--zn-color-neutral-500)`.\n * @cssproperty --zn-priority-list-priority-color - The color of the priority number. Defaults to `var(--zn-color-neutral-600)`.\n */",
+          "documentation": "https://zinc.style/components/priority-list",
           "status": "experimental",
           "since": "1.0",
           "dependencies": [
-            "zn-example"
+            "zn-icon"
           ]
         }
       ],
@@ -23893,647 +23998,542 @@
           "kind": "js",
           "name": "default",
           "declaration": {
-            "name": "ZnPopup",
-            "module": "components/popup/popup.js"
+            "name": "ZnPriorityList",
+            "module": "components/priority-list/priority-list.js"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "components/priority-list/priority-list.js",
+      "path": "components/popup/popup.js",
       "declarations": [
         {
           "kind": "class",
           "description": "",
-          "name": "ZnPriorityList",
+          "name": "ZnPopup",
           "cssProperties": [
             {
-              "description": "The gap between list items. Defaults to `var(--zn-spacing-2x-small)`.",
-              "name": "--zn-priority-list-item-gap"
-            },
-            {
-              "description": "The padding inside each item. Defaults to `var(--zn-spacing-small) var(--zn-spacing-medium)`.",
-              "name": "--zn-priority-list-item-padding"
-            },
-            {
-              "description": "The color of the drag handle. Defaults to `var(--zn-color-neutral-500)`.",
-              "name": "--zn-priority-list-handle-color"
-            },
-            {
-              "description": "The color of the priority number. Defaults to `var(--zn-color-neutral-600)`.",
-              "name": "--zn-priority-list-priority-color"
+              "description": "An example CSS custom property.",
+              "name": "--example"
             }
           ],
           "cssParts": [
             {
-              "description": "The form control wrapper.",
-              "name": "form-control"
-            },
-            {
-              "description": "The label wrapper.",
-              "name": "form-control-label"
-            },
-            {
-              "description": "The input area wrapper.",
-              "name": "form-control-input"
-            },
-            {
-              "description": "The help text wrapper.",
-              "name": "form-control-help-text"
-            },
-            {
-              "description": "The list container.",
-              "name": "list"
-            },
-            {
-              "description": "An individual list item row.",
-              "name": "item"
-            },
-            {
-              "description": "The drag handle icon.",
-              "name": "drag-handle"
-            },
-            {
-              "description": "The priority number badge.",
-              "name": "priority"
-            },
-            {
-              "description": "The content area of an item.",
-              "name": "content"
+              "description": "The component's base wrapper.",
+              "name": "base"
             }
           ],
           "slots": [
             {
-              "description": "The default slot where list items are placed. Each slotted element must have a `value` attribute that uniquely identifies the item. The component automatically assigns slot names to project each item into the correct position. The item's position in the list determines its priority (top = `priority-start`, incrementing).",
+              "description": "The default slot.",
               "name": ""
             },
             {
-              "description": "The component's label. Required for proper accessibility. Alternatively, use the `label` attribute.",
-              "name": "label"
-            },
-            {
-              "description": "Used to add text displayed in a tooltip next to the label.",
-              "name": "label-tooltip"
-            },
-            {
-              "description": "Text that describes how to use the component. Alternatively, use the `help-text` attribute.",
-              "name": "help-text"
+              "description": "An example slot.",
+              "name": "example"
             }
           ],
           "members": [
             {
               "kind": "field",
-              "name": "dependencies",
+              "name": "anchorEl",
               "type": {
-                "text": "object"
+                "text": "Element | VirtualElement | null"
               },
-              "static": true,
-              "default": "{ 'zn-icon': ZnIcon, }"
-            },
-            {
-              "kind": "field",
-              "name": "formControlController",
-              "privacy": "protected",
-              "readonly": true,
-              "default": "new FormControlController(this, { value: (control: ZnPriorityList) => { return JSON.stringify(control.getPriorityMap()); }, defaultValue: (control: ZnPriorityList) => control.defaultValue, setValue: (control: ZnPriorityList, value: string) => { if (value) { try { const parsed: unknown = JSON.parse(value); if (Array.isArray(parsed) && parsed.every((item: unknown): item is string => typeof item === 'string')) { control.value = parsed as string[]; } } catch { // ignore parse errors } } }, })"
+              "privacy": "private"
             },
             {
               "kind": "field",
-              "name": "hasSlotController",
-              "privacy": "private",
-              "readonly": true,
-              "default": "new HasSlotController(this, 'help-text', 'label')"
+              "name": "cleanup",
+              "type": {
+                "text": "ReturnType<typeof autoUpdate> | undefined"
+              },
+              "privacy": "private"
             },
             {
               "kind": "field",
-              "name": "hiddenInputsContainer",
+              "name": "popup",
               "type": {
-                "text": "HTMLDivElement"
-              }
+                "text": "HTMLElement"
+              },
+              "description": "A reference to the internal popup container. Useful for animating and styling the popup with JavaScript."
             },
             {
               "kind": "field",
-              "name": "name",
+              "name": "arrowEl",
               "type": {
-                "text": "string"
+                "text": "HTMLElement"
               },
-              "default": "''",
-              "description": "The name prefix for form submission. Each item generates a hidden input named `{name}[{itemValue}]`\nwith the priority number as its value.",
-              "attribute": "name"
+              "privacy": "private"
             },
             {
               "kind": "field",
-              "name": "value",
+              "name": "anchor",
               "type": {
-                "text": "string[]"
+                "text": "Element | string | VirtualElement"
               },
-              "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.",
-              "attribute": "value"
+              "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.",
+              "attribute": "anchor"
             },
             {
               "kind": "field",
-              "name": "_value",
+              "name": "active",
               "type": {
-                "text": "string[]"
+                "text": "boolean"
               },
-              "privacy": "private",
-              "default": "[]"
+              "default": "false",
+              "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.",
+              "attribute": "active",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "defaultValue",
+              "name": "placement",
               "type": {
-                "text": "string[]"
+                "text": "| '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": "[]"
+              "default": "'top'",
+              "description": "The preferred placement of the popup. Note that the actual placement will vary as configured to keep the\npanel inside of the viewport.",
+              "attribute": "placement",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "label",
+              "name": "strategy",
               "type": {
-                "text": "string"
+                "text": "'absolute' | 'fixed'"
               },
-              "default": "''",
-              "description": "The component's label. Required for proper accessibility.",
-              "attribute": "label"
+              "default": "'fixed'",
+              "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.",
+              "attribute": "strategy",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "labelTooltip",
+              "name": "distance",
               "type": {
-                "text": "string"
+                "text": "number"
               },
-              "default": "''",
-              "description": "Text that appears in a tooltip next to the label.",
-              "attribute": "label-tooltip"
+              "default": "0",
+              "description": "The distance in pixels from which to offset the panel away from its anchor.",
+              "attribute": "distance"
             },
             {
               "kind": "field",
-              "name": "helpText",
+              "name": "skidding",
               "type": {
-                "text": "string"
+                "text": "number"
               },
-              "default": "''",
-              "description": "Help text that describes how to use the component.",
-              "attribute": "help-text"
+              "default": "0",
+              "description": "The distance in pixels from which to offset the panel along its anchor.",
+              "attribute": "skidding"
             },
             {
               "kind": "field",
-              "name": "form",
+              "name": "arrow",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "''",
-              "description": "Associates the control with a form by id. The form must be in the same document or shadow root.",
-              "attribute": "form",
-              "reflects": true
+              "default": "false",
+              "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.",
+              "attribute": "arrow"
             },
             {
               "kind": "field",
-              "name": "size",
+              "name": "arrowPlacement",
               "type": {
-                "text": "'small' | 'medium' | 'large'"
+                "text": "'start' | 'end' | 'center' | 'anchor'"
               },
-              "default": "'medium'",
-              "description": "The size of the list items.",
-              "attribute": "size",
-              "reflects": true
+              "default": "'anchor'",
+              "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.",
+              "attribute": "arrow-placement"
             },
             {
               "kind": "field",
-              "name": "disabled",
+              "name": "arrowPadding",
               "type": {
-                "text": "boolean"
+                "text": "number"
               },
-              "default": "false",
-              "description": "Whether the priority list is disabled.",
-              "attribute": "disabled",
-              "reflects": true
+              "default": "10",
+              "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.",
+              "attribute": "arrow-padding"
             },
             {
               "kind": "field",
-              "name": "required",
+              "name": "flip",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Ensures the form control has a value before allowing submission.",
-              "attribute": "required",
-              "reflects": true
+              "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.",
+              "attribute": "flip"
             },
             {
               "kind": "field",
-              "name": "priorityStart",
+              "name": "flipFallbackPlacements",
               "type": {
-                "text": "number"
+                "text": "string"
               },
-              "default": "1",
-              "description": "The starting priority number. Defaults to 1.",
-              "attribute": "priority-start"
+              "default": "''",
+              "description": "If the preferred placement doesn't fit, popup will be tested in these fallback placements until one fits. Must be a\nstring of any number of placements separated by a space, e.g. \"top bottom left\". If no placement fits, the flip\nfallback strategy will be used instead.",
+              "attribute": "flip-fallback-placements"
             },
             {
               "kind": "field",
-              "name": "formAction",
+              "name": "flipFallbackStrategy",
               "type": {
-                "text": "string"
+                "text": "'best-fit' | 'initial'"
               },
-              "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.",
-              "attribute": "formaction"
+              "default": "'best-fit'",
+              "description": "When neither the preferred placement nor the fallback placements fit, this value will be used to determine whether\nthe popup should be positioned using the best available fit based on available space or as it was initially\npreferred.",
+              "attribute": "flip-fallback-strategy"
             },
             {
               "kind": "field",
-              "name": "order",
+              "name": "flipBoundary",
               "type": {
-                "text": "string"
+                "text": "Element | Element[]"
               },
-              "default": "''",
-              "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.",
-              "attribute": "order"
+              "description": "The flip boundary describes clipping element(s) that overflow will be checked relative to when flipping. By\ndefault, the boundary includes overflow ancestors that will cause the element to be clipped. If needed, you can\nchange the boundary by passing a reference to one or more elements to this property.",
+              "attribute": "flipBoundary"
             },
             {
               "kind": "field",
-              "name": "draggedKey",
+              "name": "flipPadding",
               "type": {
-                "text": "string | null"
+                "text": "number"
               },
-              "privacy": "private",
-              "default": "null"
+              "default": "0",
+              "description": "The amount of padding, in pixels, to exceed before the flip behavior will occur.",
+              "attribute": "flip-padding"
             },
             {
               "kind": "field",
-              "name": "isDragging",
+              "name": "shift",
               "type": {
                 "text": "boolean"
               },
-              "privacy": "private",
-              "default": "false"
+              "default": "false",
+              "description": "Moves the popup along the axis to keep it in view when clipped.",
+              "attribute": "shift"
             },
             {
               "kind": "field",
-              "name": "dragOverKey",
+              "name": "shiftBoundary",
               "type": {
-                "text": "string | null"
+                "text": "Element | Element[]"
               },
-              "privacy": "private",
-              "default": "null"
+              "description": "The shift boundary describes clipping element(s) that overflow will be checked relative to when shifting. By\ndefault, the boundary includes overflow ancestors that will cause the element to be clipped. If needed, you can\nchange the boundary by passing a reference to one or more elements to this property.",
+              "attribute": "shiftBoundary"
             },
             {
               "kind": "field",
-              "name": "validity",
+              "name": "shiftPadding",
               "type": {
-                "text": "ValidityState"
+                "text": "number"
               },
-              "description": "Gets the validity state object.",
-              "readonly": true
+              "default": "0",
+              "description": "The amount of padding, in pixels, to exceed before the shift behavior will occur.",
+              "attribute": "shift-padding"
             },
             {
               "kind": "field",
-              "name": "validationMessage",
+              "name": "autoSize",
               "type": {
-                "text": "string"
+                "text": "'horizontal' | 'vertical' | 'both'"
               },
-              "description": "Gets the validation message.",
-              "readonly": true
+              "description": "When set, this will cause the popup to automatically resize itself to prevent it from overflowing.",
+              "attribute": "auto-size"
             },
             {
-              "kind": "method",
-              "name": "_initializeOrderFromSlot",
-              "privacy": "private",
-              "description": "Initialize item order from slotted children if no explicit value was provided.\nIf an `order` attribute is set, use it to define the initial order,\nappending any slotted items not listed in the order at the end."
+              "kind": "field",
+              "name": "sync",
+              "type": {
+                "text": "'width' | 'height' | 'both'"
+              },
+              "description": "Syncs the popup's width or height to that of the anchor element.",
+              "attribute": "sync"
             },
             {
-              "kind": "method",
-              "name": "_getSlottedItems",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "HTMLElement[]"
-                }
+              "kind": "field",
+              "name": "autoSizeBoundary",
+              "type": {
+                "text": "Element | Element[]"
               },
-              "description": "Gets all direct children with a `value` attribute (excluding those in reserved slots)."
+              "description": "The auto-size boundary describes clipping element(s) that overflow will be checked relative to when resizing. By\ndefault, the boundary includes overflow ancestors that will cause the element to be clipped. If needed, you can\nchange the boundary by passing a reference to one or more elements to this property.",
+              "attribute": "autoSizeBoundary"
             },
             {
-              "kind": "method",
-              "name": "_assignSlotNames",
-              "privacy": "private",
-              "description": "Assigns `slot` attributes to light DOM children based on their `value` attribute,\nso they project into the correct named slot in the shadow DOM."
+              "kind": "field",
+              "name": "autoSizePadding",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "The amount of padding, in pixels, to exceed before the auto-size behavior will occur.",
+              "attribute": "auto-size-padding"
             },
             {
-              "kind": "method",
-              "name": "getPriorityMap",
-              "return": {
-                "type": {
-                  "text": "PriorityItem[]"
-                }
+              "kind": "field",
+              "name": "hoverBridge",
+              "type": {
+                "text": "boolean"
               },
-              "description": "Returns the priority map: an array of { key, priority } objects."
+              "default": "false",
+              "description": "When a gap exists between the anchor and the popup element, this option will add a \"hover bridge\" that fills the\ngap using an invisible element. This makes listening for events such as `mouseenter` and `mouseleave` more sane\nbecause the pointer never technically leaves the element. The hover bridge will only be drawn when the popover is\nactive.",
+              "attribute": "hover-bridge"
             },
             {
               "kind": "method",
-              "name": "_syncHiddenInputs",
-              "privacy": "private",
-              "description": "Syncs hidden inputs so form data includes priority values."
+              "name": "handleAnchorChange",
+              "privacy": "private"
             },
             {
-              "kind": "method",
-              "name": "_moveItem",
-              "privacy": "private",
-              "parameters": [
-                {
-                  "name": "fromIndex",
-                  "type": {
-                    "text": "number"
-                  }
-                },
-                {
-                  "name": "toIndex",
-                  "type": {
-                    "text": "number"
-                  }
-                }
-              ],
-              "description": "Moves an item from one index to another."
+              "kind": "field",
+              "name": "handleAnchorHover",
+              "privacy": "public"
             },
             {
               "kind": "method",
-              "name": "_submitForm",
-              "privacy": "private",
-              "description": "Submits the associated form if a `formaction` attribute is set."
+              "name": "start",
+              "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "_handleDragStart",
+              "name": "stop",
               "privacy": "private",
-              "parameters": [
-                {
-                  "name": "event",
-                  "type": {
-                    "text": "DragEvent"
-                  }
-                },
-                {
-                  "name": "key",
-                  "type": {
-                    "text": "string"
-                  }
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
                 }
-              ]
+              }
             },
             {
               "kind": "method",
-              "name": "_handleDragEnd",
-              "privacy": "private"
+              "name": "reposition",
+              "description": "Forces the popup to recalculate and reposition itself."
             },
             {
-              "kind": "method",
-              "name": "_handleDragOver",
-              "privacy": "private",
-              "parameters": [
-                {
-                  "name": "event",
-                  "type": {
-                    "text": "DragEvent"
-                  }
-                },
-                {
-                  "name": "key",
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ]
-            },
+              "kind": "field",
+              "name": "updateHoverBridge",
+              "privacy": "private"
+            }
+          ],
+          "events": [
             {
-              "kind": "method",
-              "name": "_handleDragLeave",
-              "privacy": "private",
-              "parameters": [
-                {
-                  "name": "event",
-                  "type": {
-                    "text": "DragEvent"
-                  }
-                },
-                {
-                  "name": "key",
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ]
-            },
+              "description": "Emitted as an example.",
+              "name": "zn-event-name"
+            }
+          ],
+          "attributes": [
             {
-              "kind": "method",
-              "name": "_handleDrop",
-              "privacy": "private",
-              "parameters": [
-                {
-                  "name": "event",
-                  "type": {
-                    "text": "DragEvent"
-                  }
-                }
-              ]
+              "name": "anchor",
+              "type": {
+                "text": "Element | string | VirtualElement"
+              },
+              "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.",
+              "fieldName": "anchor"
             },
             {
-              "kind": "method",
-              "name": "_handleKeyDown",
-              "privacy": "private",
-              "parameters": [
-                {
-                  "name": "event",
-                  "type": {
-                    "text": "KeyboardEvent"
-                  }
-                },
-                {
-                  "name": "key",
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ]
+              "name": "active",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "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.",
+              "fieldName": "active"
             },
             {
-              "kind": "method",
-              "name": "_handleSlotChange",
-              "privacy": "private"
+              "name": "placement",
+              "type": {
+                "text": "| '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'",
+              "description": "The preferred placement of the popup. Note that the actual placement will vary as configured to keep the\npanel inside of the viewport.",
+              "fieldName": "placement"
             },
             {
-              "kind": "method",
-              "name": "checkValidity",
-              "return": {
-                "type": {
-                  "text": "boolean"
-                }
+              "name": "strategy",
+              "type": {
+                "text": "'absolute' | 'fixed'"
               },
-              "description": "Checks for validity but does not show a validation message."
+              "default": "'fixed'",
+              "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.",
+              "fieldName": "strategy"
             },
             {
-              "kind": "method",
-              "name": "getForm",
-              "return": {
-                "type": {
-                  "text": "HTMLFormElement | null"
-                }
+              "name": "distance",
+              "type": {
+                "text": "number"
               },
-              "description": "Gets the associated form, if one exists."
+              "default": "0",
+              "description": "The distance in pixels from which to offset the panel away from its anchor.",
+              "fieldName": "distance"
             },
             {
-              "kind": "method",
-              "name": "reportValidity",
-              "return": {
-                "type": {
-                  "text": "boolean"
-                }
+              "name": "skidding",
+              "type": {
+                "text": "number"
               },
-              "description": "Checks for validity and shows the browser's validation message if the control is invalid."
+              "default": "0",
+              "description": "The distance in pixels from which to offset the panel along its anchor.",
+              "fieldName": "skidding"
             },
             {
-              "kind": "method",
-              "name": "setCustomValidity",
-              "parameters": [
-                {
-                  "name": "_message",
-                  "default": "''"
-                }
-              ],
-              "description": "Sets a custom validation message. Pass an empty string to restore validity."
-            }
-          ],
-          "events": [
-            {
-              "description": "Emitted when the order of items changes.",
-              "name": "zn-change"
+              "name": "arrow",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "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.",
+              "fieldName": "arrow"
             },
             {
-              "description": "Emitted when items are reordered. Call `getPriorityMap()` on the component to get the updated `{ key: string, priority: number }[]` array.",
-              "name": "zn-reorder"
-            }
-          ],
-          "attributes": [
-            {
-              "name": "name",
+              "name": "arrow-placement",
               "type": {
-                "text": "string"
+                "text": "'start' | 'end' | 'center' | 'anchor'"
               },
-              "default": "''",
-              "description": "The name prefix for form submission. Each item generates a hidden input named `{name}[{itemValue}]`\nwith the priority number as its value.",
-              "fieldName": "name"
+              "default": "'anchor'",
+              "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.",
+              "fieldName": "arrowPlacement"
             },
             {
-              "name": "value",
+              "name": "arrow-padding",
               "type": {
-                "text": "string[]"
+                "text": "number"
               },
-              "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.",
-              "fieldName": "value"
+              "default": "10",
+              "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.",
+              "fieldName": "arrowPadding"
             },
             {
-              "name": "label",
+              "name": "flip",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "''",
-              "description": "The component's label. Required for proper accessibility.",
-              "fieldName": "label"
+              "default": "false",
+              "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.",
+              "fieldName": "flip"
             },
             {
-              "name": "label-tooltip",
+              "name": "flip-fallback-placements",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "description": "Text that appears in a tooltip next to the label.",
-              "fieldName": "labelTooltip"
+              "description": "If the preferred placement doesn't fit, popup will be tested in these fallback placements until one fits. Must be a\nstring of any number of placements separated by a space, e.g. \"top bottom left\". If no placement fits, the flip\nfallback strategy will be used instead.",
+              "fieldName": "flipFallbackPlacements"
             },
             {
-              "name": "help-text",
+              "name": "flip-fallback-strategy",
               "type": {
-                "text": "string"
+                "text": "'best-fit' | 'initial'"
               },
-              "default": "''",
-              "description": "Help text that describes how to use the component.",
-              "fieldName": "helpText"
+              "default": "'best-fit'",
+              "description": "When neither the preferred placement nor the fallback placements fit, this value will be used to determine whether\nthe popup should be positioned using the best available fit based on available space or as it was initially\npreferred.",
+              "fieldName": "flipFallbackStrategy"
             },
             {
-              "name": "form",
+              "name": "flipBoundary",
               "type": {
-                "text": "string"
+                "text": "Element | Element[]"
               },
-              "default": "''",
-              "description": "Associates the control with a form by id. The form must be in the same document or shadow root.",
-              "fieldName": "form"
+              "description": "The flip boundary describes clipping element(s) that overflow will be checked relative to when flipping. By\ndefault, the boundary includes overflow ancestors that will cause the element to be clipped. If needed, you can\nchange the boundary by passing a reference to one or more elements to this property.",
+              "fieldName": "flipBoundary"
             },
             {
-              "name": "size",
+              "name": "flip-padding",
               "type": {
-                "text": "'small' | 'medium' | 'large'"
+                "text": "number"
               },
-              "default": "'medium'",
-              "description": "The size of the list items.",
-              "fieldName": "size"
+              "default": "0",
+              "description": "The amount of padding, in pixels, to exceed before the flip behavior will occur.",
+              "fieldName": "flipPadding"
             },
             {
-              "name": "disabled",
+              "name": "shift",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the priority list is disabled.",
-              "fieldName": "disabled"
+              "description": "Moves the popup along the axis to keep it in view when clipped.",
+              "fieldName": "shift"
             },
             {
-              "name": "required",
+              "name": "shiftBoundary",
               "type": {
-                "text": "boolean"
+                "text": "Element | Element[]"
               },
-              "default": "false",
-              "description": "Ensures the form control has a value before allowing submission.",
-              "fieldName": "required"
+              "description": "The shift boundary describes clipping element(s) that overflow will be checked relative to when shifting. By\ndefault, the boundary includes overflow ancestors that will cause the element to be clipped. If needed, you can\nchange the boundary by passing a reference to one or more elements to this property.",
+              "fieldName": "shiftBoundary"
             },
             {
-              "name": "priority-start",
+              "name": "shift-padding",
               "type": {
                 "text": "number"
               },
-              "default": "1",
-              "description": "The starting priority number. Defaults to 1.",
-              "fieldName": "priorityStart"
+              "default": "0",
+              "description": "The amount of padding, in pixels, to exceed before the shift behavior will occur.",
+              "fieldName": "shiftPadding"
             },
             {
-              "name": "formaction",
+              "name": "auto-size",
               "type": {
-                "text": "string"
+                "text": "'horizontal' | 'vertical' | 'both'"
               },
-              "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.",
-              "fieldName": "formAction"
+              "description": "When set, this will cause the popup to automatically resize itself to prevent it from overflowing.",
+              "fieldName": "autoSize"
             },
             {
-              "name": "order",
+              "name": "sync",
               "type": {
-                "text": "string"
+                "text": "'width' | 'height' | 'both'"
               },
-              "default": "''",
-              "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.",
-              "fieldName": "order"
+              "description": "Syncs the popup's width or height to that of the anchor element.",
+              "fieldName": "sync"
+            },
+            {
+              "name": "autoSizeBoundary",
+              "type": {
+                "text": "Element | Element[]"
+              },
+              "description": "The auto-size boundary describes clipping element(s) that overflow will be checked relative to when resizing. By\ndefault, the boundary includes overflow ancestors that will cause the element to be clipped. If needed, you can\nchange the boundary by passing a reference to one or more elements to this property.",
+              "fieldName": "autoSizeBoundary"
+            },
+            {
+              "name": "auto-size-padding",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "The amount of padding, in pixels, to exceed before the auto-size behavior will occur.",
+              "fieldName": "autoSizePadding"
+            },
+            {
+              "name": "hover-bridge",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When a gap exists between the anchor and the popup element, this option will add a \"hover bridge\" that fills the\ngap using an invisible element. This makes listening for events such as `mouseenter` and `mouseleave` more sane\nbecause the pointer never technically leaves the element. The hover bridge will only be drawn when the popover is\nactive.",
+              "fieldName": "hoverBridge"
             }
           ],
           "superclass": {
             "name": "ZincElement",
             "module": "/src/internal/zinc-element"
           },
-          "summary": "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.",
-          "tagNameWithoutPrefix": "priority-list",
-          "tagName": "zn-priority-list",
+          "summary": "Short summary of the component's intended use.",
+          "tagNameWithoutPrefix": "popup",
+          "tagName": "zn-popup",
           "customElement": true,
-          "jsDoc": "/**\n * @summary A reorderable list where each item receives a numerical priority based on its position. Supports drag-and-drop\n *   and keyboard reordering. Priority values are submitted as form data via hidden inputs.\n *\n * @documentation https://zinc.style/components/priority-list\n * @status experimental\n * @since 1.0\n *\n * @dependency zn-icon\n *\n * @slot - The default slot where list items are placed. Each slotted element must have a `value` attribute that\n *   uniquely identifies the item. The component automatically assigns slot names to project each item into the\n *   correct position. The item's position in the list determines its priority (top = `priority-start`, incrementing).\n * @slot label - The component's label. Required for proper accessibility. Alternatively, use the `label` attribute.\n * @slot label-tooltip - Used to add text displayed in a tooltip next to the label.\n * @slot help-text - Text that describes how to use the component. Alternatively, use the `help-text` attribute.\n *\n * @event zn-change - Emitted when the order of items changes.\n * @event zn-reorder - Emitted when items are reordered. Call `getPriorityMap()` on the component to get\n *   the updated `{ key: string, priority: number }[]` array.\n *\n * @csspart form-control - The form control wrapper.\n * @csspart form-control-label - The label wrapper.\n * @csspart form-control-input - The input area wrapper.\n * @csspart form-control-help-text - The help text wrapper.\n * @csspart list - The list container.\n * @csspart item - An individual list item row.\n * @csspart drag-handle - The drag handle icon.\n * @csspart priority - The priority number badge.\n * @csspart content - The content area of an item.\n *\n * @cssproperty --zn-priority-list-item-gap - The gap between list items. Defaults to `var(--zn-spacing-2x-small)`.\n * @cssproperty --zn-priority-list-item-padding - The padding inside each item. Defaults to `var(--zn-spacing-small) var(--zn-spacing-medium)`.\n * @cssproperty --zn-priority-list-handle-color - The color of the drag handle. Defaults to `var(--zn-color-neutral-500)`.\n * @cssproperty --zn-priority-list-priority-color - The color of the priority number. Defaults to `var(--zn-color-neutral-600)`.\n */",
-          "documentation": "https://zinc.style/components/priority-list",
+          "jsDoc": "/**\n * @summary Short summary of the component's intended use.\n * @documentation https://zinc.style/components/popup\n * @status experimental\n * @since 1.0\n *\n * @dependency zn-example\n *\n * @event zn-event-name - Emitted as an example.\n *\n * @slot - The default slot.\n * @slot example - An example slot.\n *\n * @csspart base - The component's base wrapper.\n *\n * @cssproperty --example - An example CSS custom property.\n */",
+          "documentation": "https://zinc.style/components/popup",
           "status": "experimental",
           "since": "1.0",
           "dependencies": [
-            "zn-icon"
+            "zn-example"
           ]
         }
       ],
@@ -24542,8 +24542,8 @@
           "kind": "js",
           "name": "default",
           "declaration": {
-            "name": "ZnPriorityList",
-            "module": "components/priority-list/priority-list.js"
+            "name": "ZnPopup",
+            "module": "components/popup/popup.js"
           }
         }
       ]
@@ -36368,7 +36368,7 @@
   "package": {
     "name": "@kubex/zinc",
     "description": "A collection of web components for building web applications based off of @shoelace-style/Shoelace",
-    "version": "1.1.11",
+    "version": "1.1.12",
     "author": "",
     "license": "MIT"
   }