@public-ui/components 2.2.0 → 3.0.0-alpha.0

package/doc/button-link.md

@@ -1,51 +1,4 @@
-# ButtonLink
-
-Der ButtonLink ist semantisch ein Button und hat das Design eines Links. Hierzu werden alle relevanten Properties der Button-Komponente übernommen und um die Design-bestimmenden Properties des Links erweitert.
-
-Einen Button kann man deaktivieren und daher gibt es bei einem ButtonLink das Property `_disabled`. Wie das optisch ausgestaltet wird, entscheidet die UX-Designer:in.
-
-Statt, wie bei einem Link, `_href` zu verwenden, wird bei einem ButtonLink das Property über den `Click-Callback` gesteuert. Hierzu wird das `_on`-Property verwendet.
-
-Bei einem Link gibt es das Property `target`, welches ggf. den Link in einem neuen Fenster/Tab öffnet. Das Verhalten ist aktuell noch nicht umgesetzt.
-
-Da der Link, nicht wie der Button, in mehrere Varianten (`primary` oder `secondary` usw.) angeboten wird, stehen die Properties `_customClass` und `_variant` nicht zur Verfügung.
-
-## Konstruktion
-
-### Code
-
-```html
-<kol-button-link _on="" _label="Schalter sieht wie ein Link aus"></kol-button-link>
-```
-
-### Events
-
-Events der Komponente können über eine `_on`-Property behandelt werden, die aus einem Objekt mit verschiedenen Callback-Funktionen besteht:
-
-```js
-kolibriElement._on = {
-	onFocus: (event) => {
-		/* Do something on focus */
-	},
-	onClick: (event, value) => {
-		/* Do something with value or event */
-	},
-	// ...
-};
-```
-
-| Event       | Auslöser                                                       | Value                |
-| ----------- | -------------------------------------------------------------- | -------------------- |
-| onFocus     | Element wird fokussiert                                        | -                    |
-| onMouseDown | Element wird angeklickt (entspricht nativem `mouseDown`-Event) | -                    |
-| onClick     | Element wird angeklickt (entspricht nativem `click`-Event)     | Definierter `_value` |
-| onBlur      | Element verliert Fokus                                         | -                    |
-
-### Beispiel
-
-<div class="flex gap-2">
-  <kol-button-link _on="" _label="Schalter sieht wie ein Link aus"></kol-button-link>
-</div>
+# kol-button-link
 
 <!-- Auto Generated Below -->
 

package/doc/button.md

@@ -1,120 +1,4 @@
-# Button
-
-**Buttons** dienen dazu, Benutzer:innen Auswahlmöglichkeiten für Aktionen anzuzeigen und diese in einer klaren Hierarchie anzuordnen. Sie helfen Nutzer:innen, die wichtigsten Aktionen einer Seite oder innerhalb eines Viewports zu finden und ermöglichen es ihnen, diese Aktionen auszuführen. Die Beschriftung des Buttons wird verwendet, um Nutzer:innen klar anzuzeigen, welche Aktion ausgelöst wird. Buttons ermöglichen es Nutzer:innen, eine Änderung zu bestätigen, Schritte in einer Aufgabe abzuschließen oder Entscheidungen zu treffen.
-
-## Konstruktion
-
-### Code
-
-```html
-<kol-button _label="Primary" _variant="primary"></kol-button>
-<kol-button _label="Secondary" _variant="secondary"></kol-button>
-<kol-button _label="Normal" _variant="normal"></kol-button>
-<kol-button _label="Danger" _variant="danger"></kol-button>
-<kol-button _label="Ghost" _variant="ghost"></kol-button>
-```
-
-### Events
-
-Events der Komponente können über eine `_on`-Property behandelt werden, die aus einem Objekt mit verschiedenen Callback-Funktionen besteht:
-
-```js
-kolibriElement._on = {
-	onFocus: (event) => {
-		/* Do something on focus */
-	},
-	onClick: (event, value) => {
-		/* Do something with value or event */
-	},
-	// ...
-};
-```
-
-| Event       | Auslöser                                                       | Value                |
-| ----------- | -------------------------------------------------------------- | -------------------- |
-| onFocus     | Element wird fokussiert                                        | -                    |
-| onMouseDown | Element wird angeklickt (entspricht nativem `mouseDown`-Event) | -                    |
-| onClick     | Element wird angeklickt (entspricht nativem `click`-Event)     | Definierter `_value` |
-| onBlur      | Element verliert Fokus                                         | -                    |
-
-### Beispiel
-
-Default
-
-<div class="flex flex-wrap gap-2">
-  <kol-button _label="Primary" _variant="primary"></kol-button>
-  <kol-button _label="Secondary" _variant="secondary"></kol-button>
-  <kol-button _label="Normal" _variant="normal"></kol-button>
-  <kol-button _label="Danger" _variant="danger"></kol-button>
-  <kol-button _label="Ghost" _variant="ghost"></kol-button>
-</div>
-
-Disabled
-
-<div class="flex flex-wrap gap-2">
-  <kol-button _label="Primary" _variant="primary" _disabled></kol-button>
-  <kol-button _label="Secondary" _variant="secondary" _disabled></kol-button>
-  <kol-button _label="Normal" _variant="normal" _disabled></kol-button>
-  <kol-button _label="Danger" _variant="danger" _disabled></kol-button>
-  <kol-button _label="Ghost" _variant="ghost" _disabled></kol-button>
-</div>
-
-## Verwendung
-
-### Beschriftung
-
-Für die eindeutige Beschriftung des Buttons nutzen Sie das Attribut **`_label`**.
-`_label="Schaltflächenbeschriftung"`
-
-### Icons
-
-Icons (**`_icons`**) kann entweder als String angegeben werden, oder als Objekt.
-Als String übergeben Sie die Iconklasse (z.B.: `_icons="codicon codicon-home`), das Icon wird links vom Text angezeigt.
-Das Objekt ist vom Typ `KoliBriAllIcon`, kann also einen oder mehrere der Schlüssel `top`, `right`, `bottom` und `left` besitzen. Diese sind dann entweder String (siehe oben) oder ein Objekt vom Typ `KoliBriCustomIcon`, welches aus `icon` (String, siehe oben) und `style` (optional, Styleobjekt) besteht.
-
-<kol-link _href="https://microsoft.github.io/vscode-codicons/dist/codicon.html" _target="_blank" _label="Übersicht Codicons"></kol-link>
-
-### Schaltfläche ohne Text
-
-Mittels **`_hide-label`** wird die Schaltfläche nur das icon anzeigen (<kol-link _href="#icon" _label="siehe icon"></kol-link>)
-
-<kol-alert _type="info">Beachten Sie, dass das Attribut **`_label`** auch dann gesetzt werden muss, wenn nur ein Icon angezeigt werden soll, dieses wird von Screenreadern vorgelesen und in den Tooltip gesetzt.</kol-alert>
-
-### Darstellung angeben
-
-Zur Steuerung der Darstellung verwenden Sie das Attribut **`_variant`**. Der Standardwert ist `primary`, alternativ kann auch `primary`, `secondary`, `normal`, `danger`, `ghost`, oder `custom` gesetzt werden.<br/>
-
-Über die Verwendung des Wertes `custom` kann eine eigene Darstellung gewählt werden. Verpflichtend ist in diesem Fall das Setzen des Attribut **`_custom-class`**, damit die Schaltfläche im Shadow-Dom mittels CSS selektiert werden kann.
-
-### Best practices
-
-- Verwenden Sie eine primäre Schaltfläche für die nächstbeste Aktion. Verbleibende Calls-to-Action sollten als sekundäre Schaltfläche dargestellt werden.
-- Verwenden Sie Schaltflächen an einheitlichen Stellen in der Benutzeroberfläche, um die Benutzererfahrung zu verbessern.
-- Verwenden Sie nur eine primäre Schaltfläche je Viewport. Auf der gesamten Seite kann ein Button-Style beliebig oft auftreten.
-- Die Beschriftung des Button muss die Aktion beschreiben, die die Schaltfläche ausführt. Sie sollte ein Verb enthalten (z.B. Speichern). Verwenden Sie prägnante, spezifische, selbsterklärende Beschriftungen.
-- Schaltflächenbeschriftungen sollten immer dann auch ein Nomen enthalten, wenn es Raum für Interpretationen darüber gibt, wofür das Verb zuständig ist. Verwenden Sie keine generischen Bezeichnungen wie "OK", insbesondere nicht im Fehlerfall. Fehler sind nie "OK".
-- Verwenden Sie nicht mehrere Buttons im Style "primär" innerhalb einer Gruppierung.
-- Verwenden Sie Buttons nicht als Link oder als Navigationselement.
-
-## Barrierefreiheit
-
-Für Menschen mit einem eingeschränkten Sichtfeld ist die Positionierung des **Icons** im Button links von der Beschriftung optimal.
-
-Probleme mit Disabled-Status
-
-- Darstellung Kontraste
-- Möglichkeit des Nutzerfeedbacks
-
-### Tastatursteuerung
-
-| Taste   | Funktion                                                     |
-| ------- | ------------------------------------------------------------ |
-| `Tab`   | Springt den einzelnen Button an und fokussiert ihn.          |
-| `Enter` | Führt die onClick-Methode der fokussierten Schaltfläche aus. |
-
-## Links und Referenzen
-
-- <kol-link _href="https://www.w3.org/TR/wai-aria-practices/#button" _target="_blank"></kol-link>
+# kol-button
 
 <!-- Auto Generated Below -->
 

package/doc/card.md

@@ -1,68 +1,4 @@
-# Card
-
-Um einzelne Bereiche Ihrer Webseite optisch hervorzuheben, bietet sich die **Card**-Komponente an. Mit ihrer Hilfe können Sie Ihre Inhalte sehr einfach strukturieren.
-
-Die **Card**-Komponente besteht aus einem **_Titel-Bereich_**, einem **_Inhalts-Bereich_**.
-
-Der **Titel-Bereich** wird in einer größeren Schrift dargestellt. Der **Inhalts-Bereich** ist optisch durch eine horizontale Trennlinie unterhalb des Titel-Bereichs abgetrennt und wird in der Standardschrift ausgegeben.
-
-## Konstruktion
-
-### Code
-
-```html
-<kol-card _label="Testtitel">
-	<div>
-		Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua.
-		At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum
-		dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos
-		et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.
-	</div>
-</kol-card>
-```
-
-### Beispiel
-
-<kol-card _label="Testtitel">
-	<div>
-		Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua.
-		At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum
-		dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos
-		et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.
-	</div>
-</kol-card>
-
-## Verwendung
-
-### Einfache Standard-Card
-
-In der Standardansicht besteht eine **Card** aus einem Titel-Bereich, und einem leeren Inhalts-Bereich.
-Die horizontale Trennlinie zwischen beiden Bereichen setzt KoliBri automatisch.
-
-### Titel der Card-Komponente
-
-Den Titel der Card bestimmen Sie durch Setzen des Attributs **`_label`**. Hier können Sie beliebigen Text, auch Sonderzeichen und Umlaute, eingeben.
-Beachten Sie, dass **HTML-Code** nicht erlaubt ist. Sofern nicht gesetzt werden drei Punkte dargestellt.
-Die Überschriftenebene des Titels wird durch das Attribut **`_level`** übergeben. Möglich sind die Level **1** bis **6**
-
-### Inhalts-Container
-
-Die Inhalte im Content-Bereich der Card bestimmen Sie durch Einfügen eines **Inhalts-Containers** innerhalb des `<kol-card></kol-card>-Elements`. Hier können Sie beliebigen **HTML-Code** einfügen.
-
-Bitte beachten Sie, dass Sie zwar ein beliebiges HTML-Tag als Inhalts-Container verwenden können, es aber empfohlen wird ein `<div></div>`-Tag zu verwenden.
-
-```html
-<kol-card _label="Beispiel" _level="1">
-	<div>Text im Inhalts-Bereich</div>
-</kol-card>
-```
-
-### Best practices
-
-- Verwenden Sie die **Card**-Komponente, um in sich geschlossene Themenbereiche optisch zu kapseln.
-- Verwenden Sie die **Card**-Komponente, um Ihre Inhalte semantisch zu strukturieren.
-- Vermeiden Sie, zu viele Cards auf einer Inhaltsseite zu verwenden.
-- Vermeiden Sie, wichtige Inhalte innerhalb der Card-Komponente zu platzieren, wenn sich die zugehörigen Aktions-Elemente (Buttons, Links, etc.) nicht innerhalb der gleichen Card befinden.
+# kol-card
 
 <!-- Auto Generated Below -->
 

package/doc/combobox.md

@@ -1,53 +1,4 @@
-# Combobox `preview`
-
-Synonyme: Autocomplete, Select, Dropdown
-
-<kol-alert _type="warning" _variant="card">
-  <kol-badge _color="#476af5" _label="Preview"></kol-badge> Diese neue Komponente wird als ungetestet markiert, da die Barrierefreiheitstests noch ausstehen. Die verschiedenen Tests können aufgrund der Modularität bei neuen Komponenten und Funktionalitäten meist erst nach einem Release erfolgen. Wir empfehlen daher, die Komponente noch nicht in Produktion zu verwenden.
-</kol-alert>
-
-Die **Combobox**-Komponente erzeugt eine Auswahlliste, die ein Eingabefeld mit einer darunter angezeigten Liste von auswählbaren Optionen kombiniert.
-
-## Konstruktion
-
-### Code
-
-```html
-<kol-combobox _suggestions="['Herr','Frau','Firma']" _label="Anrede" _value="Herr"></kol-combobox>
-```
-
-### Beispiel
-
-<kol-combobox  _suggestions="['Herr','Frau','Firma']" _label="Anrede" _value="Herr"></kol-combobox>
-
-## Verwendung
-
-Die Auswahlmöglichkeiten werden über das Attribut **`_suggestions`** als JSON-Array an die Komponente übergeben.
-
-Beispiel für die Konstruktion des JSON-Array:
-
-```json
-["Herr", "Frau", "Firma"]
-```
-
-<!--### Best practices-->
-
-<!-- ## Barrierefreiheit -->
-
-### Tastatursteuerung
-
-| Taste                          | Funktion                                                                                                                                                                                            |
-| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `Tab`                          | Fokussiert das Auswahlfeld.                                                                                                                                                                         |
-| `Enter`                        | Wenn die Listbox geöffnet ist und eine Option fokussiert ist, wählt diese Funktion die fokussierte Option aus und schließt die Listbox. Wenn keine Optionfokussiert ist, öffnet es nur die Listbox. |
-| `Pfeil nach unten (ArrowDown)` | Öffnet die Listbox, wenn sie geschlossen ist, und bewegt den visuellen Fokus um eine Option nach unten, wenn die Listbox geöffnet ist.                                                              |
-| `Pfeil nach oben (ArrowUp)`    | Öffnet die Listbox, wenn sie geschlossen ist, und bewegt den visuellen Fokus um eine Option nach oben, wenn die Listbox geöffnet ist.                                                               |
-| `Escape (Esc)`                 | Schlißt die Listbox und entfernt den visuellen Fokus von der Combobox, ohne eine Auswahl zu treffen.                                                                                                |
-| `Home`                         | Bewegt den visuellen Fokus auf die erste Option in der Listbox.                                                                                                                                     |
-| `End`                          | Bewegt den visuellen Fokus auf die letzte Option in der Listbox.                                                                                                                                    |
-| `Seite mach oben(PageUp)`      | Springt zehn Optionen nach oben in der Listbox und fokussiert die entsprechende Option.                                                                                                             |
-| `Seite mach unten(PageDown)`   | Springt zehn Optionen nach unten in der Listbox und fokussiert die entsprechende Option.                                                                                                            |
-| `Druckbare Zeichen`            | Fokussiert die erste Option, die mit dem gedrückten Zeichen beginnt.                                                                                                                                |
+# kol-combobox
 
 <!-- Auto Generated Below -->
 

package/doc/details.md

@@ -1,92 +1,4 @@
-# Details
-
-Synonyme: Disclosure, Collapse, Summary Detail
-
-Mit Hilfe der **Detail**-Komponente können weiterführende Informationen zunächst mit einem kurzen Einleitungstext angezeigt werden, die erst nach Klick
-durch die Nutzer:innen auf ein Pfeil-Icon in voller Größe aufgeklappt werden.
-
-Die **Detail**-Komponente stellt sich standardmäßig als einzeiliges Layout-Element dar, das aus einem Pfeil-Icon und einem nachfolgenden,
-kurzen Einleitungstext gebildet wird. Der eigentliche Inhalt der Komponente wird erst nach Klick auf den Kopfbereich nach unten hin geöffnet. Das Pfeil-Icon ändert dabei
-seine Ausrichtung von **_rechts_** nach **_unten_**.
-Analog lässt sich die Komponente auch wieder schließen und der Inhalt damit verbergen.
-
-## Konstruktion
-
-### Code
-
-```html
-<kol-details _label="Nach Laden der Seite geschlossen">
-	Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At
-	vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit
-	amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt.
-</kol-details>
-```
-
-### Beispiel
-
-<kol-details _label="Nach Laden der Seite geschlossen">
-  Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et
-  dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita
-  kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur
-  sadipscing elitr, sed diam nonumy eirmod tempor invidunt.
-</kol-details>
-
-## Verwendung
-
-### Geöffnet anzeigen
-
-Verwenden Sie das Attribut **`_open`**, um die Komponente geöffnet darzustellen.
-
-### Einleitungstext
-
-Verwenden Sie das Attribut **`_label`**, um den Text zu definieren, der als Überschrift angezeigt werden soll.
-
-### Best practices
-
-- Verwenden Sie die **Detail**-Komponente, um ergänzende Inhalte zu einem Hauptthema platzsparend anzuordnen.
-- Die **Detail**-Komponente eignet sich gut für die Realisierung einer FAQ-Seite, wobei die Frage über das Attribut **`_label`** und die Antwort im Inhaltsbereich ausgegeben werden kann.
-- Vermeiden Sie es, wichtige Informationen, die z.B. rechtliche Aspekte betreffen, in einem verborgenen Bereich auszugeben. Es kann nicht sichergestellt werden, dass der Benutzer diese Informationen auch sicher liest.
-- Vermeiden Sie es, zu viele **Detail**-Komponenten zu verwenden, da die Übersichtlichkeit der Seite hierunter leiden kann.
-
-### Anwendungsfälle
-
-#### Details-Komponente innerhalb eines Fließtextes
-
-<div>
-    <p>
-      Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et
-      dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita
-      kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur
-      sadipscing elitr, sed diam nonumy eirmod tempor invidunt.
-    </p>
-    <kol-details _label="Erst nach Klick offen">
-      Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et
-      dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita
-      kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur
-      sadipscing elitr, sed diam nonumy eirmod tempor invidunt.
-    </kol-details>
-    <p>
-      Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et
-      dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita
-      kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur
-      sadipscing elitr, sed diam nonumy eirmod tempor invidunt.
-    </p>
-  </div>
-
-## Barrierefreiheit
-
-- Die **Details**-Komponente bietet sich an, um eine Kontext-sensitive Hilfe für die Barrierefreiheit umzusetzen.
-
-### Tastatursteuerung
-
-| Taste   | Funktion                                        |
-| ------- | ----------------------------------------------- |
-| `Tab`   | Fokussiert die Details-Komponente.              |
-| `Enter` | Öffnet bzw. schließt den Inhalt der Komponente. |
-
-## Links und Referenzen
-
-- <kol-link _href="https://www.w3.org/TR/UNDERSTANDING-WCAG20/minimize-error-context-help.html" _target="_blank"></kol-link>
+# kol-details
 
 <!-- Auto Generated Below -->
 

package/doc/drawer.md

@@ -1,129 +1,4 @@
-Synonyme: Modal, Modal Dialog, Corner Dialog, Prompt
-
-<kol-alert _type="warning" _variant="card">
-  <kol-badge _color="#476af5" _label="Preview"></kol-badge> Diese neue Komponente wird als ungetestet markiert, da die Barrierefreiheitstests noch ausstehen. Die verschiedenen Tests können aufgrund der Modularität bei neuen Komponenten und Funktionalitäten meist erst nach einem Release erfolgen. Wir empfehlen daher, die Komponente noch nicht in Produktion zu verwenden.
-</kol-alert>
-
-Mithilfe der **Drawer**-Komponente können zusätzliche Informationen oder auch Navigationselemente in einem ausklappbaren Seitenfenster angezeigt werden. Ein offener Drawer kann als Modal (`_modal`) via ESC geschlossen werden.
-
-Die **Drawer**-Komponente ist standardmäßig versteckt. Sie wird i.d.R. erst nach Klick auf einen Button oder sonstigem Trigger angezeigt bzw. controlled mit dem Attribut `_open` gesteuert.
-
-```html
-<kol-drawer _label="Drawer" _open _modal _align="top"></kol-drawer>
-```
-
-### Beispiel
-
-#### Uncontrolled
-
-Im _Uncontrolled_-Modus wird der Drawer über die Methoden `open()` und `close()` gesteuert.
-
-```html
-<kol-drawer id="example-drawer" _align="left" _label="Drawer">
-	<div>
-		<p>Dies ist der Inhalt des Drawers. Hier können Sie beliebige HTML-Elemente einfügen.</p>
-		<kol-button class="close-drawer" _label="Schließen"></kol-button>
-	</div>
-</kol-drawer>
-<kol-button id="drawer-open-button" _label="Drawer öffnen"></kol-button>
-
-<script>
-	const drawer = document.querySelector('#example-drawer');
-	const drawerOpenButton = document.querySelector('#drawer-open-button');
-
-	function openDrawer() {
-		drawer.open();
-	}
-
-	function closeDrawer() {
-		drawer.close();
-	}
-
-	document.querySelectorAll('.close-drawer').forEach((b) => (b.onclick = closeDrawer));
-	drawerOpenButton.onclick = openDrawer;
-</script>
-```
-
-#### Uncontrolled Modal
-
-```html
-<kol-drawer _modal _align="left" _label="Drawer">
-	<p>Drawer Inhalt</p>
-</kol-drawer>
-```
-
-#### Controlled
-
-Im _Controlled_-Modus wird der Drawer über das `_open` Attribut gesteuert.
-
-```html
-<kol-drawer _open="true" _align="left" _label="Drawer">
-	<p>Drawer Inhalt</p>
-</kol-drawer>
-```
-
-## Verwendung
-
-Um den **Drawer** programmgesteuert zu öffnen und zu schließen, verwenden Sie die Methoden **`open()`** und **`close()`**. Stellen Sie sicher, dass das **`_label`** Attribut gesetzt ist, um die Zugänglichkeit zu gewährleisten. Die Ausrichtung des Drawers können Sie mit dem **`_align`** Attribut und den Werten **left**, **top**, **right** oder **bottom** anpassen, um ihn auf der gewünschten Seite des Bildschirms anzuzeigen. Wenn Sie den **Drawer** als **Modal** verwenden möchten, aktivieren Sie das **`_modal`** Attribut, um den Hintergrund abzudunkeln und den Fokus auf den Drawer-Inhalt zu lenken. Zudem nutzen Sie das **`_on`** Attribut, um benutzerdefinierte Aktionen beim Schließen des Drawers auszuführen. Ein offenes **Modal** kann via **ESC** geschlossen werden.
-
-## Barrierefreiheit
-
-Das `_label` Attribut stellt eine klare und verständliche Beschriftung für den Drawer bereit. Dies verbessert die Nutzung für Personen, die Screenreader verwenden, da das Label als **`aria-label`** fungiert und somit die Bedeutung und Funktion des Drawers erklärt.
-
-### Drawer als Modal
-
-Beim Öffnen des **Drawers** wird der Fokus automatisch auf den Inhalt des Drawers gesetzt. Dies stellt sicher, dass Benutzer von Screenreadern sofort wissen, dass ein neuer Bereich geöffnet wurde, und dass sie direkt interagieren können. Beim Schließen des Drawers wird der Fokus zum vorherigen aktiven Element zurückgeführt, was eine nahtlose Benutzererfahrung bietet.
-
-Die **Drawer**-Komponente unterstützt die vollständige Navigation über die Tastatur. Benutzer können mit der Tab-Taste durch die interaktiven Elemente innerhalb des Drawers navigieren. Zudem kann der **Drawer** mit der ESC-Taste schnell und einfach geschlossen werden, was die Bedienung erleichtert.
-
-Während der **Drawer** (als Modal) geöffnet ist, werden alle selektierbaren Elemente außerhalb des Drawers deaktiviert. Dies verhindert ungewollte Interaktionen mit dem Hintergrundinhalt und lenkt die Aufmerksamkeit der Benutzer auf den **Drawer**-Inhalt.
-
-### Tastatursteuerung
-
-| Taste       | Funktion                                                                                     |
-| ----------- | -------------------------------------------------------------------------------------------- |
-| `Tab`       | Bei geöffnetem Drawer werden alle fokussierbaren Elemente der Reihenfolge nach angesprungen. |
-| `ESC-Taste` | Schließt den Drawer.                                                                         |
-
-## Animationen
-
-Optional können Animationen mit Keyframes hinzugefügt werden. Dabei ist es wichtig, dass die Keyframes die Namen `slideIn` bzw. `slideOut` enthalten und auf der Klasse `drawer__wrapper` definiert werden.
-
-**Beispiel:**
-
-```scss
-.drawer__wrapper {
-	&--left {
-		animation: slideInLeft $duration forwards;
-		&.is-closing {
-			animation: slideOutLeft $duration forwards !important;
-		}
-	}
-	&--right {
-		animation: slideInRight $duration forwards;
-		&.is-closing {
-			animation: slideOutRight $duration forwards;
-		}
-	}
-	&--top {
-		animation: slideInTop $duration forwards;
-		&.is-closing {
-			animation: slideOutTop $duration forwards;
-		}
-	}
-	&--bottom {
-		animation: slideInBottom $duration forwards;
-		&.is-closing {
-			animation: slideOutBottom $duration forwards;
-		}
-	}
-}
-```
-
-## Links und Referenzen
-
-- <kol-link _href="https://developer.mozilla.org/en-US/docs/Web/HTML/Element/dialog" _target="_blank"></kol-link>
-- <kol-link _href="https://developer.mozilla.org/en-US/docs/Web/CSS/@keyframes" _target="_blank"></kol-link>
+# kol-drawer
 
 <!-- Auto Generated Below -->
 

package/doc/form.md

@@ -1,24 +1,4 @@
-# Form
-
-Die **Form**-Komponente dient dazu alle Eingabefelder zu umschließen, den Hinweistext für Pflichtfelder korrekt zu positionieren und die Events `submit` und `reset` weiterzuleiten.
-
-## Konstruktion
-
-### Code
-
-```html
-<kol-form _requiredText="Sternchen heißt Pflichtfeld.">
-	<kol-input-text _label="Vorname"></kol-input-text>
-	<kol-input-text _label="Nachname"></kol-input-text>
-</kol-form>
-```
-
-### Beispiel
-
-<kol-form _requiredText="Sternchen heißt Pflichtfeld.">
-	<kol-input-text _label="Vorname"></kol-input-text>
-	<kol-input-text _label="Nachname"></kol-input-text>
-</kol-form>
+# kol-form
 
 <!-- Auto Generated Below -->
 

package/doc/heading.md

@@ -1,37 +1,4 @@
-# Heading
-
-Die **Heading**-Komponente kann überall dort verwendet werden, wo eine Überschrift angezeigt werden soll. Durch die Verwendung der unterschiedlichen Größen, lassen sich Inhalte klar strukturieren und Seiten wirkungsvoll und abwechslungsreich präsentieren. Sie trennt Styling von Semantik und ermöglicht Flexibilität.
-
-## Konstruktion
-
-### Code
-
-```html
-<kol-heading _level="1" _label="Inhalt einer H1-Überschrift"></kol-heading>
-<kol-heading _level="2" _label="Inhalt einer H2-Überschrift"></kol-heading>
-<kol-heading _level="3" _label="Inhalt einer H3-Überschrift"></kol-heading>
-<kol-heading _level="4" _label="Inhalt einer H4-Überschrift"></kol-heading>
-<kol-heading _level="5" _label="Inhalt einer H5-Überschrift"></kol-heading>
-<kol-heading _level="6" _label="Inhalt einer H6-Überschrift"></kol-heading>
-```
-
-### Beispiel
-
-<kol-heading _level="1" _label="Inhalt einer H1-Überschrift"></kol-heading>
-<kol-heading _level="2" _label="Inhalt einer H2-Überschrift"></kol-heading>
-<kol-heading _level="3" _label="Inhalt einer H3-Überschrift"></kol-heading>
-<kol-heading _level="4" _label="Inhalt einer H4-Überschrift"></kol-heading>
-<kol-heading _level="5" _label="Inhalt einer H5-Überschrift"></kol-heading>
-<kol-heading _level="6" _label="Inhalt einer H6-Überschrift"></kol-heading>
-
-## Verwendung
-
-Die Überschriftenebene wird durch das Attribut **`_level`** übergeben. Möglich sind die Level **1** bis **6**
-
-### Best practices
-
-- Achten Sie bei der Verwendung von Headings auf die empfohlene Semantik für die Suchmaschinenoptimierung.
-- Setzen Sie Headings in verschiedenen Größen ein, um eine sinnvolle Struktur Ihrer Inhalte zu erzeugen.
+# kol-heading
 
 <!-- Auto Generated Below -->
 
@@ -41,16 +8,16 @@ Die Überschriftenebene wird durch das Attribut **`_level`** übergeben. Möglic
 | Property              | Attribute             | Description                                                                                                                                                  | Type                                                                    | Default     |
 | --------------------- | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------- | ----------- |
 | `_label` _(required)_ | `_label`              | Defines the visible or semantic label of the component (e.g. aria-label, label, headline, caption, summary, etc.). Set to `false` to enable the expert slot. | `string`                                                                | `undefined` |
-| `_level`              | `_level`              | Defines which H-level from 1-6 the heading has. 0 specifies no heading and is shown as bold text.                                                            | `0` \| `1` \| `2` \| `3` \| `4` \| `5` \| `6` \| `undefined`                          | `undefined` |
+| `_level`              | `_level`              | Defines which H-level from 1-6 the heading has. 0 specifies no heading and is shown as bold text.                                                            | `0` \| `1` \| `2` \| `3` \| `4` \| `5` \| `6` \| `undefined`                          | `1`         |
 | `_secondaryHeadline`  | `_secondary-headline` | Defines the text of the secondary headline.                                                                                                                  | `string` \| `undefined`                                                   | `undefined` |
 | `_variant`            | `_variant`            | Defines which variant should be used for presentation.                                                                                                       | `"h1"` \| `"h2"` \| `"h3"` \| `"h4"` \| `"h5"` \| `"h6"` \| `"strong"` \| `undefined` | `undefined` |
 
 
 ## Slots
 
-| Slot         | Description              |
-| ------------ | ------------------------ |
-| `"headline"` | Content of the headline. |
+| Slot | Description             |
+| ---- | ----------------------- |
+|      | Inhalt der Überschrift. |
 
 
 ----------------------------------------------

package/doc/icon.md

@@ -1,46 +1,4 @@
-# Icon
-
-Mit Hilfe der **Icon**-Komponente können Icons aus eingebundenen Icon-Fonts an beliebigen Positionen dargestellt werden. Die Ausgabe des Icon kann über das Attribut **`_icon`** gesteuert werden und erfolgt durch das Attribut **`_label`** barrierefrei. Die Ausgabe erfolgt standardmäßig als _`inline`_-Element.
-
-Aktuell werden die Icons von <kol-link _href="https://microsoft.github.io/vscode-codicons/dist/codicon.html" _target="_blank" _label="Codicons"></kol-link> unterstützt.
-
-<kol-alert _heading="Hinweis" _type="info">Es ist wichtig, dass in der Rahmenseite (`index.html`) die CSS-Dateie(n) der Icon-Font(s) eingebunden ist/sind.</kol-alert>
-
-## Konstruktion
-
-Die Komponente **Icon** wird über das HTML-Tag `kol-icon` erzeugt.
-
-### Code
-
-```html
-<kol-icon _label="Zu Hause" _icons="codicon codicon-home"></kol-icon>
-```
-
-### Beispiel
-
-<kol-icon _label="Zu Hause" _icons="codicon codicon-home"></kol-icon>
-
-### Icons
-
-Die Property `_icons` erwartet einen String mit den Klassennamen der zu zeigenden Icons (z.B.: `_icons="codicon codicon-home`).
-
-<kol-link _href="https://microsoft.github.io/vscode-codicons/dist/codicon.html" _target="_blank" _label="Übersicht Codicons"></kol-link>
-
-## Barrierefreiheit
-
-Wichtig ist bei Kontext-relevanten Grafiken, dass sie beschriftet werden.
-
-- <kol-link _href="https://www.w3.org/WAI/ARIA/apg/practices/names-and-descriptions/"></kol-link>
-
-### Label
-
-Mittels der Property `_label` muss ein Kontext-relevantes Icon beschriftet werden.
-
-## Links und Referenzen
-
-- <kol-link _href="https://github.com/microsoft/vscode-codicons" _target="_blank" _label="Codicons"></kol-link>
-- <kol-link _href="https://fontawesome.com" _target="_blank" _label="Font-Awesome"></kol-link>
-- <kol-link _href="https://icofont.com"  _target="_blank" _label="Icofont"></kol-link>
+# kol-icon
 
 <!-- Auto Generated Below -->