@ds-mo/ui 15.1.1 → 15.3.0

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

@@ -369,8 +369,8 @@
       "complexPropertyNote": "Assign these non-primitive values as JavaScript properties: fieldOrder, fields, hiddenFieldIds, options.",
       "peerDependencies": {
         "required": [
-          "@ds-mo/tokens ^6.5.1",
-          "@ds-mo/icons ^8.1.0"
+          "@ds-mo/tokens ^6.5.2",
+          "@ds-mo/icons ^8.1.1"
         ],
         "frameworks": "Custom Elements; React 18/19 wrappers; Vue 3 wrappers; Angular 19-22 standalone adapters."
       }
@@ -392,7 +392,7 @@
     },
     {
       "path": "src/wc/components/DataCustomize/DataCustomize.tsx",
-      "content": "import {\n  Component,\n  Element,\n  Event,\n  EventEmitter,\n  h,\n  Host,\n  Method,\n  Prop,\n  State,\n} from '@stencil/core';\nimport type { DataField } from '../../utils/data-field';\nimport type { MenuItemData, MenuSection } from '../Menu/menu-types';\nimport {\n  listCustomizerMenuItems,\n  resolveListOrder,\n  toggleListHidden,\n  type ListCustomizerOptions,\n} from '../../utils/list-customizer';\n\nexport interface DataCustomizeChangeDetail {\n  /** Fields the viewer has hidden, in the order they were hidden. */\n  hiddenFieldIds: string[];\n  /** Field ids in display order. Unchanged unless the catalog reorders. */\n  fieldOrder: string[];\n}\n\nlet dataCustomizeSeq = 0;\n\n/**\n * Show, hide and optionally reorder the data points a view renders.\n *\n * The table owns its own column customizer inside the caption, because a table\n * locks its last visible column and reorders columns. This control is the same\n * catalog for every other surface — a card list, a map overlay — where the\n * fields are independent and usually only show and hide.\n */\n@Component({\n  tag: 'ds-data-customize',\n  styleUrl: 'DataCustomize.css',\n  scoped: true,\n})\nexport class DataCustomize {\n  @Element() private el!: HTMLElement;\n\n  /** Show the trigger border. */\n  @Prop() hasBorder: boolean = true;\n  /** Catalog of data points the view can render. */\n  @Prop() fields: DataField[] = [];\n  /** Controlled hidden field ids. */\n  @Prop() hiddenFieldIds: string[] = [];\n  /** Controlled display order. Ids missing from it keep catalog order. */\n  @Prop() fieldOrder: string[] = [];\n  /**\n   * Drag-reorder the catalog rows. Off by default: most surfaces only show and\n   * hide, and a card layout has no column order to express.\n   */\n  @Prop() reorderable: boolean = false;\n  /**\n   * Fields that must stay visible. Zero by default, so a view whose identity\n   * lives outside this catalog can hide every entry in it.\n   */\n  @Prop() minVisible: number = 0;\n  /** Section header above the catalog rows. Omitted when there is no second section. */\n  @Prop() catalogHeader?: string;\n  /** Extra switch rows rendered in their own Options section. */\n  @Prop() options: MenuItemData[] = [];\n  /** Header for the options section. */\n  @Prop() optionsHeader: string = 'Options';\n  /** Accessible name for the trigger and menu. */\n  @Prop({ attribute: 'aria-label' }) ariaLabel: string | null = null;\n  /** Visible trigger label. Collapses to the icon when space is tight. */\n  @Prop() label: string = 'Customize';\n\n  @Event({ bubbles: false }) dsFieldsConfigChange!: EventEmitter<DataCustomizeChangeDetail>;\n  @Event({ bubbles: false }) dsOptionChange!: EventEmitter<string>;\n\n  @State() private menuOpen = false;\n  @State() private menuSurfaceOpen = false;\n  @State() private initialFocusVisible = false;\n\n  private readonly componentId = `ds-data-customize-${++dataCustomizeSeq}`;\n  private readonly triggerId = `${this.componentId}-trigger`;\n  private readonly menuId = `${this.componentId}-menu`;\n\n  @Method()\n  async setFocus() {\n    const trigger = this.el.querySelector<HTMLElement & { setFocus?: () => Promise<void> }>(\n      `#${CSS.escape(this.triggerId)}`\n    );\n    await trigger?.setFocus?.();\n  }\n\n  private get customizerOptions(): ListCustomizerOptions {\n    return { minVisible: this.minVisible, reorderable: this.reorderable };\n  }\n\n  private get catalog(): { id: string; label: string }[] {\n    return this.fields.map(field => ({\n      id: field.id,\n      label: field.label.trim() || field.accessibleLabel?.trim() || field.id,\n    }));\n  }\n\n  private get sections(): MenuSection[] {\n    const rows = listCustomizerMenuItems(\n      this.catalog,\n      this.hiddenFieldIds,\n      this.fieldOrder,\n      this.customizerOptions\n    );\n\n    return [\n      ...(rows.length\n        ? [\n            {\n              header: this.catalogHeader ?? (this.options.length ? 'Data' : undefined),\n              items: rows,\n            },\n          ]\n        : []),\n      ...(this.options.length ? [{ header: this.optionsHeader, items: this.options }] : []),\n    ];\n  }\n\n  render() {\n    const name = this.ariaLabel?.trim() || this.label?.trim() || 'Customize';\n    const empty = this.fields.length === 0 && this.options.length === 0;\n\n    return (\n      <Host hidden={empty ? true : undefined}>\n        {empty ? null : (\n          <ds-button-unfilled\n            hasBorder={this.hasBorder}\n            id={this.triggerId}\n            variant=\"icon-label\"\n            size=\"md\"\n            icon=\"ViewMenu\"\n            label={this.label}\n            labelEmphasis={false}\n            pressScale={false}\n            aria-label={name}\n            haspopup=\"menu\"\n            collapseLabel={true}\n            expanded={this.menuOpen}\n            surfaceOpen={this.menuSurfaceOpen}\n            controls={this.menuId}\n            onDsClick={(event: CustomEvent<MouseEvent>) => {\n              this.toggle(event.detail.detail === 0);\n            }}\n          />\n        )}\n        {empty ? null : (\n          <ds-menu\n            id={this.menuId}\n            open={this.menuOpen}\n            anchorId={this.triggerId}\n            align=\"start\"\n            side=\"bottom\"\n            menuLabel={name}\n            selectionMode=\"none\"\n            initialFocusVisible={this.initialFocusVisible}\n            sections={this.sections}\n            onDsClose={() => this.close()}\n            onDsAfterClose={() => {\n              if (!this.menuOpen) this.menuSurfaceOpen = false;\n            }}\n            onDsSelect={event => this.handleSelect(event.detail)}\n            onDsReorder={event => this.handleReorder(event.detail.items)}\n          />\n        )}\n      </Host>\n    );\n  }\n\n  private toggle(fromKeyboard = false): void {\n    if (this.menuOpen) this.close();\n    else this.open(fromKeyboard);\n  }\n\n  private open(fromKeyboard = false): void {\n    if (this.menuOpen) return;\n    this.initialFocusVisible = fromKeyboard;\n    this.menuOpen = true;\n    this.menuSurfaceOpen = true;\n  }\n\n  private close(): void {\n    this.menuOpen = false;\n  }\n\n  private handleSelect(item: MenuItemData): void {\n    const value = item.value;\n    if (!value || item.isInactive) return;\n\n    if (this.options.some(option => option.value === value)) {\n      this.dsOptionChange.emit(value);\n      return;\n    }\n\n    const ids = this.catalog.map(entry => entry.id);\n    this.dsFieldsConfigChange.emit({\n      hiddenFieldIds: toggleListHidden(ids, this.hiddenFieldIds, value, this.customizerOptions),\n      fieldOrder: resolveListOrder(ids, this.fieldOrder),\n    });\n  }\n\n  private handleReorder(items: MenuItemData[]): void {\n    if (!this.reorderable) return;\n\n    // Menu reports the new order of the reorderable run. resolveListOrder\n    // rebuilds the full order from it, appending anything the run omitted.\n    const next = items\n      .filter(item => item.reorderable && item.value)\n      .map(item => item.value as string);\n    if (next.length === 0) return;\n\n    this.dsFieldsConfigChange.emit({\n      hiddenFieldIds: this.hiddenFieldIds,\n      fieldOrder: resolveListOrder(\n        this.catalog.map(entry => entry.id),\n        next\n      ),\n    });\n  }\n}\n",
+      "content": "import {\n  Component,\n  Element,\n  Event,\n  EventEmitter,\n  h,\n  Host,\n  Method,\n  Prop,\n  State,\n} from '@stencil/core';\nimport type { DataField } from '../../utils/data-field';\nimport type { MenuItemData, MenuSection } from '../Menu/menu-types';\nimport {\n  listCustomizerMenuItems,\n  resolveListOrder,\n  toggleListHidden,\n  type ListCustomizerOptions,\n} from '../../utils/list-customizer';\n\nexport interface DataCustomizeChangeDetail {\n  /** Fields the viewer has hidden, in the order they were hidden. */\n  hiddenFieldIds: string[];\n  /** Field ids in display order. Unchanged unless the catalog reorders. */\n  fieldOrder: string[];\n}\n\nlet dataCustomizeSeq = 0;\n\n/**\n * Show, hide and optionally reorder the data points a view renders.\n *\n * The table owns its own column customizer inside the caption, because a table\n * locks its last visible column and reorders columns. This control is the same\n * catalog for every other surface — a card list, a map overlay — where the\n * fields are independent and usually only show and hide.\n */\n@Component({\n  tag: 'ds-data-customize',\n  styleUrl: 'DataCustomize.css',\n  scoped: true,\n})\nexport class DataCustomize {\n  @Element() private el!: HTMLElement;\n\n  /** Show the trigger border. */\n  @Prop() hasBorder: boolean = true;\n  /** Catalog of data points the view can render. */\n  @Prop() fields: DataField[] = [];\n  /** Controlled hidden field ids. */\n  @Prop() hiddenFieldIds: string[] = [];\n  /** Controlled display order. Ids missing from it keep catalog order. */\n  @Prop() fieldOrder: string[] = [];\n  /**\n   * Drag-reorder the catalog rows. Off by default: most surfaces only show and\n   * hide, and a card layout has no column order to express.\n   */\n  @Prop() reorderable: boolean = false;\n  /**\n   * Fields that must stay visible. Zero by default, so a view whose identity\n   * lives outside this catalog can hide every entry in it.\n   */\n  @Prop() minVisible: number = 0;\n  /** Section header above the catalog rows. Omitted when there is no second section. */\n  @Prop() catalogHeader?: string;\n  /** Extra switch rows rendered in their own Options section. */\n  @Prop() options: MenuItemData[] = [];\n  /** Header for the options section. */\n  @Prop() optionsHeader: string = 'Options';\n  /** Accessible name for the trigger and menu. */\n  @Prop({ attribute: 'aria-label' }) ariaLabel: string | null = null;\n  /** Visible trigger label. Collapses to the icon when space is tight. */\n  @Prop() label: string = 'Customize';\n\n  @Event({ bubbles: false }) dsFieldsConfigChange!: EventEmitter<DataCustomizeChangeDetail>;\n  @Event({ bubbles: false }) dsOptionChange!: EventEmitter<string>;\n\n  @State() private menuOpen = false;\n  @State() private menuSurfaceOpen = false;\n  @State() private initialFocusVisible = false;\n\n  private readonly componentId = `ds-data-customize-${++dataCustomizeSeq}`;\n  private readonly triggerId = `${this.componentId}-trigger`;\n  private readonly menuId = `${this.componentId}-menu`;\n\n  @Method()\n  async setFocus() {\n    const trigger = this.el.querySelector<HTMLElement & { setFocus?: () => Promise<void> }>(\n      `#${CSS.escape(this.triggerId)}`\n    );\n    await trigger?.setFocus?.();\n  }\n\n  private get customizerOptions(): ListCustomizerOptions {\n    return { minVisible: this.minVisible, reorderable: this.reorderable };\n  }\n\n  private get catalog(): { id: string; label: string }[] {\n    return this.fields.map(field => ({\n      id: field.id,\n      label: field.label.trim() || field.accessibleLabel?.trim() || field.id,\n    }));\n  }\n\n  private get sections(): MenuSection[] {\n    const rows = listCustomizerMenuItems(\n      this.catalog,\n      this.hiddenFieldIds,\n      this.fieldOrder,\n      this.customizerOptions\n    );\n\n    return [\n      ...(rows.length\n        ? [\n            {\n              header: this.catalogHeader ?? (this.options.length ? 'Data' : undefined),\n              items: rows,\n            },\n          ]\n        : []),\n      ...(this.options.length ? [{ header: this.optionsHeader, items: this.options }] : []),\n    ];\n  }\n\n  render() {\n    const name = this.ariaLabel?.trim() || this.label?.trim() || 'Customize';\n    const empty = this.fields.length === 0 && this.options.length === 0;\n\n    return (\n      <Host hidden={empty ? true : undefined}>\n        {empty ? null : (\n          <ds-button-unfilled\n            hasBorder={this.hasBorder}\n            id={this.triggerId}\n            variant=\"icon-label\"\n            size=\"md\"\n            icon=\"Preferences\"\n            label={this.label}\n            labelEmphasis={false}\n            pressScale={false}\n            aria-label={name}\n            haspopup=\"menu\"\n            collapseLabel={true}\n            expanded={this.menuOpen}\n            surfaceOpen={this.menuSurfaceOpen}\n            controls={this.menuId}\n            onDsClick={(event: CustomEvent<MouseEvent>) => {\n              this.toggle(event.detail.detail === 0);\n            }}\n          />\n        )}\n        {empty ? null : (\n          <ds-menu\n            id={this.menuId}\n            open={this.menuOpen}\n            anchorId={this.triggerId}\n            align=\"start\"\n            side=\"bottom\"\n            menuLabel={name}\n            selectionMode=\"none\"\n            initialFocusVisible={this.initialFocusVisible}\n            sections={this.sections}\n            onDsClose={() => this.close()}\n            onDsAfterClose={() => {\n              if (!this.menuOpen) this.menuSurfaceOpen = false;\n            }}\n            onDsSelect={event => this.handleSelect(event.detail)}\n            onDsReorder={event => this.handleReorder(event.detail.items)}\n          />\n        )}\n      </Host>\n    );\n  }\n\n  private toggle(fromKeyboard = false): void {\n    if (this.menuOpen) this.close();\n    else this.open(fromKeyboard);\n  }\n\n  private open(fromKeyboard = false): void {\n    if (this.menuOpen) return;\n    this.initialFocusVisible = fromKeyboard;\n    this.menuOpen = true;\n    this.menuSurfaceOpen = true;\n  }\n\n  private close(): void {\n    this.menuOpen = false;\n  }\n\n  private handleSelect(item: MenuItemData): void {\n    const value = item.value;\n    if (!value || item.isInactive) return;\n\n    if (this.options.some(option => option.value === value)) {\n      this.dsOptionChange.emit(value);\n      return;\n    }\n\n    const ids = this.catalog.map(entry => entry.id);\n    this.dsFieldsConfigChange.emit({\n      hiddenFieldIds: toggleListHidden(ids, this.hiddenFieldIds, value, this.customizerOptions),\n      fieldOrder: resolveListOrder(ids, this.fieldOrder),\n    });\n  }\n\n  private handleReorder(items: MenuItemData[]): void {\n    if (!this.reorderable) return;\n\n    // Menu reports the new order of the reorderable run. resolveListOrder\n    // rebuilds the full order from it, appending anything the run omitted.\n    const next = items\n      .filter(item => item.reorderable && item.value)\n      .map(item => item.value as string);\n    if (next.length === 0) return;\n\n    this.dsFieldsConfigChange.emit({\n      hiddenFieldIds: this.hiddenFieldIds,\n      fieldOrder: resolveListOrder(\n        this.catalog.map(entry => entry.id),\n        next\n      ),\n    });\n  }\n}\n",
       "type": "registry:ui"
     }
   ]

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

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

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

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

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

@@ -557,8 +557,8 @@
       "complexPropertyNote": "Assign these non-primitive values as JavaScript properties: customizeOptions, customizeSections, fieldOrder, fields, filters, grouping, groupingOptions, hiddenFieldIds, matchModes, sort, sortColumns, values.",
       "peerDependencies": {
         "required": [
-          "@ds-mo/tokens ^6.5.1",
-          "@ds-mo/icons ^8.1.0"
+          "@ds-mo/tokens ^6.5.2",
+          "@ds-mo/icons ^8.1.1"
         ],
         "frameworks": "Custom Elements; React 18/19 wrappers; Vue 3 wrappers; Angular 19-22 standalone adapters."
       }

package/dist/mcp-data/registry/data-saved-views.json

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

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

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

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

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

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

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

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

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

package/dist/mcp-data/registry/empty-state.json

@@ -2,7 +2,7 @@
   "$schema": "https://ui.shadcn.com/schema/registry-item.json",
   "name": "empty-state",
   "title": "EmptyState",
-  "description": "Centered empty-content message composed as icon plus title plus body, title plus body, or compact body-only content.",
+  "description": "Centered empty-content message with optional consumer-owned recovery actions.",
   "type": "registry:ui",
   "meta": {
     "library": "@ds-mo/ui",
@@ -13,16 +13,16 @@
     "intent": {
       "audience": "general",
       "status": "stable",
-      "summary": "Centered empty-content message composed as icon plus title plus body, title plus body, or compact body-only content.",
+      "summary": "Centered empty-content message with optional consumer-owned recovery actions.",
       "useWhen": [
         "A bounded content area is in a first-use, no-content, filtered no-results, or no-access state and needs a calm explanatory message tailored to that cause.",
         "A prominent empty region benefits from a decorative icon, visual title, and supporting body copy.",
-        "A compact owner such as a Select popup needs only centered body copy."
+        "A compact owner such as a Select popup needs only centered body copy.",
+        "An empty region needs a concise recovery action that helps the user reveal or create content."
       ],
       "avoidWhen": [
         "Content is still loading; use Skeleton for predictable structure or Loader for an indeterminate operation.",
         "The state is an error, warning, or confirmation that needs semantic intent and announcement from the owning workflow.",
-        "The state needs a recovery action, link, or other interactive content; the current EmptyState pattern is intentionally message-only.",
         "A decorative illustration, arbitrary rich content, or custom layout is required."
       ],
       "alternatives": [
@@ -46,20 +46,23 @@
         "component:ds-table",
         "component:ds-select",
         "component:ds-text",
-        "component:ds-icon"
+        "component:ds-icon",
+        "component:ds-button-unfilled"
       ],
       "accessibility": [
         "The optional icon is decorative; the title and body provide all meaning in text.",
         "EmptyState does not create a live region or alert automatically. The owner decides whether a dynamic transition requires announcement.",
         "The visual title does not impose a document heading level because the correct hierarchy belongs to the consuming page or region.",
-        "Keep localized body copy concise and sufficient when using the body-only variant."
+        "Keep localized body copy concise and sufficient when using the body-only variant.",
+        "Give recovery controls explicit accessible names and keep their behavior with the owning workflow."
       ],
       "states": [
         "Supported compositions are icon plus title plus body, title plus body, and body only; body copy is present in every supported composition.",
         "The decorative icon renders at xl in the primary foreground with an 8px gap before the text group and only when a title is also provided.",
         "The visual title uses title-small primary text; body uses body-medium secondary text with a 4px title-to-body gap.",
-        "All content is centered. The owner supplies container size and surrounding padding; repeated panel and master-detail owners should share one empty-region geometry instead of wrapping each EmptyState differently. Do not compose actions into or immediately alongside the current EmptyState pattern.",
-        "First-use, no-content, no-results, and no-access states reuse this primitive with cause-specific localized messages rather than visual variants."
+        "All content is centered. The owner supplies container size and surrounding padding; repeated panel and master-detail owners should share one empty-region geometry instead of wrapping each EmptyState differently.",
+        "First-use, no-content, no-results, and no-access states reuse this primitive with cause-specific localized messages rather than visual variants.",
+        "Recovery actions are optional. The consumer owns the action labels, control choice, and behavior; the component centers them below the message and wraps multiple actions when needed."
       ],
       "responsiveBehavior": [
         "The owner controls available width and height; text wraps naturally while remaining centered.",
@@ -122,7 +125,12 @@
       },
       "events": [],
       "methods": [],
-      "slots": []
+      "slots": [
+        {
+          "name": "actions",
+          "description": "Optional recovery buttons or links. The consumer owns their labels and behavior."
+        }
+      ]
     },
     "props": {
       "body": {
@@ -153,7 +161,12 @@
     },
     "events": [],
     "methods": [],
-    "slots": [],
+    "slots": [
+      {
+        "name": "actions",
+        "description": "Optional recovery buttons or links. The consumer owns their labels and behavior."
+      }
+    ],
     "exports": {
       "customElement": "ds-empty-state",
       "react": "DsEmptyState",
@@ -181,8 +194,8 @@
       },
       "peerDependencies": {
         "required": [
-          "@ds-mo/tokens ^6.5.1",
-          "@ds-mo/icons ^8.1.0"
+          "@ds-mo/tokens ^6.5.2",
+          "@ds-mo/icons ^8.1.1"
         ],
         "frameworks": "Custom Elements; React 18/19 wrappers; Vue 3 wrappers; Angular 19-22 standalone adapters."
       }
@@ -200,12 +213,12 @@
   "files": [
     {
       "path": "src/wc/components/EmptyState/EmptyState.css",
-      "content": ":host {\n  display: block;\n  width: 100%;\n  height: 100%;\n}\n\n:host,\n.empty-state,\n.empty-state__text {\n  box-sizing: border-box;\n}\n\n.empty-state {\n  display: flex;\n  flex-direction: column;\n  align-items: center;\n  justify-content: center;\n  gap: var(--dimension-space-100);\n  height: 100%;\n  width: 100%;\n  text-align: center;\n}\n\n.empty-state__icon {\n  flex: 0 0 auto;\n}\n\n.empty-state__text {\n  display: flex;\n  flex-direction: column;\n  align-items: center;\n  gap: var(--dimension-space-050);\n  width: 100%;\n}\n",
+      "content": ":host {\n  display: block;\n  width: 100%;\n  height: 100%;\n}\n\n:host,\n.empty-state,\n.empty-state__text {\n  box-sizing: border-box;\n}\n\n.empty-state {\n  display: flex;\n  flex-direction: column;\n  align-items: center;\n  justify-content: center;\n  height: 100%;\n  width: 100%;\n  text-align: center;\n}\n\n.empty-state__icon {\n  margin-block-end: var(--dimension-space-100);\n  flex: 0 0 auto;\n}\n\n.empty-state__text {\n  display: flex;\n  flex-direction: column;\n  align-items: center;\n  gap: var(--dimension-space-050);\n  width: 100%;\n}\n\n.empty-state__actions {\n  margin-block-start: var(--dimension-space-200);\n  display: flex;\n  flex-wrap: wrap;\n  align-items: center;\n  justify-content: center;\n  gap: var(--dimension-space-100);\n}\n\n.empty-state__actions:not(:has([slot='actions'])) {\n  display: none;\n}\n\n.empty-state__title,\n.empty-state__body {\n  text-wrap: balance;\n}\n",
       "type": "registry:ui"
     },
     {
       "path": "src/wc/components/EmptyState/EmptyState.tsx",
-      "content": "import { Component, Prop, h, Host } from '@stencil/core';\n\n@Component({\n  tag: 'ds-empty-state',\n  styleUrl: 'EmptyState.css',\n  scoped: true,\n})\nexport class EmptyState {\n  /** Optional decorative prefix glyph for the complete icon + title + body variant. */\n  @Prop() icon: string | undefined;\n  /** Optional visual title. Use with body; required when icon is provided. */\n  @Prop() heading: string | undefined;\n  /** Explanatory empty-state copy. Every supported variant includes body text. */\n  @Prop() body: string = '';\n\n  render() {\n    const showHeading = Boolean(this.heading?.trim());\n    const showIcon = showHeading && Boolean(this.icon);\n\n    return (\n      <Host>\n        <div class=\"empty-state\">\n          {showIcon && (\n            <ds-icon class=\"empty-state__icon\" name={this.icon} size=\"xl\" color=\"primary\" />\n          )}\n          <div class=\"empty-state__text\">\n            {showHeading && (\n              <ds-text\n                class=\"empty-state__title\"\n                as=\"div\"\n                variant=\"text-title-small\"\n                color=\"primary\"\n                align=\"center\"\n              >\n                {this.heading}\n              </ds-text>\n            )}\n            {this.body && (\n              <ds-text\n                class=\"empty-state__body\"\n                as=\"p\"\n                variant=\"text-body-medium\"\n                color=\"secondary\"\n                align=\"center\"\n              >\n                {this.body}\n              </ds-text>\n            )}\n          </div>\n        </div>\n      </Host>\n    );\n  }\n}\n",
+      "content": "import { Component, Prop, h, Host } from '@stencil/core';\n\n/**\n * @slot actions - Optional recovery buttons or links. The consumer owns their labels and behavior.\n */\n@Component({\n  tag: 'ds-empty-state',\n  styleUrl: 'EmptyState.css',\n  scoped: true,\n})\nexport class EmptyState {\n  /** Optional decorative prefix glyph for the complete icon + title + body variant. */\n  @Prop() icon: string | undefined;\n  /** Optional visual title. Use with body; required when icon is provided. */\n  @Prop() heading: string | undefined;\n  /** Explanatory empty-state copy. Every supported variant includes body text. */\n  @Prop() body: string = '';\n\n  render() {\n    const showHeading = Boolean(this.heading?.trim());\n    const showIcon = showHeading && Boolean(this.icon);\n\n    return (\n      <Host>\n        <div class=\"empty-state\">\n          {showIcon && (\n            <ds-icon class=\"empty-state__icon\" name={this.icon} size=\"xl\" color=\"primary\" />\n          )}\n          <div class=\"empty-state__text\">\n            {showHeading && (\n              <ds-text\n                class=\"empty-state__title\"\n                as=\"div\"\n                variant=\"text-title-small\"\n                color=\"primary\"\n                align=\"center\"\n              >\n                {this.heading}\n              </ds-text>\n            )}\n            {this.body && (\n              <ds-text\n                class=\"empty-state__body\"\n                as=\"p\"\n                variant=\"text-body-medium\"\n                color=\"secondary\"\n                align=\"center\"\n              >\n                {this.body}\n              </ds-text>\n            )}\n          </div>\n          <div class=\"empty-state__actions\">\n            <slot name=\"actions\" />\n          </div>\n        </div>\n      </Host>\n    );\n  }\n}\n",
       "type": "registry:ui"
     }
   ]

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

@@ -54,7 +54,8 @@
         "Field exposes data-focused, data-filled, data-dirty, data-touched, data-invalid, data-disabled, and data-required hooks while the slotted control remains the source of value and interaction behavior.",
         "A rendered error replaces the description; preserve essential guidance in the error message so users retain what they need to correct the field.",
         "Field owns validation presentation but not validation timing; the form decides when to set error and errorMessage.",
-        "The label uses primary body-small emphasis, description uses secondary body-small text, and error uses negative body-small text."
+        "The label uses primary body-small emphasis, description uses secondary body-small text, and error uses negative body-small text.",
+        "Input and Textarea contribute constraint messages and character counts to the supporting row. Helper text yields to an error, with the count at the opposite edge; a count alone begins at the text origin."
       ],
       "responsiveBehavior": [
         "Field fills the width supplied by its parent and makes the slotted control fill that field width.",
@@ -217,8 +218,8 @@
       },
       "peerDependencies": {
         "required": [
-          "@ds-mo/tokens ^6.5.1",
-          "@ds-mo/icons ^8.1.0"
+          "@ds-mo/tokens ^6.5.2",
+          "@ds-mo/icons ^8.1.1"
         ],
         "frameworks": "Custom Elements; React 18/19 wrappers; Vue 3 wrappers; Angular 19-22 standalone adapters."
       }
@@ -234,12 +235,12 @@
   "files": [
     {
       "path": "src/wc/components/Field/Field.css",
-      "content": "@import '../../utils/control-density.css';\n@import '../../utils/field-stack.css';\n\n:host {\n  display: block;\n}\n\n.field__control {\n  display: flex;\n  min-width: 0;\n}\n\n.field__control > * {\n  width: 100%;\n}\n",
+      "content": "@import '../../utils/text-field-support.css';\n@import '../../utils/control-density.css';\n@import '../../utils/field-stack.css';\n\n:host {\n  display: block;\n}\n\n.field__control {\n  display: flex;\n  min-width: 0;\n}\n\n.field__control > * {\n  width: 100%;\n}\n",
       "type": "registry:ui"
     },
     {
       "path": "src/wc/components/Field/Field.tsx",
-      "content": "import { Component, Element, Prop, State, Watch, h, Host } from '@stencil/core';\n\ninterface FieldControl extends HTMLElement {\n  value?: string | string[];\n  inputId?: string;\n  error?: boolean;\n  disabled?: boolean;\n  isInactive?: boolean;\n  required?: boolean;\n  hasBorder?: boolean;\n  size?: string;\n  setFocus?: () => Promise<void> | void;\n}\n\ninterface AuthoredAria {\n  labelledby: string[];\n  describedby: string[];\n}\n\nlet fieldCounter = 0;\n\nconst tokens = (value: string | null | undefined): string[] =>\n  value?.split(/\\s+/).filter(Boolean) ?? [];\n\nconst uniqueTokens = (...groups: string[][]): string[] => [...new Set(groups.flat())];\n\nconst CONTROL_SIZES = ['lg', 'md', 'sm', 'xs'] as const;\ntype FieldControlSize = (typeof CONTROL_SIZES)[number];\n\nconst readControlSize = (control: FieldControl): FieldControlSize =>\n  CONTROL_SIZES.includes(control.size as FieldControlSize)\n    ? (control.size as FieldControlSize)\n    : 'md';\n\n@Component({\n  tag: 'ds-field',\n  styleUrl: 'Field.css',\n  scoped: true,\n})\nexport class Field {\n  @Element() el!: HTMLElement;\n\n  /** Visible label for the slotted control. Omit when a nearby heading already names the field. */\n  @Prop() label?: string;\n  /** Explicit ID for the slotted control; generated when omitted. */\n  @Prop() fieldId: string | undefined;\n  /** Optional guidance associated with the slotted control while no visible error is shown. */\n  @Prop() description: string | undefined;\n  /** Invalid visual and accessible state forwarded to supported ds controls. */\n  @Prop() error: boolean = false;\n  /** Visible error associated with the slotted control while error is true. */\n  @Prop() errorMessage: string | undefined;\n\n  @State() private focused = false;\n  @State() private filled = false;\n  @State() private dirty = false;\n  @State() private touched = false;\n  @State() private controlDisabled = false;\n  @State() private controlRequired = false;\n  @State() private controlBorderless = false;\n  @State() private controlSize: 'lg' | 'md' | 'sm' | 'xs' = 'md';\n  /** Bumped to let Stencil relocate a control added after the initial render. */\n  @State() private slotRevision = 0;\n\n  private readonly generatedId = `ds-field-${++fieldCounter}`;\n  private controlContainer?: HTMLDivElement;\n  private control?: FieldControl;\n  private initialValue = '';\n  private authoredAria = new WeakMap<FieldControl, AuthoredAria>();\n  private childObserver?: MutationObserver;\n  private controlAttrObserver?: MutationObserver;\n  private didLoad = false;\n\n  connectedCallback() {\n    if (this.didLoad) this.observeLateControls();\n  }\n\n  disconnectedCallback() {\n    this.childObserver?.disconnect();\n    this.childObserver = undefined;\n    this.controlAttrObserver?.disconnect();\n    this.controlAttrObserver = undefined;\n  }\n\n  componentDidLoad() {\n    this.syncControl();\n    this.didLoad = true;\n    this.observeLateControls();\n    requestAnimationFrame(() => this.syncControl());\n  }\n\n  componentDidRender() {\n    this.syncControl();\n  }\n\n  @Watch('fieldId')\n  @Watch('label')\n  @Watch('description')\n  @Watch('error')\n  @Watch('errorMessage')\n  onFieldContractChange() {\n    this.syncControl();\n  }\n\n  private get hasLabel(): boolean {\n    return Boolean(this.label?.trim());\n  }\n\n  private get controlId(): string {\n    return this.fieldId || this.generatedId;\n  }\n\n  private get labelId(): string {\n    return `${this.controlId}-label`;\n  }\n\n  private get descriptionId(): string {\n    return `${this.controlId}-description`;\n  }\n\n  private get errorId(): string {\n    return `${this.controlId}-error`;\n  }\n\n  private get renderedDescription(): boolean {\n    return Boolean(this.description) && !this.renderedError;\n  }\n\n  private get renderedError(): boolean {\n    return this.error && Boolean(this.errorMessage);\n  }\n\n  private readValue(control: FieldControl): string {\n    const value = control.value;\n    return Array.isArray(value) ? value.join('\\u001f') : String(value ?? '');\n  }\n\n  private updateControlAttribute(control: FieldControl, name: string, value: string | undefined) {\n    if (value === undefined) {\n      if (control.hasAttribute(name)) control.removeAttribute(name);\n      return;\n    }\n    if (control.getAttribute(name) !== value) control.setAttribute(name, value);\n  }\n\n  private findControl(): FieldControl | undefined {\n    return this.controlContainer?.querySelector<FieldControl>(':scope > :not(slot)') ?? undefined;\n  }\n\n  private observeLateControls() {\n    if (this.childObserver || typeof MutationObserver === 'undefined') return;\n    this.childObserver = new MutationObserver(records => {\n      const addedControl = records.some(record =>\n        Array.from(record.addedNodes).some(node => node.nodeType === 1)\n      );\n      if (addedControl) this.slotRevision++;\n    });\n    this.childObserver.observe(this.el, { childList: true });\n  }\n\n  private syncControl = () => {\n    const control = this.findControl();\n    if (!control) return;\n\n    if (control !== this.control) {\n      this.control = control;\n      this.initialValue = this.readValue(control);\n      this.authoredAria.set(control, {\n        labelledby: tokens(control.getAttribute('aria-labelledby')),\n        describedby: tokens(control.getAttribute('aria-describedby')),\n      });\n      this.observeControlAttributes(control);\n    }\n\n    const isDsControl = control.tagName.startsWith('DS-');\n    if (isDsControl && 'inputId' in control) control.inputId = this.controlId;\n    else this.updateControlAttribute(control, 'id', this.controlId);\n\n    const authored = this.authoredAria.get(control) ?? { labelledby: [], describedby: [] };\n    const labelledby = uniqueTokens(authored.labelledby, this.hasLabel ? [this.labelId] : []).join(\n      ' '\n    );\n    const describedby = uniqueTokens(\n      authored.describedby,\n      this.renderedDescription ? [this.descriptionId] : [],\n      this.renderedError ? [this.errorId] : []\n    ).join(' ');\n\n    this.updateControlAttribute(control, 'aria-labelledby', labelledby || undefined);\n    this.updateControlAttribute(control, 'aria-describedby', describedby || undefined);\n    this.updateControlAttribute(control, 'aria-invalid', this.error ? 'true' : undefined);\n\n    if (isDsControl && 'error' in control && control.error !== this.error)\n      control.error = this.error;\n\n    const value = this.readValue(control);\n    this.filled = value.length > 0;\n    this.dirty = value !== this.initialValue;\n    this.controlDisabled = Boolean(\n      control.disabled || control.isInactive || control.hasAttribute('disabled')\n    );\n    this.controlRequired = Boolean(control.required || control.hasAttribute('required'));\n    this.controlBorderless = control.hasBorder === false;\n    this.controlSize = readControlSize(control);\n  };\n\n  private observeControlAttributes(control: FieldControl) {\n    this.controlAttrObserver?.disconnect();\n    this.controlAttrObserver = new MutationObserver(() => this.syncControl());\n    this.controlAttrObserver.observe(control, {\n      attributes: true,\n      attributeFilter: ['has-border', 'size', 'class'],\n    });\n  }\n\n  private handleLabelClick = (event: MouseEvent) => {\n    if (!this.control?.tagName.startsWith('DS-')) return;\n    event.preventDefault();\n    this.control.setFocus?.();\n  };\n\n  private handleFocusIn = () => {\n    this.focused = true;\n  };\n\n  private handleFocusOut = (event: FocusEvent) => {\n    if (event.relatedTarget instanceof Node && this.el.contains(event.relatedTarget)) return;\n    this.focused = false;\n    this.touched = true;\n  };\n\n  private handleValueChange = () => {\n    this.syncControl();\n  };\n\n  render() {\n    return (\n      <Host\n        data-focused={this.focused ? '' : undefined}\n        data-filled={this.filled ? '' : undefined}\n        data-dirty={this.dirty ? '' : undefined}\n        data-touched={this.touched ? '' : undefined}\n        data-invalid={this.error ? '' : undefined}\n        data-disabled={this.controlDisabled ? '' : undefined}\n        data-required={this.controlRequired ? '' : undefined}\n        onFocusin={this.handleFocusIn}\n        onFocusout={this.handleFocusOut}\n        onInput={this.handleValueChange}\n        onChange={this.handleValueChange}\n        onDsChange={this.handleValueChange}\n      >\n        <div\n          class={{\n            field: true,\n            'ds-field-stack': true,\n            'ds-field-stack--supporting-inset': this.controlBorderless,\n            [`ds-control--${this.controlSize}`]: true,\n          }}\n        >\n          {this.hasLabel ? (\n            <ds-text\n              class=\"field__label\"\n              as=\"label\"\n              variant=\"text-body-small\"\n              color=\"primary\"\n              emphasis\n              for={this.controlId}\n              textId={this.labelId}\n              onClick={this.handleLabelClick}\n            >\n              {this.label}\n            </ds-text>\n          ) : null}\n          <div class=\"field__control\" ref={el => (this.controlContainer = el)}>\n            <slot onSlotchange={this.syncControl} />\n          </div>\n          {this.renderedDescription && (\n            <ds-text\n              class=\"field__description\"\n              as=\"div\"\n              variant=\"text-body-small\"\n              color=\"secondary\"\n              textId={this.descriptionId}\n            >\n              {this.description}\n            </ds-text>\n          )}\n          {this.renderedError && (\n            <ds-text\n              class=\"field__error\"\n              as=\"div\"\n              variant=\"text-body-small\"\n              color=\"negative\"\n              textId={this.errorId}\n              role=\"alert\"\n            >\n              {this.errorMessage}\n            </ds-text>\n          )}\n        </div>\n      </Host>\n    );\n  }\n}\n",
+      "content": "import { Component, Element, Prop, State, Watch, h, Host } from '@stencil/core';\n\ninterface FieldControl extends HTMLElement {\n  value?: string | string[];\n  tokens?: string[];\n  tokenized?: boolean;\n  inputId?: string;\n  error?: boolean;\n  disabled?: boolean;\n  isInactive?: boolean;\n  required?: boolean;\n  hasBorder?: boolean;\n  size?: string;\n  setFocus?: () => Promise<void> | void;\n}\n\ninterface AuthoredAria {\n  labelledby: string[];\n  describedby: string[];\n}\n\nlet fieldCounter = 0;\n\nconst tokens = (value: string | null | undefined): string[] =>\n  value?.split(/\\s+/).filter(Boolean) ?? [];\n\nconst uniqueTokens = (...groups: string[][]): string[] => [...new Set(groups.flat())];\n\nconst CONTROL_SIZES = ['lg', 'md', 'sm', 'xs'] as const;\ntype FieldControlSize = (typeof CONTROL_SIZES)[number];\n\nconst readControlSize = (control: FieldControl): FieldControlSize =>\n  CONTROL_SIZES.includes(control.size as FieldControlSize)\n    ? (control.size as FieldControlSize)\n    : 'md';\n\n@Component({\n  tag: 'ds-field',\n  styleUrl: 'Field.css',\n  scoped: true,\n})\nexport class Field {\n  @Element() el!: HTMLElement;\n\n  /** Visible label for the slotted control. Omit when a nearby heading already names the field. */\n  @Prop() label?: string;\n  /** Explicit ID for the slotted control; generated when omitted. */\n  @Prop() fieldId: string | undefined;\n  /** Optional guidance associated with the slotted control while no visible error is shown. */\n  @Prop() description: string | undefined;\n  /** Invalid visual and accessible state forwarded to supported ds controls. */\n  @Prop() error: boolean = false;\n  /** Visible error associated with the slotted control while error is true. */\n  @Prop() errorMessage: string | undefined;\n\n  @State() private constraintMessage = '';\n  @State() private characterCount: string | undefined;\n  @State() private characterLimit: string | undefined;\n  @State() private focused = false;\n  @State() private filled = false;\n  @State() private dirty = false;\n  @State() private touched = false;\n  @State() private controlDisabled = false;\n  @State() private controlRequired = false;\n  @State() private controlBorderless = false;\n  @State() private controlSize: 'lg' | 'md' | 'sm' | 'xs' = 'md';\n  /** Bumped to let Stencil relocate a control added after the initial render. */\n  @State() private slotRevision = 0;\n\n  private readonly generatedId = `ds-field-${++fieldCounter}`;\n  private controlContainer?: HTMLDivElement;\n  private control?: FieldControl;\n  private initialValue = '';\n  private authoredAria = new WeakMap<FieldControl, AuthoredAria>();\n  private childObserver?: MutationObserver;\n  private controlAttrObserver?: MutationObserver;\n  private didLoad = false;\n\n  connectedCallback() {\n    if (this.didLoad) this.observeLateControls();\n  }\n\n  disconnectedCallback() {\n    this.childObserver?.disconnect();\n    this.childObserver = undefined;\n    this.controlAttrObserver?.disconnect();\n    this.controlAttrObserver = undefined;\n  }\n\n  componentDidLoad() {\n    this.syncControl();\n    this.didLoad = true;\n    this.observeLateControls();\n    requestAnimationFrame(() => this.syncControl());\n  }\n\n  componentDidRender() {\n    this.syncControl();\n  }\n\n  @Watch('fieldId')\n  @Watch('label')\n  @Watch('description')\n  @Watch('error')\n  @Watch('errorMessage')\n  onFieldContractChange() {\n    this.syncControl();\n  }\n\n  private get hasLabel(): boolean {\n    return Boolean(this.label?.trim());\n  }\n\n  private get controlId(): string {\n    return this.fieldId || this.generatedId;\n  }\n\n  private get labelId(): string {\n    return `${this.controlId}-label`;\n  }\n\n  private get descriptionId(): string {\n    return `${this.controlId}-description`;\n  }\n\n  private get errorId(): string {\n    return `${this.controlId}-error`;\n  }\n\n  private get renderedDescription(): boolean {\n    return Boolean(this.description) && !this.renderedError;\n  }\n\n  private get renderedError(): boolean {\n    return Boolean(this.visibleError);\n  }\n\n  private get visibleError(): string {\n    return this.error && this.errorMessage ? this.errorMessage : this.constraintMessage;\n  }\n\n  private readValue(control: FieldControl): string {\n    if (control.tokenized)\n      return [...(control.tokens ?? []), String(control.value ?? '')]\n        .filter(Boolean)\n        .join('\\u001f');\n    const value = control.value;\n    return Array.isArray(value) ? value.join('\\u001f') : String(value ?? '');\n  }\n\n  private updateControlAttribute(control: FieldControl, name: string, value: string | undefined) {\n    if (value === undefined) {\n      if (control.hasAttribute(name)) control.removeAttribute(name);\n      return;\n    }\n    if (control.getAttribute(name) !== value) control.setAttribute(name, value);\n  }\n\n  private findControl(): FieldControl | undefined {\n    return this.controlContainer?.querySelector<FieldControl>(':scope > :not(slot)') ?? undefined;\n  }\n\n  private observeLateControls() {\n    if (this.childObserver || typeof MutationObserver === 'undefined') return;\n    this.childObserver = new MutationObserver(records => {\n      const addedControl = records.some(record =>\n        Array.from(record.addedNodes).some(node => node.nodeType === 1)\n      );\n      if (addedControl) this.slotRevision++;\n    });\n    this.childObserver.observe(this.el, { childList: true });\n  }\n\n  private syncControl = () => {\n    const control = this.findControl();\n    if (!control) return;\n\n    if (control !== this.control) {\n      this.control = control;\n      this.initialValue = this.readValue(control);\n      this.authoredAria.set(control, {\n        labelledby: tokens(control.getAttribute('aria-labelledby')),\n        describedby: tokens(control.getAttribute('aria-describedby')),\n      });\n      this.observeControlAttributes(control);\n    }\n\n    this.constraintMessage = control.getAttribute('data-constraint-message') ?? '';\n    this.characterCount = control.getAttribute('data-character-count') ?? undefined;\n    this.characterLimit = control.getAttribute('data-character-limit') ?? undefined;\n\n    const isDsControl = control.tagName.startsWith('DS-');\n    if (isDsControl && 'inputId' in control) control.inputId = this.controlId;\n    else this.updateControlAttribute(control, 'id', this.controlId);\n\n    const authored = this.authoredAria.get(control) ?? { labelledby: [], describedby: [] };\n    const labelledby = uniqueTokens(authored.labelledby, this.hasLabel ? [this.labelId] : []).join(\n      ' '\n    );\n    const describedby = uniqueTokens(\n      authored.describedby,\n      this.renderedDescription ? [this.descriptionId] : [],\n      this.renderedError ? [this.errorId] : [],\n      this.characterCount !== undefined ? [`${this.controlId}-count`] : []\n    ).join(' ');\n\n    this.updateControlAttribute(control, 'aria-labelledby', labelledby || undefined);\n    this.updateControlAttribute(control, 'aria-describedby', describedby || undefined);\n    this.updateControlAttribute(control, 'aria-invalid', this.error ? 'true' : undefined);\n\n    if (isDsControl && 'error' in control && control.error !== this.error)\n      control.error = this.error;\n\n    const value = this.readValue(control);\n    this.filled = value.length > 0;\n    this.dirty = value !== this.initialValue;\n    this.controlDisabled = Boolean(\n      control.disabled || control.isInactive || control.hasAttribute('disabled')\n    );\n    this.controlRequired = Boolean(control.required || control.hasAttribute('required'));\n    this.controlBorderless = control.hasBorder === false;\n    this.controlSize = readControlSize(control);\n  };\n\n  private observeControlAttributes(control: FieldControl) {\n    this.controlAttrObserver?.disconnect();\n    this.controlAttrObserver = new MutationObserver(() => this.syncControl());\n    this.controlAttrObserver.observe(control, {\n      attributes: true,\n      attributeFilter: [\n        'has-border',\n        'size',\n        'class',\n        'data-constraint-message',\n        'data-character-count',\n        'data-character-limit',\n      ],\n    });\n  }\n\n  private handleLabelClick = (event: MouseEvent) => {\n    if (!this.control?.tagName.startsWith('DS-')) return;\n    event.preventDefault();\n    this.control.setFocus?.();\n  };\n\n  private handleFocusIn = () => {\n    this.focused = true;\n  };\n\n  private handleFocusOut = (event: FocusEvent) => {\n    if (event.relatedTarget instanceof Node && this.el.contains(event.relatedTarget)) return;\n    this.focused = false;\n    this.touched = true;\n  };\n\n  private handleValueChange = () => {\n    this.syncControl();\n  };\n\n  render() {\n    return (\n      <Host\n        data-focused={this.focused ? '' : undefined}\n        data-filled={this.filled ? '' : undefined}\n        data-dirty={this.dirty ? '' : undefined}\n        data-touched={this.touched ? '' : undefined}\n        data-invalid={this.error || this.constraintMessage ? '' : undefined}\n        data-disabled={this.controlDisabled ? '' : undefined}\n        data-required={this.controlRequired ? '' : undefined}\n        onFocusin={this.handleFocusIn}\n        onFocusout={this.handleFocusOut}\n        onInput={this.handleValueChange}\n        onChange={this.handleValueChange}\n        onDsChange={this.handleValueChange}\n        onDsTokensChange={this.handleValueChange}\n      >\n        <div\n          class={{\n            field: true,\n            'ds-field-stack': true,\n            'ds-field-stack--supporting-inset': this.controlBorderless,\n            [`ds-control--${this.controlSize}`]: true,\n          }}\n        >\n          {this.hasLabel ? (\n            <ds-text\n              class=\"field__label\"\n              as=\"label\"\n              variant=\"text-body-small\"\n              color=\"primary\"\n              emphasis\n              for={this.controlId}\n              textId={this.labelId}\n              onClick={this.handleLabelClick}\n            >\n              {this.label}\n            </ds-text>\n          ) : null}\n          <div class=\"field__control\" ref={el => (this.controlContainer = el)}>\n            <slot onSlotchange={this.syncControl} />\n          </div>\n          {(this.renderedDescription ||\n            this.renderedError ||\n            this.characterCount !== undefined) && (\n            <div class=\"text-field-support\">\n              {this.renderedDescription && (\n                <ds-text\n                  class=\"field__description\"\n                  as=\"div\"\n                  variant=\"text-body-small\"\n                  color=\"secondary\"\n                  textId={this.descriptionId}\n                >\n                  {this.description}\n                </ds-text>\n              )}\n              {this.renderedError && (\n                <ds-text\n                  class=\"field__error\"\n                  as=\"div\"\n                  variant=\"text-body-small\"\n                  color=\"negative\"\n                  textId={this.errorId}\n                  role=\"alert\"\n                >\n                  {this.visibleError}\n                </ds-text>\n              )}\n              {this.characterCount !== undefined && (\n                <ds-text\n                  class=\"text-field-count\"\n                  as=\"span\"\n                  variant=\"text-body-small\"\n                  color={this.error || this.constraintMessage ? 'negative' : 'secondary'}\n                  textId={`${this.controlId}-count`}\n                >\n                  {this.characterCount}/{this.characterLimit}\n                </ds-text>\n              )}\n            </div>\n          )}\n        </div>\n      </Host>\n    );\n  }\n}\n",
       "type": "registry:ui"
     }
   ]

package/dist/mcp-data/registry/filter-menu.json

@@ -899,8 +899,8 @@
       "complexPropertyNote": "Assign these non-primitive values as JavaScript properties: anchor, boundary, filters, matchModes, values.",
       "peerDependencies": {
         "required": [
-          "@ds-mo/tokens ^6.5.1",
-          "@ds-mo/icons ^8.1.0"
+          "@ds-mo/tokens ^6.5.2",
+          "@ds-mo/icons ^8.1.1"
         ],
         "frameworks": "Custom Elements; React 18/19 wrappers; Vue 3 wrappers; Angular 19-22 standalone adapters."
       }

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

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

package/dist/mcp-data/registry/input-date.json

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

package/dist/mcp-data/registry/input-time.json

@@ -38,7 +38,7 @@
         {
           "when": "The hour, minute, and AM/PM lists are needed without a form field.",
           "component": "component:ds-time-picker",
-          "reason": "TimePicker owns the bounded 12-hour lists and selected-tile treatment."
+          "reason": "TimePicker owns the bounded clock lists and selected-tile treatment."
         },
         {
           "when": "The user chooses from a finite set of named times or cadences.",
@@ -56,9 +56,9 @@
       ],
       "accessibility": [
         "Provide a persistent visible label through the owning field or an external native label.",
-        "The text field remains the keyboard and assistive-technology value control. Users can type HH:MM, H:MM, or a 12-hour label such as 9:00 AM.",
+        "The text field remains the keyboard and assistive-technology value control. Users can type HH:MM, H:MM, or a 12- or 24-hour label such as 9:00 AM.",
         "The trailing clock button is a named disclosure that opens a non-modal time dialog. It shares the field's density, uses the single inset recipe, and reports expanded state while the picker is open.",
-        "Filled values keep HH:MM as the form value. Visible text uses a 12-hour label such as 9:00 AM so the field does not show 24-hour chrome. That label reuses Input's value typography and text-container inset.",
+        "Filled values keep HH:MM as the form value. Visible text uses a 12- or 24-hour label such as 9:00 AM so the field does not show 24-hour chrome. That label reuses Input's value typography and text-container inset.",
         "Error text is associated with the text field and announced as an alert when the invalid state is rendered.",
         "Read-only fields remain focusable and submittable while preventing edits; inactive or disabled fields leave the tab order and are omitted from form submission."
       ],
@@ -68,7 +68,8 @@
         "The normal field boundary uses the shared secondary inset border. Focus promotes it to the thicker bold-brand inset stroke, while error uses the thicker bold-negative inset stroke without changing geometry. When hasBorder is false, supporting error copy insets to the field's text origin rather than the resting border box.",
         "The host exposes focused, filled, dirty, touched, invalid, disabled, read-only, and required data attributes for Field integration and diagnostics.",
         "The trailing clock action is an unfilled icon button of the same density as the field, borderless and square, with the single inset recipe so the 4px height reduction insets it equally from the field's top, end, and bottom edges. It does not replace the field label or the submitted time value. Inactive or disabled fields apply that treatment on the host only, so the nested button is not faded a second time.",
-        "Activating the clock button opens the shared TimePicker in a choice-popup dialog anchored to the field's end edge, beside the trailing clock action. Choosing hour, minute, or AM/PM commits that part of the time and leaves the dialog open so the other columns can be adjusted. Typing in the field commits a parsed time without requiring the picker. Invalid typed text reverts to the last committed value on blur."
+        "Activating the clock button opens the shared TimePicker in a choice-popup dialog anchored to the field's end edge, beside the trailing clock action. Choosing hour, minute, or AM/PM commits that part of the time and leaves the dialog open so the other columns can be adjusted. Typing in the field commits a parsed time without requiring the picker. Invalid typed text reverts to the last committed value on blur.",
+        "The default twelve-hour presentation includes AM/PM. Twenty-four-hour presentation uses hours 00–23 and omits the period column; both keep HH:MM form values and the same time bounds."
       ],
       "responsiveBehavior": [
         "Form fields normally fill their parent; use hug width only in a compact toolbar or filter layout with an explicit width constraint.",
@@ -226,6 +227,15 @@
           "required": false,
           "mutable": false
         },
+        "hourFormat": {
+          "type": "'12' | '24'",
+          "resolvedType": "\"12\" | \"24\"",
+          "attribute": "hour-format",
+          "default": "'12'",
+          "required": false,
+          "mutable": false,
+          "description": "Display format; submitted values remain HH:MM in either format."
+        },
         "inputId": {
           "type": "string | undefined",
           "resolvedType": "string | undefined",
@@ -414,6 +424,15 @@
         "required": false,
         "mutable": false
       },
+      "hourFormat": {
+        "type": "'12' | '24'",
+        "resolvedType": "\"12\" | \"24\"",
+        "attribute": "hour-format",
+        "default": "'12'",
+        "required": false,
+        "mutable": false,
+        "description": "Display format; submitted values remain HH:MM in either format."
+      },
       "inputId": {
         "type": "string | undefined",
         "resolvedType": "string | undefined",
@@ -551,8 +570,8 @@
       },
       "peerDependencies": {
         "required": [
-          "@ds-mo/tokens ^6.5.1",
-          "@ds-mo/icons ^8.1.0"
+          "@ds-mo/tokens ^6.5.2",
+          "@ds-mo/icons ^8.1.1"
         ],
         "frameworks": "Custom Elements; React 18/19 wrappers; Vue 3 wrappers; Angular 19-22 standalone adapters."
       }
@@ -575,7 +594,7 @@
     },
     {
       "path": "src/wc/components/InputTime/InputTime.tsx",
-      "content": "import {\n  AttachInternals,\n  Component,\n  Element,\n  Prop,\n  State,\n  Event,\n  EventEmitter,\n  Listen,\n  Method,\n  Watch,\n  h,\n  Host,\n} from '@stencil/core';\nimport {\n  controlWidthClass,\n  CONTROL_TEXT_VARIANT,\n  DEFAULT_REQUIRED_MESSAGE,\n  formatClockTimeLabel,\n  isClockTime,\n  isClockTimeStepAligned,\n  parseLooseClockTime,\n  resolveChoicePopupAlignOffset,\n  resolveCssLengthPx,\n  resolveMotionTimeMs,\n  restoreStringFormState,\n  setFormControlValue,\n  TOKEN_DEFAULTS,\n  type ControlSize,\n  type ControlWidth,\n} from '../../utils';\nimport { AnchoredPositionController } from '../../utils/anchored-position-controller';\nimport { AnchoredOverlayInteractionController } from '../../utils/anchored-overlay-interaction-controller';\nimport { resolveAnchoredOverlayBoundaryRect } from '../../utils/anchored-overlay-boundary';\n\nexport type InputTimeSize = ControlSize;\nexport type InputTimeWidth = ControlWidth;\n\nlet idCounter = 0;\n\nconst INVALID_TIME_MESSAGE = 'Enter a valid time.';\nconst TIME_BEFORE_MIN_MESSAGE = 'Time is before the minimum allowed time.';\nconst TIME_AFTER_MAX_MESSAGE = 'Time is after the maximum allowed time.';\nconst TIME_STEP_MESSAGE = 'Time does not match the allowed interval.';\n\n@Component({\n  tag: 'ds-input-time',\n  styleUrl: 'InputTime.css',\n  scoped: true,\n  formAssociated: true,\n})\nexport class InputTime {\n  @Element() el!: HTMLElement;\n  @AttachInternals() internals!: ElementInternals;\n\n  private generatedId = `ds-input-time-${++idCounter}`;\n  private errorId = `${this.generatedId}-error`;\n  private popupId = `${this.generatedId}-popup`;\n\n  @Prop({ mutable: true }) value: string = '';\n  @Prop({ reflect: true }) name: string | undefined;\n  @Prop({ reflect: true }) form: string | undefined;\n  @Prop({ reflect: true }) disabled: boolean = false;\n  @Prop({ reflect: true }) readOnly: boolean = false;\n  @Prop({ reflect: true }) required: boolean = false;\n  @Prop() requiredMessage: string = DEFAULT_REQUIRED_MESSAGE;\n  /** Native time step in seconds. Defaults to minutes (`60`). */\n  @Prop() step: string | number = 60;\n  @Prop() min: string | undefined;\n  @Prop() max: string | undefined;\n  @Prop() size: InputTimeSize = 'md';\n  @Prop() width: InputTimeWidth = 'fill';\n  @Prop() hasBorder: boolean = true;\n  @Prop() hasInteractionFill: boolean = true;\n  @Prop() isInactive: boolean = false;\n  @Prop() autoFocus: boolean = false;\n  @Prop() error: boolean = false;\n  @Prop() errorMessage: string | undefined;\n  @Prop() inputId: string | undefined;\n  @Prop({ attribute: 'aria-label' }) ariaLabel: string | null = null;\n  @Prop({ attribute: 'aria-labelledby' }) ariaLabelledby: string | undefined;\n  @Prop({ attribute: 'aria-describedby' }) ariaDescribedby: string | undefined;\n\n  @Event() dsChange!: EventEmitter<string>;\n\n  private initialValue = '';\n  private inputEl?: HTMLInputElement;\n  private controlEl?: HTMLElement;\n  private clockButton?: HTMLDsButtonUnfilledElement;\n  private closeTimer: ReturnType<typeof setTimeout> | null = null;\n  @State() private formDisabled = false;\n  @State() private focused = false;\n  @State() private touched = false;\n  @State() private draftText = '';\n  @State() private open = false;\n  @State() private shouldRender = false;\n  @State() private closing = false;\n  @State() private positionReady = false;\n  @State() private pos = { x: 0, y: 0 };\n\n  private readonly position = new AnchoredPositionController({\n    getAnchor: () => this.controlEl ?? null,\n    getPopup: () => this.el.querySelector<HTMLElement>('.input-time-popup'),\n    getOwnerDocument: () => this.el.ownerDocument,\n    measure: (anchor, popup) => {\n      if (!this.open) return null;\n      const sectionInsetPx = resolveCssLengthPx(TOKEN_DEFAULTS.space050, TOKEN_DEFAULTS.space050);\n      return {\n        anchorRect: anchor.getBoundingClientRect(),\n        popupWidth: popup.offsetWidth || this.popupFallbackWidth,\n        popupHeight: popup.offsetHeight || this.popupFallbackHeight,\n        side: 'bottom',\n        align: 'end',\n        sideOffsetPx: resolveCssLengthPx(TOKEN_DEFAULTS.space050, TOKEN_DEFAULTS.space050),\n        alignOffsetPx: resolveChoicePopupAlignOffset({\n          align: 'end',\n          alignOffsetPx: 0,\n          sectionInsetPx,\n          anchorAlignment: 'popup-frame',\n        }),\n        viewportPadPx: resolveCssLengthPx(TOKEN_DEFAULTS.space050, TOKEN_DEFAULTS.space050),\n        viewportWidth: window.innerWidth,\n        viewportHeight: window.innerHeight,\n        collisionRect: resolveAnchoredOverlayBoundaryRect(anchor),\n      };\n    },\n    apply: ({ x, y }) => {\n      this.pos = { x, y };\n    },\n    onReady: () => {\n      this.positionReady = true;\n    },\n    liveUpdate: 'double-frame',\n    observeResize: true,\n    topLayer: true,\n  });\n  private readonly interaction = new AnchoredOverlayInteractionController({\n    getAnchor: () => this.controlEl ?? null,\n    getPopup: () => this.el.querySelector<HTMLElement>('.input-time-popup'),\n    getOwnerDocument: () => this.el.ownerDocument,\n    onOutsideActivation: () => this.closePicker(false),\n  });\n\n  private get popupFallbackWidth(): number {\n    return resolveCssLengthPx(TOKEN_DEFAULTS.menuWidthXs, TOKEN_DEFAULTS.menuWidthXs);\n  }\n\n  private get popupFallbackHeight(): number {\n    return resolveCssLengthPx(TOKEN_DEFAULTS.menuFallbackHeight, TOKEN_DEFAULTS.menuFallbackHeight);\n  }\n\n  private get formInactive(): boolean {\n    return this.isInactive || this.disabled || this.formDisabled;\n  }\n\n  private get pickerInactive(): boolean {\n    return this.formInactive || this.readOnly;\n  }\n\n  private get hasConstraintError(): boolean {\n    if (!this.value) return false;\n    if (!isClockTime(this.value)) return true;\n    if (this.min && isClockTime(this.min) && this.value < this.min) return true;\n    if (this.max && isClockTime(this.max) && this.value > this.max) return true;\n    return !isClockTimeStepAligned(this.value, this.step, this.min);\n  }\n\n  private get isInvalid(): boolean {\n    return (\n      this.error ||\n      (!this.formInactive &&\n        ((this.required && this.value.length === 0) || this.hasConstraintError))\n    );\n  }\n\n  componentWillLoad() {\n    this.initialValue = this.value;\n    this.syncFormValue();\n  }\n\n  disconnectedCallback() {\n    this.position.unobserve();\n    this.teardownListeners();\n  }\n\n  @Watch('value')\n  @Watch('required')\n  @Watch('requiredMessage')\n  @Watch('min')\n  @Watch('max')\n  @Watch('step')\n  syncFormValue() {\n    const inactive = this.formInactive;\n    setFormControlValue(this.internals, this.value, { inactive });\n    const flags: ValidityStateFlags = {};\n    let message = '';\n    if (!inactive) {\n      if (this.required && this.value.length === 0) {\n        flags.valueMissing = true;\n        message = this.requiredMessage;\n      } else if (this.value && !isClockTime(this.value)) {\n        flags.badInput = true;\n        message = INVALID_TIME_MESSAGE;\n      } else if (this.value && this.min && isClockTime(this.min) && this.value < this.min) {\n        flags.rangeUnderflow = true;\n        message = TIME_BEFORE_MIN_MESSAGE;\n      } else if (this.value && this.max && isClockTime(this.max) && this.value > this.max) {\n        flags.rangeOverflow = true;\n        message = TIME_AFTER_MAX_MESSAGE;\n      } else if (this.value && !isClockTimeStepAligned(this.value, this.step, this.min)) {\n        flags.stepMismatch = true;\n        message = TIME_STEP_MESSAGE;\n      }\n    }\n    this.internals.setValidity(flags, message);\n  }\n\n  @Watch('disabled')\n  @Watch('isInactive')\n  @Watch('readOnly')\n  onInteractionStateChange() {\n    this.syncFormValue();\n    if (this.pickerInactive && this.shouldRender) this.closePicker(false);\n  }\n\n  formDisabledCallback(disabled: boolean) {\n    this.formDisabled = disabled;\n    this.onInteractionStateChange();\n  }\n\n  formResetCallback() {\n    this.value = this.initialValue;\n    this.draftText = this.displayValue;\n  }\n\n  formStateRestoreCallback(state: string | File | FormData | null) {\n    this.value = restoreStringFormState(state);\n    this.draftText = this.displayValue;\n  }\n\n  @Method()\n  async setFocus() {\n    this.inputEl?.focus();\n  }\n\n  @Listen('keydown')\n  handleHostKeyDown(event: KeyboardEvent) {\n    if (!this.shouldRender || this.closing) return;\n    if (event.key === 'Escape') {\n      event.preventDefault();\n      this.closePicker('button');\n      return;\n    }\n    if (event.key !== 'Tab') return;\n    const popup = this.el.querySelector<HTMLElement>('.input-time-popup');\n    if (!popup || !event.composedPath().includes(popup)) return;\n    if (!this.interaction.tabLeavesPopup(event)) return;\n    event.preventDefault();\n    this.closePicker(false);\n    this.interaction.moveFocusAfterTab(event.shiftKey);\n  }\n\n  private get displayValue(): string {\n    return formatClockTimeLabel(this.value);\n  }\n\n  private parseDraft(text: string): string | null {\n    const trimmed = text.trim();\n    if (!trimmed) return '';\n    const iso = parseLooseClockTime(trimmed);\n    if (!iso) return null;\n    if (this.min && isClockTime(this.min) && iso < this.min) return null;\n    if (this.max && isClockTime(this.max) && iso > this.max) return null;\n    if (!isClockTimeStepAligned(iso, this.step, this.min)) return null;\n    return iso;\n  }\n\n  private commitIso(iso: string, emit = true) {\n    if (this.value !== iso) {\n      this.value = iso;\n      if (emit) this.dsChange.emit(iso);\n    }\n    this.draftText = formatClockTimeLabel(iso);\n  }\n\n  private teardownListeners() {\n    this.position.unobserve();\n    this.interaction.disconnect();\n    if (this.closeTimer) {\n      clearTimeout(this.closeTimer);\n      this.closeTimer = null;\n    }\n  }\n\n  private openPicker() {\n    const inactive = this.isInactive || this.disabled || this.formDisabled || this.readOnly;\n    if (inactive || this.open) return;\n    this.shouldRender = true;\n    this.closing = false;\n    this.positionReady = false;\n    this.open = true;\n    this.teardownListeners();\n    this.interaction.connect();\n    this.position.observe();\n    this.position.schedule();\n  }\n\n  private closePicker(restore: 'input' | 'button' | false) {\n    if (!this.shouldRender || this.closing) return;\n    this.open = false;\n    this.position.cancel();\n    this.closing = true;\n    this.interaction.disconnect();\n    this.position.unobserve();\n    if (restore === 'input') this.inputEl?.focus();\n    if (restore === 'button') void this.clockButton?.setFocus();\n    const duration = resolveMotionTimeMs(\n      TOKEN_DEFAULTS.motionShort2,\n      TOKEN_DEFAULTS.animationDurationShort3\n    );\n    if (duration <= 0) {\n      this.finishClose();\n      return;\n    }\n    this.closeTimer = setTimeout(() => this.finishClose(), duration);\n  }\n\n  private finishClose() {\n    const popup = this.el.querySelector<HTMLElement>('.input-time-popup');\n    if (popup?.matches(':popover-open')) popup.hidePopover();\n    this.shouldRender = false;\n    this.closing = false;\n    this.closeTimer = null;\n  }\n\n  private togglePicker = () => {\n    if (this.isInactive || this.disabled || this.formDisabled || this.readOnly) return;\n    if (this.open) this.closePicker('button');\n    else this.openPicker();\n  };\n\n  private handleInput = (event: Event) => {\n    if (this.pickerInactive) return;\n    this.draftText = (event.target as HTMLInputElement).value;\n    const parsed = this.parseDraft(this.draftText);\n    if (parsed === null) return;\n    this.commitIso(parsed);\n  };\n\n  private handleFocus = () => {\n    this.draftText = this.displayValue || this.value;\n    this.focused = true;\n  };\n\n  private handleBlur = () => {\n    this.focused = false;\n    this.touched = true;\n    if (this.pickerInactive) {\n      this.draftText = this.displayValue;\n      return;\n    }\n    const parsed = this.parseDraft(this.draftText);\n    if (parsed === null) {\n      this.draftText = this.displayValue;\n      return;\n    }\n    this.commitIso(parsed);\n  };\n\n  private handleTimeChange = (event: CustomEvent<string>) => {\n    event.stopPropagation();\n    if (this.pickerInactive) return;\n    const parsed = this.parseDraft(event.detail);\n    if (parsed === null) return;\n    this.commitIso(parsed);\n  };\n\n  render() {\n    const inputId = this.inputId ?? this.generatedId;\n    const inactive = this.formInactive;\n    const pickerInactive = this.pickerInactive;\n    const filled = this.value.length > 0;\n    const dirty = this.value !== this.initialValue;\n    const showError = this.error && Boolean(this.errorMessage);\n    const textVariant = CONTROL_TEXT_VARIANT[this.size];\n    const textClass = `ds-text--${textVariant.replace('text-', '')}`;\n    const describedBy =\n      [this.ariaDescribedby, showError ? this.errorId : undefined].filter(Boolean).join(' ') ||\n      undefined;\n    const popupStyle = {\n      position: 'fixed',\n      left: '0',\n      top: '0',\n      transform: `translate(${Math.round(this.pos.x)}px, ${Math.round(this.pos.y)}px)`,\n      zIndex: 'var(--dimension-z-index-floating)',\n      visibility: this.positionReady ? 'visible' : 'hidden',\n    };\n\n    return (\n      <Host\n        class={{\n          'input-host': true,\n          'ds-field-stack': true,\n          'ds-field-stack--supporting-inset': !this.hasBorder,\n          'ds-control-inactive': inactive,\n          [`ds-control--${this.size}`]: true,\n          ...controlWidthClass(this.width),\n        }}\n        data-disabled={inactive ? '' : undefined}\n        data-readonly={this.readOnly ? '' : undefined}\n        data-required={this.required ? '' : undefined}\n        data-invalid={this.isInvalid ? '' : undefined}\n        data-filled={filled ? '' : undefined}\n        data-focused={this.focused ? '' : undefined}\n        data-dirty={dirty ? '' : undefined}\n        data-touched={this.touched ? '' : undefined}\n      >\n        <div\n          ref={element => {\n            this.controlEl = element;\n          }}\n          class={{\n            'input-control': true,\n            'ds-control-frame': true,\n            'input-control--bordered': this.hasBorder,\n            'input-control--error': this.hasBorder && this.error,\n            'ds-interaction-fill': this.hasInteractionFill,\n            [`ds-control--${this.size}`]: true,\n          }}\n        >\n          <input\n            ref={element => {\n              this.inputEl = element;\n            }}\n            type=\"text\"\n            id={inputId}\n            value={this.focused ? this.draftText : this.displayValue}\n            disabled={inactive}\n            readOnly={this.readOnly}\n            required={this.required}\n            autoFocus={this.autoFocus}\n            autoComplete=\"off\"\n            spellcheck={false}\n            class={{\n              'native-input': true,\n              'native-input--align-start': true,\n              'ds-control-label-box': true,\n              [textClass]: true,\n              'ds-text--regular': true,\n            }}\n            aria-label={this.ariaLabel}\n            aria-labelledby={this.ariaLabelledby}\n            aria-describedby={describedBy}\n            aria-invalid={this.isInvalid ? 'true' : undefined}\n            onInput={this.handleInput}\n            onFocus={this.handleFocus}\n            onBlur={this.handleBlur}\n          />\n          <ds-button-unfilled\n            ref={element => {\n              this.clockButton = element as HTMLDsButtonUnfilledElement | undefined;\n            }}\n            class=\"input-control__datetime-action\"\n            variant=\"icon\"\n            size={this.size}\n            icon=\"Clock\"\n            hasBorder={false}\n            isInset\n            isInactive={pickerInactive}\n            ariaLabel=\"Choose time\"\n            haspopup=\"dialog\"\n            expanded={this.open}\n            surfaceOpen={this.open || this.closing}\n            controls={this.open ? this.popupId : undefined}\n            onDsClick={this.togglePicker}\n          />\n        </div>\n        {this.shouldRender ? (\n          <div\n            id={this.popupId}\n            popover=\"manual\"\n            class={{\n              'input-time-popup': true,\n              'ds-choice-popup': true,\n              'ds-choice-popup--closing': this.closing,\n              'ds-chrome-column': true,\n              'ds-chrome-space--sm': true,\n            }}\n            style={popupStyle}\n            role=\"dialog\"\n            aria-label=\"Choose time\"\n          >\n            <ds-time-picker\n              value={this.value}\n              min={this.min}\n              max={this.max}\n              step={this.step}\n              isInactive={pickerInactive}\n              autoFocus\n              onDsChange={this.handleTimeChange}\n            />\n          </div>\n        ) : null}\n        {showError && (\n          <ds-text\n            class=\"error-text\"\n            as=\"div\"\n            variant=\"text-body-small\"\n            color=\"negative\"\n            textId={this.errorId}\n            role=\"alert\"\n          >\n            {this.errorMessage}\n          </ds-text>\n        )}\n      </Host>\n    );\n  }\n}\n",
+      "content": "import {\n  AttachInternals,\n  Component,\n  Element,\n  Prop,\n  State,\n  Event,\n  EventEmitter,\n  Listen,\n  Method,\n  Watch,\n  h,\n  Host,\n} from '@stencil/core';\nimport {\n  controlWidthClass,\n  CONTROL_TEXT_VARIANT,\n  DEFAULT_REQUIRED_MESSAGE,\n  formatClockTimeLabel,\n  isClockTime,\n  isClockTimeStepAligned,\n  parseLooseClockTime,\n  resolveChoicePopupAlignOffset,\n  resolveCssLengthPx,\n  resolveMotionTimeMs,\n  restoreStringFormState,\n  setFormControlValue,\n  TOKEN_DEFAULTS,\n  type ControlSize,\n  type ControlWidth,\n} from '../../utils';\nimport { AnchoredPositionController } from '../../utils/anchored-position-controller';\nimport { AnchoredOverlayInteractionController } from '../../utils/anchored-overlay-interaction-controller';\nimport { resolveAnchoredOverlayBoundaryRect } from '../../utils/anchored-overlay-boundary';\n\nexport type InputTimeSize = ControlSize;\nexport type InputTimeWidth = ControlWidth;\n\nlet idCounter = 0;\n\nconst INVALID_TIME_MESSAGE = 'Enter a valid time.';\nconst TIME_BEFORE_MIN_MESSAGE = 'Time is before the minimum allowed time.';\nconst TIME_AFTER_MAX_MESSAGE = 'Time is after the maximum allowed time.';\nconst TIME_STEP_MESSAGE = 'Time does not match the allowed interval.';\n\n@Component({\n  tag: 'ds-input-time',\n  styleUrl: 'InputTime.css',\n  scoped: true,\n  formAssociated: true,\n})\nexport class InputTime {\n  @Element() el!: HTMLElement;\n  @AttachInternals() internals!: ElementInternals;\n\n  private generatedId = `ds-input-time-${++idCounter}`;\n  private errorId = `${this.generatedId}-error`;\n  private popupId = `${this.generatedId}-popup`;\n\n  @Prop({ mutable: true }) value: string = '';\n  @Prop({ reflect: true }) name: string | undefined;\n  @Prop({ reflect: true }) form: string | undefined;\n  @Prop({ reflect: true }) disabled: boolean = false;\n  @Prop({ reflect: true }) readOnly: boolean = false;\n  @Prop({ reflect: true }) required: boolean = false;\n  @Prop() requiredMessage: string = DEFAULT_REQUIRED_MESSAGE;\n  /** Native time step in seconds. Defaults to minutes (`60`). */\n  @Prop() step: string | number = 60;\n  /** Display format; submitted values remain HH:MM in either format. */\n  @Prop() hourFormat: '12' | '24' = '12';\n  @Prop() min: string | undefined;\n  @Prop() max: string | undefined;\n  @Prop() size: InputTimeSize = 'md';\n  @Prop() width: InputTimeWidth = 'fill';\n  @Prop() hasBorder: boolean = true;\n  @Prop() hasInteractionFill: boolean = true;\n  @Prop() isInactive: boolean = false;\n  @Prop() autoFocus: boolean = false;\n  @Prop() error: boolean = false;\n  @Prop() errorMessage: string | undefined;\n  @Prop() inputId: string | undefined;\n  @Prop({ attribute: 'aria-label' }) ariaLabel: string | null = null;\n  @Prop({ attribute: 'aria-labelledby' }) ariaLabelledby: string | undefined;\n  @Prop({ attribute: 'aria-describedby' }) ariaDescribedby: string | undefined;\n\n  @Event() dsChange!: EventEmitter<string>;\n\n  private initialValue = '';\n  private inputEl?: HTMLInputElement;\n  private controlEl?: HTMLElement;\n  private clockButton?: HTMLDsButtonUnfilledElement;\n  private closeTimer: ReturnType<typeof setTimeout> | null = null;\n  @State() private formDisabled = false;\n  @State() private focused = false;\n  @State() private touched = false;\n  @State() private draftText = '';\n  @State() private open = false;\n  @State() private shouldRender = false;\n  @State() private closing = false;\n  @State() private positionReady = false;\n  @State() private pos = { x: 0, y: 0 };\n\n  private readonly position = new AnchoredPositionController({\n    getAnchor: () => this.controlEl ?? null,\n    getPopup: () => this.el.querySelector<HTMLElement>('.input-time-popup'),\n    getOwnerDocument: () => this.el.ownerDocument,\n    measure: (anchor, popup) => {\n      if (!this.open) return null;\n      const sectionInsetPx = resolveCssLengthPx(TOKEN_DEFAULTS.space050, TOKEN_DEFAULTS.space050);\n      return {\n        anchorRect: anchor.getBoundingClientRect(),\n        popupWidth: popup.offsetWidth || this.popupFallbackWidth,\n        popupHeight: popup.offsetHeight || this.popupFallbackHeight,\n        side: 'bottom',\n        align: 'end',\n        sideOffsetPx: resolveCssLengthPx(TOKEN_DEFAULTS.space050, TOKEN_DEFAULTS.space050),\n        alignOffsetPx: resolveChoicePopupAlignOffset({\n          align: 'end',\n          alignOffsetPx: 0,\n          sectionInsetPx,\n          anchorAlignment: 'popup-frame',\n        }),\n        viewportPadPx: resolveCssLengthPx(TOKEN_DEFAULTS.space050, TOKEN_DEFAULTS.space050),\n        viewportWidth: window.innerWidth,\n        viewportHeight: window.innerHeight,\n        collisionRect: resolveAnchoredOverlayBoundaryRect(anchor),\n      };\n    },\n    apply: ({ x, y }) => {\n      this.pos = { x, y };\n    },\n    onReady: () => {\n      this.positionReady = true;\n    },\n    liveUpdate: 'double-frame',\n    observeResize: true,\n    topLayer: true,\n  });\n  private readonly interaction = new AnchoredOverlayInteractionController({\n    getAnchor: () => this.controlEl ?? null,\n    getPopup: () => this.el.querySelector<HTMLElement>('.input-time-popup'),\n    getOwnerDocument: () => this.el.ownerDocument,\n    onOutsideActivation: () => this.closePicker(false),\n  });\n\n  private get popupFallbackWidth(): number {\n    return resolveCssLengthPx(TOKEN_DEFAULTS.menuWidthXs, TOKEN_DEFAULTS.menuWidthXs);\n  }\n\n  private get popupFallbackHeight(): number {\n    return resolveCssLengthPx(TOKEN_DEFAULTS.menuFallbackHeight, TOKEN_DEFAULTS.menuFallbackHeight);\n  }\n\n  private get formInactive(): boolean {\n    return this.isInactive || this.disabled || this.formDisabled;\n  }\n\n  private get pickerInactive(): boolean {\n    return this.formInactive || this.readOnly;\n  }\n\n  private get hasConstraintError(): boolean {\n    if (!this.value) return false;\n    if (!isClockTime(this.value)) return true;\n    if (this.min && isClockTime(this.min) && this.value < this.min) return true;\n    if (this.max && isClockTime(this.max) && this.value > this.max) return true;\n    return !isClockTimeStepAligned(this.value, this.step, this.min);\n  }\n\n  private get isInvalid(): boolean {\n    return (\n      this.error ||\n      (!this.formInactive &&\n        ((this.required && this.value.length === 0) || this.hasConstraintError))\n    );\n  }\n\n  componentWillLoad() {\n    this.initialValue = this.value;\n    this.syncFormValue();\n  }\n\n  disconnectedCallback() {\n    this.position.unobserve();\n    this.teardownListeners();\n  }\n\n  @Watch('hourFormat')\n  onHourFormatChange() {\n    this.draftText = this.displayValue;\n  }\n\n  @Watch('value')\n  @Watch('required')\n  @Watch('requiredMessage')\n  @Watch('min')\n  @Watch('max')\n  @Watch('step')\n  syncFormValue() {\n    const inactive = this.formInactive;\n    setFormControlValue(this.internals, this.value, { inactive });\n    const flags: ValidityStateFlags = {};\n    let message = '';\n    if (!inactive) {\n      if (this.required && this.value.length === 0) {\n        flags.valueMissing = true;\n        message = this.requiredMessage;\n      } else if (this.value && !isClockTime(this.value)) {\n        flags.badInput = true;\n        message = INVALID_TIME_MESSAGE;\n      } else if (this.value && this.min && isClockTime(this.min) && this.value < this.min) {\n        flags.rangeUnderflow = true;\n        message = TIME_BEFORE_MIN_MESSAGE;\n      } else if (this.value && this.max && isClockTime(this.max) && this.value > this.max) {\n        flags.rangeOverflow = true;\n        message = TIME_AFTER_MAX_MESSAGE;\n      } else if (this.value && !isClockTimeStepAligned(this.value, this.step, this.min)) {\n        flags.stepMismatch = true;\n        message = TIME_STEP_MESSAGE;\n      }\n    }\n    this.internals.setValidity(flags, message);\n  }\n\n  @Watch('disabled')\n  @Watch('isInactive')\n  @Watch('readOnly')\n  onInteractionStateChange() {\n    this.syncFormValue();\n    if (this.pickerInactive && this.shouldRender) this.closePicker(false);\n  }\n\n  formDisabledCallback(disabled: boolean) {\n    this.formDisabled = disabled;\n    this.onInteractionStateChange();\n  }\n\n  formResetCallback() {\n    this.value = this.initialValue;\n    this.draftText = this.displayValue;\n  }\n\n  formStateRestoreCallback(state: string | File | FormData | null) {\n    this.value = restoreStringFormState(state);\n    this.draftText = this.displayValue;\n  }\n\n  @Method()\n  async setFocus() {\n    this.inputEl?.focus();\n  }\n\n  @Listen('keydown')\n  handleHostKeyDown(event: KeyboardEvent) {\n    if (!this.shouldRender || this.closing) return;\n    if (event.key === 'Escape') {\n      event.preventDefault();\n      this.closePicker('button');\n      return;\n    }\n    if (event.key !== 'Tab') return;\n    const popup = this.el.querySelector<HTMLElement>('.input-time-popup');\n    if (!popup || !event.composedPath().includes(popup)) return;\n    if (!this.interaction.tabLeavesPopup(event)) return;\n    event.preventDefault();\n    this.closePicker(false);\n    this.interaction.moveFocusAfterTab(event.shiftKey);\n  }\n\n  private get displayValue(): string {\n    return this.hourFormat === '24' ? this.value : formatClockTimeLabel(this.value);\n  }\n\n  private parseDraft(text: string): string | null {\n    const trimmed = text.trim();\n    if (!trimmed) return '';\n    const iso = parseLooseClockTime(trimmed);\n    if (!iso) return null;\n    if (this.min && isClockTime(this.min) && iso < this.min) return null;\n    if (this.max && isClockTime(this.max) && iso > this.max) return null;\n    if (!isClockTimeStepAligned(iso, this.step, this.min)) return null;\n    return iso;\n  }\n\n  private commitIso(iso: string, emit = true) {\n    if (this.value !== iso) {\n      this.value = iso;\n      if (emit) this.dsChange.emit(iso);\n    }\n    this.draftText = this.hourFormat === '24' ? iso : formatClockTimeLabel(iso);\n  }\n\n  private teardownListeners() {\n    this.position.unobserve();\n    this.interaction.disconnect();\n    if (this.closeTimer) {\n      clearTimeout(this.closeTimer);\n      this.closeTimer = null;\n    }\n  }\n\n  private openPicker() {\n    const inactive = this.isInactive || this.disabled || this.formDisabled || this.readOnly;\n    if (inactive || this.open) return;\n    this.shouldRender = true;\n    this.closing = false;\n    this.positionReady = false;\n    this.open = true;\n    this.teardownListeners();\n    this.interaction.connect();\n    this.position.observe();\n    this.position.schedule();\n  }\n\n  private closePicker(restore: 'input' | 'button' | false) {\n    if (!this.shouldRender || this.closing) return;\n    this.open = false;\n    this.position.cancel();\n    this.closing = true;\n    this.interaction.disconnect();\n    this.position.unobserve();\n    if (restore === 'input') this.inputEl?.focus();\n    if (restore === 'button') void this.clockButton?.setFocus();\n    const duration = resolveMotionTimeMs(\n      TOKEN_DEFAULTS.motionShort2,\n      TOKEN_DEFAULTS.animationDurationShort3\n    );\n    if (duration <= 0) {\n      this.finishClose();\n      return;\n    }\n    this.closeTimer = setTimeout(() => this.finishClose(), duration);\n  }\n\n  private finishClose() {\n    const popup = this.el.querySelector<HTMLElement>('.input-time-popup');\n    if (popup?.matches(':popover-open')) popup.hidePopover();\n    this.shouldRender = false;\n    this.closing = false;\n    this.closeTimer = null;\n  }\n\n  private togglePicker = () => {\n    if (this.isInactive || this.disabled || this.formDisabled || this.readOnly) return;\n    if (this.open) this.closePicker('button');\n    else this.openPicker();\n  };\n\n  private handleInput = (event: Event) => {\n    if (this.pickerInactive) return;\n    this.draftText = (event.target as HTMLInputElement).value;\n    const parsed = this.parseDraft(this.draftText);\n    if (parsed === null) return;\n    this.commitIso(parsed);\n  };\n\n  private handleFocus = () => {\n    this.draftText = this.displayValue || this.value;\n    this.focused = true;\n  };\n\n  private handleBlur = () => {\n    this.focused = false;\n    this.touched = true;\n    if (this.pickerInactive) {\n      this.draftText = this.displayValue;\n      return;\n    }\n    const parsed = this.parseDraft(this.draftText);\n    if (parsed === null) {\n      this.draftText = this.displayValue;\n      return;\n    }\n    this.commitIso(parsed);\n  };\n\n  private handleTimeChange = (event: CustomEvent<string>) => {\n    event.stopPropagation();\n    if (this.pickerInactive) return;\n    const parsed = this.parseDraft(event.detail);\n    if (parsed === null) return;\n    this.commitIso(parsed);\n  };\n\n  render() {\n    const inputId = this.inputId ?? this.generatedId;\n    const inactive = this.formInactive;\n    const pickerInactive = this.pickerInactive;\n    const filled = this.value.length > 0;\n    const dirty = this.value !== this.initialValue;\n    const showError = this.error && Boolean(this.errorMessage);\n    const textVariant = CONTROL_TEXT_VARIANT[this.size];\n    const textClass = `ds-text--${textVariant.replace('text-', '')}`;\n    const describedBy =\n      [this.ariaDescribedby, showError ? this.errorId : undefined].filter(Boolean).join(' ') ||\n      undefined;\n    const popupStyle = {\n      position: 'fixed',\n      left: '0',\n      top: '0',\n      transform: `translate(${Math.round(this.pos.x)}px, ${Math.round(this.pos.y)}px)`,\n      zIndex: 'var(--dimension-z-index-floating)',\n      visibility: this.positionReady ? 'visible' : 'hidden',\n    };\n\n    return (\n      <Host\n        class={{\n          'input-host': true,\n          'ds-field-stack': true,\n          'ds-field-stack--supporting-inset': !this.hasBorder,\n          'ds-control-inactive': inactive,\n          [`ds-control--${this.size}`]: true,\n          ...controlWidthClass(this.width),\n        }}\n        data-disabled={inactive ? '' : undefined}\n        data-readonly={this.readOnly ? '' : undefined}\n        data-required={this.required ? '' : undefined}\n        data-invalid={this.isInvalid ? '' : undefined}\n        data-filled={filled ? '' : undefined}\n        data-focused={this.focused ? '' : undefined}\n        data-dirty={dirty ? '' : undefined}\n        data-touched={this.touched ? '' : undefined}\n      >\n        <div\n          ref={element => {\n            this.controlEl = element;\n          }}\n          class={{\n            'input-control': true,\n            'ds-control-frame': true,\n            'input-control--bordered': this.hasBorder,\n            'input-control--error': this.hasBorder && this.error,\n            'ds-interaction-fill': this.hasInteractionFill,\n            [`ds-control--${this.size}`]: true,\n          }}\n        >\n          <input\n            ref={element => {\n              this.inputEl = element;\n            }}\n            type=\"text\"\n            id={inputId}\n            value={this.focused ? this.draftText : this.displayValue}\n            disabled={inactive}\n            readOnly={this.readOnly}\n            required={this.required}\n            autoFocus={this.autoFocus}\n            autoComplete=\"off\"\n            spellcheck={false}\n            class={{\n              'native-input': true,\n              'native-input--align-start': true,\n              'ds-control-label-box': true,\n              [textClass]: true,\n              'ds-text--regular': true,\n            }}\n            aria-label={this.ariaLabel}\n            aria-labelledby={this.ariaLabelledby}\n            aria-describedby={describedBy}\n            aria-invalid={this.isInvalid ? 'true' : undefined}\n            onInput={this.handleInput}\n            onFocus={this.handleFocus}\n            onBlur={this.handleBlur}\n          />\n          <ds-button-unfilled\n            ref={element => {\n              this.clockButton = element as HTMLDsButtonUnfilledElement | undefined;\n            }}\n            class=\"input-control__datetime-action\"\n            variant=\"icon\"\n            size={this.size}\n            icon=\"Clock\"\n            hasBorder={false}\n            isInset\n            isInactive={pickerInactive}\n            ariaLabel=\"Choose time\"\n            haspopup=\"dialog\"\n            expanded={this.open}\n            surfaceOpen={this.open || this.closing}\n            controls={this.open ? this.popupId : undefined}\n            onDsClick={this.togglePicker}\n          />\n        </div>\n        {this.shouldRender ? (\n          <div\n            id={this.popupId}\n            popover=\"manual\"\n            class={{\n              'input-time-popup': true,\n              'ds-choice-popup': true,\n              'ds-choice-popup--closing': this.closing,\n              'ds-chrome-column': true,\n              'ds-chrome-space--sm': true,\n            }}\n            style={popupStyle}\n            role=\"dialog\"\n            aria-label=\"Choose time\"\n          >\n            <ds-time-picker\n              hourFormat={this.hourFormat}\n              value={this.value}\n              min={this.min}\n              max={this.max}\n              step={this.step}\n              isInactive={pickerInactive}\n              autoFocus\n              onDsChange={this.handleTimeChange}\n            />\n          </div>\n        ) : null}\n        {showError && (\n          <ds-text\n            class=\"error-text\"\n            as=\"div\"\n            variant=\"text-body-small\"\n            color=\"negative\"\n            textId={this.errorId}\n            role=\"alert\"\n          >\n            {this.errorMessage}\n          </ds-text>\n        )}\n      </Host>\n    );\n  }\n}\n",
       "type": "registry:ui"
     }
   ]