@kubex/zinc 1.1.28 → 1.1.29

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

@@ -1600,10 +1600,15 @@
     },
     {
       "name": "zn-flow-builder",
-      "description": "A drag-and-drop visual flow builder: steps panel, pan/zoom canvas, and a config inspector.\n---\n\n\n### **Events:**\n - **zn-flow-change** - Emitted whenever the flow state changes. `event.detail.state` is the new FlowState.\n- **zn-flow-selection-change** - Emitted when the selected node changes. `event.detail.nodeId`.\n- **zn-flow-connect** - Emitted when a connection is created. `event.detail.connection`.\n\n### **Slots:**\n - _default_ - `<zn-flow-step>` type declarations; never displayed, each `group`/`category` routes the step into the right tab and collapsible grouping of the rendered panel.\n- **header-left** - Actions shown on the left of the header bar (e.g. Close / Undo All Changes).\n- **header-right** - Actions shown on the right of the header bar (e.g. Apply Changes).\n- **sidebar** - Extra right-panel content (status, version history), below the configuration errors.\n\n### **CSS Parts:**\n - **base** - The grid wrapper.\n- **header** - The full-width header action bar (only rendered when header slots are filled).\n- **steps** - The left steps panel.\n- **inspector** - The right panel while a node or branch is selected.",
+      "description": "A drag-and-drop visual flow builder: steps panel, pan/zoom canvas, and a config inspector.\n---\n\n\n### **Events:**\n - **zn-flow-change** - Emitted whenever the flow state changes. `event.detail.state` is the new FlowState.\n- **zn-flow-selection-change** - Emitted when the selected node changes. `event.detail.nodeId`.\n- **zn-flow-connect** - Emitted when a connection is created. `event.detail.connection`.\n\n### **Methods:**\n - **restoreAutoSave(): _boolean_** - Load the auto-saved flow, if one exists within the 1-day TTL.\n- **toJSON(): _FlowState_** - 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.\n\n### **Slots:**\n - _default_ - `<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.\n- **header-left** - Actions shown on the left of the header bar (e.g. Close / Undo All Changes).\n- **header-right** - Actions shown on the right of the header bar (e.g. Apply Changes).\n- **sidebar** - Extra right-panel content (status, version history), below the configuration errors.\n\n### **CSS Parts:**\n - **base** - The grid wrapper.\n- **header** - The full-width header action bar (only rendered when header slots are filled).\n- **steps** - The left steps panel.\n- **inspector** - The right panel while a node or branch is selected.",
       "attributes": [
         { "name": "heading", "values": [] },
         { "name": "subheading", "values": [] },
+        {
+          "name": "auto-save",
+          "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()`.",
+          "values": []
+        },
         {
           "name": "entrypoints-hint",
           "description": "Optional hint shown beneath each steps-panel tab.",
@@ -2528,6 +2533,40 @@
         { "name": "Documentation", "url": "https://zinc.style/components/page" }
       ]
     },
+    {
+      "name": "zn-page-builder",
+      "description": "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.\n---\n\n\n### **Events:**\n - **zn-page-change** - Emitted whenever the page state changes. `event.detail.state` is the new PageState.\n- **zn-page-selection-change** - Emitted when the selected section changes. `event.detail.sectionId`.\n\n### **Methods:**\n - **addSection(type: _string_, index: _number_): _PageSection | null_** - Adds a section of a registered type at `index` (default: end). Returns null for unknown types.\n- **addSectionToSlot(type: _string_, containerId: _string_, slotIndex: _number_): _PageSection | null_** - Adds a new section of a registered type into a container's slot. Returns null if not allowed.\n\n### **Slots:**\n - **config** - `<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.\n- **header-left** - Actions shown on the left of the header bar.\n- **header-right** - Actions shown on the right of the header bar.\n\n### **CSS Parts:**\n - **base** - The grid wrapper.\n- **header** - The full-width header action bar (only rendered when header slots are filled).\n- **palette** - The left palette panel.\n- **canvas** - The centre section-card canvas.\n- **inspector** - The right panel while a section is selected.",
+      "attributes": [
+        {
+          "name": "config",
+          "description": "The page state as a JSON string. Parsed on set; invalid JSON is ignored with a warning.",
+          "values": []
+        },
+        { "name": "heading", "values": [] },
+        { "name": "subheading", "values": [] },
+        {
+          "name": "palette-collapsed",
+          "description": "Collapses the left palette. Auto-set when the builder becomes narrow.",
+          "values": []
+        },
+        {
+          "name": "inspector-collapsed",
+          "description": "Collapses the inspector while a section is selected.",
+          "values": []
+        },
+        {
+          "name": "auto-save",
+          "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()`.",
+          "values": []
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://zinc.style/components/page-builder"
+        }
+      ]
+    },
     {
       "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.",

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.28",
+  "version": "1.1.29",
   "description-markup": "markdown",
   "contributions": {
     "html": {
@@ -3731,7 +3731,7 @@
         },
         {
           "name": "zn-flow-builder",
-          "description": "A drag-and-drop visual flow builder: steps panel, pan/zoom canvas, and a config inspector.\n---\n\n\n### **Events:**\n - **zn-flow-change** - Emitted whenever the flow state changes. `event.detail.state` is the new FlowState.\n- **zn-flow-selection-change** - Emitted when the selected node changes. `event.detail.nodeId`.\n- **zn-flow-connect** - Emitted when a connection is created. `event.detail.connection`.\n\n### **Slots:**\n - _default_ - `<zn-flow-step>` type declarations; never displayed, each `group`/`category` routes the step into the right tab and collapsible grouping of the rendered panel.\n- **header-left** - Actions shown on the left of the header bar (e.g. Close / Undo All Changes).\n- **header-right** - Actions shown on the right of the header bar (e.g. Apply Changes).\n- **sidebar** - Extra right-panel content (status, version history), below the configuration errors.\n\n### **CSS Parts:**\n - **base** - The grid wrapper.\n- **header** - The full-width header action bar (only rendered when header slots are filled).\n- **steps** - The left steps panel.\n- **inspector** - The right panel while a node or branch is selected.",
+          "description": "A drag-and-drop visual flow builder: steps panel, pan/zoom canvas, and a config inspector.\n---\n\n\n### **Events:**\n - **zn-flow-change** - Emitted whenever the flow state changes. `event.detail.state` is the new FlowState.\n- **zn-flow-selection-change** - Emitted when the selected node changes. `event.detail.nodeId`.\n- **zn-flow-connect** - Emitted when a connection is created. `event.detail.connection`.\n\n### **Methods:**\n - **restoreAutoSave(): _boolean_** - Load the auto-saved flow, if one exists within the 1-day TTL.\n- **toJSON(): _FlowState_** - 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.\n\n### **Slots:**\n - _default_ - `<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.\n- **header-left** - Actions shown on the left of the header bar (e.g. Close / Undo All Changes).\n- **header-right** - Actions shown on the right of the header bar (e.g. Apply Changes).\n- **sidebar** - Extra right-panel content (status, version history), below the configuration errors.\n\n### **CSS Parts:**\n - **base** - The grid wrapper.\n- **header** - The full-width header action bar (only rendered when header slots are filled).\n- **steps** - The left steps panel.\n- **inspector** - The right panel while a node or branch is selected.",
           "doc-url": "",
           "attributes": [
             {
@@ -3742,6 +3742,11 @@
               "name": "subheading",
               "value": { "type": "string", "default": "''" }
             },
+            {
+              "name": "auto-save",
+              "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()`.",
+              "value": { "type": "number | null", "default": "null" }
+            },
             {
               "name": "entrypoints-hint",
               "description": "Optional hint shown beneath each steps-panel tab.",
@@ -3763,7 +3768,7 @@
           "slots": [
             {
               "name": "",
-              "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": "header-left",
@@ -3806,6 +3811,11 @@
                 "description": "Node ids flagged as having configuration errors (drives the red node styling).",
                 "type": "string[]"
               },
+              {
+                "name": "autoSave",
+                "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()`.",
+                "type": "number | null"
+              },
               {
                 "name": "entrypointsHint",
                 "description": "Optional hint shown beneath each steps-panel tab.",
@@ -5947,6 +5957,117 @@
             ]
           }
         },
+        {
+          "name": "zn-page-builder",
+          "description": "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.\n---\n\n\n### **Events:**\n - **zn-page-change** - Emitted whenever the page state changes. `event.detail.state` is the new PageState.\n- **zn-page-selection-change** - Emitted when the selected section changes. `event.detail.sectionId`.\n\n### **Methods:**\n - **addSection(type: _string_, index: _number_): _PageSection | null_** - Adds a section of a registered type at `index` (default: end). Returns null for unknown types.\n- **addSectionToSlot(type: _string_, containerId: _string_, slotIndex: _number_): _PageSection | null_** - Adds a new section of a registered type into a container's slot. Returns null if not allowed.\n\n### **Slots:**\n - **config** - `<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.\n- **header-left** - Actions shown on the left of the header bar.\n- **header-right** - Actions shown on the right of the header bar.\n\n### **CSS Parts:**\n - **base** - The grid wrapper.\n- **header** - The full-width header action bar (only rendered when header slots are filled).\n- **palette** - The left palette panel.\n- **canvas** - The centre section-card canvas.\n- **inspector** - The right panel while a section is selected.",
+          "doc-url": "",
+          "attributes": [
+            {
+              "name": "config",
+              "description": "The page state as a JSON string. Parsed on set; invalid JSON is ignored with a warning.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "heading",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "subheading",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "palette-collapsed",
+              "description": "Collapses the left palette. Auto-set when the builder becomes narrow.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "inspector-collapsed",
+              "description": "Collapses the inspector while a section is selected.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "auto-save",
+              "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()`.",
+              "value": { "type": "number | null", "default": "null" }
+            }
+          ],
+          "slots": [
+            {
+              "name": "config",
+              "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": "header-left",
+              "description": "Actions shown on the left of the header bar."
+            },
+            {
+              "name": "header-right",
+              "description": "Actions shown on the right of the header bar."
+            }
+          ],
+          "events": [
+            {
+              "name": "zn-page-change",
+              "description": "Emitted whenever the page state changes. `event.detail.state` is the new PageState."
+            },
+            {
+              "name": "zn-page-selection-change",
+              "description": "Emitted when the selected section changes. `event.detail.sectionId`."
+            }
+          ],
+          "js": {
+            "properties": [
+              {
+                "name": "config",
+                "description": "The page state as a JSON string. Parsed on set; invalid JSON is ignored with a warning.",
+                "type": "string"
+              },
+              { "name": "heading", "type": "string" },
+              { "name": "subheading", "type": "string" },
+              {
+                "name": "sectionTypes",
+                "description": "Section types to make available, registered into the internal registry.",
+                "type": "PageSectionType[]"
+              },
+              {
+                "name": "paletteCollapsed",
+                "description": "Collapses the left palette. Auto-set when the builder becomes narrow.",
+                "type": "boolean"
+              },
+              {
+                "name": "inspectorCollapsed",
+                "description": "Collapses the inspector while a section is selected.",
+                "type": "boolean"
+              },
+              {
+                "name": "autoSave",
+                "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()`.",
+                "type": "number | null"
+              },
+              {
+                "name": "state",
+                "description": "Replaces the page state wholesale (does not emit zn-page-change).",
+                "type": "PageState"
+              },
+              {
+                "name": "restoreAutoSave",
+                "description": "Load the auto-saved page, if one exists within the 1-day TTL."
+              },
+              { "name": "undo" },
+              { "name": "redo" }
+            ],
+            "events": [
+              {
+                "name": "zn-page-change",
+                "description": "Emitted whenever the page state changes. `event.detail.state` is the new PageState."
+              },
+              {
+                "name": "zn-page-selection-change",
+                "description": "Emitted when the selected section changes. `event.detail.sectionId`."
+              }
+            ]
+          }
+        },
         {
           "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.",