@getflip/swirl-ai 0.472.0 → 0.473.0

package/dist/agent/components/swirl-data-cell-stack.md

@@ -41,6 +41,7 @@ _None._
 | ------------------ | ------------------------------------------------- |
 | `role="group"`     | Set on the stack container.                       |
 | `role="list"`      | Set on the list of data cells.                    |
+| `role="listitem"`  | Exposed by each direct `swirl-data-cell` child.   |
 | `aria-labelledby`  | References the optional label when present.       |
 | `aria-describedby` | References the optional description when present. |
 

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

@@ -44,7 +44,8 @@ The component structures label-value pairs for assistive technologies.
 
 | ARIA                | Usage                                                             |
 | ------------------- | ----------------------------------------------------------------- |
-| `role="group"`      | Set on the host to group label and value.                         |
+| `role="group"`      | Set on the host when `swirl-data-cell` is used standalone.        |
+| `role="listitem"`   | Set on the host when `swirl-data-cell` is used in a stack/list.   |
 | `role="term"`       | Set on the label element.                                         |
 | `role="definition"` | Set on the value/definition container.                            |
 | `aria-labelledby`   | Set on the definition, referencing the label ID.                  |

package/dist/agent/components/swirl-shell-layout.md

@@ -2,7 +2,7 @@
 
 ## Purpose
 
-The SwirlShellLayout component provides the outer layout of the Flip Desktop app.
+> **Deprecated:** This component is deprecated and will be removed in the next > major release. The SwirlShellLayout component provides the outer layout of the Flip Desktop app.
 
 ## Required props
 

package/dist/agent/components/swirl-shell-navigation-item.md

@@ -2,7 +2,7 @@
 
 ## Purpose
 
-The SwirlShellNavigationItem component is used to provide the main navigation for the [SwirlShellLayout](?path=/docs/components-swirlshelllayout--docs).
+> **Deprecated:** This component is deprecated and will be removed in the next > major release. The SwirlShellNavigationItem component is used to provide the main navigation for the [SwirlShellLayout](?path=/docs/components-swirlshelllayout--docs).
 
 ## Required props
 

package/dist/agent/components-index.json

@@ -1458,11 +1458,11 @@
     },
     {
       "tag": "swirl-shell-layout",
-      "summary": "The SwirlShellLayout component provides the outer layout of the Flip Desktop app."
+      "summary": "> **Deprecated:** This component is deprecated and will be removed in the next > major release. The SwirlShellLayout component provides the outer layout of the Flip Desktop app."
     },
     {
       "tag": "swirl-shell-navigation-item",
-      "summary": "The SwirlShellNavigationItem component is used to provide the main navigation for the [SwirlShellLayout](?path=/docs/components-swirlshelllayout--docs)."
+      "summary": "> **Deprecated:** This component is deprecated and will be removed in the next > major release. The SwirlShellNavigationItem component is used to provide the main navigation for the [SwirlShellLayout](?path=/docs/components-swirlshelllayout--docs)."
     },
     {
       "tag": "swirl-skeleton-box",

package/dist/custom-elements.manifest.json

@@ -6961,7 +6961,7 @@
               "name": "data-cell"
             }
           ],
-          "description": "The SwirlDataCell component displays a label-value pair with optional media slot (e.g., swirl-avatar, icons), tooltip support with an info icon, and a suffix slot for additional content. It also supports interactive form controls through the content slot, allowing for editable data cells with inputs and selects.\n\nAccessibility\n\n### ARIA\n\nThe component structures label-value pairs for assistive technologies.\n\n| ARIA                | Usage                                                             |\n| ------------------- | ----------------------------------------------------------------- |\n| `role=\"group\"`      | Set on the host to group label and value.                         |\n| `role=\"term\"`       | Set on the label element.                                         |\n| `role=\"definition\"` | Set on the value/definition container.                            |\n| `aria-labelledby`   | Set on the definition, referencing the label ID.                  |\n| `aria-hidden`       | Set on the media container when present.                          |\n| `role=\"button\"`     | Optional; set when the cell contains a checkbox or radio control. |\n\n### Keyboard\n\nKeyboard behavior is determined by slotted content (e.g. form controls). No\ncomponent-specific shortcuts."
+          "description": "The SwirlDataCell component displays a label-value pair with optional media slot (e.g., swirl-avatar, icons), tooltip support with an info icon, and a suffix slot for additional content. It also supports interactive form controls through the content slot, allowing for editable data cells with inputs and selects.\n\nAccessibility\n\n### ARIA\n\nThe component structures label-value pairs for assistive technologies.\n\n| ARIA                | Usage                                                             |\n| ------------------- | ----------------------------------------------------------------- |\n| `role=\"group\"`      | Set on the host when `swirl-data-cell` is used standalone.        |\n| `role=\"listitem\"`   | Set on the host when `swirl-data-cell` is used in a stack/list.   |\n| `role=\"term\"`       | Set on the label element.                                         |\n| `role=\"definition\"` | Set on the value/definition container.                            |\n| `aria-labelledby`   | Set on the definition, referencing the label ID.                  |\n| `aria-hidden`       | Set on the media container when present.                          |\n| `role=\"button\"`     | Optional; set when the cell contains a checkbox or radio control. |\n\n### Keyboard\n\nKeyboard behavior is determined by slotted content (e.g. form controls). No\ncomponent-specific shortcuts."
         }
       ],
       "exports": [
@@ -7059,7 +7059,7 @@
               "name": "data-cell-stack"
             }
           ],
-          "description": "The SwirlDataCellStack component is a container for grouping multiple SwirlDataCell components with an optional label, description, and call-to-action slot.\n\nAccessibility\n\n### ARIA\n\n| ARIA               | Usage                                             |\n| ------------------ | ------------------------------------------------- |\n| `role=\"group\"`     | Set on the stack container.                       |\n| `role=\"list\"`      | Set on the list of data cells.                    |\n| `aria-labelledby`  | References the optional label when present.       |\n| `aria-describedby` | References the optional description when present. |\n\n### Keyboard\n\nNo component-specific keyboard behavior; interaction is handled by slotted\nSwirlDataCell content."
+          "description": "The SwirlDataCellStack component is a container for grouping multiple SwirlDataCell components with an optional label, description, and call-to-action slot.\n\nAccessibility\n\n### ARIA\n\n| ARIA               | Usage                                             |\n| ------------------ | ------------------------------------------------- |\n| `role=\"group\"`     | Set on the stack container.                       |\n| `role=\"list\"`      | Set on the list of data cells.                    |\n| `role=\"listitem\"`  | Exposed by each direct `swirl-data-cell` child.   |\n| `aria-labelledby`  | References the optional label when present.       |\n| `aria-describedby` | References the optional description when present. |\n\n### Keyboard\n\nNo component-specific keyboard behavior; interaction is handled by slotted\nSwirlDataCell content."
         }
       ],
       "exports": [
@@ -42976,6 +42976,7 @@
           "customElement": true,
           "tagName": "swirl-shell-layout",
           "name": "SwirlShellLayout",
+          "deprecated": "This component is deprecated and will be removed in the next major release.",
           "attributes": [
             {
               "name": "branded-header",
@@ -43348,7 +43349,7 @@
               "description": "Contents of the main area."
             }
           ],
-          "description": "The SwirlShellLayout component provides the outer layout of the Flip Desktop app.\n\nAccessibility\n\nSwirlShellLayout is a layout shell with no ARIA attributes or keyboard-specific\nbehavior. Ensure slotted navigation and main content provide appropriate\nlandmarks and focus order.\n\n### Keyboard\n\nNo component-specific keyboard behavior."
+          "description": "> **Deprecated:** This component is deprecated and will be removed in the next > major release. The SwirlShellLayout component provides the outer layout of the Flip Desktop app.\n\nAccessibility\n\nSwirlShellLayout is a layout shell with no ARIA attributes or keyboard-specific\nbehavior. Ensure slotted navigation and main content provide appropriate\nlandmarks and focus order.\n\n### Keyboard\n\nNo component-specific keyboard behavior."
         }
       ],
       "exports": [
@@ -43377,6 +43378,7 @@
           "customElement": true,
           "tagName": "swirl-shell-navigation-item",
           "name": "SwirlShellNavigationItem",
+          "deprecated": "This component is deprecated and will be removed in the next major release.",
           "attributes": [
             {
               "name": "active",
@@ -43699,7 +43701,7 @@
               "description": "Image or icon to display in the navigation item."
             }
           ],
-          "description": "The SwirlShellNavigationItem component is used to provide the main navigation for the [SwirlShellLayout](?path=/docs/components-swirlshelllayout--docs).\n\nAccessibility\n\n### ARIA\n\nThe component follows the\n[WAI-ARIA Link Pattern](https://www.w3.org/WAI/ARIA/apg/patterns/link/).\n\n| ARIA          | Usage |\n| ------------- | ----- |\n| `role=\"link\"` |       |\n\n### Keyboard\n\n| Key              | Action              |\n| ---------------- | ------------------- |\n| <kbd>ENTER</kbd> | Activates the link. |"
+          "description": "> **Deprecated:** This component is deprecated and will be removed in the next > major release. The SwirlShellNavigationItem component is used to provide the main navigation for the [SwirlShellLayout](?path=/docs/components-swirlshelllayout--docs).\n\nAccessibility\n\n### ARIA\n\nThe component follows the\n[WAI-ARIA Link Pattern](https://www.w3.org/WAI/ARIA/apg/patterns/link/).\n\n| ARIA          | Usage |\n| ------------- | ----- |\n| `role=\"link\"` |       |\n\n### Keyboard\n\n| Key              | Action              |\n| ---------------- | ------------------- |\n| <kbd>ENTER</kbd> | Activates the link. |"
         }
       ],
       "exports": [

package/dist/types/components/swirl-modal-shell/swirl-modal-shell.d.ts

@@ -8,6 +8,7 @@ export declare class SwirlModalShell {
     closeModal: EventEmitter<void>;
     isClosing: boolean;
     private modalEl;
+    private scrollContainerEl;
     componentDidLoad(): void;
     disconnectedCallback(): void;
     close(): Promise<void>;

package/dist/types/components/swirl-shell-layout/swirl-shell-layout.d.ts

@@ -3,6 +3,7 @@ import { SwirlShellNavigationItemVariant } from "../swirl-shell-navigation-item/
 export type SwirlShellLayoutSecondaryNavView = "grid" | "list";
 export type SwirlShellLayoutSecondaryNavGridItemVariant = Exclude<SwirlShellNavigationItemVariant, "default">;
 /**
+ * @deprecated This component is deprecated and will be removed in the next major release.
  * @slot logo - Logo shown inside header.
  * @slot left-header-tools - Tools positioned on the header's left-hand side.
  * @slot right-header-tools - Tools positioned on the header's right-hand side.

package/dist/types/components/swirl-shell-navigation-item/swirl-shell-navigation-item.d.ts

@@ -2,6 +2,7 @@ export type SwirlLabelColor = "default" | "light" | "dark";
 export type SwirlShellNavigationItemVariant = "default" | "tiled" | "app-icon";
 export type SwirlShellNavigationItemAriaCurrent = "page" | "true";
 /**
+ * @deprecated This component is deprecated and will be removed in the next major release.
  * @slot icon - Image or icon to display in the navigation item.
  */
 export declare class SwirlShellNavigationItem {

package/dist/types/components.d.ts

@@ -3909,6 +3909,9 @@ export namespace Components {
          */
         "spacing"?: SwirlSeparatorSpacing1;
     }
+    /**
+     * @deprecated This component is deprecated and will be removed in the next major release.
+     */
     interface SwirlShellLayout {
         "brandedHeader"?: boolean;
         /**
@@ -3972,6 +3975,9 @@ export namespace Components {
          */
         "skipLinkLabel"?: string;
     }
+    /**
+     * @deprecated This component is deprecated and will be removed in the next major release.
+     */
     interface SwirlShellNavigationItem {
         "active"?: boolean;
         "badgeLabel"?: string;
@@ -8113,6 +8119,9 @@ declare global {
         "historyForwardClick": MouseEvent;
         "skipLinkClick": MouseEvent;
     }
+    /**
+     * @deprecated This component is deprecated and will be removed in the next major release.
+     */
     interface HTMLSwirlShellLayoutElement extends Components.SwirlShellLayout, HTMLStencilElement {
         addEventListener<K extends keyof HTMLSwirlShellLayoutElementEventMap>(type: K, listener: (this: HTMLSwirlShellLayoutElement, ev: SwirlShellLayoutCustomEvent<HTMLSwirlShellLayoutElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
         addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
@@ -8127,6 +8136,9 @@ declare global {
         prototype: HTMLSwirlShellLayoutElement;
         new (): HTMLSwirlShellLayoutElement;
     };
+    /**
+     * @deprecated This component is deprecated and will be removed in the next major release.
+     */
     interface HTMLSwirlShellNavigationItemElement extends Components.SwirlShellNavigationItem, HTMLStencilElement {
     }
     var HTMLSwirlShellNavigationItemElement: {
@@ -13312,6 +13324,9 @@ declare namespace LocalJSX {
          */
         "spacing"?: SwirlSeparatorSpacing1;
     }
+    /**
+     * @deprecated This component is deprecated and will be removed in the next major release.
+     */
     interface SwirlShellLayout {
         "brandedHeader"?: boolean;
         /**
@@ -13370,6 +13385,9 @@ declare namespace LocalJSX {
          */
         "skipLinkLabel"?: string;
     }
+    /**
+     * @deprecated This component is deprecated and will be removed in the next major release.
+     */
     interface SwirlShellNavigationItem {
         "active"?: boolean;
         "badgeLabel"?: string;
@@ -18030,7 +18048,13 @@ declare module "@stencil/core" {
             "swirl-search": LocalJSX.IntrinsicElements["swirl-search"] & JSXBase.HTMLAttributes<HTMLSwirlSearchElement>;
             "swirl-select": LocalJSX.IntrinsicElements["swirl-select"] & JSXBase.HTMLAttributes<HTMLSwirlSelectElement>;
             "swirl-separator": LocalJSX.IntrinsicElements["swirl-separator"] & JSXBase.HTMLAttributes<HTMLSwirlSeparatorElement>;
+            /**
+             * @deprecated This component is deprecated and will be removed in the next major release.
+             */
             "swirl-shell-layout": LocalJSX.IntrinsicElements["swirl-shell-layout"] & JSXBase.HTMLAttributes<HTMLSwirlShellLayoutElement>;
+            /**
+             * @deprecated This component is deprecated and will be removed in the next major release.
+             */
             "swirl-shell-navigation-item": LocalJSX.IntrinsicElements["swirl-shell-navigation-item"] & JSXBase.HTMLAttributes<HTMLSwirlShellNavigationItemElement>;
             "swirl-skeleton-box": LocalJSX.IntrinsicElements["swirl-skeleton-box"] & JSXBase.HTMLAttributes<HTMLSwirlSkeletonBoxElement>;
             "swirl-skeleton-text": LocalJSX.IntrinsicElements["swirl-skeleton-text"] & JSXBase.HTMLAttributes<HTMLSwirlSkeletonTextElement>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getflip/swirl-ai",
-  "version": "0.472.0",
+  "version": "0.473.0",
   "description": "Swirl Design System AI package with artifacts for AI agents",
   "author": "Flip GmbH",
   "repository": {
@@ -49,7 +49,7 @@
     "zod": "3.24.0"
   },
   "devDependencies": {
-    "@getflip/swirl-components": "0.472.0",
+    "@getflip/swirl-components": "0.473.0",
     "@types/node": "25.3.0",
     "tsup": "^8.0.0",
     "tsx": "^4.7.0",