@getflip/swirl-ai 0.448.0

package/dist/agent/components/swirl-symbol.md

@@ -0,0 +1,54 @@
+# `<swirl-symbol>`
+
+## Purpose
+
+Symbols are user selectable glyphs used to represent resources like menu items.
+
+## Required props
+
+- `glyph` (string) – 
+
+## Optional props
+
+- `size` (16 | 20 | 24 | 28 | 32 | undefined) – 
+
+## Slots
+
+_None._
+
+## Events
+
+_None._
+
+## Methods
+
+_None._
+
+## Related components
+
+No related components.
+
+## Accessibility
+
+SwirlSymbol is a presentational icon component with no ARIA attributes or
+keyboard-specific behavior. When used as the only content of a button or link,
+ensure the parent provides an accessible label.
+
+### Keyboard
+
+No component-specific keyboard behavior.
+
+## Minimal example
+
+```html
+<swirl-symbol glyph="..."></swirl-symbol>
+```
+
+## Usage example
+
+_No usage example in docs._
+
+## Common mistakes
+
+- Ensure required props are set.
+- Use only allowed slot names and child components where documented.

package/dist/agent/components/swirl-tab-bar.md

@@ -0,0 +1,89 @@
+# `<swirl-tab-bar>`
+
+## Purpose
+
+The SwirlTabBar component is used to render the tabs navigation of the [SwirlTabs](?path=/docs/components-swirltabs--docs) component. You can use it standalone in combination with the [SwirlTab](?path=/docs/components-swirltab--docs) components, if you want to implement your own tab handling.
+
+## Required props
+
+- `label` (string) – 
+
+## Optional props
+
+- `disableTabSemantics` (boolean | undefined) – 
+- `justify` ("evenly" | "start" | undefined) – 
+- `paddingBlockEnd` ("0" | "12" | "16" | "2" | "20" | "24" | "4" | "8" | undefined) – 
+- `paddingBlockStart` ("0" | "12" | "16" | "2" | "20" | "24" | "4" | "8" | undefined) – 
+- `paddingInlineEnd` ("0" | "12" | "16" | "2" | "20" | "24" | "4" | "8" | undefined) – 
+- `paddingInlineStart` ("0" | "12" | "16" | "2" | "20" | "24" | "4" | "8" | undefined) – 
+- `variant` ("default" | "pill" | undefined) – 
+- `tabs` (SwirlTabBarTab[] | undefined) – 
+
+## Slots
+
+_None._
+
+## Events
+
+- `activateNextTab` – CustomEvent<void>
+- `activatePreviousTab` – CustomEvent<void>
+- `activateTab` – CustomEvent<string>
+
+## Methods
+
+_None._
+
+## Related components
+
+- **[swirl-tabs](?path=/docs/components-swirltabs--docs)** (parent) — Tab
+  container; `swirl-tab-bar` is typically used inside `swirl-tabs` to render the
+  tab strip.
+- **[swirl-tab](?path=/docs/components-swirltab--docs)** (sibling) — Tab panels;
+  use alongside `swirl-tab-bar` when building a tabbed UI.
+
+## Accessibility
+
+See [SwirlTabs](?path=/docs/components-swirltabs--docs).
+
+### Keyboard
+
+Keyboard behavior is defined by SwirlTabs (e.g. arrow keys for tab navigation).
+
+## Minimal example
+
+```html
+<swirl-tab-bar label="..."></swirl-tab-bar>
+```
+
+## Usage example
+
+```html
+<swirl-tab-bar
+    tabs='[
+    {
+      active: false,
+      id: "tab1",
+      label: "A Tab",
+      suffix: "2",
+    },
+    {
+      active: true,
+      icon: &apos;<swirl-icon glyph="emoji-mood" size="20"></swirl-icon>&apos;,
+      id: "tab2",
+      label: "Another Tab",
+      suffix: "12",
+    },
+    {
+      active: false,
+      icon: &apos;<swirl-icon glyph="emoji-satisfied" size="20"></swirl-icon>&apos;,
+      id: "tab3",
+      label: "Yet Another Tab",
+    },
+  ]'
+></swirl-tab-bar>
+```
+
+## Common mistakes
+
+- Ensure required props are set.
+- Use only allowed slot names and child components where documented.

package/dist/agent/components/swirl-tab.md

@@ -0,0 +1,69 @@
+# `<swirl-tab>`
+
+## Purpose
+
+The SwirlTab component is used to display a tab panel inside the [SwirlTabs component](?path=/docs/components-swirltabs--docs).
+
+## Required props
+
+- `label` (string) – 
+- `tabId` (string) – 
+
+## Optional props
+
+- `active` (boolean | undefined) – 
+- `icon` (string | undefined) – 
+- `padding` ("0" | "12" | "16" | "2" | "20" | "24" | "4" | "8" | undefined) – 
+
+## Slots
+
+_None._
+
+## Events
+
+_None._
+
+## Methods
+
+_None._
+
+## Related components
+
+- **[swirl-tabs](?path=/docs/components-swirltabs--docs)** (parent) — Tab
+  container; use `swirl-tab` as a direct child of `swirl-tabs`.
+
+## Accessibility
+
+### ARIA
+
+The component follows the
+[WAI-ARIA Tabs Pattern](https://www.w3.org/WAI/ARIA/apg/patterns/tabpanel/).
+
+| ARIA              | Usage                                                        |
+| ----------------- | ------------------------------------------------------------ |
+| `role="tabpanel"` |                                                              |
+| `aria-labelledby` | Set on each tab panel to associate it with its tab bar item. |
+
+### Keyboard
+
+Keyboard behavior is defined by SwirlTabs / SwirlTabBar (e.g. arrow keys for tab
+focus).
+
+## Minimal example
+
+```html
+<swirl-tab label="..." tabId="..."></swirl-tab>
+```
+
+## Usage example
+
+```html
+<swirl-tab active icon='<swirl-icon glyph="emoji-satisfied" size="20"></swirl-icon>' label="Label" tab-id="tab-id">
+    <swirl-text>Content</swirl-text>
+</swirl-tab>
+```
+
+## Common mistakes
+
+- Ensure required props are set.
+- Use only allowed slot names and child components where documented.

package/dist/agent/components/swirl-table-cell.md

@@ -0,0 +1,62 @@
+# `<swirl-table-cell>`
+
+## Purpose
+
+The SwirlTableColumn component is used to display a cell inside a [SwirlTableRow component](?path=/docs/components-swirltablerow--docs).
+
+## Required props
+
+_None._
+
+## Optional props
+
+_None._
+
+## Slots
+
+- **`slot`** – The cell content.
+
+## Events
+
+_None._
+
+## Methods
+
+_None._
+
+## Related components
+
+- **[swirl-table-row](?path=/docs/components-swirltablerow--docs)** (parent) —
+  Table row; use `swirl-table-cell` as a direct child of `swirl-table-row`.
+
+## Accessibility
+
+### ARIA
+
+The component follows the
+[WAI-ARIA Table Pattern](https://www.w3.org/WAI/ARIA/apg/patterns/table/).
+
+| ARIA          | Usage |
+| ------------- | ----- |
+| `role="cell"` |       |
+
+### Keyboard
+
+No component-specific keyboard behavior.
+
+## Minimal example
+
+```html
+<swirl-table-cell></swirl-table-cell>
+```
+
+## Usage example
+
+```html
+<swirl-table-cell> Table cell </swirl-table-cell>
+```
+
+## Common mistakes
+
+- Ensure required props are set.
+- Use only allowed slot names and child components where documented.

package/dist/agent/components/swirl-table-column.md

@@ -0,0 +1,69 @@
+# `<swirl-table-column>`
+
+## Purpose
+
+The SwirlTableColumn component is used to display a column inside a [SwirlTable component](?path=/docs/components-swirltable--docs).
+
+## Required props
+
+_None._
+
+## Optional props
+
+- `maxWidth` (string | undefined) – 
+- `minWidth` (string | undefined) – 
+- `sort` ("ascending" | "descending" | undefined) – 
+- `sortable` (boolean | undefined) – 
+- `sticky` (boolean | undefined) – 
+- `variant` ("default" | "raised" | "sunken" | undefined) – 
+- `width` (string | undefined) – 
+
+## Slots
+
+- **`slot`** – The column label.
+
+## Events
+
+_None._
+
+## Methods
+
+_None._
+
+## Related components
+
+- **[swirl-table](?path=/docs/components-swirltable--docs)** (parent) — Table
+  container; use `swirl-table-column` in the `columns` slot of `swirl-table`.
+
+## Accessibility
+
+### ARIA
+
+The component follows the
+[WAI-ARIA Table Pattern](https://www.w3.org/WAI/ARIA/apg/patterns/table/).
+
+| ARIA                  | Usage                   |
+| --------------------- | ----------------------- |
+| `role="columnheader"` |                         |
+| `aria-sort`           | Set on a sorted column. |
+
+### Keyboard
+
+No component-specific keyboard behavior.
+
+## Minimal example
+
+```html
+<swirl-table-column></swirl-table-column>
+```
+
+## Usage example
+
+```html
+<swirl-table-column></swirl-table-column>
+```
+
+## Common mistakes
+
+- Ensure required props are set.
+- Use only allowed slot names and child components where documented.

package/dist/agent/components/swirl-table-row-group.md

@@ -0,0 +1,69 @@
+# `<swirl-table-row-group>`
+
+## Purpose
+
+The SwirlTableColumn component is used to group multiple rows of a [SwirlTable component](?path=/docs/components-swirltable--docs).
+
+## Required props
+
+- `label` (string) – 
+
+## Optional props
+
+- `collapseButtonLabel` (string | undefined) – 
+- `collapsible` (boolean | undefined) – 
+- `tooltip` (string | undefined) – 
+
+## Slots
+
+- **`slot`** – The rows of this group.
+
+## Events
+
+_None._
+
+## Methods
+
+_None._
+
+## Related components
+
+- **[swirl-table](?path=/docs/components-swirltable--docs)** (parent) — Table
+  container; use `swirl-table-row-group` in the `rows` slot of `swirl-table`.
+- **[swirl-table-row](?path=/docs/components-swirltablerow--docs)** (child) —
+  Table rows; use as direct children of this component.
+
+## Accessibility
+
+### ARIA
+
+The component follows the
+[WAI-ARIA Table Pattern](https://www.w3.org/WAI/ARIA/apg/patterns/table/).
+
+| ARIA               | Usage                                      |
+| ------------------ | ------------------------------------------ |
+| `role="rowgroup"`  |                                            |
+| `role="row"`       | Set on a the groups row element.           |
+| `role="rowheader"` | Set on the header cell element.            |
+| `aria-colspan`     | Set to the amount of columns of the table. |
+
+### Keyboard
+
+No component-specific keyboard behavior.
+
+## Minimal example
+
+```html
+<swirl-table-row-group label="..."></swirl-table-row-group>
+```
+
+## Usage example
+
+```html
+<swirl-table-row-group label="Table row group"></swirl-table-row-group>
+```
+
+## Common mistakes
+
+- Ensure required props are set.
+- Use only allowed slot names and child components where documented.

package/dist/agent/components/swirl-table-row.md

@@ -0,0 +1,74 @@
+# `<swirl-table-row>`
+
+## Purpose
+
+The SwirlTableColumn component is used to display a row inside a [SwirlTable component](?path=/docs/components-swirltable--docs).
+
+## Required props
+
+_None._
+
+## Optional props
+
+- `highlighted` (boolean | undefined) – 
+- `index` (number | undefined) – 
+
+## Slots
+
+- **`slot`** – The cells of this row.
+
+## Events
+
+_None._
+
+## Methods
+
+_None._
+
+## Related components
+
+- **[swirl-table](?path=/docs/components-swirltable--docs)** (parent) — Table
+  container; use `swirl-table-row` in the `rows` slot of `swirl-table` or inside
+  `swirl-table-row-group`.
+- **[swirl-table-cell](?path=/docs/components-swirltablecell--docs)** (child) —
+  Table cells; use as direct children of `swirl-table-row`.
+
+## Accessibility
+
+### ARIA
+
+The component follows the
+[WAI-ARIA Table Pattern](https://www.w3.org/WAI/ARIA/apg/patterns/table/).
+
+| ARIA            | Usage                                                 |
+| --------------- | ----------------------------------------------------- |
+| `role="row"`    |                                                       |
+| `aria-rowindex` | Set to the overall index of the row inside the table. |
+
+### Keyboard
+
+No component-specific keyboard behavior.
+
+## Minimal example
+
+```html
+<swirl-table-row></swirl-table-row>
+```
+
+## Usage example
+
+```html
+<swirl-table-row>
+    <swirl-table-cell>
+        <swirl-text size="sm">Cell</swirl-text>
+    </swirl-table-cell>
+    <swirl-table-cell>
+        <swirl-text size="sm">Cell</swirl-text>
+    </swirl-table-cell>
+</swirl-table-row>
+```
+
+## Common mistakes
+
+- Ensure required props are set.
+- Use only allowed slot names and child components where documented.

package/dist/agent/components/swirl-table.md

@@ -0,0 +1,204 @@
+# `<swirl-table>`
+
+## Purpose
+
+The SwirlTable component is used to organize and display data sets.
+
+## Required props
+
+- `label` (string) – 
+
+## Optional props
+
+- `caption` (string | undefined) – 
+- `dragDropHandle` (string | undefined) – 
+- `emptyStateLabel` (string | undefined) – 
+- `enableDragDrop` (boolean | undefined) – 
+- `loading` (boolean | undefined) – 
+- `dragDropInstructions` ({ end: string; initial: string; moved: string; start: string; } | undefined) – 
+
+## Slots
+
+- **`columns`** – Column container, should contain SwirlTableColumns.
+- **`empty`** – Optional. Rendered in place of the `emptyStateLabel` when no rows are present.
+- **`rows`** – Row container, should contain SwirlTableRows.
+
+## Events
+
+- `dropRow` – CustomEvent<Pick<SortableEvent, "oldIndex" | "newIndex" | "item"> & { itemId: string; newNextSiblingItemId: string; newPrevSiblingItemId: string; }>
+
+## Methods
+
+- `rerender()` – Force a re-render of the table
+
+## Related components
+
+- **[swirl-table-column](?path=/docs/components-swirltablecolumn--docs)**
+  (child) — Column definitions; use in the `columns` slot of `swirl-table`.
+- **[swirl-table-row-group](?path=/docs/components-swirltablerowgroup--docs)**
+  (child) — Optional row grouping; use in the `rows` slot of `swirl-table`.
+- **[swirl-table-row](?path=/docs/components-swirltablerow--docs)** (child) —
+  Table rows; use in the `rows` slot of `swirl-table` or inside
+  `swirl-table-row-group`.
+
+## Accessibility
+
+### ARIA
+
+The component follows the
+[WAI-ARIA Table Pattern](https://www.w3.org/WAI/ARIA/apg/patterns/table/).
+
+| ARIA                  | Usage                                                           |
+| --------------------- | --------------------------------------------------------------- |
+| `role="table"`        | Set on the outer table element.                                 |
+| `aria-rowcount`       | Set to the overall row count.                                   |
+| `aria-label`          | An accessible label is provided via the `aria-label` attribute. |
+| `role="rowgroup"`     | Set on the table's header and body elements.                    |
+| `role="columnheader"` | Set on the table's column element.                              |
+| `aria-sort`           | Set on a sorted table column.                                   |
+| `role="row"`          | Set on a the table's row elements.                              |
+| `aria-rowindex`       | Set to the overall index of the row element.                    |
+| `role="cell"`         | Set on a the table's cell elements.                             |
+
+### Keyboard
+
+No component-specific keyboard behavior; table navigation depends on host or
+application.
+
+## Minimal example
+
+```html
+<swirl-table label="..."></swirl-table>
+```
+
+## Usage example
+
+```html
+<swirl-table
+    caption="A table displaying data."
+    drag-drop-handle=".drag-handle"
+    enable-drag-drop
+    label="Table"
+>
+<div slot="columns">
+      <swirl-table-column sticky width="58px">
+        <swirl-checkbox checked="indeterminate" swirl-aria-label="Select all" input-id="select" input-name="select">
+        </swirl-checkbox><swirl-visually-hidden>Select</swirl-visually-hidden>
+      </swirl-table-column>
+      <swirl-table-column min-width="160px" sticky>User</swirl-table-column>
+      <swirl-table-column>Drag</swirl-table-column>
+      <swirl-table-column min-width="120px">User ID</swirl-table-column>
+      <swirl-table-column min-width="200px" sortable sort="descending">Email</swirl-table-column>
+      <swirl-table-column>Location</swirl-table-column>
+      <swirl-table-column>Logins</swirl-table-column>
+      <swirl-table-column>Latest login</swirl-table-column>
+      <swirl-table-column>User status</swirl-table-column>
+      <swirl-table-column sticky width="74px"><swirl-visually-hidden>Tools</swirl-visually-hidden></swirl-table-column>
+    </div>
+    <div slot="rows">
+      <swirl-table-row id="1">
+        <swirl-table-cell>
+          <swirl-checkbox swirl-aria-label="Select Isabel Lakin" input-id="select-1" input-name="select-1">
+        </swirl-table-cell>
+        <swirl-table-cell>
+          <swirl-text size="sm" weight="medium">Isabel Lakin</swirl-text>
+        </swirl-table-cell>
+        <swirl-table-cell>
+          <swirl-button class="drag-handle" hide-label icon="<swirl-icon-drag-handle></swirl-icon-drag-handle>" label="Drag" variant="plain"></swirl-button>
+        </swirl-table-cell>
+        <swirl-table-cell>
+          <swirl-text size="sm" truncate>1234567890</swirl-text>
+        </swirl-table-cell>
+        <swirl-table-cell>
+          <swirl-text size="sm"><swirl-link href="#" label="isabel.lakin@flipapp.de"></swirl-link></swirl-text>
+        </swirl-table-cell>
+        <swirl-table-cell>
+          <swirl-text size="sm">DE</swirl-text>
+        </swirl-table-cell>
+        <swirl-table-cell>
+          <swirl-text size="sm" truncate>21</swirl-text>
+        </swirl-table-cell>
+        <swirl-table-cell>
+          <swirl-text size="sm">24.11.2022 13:39</swirl-text>
+        </swirl-table-cell>
+        <swirl-table-cell>
+          <swirl-tag label="Active" intent="success"></swirl-tag>
+        </swirl-table-cell>
+        <swirl-table-cell>
+          <swirl-tooltip position="left" content="Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua.">
+            <swirl-button label="Test"></swirl-button>
+          </swirl-tooltip>
+        </swirl-table-cell>
+      </swirl-table-row>
+        <swirl-table-row id="2">
+          <swirl-table-cell>
+            <swirl-checkbox swirl-aria-label="Select Doyle Stoltenberg" input-id="select-2" input-name="select-2">
+          </swirl-table-cell>
+          <swirl-table-cell>
+            <swirl-text size="sm" weight="medium">Doyle Stoltenberg</swirl-text>
+          </swirl-table-cell>
+          <swirl-table-cell>
+            <swirl-button class="drag-handle" hide-label icon="<swirl-icon-drag-handle></swirl-icon-drag-handle>" label="Drag" variant="plain"></swirl-button>
+          </swirl-table-cell>
+          <swirl-table-cell>
+            <swirl-text size="sm" truncate>0987654321</swirl-text>
+          </swirl-table-cell>
+          <swirl-table-cell>
+            <swirl-text size="sm"><swirl-link href="#" label="john.doe@flipapp.de"></swirl-link></swirl-text>
+          </swirl-table-cell>
+          <swirl-table-cell>
+            <swirl-text size="sm">DE</swirl-text>
+          </swirl-table-cell>
+          <swirl-table-cell>
+            <swirl-text size="sm" truncate>432</swirl-text>
+          </swirl-table-cell>
+          <swirl-table-cell>
+            <swirl-text size="sm">24.11.2022 13:39</swirl-text>
+          </swirl-table-cell>
+          <swirl-table-cell>
+            <swirl-tag label="Pending" intent="warning"></swirl-tag>
+          </swirl-table-cell>
+          <swirl-table-cell>
+            <swirl-button hide-label icon="<swirl-icon-more-vertikal></swirl-icon-more-vertikal>" label="Options"></swirl-button>
+          </swirl-table-cell>
+        </swirl-table-row>
+        <swirl-table-row highlighted id="3">
+          <swirl-table-cell>
+            <swirl-checkbox checked="true" swirl-aria-label="Select Don Conroy" input-id="select-3" input-name="select-3">
+          </swirl-table-cell>
+          <swirl-table-cell>
+            <swirl-text size="sm" weight="medium">Don Conroy</swirl-text>
+          </swirl-table-cell>
+          <swirl-table-cell>
+            <swirl-button class="drag-handle" hide-label icon="<swirl-icon-drag-handle></swirl-icon-drag-handle>" label="Drag" variant="plain"></swirl-button>
+          </swirl-table-cell>
+          <swirl-table-cell>
+            <swirl-text size="sm" truncate>5432167890</swirl-text>
+          </swirl-table-cell>
+          <swirl-table-cell>
+            <swirl-text size="sm"><swirl-link href="#" label="don.conroy@flipapp.de"></swirl-link></swirl-text>
+          </swirl-table-cell>
+          <swirl-table-cell>
+            <swirl-text size="sm">DE</swirl-text>
+          </swirl-table-cell>
+          <swirl-table-cell>
+            <swirl-text size="sm" truncate>0</swirl-text>
+          </swirl-table-cell>
+          <swirl-table-cell>
+            <swirl-text size="sm">-</swirl-text>
+          </swirl-table-cell>
+          <swirl-table-cell>
+            <swirl-tag label="Pending" intent="warning"></swirl-tag>
+          </swirl-table-cell>
+          <swirl-table-cell>
+            <swirl-button hide-label icon="<swirl-icon-more-vertikal></swirl-icon-more-vertikal>" label="Options"></swirl-button>
+          </swirl-table-cell>
+        </swirl-table-row>
+      </div>
+</swirl-table>
+```
+
+## Common mistakes
+
+- Ensure required props are set.
+- Use only allowed slot names and child components where documented.