@kubex/zinc 1.1.132 → 1.1.133

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.",
@@ -53,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",
@@ -490,48 +490,6 @@
         }
       ]
     },
-    {
-      "name": "zn-chart",
-      "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": "y-categories", "values": [{ "name": "string[]" }] },
-        { "name": "indicators", "values": [{ "name": "RadarIndicator[]" }] },
-        {
-          "name": "xaxis",
-          "values": [
-            { "name": "datetime" },
-            { "name": "category" },
-            { "name": "numeric" }
-          ]
-        },
-        { "name": "d-size", "values": [] },
-        { "name": "stacked", "values": [] },
-        { "name": "live", "values": [] },
-        { "name": "data-url", "values": [] },
-        { "name": "live-interval", "values": [] },
-        { "name": "height", "values": [] },
-        { "name": "enable-animations", "values": [] },
-        { "name": "y-axis-append", "values": [] },
-        { "name": "colors", "values": [{ "name": "string[]" }] },
-        { "name": "sync-group", "values": [] },
-        { "name": "smooth", "values": [] },
-        { "name": "inner-radius", "values": [] },
-        { "name": "outer-radius", "values": [] },
-        { "name": "show-labels", "values": [] },
-        { "name": "min-value", "values": [] },
-        { "name": "max-value", "values": [] },
-        { "name": "scale", "values": [] }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://zinc.style/components/chart"
-        }
-      ]
-    },
     {
       "name": "zn-chat-message",
       "description": "A single message in a chat-style conversation: avatar, sender,\ntime, optional badge, and a message bubble with optional actions. Also renders\nsystem events (connections, transfers, etc.) as a centred card.\n---\n\n\n### **Slots:**\n - _default_ - The message content. Ignored when the `message` attribute is set.\n- **badge** - Rendered in the header after the sender and time (e.g. an INTERNAL NOTE chip).\n- **attachments** - Attachments displayed beneath the message content. Use `zn-chat-message-attachment`, which auto-assigns itself to this slot.\n- **edit-dialog-trigger** - Action rendered at the end of the bubble (e.g. a remove icon button).\n- **edit-dialog** - Pass-through for an associated dialog element.\n\n### **CSS Properties:**\n - **--message-background** - The bubble's background color. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **avatar** - The avatar column.\n- **body** - The header and bubble column.\n- **header** - The sender/time/badge row.\n- **bubble** - The message bubble.\n- **content** - The message content within the bubble.\n- **attachments** - The attachments row beneath the message content.\n- **system-card** - The card rendered for system action types.",
@@ -584,6 +542,48 @@
         }
       ]
     },
+    {
+      "name": "zn-chart",
+      "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": "y-categories", "values": [{ "name": "string[]" }] },
+        { "name": "indicators", "values": [{ "name": "RadarIndicator[]" }] },
+        {
+          "name": "xaxis",
+          "values": [
+            { "name": "datetime" },
+            { "name": "category" },
+            { "name": "numeric" }
+          ]
+        },
+        { "name": "d-size", "values": [] },
+        { "name": "stacked", "values": [] },
+        { "name": "live", "values": [] },
+        { "name": "data-url", "values": [] },
+        { "name": "live-interval", "values": [] },
+        { "name": "height", "values": [] },
+        { "name": "enable-animations", "values": [] },
+        { "name": "y-axis-append", "values": [] },
+        { "name": "colors", "values": [{ "name": "string[]" }] },
+        { "name": "sync-group", "values": [] },
+        { "name": "smooth", "values": [] },
+        { "name": "inner-radius", "values": [] },
+        { "name": "outer-radius", "values": [] },
+        { "name": "show-labels", "values": [] },
+        { "name": "min-value", "values": [] },
+        { "name": "max-value", "values": [] },
+        { "name": "scale", "values": [] }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://zinc.style/components/chart"
+        }
+      ]
+    },
     {
       "name": "zn-chat-message-attachment",
       "description": "A single file or link attachment for a `zn-chat-message` or `zn-content-block`.\nRenders an icon and a label as a link, styled to match the message's attachments row. It is\nintended to be used only inside a `zn-chat-message` or `zn-content-block` and is automatically\nplaced in that component's `attachments` slot.\n---\n\n\n### **Slots:**\n - _default_ - The attachment label. Falls back to the `name` attribute when empty.\n\n### **CSS Parts:**\n - **base** - The attachment link.\n- **icon** - The leading icon.\n- **label** - The attachment label.",
@@ -1223,6 +1223,11 @@
         { "name": "filters", "values": [{ "name": "[]" }] },
         { "name": "method", "values": [{ "name": "GET" }, { "name": "POST" }] },
         { "name": "no-initial-load", "values": [] },
+        {
+          "name": "sharable",
+          "description": "When set, the table's non-default state (search, filter, sort, page, per-page and field values)\nis mirrored to the URL query string and restored from it on load, so the view is shareable.",
+          "values": []
+        },
         { "name": "group-by", "values": [] },
         { "name": "groups", "values": [] },
         { "name": "per-page-size", "values": [] }
@@ -1285,7 +1290,7 @@
         },
         {
           "name": "debounce-delay",
-          "description": "The delay in milliseconds before triggering a search (default: 500).",
+          "description": "The delay in milliseconds before triggering a search (default: 350).",
           "values": []
         }
       ],

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.132",
+  "version": "1.1.133",
   "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.",
@@ -83,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",
@@ -1003,119 +1003,6 @@
             ]
           }
         },
-        {
-          "name": "zn-chart",
-          "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": "ChartType", "default": "'bar'" }
-            },
-            {
-              "name": "data",
-              "value": { "type": "SeriesItem[]", "default": "[]" }
-            },
-            {
-              "name": "categories",
-              "value": { "type": "string[]", "default": "[]" }
-            },
-            {
-              "name": "y-categories",
-              "value": { "type": "string[]", "default": "[]" }
-            },
-            {
-              "name": "indicators",
-              "value": { "type": "RadarIndicator[]", "default": "[]" }
-            },
-            {
-              "name": "xaxis",
-              "value": { "type": "'datetime' | 'category' | 'numeric'" }
-            },
-            { "name": "d-size", "value": { "type": "number", "default": "1" } },
-            {
-              "name": "stacked",
-              "value": { "type": "boolean", "default": "false" }
-            },
-            {
-              "name": "live",
-              "value": { "type": "boolean", "default": "false" }
-            },
-            {
-              "name": "data-url",
-              "value": { "type": "string", "default": "''" }
-            },
-            {
-              "name": "live-interval",
-              "value": { "type": "number", "default": "1000" }
-            },
-            {
-              "name": "height",
-              "value": { "type": "number", "default": "300" }
-            },
-            {
-              "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": "inner-radius",
-              "value": { "type": "number | string | undefined" }
-            },
-            {
-              "name": "outer-radius",
-              "value": { "type": "number | string | undefined" }
-            },
-            {
-              "name": "show-labels",
-              "value": { "type": "boolean | undefined" }
-            },
-            { "name": "min-value", "value": { "type": "number | undefined" } },
-            { "name": "max-value", "value": { "type": "number | undefined" } },
-            {
-              "name": "scale",
-              "value": { "type": "boolean | number", "default": "false" }
-            }
-          ],
-          "events": [],
-          "js": {
-            "properties": [
-              { "name": "type", "type": "ChartType" },
-              { "name": "data", "type": "SeriesItem[]" },
-              { "name": "categories", "type": "string[]" },
-              { "name": "yCategories", "type": "string[]" },
-              { "name": "indicators", "type": "RadarIndicator[]" },
-              {
-                "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 | number" },
-              { "name": "yAxisAppend", "type": "string" },
-              { "name": "colors", "type": "string[] | undefined" },
-              { "name": "syncGroup", "type": "string | undefined" },
-              { "name": "smooth", "type": "boolean" },
-              { "name": "innerRadius", "type": "number | string | undefined" },
-              { "name": "outerRadius", "type": "number | string | undefined" },
-              { "name": "showLabels", "type": "boolean | undefined" },
-              { "name": "minValue", "type": "number | undefined" },
-              { "name": "maxValue", "type": "number | undefined" },
-              { "name": "scale", "type": "boolean | number" }
-            ],
-            "events": []
-          }
-        },
         {
           "name": "zn-chat-message",
           "description": "A single message in a chat-style conversation: avatar, sender,\ntime, optional badge, and a message bubble with optional actions. Also renders\nsystem events (connections, transfers, etc.) as a centred card.\n---\n\n\n### **Slots:**\n - _default_ - The message content. Ignored when the `message` attribute is set.\n- **badge** - Rendered in the header after the sender and time (e.g. an INTERNAL NOTE chip).\n- **attachments** - Attachments displayed beneath the message content. Use `zn-chat-message-attachment`, which auto-assigns itself to this slot.\n- **edit-dialog-trigger** - Action rendered at the end of the bubble (e.g. a remove icon button).\n- **edit-dialog** - Pass-through for an associated dialog element.\n\n### **CSS Properties:**\n - **--message-background** - The bubble's background color. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **avatar** - The avatar column.\n- **body** - The header and bubble column.\n- **header** - The sender/time/badge row.\n- **bubble** - The message bubble.\n- **content** - The message content within the bubble.\n- **attachments** - The attachments row beneath the message content.\n- **system-card** - The card rendered for system action types.",
@@ -1231,6 +1118,119 @@
             "events": []
           }
         },
+        {
+          "name": "zn-chart",
+          "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": "ChartType", "default": "'bar'" }
+            },
+            {
+              "name": "data",
+              "value": { "type": "SeriesItem[]", "default": "[]" }
+            },
+            {
+              "name": "categories",
+              "value": { "type": "string[]", "default": "[]" }
+            },
+            {
+              "name": "y-categories",
+              "value": { "type": "string[]", "default": "[]" }
+            },
+            {
+              "name": "indicators",
+              "value": { "type": "RadarIndicator[]", "default": "[]" }
+            },
+            {
+              "name": "xaxis",
+              "value": { "type": "'datetime' | 'category' | 'numeric'" }
+            },
+            { "name": "d-size", "value": { "type": "number", "default": "1" } },
+            {
+              "name": "stacked",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "live",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "data-url",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "live-interval",
+              "value": { "type": "number", "default": "1000" }
+            },
+            {
+              "name": "height",
+              "value": { "type": "number", "default": "300" }
+            },
+            {
+              "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": "inner-radius",
+              "value": { "type": "number | string | undefined" }
+            },
+            {
+              "name": "outer-radius",
+              "value": { "type": "number | string | undefined" }
+            },
+            {
+              "name": "show-labels",
+              "value": { "type": "boolean | undefined" }
+            },
+            { "name": "min-value", "value": { "type": "number | undefined" } },
+            { "name": "max-value", "value": { "type": "number | undefined" } },
+            {
+              "name": "scale",
+              "value": { "type": "boolean | number", "default": "false" }
+            }
+          ],
+          "events": [],
+          "js": {
+            "properties": [
+              { "name": "type", "type": "ChartType" },
+              { "name": "data", "type": "SeriesItem[]" },
+              { "name": "categories", "type": "string[]" },
+              { "name": "yCategories", "type": "string[]" },
+              { "name": "indicators", "type": "RadarIndicator[]" },
+              {
+                "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 | number" },
+              { "name": "yAxisAppend", "type": "string" },
+              { "name": "colors", "type": "string[] | undefined" },
+              { "name": "syncGroup", "type": "string | undefined" },
+              { "name": "smooth", "type": "boolean" },
+              { "name": "innerRadius", "type": "number | string | undefined" },
+              { "name": "outerRadius", "type": "number | string | undefined" },
+              { "name": "showLabels", "type": "boolean | undefined" },
+              { "name": "minValue", "type": "number | undefined" },
+              { "name": "maxValue", "type": "number | undefined" },
+              { "name": "scale", "type": "boolean | number" }
+            ],
+            "events": []
+          }
+        },
         {
           "name": "zn-chat-message-attachment",
           "description": "A single file or link attachment for a `zn-chat-message` or `zn-content-block`.\nRenders an icon and a label as a link, styled to match the message's attachments row. It is\nintended to be used only inside a `zn-chat-message` or `zn-content-block` and is automatically\nplaced in that component's `attachments` slot.\n---\n\n\n### **Slots:**\n - _default_ - The attachment label. Falls back to the `name` attribute when empty.\n\n### **CSS Parts:**\n - **base** - The attachment link.\n- **icon** - The leading icon.\n- **label** - The attachment label.",
@@ -2746,6 +2746,11 @@
               "name": "no-initial-load",
               "value": { "type": "boolean", "default": "false" }
             },
+            {
+              "name": "sharable",
+              "description": "When set, the table's non-default state (search, filter, sort, page, per-page and field values)\nis mirrored to the URL query string and restored from it on load, so the view is shareable.",
+              "value": { "type": "boolean", "default": "false" }
+            },
             {
               "name": "group-by",
               "value": { "type": "string", "default": "''" }
@@ -2834,6 +2839,11 @@
               { "name": "filters", "type": "[]" },
               { "name": "method", "type": "'GET' | 'POST'" },
               { "name": "noInitialLoad", "type": "boolean" },
+              {
+                "name": "sharable",
+                "description": "When set, the table's non-default state (search, filter, sort, page, per-page and field values)\nis mirrored to the URL query string and restored from it on load, so the view is shareable.",
+                "type": "boolean"
+              },
               { "name": "groupBy", "type": "string" },
               { "name": "groups", "type": "string" },
               { "name": "itemsPerPage", "type": "number" },
@@ -2935,7 +2945,7 @@
             },
             {
               "name": "debounce-delay",
-              "description": "The delay in milliseconds before triggering a search (default: 500).",
+              "description": "The delay in milliseconds before triggering a search (default: 350).",
               "value": { "type": "number", "default": "350" }
             }
           ],
@@ -2980,7 +2990,7 @@
               },
               {
                 "name": "debounceDelay",
-                "description": "The delay in milliseconds before triggering a search (default: 500).",
+                "description": "The delay in milliseconds before triggering a search (default: 350).",
                 "type": "number"
               },
               { "name": "validationMessage", "type": "string" },

package/dist/zn.d.ts

@@ -3460,6 +3460,13 @@ declare module "components/data-table-filter/data-table-filter.component" {
         private toggleOption;
         private selectedValues;
         private emitChange;
+        /**
+         * Rebuild the active filters from an encoded `value` (the inverse of emitChange), so a filter
+         * restored from a shareable URL shows its pills. Runs only while there are no active filters and
+         * needs the filters schema present to resolve each key. Sets `_active` directly so it neither
+         * re-emits nor overwrites the value it just read.
+         */
+        private hydrateFromValue;
         private handleDateInput;
         private serializeDate;
         private handleTextInput;
@@ -3679,7 +3686,7 @@ declare module "components/data-table-search/data-table-search.component" {
      * @property {string} placeholder - The placeholder text for the search input (default: "Search...").
      * @property {string} helpText - Help text, shown from an information icon inside the search input.
      * @property {string} searchUri - Optional URI to use for search operations.
-     * @property {number} debounceDelay - The delay in milliseconds before triggering a search (default: 500).
+     * @property {number} debounceDelay - The delay in milliseconds before triggering a search (default: 350).
      */
     export default class ZnDataTableSearch extends ZincElement implements ZincFormControl {
         static styles: CSSResultGroup;
@@ -4139,6 +4146,11 @@ declare module "components/data-table/data-table.component" {
         filters: [];
         method: 'GET' | 'POST';
         noInitialLoad: boolean;
+        /**
+         * When set, the table's non-default state (search, filter, sort, page, per-page and field values)
+         *is mirrored to the URL query string and restored from it on load, so the view is shareable.
+         */
+        sharable: boolean;
         groupBy: string;
         groups: string;
         itemsPerPage: number;
@@ -4147,6 +4159,9 @@ declare module "components/data-table/data-table.component" {
         private _hasLoadedData;
         private _lastLoadHadRows;
         private _lastTableContent;
+        private _sharableInitialised;
+        private _sharableDefaults;
+        private readonly _urlManagedKeys;
         private readonly resizeObserver;
         private page;
         private totalPages;
@@ -4173,8 +4188,36 @@ declare module "components/data-table/data-table.component" {
         private isColumnVisible;
         private applyColumnDefaults;
         private toggleColumn;
+        private static readonly _sharableKnownKeys;
+        /**
+         * Snapshot the initial (attribute-provided) value of every managed key, so the URL writer can
+         * omit any key still holding its default - e.g. the table's default sort/direction, page 1 or the
+         * default page size. Captured once, before the URL is read, so URL values are treated as deltas.
+         */
+        private _captureSharableDefaults;
+        /**
+         * Seed the table state from the URL query string (raw param names) when `sharable` is set. Runs
+         * once, before the first render, so the initial data request already carries the shared state.
+         */
+        private _readSharableState;
+        /**
+         * Push the shared state back into the actual DOM fields so the UI reflects it. The search value
+         * lives on the slotted <zn-data-table-search>, the filter on <zn-data-table-filter>, and extra
+         * field params on the search/inputs fields (all light-DOM descendants).
+         */
+        private _populateSharableFields;
+        private _hasFieldNamed;
+        private _setSharableFieldValue;
+        /**
+         * Mirror the current table state to the URL query string (raw param names) via replaceState.
+         * A key is written only when its value differs from the captured default, so the default sort,
+         * page 1, the default page size and empty search/filter/fields never clutter the URL. Unrelated
+         * params (e.g. utm_*) are preserved.
+         */
+        private _updateSharableUrl;
         render(): TemplateResult<1>;
         connectedCallback(): void;
+        protected firstUpdated(): void;
         protected updated(changed: PropertyValues): void;
         private publishFilterSuggestions;
         private getTemplate;