@kubex/zinc 1.1.58 → 1.1.59

package/dist/custom-elements.json

@@ -33542,6 +33542,128 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "components/simple-chart/simple-chart.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "ZnSimpleChart",
+          "members": [
+            {
+              "kind": "field",
+              "name": "datasets",
+              "type": {
+                "text": "{ data: number[] }[] | undefined"
+              },
+              "attribute": "datasets"
+            },
+            {
+              "kind": "field",
+              "name": "labels",
+              "type": {
+                "text": "string[] | undefined"
+              },
+              "attribute": "labels"
+            },
+            {
+              "kind": "field",
+              "name": "enableAnimations",
+              "type": {
+                "text": "boolean | number"
+              },
+              "default": "false",
+              "attribute": "enable-animations"
+            },
+            {
+              "kind": "field",
+              "name": "chart",
+              "type": {
+                "text": "ECharts | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "initPromise",
+              "type": {
+                "text": "Promise<void> | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "resizeObserver",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new ResizeController(this, { target: null, skipInitial: true, callback: () => this.chart?.resize(), })"
+            },
+            {
+              "kind": "method",
+              "name": "getUpdateComplete",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "Promise<boolean>"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "initChart",
+              "privacy": "private"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "datasets",
+              "type": {
+                "text": "{ data: number[] }[] | undefined"
+              },
+              "fieldName": "datasets"
+            },
+            {
+              "name": "labels",
+              "type": {
+                "text": "string[] | undefined"
+              },
+              "fieldName": "labels"
+            },
+            {
+              "name": "enable-animations",
+              "type": {
+                "text": "boolean | number"
+              },
+              "default": "false",
+              "fieldName": "enableAnimations"
+            }
+          ],
+          "superclass": {
+            "name": "ZincElement",
+            "module": "/src/internal/zinc-element"
+          },
+          "summary": "A simple, pre-styled bar chart.",
+          "tagNameWithoutPrefix": "simple-chart",
+          "tagName": "zn-simple-chart",
+          "customElement": true,
+          "jsDoc": "/**\n * @summary A simple, pre-styled bar chart.\n * @documentation https://zinc.style/components/simple-chart\n * @status experimental\n * @since 1.0\n */",
+          "documentation": "https://zinc.style/components/simple-chart",
+          "status": "experimental",
+          "since": "1.0"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "ZnSimpleChart",
+            "module": "components/simple-chart/simple-chart.js"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "components/skeleton/skeleton.js",
@@ -33897,128 +34019,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "components/simple-chart/simple-chart.js",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "",
-          "name": "ZnSimpleChart",
-          "members": [
-            {
-              "kind": "field",
-              "name": "datasets",
-              "type": {
-                "text": "{ data: number[] }[] | undefined"
-              },
-              "attribute": "datasets"
-            },
-            {
-              "kind": "field",
-              "name": "labels",
-              "type": {
-                "text": "string[] | undefined"
-              },
-              "attribute": "labels"
-            },
-            {
-              "kind": "field",
-              "name": "enableAnimations",
-              "type": {
-                "text": "boolean | number"
-              },
-              "default": "false",
-              "attribute": "enable-animations"
-            },
-            {
-              "kind": "field",
-              "name": "chart",
-              "type": {
-                "text": "ECharts | undefined"
-              },
-              "privacy": "private"
-            },
-            {
-              "kind": "field",
-              "name": "initPromise",
-              "type": {
-                "text": "Promise<void> | undefined"
-              },
-              "privacy": "private"
-            },
-            {
-              "kind": "field",
-              "name": "resizeObserver",
-              "privacy": "private",
-              "readonly": true,
-              "default": "new ResizeController(this, { target: null, skipInitial: true, callback: () => this.chart?.resize(), })"
-            },
-            {
-              "kind": "method",
-              "name": "getUpdateComplete",
-              "privacy": "protected",
-              "return": {
-                "type": {
-                  "text": "Promise<boolean>"
-                }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "initChart",
-              "privacy": "private"
-            }
-          ],
-          "attributes": [
-            {
-              "name": "datasets",
-              "type": {
-                "text": "{ data: number[] }[] | undefined"
-              },
-              "fieldName": "datasets"
-            },
-            {
-              "name": "labels",
-              "type": {
-                "text": "string[] | undefined"
-              },
-              "fieldName": "labels"
-            },
-            {
-              "name": "enable-animations",
-              "type": {
-                "text": "boolean | number"
-              },
-              "default": "false",
-              "fieldName": "enableAnimations"
-            }
-          ],
-          "superclass": {
-            "name": "ZincElement",
-            "module": "/src/internal/zinc-element"
-          },
-          "summary": "A simple, pre-styled bar chart.",
-          "tagNameWithoutPrefix": "simple-chart",
-          "tagName": "zn-simple-chart",
-          "customElement": true,
-          "jsDoc": "/**\n * @summary A simple, pre-styled bar chart.\n * @documentation https://zinc.style/components/simple-chart\n * @status experimental\n * @since 1.0\n */",
-          "documentation": "https://zinc.style/components/simple-chart",
-          "status": "experimental",
-          "since": "1.0"
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "default",
-          "declaration": {
-            "name": "ZnSimpleChart",
-            "module": "components/simple-chart/simple-chart.js"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "components/sp/sp.js",
@@ -38793,9 +38793,20 @@
             {
               "description": "The toggle's label.",
               "name": ""
+            },
+            {
+              "description": "Text that describes how to use the toggle. Alternatively, you can use the `help-text` attribute.",
+              "name": "help-text"
             }
           ],
           "members": [
+            {
+              "kind": "field",
+              "name": "hasSlotController",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new HasSlotController(this, 'help-text')"
+            },
             {
               "kind": "field",
               "name": "formControlController",
@@ -38956,6 +38967,16 @@
               "default": "''",
               "attribute": "label"
             },
+            {
+              "kind": "field",
+              "name": "labelPosition",
+              "type": {
+                "text": "'top' | 'left' | 'right'"
+              },
+              "default": "'top'",
+              "attribute": "label-position",
+              "reflects": true
+            },
             {
               "kind": "field",
               "name": "inline",
@@ -39190,6 +39211,14 @@
               "default": "''",
               "fieldName": "label"
             },
+            {
+              "name": "label-position",
+              "type": {
+                "text": "'top' | 'left' | 'right'"
+              },
+              "default": "'top'",
+              "fieldName": "labelPosition"
+            },
             {
               "name": "inline",
               "type": {
@@ -39207,7 +39236,7 @@
           "tagNameWithoutPrefix": "toggle",
           "tagName": "zn-toggle",
           "customElement": true,
-          "jsDoc": "/**\n * @summary Toggles allow the user to switch an option on or off.\n * @documentation https://zinc.style/components/toggle\n * @status stable\n * @since 1.0\n *\n * @dependency zn-tooltip\n *\n * @event zn-input - Emitted when the toggle receives input.\n *\n * @slot - The toggle's label.\n *\n * @csspart base - The component's base wrapper containing the toggle switch.\n * @csspart control - The toggle switch control (the circular button that slides).\n *\n * @cssproperty --zn-toggle-margin - The margin around the toggle switch. Defaults to `8px 0`.\n */",
+          "jsDoc": "/**\n * @summary Toggles allow the user to switch an option on or off.\n * @documentation https://zinc.style/components/toggle\n * @status stable\n * @since 1.0\n *\n * @dependency zn-tooltip\n *\n * @event zn-input - Emitted when the toggle receives input.\n *\n * @slot - The toggle's label.\n * @slot help-text - Text that describes how to use the toggle. Alternatively, you can use the `help-text` attribute.\n *\n * @csspart base - The component's base wrapper containing the toggle switch.\n * @csspart control - The toggle switch control (the circular button that slides).\n *\n * @cssproperty --zn-toggle-margin - The margin around the toggle switch. Defaults to `8px 0`.\n */",
           "documentation": "https://zinc.style/components/toggle",
           "status": "stable",
           "since": "1.0",
@@ -40751,7 +40780,7 @@
   "package": {
     "name": "@kubex/zinc",
     "description": "A collection of web components for building web applications based off of @shoelace-style/Shoelace",
-    "version": "1.1.58",
+    "version": "1.1.59",
     "author": "",
     "license": "MIT"
   }

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

@@ -3442,6 +3442,21 @@
         }
       ]
     },
+    {
+      "name": "zn-simple-chart",
+      "description": "A simple, pre-styled bar chart.\n---\n",
+      "attributes": [
+        { "name": "datasets", "values": [{ "name": "{ data: number[] }[]" }] },
+        { "name": "labels", "values": [{ "name": "string[]" }] },
+        { "name": "enable-animations", "values": [] }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://zinc.style/components/simple-chart"
+        }
+      ]
+    },
     {
       "name": "zn-skeleton",
       "description": "Skeleton loaders provide visual placeholders while content is loading, improving perceived performance and user experience.\n---\n",
@@ -3501,21 +3516,6 @@
         }
       ]
     },
-    {
-      "name": "zn-simple-chart",
-      "description": "A simple, pre-styled bar chart.\n---\n",
-      "attributes": [
-        { "name": "datasets", "values": [{ "name": "{ data: number[] }[]" }] },
-        { "name": "labels", "values": [{ "name": "string[]" }] },
-        { "name": "enable-animations", "values": [] }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://zinc.style/components/simple-chart"
-        }
-      ]
-    },
     {
       "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.",
@@ -4049,7 +4049,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- **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).",
       "attributes": [
         { "name": "title", "values": [] },
         { "name": "name", "values": [] },
@@ -4072,6 +4072,10 @@
         { "name": "on-text", "values": [] },
         { "name": "off-text", "values": [] },
         { "name": "label", "values": [] },
+        {
+          "name": "label-position",
+          "values": [{ "name": "top" }, { "name": "left" }, { "name": "right" }]
+        },
         { "name": "inline", "values": [] }
       ],
       "references": [

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.59",
   "description-markup": "markdown",
   "contributions": {
     "html": {
@@ -8154,6 +8154,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 +8316,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 +9550,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- **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).",
           "doc-url": "",
           "attributes": [
             {
@@ -9603,12 +9603,25 @@
               "value": { "type": "string", "default": "''" }
             },
             { "name": "label", "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": "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 +9647,7 @@
               { "name": "onText", "type": "string" },
               { "name": "offText", "type": "string" },
               { "name": "label", "type": "string" },
+              { "name": "labelPosition", "type": "'top' | 'left' | 'right'" },
               { "name": "inline", "type": "boolean" },
               { "name": "validity" },
               { "name": "validationMessage" }

package/dist/zn.d.ts

@@ -1309,6 +1309,7 @@ declare module "components/toggle/toggle.component" {
      * @event zn-input - Emitted when the toggle receives input.
      *
      * @slot - The toggle's label.
+     * @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).
@@ -1317,6 +1318,7 @@ declare module "components/toggle/toggle.component" {
      */
     export default class ZnToggle extends ZincElement implements ZincFormControl {
         static styles: CSSResultGroup;
+        private readonly hasSlotController;
         private readonly formControlController;
         input: HTMLInputElement;
         hasFocus: boolean;
@@ -1335,6 +1337,7 @@ declare module "components/toggle/toggle.component" {
         onText: string;
         offText: string;
         label: string;
+        labelPosition: 'top' | 'left' | 'right';
         inline: boolean;
         get validity(): ValidityState;
         get validationMessage(): string;