@kubex/zinc 1.1.154 → 1.1.155

package/dist/custom-elements.json

@@ -28460,7 +28460,7 @@
                 "text": "object"
               },
               "static": true,
-              "default": "{ 'zn-collapsible': ZnCollapsible, 'zn-icon': ZnIcon, 'zn-input': ZnInput, 'zn-page-palette-item': ZnPagePaletteItem, 'zn-page-section-card': ZnPageSectionCard, }"
+              "default": "{ 'zn-collapsible': ZnCollapsible, 'zn-icon': ZnIcon, 'zn-input': ZnInput, 'zn-option': ZnOption, 'zn-page-palette-item': ZnPagePaletteItem, 'zn-page-section-card': ZnPageSectionCard, 'zn-select': ZnSelect, }"
             },
             {
               "kind": "field",
@@ -28527,7 +28527,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "Section type key that must lead the page. The builder hoists an existing section of\nthat type to the top, or inserts an empty one, and pins it there: it can't be\nremoved, reordered or dragged into a slot, and nothing can be dropped above it.\nIts content stays fully editable in the inspector.",
+              "description": "Section type keys that may lead the page, comma separated. The builder hoists an\nexisting section of any of them to the top, or inserts an empty one of the first,\nand pins it there: it can't be removed, reordered or dragged into a slot, and\nnothing can be dropped above it. Its content stays fully editable in the\ninspector, which offers a swap between the allowed types when there is more\nthan one.",
               "attribute": "required-first",
               "reflects": true
             },
@@ -29043,6 +29043,16 @@
               "description": "Id of the section pinned to the top of the page, or null when `required-first`\nis unset. Derived from the state rather than stored on it, so nothing about the\nlock leaks into the persisted config.",
               "readonly": true
             },
+            {
+              "kind": "field",
+              "name": "_requiredFirstTypes",
+              "type": {
+                "text": "string[]"
+              },
+              "privacy": "private",
+              "description": "The types `required-first` allows to lead the page, in the order given.",
+              "readonly": true
+            },
             {
               "kind": "method",
               "name": "_isPinned",
@@ -29061,6 +29071,16 @@
                 }
               ]
             },
+            {
+              "kind": "field",
+              "name": "_canUnpin",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "description": "Whether the pinned section may be removed: only while another section can take\nthe lead in its place, so the page is never left without one. It stays undraggable\neither way — the replacement arrives by removing this one, not by reordering.",
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "_firstFreeIndex",
@@ -29088,7 +29108,7 @@
                   }
                 }
               ],
-              "description": "Sections reordered so `required-first` leads the page: an existing section of that\ntype is hoisted to the front, otherwise an empty one is prepended. Returns the\nargument unchanged when there is nothing to do, so callers can compare by identity."
+              "description": "Sections reordered so `required-first` leads the page: an existing section of an\nallowed type is hoisted to the front, otherwise an empty one of the first type is\nprepended. Returns the\nargument unchanged when there is nothing to do, so callers can compare by identity."
             },
             {
               "kind": "method",
@@ -29843,6 +29863,20 @@
                 }
               ]
             },
+            {
+              "kind": "method",
+              "name": "_swapPinnedType",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "type",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Retypes the pinned section, keeping its id, name and data so the copy shared by\nthe allowed types survives; keys the new type has no field for stay unread. The\ninspector form is stamped from the type's template, so it is rebuilt by hand —\nselection has not changed."
+            },
             {
               "kind": "method",
               "name": "_renameSection",
@@ -29901,6 +29935,20 @@
               "name": "_onResizeKey",
               "privacy": "private"
             },
+            {
+              "kind": "method",
+              "name": "_renderSwapControl",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "section",
+                  "type": {
+                    "text": "PageSection"
+                  }
+                }
+              ],
+              "description": "Offered on the pinned section alone, and only where there is another type to take."
+            },
             {
               "kind": "method",
               "name": "_renderInspector",
@@ -29967,7 +30015,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "Section type key that must lead the page. The builder hoists an existing section of\nthat type to the top, or inserts an empty one, and pins it there: it can't be\nremoved, reordered or dragged into a slot, and nothing can be dropped above it.\nIts content stays fully editable in the inspector.",
+              "description": "Section type keys that may lead the page, comma separated. The builder hoists an\nexisting section of any of them to the top, or inserts an empty one of the first,\nand pins it there: it can't be removed, reordered or dragged into a slot, and\nnothing can be dropped above it. Its content stays fully editable in the\ninspector, which offers a swap between the allowed types when there is more\nthan one.",
               "fieldName": "requiredFirst"
             },
             {
@@ -53512,7 +53560,7 @@
   "package": {
     "name": "@kubex/zinc",
     "description": "A collection of web components for building web applications based off of @shoelace-style/Shoelace",
-    "version": "1.1.154",
+    "version": "1.1.155",
     "author": "",
     "license": "MIT"
   }

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

@@ -2993,7 +2993,7 @@
         { "name": "subheading", "values": [] },
         {
           "name": "required-first",
-          "description": "Section type key that must lead the page. The builder hoists an existing section of\nthat type to the top, or inserts an empty one, and pins it there: it can't be\nremoved, reordered or dragged into a slot, and nothing can be dropped above it.\nIts content stays fully editable in the inspector.",
+          "description": "Section type keys that may lead the page, comma separated. The builder hoists an\nexisting section of any of them to the top, or inserts an empty one of the first,\nand pins it there: it can't be removed, reordered or dragged into a slot, and\nnothing can be dropped above it. Its content stays fully editable in the\ninspector, which offers a swap between the allowed types when there is more\nthan one.",
           "values": []
         },
         {

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.154",
+  "version": "1.1.155",
   "description-markup": "markdown",
   "contributions": {
     "html": {
@@ -7039,7 +7039,7 @@
             },
             {
               "name": "required-first",
-              "description": "Section type key that must lead the page. The builder hoists an existing section of\nthat type to the top, or inserts an empty one, and pins it there: it can't be\nremoved, reordered or dragged into a slot, and nothing can be dropped above it.\nIts content stays fully editable in the inspector.",
+              "description": "Section type keys that may lead the page, comma separated. The builder hoists an\nexisting section of any of them to the top, or inserts an empty one of the first,\nand pins it there: it can't be removed, reordered or dragged into a slot, and\nnothing can be dropped above it. Its content stays fully editable in the\ninspector, which offers a swap between the allowed types when there is more\nthan one.",
               "value": { "type": "string", "default": "''" }
             },
             {
@@ -7103,7 +7103,7 @@
               { "name": "subheading", "type": "string" },
               {
                 "name": "requiredFirst",
-                "description": "Section type key that must lead the page. The builder hoists an existing section of\nthat type to the top, or inserts an empty one, and pins it there: it can't be\nremoved, reordered or dragged into a slot, and nothing can be dropped above it.\nIts content stays fully editable in the inspector.",
+                "description": "Section type keys that may lead the page, comma separated. The builder hoists an\nexisting section of any of them to the top, or inserts an empty one of the first,\nand pins it there: it can't be removed, reordered or dragged into a slot, and\nnothing can be dropped above it. Its content stays fully editable in the\ninspector, which offers a swap between the allowed types when there is more\nthan one.",
                 "type": "string"
               },
               {

package/dist/zn.d.ts

@@ -11696,8 +11696,10 @@ declare module "components/page-builder/page-builder.component" {
     import ZnCollapsible from "components/collapsible/index";
     import ZnIcon from "components/icon/index";
     import ZnInput from "components/input/index";
+    import ZnOption from "components/option/index";
     import ZnPagePaletteItem from "components/page-builder/modules/page-palette-item/index";
     import ZnPageSectionCard from "components/page-builder/modules/page-section-card/index";
+    import ZnSelect from "components/select/index";
     /**
      * @summary A config-driven page composer: a palette of predefined section types, a linear
      *   canvas of section cards, and an inspector for editing each section's content.
@@ -11737,8 +11739,10 @@ declare module "components/page-builder/page-builder.component" {
             'zn-collapsible': typeof ZnCollapsible;
             'zn-icon': typeof ZnIcon;
             'zn-input': typeof ZnInput;
+            'zn-option': typeof ZnOption;
             'zn-page-palette-item': typeof ZnPagePaletteItem;
             'zn-page-section-card': typeof ZnPageSectionCard;
+            'zn-select': typeof ZnSelect;
         };
         private readonly formControlController;
         /** The name of the control, submitted as a name/value pair with form data. */
@@ -11750,10 +11754,12 @@ declare module "components/page-builder/page-builder.component" {
         heading: string;
         subheading: string;
         /**
-         * Section type key that must lead the page. The builder hoists an existing section of
-         * that type to the top, or inserts an empty one, and pins it there: it can't be
-         * removed, reordered or dragged into a slot, and nothing can be dropped above it.
-         * Its content stays fully editable in the inspector.
+         * Section type keys that may lead the page, comma separated. The builder hoists an
+         * existing section of any of them to the top, or inserts an empty one of the first,
+         * and pins it there: it can't be removed, reordered or dragged into a slot, and
+         * nothing can be dropped above it. Its content stays fully editable in the
+         * inspector, which offers a swap between the allowed types when there is more
+         * than one.
          */
         requiredFirst: string;
         /** Section types to make available, registered into the internal registry. */
@@ -11870,12 +11876,21 @@ declare module "components/page-builder/page-builder.component" {
          * lock leaks into the persisted config.
          */
         private get _pinnedId();
+        /** The types `required-first` allows to lead the page, in the order given. */
+        private get _requiredFirstTypes();
         private _isPinned;
+        /**
+         * Whether the pinned section may be removed: only while another section can take
+         * the lead in its place, so the page is never left without one. It stays undraggable
+         * either way — the replacement arrives by removing this one, not by reordering.
+         */
+        private get _canUnpin();
         /** Lowest top-level index a section may be added or moved to. */
         private get _firstFreeIndex();
         /**
-         * Sections reordered so `required-first` leads the page: an existing section of that
-         * type is hoisted to the front, otherwise an empty one is prepended. Returns the
+         * Sections reordered so `required-first` leads the page: an existing section of an
+         * allowed type is hoisted to the front, otherwise an empty one of the first type is
+         * prepended. Returns the
          * argument unchanged when there is nothing to do, so callers can compare by identity.
          */
         private _requireFirst;
@@ -11971,12 +11986,21 @@ declare module "components/page-builder/page-builder.component" {
         /** Handles change/input events bubbling from stamped form controls. */
         private _onInspectorInput;
         private _updateSectionData;
+        /**
+         * Retypes the pinned section, keeping its id, name and data so the copy shared by
+         * the allowed types survives; keys the new type has no field for stay unread. The
+         * inspector form is stamped from the type's template, so it is rebuilt by hand —
+         * selection has not changed.
+         */
+        private _swapPinnedType;
         private _renameSection;
         /** Width the inspector may be dragged to, against the builder's own width. */
         private _clampInspector;
         private _inspectorRect;
         private _onResizeStart;
         private _onResizeKey;
+        /** Offered on the pinned section alone, and only where there is another type to take. */
+        private _renderSwapControl;
         private _renderInspector;
         render(): import("lit-html").TemplateResult<1>;
     }