@kubex/zinc 2.0.3 → 2.0.4

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

@@ -13,17 +13,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-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.",
@@ -71,6 +60,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-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",
@@ -2299,7 +2299,7 @@
     },
     {
       "name": "zn-form-actions",
-      "description": "Standard action row for the bottom of a form. Renders a submit button by default; opt in to more\nwith `with-cancel` and `with-reset`.\n---\n\n\n### **Events:**\n - **zn-cancel** - Emitted when the cancel button is clicked.\n\n### **Slots:**\n - _default_ - Extra actions, placed before the buttons. `align=\"start\"` on a child moves it to the start of the row; any number can sit on either side. Write them in the order they should be read — the sides are set by CSS ordering, so markup order is what a keyboard follows.\n\n### **CSS Parts:**\n - **cancel-button** - The cancel button.\n- **reset-button** - The reset button.\n- **submit-button** - The submit button.",
+      "description": "\n---\n",
       "attributes": [
         {
           "name": "submit-text",
@@ -2350,6 +2350,11 @@
           "name": "loading-on-submit",
           "description": "Shows the submit button loading and ignores further submits until the console reports the request finished,\nso a slow save such as an upload can't be sent twice. Only for forms the console submits.",
           "values": []
+        },
+        {
+          "name": "hide-until-changed",
+          "description": "Hides the row until the form's values differ from when it loaded or was last saved, and hides it again once\nthey match.",
+          "values": []
         }
       ],
       "references": [
@@ -3055,7 +3060,7 @@
         { "name": "name", "values": [] },
         {
           "name": "value",
-          "description": "The pairs as a JSON object, such as `{\"1\": \"{{recipient.firstName}}\"}`.",
+          "description": "The pairs as a JSON object, such as `{\"1\": \"{{recipient.firstName}}\"}`. With `list`, the names as a JSON array,\nsuch as `[\"10.0.0.0/24\"]`.",
           "values": []
         },
         { "name": "label", "values": [] },
@@ -3068,6 +3073,16 @@
           "description": "Passed to each value input, so its slash menu can insert merge fields.",
           "values": []
         },
+        {
+          "name": "value-options",
+          "description": "Makes each value a choice instead of free text: a JSON object of option values to labels, such as\n`{\"default\": \"System default\", \"auto\": \"Auto approve\"}`. New rows take the first option.",
+          "values": [{ "name": "Record<string, string>" }]
+        },
+        {
+          "name": "list",
+          "description": "Edits a plain list of names with no values, submitted as a JSON array.",
+          "values": []
+        },
         { "name": "form", "values": [] },
         { "name": "disabled", "values": [] }
       ],
@@ -3679,14 +3694,6 @@
         }
       ]
     },
-    {
-      "name": "zn-pane",
-      "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": [{ "name": "flush", "values": [] }],
-      "references": [
-        { "name": "Documentation", "url": "https://zinc.style/components/pane" }
-      ]
-    },
     {
       "name": "zn-pagination",
       "description": "Pagination component for navigating through pages of content.\n---\n",
@@ -3703,6 +3710,14 @@
         }
       ]
     },
+    {
+      "name": "zn-pane",
+      "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": [{ "name": "flush", "values": [] }],
+      "references": [
+        { "name": "Documentation", "url": "https://zinc.style/components/pane" }
+      ]
+    },
     {
       "name": "zn-panel",
       "description": "Panels are versatile containers that provide structure for organizing content with optional headers and footers.\n---\n\n\n### **Slots:**\n - _default_ - The panel's main content.\n- **actions** - Actions displayed in the panel header (buttons, chips, etc).\n- **footer** - Content displayed in the panel footer.\n\n### **CSS Properties:**\n - **--zn-panel-basis** - The flex-basis of the panel. Can be set using the basis-px attribute. _(default: undefined)_\n- **--zn-panel-header-padding** - Padding around the header row. Defaults to `--zn-base-gap`. _(default: undefined)_\n- **--zn-panel-footer-padding** - Padding around the footer row. _(default: undefined)_\n- **--zn-panel-padding** - Padding around the body. Defaults to `--zn-base-gap`. _(default: undefined)_\n- **--zn-panel-shadow** - Resting shadow. Defaults to none. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **header** - The header region, when a caption or actions are given.\n- **header-content** - The padded row inside the header, forwarded from zn-header.\n- **header-left** - The caption and description, forwarded from zn-header.\n- **footer** - The footer region, when the footer slot is filled.",
@@ -4432,27 +4447,6 @@
         }
       ]
     },
-    {
-      "name": "zn-reveal",
-      "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": [
-        { "name": "duration", "values": [] },
-        { "name": "initial", "values": [] },
-        { "name": "revealed", "values": [] },
-        { "name": "hide-delay", "values": [] },
-        {
-          "name": "no-toggle",
-          "description": "Disables click-to-toggle so the value is only revealed on hover. Clicks still bubble to the parent.",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://zinc.style/components/reveal"
-        }
-      ]
-    },
     {
       "name": "zn-report-table",
       "description": "A grouped report: one row per value of a dimension, read column by column, with a total row.\n---\n\n\n### **Events:**\n - **zn-report-change** - Emitted when the type, group by, date range or filter is changed, before the report is fetched again.\n\n### **Slots:**\n - **inputs** - Inputs whose name and value are sent with every request (csrf tokens and similar).\n- **empty-state** - Replaces the default empty state.",
@@ -4526,6 +4520,27 @@
         }
       ]
     },
+    {
+      "name": "zn-reveal",
+      "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": [
+        { "name": "duration", "values": [] },
+        { "name": "initial", "values": [] },
+        { "name": "revealed", "values": [] },
+        { "name": "hide-delay", "values": [] },
+        {
+          "name": "no-toggle",
+          "description": "Disables click-to-toggle so the value is only revealed on hover. Clicks still bubble to the parent.",
+          "values": []
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://zinc.style/components/reveal"
+        }
+      ]
+    },
     {
       "name": "zn-schedule-builder",
       "description": "Builds a weekly opening-hours schedule as a drag-to-paint calendar or a compact list of\ntime ranges, and posts the result as JSON.\n---\n\n\n### **Events:**\n - **zn-change** - Emitted when the schedule changes.\n\n### **Methods:**\n - **checkValidity(): _boolean_** - Checks validity but does not show a validation message.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity(): _boolean_** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.\n- **setDay(day: _ScheduleDay_, ranges: _ScheduleRange[]_)** - Replaces the hours for a single day, in the save timezone.\n- **getDay(day: _ScheduleDay_): _ScheduleRange[]_** - Reads the hours for a single day, in the save timezone.\n- **setDisplayDay(day: _ScheduleDay_, ranges: _ScheduleRange[]_)** - Replaces the hours for a single day, given in the display timezone.\n\n### **Slots:**\n - **label** - The schedule's label. Alternatively, use the `label` attribute.\n- **help-text** - Text that describes how to use the schedule. Alternatively, use the `help-text` attribute.\n\n### **CSS Properties:**\n - **--slot-height** - The height of a single time slot in the calendar. Defaults to `18px`. _(default: undefined)_\n- **--gutter-width** - The width of the calendar's time gutter. Defaults to `64px`. _(default: undefined)_\n- **--open-color** - The fill used for open hours. _(default: undefined)_\n- **--reduced-color** - The fill used for hours an exception removes. _(default: undefined)_\n\n### **CSS Parts:**\n - **form-control** - The form control that wraps the builder, label and help text.\n- **base** - The component's base wrapper.\n- **toolbar** - The row above the builder holding the hint, legend and view toggle.\n- **calendar** - The calendar view wrapper.\n- **list** - The form (list) view wrapper.\n- **summary** - The summary panel beside the calendar.",

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": "2.0.3",
+  "version": "2.0.4",
   "description-markup": "markdown",
   "contributions": {
     "html": {
@@ -15,28 +15,6 @@
           "events": [],
           "js": { "properties": [], "events": [] }
         },
-        {
-          "name": "zn-action-bar",
-          "description": "Short summary of the component's intended use.\n\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\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.",
@@ -117,6 +95,28 @@
             ]
           }
         },
+        {
+          "name": "zn-action-bar",
+          "description": "Short summary of the component's intended use.\n\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\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",
@@ -5273,7 +5273,7 @@
         },
         {
           "name": "zn-form-actions",
-          "description": "Standard action row for the bottom of a form. Renders a submit button by default; opt in to more\nwith `with-cancel` and `with-reset`.\n\n---\n\n\n### **Events:**\n - **zn-cancel** - Emitted when the cancel button is clicked.\n\n### **Slots:**\n - _default_ - Extra actions, placed before the buttons. `align=\"start\"` on a child moves it to the start of the row; any number can sit on either side. Write them in the order they should be read — the sides are set by CSS ordering, so markup order is what a keyboard follows.\n\n### **CSS Parts:**\n - **cancel-button** - The cancel button.\n- **reset-button** - The reset button.\n- **submit-button** - The submit button.",
+          "description": "\n\n---\n",
           "doc-url": "",
           "attributes": [
             {
@@ -5325,20 +5325,14 @@
               "name": "loading-on-submit",
               "description": "Shows the submit button loading and ignores further submits until the console reports the request finished,\nso a slow save such as an upload can't be sent twice. Only for forms the console submits.",
               "value": { "type": "boolean", "default": "false" }
-            }
-          ],
-          "slots": [
-            {
-              "name": "",
-              "description": "Extra actions, placed before the buttons. `align=\"start\"` on a child moves it to the start of the row; any number can sit on either side. Write them in the order they should be read — the sides are set by CSS ordering, so markup order is what a keyboard follows."
-            }
-          ],
-          "events": [
+            },
             {
-              "name": "zn-cancel",
-              "description": "Emitted when the cancel button is clicked."
+              "name": "hide-until-changed",
+              "description": "Hides the row until the form's values differ from when it loaded or was last saved, and hides it again once\nthey match.",
+              "value": { "type": "boolean", "default": "false" }
             }
           ],
+          "events": [],
           "js": {
             "properties": [
               {
@@ -5390,14 +5384,14 @@
                 "name": "loadingOnSubmit",
                 "description": "Shows the submit button loading and ignores further submits until the console reports the request finished,\nso a slow save such as an upload can't be sent twice. Only for forms the console submits.",
                 "type": "boolean"
-              }
-            ],
-            "events": [
+              },
               {
-                "name": "zn-cancel",
-                "description": "Emitted when the cancel button is clicked."
+                "name": "hideUntilChanged",
+                "description": "Hides the row until the form's values differ from when it loaded or was last saved, and hides it again once\nthey match.",
+                "type": "boolean"
               }
-            ]
+            ],
+            "events": []
           }
         },
         {
@@ -6960,7 +6954,7 @@
             { "name": "name", "value": { "type": "string", "default": "''" } },
             {
               "name": "value",
-              "description": "The pairs as a JSON object, such as `{\"1\": \"{{recipient.firstName}}\"}`.",
+              "description": "The pairs as a JSON object, such as `{\"1\": \"{{recipient.firstName}}\"}`. With `list`, the names as a JSON array,\nsuch as `[\"10.0.0.0/24\"]`.",
               "value": { "type": "string", "default": "'{}'" }
             },
             { "name": "label", "value": { "type": "string", "default": "''" } },
@@ -6985,6 +6979,19 @@
               "description": "Passed to each value input, so its slash menu can insert merge fields.",
               "value": { "type": "string", "default": "''" }
             },
+            {
+              "name": "value-options",
+              "description": "Makes each value a choice instead of free text: a JSON object of option values to labels, such as\n`{\"default\": \"System default\", \"auto\": \"Auto approve\"}`. New rows take the first option.",
+              "value": {
+                "type": "Record<string, string> | null",
+                "default": "null"
+              }
+            },
+            {
+              "name": "list",
+              "description": "Edits a plain list of names with no values, submitted as a JSON array.",
+              "value": { "type": "boolean", "default": "false" }
+            },
             { "name": "form", "value": { "type": "string", "default": "''" } },
             {
               "name": "disabled",
@@ -7012,7 +7019,12 @@
               { "name": "name", "type": "string" },
               {
                 "name": "value",
-                "description": "The pairs as a JSON object, such as `{\"1\": \"{{recipient.firstName}}\"}`.",
+                "description": "The pairs as a JSON object, such as `{\"1\": \"{{recipient.firstName}}\"}`. With `list`, the names as a JSON array,\nsuch as `[\"10.0.0.0/24\"]`.",
+                "type": "string"
+              },
+              {
+                "name": "defaultValue",
+                "description": "The value a form reset restores, taken from the initial `value` attribute.",
                 "type": "string"
               },
               { "name": "label", "type": "string" },
@@ -7025,6 +7037,16 @@
                 "description": "Passed to each value input, so its slash menu can insert merge fields.",
                 "type": "string"
               },
+              {
+                "name": "valueOptions",
+                "description": "Makes each value a choice instead of free text: a JSON object of option values to labels, such as\n`{\"default\": \"System default\", \"auto\": \"Auto approve\"}`. New rows take the first option.",
+                "type": "Record<string, string> | null"
+              },
+              {
+                "name": "list",
+                "description": "Edits a plain list of names with no values, submitted as a JSON array.",
+                "type": "boolean"
+              },
               { "name": "form", "type": "string" },
               { "name": "disabled", "type": "boolean" },
               { "name": "validity", "type": "ValidityState" },
@@ -8547,6 +8569,27 @@
             ]
           }
         },
+        {
+          "name": "zn-pagination",
+          "description": "Pagination component for navigating through pages of content.\n\n---\n",
+          "doc-url": "",
+          "attributes": [
+            { "name": "limit", "value": { "type": "number", "default": "10" } },
+            { "name": "total", "value": { "type": "number", "default": "0" } },
+            { "name": "page", "value": { "type": "number", "default": "1" } },
+            { "name": "uri", "value": { "type": "string", "default": "\"\"" } }
+          ],
+          "events": [],
+          "js": {
+            "properties": [
+              { "name": "limit", "type": "number" },
+              { "name": "total", "type": "number" },
+              { "name": "page", "type": "number" },
+              { "name": "uri", "type": "string" }
+            ],
+            "events": []
+          }
+        },
         {
           "name": "zn-pane",
           "description": "Short summary of the component's intended use.\n\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.",
@@ -8569,27 +8612,6 @@
             ]
           }
         },
-        {
-          "name": "zn-pagination",
-          "description": "Pagination component for navigating through pages of content.\n\n---\n",
-          "doc-url": "",
-          "attributes": [
-            { "name": "limit", "value": { "type": "number", "default": "10" } },
-            { "name": "total", "value": { "type": "number", "default": "0" } },
-            { "name": "page", "value": { "type": "number", "default": "1" } },
-            { "name": "uri", "value": { "type": "string", "default": "\"\"" } }
-          ],
-          "events": [],
-          "js": {
-            "properties": [
-              { "name": "limit", "type": "number" },
-              { "name": "total", "type": "number" },
-              { "name": "page", "type": "number" },
-              { "name": "uri", "type": "string" }
-            ],
-            "events": []
-          }
-        },
         {
           "name": "zn-panel",
           "description": "Panels are versatile containers that provide structure for organizing content with optional headers and footers.\n\n---\n\n\n### **Slots:**\n - _default_ - The panel's main content.\n- **actions** - Actions displayed in the panel header (buttons, chips, etc).\n- **footer** - Content displayed in the panel footer.\n\n### **CSS Properties:**\n - **--zn-panel-basis** - The flex-basis of the panel. Can be set using the basis-px attribute. _(default: undefined)_\n- **--zn-panel-header-padding** - Padding around the header row. Defaults to `--zn-base-gap`. _(default: undefined)_\n- **--zn-panel-footer-padding** - Padding around the footer row. _(default: undefined)_\n- **--zn-panel-padding** - Padding around the body. Defaults to `--zn-base-gap`. _(default: undefined)_\n- **--zn-panel-shadow** - Resting shadow. Defaults to none. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **header** - The header region, when a caption or actions are given.\n- **header-content** - The padded row inside the header, forwarded from zn-header.\n- **header-left** - The caption and description, forwarded from zn-header.\n- **footer** - The footer region, when the footer slot is filled.",
@@ -10152,60 +10174,6 @@
             ]
           }
         },
-        {
-          "name": "zn-reveal",
-          "description": "Short summary of the component's intended use.\n\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": [
-            {
-              "name": "duration",
-              "value": { "type": "number", "default": "2000" }
-            },
-            {
-              "name": "initial",
-              "value": { "type": "string", "default": "''" }
-            },
-            {
-              "name": "revealed",
-              "value": { "type": "string", "default": "''" }
-            },
-            {
-              "name": "hide-delay",
-              "value": { "type": "number", "default": "150" }
-            },
-            {
-              "name": "no-toggle",
-              "description": "Disables click-to-toggle so the value is only revealed on hover. Clicks still bubble to the parent.",
-              "value": { "type": "boolean", "default": "false" }
-            }
-          ],
-          "slots": [
-            { "name": "", "description": "The default slot." },
-            { "name": "example", "description": "An example slot." }
-          ],
-          "events": [
-            { "name": "zn-event-name", "description": "Emitted as an example." }
-          ],
-          "js": {
-            "properties": [
-              { "name": "duration", "type": "number" },
-              { "name": "initial", "type": "string" },
-              { "name": "revealed", "type": "string" },
-              { "name": "hideDelay", "type": "number" },
-              {
-                "name": "noToggle",
-                "description": "Disables click-to-toggle so the value is only revealed on hover. Clicks still bubble to the parent.",
-                "type": "boolean"
-              }
-            ],
-            "events": [
-              {
-                "name": "zn-event-name",
-                "description": "Emitted as an example."
-              }
-            ]
-          }
-        },
         {
           "name": "zn-report-table",
           "description": "A grouped report: one row per value of a dimension, read column by column, with a total row.\n\n---\n\n\n### **Events:**\n - **zn-report-change** - Emitted when the type, group by, date range or filter is changed, before the report is fetched again.\n\n### **Slots:**\n - **inputs** - Inputs whose name and value are sent with every request (csrf tokens and similar).\n- **empty-state** - Replaces the default empty state.",
@@ -10379,6 +10347,60 @@
             ]
           }
         },
+        {
+          "name": "zn-reveal",
+          "description": "Short summary of the component's intended use.\n\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": [
+            {
+              "name": "duration",
+              "value": { "type": "number", "default": "2000" }
+            },
+            {
+              "name": "initial",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "revealed",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "hide-delay",
+              "value": { "type": "number", "default": "150" }
+            },
+            {
+              "name": "no-toggle",
+              "description": "Disables click-to-toggle so the value is only revealed on hover. Clicks still bubble to the parent.",
+              "value": { "type": "boolean", "default": "false" }
+            }
+          ],
+          "slots": [
+            { "name": "", "description": "The default slot." },
+            { "name": "example", "description": "An example slot." }
+          ],
+          "events": [
+            { "name": "zn-event-name", "description": "Emitted as an example." }
+          ],
+          "js": {
+            "properties": [
+              { "name": "duration", "type": "number" },
+              { "name": "initial", "type": "string" },
+              { "name": "revealed", "type": "string" },
+              { "name": "hideDelay", "type": "number" },
+              {
+                "name": "noToggle",
+                "description": "Disables click-to-toggle so the value is only revealed on hover. Clicks still bubble to the parent.",
+                "type": "boolean"
+              }
+            ],
+            "events": [
+              {
+                "name": "zn-event-name",
+                "description": "Emitted as an example."
+              }
+            ]
+          }
+        },
         {
           "name": "zn-schedule-builder",
           "description": "Builds a weekly opening-hours schedule as a drag-to-paint calendar or a compact list of\ntime ranges, and posts the result as JSON.\n\n---\n\n\n### **Events:**\n - **zn-change** - Emitted when the schedule changes.\n\n### **Methods:**\n - **checkValidity(): _boolean_** - Checks validity but does not show a validation message.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity(): _boolean_** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.\n- **setDay(day: _ScheduleDay_, ranges: _ScheduleRange[]_)** - Replaces the hours for a single day, in the save timezone.\n- **getDay(day: _ScheduleDay_): _ScheduleRange[]_** - Reads the hours for a single day, in the save timezone.\n- **setDisplayDay(day: _ScheduleDay_, ranges: _ScheduleRange[]_)** - Replaces the hours for a single day, given in the display timezone.\n\n### **Slots:**\n - **label** - The schedule's label. Alternatively, use the `label` attribute.\n- **help-text** - Text that describes how to use the schedule. Alternatively, use the `help-text` attribute.\n\n### **CSS Properties:**\n - **--slot-height** - The height of a single time slot in the calendar. Defaults to `18px`. _(default: undefined)_\n- **--gutter-width** - The width of the calendar's time gutter. Defaults to `64px`. _(default: undefined)_\n- **--open-color** - The fill used for open hours. _(default: undefined)_\n- **--reduced-color** - The fill used for hours an exception removes. _(default: undefined)_\n\n### **CSS Parts:**\n - **form-control** - The form control that wraps the builder, label and help text.\n- **base** - The component's base wrapper.\n- **toolbar** - The row above the builder holding the hint, legend and view toggle.\n- **calendar** - The calendar view wrapper.\n- **list** - The form (list) view wrapper.\n- **summary** - The summary panel beside the calendar.",

package/dist/zn.d.ts

@@ -3121,7 +3121,9 @@ declare module "internal/conditional" {
         private conditionals;
         private required;
         private initiallyDisabled;
+        private forms;
         private readonly handleChange;
+        private readonly handleReset;
         constructor(host: ReactiveControllerHost & Element & ConditionalHost);
         /** Call from the host's `firstUpdated()` to parse IDs, find elements, attach listeners, and run the initial check. */
         setup(): void;
@@ -8913,25 +8915,6 @@ declare module "components/form-actions/form-actions.component" {
     import { type CSSResultGroup } from 'lit';
     import ZincElement from "internal/zinc-element";
     import ZnButton from "components/button/index";
-    /**
-     * @summary Standard action row for the bottom of a form. Renders a submit button by default; opt in to more
-     * with `with-cancel` and `with-reset`.
-     * @documentation https://zinc.style/components/form-actions
-     * @status experimental
-     * @since 1.0
-     *
-     * @dependency zn-button
-     *
-     * @event zn-cancel - Emitted when the cancel button is clicked.
-     *
-     * @slot - Extra actions, placed before the buttons. `align="start"` on a child moves it to the start of the row; any
-     * number can sit on either side. Write them in the order they should be read — the sides are set by CSS ordering, so
-     * markup order is what a keyboard follows.
-     *
-     * @csspart cancel-button - The cancel button.
-     * @csspart reset-button - The reset button.
-     * @csspart submit-button - The submit button.
-     */
     export default class ZnFormActions extends ZincElement {
         static styles: CSSResultGroup;
         static dependencies: {
@@ -8960,10 +8943,27 @@ declare module "components/form-actions/form-actions.component" {
          * so a slow save such as an upload can't be sent twice. Only for forms the console submits.
          */
         loadingOnSubmit: boolean;
+        /**
+         * Hides the row until the form's values differ from when it loaded or was last saved, and hides it again once
+         * they match.
+         */
+        hideUntilChanged: boolean;
         private submitting;
         private watchedForm;
+        private changeForm;
+        private baseline;
+        private interacted;
         connectedCallback(): void;
         disconnectedCallback(): void;
+        /**
+         * The form's values, compared against the baseline. Read from the controls directly, since building FormData runs
+         * zinc controls' formdata handlers, which trim the value being typed.
+         */
+        private snapshot;
+        private checkForChanges;
+        private markSaved;
+        private refreshBaseline;
+        private handleFormReset;
         private handleFormSubmit;
         private handleRequested;
         private handleDone;
@@ -15112,6 +15112,8 @@ declare module "components/key-value/key-value.component" {
      * @since 1.0
      *
      * @dependency zn-input
+     * @dependency zn-select
+     * @dependency zn-option
      * @dependency zn-button
      *
      * @event zn-change - Emitted when a pair is added, removed or edited.
@@ -15127,8 +15129,13 @@ declare module "components/key-value/key-value.component" {
         private readonly hasSlotController;
         private readonly formControlController;
         name: string;
-        /** The pairs as a JSON object, such as `{"1": "{{recipient.firstName}}"}`. */
+        /**
+         * The pairs as a JSON object, such as `{"1": "{{recipient.firstName}}"}`. With `list`, the names as a JSON array,
+         * such as `["10.0.0.0/24"]`.
+         */
         value: string;
+        /** The value a form reset restores, taken from the initial `value` attribute. */
+        defaultValue: string;
         label: string;
         helpText: string;
         keyLabel: string;
@@ -15136,6 +15143,13 @@ declare module "components/key-value/key-value.component" {
         addText: string;
         /** Passed to each value input, so its slash menu can insert merge fields. */
         slashItems: string;
+        /**
+         * Makes each value a choice instead of free text: a JSON object of option values to labels, such as
+         * `{"default": "System default", "auto": "Auto approve"}`. New rows take the first option.
+         */
+        valueOptions: Record<string, string> | null;
+        /** Edits a plain list of names with no values, submitted as a JSON array. */
+        list: boolean;
         form: string;
         disabled: boolean;
         private _rows;
@@ -15146,10 +15160,18 @@ declare module "components/key-value/key-value.component" {
         reportValidity(): boolean;
         setCustomValidity(): void;
         protected willUpdate(changed: PropertyValues): void;
+        private get _defaultValue();
+        private _emptyRow;
+        private _withSpareRow;
         private _parse;
         private _serialise;
         private _update;
         private _edit;
+        private get _reduceMotion();
+        private _easing;
+        private _add;
+        private _remove;
+        private _renderValue;
         render(): import("lit-html").TemplateResult<1>;
     }
 }