@getflip/swirl-ai 0.448.0

package/dist/agent/components/swirl-file-viewer-fallback.md

@@ -0,0 +1,51 @@
+# `<swirl-file-viewer-fallback>`
+
+## Purpose
+
+Custom element: swirl-file-viewer-fallback.
+
+## Required props
+
+- `file` (string) – 
+
+## Optional props
+
+- `disableDownload` (boolean | undefined) – 
+- `downloadButtonLabel` (string | undefined) – 
+- `fileName` (string | undefined) – 
+
+## Slots
+
+_None._
+
+## Events
+
+- `activate` – CustomEvent<HTMLElement>
+- `download` – CustomEvent<void>
+
+## Methods
+
+_None._
+
+## Related components
+
+_See description for usage context._
+
+## Accessibility
+
+_See full docs for accessibility details._
+
+## Minimal example
+
+```html
+<swirl-file-viewer-fallback file="..."></swirl-file-viewer-fallback>
+```
+
+## 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-file-viewer-image.md

@@ -0,0 +1,51 @@
+# `<swirl-file-viewer-image>`
+
+## Purpose
+
+Custom element: swirl-file-viewer-image.
+
+## Required props
+
+- `file` (string) – 
+
+## Optional props
+
+- `description` (string | undefined) – 
+- `errorMessage` (string | undefined) – 
+- `maxZoom` (number | undefined) – 
+
+## Slots
+
+- **`watermark`** – Optional watermark image to be displayed in the bottom left corner.
+
+## Events
+
+- `activate` – CustomEvent<HTMLElement>
+
+## Methods
+
+- `getZoom()` – Get the current zoom.
+- `resetZoom()` – Resets the zoom.
+
+## Related components
+
+_See description for usage context._
+
+## Accessibility
+
+_See full docs for accessibility details._
+
+## Minimal example
+
+```html
+<swirl-file-viewer-image file="..."></swirl-file-viewer-image>
+```
+
+## 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-file-viewer-pdf.md

@@ -0,0 +1,57 @@
+# `<swirl-file-viewer-pdf>`
+
+## Purpose
+
+Custom element: swirl-file-viewer-pdf.
+
+## Required props
+
+- `file` (string) – 
+- `singlePageMode` (boolean) – 
+
+## Optional props
+
+- `errorMessage` (string | undefined) – 
+- `viewMode` ("side-by-side" | "single" | undefined) – 
+- `workerSrc` (string | undefined) – 
+- `zoom` ("auto" | number | undefined) – 
+
+## Slots
+
+_None._
+
+## Events
+
+- `activate` – CustomEvent<HTMLElement>
+- `visiblePagesChange` – CustomEvent<number[]>
+
+## Methods
+
+- `getThumbnails()` – Get thumbnails of all pages.
+- `nextPage()` – Navigate to next page, if single page mode is enabled.
+- `previousPage()` – Navigate to previous page, if single page mode is enabled.
+- `print()` – Print the file.
+- `setPage()` – Navigate to specific page, if single page mode is enabled.
+
+## Related components
+
+_See description for usage context._
+
+## Accessibility
+
+_See full docs for accessibility details._
+
+## Minimal example
+
+```html
+<swirl-file-viewer-pdf file="..."></swirl-file-viewer-pdf>
+```
+
+## 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-file-viewer-text.md

@@ -0,0 +1,48 @@
+# `<swirl-file-viewer-text>`
+
+## Purpose
+
+Custom element: swirl-file-viewer-text.
+
+## Required props
+
+- `file` (string) – 
+
+## Optional props
+
+- `errorMessage` (string | undefined) – 
+
+## Slots
+
+_None._
+
+## Events
+
+- `activate` – CustomEvent<HTMLElement>
+
+## Methods
+
+_None._
+
+## Related components
+
+_See description for usage context._
+
+## Accessibility
+
+_See full docs for accessibility details._
+
+## Minimal example
+
+```html
+<swirl-file-viewer-text file="..."></swirl-file-viewer-text>
+```
+
+## 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-file-viewer-video.md

@@ -0,0 +1,49 @@
+# `<swirl-file-viewer-video>`
+
+## Purpose
+
+Custom element: swirl-file-viewer-video.
+
+## Required props
+
+- `file` (string) – 
+
+## Optional props
+
+- `autoplay` (boolean | undefined) – 
+- `disableDownload` (boolean | undefined) – 
+
+## Slots
+
+_None._
+
+## Events
+
+- `activate` – CustomEvent<HTMLElement>
+
+## Methods
+
+_None._
+
+## Related components
+
+_See description for usage context._
+
+## Accessibility
+
+_See full docs for accessibility details._
+
+## Minimal example
+
+```html
+<swirl-file-viewer-video file="..."></swirl-file-viewer-video>
+```
+
+## 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-file-viewer.md

@@ -0,0 +1,73 @@
+# `<swirl-file-viewer>`
+
+## Purpose
+
+The SwirlFileViewer component is used to render files of various formats.
+
+## Required props
+
+- `file` (string) – 
+- `type` (string) – 
+
+## Optional props
+
+- `active` (boolean | undefined) – 
+- `autoplay` (boolean | undefined) – 
+- `description` (string | undefined) – 
+- `disableDownload` (boolean | undefined) – 
+- `disablePrint` (boolean | undefined) – 
+- `errorMessage` (string | undefined) – 
+- `fileName` (string | undefined) – 
+- `pdfWorkerSrc` (string | undefined) – 
+- `skipNativeDownload` (boolean | undefined) – 
+- `thumbnailUrl` (string | undefined) – 
+- `typeUnsupportedMessage` (string | undefined) – 
+- `viewMode` ("side-by-side" | "single" | undefined) – 
+- `zoom` ("auto" | number | undefined) – 
+
+## Slots
+
+- **`watermark`** – Optional watermark image to be displayed in the bottom left corner. Only supported for image files.
+
+## Events
+
+- `activate` – CustomEvent<HTMLElement>
+- `downloadStart` – CustomEvent<void>
+- `visiblePagesChange` – CustomEvent<number[]>
+
+## Methods
+
+- `download()` – Download the file.
+- `print()` – Print the file. Applicable to PDFs only.
+
+## Related components
+
+No related components.
+
+## Accessibility
+
+SwirlFileViewer delegates rendering to format-specific viewers (e.g. PDF, image,
+video). Ensure slotted or embedded content provides appropriate labels and
+keyboard access; no component-level ARIA table.
+
+### Keyboard
+
+No component-specific keyboard behavior; keyboard access depends on the embedded
+viewer.
+
+## Minimal example
+
+```html
+<swirl-file-viewer file="..." type="..."></swirl-file-viewer>
+```
+
+## Usage example
+
+```html
+<swirl-file-viewer file="/sample.pdf" type="application/pdf"></swirl-file-viewer>
+```
+
+## Common mistakes
+
+- Ensure required props are set.
+- Use only allowed slot names and child components where documented.

package/dist/agent/components/swirl-form-control.md

@@ -0,0 +1,78 @@
+# `<swirl-form-control>`
+
+## Purpose
+
+The SwirlFormControl component is used to wrap form elements and provide context information via labels, descriptions and error messages.
+
+## Required props
+
+- `label` (string) – 
+
+## Optional props
+
+- `description` (string | undefined) – 
+- `disabled` (boolean | undefined) – 
+- `errorMessage` (string | undefined) – 
+- `fontSize` ("base" | "default" | "sm" | undefined) – 
+- `hideLabel` (boolean | undefined) – 
+- `icon` (string | undefined) – 
+- `inline` (boolean | undefined) – 
+- `invalid` (boolean | undefined) – 
+- `labelPosition` ("inside" | "outside" | undefined) – 
+- `readonly` (boolean | undefined) – 
+- `secondaryLabel` (string | undefined) – 
+- `tooltip` (string | undefined) – 
+
+## Slots
+
+- **`bottom`** – Additional content below the input, e.g. `<div slot="bottom">…</div>`
+- **`prefix`** – The prefix element, e.g. `<select slot="prefix">…</select>`
+- **`slot`** – The input element, e.g. `<swirl-text-input></swirl-text-input>`
+
+## Events
+
+_None._
+
+## Methods
+
+_None._
+
+## Related components
+
+- **Form inputs** (child) — Use a single form control element in the default
+  slot (e.g. [swirl-text-input](?path=/docs/components-swirltextinput--docs),
+  [swirl-select](?path=/docs/components-swirlselect--docs),
+  [swirl-checkbox](?path=/docs/components-swirlcheckbox--docs),
+  [swirl-date-input](?path=/docs/components-swirldateinput--docs),
+  [swirl-time-input](?path=/docs/components-swirltimeinput--docs)).
+
+## Accessibility
+
+### ARIA
+
+| ARIA               | Usage                                                           |
+| ------------------ | --------------------------------------------------------------- |
+| `role="group"`     |                                                                 |
+| `aria-describedby` | Added to the form element to associate it with the description. |
+
+### Keyboard
+
+No component-specific keyboard behavior; focus and input behavior come from the
+slotted form control.
+
+## Minimal example
+
+```html
+<swirl-form-control label="..."></swirl-form-control>
+```
+
+## Usage example
+
+```html
+<swirl-form-control description="Optional description of the control." label="Form Control Label"></swirl-form-control>
+```
+
+## Common mistakes
+
+- Ensure required props are set.
+- Use only allowed slot names and child components where documented.

package/dist/agent/components/swirl-form-group.md

@@ -0,0 +1,69 @@
+# `<swirl-form-group>`
+
+## Purpose
+
+The SwirlFormGroup component is used to arrange multiple [SwirlFormControl components](?path=/docs/components-swirlformcontrol--docs).
+
+## Required props
+
+_None._
+
+## Optional props
+
+- `orientation` ("horizontal" | "vertical" | undefined) – 
+
+## Slots
+
+_None._
+
+## Events
+
+_None._
+
+## Methods
+
+_None._
+
+## Related components
+
+No related components.
+
+## Accessibility
+
+SwirlFormGroup is a layout wrapper for form controls with no ARIA attributes or
+keyboard-specific behavior. Ensure each SwirlFormControl provides appropriate
+labels and semantics.
+
+### Keyboard
+
+No component-specific keyboard behavior.
+
+## Minimal example
+
+```html
+<swirl-form-group></swirl-form-group>
+```
+
+## Usage example
+
+```html
+<swirl-form-group>
+    <swirl-form-group orientation="horizontal">
+        <swirl-form-control label="First name">
+            <swirl-text-input type="text" value="John"></swirl-text-input>
+        </swirl-form-control>
+        <swirl-form-control label="Last name">
+            <swirl-text-input type="text" value="Doe"></swirl-text-input>
+        </swirl-form-control>
+    </swirl-form-group>
+
+    <swirl-form-control label="Email">
+        <swirl-text-input type="email"></swirl-text-input>
+    </swirl-form-control>
+</swirl-form-group>
+```
+
+## Common mistakes
+
+- Ensure required props are set.
+- Use only allowed slot names and child components where documented.

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

@@ -0,0 +1,65 @@
+# `<swirl-heading>`
+
+## Purpose
+
+The SwirlHeading component is used to add titles to major sections of content.
+
+## Required props
+
+- `text` (string) – 
+
+## Optional props
+
+- `align` ("center" | "end" | "start" | undefined) – 
+- `as` ("div" | "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "p" | "span" | undefined) – 
+- `balance` (boolean | undefined) – 
+- `headingId` (string | undefined) – 
+- `level` (1 | 2 | 3 | 4 | 5 | 6 | undefined) – 
+- `lines` (number | undefined) – 
+- `truncate` (boolean | undefined) – 
+
+## Slots
+
+_None._
+
+## Events
+
+_None._
+
+## Methods
+
+_None._
+
+## Related components
+
+No related components.
+
+## Accessibility
+
+Please refer to the
+["Headings" part](https://www.w3.org/WAI/tutorials/page-structure/headings/) of
+the
+[W3C's Page Structure Tutorial](https://www.w3.org/WAI/tutorials/page-structure/)
+on how to use headings correctly. The component renders a native heading element
+(`h1`–`h6`) via the `as` prop; no component-specific ARIA or keyboard behavior.
+
+### Keyboard
+
+No component-specific keyboard behavior.
+
+## Minimal example
+
+```html
+<swirl-heading text="..."></swirl-heading>
+```
+
+## Usage example
+
+```html
+<swirl-heading text="Headline: A line of words printed in large letters as the title of a story"></swirl-heading>
+```
+
+## Common mistakes
+
+- Ensure required props are set.
+- Use only allowed slot names and child components where documented.

package/dist/agent/components/swirl-icon-add-moderator.md

@@ -0,0 +1,49 @@
+# `<swirl-icon-add-moderator>`
+
+## Purpose
+
+Custom element: swirl-icon-add-moderator.
+
+## Required props
+
+_None._
+
+## Optional props
+
+- `color` ("critical" | "default" | "disabled" | "highlight" | "info" | "on-action-primary" | "on-image" | "on-status" | "on-surface-highlight" | "on-surface-highlight-subdued" | "strong" | "success" | "warning" | undefined) – 
+- `size` (16 | 20 | 24 | 28 | undefined) – 
+
+## Slots
+
+_None._
+
+## Events
+
+_None._
+
+## Methods
+
+_None._
+
+## Related components
+
+_See description for usage context._
+
+## Accessibility
+
+_See full docs for accessibility details._
+
+## Minimal example
+
+```html
+<swirl-icon-add-moderator></swirl-icon-add-moderator>
+```
+
+## 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-icon-add-photo.md

@@ -0,0 +1,49 @@
+# `<swirl-icon-add-photo>`
+
+## Purpose
+
+Custom element: swirl-icon-add-photo.
+
+## Required props
+
+_None._
+
+## Optional props
+
+- `color` ("critical" | "default" | "disabled" | "highlight" | "info" | "on-action-primary" | "on-image" | "on-status" | "on-surface-highlight" | "on-surface-highlight-subdued" | "strong" | "success" | "warning" | undefined) – 
+- `size` (16 | 20 | 24 | 28 | undefined) – 
+
+## Slots
+
+_None._
+
+## Events
+
+_None._
+
+## Methods
+
+_None._
+
+## Related components
+
+_See description for usage context._
+
+## Accessibility
+
+_See full docs for accessibility details._
+
+## Minimal example
+
+```html
+<swirl-icon-add-photo></swirl-icon-add-photo>
+```
+
+## 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-icon-add-reaction.md

@@ -0,0 +1,49 @@
+# `<swirl-icon-add-reaction>`
+
+## Purpose
+
+Custom element: swirl-icon-add-reaction.
+
+## Required props
+
+_None._
+
+## Optional props
+
+- `color` ("critical" | "default" | "disabled" | "highlight" | "info" | "on-action-primary" | "on-image" | "on-status" | "on-surface-highlight" | "on-surface-highlight-subdued" | "strong" | "success" | "warning" | undefined) – 
+- `size` (16 | 20 | 24 | 28 | undefined) – 
+
+## Slots
+
+_None._
+
+## Events
+
+_None._
+
+## Methods
+
+_None._
+
+## Related components
+
+_See description for usage context._
+
+## Accessibility
+
+_See full docs for accessibility details._
+
+## Minimal example
+
+```html
+<swirl-icon-add-reaction></swirl-icon-add-reaction>
+```
+
+## Usage example
+
+_No usage example in docs._
+
+## Common mistakes
+
+- Ensure required props are set.
+- Use only allowed slot names and child components where documented.