@public-ui/components 2.0.13 → 2.0.15

package/dist/types/core/component-names.d.ts

@@ -6,11 +6,11 @@ export declare let KolAvatarTag: "kol-avatar";
 export declare let KolAvatarWcTag: "kol-avatar-wc";
 export declare let KolBadgeTag: "kol-badge";
 export declare let KolBreadcrumbTag: "kol-breadcrumb";
-export declare let KolButtonTag: "kol-button";
-export declare let KolButtonWcTag: "kol-button-wc";
 export declare let KolButtonGroupTag: "kol-button-group";
 export declare let KolButtonGroupWcTag: "kol-button-group-wc";
 export declare let KolButtonLinkTag: "kol-button-link";
+export declare let KolButtonTag: "kol-button";
+export declare let KolButtonWcTag: "kol-button-wc";
 export declare let KolCardTag: "kol-card";
 export declare let KolDetailsTag: "kol-details";
 export declare let KolFormTag: "kol-form";
@@ -19,7 +19,6 @@ export declare let KolHeadingWcTag: "kol-heading-wc";
 export declare let KolIconTag: "kol-icon";
 export declare let KolImageTag: "kol-image";
 export declare let KolIndentedTextTag: "kol-indented-text";
-export declare let KolInputTag: "kol-input";
 export declare let KolInputCheckboxTag: "kol-input-checkbox";
 export declare let KolInputColorTag: "kol-input-color";
 export declare let KolInputDateTag: "kol-input-date";
@@ -29,12 +28,13 @@ export declare let KolInputNumberTag: "kol-input-number";
 export declare let KolInputPasswordTag: "kol-input-password";
 export declare let KolInputRadioTag: "kol-input-radio";
 export declare let KolInputRangeTag: "kol-input-range";
+export declare let KolInputTag: "kol-input";
 export declare let KolInputTextTag: "kol-input-text";
 export declare let KolKolibriTag: "kol-kolibri";
-export declare let KolLinkTag: "kol-link";
-export declare let KolLinkWcTag: "kol-link-wc";
 export declare let KolLinkButtonTag: "kol-link-button";
 export declare let KolLinkGroupTag: "kol-link-group";
+export declare let KolLinkTag: "kol-link";
+export declare let KolLinkWcTag: "kol-link-wc";
 export declare let KolLogoTag: "kol-logo";
 export declare let KolModalTag: "kol-modal";
 export declare let KolNavTag: "kol-nav";
@@ -49,14 +49,17 @@ export declare let KolSpanWcTag: "kol-span-wc";
 export declare let KolSpinTag: "kol-spin";
 export declare let KolSplitButtonTag: "kol-split-button";
 export declare let KolSymbolTag: "kol-symbol";
+export declare let KolTableStatefulTag: string;
+export declare let KolTableStatelessTag: "kol-table-stateless";
+export declare let KolTableStatelessWcTag: "kol-table-stateless-wc";
 export declare let KolTableTag: "kol-table";
 export declare let KolTabsTag: "kol-tabs";
 export declare let KolTextareaTag: "kol-textarea";
 export declare let KolToastContainerTag: "kol-toast-container";
 export declare let KolTooltipWcTag: "kol-tooltip-wc";
-export declare let KolTreeTag: "kol-tree";
 export declare let KolTreeItemTag: "kol-tree-item";
 export declare let KolTreeItemWcTag: "kol-tree-item-wc";
+export declare let KolTreeTag: "kol-tree";
 export declare let KolTreeWcTag: "kol-tree-wc";
 export declare let KolVersionTag: "kol-version";
 export declare const setCustomTagNames: (transformTagName: (tagName: string) => string) => void;

package/dist/types/core/i18n.d.ts

@@ -1,22 +1,17 @@
 import type { Generic } from 'adopted-style-sheets';
 interface ITranslationOptions {
-    count?: number;
     placeholders?: {
         [K: string]: string;
     };
 }
-export declare class I18nextService {
-    private static instance;
-    private static namespace;
-    private _initialized;
-    get initialized(): boolean;
-    private constructor();
-    static getInstance(lng?: Generic.I18n.Locale.ISO_639_1): Promise<I18nextService>;
+export declare class I18nService {
+    private resourceMap;
+    language: Generic.I18n.Locale.ISO_639_1;
+    constructor(initialLanguage?: Generic.I18n.Locale.ISO_639_1);
     addTranslations(translations?: Generic.I18n.RegisterPatch<Generic.I18n.Locale.ISO_639_1, string, string> | Generic.I18n.RegisterPatch<Generic.I18n.Locale.ISO_639_1, string, string>[] | Set<Generic.I18n.RegisterPatch<Generic.I18n.Locale.ISO_639_1, string, string>>): void;
-    setLanguage(lng: Generic.I18n.Locale.ISO_639_1): Promise<void>;
+    setLanguage(lng: Generic.I18n.Locale.ISO_639_1): void;
     translate(key: string, options?: ITranslationOptions): string;
 }
-export declare const getI18nInstance: () => I18nextService;
-export declare const initI18n: (lng?: Generic.I18n.Locale.ISO_639_1) => Promise<I18nextService>;
-export declare const configI18n: (lng: Generic.I18n.Locale.ISO_639_1, translations?: Generic.I18n.RegisterPatch<Generic.I18n.Locale.ISO_639_1, string, string> | Generic.I18n.RegisterPatch<Generic.I18n.Locale.ISO_639_1, string, string>[] | Set<Generic.I18n.RegisterPatch<Generic.I18n.Locale.ISO_639_1, string, string>>) => Promise<void>;
+export declare const getI18nInstance: () => I18nService;
+export declare const initializeI18n: (lng: Generic.I18n.Locale.ISO_639_1, translations?: Generic.I18n.RegisterPatch<Generic.I18n.Locale.ISO_639_1, string, string> | Generic.I18n.RegisterPatch<Generic.I18n.Locale.ISO_639_1, string, string>[] | Set<Generic.I18n.RegisterPatch<Generic.I18n.Locale.ISO_639_1, string, string>>) => void;
 export {};

package/dist/types/index.d.ts

@@ -1,9 +1,9 @@
-export { setCurrentLocation } from './components/link/ariaCurrentService';
+export { KoliBriDevHelper, Optgroup, Option, SelectOption } from '@public-ui/schema';
+export type { Toast, ToasterOptions } from '@public-ui/schema';
+export * from '@public-ui/schema/dist/index.d';
 export * from './components.d';
+export { setCurrentLocation } from './components/link/ariaCurrentService';
+export { ToasterService } from './components/toaster/toaster';
 export { bootstrap, register } from './core/bootstrap';
 export * from './enums/bund';
 export * from './kolibri';
-export { ToasterService } from './components/toaster/toaster';
-export type { Toast, ToasterOptions } from '@public-ui/schema';
-export { Optgroup, Option, SelectOption } from '@public-ui/schema';
-export { KoliBriDevHelper } from '@public-ui/schema';

package/dist/types/locales/de.d.ts

@@ -30,6 +30,8 @@ declare const _default: {
     'kolibri-logo': string;
     'table-pagination-label': string;
     'avatar-alt': string;
+    'split-button-dropdown-label-open': string;
+    'split-button-dropdown-label-close': string;
     'toast-close-all': string;
     'error-list': string;
     'error-list-message': string;

package/dist/types/locales/en.d.ts

@@ -30,6 +30,8 @@ declare const _default: {
     'kolibri-logo': string;
     'table-pagination-label': string;
     'avatar-alt': string;
+    'split-button-dropdown-label-open': string;
+    'split-button-dropdown-label-close': string;
     'toast-close-all': string;
     'error-list': string;
     'error-list-message': string;

package/doc/table-stateful.md

@@ -0,0 +1,200 @@
+# TableStateful
+
+<KolAlert _type="warning" _variant="msg">
+  <kol-badge _label="untested"></kol-badge> Diese neue Komponente wird als ungetestet markiert, da der vollständige Barrierefreiheitstest noch aussteht. Der vollständige Test kann bei neuen Komponenten und Funktionalitäten auch erst nach einem abgeschlossenen Release erfolgen.
+</KolAlert>
+
+Die **TableStateful**-Komponente dient primär der übersichtlichen Darstellung von Datenmengen. Dabei ist sie so ausgelegt, dass sie alle von den Daten abhängige Werte automatisch ermittelt und die Tabelle entsprechend darstellt. Hierzu gehören beispielsweise die optionalen Funktionalitäten Spaltensortierung oder Pagination.
+
+<kol-indented-text _summary="Backend-seitige Pagination">
+	Bei sehr großen Datenmengen ist auch eine manuelle Nutzung der TableStateless-Komponente möglich. Das bedeutet, dass die Tabelle seitenweise "manuell" befüllt wird. Hierzu kann einfach anstatt der Table-Pagination eine "eigene" Pagination unter der Tabelle mittels der Pagination-Komponente verwendet werden. Eine mögliche Sortierung muss ebenfalls über die `onSort`-Events selber implementiert werden. Siehe [KolTableStateless](../table-stateless/readme.md).
+</kol-indented-text>
+
+## Konstruktion
+
+Die Table-Komponente ist so konstruiert, dass nicht der gesamte Tabellenaufbau im Markup selbst beschrieben werden muss. Wie genau die Tabelle Markup-spezifisch aufgebaut werden muss, um barrierefrei zu sein, übernimmt die Komponente selbst.
+
+Dadurch, dass die Table-Komponente das valide und barrierefreie Markup dynamisch zusammenbaut, kann die komplexe Auszeichnung für die assistive Systeme dem/der Entwickler:in abgenommen werden.
+
+### Funktionalitäten
+
+Die Table-Komponente unterstützt folgende Funktionalitäten:
+
+- Tabellenbeschreibung durch ein **`label`**-Attribut.
+- Mehrzeilige Spaltenüberschriften in horizontaler oder vertikaler Richtung.
+- Sortierfunktion für entweder horizontale und vertikale Ausrichtung.
+- Unterschiedliche Render-Funktion für die Zellen.
+- Pagination für die Tabelle.
+
+Die Table-Komponente unterstützt folgende Funktionalitäten **nicht**:
+
+- Das Filtern der Tabelle ist aktuell nicht innerhalb der Tabelle vorgesehen.
+- Das Auswählen von Zeilen ist aktuell in der Tabelle nicht vorgesehen.
+
+> Beides könnte jedoch mittels der Render-Funktion umgesetzt werden.
+
+### Pagination
+
+Über das Attribut **`_pagination`** kann optional eine Vielzahl zusätzlicher Properties zur Steuerung der Pagination übergeben werden. Die genaue Beschreibung der Optionen ist auf der Seite <kol-link _href="/docs/components/pagination" _label="/docs/components/pagination" _label="Pagination"></kol-link> zu finden.
+
+#### KoliBriTableHeaders
+
+```ts
+{
+  horizontal: [
+    [
+      {
+        label: string,
+        key?: string,
+        colsSpan?: number,
+        rowSpan?: number,
+        useTdInsteadOfTh?: boolean,
+        render?: (data) => string,
+        sort?: (data) => data,
+      },
+      …
+    ],
+    …
+  ],
+  vertical: [
+    [
+      {
+        label: string,
+        key?: string,
+        colsSpan?: number,
+        rowSpan?: number,
+        useTdInsteadOfTh?: boolean,
+        render?: (data) => string,
+        sort?: (data) => data,
+      },
+      …
+    ],
+    …
+  ],
+};
+```
+
+### Code
+
+```html
+<kol-table-stateful _label="Tabellenbeschreibung" _headers='{"horizontal": [[{"label":"Montag","key":"montag"}]]}' _pagination='[{"page":2}]'></kol-table>
+```
+
+### Beispiel
+
+<kol-table-stateful _label="Nur Vertikal Header, Daten Vertikal, Pagination" _headers='{"horizontal":[[{"label":"Montag","key":"montag"}]]}' _data='[{"montag":"Zelle1"},{"montag":"Zelle2"}]' _pagination='{"page":2}'></kol-table>
+
+### Footer
+
+Durch die Verwendung des **`_dataFoot_`**-Attribut können zusammenfassende Informationen oder zusätzliche Details am Ende der Tabelle angezeigt werden. Die Informationen sind hierbei an die Spaltendefinitionen gebunden.
+
+### Beispiel
+
+<kol-table-stateful _label="Nur Vertikal Header, Daten Vertikal, Pagination, DataFoot" _headers='{"horizontal":[[{"label":"Montag","key":"montag"}]]}' _data='[{"montag":"Zelle1"},{"montag":"Zelle2"}]' _dataFoot='[{"montag":"Ruhetag"}]' _pagination='{"page":2}'></kol-table>
+
+## Verwendung
+
+### Sortierung
+
+- Zu jedem Header kann man eine Sortierfunktion definieren.
+- Es ist exakt eine oder keine Sortierfunktion aktiviert.
+- Aktuell wird nicht unterstützt, dass bei zweidimensionalen Headern, die Header der jeweils anderen Header-Seite mit sortiert werden. Bei der Anforderung der Sortierung empfehlen wir die Verwendung nur einer Header-Dimension (entweder horizontal oder vertikal).
+
+### Render Funktion
+
+Die `render` Funktion kann auf verschiedene Arten wie folgt verwendet werden.  
+Alle Methoden sind auch in diesem Beispiel demonstriert: [render-cell.tsx](https://github.com/public-ui/kolibri/blob/23ebb42d1ce3c8d1e4c74a5c7972842d5e4203fe/packages/samples/react/src/components/table/render-cell.tsx#L34)
+
+1. String Rückgabewert:
+
+```tsx
+{
+  render: (_el, cell) => `Index: ${cell.label}`,
+}
+```
+
+2. Node mit textContent füllen
+
+```tsx
+{
+  render: (el, cell) => {
+    el.textContent = `Index: ${cell.label}`;
+  },
+}
+```
+
+3. Node mit innerHTML füllen - ⚠️ Hierbei unbedingt darauf achten, Werte zu sanitizen, um XXS vermeiden.
+
+```tsx
+{
+  render: (el, cell) => {
+    el.innerHTML = `<strong>${cell.label}</strong>`;
+  },
+}
+```
+
+4. React render-function verwenden
+
+```tsx
+import { createReactRenderElement } from '@public-ui/react';
+{
+  render: (el) => {
+    getRoot(createReactRenderElement(el)).render(
+      <div>
+        <KolInputText _label="Input" />
+        <KolButton _label="Save" />
+      </div>,
+    );
+  },
+}
+```
+
+<!--### Best practices
+
+### Anwendungsfälle-->
+
+## Barrierefreiheit
+
+Bei der Table-Komponente werden zahlreiche Attribut-Definitionen dem Tabellen-Markup hinzugefügt, um die Screenreader bestmöglich zu unterstützen.
+
+Aktuell werden folgende Attribute von der Komponente verwaltet: `role`, `scope` und `aria-\*`.
+
+Das heißt beispielsweise, dass bei den Spaltenüberschriften automatisch entweder die Rolle `colheader` oder `rowheader` gesetzt wird. Darüber hinaus wird der Scope entweder auf `col`/`colgroup` oder `row`/`rowgroup` gesetzt. Ähnlich dieser Automatismen werden auch die `aria-\*`-Attribute je nach Relevanz gesetzt.
+
+Warum die Tabelle einen **Tabindex** hat, wird auf der folgenden Webseite beschrieben: <kol-link _href="" _label=""></kol-link>https://dequeuniversity.com/rules/axe/3.5/scrollable-region-focusable
+
+## Links und Referenzen
+
+- <kol-link _href="https://www.w3.org/WAI/tutorials/tables/" _target="_blank"></kol-link>
+- <kol-link _href="https://www.barrierefreies-webdesign.de/knowhow/datentabellen/scope.html" _target="_blank"></kol-link>
+- <kol-link _href="https://developer.mozilla.org/de/docs/Web/Accessibility/ARIA/ARIA_Live_Regions" _target="_blank"></kol-link>
+- <kol-link _href="https://tollwerk.de/projekte/tipps-techniken-inklusiv-barrierefrei/aria-live-regionen" _target="_blank"></kol-link>
+- <kol-link _href="https://www.barrierefreies-webdesign.de/knowhow/live-regions/attribute.html" _target="_blank"></kol-link>
+- <kol-link _href="https://www.digitala11y.com/aria-sort-properties/" _target="_blank"></kol-link>
+- <kol-link _href="https://dequeuniversity.com/library/aria/table-sortable" _target="_blank"></kol-link>
+- <kol-link _href="https://www.maxability.co.in/2016/06/07/aria-sort-property/" _target="_blank"></kol-link>
+- <kol-link _href="https://developer.mozilla.org/en-US/docs/Web/API/Element/ariaSort" _target="_blank"></kol-link>
+- <kol-link _href="https://tollwerk.de/projekte/tipps-techniken-inklusiv-barrierefrei/aria-live-regionen" _target="_blank"></kol-link>
+- <kol-link _href="https://stackoverflow.com/questions/1312236/" _target="_blank"></kol-link>
+- <kol-link _href="https://dequeuniversity.com/rules/axe/3.5/scrollable-region-focusable" _target="_blank"></kol-link>
+
+<!-- Auto Generated Below -->
+
+
+## Properties
+
+| Property                | Attribute              | Description                                                                                                        | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | Default     |
+| ----------------------- | ---------------------- | ------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- |
+| `_allowMultiSort`       | `_allow-multi-sort`    | Defines whether to allow multi sort.                                                                               | `boolean` \| `undefined`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | `undefined` |
+| `_data` _(required)_    | `_data`                | Defines the primary table data.                                                                                    | `KoliBriTableDataType[]` \| `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | `undefined` |
+| `_dataFoot`             | `_data-foot`           | Defines the data for the table footer.                                                                             | `KoliBriTableDataType[]` \| `string` \| `undefined`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | `undefined` |
+| `_headers` _(required)_ | `_headers`             | Defines the horizontal and vertical table headers.                                                                 | `string` \| `{ horizontal?: KoliBriTableHeaderCellWithLogic[][]` \| `undefined; vertical?: KoliBriTableHeaderCellWithLogic[][]` \| `undefined; }`                                                                                                                                                                                                                                                                                                                                                                                         | `undefined` |
+| `_label` _(required)_   | `_label`               | Defines the visible or semantic label of the component (e.g. aria-label, label, headline, caption, summary, etc.). | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | `undefined` |
+| `_minWidth`             | `_min-width`           | Defines the table min-width.                                                                                       | `string` \| `undefined`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | `undefined` |
+| `_pagination`           | `_pagination`          | Defines whether to show the data distributed over multiple pages.                                                  | `boolean` \| `string` \| `undefined` \| `{ _page: number; } & { _on?: KoliBriPaginationButtonCallbacks` \| `undefined; _page?: number` \| `undefined; _max?: number` \| `undefined; _boundaryCount?: number` \| `undefined; _hasButtons?: boolean` \| `Stringified<PaginationHasButton>` \| `undefined; _pageSize?: number` \| `undefined; _pageSizeOptions?: Stringified<number[]>` \| `undefined; _siblingCount?: number` \| `undefined; _customClass?: string` \| `undefined; _label?: string` \| `undefined; _tooltipAlign?: AlignPropType` \| `undefined; }` | `undefined` |
+| `_paginationPosition`   | `_pagination-position` | Controls the position of the pagination.                                                                           | `"both"` \| `"bottom"` \| `"top"` \| `undefined`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | `'bottom'`  |
+
+
+----------------------------------------------
+
+

package/doc/table-stateless.md

@@ -0,0 +1,57 @@
+# TableStateless
+
+<KolAlert _type="warning" _variant="msg">
+  <kol-badge _label="untested"></kol-badge> Diese neue Komponente wird als ungetestet markiert, da der vollständige Barrierefreiheitstest noch aussteht. Der vollständige Test kann bei neuen Komponenten und Funktionalitäten auch erst nach einem abgeschlossenen Release erfolgen.
+</KolAlert>
+
+Die **TableStateless**-Komponente ist für die reine Darstellung der KoliBri-Tabelle verantwortlich. Für eine Tabellen-Komponente, die Sortierung und Paginierung mit den zur Verfügung gestellten Daten automatisch übernehmen kann, siehe [KolTableStateful](../table-stateful/readme.md).
+
+TableStateless bietet sich insbesondere bei größeren Datenmengen an, wenn es nicht praktikabel ist, die komplette Datenmenge zur Filterung und Sortierung in den Browser auszuliefern.
+
+Beispiel:
+
+```jsx
+<KolTableStateless
+  _label="Table for demonstration purposes"
+  _headerCells={{
+    horizontal: [
+      [
+        { key: 'value', label: 'Value', sortDirection: 'ASC' },
+      ],
+    ],
+  }}
+  _data={DATA}
+  className="block"
+  style={{ maxWidth: '600px' }}
+  _on={{
+    /**
+     * @param {MouseEvent} _
+     * @param {SortEventPayload} payload
+     * @param {string} payload.key
+     * @param {KoliBriSortDirection} payload.currentSortDirection
+     */
+    onSort: (_: MouseEvent, payload: SortEventPayload) => {
+      /* Perform sort, update `DATA` and headers `sortDirection` */
+    },
+  }}
+/>
+```
+
+<!-- Auto Generated Below -->
+
+
+## Properties
+
+| Property                    | Attribute       | Description                                                                                                        | Type                                                                                                                      | Default     |
+| --------------------------- | --------------- | ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------- | ----------- |
+| `_data` _(required)_        | `_data`         | Defines the primary table data.                                                                                    | `KoliBriTableDataType[]` \| `string`                                                                                        | `undefined` |
+| `_dataFoot`                 | `_data-foot`    | Defines the data for the table footer.                                                                             | `KoliBriTableDataType[]` \| `string` \| `undefined`                                                                           | `undefined` |
+| `_headerCells` _(required)_ | `_header-cells` | Defines the horizontal and vertical table headers.                                                                 | `string` \| `{ horizontal?: KoliBriTableHeaderCell[][]` \| `undefined; vertical?: KoliBriTableHeaderCell[][]` \| `undefined; }` | `undefined` |
+| `_label` _(required)_       | `_label`        | Defines the visible or semantic label of the component (e.g. aria-label, label, headline, caption, summary, etc.). | `string`                                                                                                                  | `undefined` |
+| `_minWidth`                 | `_min-width`    | Defines the table min-width.                                                                                       | `string` \| `undefined`                                                                                                     | `undefined` |
+| `_on`                       | --              | Defines the callback functions for table events.                                                                   | `undefined` \| `{ onSort?: EventValueOrEventCallback<MouseEvent, SortEventPayload>` \| `undefined; }`                         | `undefined` |
+
+
+----------------------------------------------
+
+

package/doc/table.md

@@ -1,5 +1,11 @@
 # Table
 
+<KolAlert _type="warning" _variant="msg">
+  KolTable ist deprecated, bitte stattdessen
+  <kol-link _label="KolTableStateful" _href="https://github.com/public-ui/kolibri/blob/develop/packages/components/src/components/table-stateless/readme.md">
+  verwenden, die API und Funktionalität sind identisch.
+</KolAlert>
+
 Die **Table**-Komponente dient primär der übersichtlichen Darstellung von Datenmengen. Dabei ist sie so ausgelegt, dass sie alle von den Daten abhängige Werte automatisch ermittelt und die Tabelle entsprechend darstellt. Hierzu gehören beispielsweise die optionalen Funktionalitäten Spaltensortierung oder Pagination.
 
 <kol-indented-text _summary="Backend-seitige Pagination">
@@ -169,6 +175,8 @@ Warum die Tabelle einen **Tabindex** hat, wird auf der folgenden Webseite beschr
 <!-- Auto Generated Below -->
 
 
+> **[DEPRECATED]** Use KolTableStateful instead.
+
 ## Properties
 
 | Property                | Attribute              | Description                                                                                                        | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | Default     |
@@ -176,7 +184,7 @@ Warum die Tabelle einen **Tabindex** hat, wird auf der folgenden Webseite beschr
 | `_allowMultiSort`       | `_allow-multi-sort`    | Defines whether to allow multi sort.                                                                               | `boolean` \| `undefined`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | `undefined` |
 | `_data` _(required)_    | `_data`                | Defines the primary table data.                                                                                    | `KoliBriTableDataType[]` \| `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | `undefined` |
 | `_dataFoot`             | `_data-foot`           | Defines the data for the table footer.                                                                             | `KoliBriTableDataType[]` \| `string` \| `undefined`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | `undefined` |
-| `_headers` _(required)_ | `_headers`             | Defines the horizontal and vertical table headers.                                                                 | `string` \| `{ horizontal?: KoliBriTableHeaderCell[][]` \| `undefined; vertical?: KoliBriTableHeaderCell[][]` \| `undefined; }`                                                                                                                                                                                                                                                                                                                                                                                                           | `undefined` |
+| `_headers` _(required)_ | `_headers`             | Defines the horizontal and vertical table headers.                                                                 | `string` \| `{ horizontal?: KoliBriTableHeaderCellWithLogic[][]` \| `undefined; vertical?: KoliBriTableHeaderCellWithLogic[][]` \| `undefined; }`                                                                                                                                                                                                                                                                                                                                                                                         | `undefined` |
 | `_label` _(required)_   | `_label`               | Defines the visible or semantic label of the component (e.g. aria-label, label, headline, caption, summary, etc.). | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | `undefined` |
 | `_minWidth`             | `_min-width`           | Defines the table min-width.                                                                                       | `string` \| `undefined`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | `undefined` |
 | `_pagination`           | `_pagination`          | Defines whether to show the data distributed over multiple pages.                                                  | `boolean` \| `string` \| `undefined` \| `{ _page: number; } & { _on?: KoliBriPaginationButtonCallbacks` \| `undefined; _page?: number` \| `undefined; _max?: number` \| `undefined; _boundaryCount?: number` \| `undefined; _hasButtons?: boolean` \| `Stringified<PaginationHasButton>` \| `undefined; _pageSize?: number` \| `undefined; _pageSizeOptions?: Stringified<number[]>` \| `undefined; _siblingCount?: number` \| `undefined; _customClass?: string` \| `undefined; _label?: string` \| `undefined; _tooltipAlign?: AlignPropType` \| `undefined; }` | `undefined` |

package/doc/toaster.md

@@ -89,9 +89,9 @@ Type: `Promise<void>`
 
 #### Parameters
 
-| Name    | Type                                                                                                                                                                                                                                                          | Description |
-| ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- |
-| `toast` | `{ description?: string` \| `undefined; render?: ((nodeRef: HTMLElement, options: { close: () => void; }) => void)` \| `undefined; label: string; type: "error"` \| `"warning"` \| `"info"` \| `"success"` \| `"default"; alertVariant?: "card"` \| `"msg"` \| `undefined; }` |             |
+| Name    | Type                                                                                                                                                                                                            | Description |
+| ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- |
+| `toast` | `{ description?: string` \| `undefined; render?: ToastRenderFunction` \| `undefined; label: string; type: "error"` \| `"warning"` \| `"info"` \| `"success"` \| `"default"; alertVariant?: "card"` \| `"msg"` \| `undefined; }` |             |
 
 #### Returns
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@public-ui/components",
-  "version": "2.0.13",
+  "version": "2.0.15",
   "license": "EUPL-1.2",
   "homepage": "https://public-ui.github.io",
   "bugs": {

package/vscode-custom-data.json

@@ -3012,7 +3012,7 @@
       "name": "kol-table",
       "description": {
         "kind": "markdown",
-        "value": "Die **Table**-Komponente dient primär der übersichtlichen Darstellung von Datenmengen. Dabei ist sie so ausgelegt, dass sie alle von den Daten abhängige Werte automatisch ermittelt und die Tabelle entsprechend darstellt. Hierzu gehören beispielsweise die optionalen Funktionalitäten Spaltensortierung oder Pagination.\n\n<kol-indented-text _summary=\"Backend-seitige Pagination\">\n\tBei sehr großen Datenmengen ist auch eine manuelle Nutzung der Table-Komponente möglich. Das bedeutet, dass die Tabelle seitenweise \"manuell\" befüllt wird. Hierzu kann einfach anstatt der Table-Pagination eine \"eigene\" Pagination unter der Tabelle mittels der Pagination-Komponente verwendet werden.\n</kol-indented-text>"
+        "value": "<KolAlert _type=\"warning\" _variant=\"msg\">\n  KolTable ist deprecated, bitte stattdessen\n  <kol-link _label=\"KolTableStateful\" _href=\"https://github.com/public-ui/kolibri/blob/develop/packages/components/src/components/table-stateless/readme.md\">\n  verwenden, die API und Funktionalität sind identisch.\n</KolAlert>\n\nDie **Table**-Komponente dient primär der übersichtlichen Darstellung von Datenmengen. Dabei ist sie so ausgelegt, dass sie alle von den Daten abhängige Werte automatisch ermittelt und die Tabelle entsprechend darstellt. Hierzu gehören beispielsweise die optionalen Funktionalitäten Spaltensortierung oder Pagination.\n\n<kol-indented-text _summary=\"Backend-seitige Pagination\">\n\tBei sehr großen Datenmengen ist auch eine manuelle Nutzung der Table-Komponente möglich. Das bedeutet, dass die Tabelle seitenweise \"manuell\" befüllt wird. Hierzu kann einfach anstatt der Table-Pagination eine \"eigene\" Pagination unter der Tabelle mittels der Pagination-Komponente verwendet werden.\n</kol-indented-text>"
       },
       "attributes": [
         {
@@ -3060,6 +3060,116 @@
         }
       ]
     },
+    {
+      "name": "kol-table-stateful",
+      "description": {
+        "kind": "markdown",
+        "value": "<KolAlert _type=\"warning\" _variant=\"msg\">\n  <kol-badge _label=\"untested\"></kol-badge> Diese neue Komponente wird als ungetestet markiert, da der vollständige Barrierefreiheitstest noch aussteht. Der vollständige Test kann bei neuen Komponenten und Funktionalitäten auch erst nach einem abgeschlossenen Release erfolgen.\n</KolAlert>\n\nDie **TableStateful**-Komponente dient primär der übersichtlichen Darstellung von Datenmengen. Dabei ist sie so ausgelegt, dass sie alle von den Daten abhängige Werte automatisch ermittelt und die Tabelle entsprechend darstellt. Hierzu gehören beispielsweise die optionalen Funktionalitäten Spaltensortierung oder Pagination.\n\n<kol-indented-text _summary=\"Backend-seitige Pagination\">\n\tBei sehr großen Datenmengen ist auch eine manuelle Nutzung der TableStateless-Komponente möglich. Das bedeutet, dass die Tabelle seitenweise \"manuell\" befüllt wird. Hierzu kann einfach anstatt der Table-Pagination eine \"eigene\" Pagination unter der Tabelle mittels der Pagination-Komponente verwendet werden. Eine mögliche Sortierung muss ebenfalls über die `onSort`-Events selber implementiert werden. Siehe [KolTableStateless](../table-stateless/readme.md).\n</kol-indented-text>"
+      },
+      "attributes": [
+        {
+          "name": "_allow-multi-sort",
+          "description": "Defines whether to allow multi sort."
+        },
+        {
+          "name": "_data",
+          "description": "Defines the primary table data."
+        },
+        {
+          "name": "_data-foot",
+          "description": "Defines the data for the table footer."
+        },
+        {
+          "name": "_headers",
+          "description": "Defines the horizontal and vertical table headers."
+        },
+        {
+          "name": "_label",
+          "description": "Defines the visible or semantic label of the component (e.g. aria-label, label, headline, caption, summary, etc.)."
+        },
+        {
+          "name": "_min-width",
+          "description": "Defines the table min-width."
+        },
+        {
+          "name": "_pagination",
+          "description": "Defines whether to show the data distributed over multiple pages."
+        },
+        {
+          "name": "_pagination-position",
+          "description": "Controls the position of the pagination.",
+          "values": [
+            {
+              "name": "both"
+            },
+            {
+              "name": "bottom"
+            },
+            {
+              "name": "top"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "name": "kol-table-stateless",
+      "description": {
+        "kind": "markdown",
+        "value": "<KolAlert _type=\"warning\" _variant=\"msg\">\n  <kol-badge _label=\"untested\"></kol-badge> Diese neue Komponente wird als ungetestet markiert, da der vollständige Barrierefreiheitstest noch aussteht. Der vollständige Test kann bei neuen Komponenten und Funktionalitäten auch erst nach einem abgeschlossenen Release erfolgen.\n</KolAlert>\n\nDie **TableStateless**-Komponente ist für die reine Darstellung der KoliBri-Tabelle verantwortlich. Für eine Tabellen-Komponente, die Sortierung und Paginierung mit den zur Verfügung gestellten Daten automatisch übernehmen kann, siehe [KolTableStateful](../table-stateful/readme.md).\n\nTableStateless bietet sich insbesondere bei größeren Datenmengen an, wenn es nicht praktikabel ist, die komplette Datenmenge zur Filterung und Sortierung in den Browser auszuliefern.\n\nBeispiel:\n\n```jsx\n<KolTableStateless\n  _label=\"Table for demonstration purposes\"\n  _headerCells={{\n    horizontal: [\n      [\n        { key: 'value', label: 'Value', sortDirection: 'ASC' },\n      ],\n    ],\n  }}\n  _data={DATA}\n  className=\"block\"\n  style={{ maxWidth: '600px' }}\n  _on={{\n    /**\n     * @param {MouseEvent} _\n     * @param {SortEventPayload} payload\n     * @param {string} payload.key\n     * @param {KoliBriSortDirection} payload.currentSortDirection\n     */\n    onSort: (_: MouseEvent, payload: SortEventPayload) => {\n      /* Perform sort, update `DATA` and headers `sortDirection` */\n    },\n  }}\n/>\n```"
+      },
+      "attributes": [
+        {
+          "name": "_data",
+          "description": "Defines the primary table data."
+        },
+        {
+          "name": "_data-foot",
+          "description": "Defines the data for the table footer."
+        },
+        {
+          "name": "_header-cells",
+          "description": "Defines the horizontal and vertical table headers."
+        },
+        {
+          "name": "_label",
+          "description": "Defines the visible or semantic label of the component (e.g. aria-label, label, headline, caption, summary, etc.)."
+        },
+        {
+          "name": "_min-width",
+          "description": "Defines the table min-width."
+        }
+      ]
+    },
+    {
+      "name": "kol-table-stateless-wc",
+      "description": {
+        "kind": "markdown",
+        "value": "<KolAlert _type=\"warning\" _variant=\"msg\">\n  <kol-badge _label=\"untested\"></kol-badge> Diese neue Komponente wird als ungetestet markiert, da der vollständige Barrierefreiheitstest noch aussteht. Der vollständige Test kann bei neuen Komponenten und Funktionalitäten auch erst nach einem abgeschlossenen Release erfolgen.\n</KolAlert>\n\nDie **TableStateless**-Komponente ist für die reine Darstellung der KoliBri-Tabelle verantwortlich. Für eine Tabellen-Komponente, die Sortierung und Paginierung mit den zur Verfügung gestellten Daten automatisch übernehmen kann, siehe [KolTableStateful](../table-stateful/readme.md).\n\nTableStateless bietet sich insbesondere bei größeren Datenmengen an, wenn es nicht praktikabel ist, die komplette Datenmenge zur Filterung und Sortierung in den Browser auszuliefern.\n\nBeispiel:\n\n```jsx\n<KolTableStateless\n  _label=\"Table for demonstration purposes\"\n  _headerCells={{\n    horizontal: [\n      [\n        { key: 'value', label: 'Value', sortDirection: 'ASC' },\n      ],\n    ],\n  }}\n  _data={DATA}\n  className=\"block\"\n  style={{ maxWidth: '600px' }}\n  _on={{\n    /**\n     * @param {MouseEvent} _\n     * @param {SortEventPayload} payload\n     * @param {string} payload.key\n     * @param {KoliBriSortDirection} payload.currentSortDirection\n     */\n    onSort: (_: MouseEvent, payload: SortEventPayload) => {\n      /* Perform sort, update `DATA` and headers `sortDirection` */\n    },\n  }}\n/>\n```"
+      },
+      "attributes": [
+        {
+          "name": "_data",
+          "description": "Defines the primary table data."
+        },
+        {
+          "name": "_data-foot",
+          "description": "Defines the data for the table footer."
+        },
+        {
+          "name": "_header-cells",
+          "description": "Defines the horizontal and vertical table headers."
+        },
+        {
+          "name": "_label",
+          "description": "Defines the visible or semantic label of the component (e.g. aria-label, label, headline, caption, summary, etc.)."
+        },
+        {
+          "name": "_min-width",
+          "description": "Defines the table min-width."
+        }
+      ]
+    },
     {
       "name": "kol-tabs",
       "description": {

package/dist/cjs/component-names-4cf3e7f5.js

@@ -1,4 +0,0 @@
-/*!
- * KoliBri - The accessible HTML-Standard
- */
-"use strict";let KolAbbrTag="kol-abbr",KolAccordionTag="kol-accordion";exports.KolAlertTag="kol-alert",exports.KolAlertWcTag="kol-alert-wc";let KolAvatarTag="kol-avatar";exports.KolAvatarWcTag="kol-avatar-wc",exports.KolBadgeTag="kol-badge";let KolBreadcrumbTag="kol-breadcrumb";exports.KolButtonTag="kol-button",exports.KolButtonWcTag="kol-button-wc";let KolButtonGroupTag="kol-button-group";exports.KolButtonGroupWcTag="kol-button-group-wc";let KolButtonLinkTag="kol-button-link",KolCardTag="kol-card",KolDetailsTag="kol-details",KolFormTag="kol-form",KolHeadingTag="kol-heading";exports.KolHeadingWcTag="kol-heading-wc",exports.KolIconTag="kol-icon";let KolImageTag="kol-image";exports.KolIndentedTextTag="kol-indented-text",exports.KolInputTag="kol-input";let KolInputCheckboxTag="kol-input-checkbox",KolInputColorTag="kol-input-color",KolInputDateTag="kol-input-date",KolInputEmailTag="kol-input-email",KolInputFileTag="kol-input-file",KolInputNumberTag="kol-input-number",KolInputPasswordTag="kol-input-password",KolInputRadioTag="kol-input-radio",KolInputRangeTag="kol-input-range",KolInputTextTag="kol-input-text",KolKolibriTag="kol-kolibri";exports.KolLinkTag="kol-link",exports.KolLinkWcTag="kol-link-wc";let KolLinkButtonTag="kol-link-button",KolLinkGroupTag="kol-link-group",KolLogoTag="kol-logo",KolModalTag="kol-modal",KolNavTag="kol-nav";exports.KolPaginationTag="kol-pagination";let KolPopoverWcTag="kol-popover-wc",KolProgressTag="kol-progress",KolQuoteTag="kol-quote";exports.KolSelectTag="kol-select";let KolSkipNavTag="kol-skip-nav",KolSpanTag="kol-span";exports.KolSpanWcTag="kol-span-wc";let KolSpinTag="kol-spin",KolSplitButtonTag="kol-split-button",KolSymbolTag="kol-symbol",KolTableTag="kol-table",KolTabsTag="kol-tabs",KolTextareaTag="kol-textarea";exports.KolToastContainerTag="kol-toast-container",exports.KolTooltipWcTag="kol-tooltip-wc";let KolTreeTag="kol-tree",KolTreeItemTag="kol-tree-item";exports.KolTreeItemWcTag="kol-tree-item-wc",exports.KolTreeWcTag="kol-tree-wc";let KolVersionTag="kol-version";const setCustomTagNames=o=>{KolAbbrTag=o(KolAbbrTag),KolAccordionTag=o(KolAccordionTag),exports.KolAlertTag=o(exports.KolAlertTag),exports.KolAlertWcTag=o(exports.KolAlertWcTag),KolAvatarTag=o(KolAvatarTag),exports.KolAvatarWcTag=o(exports.KolAvatarWcTag),exports.KolBadgeTag=o(exports.KolBadgeTag),KolBreadcrumbTag=o(KolBreadcrumbTag),exports.KolButtonTag=o(exports.KolButtonTag),exports.KolButtonWcTag=o(exports.KolButtonWcTag),KolButtonGroupTag=o(KolButtonGroupTag),exports.KolButtonGroupWcTag=o(exports.KolButtonGroupWcTag),KolButtonLinkTag=o(KolButtonLinkTag),KolCardTag=o(KolCardTag),KolDetailsTag=o(KolDetailsTag),KolFormTag=o(KolFormTag),KolHeadingTag=o(KolHeadingTag),exports.KolHeadingWcTag=o(exports.KolHeadingWcTag),exports.KolIconTag=o(exports.KolIconTag),KolImageTag=o(KolImageTag),exports.KolIndentedTextTag=o(exports.KolIndentedTextTag),exports.KolInputTag=o(exports.KolInputTag),KolInputCheckboxTag=o(KolInputCheckboxTag),KolInputColorTag=o(KolInputColorTag),KolInputDateTag=o(KolInputDateTag),KolInputEmailTag=o(KolInputEmailTag),KolInputFileTag=o(KolInputFileTag),KolInputNumberTag=o(KolInputNumberTag),KolInputPasswordTag=o(KolInputPasswordTag),KolInputRadioTag=o(KolInputRadioTag),KolInputRangeTag=o(KolInputRangeTag),KolInputTextTag=o(KolInputTextTag),KolKolibriTag=o(KolKolibriTag),exports.KolLinkTag=o(exports.KolLinkTag),exports.KolLinkWcTag=o(exports.KolLinkWcTag),KolLinkButtonTag=o(KolLinkButtonTag),KolLinkGroupTag=o(KolLinkGroupTag),KolLogoTag=o(KolLogoTag),KolModalTag=o(KolModalTag),KolNavTag=o(KolNavTag),exports.KolPaginationTag=o(exports.KolPaginationTag),KolPopoverWcTag=o(KolPopoverWcTag),KolProgressTag=o(KolProgressTag),KolQuoteTag=o(KolQuoteTag),exports.KolSelectTag=o(exports.KolSelectTag),KolSkipNavTag=o(KolSkipNavTag),KolSpanTag=o(KolSpanTag),exports.KolSpanWcTag=o(exports.KolSpanWcTag),KolSpinTag=o(KolSpinTag),KolSplitButtonTag=o(KolSplitButtonTag),KolSymbolTag=o(KolSymbolTag),KolTableTag=o(KolTableTag),KolTabsTag=o(KolTabsTag),KolTextareaTag=o(KolTextareaTag),exports.KolToastContainerTag=o(exports.KolToastContainerTag),exports.KolTooltipWcTag=o(exports.KolTooltipWcTag),KolTreeTag=o(KolTreeTag),KolTreeItemTag=o(KolTreeItemTag),exports.KolTreeItemWcTag=o(exports.KolTreeItemWcTag),exports.KolTreeWcTag=o(exports.KolTreeWcTag),KolVersionTag=o(KolVersionTag)};exports.setCustomTagNames=setCustomTagNames;