@ds-mo/ui 15.11.1 → 15.12.0

package/dist/mcp-data/registry/mobile-section-switcher.json

@@ -229,8 +229,8 @@
       "complexPropertyNote": "Assign these non-primitive values as JavaScript properties: sections.",
       "peerDependencies": {
         "required": [
-          "@ds-mo/tokens ^8.0.0",
-          "@ds-mo/icons ^8.1.1"
+          "@ds-mo/tokens ^8.0.1",
+          "@ds-mo/icons ^8.1.2"
         ],
         "frameworks": "Custom Elements; React 18/19 wrappers; Vue 3 wrappers; Angular 19-22 standalone adapters."
       }

package/dist/mcp-data/registry/mobile-sheet-nav.json

@@ -390,8 +390,8 @@
       "complexPropertyNote": "Assign these non-primitive values as JavaScript properties: dashboardGroups, settingsGroups.",
       "peerDependencies": {
         "required": [
-          "@ds-mo/tokens ^8.0.0",
-          "@ds-mo/icons ^8.1.1"
+          "@ds-mo/tokens ^8.0.1",
+          "@ds-mo/icons ^8.1.2"
         ],
         "frameworks": "Custom Elements; React 18/19 wrappers; Vue 3 wrappers; Angular 19-22 standalone adapters."
       }

package/dist/mcp-data/registry/modal.json

@@ -298,8 +298,8 @@
       },
       "peerDependencies": {
         "required": [
-          "@ds-mo/tokens ^8.0.0",
-          "@ds-mo/icons ^8.1.1"
+          "@ds-mo/tokens ^8.0.1",
+          "@ds-mo/icons ^8.1.2"
         ],
         "frameworks": "Custom Elements; React 18/19 wrappers; Vue 3 wrappers; Angular 19-22 standalone adapters."
       }

package/dist/mcp-data/registry/navigation-tab-group.json

@@ -250,8 +250,8 @@
       "complexPropertyNote": "Assign these non-primitive values as JavaScript properties: tabs.",
       "peerDependencies": {
         "required": [
-          "@ds-mo/tokens ^8.0.0",
-          "@ds-mo/icons ^8.1.1"
+          "@ds-mo/tokens ^8.0.1",
+          "@ds-mo/icons ^8.1.2"
         ],
         "frameworks": "Custom Elements; React 18/19 wrappers; Vue 3 wrappers; Angular 19-22 standalone adapters."
       }

package/dist/mcp-data/registry/pagination.json

@@ -41,7 +41,8 @@
         "Zero results display Page 1 of 1. A partial final page still derives from totalItems. Assistive status keeps the complete item range.",
         "loading preserves the full pagination surface, applies aria-busy to the navigation region, and prevents page or page-size requests.",
         "fitToPage appends a Fit to page choice. fitPageSize supplies its effective whole-item capacity; the closed trigger says Fit while page position reflects the resulting window. fitToPageInactive keeps that choice visible but unavailable when fitting is not meaningful for the current data shape. Pagination does not measure layouts itself.",
-        "showFirstLastButtons defaults to false. Enable it when direct jumps to both result boundaries materially help the workflow."
+        "showFirstLastButtons defaults to false. Enable it when direct jumps to both result boundaries materially help the workflow.",
+        "chromeLoading shows separate skeletons for the page-size label, selector, page position and each configured navigation control, retaining their intrinsic and responsive geometry. It also prevents requests."
       ],
       "responsiveBehavior": [
         "The full-width controls remain on one line with noun, selected size, a vertical divider, page position, Previous and Next, plus optional First and Last navigation.",
@@ -72,6 +73,15 @@
     },
     "api": {
       "props": {
+        "chromeLoading": {
+          "type": "boolean",
+          "resolvedType": "boolean",
+          "attribute": "chrome-loading",
+          "default": "false",
+          "required": false,
+          "mutable": false,
+          "description": "Show skeletons for the existing controls without changing their geometry."
+        },
         "fitPageSize": {
           "type": "number | undefined",
           "resolvedType": "number | undefined",
@@ -228,6 +238,15 @@
       "slots": []
     },
     "props": {
+      "chromeLoading": {
+        "type": "boolean",
+        "resolvedType": "boolean",
+        "attribute": "chrome-loading",
+        "default": "false",
+        "required": false,
+        "mutable": false,
+        "description": "Show skeletons for the existing controls without changing their geometry."
+      },
       "fitPageSize": {
         "type": "number | undefined",
         "resolvedType": "number | undefined",
@@ -410,8 +429,8 @@
       "complexPropertyNote": "Assign these non-primitive values as JavaScript properties: pageSizeOptions.",
       "peerDependencies": {
         "required": [
-          "@ds-mo/tokens ^8.0.0",
-          "@ds-mo/icons ^8.1.1"
+          "@ds-mo/tokens ^8.0.1",
+          "@ds-mo/icons ^8.1.2"
         ],
         "frameworks": "Custom Elements; React 18/19 wrappers; Vue 3 wrappers; Angular 19-22 standalone adapters."
       }
@@ -425,6 +444,7 @@
     "button-unfilled",
     "divider",
     "select",
+    "skeleton",
     "text"
   ],
   "files": [
@@ -435,7 +455,7 @@
     },
     {
       "path": "src/wc/components/Pagination/Pagination.tsx",
-      "content": "import { Component, Element, Event, EventEmitter, h, Host, Prop, State } from '@stencil/core';\nimport { observeTableCaptionCompact } from '../../utils/table-caption-compact';\nimport { resolvePaginationState } from './pagination-model';\nimport type { PaginationChangeDetail, PaginationPageSizeMode } from './pagination-types';\n\nlet paginationId = 0;\n\n@Component({\n  tag: 'ds-pagination',\n  styleUrl: 'Pagination.css',\n  scoped: true,\n})\nexport class Pagination {\n  @Element() el!: HTMLElement;\n\n  /** Controlled zero-based page index. */\n  @Prop() pageIndex: number = 0;\n  /** Controlled number of top-level items on a full page. */\n  @Prop() pageSize: number = 25;\n  /** Whether pageSize is a fixed choice or a measured Fit snapshot. */\n  @Prop() pageSizeMode: PaginationPageSizeMode = 'fixed';\n  /** Controlled total number of top-level items across every page. */\n  @Prop() totalItems: number = 0;\n  /** Available page sizes. Assign arrays through JavaScript. */\n  @Prop() pageSizeOptions: number[] = [25, 50, 100, 200];\n  /** Include the Fit to page choice. */\n  @Prop() fitToPage: boolean = false;\n  /** Keep the Fit to page choice visible but unavailable. */\n  @Prop() fitToPageInactive: boolean = false;\n  /** Effective whole-item capacity to request when Fit is selected. */\n  @Prop() fitPageSize: number | undefined;\n  /** Full choice-list label for Fit. */\n  @Prop() fitPageSizeLabel: string = 'Fit to page';\n  /** Compact closed-trigger label while Fit is selected. */\n  @Prop() fitPageSizeTriggerLabel: string = 'Fit';\n  /** Localized plural noun used by assistive range announcements. */\n  @Prop() itemLabel: string = 'items';\n  /** Visible page-size control label. */\n  @Prop() pageSizeLabel: string = 'Items';\n  /** Accessible page-size control label. Defaults to “{pageSizeLabel} per page”. */\n  @Prop() pageSizeAriaLabel: string | undefined;\n  /** Accessible name for the pagination navigation region. */\n  @Prop() label: string = 'Pagination';\n  /** Include direct first-page and last-page controls. */\n  @Prop() showFirstLastButtons: boolean = false;\n  /** Prevent interaction while the owner replaces the current data page. */\n  @Prop() loading: boolean = false;\n\n  /** Emits the complete next controlled state after a page or page-size request. */\n  @Event() dsChange!: EventEmitter<PaginationChangeDetail>;\n\n  @State() private tableCompact = false;\n\n  private readonly pageSizeControlId = `ds-pagination-${++paginationId}-page-size`;\n  private tableCompactDisconnect: (() => void) | undefined;\n  private hasLoaded = false;\n\n  componentDidLoad(): void {\n    this.hasLoaded = true;\n    this.syncTableCompactObserver();\n  }\n\n  connectedCallback(): void {\n    if (this.hasLoaded) this.syncTableCompactObserver();\n  }\n\n  disconnectedCallback(): void {\n    this.tableCompactDisconnect?.();\n    this.tableCompactDisconnect = undefined;\n  }\n\n  private syncTableCompactObserver(): void {\n    this.tableCompactDisconnect?.();\n    this.tableCompactDisconnect = observeTableCaptionCompact(this.el, compact => {\n      if (this.tableCompact !== compact) this.tableCompact = compact;\n    });\n  }\n\n  private requestPage(pageIndex: number): void {\n    const state = this.resolvedState;\n    if (\n      this.loading ||\n      pageIndex === state.pageIndex ||\n      pageIndex < 0 ||\n      pageIndex >= state.totalPages\n    ) {\n      return;\n    }\n    this.dsChange.emit({\n      pageIndex,\n      pageSize: state.pageSize,\n      pageSizeMode: state.pageSizeMode,\n      totalItems: state.totalItems,\n      pageSizeOptions: state.pageSizeOptions,\n      fitToPage: this.fitToPage,\n      fitToPageInactive: this.fitToPageInactive,\n      fitPageSize: this.resolvedFitPageSize,\n      fitPageSizeLabel: this.fitPageSizeLabel,\n      fitPageSizeTriggerLabel: this.fitPageSizeTriggerLabel,\n      itemLabel: this.itemLabel,\n      pageSizeLabel: this.pageSizeLabel,\n      ariaLabel: this.label,\n      showFirstLastButtons: this.showFirstLastButtons,\n      previousPageIndex: state.pageIndex,\n      previousPageSize: state.pageSize,\n      previousPageSizeMode: state.pageSizeMode,\n      reason: 'page',\n    });\n  }\n\n  private requestPageSize(value: string | string[]): void {\n    if (this.loading || typeof value !== 'string' || (value === 'fit' && this.fitToPageInactive))\n      return;\n    const state = this.resolvedState;\n    const nextMode: PaginationPageSizeMode = value === 'fit' ? 'fit' : 'fixed';\n    const pageSize = nextMode === 'fit' ? this.resolvedFitPageSize : Number(value);\n    if (!pageSize || (pageSize === state.pageSize && nextMode === state.pageSizeMode)) return;\n    this.dsChange.emit({\n      pageIndex: 0,\n      pageSize: Math.trunc(pageSize),\n      pageSizeMode: nextMode,\n      totalItems: state.totalItems,\n      pageSizeOptions: state.pageSizeOptions,\n      fitToPage: this.fitToPage,\n      fitToPageInactive: this.fitToPageInactive,\n      fitPageSize: this.resolvedFitPageSize,\n      fitPageSizeLabel: this.fitPageSizeLabel,\n      fitPageSizeTriggerLabel: this.fitPageSizeTriggerLabel,\n      itemLabel: this.itemLabel,\n      pageSizeLabel: this.pageSizeLabel,\n      ariaLabel: this.label,\n      showFirstLastButtons: this.showFirstLastButtons,\n      previousPageIndex: state.pageIndex,\n      previousPageSize: state.pageSize,\n      previousPageSizeMode: state.pageSizeMode,\n      reason: 'page-size',\n    });\n  }\n\n  private handleKeyDown(event: KeyboardEvent): void {\n    if (\n      event.defaultPrevented ||\n      event.altKey ||\n      event.ctrlKey ||\n      event.metaKey ||\n      event.shiftKey\n    ) {\n      return;\n    }\n    const fromChoiceControl = event\n      .composedPath()\n      .some(\n        node =>\n          node instanceof HTMLElement &&\n          (node.tagName === 'DS-SELECT' || ['INPUT', 'SELECT', 'TEXTAREA'].includes(node.tagName))\n      );\n    if (fromChoiceControl || (event.key !== 'ArrowLeft' && event.key !== 'ArrowRight')) return;\n    const state = this.resolvedState;\n    const pageIndex = event.key === 'ArrowLeft' ? state.pageIndex - 1 : state.pageIndex + 1;\n    if (this.loading || pageIndex < 0 || pageIndex >= state.totalPages) return;\n    event.preventDefault();\n    this.requestPage(pageIndex);\n  }\n\n  private get resolvedFitPageSize(): number | undefined {\n    return Number.isFinite(this.fitPageSize) && Number(this.fitPageSize) > 0\n      ? Math.trunc(Number(this.fitPageSize))\n      : undefined;\n  }\n\n  private get resolvedState() {\n    return resolvePaginationState({\n      pageIndex: this.pageIndex,\n      pageSize: this.pageSize,\n      pageSizeMode: this.pageSizeMode,\n      totalItems: this.totalItems,\n      pageSizeOptions: this.pageSizeOptions,\n    });\n  }\n\n  render() {\n    const state = this.resolvedState;\n    const atStart = state.pageIndex === 0;\n    const atEnd = state.pageIndex === state.totalPages - 1;\n    const page = `${state.pageIndex + 1} of ${state.totalPages}`;\n    const announcedRange = `${state.firstItem}–${state.lastItem} of ${state.totalItems}`;\n    const announcedPage = `Page ${state.pageIndex + 1} of ${state.totalPages}`;\n    const pageSizeAriaLabel = this.pageSizeAriaLabel ?? `${this.pageSizeLabel} per page`;\n    const options: Array<{ label: string; value: string; isInactive?: boolean }> =\n      state.pageSizeOptions.map(value => ({ label: String(value), value: String(value) }));\n    if (this.fitToPage) {\n      options.push({\n        label: this.fitPageSizeLabel,\n        value: 'fit',\n        isInactive: this.fitToPageInactive || this.resolvedFitPageSize === undefined,\n      });\n    }\n\n    return (\n      <Host>\n        <nav\n          class={{\n            pagination: true,\n            'pagination--table-compact': this.tableCompact,\n          }}\n          aria-label={this.label}\n          aria-busy={this.loading ? 'true' : undefined}\n          onKeyDown={event => this.handleKeyDown(event)}\n        >\n          <div class=\"pagination__page-size\">\n            <ds-text\n              class=\"pagination__label\"\n              as=\"span\"\n              variant=\"text-body-medium\"\n              color=\"secondary\"\n              aria-hidden=\"true\"\n            >\n              {this.pageSizeLabel}:\n            </ds-text>\n            <span id={`${this.pageSizeControlId}-label`} class=\"ds-visually-hidden\">\n              {pageSizeAriaLabel}\n            </span>\n            <ds-select\n              class=\"pagination__page-size-select\"\n              size=\"md\"\n              inputId={this.pageSizeControlId}\n              ariaLabelledby={`${this.pageSizeControlId}-label`}\n              options={options}\n              value={state.pageSizeMode === 'fit' ? 'fit' : String(state.pageSize)}\n              triggerLabel={state.pageSizeMode === 'fit' ? this.fitPageSizeTriggerLabel : undefined}\n              indicator=\"up-down\"\n              allowClear={false}\n              activeFill={false}\n              hasBorder={false}\n              isInactive={this.loading}\n              onDsChange={event => {\n                event.stopPropagation();\n                this.requestPageSize(event.detail);\n              }}\n            />\n          </div>\n          <ds-divider\n            class=\"pagination__divider\"\n            orientation=\"vertical\"\n            length=\"var(--dimension-size-250)\"\n          />\n          <div class=\"pagination__navigation\">\n            {this.showFirstLastButtons ? (\n              <ds-button-unfilled\n                class=\"pagination__boundary\"\n                variant=\"icon\"\n                size=\"md\"\n                icon=\"ChevronLeftDouble\"\n                ariaLabel=\"First page\"\n                hasBorder={false}\n                isInactive={this.loading || atStart}\n                onDsClick={() => this.requestPage(0)}\n              />\n            ) : null}\n            <ds-button-unfilled\n              variant=\"icon\"\n              size=\"md\"\n              icon=\"ChevronLeft\"\n              ariaLabel=\"Previous page\"\n              hasBorder={false}\n              isInactive={this.loading || atStart}\n              onDsClick={() => this.requestPage(state.pageIndex - 1)}\n            />\n            <ds-text\n              class=\"pagination__page\"\n              as=\"span\"\n              variant=\"text-body-medium\"\n              color=\"secondary\"\n              fontFeature=\"tabular-nums\"\n            >\n              {page}\n            </ds-text>\n            <ds-button-unfilled\n              variant=\"icon\"\n              size=\"md\"\n              icon=\"ChevronRight\"\n              ariaLabel=\"Next page\"\n              hasBorder={false}\n              isInactive={this.loading || atEnd}\n              onDsClick={() => this.requestPage(state.pageIndex + 1)}\n            />\n            {this.showFirstLastButtons ? (\n              <ds-button-unfilled\n                class=\"pagination__boundary\"\n                variant=\"icon\"\n                size=\"md\"\n                icon=\"ChevronRightDouble\"\n                ariaLabel=\"Last page\"\n                hasBorder={false}\n                isInactive={this.loading || atEnd}\n                onDsClick={() => this.requestPage(state.totalPages - 1)}\n              />\n            ) : null}\n          </div>\n          <span class=\"ds-visually-hidden\" role=\"status\" aria-live=\"polite\" aria-atomic=\"true\">\n            {announcedRange} {this.itemLabel}. {announcedPage}.\n          </span>\n        </nav>\n      </Host>\n    );\n  }\n}\n",
+      "content": "import { Component, Element, Event, EventEmitter, h, Host, Prop, State } from '@stencil/core';\nimport { observeTableCaptionCompact } from '../../utils/table-caption-compact';\nimport { resolvePaginationState } from './pagination-model';\nimport type { PaginationChangeDetail, PaginationPageSizeMode } from './pagination-types';\n\nlet paginationId = 0;\n\n@Component({\n  tag: 'ds-pagination',\n  styleUrl: 'Pagination.css',\n  scoped: true,\n})\nexport class Pagination {\n  @Element() el!: HTMLElement;\n\n  /** Controlled zero-based page index. */\n  @Prop() pageIndex: number = 0;\n  /** Controlled number of top-level items on a full page. */\n  @Prop() pageSize: number = 25;\n  /** Whether pageSize is a fixed choice or a measured Fit snapshot. */\n  @Prop() pageSizeMode: PaginationPageSizeMode = 'fixed';\n  /** Controlled total number of top-level items across every page. */\n  @Prop() totalItems: number = 0;\n  /** Available page sizes. Assign arrays through JavaScript. */\n  @Prop() pageSizeOptions: number[] = [25, 50, 100, 200];\n  /** Include the Fit to page choice. */\n  @Prop() fitToPage: boolean = false;\n  /** Keep the Fit to page choice visible but unavailable. */\n  @Prop() fitToPageInactive: boolean = false;\n  /** Effective whole-item capacity to request when Fit is selected. */\n  @Prop() fitPageSize: number | undefined;\n  /** Full choice-list label for Fit. */\n  @Prop() fitPageSizeLabel: string = 'Fit to page';\n  /** Compact closed-trigger label while Fit is selected. */\n  @Prop() fitPageSizeTriggerLabel: string = 'Fit';\n  /** Localized plural noun used by assistive range announcements. */\n  @Prop() itemLabel: string = 'items';\n  /** Visible page-size control label. */\n  @Prop() pageSizeLabel: string = 'Items';\n  /** Accessible page-size control label. Defaults to “{pageSizeLabel} per page”. */\n  @Prop() pageSizeAriaLabel: string | undefined;\n  /** Accessible name for the pagination navigation region. */\n  @Prop() label: string = 'Pagination';\n  /** Include direct first-page and last-page controls. */\n  @Prop() showFirstLastButtons: boolean = false;\n  /** Prevent interaction while the owner replaces the current data page. */\n  @Prop() loading: boolean = false;\n  /** Show skeletons for the existing controls without changing their geometry. */\n  @Prop() chromeLoading: boolean = false;\n\n  private get busy(): boolean {\n    return this.loading || this.chromeLoading;\n  }\n\n  /** Emits the complete next controlled state after a page or page-size request. */\n  @Event() dsChange!: EventEmitter<PaginationChangeDetail>;\n\n  @State() private tableCompact = false;\n\n  private readonly pageSizeControlId = `ds-pagination-${++paginationId}-page-size`;\n  private tableCompactDisconnect: (() => void) | undefined;\n  private hasLoaded = false;\n\n  componentDidLoad(): void {\n    this.hasLoaded = true;\n    this.syncTableCompactObserver();\n  }\n\n  connectedCallback(): void {\n    if (this.hasLoaded) this.syncTableCompactObserver();\n  }\n\n  disconnectedCallback(): void {\n    this.tableCompactDisconnect?.();\n    this.tableCompactDisconnect = undefined;\n  }\n\n  private syncTableCompactObserver(): void {\n    this.tableCompactDisconnect?.();\n    this.tableCompactDisconnect = observeTableCaptionCompact(this.el, compact => {\n      if (this.tableCompact !== compact) this.tableCompact = compact;\n    });\n  }\n\n  private requestPage(pageIndex: number): void {\n    const state = this.resolvedState;\n    if (\n      this.busy ||\n      pageIndex === state.pageIndex ||\n      pageIndex < 0 ||\n      pageIndex >= state.totalPages\n    ) {\n      return;\n    }\n    this.dsChange.emit({\n      pageIndex,\n      pageSize: state.pageSize,\n      pageSizeMode: state.pageSizeMode,\n      totalItems: state.totalItems,\n      pageSizeOptions: state.pageSizeOptions,\n      fitToPage: this.fitToPage,\n      fitToPageInactive: this.fitToPageInactive,\n      fitPageSize: this.resolvedFitPageSize,\n      fitPageSizeLabel: this.fitPageSizeLabel,\n      fitPageSizeTriggerLabel: this.fitPageSizeTriggerLabel,\n      itemLabel: this.itemLabel,\n      pageSizeLabel: this.pageSizeLabel,\n      ariaLabel: this.label,\n      showFirstLastButtons: this.showFirstLastButtons,\n      previousPageIndex: state.pageIndex,\n      previousPageSize: state.pageSize,\n      previousPageSizeMode: state.pageSizeMode,\n      reason: 'page',\n    });\n  }\n\n  private requestPageSize(value: string | string[]): void {\n    if (this.busy || typeof value !== 'string' || (value === 'fit' && this.fitToPageInactive))\n      return;\n    const state = this.resolvedState;\n    const nextMode: PaginationPageSizeMode = value === 'fit' ? 'fit' : 'fixed';\n    const pageSize = nextMode === 'fit' ? this.resolvedFitPageSize : Number(value);\n    if (!pageSize || (pageSize === state.pageSize && nextMode === state.pageSizeMode)) return;\n    this.dsChange.emit({\n      pageIndex: 0,\n      pageSize: Math.trunc(pageSize),\n      pageSizeMode: nextMode,\n      totalItems: state.totalItems,\n      pageSizeOptions: state.pageSizeOptions,\n      fitToPage: this.fitToPage,\n      fitToPageInactive: this.fitToPageInactive,\n      fitPageSize: this.resolvedFitPageSize,\n      fitPageSizeLabel: this.fitPageSizeLabel,\n      fitPageSizeTriggerLabel: this.fitPageSizeTriggerLabel,\n      itemLabel: this.itemLabel,\n      pageSizeLabel: this.pageSizeLabel,\n      ariaLabel: this.label,\n      showFirstLastButtons: this.showFirstLastButtons,\n      previousPageIndex: state.pageIndex,\n      previousPageSize: state.pageSize,\n      previousPageSizeMode: state.pageSizeMode,\n      reason: 'page-size',\n    });\n  }\n\n  private handleKeyDown(event: KeyboardEvent): void {\n    if (\n      event.defaultPrevented ||\n      event.altKey ||\n      event.ctrlKey ||\n      event.metaKey ||\n      event.shiftKey\n    ) {\n      return;\n    }\n    const fromChoiceControl = event\n      .composedPath()\n      .some(\n        node =>\n          node instanceof HTMLElement &&\n          (node.tagName === 'DS-SELECT' || ['INPUT', 'SELECT', 'TEXTAREA'].includes(node.tagName))\n      );\n    if (fromChoiceControl || (event.key !== 'ArrowLeft' && event.key !== 'ArrowRight')) return;\n    const state = this.resolvedState;\n    const pageIndex = event.key === 'ArrowLeft' ? state.pageIndex - 1 : state.pageIndex + 1;\n    if (this.busy || pageIndex < 0 || pageIndex >= state.totalPages) return;\n    event.preventDefault();\n    this.requestPage(pageIndex);\n  }\n\n  private get resolvedFitPageSize(): number | undefined {\n    return Number.isFinite(this.fitPageSize) && Number(this.fitPageSize) > 0\n      ? Math.trunc(Number(this.fitPageSize))\n      : undefined;\n  }\n\n  private get resolvedState() {\n    return resolvePaginationState({\n      pageIndex: this.pageIndex,\n      pageSize: this.pageSize,\n      pageSizeMode: this.pageSizeMode,\n      totalItems: this.totalItems,\n      pageSizeOptions: this.pageSizeOptions,\n    });\n  }\n\n  render() {\n    const state = this.resolvedState;\n    const atStart = state.pageIndex === 0;\n    const atEnd = state.pageIndex === state.totalPages - 1;\n    const page = `${state.pageIndex + 1} of ${state.totalPages}`;\n    const announcedRange = `${state.firstItem}–${state.lastItem} of ${state.totalItems}`;\n    const announcedPage = `Page ${state.pageIndex + 1} of ${state.totalPages}`;\n    const pageSizeAriaLabel = this.pageSizeAriaLabel ?? `${this.pageSizeLabel} per page`;\n    const options: Array<{ label: string; value: string; isInactive?: boolean }> =\n      state.pageSizeOptions.map(value => ({ label: String(value), value: String(value) }));\n    if (this.fitToPage) {\n      options.push({\n        label: this.fitPageSizeLabel,\n        value: 'fit',\n        isInactive: this.fitToPageInactive || this.resolvedFitPageSize === undefined,\n      });\n    }\n\n    return (\n      <Host>\n        <nav\n          class={{\n            pagination: true,\n            'pagination--table-compact': this.tableCompact,\n          }}\n          aria-label={this.label}\n          aria-busy={this.busy ? 'true' : undefined}\n          onKeyDown={event => this.handleKeyDown(event)}\n        >\n          <div class=\"pagination__page-size\">\n            <ds-skeleton preserveLayout={true} isLoading={this.chromeLoading}>\n              <ds-text\n                class=\"pagination__label\"\n                as=\"span\"\n                variant=\"text-body-medium\"\n                color=\"secondary\"\n                aria-hidden=\"true\"\n              >\n                {this.pageSizeLabel}:\n              </ds-text>\n            </ds-skeleton>\n            <span id={`${this.pageSizeControlId}-label`} class=\"ds-visually-hidden\">\n              {pageSizeAriaLabel}\n            </span>\n            <ds-skeleton\n              preserveLayout={true}\n              isLoading={this.chromeLoading}\n              variant=\"control\"\n              controlAppearance=\"borderless\"\n              controlContent=\"label-icon\"\n            >\n              <ds-select\n                class=\"pagination__page-size-select\"\n                size=\"md\"\n                inputId={this.pageSizeControlId}\n                ariaLabelledby={`${this.pageSizeControlId}-label`}\n                options={options}\n                value={state.pageSizeMode === 'fit' ? 'fit' : String(state.pageSize)}\n                triggerLabel={\n                  state.pageSizeMode === 'fit' ? this.fitPageSizeTriggerLabel : undefined\n                }\n                indicator=\"up-down\"\n                allowClear={false}\n                activeFill={false}\n                hasBorder={false}\n                isInactive={this.busy}\n                onDsChange={event => {\n                  event.stopPropagation();\n                  this.requestPageSize(event.detail);\n                }}\n              />\n            </ds-skeleton>\n          </div>\n          <ds-divider\n            class=\"pagination__divider\"\n            orientation=\"vertical\"\n            length=\"var(--dimension-size-250)\"\n          />\n          <div class=\"pagination__navigation\">\n            {this.showFirstLastButtons ? (\n              <ds-skeleton\n                class=\"pagination__boundary\"\n                preserveLayout={true}\n                isLoading={this.chromeLoading}\n                variant=\"control\"\n                controlAppearance=\"borderless\"\n                controlContent=\"icon\"\n              >\n                <ds-button-unfilled\n                  variant=\"icon\"\n                  size=\"md\"\n                  icon=\"ChevronLeftDouble\"\n                  ariaLabel=\"First page\"\n                  hasBorder={false}\n                  isInactive={this.busy || atStart}\n                  onDsClick={() => this.requestPage(0)}\n                />\n              </ds-skeleton>\n            ) : null}\n            <ds-skeleton\n              preserveLayout={true}\n              isLoading={this.chromeLoading}\n              variant=\"control\"\n              controlAppearance=\"borderless\"\n              controlContent=\"icon\"\n            >\n              <ds-button-unfilled\n                variant=\"icon\"\n                size=\"md\"\n                icon=\"ChevronLeft\"\n                ariaLabel=\"Previous page\"\n                hasBorder={false}\n                isInactive={this.busy || atStart}\n                onDsClick={() => this.requestPage(state.pageIndex - 1)}\n              />\n            </ds-skeleton>\n            <ds-skeleton preserveLayout={true} isLoading={this.chromeLoading}>\n              <ds-text\n                class=\"pagination__page\"\n                as=\"span\"\n                variant=\"text-body-medium\"\n                color=\"secondary\"\n                fontFeature=\"tabular-nums\"\n              >\n                {page}\n              </ds-text>\n            </ds-skeleton>\n            <ds-skeleton\n              preserveLayout={true}\n              isLoading={this.chromeLoading}\n              variant=\"control\"\n              controlAppearance=\"borderless\"\n              controlContent=\"icon\"\n            >\n              <ds-button-unfilled\n                variant=\"icon\"\n                size=\"md\"\n                icon=\"ChevronRight\"\n                ariaLabel=\"Next page\"\n                hasBorder={false}\n                isInactive={this.busy || atEnd}\n                onDsClick={() => this.requestPage(state.pageIndex + 1)}\n              />\n            </ds-skeleton>\n            {this.showFirstLastButtons ? (\n              <ds-skeleton\n                class=\"pagination__boundary\"\n                preserveLayout={true}\n                isLoading={this.chromeLoading}\n                variant=\"control\"\n                controlAppearance=\"borderless\"\n                controlContent=\"icon\"\n              >\n                <ds-button-unfilled\n                  variant=\"icon\"\n                  size=\"md\"\n                  icon=\"ChevronRightDouble\"\n                  ariaLabel=\"Last page\"\n                  hasBorder={false}\n                  isInactive={this.busy || atEnd}\n                  onDsClick={() => this.requestPage(state.totalPages - 1)}\n                />\n              </ds-skeleton>\n            ) : null}\n          </div>\n          <span class=\"ds-visually-hidden\" role=\"status\" aria-live=\"polite\" aria-atomic=\"true\">\n            {this.chromeLoading\n              ? 'Loading pages'\n              : `${announcedRange} ${this.itemLabel}. ${announcedPage}.`}\n          </span>\n        </nav>\n      </Host>\n    );\n  }\n}\n",
       "type": "registry:ui"
     },
     {

package/dist/mcp-data/registry/panel-nav.json

@@ -711,8 +711,8 @@
       },
       "peerDependencies": {
         "required": [
-          "@ds-mo/tokens ^8.0.0",
-          "@ds-mo/icons ^8.1.1"
+          "@ds-mo/tokens ^8.0.1",
+          "@ds-mo/icons ^8.1.2"
         ],
         "frameworks": "Custom Elements; React 18/19 wrappers; Vue 3 wrappers; Angular 19-22 standalone adapters."
       }

package/dist/mcp-data/registry/panel-sub-nav.json

@@ -245,8 +245,8 @@
       "complexPropertyNote": "Assign these non-primitive values as JavaScript properties: items.",
       "peerDependencies": {
         "required": [
-          "@ds-mo/tokens ^8.0.0",
-          "@ds-mo/icons ^8.1.1"
+          "@ds-mo/tokens ^8.0.1",
+          "@ds-mo/icons ^8.1.2"
         ],
         "frameworks": "Custom Elements; React 18/19 wrappers; Vue 3 wrappers; Angular 19-22 standalone adapters."
       }

package/dist/mcp-data/registry/panel-tool-header.json

@@ -361,8 +361,8 @@
       "complexPropertyNote": "Assign these non-primitive values as JavaScript properties: actions.",
       "peerDependencies": {
         "required": [
-          "@ds-mo/tokens ^8.0.0",
-          "@ds-mo/icons ^8.1.1"
+          "@ds-mo/tokens ^8.0.1",
+          "@ds-mo/icons ^8.1.2"
         ],
         "frameworks": "Custom Elements; React 18/19 wrappers; Vue 3 wrappers; Angular 19-22 standalone adapters."
       }

package/dist/mcp-data/registry/panel-tool-search.json

@@ -403,8 +403,8 @@
       },
       "peerDependencies": {
         "required": [
-          "@ds-mo/tokens ^8.0.0",
-          "@ds-mo/icons ^8.1.1"
+          "@ds-mo/tokens ^8.0.1",
+          "@ds-mo/icons ^8.1.2"
         ],
         "frameworks": "Custom Elements; React 18/19 wrappers; Vue 3 wrappers; Angular 19-22 standalone adapters."
       }

package/dist/mcp-data/registry/panel-tools.json

@@ -518,8 +518,8 @@
       "complexPropertyNote": "Assign these non-primitive values as JavaScript properties: accessories, headers, items.",
       "peerDependencies": {
         "required": [
-          "@ds-mo/tokens ^8.0.0",
-          "@ds-mo/icons ^8.1.1"
+          "@ds-mo/tokens ^8.0.1",
+          "@ds-mo/icons ^8.1.2"
         ],
         "frameworks": "Custom Elements; React 18/19 wrappers; Vue 3 wrappers; Angular 19-22 standalone adapters."
       }

package/dist/mcp-data/registry/paper-texture.json

@@ -119,8 +119,8 @@
       "complexPropertyNote": "Assign these non-primitive values as JavaScript properties: config.",
       "peerDependencies": {
         "required": [
-          "@ds-mo/tokens ^8.0.0",
-          "@ds-mo/icons ^8.1.1"
+          "@ds-mo/tokens ^8.0.1",
+          "@ds-mo/icons ^8.1.2"
         ],
         "frameworks": "Custom Elements; React 18/19 wrappers; Vue 3 wrappers; Angular 19-22 standalone adapters."
       }

package/dist/mcp-data/registry/radio-tile.json

@@ -370,8 +370,8 @@
       "complexPropertyNote": "Assign these non-primitive values as JavaScript properties: options.",
       "peerDependencies": {
         "required": [
-          "@ds-mo/tokens ^8.0.0",
-          "@ds-mo/icons ^8.1.1"
+          "@ds-mo/tokens ^8.0.1",
+          "@ds-mo/icons ^8.1.2"
         ],
         "frameworks": "Custom Elements; React 18/19 wrappers; Vue 3 wrappers; Angular 19-22 standalone adapters."
       }

package/dist/mcp-data/registry/radio.json

@@ -61,7 +61,8 @@
         "Description-rich options grow beyond the fixed density height while retaining its minimum target size and primitive-owned selection anatomy.",
         "A visible group label uses the same density height and horizontal text origin as a menu section heading above the option list without adding a second interaction target. Copy uses text-body-small emphasis.",
         "Vertical form options use a 4px gap; a medium single-line option and its group label each use the shared 32px control height.",
-        "Form and settings usage omits a row hover or pressed wash by default; set hasInteractionFill only when each radio option is presented as a choice-list row."
+        "Form and settings usage omits a row hover or pressed wash by default; set hasInteractionFill only when each radio option is presented as a choice-list row.",
+        "isLoading preserves option geometry and the submitted form value while skeletonizing the circles and copy. Loading options cannot receive focus or change selection."
       ],
       "responsiveBehavior": [
         "Choose size from the density of the containing form or settings row.",
@@ -200,6 +201,15 @@
           "mutable": false,
           "description": "Design-system inactive state for the complete set."
         },
+        "isLoading": {
+          "type": "boolean",
+          "resolvedType": "boolean",
+          "attribute": "is-loading",
+          "default": "false",
+          "required": false,
+          "mutable": false,
+          "description": "Preserve each option while replacing its circle and copy with loading atoms."
+        },
         "name": {
           "type": "string | undefined",
           "resolvedType": "string | undefined",
@@ -343,6 +353,15 @@
         "mutable": false,
         "description": "Design-system inactive state for the complete set."
       },
+      "isLoading": {
+        "type": "boolean",
+        "resolvedType": "boolean",
+        "attribute": "is-loading",
+        "default": "false",
+        "required": false,
+        "mutable": false,
+        "description": "Preserve each option while replacing its circle and copy with loading atoms."
+      },
       "name": {
         "type": "string | undefined",
         "resolvedType": "string | undefined",
@@ -442,8 +461,8 @@
       "complexPropertyNote": "Assign these non-primitive values as JavaScript properties: options.",
       "peerDependencies": {
         "required": [
-          "@ds-mo/tokens ^8.0.0",
-          "@ds-mo/icons ^8.1.1"
+          "@ds-mo/tokens ^8.0.1",
+          "@ds-mo/icons ^8.1.2"
         ],
         "frameworks": "Custom Elements; React 18/19 wrappers; Vue 3 wrappers; Angular 19-22 standalone adapters."
       }
@@ -454,6 +473,7 @@
     "@ds-mo/tokens"
   ],
   "registryDependencies": [
+    "skeleton",
     "text"
   ],
   "files": [
@@ -464,7 +484,7 @@
     },
     {
       "path": "src/wc/components/Radio/Radio.tsx",
-      "content": "import {\n  AttachInternals,\n  Component,\n  Prop,\n  State,\n  Event,\n  EventEmitter,\n  Element,\n  Listen,\n  Method,\n  Watch,\n  h,\n  Host,\n} from '@stencil/core';\nimport {\n  CONTROL_SUPPORTING_TEXT_VARIANT,\n  CONTROL_TEXT_VARIANT,\n  DEFAULT_REQUIRED_MESSAGE,\n  restoreStringFormState,\n  setFormControlValue,\n  setRequiredValidity,\n} from '../../utils';\n\nexport interface RadioOption {\n  label: string;\n  value: string;\n  description?: string;\n  isInactive?: boolean;\n}\n\nexport type RadioSize = 'lg' | 'md' | 'sm' | 'xs';\n\nlet radioIdCounter = 0;\n\n@Component({\n  tag: 'ds-radio',\n  styleUrl: 'Radio.css',\n  scoped: true,\n  formAssociated: true,\n})\nexport class Radio {\n  @Element() el!: HTMLElement;\n  @AttachInternals() internals!: ElementInternals;\n\n  private readonly instanceId = ++radioIdCounter;\n\n  /** Visible choices in this one-of-many set. */\n  @Prop() options: RadioOption[] = [];\n  /** Optional visible group label rendered above the options. */\n  @Prop() groupLabel: string = '';\n  /** Selected option value. */\n  @Prop({ mutable: true }) value: string = '';\n  /** Visual and placement density for every option. */\n  @Prop() size: RadioSize = 'md';\n  /** Native form field name. */\n  @Prop({ reflect: true }) name: string | undefined;\n  /** Associates the radio set with a form by id when rendered outside that form. */\n  @Prop({ reflect: true }) form: string | undefined;\n  /** Native disabled state for the complete set. */\n  @Prop({ reflect: true }) disabled: boolean = false;\n  /** Require one option to be selected for form validity. */\n  @Prop({ reflect: true }) required: boolean = false;\n  /** Validation message used when a required set has no selection. */\n  @Prop() requiredMessage: string = DEFAULT_REQUIRED_MESSAGE;\n  /** Layout direction for the option set. */\n  @Prop() direction: 'vertical' | 'horizontal' = 'vertical';\n  /** Design-system inactive state for the complete set. */\n  @Prop() isInactive: boolean = false;\n  /** Show full-row hover and pressed feedback for choice-list presentations. */\n  @Prop() hasInteractionFill: boolean = false;\n  /** Accessible name when visible group labeling is unavailable. */\n  @Prop({ attribute: 'aria-label' }) ariaLabel: string | null = null;\n  /** Id reference for a visible group label. */\n  @Prop({ attribute: 'aria-labelledby' }) ariaLabelledby: string | undefined;\n\n  /** Emitted after user selection with the selected option value. */\n  @Event() dsChange!: EventEmitter<string>;\n\n  private initialValue = '';\n  @State() private formDisabled = false;\n\n  private get hasGroupLabel(): boolean {\n    return Boolean(this.groupLabel.trim());\n  }\n\n  private get hasSelection(): boolean {\n    return this.options.some(option => option.value === this.value && !option.isInactive);\n  }\n\n  /** Settings rows own a separate heading; never mount the form group label there. */\n  private get showGroupLabel(): boolean {\n    return this.hasGroupLabel && !this.el.closest('ds-setting-row-radio');\n  }\n\n  componentWillLoad() {\n    this.initialValue = this.value;\n    this.syncFormValue();\n  }\n\n  @Watch('value')\n  @Watch('options')\n  @Watch('disabled')\n  @Watch('isInactive')\n  @Watch('required')\n  @Watch('requiredMessage')\n  syncFormValue() {\n    const inactive = this.isInactive || this.disabled || this.formDisabled;\n    setFormControlValue(this.internals, this.hasSelection ? this.value : '', {\n      inactive,\n      state: this.value,\n    });\n    const missing = this.required && !inactive && !this.hasSelection;\n    setRequiredValidity(this.internals, missing, this.requiredMessage);\n  }\n\n  formDisabledCallback(disabled: boolean) {\n    this.formDisabled = disabled;\n    this.syncFormValue();\n  }\n\n  formResetCallback() {\n    this.value = this.initialValue;\n  }\n\n  formStateRestoreCallback(state: string | File | FormData | null) {\n    this.value = restoreStringFormState(state);\n  }\n\n  /** Focus the selected option, or the first active option when nothing is selected. */\n  @Method()\n  async setFocus() {\n    this.activeItems.find(item => item.tabIndex === 0)?.focus();\n  }\n\n  private get activeItems(): HTMLElement[] {\n    return Array.from(\n      this.el.querySelectorAll<HTMLElement>('[data-radio-item]:not([data-inactive])')\n    );\n  }\n\n  @Listen('keydown')\n  handleKeyDown(e: KeyboardEvent) {\n    const items = this.activeItems;\n    if (!items.length) return;\n\n    const focused = items.find(item => item === document.activeElement);\n    if (!focused) return;\n\n    const idx = items.indexOf(focused);\n    let next = -1;\n\n    switch (e.key) {\n      case 'ArrowDown':\n      case 'ArrowRight':\n        e.preventDefault();\n        next = (idx + 1) % items.length;\n        break;\n      case 'ArrowUp':\n      case 'ArrowLeft':\n        e.preventDefault();\n        next = (idx - 1 + items.length) % items.length;\n        break;\n      case 'Home':\n        e.preventDefault();\n        next = 0;\n        break;\n      case 'End':\n        e.preventDefault();\n        next = items.length - 1;\n        break;\n    }\n\n    if (next >= 0) {\n      items[next].focus();\n      const nextValue = items[next].dataset['value'];\n      if (nextValue !== undefined && nextValue !== this.value) {\n        this.value = nextValue;\n        this.dsChange.emit(nextValue);\n      }\n    }\n  }\n\n  private selectItem(optValue: string) {\n    if (this.isInactive || this.disabled || this.formDisabled) return;\n    if (optValue !== this.value) {\n      this.value = optValue;\n      this.dsChange.emit(optValue);\n    }\n  }\n\n  private renderOptions(inactive: boolean, focusableIdx: number) {\n    return this.options.map((option, index) => {\n      const isItemInactive = inactive || !!option.isInactive;\n      const isChecked = option.value === this.value;\n      const tabIdx = isItemInactive ? -1 : index === focusableIdx ? 0 : -1;\n      const labelId = `ds-radio-${this.instanceId}-label-${index}`;\n      const descriptionId = `ds-radio-${this.instanceId}-description-${index}`;\n\n      return (\n        <div\n          key={option.value}\n          role=\"radio\"\n          aria-checked={String(isChecked)}\n          aria-disabled={isItemInactive ? 'true' : undefined}\n          aria-labelledby={labelId}\n          aria-describedby={option.description ? descriptionId : undefined}\n          tabIndex={tabIdx}\n          data-radio-item\n          data-value={option.value}\n          data-inactive={isItemInactive || undefined}\n          class={{\n            radio__item: true,\n            'radio__item--described': Boolean(option.description),\n            [`ds-control--${this.size}`]: true,\n            'ds-control-inactive': isItemInactive,\n            'ds-focus-ring-inset': !isItemInactive,\n            'ds-interaction-fill': !isItemInactive && this.hasInteractionFill,\n          }}\n          onClick={() => !isItemInactive && this.selectItem(option.value)}\n          onKeyDown={(e: KeyboardEvent) => {\n            if ((e.key === ' ' || e.key === 'Enter') && !isItemInactive) {\n              e.preventDefault();\n              this.selectItem(option.value);\n            }\n          }}\n        >\n          <span class=\"radio__placement ds-interaction-fill__content\" aria-hidden=\"true\">\n            <span class={{ radio__circle: true, 'radio__circle--checked': isChecked }}>\n              {isChecked && <span class=\"radio__dot\" />}\n            </span>\n          </span>\n          <span class=\"radio__copy ds-interaction-fill__content\">\n            <ds-text\n              class=\"radio__label\"\n              as=\"span\"\n              variant={CONTROL_TEXT_VARIANT[this.size]}\n              textId={labelId}\n            >\n              {option.label}\n            </ds-text>\n            {option.description ? (\n              <ds-text\n                as=\"span\"\n                variant={CONTROL_SUPPORTING_TEXT_VARIANT[this.size]}\n                color=\"secondary\"\n                textId={descriptionId}\n              >\n                {option.description}\n              </ds-text>\n            ) : null}\n          </span>\n        </div>\n      );\n    });\n  }\n\n  render() {\n    const inactive = this.isInactive || this.disabled || this.formDisabled;\n    const invalid = this.required && !inactive && !this.hasSelection;\n    const selectedIdx = this.options.findIndex(option => option.value === this.value);\n    const firstActiveIdx = this.options.findIndex(option => !inactive && !option.isInactive);\n    const focusableIdx =\n      selectedIdx >= 0 && !inactive && !this.options[selectedIdx]?.isInactive\n        ? selectedIdx\n        : firstActiveIdx;\n    const renderedOptions = this.renderOptions(inactive, focusableIdx);\n\n    return (\n      <Host\n        role=\"radiogroup\"\n        aria-label={this.showGroupLabel ? this.groupLabel : this.ariaLabel}\n        aria-labelledby={this.ariaLabelledby}\n        aria-required={this.required ? 'true' : undefined}\n        aria-invalid={invalid ? 'true' : undefined}\n        class={{\n          radio: true,\n          'radio--horizontal': this.direction === 'horizontal',\n          [`radio--${this.size}`]: true,\n          'radio--labeled': this.showGroupLabel,\n        }}\n      >\n        {this.showGroupLabel ? (\n          <ds-text\n            key=\"radio-group-label\"\n            class={`radio__group-label ds-control-section-heading ds-control--${this.size}`}\n            as=\"span\"\n            variant=\"text-body-small\"\n            emphasis\n          >\n            {this.groupLabel}\n          </ds-text>\n        ) : null}\n        <div key=\"radio-options\" class=\"radio__options\">\n          {renderedOptions}\n        </div>\n      </Host>\n    );\n  }\n}\n",
+      "content": "import {\n  AttachInternals,\n  Component,\n  Prop,\n  State,\n  Event,\n  EventEmitter,\n  Element,\n  Listen,\n  Method,\n  Watch,\n  h,\n  Host,\n} from '@stencil/core';\nimport {\n  CONTROL_SUPPORTING_TEXT_VARIANT,\n  CONTROL_TEXT_VARIANT,\n  DEFAULT_REQUIRED_MESSAGE,\n  restoreStringFormState,\n  setFormControlValue,\n  setRequiredValidity,\n} from '../../utils';\n\nexport interface RadioOption {\n  label: string;\n  value: string;\n  description?: string;\n  isInactive?: boolean;\n}\n\nexport type RadioSize = 'lg' | 'md' | 'sm' | 'xs';\n\nlet radioIdCounter = 0;\n\n@Component({\n  tag: 'ds-radio',\n  styleUrl: 'Radio.css',\n  scoped: true,\n  formAssociated: true,\n})\nexport class Radio {\n  @Element() el!: HTMLElement;\n  @AttachInternals() internals!: ElementInternals;\n\n  private readonly instanceId = ++radioIdCounter;\n\n  /** Visible choices in this one-of-many set. */\n  @Prop() options: RadioOption[] = [];\n  /** Optional visible group label rendered above the options. */\n  @Prop() groupLabel: string = '';\n  /** Selected option value. */\n  @Prop({ mutable: true }) value: string = '';\n  /** Visual and placement density for every option. */\n  @Prop() size: RadioSize = 'md';\n  /** Native form field name. */\n  @Prop({ reflect: true }) name: string | undefined;\n  /** Associates the radio set with a form by id when rendered outside that form. */\n  @Prop({ reflect: true }) form: string | undefined;\n  /** Native disabled state for the complete set. */\n  @Prop({ reflect: true }) disabled: boolean = false;\n  /** Require one option to be selected for form validity. */\n  @Prop({ reflect: true }) required: boolean = false;\n  /** Validation message used when a required set has no selection. */\n  @Prop() requiredMessage: string = DEFAULT_REQUIRED_MESSAGE;\n  /** Layout direction for the option set. */\n  @Prop() direction: 'vertical' | 'horizontal' = 'vertical';\n  /** Design-system inactive state for the complete set. */\n  @Prop() isInactive: boolean = false;\n  /** Preserve each option while replacing its circle and copy with loading atoms. */\n  @Prop() isLoading: boolean = false;\n  /** Show full-row hover and pressed feedback for choice-list presentations. */\n  @Prop() hasInteractionFill: boolean = false;\n  /** Accessible name when visible group labeling is unavailable. */\n  @Prop({ attribute: 'aria-label' }) ariaLabel: string | null = null;\n  /** Id reference for a visible group label. */\n  @Prop({ attribute: 'aria-labelledby' }) ariaLabelledby: string | undefined;\n\n  /** Emitted after user selection with the selected option value. */\n  @Event() dsChange!: EventEmitter<string>;\n\n  private initialValue = '';\n  @State() private formDisabled = false;\n\n  private get hasGroupLabel(): boolean {\n    return Boolean(this.groupLabel.trim());\n  }\n\n  private get hasSelection(): boolean {\n    return this.options.some(option => option.value === this.value && !option.isInactive);\n  }\n\n  /** Settings rows own a separate heading; never mount the form group label there. */\n  private get showGroupLabel(): boolean {\n    return this.hasGroupLabel && !this.el.closest('ds-setting-row-radio');\n  }\n\n  componentWillLoad() {\n    this.initialValue = this.value;\n    this.syncFormValue();\n  }\n\n  @Watch('value')\n  @Watch('options')\n  @Watch('disabled')\n  @Watch('isInactive')\n  @Watch('required')\n  @Watch('requiredMessage')\n  syncFormValue() {\n    const inactive = this.isInactive || this.disabled || this.formDisabled;\n    setFormControlValue(this.internals, this.hasSelection ? this.value : '', {\n      inactive,\n      state: this.value,\n    });\n    const missing = this.required && !inactive && !this.hasSelection;\n    setRequiredValidity(this.internals, missing, this.requiredMessage);\n  }\n\n  formDisabledCallback(disabled: boolean) {\n    this.formDisabled = disabled;\n    this.syncFormValue();\n  }\n\n  formResetCallback() {\n    this.value = this.initialValue;\n  }\n\n  formStateRestoreCallback(state: string | File | FormData | null) {\n    this.value = restoreStringFormState(state);\n  }\n\n  /** Focus the selected option, or the first active option when nothing is selected. */\n  @Method()\n  async setFocus() {\n    this.activeItems.find(item => item.tabIndex === 0)?.focus();\n  }\n\n  private get activeItems(): HTMLElement[] {\n    return Array.from(\n      this.el.querySelectorAll<HTMLElement>('[data-radio-item]:not([data-inactive])')\n    );\n  }\n\n  @Listen('keydown')\n  handleKeyDown(e: KeyboardEvent) {\n    if (this.isLoading) return;\n    const items = this.activeItems;\n    if (!items.length) return;\n\n    const focused = items.find(item => item === document.activeElement);\n    if (!focused) return;\n\n    const idx = items.indexOf(focused);\n    let next = -1;\n\n    switch (e.key) {\n      case 'ArrowDown':\n      case 'ArrowRight':\n        e.preventDefault();\n        next = (idx + 1) % items.length;\n        break;\n      case 'ArrowUp':\n      case 'ArrowLeft':\n        e.preventDefault();\n        next = (idx - 1 + items.length) % items.length;\n        break;\n      case 'Home':\n        e.preventDefault();\n        next = 0;\n        break;\n      case 'End':\n        e.preventDefault();\n        next = items.length - 1;\n        break;\n    }\n\n    if (next >= 0) {\n      items[next].focus();\n      const nextValue = items[next].dataset['value'];\n      if (nextValue !== undefined && nextValue !== this.value) {\n        this.value = nextValue;\n        this.dsChange.emit(nextValue);\n      }\n    }\n  }\n\n  private selectItem(optValue: string) {\n    if (this.isLoading || this.isInactive || this.disabled || this.formDisabled) return;\n    if (optValue !== this.value) {\n      this.value = optValue;\n      this.dsChange.emit(optValue);\n    }\n  }\n\n  private renderOptions(inactive: boolean, focusableIdx: number) {\n    return this.options.map((option, index) => {\n      const isItemInactive = inactive || !!option.isInactive;\n      const isChecked = option.value === this.value;\n      const tabIdx = isItemInactive ? -1 : index === focusableIdx ? 0 : -1;\n      const labelId = `ds-radio-${this.instanceId}-label-${index}`;\n      const descriptionId = `ds-radio-${this.instanceId}-description-${index}`;\n\n      return (\n        <div\n          key={option.value}\n          role=\"radio\"\n          aria-checked={String(isChecked)}\n          aria-disabled={isItemInactive ? 'true' : undefined}\n          aria-labelledby={labelId}\n          aria-describedby={option.description ? descriptionId : undefined}\n          tabIndex={this.isLoading ? -1 : tabIdx}\n          aria-hidden={this.isLoading ? 'true' : undefined}\n          inert={this.isLoading}\n          data-radio-item\n          data-value={option.value}\n          data-inactive={isItemInactive || undefined}\n          class={{\n            radio__item: true,\n            'radio__item--described': Boolean(option.description),\n            [`ds-control--${this.size}`]: true,\n            'ds-control-inactive': isItemInactive,\n            'ds-focus-ring-inset': !isItemInactive,\n            'ds-interaction-fill': !isItemInactive && this.hasInteractionFill,\n          }}\n          onClick={() => !isItemInactive && this.selectItem(option.value)}\n          onKeyDown={(e: KeyboardEvent) => {\n            if ((e.key === ' ' || e.key === 'Enter') && !isItemInactive) {\n              e.preventDefault();\n              this.selectItem(option.value);\n            }\n          }}\n        >\n          <span class=\"radio__placement ds-interaction-fill__content\" aria-hidden=\"true\">\n            <ds-skeleton preserveLayout isLoading={this.isLoading} variant=\"control\" rounded>\n              <span class={{ radio__circle: true, 'radio__circle--checked': isChecked }}>\n                {isChecked && <span class=\"radio__dot\" />}\n              </span>\n            </ds-skeleton>\n          </span>\n          <span class=\"radio__copy ds-interaction-fill__content\">\n            <ds-skeleton\n              preserveLayout\n              isLoading={this.isLoading}\n              textVariant={CONTROL_TEXT_VARIANT[this.size]}\n            >\n              <ds-text\n                class=\"radio__label\"\n                as=\"span\"\n                variant={CONTROL_TEXT_VARIANT[this.size]}\n                textId={labelId}\n              >\n                {option.label}\n              </ds-text>\n            </ds-skeleton>\n            {option.description ? (\n              <ds-skeleton\n                preserveLayout\n                isLoading={this.isLoading}\n                textVariant={CONTROL_SUPPORTING_TEXT_VARIANT[this.size]}\n              >\n                <ds-text\n                  as=\"span\"\n                  variant={CONTROL_SUPPORTING_TEXT_VARIANT[this.size]}\n                  color=\"secondary\"\n                  textId={descriptionId}\n                >\n                  {option.description}\n                </ds-text>\n              </ds-skeleton>\n            ) : null}\n          </span>\n        </div>\n      );\n    });\n  }\n\n  render() {\n    const inactive = this.isInactive || this.disabled || this.formDisabled;\n    const invalid = this.required && !inactive && !this.hasSelection;\n    const selectedIdx = this.options.findIndex(option => option.value === this.value);\n    const firstActiveIdx = this.options.findIndex(option => !inactive && !option.isInactive);\n    const focusableIdx =\n      selectedIdx >= 0 && !inactive && !this.options[selectedIdx]?.isInactive\n        ? selectedIdx\n        : firstActiveIdx;\n    const renderedOptions = this.renderOptions(inactive, focusableIdx);\n\n    return (\n      <Host\n        role=\"radiogroup\"\n        aria-busy={this.isLoading ? 'true' : undefined}\n        aria-label={this.showGroupLabel ? this.groupLabel : this.ariaLabel}\n        aria-labelledby={this.ariaLabelledby}\n        aria-required={this.required ? 'true' : undefined}\n        aria-invalid={invalid ? 'true' : undefined}\n        class={{\n          radio: true,\n          'radio--horizontal': this.direction === 'horizontal',\n          [`radio--${this.size}`]: true,\n          'radio--labeled': this.showGroupLabel,\n        }}\n      >\n        {this.showGroupLabel ? (\n          <ds-skeleton preserveLayout isLoading={this.isLoading} textVariant={'text-body-small'}>\n            <ds-text\n              key=\"radio-group-label\"\n              class={`radio__group-label ds-control-section-heading ds-control--${this.size}`}\n              as=\"span\"\n              variant=\"text-body-small\"\n              emphasis\n            >\n              {this.groupLabel}\n            </ds-text>\n          </ds-skeleton>\n        ) : null}\n        <div key=\"radio-options\" class=\"radio__options\">\n          {renderedOptions}\n        </div>\n      </Host>\n    );\n  }\n}\n",
       "type": "registry:ui"
     }
   ]