@kubex/zinc 1.1.69 → 1.1.71

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.69",
+  "version": "1.1.71",
   "description-markup": "markdown",
   "contributions": {
     "html": {
@@ -3663,7 +3663,7 @@
         },
         {
           "name": "zn-file",
-          "description": "File controls allow selecting an arbitrary number of files for uploading.\n---\n\n\n### **Events:**\n - **zn-blur** - Emitted when the control loses focus.\n- **zn-change** - Emitted when an alteration to the control's value is committed by the user.\n- **zn-clear** - Emitted when the user confirms clearing the selected file or `src`.\n- **zn-error** - Emitted when multiple files are selected via drag and drop, without the `multiple` property being set.\n- **zn-focus** - Emitted when the control gains focus.\n- **zn-input** - Emitted when the control receives input.\n\n### **Methods:**\n - **checkValidity()** - Checks for validity but does not show a validation message.\nReturns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - 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- **focus(options: _FocusOptions_)** - Sets focus on the button or droparea.\n- **blur()** - Removes focus from the button or droparea.\n\n### **Slots:**\n - **label** - The file control's label. Alternatively, you can use the `label` attribute.\n- **help-text** - Text that describes how to use the file control. Alternatively, you can use the `help-text` attribute.\n- **trigger** - Optional content to be used as trigger instead of the default content. Opening the file dialog on click and as well as drag and drop will work for this content. Following attributes will no longer work: *label*, *droparea*, *help-text*, *size*, *hide-value*. Also if using the disabled attribute, the disabled styling will not be applied and must be taken care of yourself.\n\n### **CSS Parts:**\n - **form-control** - The form control that wraps the label, input, and help text.\n- **form-control-label** - The label's wrapper.\n- **form-control-input** - The input's wrapper.\n- **form-control-help-text** - The help text's wrapper.\n- **button-wrapper** - The wrapper around the button and text value.\n- **button** - The zn-button acting as a file input.\n- **button__base** - The zn-button's exported `base` part.\n- **value** - The chosen files or placeholder text for the file input.\n- **droparea** - The element wrapping the drop zone.\n- **droparea-background** - The background of the drop zone.\n- **upload** - The upload button shown in the droparea when no file is selected.\n- **preview** - The image preview rendered in the droparea for previewable files.\n- **filename** - The filename label rendered in the droparea for non-previewable files.\n- **clear** - The clear button rendered in the droparea when a file is present.\n- **clear-confirm** - The confirmation dialog shown before clearing the file.\n- **link** - The current link anchor rendered when `show-link` is enabled.\n- **trigger** - The container that wraps the trigger.",
+          "description": "File controls allow selecting an arbitrary number of files for uploading.\n---\n\n\n### **Events:**\n - **zn-blur** - Emitted when the control loses focus.\n- **zn-change** - Emitted when an alteration to the control's value is committed by the user.\n- **zn-clear** - Emitted when the user confirms clearing the selected file or `src`.\n- **zn-error** - Emitted when multiple files are selected via drag and drop, without the `multiple` property being set.\n- **zn-focus** - Emitted when the control gains focus.\n- **zn-input** - Emitted when the control receives input.\n\n### **Methods:**\n - **checkValidity()** - Checks for validity but does not show a validation message.\nReturns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - 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- **focus(options: _FocusOptions_)** - Sets focus on the button or droparea.\n- **blur()** - Removes focus from the button or droparea.\n- **clear()** - Programmatically clears the selected file and any external `src` without\nconfirmation. Unlike a user-initiated clear, this does not flag the control\nto submit an empty value.\n\n### **Slots:**\n - **label** - The file control's label. Alternatively, you can use the `label` attribute.\n- **help-text** - Text that describes how to use the file control. Alternatively, you can use the `help-text` attribute.\n- **trigger** - Optional content to be used as trigger instead of the default content. Opening the file dialog on click and as well as drag and drop will work for this content. Following attributes will no longer work: *label*, *droparea*, *help-text*, *size*, *hide-value*. Also if using the disabled attribute, the disabled styling will not be applied and must be taken care of yourself.\n\n### **CSS Parts:**\n - **form-control** - The form control that wraps the label, input, and help text.\n- **form-control-label** - The label's wrapper.\n- **form-control-input** - The input's wrapper.\n- **form-control-help-text** - The help text's wrapper.\n- **button-wrapper** - The wrapper around the button and text value.\n- **button** - The zn-button acting as a file input.\n- **button__base** - The zn-button's exported `base` part.\n- **value** - The chosen files or placeholder text for the file input.\n- **droparea** - The element wrapping the drop zone.\n- **droparea-background** - The background of the drop zone.\n- **upload** - The upload button shown in the droparea when no file is selected.\n- **preview** - The image preview rendered in the droparea for previewable files.\n- **filename** - The filename label rendered in the droparea for non-previewable files.\n- **clear** - The clear button rendered in the droparea when a file is present.\n- **clear-confirm** - The confirmation dialog shown before clearing the file.\n- **link** - The current link anchor rendered when `show-link` is enabled.\n- **trigger** - The container that wraps the trigger.",
           "doc-url": "",
           "attributes": [
             {
@@ -4445,7 +4445,10 @@
             { "name": "label", "value": { "type": "string", "default": "''" } },
             {
               "name": "library",
-              "value": { "type": "string", "default": "'material'" }
+              "value": {
+                "type": "string",
+                "default": "'material-symbols-outlined'"
+              }
             },
             { "name": "color", "value": { "type": "string", "default": "''" } },
             {
@@ -4468,6 +4471,18 @@
               "name": "required",
               "value": { "type": "boolean", "default": "false" }
             },
+            {
+              "name": "trigger-submit",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "allow-upload",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "accept",
+              "value": { "type": "string", "default": "'image/*'" }
+            },
             { "name": "form", "value": { "type": "string" } }
           ],
           "events": [],
@@ -4483,9 +4498,22 @@
               { "name": "helpText", "type": "string" },
               { "name": "disabled", "type": "boolean" },
               { "name": "required", "type": "boolean" },
+              { "name": "triggerSubmit", "type": "boolean" },
+              { "name": "allowUpload", "type": "boolean" },
+              { "name": "accept", "type": "string" },
               { "name": "form", "type": "string" },
               { "name": "defaultValue", "type": "string" },
               { "name": "value", "type": "string" },
+              {
+                "name": "file",
+                "description": "The chosen file when the user uploaded an image instead of picking an icon.",
+                "type": "File | null"
+              },
+              {
+                "name": "isImageValue",
+                "description": "True when the current value renders as an image (an uploaded file or a URL) rather than a library icon.",
+                "type": "boolean"
+              },
               { "name": "validity", "type": "ValidityState" },
               { "name": "validationMessage", "type": "string" }
             ],
@@ -4702,7 +4730,7 @@
         },
         {
           "name": "zn-input",
-          "description": "Short summary of the component's intended use.\n---\n\n\n### **Events:**\n - **zn-blur** - Emitted when the control loses focus.\n- **zn-change** - Emitted when an alteration to the control's value is committed by the user.\n- **zn-clear** - Emitted when the clear button is activated.\n- **zn-focus** - Emitted when the control gains focus.\n- **zn-input** - Emitted when the control receives input.\n- **zn-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\n - **focus(options: _FocusOptions_)** - Sets focus on the input.\n- **blur()** - Removes focus from the input.\n- **select()** - Selects all the text in the input.\n- **setSelectionRange(selectionStart: _number_, selectionEnd: _number_, selectionDirection: _'forward' | 'backward' | 'none'_)** - Sets the start and end positions of the text selection (0-based).\n- **setRangeText(replacement: _string_, start: _number_, end: _number_, selectMode: _'select' | 'start' | 'end' | 'preserve'_)** - Replaces a range of text with a new string.\n- **showPicker()** - Displays the browser picker for an input element (only works if the browser supports it for the input type).\n- **stepUp()** - Increments the value of a numeric input type by the value of the step attribute.\n- **stepDown()** - Decrements the value of a numeric input type by the value of the step attribute.\n- **checkValidity(): _boolean_** - Checks the validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - 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\n### **Slots:**\n - **label** - The input's label. Alternatively, you can use the `label` attribute.\n- **label-tooltip** - Used to add text that is displayed in a tooltip next to the label. Alternatively, you can use the `label-tooltip` attribute.\n- **context-note** - Used to add contextual text that is displayed above the input, on the right. Alternatively, you can use the `context-note` attribute.\n- **prefix** - Used to prepend a presentational icon or similar element to the input.\n- **suffix** - Used to append a presentational icon or similar element to the input.\n- **clear-icon** - An icon to use in lieu of the default clear icon.\n- **show-password-icon** - An icon to use in lieu of the default show password icon.\n- **hide-password-icon** - An icon to use in lieu of the default hide password icon.\n- **help-text** - Text that describes how to use the input. Alternatively, you can use the `help-text` attribute.\n\n### **CSS Parts:**\n - **form-control** - The form control that wraps the label, input, and help text.\n- **form-control-label** - The label's wrapper.\n- **form-control-input** - The input's wrapper.\n- **form-control-help-text** - The help text's wrapper.\n- **base** - The component's base wrapper.\n- **input** - The internal `<input>` control.\n- **prefix** - The container that wraps the prefix.\n- **clear-button** - The clear button.\n- **password-toggle-button** - The password toggle button.\n- **suffix** - The container that wraps the suffix.",
+          "description": "Short summary of the component's intended use.\n---\n\n\n### **Events:**\n - **zn-blur** - Emitted when the control loses focus.\n- **zn-change** - Emitted when an alteration to the control's value is committed by the user.\n- **zn-clear** - Emitted when the clear button is activated.\n- **zn-focus** - Emitted when the control gains focus.\n- **zn-input** - Emitted when the control receives input.\n- **zn-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\n - **focus(options: _FocusOptions_)** - Sets focus on the input.\n- **blur()** - Removes focus from the input.\n- **select()** - Selects all the text in the input.\n- **setSelectionRange(selectionStart: _number_, selectionEnd: _number_, selectionDirection: _'forward' | 'backward' | 'none'_)** - Sets the start and end positions of the text selection (0-based).\n- **setRangeText(replacement: _string_, start: _number_, end: _number_, selectMode: _'select' | 'start' | 'end' | 'preserve'_)** - Replaces a range of text with a new string.\n- **showPicker()** - Displays the browser picker for an input element (only works if the browser supports it for the input type).\n- **stepUp()** - Increments the value of a numeric input type by the value of the step attribute.\n- **stepDown()** - Decrements the value of a numeric input type by the value of the step attribute.\n- **checkValidity(): _boolean_** - Checks the validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - 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\n### **Slots:**\n - **label** - The input's label. Alternatively, you can use the `label` attribute.\n- **label-tooltip** - Used to add text that is displayed in a tooltip next to the label. Alternatively, you can use the `label-tooltip` attribute.\n- **context-note** - Used to add contextual text that is displayed above the input, on the right. Alternatively, you can use the `context-note` attribute. Range inputs display their live value here unless this is set.\n- **prefix** - Used to prepend a presentational icon or similar element to the input.\n- **suffix** - Used to append a presentational icon or similar element to the input.\n- **clear-icon** - An icon to use in lieu of the default clear icon.\n- **show-password-icon** - An icon to use in lieu of the default show password icon.\n- **hide-password-icon** - An icon to use in lieu of the default hide password icon.\n- **help-text** - Text that describes how to use the input. Alternatively, you can use the `help-text` attribute.\n\n### **CSS Properties:**\n - **--zn-range-track-height** - The height of a range input's track. _(default: undefined)_\n- **--zn-range-track-color** - The color of a range input's track. _(default: undefined)_\n- **--zn-range-thumb-size** - The diameter of a range input's thumb. _(default: undefined)_\n- **--zn-range-thumb-color** - The color of a range input's thumb. _(default: undefined)_\n- **--zn-range-thumb-ring-width** - The width of the ring drawn around a range input's thumb. _(default: undefined)_\n\n### **CSS Parts:**\n - **form-control** - The form control that wraps the label, input, and help text.\n- **form-control-label** - The label's wrapper.\n- **form-control-input** - The input's wrapper.\n- **form-control-help-text** - The help text's wrapper.\n- **base** - The component's base wrapper.\n- **input** - The internal `<input>` control.\n- **prefix** - The container that wraps the prefix.\n- **clear-button** - The clear button.\n- **password-toggle-button** - The password toggle button.\n- **suffix** - The container that wraps the suffix.",
           "doc-url": "",
           "attributes": [
             {
@@ -4713,7 +4741,7 @@
               "name": "type",
               "description": "The type of input. Works the same as native `<input>` element. But only a subset of types is supported. Defaults\nto `text`",
               "value": {
-                "type": "'color' | 'currency' | 'date' | 'datetime-local' | 'email' | 'number' | 'password' |\n    'search' | 'tel' | 'text' | 'time' | 'url'",
+                "type": "'color' | 'currency' | 'date' | 'datetime-local' | 'email' | 'number' | 'password' |\n    'range' | 'search' | 'tel' | 'text' | 'time' | 'url'",
                 "default": "'text'"
               }
             },
@@ -4813,6 +4841,11 @@
                 "default": "'hex'"
               }
             },
+            {
+              "name": "value-suffix",
+              "description": "Appended to the value that range inputs display above the track, on the right, e.g. `rem`. Only applies when type\nis 'range' and no `context-note` is set.",
+              "value": { "type": "string", "default": "''" }
+            },
             {
               "name": "form",
               "description": "By default, form-controls are associated with the nearest containing `<form>` element. This attribute allows you\nto place the form control outside a form and associate it with the form that has this `id`. The form must be\nin the same document or shadow root for this to work.",
@@ -4911,7 +4944,7 @@
             },
             {
               "name": "context-note",
-              "description": "Used to add contextual text that is displayed above the input, on the right. Alternatively, you can use the `context-note` attribute."
+              "description": "Used to add contextual text that is displayed above the input, on the right. Alternatively, you can use the `context-note` attribute. Range inputs display their live value here unless this is set."
             },
             {
               "name": "prefix",
@@ -4972,7 +5005,7 @@
               {
                 "name": "type",
                 "description": "The type of input. Works the same as native `<input>` element. But only a subset of types is supported. Defaults\nto `text`",
-                "type": "'color' | 'currency' | 'date' | 'datetime-local' | 'email' | 'number' | 'password' |\n    'search' | 'tel' | 'text' | 'time' | 'url'"
+                "type": "'color' | 'currency' | 'date' | 'datetime-local' | 'email' | 'number' | 'password' |\n    'range' | 'search' | 'tel' | 'text' | 'time' | 'url'"
               },
               {
                 "name": "name",
@@ -5069,6 +5102,11 @@
                 "description": "The color format to display for color inputs. Only applies when type is 'color'. *",
                 "type": "'hex' | 'rgb' | 'hsl' | 'oklch'"
               },
+              {
+                "name": "valueSuffix",
+                "description": "Appended to the value that range inputs display above the track, on the right, e.g. `rem`. Only applies when type\nis 'range' and no `context-note` is set.",
+                "type": "string"
+              },
               {
                 "name": "form",
                 "description": "By default, form-controls are associated with the nearest containing `<form>` element. This attribute allows you\nto place the form control outside a form and associate it with the form that has this `id`. The form must be\nin the same document or shadow root for this to work.",
@@ -9765,7 +9803,7 @@
         },
         {
           "name": "zn-theme-editor",
-          "description": "A theme editor: slotted form controls drive a live preview frame,\nwith a toolbar for the preview's light/dark mode and device width.\n---\n\n\n### **Events:**\n - **zn-theme-change** - Emitted when the values, mode or device change.\n- **zn-theme-submit** - Emitted on submit (button click), carrying the current values. With `action` set, only fires after a successful save.\n- **zn-error** - Emitted when a save fails. Also seen for preview render failures: the frame's zn-error is composed and not stopped, so it bubbles out through the editor too.\n\n### **Slots:**\n - _default_ - Ungrouped theme controls, rendered above any sections. Controls assigned `slot=\"<name>\"` matching a `sections` entry (or, when nested, a `groups` entry) render inside that section/group instead. Harvesting and change detection walk every slot's full assigned subtree, not just direct children.\n- **toolbar** - Actions in the toolbar, right-aligned beside the device controls. Where a save button belongs.\n- **footer** - Actions pinned beneath the controls. The built-in submit button lives in the toolbar, not here.\n\n### **CSS Properties:**\n - **--zn-theme-editor-controls-width** - Width of the controls column. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **controls** - The left-hand controls column, full height.\n- **controls-header** - The controls column's header row: `controls-caption` on the left, the light/dark mode toggle on the right.\n- **toolbar** - The preview column's header row: `preview-caption` on the left, the device switcher (and sources/submit) on the right. Spans the preview column only.\n- **section** - A rendered section's or group's collapsible (`section-layout=\"collapsible\"`, or any nested group).\n- **footer** - The footer wrapper beneath the controls.\n- **preview** - The preview column.\n- **error** - The inline error strip.\n- **preview__base** - The frame's base wrapper (forwarded from zn-preview-frame).\n- **preview__stage** - The frame's device-width wrapper (forwarded from zn-preview-frame).\n- **preview__iframe** - The frame's iframe (forwarded from zn-preview-frame).\n- **preview__error** - The frame's own error overlay (forwarded from zn-preview-frame).",
+          "description": "A theme editor: slotted form controls drive a live preview frame,\nwith a toolbar for the preview's light/dark mode and device width.\n---\n\n\n### **Events:**\n - **zn-theme-change** - Emitted when the values, mode or device change.\n- **zn-theme-submit** - Emitted on submit (button click), carrying the current values. With `action` set, only fires after a successful save.\n- **zn-error** - Emitted when a save fails. Also seen for preview render failures: the frame's zn-error is composed and not stopped, so it bubbles out through the editor too.\n\n### **Slots:**\n - _default_ - Ungrouped theme controls, rendered above any sections. Controls assigned `slot=\"<name>\"` matching a `sections` entry (or, when nested, a `groups` entry) render inside that section/group instead. Harvesting and change detection walk every slot's full assigned subtree, not just direct children. With `sections` left unset, the structure is instead derived from the controls' own attributes: `group=\"<label>\"` becomes a tab and `category=\"<label>\"` a collapsible within it, and the control is slotted into that collapsible automatically. Either attribute works alone - a control with only `group` sits directly in its tab, and one with only `category` becomes its own top-level section. Setting `sections` explicitly disables the derivation entirely.\n- **toolbar** - Actions in the toolbar, right-aligned beside the device controls. Where a save button belongs.\n- **footer** - Actions pinned beneath the controls. The built-in submit button lives in the toolbar, not here.\n\n### **CSS Properties:**\n - **--zn-theme-editor-controls-width** - Width of the controls column. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **controls** - The left-hand controls column, full height.\n- **controls-header** - The controls column's header row: `controls-caption` on the left, the light/dark mode toggle on the right.\n- **toolbar** - The preview column's header row: `preview-caption` on the left, the device switcher (and sources/submit) on the right. Spans the preview column only.\n- **section** - A rendered section's or group's collapsible (`section-layout=\"collapsible\"`, or any nested group).\n- **footer** - The footer wrapper beneath the controls.\n- **preview** - The preview column.\n- **error** - The inline error strip.\n- **preview__base** - The frame's base wrapper (forwarded from zn-preview-frame).\n- **preview__stage** - The frame's device-width wrapper (forwarded from zn-preview-frame).\n- **preview__iframe** - The frame's iframe (forwarded from zn-preview-frame).\n- **preview__error** - The frame's own error overlay (forwarded from zn-preview-frame).",
           "doc-url": "",
           "attributes": [
             {
@@ -9815,7 +9853,7 @@
             },
             {
               "name": "sections",
-              "description": "Groups controls into named sections. Empty/unset renders one ungrouped\ncolumn. A section with a non-empty `groups` nests a collapsible per\ngroup inside a `zn-tabs` tab for that section - see `groups` on\n`ThemeEditorSection`.",
+              "description": "Groups controls into named sections. Empty/unset falls back to deriving the\nstructure from the controls' own `group`/`category` attributes, and renders\none ungrouped column when they carry neither. A section with a non-empty\n`groups` nests a collapsible per group inside a `zn-tabs` tab for that\nsection - see `groups` on `ThemeEditorSection`.",
               "value": { "type": "ThemeEditorSection[]", "default": "[]" }
             },
             {
@@ -9865,7 +9903,7 @@
           "slots": [
             {
               "name": "",
-              "description": "Ungrouped theme controls, rendered above any sections. Controls assigned `slot=\"<name>\"` matching a `sections` entry (or, when nested, a `groups` entry) render inside that section/group instead. Harvesting and change detection walk every slot's full assigned subtree, not just direct children."
+              "description": "Ungrouped theme controls, rendered above any sections. Controls assigned `slot=\"<name>\"` matching a `sections` entry (or, when nested, a `groups` entry) render inside that section/group instead. Harvesting and change detection walk every slot's full assigned subtree, not just direct children. With `sections` left unset, the structure is instead derived from the controls' own attributes: `group=\"<label>\"` becomes a tab and `category=\"<label>\"` a collapsible within it, and the control is slotted into that collapsible automatically. Either attribute works alone - a control with only `group` sits directly in its tab, and one with only `category` becomes its own top-level section. Setting `sections` explicitly disables the derivation entirely."
             },
             {
               "name": "toolbar",
@@ -9939,7 +9977,7 @@
               },
               {
                 "name": "sections",
-                "description": "Groups controls into named sections. Empty/unset renders one ungrouped\ncolumn. A section with a non-empty `groups` nests a collapsible per\ngroup inside a `zn-tabs` tab for that section - see `groups` on\n`ThemeEditorSection`.",
+                "description": "Groups controls into named sections. Empty/unset falls back to deriving the\nstructure from the controls' own `group`/`category` attributes, and renders\none ungrouped column when they carry neither. A section with a non-empty\n`groups` nests a collapsible per group inside a `zn-tabs` tab for that\nsection - see `groups` on `ThemeEditorSection`.",
                 "type": "ThemeEditorSection[]"
               },
               {

package/dist/zn.d.ts

@@ -1880,7 +1880,7 @@ declare module "components/input/input.component" {
      *
      * @slot label - The input's label. Alternatively, you can use the `label` attribute.
      * @slot label-tooltip - Used to add text that is displayed in a tooltip next to the label. Alternatively, you can use the `label-tooltip` attribute.
-     * @slot context-note - Used to add contextual text that is displayed above the input, on the right. Alternatively, you can use the `context-note` attribute.
+     * @slot context-note - Used to add contextual text that is displayed above the input, on the right. Alternatively, you can use the `context-note` attribute. Range inputs display their live value here unless this is set.
      * @slot prefix - Used to prepend a presentational icon or similar element to the input.
      * @slot suffix - Used to append a presentational icon or similar element to the input.
      * @slot clear-icon - An icon to use in lieu of the default clear icon.
@@ -1898,6 +1898,12 @@ declare module "components/input/input.component" {
      * @csspart clear-button - The clear button.
      * @csspart password-toggle-button - The password toggle button.
      * @csspart suffix - The container that wraps the suffix.
+     *
+     * @cssproperty --zn-range-track-height - The height of a range input's track.
+     * @cssproperty --zn-range-track-color - The color of a range input's track.
+     * @cssproperty --zn-range-thumb-size - The diameter of a range input's thumb.
+     * @cssproperty --zn-range-thumb-color - The color of a range input's thumb.
+     * @cssproperty --zn-range-thumb-ring-width - The width of the ring drawn around a range input's thumb.
      */
     export default class ZnInput extends ZincElement implements ZincFormControl {
         static styles: import("lit").CSSResult;
@@ -1919,7 +1925,7 @@ declare module "components/input/input.component" {
          * The type of input. Works the same as native `<input>` element. But only a subset of types is supported. Defaults
          * to `text`
          */
-        type: 'color' | 'currency' | 'date' | 'datetime-local' | 'email' | 'number' | 'password' | 'search' | 'tel' | 'text' | 'time' | 'url';
+        type: 'color' | 'currency' | 'date' | 'datetime-local' | 'email' | 'number' | 'password' | 'range' | 'search' | 'tel' | 'text' | 'time' | 'url';
         /** The name of the input, submitted as a name/value pair with form data. */
         name: string;
         /** The current value of the input, submitted as a name/value pair with form data. */
@@ -1965,6 +1971,11 @@ declare module "components/input/input.component" {
         noSpinButtons: boolean;
         /** The color format to display for color inputs. Only applies when type is 'color'. **/
         colorFormat: 'hex' | 'rgb' | 'hsl' | 'oklch';
+        /**
+         * Appended to the value that range inputs display above the track, on the right, e.g. `rem`. Only applies when type
+         * is 'range' and no `context-note` is set.
+         */
+        valueSuffix: string;
         /**
          * By default, form-controls are associated with the nearest containing `<form>` element. This attribute allows you
          * to place the form control outside a form and associate it with the form that has this `id`. The form must be
@@ -2046,6 +2057,7 @@ declare module "components/input/input.component" {
         private handleColorSwatchClick;
         private handleColorPickerChange;
         private focusInput;
+        protected firstUpdated(): void;
         handleDisabledChange(): void;
         handleStepChange(): void;
         handleValueChange(): Promise<void>;
@@ -4697,6 +4709,9 @@ declare module "components/icon-picker/icon-picker.component" {
         helpText: string;
         disabled: boolean;
         required: boolean;
+        triggerSubmit: boolean;
+        allowUpload: boolean;
+        accept: string;
         form: string;
         defaultValue: string;
         private _dialogOpen;
@@ -4706,9 +4721,19 @@ declare module "components/icon-picker/icon-picker.component" {
         private _pendingIcon;
         private _pendingLibrary;
         private _pendingColor;
+        private _pendingFile;
+        private _pendingFileUrl;
+        private _mode;
+        private _file;
+        private _fileUrl;
         private _dialog;
+        private _fileInput;
         get value(): string;
         set value(val: string);
+        /** The chosen file when the user uploaded an image instead of picking an icon. */
+        get file(): File | null;
+        /** True when the current value renders as an image (an uploaded file or a URL) rather than a library icon. */
+        get isImageValue(): boolean;
         get validity(): ValidityState;
         get validationMessage(): string;
         checkValidity(): boolean;
@@ -4722,6 +4747,10 @@ declare module "components/icon-picker/icon-picker.component" {
         private closeDialog;
         private handleConfirm;
         private handleCancel;
+        private handleFileSelect;
+        private discardPendingFile;
+        private clearFile;
+        disconnectedCallback(): void;
         private handleSearchInput;
         private filterIcons;
         private handleIconSelect;
@@ -7267,6 +7296,12 @@ declare module "components/file/file.component" {
         private handleClearClick;
         /** Clear the current value after the user confirms. */
         private confirmClear;
+        /**
+         * Programmatically clears the selected file and any external `src` without
+         * confirmation. Unlike a user-initiated clear, this does not flag the control
+         * to submit an empty value.
+         */
+        clear(): void;
         private updatePreview;
         /**
          * Returns the URL currently shown in the droparea — the locally-selected file's object URL
@@ -10524,7 +10559,7 @@ declare module "events/zn-error" {
     }
 }
 declare module "components/theme-editor/theme-editor.component" {
-    import { type CSSResultGroup } from 'lit';
+    import { type CSSResultGroup, type PropertyValues } from 'lit';
     import ZincElement from "internal/zinc-element";
     import ZnButton from "components/button/index";
     import ZnCollapsible from "components/collapsible/index";
@@ -10583,6 +10618,14 @@ declare module "components/theme-editor/theme-editor.component" {
      * `groups` entry) render inside that section/group instead. Harvesting and
      * change detection walk every slot's full assigned subtree, not just direct
      * children.
+     *
+     * With `sections` left unset, the structure is instead derived from the
+     * controls' own attributes: `group="<label>"` becomes a tab and
+     * `category="<label>"` a collapsible within it, and the control is slotted
+     * into that collapsible automatically. Either attribute works alone - a
+     * control with only `group` sits directly in its tab, and one with only
+     * `category` becomes its own top-level section. Setting `sections`
+     * explicitly disables the derivation entirely.
      * @slot toolbar - Actions in the toolbar, right-aligned beside the device
      * controls. Where a save button belongs.
      * @slot footer - Actions pinned beneath the controls. The built-in submit button
@@ -10634,10 +10677,11 @@ declare module "components/theme-editor/theme-editor.component" {
         /** Debounce in ms between a control change and the save POST. */
         saveDebounce: number;
         /**
-         * Groups controls into named sections. Empty/unset renders one ungrouped
-         * column. A section with a non-empty `groups` nests a collapsible per
-         * group inside a `zn-tabs` tab for that section - see `groups` on
-         * `ThemeEditorSection`.
+         * Groups controls into named sections. Empty/unset falls back to deriving the
+         * structure from the controls' own `group`/`category` attributes, and renders
+         * one ungrouped column when they carry neither. A section with a non-empty
+         * `groups` nests a collapsible per group inside a `zn-tabs` tab for that
+         * section - see `groups` on `ThemeEditorSection`.
          */
         sections: ThemeEditorSection[];
         /**
@@ -10680,6 +10724,7 @@ declare module "components/theme-editor/theme-editor.component" {
         private readonly _controlsObserver;
         private _modeValues;
         private _suppressDepth;
+        private _openedInitialCollapsible;
         /** The current per-mode value sets. Returns copies. */
         get values(): {
             light: Record<string, unknown>;
@@ -10732,6 +10777,23 @@ declare module "components/theme-editor/theme-editor.component" {
         private readonly _onSourceChange;
         private _sectionsSafe;
         private _groupsFor;
+        /** Whether any direct child carries the `group`/`category` structure attributes. */
+        private _hasStructureAttributes;
+        /** Attribute-derived structure applies only when `sections` is left unset. */
+        private _usesDerivedSections;
+        /**
+         * Builds the tab/collapsible tree from the controls' own `group` (tab) and
+         * `category` (collapsible) attributes, alongside the slot name each control
+         * needs assigning to. Only direct children are considered, since `slot` only
+         * works one level deep. Slot names are slugged from the labels and made
+         * unique across the whole tree, so two tabs can each hold a "Colors"
+         * category without their slots colliding.
+         */
+        private _derive;
+        /** Explicit `sections` when set, otherwise the attribute-derived tree. */
+        private _effectiveSections;
+        private _assignDerivedSlots;
+        protected willUpdate(changed: PropertyValues): void;
         /** Whether any section has a populated `groups` - the switch to nested tabs+collapsibles. */
         private _hasNestedGroups;
         private _visibleGroups;
@@ -10739,6 +10801,12 @@ declare module "components/theme-editor/theme-editor.component" {
         private _visibleSections;
         private _renderSections;
         private _renderGroups;
+        /** Every collapsible inside a tab's panel, in document order. */
+        private _tabCollapsibles;
+        /** Expands the first collapsible, unless one is already open. */
+        private _expandFirst;
+        private _openFirstCollapsible;
+        protected updated(changed: PropertyValues): void;
         private _renderTabs;
         render(): import("lit-html").TemplateResult<1>;
     }