@kubex/zinc 1.1.58 → 1.1.60

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.58",
+  "version": "1.1.60",
   "description-markup": "markdown",
   "contributions": {
     "html": {
@@ -15,28 +15,6 @@
           "events": [],
           "js": { "properties": [], "events": [] }
         },
-        {
-          "name": "zn-action-bar",
-          "description": "Short summary of the component's intended use.\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
-          "doc-url": "",
-          "attributes": [],
-          "slots": [
-            { "name": "", "description": "The default slot." },
-            { "name": "example", "description": "An example slot." }
-          ],
-          "events": [
-            { "name": "zn-event-name", "description": "Emitted as an example." }
-          ],
-          "js": {
-            "properties": [],
-            "events": [
-              {
-                "name": "zn-event-name",
-                "description": "Emitted as an example."
-              }
-            ]
-          }
-        },
         {
           "name": "zn-alert",
           "description": "Short summary of the component's intended use.\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
@@ -105,6 +83,28 @@
             ]
           }
         },
+        {
+          "name": "zn-action-bar",
+          "description": "Short summary of the component's intended use.\n---\n\n\n### **Events:**\n - **zn-event-name** - Emitted as an example.\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
+          "doc-url": "",
+          "attributes": [],
+          "slots": [
+            { "name": "", "description": "The default slot." },
+            { "name": "example", "description": "An example slot." }
+          ],
+          "events": [
+            { "name": "zn-event-name", "description": "Emitted as an example." }
+          ],
+          "js": {
+            "properties": [],
+            "events": [
+              {
+                "name": "zn-event-name",
+                "description": "Emitted as an example."
+              }
+            ]
+          }
+        },
         {
           "name": "zn-animated-button",
           "description": "\n---\n\n\n### **Methods:**\n - **purchase(): _void_** - Programmatically trigger the purchase flow\n- **setSuccess(): _void_** - Set the button to success state manually\n- **setFailure(message): _void_** - Set the button to failure state manually with optional error message\n- **reset(): _void_** - Reset the button to idle state",
@@ -4822,6 +4822,11 @@
               "value": {
                 "type": "'none' | 'text' | 'decimal' | 'numeric' | 'tel' | 'search' | 'email' | 'url'"
               }
+            },
+            {
+              "name": "trigger-submit",
+              "description": "When enabled, pressing enter will always submit the surrounding form, even when the form uses\nenter-navigation to move between fields.",
+              "value": { "type": "boolean", "default": "false" }
             }
           ],
           "slots": [
@@ -5068,6 +5073,11 @@
                 "description": "Tells the browser what type of data will be entered by the user, allowing it to display the appropriate virtual\nkeyboard on supportive devices.",
                 "type": "'none' | 'text' | 'decimal' | 'numeric' | 'tel' | 'search' | 'email' | 'url'"
               },
+              {
+                "name": "triggerSubmit",
+                "description": "When enabled, pressing enter will always submit the surrounding form, even when the form uses\nenter-navigation to move between fields.",
+                "type": "boolean"
+              },
               {
                 "name": "valueAsDate",
                 "description": "Gets or sets the current value as `date` object. Returns `null` if the value can't be converted. This will use\nthe native `<input type=\"{{type}}\">` implementation and may result in an error."
@@ -8154,6 +8164,34 @@
             ]
           }
         },
+        {
+          "name": "zn-simple-chart",
+          "description": "A simple, pre-styled bar chart.\n---\n",
+          "doc-url": "",
+          "attributes": [
+            {
+              "name": "datasets",
+              "value": { "type": "{ data: number[] }[] | undefined" }
+            },
+            { "name": "labels", "value": { "type": "string[] | undefined" } },
+            {
+              "name": "enable-animations",
+              "value": { "type": "boolean | number", "default": "false" }
+            }
+          ],
+          "events": [],
+          "js": {
+            "properties": [
+              {
+                "name": "datasets",
+                "type": "{ data: number[] }[] | undefined"
+              },
+              { "name": "labels", "type": "string[] | undefined" },
+              { "name": "enableAnimations", "type": "boolean | number" }
+            ],
+            "events": []
+          }
+        },
         {
           "name": "zn-skeleton",
           "description": "Skeleton loaders provide visual placeholders while content is loading, improving perceived performance and user experience.\n---\n",
@@ -8288,34 +8326,6 @@
             ]
           }
         },
-        {
-          "name": "zn-simple-chart",
-          "description": "A simple, pre-styled bar chart.\n---\n",
-          "doc-url": "",
-          "attributes": [
-            {
-              "name": "datasets",
-              "value": { "type": "{ data: number[] }[] | undefined" }
-            },
-            { "name": "labels", "value": { "type": "string[] | undefined" } },
-            {
-              "name": "enable-animations",
-              "value": { "type": "boolean | number", "default": "false" }
-            }
-          ],
-          "events": [],
-          "js": {
-            "properties": [
-              {
-                "name": "datasets",
-                "type": "{ data: number[] }[] | undefined"
-              },
-              { "name": "labels", "type": "string[] | undefined" },
-              { "name": "enableAnimations", "type": "boolean | number" }
-            ],
-            "events": []
-          }
-        },
         {
           "name": "zn-sp",
           "description": "A flexible layout container for spacing and arranging child elements in rows or columns with configurable gap, padding, and dividers.\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.",
@@ -9550,7 +9560,7 @@
         },
         {
           "name": "zn-toggle",
-          "description": "Toggles allow the user to switch an option on or off.\n---\n\n\n### **Events:**\n - **zn-input** - Emitted when the toggle receives input.\n\n### **Slots:**\n - _default_ - The toggle's label.\n\n### **CSS Properties:**\n - **--zn-toggle-margin** - The margin around the toggle switch. Defaults to `8px 0`. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper containing the toggle switch.\n- **control** - The toggle switch control (the circular button that slides).",
+          "description": "Toggles allow the user to switch an option on or off.\n---\n\n\n### **Events:**\n - **zn-input** - Emitted when the toggle receives input.\n\n### **Slots:**\n - _default_ - The toggle's label.\n- **description** - A description of the toggle's label. Alternatively, you can use the `description` attribute.\n- **help-text** - Text that describes how to use the toggle. Alternatively, you can use the `help-text` attribute.\n\n### **CSS Properties:**\n - **--zn-toggle-margin** - The margin around the toggle switch. Defaults to `8px 0`. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper containing the toggle switch.\n- **control** - The toggle switch control (the circular button that slides).\n- **description** - The container that wraps the toggle's description.",
           "doc-url": "",
           "attributes": [
             {
@@ -9603,12 +9613,34 @@
               "value": { "type": "string", "default": "''" }
             },
             { "name": "label", "value": { "type": "string", "default": "''" } },
+            {
+              "name": "description",
+              "description": "The toggle's description, displayed under the label. If you need to display HTML, use the `description` slot instead.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "label-position",
+              "value": {
+                "type": "'top' | 'left' | 'right'",
+                "default": "'top'"
+              }
+            },
             {
               "name": "inline",
               "value": { "type": "boolean", "default": "false" }
             }
           ],
-          "slots": [{ "name": "", "description": "The toggle's label." }],
+          "slots": [
+            { "name": "", "description": "The toggle's label." },
+            {
+              "name": "description",
+              "description": "A description of the toggle's label. Alternatively, you can use the `description` attribute."
+            },
+            {
+              "name": "help-text",
+              "description": "Text that describes how to use the toggle. Alternatively, you can use the `help-text` attribute."
+            }
+          ],
           "events": [
             {
               "name": "zn-input",
@@ -9634,6 +9666,12 @@
               { "name": "onText", "type": "string" },
               { "name": "offText", "type": "string" },
               { "name": "label", "type": "string" },
+              {
+                "name": "description",
+                "description": "The toggle's description, displayed under the label. If you need to display HTML, use the `description` slot instead.",
+                "type": "string"
+              },
+              { "name": "labelPosition", "type": "'top' | 'left' | 'right'" },
               { "name": "inline", "type": "boolean" },
               { "name": "validity" },
               { "name": "validationMessage" }

package/dist/zn.d.ts

@@ -1309,14 +1309,18 @@ declare module "components/toggle/toggle.component" {
      * @event zn-input - Emitted when the toggle receives input.
      *
      * @slot - The toggle's label.
+     * @slot description - A description of the toggle's label. Alternatively, you can use the `description` attribute.
+     * @slot help-text - Text that describes how to use the toggle. Alternatively, you can use the `help-text` attribute.
      *
      * @csspart base - The component's base wrapper containing the toggle switch.
      * @csspart control - The toggle switch control (the circular button that slides).
+     * @csspart description - The container that wraps the toggle's description.
      *
      * @cssproperty --zn-toggle-margin - The margin around the toggle switch. Defaults to `8px 0`.
      */
     export default class ZnToggle extends ZincElement implements ZincFormControl {
         static styles: CSSResultGroup;
+        private readonly hasSlotController;
         private readonly formControlController;
         input: HTMLInputElement;
         hasFocus: boolean;
@@ -1335,6 +1339,9 @@ declare module "components/toggle/toggle.component" {
         onText: string;
         offText: string;
         label: string;
+        /** The toggle's description, displayed under the label. If you need to display HTML, use the `description` slot instead. */
+        description: string;
+        labelPosition: 'top' | 'left' | 'right';
         inline: boolean;
         get validity(): ValidityState;
         get validationMessage(): string;
@@ -1999,6 +2006,11 @@ declare module "components/input/input.component" {
          * keyboard on supportive devices.
          */
         inputmode: 'none' | 'text' | 'decimal' | 'numeric' | 'tel' | 'search' | 'email' | 'url';
+        /**
+         * When enabled, pressing enter will always submit the surrounding form, even when the form uses
+         * enter-navigation to move between fields.
+         */
+        triggerSubmit: boolean;
         /**
          * Gets or sets the current value as `date` object. Returns `null` if the value can't be converted. This will use
          * the native `<input type="{{type}}">` implementation and may result in an error.