@ds-mo/ui 15.11.2 → 15.12.0

package/dist/mcp-data/registry/card-action-center.json

@@ -51,7 +51,8 @@
       "states": [
         "Rows expose distinct rest, hover, pressed, keyboard-focus, and inactive states.",
         "An empty sections array or groups with no items render the configured empty message.",
-        "The application owns loading, error, permission, routing, and post-activation consequences and reflects availability through the supplied item data."
+        "The application owns data fetching, error, permission, routing, and post-activation consequences and reflects availability through the supplied item data.",
+        "isLoading preserves the section and row layout while skeletonizing all headings, labels, and values; actions become inert and the card exposes its busy state."
       ],
       "responsiveBehavior": [
         "The card fills its parent width and never establishes a product breakpoint.",
@@ -117,6 +118,15 @@
           "mutable": false,
           "description": "Copy shown when no section contains an action."
         },
+        "isLoading": {
+          "type": "boolean",
+          "resolvedType": "boolean",
+          "attribute": "is-loading",
+          "default": "false",
+          "required": false,
+          "mutable": false,
+          "description": "Retain sections and rows while replacing their headings, labels, and values with skeletons."
+        },
         "sections": {
           "type": "ReadonlyArray<CardActionCenterSection>",
           "resolvedType": "readonly CardActionCenterSection[]",
@@ -149,6 +159,15 @@
         "mutable": false,
         "description": "Copy shown when no section contains an action."
       },
+      "isLoading": {
+        "type": "boolean",
+        "resolvedType": "boolean",
+        "attribute": "is-loading",
+        "default": "false",
+        "required": false,
+        "mutable": false,
+        "description": "Retain sections and rows while replacing their headings, labels, and values with skeletons."
+      },
       "sections": {
         "type": "ReadonlyArray<CardActionCenterSection>",
         "resolvedType": "readonly CardActionCenterSection[]",
@@ -211,18 +230,19 @@
   ],
   "registryDependencies": [
     "divider",
+    "skeleton",
     "tag",
     "text"
   ],
   "files": [
     {
       "path": "src/wc/components/CardActionCenter/CardActionCenter.css",
-      "content": "@import '../../utils/radius.css';\n@import '../../utils/interaction-fill.css';\n@import '../../utils/focus-ring.css';\n@import '../../utils/control-inactive.css';\n@import '../../utils/forced-colors.css';\n\n:host {\n  display: flex;\n  flex-direction: column;\n  gap: 0;\n  min-width: 0;\n  padding: calc(var(--dimension-space-100) - var(--dimension-stroke-width-012));\n  box-sizing: border-box;\n  border: var(--dimension-stroke-width-012) solid var(--color-border-tertiary);\n  border-radius: var(--ds-radius-card);\n  background: var(--color-background-primary);\n}\n\n.card-action-center__group,\n.card-action-center__section {\n  display: flex;\n  flex-direction: column;\n  min-width: 0;\n}\n\n.card-action-center__section {\n  gap: var(--dimension-space-050);\n}\n\n.card-action-center__divider {\n  display: flex;\n  flex: 0 0 var(--dimension-space-400);\n  align-items: center;\n  min-width: 0;\n}\n\n.card-action-center__section-heading {\n  display: flex;\n  flex: 1 1 auto;\n  align-items: center;\n  min-width: 0;\n  min-height: var(--dimension-size-400);\n  padding-inline: var(--dimension-space-100);\n  box-sizing: border-box;\n  user-select: none;\n}\n\n.card-action-center__list {\n  display: flex;\n  flex-direction: column;\n  gap: var(--dimension-space-050);\n  margin: 0;\n  padding: 0;\n  list-style: none;\n}\n\n.card-action-center__item {\n  display: flex;\n  align-items: center;\n  gap: var(--dimension-space-050);\n  width: 100%;\n  height: var(--dimension-size-400);\n  padding: 0 var(--dimension-space-075);\n  overflow: hidden;\n  box-sizing: border-box;\n  appearance: none;\n  border: none;\n  border-radius: var(--dimension-radius-025);\n  background: transparent;\n  color: inherit;\n  font: inherit;\n  text-align: start;\n  text-decoration: none;\n}\n\n.card-action-center__item--tagged {\n  padding-inline-end: var(--dimension-space-075);\n}\n\n.card-action-center__item-content {\n  display: flex;\n  flex: 1 1 auto;\n  flex-direction: column;\n  gap: var(--dimension-space-025);\n  min-width: 0;\n  padding-inline: var(--dimension-space-025);\n}\n\n.card-action-center__item-label {\n  display: block;\n  min-width: 0;\n}\n\n.card-action-center__item-value {\n  flex: 0 0 auto;\n}\n\nds-tag.card-action-center__item-value {\n  font-variant-numeric: tabular-nums;\n  font-feature-settings: 'tnum';\n}\n\n.card-action-center__empty {\n  margin: 0;\n  padding: var(--dimension-space-100);\n  text-align: center;\n}\n\n@media (forced-colors: active) {\n  :host {\n    border-color: var(--ds-forced-color-content);\n    background: var(--ds-forced-color-surface);\n  }\n}\n",
+      "content": "@import '../../utils/radius.css';\n@import '../../utils/interaction-fill.css';\n@import '../../utils/focus-ring.css';\n@import '../../utils/control-inactive.css';\n@import '../../utils/forced-colors.css';\n\n:host {\n  display: flex;\n  flex-direction: column;\n  gap: 0;\n  min-width: 0;\n  padding: calc(var(--dimension-space-100) - var(--dimension-stroke-width-012));\n  box-sizing: border-box;\n  border: var(--dimension-stroke-width-012) solid var(--color-border-tertiary);\n  border-radius: var(--ds-radius-card);\n  background: var(--color-background-primary);\n}\n\n.card-action-center__group,\n.card-action-center__section {\n  display: flex;\n  flex-direction: column;\n  min-width: 0;\n}\n\n.card-action-center__section {\n  gap: var(--dimension-space-050);\n}\n\n.card-action-center__divider {\n  display: flex;\n  flex: 0 0 var(--dimension-space-400);\n  align-items: center;\n  min-width: 0;\n}\n\n.card-action-center__section-heading {\n  display: flex;\n  flex: 1 1 auto;\n  align-items: center;\n  min-width: 0;\n  min-height: var(--dimension-size-400);\n  padding-inline: var(--dimension-space-100);\n  box-sizing: border-box;\n  user-select: none;\n}\n\n.card-action-center__list {\n  display: flex;\n  flex-direction: column;\n  gap: var(--dimension-space-050);\n  margin: 0;\n  padding: 0;\n  list-style: none;\n}\n\n.card-action-center__item {\n  display: flex;\n  align-items: center;\n  gap: var(--dimension-space-050);\n  width: 100%;\n  height: var(--dimension-size-400);\n  padding: 0 var(--dimension-space-075);\n  overflow: hidden;\n  box-sizing: border-box;\n  appearance: none;\n  border: none;\n  border-radius: var(--dimension-radius-025);\n  background: transparent;\n  color: inherit;\n  font: inherit;\n  text-align: start;\n  text-decoration: none;\n}\n\n.card-action-center__item--tagged {\n  padding-inline-end: var(--dimension-space-075);\n}\n\n.card-action-center__item-content {\n  display: flex;\n  flex: 1 1 auto;\n  flex-direction: column;\n  gap: var(--dimension-space-025);\n  min-width: 0;\n  padding-inline: var(--dimension-space-025);\n}\n\n.card-action-center__item-label {\n  display: block;\n  min-width: 0;\n}\n\n.card-action-center__item-value {\n  flex: 0 0 auto;\n}\n\n.card-action-center__item-value ds-tag {\n  font-variant-numeric: tabular-nums;\n  font-feature-settings: 'tnum';\n}\n\n.card-action-center__section-heading,\n.card-action-center__item-label {\n  position: relative;\n}\n\n:host(.card-action-center--loading) .card-action-center__copy {\n  visibility: hidden;\n}\n\n.card-action-center__copy-skeleton {\n  position: absolute;\n  inset-block-start: 50%;\n  transform: translateY(-50%);\n}\n\n.card-action-center__empty {\n  margin: 0;\n  padding: var(--dimension-space-100);\n  text-align: center;\n}\n\n@media (forced-colors: active) {\n  :host {\n    border-color: var(--ds-forced-color-content);\n    background: var(--ds-forced-color-surface);\n  }\n}\n\n.card-action-center__section-heading .card-action-center__copy-skeleton {\n  inset-inline-start: var(--dimension-space-100);\n}\n.card-action-center__item-label .card-action-center__copy-skeleton {\n  inset-inline-start: var(--dimension-space-025);\n}\n",
       "type": "registry:ui"
     },
     {
       "path": "src/wc/components/CardActionCenter/CardActionCenter.tsx",
-      "content": "import { Component, Event, EventEmitter, h, Host, Prop } from '@stencil/core';\nimport { resolveSafeUrl } from '../../utils';\nimport type { TagContrast, TagIntent } from '../Tag/Tag';\n\nexport interface CardActionCenterTag {\n  intent?: TagIntent;\n  contrast?: TagContrast;\n}\n\nexport interface CardActionCenterItem {\n  id: string;\n  label: string;\n  value?: string | number;\n  tag?: CardActionCenterTag;\n  href?: string;\n  isInactive?: boolean;\n}\n\nexport interface CardActionCenterSection {\n  id: string;\n  heading: string;\n  items: ReadonlyArray<CardActionCenterItem>;\n}\n\nexport interface CardActionCenterActionDetail {\n  sectionId: string;\n  itemId: string;\n  item: CardActionCenterItem;\n  href?: string;\n  originalEvent: MouseEvent;\n}\n\nlet nextCardActionCenterId = 0;\n\n@Component({\n  tag: 'ds-card-action-center',\n  styleUrl: 'CardActionCenter.css',\n  scoped: true,\n})\nexport class CardActionCenter {\n  /** Ordered groups of actions rendered in the card. Empty groups are omitted. */\n  @Prop() sections: ReadonlyArray<CardActionCenterSection> = [];\n\n  /** Copy shown when no section contains an action. */\n  @Prop() emptyMessage: string = 'No actions available';\n\n  /**\n   * Emitted when an available row is activated. When a row has an `href`,\n   * prevent this event to take over navigation with an application router.\n   */\n  @Event({ cancelable: true }) dsAction!: EventEmitter<CardActionCenterActionDetail>;\n\n  private readonly instanceId = ++nextCardActionCenterId;\n\n  private get visibleSections(): ReadonlyArray<CardActionCenterSection> {\n    return this.sections.filter(section => section.items.length > 0);\n  }\n\n  private headingId(section: CardActionCenterSection, index: number): string {\n    const sectionId = section.id.replace(/[^a-zA-Z0-9_-]/g, '-');\n    return `ds-card-action-center-${this.instanceId}-${index}-${sectionId}`;\n  }\n\n  private handleAction(\n    section: CardActionCenterSection,\n    item: CardActionCenterItem,\n    href: string | undefined,\n    originalEvent: MouseEvent\n  ) {\n    if (item.isInactive) return;\n\n    const actionEvent = this.dsAction.emit({\n      sectionId: section.id,\n      itemId: item.id,\n      item,\n      href,\n      originalEvent,\n    });\n    if (href && actionEvent.defaultPrevented) originalEvent.preventDefault();\n  }\n\n  private renderValue(item: CardActionCenterItem) {\n    if (item.value === undefined || item.value === null) return null;\n    const value = String(item.value);\n\n    if (item.tag) {\n      return (\n        <ds-tag\n          class=\"card-action-center__item-value ds-interaction-fill__content\"\n          label={value}\n          intent={item.tag.intent ?? 'neutral'}\n          contrast={item.tag.contrast ?? 'faint'}\n          size=\"sm\"\n          isInset\n          rounded\n        ></ds-tag>\n      );\n    }\n\n    return (\n      <ds-text\n        class=\"card-action-center__item-value ds-interaction-fill__content\"\n        variant=\"text-body-medium\"\n        color=\"secondary\"\n        emphasis\n        wrap=\"nowrap\"\n        fontFeature=\"tabular-nums\"\n        as=\"span\"\n      >\n        {value}\n      </ds-text>\n    );\n  }\n\n  private renderItem(section: CardActionCenterSection, item: CardActionCenterItem) {\n    const href = item.isInactive ? undefined : resolveSafeUrl(item.href);\n    const classes = {\n      'card-action-center__item': true,\n      'card-action-center__item--tagged': !!item.tag && item.value != null,\n      'ds-interaction-fill': true,\n      'ds-focus-ring-inset': true,\n      'ds-control-inactive': !!item.isInactive,\n    };\n    const content = [\n      <ds-text\n        class=\"card-action-center__item-content card-action-center__item-label ds-interaction-fill__content\"\n        variant=\"text-body-medium\"\n        color=\"secondary\"\n        wrap=\"balance\"\n        as=\"span\"\n      >\n        {item.label}\n      </ds-text>,\n      this.renderValue(item),\n    ];\n\n    if (href) {\n      return (\n        <a\n          class={classes}\n          href={href}\n          onClick={(event: MouseEvent) => this.handleAction(section, item, href, event)}\n        >\n          {content}\n        </a>\n      );\n    }\n\n    return (\n      <button\n        type=\"button\"\n        class={classes}\n        disabled={item.isInactive || undefined}\n        onClick={(event: MouseEvent) => this.handleAction(section, item, undefined, event)}\n      >\n        {content}\n      </button>\n    );\n  }\n\n  render() {\n    const sections = this.visibleSections;\n\n    return (\n      <Host>\n        {sections.length ? (\n          sections.map((section, sectionIndex) => (\n            <div class=\"card-action-center__group\">\n              {sectionIndex > 0 ? (\n                <div class=\"card-action-center__divider\">\n                  <ds-divider\n                    inset=\"space-100\"\n                    length=\"calc(100% - var(--dimension-space-200))\"\n                  ></ds-divider>\n                </div>\n              ) : null}\n              <section\n                class=\"card-action-center__section\"\n                aria-labelledby={this.headingId(section, sectionIndex)}\n              >\n                <ds-text\n                  id={this.headingId(section, sectionIndex)}\n                  class=\"card-action-center__section-heading\"\n                  variant=\"text-title-small\"\n                  emphasis\n                  color=\"primary\"\n                  wrap=\"balance\"\n                  as=\"h2\"\n                >\n                  {section.heading}\n                </ds-text>\n                <ul class=\"card-action-center__list\">\n                  {section.items.map(item => (\n                    <li>{this.renderItem(section, item)}</li>\n                  ))}\n                </ul>\n              </section>\n            </div>\n          ))\n        ) : (\n          <ds-text\n            class=\"card-action-center__empty\"\n            variant=\"text-body-medium\"\n            color=\"secondary\"\n            wrap=\"balance\"\n            as=\"p\"\n          >\n            {this.emptyMessage}\n          </ds-text>\n        )}\n      </Host>\n    );\n  }\n}\n",
+      "content": "import { Component, Event, EventEmitter, h, Host, Prop } from '@stencil/core';\nimport { resolveSafeUrl } from '../../utils';\nimport type { TagContrast, TagIntent } from '../Tag/Tag';\n\nexport interface CardActionCenterTag {\n  intent?: TagIntent;\n  contrast?: TagContrast;\n}\n\nexport interface CardActionCenterItem {\n  id: string;\n  label: string;\n  value?: string | number;\n  tag?: CardActionCenterTag;\n  href?: string;\n  isInactive?: boolean;\n}\n\nexport interface CardActionCenterSection {\n  id: string;\n  heading: string;\n  items: ReadonlyArray<CardActionCenterItem>;\n}\n\nexport interface CardActionCenterActionDetail {\n  sectionId: string;\n  itemId: string;\n  item: CardActionCenterItem;\n  href?: string;\n  originalEvent: MouseEvent;\n}\n\nlet nextCardActionCenterId = 0;\n\n@Component({\n  tag: 'ds-card-action-center',\n  styleUrl: 'CardActionCenter.css',\n  scoped: true,\n})\nexport class CardActionCenter {\n  /** Ordered groups of actions rendered in the card. Empty groups are omitted. */\n  @Prop() sections: ReadonlyArray<CardActionCenterSection> = [];\n\n  /** Copy shown when no section contains an action. */\n  @Prop() emptyMessage: string = 'No actions available';\n  /** Retain sections and rows while replacing their headings, labels, and values with skeletons. */\n  @Prop() isLoading: boolean = false;\n\n  /**\n   * Emitted when an available row is activated. When a row has an `href`,\n   * prevent this event to take over navigation with an application router.\n   */\n  @Event({ cancelable: true }) dsAction!: EventEmitter<CardActionCenterActionDetail>;\n\n  private readonly instanceId = ++nextCardActionCenterId;\n\n  private get visibleSections(): ReadonlyArray<CardActionCenterSection> {\n    return this.sections.filter(section => section.items.length > 0);\n  }\n\n  private headingId(section: CardActionCenterSection, index: number): string {\n    const sectionId = section.id.replace(/[^a-zA-Z0-9_-]/g, '-');\n    return `ds-card-action-center-${this.instanceId}-${index}-${sectionId}`;\n  }\n\n  private handleAction(\n    section: CardActionCenterSection,\n    item: CardActionCenterItem,\n    href: string | undefined,\n    originalEvent: MouseEvent\n  ) {\n    if (item.isInactive || this.isLoading) return;\n\n    const actionEvent = this.dsAction.emit({\n      sectionId: section.id,\n      itemId: item.id,\n      item,\n      href,\n      originalEvent,\n    });\n    if (href && actionEvent.defaultPrevented) originalEvent.preventDefault();\n  }\n\n  private renderValue(item: CardActionCenterItem) {\n    if (item.value === undefined || item.value === null) return null;\n    const value = String(item.value);\n\n    if (item.tag) {\n      return (\n        <ds-skeleton\n          class=\"card-action-center__item-value\"\n          preserveLayout\n          isLoading={this.isLoading}\n          variant=\"control\"\n          rounded\n        >\n          <ds-tag\n            class=\"ds-interaction-fill__content\"\n            label={value}\n            intent={item.tag.intent ?? 'neutral'}\n            contrast={item.tag.contrast ?? 'faint'}\n            size=\"sm\"\n            isInset\n            rounded\n          ></ds-tag>\n        </ds-skeleton>\n      );\n    }\n\n    return (\n      <ds-skeleton class=\"card-action-center__item-value\" preserveLayout isLoading={this.isLoading}>\n        <ds-text\n          class=\"ds-interaction-fill__content\"\n          variant=\"text-body-medium\"\n          color=\"secondary\"\n          emphasis\n          wrap=\"nowrap\"\n          fontFeature=\"tabular-nums\"\n          as=\"span\"\n        >\n          {value}\n        </ds-text>\n      </ds-skeleton>\n    );\n  }\n\n  private renderItem(section: CardActionCenterSection, item: CardActionCenterItem) {\n    const href = item.isInactive || this.isLoading ? undefined : resolveSafeUrl(item.href);\n    const classes = {\n      'card-action-center__item': true,\n      'card-action-center__item--tagged': !!item.tag && item.value != null,\n      'ds-interaction-fill': true,\n      'ds-focus-ring-inset': true,\n      'ds-control-inactive': !!item.isInactive && !this.isLoading,\n    };\n    const content = [\n      <ds-text\n        class=\"card-action-center__item-content card-action-center__item-label ds-interaction-fill__content\"\n        variant=\"text-body-medium\"\n        color=\"secondary\"\n        wrap=\"balance\"\n        as=\"span\"\n        aria-hidden={this.isLoading ? 'true' : undefined}\n      >\n        <span class=\"card-action-center__copy\">{item.label}</span>\n        {this.isLoading && <ds-skeleton class=\"card-action-center__copy-skeleton\" width=\"75%\" />}\n      </ds-text>,\n      this.renderValue(item),\n    ];\n\n    if (href) {\n      return (\n        <a\n          class={classes}\n          href={href}\n          onClick={(event: MouseEvent) => this.handleAction(section, item, href, event)}\n        >\n          {content}\n        </a>\n      );\n    }\n\n    return (\n      <button\n        type=\"button\"\n        class={classes}\n        disabled={this.isLoading || item.isInactive || undefined}\n        inert={this.isLoading}\n        aria-hidden={this.isLoading ? 'true' : undefined}\n        onClick={(event: MouseEvent) => this.handleAction(section, item, undefined, event)}\n      >\n        {content}\n      </button>\n    );\n  }\n\n  render() {\n    const sections = this.visibleSections;\n\n    return (\n      <Host\n        class={{ 'card-action-center--loading': this.isLoading }}\n        aria-busy={this.isLoading ? 'true' : undefined}\n      >\n        {sections.length ? (\n          sections.map((section, sectionIndex) => (\n            <div class=\"card-action-center__group\">\n              {sectionIndex > 0 ? (\n                <div class=\"card-action-center__divider\">\n                  <ds-divider\n                    inset=\"space-100\"\n                    length=\"calc(100% - var(--dimension-space-200))\"\n                  ></ds-divider>\n                </div>\n              ) : null}\n              <section\n                class=\"card-action-center__section\"\n                aria-labelledby={this.headingId(section, sectionIndex)}\n              >\n                <ds-text\n                  id={this.headingId(section, sectionIndex)}\n                  class=\"card-action-center__section-heading\"\n                  variant=\"text-title-small\"\n                  emphasis\n                  color=\"primary\"\n                  wrap=\"balance\"\n                  as=\"h2\"\n                  aria-hidden={this.isLoading ? 'true' : undefined}\n                >\n                  <span class=\"card-action-center__copy\">{section.heading}</span>\n                  {this.isLoading && (\n                    <ds-skeleton\n                      class=\"card-action-center__copy-skeleton\"\n                      textVariant=\"text-title-small\"\n                      width=\"min(60%, calc(var(--dimension-size-800) * 2))\"\n                    />\n                  )}\n                </ds-text>\n                <ul class=\"card-action-center__list\">\n                  {section.items.map(item => (\n                    <li>{this.renderItem(section, item)}</li>\n                  ))}\n                </ul>\n              </section>\n            </div>\n          ))\n        ) : (\n          <ds-text\n            class=\"card-action-center__empty\"\n            variant=\"text-body-medium\"\n            color=\"secondary\"\n            wrap=\"balance\"\n            as=\"p\"\n          >\n            {this.emptyMessage}\n          </ds-text>\n        )}\n      </Host>\n    );\n  }\n}\n",
       "type": "registry:ui"
     }
   ]

package/dist/mcp-data/registry/card-chart.json

@@ -45,7 +45,8 @@
       "states": [
         "Custom mode provides flexible body chrome and does not mutate chart or legend interaction.",
         "Chart mode keeps a slotted external legend static by disabling hover emphasis.",
-        "showFilter adds the standard filter action and emits dsFilterClick without owning filter state."
+        "showFilter adds the standard filter action and emits dsFilterClick without owning filter state.",
+        "isLoading preserves card geometry, skeletonizes the heading and standard filter control, and replaces a chart canvas with one quiet placeholder. The owner supplies skeletons for custom body content and slotted actions."
       ],
       "responsiveBehavior": [
         "The sm, md, or lg width sets a matching token-based minimum height and remains constrained by its parent.",
@@ -132,6 +133,15 @@
           "mutable": false,
           "description": "Chart heading shown in the card header."
         },
+        "isLoading": {
+          "type": "boolean",
+          "resolvedType": "boolean",
+          "attribute": "is-loading",
+          "default": "false",
+          "required": false,
+          "mutable": false,
+          "description": "Skeletonize the header and chart canvas; custom body content owns its loading atoms."
+        },
         "showFilter": {
           "type": "boolean",
           "resolvedType": "boolean",
@@ -190,6 +200,15 @@
         "mutable": false,
         "description": "Chart heading shown in the card header."
       },
+      "isLoading": {
+        "type": "boolean",
+        "resolvedType": "boolean",
+        "attribute": "is-loading",
+        "default": "false",
+        "required": false,
+        "mutable": false,
+        "description": "Skeletonize the header and chart canvas; custom body content owns its loading atoms."
+      },
       "showFilter": {
         "type": "boolean",
         "resolvedType": "boolean",
@@ -261,17 +280,18 @@
   ],
   "registryDependencies": [
     "button-unfilled",
+    "skeleton",
     "text"
   ],
   "files": [
     {
       "path": "src/wc/components/CardChart/CardChart.css",
-      "content": "@import '../../utils/radius.css';\n@import '../../utils/chrome-header.css';\n@import '../../utils/forced-colors.css';\n\n:host {\n  position: relative;\n  display: flex;\n  flex-direction: column;\n  box-sizing: border-box;\n  width: var(--_card-chart-width);\n  min-height: var(--_card-chart-min-height);\n  max-width: 100%;\n  overflow: visible;\n  border: none;\n  border-radius: var(--ds-radius-card);\n  background-color: var(--color-background-primary);\n  box-shadow: var(--effect-shadow-elevated-sm);\n}\n\n:host::after {\n  content: '';\n  position: absolute;\n  inset: 0;\n  z-index: 4;\n  border-radius: inherit;\n  box-shadow: var(--effect-highlight-elevated-sm);\n  pointer-events: none;\n}\n\n.card-chart__header {\n  flex-shrink: 0;\n  border-bottom: var(--dimension-stroke-width-012) solid var(--color-border-tertiary);\n}\n\n.card-chart__copy {\n  align-items: center;\n}\n\nds-text.card-chart__title {\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n  -webkit-user-select: none;\n  user-select: none;\n}\n\n.card-chart__actions {\n  flex-shrink: 0;\n}\n\n.card-chart__actions:empty {\n  display: none;\n}\n\n.card-chart__body,\n.card-chart__layout {\n  display: flex;\n  flex: 1 1 auto;\n  flex-direction: column;\n  box-sizing: border-box;\n  min-height: 0;\n}\n\n.card-chart__body {\n  border-radius: 0 0 var(--ds-radius-card) var(--ds-radius-card);\n  background-color: var(--color-background-primary);\n}\n\n.card-chart__layout {\n  height: 100%;\n  gap: var(--dimension-space-200);\n}\n\n.card-chart__chart {\n  display: grid;\n  flex: 1 1 auto;\n  align-items: center;\n  box-sizing: border-box;\n  min-height: 0;\n  padding: var(--dimension-space-200) var(--dimension-space-200) 0 var(--dimension-space-200);\n}\n\n.card-chart__chart > * {\n  width: 100%;\n  min-width: 0;\n  max-width: 100%;\n}\n\n.card-chart__chart > ds-chart {\n  --ds-chart-container-height: 100%;\n}\n\n.card-chart__legend {\n  flex: 0 0 auto;\n  box-sizing: border-box;\n  padding: 0 var(--dimension-space-100) var(--dimension-space-100) var(--dimension-space-100);\n}\n\n@media (forced-colors: active) {\n  :host {\n    box-shadow: none;\n    outline: var(--dimension-stroke-width-012) solid var(--ds-forced-color-content);\n    outline-offset: calc(-1 * var(--dimension-stroke-width-012));\n  }\n\n  :host::after {\n    box-shadow: none;\n  }\n}\n",
+      "content": "@import '../../utils/radius.css';\n@import '../../utils/chrome-header.css';\n@import '../../utils/forced-colors.css';\n\n:host {\n  position: relative;\n  display: flex;\n  flex-direction: column;\n  box-sizing: border-box;\n  width: var(--_card-chart-width);\n  min-height: var(--_card-chart-min-height);\n  max-width: 100%;\n  overflow: visible;\n  border: none;\n  border-radius: var(--ds-radius-card);\n  background-color: var(--color-background-primary);\n  box-shadow: var(--effect-shadow-elevated-sm);\n}\n\n:host::after {\n  content: '';\n  position: absolute;\n  inset: 0;\n  z-index: 4;\n  border-radius: inherit;\n  box-shadow: var(--effect-highlight-elevated-sm);\n  pointer-events: none;\n}\n\n.card-chart__header {\n  flex-shrink: 0;\n  border-bottom: var(--dimension-stroke-width-012) solid var(--color-border-tertiary);\n}\n\n.card-chart__copy {\n  position: relative;\n  align-items: center;\n}\n\nds-text.card-chart__title {\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n  -webkit-user-select: none;\n  user-select: none;\n}\n\n.card-chart__actions {\n  flex-shrink: 0;\n}\n\n.card-chart__actions:empty {\n  display: none;\n}\n\n.card-chart__body,\n.card-chart__layout {\n  display: flex;\n  flex: 1 1 auto;\n  flex-direction: column;\n  box-sizing: border-box;\n  min-height: 0;\n}\n\n.card-chart__body {\n  border-radius: 0 0 var(--ds-radius-card) var(--ds-radius-card);\n  background-color: var(--color-background-primary);\n}\n\n.card-chart__layout {\n  height: 100%;\n  gap: var(--dimension-space-200);\n}\n\n.card-chart__chart {\n  position: relative;\n  display: grid;\n  flex: 1 1 auto;\n  align-items: center;\n  box-sizing: border-box;\n  min-height: 0;\n  padding: var(--dimension-space-200) var(--dimension-space-200) 0 var(--dimension-space-200);\n}\n\n.card-chart__chart > * {\n  width: 100%;\n  min-width: 0;\n  max-width: 100%;\n}\n\n.card-chart__chart > ds-chart {\n  --ds-chart-container-height: 100%;\n}\n\n.card-chart__legend {\n  position: relative;\n  flex: 0 0 auto;\n  box-sizing: border-box;\n  padding: 0 var(--dimension-space-100) var(--dimension-space-100) var(--dimension-space-100);\n}\n\n:host(.card-chart--loading) .card-chart__title,\n:host(.card-chart--loading) .card-chart__chart,\n:host(.card-chart--loading) .card-chart__legend {\n  visibility: hidden;\n}\n\n.card-chart__heading-skeleton {\n  position: absolute;\n  inset-inline-start: calc(var(--ds-control-padding-inline) + var(--ds-control-label-inset));\n  width: min(60%, calc(var(--dimension-size-800) * 2));\n}\n\n.card-chart__chart > .card-chart__plot-skeleton {\n  visibility: visible;\n  position: absolute;\n  inset: var(--dimension-space-200);\n  width: auto;\n  height: auto;\n}\n\n@media (forced-colors: active) {\n  :host {\n    box-shadow: none;\n    outline: var(--dimension-stroke-width-012) solid var(--ds-forced-color-content);\n    outline-offset: calc(-1 * var(--dimension-stroke-width-012));\n  }\n\n  :host::after {\n    box-shadow: none;\n  }\n}\n\n.card-chart__legend-skeleton {\n  position: absolute;\n  inset-block-start: 0;\n  inset-inline-start: var(--dimension-space-100);\n  visibility: visible;\n}\n",
       "type": "registry:ui"
     },
     {
       "path": "src/wc/components/CardChart/CardChart.tsx",
-      "content": "import { Component, Element, Event, EventEmitter, h, Host, Prop, State } from '@stencil/core';\n\nexport type CardChartWidth = 'sm' | 'md' | 'lg';\nexport type CardChartVariant = 'custom' | 'chart';\n\ntype LegendSlot = HTMLElement & {\n  activeLabel?: string | null;\n  highlightOnHover?: boolean;\n};\n\nconst CARD_WIDTH_VARS: Record<CardChartWidth, string> = {\n  sm: 'var(--dimension-card-width-sm)',\n  md: 'var(--dimension-card-width-md)',\n  lg: 'var(--dimension-card-width-lg)',\n};\n\nconst CARD_HEIGHT_VARS: Record<CardChartWidth, string> = {\n  sm: 'var(--dimension-card-height-sm)',\n  md: 'var(--dimension-card-height-md)',\n  lg: 'var(--dimension-card-height-lg)',\n};\n\n/**\n * Standard chart card chrome and composition. The variant owns\n * only the chart/legend relationship; applications continue to own data.\n */\n@Component({\n  tag: 'ds-card-chart',\n  styleUrl: 'CardChart.css',\n  scoped: true,\n})\nexport class CardChart {\n  @Element() el!: HTMLElement;\n\n  /** Chart heading shown in the card header. */\n  @Prop() heading!: string;\n  /** Chart composition behavior. */\n  @Prop() variant: CardChartVariant = 'custom';\n  /** Width token with the matching chart-card min-height. */\n  @Prop() cardWidth: CardChartWidth = 'md';\n  /** Renders the standard filter action before custom actions. */\n  @Prop() showFilter: boolean = false;\n  @Prop() filterLabel: string = 'Filter';\n\n  /** Emits when the standard header filter control is activated. */\n  @Event() dsFilterClick!: EventEmitter<void>;\n\n  @State() private hasChartSlot = false;\n  @State() private hasLegendSlot = false;\n\n  componentWillRender() {\n    this.hasChartSlot = !!this.el.querySelector('[slot=\"chart\"]');\n    this.hasLegendSlot = !!this.el.querySelector('[slot=\"legend\"]');\n  }\n\n  componentDidRender() {\n    const legend = this.el.querySelector('ds-chart-legend[slot=\"legend\"]') as LegendSlot | null;\n    if (this.variant === 'chart' && legend) {\n      legend.setAttribute('highlight-on-hover', 'false');\n      if ('highlightOnHover' in legend) legend.highlightOnHover = false;\n    }\n  }\n\n  private handleFilterClick = () => {\n    this.dsFilterClick.emit();\n  };\n\n  render() {\n    const usesChartLayout = this.variant !== 'custom' || this.hasChartSlot;\n    return (\n      <Host\n        class={{\n          'card-chart': true,\n          [`card-chart--${this.variant}`]: true,\n        }}\n        style={{\n          '--_card-chart-width': CARD_WIDTH_VARS[this.cardWidth],\n          '--_card-chart-min-height': CARD_HEIGHT_VARS[this.cardWidth],\n        }}\n      >\n        <header class=\"card-chart__header ds-chrome-header\">\n          {/* eslint-disable-next-line compomo/prefer-direct-ds-text -- Shared header copy owns the control-density geometry around the semantic heading. */}\n          <div class=\"card-chart__copy ds-chrome-header__copy ds-control--md\">\n            <ds-text\n              class=\"card-chart__title ds-chrome-header__heading\"\n              variant=\"text-title-small\"\n              emphasis\n              color=\"primary\"\n              as=\"h2\"\n            >\n              {this.heading}\n            </ds-text>\n          </div>\n          <div class=\"card-chart__actions ds-chrome-header__trailing\">\n            {this.showFilter ? (\n              <ds-button-unfilled\n                variant=\"icon\"\n                type=\"button\"\n                icon=\"Filters\"\n                aria-label={this.filterLabel}\n                onDsClick={this.handleFilterClick}\n              />\n            ) : null}\n            <slot name=\"actions\" />\n          </div>\n        </header>\n        <div class=\"card-chart__body\">\n          {usesChartLayout ? (\n            <div class=\"card-chart__layout\">\n              {this.hasChartSlot ? (\n                <div\n                  class={{\n                    'card-chart__chart': true,\n                  }}\n                >\n                  <slot name=\"chart\" />\n                </div>\n              ) : null}\n              {this.hasLegendSlot ? (\n                <div class=\"card-chart__legend\">\n                  <slot name=\"legend\" />\n                </div>\n              ) : null}\n              <slot />\n            </div>\n          ) : (\n            <slot />\n          )}\n        </div>\n      </Host>\n    );\n  }\n}\n",
+      "content": "import { Component, Element, Event, EventEmitter, h, Host, Prop, State } from '@stencil/core';\n\nexport type CardChartWidth = 'sm' | 'md' | 'lg';\nexport type CardChartVariant = 'custom' | 'chart';\n\ntype LegendSlot = HTMLElement & {\n  activeLabel?: string | null;\n  highlightOnHover?: boolean;\n};\n\nconst CARD_WIDTH_VARS: Record<CardChartWidth, string> = {\n  sm: 'var(--dimension-card-width-sm)',\n  md: 'var(--dimension-card-width-md)',\n  lg: 'var(--dimension-card-width-lg)',\n};\n\nconst CARD_HEIGHT_VARS: Record<CardChartWidth, string> = {\n  sm: 'var(--dimension-card-height-sm)',\n  md: 'var(--dimension-card-height-md)',\n  lg: 'var(--dimension-card-height-lg)',\n};\n\n/**\n * Standard chart card chrome and composition. The variant owns\n * only the chart/legend relationship; applications continue to own data.\n */\n@Component({\n  tag: 'ds-card-chart',\n  styleUrl: 'CardChart.css',\n  scoped: true,\n})\nexport class CardChart {\n  @Element() el!: HTMLElement;\n\n  /** Chart heading shown in the card header. */\n  @Prop() heading!: string;\n  /** Chart composition behavior. */\n  @Prop() variant: CardChartVariant = 'custom';\n  /** Width token with the matching chart-card min-height. */\n  @Prop() cardWidth: CardChartWidth = 'md';\n  /** Renders the standard filter action before custom actions. */\n  @Prop() showFilter: boolean = false;\n  @Prop() filterLabel: string = 'Filter';\n  /** Skeletonize the header and chart canvas; custom body content owns its loading atoms. */\n  @Prop() isLoading: boolean = false;\n\n  /** Emits when the standard header filter control is activated. */\n  @Event() dsFilterClick!: EventEmitter<void>;\n\n  @State() private hasChartSlot = false;\n  @State() private hasLegendSlot = false;\n\n  componentWillRender() {\n    this.hasChartSlot = !!this.el.querySelector('[slot=\"chart\"]');\n    this.hasLegendSlot = !!this.el.querySelector('[slot=\"legend\"]');\n  }\n\n  componentDidRender() {\n    const legend = this.el.querySelector('ds-chart-legend[slot=\"legend\"]') as LegendSlot | null;\n    if (this.variant === 'chart' && legend) {\n      legend.setAttribute('highlight-on-hover', 'false');\n      if ('highlightOnHover' in legend) legend.highlightOnHover = false;\n    }\n  }\n\n  private handleFilterClick = () => {\n    if (this.isLoading) return;\n    this.dsFilterClick.emit();\n  };\n\n  render() {\n    const usesChartLayout = this.variant !== 'custom' || this.hasChartSlot;\n    return (\n      <Host\n        class={{\n          'card-chart': true,\n          [`card-chart--${this.variant}`]: true,\n          'card-chart--loading': this.isLoading,\n        }}\n        aria-busy={this.isLoading ? 'true' : undefined}\n        style={{\n          '--_card-chart-width': CARD_WIDTH_VARS[this.cardWidth],\n          '--_card-chart-min-height': CARD_HEIGHT_VARS[this.cardWidth],\n        }}\n      >\n        <header class=\"card-chart__header ds-chrome-header\">\n          <div class=\"card-chart__copy ds-chrome-header__copy ds-control--md\">\n            <ds-text\n              class=\"card-chart__title ds-chrome-header__heading\"\n              variant=\"text-title-small\"\n              emphasis\n              color=\"primary\"\n              as=\"h2\"\n              aria-hidden={this.isLoading ? 'true' : undefined}\n            >\n              {this.heading}\n            </ds-text>\n            {this.isLoading && (\n              <ds-skeleton class=\"card-chart__heading-skeleton\" textVariant=\"text-title-small\" />\n            )}\n          </div>\n          <div class=\"card-chart__actions ds-chrome-header__trailing\">\n            {this.showFilter ? (\n              <ds-skeleton\n                preserveLayout\n                isLoading={this.isLoading}\n                variant=\"control\"\n                controlAppearance=\"outlined\"\n                controlContent=\"icon\"\n              >\n                <ds-button-unfilled\n                  variant=\"icon\"\n                  type=\"button\"\n                  icon=\"Filters\"\n                  aria-label={this.filterLabel}\n                  onDsClick={this.handleFilterClick}\n                />\n              </ds-skeleton>\n            ) : null}\n            <slot name=\"actions\" />\n          </div>\n        </header>\n        <div class=\"card-chart__body\">\n          {usesChartLayout ? (\n            <div class=\"card-chart__layout\">\n              {this.hasChartSlot || this.isLoading ? (\n                <div\n                  class={{\n                    'card-chart__chart': true,\n                  }}\n                >\n                  <slot name=\"chart\" />\n                  {this.isLoading && (\n                    <ds-skeleton class=\"card-chart__plot-skeleton\" variant=\"control\" />\n                  )}\n                </div>\n              ) : null}\n              {this.hasLegendSlot ? (\n                <div class=\"card-chart__legend\">\n                  <slot name=\"legend\" />\n                  {this.isLoading && (\n                    <ds-skeleton\n                      class=\"card-chart__legend-skeleton\"\n                      width=\"min(60%, calc(var(--dimension-size-800) * 2))\"\n                    />\n                  )}\n                </div>\n              ) : null}\n              <slot />\n            </div>\n          ) : (\n            <slot />\n          )}\n        </div>\n      </Host>\n    );\n  }\n}\n",
       "type": "registry:ui"
     }
   ]

package/dist/mcp-data/registry/card-navigation.json

@@ -52,7 +52,8 @@
         "In content mode, the native link owns those interaction states only across the header while the body remains application-owned.",
         "An empty or unsafe href renders non-interactive card chrome without a false keyboard target.",
         "Copy is always stacked, so a missing description keeps the heading at the start of the column instead of centering it in the header.",
-        "The application owns destination loading, authorization, not-found, and recovery states after navigation."
+        "The application owns destination loading, authorization, not-found, and recovery states after navigation.",
+        "isLoading preserves card geometry and copy wrapping while showing skeletons and preventing navigation."
       ],
       "responsiveBehavior": [
         "Choose sm, md, or lg from the parent layout; the surface never exceeds its parent width.",
@@ -155,6 +156,15 @@
           "mutable": false,
           "description": "Destination for the card's native link."
         },
+        "isLoading": {
+          "type": "boolean",
+          "resolvedType": "boolean",
+          "attribute": "is-loading",
+          "default": "false",
+          "required": false,
+          "mutable": false,
+          "description": "Preserve the card layout while its copy and navigation affordance show skeletons."
+        },
         "variant": {
           "type": "CardNavigationVariant",
           "resolvedType": "\"content\" | \"navigation-only\"",
@@ -212,6 +222,15 @@
         "mutable": false,
         "description": "Destination for the card's native link."
       },
+      "isLoading": {
+        "type": "boolean",
+        "resolvedType": "boolean",
+        "attribute": "is-loading",
+        "default": "false",
+        "required": false,
+        "mutable": false,
+        "description": "Preserve the card layout while its copy and navigation affordance show skeletons."
+      },
       "variant": {
         "type": "CardNavigationVariant",
         "resolvedType": "\"content\" | \"navigation-only\"",
@@ -275,17 +294,18 @@
   ],
   "registryDependencies": [
     "icon",
+    "skeleton",
     "text"
   ],
   "files": [
     {
       "path": "src/wc/components/CardNavigation/CardNavigation.css",
-      "content": "@import '../../utils/radius.css';\n@import '../../utils/chrome-header.css';\n@import '../../utils/interaction-fill.css';\n@import '../../utils/focus-ring.css';\n@import '../../utils/forced-colors.css';\n\n:host {\n  position: relative;\n  display: flex;\n  flex-direction: column;\n  box-sizing: border-box;\n  width: var(--_card-navigation-width);\n  max-width: 100%;\n  overflow: hidden;\n  border: none;\n  border-radius: var(--ds-radius-card);\n  background-color: var(--color-background-primary);\n  box-shadow: var(--effect-shadow-elevated-sm);\n}\n\n:host(.card-navigation--content) {\n  min-height: var(--_card-navigation-min-height);\n}\n\n:host::after {\n  content: '';\n  position: absolute;\n  inset: 0;\n  z-index: 4;\n  border-radius: inherit;\n  box-shadow: var(--effect-highlight-elevated-sm);\n  pointer-events: none;\n}\n\n.card-navigation__target {\n  color: inherit;\n  text-decoration: none;\n  cursor: pointer;\n}\n\n.card-navigation__header {\n  flex: 0 0 auto;\n  align-items: flex-start;\n  border-radius: inherit;\n}\n\n:host(.card-navigation--content) .card-navigation__header {\n  border-radius: var(--ds-radius-card) var(--ds-radius-card) 0 0;\n  --ds-interaction-divider-width: var(--dimension-stroke-width-012);\n  --ds-interaction-divider-color: var(--color-border-tertiary);\n}\n\n.card-navigation__copy {\n  min-height: var(--dimension-size-400);\n  justify-content: flex-start;\n}\n\nds-text.card-navigation__title,\nds-text.card-navigation__description {\n  overflow-wrap: anywhere;\n}\n\n.card-navigation__chevron {\n  align-self: center;\n  justify-content: center;\n  width: var(--dimension-size-400);\n  color: var(--color-foreground-secondary);\n}\n\n.card-navigation__body {\n  display: flex;\n  flex: 1 1 auto;\n  flex-direction: column;\n  min-height: 0;\n  box-sizing: border-box;\n  background-color: var(--color-background-primary);\n  border-radius: 0 0 var(--ds-radius-card) var(--ds-radius-card);\n}\n\n@media (forced-colors: active) {\n  :host {\n    box-shadow: none;\n    outline: var(--dimension-stroke-width-012) solid var(--ds-forced-color-content);\n    outline-offset: calc(-1 * var(--dimension-stroke-width-012));\n  }\n\n  :host::after {\n    box-shadow: none;\n  }\n}\n",
+      "content": "@import '../../utils/radius.css';\n@import '../../utils/chrome-header.css';\n@import '../../utils/interaction-fill.css';\n@import '../../utils/focus-ring.css';\n@import '../../utils/forced-colors.css';\n\n:host {\n  position: relative;\n  display: flex;\n  flex-direction: column;\n  box-sizing: border-box;\n  width: var(--_card-navigation-width);\n  max-width: 100%;\n  overflow: hidden;\n  border: none;\n  border-radius: var(--ds-radius-card);\n  background-color: var(--color-background-primary);\n  box-shadow: var(--effect-shadow-elevated-sm);\n}\n\n:host(.card-navigation--content) {\n  min-height: var(--_card-navigation-min-height);\n}\n\n:host::after {\n  content: '';\n  position: absolute;\n  inset: 0;\n  z-index: 4;\n  border-radius: inherit;\n  box-shadow: var(--effect-highlight-elevated-sm);\n  pointer-events: none;\n}\n\n.card-navigation__target {\n  color: inherit;\n  text-decoration: none;\n  cursor: pointer;\n}\n\n.card-navigation__header {\n  flex: 0 0 auto;\n  align-items: flex-start;\n  border-radius: inherit;\n}\n\n:host(.card-navigation--content) .card-navigation__header {\n  border-radius: var(--ds-radius-card) var(--ds-radius-card) 0 0;\n  --ds-interaction-divider-width: var(--dimension-stroke-width-012);\n  --ds-interaction-divider-color: var(--color-border-tertiary);\n}\n\n.card-navigation__copy {\n  min-height: var(--dimension-size-400);\n  justify-content: flex-start;\n}\n\n.card-navigation__line {\n  display: grid;\n  min-width: 0;\n  align-items: start;\n}\n\n.card-navigation__line > * {\n  grid-area: 1 / 1;\n}\n\n:host(.card-navigation--loading) ds-text {\n  visibility: hidden;\n}\n\nds-text.card-navigation__title,\nds-text.card-navigation__description {\n  overflow-wrap: anywhere;\n}\n\n.card-navigation__chevron {\n  align-self: center;\n  justify-content: center;\n  width: var(--dimension-size-400);\n  color: var(--color-foreground-secondary);\n}\n\n.card-navigation__body {\n  display: flex;\n  flex: 1 1 auto;\n  flex-direction: column;\n  min-height: 0;\n  box-sizing: border-box;\n  background-color: var(--color-background-primary);\n  border-radius: 0 0 var(--ds-radius-card) var(--ds-radius-card);\n}\n\n@media (forced-colors: active) {\n  :host {\n    box-shadow: none;\n    outline: var(--dimension-stroke-width-012) solid var(--ds-forced-color-content);\n    outline-offset: calc(-1 * var(--dimension-stroke-width-012));\n  }\n\n  :host::after {\n    box-shadow: none;\n  }\n}\n",
       "type": "registry:ui"
     },
     {
       "path": "src/wc/components/CardNavigation/CardNavigation.tsx",
-      "content": "import { Component, Event, EventEmitter, h, Host, Prop } from '@stencil/core';\nimport { resolveSafeUrl } from '../../utils';\n\nexport type CardNavigationWidth = 'sm' | 'md' | 'lg';\nexport type CardNavigationVariant = 'navigation-only' | 'content';\n\nexport interface CardNavigationDetail {\n  href: string;\n  originalEvent: MouseEvent;\n}\n\nconst CARD_WIDTH_VARS: Record<CardNavigationWidth, string> = {\n  sm: 'var(--dimension-card-width-sm)',\n  md: 'var(--dimension-card-width-md)',\n  lg: 'var(--dimension-card-width-lg)',\n};\n\nconst CARD_HEIGHT_VARS: Record<CardNavigationWidth, string> = {\n  sm: 'var(--dimension-card-height-sm)',\n  md: 'var(--dimension-card-height-md)',\n  lg: 'var(--dimension-card-height-lg)',\n};\n\n@Component({\n  tag: 'ds-card-navigation',\n  styleUrl: 'CardNavigation.css',\n  scoped: true,\n})\nexport class CardNavigation {\n  /** Destination for the card's native link. */\n  @Prop() href!: string;\n\n  /** Section or destination heading shown in the card header. */\n  @Prop() heading!: string;\n\n  /** Optional supporting copy shown below the heading. */\n  @Prop() description: string | undefined;\n\n  /**\n   * `navigation-only` makes the complete card the link. `content` keeps the\n   * header as the link and exposes a non-interactive body slot below it.\n   */\n  @Prop() variant: CardNavigationVariant = 'navigation-only';\n\n  /** Card width token (`sm` / `md` / `lg`). */\n  @Prop() cardWidth: CardNavigationWidth = 'md';\n\n  /**\n   * Emits before native navigation. Prevent this event to take over routing;\n   * the component will then prevent the original link navigation.\n   */\n  @Event({ cancelable: true }) dsNavigate!: EventEmitter<CardNavigationDetail>;\n\n  private handleNavigation(href: string, originalEvent: MouseEvent) {\n    const navigateEvent = this.dsNavigate.emit({ href, originalEvent });\n    if (navigateEvent.defaultPrevented) originalEvent.preventDefault();\n  }\n\n  private renderHeader(href: string | undefined) {\n    const Target = href ? 'a' : 'div';\n    const description = this.description?.trim();\n\n    return (\n      <Target\n        class={{\n          'card-navigation__target': true,\n          'card-navigation__header': true,\n          'ds-chrome-header': true,\n          'ds-interaction-fill': !!href,\n          'ds-focus-ring-inset': !!href,\n        }}\n        href={href}\n        onClick={href ? (event: MouseEvent) => this.handleNavigation(href, event) : undefined}\n      >\n        <div\n          class={{\n            'card-navigation__copy': true,\n            'ds-chrome-header__copy': true,\n            'ds-chrome-header__copy--stacked': true,\n            'ds-control--md': true,\n            'ds-interaction-fill__content': true,\n          }}\n        >\n          <ds-text\n            class=\"card-navigation__title ds-chrome-header__heading\"\n            variant=\"text-title-small\"\n            emphasis\n            color=\"primary\"\n            as=\"h2\"\n          >\n            {this.heading}\n          </ds-text>\n          {description ? (\n            <ds-text\n              class=\"card-navigation__description ds-chrome-header__description\"\n              variant=\"text-body-small\"\n              color=\"secondary\"\n              as=\"span\"\n            >\n              {description}\n            </ds-text>\n          ) : null}\n        </div>\n        <span class=\"card-navigation__chevron ds-chrome-header__trailing ds-interaction-fill__content\">\n          <ds-icon name=\"ChevronRight\" size=\"md\" color=\"inherit\" aria-hidden=\"true\" />\n        </span>\n      </Target>\n    );\n  }\n\n  render() {\n    const href = resolveSafeUrl(this.href);\n    const hasContent = this.variant === 'content';\n\n    return (\n      <Host\n        class={{\n          'card-navigation': true,\n          'card-navigation--navigation-only': !hasContent,\n          'card-navigation--content': hasContent,\n        }}\n        style={{\n          '--_card-navigation-width': CARD_WIDTH_VARS[this.cardWidth],\n          '--_card-navigation-min-height': CARD_HEIGHT_VARS[this.cardWidth],\n        }}\n      >\n        {this.renderHeader(href)}\n        {hasContent ? (\n          <div class=\"card-navigation__body\">\n            <slot />\n          </div>\n        ) : null}\n      </Host>\n    );\n  }\n}\n",
+      "content": "import { Component, Event, EventEmitter, h, Host, Prop } from '@stencil/core';\nimport { resolveSafeUrl } from '../../utils';\n\nexport type CardNavigationWidth = 'sm' | 'md' | 'lg';\nexport type CardNavigationVariant = 'navigation-only' | 'content';\n\nexport interface CardNavigationDetail {\n  href: string;\n  originalEvent: MouseEvent;\n}\n\nconst CARD_WIDTH_VARS: Record<CardNavigationWidth, string> = {\n  sm: 'var(--dimension-card-width-sm)',\n  md: 'var(--dimension-card-width-md)',\n  lg: 'var(--dimension-card-width-lg)',\n};\n\nconst CARD_HEIGHT_VARS: Record<CardNavigationWidth, string> = {\n  sm: 'var(--dimension-card-height-sm)',\n  md: 'var(--dimension-card-height-md)',\n  lg: 'var(--dimension-card-height-lg)',\n};\n\n@Component({\n  tag: 'ds-card-navigation',\n  styleUrl: 'CardNavigation.css',\n  scoped: true,\n})\nexport class CardNavigation {\n  /** Destination for the card's native link. */\n  @Prop() href!: string;\n\n  /** Section or destination heading shown in the card header. */\n  @Prop() heading!: string;\n\n  /** Optional supporting copy shown below the heading. */\n  @Prop() description: string | undefined;\n  /** Preserve the card layout while its copy and navigation affordance show skeletons. */\n  @Prop() isLoading = false;\n\n  /**\n   * `navigation-only` makes the complete card the link. `content` keeps the\n   * header as the link and exposes a non-interactive body slot below it.\n   */\n  @Prop() variant: CardNavigationVariant = 'navigation-only';\n\n  /** Card width token (`sm` / `md` / `lg`). */\n  @Prop() cardWidth: CardNavigationWidth = 'md';\n\n  /**\n   * Emits before native navigation. Prevent this event to take over routing;\n   * the component will then prevent the original link navigation.\n   */\n  @Event({ cancelable: true }) dsNavigate!: EventEmitter<CardNavigationDetail>;\n\n  private handleNavigation(href: string, originalEvent: MouseEvent) {\n    const navigateEvent = this.dsNavigate.emit({ href, originalEvent });\n    if (navigateEvent.defaultPrevented) originalEvent.preventDefault();\n  }\n\n  private renderHeader(href: string | undefined) {\n    const Target = href ? 'a' : 'div';\n    const description = this.description?.trim();\n\n    return (\n      <Target\n        class={{\n          'card-navigation__target': true,\n          'card-navigation__header': true,\n          'ds-chrome-header': true,\n          'ds-interaction-fill': !!href,\n          'ds-focus-ring-inset': !!href,\n        }}\n        href={href}\n        inert={this.isLoading}\n        onClick={href ? (event: MouseEvent) => this.handleNavigation(href, event) : undefined}\n      >\n        <div\n          class={{\n            'card-navigation__copy': true,\n            'ds-chrome-header__copy': true,\n            'ds-chrome-header__copy--stacked': true,\n            'ds-control--md': true,\n            'ds-interaction-fill__content': true,\n          }}\n        >\n          <div class=\"card-navigation__line\">\n            <ds-text\n              class=\"card-navigation__title ds-chrome-header__heading\"\n              variant=\"text-title-small\"\n              emphasis\n              color=\"primary\"\n              as=\"h2\"\n            >\n              {this.heading}\n            </ds-text>\n            {this.isLoading && (\n              <ds-skeleton\n                width=\"min(60%, calc(var(--dimension-size-800) * 2))\"\n                textVariant=\"text-title-small\"\n              />\n            )}\n          </div>\n          {description ? (\n            <div class=\"card-navigation__line\">\n              <ds-text\n                class=\"card-navigation__description ds-chrome-header__description\"\n                variant=\"text-body-small\"\n                color=\"secondary\"\n                as=\"span\"\n              >\n                {description}\n              </ds-text>\n              {this.isLoading && <ds-skeleton width=\"95%\" textVariant=\"text-body-small\" />}\n            </div>\n          ) : null}\n        </div>\n        <span class=\"card-navigation__chevron ds-chrome-header__trailing ds-interaction-fill__content\">\n          {this.isLoading ? (\n            <ds-skeleton variant=\"icon\" iconSize=\"md\" />\n          ) : (\n            <ds-icon name=\"ChevronRight\" size=\"md\" color=\"inherit\" aria-hidden=\"true\" />\n          )}\n        </span>\n      </Target>\n    );\n  }\n\n  render() {\n    const href = this.isLoading ? undefined : resolveSafeUrl(this.href);\n    const hasContent = this.variant === 'content';\n\n    return (\n      <Host\n        aria-busy={this.isLoading ? 'true' : undefined}\n        class={{\n          'card-navigation': true,\n          'card-navigation--loading': this.isLoading,\n          'card-navigation--navigation-only': !hasContent,\n          'card-navigation--content': hasContent,\n        }}\n        style={{\n          '--_card-navigation-width': CARD_WIDTH_VARS[this.cardWidth],\n          '--_card-navigation-min-height': CARD_HEIGHT_VARS[this.cardWidth],\n        }}\n      >\n        {this.renderHeader(href)}\n        {hasContent ? (\n          <div class=\"card-navigation__body\">\n            <slot />\n          </div>\n        ) : null}\n      </Host>\n    );\n  }\n}\n",
       "type": "registry:ui"
     }
   ]

package/dist/mcp-data/registry/card-overview.json

@@ -56,7 +56,7 @@
         "Trend is supplied already resolved as a direction, a formatted value, and a tone. Whether a rise reads well is a product decision, so the component never infers tone from the numbers. Derive it with resolveMetricTrend.",
         "Omit a trend when there is nothing to report; resolveMetricTrend returns null in that case so no zero change is rendered.",
         "Omit score to render a centered Score unavailable cell with a tertiary border and no score fill. Set scoreErrorMessage to replace that copy while the measures remain readable.",
-        "Loading replaces the score and measures with skeletons and does not alter the slotted period control. Score loading replaces only the fill figure; the overview still skeletons the score-copy spacer and trend. When measures are already supplied, their count preserves the resolved grid shape; otherwise five measure placeholders join the score in the standard six-cell grid.",
+        "Loading replaces the score, measures, and fixed period copy with skeletons. The owner supplies loading atoms for slotted controls. Score loading replaces only the fill figure; the overview still skeletons the score-copy spacer and trend. When measures are already supplied, their count preserves the resolved grid shape; otherwise five measure placeholders join the score in the standard six-cell grid.",
         "At most seven measures are shown. Keep larger collections outside the summary bar rather than turning it into a dense dashboard.",
         "The period and filter controls are slotted rather than owned. Use the period slot when the current range is selectable; otherwise periodLabel supplies fixed current copy in the same md control-frame and label-inset anatomy. Use the filter slot for the application-owned comparison-window control. Slotted Selects use hasBorder false so the 48px bar owns their surrounding boundary and allowClear false because both controls always require one selected reporting period.",
         "A numeric safety score infers fair from 0–50, good from 51–80, and excellent from 81–100. The level can be supplied explicitly when the displayed value is not numeric. The deprecated band field is ignored.",
@@ -401,7 +401,7 @@
     },
     {
       "path": "src/wc/components/CardOverview/CardOverview.tsx",
-      "content": "import {\n  Component,\n  Element,\n  Event,\n  EventEmitter,\n  forceUpdate,\n  h,\n  Host,\n  Prop,\n  State,\n} from '@stencil/core';\nimport { resolveCssLengthPx, TOKEN_DEFAULTS } from '../../utils';\nimport { ConnectionTasks } from '../../utils/connection-tasks';\nimport type { TextColor, TextVariant } from '../Text/text-types';\nimport type { MetricTrend } from '../../utils/metric-change';\nimport type {\n  CardOverviewLayout,\n  CardOverviewVariant,\n  OverviewMetric,\n  OverviewScore,\n} from './card-overview-types';\nimport {\n  findNextOverviewMetricIndex,\n  resolveCardOverviewCollapseGeometry,\n  resolveOverviewGridColumns,\n  resolveOverviewRovingIndex,\n} from './card-overview-controller';\n\n/**\n * Metric cells below this width drop a grid column rather than compress further.\n *\n * A literal rather than a token: this is a layout threshold for a grid cell, and\n * the dimension scale has no token for that. The 200px tokens it could borrow\n * (`menu-width-xs`, `form-width-xs`, `panel-width-2xs`) all name other\n * components, so binding to one would couple this grid to an unrelated contract.\n * Consumers override with the `metricMinWidth` prop.\n */\nconst DEFAULT_METRIC_MIN_WIDTH = '200px';\n\n/** Skeleton cells rendered while loading with no metrics supplied yet. */\nconst DEFAULT_LOADING_METRIC_COUNT = 5;\n\n/** Maximum number of comparable measures the summary bar presents at once. */\nconst MAX_METRIC_COUNT = 7;\n\nconst TREND_COLORS: Record<MetricTrend['tone'], TextColor> = {\n  positive: 'var(--color-always-dark-foreground-positive)',\n  negative: 'var(--color-always-dark-foreground-negative)',\n  neutral: 'var(--color-always-dark-foreground-secondary)',\n};\n\nconst ALWAYS_DARK_PRIMARY: TextColor = 'var(--color-always-dark-foreground-primary)';\nconst ALWAYS_DARK_SECONDARY: TextColor = 'var(--color-always-dark-foreground-secondary)';\n\n@Component({\n  tag: 'ds-card-overview',\n  styleUrl: 'CardOverview.css',\n  scoped: true,\n})\nexport class CardOverview {\n  @Element() el!: HTMLElement;\n\n  /** Full summary card, or the condensed 48px summary bar. */\n  @Prop() variant: CardOverviewVariant = 'default';\n\n  /** Intrinsic responsive layout, or a page-owned single-column stack. */\n  @Prop() layout: CardOverviewLayout = 'auto';\n\n  /** Optional nonselectable safety score rendered as the first grid cell. */\n  @Prop() score: OverviewScore | undefined;\n\n  /** Fixed current date or range. Replaced by content in the `period` slot. */\n  @Prop() periodLabel: string = '';\n\n  /** Copy between the current period and comparison control, usually `vs.`. */\n  @Prop() comparisonLabel: string = '';\n\n  /** Measures rendered in the responsive grid. Only the first seven are shown. */\n  @Prop() metrics: OverviewMetric[] = [];\n\n  /**\n   * Width a metric cell may shrink to before the grid drops a column. The grid\n   * uses this threshold while choosing an evenly distributed column count.\n   */\n  @Prop() metricMinWidth: string = DEFAULT_METRIC_MIN_WIDTH;\n\n  /** Replace the score and metrics with skeletons while data resolves. */\n  @Prop() isLoading: boolean = false;\n\n  /** Message shown in place of the score when its figure cannot be resolved. */\n  @Prop() scoreErrorMessage: string | undefined;\n\n  /** Accessible name for the region. */\n  @Prop() overviewLabel: string = 'Overview';\n\n  /**\n   * Page-controlled visual collapse from the full card (`0`) toward its 48px\n   * compact handoff height (`1`). The component preserves its expanded flow\n   * height, keeps the period bar stationary, and moves/clips the grid beneath\n   * it. The page still owns sticky positioning and the final compact handoff.\n   */\n  @Prop() scrollCollapseProgress: number = 0;\n\n  /** Emitted when a metric that is not inactive is activated. */\n  @Event() dsMetricSelect!: EventEmitter<OverviewMetric>;\n\n  /** Roving tab stop across selectable metrics. */\n  @State() private focusedMetricIndex: number = 0;\n  @State() private expandedHeight: number = 0;\n  @State() private gridColumns: number | undefined;\n\n  private layoutEl?: HTMLElement;\n  private layoutResizeObserver: ResizeObserver | null = null;\n  private layoutResizeFrame: number | undefined;\n  private hasLoaded = false;\n  private readonly connectionTasks = new ConnectionTasks(() => this.el.isConnected);\n  /** The node the observer is bound to, which a later render can replace. */\n  private observedLayoutEl?: HTMLElement;\n\n  connectedCallback() {\n    if (this.hasLoaded) this.observeLayout();\n  }\n\n  componentDidLoad() {\n    this.hasLoaded = true;\n    this.observeLayout();\n  }\n\n  componentDidRender() {\n    if (!this.el.isConnected) return;\n    // Re-bind after HMR when DidLoad's observer was dropped, and whenever a\n    // render swapped the layout node out from under the observer: the ref points\n    // at the new node while the observer still watches the detached one, which\n    // never resizes again. The grid would then keep its first measured column\n    // count for the life of the component.\n    if (!this.layoutResizeObserver || this.observedLayoutEl !== this.layoutEl) {\n      this.observeLayout();\n    } else {\n      this.updateLayoutGeometry();\n    }\n  }\n\n  disconnectedCallback() {\n    this.connectionTasks.cancel();\n    this.layoutResizeObserver?.disconnect();\n    this.layoutResizeObserver = null;\n    this.layoutResizeFrame = undefined;\n    this.observedLayoutEl = undefined;\n  }\n\n  private get visibleMetrics(): OverviewMetric[] {\n    return this.metrics.slice(0, MAX_METRIC_COUNT);\n  }\n\n  private get visibleCellCount(): number {\n    const metricCount = this.isLoading ? this.loadingMetricCount : this.visibleMetrics.length;\n    return 1 + metricCount;\n  }\n\n  /** Preserve an authored data shape while loading, or use the standard six-cell grid. */\n  private get loadingMetricCount(): number {\n    return this.visibleMetrics.length || DEFAULT_LOADING_METRIC_COUNT;\n  }\n\n  private get resolvedScrollCollapseProgress(): number {\n    if (this.variant === 'compact' || !Number.isFinite(this.scrollCollapseProgress)) return 0;\n    return Math.min(1, Math.max(0, this.scrollCollapseProgress));\n  }\n\n  private get scrollCollapseGeometry() {\n    const compactHeight = resolveCssLengthPx(TOKEN_DEFAULTS.size600, 48);\n    return resolveCardOverviewCollapseGeometry({\n      variant: this.variant,\n      progress: this.resolvedScrollCollapseProgress,\n      expandedHeight: this.expandedHeight,\n      compactHeight,\n    });\n  }\n\n  private observeLayout() {\n    const layout = this.layoutEl;\n    if (!this.el.isConnected || !layout) return;\n\n    this.connectionTasks.cancelFrame(this.layoutResizeFrame);\n    this.layoutResizeFrame = undefined;\n\n    const bounds = layout.getBoundingClientRect();\n    this.updateLayoutGeometry(bounds.width, bounds.height);\n    if (typeof ResizeObserver === 'undefined') return;\n\n    this.layoutResizeObserver?.disconnect();\n    this.layoutResizeObserver = new ResizeObserver(entries => {\n      const rect = entries[0]?.contentRect;\n      if (!rect) return;\n      this.connectionTasks.cancelFrame(this.layoutResizeFrame);\n      this.layoutResizeFrame = this.connectionTasks.frame(() => {\n        this.layoutResizeFrame = undefined;\n        if (this.layoutEl !== layout) return;\n        this.updateLayoutGeometry(rect.width, rect.height);\n      });\n    });\n    this.layoutResizeObserver.observe(layout);\n    this.observedLayoutEl = layout;\n  }\n\n  private updateLayoutGeometry(width?: number, height?: number) {\n    const layout = this.layoutEl;\n    if (!this.el.isConnected || !layout) return;\n\n    const bounds =\n      width === undefined || height === undefined ? layout.getBoundingClientRect() : null;\n    const resolvedWidth = width ?? bounds?.width ?? 0;\n    const resolvedHeight = height ?? bounds?.height ?? 0;\n\n    let changed = false;\n\n    if (resolvedHeight > 0 && Math.abs(resolvedHeight - this.expandedHeight) >= 0.5) {\n      this.expandedHeight = resolvedHeight;\n      changed = true;\n    }\n\n    const columns = resolveOverviewGridColumns({\n      cellCount: this.visibleCellCount,\n      availableWidth: resolvedWidth,\n      minCellWidth: resolveCssLengthPx(this.metricMinWidth, DEFAULT_METRIC_MIN_WIDTH),\n    });\n    if (columns !== this.gridColumns) {\n      this.gridColumns = columns;\n      changed = true;\n    }\n\n    // The column count is written straight to the host rather than through the\n    // rendered style object. Measurement happens in `componentDidLoad` and in the\n    // ResizeObserver callback, both outside a render cycle, and the host's style\n    // is not patched again after the first render — so a rendered value would stay\n    // pinned to whatever the first paint produced, before any width was known.\n    if (this.gridColumns) {\n      this.el.style.setProperty('--ds-card-overview-grid-columns', String(this.gridColumns));\n    } else {\n      this.el.style.removeProperty('--ds-card-overview-grid-columns');\n    }\n\n    if (changed) forceUpdate(this);\n  }\n\n  /** Index of the roving tab stop, skipping inactive metrics. */\n  private get rovingIndex(): number {\n    return resolveOverviewRovingIndex(this.visibleMetrics, this.focusedMetricIndex);\n  }\n\n  private selectMetric(metric: OverviewMetric, index: number) {\n    if (metric.isInactive) return;\n    this.focusedMetricIndex = index;\n    this.dsMetricSelect.emit(metric);\n  }\n\n  /** Move the roving tab stop, wrapping and skipping inactive metrics. */\n  private moveFocus(from: number, step: number) {\n    const metrics = this.visibleMetrics;\n    const next = findNextOverviewMetricIndex(metrics, from, step < 0 ? -1 : 1);\n    if (next < 0) return;\n\n    this.focusedMetricIndex = next;\n    const cells = this.el.querySelectorAll<HTMLElement>('.card-overview__metric-action');\n    cells[next]?.focus();\n  }\n\n  private handleMetricKeyDown = (event: KeyboardEvent, index: number) => {\n    switch (event.key) {\n      case 'ArrowRight':\n      case 'ArrowDown':\n        event.preventDefault();\n        this.moveFocus(index, 1);\n        break;\n      case 'ArrowLeft':\n      case 'ArrowUp':\n        event.preventDefault();\n        this.moveFocus(index, -1);\n        break;\n      default:\n        break;\n    }\n  };\n\n  /**\n   * A skeleton bar matching the type metrics of the text it stands in for, so the\n   * loading state holds the same shape and rhythm as the resolved content.\n   *\n   * `background` is always passed so the base and shimmer follow the card's\n   * permanently dark surface in both themes.\n   */\n  private bar(textVariant: TextVariant, width: string, className?: string) {\n    return (\n      <ds-skeleton\n        class={className}\n        variant=\"text\"\n        textVariant={textVariant}\n        width={width}\n        background=\"always-dark\"\n      />\n    );\n  }\n\n  /**\n   * Arrow and change in one text node.\n   *\n   * The arrow is a typeface glyph rather than an icon so it inherits the exact\n   * size, weight, and baseline of the value beside it; an icon would need its\n   * own size scale and would drift whenever the type scale changed.\n   *\n   * Tone is supplied by the caller and never inferred here.\n   */\n  private renderTrend(trend: MetricTrend | undefined, variant: TextVariant) {\n    if (!trend) return null;\n    return (\n      <ds-text\n        as=\"span\"\n        class={{\n          'card-overview__trend': true,\n          'ds-control-label-box': true,\n          [`card-overview__trend--${trend.tone}`]: true,\n        }}\n        variant={variant}\n        color={TREND_COLORS[trend.tone]}\n        fontFeature=\"tabular-nums\"\n      >\n        {trend.direction === 'up' ? '↑' : '↓'} {trend.value}\n      </ds-text>\n    );\n  }\n\n  private renderScore() {\n    if (this.isLoading) {\n      return (\n        <div class=\"card-overview__score\" part=\"score\">\n          <div class=\"card-overview__score-content\">\n            <ds-score size=\"lg\" variant=\"dense\" isLoading></ds-score>\n            <div class=\"card-overview__score-copy\">\n              {this.bar(\n                'text-body-small',\n                'var(--dimension-size-800)',\n                'card-overview__score-label-spacer'\n              )}\n              {this.bar(\n                'text-body-medium',\n                'calc(var(--dimension-size-300) + var(--dimension-space-050))'\n              )}\n            </div>\n          </div>\n        </div>\n      );\n    }\n\n    const unavailableMessage =\n      this.scoreErrorMessage || (!this.score ? 'Score unavailable' : undefined);\n    if (unavailableMessage) {\n      return (\n        /* eslint-disable-next-line compomo/prefer-direct-ds-text -- The score track owns the grid divider and 8px outer inset. */\n        <div class=\"card-overview__score\" part=\"score\">\n          <ds-text\n            as=\"span\"\n            class=\"card-overview__score-content card-overview__score-content--error\"\n            variant=\"text-body-medium\"\n            color=\"inherit\"\n            role=\"alert\"\n          >\n            {unavailableMessage}\n          </ds-text>\n        </div>\n      );\n    }\n\n    const score = this.score;\n    if (!score) return null;\n\n    return (\n      <div class=\"card-overview__score\" part=\"score\">\n        <div class=\"card-overview__score-content\">\n          <ds-score\n            size=\"lg\"\n            variant=\"dense\"\n            value={score.value}\n            level={score.level}\n            label=\"Safety score\"\n          />\n          <div class=\"card-overview__score-copy\">\n            <ds-text\n              as=\"span\"\n              class=\"card-overview__score-label-spacer ds-control-label-box\"\n              variant=\"text-body-small\"\n              color={ALWAYS_DARK_SECONDARY}\n              aria-hidden=\"true\"\n            >\n              &nbsp;\n            </ds-text>\n            {this.renderTrend(score.trend, 'text-body-medium')}\n          </div>\n        </div>\n      </div>\n    );\n  }\n\n  private renderMetric(metric: OverviewMetric, index: number) {\n    const selectable = !metric.isInactive;\n    const label = (\n      <ds-text\n        as=\"span\"\n        class=\"card-overview__metric-label ds-control-label-box\"\n        variant=\"text-body-small\"\n        color={ALWAYS_DARK_SECONDARY}\n        wrap=\"nowrap\"\n      >\n        {metric.label}\n      </ds-text>\n    );\n\n    return (\n      <div class=\"card-overview__metric\" part=\"metric\">\n        <div\n          class={{\n            'card-overview__metric-action': true,\n            'card-overview__metric-action--inactive': !selectable,\n            // Selection targets get the shared wash; press scaling is not used here\n            // so the grid keeps its columns aligned. See docs/control-press-policy.md.\n            'ds-interaction-fill': selectable,\n            'ds-interaction-fill--on-always-dark': selectable,\n            'ds-focus-ring-inset': selectable,\n          }}\n          role={selectable ? 'button' : undefined}\n          tabIndex={selectable && index === this.rovingIndex ? 0 : -1}\n          onClick={() => this.selectMetric(metric, index)}\n          onKeyDown={event => this.handleMetricKeyDown(event, index)}\n          onFocusin={() => {\n            if (selectable) this.focusedMetricIndex = index;\n          }}\n        >\n          <div class=\"ds-interaction-fill__content card-overview__metric-content\">\n            {metric.labelTooltip ? (\n              <ds-tooltip label={metric.labelTooltip} side=\"top\" size=\"sm\">\n                {label}\n              </ds-tooltip>\n            ) : (\n              label\n            )}\n            <div class=\"card-overview__metric-figure\">\n              <ds-text\n                as=\"span\"\n                class=\"card-overview__metric-value ds-control-label-box\"\n                variant=\"text-body-medium\"\n                color={ALWAYS_DARK_PRIMARY}\n                wrap=\"nowrap\"\n                fontFeature=\"tabular-nums\"\n              >\n                {metric.value}\n              </ds-text>\n              {this.renderTrend(metric.trend, 'text-body-medium')}\n            </div>\n          </div>\n        </div>\n      </div>\n    );\n  }\n\n  private renderMetrics() {\n    if (this.isLoading) {\n      return [\n        this.renderScore(),\n        ...Array.from({ length: this.loadingMetricCount }, (_, index) => (\n          <div class=\"card-overview__metric\" key={`loading-${index}`}>\n            <div class=\"card-overview__metric-action card-overview__metric-action--inactive\">\n              <div class=\"card-overview__metric-content\">\n                {this.bar('text-body-small', '35%', 'card-overview__metric-label')}\n                <div class=\"card-overview__metric-figure\">\n                  {this.bar('text-body-medium', 'var(--dimension-size-500)')}\n                  {/* Match renderTrend's type canvas and the score trend's 28px width. */}\n                  {this.bar(\n                    'text-body-medium',\n                    'calc(var(--dimension-size-300) + var(--dimension-space-050))'\n                  )}\n                </div>\n              </div>\n            </div>\n          </div>\n        )),\n      ];\n    }\n\n    return [\n      this.renderScore(),\n      ...this.visibleMetrics.map((metric, index) => this.renderMetric(metric, index)),\n    ];\n  }\n\n  render() {\n    const compact = this.variant === 'compact';\n    const collapse = this.scrollCollapseGeometry;\n\n    // Omit absent custom properties rather than handing them an undefined value.\n    // Stencil serialises undefined to the string \"undefined\", which is invalid in\n    // `repeat()` and voids the whole grid-template-columns declaration — the grid\n    // then collapses to one implicit column instead of using the `auto-fit`\n    // fallback baked into the stylesheet.\n    const customProperties: Record<string, string> = {\n      '--ds-card-overview-metric-min': this.metricMinWidth,\n    };\n    if (this.gridColumns) {\n      customProperties['--ds-card-overview-grid-columns'] = String(this.gridColumns);\n    }\n    if (collapse.active) {\n      customProperties['--ds-card-overview-expanded-height'] = `${collapse.expandedHeight}px`;\n      customProperties['--ds-card-overview-visible-height'] = `${collapse.visibleHeight}px`;\n      customProperties['--ds-card-overview-content-offset'] = `${collapse.offset}px`;\n    }\n\n    return (\n      <Host\n        class={{\n          'card-overview': true,\n          'card-overview--compact': compact,\n          'card-overview--stacked': !compact && this.layout === 'stacked',\n          'card-overview--scroll-collapsing': collapse.active,\n        }}\n        role=\"region\"\n        aria-label={this.overviewLabel}\n        aria-busy={this.isLoading ? 'true' : undefined}\n        style={customProperties}\n      >\n        <div\n          class={{\n            'card-overview__surface': true,\n            // Split shadow and inset highlight, so the opaque surface cannot cover\n            // the highlight the way a combined elevation shadow would.\n            'ds-control-elevation': true,\n            'ds-control-elevation--sm': !compact,\n            'ds-control-elevation--floating': compact,\n          }}\n        >\n          <div class=\"card-overview__clip\">\n            <div\n              ref={element => {\n                this.layoutEl = (element as HTMLElement) ?? undefined;\n              }}\n              class={{\n                'card-overview__layout': true,\n              }}\n            >\n              <div class=\"card-overview__summary\">\n                <div class=\"card-overview__header ds-control--md\">\n                  <div class=\"card-overview__period\">\n                    <div class=\"card-overview__period-current\">\n                      <slot name=\"period\">\n                        {this.periodLabel && (\n                          /* eslint-disable-next-line compomo/prefer-direct-ds-text -- Fixed copy uses the same structural frame and label inset as a slotted Select. */\n                          <div class=\"card-overview__period-fixed ds-control-frame\">\n                            <ds-text\n                              as=\"span\"\n                              class=\"ds-control-label-box\"\n                              variant=\"text-body-medium\"\n                              emphasis\n                              color={ALWAYS_DARK_PRIMARY}\n                            >\n                              {this.periodLabel}\n                            </ds-text>\n                          </div>\n                        )}\n                      </slot>\n                    </div>\n                    {this.comparisonLabel && (\n                      <ds-text\n                        as=\"span\"\n                        class=\"card-overview__period-comparison ds-control-label-box\"\n                        variant=\"text-body-medium\"\n                        color={ALWAYS_DARK_SECONDARY}\n                      >\n                        {this.comparisonLabel}\n                      </ds-text>\n                    )}\n                  </div>\n                  <div class=\"card-overview__filter\">\n                    <slot name=\"filter\" />\n                  </div>\n                </div>\n              </div>\n\n              {!compact && (\n                <div class=\"card-overview__body\">\n                  <div class=\"card-overview__metrics\" part=\"metrics\">\n                    {this.renderMetrics()}\n                  </div>\n\n                  <slot name=\"footer\" />\n                </div>\n              )}\n            </div>\n          </div>\n        </div>\n      </Host>\n    );\n  }\n}\n",
+      "content": "import {\n  Component,\n  Element,\n  Event,\n  EventEmitter,\n  forceUpdate,\n  h,\n  Host,\n  Prop,\n  State,\n} from '@stencil/core';\nimport { resolveCssLengthPx, TOKEN_DEFAULTS } from '../../utils';\nimport { ConnectionTasks } from '../../utils/connection-tasks';\nimport type { TextColor, TextVariant } from '../Text/text-types';\nimport type { MetricTrend } from '../../utils/metric-change';\nimport type {\n  CardOverviewLayout,\n  CardOverviewVariant,\n  OverviewMetric,\n  OverviewScore,\n} from './card-overview-types';\nimport {\n  findNextOverviewMetricIndex,\n  resolveCardOverviewCollapseGeometry,\n  resolveOverviewGridColumns,\n  resolveOverviewRovingIndex,\n} from './card-overview-controller';\n\n/**\n * Metric cells below this width drop a grid column rather than compress further.\n *\n * A literal rather than a token: this is a layout threshold for a grid cell, and\n * the dimension scale has no token for that. The 200px tokens it could borrow\n * (`menu-width-xs`, `form-width-xs`, `panel-width-2xs`) all name other\n * components, so binding to one would couple this grid to an unrelated contract.\n * Consumers override with the `metricMinWidth` prop.\n */\nconst DEFAULT_METRIC_MIN_WIDTH = '200px';\n\n/** Skeleton cells rendered while loading with no metrics supplied yet. */\nconst DEFAULT_LOADING_METRIC_COUNT = 5;\n\n/** Maximum number of comparable measures the summary bar presents at once. */\nconst MAX_METRIC_COUNT = 7;\n\nconst TREND_COLORS: Record<MetricTrend['tone'], TextColor> = {\n  positive: 'var(--color-always-dark-foreground-positive)',\n  negative: 'var(--color-always-dark-foreground-negative)',\n  neutral: 'var(--color-always-dark-foreground-secondary)',\n};\n\nconst ALWAYS_DARK_PRIMARY: TextColor = 'var(--color-always-dark-foreground-primary)';\nconst ALWAYS_DARK_SECONDARY: TextColor = 'var(--color-always-dark-foreground-secondary)';\n\n@Component({\n  tag: 'ds-card-overview',\n  styleUrl: 'CardOverview.css',\n  scoped: true,\n})\nexport class CardOverview {\n  @Element() el!: HTMLElement;\n\n  /** Full summary card, or the condensed 48px summary bar. */\n  @Prop() variant: CardOverviewVariant = 'default';\n\n  /** Intrinsic responsive layout, or a page-owned single-column stack. */\n  @Prop() layout: CardOverviewLayout = 'auto';\n\n  /** Optional nonselectable safety score rendered as the first grid cell. */\n  @Prop() score: OverviewScore | undefined;\n\n  /** Fixed current date or range. Replaced by content in the `period` slot. */\n  @Prop() periodLabel: string = '';\n\n  /** Copy between the current period and comparison control, usually `vs.`. */\n  @Prop() comparisonLabel: string = '';\n\n  /** Measures rendered in the responsive grid. Only the first seven are shown. */\n  @Prop() metrics: OverviewMetric[] = [];\n\n  /**\n   * Width a metric cell may shrink to before the grid drops a column. The grid\n   * uses this threshold while choosing an evenly distributed column count.\n   */\n  @Prop() metricMinWidth: string = DEFAULT_METRIC_MIN_WIDTH;\n\n  /** Replace the score and metrics with skeletons while data resolves. */\n  @Prop() isLoading: boolean = false;\n\n  /** Message shown in place of the score when its figure cannot be resolved. */\n  @Prop() scoreErrorMessage: string | undefined;\n\n  /** Accessible name for the region. */\n  @Prop() overviewLabel: string = 'Overview';\n\n  /**\n   * Page-controlled visual collapse from the full card (`0`) toward its 48px\n   * compact handoff height (`1`). The component preserves its expanded flow\n   * height, keeps the period bar stationary, and moves/clips the grid beneath\n   * it. The page still owns sticky positioning and the final compact handoff.\n   */\n  @Prop() scrollCollapseProgress: number = 0;\n\n  /** Emitted when a metric that is not inactive is activated. */\n  @Event() dsMetricSelect!: EventEmitter<OverviewMetric>;\n\n  /** Roving tab stop across selectable metrics. */\n  @State() private focusedMetricIndex: number = 0;\n  @State() private expandedHeight: number = 0;\n  @State() private gridColumns: number | undefined;\n\n  private layoutEl?: HTMLElement;\n  private layoutResizeObserver: ResizeObserver | null = null;\n  private layoutResizeFrame: number | undefined;\n  private hasLoaded = false;\n  private readonly connectionTasks = new ConnectionTasks(() => this.el.isConnected);\n  /** The node the observer is bound to, which a later render can replace. */\n  private observedLayoutEl?: HTMLElement;\n\n  connectedCallback() {\n    if (this.hasLoaded) this.observeLayout();\n  }\n\n  componentDidLoad() {\n    this.hasLoaded = true;\n    this.observeLayout();\n  }\n\n  componentDidRender() {\n    if (!this.el.isConnected) return;\n    // Re-bind after HMR when DidLoad's observer was dropped, and whenever a\n    // render swapped the layout node out from under the observer: the ref points\n    // at the new node while the observer still watches the detached one, which\n    // never resizes again. The grid would then keep its first measured column\n    // count for the life of the component.\n    if (!this.layoutResizeObserver || this.observedLayoutEl !== this.layoutEl) {\n      this.observeLayout();\n    } else {\n      this.updateLayoutGeometry();\n    }\n  }\n\n  disconnectedCallback() {\n    this.connectionTasks.cancel();\n    this.layoutResizeObserver?.disconnect();\n    this.layoutResizeObserver = null;\n    this.layoutResizeFrame = undefined;\n    this.observedLayoutEl = undefined;\n  }\n\n  private get visibleMetrics(): OverviewMetric[] {\n    return this.metrics.slice(0, MAX_METRIC_COUNT);\n  }\n\n  private get visibleCellCount(): number {\n    const metricCount = this.isLoading ? this.loadingMetricCount : this.visibleMetrics.length;\n    return 1 + metricCount;\n  }\n\n  /** Preserve an authored data shape while loading, or use the standard six-cell grid. */\n  private get loadingMetricCount(): number {\n    return this.visibleMetrics.length || DEFAULT_LOADING_METRIC_COUNT;\n  }\n\n  private get resolvedScrollCollapseProgress(): number {\n    if (this.variant === 'compact' || !Number.isFinite(this.scrollCollapseProgress)) return 0;\n    return Math.min(1, Math.max(0, this.scrollCollapseProgress));\n  }\n\n  private get scrollCollapseGeometry() {\n    const compactHeight = resolveCssLengthPx(TOKEN_DEFAULTS.size600, 48);\n    return resolveCardOverviewCollapseGeometry({\n      variant: this.variant,\n      progress: this.resolvedScrollCollapseProgress,\n      expandedHeight: this.expandedHeight,\n      compactHeight,\n    });\n  }\n\n  private observeLayout() {\n    const layout = this.layoutEl;\n    if (!this.el.isConnected || !layout) return;\n\n    this.connectionTasks.cancelFrame(this.layoutResizeFrame);\n    this.layoutResizeFrame = undefined;\n\n    const bounds = layout.getBoundingClientRect();\n    this.updateLayoutGeometry(bounds.width, bounds.height);\n    if (typeof ResizeObserver === 'undefined') return;\n\n    this.layoutResizeObserver?.disconnect();\n    this.layoutResizeObserver = new ResizeObserver(entries => {\n      const rect = entries[0]?.contentRect;\n      if (!rect) return;\n      this.connectionTasks.cancelFrame(this.layoutResizeFrame);\n      this.layoutResizeFrame = this.connectionTasks.frame(() => {\n        this.layoutResizeFrame = undefined;\n        if (this.layoutEl !== layout) return;\n        this.updateLayoutGeometry(rect.width, rect.height);\n      });\n    });\n    this.layoutResizeObserver.observe(layout);\n    this.observedLayoutEl = layout;\n  }\n\n  private updateLayoutGeometry(width?: number, height?: number) {\n    const layout = this.layoutEl;\n    if (!this.el.isConnected || !layout) return;\n\n    const bounds =\n      width === undefined || height === undefined ? layout.getBoundingClientRect() : null;\n    const resolvedWidth = width ?? bounds?.width ?? 0;\n    const resolvedHeight = height ?? bounds?.height ?? 0;\n\n    let changed = false;\n\n    if (resolvedHeight > 0 && Math.abs(resolvedHeight - this.expandedHeight) >= 0.5) {\n      this.expandedHeight = resolvedHeight;\n      changed = true;\n    }\n\n    const columns = resolveOverviewGridColumns({\n      cellCount: this.visibleCellCount,\n      availableWidth: resolvedWidth,\n      minCellWidth: resolveCssLengthPx(this.metricMinWidth, DEFAULT_METRIC_MIN_WIDTH),\n    });\n    if (columns !== this.gridColumns) {\n      this.gridColumns = columns;\n      changed = true;\n    }\n\n    // The column count is written straight to the host rather than through the\n    // rendered style object. Measurement happens in `componentDidLoad` and in the\n    // ResizeObserver callback, both outside a render cycle, and the host's style\n    // is not patched again after the first render — so a rendered value would stay\n    // pinned to whatever the first paint produced, before any width was known.\n    if (this.gridColumns) {\n      this.el.style.setProperty('--ds-card-overview-grid-columns', String(this.gridColumns));\n    } else {\n      this.el.style.removeProperty('--ds-card-overview-grid-columns');\n    }\n\n    if (changed) forceUpdate(this);\n  }\n\n  /** Index of the roving tab stop, skipping inactive metrics. */\n  private get rovingIndex(): number {\n    return resolveOverviewRovingIndex(this.visibleMetrics, this.focusedMetricIndex);\n  }\n\n  private selectMetric(metric: OverviewMetric, index: number) {\n    if (metric.isInactive) return;\n    this.focusedMetricIndex = index;\n    this.dsMetricSelect.emit(metric);\n  }\n\n  /** Move the roving tab stop, wrapping and skipping inactive metrics. */\n  private moveFocus(from: number, step: number) {\n    const metrics = this.visibleMetrics;\n    const next = findNextOverviewMetricIndex(metrics, from, step < 0 ? -1 : 1);\n    if (next < 0) return;\n\n    this.focusedMetricIndex = next;\n    const cells = this.el.querySelectorAll<HTMLElement>('.card-overview__metric-action');\n    cells[next]?.focus();\n  }\n\n  private handleMetricKeyDown = (event: KeyboardEvent, index: number) => {\n    switch (event.key) {\n      case 'ArrowRight':\n      case 'ArrowDown':\n        event.preventDefault();\n        this.moveFocus(index, 1);\n        break;\n      case 'ArrowLeft':\n      case 'ArrowUp':\n        event.preventDefault();\n        this.moveFocus(index, -1);\n        break;\n      default:\n        break;\n    }\n  };\n\n  /**\n   * A skeleton bar matching the type metrics of the text it stands in for, so the\n   * loading state holds the same shape and rhythm as the resolved content.\n   *\n   * `background` is always passed so the base and shimmer follow the card's\n   * permanently dark surface in both themes.\n   */\n  private bar(textVariant: TextVariant, width: string, className?: string) {\n    return (\n      <ds-skeleton\n        class={className}\n        variant=\"text\"\n        textVariant={textVariant}\n        width={width}\n        background=\"always-dark\"\n      />\n    );\n  }\n\n  /**\n   * Arrow and change in one text node.\n   *\n   * The arrow is a typeface glyph rather than an icon so it inherits the exact\n   * size, weight, and baseline of the value beside it; an icon would need its\n   * own size scale and would drift whenever the type scale changed.\n   *\n   * Tone is supplied by the caller and never inferred here.\n   */\n  private renderTrend(trend: MetricTrend | undefined, variant: TextVariant) {\n    if (!trend) return null;\n    return (\n      <ds-text\n        as=\"span\"\n        class={{\n          'card-overview__trend': true,\n          'ds-control-label-box': true,\n          [`card-overview__trend--${trend.tone}`]: true,\n        }}\n        variant={variant}\n        color={TREND_COLORS[trend.tone]}\n        fontFeature=\"tabular-nums\"\n      >\n        {trend.direction === 'up' ? '↑' : '↓'} {trend.value}\n      </ds-text>\n    );\n  }\n\n  private renderScore() {\n    if (this.isLoading) {\n      return (\n        <div class=\"card-overview__score\" part=\"score\">\n          <div class=\"card-overview__score-content\">\n            <ds-score size=\"lg\" variant=\"dense\" isLoading></ds-score>\n            <div class=\"card-overview__score-copy\">\n              {this.bar(\n                'text-body-small',\n                'var(--dimension-size-800)',\n                'card-overview__score-label-spacer'\n              )}\n              {this.bar(\n                'text-body-medium',\n                'calc(var(--dimension-size-300) + var(--dimension-space-050))'\n              )}\n            </div>\n          </div>\n        </div>\n      );\n    }\n\n    const unavailableMessage =\n      this.scoreErrorMessage || (!this.score ? 'Score unavailable' : undefined);\n    if (unavailableMessage) {\n      return (\n        /* eslint-disable-next-line compomo/prefer-direct-ds-text -- The score track owns the grid divider and 8px outer inset. */\n        <div class=\"card-overview__score\" part=\"score\">\n          <ds-text\n            as=\"span\"\n            class=\"card-overview__score-content card-overview__score-content--error\"\n            variant=\"text-body-medium\"\n            color=\"inherit\"\n            role=\"alert\"\n          >\n            {unavailableMessage}\n          </ds-text>\n        </div>\n      );\n    }\n\n    const score = this.score;\n    if (!score) return null;\n\n    return (\n      <div class=\"card-overview__score\" part=\"score\">\n        <div class=\"card-overview__score-content\">\n          <ds-score\n            size=\"lg\"\n            variant=\"dense\"\n            value={score.value}\n            level={score.level}\n            label=\"Safety score\"\n          />\n          <div class=\"card-overview__score-copy\">\n            <ds-text\n              as=\"span\"\n              class=\"card-overview__score-label-spacer ds-control-label-box\"\n              variant=\"text-body-small\"\n              color={ALWAYS_DARK_SECONDARY}\n              aria-hidden=\"true\"\n            >\n              &nbsp;\n            </ds-text>\n            {this.renderTrend(score.trend, 'text-body-medium')}\n          </div>\n        </div>\n      </div>\n    );\n  }\n\n  private renderMetric(metric: OverviewMetric, index: number) {\n    const selectable = !metric.isInactive;\n    const label = (\n      <ds-text\n        as=\"span\"\n        class=\"card-overview__metric-label ds-control-label-box\"\n        variant=\"text-body-small\"\n        color={ALWAYS_DARK_SECONDARY}\n        wrap=\"nowrap\"\n      >\n        {metric.label}\n      </ds-text>\n    );\n\n    return (\n      <div class=\"card-overview__metric\" part=\"metric\">\n        <div\n          class={{\n            'card-overview__metric-action': true,\n            'card-overview__metric-action--inactive': !selectable,\n            // Selection targets get the shared wash; press scaling is not used here\n            // so the grid keeps its columns aligned. See docs/control-press-policy.md.\n            'ds-interaction-fill': selectable,\n            'ds-interaction-fill--on-always-dark': selectable,\n            'ds-focus-ring-inset': selectable,\n          }}\n          role={selectable ? 'button' : undefined}\n          tabIndex={selectable && index === this.rovingIndex ? 0 : -1}\n          onClick={() => this.selectMetric(metric, index)}\n          onKeyDown={event => this.handleMetricKeyDown(event, index)}\n          onFocusin={() => {\n            if (selectable) this.focusedMetricIndex = index;\n          }}\n        >\n          <div class=\"ds-interaction-fill__content card-overview__metric-content\">\n            {metric.labelTooltip ? (\n              <ds-tooltip label={metric.labelTooltip} side=\"top\" size=\"sm\">\n                {label}\n              </ds-tooltip>\n            ) : (\n              label\n            )}\n            <div class=\"card-overview__metric-figure\">\n              <ds-text\n                as=\"span\"\n                class=\"card-overview__metric-value ds-control-label-box\"\n                variant=\"text-body-medium\"\n                color={ALWAYS_DARK_PRIMARY}\n                wrap=\"nowrap\"\n                fontFeature=\"tabular-nums\"\n              >\n                {metric.value}\n              </ds-text>\n              {this.renderTrend(metric.trend, 'text-body-medium')}\n            </div>\n          </div>\n        </div>\n      </div>\n    );\n  }\n\n  private renderMetrics() {\n    if (this.isLoading) {\n      return [\n        this.renderScore(),\n        ...Array.from({ length: this.loadingMetricCount }, (_, index) => (\n          <div class=\"card-overview__metric\" key={`loading-${index}`}>\n            <div class=\"card-overview__metric-action card-overview__metric-action--inactive\">\n              <div class=\"card-overview__metric-content\">\n                {this.bar('text-body-small', '35%', 'card-overview__metric-label')}\n                <div class=\"card-overview__metric-figure\">\n                  {this.bar('text-body-medium', 'var(--dimension-size-500)')}\n                  {/* Match renderTrend's type canvas and the score trend's 28px width. */}\n                  {this.bar(\n                    'text-body-medium',\n                    'calc(var(--dimension-size-300) + var(--dimension-space-050))'\n                  )}\n                </div>\n              </div>\n            </div>\n          </div>\n        )),\n      ];\n    }\n\n    return [\n      this.renderScore(),\n      ...this.visibleMetrics.map((metric, index) => this.renderMetric(metric, index)),\n    ];\n  }\n\n  render() {\n    const compact = this.variant === 'compact';\n    const collapse = this.scrollCollapseGeometry;\n\n    // Omit absent custom properties rather than handing them an undefined value.\n    // Stencil serialises undefined to the string \"undefined\", which is invalid in\n    // `repeat()` and voids the whole grid-template-columns declaration — the grid\n    // then collapses to one implicit column instead of using the `auto-fit`\n    // fallback baked into the stylesheet.\n    const customProperties: Record<string, string> = {\n      '--ds-card-overview-metric-min': this.metricMinWidth,\n    };\n    if (this.gridColumns) {\n      customProperties['--ds-card-overview-grid-columns'] = String(this.gridColumns);\n    }\n    if (collapse.active) {\n      customProperties['--ds-card-overview-expanded-height'] = `${collapse.expandedHeight}px`;\n      customProperties['--ds-card-overview-visible-height'] = `${collapse.visibleHeight}px`;\n      customProperties['--ds-card-overview-content-offset'] = `${collapse.offset}px`;\n    }\n\n    return (\n      <Host\n        class={{\n          'card-overview': true,\n          'card-overview--compact': compact,\n          'card-overview--stacked': !compact && this.layout === 'stacked',\n          'card-overview--scroll-collapsing': collapse.active,\n        }}\n        role=\"region\"\n        aria-label={this.overviewLabel}\n        aria-busy={this.isLoading ? 'true' : undefined}\n        style={customProperties}\n      >\n        <div\n          class={{\n            'card-overview__surface': true,\n            // Split shadow and inset highlight, so the opaque surface cannot cover\n            // the highlight the way a combined elevation shadow would.\n            'ds-control-elevation': true,\n            'ds-control-elevation--sm': !compact,\n            'ds-control-elevation--floating': compact,\n          }}\n        >\n          <div class=\"card-overview__clip\">\n            <div\n              ref={element => {\n                this.layoutEl = (element as HTMLElement) ?? undefined;\n              }}\n              class={{\n                'card-overview__layout': true,\n              }}\n            >\n              <div class=\"card-overview__summary\">\n                <div class=\"card-overview__header ds-control--md\">\n                  <div class=\"card-overview__period\">\n                    <div class=\"card-overview__period-current\">\n                      <slot name=\"period\">\n                        {this.periodLabel && (\n                          <div class=\"card-overview__period-fixed ds-control-frame\">\n                            <ds-skeleton\n                              preserveLayout\n                              isLoading={this.isLoading}\n                              background=\"always-dark\"\n                            >\n                              <ds-text\n                                as=\"span\"\n                                class=\"ds-control-label-box\"\n                                variant=\"text-body-medium\"\n                                emphasis\n                                color={ALWAYS_DARK_PRIMARY}\n                              >\n                                {this.periodLabel}\n                              </ds-text>\n                            </ds-skeleton>\n                          </div>\n                        )}\n                      </slot>\n                    </div>\n                    {this.comparisonLabel && (\n                      <ds-skeleton\n                        class=\"card-overview__period-comparison\"\n                        preserveLayout\n                        isLoading={this.isLoading}\n                        background=\"always-dark\"\n                      >\n                        <ds-text\n                          as=\"span\"\n                          class=\"ds-control-label-box\"\n                          variant=\"text-body-medium\"\n                          color={ALWAYS_DARK_SECONDARY}\n                        >\n                          {this.comparisonLabel}\n                        </ds-text>\n                      </ds-skeleton>\n                    )}\n                  </div>\n                  <div class=\"card-overview__filter\">\n                    <slot name=\"filter\" />\n                  </div>\n                </div>\n              </div>\n\n              {!compact && (\n                <div class=\"card-overview__body\">\n                  <div class=\"card-overview__metrics\" part=\"metrics\">\n                    {this.renderMetrics()}\n                  </div>\n\n                  <slot name=\"footer\" />\n                </div>\n              )}\n            </div>\n          </div>\n        </div>\n      </Host>\n    );\n  }\n}\n",
       "type": "registry:ui"
     },
     {

package/dist/mcp-data/registry/card-setting.json

@@ -71,7 +71,8 @@
         "The parent owns read-only versus editable body composition, dirty state, validation, persistence, loading, success, and error consequences.",
         "A save request keeps the section editing while validation or persistence is pending; the parent exits only after success.",
         "A cancel request does not persist changes; the parent restores its chosen value snapshot and exits editing.",
-        "The immediate variant keeps the resting card surface and omits header actions even if editing is supplied. The application applies and persists each control change independently."
+        "The immediate variant keeps the resting card surface and omits header actions even if editing is supplied. The application applies and persists each control change independently.",
+        "isLoading replaces header copy and actions with skeletons while retaining card geometry; projected body loading remains owned by the application."
       ],
       "responsiveBehavior": [
         "Choose sm, md, or lg from the parent layout. Empty editable cards use the matching minimum height. Cards with body content, and immediate cards, fit that content.",
@@ -191,6 +192,15 @@
           "mutable": false,
           "description": "Section heading shown in the card header."
         },
+        "isLoading": {
+          "type": "boolean",
+          "resolvedType": "boolean",
+          "attribute": "is-loading",
+          "default": "false",
+          "required": false,
+          "mutable": false,
+          "description": "Keep the card and projected content in place while its header shows skeletons."
+        },
         "saveLabel": {
           "type": "string",
           "resolvedType": "string",
@@ -265,6 +275,15 @@
         "mutable": false,
         "description": "Section heading shown in the card header."
       },
+      "isLoading": {
+        "type": "boolean",
+        "resolvedType": "boolean",
+        "attribute": "is-loading",
+        "default": "false",
+        "required": false,
+        "mutable": false,
+        "description": "Keep the card and projected content in place while its header shows skeletons."
+      },
       "saveLabel": {
         "type": "string",
         "resolvedType": "string",
@@ -336,17 +355,18 @@
   "registryDependencies": [
     "button-filled",
     "button-unfilled",
+    "skeleton",
     "text"
   ],
   "files": [
     {
       "path": "src/wc/components/CardSetting/CardSetting.css",
-      "content": "@import '../../utils/radius.css';\n@import '../../utils/chrome-header.css';\n@import '../../utils/forced-colors.css';\n\n:host {\n  position: relative;\n  display: flex;\n  flex-direction: column;\n  box-sizing: border-box;\n  width: var(--_card-setting-width);\n  min-height: var(--_card-setting-min-height);\n  max-width: 100%;\n  overflow: hidden;\n  border: none;\n  border-radius: var(--ds-radius-card);\n  background-color: var(--color-background-primary);\n  box-shadow: var(--effect-shadow-elevated-sm);\n}\n\n:host::after {\n  content: '';\n  position: absolute;\n  inset: 0;\n  z-index: 4;\n  border-radius: inherit;\n  box-shadow: var(--effect-highlight-elevated-sm);\n  pointer-events: none;\n}\n\n:host(.card-setting--editing) {\n  background-color: var(--color-background-bold-brand);\n  box-shadow: 0 0 0 var(--dimension-stroke-width-025) var(--color-border-bold-brand);\n}\n\n:host(.card-setting--editing)::after {\n  box-shadow: none;\n}\n\n.card-setting__header {\n  flex: 0 0 auto;\n  border-bottom: var(--dimension-stroke-width-012) solid var(--color-border-tertiary);\n}\n\n:host(.card-setting--editing) .card-setting__header {\n  border-bottom-color: transparent;\n}\n\n.card-setting__copy {\n  align-items: center;\n}\n\nds-text.card-setting__title {\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n  -webkit-user-select: none;\n  user-select: none;\n}\n\n.card-setting__actions {\n  flex-shrink: 0;\n}\n\n.card-setting__panel {\n  display: flex;\n  flex: 1 1 auto;\n  flex-direction: column;\n  min-height: 0;\n  box-sizing: border-box;\n  background-color: var(--color-background-primary);\n  border-radius: 0 0 var(--ds-radius-card) var(--ds-radius-card);\n}\n\n:host(.card-setting--editing) .card-setting__panel {\n  border-radius: var(--ds-radius-card);\n}\n\n.card-setting__banner {\n  flex: 0 0 auto;\n  min-width: 0;\n}\n\n.card-setting__banner--empty {\n  display: none;\n}\n\n.card-setting__body {\n  display: flex;\n  flex: 1 1 auto;\n  flex-direction: column;\n  min-height: 0;\n  box-sizing: border-box;\n  padding-block: var(--dimension-space-100);\n}\n\n@media (forced-colors: active) {\n  :host {\n    box-shadow: none;\n    outline: var(--dimension-stroke-width-012) solid var(--ds-forced-color-content);\n    outline-offset: calc(-1 * var(--dimension-stroke-width-012));\n  }\n\n  :host::after {\n    box-shadow: none;\n  }\n}\n",
+      "content": "@import '../../utils/radius.css';\n@import '../../utils/chrome-header.css';\n@import '../../utils/forced-colors.css';\n\n:host {\n  position: relative;\n  display: flex;\n  flex-direction: column;\n  box-sizing: border-box;\n  width: var(--_card-setting-width);\n  min-height: var(--_card-setting-min-height);\n  max-width: 100%;\n  overflow: hidden;\n  border: none;\n  border-radius: var(--ds-radius-card);\n  background-color: var(--color-background-primary);\n  box-shadow: var(--effect-shadow-elevated-sm);\n}\n\n:host::after {\n  content: '';\n  position: absolute;\n  inset: 0;\n  z-index: 4;\n  border-radius: inherit;\n  box-shadow: var(--effect-highlight-elevated-sm);\n  pointer-events: none;\n}\n\n:host(.card-setting--editing) {\n  background-color: var(--color-background-bold-brand);\n  box-shadow: 0 0 0 var(--dimension-stroke-width-025) var(--color-border-bold-brand);\n}\n\n:host(.card-setting--editing)::after {\n  box-shadow: none;\n}\n\n.card-setting__header {\n  flex: 0 0 auto;\n  border-bottom: var(--dimension-stroke-width-012) solid var(--color-border-tertiary);\n}\n\n:host(.card-setting--editing) .card-setting__header {\n  border-bottom-color: transparent;\n}\n\n.card-setting__copy {\n  align-items: center;\n  position: relative;\n}\n\nds-text.card-setting__title {\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n  -webkit-user-select: none;\n  user-select: none;\n}\n\n.card-setting__actions {\n  flex-shrink: 0;\n  position: relative;\n}\n\n:host(.card-setting--loading) .card-setting__title {\n  visibility: hidden;\n}\n\n.card-setting__heading-skeleton {\n  position: absolute;\n  inset-inline-start: var(--dimension-space-100);\n}\n\n.card-setting__panel {\n  display: flex;\n  flex: 1 1 auto;\n  flex-direction: column;\n  min-height: 0;\n  box-sizing: border-box;\n  background-color: var(--color-background-primary);\n  border-radius: 0 0 var(--ds-radius-card) var(--ds-radius-card);\n}\n\n:host(.card-setting--editing) .card-setting__panel {\n  border-radius: var(--ds-radius-card);\n}\n\n.card-setting__banner {\n  flex: 0 0 auto;\n  min-width: 0;\n}\n\n.card-setting__banner--empty {\n  display: none;\n}\n\n.card-setting__body {\n  display: flex;\n  flex: 1 1 auto;\n  flex-direction: column;\n  min-height: 0;\n  box-sizing: border-box;\n  padding-block: var(--dimension-space-100);\n}\n\n@media (forced-colors: active) {\n  :host {\n    box-shadow: none;\n    outline: var(--dimension-stroke-width-012) solid var(--ds-forced-color-content);\n    outline-offset: calc(-1 * var(--dimension-stroke-width-012));\n  }\n\n  :host::after {\n    box-shadow: none;\n  }\n}\n",
       "type": "registry:ui"
     },
     {
       "path": "src/wc/components/CardSetting/CardSetting.tsx",
-      "content": "import { Component, Element, Event, EventEmitter, h, Host, Prop, State } from '@stencil/core';\n\nexport type CardSettingVariant = 'editable' | 'immediate';\nexport type CardSettingWidth = 'sm' | 'md' | 'lg';\nexport type CardSettingAction = 'edit' | 'save' | 'cancel';\n\nexport interface CardSettingActionDetail {\n  action: CardSettingAction;\n  originalEvent: MouseEvent;\n}\n\nconst CARD_WIDTH_VARS: Record<CardSettingWidth, string> = {\n  sm: 'var(--dimension-card-width-sm)',\n  md: 'var(--dimension-card-width-md)',\n  lg: 'var(--dimension-card-width-lg)',\n};\n\nconst CARD_HEIGHT_VARS: Record<CardSettingWidth, string> = {\n  sm: 'var(--dimension-card-height-sm)',\n  md: 'var(--dimension-card-height-md)',\n  lg: 'var(--dimension-card-height-lg)',\n};\n\nconst FAINT_BRAND_TITLE_COLOR = 'var(--color-foreground-faint-brand)';\n\nconst isRenderableNode = (node: Node): boolean => {\n  if (node.nodeType === Node.ELEMENT_NODE) {\n    return (node as Element).tagName !== 'SLOT';\n  }\n  return node.nodeType === Node.TEXT_NODE && Boolean(node.textContent?.trim());\n};\n\nconst slotName = (node: Node): string | null =>\n  node.nodeType === Node.ELEMENT_NODE ? (node as Element).getAttribute('slot') : null;\n\nconst isDefaultSlottedNode = (node: Node): boolean => isRenderableNode(node) && !slotName(node);\n\nconst isBannerSlottedNode = (node: Node): boolean =>\n  isRenderableNode(node) && slotName(node) === 'banner';\n\nconst slotHasRenderableContent = (slot: HTMLSlotElement | null): boolean =>\n  Boolean(slot?.assignedNodes({ flatten: true }).some(isRenderableNode));\n\n@Component({\n  tag: 'ds-card-setting',\n  styleUrl: 'CardSetting.css',\n  scoped: true,\n})\nexport class CardSetting {\n  @Element() el!: HTMLElement;\n\n  /** Section heading shown in the card header. */\n  @Prop() heading!: string;\n\n  /**\n   * Card width token (`sm` / `md` / `lg`). Empty editable cards use the matching\n   * minimum-height token. Cards with body content, and immediate cards, fit\n   * that content.\n   */\n  @Prop() cardWidth: CardSettingWidth = 'md';\n\n  /** Immediate settings omit edit actions and apply changes through their own controls. */\n  @Prop() variant: CardSettingVariant = 'editable';\n\n  /** Controlled edit state — parent owns single-edit orchestration. */\n  @Prop() editing = false;\n  @Prop() editLabel: string = 'Edit';\n  @Prop() cancelLabel: string = 'Cancel';\n  @Prop() saveLabel: string = 'Save';\n\n  /** Emits a controlled edit, save, or cancel request. */\n  @Event() dsAction!: EventEmitter<CardSettingActionDetail>;\n\n  @State() private hasBannerContent = false;\n  @State() private hasBodyContent = false;\n\n  componentWillLoad() {\n    const nodes = Array.from(this.el.childNodes);\n    this.hasBannerContent = nodes.some(isBannerSlottedNode);\n    this.hasBodyContent = nodes.some(isDefaultSlottedNode);\n  }\n\n  componentDidLoad() {\n    this.syncBannerContent();\n    this.syncBodyContent();\n  }\n\n  private emitAction(action: CardSettingAction, originalEvent: MouseEvent) {\n    this.dsAction.emit({ action, originalEvent });\n  }\n\n  private readSlotContent(\n    event: Event | undefined,\n    slotSelector: string,\n    containerSelector: string\n  ): boolean {\n    const slot =\n      event?.target instanceof HTMLSlotElement\n        ? event.target\n        : this.el.querySelector<HTMLSlotElement>(slotSelector);\n    if (slotHasRenderableContent(slot)) return true;\n    const container = this.el.querySelector(containerSelector);\n    return Array.from(container?.childNodes ?? []).some(isRenderableNode);\n  }\n\n  private syncBannerContent = (event?: Event) => {\n    const hasContent = this.readSlotContent(\n      event,\n      ':scope > .card-setting__panel > .card-setting__banner > slot',\n      ':scope > .card-setting__panel > .card-setting__banner'\n    );\n    if (hasContent !== this.hasBannerContent) this.hasBannerContent = hasContent;\n  };\n\n  private syncBodyContent = (event?: Event) => {\n    const hasContent = this.readSlotContent(\n      event,\n      ':scope > .card-setting__panel > .card-setting__body > slot',\n      ':scope > .card-setting__panel > .card-setting__body'\n    );\n    if (hasContent !== this.hasBodyContent) this.hasBodyContent = hasContent;\n  };\n\n  private get hugContent(): boolean {\n    return this.variant === 'immediate' || this.hasBannerContent || this.hasBodyContent;\n  }\n\n  render() {\n    const editing = this.variant === 'editable' && this.editing;\n\n    return (\n      <Host\n        class={{\n          'card-setting': true,\n          'card-setting--editing': editing,\n          'card-setting--immediate': this.variant === 'immediate',\n          'card-setting--empty': !this.hugContent,\n        }}\n        style={{\n          '--_card-setting-width': CARD_WIDTH_VARS[this.cardWidth],\n          '--_card-setting-min-height': this.hugContent ? '0' : CARD_HEIGHT_VARS[this.cardWidth],\n        }}\n      >\n        <header class=\"card-setting__header ds-chrome-header\">\n          {/* eslint-disable-next-line compomo/prefer-direct-ds-text -- Shared header copy owns the control-density geometry around the semantic heading. */}\n          <div class=\"card-setting__copy ds-chrome-header__copy ds-control--md\">\n            <ds-text\n              class=\"card-setting__title ds-chrome-header__heading\"\n              variant=\"text-title-small\"\n              emphasis\n              color={editing ? FAINT_BRAND_TITLE_COLOR : 'primary'}\n              as=\"h2\"\n            >\n              {this.heading}\n            </ds-text>\n          </div>\n          {this.variant === 'editable' && (\n            <div class=\"card-setting__actions ds-chrome-header__trailing\">\n              {!editing ? (\n                <ds-button-unfilled\n                  variant=\"icon\"\n                  type=\"button\"\n                  icon=\"Pencil\"\n                  aria-label={this.editLabel}\n                  onDsClick={(event: CustomEvent<MouseEvent>) =>\n                    this.emitAction('edit', event.detail)\n                  }\n                />\n              ) : (\n                [\n                  <ds-button-unfilled\n                    key=\"cancel\"\n                    variant=\"icon\"\n                    type=\"button\"\n                    icon=\"Cross\"\n                    background=\"bold\"\n                    aria-label={this.cancelLabel}\n                    onDsClick={(event: CustomEvent<MouseEvent>) =>\n                      this.emitAction('cancel', event.detail)\n                    }\n                  />,\n                  <ds-button-filled\n                    key=\"save\"\n                    variant=\"icon\"\n                    type=\"button\"\n                    icon=\"Check\"\n                    intent=\"brand\"\n                    contrast=\"faint\"\n                    aria-label={this.saveLabel}\n                    onDsClick={(event: CustomEvent<MouseEvent>) =>\n                      this.emitAction('save', event.detail)\n                    }\n                  />,\n                ]\n              )}\n            </div>\n          )}\n        </header>\n        <div class=\"card-setting__panel\">\n          <div\n            class={{\n              'card-setting__banner': true,\n              'card-setting__banner--empty': !this.hasBannerContent,\n            }}\n          >\n            <slot name=\"banner\" onSlotchange={this.syncBannerContent} />\n          </div>\n          <div class=\"card-setting__body\">\n            <slot onSlotchange={this.syncBodyContent} />\n          </div>\n        </div>\n      </Host>\n    );\n  }\n}\n",
+      "content": "import { Component, Element, Event, EventEmitter, h, Host, Prop, State } from '@stencil/core';\n\nexport type CardSettingVariant = 'editable' | 'immediate';\nexport type CardSettingWidth = 'sm' | 'md' | 'lg';\nexport type CardSettingAction = 'edit' | 'save' | 'cancel';\n\nexport interface CardSettingActionDetail {\n  action: CardSettingAction;\n  originalEvent: MouseEvent;\n}\n\nconst CARD_WIDTH_VARS: Record<CardSettingWidth, string> = {\n  sm: 'var(--dimension-card-width-sm)',\n  md: 'var(--dimension-card-width-md)',\n  lg: 'var(--dimension-card-width-lg)',\n};\n\nconst CARD_HEIGHT_VARS: Record<CardSettingWidth, string> = {\n  sm: 'var(--dimension-card-height-sm)',\n  md: 'var(--dimension-card-height-md)',\n  lg: 'var(--dimension-card-height-lg)',\n};\n\nconst FAINT_BRAND_TITLE_COLOR = 'var(--color-foreground-faint-brand)';\n\nconst isRenderableNode = (node: Node): boolean => {\n  if (node.nodeType === Node.ELEMENT_NODE) {\n    return (node as Element).tagName !== 'SLOT';\n  }\n  return node.nodeType === Node.TEXT_NODE && Boolean(node.textContent?.trim());\n};\n\nconst slotName = (node: Node): string | null =>\n  node.nodeType === Node.ELEMENT_NODE ? (node as Element).getAttribute('slot') : null;\n\nconst isDefaultSlottedNode = (node: Node): boolean => isRenderableNode(node) && !slotName(node);\n\nconst isBannerSlottedNode = (node: Node): boolean =>\n  isRenderableNode(node) && slotName(node) === 'banner';\n\nconst slotHasRenderableContent = (slot: HTMLSlotElement | null): boolean =>\n  Boolean(slot?.assignedNodes({ flatten: true }).some(isRenderableNode));\n\n@Component({\n  tag: 'ds-card-setting',\n  styleUrl: 'CardSetting.css',\n  scoped: true,\n})\nexport class CardSetting {\n  @Element() el!: HTMLElement;\n\n  /** Section heading shown in the card header. */\n  @Prop() heading!: string;\n\n  /**\n   * Card width token (`sm` / `md` / `lg`). Empty editable cards use the matching\n   * minimum-height token. Cards with body content, and immediate cards, fit\n   * that content.\n   */\n  @Prop() cardWidth: CardSettingWidth = 'md';\n\n  /** Immediate settings omit edit actions and apply changes through their own controls. */\n  @Prop() variant: CardSettingVariant = 'editable';\n\n  /** Controlled edit state — parent owns single-edit orchestration. */\n  @Prop() editing = false;\n  /** Keep the card and projected content in place while its header shows skeletons. */\n  @Prop() isLoading = false;\n  @Prop() editLabel: string = 'Edit';\n  @Prop() cancelLabel: string = 'Cancel';\n  @Prop() saveLabel: string = 'Save';\n\n  /** Emits a controlled edit, save, or cancel request. */\n  @Event() dsAction!: EventEmitter<CardSettingActionDetail>;\n\n  @State() private hasBannerContent = false;\n  @State() private hasBodyContent = false;\n\n  componentWillLoad() {\n    const nodes = Array.from(this.el.childNodes);\n    this.hasBannerContent = nodes.some(isBannerSlottedNode);\n    this.hasBodyContent = nodes.some(isDefaultSlottedNode);\n  }\n\n  componentDidLoad() {\n    this.syncBannerContent();\n    this.syncBodyContent();\n  }\n\n  private emitAction(action: CardSettingAction, originalEvent: MouseEvent) {\n    this.dsAction.emit({ action, originalEvent });\n  }\n\n  private readSlotContent(\n    event: Event | undefined,\n    slotSelector: string,\n    containerSelector: string\n  ): boolean {\n    const slot =\n      event?.target instanceof HTMLSlotElement\n        ? event.target\n        : this.el.querySelector<HTMLSlotElement>(slotSelector);\n    if (slotHasRenderableContent(slot)) return true;\n    const container = this.el.querySelector(containerSelector);\n    return Array.from(container?.childNodes ?? []).some(isRenderableNode);\n  }\n\n  private syncBannerContent = (event?: Event) => {\n    const hasContent = this.readSlotContent(\n      event,\n      ':scope > .card-setting__panel > .card-setting__banner > slot',\n      ':scope > .card-setting__panel > .card-setting__banner'\n    );\n    if (hasContent !== this.hasBannerContent) this.hasBannerContent = hasContent;\n  };\n\n  private syncBodyContent = (event?: Event) => {\n    const hasContent = this.readSlotContent(\n      event,\n      ':scope > .card-setting__panel > .card-setting__body > slot',\n      ':scope > .card-setting__panel > .card-setting__body'\n    );\n    if (hasContent !== this.hasBodyContent) this.hasBodyContent = hasContent;\n  };\n\n  private get hugContent(): boolean {\n    return this.variant === 'immediate' || this.hasBannerContent || this.hasBodyContent;\n  }\n\n  render() {\n    const editing = this.variant === 'editable' && this.editing;\n\n    return (\n      <Host\n        aria-busy={this.isLoading ? 'true' : undefined}\n        class={{\n          'card-setting': true,\n          'card-setting--loading': this.isLoading,\n          'card-setting--editing': editing,\n          'card-setting--immediate': this.variant === 'immediate',\n          'card-setting--empty': !this.hugContent,\n        }}\n        style={{\n          '--_card-setting-width': CARD_WIDTH_VARS[this.cardWidth],\n          '--_card-setting-min-height': this.hugContent ? '0' : CARD_HEIGHT_VARS[this.cardWidth],\n        }}\n      >\n        <header class=\"card-setting__header ds-chrome-header\">\n          <div class=\"card-setting__copy ds-chrome-header__copy ds-control--md\">\n            <ds-text\n              class=\"card-setting__title ds-chrome-header__heading\"\n              variant=\"text-title-small\"\n              emphasis\n              color={editing ? FAINT_BRAND_TITLE_COLOR : 'primary'}\n              as=\"h2\"\n            >\n              {this.heading}\n            </ds-text>\n            {this.isLoading && (\n              <ds-skeleton\n                class=\"card-setting__heading-skeleton\"\n                width=\"min(60%, calc(var(--dimension-size-800) * 2))\"\n                textVariant=\"text-title-small\"\n              />\n            )}\n          </div>\n          {this.variant === 'editable' && (\n            <div class=\"card-setting__actions ds-chrome-header__trailing\" inert={this.isLoading}>\n              {!editing ? (\n                <ds-skeleton\n                  preserveLayout\n                  isLoading={this.isLoading}\n                  variant=\"control\"\n                  controlAppearance=\"outlined\"\n                  controlContent=\"icon\"\n                >\n                  <ds-button-unfilled\n                    variant=\"icon\"\n                    type=\"button\"\n                    icon=\"Pencil\"\n                    aria-label={this.editLabel}\n                    onDsClick={(event: CustomEvent<MouseEvent>) =>\n                      this.emitAction('edit', event.detail)\n                    }\n                  />\n                </ds-skeleton>\n              ) : (\n                [\n                  <ds-skeleton\n                    key=\"cancel\"\n                    preserveLayout\n                    isLoading={this.isLoading}\n                    variant=\"control\"\n                    controlAppearance=\"outlined\"\n                    controlContent=\"icon\"\n                    background=\"bold\"\n                  >\n                    <ds-button-unfilled\n                      variant=\"icon\"\n                      type=\"button\"\n                      icon=\"Cross\"\n                      background=\"bold\"\n                      aria-label={this.cancelLabel}\n                      onDsClick={(event: CustomEvent<MouseEvent>) =>\n                        this.emitAction('cancel', event.detail)\n                      }\n                    />\n                  </ds-skeleton>,\n                  <ds-skeleton\n                    key=\"save\"\n                    preserveLayout\n                    isLoading={this.isLoading}\n                    variant=\"control\"\n                  >\n                    <ds-button-filled\n                      variant=\"icon\"\n                      type=\"button\"\n                      icon=\"Check\"\n                      intent=\"brand\"\n                      contrast=\"faint\"\n                      aria-label={this.saveLabel}\n                      onDsClick={(event: CustomEvent<MouseEvent>) =>\n                        this.emitAction('save', event.detail)\n                      }\n                    />\n                  </ds-skeleton>,\n                ]\n              )}\n            </div>\n          )}\n        </header>\n        <div class=\"card-setting__panel\">\n          <div\n            class={{\n              'card-setting__banner': true,\n              'card-setting__banner--empty': !this.hasBannerContent,\n            }}\n          >\n            <slot name=\"banner\" onSlotchange={this.syncBannerContent} />\n          </div>\n          <div class=\"card-setting__body\">\n            <slot onSlotchange={this.syncBodyContent} />\n          </div>\n        </div>\n      </Host>\n    );\n  }\n}\n",
       "type": "registry:ui"
     }
   ]