@kubex/zinc 1.1.117 → 1.1.119

package/dist/custom-elements.json

@@ -56,6 +56,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/alert/alert.js",
@@ -250,79 +323,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/animated-button/animated-button.js",
@@ -842,269 +842,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "components/background/background.js",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "",
-          "name": "ZnBackground",
-          "cssProperties": [
-            {
-              "description": "Fallback colour when the `color` attribute is not set.",
-              "name": "--zn-background-color"
-            },
-            {
-              "description": "Position of the background image. Defaults to `center`.",
-              "name": "--zn-background-image-position"
-            },
-            {
-              "description": "Direction of the overlay gradient. Defaults to `110deg`.",
-              "name": "--zn-background-overlay-angle"
-            },
-            {
-              "description": "Colour of the floating icons. Defaults to `currentColor`.",
-              "name": "--zn-background-floating-icon-color"
-            }
-          ],
-          "cssParts": [
-            {
-              "description": "The component's full-size background canvas.",
-              "name": "base"
-            },
-            {
-              "description": "The decorative background image.",
-              "name": "image"
-            },
-            {
-              "description": "The contrast overlay between the image and content.",
-              "name": "overlay"
-            },
-            {
-              "description": "The non-interactive layer containing the floating icons.",
-              "name": "floating-icons"
-            },
-            {
-              "description": "Each floating `zn-icon`.",
-              "name": "floating-icon"
-            },
-            {
-              "description": "The wrapper around the default slot.",
-              "name": "content"
-            }
-          ],
-          "slots": [
-            {
-              "description": "Content displayed above the background layers.",
-              "name": ""
-            }
-          ],
-          "members": [
-            {
-              "kind": "field",
-              "name": "dependencies",
-              "type": {
-                "text": "object"
-              },
-              "static": true,
-              "default": "{'zn-icon': ZnIcon}"
-            },
-            {
-              "kind": "field",
-              "name": "resizeObserver",
-              "privacy": "private",
-              "readonly": true,
-              "default": "new ResizeController<number>(this, { callback: entries => { const width = entries[0]?.contentRect.width ?? this.offsetWidth; return Math.max(1, Math.min(width * 0.05, 150)); }, })"
-            },
-            {
-              "kind": "field",
-              "name": "image",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "description": "URL of the decorative background image.",
-              "attribute": "image"
-            },
-            {
-              "kind": "field",
-              "name": "color",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "description": "CSS colour painted beneath the image.",
-              "attribute": "color"
-            },
-            {
-              "kind": "field",
-              "name": "imageStrength",
-              "type": {
-                "text": "BackgroundImageStrength"
-              },
-              "default": "'full'",
-              "description": "Visibility of the image: `soft` (30%), `medium` (62%) or `full` (100%).",
-              "attribute": "image-strength",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "motion",
-              "type": {
-                "text": "BackgroundMotion"
-              },
-              "default": "'none'",
-              "description": "Subtle animation applied to the image. Motion stops when reduced motion is requested.",
-              "attribute": "motion",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "overlay",
-              "type": {
-                "text": "BackgroundOverlay"
-              },
-              "default": "'soft'",
-              "description": "Strength of the contrast gradient above the image.",
-              "attribute": "overlay",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "overlayTone",
-              "type": {
-                "text": "BackgroundOverlayTone"
-              },
-              "default": "'light'",
-              "description": "Whether the overlay uses a light or dark contrast treatment.",
-              "attribute": "overlay-tone",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "floatingIcons",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "description": "Comma-separated Zinc icon names placed as ambient decoration. At most eight are rendered.",
-              "attribute": "floating-icons"
-            },
-            {
-              "kind": "field",
-              "name": "paused",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Pauses background motion without changing the selected motion treatment.",
-              "attribute": "paused",
-              "reflects": true
-            }
-          ],
-          "attributes": [
-            {
-              "name": "image",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "description": "URL of the decorative background image.",
-              "fieldName": "image"
-            },
-            {
-              "name": "color",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "description": "CSS colour painted beneath the image.",
-              "fieldName": "color"
-            },
-            {
-              "name": "image-strength",
-              "type": {
-                "text": "BackgroundImageStrength"
-              },
-              "default": "'full'",
-              "description": "Visibility of the image: `soft` (30%), `medium` (62%) or `full` (100%).",
-              "fieldName": "imageStrength"
-            },
-            {
-              "name": "motion",
-              "type": {
-                "text": "BackgroundMotion"
-              },
-              "default": "'none'",
-              "description": "Subtle animation applied to the image. Motion stops when reduced motion is requested.",
-              "fieldName": "motion"
-            },
-            {
-              "name": "overlay",
-              "type": {
-                "text": "BackgroundOverlay"
-              },
-              "default": "'soft'",
-              "description": "Strength of the contrast gradient above the image.",
-              "fieldName": "overlay"
-            },
-            {
-              "name": "overlay-tone",
-              "type": {
-                "text": "BackgroundOverlayTone"
-              },
-              "default": "'light'",
-              "description": "Whether the overlay uses a light or dark contrast treatment.",
-              "fieldName": "overlayTone"
-            },
-            {
-              "name": "floating-icons",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "description": "Comma-separated Zinc icon names placed as ambient decoration. At most eight are rendered.",
-              "fieldName": "floatingIcons"
-            },
-            {
-              "name": "paused",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Pauses background motion without changing the selected motion treatment.",
-              "fieldName": "paused"
-            }
-          ],
-          "superclass": {
-            "name": "ZincElement",
-            "module": "/src/internal/zinc-element"
-          },
-          "summary": "Composes a colour, decorative image, image strength, optional motion and contrast overlay behind slotted content.",
-          "tagNameWithoutPrefix": "background",
-          "tagName": "zn-background",
-          "customElement": true,
-          "jsDoc": "/**\n * @summary Composes a colour, decorative image, image strength, optional motion and contrast overlay behind slotted content.\n *\n * @documentation https://zinc.style/components/background\n * @status experimental\n * @since 1.0\n *\n * @dependency zn-icon\n *\n * @slot - Content displayed above the background layers.\n *\n * @csspart base - The component's full-size background canvas.\n * @csspart image - The decorative background image.\n * @csspart overlay - The contrast overlay between the image and content.\n * @csspart floating-icons - The non-interactive layer containing the floating icons.\n * @csspart floating-icon - Each floating `zn-icon`.\n * @csspart content - The wrapper around the default slot.\n *\n * @cssproperty --zn-background-color - Fallback colour when the `color` attribute is not set.\n * @cssproperty --zn-background-image-position - Position of the background image. Defaults to `center`.\n * @cssproperty --zn-background-overlay-angle - Direction of the overlay gradient. Defaults to `110deg`.\n * @cssproperty --zn-background-floating-icon-color - Colour of the floating icons. Defaults to `currentColor`.\n */",
-          "documentation": "https://zinc.style/components/background",
-          "status": "experimental",
-          "since": "1.0",
-          "dependencies": [
-            "zn-icon"
-          ]
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "default",
-          "declaration": {
-            "name": "ZnBackground",
-            "module": "components/background/background.js"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "components/bulk-actions/bulk-actions.js",
@@ -1462,6 +1199,434 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "components/background/background.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "ZnBackground",
+          "cssProperties": [
+            {
+              "description": "Fallback colour when the `color` attribute is not set.",
+              "name": "--zn-background-color"
+            },
+            {
+              "description": "Position of the background image. Defaults to `center`.",
+              "name": "--zn-background-image-position"
+            },
+            {
+              "description": "Direction of the overlay gradient. Defaults to `110deg`.",
+              "name": "--zn-background-overlay-angle"
+            },
+            {
+              "description": "Colour of the floating icons. Defaults to `currentColor`.",
+              "name": "--zn-background-floating-icon-color"
+            }
+          ],
+          "cssParts": [
+            {
+              "description": "The component's full-size background canvas.",
+              "name": "base"
+            },
+            {
+              "description": "The decorative background image.",
+              "name": "image"
+            },
+            {
+              "description": "The contrast overlay between the image and content.",
+              "name": "overlay"
+            },
+            {
+              "description": "The non-interactive layer containing the floating icons.",
+              "name": "floating-icons"
+            },
+            {
+              "description": "Each floating `zn-icon`.",
+              "name": "floating-icon"
+            },
+            {
+              "description": "The wrapper around the default slot.",
+              "name": "content"
+            }
+          ],
+          "slots": [
+            {
+              "description": "Content displayed above the background layers.",
+              "name": ""
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "dependencies",
+              "type": {
+                "text": "object"
+              },
+              "static": true,
+              "default": "{'zn-icon': ZnIcon}"
+            },
+            {
+              "kind": "field",
+              "name": "resizeObserver",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new ResizeController<number>(this, { callback: entries => { const width = entries[0]?.contentRect.width ?? this.offsetWidth; return Math.max(1, Math.min(width * 0.05, 150)); }, })"
+            },
+            {
+              "kind": "field",
+              "name": "image",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "URL of the decorative background image.",
+              "attribute": "image"
+            },
+            {
+              "kind": "field",
+              "name": "color",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "CSS colour painted beneath the image.",
+              "attribute": "color"
+            },
+            {
+              "kind": "field",
+              "name": "imageStrength",
+              "type": {
+                "text": "BackgroundImageStrength"
+              },
+              "default": "'full'",
+              "description": "Visibility of the image: `soft` (30%), `medium` (62%) or `full` (100%).",
+              "attribute": "image-strength",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "motion",
+              "type": {
+                "text": "BackgroundMotion"
+              },
+              "default": "'none'",
+              "description": "Subtle animation applied to the image. Motion stops when reduced motion is requested.",
+              "attribute": "motion",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "overlay",
+              "type": {
+                "text": "BackgroundOverlay"
+              },
+              "default": "'soft'",
+              "description": "Strength of the contrast gradient above the image.",
+              "attribute": "overlay",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "overlayTone",
+              "type": {
+                "text": "BackgroundOverlayTone"
+              },
+              "default": "'light'",
+              "description": "Whether the overlay uses a light or dark contrast treatment.",
+              "attribute": "overlay-tone",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "floatingIcons",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Comma-separated Zinc icon names placed as ambient decoration. At most eight are rendered.",
+              "attribute": "floating-icons"
+            },
+            {
+              "kind": "field",
+              "name": "paused",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Pauses background motion without changing the selected motion treatment.",
+              "attribute": "paused",
+              "reflects": true
+            }
+          ],
+          "attributes": [
+            {
+              "name": "image",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "URL of the decorative background image.",
+              "fieldName": "image"
+            },
+            {
+              "name": "color",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "CSS colour painted beneath the image.",
+              "fieldName": "color"
+            },
+            {
+              "name": "image-strength",
+              "type": {
+                "text": "BackgroundImageStrength"
+              },
+              "default": "'full'",
+              "description": "Visibility of the image: `soft` (30%), `medium` (62%) or `full` (100%).",
+              "fieldName": "imageStrength"
+            },
+            {
+              "name": "motion",
+              "type": {
+                "text": "BackgroundMotion"
+              },
+              "default": "'none'",
+              "description": "Subtle animation applied to the image. Motion stops when reduced motion is requested.",
+              "fieldName": "motion"
+            },
+            {
+              "name": "overlay",
+              "type": {
+                "text": "BackgroundOverlay"
+              },
+              "default": "'soft'",
+              "description": "Strength of the contrast gradient above the image.",
+              "fieldName": "overlay"
+            },
+            {
+              "name": "overlay-tone",
+              "type": {
+                "text": "BackgroundOverlayTone"
+              },
+              "default": "'light'",
+              "description": "Whether the overlay uses a light or dark contrast treatment.",
+              "fieldName": "overlayTone"
+            },
+            {
+              "name": "floating-icons",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Comma-separated Zinc icon names placed as ambient decoration. At most eight are rendered.",
+              "fieldName": "floatingIcons"
+            },
+            {
+              "name": "paused",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Pauses background motion without changing the selected motion treatment.",
+              "fieldName": "paused"
+            }
+          ],
+          "superclass": {
+            "name": "ZincElement",
+            "module": "/src/internal/zinc-element"
+          },
+          "summary": "Composes a colour, decorative image, image strength, optional motion and contrast overlay behind slotted content.",
+          "tagNameWithoutPrefix": "background",
+          "tagName": "zn-background",
+          "customElement": true,
+          "jsDoc": "/**\n * @summary Composes a colour, decorative image, image strength, optional motion and contrast overlay behind slotted content.\n *\n * @documentation https://zinc.style/components/background\n * @status experimental\n * @since 1.0\n *\n * @dependency zn-icon\n *\n * @slot - Content displayed above the background layers.\n *\n * @csspart base - The component's full-size background canvas.\n * @csspart image - The decorative background image.\n * @csspart overlay - The contrast overlay between the image and content.\n * @csspart floating-icons - The non-interactive layer containing the floating icons.\n * @csspart floating-icon - Each floating `zn-icon`.\n * @csspart content - The wrapper around the default slot.\n *\n * @cssproperty --zn-background-color - Fallback colour when the `color` attribute is not set.\n * @cssproperty --zn-background-image-position - Position of the background image. Defaults to `center`.\n * @cssproperty --zn-background-overlay-angle - Direction of the overlay gradient. Defaults to `110deg`.\n * @cssproperty --zn-background-floating-icon-color - Colour of the floating icons. Defaults to `currentColor`.\n */",
+          "documentation": "https://zinc.style/components/background",
+          "status": "experimental",
+          "since": "1.0",
+          "dependencies": [
+            "zn-icon"
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "ZnBackground",
+            "module": "components/background/background.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "components/button-group/button-group.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "ZnButtonGroup",
+          "cssProperties": [
+            {
+              "description": "Use flex-grow to fill available space.",
+              "name": "--grow"
+            },
+            {
+              "description": "Justify content at the start of the flex space.",
+              "name": "--start"
+            }
+          ],
+          "cssParts": [
+            {
+              "description": "The component's base wrapper.",
+              "name": "base"
+            }
+          ],
+          "slots": [
+            {
+              "description": "The default slot.",
+              "name": ""
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "direction",
+              "type": {
+                "text": "'horizontal' | 'vertical'"
+              },
+              "default": "'horizontal'",
+              "attribute": "direction"
+            },
+            {
+              "kind": "field",
+              "name": "grow",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "grow"
+            },
+            {
+              "kind": "field",
+              "name": "wrap",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "wrap"
+            },
+            {
+              "kind": "field",
+              "name": "start",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "start"
+            },
+            {
+              "kind": "field",
+              "name": "gap",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "gap"
+            },
+            {
+              "kind": "field",
+              "name": "defaultSlot",
+              "type": {
+                "text": "HTMLSlotElement"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "handleSlotChange",
+              "privacy": "private"
+            }
+          ],
+          "events": [
+            {
+              "description": "Emitted as an example.",
+              "name": "zn-event-name"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "direction",
+              "type": {
+                "text": "'horizontal' | 'vertical'"
+              },
+              "default": "'horizontal'",
+              "fieldName": "direction"
+            },
+            {
+              "name": "grow",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "grow"
+            },
+            {
+              "name": "wrap",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "wrap"
+            },
+            {
+              "name": "start",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "start"
+            },
+            {
+              "name": "gap",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "gap"
+            }
+          ],
+          "superclass": {
+            "name": "ZincElement",
+            "module": "/src/internal/zinc-element"
+          },
+          "summary": "Short summary of the component's intended use.",
+          "tagNameWithoutPrefix": "button-group",
+          "tagName": "zn-button-group",
+          "customElement": true,
+          "jsDoc": "/**\n * @summary Short summary of the component's intended use.\n * @documentation https://zinc.style/components/button-group\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 *\n * @csspart base - The component's base wrapper.\n *\n * @cssproperty --grow - Use flex-grow to fill available space.\n * @cssproperty --start - Justify content at the start of the flex space.\n */",
+          "documentation": "https://zinc.style/components/button-group",
+          "status": "experimental",
+          "since": "1.0",
+          "dependencies": [
+            "zn-example"
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "ZnButtonGroup",
+            "module": "components/button-group/button-group.js"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "components/button/button.js",
@@ -2417,171 +2582,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "components/button-group/button-group.js",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "",
-          "name": "ZnButtonGroup",
-          "cssProperties": [
-            {
-              "description": "Use flex-grow to fill available space.",
-              "name": "--grow"
-            },
-            {
-              "description": "Justify content at the start of the flex space.",
-              "name": "--start"
-            }
-          ],
-          "cssParts": [
-            {
-              "description": "The component's base wrapper.",
-              "name": "base"
-            }
-          ],
-          "slots": [
-            {
-              "description": "The default slot.",
-              "name": ""
-            }
-          ],
-          "members": [
-            {
-              "kind": "field",
-              "name": "direction",
-              "type": {
-                "text": "'horizontal' | 'vertical'"
-              },
-              "default": "'horizontal'",
-              "attribute": "direction"
-            },
-            {
-              "kind": "field",
-              "name": "grow",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "attribute": "grow"
-            },
-            {
-              "kind": "field",
-              "name": "wrap",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "attribute": "wrap"
-            },
-            {
-              "kind": "field",
-              "name": "start",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "attribute": "start"
-            },
-            {
-              "kind": "field",
-              "name": "gap",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "attribute": "gap"
-            },
-            {
-              "kind": "field",
-              "name": "defaultSlot",
-              "type": {
-                "text": "HTMLSlotElement"
-              }
-            },
-            {
-              "kind": "method",
-              "name": "handleSlotChange",
-              "privacy": "private"
-            }
-          ],
-          "events": [
-            {
-              "description": "Emitted as an example.",
-              "name": "zn-event-name"
-            }
-          ],
-          "attributes": [
-            {
-              "name": "direction",
-              "type": {
-                "text": "'horizontal' | 'vertical'"
-              },
-              "default": "'horizontal'",
-              "fieldName": "direction"
-            },
-            {
-              "name": "grow",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "fieldName": "grow"
-            },
-            {
-              "name": "wrap",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "fieldName": "wrap"
-            },
-            {
-              "name": "start",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "fieldName": "start"
-            },
-            {
-              "name": "gap",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "fieldName": "gap"
-            }
-          ],
-          "superclass": {
-            "name": "ZincElement",
-            "module": "/src/internal/zinc-element"
-          },
-          "summary": "Short summary of the component's intended use.",
-          "tagNameWithoutPrefix": "button-group",
-          "tagName": "zn-button-group",
-          "customElement": true,
-          "jsDoc": "/**\n * @summary Short summary of the component's intended use.\n * @documentation https://zinc.style/components/button-group\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 *\n * @csspart base - The component's base wrapper.\n *\n * @cssproperty --grow - Use flex-grow to fill available space.\n * @cssproperty --start - Justify content at the start of the flex space.\n */",
-          "documentation": "https://zinc.style/components/button-group",
-          "status": "experimental",
-          "since": "1.0",
-          "dependencies": [
-            "zn-example"
-          ]
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "default",
-          "declaration": {
-            "name": "ZnButtonGroup",
-            "module": "components/button-group/button-group.js"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "components/button-menu/button-menu.js",
@@ -16550,13 +16550,11 @@
             },
             {
               "kind": "field",
-              "name": "tracked",
-              "type": {
-                "text": "HTMLElement | null"
-              },
+              "name": "clipped",
               "privacy": "private",
-              "default": "null",
-              "description": "The scroller the label is tracked against by hand; null while native sticky is enough."
+              "readonly": true,
+              "default": "new Map<HTMLElement, { x: string; y: string }>()",
+              "description": "The scroll containers we have clipped, against the inline overflow each carried before."
             },
             {
               "kind": "field",
@@ -16567,24 +16565,6 @@
               "privacy": "private",
               "default": "0"
             },
-            {
-              "kind": "field",
-              "name": "rebind",
-              "type": {
-                "text": "boolean"
-              },
-              "privacy": "private",
-              "default": "false"
-            },
-            {
-              "kind": "field",
-              "name": "offset",
-              "type": {
-                "text": "number"
-              },
-              "privacy": "private",
-              "default": "0"
-            },
             {
               "kind": "field",
               "name": "resizeObserver",
@@ -16607,84 +16587,53 @@
               "kind": "method",
               "name": "schedule",
               "privacy": "private",
-              "parameters": [
-                {
-                  "name": "rebind",
-                  "default": "false",
-                  "type": {
-                    "text": "boolean"
-                  }
-                }
-              ],
-              "description": "Coalesces scroll and resize work into one frame, and out of the ResizeObserver callback."
+              "description": "Coalesces resize work into one frame, and out of the ResizeObserver callback."
+            },
+            {
+              "kind": "field",
+              "name": "onViewportResize",
+              "privacy": "private",
+              "readonly": true
             },
             {
               "kind": "method",
-              "name": "findScroller",
+              "name": "freeSticky",
               "privacy": "private",
-              "description": "Native sticky only follows the nearest scroll container. Where that container isn't the one\nthe user actually scrolls — a `zn-panel` body sized to its content inside a scrolling\nslideout, say — the label never moves, so it gets translated by hand instead."
+              "description": "Native sticky anchors to the nearest scroll container, even one that cannot scroll — a `zn-panel` body sized to\nits content, say — where it then holds the label still for the whole scroll. `overflow: clip` clips without\nmaking a scroll container, so clipping those takes them out of sticky's search and the label follows the box the\nuser actually scrolls, moved by the compositor rather than by hand."
             },
             {
               "kind": "method",
-              "name": "trackScroller",
+              "name": "clip",
               "privacy": "private",
               "parameters": [
                 {
-                  "name": "scroller",
+                  "name": "element",
                   "type": {
-                    "text": "HTMLElement | null"
+                    "text": "HTMLElement"
                   }
                 }
               ]
             },
             {
               "kind": "method",
-              "name": "scrollTarget",
+              "name": "release",
               "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "EventTarget | null"
-                }
-              },
               "parameters": [
                 {
-                  "name": "scroller",
+                  "name": "elements",
                   "type": {
-                    "text": "HTMLElement | null"
+                    "text": "HTMLElement[]"
                   }
                 }
-              ],
-              "description": "The document scrolls through the window, every other scroller reports its own events."
-            },
-            {
-              "kind": "field",
-              "name": "onScroll",
-              "privacy": "private",
-              "readonly": true
-            },
-            {
-              "kind": "field",
-              "name": "onViewportResize",
-              "privacy": "private",
-              "readonly": true
-            },
-            {
-              "kind": "method",
-              "name": "positionLabel",
-              "privacy": "private"
+              ]
             },
             {
               "kind": "method",
-              "name": "nearestScrollContainer",
+              "name": "isStickyAnchor",
               "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "HTMLElement | null"
-                }
-              },
               "parameters": [
                 {
-                  "name": "from",
+                  "name": "element",
                   "type": {
                     "text": "HTMLElement"
                   }
@@ -16694,32 +16643,26 @@
             },
             {
               "kind": "method",
-              "name": "scrollingAncestor",
+              "name": "isScrollContainer",
               "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "HTMLElement | null"
-                }
-              },
               "parameters": [
                 {
-                  "name": "from",
+                  "name": "overflow",
                   "type": {
-                    "text": "HTMLElement"
+                    "text": "string"
                   }
                 }
-              ],
-              "description": "The nearest ancestor the user can actually scroll, falling back to the document."
+              ]
             },
             {
               "kind": "method",
-              "name": "isScrollContainer",
+              "name": "overflows",
               "privacy": "private",
               "parameters": [
                 {
-                  "name": "overflow",
+                  "name": "element",
                   "type": {
-                    "text": "string"
+                    "text": "HTMLElement"
                   }
                 }
               ]
@@ -28329,6 +28272,230 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "components/pagination/pagination.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "ZnPagination",
+          "members": [
+            {
+              "kind": "field",
+              "name": "limit",
+              "type": {
+                "text": "number"
+              },
+              "default": "10",
+              "attribute": "limit",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "total",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "attribute": "total",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "page",
+              "type": {
+                "text": "number"
+              },
+              "default": "1",
+              "attribute": "page",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "uri",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "attribute": "uri",
+              "reflects": true
+            },
+            {
+              "kind": "method",
+              "name": "_createLink",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "page",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_calculatePages",
+              "privacy": "protected"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "limit",
+              "type": {
+                "text": "number"
+              },
+              "default": "10",
+              "fieldName": "limit"
+            },
+            {
+              "name": "total",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "fieldName": "total"
+            },
+            {
+              "name": "page",
+              "type": {
+                "text": "number"
+              },
+              "default": "1",
+              "fieldName": "page"
+            },
+            {
+              "name": "uri",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "fieldName": "uri"
+            }
+          ],
+          "superclass": {
+            "name": "ZincElement",
+            "module": "/src/internal/zinc-element"
+          },
+          "summary": "Pagination component for navigating through pages of content.",
+          "tagNameWithoutPrefix": "pagination",
+          "tagName": "zn-pagination",
+          "customElement": true,
+          "jsDoc": "/**\n * @summary Pagination component for navigating through pages of content.\n * @documentation https://zinc.style/components/pagination\n * @status experimental\n * @since 1.0\n */",
+          "documentation": "https://zinc.style/components/pagination",
+          "status": "experimental",
+          "since": "1.0"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "ZnPagination",
+            "module": "components/pagination/pagination.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "components/pane/pane.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "ZnPane",
+          "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": "flush",
+              "type": {
+                "text": "boolean"
+              },
+              "attribute": "flush"
+            },
+            {
+              "kind": "field",
+              "name": "_header",
+              "type": {
+                "text": "HTMLElement | null"
+              },
+              "privacy": "protected",
+              "default": "null"
+            }
+          ],
+          "events": [
+            {
+              "description": "Emitted as an example.",
+              "name": "zn-event-name"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "flush",
+              "type": {
+                "text": "boolean"
+              },
+              "fieldName": "flush"
+            }
+          ],
+          "superclass": {
+            "name": "ZincElement",
+            "module": "/src/internal/zinc-element"
+          },
+          "summary": "Short summary of the component's intended use.",
+          "tagNameWithoutPrefix": "pane",
+          "tagName": "zn-pane",
+          "customElement": true,
+          "jsDoc": "/**\n * @summary Short summary of the component's intended use.\n * @documentation https://zinc.style/components/pane\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/pane",
+          "status": "experimental",
+          "since": "1.0",
+          "dependencies": [
+            "zn-example"
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "ZnPane",
+            "module": "components/pane/pane.js"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "components/page-nav/page-nav.js",
@@ -29603,230 +29770,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "components/pagination/pagination.js",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "",
-          "name": "ZnPagination",
-          "members": [
-            {
-              "kind": "field",
-              "name": "limit",
-              "type": {
-                "text": "number"
-              },
-              "default": "10",
-              "attribute": "limit",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "total",
-              "type": {
-                "text": "number"
-              },
-              "default": "0",
-              "attribute": "total",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "page",
-              "type": {
-                "text": "number"
-              },
-              "default": "1",
-              "attribute": "page",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "uri",
-              "type": {
-                "text": "string"
-              },
-              "default": "\"\"",
-              "attribute": "uri",
-              "reflects": true
-            },
-            {
-              "kind": "method",
-              "name": "_createLink",
-              "privacy": "protected",
-              "return": {
-                "type": {
-                  "text": "string"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "page",
-                  "type": {
-                    "text": "number"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "_calculatePages",
-              "privacy": "protected"
-            }
-          ],
-          "attributes": [
-            {
-              "name": "limit",
-              "type": {
-                "text": "number"
-              },
-              "default": "10",
-              "fieldName": "limit"
-            },
-            {
-              "name": "total",
-              "type": {
-                "text": "number"
-              },
-              "default": "0",
-              "fieldName": "total"
-            },
-            {
-              "name": "page",
-              "type": {
-                "text": "number"
-              },
-              "default": "1",
-              "fieldName": "page"
-            },
-            {
-              "name": "uri",
-              "type": {
-                "text": "string"
-              },
-              "default": "\"\"",
-              "fieldName": "uri"
-            }
-          ],
-          "superclass": {
-            "name": "ZincElement",
-            "module": "/src/internal/zinc-element"
-          },
-          "summary": "Pagination component for navigating through pages of content.",
-          "tagNameWithoutPrefix": "pagination",
-          "tagName": "zn-pagination",
-          "customElement": true,
-          "jsDoc": "/**\n * @summary Pagination component for navigating through pages of content.\n * @documentation https://zinc.style/components/pagination\n * @status experimental\n * @since 1.0\n */",
-          "documentation": "https://zinc.style/components/pagination",
-          "status": "experimental",
-          "since": "1.0"
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "default",
-          "declaration": {
-            "name": "ZnPagination",
-            "module": "components/pagination/pagination.js"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "components/pane/pane.js",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "",
-          "name": "ZnPane",
-          "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": "flush",
-              "type": {
-                "text": "boolean"
-              },
-              "attribute": "flush"
-            },
-            {
-              "kind": "field",
-              "name": "_header",
-              "type": {
-                "text": "HTMLElement | null"
-              },
-              "privacy": "protected",
-              "default": "null"
-            }
-          ],
-          "events": [
-            {
-              "description": "Emitted as an example.",
-              "name": "zn-event-name"
-            }
-          ],
-          "attributes": [
-            {
-              "name": "flush",
-              "type": {
-                "text": "boolean"
-              },
-              "fieldName": "flush"
-            }
-          ],
-          "superclass": {
-            "name": "ZincElement",
-            "module": "/src/internal/zinc-element"
-          },
-          "summary": "Short summary of the component's intended use.",
-          "tagNameWithoutPrefix": "pane",
-          "tagName": "zn-pane",
-          "customElement": true,
-          "jsDoc": "/**\n * @summary Short summary of the component's intended use.\n * @documentation https://zinc.style/components/pane\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/pane",
-          "status": "experimental",
-          "since": "1.0",
-          "dependencies": [
-            "zn-example"
-          ]
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "default",
-          "declaration": {
-            "name": "ZnPane",
-            "module": "components/pane/pane.js"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "components/panel/panel.js",
@@ -30623,502 +30566,644 @@
     },
     {
       "kind": "javascript-module",
-      "path": "components/preview-frame/preview-frame.js",
+      "path": "components/priority-list/priority-list.js",
       "declarations": [
         {
           "kind": "class",
           "description": "",
-          "name": "ZnPreviewFrame",
+          "name": "ZnPriorityList",
           "cssProperties": [
             {
-              "description": "Spacing of the backdrop dot grid (`backdrop=\"dots\"`). Defaults to 20px.",
-              "name": "--zn-preview-frame-dot-spacing"
+              "description": "The gap between list items. Defaults to `var(--zn-spacing-2x-small)`.",
+              "name": "--zn-priority-list-item-gap"
             },
             {
-              "description": "Opacity of the backdrop dots (`backdrop=\"dots\"`). Defaults to 0.08.",
-              "name": "--zn-preview-frame-dot-opacity"
+              "description": "The padding inside each item. Defaults to `var(--zn-spacing-small) var(--zn-spacing-medium)`.",
+              "name": "--zn-priority-list-item-padding"
+            },
+            {
+              "description": "The gap between an item's slotted actions. Defaults to `var(--zn-spacing-x-small)`.",
+              "name": "--zn-priority-list-actions-gap"
+            },
+            {
+              "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 device-width wrapper around the iframe.",
-              "name": "stage"
+              "description": "The label wrapper.",
+              "name": "form-control-label"
             },
             {
-              "description": "The preview iframe.",
-              "name": "iframe"
+              "description": "The input area wrapper.",
+              "name": "form-control-input"
             },
             {
-              "description": "The error overlay.",
-              "name": "error"
+              "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 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": "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": "src",
+              "name": "dependencies",
               "type": {
-                "text": "string"
+                "text": "object"
               },
-              "default": "''",
-              "description": "URL of the preview shell page (tokened embed URL).",
-              "attribute": "src"
+              "static": true,
+              "default": "{ 'zn-icon': ZnIcon, }"
             },
             {
               "kind": "field",
-              "name": "frameOrigin",
+              "name": "formControlController",
+              "privacy": "protected",
+              "readonly": true,
+              "default": "new FormControlController(this, { value: (control: ZnPriorityList) => { return JSON.stringify(control.getPriorityMap()); }, defaultValue: (control: ZnPriorityList) => control.defaultValue, // A form reset passes defaultValue straight back in, so this has to accept the // key array as well as the serialised value other callers set. setValue: (control: ZnPriorityList, value: string | string[]) => { if (!value || (Array.isArray(value) && value.length === 0)) return; const keys: unknown = Array.isArray(value) ? value : safeParse(value); if (Array.isArray(keys) && keys.every((item: unknown): item is string => typeof item === 'string')) { control.value = keys as string[]; } }, })"
+            },
+            {
+              "kind": "field",
+              "name": "hasSlotController",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new HasSlotController(this, 'help-text', 'label')"
+            },
+            {
+              "kind": "field",
+              "name": "hiddenInputsContainer",
               "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "description": "Expected origin of the iframe; all postMessage traffic is checked against it.",
-              "attribute": "frame-origin"
+                "text": "HTMLDivElement"
+              }
             },
             {
               "kind": "field",
-              "name": "dataUri",
+              "name": "name",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "description": "Endpoint returning the hp-preview:config payload JSON. The console proxy rewrites this attribute to an app-prefixed path for proper fetch resolution.",
-              "attribute": "data-uri"
+              "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": "watch",
+              "name": "value",
               "type": {
-                "text": "string"
+                "text": "string[]"
               },
-              "default": "'form[data-auto-save]'",
-              "description": "Selector (resolved against the component's root node) for the forms to watch.\nDefaults to only forms explicitly opted in via a `data-auto-save` attribute —\nunmarked forms keep normal submit behavior and are never intercepted,\nauto-saved, or used to trigger a preview refresh. Override to widen the scope.",
-              "attribute": "watch"
+              "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": "refreshOn",
+              "name": "_value",
               "type": {
-                "text": "string"
+                "text": "string[]"
               },
-              "default": "'form'",
-              "description": "Selector for forms whose saves are left to the shell but should still\nrefresh the preview. These are never intercepted: the shell submits them\n(so its own response handling — alerts, refreshes — runs as normal) and the\npreview re-fetches its config once the shell reports the save complete.\nMatched by delegation on the shell's bubbled `complete` event rather than\nby attaching to the forms themselves, so a save anywhere on the page\nrefreshes the preview — including forms in a different DOM root, e.g. a\npage-level form saved while the preview sits inside a tab panel's shadow\nroot (a page's Template select lives on one tab, its preview on another).\nSet empty to disable.",
-              "attribute": "refresh-on"
+              "privacy": "private",
+              "default": "[]"
             },
             {
               "kind": "field",
-              "name": "debounce",
+              "name": "defaultValue",
               "type": {
-                "text": "number"
+                "text": "string[]"
               },
-              "default": "400",
-              "description": "Debounce in ms between a form change and its auto-save.",
-              "attribute": "debounce"
+              "default": "[]"
             },
             {
               "kind": "field",
-              "name": "zoom",
+              "name": "label",
               "type": {
-                "text": "number"
+                "text": "string"
               },
-              "default": "1",
-              "description": "Zooms the previewed page out (0–1]. The frame always fills the panel;\nzoom shrinks the content browser-style, so 0.4 shows the page at 40%\nsize with correspondingly more of it visible. 1 = natural size.\nIgnored when `fill` is set.",
-              "attribute": "zoom"
+              "default": "''",
+              "description": "The component's label. Required for proper accessibility.",
+              "attribute": "label"
             },
             {
               "kind": "field",
-              "name": "minHeight",
+              "name": "labelTooltip",
               "type": {
-                "text": "number"
+                "text": "string"
               },
-              "default": "480",
-              "description": "The visible height (in CSS pixels) of the preview panel. Fixed rather\nthan measured, because a measured height would feed back into the\nscaled iframe's layout box and grow unbounded. With `fill` set, this\nbecomes a `min-height` floor instead of the height.",
-              "attribute": "min-height"
+              "default": "''",
+              "description": "Text that appears in a tooltip next to the label.",
+              "attribute": "label-tooltip"
             },
             {
               "kind": "field",
-              "name": "fill",
+              "name": "helpText",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "description": "Fills the panel's own column height instead of using a fixed\n`min-height` pixel height — for hosts (like zn-theme-editor) whose\nlayout already stretches the column to match a taller sibling.\n`zoom` is ignored when set: its oversize maths depends on a known\npixel height, which `fill` deliberately doesn't have.",
-              "attribute": "fill"
+              "default": "''",
+              "description": "Help text that describes how to use the component.",
+              "attribute": "help-text"
             },
             {
               "kind": "field",
-              "name": "device",
+              "name": "form",
               "type": {
-                "text": "PreviewFrameDevice"
+                "text": "string"
               },
-              "default": "'desktop'",
-              "description": "Constrains and centres the preview to a device width: `desktop` (100%),\n`tablet` (768px) or `mobile` (390px). The iframe element itself is\nnarrowed, so the embedded page's own media queries fire.",
-              "attribute": "device",
+              "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": "backdrop",
+              "name": "size",
               "type": {
-                "text": "'dots' | 'panel'"
+                "text": "'small' | 'medium' | 'large'"
               },
-              "default": "'dots'",
-              "description": "Backdrop behind the stage: `dots` (default) is the canvas dot grid; `panel` is a plain `rgb(var(--zn-panel))` fill.",
-              "attribute": "backdrop",
+              "default": "'medium'",
+              "description": "The size of the list items.",
+              "attribute": "size",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "interactive",
+              "name": "disabled",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Lets pointer input through to the embedded page. The preview is inert by\ndefault: clicks never reach the frame, so the previewed page can't be\nnavigated or submitted from inside the preview. Cross-origin content can't\nbe reached from here to cancel its own handlers, so this blocks pointer\ninput entirely — hover goes with it. Scrolling doesn't: an overflowing\npage is scrolled by the panel rather than by the frame (see _contentHeight).\n\nSet, the frame becomes a real viewport instead: it stays the panel's own\nheight and the embed scrolls itself, so there is one scrollbar rather than\na panel scrolling an oversized frame, and the embed's viewport-relative\nlayout (`100vh`, `position: fixed`, sticky headers) sizes to what's on\nscreen. _contentHeight is ignored while this is set.",
-              "attribute": "interactive",
+              "description": "Whether the priority list is disabled.",
+              "attribute": "disabled",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "frame",
-              "type": {
-                "text": "HTMLIFrameElement"
-              }
-            },
-            {
-              "kind": "field",
-              "name": "error",
+              "name": "required",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "privacy": "private",
-              "default": "''"
+              "default": "false",
+              "description": "Ensures the form control has a value before allowing submission.",
+              "attribute": "required",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "_contentHeight",
+              "name": "priorityStart",
               "type": {
                 "text": "number"
               },
-              "privacy": "private",
-              "default": "0",
-              "description": "Height of the embedded page's content, when it's known: reported by the\nembed (`height` on hp-preview:rendered, or an hp-preview:height message) or\nmeasured directly for a same-origin embed. The frame is laid out at this\nheight rather than the panel's, so the page never scrolls inside the frame\n— the panel scrolls instead, which is what makes an overflowing preview\nreachable while pointer input to the frame is blocked. 0 = unknown, and the\nframe falls back to filling the panel. Kept up to date either way, but only\nlaid out when the frame is inert: an `interactive` frame scrolls itself."
+              "default": "1",
+              "description": "The starting priority number. Defaults to 1.",
+              "attribute": "priority-start"
             },
             {
               "kind": "field",
-              "name": "_generation",
+              "name": "formAction",
               "type": {
-                "text": "number"
+                "text": "string"
               },
-              "privacy": "private",
-              "default": "0"
+              "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": "_theme",
+              "name": "order",
               "type": {
-                "text": "Record<string, unknown> | undefined"
+                "text": "string"
               },
-              "privacy": "private"
+              "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": "_contentObserver",
+              "name": "draggedKey",
               "type": {
-                "text": "ResizeObserver | undefined"
+                "text": "string | null"
               },
-              "privacy": "private"
-            },
-            {
-              "kind": "field",
-              "name": "_watchedForms",
               "privacy": "private",
-              "readonly": true,
-              "default": "new Set<HTMLFormElement>()"
+              "default": "null"
             },
             {
               "kind": "field",
-              "name": "_debounceTimers",
+              "name": "isDragging",
+              "type": {
+                "text": "boolean"
+              },
               "privacy": "private",
-              "readonly": true,
-              "default": "new Map<HTMLFormElement, number>()"
+              "default": "false"
             },
             {
               "kind": "field",
-              "name": "_shellSaveRoots",
+              "name": "dragOverKey",
               "type": {
-                "text": "EventTarget[]"
+                "text": "string | null"
               },
               "privacy": "private",
-              "default": "[]"
+              "default": "null"
             },
             {
               "kind": "field",
-              "name": "_lastShellSave",
+              "name": "validity",
               "type": {
-                "text": "Event | undefined"
+                "text": "ValidityState"
               },
-              "privacy": "private"
+              "description": "Gets the validity state object.",
+              "readonly": true
             },
             {
               "kind": "field",
-              "name": "_formObserver",
-              "privacy": "private",
-              "readonly": true,
-              "default": "new MutationController(this, { target: null, config: {subtree: true, childList: true}, callback: () => this._attachForms(), })"
+              "name": "validationMessage",
+              "type": {
+                "text": "string"
+              },
+              "description": "Gets the validation message.",
+              "readonly": true
             },
             {
-              "kind": "field",
-              "name": "_onMessage",
+              "kind": "method",
+              "name": "_initializeOrderFromSlot",
               "privacy": "private",
-              "readonly": true
+              "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": "method",
-              "name": "_applyContentHeight",
+              "name": "_getSlottedItems",
               "privacy": "private",
-              "parameters": [
-                {
-                  "name": "height",
-                  "type": {
-                    "text": "unknown"
-                  }
+              "return": {
+                "type": {
+                  "text": "HTMLElement[]"
                 }
-              ]
+              },
+              "description": "Gets all direct children with a `value` attribute (excluding those in reserved slots)."
             },
             {
               "kind": "method",
-              "name": "_resetContentHeight",
-              "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": "_onFrameLoad",
-              "privacy": "private",
-              "readonly": true
+              "kind": "method",
+              "name": "getPriorityMap",
+              "return": {
+                "type": {
+                  "text": "PriorityItem[]"
+                }
+              },
+              "description": "Returns the priority map: an array of { key, priority } objects."
             },
             {
               "kind": "method",
-              "name": "refresh",
-              "description": "Re-fetches the payload and pushes a fresh config to the preview."
+              "name": "_syncHiddenInputs",
+              "privacy": "private",
+              "description": "Syncs hidden inputs so form data includes priority values."
             },
             {
               "kind": "method",
-              "name": "setTheme",
+              "name": "_moveItem",
+              "privacy": "private",
               "parameters": [
                 {
-                  "name": "theme",
+                  "name": "fromIndex",
                   "type": {
-                    "text": "Record<string, unknown>"
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "toIndex",
+                  "type": {
+                    "text": "number"
                   }
                 }
               ],
-              "description": "Pushes a theme payload into the preview. The payload is retained and\nre-posted after every ready handshake, so a frame reload doesn't drop an\nin-progress theme."
+              "description": "Moves an item from one index to another."
             },
             {
               "kind": "method",
-              "name": "_postTheme",
-              "privacy": "private"
+              "name": "_submitForm",
+              "privacy": "private",
+              "description": "Submits the associated form if a `formaction` attribute is set."
             },
             {
               "kind": "method",
-              "name": "_sendConfig",
-              "privacy": "private"
+              "name": "_handleDragStart",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "DragEvent"
+                  }
+                },
+                {
+                  "name": "key",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
             },
             {
               "kind": "method",
-              "name": "_attachForms",
+              "name": "_handleDragEnd",
               "privacy": "private"
             },
-            {
-              "kind": "field",
-              "name": "_onShellSave",
-              "privacy": "private",
-              "readonly": true
-            },
             {
               "kind": "method",
-              "name": "_detachForm",
+              "name": "_handleDragOver",
               "privacy": "private",
               "parameters": [
                 {
-                  "name": "form",
+                  "name": "event",
                   "type": {
-                    "text": "HTMLFormElement"
+                    "text": "DragEvent"
+                  }
+                },
+                {
+                  "name": "key",
+                  "type": {
+                    "text": "string"
                   }
                 }
               ]
             },
             {
-              "kind": "field",
-              "name": "_onChange",
-              "privacy": "private",
-              "readonly": true
-            },
-            {
-              "kind": "field",
-              "name": "_onSubmit",
+              "kind": "method",
+              "name": "_handleDragLeave",
               "privacy": "private",
-              "readonly": true
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "DragEvent"
+                  }
+                },
+                {
+                  "name": "key",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
             },
             {
               "kind": "method",
-              "name": "_save",
+              "name": "_handleDrop",
               "privacy": "private",
               "parameters": [
                 {
-                  "name": "form",
+                  "name": "event",
                   "type": {
-                    "text": "HTMLFormElement"
+                    "text": "DragEvent"
                   }
                 }
               ]
             },
             {
               "kind": "method",
-              "name": "_fail",
+              "name": "_handleKeyDown",
               "privacy": "private",
               "parameters": [
                 {
-                  "name": "message",
+                  "name": "event",
+                  "type": {
+                    "text": "KeyboardEvent"
+                  }
+                },
+                {
+                  "name": "key",
                   "type": {
                     "text": "string"
                   }
                 }
               ]
+            },
+            {
+              "kind": "method",
+              "name": "_handleSlotChange",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "checkValidity",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "description": "Checks for validity but does not show a validation message."
+            },
+            {
+              "kind": "method",
+              "name": "getForm",
+              "return": {
+                "type": {
+                  "text": "HTMLFormElement | null"
+                }
+              },
+              "description": "Gets the associated form, if one exists."
+            },
+            {
+              "kind": "method",
+              "name": "reportValidity",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "description": "Checks for validity and shows the browser's validation message if the control is invalid."
+            },
+            {
+              "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 preview reports a render error or a save fails.",
-              "name": "zn-error"
+              "description": "Emitted when the order of items changes.",
+              "name": "zn-change"
+            },
+            {
+              "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": "src",
+              "name": "name",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "description": "URL of the preview shell page (tokened embed URL).",
-              "fieldName": "src"
+              "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": "frame-origin",
+              "name": "value",
               "type": {
-                "text": "string"
+                "text": "string[]"
               },
-              "default": "''",
-              "description": "Expected origin of the iframe; all postMessage traffic is checked against it.",
-              "fieldName": "frameOrigin"
+              "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": "data-uri",
+              "name": "label",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "description": "Endpoint returning the hp-preview:config payload JSON. The console proxy rewrites this attribute to an app-prefixed path for proper fetch resolution.",
-              "fieldName": "dataUri"
+              "description": "The component's label. Required for proper accessibility.",
+              "fieldName": "label"
             },
             {
-              "name": "watch",
+              "name": "label-tooltip",
               "type": {
                 "text": "string"
               },
-              "default": "'form[data-auto-save]'",
-              "description": "Selector (resolved against the component's root node) for the forms to watch.\nDefaults to only forms explicitly opted in via a `data-auto-save` attribute —\nunmarked forms keep normal submit behavior and are never intercepted,\nauto-saved, or used to trigger a preview refresh. Override to widen the scope.",
-              "fieldName": "watch"
+              "default": "''",
+              "description": "Text that appears in a tooltip next to the label.",
+              "fieldName": "labelTooltip"
             },
             {
-              "name": "refresh-on",
+              "name": "help-text",
               "type": {
                 "text": "string"
               },
-              "default": "'form'",
-              "description": "Selector for forms whose saves are left to the shell but should still\nrefresh the preview. These are never intercepted: the shell submits them\n(so its own response handling — alerts, refreshes — runs as normal) and the\npreview re-fetches its config once the shell reports the save complete.\nMatched by delegation on the shell's bubbled `complete` event rather than\nby attaching to the forms themselves, so a save anywhere on the page\nrefreshes the preview — including forms in a different DOM root, e.g. a\npage-level form saved while the preview sits inside a tab panel's shadow\nroot (a page's Template select lives on one tab, its preview on another).\nSet empty to disable.",
-              "fieldName": "refreshOn"
+              "default": "''",
+              "description": "Help text that describes how to use the component.",
+              "fieldName": "helpText"
             },
             {
-              "name": "debounce",
+              "name": "form",
               "type": {
-                "text": "number"
+                "text": "string"
               },
-              "default": "400",
-              "description": "Debounce in ms between a form change and its auto-save.",
-              "fieldName": "debounce"
+              "default": "''",
+              "description": "Associates the control with a form by id. The form must be in the same document or shadow root.",
+              "fieldName": "form"
             },
             {
-              "name": "zoom",
+              "name": "size",
               "type": {
-                "text": "number"
+                "text": "'small' | 'medium' | 'large'"
               },
-              "default": "1",
-              "description": "Zooms the previewed page out (0–1]. The frame always fills the panel;\nzoom shrinks the content browser-style, so 0.4 shows the page at 40%\nsize with correspondingly more of it visible. 1 = natural size.\nIgnored when `fill` is set.",
-              "fieldName": "zoom"
+              "default": "'medium'",
+              "description": "The size of the list items.",
+              "fieldName": "size"
             },
             {
-              "name": "min-height",
+              "name": "disabled",
               "type": {
-                "text": "number"
+                "text": "boolean"
               },
-              "default": "480",
-              "description": "The visible height (in CSS pixels) of the preview panel. Fixed rather\nthan measured, because a measured height would feed back into the\nscaled iframe's layout box and grow unbounded. With `fill` set, this\nbecomes a `min-height` floor instead of the height.",
-              "fieldName": "minHeight"
+              "default": "false",
+              "description": "Whether the priority list is disabled.",
+              "fieldName": "disabled"
             },
             {
-              "name": "fill",
+              "name": "required",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Fills the panel's own column height instead of using a fixed\n`min-height` pixel height — for hosts (like zn-theme-editor) whose\nlayout already stretches the column to match a taller sibling.\n`zoom` is ignored when set: its oversize maths depends on a known\npixel height, which `fill` deliberately doesn't have.",
-              "fieldName": "fill"
+              "description": "Ensures the form control has a value before allowing submission.",
+              "fieldName": "required"
             },
             {
-              "name": "device",
+              "name": "priority-start",
               "type": {
-                "text": "PreviewFrameDevice"
+                "text": "number"
               },
-              "default": "'desktop'",
-              "description": "Constrains and centres the preview to a device width: `desktop` (100%),\n`tablet` (768px) or `mobile` (390px). The iframe element itself is\nnarrowed, so the embedded page's own media queries fire.",
-              "fieldName": "device"
+              "default": "1",
+              "description": "The starting priority number. Defaults to 1.",
+              "fieldName": "priorityStart"
             },
             {
-              "name": "backdrop",
+              "name": "formaction",
               "type": {
-                "text": "'dots' | 'panel'"
+                "text": "string"
               },
-              "default": "'dots'",
-              "description": "Backdrop behind the stage: `dots` (default) is the canvas dot grid; `panel` is a plain `rgb(var(--zn-panel))` fill.",
-              "fieldName": "backdrop"
+              "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": "interactive",
+              "name": "order",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "description": "Lets pointer input through to the embedded page. The preview is inert by\ndefault: clicks never reach the frame, so the previewed page can't be\nnavigated or submitted from inside the preview. Cross-origin content can't\nbe reached from here to cancel its own handlers, so this blocks pointer\ninput entirely — hover goes with it. Scrolling doesn't: an overflowing\npage is scrolled by the panel rather than by the frame (see _contentHeight).\n\nSet, the frame becomes a real viewport instead: it stays the panel's own\nheight and the embed scrolls itself, so there is one scrollbar rather than\na panel scrolling an oversized frame, and the embed's viewport-relative\nlayout (`100vh`, `position: fixed`, sticky headers) sizes to what's on\nscreen. _contentHeight is ignored while this is set.",
-              "fieldName": "interactive"
+              "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": "Embeds a live preview iframe and drives the hp-preview postMessage\nprotocol: answers the frame's ready handshake with a config payload fetched\nfrom data-uri, auto-saves watched forms on change, refreshes the preview\nafter each save (its own, or a shell-driven save of a `refresh-on` form),\naccepts a theme payload via setTheme() that is retained and replayed\nafter every ready handshake, and grows the frame to a content height the\nembed reports so the panel scrolls an overflowing page.",
-          "tagNameWithoutPrefix": "preview-frame",
-          "tagName": "zn-preview-frame",
+          "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 Embeds a live preview iframe and drives the hp-preview postMessage\n * protocol: answers the frame's ready handshake with a config payload fetched\n * from data-uri, auto-saves watched forms on change, refreshes the preview\n * after each save (its own, or a shell-driven save of a `refresh-on` form),\n * accepts a theme payload via setTheme() that is retained and replayed\n * after every ready handshake, and grows the frame to a content height the\n * embed reports so the panel scrolls an overflowing page.\n *\n * @documentation https://zinc.style/components/preview-frame\n * @status experimental\n * @since 1.0\n *\n * @event zn-error - Emitted when the preview reports a render error or a save fails.\n *\n * @csspart base - The component's base wrapper.\n * @csspart stage - The device-width wrapper around the iframe.\n * @csspart iframe - The preview iframe.\n * @csspart error - The error overlay.\n *\n * @cssproperty --zn-preview-frame-dot-spacing - Spacing of the backdrop dot grid (`backdrop=\"dots\"`). Defaults to 20px.\n * @cssproperty --zn-preview-frame-dot-opacity - Opacity of the backdrop dots (`backdrop=\"dots\"`). Defaults to 0.08.\n */",
-          "documentation": "https://zinc.style/components/preview-frame",
+          "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-actions-gap - The gap between an item's slotted actions. Defaults to `var(--zn-spacing-x-small)`.\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"
+          "since": "1.0",
+          "dependencies": [
+            "zn-icon"
+          ]
         }
       ],
       "exports": [
@@ -31126,825 +31211,683 @@
           "kind": "js",
           "name": "default",
           "declaration": {
-            "name": "ZnPreviewFrame",
-            "module": "components/preview-frame/preview-frame.js"
+            "name": "ZnPriorityList",
+            "module": "components/priority-list/priority-list.js"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "components/priority-list/priority-list.js",
+      "path": "components/progress-bar/progress-bar.js",
       "declarations": [
         {
           "kind": "class",
           "description": "",
-          "name": "ZnPriorityList",
+          "name": "ZnProgressBar",
           "cssProperties": [
             {
-              "description": "The gap between list items. Defaults to `var(--zn-spacing-2x-small)`.",
-              "name": "--zn-priority-list-item-gap"
+              "description": "The color of the progress bar background track.",
+              "name": "--zn-border-color"
             },
             {
-              "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 progress bar fill.",
+              "name": "--zn-progress-bar-color"
             },
             {
-              "description": "The gap between an item's slotted actions. Defaults to `var(--zn-spacing-x-small)`.",
-              "name": "--zn-priority-list-actions-gap"
+              "description": "The color of the caption text.",
+              "name": "--zn-text-heading"
             },
             {
-              "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 progress percentage and description text.",
+              "name": "--zn-text"
             },
             {
-              "description": "The color of the priority number. Defaults to `var(--zn-color-neutral-600)`.",
-              "name": "--zn-priority-list-priority-color"
+              "description": "The spacing between header/footer and the progress bar.",
+              "name": "--zn-spacing-x-small"
             }
           ],
           "cssParts": [
             {
-              "description": "The form control wrapper.",
-              "name": "form-control"
-            },
-            {
-              "description": "The label wrapper.",
-              "name": "form-control-label"
+              "description": "The header container that contains the caption and progress text.",
+              "name": "header"
             },
             {
-              "description": "The input area wrapper.",
-              "name": "form-control-input"
+              "description": "The caption text element.",
+              "name": "caption"
             },
             {
-              "description": "The help text wrapper.",
-              "name": "form-control-help-text"
+              "description": "The progress percentage text element.",
+              "name": "progress"
             },
             {
-              "description": "The list container.",
-              "name": "list"
+              "description": "The SVG element containing the progress bar.",
+              "name": "bar"
             },
             {
-              "description": "An individual list item row.",
-              "name": "item"
+              "description": "The background track of the progress bar.",
+              "name": "track"
             },
             {
-              "description": "The drag handle icon.",
-              "name": "drag-handle"
+              "description": "The filled portion of the progress bar indicating progress.",
+              "name": "fill"
             },
             {
-              "description": "The priority number badge.",
-              "name": "priority"
+              "description": "The footer container that contains the description.",
+              "name": "footer"
             },
             {
-              "description": "The content area of an item.",
-              "name": "content"
+              "description": "The description text element.",
+              "name": "info"
             }
           ],
-          "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).",
-              "name": ""
-            },
+          "members": [
             {
-              "description": "The component's label. Required for proper accessibility. Alternatively, use the `label` attribute.",
-              "name": "label"
+              "kind": "field",
+              "name": "caption",
+              "type": {
+                "text": "string | undefined"
+              },
+              "attribute": "caption",
+              "reflects": true
             },
             {
-              "description": "Used to add text displayed in a tooltip next to the label.",
-              "name": "label-tooltip"
+              "kind": "field",
+              "name": "color",
+              "type": {
+                "text": "ProgressBarColor"
+              },
+              "default": "'current'",
+              "attribute": "color",
+              "reflects": true
             },
-            {
-              "description": "Text that describes how to use the component. Alternatively, use the `help-text` attribute.",
-              "name": "help-text"
-            }
-          ],
-          "members": [
             {
               "kind": "field",
-              "name": "dependencies",
+              "name": "description",
               "type": {
-                "text": "object"
+                "text": "string | undefined"
               },
-              "static": true,
-              "default": "{ 'zn-icon': ZnIcon, }"
+              "attribute": "description",
+              "reflects": true
             },
             {
               "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, // A form reset passes defaultValue straight back in, so this has to accept the // key array as well as the serialised value other callers set. setValue: (control: ZnPriorityList, value: string | string[]) => { if (!value || (Array.isArray(value) && value.length === 0)) return; const keys: unknown = Array.isArray(value) ? value : safeParse(value); if (Array.isArray(keys) && keys.every((item: unknown): item is string => typeof item === 'string')) { control.value = keys as string[]; } }, })"
+              "name": "value",
+              "type": {
+                "text": "number | undefined"
+              },
+              "attribute": "value",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "hasSlotController",
-              "privacy": "private",
-              "readonly": true,
-              "default": "new HasSlotController(this, 'help-text', 'label')"
+              "name": "showProgress",
+              "type": {
+                "text": "boolean | undefined"
+              },
+              "attribute": "show-progress",
+              "reflects": true
+            }
+          ],
+          "attributes": [
+            {
+              "name": "caption",
+              "type": {
+                "text": "string | undefined"
+              },
+              "fieldName": "caption"
             },
             {
-              "kind": "field",
-              "name": "hiddenInputsContainer",
+              "name": "color",
               "type": {
-                "text": "HTMLDivElement"
-              }
+                "text": "ProgressBarColor"
+              },
+              "default": "'current'",
+              "fieldName": "color"
             },
             {
-              "kind": "field",
-              "name": "name",
+              "name": "description",
               "type": {
-                "text": "string"
+                "text": "string | undefined"
               },
-              "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"
+              "fieldName": "description"
             },
             {
-              "kind": "field",
               "name": "value",
               "type": {
-                "text": "string[]"
+                "text": "number | undefined"
               },
-              "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"
+              "fieldName": "value"
             },
             {
-              "kind": "field",
-              "name": "_value",
+              "name": "show-progress",
               "type": {
-                "text": "string[]"
+                "text": "boolean | undefined"
               },
-              "privacy": "private",
-              "default": "[]"
+              "fieldName": "showProgress"
+            }
+          ],
+          "superclass": {
+            "name": "ZincElement",
+            "module": "/src/internal/zinc-element"
+          },
+          "summary": "Progress bars provide visual feedback about the completion status of a task or process.",
+          "tagNameWithoutPrefix": "progress-bar",
+          "tagName": "zn-progress-bar",
+          "customElement": true,
+          "jsDoc": "/**\n * @summary Progress bars provide visual feedback about the completion status of a task or process.\n * @documentation https://zinc.style/components/progress-bar\n * @status experimental\n * @since 1.0\n *\n * @csspart header - The header container that contains the caption and progress text.\n * @csspart caption - The caption text element.\n * @csspart progress - The progress percentage text element.\n * @csspart bar - The SVG element containing the progress bar.\n * @csspart track - The background track of the progress bar.\n * @csspart fill - The filled portion of the progress bar indicating progress.\n * @csspart footer - The footer container that contains the description.\n * @csspart info - The description text element.\n *\n * @cssproperty --zn-border-color - The color of the progress bar background track.\n * @cssproperty --zn-progress-bar-color - The color of the progress bar fill.\n * @cssproperty --zn-text-heading - The color of the caption text.\n * @cssproperty --zn-text - The color of the progress percentage and description text.\n * @cssproperty --zn-spacing-x-small - The spacing between header/footer and the progress bar.\n */",
+          "documentation": "https://zinc.style/components/progress-bar",
+          "status": "experimental",
+          "since": "1.0"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "ZnProgressBar",
+            "module": "components/progress-bar/progress-bar.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "components/preview-frame/preview-frame.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "ZnPreviewFrame",
+          "cssProperties": [
+            {
+              "description": "Spacing of the backdrop dot grid (`backdrop=\"dots\"`). Defaults to 20px.",
+              "name": "--zn-preview-frame-dot-spacing"
+            },
+            {
+              "description": "Opacity of the backdrop dots (`backdrop=\"dots\"`). Defaults to 0.08.",
+              "name": "--zn-preview-frame-dot-opacity"
+            }
+          ],
+          "cssParts": [
+            {
+              "description": "The component's base wrapper.",
+              "name": "base"
+            },
+            {
+              "description": "The device-width wrapper around the iframe.",
+              "name": "stage"
             },
+            {
+              "description": "The preview iframe.",
+              "name": "iframe"
+            },
+            {
+              "description": "The error overlay.",
+              "name": "error"
+            }
+          ],
+          "members": [
             {
               "kind": "field",
-              "name": "defaultValue",
+              "name": "src",
               "type": {
-                "text": "string[]"
+                "text": "string"
               },
-              "default": "[]"
+              "default": "''",
+              "description": "URL of the preview shell page (tokened embed URL).",
+              "attribute": "src"
             },
             {
               "kind": "field",
-              "name": "label",
+              "name": "frameOrigin",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "description": "The component's label. Required for proper accessibility.",
-              "attribute": "label"
+              "description": "Expected origin of the iframe; all postMessage traffic is checked against it.",
+              "attribute": "frame-origin"
             },
             {
               "kind": "field",
-              "name": "labelTooltip",
+              "name": "dataUri",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "description": "Text that appears in a tooltip next to the label.",
-              "attribute": "label-tooltip"
+              "description": "Endpoint returning the hp-preview:config payload JSON. The console proxy rewrites this attribute to an app-prefixed path for proper fetch resolution.",
+              "attribute": "data-uri"
             },
             {
               "kind": "field",
-              "name": "helpText",
+              "name": "watch",
               "type": {
                 "text": "string"
               },
-              "default": "''",
-              "description": "Help text that describes how to use the component.",
-              "attribute": "help-text"
+              "default": "'form[data-auto-save]'",
+              "description": "Selector (resolved against the component's root node) for the forms to watch.\nDefaults to only forms explicitly opted in via a `data-auto-save` attribute —\nunmarked forms keep normal submit behavior and are never intercepted,\nauto-saved, or used to trigger a preview refresh. Override to widen the scope.",
+              "attribute": "watch"
             },
             {
               "kind": "field",
-              "name": "form",
+              "name": "refreshOn",
               "type": {
                 "text": "string"
               },
-              "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": "'form'",
+              "description": "Selector for forms whose saves are left to the shell but should still\nrefresh the preview. These are never intercepted: the shell submits them\n(so its own response handling — alerts, refreshes — runs as normal) and the\npreview re-fetches its config once the shell reports the save complete.\nMatched by delegation on the shell's bubbled `complete` event rather than\nby attaching to the forms themselves, so a save anywhere on the page\nrefreshes the preview — including forms in a different DOM root, e.g. a\npage-level form saved while the preview sits inside a tab panel's shadow\nroot (a page's Template select lives on one tab, its preview on another).\nSet empty to disable.",
+              "attribute": "refresh-on"
             },
             {
               "kind": "field",
-              "name": "size",
+              "name": "debounce",
               "type": {
-                "text": "'small' | 'medium' | 'large'"
+                "text": "number"
               },
-              "default": "'medium'",
-              "description": "The size of the list items.",
-              "attribute": "size",
-              "reflects": true
+              "default": "400",
+              "description": "Debounce in ms between a form change and its auto-save.",
+              "attribute": "debounce"
             },
             {
               "kind": "field",
-              "name": "disabled",
+              "name": "zoom",
               "type": {
-                "text": "boolean"
+                "text": "number"
               },
-              "default": "false",
-              "description": "Whether the priority list is disabled.",
-              "attribute": "disabled",
-              "reflects": true
+              "default": "1",
+              "description": "Zooms the previewed page out (0–1]. The frame always fills the panel;\nzoom shrinks the content browser-style, so 0.4 shows the page at 40%\nsize with correspondingly more of it visible. 1 = natural size.\nIgnored when `fill` is set.",
+              "attribute": "zoom"
             },
             {
               "kind": "field",
-              "name": "required",
+              "name": "minHeight",
+              "type": {
+                "text": "number"
+              },
+              "default": "480",
+              "description": "The visible height (in CSS pixels) of the preview panel. Fixed rather\nthan measured, because a measured height would feed back into the\nscaled iframe's layout box and grow unbounded. With `fill` set, this\nbecomes a `min-height` floor instead of the height.",
+              "attribute": "min-height"
+            },
+            {
+              "kind": "field",
+              "name": "fill",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Ensures the form control has a value before allowing submission.",
-              "attribute": "required",
-              "reflects": true
+              "description": "Fills the panel's own column height instead of using a fixed\n`min-height` pixel height — for hosts (like zn-theme-editor) whose\nlayout already stretches the column to match a taller sibling.\n`zoom` is ignored when set: its oversize maths depends on a known\npixel height, which `fill` deliberately doesn't have.",
+              "attribute": "fill"
             },
             {
               "kind": "field",
-              "name": "priorityStart",
+              "name": "device",
               "type": {
-                "text": "number"
+                "text": "PreviewFrameDevice"
               },
-              "default": "1",
-              "description": "The starting priority number. Defaults to 1.",
-              "attribute": "priority-start"
+              "default": "'desktop'",
+              "description": "Constrains and centres the preview to a device width: `desktop` (100%),\n`tablet` (768px) or `mobile` (390px). The iframe element itself is\nnarrowed, so the embedded page's own media queries fire.",
+              "attribute": "device",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "formAction",
+              "name": "backdrop",
               "type": {
-                "text": "string"
+                "text": "'dots' | 'panel'"
               },
-              "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": "'dots'",
+              "description": "Backdrop behind the stage: `dots` (default) is the canvas dot grid; `panel` is a plain `rgb(var(--zn-panel))` fill.",
+              "attribute": "backdrop",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "order",
+              "name": "interactive",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "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"
+              "default": "false",
+              "description": "Lets pointer input through to the embedded page. The preview is inert by\ndefault: clicks never reach the frame, so the previewed page can't be\nnavigated or submitted from inside the preview. Cross-origin content can't\nbe reached from here to cancel its own handlers, so this blocks pointer\ninput entirely — hover goes with it. Scrolling doesn't: an overflowing\npage is scrolled by the panel rather than by the frame (see _contentHeight).\n\nSet, the frame becomes a real viewport instead: it stays the panel's own\nheight and the embed scrolls itself, so there is one scrollbar rather than\na panel scrolling an oversized frame, and the embed's viewport-relative\nlayout (`100vh`, `position: fixed`, sticky headers) sizes to what's on\nscreen. _contentHeight is ignored while this is set.",
+              "attribute": "interactive",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "draggedKey",
+              "name": "frame",
               "type": {
-                "text": "string | null"
+                "text": "HTMLIFrameElement"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "error",
+              "type": {
+                "text": "string"
               },
               "privacy": "private",
-              "default": "null"
+              "default": "''"
             },
             {
               "kind": "field",
-              "name": "isDragging",
+              "name": "_contentHeight",
               "type": {
-                "text": "boolean"
+                "text": "number"
               },
               "privacy": "private",
-              "default": "false"
+              "default": "0",
+              "description": "Height of the embedded page's content, when it's known: reported by the\nembed (`height` on hp-preview:rendered, or an hp-preview:height message) or\nmeasured directly for a same-origin embed. The frame is laid out at this\nheight rather than the panel's, so the page never scrolls inside the frame\n— the panel scrolls instead, which is what makes an overflowing preview\nreachable while pointer input to the frame is blocked. 0 = unknown, and the\nframe falls back to filling the panel. Kept up to date either way, but only\nlaid out when the frame is inert: an `interactive` frame scrolls itself."
             },
             {
               "kind": "field",
-              "name": "dragOverKey",
+              "name": "_generation",
               "type": {
-                "text": "string | null"
+                "text": "number"
               },
               "privacy": "private",
-              "default": "null"
+              "default": "0"
             },
             {
               "kind": "field",
-              "name": "validity",
+              "name": "_theme",
               "type": {
-                "text": "ValidityState"
+                "text": "Record<string, unknown> | undefined"
               },
-              "description": "Gets the validity state object.",
-              "readonly": true
+              "privacy": "private"
             },
             {
               "kind": "field",
-              "name": "validationMessage",
+              "name": "_contentObserver",
               "type": {
-                "text": "string"
+                "text": "ResizeObserver | undefined"
               },
-              "description": "Gets the validation message.",
-              "readonly": true
+              "privacy": "private"
             },
             {
-              "kind": "method",
-              "name": "_initializeOrderFromSlot",
+              "kind": "field",
+              "name": "_watchedForms",
               "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."
+              "readonly": true,
+              "default": "new Set<HTMLFormElement>()"
             },
             {
-              "kind": "method",
-              "name": "_getSlottedItems",
+              "kind": "field",
+              "name": "_debounceTimers",
               "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "HTMLElement[]"
-                }
-              },
-              "description": "Gets all direct children with a `value` attribute (excluding those in reserved slots)."
+              "readonly": true,
+              "default": "new Map<HTMLFormElement, number>()"
             },
             {
-              "kind": "method",
-              "name": "_assignSlotNames",
+              "kind": "field",
+              "name": "_shellSaveRoots",
+              "type": {
+                "text": "EventTarget[]"
+              },
               "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."
+              "default": "[]"
             },
             {
-              "kind": "method",
-              "name": "getPriorityMap",
-              "return": {
-                "type": {
-                  "text": "PriorityItem[]"
-                }
+              "kind": "field",
+              "name": "_lastShellSave",
+              "type": {
+                "text": "Event | undefined"
               },
-              "description": "Returns the priority map: an array of { key, priority } objects."
+              "privacy": "private"
             },
             {
-              "kind": "method",
-              "name": "_syncHiddenInputs",
+              "kind": "field",
+              "name": "_formObserver",
               "privacy": "private",
-              "description": "Syncs hidden inputs so form data includes priority values."
+              "readonly": true,
+              "default": "new MutationController(this, { target: null, config: {subtree: true, childList: true}, callback: () => this._attachForms(), })"
+            },
+            {
+              "kind": "field",
+              "name": "_onMessage",
+              "privacy": "private",
+              "readonly": true
             },
             {
               "kind": "method",
-              "name": "_moveItem",
+              "name": "_applyContentHeight",
               "privacy": "private",
               "parameters": [
                 {
-                  "name": "fromIndex",
-                  "type": {
-                    "text": "number"
-                  }
-                },
-                {
-                  "name": "toIndex",
+                  "name": "height",
                   "type": {
-                    "text": "number"
+                    "text": "unknown"
                   }
                 }
-              ],
-              "description": "Moves an item from one index to another."
+              ]
             },
             {
               "kind": "method",
-              "name": "_submitForm",
+              "name": "_resetContentHeight",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_onFrameLoad",
               "privacy": "private",
-              "description": "Submits the associated form if a `formaction` attribute is set."
+              "readonly": true
             },
             {
               "kind": "method",
-              "name": "_handleDragStart",
-              "privacy": "private",
+              "name": "refresh",
+              "description": "Re-fetches the payload and pushes a fresh config to the preview."
+            },
+            {
+              "kind": "method",
+              "name": "setTheme",
               "parameters": [
                 {
-                  "name": "event",
-                  "type": {
-                    "text": "DragEvent"
-                  }
-                },
-                {
-                  "name": "key",
+                  "name": "theme",
                   "type": {
-                    "text": "string"
+                    "text": "Record<string, unknown>"
                   }
                 }
-              ]
+              ],
+              "description": "Pushes a theme payload into the preview. The payload is retained and\nre-posted after every ready handshake, so a frame reload doesn't drop an\nin-progress theme."
             },
             {
               "kind": "method",
-              "name": "_handleDragEnd",
+              "name": "_postTheme",
               "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "_handleDragOver",
-              "privacy": "private",
-              "parameters": [
-                {
-                  "name": "event",
-                  "type": {
-                    "text": "DragEvent"
-                  }
-                },
-                {
-                  "name": "key",
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ]
+              "name": "_sendConfig",
+              "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "_handleDragLeave",
-              "privacy": "private",
-              "parameters": [
-                {
-                  "name": "event",
-                  "type": {
-                    "text": "DragEvent"
-                  }
-                },
-                {
-                  "name": "key",
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ]
+              "name": "_attachForms",
+              "privacy": "private"
             },
             {
-              "kind": "method",
-              "name": "_handleDrop",
+              "kind": "field",
+              "name": "_onShellSave",
               "privacy": "private",
-              "parameters": [
-                {
-                  "name": "event",
-                  "type": {
-                    "text": "DragEvent"
-                  }
-                }
-              ]
+              "readonly": true
             },
             {
               "kind": "method",
-              "name": "_handleKeyDown",
+              "name": "_detachForm",
               "privacy": "private",
               "parameters": [
                 {
-                  "name": "event",
-                  "type": {
-                    "text": "KeyboardEvent"
-                  }
-                },
-                {
-                  "name": "key",
+                  "name": "form",
                   "type": {
-                    "text": "string"
+                    "text": "HTMLFormElement"
                   }
                 }
               ]
             },
             {
-              "kind": "method",
-              "name": "_handleSlotChange",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "checkValidity",
-              "return": {
-                "type": {
-                  "text": "boolean"
-                }
-              },
-              "description": "Checks for validity but does not show a validation message."
+              "kind": "field",
+              "name": "_onChange",
+              "privacy": "private",
+              "readonly": true
             },
             {
-              "kind": "method",
-              "name": "getForm",
-              "return": {
-                "type": {
-                  "text": "HTMLFormElement | null"
-                }
-              },
-              "description": "Gets the associated form, if one exists."
+              "kind": "field",
+              "name": "_onSubmit",
+              "privacy": "private",
+              "readonly": true
             },
             {
               "kind": "method",
-              "name": "reportValidity",
-              "return": {
-                "type": {
-                  "text": "boolean"
+              "name": "_save",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "form",
+                  "type": {
+                    "text": "HTMLFormElement"
+                  }
                 }
-              },
-              "description": "Checks for validity and shows the browser's validation message if the control is invalid."
+              ]
             },
             {
               "kind": "method",
-              "name": "setCustomValidity",
+              "name": "_fail",
+              "privacy": "private",
               "parameters": [
                 {
-                  "name": "_message",
-                  "default": "''"
+                  "name": "message",
+                  "type": {
+                    "text": "string"
+                  }
                 }
-              ],
-              "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"
-            },
-            {
-              "description": "Emitted when items are reordered. Call `getPriorityMap()` on the component to get the updated `{ key: string, priority: number }[]` array.",
-              "name": "zn-reorder"
+              "description": "Emitted when the preview reports a render error or a save fails.",
+              "name": "zn-error"
             }
           ],
           "attributes": [
             {
-              "name": "name",
+              "name": "src",
               "type": {
                 "text": "string"
               },
               "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"
-            },
-            {
-              "name": "value",
-              "type": {
-                "text": "string[]"
-              },
-              "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"
+              "description": "URL of the preview shell page (tokened embed URL).",
+              "fieldName": "src"
             },
             {
-              "name": "label",
+              "name": "frame-origin",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "description": "The component's label. Required for proper accessibility.",
-              "fieldName": "label"
+              "description": "Expected origin of the iframe; all postMessage traffic is checked against it.",
+              "fieldName": "frameOrigin"
             },
             {
-              "name": "label-tooltip",
+              "name": "data-uri",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "description": "Text that appears in a tooltip next to the label.",
-              "fieldName": "labelTooltip"
+              "description": "Endpoint returning the hp-preview:config payload JSON. The console proxy rewrites this attribute to an app-prefixed path for proper fetch resolution.",
+              "fieldName": "dataUri"
             },
             {
-              "name": "help-text",
+              "name": "watch",
               "type": {
                 "text": "string"
               },
-              "default": "''",
-              "description": "Help text that describes how to use the component.",
-              "fieldName": "helpText"
+              "default": "'form[data-auto-save]'",
+              "description": "Selector (resolved against the component's root node) for the forms to watch.\nDefaults to only forms explicitly opted in via a `data-auto-save` attribute —\nunmarked forms keep normal submit behavior and are never intercepted,\nauto-saved, or used to trigger a preview refresh. Override to widen the scope.",
+              "fieldName": "watch"
             },
             {
-              "name": "form",
+              "name": "refresh-on",
               "type": {
                 "text": "string"
               },
-              "default": "''",
-              "description": "Associates the control with a form by id. The form must be in the same document or shadow root.",
-              "fieldName": "form"
-            },
-            {
-              "name": "size",
-              "type": {
-                "text": "'small' | 'medium' | 'large'"
-              },
-              "default": "'medium'",
-              "description": "The size of the list items.",
-              "fieldName": "size"
-            },
-            {
-              "name": "disabled",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Whether the priority list is disabled.",
-              "fieldName": "disabled"
+              "default": "'form'",
+              "description": "Selector for forms whose saves are left to the shell but should still\nrefresh the preview. These are never intercepted: the shell submits them\n(so its own response handling — alerts, refreshes — runs as normal) and the\npreview re-fetches its config once the shell reports the save complete.\nMatched by delegation on the shell's bubbled `complete` event rather than\nby attaching to the forms themselves, so a save anywhere on the page\nrefreshes the preview — including forms in a different DOM root, e.g. a\npage-level form saved while the preview sits inside a tab panel's shadow\nroot (a page's Template select lives on one tab, its preview on another).\nSet empty to disable.",
+              "fieldName": "refreshOn"
             },
             {
-              "name": "required",
+              "name": "debounce",
               "type": {
-                "text": "boolean"
+                "text": "number"
               },
-              "default": "false",
-              "description": "Ensures the form control has a value before allowing submission.",
-              "fieldName": "required"
+              "default": "400",
+              "description": "Debounce in ms between a form change and its auto-save.",
+              "fieldName": "debounce"
             },
             {
-              "name": "priority-start",
+              "name": "zoom",
               "type": {
                 "text": "number"
               },
               "default": "1",
-              "description": "The starting priority number. Defaults to 1.",
-              "fieldName": "priorityStart"
-            },
-            {
-              "name": "formaction",
-              "type": {
-                "text": "string"
-              },
-              "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": "order",
-              "type": {
-                "text": "string"
-              },
-              "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": "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 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-actions-gap - The gap between an item's slotted actions. Defaults to `var(--zn-spacing-x-small)`.\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-icon"
-          ]
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "default",
-          "declaration": {
-            "name": "ZnPriorityList",
-            "module": "components/priority-list/priority-list.js"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "components/progress-bar/progress-bar.js",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "",
-          "name": "ZnProgressBar",
-          "cssProperties": [
-            {
-              "description": "The color of the progress bar background track.",
-              "name": "--zn-border-color"
-            },
-            {
-              "description": "The color of the progress bar fill.",
-              "name": "--zn-progress-bar-color"
-            },
-            {
-              "description": "The color of the caption text.",
-              "name": "--zn-text-heading"
-            },
-            {
-              "description": "The color of the progress percentage and description text.",
-              "name": "--zn-text"
-            },
-            {
-              "description": "The spacing between header/footer and the progress bar.",
-              "name": "--zn-spacing-x-small"
-            }
-          ],
-          "cssParts": [
-            {
-              "description": "The header container that contains the caption and progress text.",
-              "name": "header"
-            },
-            {
-              "description": "The caption text element.",
-              "name": "caption"
-            },
-            {
-              "description": "The progress percentage text element.",
-              "name": "progress"
-            },
-            {
-              "description": "The SVG element containing the progress bar.",
-              "name": "bar"
-            },
-            {
-              "description": "The background track of the progress bar.",
-              "name": "track"
-            },
-            {
-              "description": "The filled portion of the progress bar indicating progress.",
-              "name": "fill"
-            },
-            {
-              "description": "The footer container that contains the description.",
-              "name": "footer"
-            },
-            {
-              "description": "The description text element.",
-              "name": "info"
-            }
-          ],
-          "members": [
-            {
-              "kind": "field",
-              "name": "caption",
-              "type": {
-                "text": "string | undefined"
-              },
-              "attribute": "caption",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "color",
-              "type": {
-                "text": "ProgressBarColor"
-              },
-              "default": "'current'",
-              "attribute": "color",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "description",
-              "type": {
-                "text": "string | undefined"
-              },
-              "attribute": "description",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "value",
-              "type": {
-                "text": "number | undefined"
-              },
-              "attribute": "value",
-              "reflects": true
+              "description": "Zooms the previewed page out (0–1]. The frame always fills the panel;\nzoom shrinks the content browser-style, so 0.4 shows the page at 40%\nsize with correspondingly more of it visible. 1 = natural size.\nIgnored when `fill` is set.",
+              "fieldName": "zoom"
             },
             {
-              "kind": "field",
-              "name": "showProgress",
-              "type": {
-                "text": "boolean | undefined"
-              },
-              "attribute": "show-progress",
-              "reflects": true
-            }
-          ],
-          "attributes": [
-            {
-              "name": "caption",
+              "name": "min-height",
               "type": {
-                "text": "string | undefined"
+                "text": "number"
               },
-              "fieldName": "caption"
+              "default": "480",
+              "description": "The visible height (in CSS pixels) of the preview panel. Fixed rather\nthan measured, because a measured height would feed back into the\nscaled iframe's layout box and grow unbounded. With `fill` set, this\nbecomes a `min-height` floor instead of the height.",
+              "fieldName": "minHeight"
             },
             {
-              "name": "color",
+              "name": "fill",
               "type": {
-                "text": "ProgressBarColor"
+                "text": "boolean"
               },
-              "default": "'current'",
-              "fieldName": "color"
+              "default": "false",
+              "description": "Fills the panel's own column height instead of using a fixed\n`min-height` pixel height — for hosts (like zn-theme-editor) whose\nlayout already stretches the column to match a taller sibling.\n`zoom` is ignored when set: its oversize maths depends on a known\npixel height, which `fill` deliberately doesn't have.",
+              "fieldName": "fill"
             },
             {
-              "name": "description",
+              "name": "device",
               "type": {
-                "text": "string | undefined"
+                "text": "PreviewFrameDevice"
               },
-              "fieldName": "description"
+              "default": "'desktop'",
+              "description": "Constrains and centres the preview to a device width: `desktop` (100%),\n`tablet` (768px) or `mobile` (390px). The iframe element itself is\nnarrowed, so the embedded page's own media queries fire.",
+              "fieldName": "device"
             },
             {
-              "name": "value",
+              "name": "backdrop",
               "type": {
-                "text": "number | undefined"
+                "text": "'dots' | 'panel'"
               },
-              "fieldName": "value"
+              "default": "'dots'",
+              "description": "Backdrop behind the stage: `dots` (default) is the canvas dot grid; `panel` is a plain `rgb(var(--zn-panel))` fill.",
+              "fieldName": "backdrop"
             },
             {
-              "name": "show-progress",
+              "name": "interactive",
               "type": {
-                "text": "boolean | undefined"
+                "text": "boolean"
               },
-              "fieldName": "showProgress"
+              "default": "false",
+              "description": "Lets pointer input through to the embedded page. The preview is inert by\ndefault: clicks never reach the frame, so the previewed page can't be\nnavigated or submitted from inside the preview. Cross-origin content can't\nbe reached from here to cancel its own handlers, so this blocks pointer\ninput entirely — hover goes with it. Scrolling doesn't: an overflowing\npage is scrolled by the panel rather than by the frame (see _contentHeight).\n\nSet, the frame becomes a real viewport instead: it stays the panel's own\nheight and the embed scrolls itself, so there is one scrollbar rather than\na panel scrolling an oversized frame, and the embed's viewport-relative\nlayout (`100vh`, `position: fixed`, sticky headers) sizes to what's on\nscreen. _contentHeight is ignored while this is set.",
+              "fieldName": "interactive"
             }
           ],
           "superclass": {
             "name": "ZincElement",
             "module": "/src/internal/zinc-element"
           },
-          "summary": "Progress bars provide visual feedback about the completion status of a task or process.",
-          "tagNameWithoutPrefix": "progress-bar",
-          "tagName": "zn-progress-bar",
+          "summary": "Embeds a live preview iframe and drives the hp-preview postMessage\nprotocol: answers the frame's ready handshake with a config payload fetched\nfrom data-uri, auto-saves watched forms on change, refreshes the preview\nafter each save (its own, or a shell-driven save of a `refresh-on` form),\naccepts a theme payload via setTheme() that is retained and replayed\nafter every ready handshake, and grows the frame to a content height the\nembed reports so the panel scrolls an overflowing page.",
+          "tagNameWithoutPrefix": "preview-frame",
+          "tagName": "zn-preview-frame",
           "customElement": true,
-          "jsDoc": "/**\n * @summary Progress bars provide visual feedback about the completion status of a task or process.\n * @documentation https://zinc.style/components/progress-bar\n * @status experimental\n * @since 1.0\n *\n * @csspart header - The header container that contains the caption and progress text.\n * @csspart caption - The caption text element.\n * @csspart progress - The progress percentage text element.\n * @csspart bar - The SVG element containing the progress bar.\n * @csspart track - The background track of the progress bar.\n * @csspart fill - The filled portion of the progress bar indicating progress.\n * @csspart footer - The footer container that contains the description.\n * @csspart info - The description text element.\n *\n * @cssproperty --zn-border-color - The color of the progress bar background track.\n * @cssproperty --zn-progress-bar-color - The color of the progress bar fill.\n * @cssproperty --zn-text-heading - The color of the caption text.\n * @cssproperty --zn-text - The color of the progress percentage and description text.\n * @cssproperty --zn-spacing-x-small - The spacing between header/footer and the progress bar.\n */",
-          "documentation": "https://zinc.style/components/progress-bar",
+          "jsDoc": "/**\n * @summary Embeds a live preview iframe and drives the hp-preview postMessage\n * protocol: answers the frame's ready handshake with a config payload fetched\n * from data-uri, auto-saves watched forms on change, refreshes the preview\n * after each save (its own, or a shell-driven save of a `refresh-on` form),\n * accepts a theme payload via setTheme() that is retained and replayed\n * after every ready handshake, and grows the frame to a content height the\n * embed reports so the panel scrolls an overflowing page.\n *\n * @documentation https://zinc.style/components/preview-frame\n * @status experimental\n * @since 1.0\n *\n * @event zn-error - Emitted when the preview reports a render error or a save fails.\n *\n * @csspart base - The component's base wrapper.\n * @csspart stage - The device-width wrapper around the iframe.\n * @csspart iframe - The preview iframe.\n * @csspart error - The error overlay.\n *\n * @cssproperty --zn-preview-frame-dot-spacing - Spacing of the backdrop dot grid (`backdrop=\"dots\"`). Defaults to 20px.\n * @cssproperty --zn-preview-frame-dot-opacity - Opacity of the backdrop dots (`backdrop=\"dots\"`). Defaults to 0.08.\n */",
+          "documentation": "https://zinc.style/components/preview-frame",
           "status": "experimental",
           "since": "1.0"
         }
@@ -31954,8 +31897,8 @@
           "kind": "js",
           "name": "default",
           "declaration": {
-            "name": "ZnProgressBar",
-            "module": "components/progress-bar/progress-bar.js"
+            "name": "ZnPreviewFrame",
+            "module": "components/preview-frame/preview-frame.js"
           }
         }
       ]
@@ -34649,7 +34592,7 @@
               "name": "slashController",
               "privacy": "private",
               "readonly": true,
-              "default": "new SlashMenuController(this, { menu: () => this.mountSlashMenu(), // The menu only belongs in a block that is nothing but the slash command — a // block prefix like \"## \" is not valid remarkd part-way through a line. items: () => this.isSlashBlock() ? SLASH_ITEMS.filter(item => item.action !== 'include' || !!this.includeUrl) : [], onSelect: item => this.handleSlashSelect(item) })"
+              "default": "new SlashMenuController(this, { menu: () => this.mountSlashMenu(), // The menu only belongs in a block that is nothing but the slash command — a // block prefix like \"## \" is not valid remarkd part-way through a line. items: () => this.isSlashBlock() ? SLASH_ITEMS.filter(item => this.slashItemAvailable(item)) : [], onSelect: item => this.handleSlashSelect(item) })"
             },
             {
               "kind": "field",
@@ -34847,6 +34790,84 @@
               "privacy": "private",
               "default": "''"
             },
+            {
+              "kind": "field",
+              "name": "linkPickerOpen",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "linkQuery",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "default": "''"
+            },
+            {
+              "kind": "field",
+              "name": "linkResults",
+              "type": {
+                "text": "LinkOption[] | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "linkSearchFailed",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "linkSelection",
+              "type": {
+                "text": "[number, number] | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "linkSearchTimer",
+              "type": {
+                "text": "ReturnType<typeof setTimeout> | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "linkSearchToken",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0"
+            },
+            {
+              "kind": "field",
+              "name": "linkRefs",
+              "privacy": "private",
+              "default": "new Map<string, LinkOption | null>()",
+              "description": "Resolved link targets by reference; a null value is one the app does not know."
+            },
+            {
+              "kind": "field",
+              "name": "linkRefsPending",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
             {
               "kind": "field",
               "name": "pendingDragHandle",
@@ -34960,6 +34981,16 @@
               "description": "Endpoint listing the Includes this document may embed, as\n`{\"items\":[{id,title,description,scope,keywords,languages,url}]}`. Labels the\nchips rendered for `include::` directives and feeds the include picker.",
               "attribute": "include-url"
             },
+            {
+              "kind": "field",
+              "name": "linkUrl",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Endpoint the article link picker searches, as\n`{\"items\":[{ref,kind,title,context,status}]}`. Queried with `?q=<term>` as\nthe author types and with `?refs=a,b` to resolve the references a body\nalready carries.",
+              "attribute": "link-url"
+            },
             {
               "kind": "field",
               "name": "allowRaw",
@@ -35082,6 +35113,10 @@
               "kind": "method",
               "name": "handleIncludeUrlChange"
             },
+            {
+              "kind": "method",
+              "name": "handleLinkUrlChange"
+            },
             {
               "kind": "method",
               "name": "splitBlocks",
@@ -35690,6 +35725,31 @@
                 }
               ]
             },
+            {
+              "kind": "method",
+              "name": "pickLink",
+              "privacy": "private",
+              "description": "Opens the picker over the block being edited. The caret range is captured\nnow: the picker's own filter takes focus, so the textarea's selection is\ngone by the time an option is chosen."
+            },
+            {
+              "kind": "field",
+              "name": "closeLinkPicker",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "searchLinks",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "term",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Debounced; only the newest response is kept."
+            },
             {
               "kind": "field",
               "name": "closeIncludePicker",
@@ -35795,6 +35855,25 @@
               },
               "description": "Fetches the include list once; every later caller shares the same promise."
             },
+            {
+              "kind": "method",
+              "name": "resolveContentLinks",
+              "privacy": "private",
+              "description": "Resolves the references in the body that have not been resolved yet, so a\nlink whose target is gone can be marked. A failed request records nothing:\nan unanswered reference is not a broken one."
+            },
+            {
+              "kind": "method",
+              "name": "markContentLinks",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "root",
+                  "type": {
+                    "text": "Element"
+                  }
+                }
+              ]
+            },
             {
               "kind": "method",
               "name": "autosize",
@@ -35972,7 +36051,44 @@
                   }
                 }
               ],
-              "description": "An inline action needs an open block to apply its mark to."
+              "description": "Inline marks and the article link both apply into an open block, not a new one."
+            },
+            {
+              "kind": "method",
+              "name": "actionAvailable",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "action",
+                  "type": {
+                    "text": "EditorAction"
+                  }
+                }
+              ],
+              "description": "A picker action with no endpoint configured is not offered at all."
+            },
+            {
+              "kind": "method",
+              "name": "slashItemAvailable",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "item",
+                  "type": {
+                    "text": "SlashMenuItem"
+                  }
+                }
+              ]
             },
             {
               "kind": "method",
@@ -36032,6 +36148,24 @@
               "name": "renderIncludePicker",
               "privacy": "private"
             },
+            {
+              "kind": "method",
+              "name": "renderLinkPicker",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "insertLink",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "item",
+                  "type": {
+                    "text": "LinkOption"
+                  }
+                }
+              ]
+            },
             {
               "kind": "method",
               "name": "renderImagePicker",
@@ -36103,6 +36237,15 @@
               "description": "Endpoint listing the Includes this document may embed, as\n`{\"items\":[{id,title,description,scope,keywords,languages,url}]}`. Labels the\nchips rendered for `include::` directives and feeds the include picker.",
               "fieldName": "includeUrl"
             },
+            {
+              "name": "link-url",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Endpoint the article link picker searches, as\n`{\"items\":[{ref,kind,title,context,status}]}`. Queried with `?q=<term>` as\nthe author types and with `?refs=a,b` to resolve the references a body\nalready carries.",
+              "fieldName": "linkUrl"
+            },
             {
               "name": "allow-raw",
               "type": {
@@ -49712,12 +49855,16 @@
                 "module": "src/components/panel/panel.component.ts"
               }
             },
+            {
+              "description": "The form group holding the caption, the language select and the fields.",
+              "name": "form-group"
+            },
             {
               "description": "The row of buttons at the bottom of the body.",
               "name": "actions"
             },
             {
-              "description": "The label and select that choose the language every child is editing.",
+              "description": "The select that chooses the language every child is editing, in the group's chip slot.",
               "name": "language-field"
             },
             {
@@ -49743,7 +49890,7 @@
               }
             },
             {
-              "description": "Content displayed in the grey panel footer. The header belongs to the language select; nothing else is slotted into it.",
+              "description": "Content displayed in the grey panel footer.",
               "name": "footer",
               "inheritedFrom": {
                 "name": "ZnPanel",
@@ -49759,7 +49906,7 @@
                 "text": "object"
               },
               "static": true,
-              "default": "{ 'zn-chip': ZnChip, 'zn-header': ZnHeader, 'zn-option': ZnOption, 'zn-select': ZnSelect }"
+              "default": "{ 'zn-chip': ZnChip, 'zn-form-group': ZnFormGroup, 'zn-option': ZnOption, 'zn-select': ZnSelect }"
             },
             {
               "kind": "field",
@@ -49775,9 +49922,19 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The caption shown in the panel header. An alias for the inherited `caption`, which wins where both are set.",
+              "description": "The form group's label. An alias for the inherited `caption`, which wins where both are set.",
               "attribute": "label"
             },
+            {
+              "kind": "field",
+              "name": "helpText",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Sits under the label, above the language select, as help text does in any other form group.",
+              "attribute": "help-text"
+            },
             {
               "kind": "field",
               "name": "inline",
@@ -49785,7 +49942,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Drops the panel chrome — border, background and padding — so the group reads as a section of the form around it\nrather than a panel of its own. For groups nested inside another panel, where the fields would otherwise sit\nindented behind a second border.",
+              "description": "Drops the panel chrome — border, background and padding — so the group reads as a section of the surrounding form\nrather than a panel of its own. For groups nested inside another panel, where the fields would otherwise sit\nindented behind a second border.",
               "attribute": "inline",
               "reflects": true
             },
@@ -49881,7 +50038,7 @@
                   }
                 }
               ],
-              "description": "`English (EN)`, or the code alone where the configured name already is the code."
+              "description": "The configured name, or the code where `languages` does not name the language."
             },
             {
               "kind": "method",
@@ -50100,16 +50257,25 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "The caption shown in the panel header. An alias for the inherited `caption`, which wins where both are set.",
+              "description": "The form group's label. An alias for the inherited `caption`, which wins where both are set.",
               "fieldName": "label"
             },
+            {
+              "name": "help-text",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Sits under the label, above the language select, as help text does in any other form group.",
+              "fieldName": "helpText"
+            },
             {
               "name": "inline",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Drops the panel chrome — border, background and padding — so the group reads as a section of the form around it\nrather than a panel of its own. For groups nested inside another panel, where the fields would otherwise sit\nindented behind a second border.",
+              "description": "Drops the panel chrome — border, background and padding — so the group reads as a section of the surrounding form\nrather than a panel of its own. For groups nested inside another panel, where the fields would otherwise sit\nindented behind a second border.",
               "fieldName": "inline"
             },
             {
@@ -50271,13 +50437,13 @@
           "tagNameWithoutPrefix": "translation-group",
           "tagName": "zn-translation-group",
           "customElement": true,
-          "jsDoc": "/**\n * @summary Puts several zn-translations fields behind one language select, so a whole form's worth of copy is\n *  translated a language at a time.\n * @documentation https://zinc.style/components/translation-group\n * @status experimental\n * @since 1.0\n *\n * The select sits at the top right of the header, opposite the caption. Choosing a language switches every child at\n * once, and each child hides its own select while it is in a group — `grouped` is set on them here.\n *\n * Closed, the select carries how many target languages are done — `1/5`. Its options each carry a chip aggregated\n * across the children:\n *\n * - `Translated` — every child has a value for it\n * - `Partial` — only some children do\n * - `English` — none do, so all of them fall back to the English text\n *\n * `Empty` replaces the last of those for English itself, which has nothing to fall back to. English is the source\n * rather than a translation, so it is also left out of the `n of m translated` count beside the label.\n *\n * The children own their values; this component only chooses which language is shown and reports on what they hold.\n * It reads them back on every child `zn-change`, so the chips and the count follow an edit as it is typed.\n *\n * Extends `zn-panel`, so `caption`, `icon`, `flush`, `transparent` and the `footer` slot behave as they do there.\n * Nested inside another panel, add `inline` to drop the chrome and keep the fields aligned with the surrounding form.\n *\n * @dependency zn-chip\n * @dependency zn-header\n * @dependency zn-option\n * @dependency zn-select\n *\n * @event zn-language-change - Emitted when the active language changes. Detail: `{ language: string }`.\n *\n * @slot - The `zn-translations` fields the select drives.\n * @slot actions - Buttons for the bottom of the panel, on the white body rather than the grey footer. They sit on\n *  the right, as zinc's form action rows do; `align=\"start\"` moves one to the left. Write them in the order they\n *  should be read — the sides are set by CSS ordering, so markup order is what a keyboard follows.\n * @slot footer - Content displayed in the grey panel footer. The header belongs to the language select; nothing\n *  else is slotted into it.\n *\n * @csspart base - The component's base wrapper.\n * @csspart actions - The row of buttons at the bottom of the body.\n * @csspart language-field - The label and select that choose the language every child is editing.\n * @csspart language-select - The select itself.\n */",
+          "jsDoc": "/**\n * @summary Puts several zn-translations fields behind one language select, so a whole form's worth of copy is\n *  translated a language at a time.\n * @documentation https://zinc.style/components/translation-group\n * @status experimental\n * @since 1.0\n *\n * The fields sit in a `zn-form-group`, so the caption, help text and the language select share its label column and\n * the fields line up with every other form group around them. Choosing a language switches every child at once, and\n * each child hides its own select while it is in a group — `grouped` is set on them here.\n *\n * The select is searchable. Each option holds its language code as its value, so typing `de` finds German without the\n * code being on show.\n *\n * Closed, the select carries how many target languages are done — `1/5`. Its options each carry a chip aggregated\n * across the children:\n *\n * - `Translated` — every child has a value for it\n * - `Partial` — only some children do\n * - `English` — none do, so all of them fall back to the English text\n *\n * `Empty` replaces the last of those for English itself, which has nothing to fall back to. English is the source\n * rather than a translation, so it is also left out of the `n of m translated` count beside the label.\n *\n * The children own their values; this component only chooses which language is shown and reports on what they hold.\n * It reads them back on every child `zn-change`, so the chips and the count follow an edit as it is typed.\n *\n * Extends `zn-panel`, so `caption`, `flush`, `transparent` and the `footer` slot behave as they do there. Nested\n * inside another panel, add `inline` to drop the chrome and keep the fields aligned with the surrounding form.\n *\n * @dependency zn-chip\n * @dependency zn-form-group\n * @dependency zn-option\n * @dependency zn-select\n *\n * @event zn-language-change - Emitted when the active language changes. Detail: `{ language: string }`.\n *\n * @slot - The `zn-translations` fields the select drives.\n * @slot actions - Buttons for the bottom of the panel, on the white body rather than the grey footer. They sit on\n *  the right, as zinc's form action rows do; `align=\"start\"` moves one to the left. Write them in the order they\n *  should be read — the sides are set by CSS ordering, so markup order is what a keyboard follows.\n * @slot footer - Content displayed in the grey panel footer.\n *\n * @csspart base - The component's base wrapper.\n * @csspart form-group - The form group holding the caption, the language select and the fields.\n * @csspart actions - The row of buttons at the bottom of the body.\n * @csspart language-field - The select that chooses the language every child is editing, in the group's chip slot.\n * @csspart language-select - The select itself.\n */",
           "documentation": "https://zinc.style/components/translation-group",
           "status": "experimental",
           "since": "1.0",
           "dependencies": [
             "zn-chip",
-            "zn-header",
+            "zn-form-group",
             "zn-option",
             "zn-select"
           ],
@@ -50725,7 +50891,7 @@
                   }
                 }
               ],
-              "description": "`English (EN)` — the configured name plus its code, unless the name already is the code, in which case the code\nalone. `languages` is written both ways: `{\"en\": \"English\"}` and `{\"en\": \"EN\"}`."
+              "description": "The configured name, or the code where `languages` does not name the language."
             },
             {
               "kind": "method",
@@ -51332,7 +51498,7 @@
   "package": {
     "name": "@kubex/zinc",
     "description": "A collection of web components for building web applications based off of @shoelace-style/Shoelace",
-    "version": "1.1.117",
+    "version": "1.1.119",
     "author": "",
     "license": "MIT"
   }