@kubex/zinc 1.1.67 → 1.1.68

package/dist/custom-elements.json

@@ -8267,7 +8267,7 @@
                 "text": "Record<string, DisplayTemplate>"
               },
               "privacy": "private",
-              "default": "{ dateTime: ((cell) => { const t = cell.text || ''; return html` <div class=\"table__collum--datetime\"> <span><strong>${t.slice(0, 10)}</strong></span> <zn-style size=\"s\" muted>${t.slice(11)}</zn-style> </div>` }) satisfies DisplayTemplate }"
+              "default": "{ dateTime: ((cell) => { const t = cell.text || ''; return html` <div class=\"table__collum--datetime\" title=\"${ifDefined(cell.title)}\"> <span><strong>${t.slice(0, 10)}</strong></span> <zn-style size=\"s\" muted>${t.slice(11)}</zn-style> </div>` }) satisfies DisplayTemplate }"
             },
             {
               "kind": "field",
@@ -10529,6 +10529,15 @@
             }
           ],
           "members": [
+            {
+              "kind": "field",
+              "name": "dependencies",
+              "type": {
+                "text": "object"
+              },
+              "static": true,
+              "default": "{ 'zn-button': ZnButton, 'zn-dropdown': ZnDropdown, 'zn-input': ZnInput, 'zn-option': ZnOption, 'zn-select': ZnSelect }"
+            },
             {
               "kind": "field",
               "name": "formControlController",
@@ -10557,6 +10566,7 @@
                 "text": "string"
               },
               "default": "''",
+              "description": "The selected label key. Also acts as the filter while typing.",
               "attribute": "value"
             },
             {
@@ -10566,6 +10576,7 @@
                 "text": "string"
               },
               "default": "''",
+              "description": "The value entered for the selected label. Submitted as `label:value` when present.",
               "attribute": "inputValue"
             },
             {
@@ -10575,6 +10586,7 @@
                 "text": "'x-small' | 'small' | 'medium' | 'large'"
               },
               "default": "'medium'",
+              "description": "The size of the main input.",
               "attribute": "input-size",
               "reflects": true
             },
@@ -10585,6 +10597,7 @@
                 "text": "string"
               },
               "default": "'label'",
+              "description": "The name of the control. Used for form submission.",
               "attribute": "name"
             },
             {
@@ -10593,6 +10606,7 @@
               "type": {
                 "text": "string"
               },
+              "description": "The title of the main input.",
               "attribute": "title"
             },
             {
@@ -10602,6 +10616,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Disables the control.",
               "attribute": "disabled"
             },
             {
@@ -10611,15 +10626,17 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Allows labels that aren't in the predefined list.",
               "attribute": "allow-custom"
             },
             {
               "kind": "field",
               "name": "predefinedLabels",
               "type": {
-                "text": "array"
+                "text": "(PredefinedLabel | string)[]"
               },
               "default": "[]",
+              "description": "The predefined labels. Entries are either a string or `{name, options}`.",
               "attribute": "predefined-labels"
             },
             {
@@ -10680,6 +10697,16 @@
               "kind": "method",
               "name": "handleValueChange"
             },
+            {
+              "kind": "method",
+              "name": "getFilteredLabels",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "PredefinedLabel[]"
+                }
+              }
+            },
             {
               "kind": "method",
               "name": "handleChange",
@@ -10718,7 +10745,7 @@
             },
             {
               "kind": "method",
-              "name": "handleInputValueInput",
+              "name": "handleFormSubmit",
               "privacy": "private",
               "parameters": [
                 {
@@ -10726,13 +10753,64 @@
                   "type": {
                     "text": "Event"
                   }
+                },
+                {
+                  "name": "label",
+                  "optional": true,
+                  "type": {
+                    "text": "string"
+                  }
                 }
               ]
             },
             {
               "kind": "method",
-              "name": "handleFormSubmit",
-              "privacy": "private"
+              "name": "renderValueControl",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "TemplateResult"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "label",
+                  "type": {
+                    "text": "PredefinedLabel"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "renderRow",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "TemplateResult"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "name",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "control",
+                  "type": {
+                    "text": "TemplateResult"
+                  }
+                },
+                {
+                  "name": "label",
+                  "optional": true,
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
             }
           ],
           "attributes": [
@@ -10742,6 +10820,7 @@
                 "text": "string"
               },
               "default": "''",
+              "description": "The selected label key. Also acts as the filter while typing.",
               "fieldName": "value"
             },
             {
@@ -10750,6 +10829,7 @@
                 "text": "string"
               },
               "default": "''",
+              "description": "The value entered for the selected label. Submitted as `label:value` when present.",
               "fieldName": "inputValue"
             },
             {
@@ -10758,6 +10838,7 @@
                 "text": "'x-small' | 'small' | 'medium' | 'large'"
               },
               "default": "'medium'",
+              "description": "The size of the main input.",
               "fieldName": "inputSize"
             },
             {
@@ -10766,6 +10847,7 @@
                 "text": "string"
               },
               "default": "'label'",
+              "description": "The name of the control. Used for form submission.",
               "fieldName": "name"
             },
             {
@@ -10773,6 +10855,7 @@
               "type": {
                 "text": "string"
               },
+              "description": "The title of the main input.",
               "fieldName": "title"
             },
             {
@@ -10781,6 +10864,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Disables the control.",
               "fieldName": "disabled"
             },
             {
@@ -10789,14 +10873,16 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Allows labels that aren't in the predefined list.",
               "fieldName": "allowCustom"
             },
             {
               "name": "predefined-labels",
               "type": {
-                "text": "array"
+                "text": "(PredefinedLabel | string)[]"
               },
               "default": "[]",
+              "description": "The predefined labels. Entries are either a string or `{name, options}`.",
               "fieldName": "predefinedLabels"
             }
           ],
@@ -10808,7 +10894,7 @@
           "tagNameWithoutPrefix": "defined-label",
           "tagName": "zn-defined-label",
           "customElement": true,
-          "jsDoc": "/**\n * @summary This component provides a labeled input with support for predefined and custom labels,\n * allowing users to select or enter label-value pairs within a dropdown interface.\n * @documentation https://zinc.style/components/defined-label\n * @status experimental\n * @since 1.0\n *\n * @dependency zn-button\n * @dependency zn-dropdown\n * @dependency zn-input\n * @dependency zn-option\n * @dependency zn-panel\n * @dependency zn-select\n * @dependency zn-sp\n *\n * @csspart input - The component's main input.\n * @csspart input-value - The label's value inputs.\n */",
+          "jsDoc": "/**\n * @summary This component provides a labeled input with support for predefined and custom labels,\n * allowing users to select or enter label-value pairs within a dropdown interface.\n * @documentation https://zinc.style/components/defined-label\n * @status experimental\n * @since 1.0\n *\n * @dependency zn-button\n * @dependency zn-dropdown\n * @dependency zn-input\n * @dependency zn-option\n * @dependency zn-select\n *\n * @csspart input - The component's main input.\n * @csspart input-value - The label's value inputs.\n */",
           "documentation": "https://zinc.style/components/defined-label",
           "status": "experimental",
           "since": "1.0",
@@ -10817,9 +10903,7 @@
             "zn-dropdown",
             "zn-input",
             "zn-option",
-            "zn-panel",
-            "zn-select",
-            "zn-sp"
+            "zn-select"
           ]
         }
       ],
@@ -12962,7 +13046,7 @@
               "name": "formControlController",
               "privacy": "private",
               "readonly": true,
-              "default": "new FormControlController(this, { assumeInteractionOn: ['zn-change'], // An explicitly cleared control submits an empty value so the server can // remove the stored upload; an untouched empty control submits nothing. value: (el: ZnFile) => { if (el.files?.length) return el.files; return el.clearedByUser ? '' : undefined; } })"
+              "default": "new FormControlController(this, { assumeInteractionOn: ['zn-change'], // An explicitly cleared control submits an empty value so the server can // remove the stored upload; an untouched empty control submits nothing. // In upload-url mode the control submits the uploaded file's URL string // instead of the file bytes. value: (el: ZnFile) => { if (el.uploadUrl) { if (el.src) return el.src; return el.clearedByUser ? '' : undefined; } if (el.files?.length) return el.files; return el.clearedByUser ? '' : undefined; } })"
             },
             {
               "kind": "field",
@@ -13244,6 +13328,25 @@
               "description": "When enabled, render the current link (`previewSrc`) as a clickable URL below the control.\nUseful for showing the existing CDN link alongside the preview.",
               "attribute": "show-link"
             },
+            {
+              "kind": "field",
+              "name": "uploadUrl",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "When set, a chosen file is immediately POSTed (multipart, field `file`) to this URL.\nThe endpoint must respond with JSON `{\"url\": \"...\"}`; that URL becomes the control's\nvalue (and `src` preview) in place of the file bytes, so the control works inside\nJSON-serialising hosts such as `zn-page-builder`. Emits `zn-error` when the upload fails.",
+              "attribute": "upload-url"
+            },
+            {
+              "kind": "field",
+              "name": "uploading",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
             {
               "kind": "field",
               "name": "validity",
@@ -13397,6 +13500,20 @@
               ],
               "description": "Handles the change event of the native input"
             },
+            {
+              "kind": "method",
+              "name": "uploadFile",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "file",
+                  "type": {
+                    "text": "File"
+                  }
+                }
+              ],
+              "description": "Uploads the chosen file to `uploadUrl` and adopts the returned URL as the\ncontrol's value. The local file preview stays visible while the upload runs."
+            },
             {
               "kind": "field",
               "name": "handleDragOver",
@@ -13675,6 +13792,15 @@
               "default": "false",
               "description": "When enabled, render the current link (`previewSrc`) as a clickable URL below the control.\nUseful for showing the existing CDN link alongside the preview.",
               "fieldName": "showLink"
+            },
+            {
+              "name": "upload-url",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "When set, a chosen file is immediately POSTed (multipart, field `file`) to this URL.\nThe endpoint must respond with JSON `{\"url\": \"...\"}`; that URL becomes the control's\nvalue (and `src` preview) in place of the file bytes, so the control works inside\nJSON-serialising hosts such as `zn-page-builder`. Emits `zn-error` when the upload fails.",
+              "fieldName": "uploadUrl"
             }
           ],
           "superclass": {
@@ -15464,272 +15590,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "components/header/header.js",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "",
-          "name": "ZnHeader",
-          "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": "hasSlotController",
-              "privacy": "private",
-              "readonly": true,
-              "default": "new HasSlotController(this, '[default]', 'nav', 'breadcrumb')"
-            },
-            {
-              "kind": "field",
-              "name": "fullLocation",
-              "type": {
-                "text": "string"
-              },
-              "attribute": "full-location"
-            },
-            {
-              "kind": "field",
-              "name": "entityId",
-              "type": {
-                "text": "string"
-              },
-              "attribute": "entity-id"
-            },
-            {
-              "kind": "field",
-              "name": "entityIdShow",
-              "type": {
-                "text": "boolean"
-              },
-              "attribute": "entity-id-show"
-            },
-            {
-              "kind": "field",
-              "name": "transparent",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "attribute": "transparent"
-            },
-            {
-              "kind": "field",
-              "name": "caption",
-              "type": {
-                "text": "string"
-              },
-              "attribute": "caption"
-            },
-            {
-              "kind": "field",
-              "name": "icon",
-              "type": {
-                "text": "string"
-              },
-              "attribute": "icon"
-            },
-            {
-              "kind": "field",
-              "name": "navigation",
-              "type": {
-                "text": "array"
-              },
-              "default": "[]",
-              "attribute": "navigation"
-            },
-            {
-              "kind": "field",
-              "name": "fullWidth",
-              "type": {
-                "text": "boolean"
-              },
-              "attribute": "full-width"
-            },
-            {
-              "kind": "field",
-              "name": "previousPath",
-              "type": {
-                "text": "string"
-              },
-              "attribute": "previous-path"
-            },
-            {
-              "kind": "field",
-              "name": "previousTarget",
-              "type": {
-                "text": "string"
-              },
-              "attribute": "previous-target"
-            },
-            {
-              "kind": "field",
-              "name": "hideBreadcrumb",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "attribute": "hide-breadcrumb"
-            },
-            {
-              "kind": "field",
-              "name": "navbar",
-              "type": {
-                "text": "ZnNavbar"
-              },
-              "privacy": "private"
-            },
-            {
-              "kind": "field",
-              "name": "handleAltPress"
-            },
-            {
-              "kind": "field",
-              "name": "handleAltUp"
-            },
-            {
-              "kind": "method",
-              "name": "updateNav"
-            }
-          ],
-          "events": [
-            {
-              "description": "Emitted as an example.",
-              "name": "zn-event-name"
-            }
-          ],
-          "attributes": [
-            {
-              "name": "full-location",
-              "type": {
-                "text": "string"
-              },
-              "fieldName": "fullLocation"
-            },
-            {
-              "name": "entity-id",
-              "type": {
-                "text": "string"
-              },
-              "fieldName": "entityId"
-            },
-            {
-              "name": "entity-id-show",
-              "type": {
-                "text": "boolean"
-              },
-              "fieldName": "entityIdShow"
-            },
-            {
-              "name": "transparent",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "fieldName": "transparent"
-            },
-            {
-              "name": "caption",
-              "type": {
-                "text": "string"
-              },
-              "fieldName": "caption"
-            },
-            {
-              "name": "icon",
-              "type": {
-                "text": "string"
-              },
-              "fieldName": "icon"
-            },
-            {
-              "name": "navigation",
-              "type": {
-                "text": "array"
-              },
-              "default": "[]",
-              "fieldName": "navigation"
-            },
-            {
-              "name": "full-width",
-              "type": {
-                "text": "boolean"
-              },
-              "fieldName": "fullWidth"
-            },
-            {
-              "name": "previous-path",
-              "type": {
-                "text": "string"
-              },
-              "fieldName": "previousPath"
-            },
-            {
-              "name": "previous-target",
-              "type": {
-                "text": "string"
-              },
-              "fieldName": "previousTarget"
-            },
-            {
-              "name": "hide-breadcrumb",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "fieldName": "hideBreadcrumb"
-            }
-          ],
-          "superclass": {
-            "name": "ZincElement",
-            "module": "/src/internal/zinc-element"
-          },
-          "summary": "Short summary of the component's intended use.",
-          "tagNameWithoutPrefix": "header",
-          "tagName": "zn-header",
-          "customElement": true,
-          "jsDoc": "/**\n * @summary Short summary of the component's intended use.\n * @documentation https://zinc.style/components/header\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/header",
-          "status": "experimental",
-          "since": "1.0",
-          "dependencies": [
-            "zn-example"
-          ]
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "default",
-          "declaration": {
-            "name": "ZnHeader",
-            "module": "components/header/header.js"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "components/hover-container/hover-container.js",
@@ -16033,6 +15893,272 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "components/header/header.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "ZnHeader",
+          "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": "hasSlotController",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new HasSlotController(this, '[default]', 'nav', 'breadcrumb')"
+            },
+            {
+              "kind": "field",
+              "name": "fullLocation",
+              "type": {
+                "text": "string"
+              },
+              "attribute": "full-location"
+            },
+            {
+              "kind": "field",
+              "name": "entityId",
+              "type": {
+                "text": "string"
+              },
+              "attribute": "entity-id"
+            },
+            {
+              "kind": "field",
+              "name": "entityIdShow",
+              "type": {
+                "text": "boolean"
+              },
+              "attribute": "entity-id-show"
+            },
+            {
+              "kind": "field",
+              "name": "transparent",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "transparent"
+            },
+            {
+              "kind": "field",
+              "name": "caption",
+              "type": {
+                "text": "string"
+              },
+              "attribute": "caption"
+            },
+            {
+              "kind": "field",
+              "name": "icon",
+              "type": {
+                "text": "string"
+              },
+              "attribute": "icon"
+            },
+            {
+              "kind": "field",
+              "name": "navigation",
+              "type": {
+                "text": "array"
+              },
+              "default": "[]",
+              "attribute": "navigation"
+            },
+            {
+              "kind": "field",
+              "name": "fullWidth",
+              "type": {
+                "text": "boolean"
+              },
+              "attribute": "full-width"
+            },
+            {
+              "kind": "field",
+              "name": "previousPath",
+              "type": {
+                "text": "string"
+              },
+              "attribute": "previous-path"
+            },
+            {
+              "kind": "field",
+              "name": "previousTarget",
+              "type": {
+                "text": "string"
+              },
+              "attribute": "previous-target"
+            },
+            {
+              "kind": "field",
+              "name": "hideBreadcrumb",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "hide-breadcrumb"
+            },
+            {
+              "kind": "field",
+              "name": "navbar",
+              "type": {
+                "text": "ZnNavbar"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "handleAltPress"
+            },
+            {
+              "kind": "field",
+              "name": "handleAltUp"
+            },
+            {
+              "kind": "method",
+              "name": "updateNav"
+            }
+          ],
+          "events": [
+            {
+              "description": "Emitted as an example.",
+              "name": "zn-event-name"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "full-location",
+              "type": {
+                "text": "string"
+              },
+              "fieldName": "fullLocation"
+            },
+            {
+              "name": "entity-id",
+              "type": {
+                "text": "string"
+              },
+              "fieldName": "entityId"
+            },
+            {
+              "name": "entity-id-show",
+              "type": {
+                "text": "boolean"
+              },
+              "fieldName": "entityIdShow"
+            },
+            {
+              "name": "transparent",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "transparent"
+            },
+            {
+              "name": "caption",
+              "type": {
+                "text": "string"
+              },
+              "fieldName": "caption"
+            },
+            {
+              "name": "icon",
+              "type": {
+                "text": "string"
+              },
+              "fieldName": "icon"
+            },
+            {
+              "name": "navigation",
+              "type": {
+                "text": "array"
+              },
+              "default": "[]",
+              "fieldName": "navigation"
+            },
+            {
+              "name": "full-width",
+              "type": {
+                "text": "boolean"
+              },
+              "fieldName": "fullWidth"
+            },
+            {
+              "name": "previous-path",
+              "type": {
+                "text": "string"
+              },
+              "fieldName": "previousPath"
+            },
+            {
+              "name": "previous-target",
+              "type": {
+                "text": "string"
+              },
+              "fieldName": "previousTarget"
+            },
+            {
+              "name": "hide-breadcrumb",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "hideBreadcrumb"
+            }
+          ],
+          "superclass": {
+            "name": "ZincElement",
+            "module": "/src/internal/zinc-element"
+          },
+          "summary": "Short summary of the component's intended use.",
+          "tagNameWithoutPrefix": "header",
+          "tagName": "zn-header",
+          "customElement": true,
+          "jsDoc": "/**\n * @summary Short summary of the component's intended use.\n * @documentation https://zinc.style/components/header\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/header",
+          "status": "experimental",
+          "since": "1.0",
+          "dependencies": [
+            "zn-example"
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "ZnHeader",
+            "module": "components/header/header.js"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "components/icon/icon.js",
@@ -42314,7 +42440,7 @@
   "package": {
     "name": "@kubex/zinc",
     "description": "A collection of web components for building web applications based off of @shoelace-style/Shoelace",
-    "version": "1.1.67",
+    "version": "1.1.68",
     "author": "",
     "license": "MIT"
   }