@ds-mo/ui 14.33.2 → 14.35.0

package/dist/agent.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": "1.0.0",
   "package": "@ds-mo/ui",
-  "packageVersion": "14.33.2",
+  "packageVersion": "14.35.0",
   "kind": "components",
   "entries": [
     {
@@ -4498,7 +4498,10 @@
           "Selection applies immediately and does not close the popup.",
           "Changing category replaces the option-pane subtree so checkbox and other option visuals mount in their new state instead of transitioning from the previous category's row state.",
           "The trigger reports how many filter categories have selections. footerLayout=summary adds a full-width selected-count footer only while values are selected; footerLayout=categories-clear always reserves the category-pane footer height while keeping its inactive divider hidden, then reveals the divider and only its left-aligned Clear action while values are selected.",
-          "The built-in trigger derives the shared surface-open wash from the rendered popup lifecycle, including closing. For an external trigger, the application owns that relationship and retains the wash until dsAfterClose; selected filter values remain independent."
+          "The built-in trigger derives the shared surface-open wash from the rendered popup lifecycle, including closing. For an external trigger, the application owns that relationship and retains the wash until dsAfterClose; selected filter values remain independent.",
+          "Embedded mode renders the same controlled content inside a parent-owned surface; the parent owns positioning, initial focus, Escape, Tab exit, and dismissal.",
+          "Apply-required filtering stages edits locally, including match mode. Clear immediately emits dsClear and discards pending edits. The footer appears when filters are selected or applied; Apply stays in place and inactive without pending changes; applying emits controlled changes. Closing discards unapplied edits.",
+          "Vertical presentation renders initially expanded, independently collapsible filter categories and emits edits immediately to its controlled owner. The owning panel supplies the draft and action footer."
         ],
         "responsiveBehavior": [
           "The popup defaults to the large menu-width token and clamps to the nearest data-ds-overlay-boundary rectangle or the viewport fallback.",
@@ -4554,6 +4557,10 @@
             "type": "string | undefined",
             "required": false
           },
+          "applyRequired": {
+            "type": "boolean",
+            "required": false
+          },
           "ariaLabel": {
             "type": "string | null",
             "required": false
@@ -4574,6 +4581,10 @@
             "type": "boolean",
             "required": false
           },
+          "embedded": {
+            "type": "boolean",
+            "required": false
+          },
           "filters": {
             "type": "FilterMenuFilter[]",
             "required": false
@@ -4610,6 +4621,10 @@
             "type": "string",
             "required": false
           },
+          "neutralTrigger": {
+            "type": "boolean",
+            "required": false
+          },
           "noResultsText": {
             "type": "string",
             "required": false
@@ -4622,6 +4637,10 @@
             "type": "string",
             "required": false
           },
+          "showIndicator": {
+            "type": "boolean",
+            "required": false
+          },
           "showSelectedCount": {
             "type": "boolean",
             "required": false
@@ -4646,6 +4665,10 @@
             "type": "FilterMenuValues",
             "required": false
           },
+          "vertical": {
+            "type": "boolean",
+            "required": false
+          },
           "width": {
             "type": "FilterMenuWidth",
             "required": false
@@ -5340,7 +5363,8 @@
           "Use a swatch-picker section for a small curated visual preference and apply dsSwatchSelect immediately without closing the popup.",
           "Ordinary rows, section headings, and supporting text consume the Menu size. At xs, both the primary label and supporting text use caption metrics.",
           "A trailing tag resolves one density smaller than its menu row and uses the inset recipe so it nests without changing row height. Do not combine tag, dot, and switch suffixes on one item.",
-          "Reorderable rows use the Drag prefix and ignore icon. Prefix and drag-handle icons inherit the choice-popup secondary foreground, matching Select. When any row in a section has an icon or is reorderable, the remaining rows get a spacer so labels align."
+          "Reorderable rows use the Drag prefix and ignore icon. Prefix and drag-handle icons inherit the choice-popup secondary foreground, matching Select. When any row in a section has an icon or is reorderable, the remaining rows get a spacer so labels align.",
+          "Embedded mode renders the same controlled content inside a parent-owned surface; the parent owns positioning, initial focus, Escape, Tab exit, and dismissal."
         ],
         "responsiveBehavior": [
           "Keep the default choice-cell anchor alignment so the first or last interactive row edge aligns with its trigger, matching Select; use popup-frame only for deliberate custom frame geometry.",
@@ -5399,6 +5423,10 @@
             "type": "HTMLElement | undefined",
             "required": false
           },
+          "embedded": {
+            "type": "boolean",
+            "required": false
+          },
           "emptyMessage": {
             "type": "string",
             "required": false
@@ -8237,7 +8265,8 @@
           "When collapseLabel is set inside a named ds-table container narrower than 900px, the trigger omits its label and chevron, becomes icon-only, and exposes its label through a hover and keyboard-focus tooltip. A selected value promotes the prefix icon to primary.",
           "The popup matches the trigger minimum width, may grow for content, and clamps to the nearest data-ds-overlay-boundary rectangle or the viewport fallback. Assign boundary as an HTMLElement only for an explicit override.",
           "Keep popupAlign at start for ordinary fields and filters. Use end when a control sits against a right layout edge and the popup should grow inward.",
-          "Long option collections scroll inside the popup; virtualization and remote search are not part of this component."
+          "Long option collections scroll inside the popup; virtualization and remote search are not part of this component.",
+          "An explicitly compact composition can keep only the prefix icon while preserving the accessible name and tooltip."
         ],
         "frameworkCaveats": {
           "customElements": [
@@ -8334,6 +8363,10 @@
             "type": "string | undefined",
             "required": false
           },
+          "iconOnly": {
+            "type": "boolean",
+            "required": false
+          },
           "indicator": {
             "type": "SelectIndicator",
             "required": false
@@ -8362,6 +8395,10 @@
             "type": "string | undefined",
             "required": false
           },
+          "neutralTrigger": {
+            "type": "boolean",
+            "required": false
+          },
           "noResultsText": {
             "type": "string",
             "required": false
@@ -8554,7 +8591,8 @@
           "Managed ShellApp keeps the selected desktop section-navigation presentation and ShellPage present and owns page header stickiness and the content scroller.",
           "Route-owned pageChrome independently selects ShellPage contentInset, page-header seams, scroll compaction, expanded and compact header-divider visibility, and contentSurface. ShellApp forwards them while resolving whether desktop title geometry is page-local or shell-bar-owned.",
           "The application filters unauthorized destinations, sections, and tools before passing them into shell components.",
-          "Application-owned header actions and the account trigger retain surface ownership across shell presentations. Supply surfaceOpen on header actions and accountMenuSurfaceOpen on navigation for rendered surface lifetimes; keep disclosure and selected-route state separate."
+          "Application-owned header actions and the account trigger retain surface ownership across shell presentations. Supply surfaceOpen on header actions and accountMenuSurfaceOpen on navigation for rendered surface lifetimes; keep disclosure and selected-route state separate.",
+          "Managed page chrome can explicitly choose page-local title presentation for pages that must remain compact rather than following capacity and scrolling."
         ],
         "responsiveBehavior": [
           "ShellApp owns the fixed system breakpoints and resolves desktop at 1200px and wider, tablet from 768px through 1199px, and mobile below 768px.",
@@ -9811,7 +9849,8 @@
           "Use one consistent content variant across every selectable tab in a group.",
           "Omitted background is for primary and secondary surfaces; pass the faint context explicitly on faint surfaces.",
           "Only the omitted default context emphasizes visible selected label text and keeps the filled track; every explicit surface context uses a transparent track, stable text weight, surface border, and its context-matched neutral active fill rather than a brand active fill.",
-          "Dividers visually separate related subsets inside one tab list but do not create nested navigation or independent selection groups."
+          "Dividers visually separate related subsets inside one tab list but do not create nested navigation or independent selection groups.",
+          "Simple navigation-style tabs use regular control geometry and selected text emphasis, without a selected pill fill or border."
         ],
         "responsiveBehavior": [
           "The component remains a single horizontal row and does not become vertical or wrap.",
@@ -9855,6 +9894,10 @@
             "type": "boolean",
             "required": false
           },
+          "presentation": {
+            "type": "'segmented' | 'tabs'",
+            "required": false
+          },
           "size": {
             "type": "TabGroupSize",
             "required": false
@@ -9962,11 +10005,13 @@
           "When pagination enables Fit to page on a bounded table, the table proposes the number of complete top-level rows that fit below its column header. Grouped tables count group headers only; member rows never affect capacity. Selecting Fit captures that numeric snapshot. A changed fitIdentity requests one fresh snapshot for a new query shape, while viewport resizing alone does not change the active controlled page size.",
           "Rows opt into complete-row activation with interactive and emit dsRowActivate without owning navigation. Selection paints through the shared selected ::before layer; interactive hover and press paint through the shared ::after layer.",
           "Row selection owns the single sticky start lane. One explicitly sized application column can own the sticky end lane, or the start lane when selection is absent. Each sticky boundary owns one fixed divider and a row-clipped directional shadow that paints into the adjacent scrolling columns only while more inline content remains beyond that edge.",
-          "Cells accept scalar content, standard primary-and-secondary or dual-primary text primitives, declarative Tag, wrapping multiple-Tag content, icon-only, icon-and-text, 16:9 Image, or ButtonUnfilled Action content, or explicit Empty and Blank absence values. Text objects may declare an optional href (and target) on the primary track only; the table renders a native anchor with the shared brand text-action treatment when the URL is safe, and leaves scalars unlinked. Standard secondary copy defaults to the secondary foreground and may declare a semantic Text color when the application data carries intent; an optional tertiary track uses the same subdued body-small recipe as secondary. Secondary and tertiary may also be a short list of colorable runs, rendered on one line with the table's middle-dot separator. A run may supply help to add the shared dotted underline and a bottom-start Tooltip when compact visible copy summarizes supplementary details; explicit line breaks create a compact unbulleted list without obscuring the current cell's earlier tracks. Dual-primary copy keeps both tracks primary unless explicitly colored and does not gain a tertiary track. Body data cells share 8px outer padding; header and group rows keep their own geometry. Text tracks, including Empty, keep 4px inline padding so copy lines up with column-header labels; Tag and icon-only tracks stay on the 8px cell chrome alone. Icon-and-text cells (`kind: 'icon-text'`) place one md prefix icon beside the same copy stack as a text cell. The icon slot takes 2px padding on every side, then a 2px flex gap before the copy; text-track padding stays on the copy. Omit iconLabel when the glyph is decorative. 20px content (body-medium text, md icon, and the row checkbox) sits in a 24px track so it stays optically aligned with 24px Tag and Action content. Single-track text, selection, tag-only, icon-only, icon-and-text, Action, Empty, Blank, and 1-track Image cells resolve a 40px base contract while two-track cells grow to 64px and three-track cells grow to 88px. Every later track adds 24px, so four tracks resolve to 112px, five to 136px, and the sequence may continue. Tracks stack with no gap. Wrapping primary on a 1-track cell uses that same rhythm: two wrapped lines share the 64px row and three wrapped lines share the 88px row. Wrapping secondary keeps primary on the first track and consumes later tracks: two secondary lines share the 88px row and three secondary lines share a 112px fourth track. Keep the same track count in every row of a table or group when those rows should share one height. Tag cells use the inset Tag recipe: md double-inset is a 24px control for tag-only and tag-with-text, while text-with-tag uses sm single-inset at 20px so the second-track pill sits in the same 24px lane. Multiple-Tag cells use `kind: 'tags'`, a positive `tracks` count, and small single-inset Tags that wrap naturally at the column edge. Each wrap line is a 24px track with no stack gap, matching text. The tallest cell establishes the native row height, so all sibling cells match even at four, five, or more tracks; virtual tables use the declared count as the initial estimate and measure responsive wrapping after paint. Action cells primarily use an icon-only Ellipses treatment, render a 24px small ButtonUnfilled, default to unbordered, and emit row, column, and action identities through dsCellAction. When an action cell declares items, that Ellipses trigger opens the shared ds-menu for commands, dividers, inactive rows, and destructive rows instead of emitting on click; choosing a command emits dsCellAction with that item's actionId. Omit items to keep a single-shot control. Image cells declare tracks 1, 2, or 3 so the 16:9 preview fills that body-row content box (cell height minus 8px padding) and the column hugs the resulting width; omit tracks for the 1-track recipe, and keep image tracks aligned with the other cells in the table or group. The image is clipped to the 2px preview radius and the tertiary border paints as an inset overlay so it remains visible over image pixels. Image cells fall back to an accessible placeholder when no source is supplied. Empty means the data applies but has no value and renders an em dash with localized assistive text; Blank means the data is not applicable and renders no content. Nullish values remain backward-compatible Empty values. Stable type, variant, and track-count hooks keep every cell family independently styleable.",
+          "Cells accept scalar content, standard primary-and-secondary or dual-primary text primitives, declarative Tag, wrapping multiple-Tag content, icon-only, icon-and-text, 16:9 Image, or ButtonUnfilled Action content, or explicit Empty and Blank absence values. Text objects may declare an optional href (and target) on the primary track only; the table renders a native anchor with the shared brand text-action treatment when the URL is safe, and leaves scalars unlinked. Standard secondary copy defaults to the secondary foreground and may declare a semantic Text color when the application data carries intent; an optional tertiary track uses the same subdued body-small recipe as secondary. Secondary and tertiary may also be a short list of colorable runs, rendered on one line with the table's middle-dot separator. A run may supply help to add the shared dotted underline and a bottom-start Tooltip when compact visible copy summarizes supplementary details; explicit line breaks create a compact unbulleted list without obscuring the current cell's earlier tracks. Dual-primary copy keeps both tracks primary unless explicitly colored and does not gain a tertiary track. Body data cells share 8px outer padding; header and group rows keep their own geometry. Text tracks, including Empty, keep 4px inline padding so copy lines up with column-header labels; Tag and icon-only tracks stay on the 8px cell chrome alone. Icon-and-text cells (`kind: 'icon-text'`) place one md prefix icon beside the same copy stack as a text cell. The icon slot takes 2px padding on every side, then a 2px flex gap before the copy; text-track padding stays on the copy. Omit iconLabel when the glyph is decorative. 20px content (body-medium text, md icon, and the row checkbox) sits in a 24px track so it stays optically aligned with 24px Tag and Action content. Single-track text, selection, tag-only, icon-only, icon-and-text, Action, Empty, Blank, and 1-track Image cells resolve a 40px base contract while two-track cells grow to 64px and three-track cells grow to 88px. Every later track adds 24px, so four tracks resolve to 112px, five to 136px, and the sequence may continue. Tracks stack with no gap. Wrapping primary on a 1-track cell uses that same rhythm: two wrapped lines share the 64px row and three wrapped lines share the 88px row. Wrapping secondary keeps primary on the first track and consumes later tracks: two secondary lines share the 88px row and three secondary lines share a 112px fourth track. Keep the same track count in every row of a table or group when those rows should share one height. Tag cells use the inset Tag recipe: md double-inset is a 24px control for tag-only and tag-with-text, while text-with-tag uses sm single-inset at 20px so the second-track pill sits in the same 24px lane. For a compact ordered set of tags that must remain together on the primary track, choose the inline multiple-tag variation, optionally with supporting text below. Slash separators distinguish adjacent tags; labels truncate as the column narrows. Use wrapping tags when all labels must remain visible. Multiple-Tag cells use `kind: 'tags'`, a positive `tracks` count, and small single-inset Tags that wrap naturally at the column edge. Each wrap line is a 24px track with no stack gap, matching text. The tallest cell establishes the native row height, so all sibling cells match even at four, five, or more tracks; virtual tables use the declared count as the initial estimate and measure responsive wrapping after paint. Action cells primarily use an icon-only Ellipses treatment, render a 24px small ButtonUnfilled, default to unbordered, and emit row, column, and action identities through dsCellAction. When an action cell declares items, that Ellipses trigger opens the shared ds-menu for commands, dividers, inactive rows, and destructive rows instead of emitting on click; choosing a command emits dsCellAction with that item's actionId. Omit items to keep a single-shot control. Image cells declare tracks 1, 2, or 3 so the 16:9 preview fills that body-row content box (cell height minus 8px padding) and the column hugs the resulting width; omit tracks for the 1-track recipe, and keep image tracks aligned with the other cells in the table or group. The image is clipped to the 2px preview radius and the tertiary border paints as an inset overlay so it remains visible over image pixels. Image cells fall back to an accessible placeholder when no source is supplied. Empty means the data applies but has no value and renders an em dash with localized assistive text; Blank means the data is not applicable and renders no content. Nullish values remain backward-compatible Empty values. Stable type, variant, and track-count hooks keep every cell family independently styleable.",
           "Score-and-text cells (`kind: score-text`) place the small 24px safety score at the top-right of the cell while the same one-, two-, or three-track copy stack as a standard text cell fills from the start edge. The score is top-aligned with the first text track, adds no inner padding, and defaults its accessible name prefix to Safety score. Score-and-text loading geometry uses the matching small score skeleton and declared copy tracks.",
           "The public @ds-mo/ui/table.css export is the authoritative zero-specificity visual recipe. Override its --ds-table-* properties or target its stable element classes for product-specific styling.",
           "While any checkbox selection is active, row activation toggles selection instead of opening details. Clearing the selection restores ordinary row activation. Nested controls retain their own intent, and disabled or non-selectable rows cannot be selected by activating their row.",
-          "Use surfaceOpenRowId to identify the interactive row associated with a visible detail panel or other contextual surface. The application owns opening, same-row toggling, switching records, and closing; retain the identity through exit motion, then clear it. Move it when panel navigation changes the displayed record. This pressed wash spans sticky and scrolling cells, follows stable row identity through virtualization, and never checks a checkbox or changes selectedRowIds. Group expansion remains an inline disclosure."
+          "Use surfaceOpenRowId to identify the interactive row associated with a visible detail panel or other contextual surface. The application owns opening, same-row toggling, switching records, and closing; retain the identity through exit motion, then clear it. Move it when panel navigation changes the displayed record. This pressed wash spans sticky and scrolling cells, follows stable row identity through virtualization, and never checks a checkbox or changes selectedRowIds. Group expansion remains an inline disclosure.",
+          "An external ds-table-preferences may own column controls. Hide only the built-in Customize trigger, keep column customization enabled, and share hidden-column and ordering state with the external surface.",
+          "Borderless toolbar compositions omit resting control borders while retaining focus and interaction feedback."
         ],
         "responsiveBehavior": [
           "The table keeps native semantics at narrow widths and scrolls horizontally instead of transforming into cards.",
@@ -10022,6 +10067,10 @@
             "type": "string",
             "required": true
           },
+          "captionControlsBorderless": {
+            "type": "boolean",
+            "required": false
+          },
           "captionVisibility": {
             "type": "TableCaptionVisibility",
             "required": false
@@ -10046,6 +10095,10 @@
             "type": "TableColumn[]",
             "required": false
           },
+          "customizeOptions": {
+            "type": "MenuItemData[]",
+            "required": false
+          },
           "dataMode": {
             "type": "TableDataMode",
             "required": false
@@ -10142,6 +10195,10 @@
             "type": "string[]",
             "required": false
           },
+          "hideColumnCustomizerTrigger": {
+            "type": "boolean",
+            "required": false
+          },
           "highlightFieldIds": {
             "type": "string[]",
             "required": false
@@ -10272,6 +10329,10 @@
             "name": "dsColumnsConfigChange",
             "detail": "TableColumnsConfigChangeDetail"
           },
+          {
+            "name": "dsCustomizeOptionChange",
+            "detail": "string"
+          },
           {
             "name": "dsDataModeChange",
             "detail": "TableDataModeChangeDetail"
@@ -10378,16 +10439,20 @@
         ],
         "states": [
           "filters, values, matchModes, and activeFilterId are controlled. dsChange, dsMatchModeChange, dsClear, and dsActiveFilterChange report intent without changing those inputs; the application applies query consequences and returns replacement values.",
-          "The visible trigger label stays singular Filter without appending an active-count suffix. Active criteria promote only the visible label from secondary to primary, matching the other table caption controls without redefining generic button active semantics.",
+          "The visible trigger label stays singular Filter without appending an active-count suffix. Active criteria retain the same neutral label and icon colors.",
           "The popup reserves a visually empty footer row inside the category pane for every state. Active criteria reveal its divider and only a left-aligned Clear action, without adding popup height or showing redundant selected-count copy; the option pane retains its full column.",
           "Every multiple-choice category exposes a right-pane footer where the blue any or all word toggles its controlled match mode. any is the default OR mode; the application applies the requested mode to its query.",
           "Every non-date category exposes a 40px secondary-background search header that filters its displayed option labels and descriptions without changing controlled filter values. Date retains only its Relative and Range header.",
           "Date categories use the shared compact-header Range and Relative experience. Persist relative values semantically and resolve them from the product's current date whenever rows or saved views are applied.",
-          "Popup visibility follows the same mutable open and dsOpenChange contract as ds-filter-menu."
+          "Popup visibility follows the same mutable open and dsOpenChange contract as ds-filter-menu.",
+          "Borderless toolbar compositions omit resting control borders while retaining focus and interaction feedback.",
+          "Expanded toolbar triggers use an icon and regular-weight text without a trailing chevron.",
+          "Selected views and applied filters do not promote trigger icon or label colors. Trigger colors remain neutral across value changes.",
+          "Apply-required filtering stages edits locally, including match mode. Clear immediately clears all filters and discards pending edits. The footer appears when filters are selected or applied; Apply stays in place and inactive without pending changes; applying emits controlled changes. Closing discards unapplied edits."
         ],
         "responsiveBehavior": [
           "Place the control in the trailing region of ds-table-toolbar.",
-          "Inside a named ds-table container narrower than 900px, the trigger becomes icon-only, exposes its visible label through a hover and keyboard-focus tooltip, and active criteria promote the Filters icon to primary."
+          "Inside a named ds-table container narrower than 900px, the trigger becomes icon-only, exposes its visible label through a hover and keyboard-focus tooltip, and the Filters icon remains neutral with active criteria."
         ],
         "frameworkCaveats": {
           "customElements": [
@@ -10433,6 +10498,10 @@
             "type": "FilterMenuFilter[]",
             "required": false
           },
+          "hasBorder": {
+            "type": "boolean",
+            "required": false
+          },
           "label": {
             "type": "string",
             "required": false
@@ -10552,7 +10621,11 @@
           "options and grouping are controlled. A data option may supply product-owned orderOptions; otherwise Order defaults to Ascending and Descending. dsGroupChange reports a complete TableGroupingState and dsClear requests null grouping without mutating either input.",
           "Selecting a new data point starts at its first custom order option, or ascending when it has no custom order options. Re-selecting the active data point preserves its complete order state.",
           "Selecting a data point or direction applies immediately and leaves the dialog open so the other pane can be changed.",
-          "The grouping picker automatically holds the shared surface-open wash through exit. Opening this picker is separate from expanding an inline table group."
+          "The grouping picker automatically holds the shared surface-open wash through exit. Opening this picker is separate from expanding an inline table group.",
+          "Embedded mode renders the same controlled content inside a parent-owned surface; the parent owns positioning, initial focus, Escape, Tab exit, and dismissal.",
+          "Borderless toolbar compositions omit resting control borders while retaining focus and interaction feedback.",
+          "Expanded toolbar triggers use an icon and regular-weight text without a trailing chevron.",
+          "Vertical presentation stacks grouping data and ordering, with an explicit No grouping choice and no Clear footer."
         ],
         "responsiveBehavior": [
           "Use in the trailing region of ds-table-toolbar.",
@@ -10595,6 +10668,10 @@
             "type": "string",
             "required": false
           },
+          "embedded": {
+            "type": "boolean",
+            "required": false
+          },
           "emptyMessage": {
             "type": "string",
             "required": false
@@ -10603,6 +10680,10 @@
             "type": "TableGroupingState | null",
             "required": false
           },
+          "hasBorder": {
+            "type": "boolean",
+            "required": false
+          },
           "open": {
             "type": "boolean",
             "required": false
@@ -10610,6 +10691,10 @@
           "options": {
             "type": "TableGroupOption[]",
             "required": false
+          },
+          "vertical": {
+            "type": "boolean",
+            "required": false
           }
         },
         "events": [
@@ -10645,6 +10730,180 @@
         "text"
       ]
     },
+    {
+      "id": "component:ds-table-preferences",
+      "tag": "ds-table-preferences",
+      "name": "table-preferences",
+      "title": "TablePreferences",
+      "summary": "Compact table preferences dialog with Filters, Sort, Group, and Customize tabs.",
+      "intentStatus": "complete",
+      "intent": {
+        "audience": "general",
+        "status": "experimental",
+        "summary": "Compact table preferences dialog with Filters, Sort, Group, and Customize tabs.",
+        "useWhen": [
+          "A narrow table toolbar or a user preference calls for one result-shaping control."
+        ],
+        "avoidWhen": [
+          "The application needs unrelated actions or a submitted form."
+        ],
+        "states": [
+          "The application owns all filter, sort, grouping, and column configuration values. Apply emitted changes to the table and replace the matching preferences inputs.",
+          "The component owns popup visibility, active tab, positioning, and dismissal; embedded controls reuse the same content as their standalone popups.",
+          "Borderless toolbar compositions omit resting control borders while retaining focus and interaction feedback.",
+          "Apply-required filtering stages edits locally, including match mode. Clear immediately clears all filters and discards pending edits. The footer appears when filters are selected or applied; Apply stays in place and inactive without pending changes; applying emits controlled changes. Closing discards unapplied edits.",
+          "Embedded presentation delegates its active tab, draft state, Apply, Reset, and dismissal to the owning panel; it renders vertical filter and grouping content without a popup trigger."
+        ],
+        "accessibility": [
+          "An icon-only Preferences trigger opens a named dialog. TabGroup owns section keyboard navigation; Escape and outside activation dismiss, returning focus to the trigger."
+        ],
+        "responsiveBehavior": [
+          "The popup fits the viewport and scrolls internally. The application chooses whether to show it instead of separate controls. Hide the table-owned Customize trigger while retaining column customization."
+        ],
+        "patterns": [],
+        "commonlyComposedWith": [
+          "component:ds-table",
+          "component:ds-table-toolbar",
+          "component:ds-filter-menu",
+          "component:ds-menu",
+          "component:ds-table-group",
+          "component:ds-tab-group"
+        ]
+      },
+      "api": {
+        "props": {
+          "activeFilterId": {
+            "type": "string | undefined",
+            "required": false
+          },
+          "activeTab": {
+            "type": "PreferencesTab",
+            "required": false
+          },
+          "columnOrder": {
+            "type": "string[]",
+            "required": false
+          },
+          "columns": {
+            "type": "TableColumn[]",
+            "required": false
+          },
+          "customizeOptions": {
+            "type": "MenuItemData[]",
+            "required": false
+          },
+          "customizeSections": {
+            "type": "MenuSection[]",
+            "required": false
+          },
+          "embedded": {
+            "type": "boolean",
+            "required": false
+          },
+          "filters": {
+            "type": "FilterMenuFilter[]",
+            "required": false
+          },
+          "grouping": {
+            "type": "TableGroupingState | null",
+            "required": false
+          },
+          "groupingOptions": {
+            "type": "TableGroupOption[]",
+            "required": false
+          },
+          "hasBorder": {
+            "type": "boolean",
+            "required": false
+          },
+          "hiddenColumnIds": {
+            "type": "string[]",
+            "required": false
+          },
+          "label": {
+            "type": "string",
+            "required": false
+          },
+          "matchModes": {
+            "type": "FilterMenuMatchModes",
+            "required": false
+          },
+          "sort": {
+            "type": "TableSortState | null",
+            "required": false
+          },
+          "sortColumns": {
+            "type": "TableColumn[]",
+            "required": false
+          },
+          "values": {
+            "type": "FilterMenuValues",
+            "required": false
+          }
+        },
+        "events": [
+          {
+            "name": "dsActiveFilterChange",
+            "detail": "string"
+          },
+          {
+            "name": "dsColumnsConfigChange",
+            "detail": "TableColumnsConfigChangeDetail"
+          },
+          {
+            "name": "dsCustomizeOptionChange",
+            "detail": "string"
+          },
+          {
+            "name": "dsFilterChange",
+            "detail": "FilterMenuChangeDetail"
+          },
+          {
+            "name": "dsFilterMatchModeChange",
+            "detail": "FilterMenuMatchModeChangeDetail"
+          },
+          {
+            "name": "dsFiltersClear",
+            "detail": "void"
+          },
+          {
+            "name": "dsGroupChange",
+            "detail": "TableGroupingState"
+          },
+          {
+            "name": "dsGroupClear",
+            "detail": "void"
+          },
+          {
+            "name": "dsPreferencesTabChange",
+            "detail": "PreferencesTab"
+          },
+          {
+            "name": "dsSortChange",
+            "detail": "TableSortChangeDetail"
+          }
+        ],
+        "slots": []
+      },
+      "exports": {
+        "customElement": "ds-table-preferences",
+        "react": "DsTablePreferences",
+        "vue": "DsTablePreferences",
+        "angular": "DsTablePreferences"
+      },
+      "dependencies": [
+        "@ds-mo/ui",
+        "@ds-mo/tokens"
+      ],
+      "componentDependencies": [
+        "button-unfilled",
+        "filter-menu",
+        "menu",
+        "tab-group",
+        "table-group",
+        "tooltip"
+      ]
+    },
     {
       "id": "component:ds-table-saved-views",
       "tag": "ds-table-saved-views",
@@ -10683,11 +10942,15 @@
           "views, value, and dirty are controlled. Dirty state is presented only for a selected custom view; the default template never shows the trigger dot or save/discard actions even if dirty is supplied. Selection, create, save, discard, rename, and remove events communicate intent and never mutate application records.",
           "The component owns only transient interaction state: the contextual menu, naming dialog, draft name, duplicate-name validation, and focus restoration.",
           "The default view is a non-editable template. Application-owned custom views appear in a separate section with Rename and Remove actions. New view opens the naming dialog. When an editable selected view is dirty, that view row shows Save and negative Discard supporting actions while the footer remains dedicated to New view. The application decides which table state to capture, restore, and persist.",
-          "The built-in picker and contextual option menu each retain their own surface-open treatment. Opening a view menu does not select that view."
+          "The built-in picker and contextual option menu each retain their own surface-open treatment. Opening a view menu does not select that view.",
+          "Borderless toolbar compositions omit resting control borders while retaining focus and interaction feedback.",
+          "Expanded toolbar triggers use an icon and regular-weight text without a trailing chevron.",
+          "Selected views and applied filters do not promote trigger icon or label colors. Trigger colors remain neutral across value changes."
         ],
         "responsiveBehavior": [
           "The control remains a single toolbar item and relies on Select, Menu, and Modal collision and viewport behavior. Its trigger hugs short view names and is capped at the compact menu-width token so long names truncate while the dirty dot stays visible. Its choice popup keeps that same token as the minimum width.",
-          "Place it in the start region of ds-table-toolbar so the middle region can keep left-side and right-side controls on one spanning cluster."
+          "Place it in the start region of ds-table-toolbar so the middle region can keep left-side and right-side controls on one spanning cluster.",
+          "The ViewMenu prefix identifies saved views. Compact compositions and narrow table captions show only the icon while retaining the accessible name and tooltip."
         ],
         "frameworkCaveats": {
           "customElements": [
@@ -10717,6 +10980,10 @@
       },
       "api": {
         "props": {
+          "compact": {
+            "type": "boolean",
+            "required": false
+          },
           "createLabel": {
             "type": "string",
             "required": false
@@ -10733,6 +11000,10 @@
             "type": "boolean",
             "required": false
           },
+          "hasBorder": {
+            "type": "boolean",
+            "required": false
+          },
           "label": {
             "type": "string",
             "required": false
@@ -10830,7 +11101,7 @@
           "Typing slash opens the field listbox without inserting slash into the table query. Text typed while it is open filters data points by complete label, Up and Down change the active match, Enter selects it, Escape closes it, and Left and Right retain native text-cursor behavior because focus never leaves the input. Backspace edits the field-picker query first and closes the listbox when that query is empty.",
           "The query disables browser autocomplete history, automatic capitalization, autocorrection, and spellchecking so browser-owned suggestions never obscure the product-owned field menu or table results.",
           "Selected field Chips have individually labeled remove actions and are also described by the search input. Polite announcements report additions, removals, and clearing without duplicating the visible query.",
-          "The slash suffix is a labeled double-inset md button excluded from sequential keyboard navigation; the search input exposes the same action through aria-keyshortcuts and its description.",
+          "The search input exposes the slash command through aria-keyshortcuts and its description, without a visible suffix button.",
           "The clear action removes both free text and every selected field. It restores focus to the search input; each Chip's own remove action remains scoped to that field."
         ],
         "states": [
@@ -10840,12 +11111,13 @@
           "Backspace edits a non-empty field-picker query, then closes the open slash listbox when that query is empty. When the table query is empty and the listbox is already closed, the next Backspace removes the last selected field. Ordinary Backspace edits table query text when the listbox is closed.",
           "Duplicate, blank, and unknown field identities are ignored for presentation. Selected fields preserve the consumer's order.",
           "Inactive search leaves the tab order, closes the field listbox, and does not emit query or field changes.",
-          "The field-picker action holds the shared surface-open wash while its listbox is visible; chosen search fields remain independent."
+          "The field-picker action holds the shared surface-open wash while its listbox is visible; chosen search fields remain independent.",
+          "Borderless toolbar compositions omit resting control borders while retaining focus and interaction feedback."
         ],
         "responsiveBehavior": [
           "The control fills the available inline size supplied by the table toolbar search slot. Selected Chips and the editable query share one horizontal editor lane so the md control does not grow vertically.",
           "The field popup enters the top layer, aligns its first choice cell with the search control, flips or clamps to the viewport or nearest overlay boundary, and scrolls internally when its catalog is taller than available space.",
-          "Long selected field labels truncate inside their Chips while the input remains available at the inline end of the editor lane. Both suffix actions resolve to the same 24px height as selected Chips. Clear follows the standard md Input recipe—a non-inset sm icon button—while slash is a double-inset md label button. Slash remains rightmost; when query text exposes Clear, a vertical divider separates the two actions."
+          "Clear appears when query text is present and uses the standard sm icon button treatment."
         ],
         "frameworkCaveats": {
           "customElements": [
@@ -10892,6 +11164,10 @@
             "type": "string",
             "required": false
           },
+          "hasBorder": {
+            "type": "boolean",
+            "required": false
+          },
           "isInactive": {
             "type": "boolean",
             "required": false
@@ -10939,7 +11215,6 @@
       "componentDependencies": [
         "button-unfilled",
         "chip",
-        "divider",
         "empty-state",
         "icon",
         "text"
@@ -10993,7 +11268,9 @@
           "Selecting a different data field keeps the current direction, or starts ascending when no sort exists. Selecting a direction applies it to the current field, or to the first sortable field when no sort exists. Selecting the already-active field or direction is a no-op and does not toggle the way a header click does.",
           "The trigger stays Sort in regular-weight resting secondary chrome. Field and direction selection live in the menu and on column headers, so the trigger never uses active primary emphasis. It keeps pressed interaction paint without physically scaling inside the stable table caption row.",
           "Compound sortable headers contribute one Data row per segment. Action columns never appear.",
-          "The trigger automatically holds the shared surface-open wash through menu exit while the selected sort remains independently controlled."
+          "The trigger automatically holds the shared surface-open wash through menu exit while the selected sort remains independently controlled.",
+          "Borderless toolbar compositions omit resting control borders while retaining focus and interaction feedback.",
+          "Expanded toolbar triggers use an icon and regular-weight text without a trailing chevron."
         ],
         "responsiveBehavior": [
           "Place the control in the trailing region of ds-table-toolbar with Filter and Group.",
@@ -11036,6 +11313,10 @@
             "type": "TableColumn[]",
             "required": false
           },
+          "hasBorder": {
+            "type": "boolean",
+            "required": false
+          },
           "sort": {
             "type": "TableSortState | null",
             "required": false
@@ -11093,7 +11374,8 @@
           "component:ds-table-group",
           "component:ds-select",
           "component:ds-table-sort",
-          "component:ds-button-unfilled"
+          "component:ds-button-unfilled",
+          "component:ds-table-preferences"
         ],
         "patterns": [],
         "accessibility": [
@@ -11104,14 +11386,15 @@
         "states": [
           "The component owns layout only. It never mutates slotted control props, values, menus, loading, persistence, or consequences. Use ds-table-saved-views and ds-table-filter when those interactions need the shared CompoMo behavior while application data and persistence remain external.",
           "Buttons in the toolbar keep their hover and pressed interaction paint without physically scaling, so pointer feedback does not disturb the stable caption geometry.",
-          "The start cluster is followed by a decorative vertical divider, then Search, optional leading controls, and one trailing action cluster. The start cluster and divider hide when nothing is projected. Search is a dedicated slot that hides when nothing is projected and grows to consume available row space. Empty leading or trailing clusters add no placeholder chrome. Search is the only toolbar region that grows and shrinks; all action controls retain their control geometry and align directly before the table-owned actions.",
-          "Column customizer and data-mode switching stay table-owned caption actions. Do not recreate those menus in the toolbar. When slotted into a table header, the table caption owns overflow for the complete toolbar and table-owned action row."
+          "The start cluster is followed by Search, optional leading controls, and one trailing action cluster. The start cluster hides when nothing is projected. Search is a dedicated slot that hides when nothing is projected and grows to consume available row space. Empty leading or trailing clusters add no placeholder chrome. Search is the only toolbar region that grows and shrinks; all action controls retain their control geometry and align directly before the table-owned actions.",
+          "Data-mode switching remains a table-owned caption action. Column customization normally uses the table caption trigger; compact compositions use the shared ds-table-preferences control and hide that trigger. When slotted into a table header, the table caption owns overflow for the complete toolbar and table-owned action row.",
+          "Standard toolbars omit region dividers. Borderless compositions show dividers after populated start and search regions when another region follows; the application supplies borderless controls."
         ],
         "responsiveBehavior": [
           "The start cluster, search, trailing Filter/Sort/Group, and table caption trailing actions stay on one line. Saved views hug their current trigger content up to the compact menu-width token rather than reserving that full width; long names truncate while the dirty dot stays visible. Filter, Sort, and Group triggers cap at the same token, and Sort and Group popups keep that compact menu-width floor. A standalone toolbar owns its horizontal scrolling; inside a table, the complete caption row is the single overflow owner so table-owned actions never remain pinned over scrolling toolbar controls.",
-          "Search consumes the row space left between fixed control groups and flexes smaller when the complete row needs space. Inside a named ds-table container narrower than 900px, ds-table-filter, ds-table-group, and ds-table-sort omit their labels and chevrons; each exposes its label through a hover and keyboard-focus tooltip. Empty leading and trailing slot groups do not add spacing. Active filtering promotes its prefix icon to primary. Group and Sort keep resting secondary chrome. Table-owned Customize also becomes the icon-only Table menu button at that width with the same tooltip behavior.",
+          "Search consumes the row space left between fixed control groups and flexes smaller when the complete row needs space. Inside a named ds-table container narrower than 900px, ds-table-filter, ds-table-group, and ds-table-sort omit their labels and chevrons; each exposes its label through a hover and keyboard-focus tooltip. Empty leading and trailing slot groups do not add spacing. Active filtering retains neutral trigger colors. Group and Sort keep resting secondary chrome. Table-owned Customize also becomes the icon-only Table menu button at that width with the same tooltip behavior.",
           "The scrollbar is visually suppressed without removing touch, trackpad, mouse-wheel, or keyboard scrolling from the overflow container.",
-          "Trailing controls remain grouped after leading controls; the toolbar does not collapse controls into an application-specific overflow menu."
+          "For compact toolbars, the application can replace Filter, Sort, Group and the table Customize trigger with ds-table-preferences in the trailing slot. Share the same controlled values and events; the toolbar remains a data-agnostic layout."
         ],
         "frameworkCaveats": {
           "customElements": [
@@ -11137,6 +11420,10 @@
       },
       "api": {
         "props": {
+          "borderless": {
+            "type": "boolean",
+            "required": false
+          },
           "label": {
             "type": "string",
             "required": false