@public-ui/components 4.1.2-rc.1 → 4.1.2-rc.3

package/doc/input-date.md

@@ -3,6 +3,10 @@
 <!-- Auto Generated Below -->
 
 
+## Overview
+
+The **Date** input type creates an input field for date values. These can be specific dates as well as weeks, months, or time values.
+
 ## Properties
 
 | Property              | Attribute        | Description                                                                                                                                                  | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | Default     |
@@ -67,9 +71,9 @@ Type: `Promise<void>`
 
 ## Slots
 
-| Slot | Description                         |
-| ---- | ----------------------------------- |
-|      | Die Beschriftung des Eingabefeldes. |
+| Slot | Description                   |
+| ---- | ----------------------------- |
+|      | The label of the input field. |
 
 
 ----------------------------------------------

package/doc/input-email.md

@@ -3,6 +3,10 @@
 <!-- Auto Generated Below -->
 
 
+## Overview
+
+The **Email** input type creates an input field for email addresses. It supports built-in format validation, multiple addresses via the `_multiple` property, and auto-complete suggestions.
+
 ## Properties
 
 | Property              | Attribute              | Description                                                                                                                                                  | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | Default     |
@@ -59,9 +63,9 @@ Type: `Promise<string | undefined>`
 
 ## Slots
 
-| Slot | Description                         |
-| ---- | ----------------------------------- |
-|      | Die Beschriftung des Eingabefeldes. |
+| Slot | Description                   |
+| ---- | ----------------------------- |
+|      | The label of the input field. |
 
 
 ----------------------------------------------

package/doc/input-file.md

@@ -3,6 +3,10 @@
 <!-- Auto Generated Below -->
 
 
+## Overview
+
+The **File** input type creates an input field for file uploads. One or multiple files can be selected and submitted with a form.
+
 ## Properties
 
 | Property              | Attribute        | Description                                                                                                                                                  | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | Default     |
@@ -61,9 +65,9 @@ Type: `Promise<void>`
 
 ## Slots
 
-| Slot | Description                         |
-| ---- | ----------------------------------- |
-|      | Die Beschriftung des Eingabefeldes. |
+| Slot | Description                   |
+| ---- | ----------------------------- |
+|      | The label of the input field. |
 
 
 ----------------------------------------------

package/doc/input-number.md

@@ -3,6 +3,10 @@
 <!-- Auto Generated Below -->
 
 
+## Overview
+
+The **Number** input type creates an input field for numeric values. Use the `_min`, `_max`, and `_step` properties to restrict the accepted value range.
+
 ## Properties
 
 | Property              | Attribute        | Description                                                                                                                                                  | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | Default     |
@@ -57,9 +61,9 @@ Type: `Promise<number | NumberString | null>`
 
 ## Slots
 
-| Slot | Description                         |
-| ---- | ----------------------------------- |
-|      | Die Beschriftung des Eingabefeldes. |
+| Slot | Description                   |
+| ---- | ----------------------------- |
+|      | The label of the input field. |
 
 
 ----------------------------------------------

package/doc/input-password.md

@@ -3,6 +3,10 @@
 <!-- Auto Generated Below -->
 
 
+## Overview
+
+The **Password** input type creates an input field for passwords. The input is masked with dot symbols.
+
 ## Properties
 
 | Property              | Attribute              | Description                                                                                                                                                  | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | Default     |
@@ -58,9 +62,9 @@ Type: `Promise<string | undefined>`
 
 ## Slots
 
-| Slot | Description                         |
-| ---- | ----------------------------------- |
-|      | Die Beschriftung des Eingabefeldes. |
+| Slot | Description                   |
+| ---- | ----------------------------- |
+|      | The label of the input field. |
 
 
 ----------------------------------------------

package/doc/input-radio.md

@@ -3,6 +3,10 @@
 <!-- Auto Generated Below -->
 
 
+## Overview
+
+The **InputRadio** input type consists of a collection of radio elements, providing a choice between different values. Only a single value can be selected at a time. Selected radio elements are typically represented by a filled, visually highlighted circle.
+
 ## Properties
 
 | Property              | Attribute        | Description                                                                                                                                                  | Type                                                                                                                               | Default      |
@@ -48,9 +52,9 @@ Type: `Promise<StencilUnknown>`
 
 ## Slots
 
-| Slot | Description                               |
-| ---- | ----------------------------------------- |
-|      | Die Legende/Überschrift der Radiobuttons. |
+| Slot | Description                              |
+| ---- | ---------------------------------------- |
+|      | The legend/heading of the radio buttons. |
 
 
 ----------------------------------------------

package/doc/input-range.md

@@ -3,6 +3,10 @@
 <!-- Auto Generated Below -->
 
 
+## Overview
+
+The **Range** input type creates a slider control for selecting a numeric value within a defined range. Use the `_min`, `_max`, and `_step` properties to configure the range and step size.
+
 ## Properties
 
 | Property              | Attribute        | Description                                                                                                                                                  | Type                                                                                                                               | Default     |
@@ -53,9 +57,9 @@ Type: `Promise<number | NumberString | undefined>`
 
 ## Slots
 
-| Slot | Description                           |
-| ---- | ------------------------------------- |
-|      | Die Beschriftung des Eingabeelements. |
+| Slot | Description                   |
+| ---- | ----------------------------- |
+|      | The label of the input field. |
 
 
 ----------------------------------------------

package/doc/input-text.md

@@ -3,6 +3,10 @@
 <!-- Auto Generated Below -->
 
 
+## Overview
+
+The **Text** input type creates an input field for plain text, search terms, URLs, or phone numbers.
+
 ## Properties
 
 | Property              | Attribute              | Description                                                                                                                                                  | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | Default     |
@@ -133,9 +137,9 @@ Type: `Promise<void>`
 
 ## Slots
 
-| Slot | Description                         |
-| ---- | ----------------------------------- |
-|      | Die Beschriftung des Eingabefeldes. |
+| Slot | Description                   |
+| ---- | ----------------------------- |
+|      | The label of the input field. |
 
 
 ----------------------------------------------

package/doc/link-button.md

@@ -3,6 +3,10 @@
 <!-- Auto Generated Below -->
 
 
+## Overview
+
+The **LinkButton** component is semantically a link but has the appearance of a button. All relevant properties of the Link component are adopted and extended with the design-defining properties of a button.
+
 ## Properties
 
 | Property             | Attribute             | Description                                                                                                                                                                                                                              | Type                                                                                                 | Default     |
@@ -39,6 +43,13 @@ Type: `Promise<void | undefined>`
 
 
 
+## Slots
+
+| Slot       | Description                                        |
+| ---------- | -------------------------------------------------- |
+| `"expert"` | Custom label content, e.g. for rich text or icons. |
+
+
 ----------------------------------------------
 
 

package/doc/modal.md

@@ -5,6 +5,10 @@
 
 > **[DEPRECATED]** Use `kol-dialog` instead.
 
+## Overview
+
+The **Modal** component has been superseded by `kol-dialog`, which provides improved accessibility and conforms to the HTML dialog specification. It is still available in version 2 for backwards compatibility.
+
 ## Properties
 
 | Property              | Attribute  | Description                                                                                                        | Type                                                      | Default     |

package/doc/nav.md

@@ -3,6 +3,11 @@
 <!-- Auto Generated Below -->
 
 
+## Overview
+
+The **Nav** component renders a group of related links or navigation elements that perform an action or display content when clicked.
+It provides a highly configurable vertical or horizontal navigation bar that can represent multiple levels and vary in width.
+
 ## Properties
 
 | Property                | Attribute                  | Description                                                                                                                                | Type                                              | Default     |

package/doc/pagination.md

@@ -1,4 +1,4 @@
-# kol-pagination-wc
+# kol-pagination
 
 <!-- Auto Generated Below -->
 

package/doc/popover-button.md

@@ -1,8 +1,13 @@
-# kol-popover-button-wc
+# kol-popover-button
 
 <!-- Auto Generated Below -->
 
 
+## Overview
+
+A button that toggles the visibility of a popover overlay containing arbitrary content.
+The popover uses the native HTML Popover API for lightweight, non-modal overlays.
+
 ## Properties
 
 | Property              | Attribute           | Description                                                                                                                                                  | Type                                                                                                 | Default     |
@@ -27,19 +32,19 @@
 
 ## Methods
 
-### `focus() => Promise<void | undefined>`
+### `focus() => Promise<any>`
 
 Sets focus on the internal element.
 
 #### Returns
 
-Type: `Promise<void | undefined>`
+Type: `Promise<any>`
 
 
 
 ### `hidePopover() => Promise<void>`
 
-Hides the popover programmatically by calling the native hidePopover method.
+Hides the popover programmatically by forwarding the call to the web component.
 
 #### Returns
 
@@ -49,7 +54,7 @@ Type: `Promise<void>`
 
 ### `showPopover() => Promise<void>`
 
-Show the popover programmatically by calling the native showPopover method.
+Shows the popover programmatically by forwarding the call to the web component.
 
 #### Returns
 
@@ -60,9 +65,10 @@ Type: `Promise<void>`
 
 ## Slots
 
-| Slot | Description          |
-| ---- | -------------------- |
-|      | The popover content. |
+| Slot       | Description                                                     |
+| ---------- | --------------------------------------------------------------- |
+|            | The popover content (displayed when the button is clicked).     |
+| `"expert"` | Custom label content for the button (when `_label` is `false`). |
 
 
 ----------------------------------------------

package/doc/progress.md

@@ -3,6 +3,10 @@
 <!-- Auto Generated Below -->
 
 
+## Overview
+
+The **Progress** component visualizes the completion status of a task or process. It supports both determinate (percentage-based) and indeterminate variants.
+
 ## Properties
 
 | Property              | Attribute  | Description                                                                                                        | Type                            | Default     |

package/doc/quote.md

@@ -3,6 +3,10 @@
 <!-- Auto Generated Below -->
 
 
+## Overview
+
+The **Quote** component has two variants: a short inline (`inline`) and an indented block (`block`) variant. Both variants include a link to the source of the quote.
+
 ## Properties
 
 | Property              | Attribute  | Description                                                                                                        | Type                               | Default     |

package/doc/select.md

@@ -1,4 +1,4 @@
-# kol-select-wc
+# kol-select
 
 <!-- Auto Generated Below -->
 
@@ -7,7 +7,7 @@
 
 | Property                | Attribute        | Description                                                                                                                                                  | Type                                                                                                                               | Default     |
 | ----------------------- | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------- | ----------- |
-| `_accessKey`            | `_access-key`    | Defines the key combination that can be used to trigger or focus the component’s interactive element.                                                        | `string \| undefined`                                                                                                              | `undefined` |
+| `_accessKey`            | `_access-key`    | Defines the key combination that can be used to trigger or focus the component's interactive element.                                                        | `string \| undefined`                                                                                                              | `undefined` |
 | `_disabled`             | `_disabled`      | Makes the element not focusable and ignore all events.                                                                                                       | `boolean \| undefined`                                                                                                             | `false`     |
 | `_hideLabel`            | `_hide-label`    | Hides the caption by default and displays the caption text with a tooltip when the interactive element is focused or the mouse is over it.                   | `boolean \| undefined`                                                                                                             | `false`     |
 | `_hideMsg`              | `_hide-msg`      | Hides the error message but leaves it in the DOM for the input's aria-describedby.                                                                           | `boolean \| undefined`                                                                                                             | `false`     |
@@ -18,31 +18,31 @@
 | `_multiple`             | `_multiple`      | Makes the input accept multiple inputs.                                                                                                                      | `boolean \| undefined`                                                                                                             | `false`     |
 | `_name`                 | `_name`          | Defines the technical name of an input field.                                                                                                                | `string \| undefined`                                                                                                              | `undefined` |
 | `_on`                   | --               | Gibt die EventCallback-Funktionen für das Input-Event an.                                                                                                    | `InputTypeOnBlur & InputTypeOnClick & InputTypeOnChange & InputTypeOnFocus & InputTypeOnInput & InputTypeOnKeyDown \| undefined`   | `undefined` |
-| `_options` _(required)_ | `_options`       | Options the user can choose from, also supporting Optgroup.                                                                                                  | `(Option<StencilUnknown> \| Optgroup<StencilUnknown>)[] \| string`                                                                 | `undefined` |
+| `_options` _(required)_ | `_options`       | Options the user can choose from.                                                                                                                            | `(Option<StencilUnknown> \| Optgroup<StencilUnknown>)[] \| string`                                                                 | `undefined` |
 | `_required`             | `_required`      | Makes the input element required.                                                                                                                            | `boolean \| undefined`                                                                                                             | `false`     |
-| `_rows`                 | `_rows`          | Defines how many rows of options should be visible at the same time.                                                                                         | `number \| undefined`                                                                                                              | `undefined` |
+| `_rows`                 | `_rows`          | Maximum number of visible rows of the element.                                                                                                               | `number \| undefined`                                                                                                              | `undefined` |
 | `_shortKey`             | `_short-key`     | Adds a visual shortcut hint after the label and instructs the screen reader to read the shortcut aloud.                                                      | `string \| undefined`                                                                                                              | `undefined` |
 | `_tabIndex`             | `_tab-index`     | Defines which tab-index the primary element of the component has. (https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/tabindex)             | `number \| undefined`                                                                                                              | `undefined` |
 | `_tooltipAlign`         | `_tooltip-align` | Defines where to show the Tooltip preferably: top, right, bottom or left.                                                                                    | `"bottom" \| "left" \| "right" \| "top" \| undefined`                                                                              | `'top'`     |
 | `_touched`              | `_touched`       | Shows if the input was touched by a user.                                                                                                                    | `boolean \| undefined`                                                                                                             | `false`     |
-| `_value`                | `_value`         | Defines the value of the input.                                                                                                                              | `StencilUnknown[] \| boolean \| null \| number \| object \| string \| undefined`                                                   | `undefined` |
+| `_value`                | `_value`         | Defines the value of the element.                                                                                                                            | `StencilUnknown[] \| boolean \| null \| number \| object \| string \| undefined`                                                   | `undefined` |
 
 
 ## Methods
 
-### `focus() => Promise<void>`
+### `focus() => Promise<void | undefined>`
 
 Sets focus on the internal element.
 
 #### Returns
 
-Type: `Promise<void>`
+Type: `Promise<void | undefined>`
 
 
 
 ### `getValue() => Promise<StencilUnknown[] | StencilUnknown>`
 
-Returns the current value.
+Returns the selected values.
 
 #### Returns
 
@@ -53,9 +53,9 @@ Type: `Promise<StencilUnknown | StencilUnknown[]>`
 
 ## Slots
 
-| Slot | Description                         |
-| ---- | ----------------------------------- |
-|      | Die Beschriftung des Eingabefeldes. |
+| Slot | Description                   |
+| ---- | ----------------------------- |
+|      | The label of the input field. |
 
 
 ----------------------------------------------

package/doc/single-select.md

@@ -3,6 +3,10 @@
 <!-- Auto Generated Below -->
 
 
+## Overview
+
+The **SingleSelect** component creates a dropdown list from which exactly one predefined option can be selected.
+
 ## Properties
 
 | Property                | Attribute           | Description                                                                                                                                                  | Type                                                                                                                               | Default     |
@@ -53,9 +57,9 @@ Type: `Promise<StencilUnknown>`
 
 ## Slots
 
-| Slot | Description            |
-| ---- | ---------------------- |
-|      | The input field label. |
+| Slot | Description                   |
+| ---- | ----------------------------- |
+|      | The label of the input field. |
 
 
 ----------------------------------------------

package/doc/skip-nav.md

@@ -3,6 +3,10 @@
 <!-- Auto Generated Below -->
 
 
+## Overview
+
+The **SkipNav** component renders a hidden navigation that allows keyboard and assistive technology users to skip repetitive navigation sections and jump directly to the main content. It only becomes visible when reached via the Tab key.
+
 ## Properties
 
 | Property              | Attribute | Description                                                                                                        | Type                    | Default     |

package/doc/spin.md

@@ -3,6 +3,10 @@
 <!-- Auto Generated Below -->
 
 
+## Overview
+
+The **Spin** component informs users about loading or processing operations being performed by the system. Progress can be communicated through a repeated animation.
+
 ## Properties
 
 | Property   | Attribute  | Description                                                                                                        | Type                                      | Default     |
@@ -12,6 +16,13 @@
 | `_variant` | `_variant` | Defines which variant should be used for presentation.                                                             | `"cycle" \| "dot" \| "none" \| undefined` | `'dot'`     |
 
 
+## Slots
+
+| Slot       | Description                                                 |
+| ---------- | ----------------------------------------------------------- |
+| `"expert"` | Custom content displayed when the variant is set to `none`. |
+
+
 ----------------------------------------------
 
 

package/doc/split-button.md

@@ -3,6 +3,11 @@
 <!-- Auto Generated Below -->
 
 
+## Overview
+
+The **SplitButton** component can be used to display a two-part button. The primary button is typically used for
+a main action, while the secondary button opens a context menu (`Popover`) that contains additional actions.
+
 ## Properties
 
 | Property              | Attribute           | Description                                                                                                                                                                                                                              | Type                                                                                                                                                   | Default     |
@@ -62,9 +67,9 @@ Type: `Promise<StencilUnknown>`
 
 ## Slots
 
-| Slot | Description                                               |
-| ---- | --------------------------------------------------------- |
-|      | Ermöglicht das Einfügen beliebigen HTMLs in das dropdown. |
+| Slot | Description                                             |
+| ---- | ------------------------------------------------------- |
+|      | Allows arbitrary HTML to be inserted into the dropdown. |
 
 
 ----------------------------------------------

package/doc/table-stateful.md

@@ -3,6 +3,10 @@
 <!-- Auto Generated Below -->
 
 
+## Overview
+
+The **Table** component is primarily used for the clear presentation of data sets. It is designed to automatically determine all data-dependent values and render the table accordingly. This includes optional features such as column sorting and pagination.
+
 ## Properties
 
 | Property                | Attribute              | Description                                                                                                        | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | Default     |

package/doc/tabs.md

@@ -3,6 +3,10 @@
 <!-- Auto Generated Below -->
 
 
+## Overview
+
+The **Tabs** component is used to organize related content on the same page and navigate between them. Tabs ensure that large amounts of content can be more easily organized for users.
+
 ## Properties
 
 | Property              | Attribute            | Description                                                                                                        | Type                                                                                                                                                                                               | Default     |

package/doc/textarea.md

@@ -3,6 +3,10 @@
 <!-- Auto Generated Below -->
 
 
+## Overview
+
+The **Textarea** component provides a larger input field for content. Unlike InputText, it also allows extensive content to be entered, including line breaks.
+
 ## Properties
 
 | Property              | Attribute              | Description                                                                                                                                                                                                                                                                                        | Type                                                                                                                               | Default      |
@@ -58,9 +62,9 @@ Type: `Promise<string | undefined>`
 
 ## Slots
 
-| Slot | Description                         |
-| ---- | ----------------------------------- |
-|      | Die Beschriftung des Eingabefeldes. |
+| Slot | Description                   |
+| ---- | ----------------------------- |
+|      | The label of the input field. |
 
 
 ----------------------------------------------

package/doc/tree-item.md

@@ -1,4 +1,4 @@
-# kol-tree-item-wc
+# kol-tree-item
 
 <!-- Auto Generated Below -->
 
@@ -15,33 +15,33 @@
 
 ## Methods
 
-### `collapse() => Promise<void>`
+### `collapse() => Promise<void | undefined>`
 
 Collapses the tree item.
 
 #### Returns
 
-Type: `Promise<void>`
+Type: `Promise<void | undefined>`
 
 
 
-### `expand() => Promise<void>`
+### `expand() => Promise<void | undefined>`
 
 Expands the tree item.
 
 #### Returns
 
-Type: `Promise<void>`
+Type: `Promise<void | undefined>`
 
 
 
-### `focus() => Promise<void | undefined>`
+### `focus() => Promise<any>`
 
 Focuses the link element.
 
 #### Returns
 
-Type: `Promise<void | undefined>`
+Type: `Promise<any>`
 
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@public-ui/components",
-  "version": "4.1.2-rc.1",
+  "version": "4.1.2-rc.3",
   "license": "EUPL-1.2",
   "homepage": "https://public-ui.github.io",
   "repository": {
@@ -99,8 +99,8 @@
     "@types/pug": "2.0.10",
     "@types/twig": "1.12.17",
     "@types/wcag-contrast": "3.0.3",
-    "@typescript-eslint/eslint-plugin": "8.57.0",
-    "@typescript-eslint/parser": "8.57.0",
+    "@typescript-eslint/eslint-plugin": "8.57.2",
+    "@typescript-eslint/parser": "8.57.2",
     "adopted-style-sheets": "1.1.9-rc.21",
     "autoprefixer": "10.4.27",
     "cross-env": "10.1.0",
@@ -108,19 +108,20 @@
     "eslint": "9.39.4",
     "eslint-plugin-jsx-a11y": "6.10.2",
     "jest": "26.6.3",
-    "knip": "5.86.0",
+    "knip": "5.88.1",
     "mustache": "4.2.0",
     "postcss": "8.5.8",
     "postcss-sorting": "9.1.0",
     "prettier": "3.8.1",
     "prettier-plugin-organize-imports": "4.3.0",
-    "pug": "3.0.3",
+    "pug": "3.0.4",
     "rimraf": "6.1.3",
     "stencil-awesome-test": "1.0.6",
-    "stylelint": "17.4.0",
-    "terser": "5.46.0",
+    "stylelint": "17.5.0",
+    "terser": "5.46.1",
     "twig": "1.17.1",
-    "typescript": "5.9.3"
+    "typescript": "5.9.3",
+    "@public-ui/stylelint-rules": "4.1.2-rc.1"
   },
   "peerDependencies": {
     "adopted-style-sheets": "1.1.9-rc.21"