@kubex/zinc 1.1.154 → 1.1.156

package/dist/custom-elements.json

@@ -56,6 +56,79 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "components/action-bar/action-bar.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "ZnActionBar",
+          "cssProperties": [
+            {
+              "description": "An example CSS custom property.",
+              "name": "--example"
+            }
+          ],
+          "cssParts": [
+            {
+              "description": "The component's base wrapper.",
+              "name": "base"
+            }
+          ],
+          "slots": [
+            {
+              "description": "The default slot.",
+              "name": ""
+            },
+            {
+              "description": "An example slot.",
+              "name": "example"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "localize",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new LocalizeController(this)"
+            }
+          ],
+          "events": [
+            {
+              "description": "Emitted as an example.",
+              "name": "zn-event-name"
+            }
+          ],
+          "superclass": {
+            "name": "ZincElement",
+            "module": "/src/internal/zinc-element"
+          },
+          "summary": "Short summary of the component's intended use.",
+          "tagNameWithoutPrefix": "action-bar",
+          "tagName": "zn-action-bar",
+          "customElement": true,
+          "jsDoc": "/**\n * @summary Short summary of the component's intended use.\n * @documentation https://zinc.style/components/action-bar\n * @status experimental\n * @since 1.0\n *\n * @dependency zn-example\n *\n * @event zn-event-name - Emitted as an example.\n *\n * @slot - The default slot.\n * @slot example - An example slot.\n *\n * @csspart base - The component's base wrapper.\n *\n * @cssproperty --example - An example CSS custom property.\n */",
+          "documentation": "https://zinc.style/components/action-bar",
+          "status": "experimental",
+          "since": "1.0",
+          "dependencies": [
+            "zn-example"
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "ZnActionBar",
+            "module": "components/action-bar/action-bar.js"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "components/alert/alert.js",
@@ -250,79 +323,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "components/action-bar/action-bar.js",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "",
-          "name": "ZnActionBar",
-          "cssProperties": [
-            {
-              "description": "An example CSS custom property.",
-              "name": "--example"
-            }
-          ],
-          "cssParts": [
-            {
-              "description": "The component's base wrapper.",
-              "name": "base"
-            }
-          ],
-          "slots": [
-            {
-              "description": "The default slot.",
-              "name": ""
-            },
-            {
-              "description": "An example slot.",
-              "name": "example"
-            }
-          ],
-          "members": [
-            {
-              "kind": "field",
-              "name": "localize",
-              "privacy": "private",
-              "readonly": true,
-              "default": "new LocalizeController(this)"
-            }
-          ],
-          "events": [
-            {
-              "description": "Emitted as an example.",
-              "name": "zn-event-name"
-            }
-          ],
-          "superclass": {
-            "name": "ZincElement",
-            "module": "/src/internal/zinc-element"
-          },
-          "summary": "Short summary of the component's intended use.",
-          "tagNameWithoutPrefix": "action-bar",
-          "tagName": "zn-action-bar",
-          "customElement": true,
-          "jsDoc": "/**\n * @summary Short summary of the component's intended use.\n * @documentation https://zinc.style/components/action-bar\n * @status experimental\n * @since 1.0\n *\n * @dependency zn-example\n *\n * @event zn-event-name - Emitted as an example.\n *\n * @slot - The default slot.\n * @slot example - An example slot.\n *\n * @csspart base - The component's base wrapper.\n *\n * @cssproperty --example - An example CSS custom property.\n */",
-          "documentation": "https://zinc.style/components/action-bar",
-          "status": "experimental",
-          "since": "1.0",
-          "dependencies": [
-            "zn-example"
-          ]
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "default",
-          "declaration": {
-            "name": "ZnActionBar",
-            "module": "components/action-bar/action-bar.js"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "components/animated-button/animated-button.js",
@@ -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"
             },
             {
@@ -38225,6 +38273,16 @@
               "description": "Disables click-to-toggle so the value is only revealed on hover. Clicks still bubble to the parent.",
               "attribute": "no-toggle"
             },
+            {
+              "kind": "field",
+              "name": "_isMasked",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "description": "Nothing is hidden when the revealed value is what's already on show, so there is nothing to reveal.",
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "_isRevealed",
@@ -40872,6 +40930,21 @@
               "privacy": "private",
               "description": "Filters visible options based on the current search query"
             },
+            {
+              "kind": "method",
+              "name": "updateEmptyState",
+              "privacy": "private",
+              "description": "Nothing for the user to pick: either the option list is empty or every option is filtered out.\nThe search paths track this themselves, so this covers opening a dropdown with no query."
+            },
+            {
+              "kind": "field",
+              "name": "emptyStateText",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
             {
               "kind": "method",
               "name": "clearSearch",
@@ -53512,7 +53585,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.156",
     "author": "",
     "license": "MIT"
   }

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

@@ -13,6 +13,17 @@
         }
       ]
     },
+    {
+      "name": "zn-action-bar",
+      "description": "Short summary of the component's intended use.\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
+      "attributes": [],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://zinc.style/components/action-bar"
+        }
+      ]
+    },
     {
       "name": "zn-alert",
       "description": "Short summary of the component's intended use.\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
@@ -53,17 +64,6 @@
         }
       ]
     },
-    {
-      "name": "zn-action-bar",
-      "description": "Short summary of the component's intended use.\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
-      "attributes": [],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://zinc.style/components/action-bar"
-        }
-      ]
-    },
     {
       "name": "zn-animated-button",
       "description": "\n---\n\n\n### **Methods:**\n - **purchase(): _void_** - Programmatically trigger the purchase flow\n- **setSuccess(): _void_** - Set the button to success state manually\n- **setFailure(message): _void_** - Set the button to failure state manually with optional error message\n- **reset(): _void_** - Reset the button to idle state",
@@ -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.156",
   "description-markup": "markdown",
   "contributions": {
     "html": {
@@ -15,6 +15,28 @@
           "events": [],
           "js": { "properties": [], "events": [] }
         },
+        {
+          "name": "zn-action-bar",
+          "description": "Short summary of the component's intended use.\n\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
+          "doc-url": "",
+          "attributes": [],
+          "slots": [
+            { "name": "", "description": "The default slot." },
+            { "name": "example", "description": "An example slot." }
+          ],
+          "events": [
+            { "name": "zn-event-name", "description": "Emitted as an example." }
+          ],
+          "js": {
+            "properties": [],
+            "events": [
+              {
+                "name": "zn-event-name",
+                "description": "Emitted as an example."
+              }
+            ]
+          }
+        },
         {
           "name": "zn-alert",
           "description": "Short summary of the component's intended use.\n\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
@@ -83,28 +105,6 @@
             ]
           }
         },
-        {
-          "name": "zn-action-bar",
-          "description": "Short summary of the component's intended use.\n\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
-          "doc-url": "",
-          "attributes": [],
-          "slots": [
-            { "name": "", "description": "The default slot." },
-            { "name": "example", "description": "An example slot." }
-          ],
-          "events": [
-            { "name": "zn-event-name", "description": "Emitted as an example." }
-          ],
-          "js": {
-            "properties": [],
-            "events": [
-              {
-                "name": "zn-event-name",
-                "description": "Emitted as an example."
-              }
-            ]
-          }
-        },
         {
           "name": "zn-animated-button",
           "description": "\n\n---\n\n\n### **Methods:**\n - **purchase(): _void_** - Programmatically trigger the purchase flow\n- **setSuccess(): _void_** - Set the button to success state manually\n- **setFailure(message): _void_** - Set the button to failure state manually with optional error message\n- **reset(): _void_** - Reset the button to idle state",
@@ -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

@@ -2954,6 +2954,12 @@ declare module "components/select/select.component" {
         private handleSearchInput;
         /** Filters visible options based on the current search query */
         private filterOptions;
+        /**
+         * Nothing for the user to pick: either the option list is empty or every option is filtered out.
+         * The search paths track this themselves, so this covers opening a dropdown with no query.
+         */
+        private updateEmptyState;
+        private get emptyStateText();
         /** Clears the search query and shows all options */
         private clearSearch;
         private updateOptGroupSeparators;
@@ -9156,6 +9162,8 @@ declare module "components/reveal/reveal.component" {
         hideDelay: number;
         /** Disables click-to-toggle so the value is only revealed on hover. Clicks still bubble to the parent. */
         noToggle: boolean;
+        /** Nothing is hidden when the revealed value is what's already on show, so there is nothing to reveal. */
+        private get _isMasked();
         private _isRevealed;
         private _isToggled;
         private _hideTimer?;
@@ -11696,8 +11704,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 +11747,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 +11762,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 +11884,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 +11994,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>;
     }