@kubex/zinc 1.1.53 → 1.1.55

package/dist/custom-elements.json

@@ -47,6 +47,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",
@@ -124,6 +197,16 @@
               "default": "'info'",
               "attribute": "level"
             },
+            {
+              "kind": "field",
+              "name": "center",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "center",
+              "reflects": true
+            },
             {
               "kind": "field",
               "name": "size",
@@ -186,6 +269,14 @@
               "default": "'info'",
               "fieldName": "level"
             },
+            {
+              "name": "center",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "center"
+            },
             {
               "name": "size",
               "type": {
@@ -223,79 +314,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",
@@ -2787,7 +2805,7 @@
               "type": {
                 "text": "string"
               },
-              "default": "'call_end'",
+              "default": "'close'",
               "description": "Icon for the reject control.",
               "attribute": "reject-icon"
             },
@@ -3073,7 +3091,7 @@
               "type": {
                 "text": "string"
               },
-              "default": "'call_end'",
+              "default": "'close'",
               "description": "Icon for the reject control.",
               "fieldName": "rejectIcon"
             },
@@ -7852,7 +7870,7 @@
                 "text": "object"
               },
               "static": true,
-              "default": "{ 'zn-button': ZnButton, 'zn-empty-state': ZnEmptyState, 'zn-chip': ZnChip, 'zn-hover-container': ZnHoverContainer, 'zn-dropdown': ZnDropdown, 'zn-menu': ZnMenu, 'zn-menu-item': ZnMenuItem, 'zn-button-group': ZnButtonGroup, 'zn-confirm': ZnConfirm, 'zn-skeleton': ZnSkeleton, 'zn-style': ZnStyle, 'zn-data-table-search': ZnDataTableSearch, }"
+              "default": "{ 'zn-alert': ZnAlert, 'zn-button': ZnButton, 'zn-empty-state': ZnEmptyState, 'zn-chip': ZnChip, 'zn-hover-container': ZnHoverContainer, 'zn-dropdown': ZnDropdown, 'zn-menu': ZnMenu, 'zn-menu-item': ZnMenuItem, 'zn-button-group': ZnButtonGroup, 'zn-confirm': ZnConfirm, 'zn-skeleton': ZnSkeleton, 'zn-style': ZnStyle, 'zn-data-table-search': ZnDataTableSearch, }"
             },
             {
               "kind": "field",
@@ -8292,6 +8310,19 @@
                 }
               ]
             },
+            {
+              "kind": "method",
+              "name": "renderErrorAlert",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "error",
+                  "type": {
+                    "text": "ResponseError"
+                  }
+                }
+              ]
+            },
             {
               "kind": "method",
               "name": "humanize",
@@ -8315,6 +8346,13 @@
                   "type": {
                     "text": "any"
                   }
+                },
+                {
+                  "name": "error",
+                  "optional": true,
+                  "type": {
+                    "text": "ResponseError"
+                  }
                 }
               ]
             },
@@ -8947,11 +8985,12 @@
           "tagNameWithoutPrefix": "data-table",
           "tagName": "zn-data-table",
           "customElement": true,
-          "jsDoc": "/**\n * @summary Short summary of the component's intended use.\n * @documentation https://zinc.style/components/data-table\n * @status experimental\n * @since 1.0\n *\n * @dependency zn-button\n * @dependency zn-empty-state\n * @dependency zn-chip\n * @dependency zn-hover-container\n * @dependency zn-dropdown\n * @dependency zn-menu\n * @dependency zn-menu-item\n * @dependency zn-button-group\n * @dependency zn-confirm\n * @dependency zn-skeleton\n * @dependency zn-data-table-search\n *\n * @slot - The default slot.\n * @slot search - Slot for search component.\n * @slot sort - Slot for sort component.\n * @slot filter - Slot for filter component.\n * @slot filter-top - Slot for top-level filter component.\n * @slot delete-action - Slot for delete action button.\n * @slot modify-action - Slot for modify action button.\n * @slot create-action - Slot for create action button.\n * @slot inputs - Slot for additional input controls.\n * @slot empty-state - Slot for custom empty state.\n *\n * @csspart base - The component's base wrapper.\n *\n * @cssproperty --example - An example CSS custom property.\n */",
+          "jsDoc": "/**\n * @summary Short summary of the component's intended use.\n * @documentation https://zinc.style/components/data-table\n * @status experimental\n * @since 1.0\n *\n * @dependency zn-alert\n * @dependency zn-button\n * @dependency zn-empty-state\n * @dependency zn-chip\n * @dependency zn-hover-container\n * @dependency zn-dropdown\n * @dependency zn-menu\n * @dependency zn-menu-item\n * @dependency zn-button-group\n * @dependency zn-confirm\n * @dependency zn-skeleton\n * @dependency zn-data-table-search\n *\n * @slot - The default slot.\n * @slot search - Slot for search component.\n * @slot sort - Slot for sort component.\n * @slot filter - Slot for filter component.\n * @slot filter-top - Slot for top-level filter component.\n * @slot delete-action - Slot for delete action button.\n * @slot modify-action - Slot for modify action button.\n * @slot create-action - Slot for create action button.\n * @slot inputs - Slot for additional input controls.\n * @slot empty-state - Slot for custom empty state.\n *\n * @csspart base - The component's base wrapper.\n *\n * @cssproperty --example - An example CSS custom property.\n */",
           "documentation": "https://zinc.style/components/data-table",
           "status": "experimental",
           "since": "1.0",
           "dependencies": [
+            "zn-alert",
             "zn-button",
             "zn-empty-state",
             "zn-chip",
@@ -9857,6 +9896,7 @@
               "type": {
                 "text": "string | HTMLElement | undefined"
               },
+              "description": "Overrides where the calendar popup is mounted. By default it renders at the document level\n(or inside the containing dialog/popover) so it can't be clipped by ancestor shadow roots\nor overflow containers — you rarely need to set this.",
               "attribute": "container"
             },
             {
@@ -9965,6 +10005,28 @@
               "kind": "method",
               "name": "init"
             },
+            {
+              "kind": "method",
+              "name": "getCalendarContainer",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "HTMLElement | undefined"
+                }
+              },
+              "description": "Resolves where the calendar should be mounted. By default AirDatepicker mounts it in a global\ncontainer on `document.body`, so ancestor shadow roots and overflow containers can't clip it.\nHowever, when the datepicker is inside a top-layer element (a modal `<dialog>` or a popover),\na document-level calendar would render behind it and be inert, so we mount inside that element."
+            },
+            {
+              "kind": "method",
+              "name": "findTopLayerAncestor",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "HTMLElement | null"
+                }
+              },
+              "description": "Finds the closest `<dialog>` or popover ancestor, crossing shadow DOM boundaries."
+            },
             {
               "kind": "method",
               "name": "handleInput",
@@ -10402,6 +10464,7 @@
               "type": {
                 "text": "string | HTMLElement | undefined"
               },
+              "description": "Overrides where the calendar popup is mounted. By default it renders at the document level\n(or inside the containing dialog/popover) so it can't be clipped by ancestor shadow roots\nor overflow containers — you rarely need to set this.",
               "fieldName": "container"
             }
           ],
@@ -40688,7 +40751,7 @@
   "package": {
     "name": "@kubex/zinc",
     "description": "A collection of web components for building web applications based off of @shoelace-style/Shoelace",
-    "version": "1.1.53",
+    "version": "1.1.55",
     "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.",
@@ -36,6 +47,7 @@
             { "name": "cosmic" }
           ]
         },
+        { "name": "center", "values": [] },
         {
           "name": "size",
           "values": [
@@ -52,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",
@@ -1300,7 +1301,11 @@
           "description": "Time format for display and input selector. Uses AirDatepicker format tokens.\nDefault : hh:mm AA\n\nPossible symbols:\nh — hours in 12-hour mode\nhh — hours in 12-hour mode with leading zero\nH — hours in 24-hour mode\nHH — hours in 24-hour mode with leading zero\nm — minutes\nmm — minutes with leading zero\naa — day period lower case\nAA — day period upper case",
           "values": []
         },
-        { "name": "container", "values": [{ "name": "HTMLElement" }] }
+        {
+          "name": "container",
+          "description": "Overrides where the calendar popup is mounted. By default it renders at the document level\n(or inside the containing dialog/popover) so it can't be clipped by ancestor shadow roots\nor overflow containers — you rarely need to set this.",
+          "values": [{ "name": "HTMLElement" }]
+        }
       ],
       "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.53",
+  "version": "1.1.55",
   "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.",
@@ -43,6 +65,10 @@
                 "default": "'info'"
               }
             },
+            {
+              "name": "center",
+              "value": { "type": "boolean", "default": "false" }
+            },
             {
               "name": "size",
               "value": {
@@ -68,6 +94,7 @@
                 "name": "level",
                 "type": "'primary' | 'error' | 'info' | 'success' | 'warning' | 'note' | 'cosmic'"
               },
+              { "name": "center", "type": "boolean" },
               { "name": "size", "type": "'small' | 'medium' | 'large'" }
             ],
             "events": [
@@ -78,28 +105,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",
@@ -726,7 +731,7 @@
             {
               "name": "reject-icon",
               "description": "Icon for the reject control.",
-              "value": { "type": "string", "default": "'call_end'" }
+              "value": { "type": "string", "default": "'close'" }
             },
             {
               "name": "reject-label",
@@ -2843,6 +2848,7 @@
             },
             {
               "name": "container",
+              "description": "Overrides where the calendar popup is mounted. By default it renders at the document level\n(or inside the containing dialog/popover) so it can't be clipped by ancestor shadow roots\nor overflow containers — you rarely need to set this.",
               "value": { "type": "string | HTMLElement | undefined" }
             }
           ],
@@ -3007,6 +3013,7 @@
               },
               {
                 "name": "container",
+                "description": "Overrides where the calendar popup is mounted. By default it renders at the document level\n(or inside the containing dialog/popover) so it can't be clipped by ancestor shadow roots\nor overflow containers — you rarely need to set this.",
                 "type": "string | HTMLElement | undefined"
               },
               { "name": "timestamp", "type": "number" },

package/dist/zn.d.ts

@@ -1446,6 +1446,7 @@ declare module "components/alert/alert.component" {
         collapse: boolean;
         appearance: 'transparent' | 'solid';
         level: 'primary' | 'error' | 'info' | 'success' | 'warning' | 'note' | 'cosmic';
+        center: boolean;
         size: 'small' | 'medium' | 'large';
         render(): import("lit-html").TemplateResult<1>;
         hideAlert(): void;
@@ -2929,6 +2930,11 @@ declare module "components/datepicker/datepicker.component" {
          * AA — day period upper case
          */
         timeFormat?: string;
+        /**
+         * Overrides where the calendar popup is mounted. By default it renders at the document level
+         * (or inside the containing dialog/popover) so it can't be clipped by ancestor shadow roots
+         * or overflow containers — you rarely need to set this.
+         */
         container?: string | HTMLElement;
         private _instance;
         get timestamp(): number;
@@ -2954,6 +2960,15 @@ declare module "components/datepicker/datepicker.component" {
         /** Sets a custom validation message. Pass an empty string to restore validity. */
         setCustomValidity(message: string): void;
         init(): void;
+        /**
+         * Resolves where the calendar should be mounted. By default AirDatepicker mounts it in a global
+         * container on `document.body`, so ancestor shadow roots and overflow containers can't clip it.
+         * However, when the datepicker is inside a top-layer element (a modal `<dialog>` or a popover),
+         * a document-level calendar would render behind it and be inert, so we mount inside that element.
+         */
+        private getCalendarContainer;
+        /** Finds the closest `<dialog>` or popover ancestor, crossing shadow DOM boundaries. */
+        private findTopLayerAncestor;
         private handleInput;
         private handleChange;
         private handleInvalid;
@@ -3380,6 +3395,7 @@ declare module "components/data-table/data-table.component" {
     import { type ZnFilterChangeEvent } from "events/zn-filter-change";
     import { type ZnSearchChangeEvent } from "events/zn-search-change";
     import ZincElement from "internal/zinc-element";
+    import ZnAlert from "components/alert/index";
     import ZnButton from "components/button/index";
     import ZnButtonGroup from "components/button-group/index";
     import ZnChip from "components/chip/index";
@@ -3417,11 +3433,17 @@ declare module "components/data-table/data-table.component" {
         actions?: ActionConfig[];
         cells: Cell[];
     }
+    interface ResponseError {
+        text: string;
+        icon?: string;
+        level?: 'primary' | 'error' | 'info' | 'success' | 'warning' | 'note';
+    }
     interface Response {
         rows: Row[];
         perPage: number;
         total: number;
         page: number;
+        error?: ResponseError;
     }
     export enum ActionSlots {
         delete = "delete-action",
@@ -3467,6 +3489,7 @@ declare module "components/data-table/data-table.component" {
      * @status experimental
      * @since 1.0
      *
+     * @dependency zn-alert
      * @dependency zn-button
      * @dependency zn-empty-state
      * @dependency zn-chip
@@ -3497,6 +3520,7 @@ declare module "components/data-table/data-table.component" {
     export default class ZnDataTable extends ZincElement {
         static styles: CSSResultGroup;
         static dependencies: {
+            'zn-alert': typeof ZnAlert;
             'zn-button': typeof ZnButton;
             'zn-empty-state': typeof ZnEmptyState;
             'zn-chip': typeof ZnChip;
@@ -3565,8 +3589,9 @@ declare module "components/data-table/data-table.component" {
         searchChangeListener: (e: ZnSearchChangeEvent) => void;
         emptyState(): TemplateResult<1>;
         renderTable(data: Response): TemplateResult<1>;
+        private renderErrorAlert;
         humanize(str: string): string;
-        renderTableData(data: any): TemplateResult<1>;
+        renderTableData(data: any, error?: ResponseError): TemplateResult<1>;
         getTableHeader(): TemplateResult<1>;
         getTableFooter(): TemplateResult<1>;
         getRowsSelected(): TemplateResult<1> | null;