@kubex/zinc 1.1.28 → 1.1.29

package/dist/custom-elements.json

@@ -13163,7 +13163,7 @@
           ],
           "slots": [
             {
-              "description": "`<zn-flow-step>` type declarations; never displayed, each `group`/`category` routes the step into the right tab and collapsible grouping of the rendered panel.",
+              "description": "`<zn-flow-step>` type declarations; never displayed, each `group`/`category` routes the step into the right tab and collapsible grouping of the rendered panel. A step may nest `<zn-flow-filter>` declarations (each holding `<zn-flow-filter-field>`s, whose operator / option choices are nested `<zn-flow-operator>` / `<zn-flow-option>` elements) — or set a `branch-filters` JSON attribute — to drive the built-in branch conditions editor.",
               "name": ""
             },
             {
@@ -13187,7 +13187,7 @@
                 "text": "object"
               },
               "static": true,
-              "default": "{ 'zn-icon': ZnIcon, 'zn-input': ZnInput, 'zn-tabs': ZnTabs, 'zn-navbar': ZnNavbar, 'zn-flow-canvas': ZnFlowCanvas, 'zn-flow-step-group': ZnFlowStepGroup, }"
+              "default": "{ 'zn-icon': ZnIcon, 'zn-input': ZnInput, 'zn-tabs': ZnTabs, 'zn-navbar': ZnNavbar, 'zn-flow-branch-conditions': ZnFlowBranchConditions, 'zn-flow-canvas': ZnFlowCanvas, 'zn-flow-step-group': ZnFlowStepGroup, }"
             },
             {
               "kind": "field",
@@ -13227,6 +13227,16 @@
               "default": "[]",
               "description": "Node ids flagged as having configuration errors (drives the red node styling)."
             },
+            {
+              "kind": "field",
+              "name": "autoSave",
+              "type": {
+                "text": "number | null"
+              },
+              "default": "null",
+              "description": "Auto-save the flow to localStorage (1-day TTL). Omit to disable. A bare\n`auto-save` saves every 5 minutes; a numeric value sets the interval in\nminutes (`auto-save=\"5\"`). Restore with `restoreAutoSave()`.",
+              "attribute": "auto-save"
+            },
             {
               "kind": "field",
               "name": "entrypointsHint",
@@ -13323,6 +13333,25 @@
               "readonly": true,
               "default": "new HasSlotController(this, 'header-left', 'header-right')"
             },
+            {
+              "kind": "field",
+              "name": "_stepsCollapsed",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Side panels tucked away via their edge chevrons."
+            },
+            {
+              "kind": "field",
+              "name": "_sideCollapsed",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
             {
               "kind": "field",
               "name": "_movingNodeId",
@@ -13418,6 +13447,132 @@
               "privacy": "private",
               "readonly": true
             },
+            {
+              "kind": "field",
+              "name": "_autoSaveTimer",
+              "type": {
+                "text": "number | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_statusTimer",
+              "type": {
+                "text": "number | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_justSavedTimer",
+              "type": {
+                "text": "number | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_restoring",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Guards the restore prompt from re-triggering on restoreAutoSave's own setState."
+            },
+            {
+              "kind": "field",
+              "name": "_lastSavedAt",
+              "type": {
+                "text": "number | null"
+              },
+              "privacy": "private",
+              "default": "null",
+              "description": "Epoch of the newest auto-save (also picked up from storage on start)."
+            },
+            {
+              "kind": "field",
+              "name": "_justSaved",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Briefly true right after a save — flashes \"Auto-saved\" in the status pill."
+            },
+            {
+              "kind": "field",
+              "name": "_statusNow",
+              "privacy": "private",
+              "description": "Re-render clock for the \"last saved Xm ago\" label."
+            },
+            {
+              "kind": "field",
+              "name": "_restorePrompt",
+              "type": {
+                "text": "{ savedAt: number } | null"
+              },
+              "privacy": "private",
+              "default": "null",
+              "description": "A fresh auto-save differing from the loaded flow — offer to restore it."
+            },
+            {
+              "kind": "field",
+              "name": "_autoSaveKey",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "description": "localStorage key for this builder's auto-saves — its id, else its heading.",
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "_stopAutoSave",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_restartAutoSave",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_autoSaveTick",
+              "privacy": "private",
+              "description": "An empty canvas is never saved — it would clobber a stored flow with nothing."
+            },
+            {
+              "kind": "method",
+              "name": "_readAutoSave",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "{ savedAt: number; state: FlowState } | null"
+                }
+              },
+              "description": "The stored auto-save, purging it when past its TTL (or unreadable)."
+            },
+            {
+              "kind": "method",
+              "name": "restoreAutoSave",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "description": "Load the auto-saved flow, if one exists within the 1-day TTL."
+            },
+            {
+              "kind": "method",
+              "name": "_offerRestoreIfNewer",
+              "privacy": "private",
+              "description": "A flow was just loaded — when a fresh auto-save differs from it, ask the\nuser whether to pick up their draft instead."
+            },
             {
               "kind": "field",
               "name": "_onKeyDown",
@@ -13442,6 +13597,91 @@
                 }
               ]
             },
+            {
+              "kind": "method",
+              "name": "_parseFilterOptions",
+              "privacy": "private",
+              "static": true,
+              "return": {
+                "type": {
+                  "text": "FlowFilterOption[] | undefined"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "attr",
+                  "type": {
+                    "text": "string | null"
+                  }
+                }
+              ],
+              "description": "Parse an operator / option list: a JSON array (strings or `{value,label}`) or comma-separated values."
+            },
+            {
+              "kind": "method",
+              "name": "_nestedFilterOptions",
+              "privacy": "private",
+              "static": true,
+              "return": {
+                "type": {
+                  "text": "FlowFilterOption[] | undefined"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "el",
+                  "type": {
+                    "text": "Element"
+                  }
+                },
+                {
+                  "name": "tag",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Option list declared as child elements — the tidy form. The element's text\nis the label; a `value` attribute overrides the stored value:\n`<zn-flow-operator value=\"gte\">at least</zn-flow-operator>`."
+            },
+            {
+              "kind": "method",
+              "name": "_filterFieldFromEl",
+              "privacy": "private",
+              "static": true,
+              "return": {
+                "type": {
+                  "text": "FlowFilterField | null"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "el",
+                  "type": {
+                    "text": "Element"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_parseBranchFilters",
+              "privacy": "private",
+              "static": true,
+              "return": {
+                "type": {
+                  "text": "FlowBranchFilter[] | undefined"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "el",
+                  "type": {
+                    "text": "Element"
+                  }
+                }
+              ],
+              "description": "A step's branch filters: the `branch-filters` JSON attribute, or nested\n`<zn-flow-filter>` declarations each holding `<zn-flow-filter-field>`s."
+            },
             {
               "kind": "method",
               "name": "_typeFromStep",
@@ -13528,6 +13768,16 @@
                 "text": "string"
               }
             },
+            {
+              "kind": "method",
+              "name": "toJSON",
+              "return": {
+                "type": {
+                  "text": "FlowState"
+                }
+              },
+              "description": "The full flow state — nodes with their positions, connections, branch\ndata, and notes — ready for persisting. Lets `JSON.stringify(builder)`\nserialize the flow directly, e.g. as a POST body."
+            },
             {
               "kind": "field",
               "name": "undo"
@@ -14064,6 +14314,32 @@
               ],
               "description": "Replace one of the node's output ports (per-instance override), keeping its id."
             },
+            {
+              "kind": "method",
+              "name": "_saveBranchConditions",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "node",
+                  "type": {
+                    "text": "FlowNodeInstance"
+                  }
+                },
+                {
+                  "name": "port",
+                  "type": {
+                    "text": "FlowPort"
+                  }
+                },
+                {
+                  "name": "conditions",
+                  "type": {
+                    "text": "FlowBranchConditions"
+                  }
+                }
+              ],
+              "description": "Persist the built-in conditions editor's draft onto the branch and close it. Undoable."
+            },
             {
               "kind": "method",
               "name": "_renderBranchEditor",
@@ -14098,6 +14374,16 @@
               "name": "_renderSidebar",
               "privacy": "private"
             },
+            {
+              "kind": "method",
+              "name": "_renderAutoSaveStatus",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_renderRestorePrompt",
+              "privacy": "private"
+            },
             {
               "kind": "method",
               "name": "_renderPicker",
@@ -14148,6 +14434,15 @@
               "default": "''",
               "fieldName": "subheading"
             },
+            {
+              "name": "auto-save",
+              "type": {
+                "text": "number | null"
+              },
+              "default": "null",
+              "description": "Auto-save the flow to localStorage (1-day TTL). Omit to disable. A bare\n`auto-save` saves every 5 minutes; a numeric value sets the interval in\nminutes (`auto-save=\"5\"`). Restore with `restoreAutoSave()`.",
+              "fieldName": "autoSave"
+            },
             {
               "name": "entrypoints-hint",
               "type": {
@@ -14190,7 +14485,7 @@
           "tagNameWithoutPrefix": "flow-builder",
           "tagName": "zn-flow-builder",
           "customElement": true,
-          "jsDoc": "/**\n * @summary A drag-and-drop visual flow builder: steps panel, pan/zoom canvas, and a config inspector.\n * @documentation https://zinc.style/components/flow-builder\n * @status experimental\n * @since 1.0\n *\n * @dependency zn-icon\n * @dependency zn-input\n * @dependency zn-tabs\n * @dependency zn-navbar\n * @dependency zn-flow-canvas\n * @dependency zn-flow-node\n *\n * @event zn-flow-change - Emitted whenever the flow state changes. `event.detail.state` is the new FlowState.\n * @event zn-flow-selection-change - Emitted when the selected node changes. `event.detail.nodeId`.\n * @event zn-flow-connect - Emitted when a connection is created. `event.detail.connection`.\n *\n * @slot - `<zn-flow-step>` type declarations; never displayed, each `group`/`category` routes the\n *   step into the right tab and collapsible grouping of the rendered panel.\n * @slot header-left - Actions shown on the left of the header bar (e.g. Close / Undo All Changes).\n * @slot header-right - Actions shown on the right of the header bar (e.g. Apply Changes).\n * @slot sidebar - Extra right-panel content (status, version history), below the configuration errors.\n *\n * @csspart base - The grid wrapper.\n * @csspart header - The full-width header action bar (only rendered when header slots are filled).\n * @csspart steps - The left steps panel.\n * @csspart inspector - The right panel while a node or branch is selected.\n */",
+          "jsDoc": "/**\n * @summary A drag-and-drop visual flow builder: steps panel, pan/zoom canvas, and a config inspector.\n * @documentation https://zinc.style/components/flow-builder\n * @status experimental\n * @since 1.0\n *\n * @dependency zn-icon\n * @dependency zn-input\n * @dependency zn-tabs\n * @dependency zn-navbar\n * @dependency zn-flow-branch-conditions\n * @dependency zn-flow-canvas\n * @dependency zn-flow-node\n *\n * @event zn-flow-change - Emitted whenever the flow state changes. `event.detail.state` is the new FlowState.\n * @event zn-flow-selection-change - Emitted when the selected node changes. `event.detail.nodeId`.\n * @event zn-flow-connect - Emitted when a connection is created. `event.detail.connection`.\n *\n * @slot - `<zn-flow-step>` type declarations; never displayed, each `group`/`category` routes the\n *   step into the right tab and collapsible grouping of the rendered panel. A step may nest\n *   `<zn-flow-filter>` declarations (each holding `<zn-flow-filter-field>`s, whose operator /\n *   option choices are nested `<zn-flow-operator>` / `<zn-flow-option>` elements) — or set a\n *   `branch-filters` JSON attribute — to drive the built-in branch conditions editor.\n * @slot header-left - Actions shown on the left of the header bar (e.g. Close / Undo All Changes).\n * @slot header-right - Actions shown on the right of the header bar (e.g. Apply Changes).\n * @slot sidebar - Extra right-panel content (status, version history), below the configuration errors.\n *\n * @csspart base - The grid wrapper.\n * @csspart header - The full-width header action bar (only rendered when header slots are filled).\n * @csspart steps - The left steps panel.\n * @csspart inspector - The right panel while a node or branch is selected.\n */",
           "documentation": "https://zinc.style/components/flow-builder",
           "status": "experimental",
           "since": "1.0",
@@ -14199,6 +14494,7 @@
             "zn-input",
             "zn-tabs",
             "zn-navbar",
+            "zn-flow-branch-conditions",
             "zn-flow-canvas",
             "zn-flow-node"
           ]
@@ -15834,19 +16130,6 @@
               "kind": "method",
               "name": "_handleTriggerClick",
               "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "_handleTriggerKeyDown",
-              "privacy": "private",
-              "parameters": [
-                {
-                  "name": "event",
-                  "type": {
-                    "text": "KeyboardEvent"
-                  }
-                }
-              ]
             }
           ],
           "attributes": [
@@ -23608,6 +23891,1189 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "components/page-builder/page-builder.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "ZnPageBuilder",
+          "cssParts": [
+            {
+              "description": "The grid wrapper.",
+              "name": "base"
+            },
+            {
+              "description": "The full-width header action bar (only rendered when header slots are filled).",
+              "name": "header"
+            },
+            {
+              "description": "The left palette panel.",
+              "name": "palette"
+            },
+            {
+              "description": "The centre section-card canvas.",
+              "name": "canvas"
+            },
+            {
+              "description": "The right panel while a section is selected.",
+              "name": "inspector"
+            }
+          ],
+          "slots": [
+            {
+              "description": "`<template type=\"…\">` declarations; never displayed. Each template's attributes (type, label, icon, icon-library, color, category, description, slots, accepts) declare a palette entry and its content declares the inspector form for that type. `slots` makes the section a container with that many child slots; `accepts` is a comma-separated list of the type keys its slots allow.",
+              "name": "config"
+            },
+            {
+              "description": "Actions shown on the left of the header bar.",
+              "name": "header-left"
+            },
+            {
+              "description": "Actions shown on the right of the header bar.",
+              "name": "header-right"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "dependencies",
+              "type": {
+                "text": "object"
+              },
+              "static": true,
+              "default": "{ 'zn-collapsible': ZnCollapsible, 'zn-icon': ZnIcon, 'zn-input': ZnInput, 'zn-page-palette-item': ZnPagePaletteItem, 'zn-page-section-card': ZnPageSectionCard, }"
+            },
+            {
+              "kind": "field",
+              "name": "config",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The page state as a JSON string. Parsed on set; invalid JSON is ignored with a warning.",
+              "attribute": "config"
+            },
+            {
+              "kind": "field",
+              "name": "heading",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "attribute": "heading",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "subheading",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "attribute": "subheading",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "sectionTypes",
+              "type": {
+                "text": "PageSectionType[]"
+              },
+              "default": "[]",
+              "description": "Section types to make available, registered into the internal registry."
+            },
+            {
+              "kind": "field",
+              "name": "paletteCollapsed",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Collapses the left palette. Auto-set when the builder becomes narrow.",
+              "attribute": "palette-collapsed",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "inspectorCollapsed",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Collapses the inspector while a section is selected.",
+              "attribute": "inspector-collapsed",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "autoSave",
+              "type": {
+                "text": "number | null"
+              },
+              "default": "null",
+              "description": "Auto-save the page to localStorage (1-day TTL). Omit to disable. A bare\n`auto-save` saves every 5 minutes; a numeric value sets the interval in\nminutes (`auto-save=\"2\"`). Restore with `restoreAutoSave()`.",
+              "attribute": "auto-save"
+            },
+            {
+              "kind": "field",
+              "name": "registry",
+              "privacy": "private",
+              "default": "new PageSectionRegistry()"
+            },
+            {
+              "kind": "field",
+              "name": "_state",
+              "type": {
+                "text": "PageState"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_selectedId",
+              "type": {
+                "text": "string | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_search",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "default": "''"
+            },
+            {
+              "kind": "field",
+              "name": "_pickerIndex",
+              "type": {
+                "text": "number | null"
+              },
+              "privacy": "private",
+              "default": "null",
+              "description": "Index of the drop zone whose \"+\" type picker is open, if any."
+            },
+            {
+              "kind": "field",
+              "name": "_dragOverIndex",
+              "type": {
+                "text": "number | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_slotDragOver",
+              "type": {
+                "text": "{containerId: string; index: number} | null"
+              },
+              "privacy": "private",
+              "default": "null",
+              "description": "The container slot a drag is currently over, if any."
+            },
+            {
+              "kind": "field",
+              "name": "_slotPicker",
+              "type": {
+                "text": "{containerId: string; index: number} | null"
+              },
+              "privacy": "private",
+              "default": "null",
+              "description": "The container slot whose \"+\" type picker is open, if any."
+            },
+            {
+              "kind": "field",
+              "name": "_form",
+              "type": {
+                "text": "HTMLDivElement | null"
+              },
+              "privacy": "private",
+              "default": "null",
+              "description": "The stamped config form for the selected section; rebuilt on selection change."
+            },
+            {
+              "kind": "field",
+              "name": "_hasSlot",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new HasSlotController(this, 'header-left', 'header-right')"
+            },
+            {
+              "kind": "field",
+              "name": "_history",
+              "type": {
+                "text": "PageState[]"
+              },
+              "privacy": "private",
+              "default": "[]"
+            },
+            {
+              "kind": "field",
+              "name": "_redoStack",
+              "type": {
+                "text": "PageState[]"
+              },
+              "privacy": "private",
+              "default": "[]"
+            },
+            {
+              "kind": "field",
+              "name": "state",
+              "type": {
+                "text": "PageState"
+              },
+              "description": "Replaces the page state wholesale (does not emit zn-page-change)."
+            },
+            {
+              "kind": "method",
+              "name": "handleConfigChange"
+            },
+            {
+              "kind": "method",
+              "name": "handleSectionTypesChange"
+            },
+            {
+              "kind": "method",
+              "name": "registerSectionType",
+              "return": {
+                "type": {
+                  "text": "this"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "type",
+                  "type": {
+                    "text": "PageSectionType"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "registerSectionTypes",
+              "return": {
+                "type": {
+                  "text": "this"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "types",
+                  "type": {
+                    "text": "PageSectionType[]"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "field",
+              "name": "_wasNarrow",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Auto-collapses the palette when the builder crosses into narrow — only on the\ncrossing, so re-expanding while narrow stays a user choice."
+            },
+            {
+              "kind": "field",
+              "name": "_resizeObserver",
+              "privacy": "private",
+              "default": "new ResizeObserver(entries => { const width = entries[0]?.contentRect.width ?? 0; if (width <= 0) return; const narrow = width < NARROW_WIDTH; if (narrow && !this._wasNarrow) this.paletteCollapsed = true; this._wasNarrow = narrow; })"
+            },
+            {
+              "kind": "field",
+              "name": "_autoSaveTimer",
+              "type": {
+                "text": "number | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_statusTimer",
+              "type": {
+                "text": "number | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_justSavedTimer",
+              "type": {
+                "text": "number | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_restoring",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Guards the restore prompt from re-triggering on restoreAutoSave's own state install."
+            },
+            {
+              "kind": "field",
+              "name": "_lastSavedAt",
+              "type": {
+                "text": "number | null"
+              },
+              "privacy": "private",
+              "default": "null",
+              "description": "Epoch of the newest auto-save (also picked up from storage on start)."
+            },
+            {
+              "kind": "field",
+              "name": "_justSaved",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Briefly true right after a save — flashes \"Auto-saved\" in the status pill."
+            },
+            {
+              "kind": "field",
+              "name": "_statusNow",
+              "privacy": "private",
+              "description": "Re-render clock for the \"last saved Xm ago\" label."
+            },
+            {
+              "kind": "field",
+              "name": "_restorePrompt",
+              "type": {
+                "text": "{savedAt: number} | null"
+              },
+              "privacy": "private",
+              "default": "null",
+              "description": "A fresh auto-save differing from the loaded page — offer to restore it."
+            },
+            {
+              "kind": "field",
+              "name": "_autoSaveKey",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "description": "localStorage key for this builder's auto-saves — its id, else its heading.",
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "_stopAutoSave",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_restartAutoSave",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_autoSaveTick",
+              "privacy": "private",
+              "description": "An empty page is never saved — it would clobber a stored page with nothing."
+            },
+            {
+              "kind": "method",
+              "name": "_readAutoSave",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "{savedAt: number; state: PageState} | null"
+                }
+              },
+              "description": "The stored auto-save, purging it when past its TTL (or unreadable)."
+            },
+            {
+              "kind": "field",
+              "name": "restoreAutoSave",
+              "description": "Load the auto-saved page, if one exists within the 1-day TTL."
+            },
+            {
+              "kind": "method",
+              "name": "_offerRestoreIfNewer",
+              "privacy": "private",
+              "description": "A page was just loaded — when a fresh auto-save differs from it, ask the\nuser whether to pick up their draft instead."
+            },
+            {
+              "kind": "method",
+              "name": "_typeFromTemplate",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "PageSectionType | null"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "el",
+                  "type": {
+                    "text": "HTMLTemplateElement"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "field",
+              "name": "_registerSlottedTemplates",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_applyExternalState",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "next",
+                  "type": {
+                    "text": "PageState"
+                  }
+                }
+              ],
+              "description": "Normalises and installs an externally provided state; resets selection."
+            },
+            {
+              "kind": "method",
+              "name": "_findSection",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "PageSection | undefined"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "id",
+                  "type": {
+                    "text": "string | null"
+                  }
+                }
+              ],
+              "description": "Finds a section by id, searching top-level sections and slotted children."
+            },
+            {
+              "kind": "method",
+              "name": "_patchSection",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "PageSection[]"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "id",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "patch",
+                  "type": {
+                    "text": "(s: PageSection) => PageSection"
+                  }
+                }
+              ],
+              "description": "New sections array with the section patched wherever it lives (top level or slot)."
+            },
+            {
+              "kind": "method",
+              "name": "_extract",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "[PageSection | undefined, PageSection[]]"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "id",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Detaches a section wherever it lives: removed from the top level, or its slot nulled."
+            },
+            {
+              "kind": "method",
+              "name": "_commit",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "next",
+                  "type": {
+                    "text": "PageState"
+                  }
+                }
+              ],
+              "description": "Installs a new state from a user edit and notifies listeners."
+            },
+            {
+              "kind": "method",
+              "name": "_selectedSection",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "PageSection | undefined"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_select",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "id",
+                  "type": {
+                    "text": "string | null"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_pushHistory",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "undo"
+            },
+            {
+              "kind": "field",
+              "name": "redo"
+            },
+            {
+              "kind": "method",
+              "name": "addSection",
+              "return": {
+                "type": {
+                  "text": "PageSection | null"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "type",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "index",
+                  "optional": true,
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "description": "Adds a section of a registered type at `index` (default: end). Returns null for unknown types."
+            },
+            {
+              "kind": "method",
+              "name": "addSectionToSlot",
+              "return": {
+                "type": {
+                  "text": "PageSection | null"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "type",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "containerId",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "slotIndex",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "description": "Adds a new section of a registered type into a container's slot. Returns null if not allowed."
+            },
+            {
+              "kind": "method",
+              "name": "_removeSection",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "id",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_duplicateSection",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "id",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_moveSection",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "id",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "index",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "description": "Moves a section (top-level or slotted) to a top-level position."
+            },
+            {
+              "kind": "method",
+              "name": "_moveToSlot",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "id",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "containerId",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "slotIndex",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "description": "Moves a section into a container's slot. Dropping onto an occupied slot swaps\nthe two children (slot-to-slot reordering); top-level sections and containers\nonly enter empty slots / never enter slots respectively."
+            },
+            {
+              "kind": "method",
+              "name": "_onCardDragStart",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "DragEvent"
+                  }
+                },
+                {
+                  "name": "id",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_isPageDrag",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "DragEvent"
+                  }
+                }
+              ],
+              "description": "Whether a drag carries one of the builder's own payloads."
+            },
+            {
+              "kind": "method",
+              "name": "_onSlotDragOver",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "DragEvent"
+                  }
+                },
+                {
+                  "name": "containerId",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "index",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_onSlotDrop",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "DragEvent"
+                  }
+                },
+                {
+                  "name": "containerId",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "index",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_onZoneDragOver",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "DragEvent"
+                  }
+                },
+                {
+                  "name": "index",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_onZoneDrop",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "DragEvent"
+                  }
+                },
+                {
+                  "name": "index",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "field",
+              "name": "_onCanvasDragOver",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_onCanvasDrop",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_onCardKeydown",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "KeyboardEvent"
+                  }
+                },
+                {
+                  "name": "id",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_renderPalette",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_renderPaletteItem",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "type",
+                  "type": {
+                    "text": "PageSectionType"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_renderAutoSaveStatus",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_renderRestorePrompt",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_renderCanvas",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_renderSectionCard",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "section",
+                  "type": {
+                    "text": "PageSection"
+                  }
+                },
+                {
+                  "name": "drop",
+                  "type": {
+                    "text": "{over: (e: DragEvent) => void; drop: (e: DragEvent) => void}"
+                  }
+                },
+                {
+                  "name": "extraClass",
+                  "default": "''"
+                }
+              ],
+              "description": "The one card template both the page list and slot cells render."
+            },
+            {
+              "kind": "method",
+              "name": "_renderCard",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "section",
+                  "type": {
+                    "text": "PageSection"
+                  }
+                },
+                {
+                  "name": "index",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_renderSlot",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "container",
+                  "type": {
+                    "text": "PageSection"
+                  }
+                },
+                {
+                  "name": "child",
+                  "type": {
+                    "text": "PageSection | null"
+                  }
+                },
+                {
+                  "name": "index",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_slotTypes",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "PageSectionType[]"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "container",
+                  "type": {
+                    "text": "PageSection"
+                  }
+                }
+              ],
+              "description": "Types allowed in a container's slots: non-containers, filtered by its accepts list."
+            },
+            {
+              "kind": "method",
+              "name": "_renderTypePicker",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "types",
+                  "type": {
+                    "text": "PageSectionType[]"
+                  }
+                },
+                {
+                  "name": "pick",
+                  "type": {
+                    "text": "(type: string) => void"
+                  }
+                }
+              ],
+              "description": "The one type-picker template both drop zones and slot cells render."
+            },
+            {
+              "kind": "method",
+              "name": "_renderDropZone",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "index",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_buildInspectorForm",
+              "privacy": "private",
+              "description": "Clones the selected type's config template into a live form and prefills each\n`[name]` control from the section's data. The element is rendered directly by\nLit (`${this._form}`) so user-entered values survive unrelated re-renders."
+            },
+            {
+              "kind": "method",
+              "name": "_isBooleanControl",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "control",
+                  "type": {
+                    "text": "HTMLElement"
+                  }
+                },
+                {
+                  "name": "value",
+                  "type": {
+                    "text": "unknown"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "field",
+              "name": "_onInspectorInput",
+              "privacy": "private",
+              "description": "Handles change/input events bubbling from stamped form controls."
+            },
+            {
+              "kind": "method",
+              "name": "_updateSectionData",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "id",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "patch",
+                  "type": {
+                    "text": "Record<string, unknown>"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_renameSection",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "id",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "label",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_renderInspector",
+              "privacy": "private"
+            }
+          ],
+          "events": [
+            {
+              "description": "Emitted whenever the page state changes. `event.detail.state` is the new PageState.",
+              "name": "zn-page-change"
+            },
+            {
+              "description": "Emitted when the selected section changes. `event.detail.sectionId`.",
+              "name": "zn-page-selection-change"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "config",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The page state as a JSON string. Parsed on set; invalid JSON is ignored with a warning.",
+              "fieldName": "config"
+            },
+            {
+              "name": "heading",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "heading"
+            },
+            {
+              "name": "subheading",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "subheading"
+            },
+            {
+              "name": "palette-collapsed",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Collapses the left palette. Auto-set when the builder becomes narrow.",
+              "fieldName": "paletteCollapsed"
+            },
+            {
+              "name": "inspector-collapsed",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Collapses the inspector while a section is selected.",
+              "fieldName": "inspectorCollapsed"
+            },
+            {
+              "name": "auto-save",
+              "type": {
+                "text": "number | null"
+              },
+              "default": "null",
+              "description": "Auto-save the page to localStorage (1-day TTL). Omit to disable. A bare\n`auto-save` saves every 5 minutes; a numeric value sets the interval in\nminutes (`auto-save=\"2\"`). Restore with `restoreAutoSave()`.",
+              "fieldName": "autoSave"
+            }
+          ],
+          "superclass": {
+            "name": "ZincElement",
+            "module": "/src/internal/zinc-element"
+          },
+          "summary": "A config-driven page composer: a palette of predefined section types, a linear\ncanvas of section cards, and an inspector for editing each section's content.",
+          "tagNameWithoutPrefix": "page-builder",
+          "tagName": "zn-page-builder",
+          "customElement": true,
+          "jsDoc": "/**\n * @summary A config-driven page composer: a palette of predefined section types, a linear\n *   canvas of section cards, and an inspector for editing each section's content.\n * @documentation https://zinc.style/components/page-builder\n * @status experimental\n * @since 1.0\n *\n * @dependency zn-collapsible\n * @dependency zn-icon\n * @dependency zn-input\n * @dependency zn-page-palette-item\n * @dependency zn-page-section-card\n *\n * @event zn-page-change - Emitted whenever the page state changes. `event.detail.state` is the new PageState.\n * @event zn-page-selection-change - Emitted when the selected section changes. `event.detail.sectionId`.\n *\n * @slot config - `<template type=\"…\">` declarations; never displayed. Each template's attributes\n *   (type, label, icon, icon-library, color, category, description, slots, accepts) declare a\n *   palette entry and its content declares the inspector form for that type. `slots` makes the\n *   section a container with that many child slots; `accepts` is a comma-separated list of the\n *   type keys its slots allow.\n * @slot header-left - Actions shown on the left of the header bar.\n * @slot header-right - Actions shown on the right of the header bar.\n *\n * @csspart base - The grid wrapper.\n * @csspart header - The full-width header action bar (only rendered when header slots are filled).\n * @csspart palette - The left palette panel.\n * @csspart canvas - The centre section-card canvas.\n * @csspart inspector - The right panel while a section is selected.\n */",
+          "documentation": "https://zinc.style/components/page-builder",
+          "status": "experimental",
+          "since": "1.0",
+          "dependencies": [
+            "zn-collapsible",
+            "zn-icon",
+            "zn-input",
+            "zn-page-palette-item",
+            "zn-page-section-card"
+          ]
+        },
+        {
+          "kind": "variable",
+          "name": "type"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "ZnPageBuilder",
+            "module": "components/page-builder/page-builder.js"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "components/page-nav/page-nav.js",
@@ -38271,7 +39737,7 @@
   "package": {
     "name": "@kubex/zinc",
     "description": "A collection of web components for building web applications based off of @shoelace-style/Shoelace",
-    "version": "1.1.28",
+    "version": "1.1.29",
     "author": "",
     "license": "MIT"
   }