@ds-mo/ui 9.1.0 → 9.2.1

package/dist/mcp-data/registry/conversation-list-item.json

@@ -0,0 +1,283 @@
+{
+  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
+  "name": "conversation-list-item",
+  "title": "ConversationListItem",
+  "description": "Selectable conversation row with one-line preview, recency, unread presence, generic busy or error status, and channel-owned accessory slots.",
+  "type": "registry:ui",
+  "meta": {
+    "library": "@ds-mo/ui",
+    "distribution": "npm",
+    "storybook": "https://zainadeel.github.io/compomo/?path=/story/conversation-list-item",
+    "source": "src/wc/components/ConversationListItem/ConversationListItem.tsx",
+    "intentStatus": "complete",
+    "intent": {
+      "audience": "general",
+      "status": "experimental",
+      "summary": "Selectable conversation row with one-line preview, recency, unread presence, generic busy or error status, and channel-owned accessory slots.",
+      "useWhen": [
+        "A conversation history needs a compact row that opens one thread."
+      ],
+      "avoidWhen": [
+        "The row represents a command rather than a persisted conversation."
+      ],
+      "commonlyComposedWith": [
+        "component:ds-conversation-list-section",
+        "component:ds-avatar",
+        "component:ds-badge",
+        "component:ds-loader"
+      ],
+      "patterns": [
+        "pattern:conversation"
+      ],
+      "accessibility": [
+        "The conversation surface is one button with its title as the primary accessible name; actions are sibling controls so buttons are never nested.",
+        "An action in the actions slot remains keyboard-focusable and appears on row focus as well as pointer hover; touch layouts keep it visible.",
+        "Status copy must make busy or error meaning available without relying on motion or color."
+      ],
+      "states": [
+        "Rows reuse the md choice-item label/subtext recipe used by Menu, including 6px row padding, 2px text inset, and the shared content gap. The enclosing conversation-list scroll region supplies the larger 8px outer container padding.",
+        "Busy and error are generic channel-neutral states; the owning product supplies suitable status wording.",
+        "Any positive unreadCount renders one dot on the title row rather than a visible counter; the accessible row name may still announce the exact unread quantity.",
+        "Hover and press use the shared interaction hover and pressed overlays. Only the selected conversation uses the persistent active fill.",
+        "The title uses body-medium emphasis, not title-small, and the body-small preview truncates after one line. Unread titles use primary foreground; read titles use secondary foreground.",
+        "The actions slot overlays the row at an 8px right inset without changing title or preview measure, and paints above the row interaction wash while that wash remains active."
+      ],
+      "responsiveBehavior": [
+        "Long titles and previews truncate without displacing trailing status."
+      ],
+      "references": [
+        {
+          "label": "Storybook examples",
+          "path": "src/wc/components/ConversationList/ConversationList.stories.ts"
+        }
+      ]
+    },
+    "api": {
+      "props": {
+        "actionsOpen": {
+          "type": "boolean",
+          "resolvedType": "boolean",
+          "attribute": "actions-open",
+          "default": "false",
+          "required": false,
+          "mutable": false,
+          "description": "Keep the contextual-actions surface visible while its popup is open or closing."
+        },
+        "conversationId": {
+          "type": "string",
+          "resolvedType": "string",
+          "attribute": "conversation-id",
+          "default": "''",
+          "required": false,
+          "mutable": false
+        },
+        "conversationTitle": {
+          "type": "string",
+          "resolvedType": "string",
+          "attribute": "conversation-title",
+          "default": "''",
+          "required": false,
+          "mutable": false,
+          "description": "Visible conversation title. Named to avoid the native HTMLElement.title contract."
+        },
+        "preview": {
+          "type": "string",
+          "resolvedType": "string",
+          "attribute": "preview",
+          "default": "''",
+          "required": false,
+          "mutable": false
+        },
+        "selected": {
+          "type": "boolean",
+          "resolvedType": "boolean",
+          "attribute": "selected",
+          "default": "false",
+          "required": false,
+          "mutable": false
+        },
+        "state": {
+          "type": "ConversationItemState",
+          "resolvedType": "\"busy\" | \"default\" | \"error\"",
+          "attribute": "state",
+          "default": "'default'",
+          "required": false,
+          "mutable": false
+        },
+        "statusLabel": {
+          "type": "string",
+          "resolvedType": "string",
+          "attribute": "status-label",
+          "default": "''",
+          "required": false,
+          "mutable": false
+        },
+        "unreadCount": {
+          "type": "number",
+          "resolvedType": "number",
+          "attribute": "unread-count",
+          "default": "0",
+          "required": false,
+          "mutable": false
+        },
+        "updatedAt": {
+          "type": "string",
+          "resolvedType": "string",
+          "attribute": "updated-at",
+          "default": "''",
+          "required": false,
+          "mutable": false,
+          "description": "ISO timestamp for semantic activity metadata."
+        }
+      },
+      "events": [
+        {
+          "name": "dsSelect",
+          "detail": "{ id: string }",
+          "bubbles": true,
+          "cancelable": true,
+          "composed": true
+        }
+      ],
+      "methods": [],
+      "slots": []
+    },
+    "props": {
+      "actionsOpen": {
+        "type": "boolean",
+        "resolvedType": "boolean",
+        "attribute": "actions-open",
+        "default": "false",
+        "required": false,
+        "mutable": false,
+        "description": "Keep the contextual-actions surface visible while its popup is open or closing."
+      },
+      "conversationId": {
+        "type": "string",
+        "resolvedType": "string",
+        "attribute": "conversation-id",
+        "default": "''",
+        "required": false,
+        "mutable": false
+      },
+      "conversationTitle": {
+        "type": "string",
+        "resolvedType": "string",
+        "attribute": "conversation-title",
+        "default": "''",
+        "required": false,
+        "mutable": false,
+        "description": "Visible conversation title. Named to avoid the native HTMLElement.title contract."
+      },
+      "preview": {
+        "type": "string",
+        "resolvedType": "string",
+        "attribute": "preview",
+        "default": "''",
+        "required": false,
+        "mutable": false
+      },
+      "selected": {
+        "type": "boolean",
+        "resolvedType": "boolean",
+        "attribute": "selected",
+        "default": "false",
+        "required": false,
+        "mutable": false
+      },
+      "state": {
+        "type": "ConversationItemState",
+        "resolvedType": "\"busy\" | \"default\" | \"error\"",
+        "attribute": "state",
+        "default": "'default'",
+        "required": false,
+        "mutable": false
+      },
+      "statusLabel": {
+        "type": "string",
+        "resolvedType": "string",
+        "attribute": "status-label",
+        "default": "''",
+        "required": false,
+        "mutable": false
+      },
+      "unreadCount": {
+        "type": "number",
+        "resolvedType": "number",
+        "attribute": "unread-count",
+        "default": "0",
+        "required": false,
+        "mutable": false
+      },
+      "updatedAt": {
+        "type": "string",
+        "resolvedType": "string",
+        "attribute": "updated-at",
+        "default": "''",
+        "required": false,
+        "mutable": false,
+        "description": "ISO timestamp for semantic activity metadata."
+      }
+    },
+    "events": [
+      {
+        "name": "dsSelect",
+        "detail": "{ id: string }",
+        "bubbles": true,
+        "cancelable": true,
+        "composed": true
+      }
+    ],
+    "methods": [],
+    "slots": [],
+    "exports": {
+      "customElement": "ds-conversation-list-item",
+      "react": "DsConversationListItem",
+      "angular": "DsConversationListItem"
+    },
+    "consumption": {
+      "install": "npm install @ds-mo/ui @ds-mo/tokens @ds-mo/icons",
+      "cssSetup": "import '@ds-mo/tokens';\nimport '@ds-mo/tokens/reset';\nimport '@ds-mo/tokens/globals';",
+      "customElements": {
+        "import": "import '@ds-mo/ui/dist/components/ds-conversation-list-item.js';",
+        "example": "<ds-conversation-list-item></ds-conversation-list-item>"
+      },
+      "react": {
+        "import": "import { DsConversationListItem } from '@ds-mo/ui/react';",
+        "example": "<DsConversationListItem />"
+      },
+      "angular": {
+        "import": "import { DsConversationListItem } from '@ds-mo/ui/angular/ds-conversation-list-item';",
+        "example": "<ds-conversation-list-item></ds-conversation-list-item>"
+      },
+      "peerDependencies": {
+        "required": [
+          "@ds-mo/tokens ^3.1.1",
+          "@ds-mo/icons ^6.2.0"
+        ],
+        "frameworks": "Custom Elements; React 18/19 wrappers; Angular 19-22 standalone adapters."
+      }
+    }
+  },
+  "dependencies": [
+    "@ds-mo/ui",
+    "@ds-mo/tokens"
+  ],
+  "registryDependencies": [
+    "badge",
+    "loader",
+    "text"
+  ],
+  "files": [
+    {
+      "path": "src/wc/components/ConversationListItem/ConversationListItem.css",
+      "content": "@import '../../utils/choice-list.css';\n\n:host {\n  display: block;\n  box-sizing: border-box;\n  -webkit-user-select: none;\n  user-select: none;\n}\n\n.conversation-list-item__row {\n  position: relative;\n  isolation: isolate;\n}\n\n.conversation-list-item {\n  color: var(--color-foreground-primary);\n}\n\n.conversation-list-item--error {\n  --ds-interaction-border-width: var(--dimension-stroke-width-012);\n  --ds-interaction-border-color: var(--color-border-bold-negative);\n}\n\n.conversation-list-item__leading:empty,\n.conversation-list-item__trailing:empty {\n  display: none;\n}\n\n.conversation-list-item__leading,\n.conversation-list-item__trailing,\n.conversation-list-item__preview-row {\n  display: flex;\n  align-items: center;\n}\n\n.conversation-list-item__leading {\n  align-self: center;\n  width: auto;\n  height: auto;\n  margin-inline-start: var(--ds-control-label-inset, var(--dimension-space-025));\n  margin-inline-end: var(--dimension-space-050);\n}\n\n.conversation-list-item__content {\n  min-width: 0;\n}\n\n.conversation-list-item__title-row {\n  display: flex;\n  align-items: center;\n  min-width: 0;\n}\n\n.conversation-list-item__preview-row {\n  min-width: 0;\n  gap: var(--dimension-space-050);\n}\n\nds-text.conversation-list-item__title,\nds-text.conversation-list-item__preview {\n  display: block;\n  min-width: 0;\n}\n\nds-text.conversation-list-item__title {\n  flex: 1;\n}\n\n.conversation-list-item__unread {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  flex-shrink: 0;\n  width: var(--dimension-size-200);\n  margin-inline-end: var(--dimension-space-025);\n}\n\nds-text.conversation-list-item__preview.ds-choice-item__subtext {\n  -webkit-line-clamp: 1;\n}\n\n.conversation-list-item__actions {\n  position: absolute;\n  top: 50%;\n  right: var(--dimension-space-100);\n  z-index: var(--dimension-z-index-floating);\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  border-radius: var(--dimension-radius-half);\n  background: var(--color-background-transparent);\n  box-shadow: var(--effect-elevation-elevated-md);\n  -webkit-backdrop-filter: blur(var(--effect-blur-sm));\n  backdrop-filter: blur(var(--effect-blur-sm));\n  opacity: 0;\n  pointer-events: none;\n  transform: translateY(-50%);\n}\n\n.conversation-list-item__row:hover .conversation-list-item__actions,\n.conversation-list-item__row:has(:focus-visible) .conversation-list-item__actions,\n:host(.conversation-list-item--actions-open) .conversation-list-item__actions {\n  opacity: 1;\n  pointer-events: auto;\n}\n\n/* Keep the row wash continuous while the pointer moves onto its sibling action. */\n.conversation-list-item__row:hover .conversation-list-item::after {\n  background: var(--ds-interaction-hover);\n}\n\n:host(.conversation-list-item--actions-open) .conversation-list-item::after {\n  background: var(--ds-interaction-hover);\n}\n\n.conversation-list-item__row:active .conversation-list-item::after {\n  background: var(--ds-interaction-pressed);\n}\n\n@media (hover: none) {\n  .conversation-list-item__actions {\n    opacity: 1;\n    pointer-events: auto;\n  }\n\n  :host(.conversation-list-item--has-actions) .conversation-list-item__title-row {\n    padding-inline-end: var(--dimension-size-400);\n  }\n}\n\n.conversation-list-item__time {\n  position: absolute;\n  width: var(--dimension-size-050);\n  height: var(--dimension-size-050);\n  overflow: hidden;\n  clip-path: inset(50%);\n  white-space: nowrap;\n}\n",
+      "type": "registry:ui"
+    },
+    {
+      "path": "src/wc/components/ConversationListItem/ConversationListItem.tsx",
+      "content": "import { Component, Element, Event, EventEmitter, h, Host, Prop } from '@stencil/core';\nimport type { ConversationItemState } from '../conversation-types';\n\n@Component({\n  tag: 'ds-conversation-list-item',\n  styleUrl: 'ConversationListItem.css',\n  scoped: true,\n})\nexport class ConversationListItem {\n  @Element() el!: HTMLElement;\n\n  @Prop() conversationId: string = '';\n  /** Visible conversation title. Named to avoid the native HTMLElement.title contract. */\n  @Prop() conversationTitle: string = '';\n  @Prop() preview: string = '';\n  /** ISO timestamp for semantic activity metadata. */\n  @Prop() updatedAt: string = '';\n  @Prop() selected: boolean = false;\n  @Prop() state: ConversationItemState = 'default';\n  @Prop() statusLabel: string = '';\n  @Prop() unreadCount: number = 0;\n  /** Keep the contextual-actions surface visible while its popup is open or closing. */\n  @Prop({ reflect: true }) actionsOpen: boolean = false;\n\n  @Event() dsSelect!: EventEmitter<{ id: string }>;\n\n  private handleClick = () => this.dsSelect.emit({ id: this.conversationId });\n\n  private handleActionsSlotChange = (event: Event) => {\n    const slot = event.target as HTMLSlotElement;\n    this.el.classList.toggle(\n      'conversation-list-item--has-actions',\n      slot.assignedElements({ flatten: true }).length > 0\n    );\n  };\n\n  render() {\n    const busy = this.state === 'busy';\n    const subtext = busy && this.statusLabel ? this.statusLabel : this.preview;\n    const accessibleName = [\n      this.conversationTitle,\n      subtext,\n      this.unreadCount > 0 ? `${this.unreadCount} unread` : '',\n    ]\n      .filter(Boolean)\n      .join('. ');\n\n    return (\n      <Host\n        role=\"listitem\"\n        class={{ 'conversation-list-item--actions-open': this.actionsOpen }}\n      >\n        <div class=\"conversation-list-item__row\">\n          <button\n            type=\"button\"\n            class={{\n              'conversation-list-item': true,\n              'ds-choice-item': true,\n              'ds-control--md': true,\n              'ds-focus-ring-inset': true,\n              'ds-interaction-fill': true,\n              'ds-interaction-fill--selected': this.selected,\n              'conversation-list-item--error': this.state === 'error',\n            }}\n            aria-label={accessibleName}\n            aria-current={this.selected ? 'true' : undefined}\n            aria-busy={busy ? 'true' : undefined}\n            onClick={this.handleClick}\n          >\n            <span class=\"conversation-list-item__leading ds-choice-item__icon ds-interaction-fill__content\">\n              <slot name=\"leading\" />\n            </span>\n            <span class=\"conversation-list-item__content ds-choice-item__content ds-interaction-fill__content\">\n              <span class=\"conversation-list-item__title-row\">\n                <ds-text\n                  class=\"conversation-list-item__title ds-choice-item__label\"\n                  as=\"span\"\n                  variant=\"text-body-medium\"\n                  emphasis\n                  color={this.unreadCount > 0 ? 'primary' : 'secondary'}\n                  lineTruncation={1}\n                >\n                  {this.conversationTitle}\n                </ds-text>\n                {this.unreadCount > 0 ? (\n                  <span class=\"conversation-list-item__unread\">\n                    <ds-badge variant=\"dot\" surface=\"secondary\" />\n                  </span>\n                ) : null}\n              </span>\n              <span class=\"conversation-list-item__preview-row\">\n                {busy ? <ds-loader size=\"xs\" color=\"secondary\" /> : null}\n                <ds-text\n                  class=\"conversation-list-item__preview ds-choice-item__subtext\"\n                  as=\"span\"\n                  variant=\"text-body-small\"\n                  color={this.state === 'error' ? 'negative' : 'secondary'}\n                  lineTruncation={1}\n                >\n                  {subtext}\n                </ds-text>\n              </span>\n              {this.updatedAt ? (\n                <time class=\"conversation-list-item__time\" dateTime={this.updatedAt}>\n                  {this.updatedAt}\n                </time>\n              ) : null}\n            </span>\n            <span class=\"conversation-list-item__trailing ds-interaction-fill__content\">\n              <slot name=\"trailing\" />\n            </span>\n          </button>\n          <div class=\"conversation-list-item__actions\">\n            <slot name=\"actions\" onSlotchange={this.handleActionsSlotChange} />\n          </div>\n        </div>\n      </Host>\n    );\n  }\n}\n",
+      "type": "registry:ui"
+    }
+  ]
+}

package/dist/mcp-data/registry/conversation-list-section.json

@@ -0,0 +1,139 @@
+{
+  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
+  "name": "conversation-list-section",
+  "title": "ConversationListSection",
+  "description": "Semantically labelled section for grouping conversation rows by meaningful chronology or category.",
+  "type": "registry:ui",
+  "meta": {
+    "library": "@ds-mo/ui",
+    "distribution": "npm",
+    "storybook": "https://zainadeel.github.io/compomo/?path=/story/conversation-list-section",
+    "source": "src/wc/components/ConversationListSection/ConversationListSection.tsx",
+    "intentStatus": "complete",
+    "intent": {
+      "audience": "general",
+      "status": "experimental",
+      "summary": "Semantically labelled section for grouping conversation rows by meaningful chronology or category.",
+      "useWhen": [
+        "A conversation list needs visible groups such as Today, Yesterday, or Older."
+      ],
+      "avoidWhen": [
+        "A flat list is clearer or the proposed grouping has no meaning to readers."
+      ],
+      "commonlyComposedWith": [
+        "component:ds-conversation-list",
+        "component:ds-conversation-list-item"
+      ],
+      "patterns": [
+        "pattern:conversation"
+      ],
+      "accessibility": [
+        "The visible heading labels the section and must describe the relationship shared by its rows."
+      ],
+      "responsiveBehavior": [
+        "Rows remain full width while the heading stays visible in document order."
+      ],
+      "references": [
+        {
+          "label": "Storybook examples",
+          "path": "src/wc/components/ConversationList/ConversationList.stories.ts"
+        }
+      ]
+    },
+    "api": {
+      "props": {
+        "heading": {
+          "type": "string",
+          "resolvedType": "string",
+          "attribute": "heading",
+          "default": "''",
+          "required": false,
+          "mutable": false,
+          "description": "Visible section heading."
+        },
+        "sectionId": {
+          "type": "string",
+          "resolvedType": "string",
+          "attribute": "section-id",
+          "default": "''",
+          "required": false,
+          "mutable": false,
+          "description": "Optional stable id used for the section heading."
+        }
+      },
+      "events": [],
+      "methods": [],
+      "slots": []
+    },
+    "props": {
+      "heading": {
+        "type": "string",
+        "resolvedType": "string",
+        "attribute": "heading",
+        "default": "''",
+        "required": false,
+        "mutable": false,
+        "description": "Visible section heading."
+      },
+      "sectionId": {
+        "type": "string",
+        "resolvedType": "string",
+        "attribute": "section-id",
+        "default": "''",
+        "required": false,
+        "mutable": false,
+        "description": "Optional stable id used for the section heading."
+      }
+    },
+    "events": [],
+    "methods": [],
+    "slots": [],
+    "exports": {
+      "customElement": "ds-conversation-list-section",
+      "react": "DsConversationListSection",
+      "angular": "DsConversationListSection"
+    },
+    "consumption": {
+      "install": "npm install @ds-mo/ui @ds-mo/tokens @ds-mo/icons",
+      "cssSetup": "import '@ds-mo/tokens';\nimport '@ds-mo/tokens/reset';\nimport '@ds-mo/tokens/globals';",
+      "customElements": {
+        "import": "import '@ds-mo/ui/dist/components/ds-conversation-list-section.js';",
+        "example": "<ds-conversation-list-section></ds-conversation-list-section>"
+      },
+      "react": {
+        "import": "import { DsConversationListSection } from '@ds-mo/ui/react';",
+        "example": "<DsConversationListSection />"
+      },
+      "angular": {
+        "import": "import { DsConversationListSection } from '@ds-mo/ui/angular/ds-conversation-list-section';",
+        "example": "<ds-conversation-list-section></ds-conversation-list-section>"
+      },
+      "peerDependencies": {
+        "required": [
+          "@ds-mo/tokens ^3.1.1",
+          "@ds-mo/icons ^6.2.0"
+        ],
+        "frameworks": "Custom Elements; React 18/19 wrappers; Angular 19-22 standalone adapters."
+      }
+    }
+  },
+  "dependencies": [
+    "@ds-mo/ui",
+    "@ds-mo/tokens"
+  ],
+  "registryDependencies": [
+    "text"
+  ],
+  "files": [
+    {
+      "path": "src/wc/components/ConversationListSection/ConversationListSection.css",
+      "content": ":host {\n  display: block;\n  box-sizing: border-box;\n  -webkit-user-select: none;\n  user-select: none;\n}\n\n:host(:not(:first-child)) {\n  /* Match the 16px separation between PanelNav groups. */\n  margin-top: var(--dimension-space-200);\n}\n\n.conversation-list-section {\n  display: flex;\n  flex-direction: column;\n  gap: var(--dimension-space-050);\n}\n\nds-text.conversation-list-section__heading {\n  display: block;\n  padding: var(--dimension-space-050) var(--dimension-space-100);\n}\n\n.conversation-list-section__items {\n  display: flex;\n  flex-direction: column;\n  gap: var(--dimension-space-025);\n}\n",
+      "type": "registry:ui"
+    },
+    {
+      "path": "src/wc/components/ConversationListSection/ConversationListSection.tsx",
+      "content": "import { Component, h, Host, Prop } from '@stencil/core';\n\nlet sectionId = 0;\n\n@Component({\n  tag: 'ds-conversation-list-section',\n  styleUrl: 'ConversationListSection.css',\n  scoped: true,\n})\nexport class ConversationListSection {\n  /** Visible section heading. */\n  @Prop() heading: string = '';\n  /** Optional stable id used for the section heading. */\n  @Prop() sectionId: string = '';\n\n  private readonly generatedId = `ds-conversation-section-${++sectionId}`;\n\n  render() {\n    const headingId = this.sectionId || this.generatedId;\n    return (\n      <Host>\n        <section class=\"conversation-list-section\" aria-labelledby={headingId}>\n          <ds-text\n            class=\"conversation-list-section__heading\"\n            textId={headingId}\n            as=\"h3\"\n            variant=\"text-caption\"\n            emphasis\n            color=\"secondary\"\n          >\n            {this.heading}\n          </ds-text>\n          <div class=\"conversation-list-section__items\" role=\"list\">\n            <slot />\n          </div>\n        </section>\n      </Host>\n    );\n  }\n}\n",
+      "type": "registry:ui"
+    }
+  ]
+}

package/dist/mcp-data/registry/conversation-list.json

@@ -0,0 +1,101 @@
+{
+  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
+  "name": "conversation-list",
+  "title": "ConversationList",
+  "description": "Scrollable conversation-list region with dedicated empty and floating-action placement.",
+  "type": "registry:ui",
+  "meta": {
+    "library": "@ds-mo/ui",
+    "distribution": "npm",
+    "storybook": "https://zainadeel.github.io/compomo/?path=/story/conversation-list",
+    "source": "src/wc/components/ConversationList/ConversationList.tsx",
+    "intentStatus": "complete",
+    "intent": {
+      "audience": "general",
+      "status": "experimental",
+      "summary": "Scrollable conversation-list region with dedicated empty and floating-action placement.",
+      "useWhen": [
+        "A messaging-like surface needs a reusable history list with empty and action regions."
+      ],
+      "avoidWhen": [
+        "The content is not a collection of conversations or threads."
+      ],
+      "commonlyComposedWith": [
+        "component:ds-conversation-list-section",
+        "component:ds-conversation-list-item",
+        "component:ds-empty-state"
+      ],
+      "patterns": [
+        "pattern:conversation"
+      ],
+      "accessibility": [
+        "Provide an accessible list label through the surrounding heading or region.",
+        "Keep the empty message descriptive and the floating action explicitly named."
+      ],
+      "responsiveBehavior": [
+        "The list fills its owner, scrolls independently, and keeps its action at the lower end corner."
+      ],
+      "references": [
+        {
+          "label": "Storybook examples",
+          "path": "src/wc/components/ConversationList/ConversationList.stories.ts"
+        }
+      ]
+    },
+    "api": {
+      "props": {},
+      "events": [],
+      "methods": [],
+      "slots": []
+    },
+    "props": {},
+    "events": [],
+    "methods": [],
+    "slots": [],
+    "exports": {
+      "customElement": "ds-conversation-list",
+      "react": "DsConversationList",
+      "angular": "DsConversationList"
+    },
+    "consumption": {
+      "install": "npm install @ds-mo/ui @ds-mo/tokens @ds-mo/icons",
+      "cssSetup": "import '@ds-mo/tokens';\nimport '@ds-mo/tokens/reset';\nimport '@ds-mo/tokens/globals';",
+      "customElements": {
+        "import": "import '@ds-mo/ui/dist/components/ds-conversation-list.js';",
+        "example": "<ds-conversation-list></ds-conversation-list>"
+      },
+      "react": {
+        "import": "import { DsConversationList } from '@ds-mo/ui/react';",
+        "example": "<DsConversationList />"
+      },
+      "angular": {
+        "import": "import { DsConversationList } from '@ds-mo/ui/angular/ds-conversation-list';",
+        "example": "<ds-conversation-list></ds-conversation-list>"
+      },
+      "peerDependencies": {
+        "required": [
+          "@ds-mo/tokens ^3.1.1",
+          "@ds-mo/icons ^6.2.0"
+        ],
+        "frameworks": "Custom Elements; React 18/19 wrappers; Angular 19-22 standalone adapters."
+      }
+    }
+  },
+  "dependencies": [
+    "@ds-mo/ui",
+    "@ds-mo/tokens"
+  ],
+  "registryDependencies": [],
+  "files": [
+    {
+      "path": "src/wc/components/ConversationList/ConversationList.css",
+      "content": ":host {\n  display: block;\n  width: 100%;\n  height: 100%;\n  min-height: 0;\n  box-sizing: border-box;\n  -webkit-user-select: none;\n  user-select: none;\n}\n\n.conversation-list {\n  position: relative;\n  display: flex;\n  flex-direction: column;\n  width: 100%;\n  height: 100%;\n  min-height: 0;\n  box-sizing: border-box;\n}\n\n.conversation-list__content {\n  position: relative;\n  flex: 1 1 auto;\n  min-height: 0;\n  overflow: auto;\n  padding: var(--dimension-space-100);\n  padding-bottom: calc(var(--dimension-size-600) + var(--dimension-size-100));\n  box-sizing: border-box;\n}\n\n.conversation-list__empty {\n  display: contents;\n}\n\n.conversation-list__actions {\n  position: absolute;\n  right: var(--dimension-space-200);\n  bottom: var(--dimension-space-200);\n  z-index: var(--dimension-z-index-floating);\n}\n\n.conversation-list__actions-surface {\n  display: flex;\n  border-radius: var(--dimension-radius-half);\n  box-shadow: var(--effect-elevation-elevated-md);\n}\n\n.conversation-list__actions-surface:empty {\n  display: none;\n}\n",
+      "type": "registry:ui"
+    },
+    {
+      "path": "src/wc/components/ConversationList/ConversationList.tsx",
+      "content": "import { Component, h, Host } from '@stencil/core';\n\n@Component({\n  tag: 'ds-conversation-list',\n  styleUrl: 'ConversationList.css',\n  scoped: true,\n})\nexport class ConversationList {\n  render() {\n    return (\n      <Host>\n        <div class=\"conversation-list\">\n          <div class=\"conversation-list__content\">\n            <slot />\n            <div class=\"conversation-list__empty\">\n              <slot name=\"empty\" />\n            </div>\n          </div>\n          <div class=\"conversation-list__actions\">\n            <div class=\"conversation-list__actions-surface\">\n              <slot name=\"actions\" />\n            </div>\n          </div>\n        </div>\n      </Host>\n    );\n  }\n}\n",
+      "type": "registry:ui"
+    }
+  ]
+}