@kubex/zinc 1.1.72 → 1.1.74

package/dist/vscode.html-custom-data.json

@@ -13,6 +13,17 @@
         }
       ]
     },
+    {
+      "name": "zn-action-bar",
+      "description": "Short summary of the component's intended use.\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
+      "attributes": [],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://zinc.style/components/action-bar"
+        }
+      ]
+    },
     {
       "name": "zn-alert",
       "description": "Short summary of the component's intended use.\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
@@ -53,17 +64,6 @@
         }
       ]
     },
-    {
-      "name": "zn-action-bar",
-      "description": "Short summary of the component's intended use.\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
-      "attributes": [],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://zinc.style/components/action-bar"
-        }
-      ]
-    },
     {
       "name": "zn-animated-button",
       "description": "\n---\n\n\n### **Methods:**\n - **purchase(): _void_** - Programmatically trigger the purchase flow\n- **setSuccess(): _void_** - Set the button to success state manually\n- **setFailure(message): _void_** - Set the button to failure state manually with optional error message\n- **reset(): _void_** - Reset the button to idle state",
@@ -2650,7 +2650,7 @@
     },
     {
       "name": "zn-page",
-      "description": "Combines a page header with tab navigation and tab panels.\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - Page content. Use zn-tab for named tabs and header-action/header-actions for header actions.\n- **description** - Rich subtitle/description content. Falls back to the `summary` attribute when empty.\n- **bottom** - Content rendered below the navbar row (e.g. chips, filters). Forwarded to the navbar's bottom slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
+      "description": "Combines a page header with tab navigation and tab panels.\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Methods:**\n \n\n\n### **Slots:**\n - _default_ - Page content. Use zn-tab for named tabs and header-action/header-actions for header actions.\n- **description** - Rich subtitle/description content. Falls back to the `summary` attribute when empty.\n- **bottom** - Content rendered below the navbar row (e.g. chips, filters). Forwarded to the navbar's bottom slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
       "attributes": [
         { "name": "caption", "values": [] },
         { "name": "entity-id", "values": [] },
@@ -2733,7 +2733,7 @@
     },
     {
       "name": "zn-page-nav",
-      "description": "Short summary of the component's intended use.\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
+      "description": "Short summary of the component's intended use.\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Methods:**\n \n\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
       "attributes": [
         { "name": "navigation", "values": [{ "name": "PageNavData" }] },
         { "name": "master-id", "values": [] },
@@ -2964,7 +2964,7 @@
     },
     {
       "name": "zn-preview-frame",
-      "description": "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),\nand accepts a theme payload via setTheme() that is retained and replayed\nafter every ready handshake.\n---\n\n\n### **Events:**\n - **zn-error** - Emitted when the preview reports a render error or a save fails.\n\n### **Methods:**\n - **refresh()** - Re-fetches the payload and pushes a fresh config to the preview.\n- **setTheme(theme: _Record<string, unknown>_)** - 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.\n\n### **CSS Properties:**\n - **--zn-preview-frame-dot-spacing** - Spacing of the backdrop dot grid (`backdrop=\"dots\"`). Defaults to 20px. _(default: undefined)_\n- **--zn-preview-frame-dot-opacity** - Opacity of the backdrop dots (`backdrop=\"dots\"`). Defaults to 0.08. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **stage** - The device-width wrapper around the iframe.\n- **iframe** - The preview iframe.\n- **error** - The error overlay.",
+      "description": "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.\n---\n\n\n### **Events:**\n - **zn-error** - Emitted when the preview reports a render error or a save fails.\n\n### **Methods:**\n - **refresh()** - Re-fetches the payload and pushes a fresh config to the preview.\n- **setTheme(theme: _Record<string, unknown>_)** - 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.\n\n### **CSS Properties:**\n - **--zn-preview-frame-dot-spacing** - Spacing of the backdrop dot grid (`backdrop=\"dots\"`). Defaults to 20px. _(default: undefined)_\n- **--zn-preview-frame-dot-opacity** - Opacity of the backdrop dots (`backdrop=\"dots\"`). Defaults to 0.08. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **stage** - The device-width wrapper around the iframe.\n- **iframe** - The preview iframe.\n- **error** - The error overlay.",
       "attributes": [
         {
           "name": "src",
@@ -3020,6 +3020,11 @@
           "name": "backdrop",
           "description": "Backdrop behind the stage: `dots` (default) is the canvas dot grid; `panel` is a plain `rgb(var(--zn-panel))` fill.",
           "values": [{ "name": "dots" }, { "name": "panel" }]
+        },
+        {
+          "name": "interactive",
+          "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).",
+          "values": []
         }
       ],
       "references": [
@@ -3958,7 +3963,7 @@
     },
     {
       "name": "zn-tabs",
-      "description": "Short summary of the component's intended use.\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
+      "description": "Short summary of the component's intended use.\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Methods:**\n \n\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
       "attributes": [
         { "name": "master-id", "values": [] },
         { "name": "default-uri", "values": [] },
@@ -4481,6 +4486,17 @@
         }
       ]
     },
+    {
+      "name": "zn-well",
+      "description": "Short summary of the component's intended use.\n---\n\n\n### **Slots:**\n - _default_ - The default slot.",
+      "attributes": [
+        { "name": "icon", "values": [] },
+        { "name": "inline", "values": [] }
+      ],
+      "references": [
+        { "name": "Documentation", "url": "https://zinc.style/components/well" }
+      ]
+    },
     {
       "name": "zn-vertical-stepper",
       "description": "Vertical steppers display a sequence of steps in a vertical layout with descriptions and optional icons.\n---\n\n\n### **Slots:**\n - **icon** - Optional slot for adding an icon or indicator before the step content.\n\n### **CSS Parts:**\n - **vs** - The main container for the vertical stepper.\n- **vs__left** - The left section containing the icon and connecting line.\n- **vs__icon** - The icon container.\n- **vs__line** - The vertical connecting line between steps.\n- **vs__right** - The right section containing caption and description text.\n- **vs__caption** - The caption/title text element.\n- **vs__description** - The description text element.",
@@ -4517,17 +4533,6 @@
           "url": "https://zinc.style/components/vertical-stepper"
         }
       ]
-    },
-    {
-      "name": "zn-well",
-      "description": "Short summary of the component's intended use.\n---\n\n\n### **Slots:**\n - _default_ - The default slot.",
-      "attributes": [
-        { "name": "icon", "values": [] },
-        { "name": "inline", "values": [] }
-      ],
-      "references": [
-        { "name": "Documentation", "url": "https://zinc.style/components/well" }
-      ]
     }
   ]
 }

package/dist/web-types.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://raw.githubusercontent.com/JetBrains/web-types/master/schema/web-types.json",
   "name": "@kubex/zinc",
-  "version": "1.1.72",
+  "version": "1.1.74",
   "description-markup": "markdown",
   "contributions": {
     "html": {
@@ -15,6 +15,28 @@
           "events": [],
           "js": { "properties": [], "events": [] }
         },
+        {
+          "name": "zn-action-bar",
+          "description": "Short summary of the component's intended use.\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
+          "doc-url": "",
+          "attributes": [],
+          "slots": [
+            { "name": "", "description": "The default slot." },
+            { "name": "example", "description": "An example slot." }
+          ],
+          "events": [
+            { "name": "zn-event-name", "description": "Emitted as an example." }
+          ],
+          "js": {
+            "properties": [],
+            "events": [
+              {
+                "name": "zn-event-name",
+                "description": "Emitted as an example."
+              }
+            ]
+          }
+        },
         {
           "name": "zn-alert",
           "description": "Short summary of the component's intended use.\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
@@ -83,28 +105,6 @@
             ]
           }
         },
-        {
-          "name": "zn-action-bar",
-          "description": "Short summary of the component's intended use.\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
-          "doc-url": "",
-          "attributes": [],
-          "slots": [
-            { "name": "", "description": "The default slot." },
-            { "name": "example", "description": "An example slot." }
-          ],
-          "events": [
-            { "name": "zn-event-name", "description": "Emitted as an example." }
-          ],
-          "js": {
-            "properties": [],
-            "events": [
-              {
-                "name": "zn-event-name",
-                "description": "Emitted as an example."
-              }
-            ]
-          }
-        },
         {
           "name": "zn-animated-button",
           "description": "\n---\n\n\n### **Methods:**\n - **purchase(): _void_** - Programmatically trigger the purchase flow\n- **setSuccess(): _void_** - Set the button to success state manually\n- **setFailure(message): _void_** - Set the button to failure state manually with optional error message\n- **reset(): _void_** - Reset the button to idle state",
@@ -6190,7 +6190,7 @@
         },
         {
           "name": "zn-page",
-          "description": "Combines a page header with tab navigation and tab panels.\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - Page content. Use zn-tab for named tabs and header-action/header-actions for header actions.\n- **description** - Rich subtitle/description content. Falls back to the `summary` attribute when empty.\n- **bottom** - Content rendered below the navbar row (e.g. chips, filters). Forwarded to the navbar's bottom slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
+          "description": "Combines a page header with tab navigation and tab panels.\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Methods:**\n \n\n\n### **Slots:**\n - _default_ - Page content. Use zn-tab for named tabs and header-action/header-actions for header actions.\n- **description** - Rich subtitle/description content. Falls back to the `summary` attribute when empty.\n- **bottom** - Content rendered below the navbar row (e.g. chips, filters). Forwarded to the navbar's bottom slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
           "doc-url": "",
           "attributes": [
             { "name": "caption", "value": { "type": "string" } },
@@ -6482,7 +6482,7 @@
         },
         {
           "name": "zn-page-nav",
-          "description": "Short summary of the component's intended use.\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
+          "description": "Short summary of the component's intended use.\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Methods:**\n \n\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
           "doc-url": "",
           "attributes": [
             { "name": "navigation", "value": { "type": "PageNavData" } },
@@ -6939,7 +6939,7 @@
         },
         {
           "name": "zn-preview-frame",
-          "description": "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),\nand accepts a theme payload via setTheme() that is retained and replayed\nafter every ready handshake.\n---\n\n\n### **Events:**\n - **zn-error** - Emitted when the preview reports a render error or a save fails.\n\n### **Methods:**\n - **refresh()** - Re-fetches the payload and pushes a fresh config to the preview.\n- **setTheme(theme: _Record<string, unknown>_)** - 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.\n\n### **CSS Properties:**\n - **--zn-preview-frame-dot-spacing** - Spacing of the backdrop dot grid (`backdrop=\"dots\"`). Defaults to 20px. _(default: undefined)_\n- **--zn-preview-frame-dot-opacity** - Opacity of the backdrop dots (`backdrop=\"dots\"`). Defaults to 0.08. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **stage** - The device-width wrapper around the iframe.\n- **iframe** - The preview iframe.\n- **error** - The error overlay.",
+          "description": "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.\n---\n\n\n### **Events:**\n - **zn-error** - Emitted when the preview reports a render error or a save fails.\n\n### **Methods:**\n - **refresh()** - Re-fetches the payload and pushes a fresh config to the preview.\n- **setTheme(theme: _Record<string, unknown>_)** - 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.\n\n### **CSS Properties:**\n - **--zn-preview-frame-dot-spacing** - Spacing of the backdrop dot grid (`backdrop=\"dots\"`). Defaults to 20px. _(default: undefined)_\n- **--zn-preview-frame-dot-opacity** - Opacity of the backdrop dots (`backdrop=\"dots\"`). Defaults to 0.08. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **stage** - The device-width wrapper around the iframe.\n- **iframe** - The preview iframe.\n- **error** - The error overlay.",
           "doc-url": "",
           "attributes": [
             {
@@ -6996,6 +6996,11 @@
               "name": "backdrop",
               "description": "Backdrop behind the stage: `dots` (default) is the canvas dot grid; `panel` is a plain `rgb(var(--zn-panel))` fill.",
               "value": { "type": "'dots' | 'panel'", "default": "'dots'" }
+            },
+            {
+              "name": "interactive",
+              "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).",
+              "value": { "type": "boolean", "default": "false" }
             }
           ],
           "events": [
@@ -7061,6 +7066,11 @@
                 "description": "Backdrop behind the stage: `dots` (default) is the canvas dot grid; `panel` is a plain `rgb(var(--zn-panel))` fill.",
                 "type": "'dots' | 'panel'"
               },
+              {
+                "name": "interactive",
+                "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).",
+                "type": "boolean"
+              },
               { "name": "frame", "type": "HTMLIFrameElement" }
             ],
             "events": [
@@ -9356,7 +9366,7 @@
         },
         {
           "name": "zn-tabs",
-          "description": "Short summary of the component's intended use.\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
+          "description": "Short summary of the component's intended use.\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Methods:**\n \n\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
           "doc-url": "",
           "attributes": [
             { "name": "master-id", "value": { "type": "string" } },
@@ -10591,6 +10601,24 @@
             "events": []
           }
         },
+        {
+          "name": "zn-well",
+          "description": "Short summary of the component's intended use.\n---\n\n\n### **Slots:**\n - _default_ - The default slot.",
+          "doc-url": "",
+          "attributes": [
+            { "name": "icon", "value": { "type": "string", "default": "''" } },
+            { "name": "inline", "value": { "type": "boolean" } }
+          ],
+          "slots": [{ "name": "", "description": "The default slot." }],
+          "events": [],
+          "js": {
+            "properties": [
+              { "name": "icon", "type": "string" },
+              { "name": "inline", "type": "boolean" }
+            ],
+            "events": []
+          }
+        },
         {
           "name": "zn-vertical-stepper",
           "description": "Vertical steppers display a sequence of steps in a vertical layout with descriptions and optional icons.\n---\n\n\n### **Slots:**\n - **icon** - Optional slot for adding an icon or indicator before the step content.\n\n### **CSS Parts:**\n - **vs** - The main container for the vertical stepper.\n- **vs__left** - The left section containing the icon and connecting line.\n- **vs__icon** - The icon container.\n- **vs__line** - The vertical connecting line between steps.\n- **vs__right** - The right section containing caption and description text.\n- **vs__caption** - The caption/title text element.\n- **vs__description** - The description text element.",
@@ -10659,24 +10687,6 @@
             ],
             "events": []
           }
-        },
-        {
-          "name": "zn-well",
-          "description": "Short summary of the component's intended use.\n---\n\n\n### **Slots:**\n - _default_ - The default slot.",
-          "doc-url": "",
-          "attributes": [
-            { "name": "icon", "value": { "type": "string", "default": "''" } },
-            { "name": "inline", "value": { "type": "boolean" } }
-          ],
-          "slots": [{ "name": "", "description": "The default slot." }],
-          "events": [],
-          "js": {
-            "properties": [
-              { "name": "icon", "type": "string" },
-              { "name": "inline", "type": "boolean" }
-            ],
-            "events": []
-          }
         }
       ]
     }

package/dist/zn.d.ts

@@ -4487,6 +4487,29 @@ declare module "components/tab/index" {
         }
     }
 }
+declare module "components/tabs/tabs-navigation" {
+    export const TAB_STORE_PREFIX = "zntab:";
+    /** Scopes a store key to the current location, so each page keeps its own tab. */
+    export function locationScopedKey(key: string): string;
+    /**
+     * Ends the visits to every location other than the one on screen, discarding
+     * the tabs they were left showing. Called whenever the location may have
+     * changed, so the only tabs ever remembered are the current page's.
+     */
+    export function endVisitsToOtherLocations(): void;
+    /**
+     * Whether the current location was reached in a way that should replay the tab
+     * it was last left on: a reload, or a history traversal. A fresh navigation -
+     * including a client side one to a location visited earlier - returns false.
+     */
+    export function isRestorableLocation(): boolean;
+    /** The tab the current history entry was left showing, if it recorded one for the visit under way. */
+    export function getHistoryTab(key: string): string | null;
+    /** Adds a history entry for a tab change, making it its own Back step. */
+    export function pushHistoryTab(key: string, tab: string): void;
+    /** Records the tab on the current entry without adding a Back step. */
+    export function replaceHistoryTab(key: string, tab: string): void;
+}
 declare module "components/tabs/tabs.component" {
     import { type CSSResultGroup, type PropertyValues } from 'lit';
     import { Store } from "internal/storage";
@@ -4540,12 +4563,24 @@ declare module "components/tabs/tabs.component" {
         private _tabs;
         private _actions;
         private _knownUri;
+        private _defaultTab;
         private readonly hasSlotController;
         private readonly _domObserver;
         private readonly _monitorObserver;
         constructor();
         connectedCallback(): Promise<void>;
+        disconnectedCallback(): void;
         monitorDom(): void;
+        /** The key the active tab is persisted under. Null disables persistence. */
+        protected getTabStoreKey(): string | null;
+        protected getStoredTab(): string | null;
+        protected storeActiveTab(tabName: string): void;
+        protected restoreStoredTab(stored: string): void;
+        /** Activates the tab the container starts on, ignoring any stored selection. */
+        protected activateDefaultTab(): void;
+        private readonly handlePopState;
+        private pushTabHistory;
+        private getUriForTabId;
         _addPanel(panel: HTMLElement): void;
         _addTab(tab: HTMLElement): void;
         reRegisterTabs: () => void;
@@ -4558,9 +4593,9 @@ declare module "components/tabs/tabs.component" {
         _createUriPanel(tabEle: Element, tabUri: string, tabId: string): HTMLDivElement;
         _handleClick(event: PointerEvent): void;
         fetchUriTab(target: HTMLElement): void;
-        clickTab(target: HTMLElement, refresh: boolean): void;
+        clickTab(target: HTMLElement, refresh: boolean, pushHistory?: boolean): void;
         getRefTab(target: HTMLElement): string | null;
-        setActiveTab(tabName: string, store: boolean, refresh: boolean, refTab?: string | null): void;
+        setActiveTab(tabName: string, store: boolean, refresh: boolean, refTab?: string | null, pushHistory?: boolean): void;
         _setTabEleActive(ele: Element, active: boolean): void;
         selectTab(tabName: string, refresh: boolean): boolean;
         getActiveTab(): Element[];
@@ -4625,6 +4660,7 @@ declare module "components/page/page.component" {
         private hasExpandingActions;
         private actionObserver;
         private tabObserver;
+        private pageHistoryKey;
         connectedCallback(): Promise<void>;
         disconnectedCallback(): void;
         private handleAltPress;
@@ -4644,8 +4680,12 @@ declare module "components/page/page.component" {
         private handlePageScroll;
         updated(changedProperties: PropertyValues): void;
         private handleNavigationSelect;
+        private getNavigationItemPage;
         private activateTab;
         private activateInitialPageTab;
+        protected getTabStoreKey(): string;
+        protected activateDefaultTab(): void;
+        private getPageHistoryKey;
         private activateTabDefinition;
         private findNavItemForUri;
         private registerPagePanels;
@@ -4759,6 +4799,7 @@ declare module "components/icon-picker/icon-picker.component" {
         private handleFreeInput;
         private handleClear;
         private _handleTriggerClick;
+        private _handleTriggerKeyDown;
         render(): import("lit-html").TemplateResult<1>;
     }
 }
@@ -10422,7 +10463,7 @@ declare module "components/page-builder/index" {
     }
 }
 declare module "components/preview-frame/preview-frame.component" {
-    import { type CSSResultGroup } from 'lit';
+    import { type CSSResultGroup, type PropertyValues } from 'lit';
     import ZincElement from "internal/zinc-element";
     const DEVICE_WIDTHS: {
         readonly desktop: "100%";
@@ -10435,8 +10476,10 @@ declare module "components/preview-frame/preview-frame.component" {
      * protocol: answers the frame's ready handshake with a config payload fetched
      * from data-uri, auto-saves watched forms on change, refreshes the preview
      * after each save (its own, or a shell-driven save of a `refresh-on` form),
-     * and accepts a theme payload via setTheme() that is retained and replayed
-     * after every ready handshake.
+     * accepts a theme payload via setTheme() that is retained and replayed
+     * after every ready handshake, and grows the frame to a content height the
+     * embed reports so the panel scrolls an overflowing page.
+     *
      * @documentation https://zinc.style/components/preview-frame
      * @status experimental
      * @since 1.0
@@ -10506,17 +10549,41 @@ declare module "components/preview-frame/preview-frame.component" {
         device: PreviewFrameDevice;
         /** Backdrop behind the stage: `dots` (default) is the canvas dot grid; `panel` is a plain `rgb(var(--zn-panel))` fill. */
         backdrop: 'dots' | 'panel';
+        /**
+         * Lets pointer input through to the embedded page. The preview is inert by
+         * default: clicks never reach the frame, so the previewed page can't be
+         * navigated or submitted from inside the preview. Cross-origin content can't
+         * be reached from here to cancel its own handlers, so this blocks pointer
+         * input entirely — hover goes with it. Scrolling doesn't: an overflowing
+         * page is scrolled by the panel rather than by the frame (see _contentHeight).
+         */
+        interactive: boolean;
         frame: HTMLIFrameElement;
         private error;
+        /**
+         * Height of the embedded page's content, when it's known: reported by the
+         * embed (`height` on hp-preview:rendered, or an hp-preview:height message) or
+         * measured directly for a same-origin embed. The frame is laid out at this
+         * height rather than the panel's, so the page never scrolls inside the frame
+         * — the panel scrolls instead, which is what makes an overflowing preview
+         * reachable while pointer input to the frame is blocked. 0 = unknown, and the
+         * frame falls back to filling the panel.
+         */
+        private _contentHeight;
         private _generation;
         private _theme;
+        private _contentObserver;
         private readonly _watchedForms;
         private readonly _refreshForms;
         private readonly _debounceTimers;
         private readonly _formObserver;
         connectedCallback(): void;
+        protected willUpdate(changed: PropertyValues<this>): void;
         disconnectedCallback(): void;
         private readonly _onMessage;
+        private _applyContentHeight;
+        private _resetContentHeight;
+        private readonly _onFrameLoad;
         /** Re-fetches the payload and pushes a fresh config to the preview. */
         refresh(): Promise<void>;
         /**