@ds-mo/ui 14.5.0 → 14.7.0

package/dist/docs/components.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-08-19T23:31:19",
+  "timestamp": "2026-08-20T23:50:18",
   "compiler": {
     "name": "@stencil/core",
     "version": "4.43.5",
@@ -2896,6 +2896,7 @@
         "ds-menu": [
           "ds-text",
           "ds-swatch-picker",
+          "ds-icon",
           "ds-tag",
           "ds-badge",
           "ds-switch"
@@ -3538,6 +3539,7 @@
         "ds-menu": [
           "ds-text",
           "ds-swatch-picker",
+          "ds-icon",
           "ds-tag",
           "ds-badge",
           "ds-switch"
@@ -3977,6 +3979,7 @@
         "ds-menu": [
           "ds-text",
           "ds-swatch-picker",
+          "ds-icon",
           "ds-tag",
           "ds-badge",
           "ds-switch"
@@ -5272,7 +5275,7 @@
           "mutable": false,
           "attr": "has-menu",
           "reflectToAttr": false,
-          "docs": "Mark the button as a Menu trigger. Implies `aria-haspopup=\"menu\"` and covers\nboth menu-button shapes:\n\n- `label` / `icon-label` — the action *has* a menu; a trailing chevron carries\n  the affordance.\n- `icon` — the button *is* a menu, i.e. the overflow / more-options control.\n  No chevron is added, so the glyph must convey it on its own; use `Ellipses`.\n\nUse `haspopup` directly for non-menu popups.",
+          "docs": "Mark the button as a Menu trigger. Implies `aria-haspopup=\"menu\"` and covers\nboth menu-button shapes:\n\n- `label` / `icon-label` — the action *has* a menu; a trailing chevron carries\n  the affordance.\n- `icon` — the button *is* a menu. No chevron is added, so the glyph must\n  convey the menu on its own. Use `Ellipses` for generic more-options;\n  use a specific icon when the menu has a named purpose, such as\n  `Preferences` for Customize table.\n\nUse `haspopup` directly for non-menu popups.",
           "docsTags": [
             {
               "name": "default",
@@ -10540,6 +10543,7 @@
         "ds-empty-state",
         "ds-filter-menu",
         "ds-input",
+        "ds-menu",
         "ds-message-composer",
         "ds-mobile-bar-nav",
         "ds-mobile-sheet-nav",
@@ -10591,6 +10595,9 @@
         "ds-input": [
           "ds-icon"
         ],
+        "ds-menu": [
+          "ds-icon"
+        ],
         "ds-message-composer": [
           "ds-icon"
         ],
@@ -12513,6 +12520,27 @@
           "docs": "",
           "docsTags": []
         },
+        {
+          "event": "dsReorder",
+          "detail": "MenuReorderDetail",
+          "bubbles": true,
+          "complexType": {
+            "original": "MenuReorderDetail",
+            "resolved": "MenuReorderDetail",
+            "references": {
+              "MenuReorderDetail": {
+                "location": "import",
+                "path": "./menu-types",
+                "id": "src/wc/components/Menu/menu-types.ts::MenuReorderDetail",
+                "referenceLocation": "MenuReorderDetail"
+              }
+            }
+          },
+          "cancelable": true,
+          "composed": true,
+          "docs": "Emitted after a pointer drop or keyboard move; Menu never mutates item order.",
+          "docsTags": []
+        },
         {
           "event": "dsSelect",
           "detail": "MenuItemData",
@@ -12563,11 +12591,13 @@
       "dependents": [
         "ds-bar-nav",
         "ds-bar-title",
-        "ds-mobile-section-switcher"
+        "ds-mobile-section-switcher",
+        "ds-table"
       ],
       "dependencies": [
         "ds-text",
         "ds-swatch-picker",
+        "ds-icon",
         "ds-tag",
         "ds-badge",
         "ds-switch"
@@ -12576,6 +12606,7 @@
         "ds-menu": [
           "ds-text",
           "ds-swatch-picker",
+          "ds-icon",
           "ds-tag",
           "ds-badge",
           "ds-switch"
@@ -12595,6 +12626,9 @@
         ],
         "ds-mobile-section-switcher": [
           "ds-menu"
+        ],
+        "ds-table": [
+          "ds-menu"
         ]
       }
     },
@@ -14859,6 +14893,7 @@
         "ds-menu": [
           "ds-text",
           "ds-swatch-picker",
+          "ds-icon",
           "ds-tag",
           "ds-badge",
           "ds-switch"
@@ -15017,6 +15052,7 @@
         "ds-menu": [
           "ds-text",
           "ds-swatch-picker",
+          "ds-icon",
           "ds-tag",
           "ds-badge",
           "ds-switch"
@@ -21442,6 +21478,7 @@
         "ds-menu": [
           "ds-text",
           "ds-swatch-picker",
+          "ds-icon",
           "ds-tag",
           "ds-badge",
           "ds-switch"
@@ -22524,6 +22561,7 @@
         "ds-menu": [
           "ds-text",
           "ds-swatch-picker",
+          "ds-icon",
           "ds-tag",
           "ds-badge",
           "ds-switch"
@@ -24883,6 +24921,63 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "columnCustomizer",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "column-customizer",
+          "reflectToAttr": false,
+          "docs": "Opt in to the table-owned column customizer. The `columns` prop remains the\ncatalog; hidden and ordered columns are controlled separately. The trigger\nopens the shared Menu of live show/hide switch rows.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "false"
+            }
+          ],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "columnOrder",
+          "type": "string[]",
+          "complexType": {
+            "original": "string[]",
+            "resolved": "string[]",
+            "references": {}
+          },
+          "mutable": false,
+          "reflectToAttr": false,
+          "docs": "Controlled data-column identities in display order. Omitted ids append in catalog order.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "[]"
+            }
+          ],
+          "default": "[]",
+          "values": [
+            {
+              "type": "string[]"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "columns",
           "type": "TableColumn[]",
@@ -25522,6 +25617,34 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "hiddenColumnIds",
+          "type": "string[]",
+          "complexType": {
+            "original": "string[]",
+            "resolved": "string[]",
+            "references": {}
+          },
+          "mutable": false,
+          "reflectToAttr": false,
+          "docs": "Controlled hidden data-column identities. Action ids are ignored.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "[]"
+            }
+          ],
+          "default": "[]",
+          "values": [
+            {
+              "type": "string[]"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "loadIdentity",
           "type": "number | string",
@@ -26260,6 +26383,27 @@
           "docs": "",
           "docsTags": []
         },
+        {
+          "event": "dsColumnsConfigChange",
+          "detail": "TableColumnsConfigChangeDetail",
+          "bubbles": true,
+          "complexType": {
+            "original": "TableColumnsConfigChangeDetail",
+            "resolved": "TableColumnsConfigChangeDetail",
+            "references": {
+              "TableColumnsConfigChangeDetail": {
+                "location": "import",
+                "path": "./table-types",
+                "id": "src/wc/components/Table/table-types.ts::TableColumnsConfigChangeDetail",
+                "referenceLocation": "TableColumnsConfigChangeDetail"
+              }
+            }
+          },
+          "cancelable": true,
+          "composed": true,
+          "docs": "",
+          "docsTags": []
+        },
         {
           "event": "dsGroupCollapseChange",
           "detail": "TableGroupCollapseChangeDetail",
@@ -26415,6 +26559,8 @@
       "states": [],
       "dependents": [],
       "dependencies": [
+        "ds-menu",
+        "ds-tooltip",
         "ds-checkbox",
         "ds-button-unfilled",
         "ds-text",
@@ -26427,6 +26573,8 @@
       ],
       "dependencyGraph": {
         "ds-table": [
+          "ds-menu",
+          "ds-tooltip",
           "ds-checkbox",
           "ds-button-unfilled",
           "ds-text",
@@ -26437,20 +26585,31 @@
           "ds-empty-state",
           "ds-pagination"
         ],
-        "ds-checkbox": [
-          "ds-text"
-        ],
-        "ds-button-unfilled": [
-          "ds-loader",
+        "ds-menu": [
+          "ds-text",
+          "ds-swatch-picker",
           "ds-icon",
+          "ds-tag",
           "ds-badge",
+          "ds-switch"
+        ],
+        "ds-tag": [
+          "ds-icon",
           "ds-text"
         ],
         "ds-badge": [
           "ds-text"
         ],
-        "ds-tag": [
+        "ds-tooltip": [
+          "ds-text"
+        ],
+        "ds-checkbox": [
+          "ds-text"
+        ],
+        "ds-button-unfilled": [
+          "ds-loader",
           "ds-icon",
+          "ds-badge",
           "ds-text"
         ],
         "ds-empty-state": [
@@ -26472,9 +26631,6 @@
           "ds-text",
           "ds-badge",
           "ds-empty-state"
-        ],
-        "ds-tooltip": [
-          "ds-text"
         ]
       }
     },
@@ -28259,6 +28415,35 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "describedBy",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "described-by",
+          "reflectToAttr": false,
+          "docs": "Link the trigger with aria-describedby while the popup is open. Disable when\nthe label is already in the DOM, such as a truncated table cell.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "true"
+            }
+          ],
+          "default": "true",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "label",
           "type": "string",
@@ -28465,9 +28650,109 @@
           "required": false,
           "getter": false,
           "setter": false
+        },
+        {
+          "name": "wrapLabel",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "wrap-label",
+          "reflectToAttr": false,
+          "docs": "Allow the label to wrap at a panel-xs max width instead of a single line.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "false"
+            }
+          ],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        }
+      ],
+      "methods": [
+        {
+          "name": "dismiss",
+          "returns": {
+            "type": "Promise<void>",
+            "docs": ""
+          },
+          "complexType": {
+            "signature": "() => Promise<void>",
+            "parameters": [],
+            "references": {
+              "Promise": {
+                "location": "global",
+                "id": "global::Promise"
+              }
+            },
+            "return": "Promise<void>"
+          },
+          "signature": "dismiss() => Promise<void>",
+          "parameters": [],
+          "docs": "Dismiss a popup opened through presentFrom or the slotted trigger.",
+          "docsTags": []
+        },
+        {
+          "name": "presentFrom",
+          "returns": {
+            "type": "Promise<void>",
+            "docs": ""
+          },
+          "complexType": {
+            "signature": "(anchor: HTMLElement, label?: string) => Promise<void>",
+            "parameters": [
+              {
+                "name": "anchor",
+                "type": "HTMLElement",
+                "docs": ""
+              },
+              {
+                "name": "label",
+                "type": "string | undefined",
+                "docs": ""
+              }
+            ],
+            "references": {
+              "Promise": {
+                "location": "global",
+                "id": "global::Promise"
+              },
+              "HTMLElement": {
+                "location": "global",
+                "id": "global::HTMLElement"
+              }
+            },
+            "return": "Promise<void>"
+          },
+          "signature": "presentFrom(anchor: HTMLElement, label?: string) => Promise<void>",
+          "parameters": [
+            {
+              "name": "anchor",
+              "type": "HTMLElement",
+              "docs": ""
+            },
+            {
+              "name": "label",
+              "type": "string | undefined",
+              "docs": ""
+            }
+          ],
+          "docs": "Present against an external anchor the host already measured.\nDoes not bind hover or focus on that anchor — the owner drives show/hide.",
+          "docsTags": []
         }
       ],
-      "methods": [],
       "events": [],
       "listeners": [],
       "styles": [],
@@ -28493,7 +28778,8 @@
         "ds-panel-tools",
         "ds-select",
         "ds-shell-app",
-        "ds-shell-tools"
+        "ds-shell-tools",
+        "ds-table"
       ],
       "dependencies": [
         "ds-text"
@@ -28558,6 +28844,9 @@
         ],
         "ds-shell-tools": [
           "ds-tooltip"
+        ],
+        "ds-table": [
+          "ds-tooltip"
         ]
       }
     },
@@ -29133,7 +29422,7 @@
       "path": "src/wc/utils/index.ts"
     },
     "src/wc/components/Menu/menu-types.ts::MenuItemData": {
-      "declaration": "export interface MenuItemData {\n  label: string;\n  value?: string;\n  subtext?: string;\n  /** Show a supplemental brand notification dot. */\n  dot?: boolean;\n  /** Show a non-interactive tag at the trailing edge of the row. */\n  tag?: MenuItemTagData;\n  isSelected?: boolean;\n  isInactive?: boolean;\n  isDestructive?: boolean;\n  /** Render a compact switch indicator; the menu row owns interaction. */\n  showSwitch?: boolean;\n  switchValue?: boolean;\n}",
+      "declaration": "export interface MenuItemData {\n  label: string;\n  value?: string;\n  subtext?: string;\n  /** Leading decorative icon. Ignored when `reorderable` is true. */\n  icon?: string;\n  /** Show a supplemental brand notification dot. */\n  dot?: boolean;\n  /** Show a non-interactive tag at the trailing edge of the row. */\n  tag?: MenuItemTagData;\n  isSelected?: boolean;\n  isInactive?: boolean;\n  isDestructive?: boolean;\n  /** Render a compact switch indicator; the menu row owns interaction. */\n  showSwitch?: boolean;\n  switchValue?: boolean;\n  /** Prefix a drag handle and allow pointer and keyboard reorder within the contiguous reorderable run. */\n  reorderable?: boolean;\n}",
       "docstring": "",
       "path": "src/wc/components/Menu/menu-types.ts"
     },
@@ -29167,6 +29456,11 @@
       "docstring": "",
       "path": "src/wc/utils/index.ts"
     },
+    "src/wc/components/Menu/menu-types.ts::MenuReorderDetail": {
+      "declaration": "export interface MenuReorderDetail {\n  item: MenuItemData;\n  fromIndex: number;\n  toIndex: number;\n  sectionIndex: number;\n  items: MenuItemData[];\n}",
+      "docstring": "Next section item order after a pointer or keyboard reorder.",
+      "path": "src/wc/components/Menu/menu-types.ts"
+    },
     "src/wc/components/MessageBubble/MessageBubble.tsx::MessageBubbleVariant": {
       "declaration": "export type MessageBubbleVariant = 'user' | 'received';",
       "docstring": "",
@@ -29693,7 +29987,7 @@
       "path": "src/wc/components/SwatchPicker/swatch-picker-types.ts"
     },
     "src/wc/components/Table/table-types.ts::TableColumn": {
-      "declaration": "export interface TableColumn {\n  /** Stable column identity. */\n  id: string;\n  /** Visible column label. May be empty when headerLabel supplies a non-visual name. */\n  header: string;\n  /** Screen-reader-only column name for an intentionally blank visual header. */\n  headerLabel?: string;\n  /** Optional labels for columns that present and sort multiple related data points. */\n  headerSegments?: TableHeaderSegment[];\n  align?: TableCellAlign;\n  sortable?: boolean;\n  /** Preferred TokoMo table-column width. Numbers remain available for exceptional custom pixel widths. */\n  size?: TableColumnWidth | number;\n  /** Minimum accepted preferred width in CSS pixels. */\n  minSize?: number;\n  /** Maximum accepted preferred width in CSS pixels. */\n  maxSize?: number;\n  /** Wrap cell text instead of truncating it to one line. */\n  wrap?: boolean;\n  /** Pin one application column to either inline edge during horizontal scrolling. */\n  sticky?: TableColumnSticky;\n  /**\n   * Declare a trailing application-action lane. Action columns keep fixed\n   * geometry and may host grouped table-level controls in their header.\n   */\n  kind?: 'data' | 'action';\n  /** Representative loading geometry for this column. Defaults to one text line. */\n  skeleton?: TableCellSkeleton;\n}",
+      "declaration": "export interface TableColumn {\n  /** Stable column identity. */\n  id: string;\n  /** Visible column label. May be empty when headerLabel supplies a non-visual name. */\n  header: string;\n  /** Screen-reader-only column name for an intentionally blank visual header. */\n  headerLabel?: string;\n  /** Optional labels for columns that present and sort multiple related data points. */\n  headerSegments?: TableHeaderSegment[];\n  align?: TableCellAlign;\n  sortable?: boolean;\n  /** Preferred TokoMo table-column width. Numbers remain available for exceptional custom pixel widths. */\n  size?: TableColumnWidth | number;\n  /** Minimum accepted preferred width in CSS pixels. */\n  minSize?: number;\n  /** Maximum accepted preferred width in CSS pixels. */\n  maxSize?: number;\n  /** Wrap cell text instead of truncating it to one line. */\n  wrap?: boolean;\n  /** Clamp wrapping text after 1, 2, or 3 lines. Omit with wrap for unlimited wrap. */\n  maxLines?: TableCellMaxLines;\n  /** Pin one application column to either inline edge during horizontal scrolling. */\n  sticky?: TableColumnSticky;\n  /**\n   * Declare a trailing application-action lane. Action columns keep fixed\n   * geometry and may host grouped table-level controls in their header.\n   */\n  kind?: 'data' | 'action';\n  /** Representative loading geometry for this column. Defaults to one text line. */\n  skeleton?: TableCellSkeleton;\n}",
       "docstring": "",
       "path": "src/wc/components/Table/table-types.ts"
     },
@@ -29777,6 +30071,11 @@
       "docstring": "",
       "path": "src/wc/components/Table/table-types.ts"
     },
+    "src/wc/components/Table/table-types.ts::TableColumnsConfigChangeDetail": {
+      "declaration": "export interface TableColumnsConfigChangeDetail {\n  hiddenColumnIds: string[];\n  columnOrder: string[];\n}",
+      "docstring": "Controlled show/hide and data-column order for the table-owned customizer.",
+      "path": "src/wc/components/Table/table-types.ts"
+    },
     "src/wc/toast/index.ts::ToastManager": {
       "declaration": "any",
       "docstring": "",

package/dist/lib/utils/index.d.ts

@@ -6,6 +6,7 @@ export type { PercentageDecimals } from './format-percentage';
 export { computeMetricChange, resolveMetricTrend } from './metric-change';
 export type { MetricChange, MetricTrend, MetricTrendDirection, MetricTrendTone, ResolveMetricTrendOptions, } from './metric-change';
 export { truncateSvgTextToWidth } from './truncate-svg-text';
+export { isElementTruncated } from './is-element-truncated';
 export { parseCssTimeMs, prefersReducedMotion, resolveCssTimeMs, resolveMotionTimeMs, } from './resolve-css-time-ms';
 export { SCROLL_EDGE_FADE_DEFAULT_SIZE, SCROLL_EDGE_FADE_SIZE_VAR, isScrollAtEdge, resolveScrollEdgeFadeSize, scrollEdgeFadeClassMap, scrollEdgeFadeMaskImage, scrollEdgeFadeMaskStyle, scrollEdgeFadeSizeStyle, } from './scroll-edge-fade';
 export type { ScrollEdgeFadeEdge, ScrollEdgeFadeOptions, ScrollEdgeFadeSize, ScrollEdgeFadeSizeToken, } from './scroll-edge-fade';

package/dist/lib/utils/index.js

@@ -183,6 +183,13 @@ function truncateSvgTextToWidth(el, text, maxWidth) {
   return lo > 0 ? `${text.slice(0, lo)}\u2026` : "\u2026";
 }
 
+// src/wc/utils/is-element-truncated.ts
+var TRUNCATION_EPSILON_PX = 1;
+function isElementTruncated(element) {
+  const target = element.querySelector(".ds-text__element") ?? element;
+  return target.scrollWidth - target.clientWidth > TRUNCATION_EPSILON_PX || target.scrollHeight - target.clientHeight > TRUNCATION_EPSILON_PX;
+}
+
 // src/wc/utils/resolve-css-time-ms.ts
 function parseCssTimeMs(value, fallback) {
   const firstToken = value.trim().split(/\s+/)[0] ?? "";
@@ -996,6 +1003,7 @@ export {
   dot,
   formatCompactNumber,
   formatPercentage,
+  isElementTruncated,
   isScrollAtEdge,
   lineY,
   normalizeStack,