@kubex/zinc 1.0.105 → 1.0.107

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.",
@@ -48,17 +59,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",
@@ -321,15 +321,19 @@
     },
     {
       "name": "zn-chart",
-      "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.",
+      "description": "Chart component powered by Apache ECharts.\n---\n\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
       "attributes": [
+        { "name": "type", "values": [{ "name": "ChartType" }] },
+        { "name": "data", "values": [{ "name": "SeriesItem[]" }] },
+        { "name": "categories", "values": [{ "name": "string[]" }] },
         {
-          "name": "type",
-          "values": [{ "name": "area" }, { "name": "bar" }, { "name": "line" }]
+          "name": "xaxis",
+          "values": [
+            { "name": "datetime" },
+            { "name": "category" },
+            { "name": "numeric" }
+          ]
         },
-        { "name": "data", "values": [{ "name": "any[]" }] },
-        { "name": "categories", "values": [{ "name": "string[]" }] },
-        { "name": "xAxis", "values": [] },
         { "name": "d-size", "values": [] },
         { "name": "stacked", "values": [] },
         { "name": "live", "values": [] },
@@ -337,7 +341,11 @@
         { "name": "live-interval", "values": [] },
         { "name": "height", "values": [] },
         { "name": "enable-animations", "values": [] },
-        { "name": "y-axis-append", "values": [] }
+        { "name": "y-axis-append", "values": [] },
+        { "name": "colors", "values": [{ "name": "string[]" }] },
+        { "name": "sync-group", "values": [] },
+        { "name": "smooth", "values": [] },
+        { "name": "scale", "values": [] }
       ],
       "references": [
         {
@@ -1557,6 +1565,7 @@
             { "name": "textarea" }
           ]
         },
+        { "name": "textarea-rows", "values": [{ "name": "1" }] },
         {
           "name": "options",
           "values": [{ "name": "{ [key: string]: string }" }]
@@ -2989,10 +2998,11 @@
     },
     {
       "name": "zn-simple-chart",
-      "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.",
+      "description": "A simple, pre-styled bar chart.\n---\n",
       "attributes": [
-        { "name": "datasets", "values": [{ "name": "any[]" }] },
-        { "name": "labels", "values": [{ "name": "any[]" }] }
+        { "name": "datasets", "values": [{ "name": "{ data: number[] }[]" }] },
+        { "name": "labels", "values": [{ "name": "string[]" }] },
+        { "name": "enable-animations", "values": [] }
       ],
       "references": [
         {
@@ -3639,6 +3649,7 @@
             { "name": "textarea" }
           ]
         },
+        { "name": "textarea-rows", "values": [] },
         {
           "name": "grouped",
           "description": "When true, hides the individual language navbar and defers language control to a parent zn-translation-group.",

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.0.105",
+  "version": "1.0.107",
   "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### **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.",
@@ -70,28 +92,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.",
-          "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",
@@ -606,19 +606,25 @@
         },
         {
           "name": "zn-chart",
-          "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.",
+          "description": "Chart component powered by Apache ECharts.\n---\n\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
           "doc-url": "",
           "attributes": [
             {
               "name": "type",
-              "value": { "type": "'area' | 'bar' | 'line'", "default": "'bar'" }
+              "value": { "type": "ChartType", "default": "'bar'" }
+            },
+            {
+              "name": "data",
+              "value": { "type": "SeriesItem[]", "default": "[]" }
             },
-            { "name": "data", "value": { "type": "any[]", "default": "[]" } },
             {
               "name": "categories",
-              "value": { "type": "string | string[]", "default": "''" }
+              "value": { "type": "string[]", "default": "[]" }
+            },
+            {
+              "name": "xaxis",
+              "value": { "type": "'datetime' | 'category' | 'numeric'" }
             },
-            { "name": "xAxis", "value": { "type": "string" } },
             { "name": "d-size", "value": { "type": "number", "default": "1" } },
             {
               "name": "stacked",
@@ -642,38 +648,44 @@
             },
             {
               "name": "enable-animations",
+              "value": { "type": "boolean | number", "default": "false" }
+            },
+            { "name": "y-axis-append", "value": { "type": "string" } },
+            { "name": "colors", "value": { "type": "string[] | undefined" } },
+            { "name": "sync-group", "value": { "type": "string | undefined" } },
+            {
+              "name": "smooth",
               "value": { "type": "boolean", "default": "false" }
             },
-            { "name": "y-axis-append", "value": { "type": "string" } }
-          ],
-          "slots": [
-            { "name": "", "description": "The default slot." },
-            { "name": "example", "description": "An example slot." }
-          ],
-          "events": [
-            { "name": "zn-event-name", "description": "Emitted as an example." }
+            {
+              "name": "scale",
+              "value": { "type": "boolean | number", "default": "false" }
+            }
           ],
+          "events": [],
           "js": {
             "properties": [
-              { "name": "type", "type": "'area' | 'bar' | 'line'" },
-              { "name": "data", "type": "any[]" },
-              { "name": "categories", "type": "string | string[]" },
-              { "name": "xAxis", "type": "string" },
+              { "name": "type", "type": "ChartType" },
+              { "name": "data", "type": "SeriesItem[]" },
+              { "name": "categories", "type": "string[]" },
+              {
+                "name": "xAxis",
+                "type": "'datetime' | 'category' | 'numeric'"
+              },
               { "name": "datapointSize", "type": "number" },
               { "name": "stacked", "type": "boolean" },
               { "name": "live", "type": "boolean" },
               { "name": "dataUrl", "type": "string" },
               { "name": "liveInterval", "type": "number" },
               { "name": "height", "type": "number" },
-              { "name": "enableAnimations", "type": "boolean" },
-              { "name": "yAxisAppend", "type": "string" }
+              { "name": "enableAnimations", "type": "boolean | number" },
+              { "name": "yAxisAppend", "type": "string" },
+              { "name": "colors", "type": "string[] | undefined" },
+              { "name": "syncGroup", "type": "string | undefined" },
+              { "name": "smooth", "type": "boolean" },
+              { "name": "scale", "type": "boolean | number" }
             ],
-            "events": [
-              {
-                "name": "zn-event-name",
-                "description": "Emitted as an example."
-              }
-            ]
+            "events": []
           }
         },
         {
@@ -3593,6 +3605,7 @@
                 "default": "'text'"
               }
             },
+            { "name": "textarea-rows", "value": { "type": "1" } },
             {
               "name": "options",
               "value": { "type": "{ [key: string]: string }", "default": "{}" }
@@ -3671,6 +3684,7 @@
                 "name": "inputType",
                 "type": "'select' | 'text' | 'data-select' | 'number' | 'textarea'"
               },
+              { "name": "textareaRows", "type": "1" },
               { "name": "options", "type": "{ [key: string]: string }" },
               { "name": "selectProvider", "type": "string" },
               { "name": "iconPosition", "type": "'start' | 'end' | 'none'" },
@@ -6895,31 +6909,30 @@
         },
         {
           "name": "zn-simple-chart",
-          "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.",
+          "description": "A simple, pre-styled bar chart.\n---\n",
           "doc-url": "",
           "attributes": [
-            { "name": "datasets", "value": { "type": "any[]" } },
-            { "name": "labels", "value": { "type": "any[]" } }
-          ],
-          "slots": [
-            { "name": "", "description": "The default slot." },
-            { "name": "example", "description": "An example slot." }
-          ],
-          "events": [
-            { "name": "zn-event-name", "description": "Emitted as an example." }
+            {
+              "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": "any[]" },
-              { "name": "labels", "type": "any[]" },
-              { "name": "myChart", "type": "Chart" }
-            ],
-            "events": [
               {
-                "name": "zn-event-name",
-                "description": "Emitted as an example."
-              }
-            ]
+                "name": "datasets",
+                "type": "{ data: number[] }[] | undefined"
+              },
+              { "name": "labels", "type": "string[] | undefined" },
+              { "name": "enableAnimations", "type": "boolean | number" }
+            ],
+            "events": []
           }
         },
         {
@@ -8466,6 +8479,10 @@
                 "default": "'text'"
               }
             },
+            {
+              "name": "textarea-rows",
+              "value": { "type": "number | undefined" }
+            },
             {
               "name": "grouped",
               "description": "When true, hides the individual language navbar and defers language control to a parent zn-translation-group.",
@@ -8496,6 +8513,7 @@
                 "name": "inputType",
                 "type": "'select' | 'text' | 'number' | 'textarea'"
               },
+              { "name": "textareaRows", "type": "number | undefined" },
               {
                 "name": "grouped",
                 "description": "When true, hides the individual language navbar and defers language control to a parent zn-translation-group.",

package/dist/zn.d.ts

@@ -3400,43 +3400,83 @@ declare module "components/tile-property/index" {
         }
     }
 }
+declare module "components/chart/builders" {
+    import type { EChartsOption } from 'echarts';
+    export type ChartType = 'area' | 'bar' | 'line' | 'sankey';
+    export interface SeriesItem {
+        name: string;
+        data: any[];
+        color?: string;
+    }
+    export interface SankeyEdge {
+        source: string;
+        target: string;
+        value: number;
+    }
+    export interface BuilderProps {
+        type: ChartType;
+        data: SeriesItem[];
+        categories: string[];
+        xAxisType?: 'datetime' | 'category' | 'numeric';
+        yAxisAppend?: string;
+        stacked: boolean;
+        enableAnimations: boolean | number;
+        datapointSize: number;
+        colors?: string[];
+        theme: 'light' | 'dark';
+        smooth?: boolean;
+        scale?: boolean | number;
+        textColor?: string;
+        borderColor?: string;
+    }
+    export function buildBarOption(props: BuilderProps): EChartsOption;
+    export function buildLineOption(props: BuilderProps): EChartsOption;
+    export function buildAreaOption(props: BuilderProps): EChartsOption;
+    export function buildSankeyOption(props: BuilderProps): EChartsOption;
+}
 declare module "components/chart/chart.component" {
+    import { type ChartType, type SeriesItem } from "components/chart/builders";
     import { type CSSResultGroup, type PropertyValues } from 'lit';
     import ZincElement from "internal/zinc-element";
     /**
-     * @summary Short summary of the component's intended use.
+     * @summary Chart component powered by Apache ECharts.
      * @documentation https://zinc.style/components/data-chart
      * @status experimental
      * @since 1.0
      *
-     * @dependency zn-example
-     *
-     * @event zn-event-name - Emitted as an example.
-     *
-     * @slot - The default slot.
-     * @slot example - An example slot.
-     *
      * @csspart base - The component's base wrapper.
-     *
-     * @cssproperty --example - An example CSS custom property.
      */
     export default class ZnChart extends ZincElement {
         static styles: CSSResultGroup;
-        type: 'area' | 'bar' | 'line';
-        data: any[];
-        categories: string | string[];
-        xAxis: string;
+        type: ChartType;
+        data: SeriesItem[];
+        categories: string[];
+        xAxis: 'datetime' | 'category' | 'numeric';
         datapointSize: number;
         stacked: boolean;
         live: boolean;
         dataUrl: string;
         liveInterval: number;
         height: number;
-        enableAnimations: boolean;
+        enableAnimations: boolean | number;
         yAxisAppend: string;
-        private chart;
+        colors?: string[];
+        syncGroup?: string;
+        smooth: boolean;
+        scale: boolean | number;
+        private chart?;
+        private resizeObserver?;
+        private liveTimer?;
         protected firstUpdated(_changedProperties: PropertyValues): void;
+        private getTheme;
+        private getTextColor;
+        private getBorderColor;
+        private buildOption;
+        private initChart;
+        private startLive;
+        private reinit;
         attributeChangedCallback(name: string, _old: string | null, value: string | null): void;
+        disconnectedCallback(): void;
         protected render(): unknown;
     }
 }
@@ -3452,32 +3492,24 @@ declare module "components/chart/index" {
 }
 declare module "components/simple-chart/simple-chart.component" {
     import { type CSSResultGroup } from 'lit';
-    import { Chart } from "chart.js";
     import ZincElement from "internal/zinc-element";
     /**
-     * @summary Short summary of the component's intended use.
+     * @summary A simple, pre-styled bar chart.
      * @documentation https://zinc.style/components/simple-chart
      * @status experimental
      * @since 1.0
-     *
-     * @dependency zn-example
-     *
-     * @event zn-event-name - Emitted as an example.
-     *
-     * @slot - The default slot.
-     * @slot example - An example slot.
-     *
-     * @csspart base - The component's base wrapper.
-     *
-     * @cssproperty --example - An example CSS custom property.
      */
     export default class ZnSimpleChart extends ZincElement {
         static styles: CSSResultGroup;
-        datasets: any[];
-        labels: any[];
-        myChart: Chart;
-        constructor();
+        datasets?: {
+            data: number[];
+        }[];
+        labels?: string[];
+        enableAnimations: boolean | number;
+        private chart?;
+        private resizeObserver?;
         firstUpdated(): void;
+        disconnectedCallback(): void;
         render(): import("lit").TemplateResult<1>;
     }
 }
@@ -3769,6 +3801,7 @@ declare module "components/inline-edit/inline-edit.component" {
         max: string | number;
         step: number | 'any';
         inputType: 'select' | 'text' | 'data-select' | 'number' | 'textarea';
+        textareaRows: 1;
         options: {
             [key: string]: string;
         };
@@ -6007,8 +6040,8 @@ declare module "components/radio/index" {
 }
 declare module "components/rating/rating.component" {
     import { type CSSResultGroup } from 'lit';
-    import type { ZincFormControl } from "internal/zinc-element";
     import ZincElement from "internal/zinc-element";
+    import type { ZincFormControl } from "internal/zinc-element";
     /**
      * @summary Short summary of the component's intended use.
      * @documentation https://zinc.style/components/rating
@@ -7275,11 +7308,16 @@ declare module "components/translations/translations.component" {
         required: boolean;
         flush: boolean;
         inputType: 'select' | 'text' | 'number' | 'textarea';
+        textareaRows: number | undefined;
         /** When true, hides the individual language navbar and defers language control to a parent zn-translation-group. */
         grouped: boolean;
         languages: Record<string, string>;
         values: Record<string, string>;
         private _activeLanguage;
+        private _overflowIndex;
+        private _resizeObserver?;
+        private _lastObservedWidth;
+        private _measureRafId;
         get validity(): ValidityState;
         get validationMessage(): string;
         checkValidity(): boolean;
@@ -7294,9 +7332,15 @@ declare module "components/translations/translations.component" {
         addLanguageKey(languageCode: string): void;
         /** Returns all language codes that have values. */
         getValueLanguages(): string[];
+        connectedCallback(): void;
+        disconnectedCallback(): void;
         protected firstUpdated(): void;
+        protected updated(changedProperties: PropertyValues): void;
+        private _scheduleLangOverflow;
+        private _computeLangOverflow;
         willUpdate(changedProperties: PropertyValues): void;
         private handleLanguageAdd;
+        private handleOverflowSelect;
         private switchLanguage;
         private handleValueUpdate;
         private updateValue;
@@ -7488,8 +7532,16 @@ declare module "components/translation-group/translation-group.component" {
         private _activeLanguage;
         /** Tracks all language codes that have been activated across children. */
         private _activatedLanguages;
+        private _overflowIndex;
+        private _resizeObserver?;
+        private _lastObservedWidth;
+        private _measureRafId;
+        connectedCallback(): void;
+        disconnectedCallback(): void;
         protected firstUpdated(_changedProperties: PropertyValues): void;
         protected updated(changedProperties: PropertyValues): void;
+        private _scheduleLangOverflow;
+        private _computeLangOverflow;
         private getAllTranslations;
         /** Sync grouped state, languages, and active language to all children. */
         private syncChildren;
@@ -7497,6 +7549,7 @@ declare module "components/translation-group/translation-group.component" {
         private handleSlotChange;
         private switchLanguage;
         private handleLanguageAdd;
+        private handleOverflowSelect;
         render(): import("lit").TemplateResult<1>;
     }
 }