@ds-mo/ui 14.27.1 → 14.29.0

package/dist/types/components.d.ts

@@ -20,8 +20,10 @@ import { ButtonFilledBackground, ButtonFilledContrast, ButtonFilledIntent, Butto
 import { ControlInsetDepth, ControlSize } from "./utils/control-text";
 import { ButtonUnfilledBackground, ButtonUnfilledPopup, ButtonUnfilledSize, ButtonUnfilledVariant, ButtonUnfilledWidth } from "./components/ButtonUnfilled/ButtonUnfilled";
 import { CardChartVariant, CardChartWidth } from "./components/CardChart/CardChart";
+import { CardNavigationDetail, CardNavigationVariant, CardNavigationWidth } from "./components/CardNavigation/CardNavigation";
 import { CardOverviewLayout, CardOverviewVariant, OverviewMetric, OverviewScore } from "./components/CardOverview/card-overview-types";
 import { CardSettingActionDetail, CardSettingWidth } from "./components/CardSetting/CardSetting";
+import { SettingsScopeRequest } from "./components/CardSettingsScope/CardSettingsScope";
 import { ChartDefinition } from "./utils/chart-grammar";
 import { ChartFocusChangeDetail } from "./components/Chart/Chart";
 import { ChartLegendItem } from "./utils/chart-types";
@@ -92,8 +94,10 @@ export { ButtonFilledBackground, ButtonFilledContrast, ButtonFilledIntent, Butto
 export { ControlInsetDepth, ControlSize } from "./utils/control-text";
 export { ButtonUnfilledBackground, ButtonUnfilledPopup, ButtonUnfilledSize, ButtonUnfilledVariant, ButtonUnfilledWidth } from "./components/ButtonUnfilled/ButtonUnfilled";
 export { CardChartVariant, CardChartWidth } from "./components/CardChart/CardChart";
+export { CardNavigationDetail, CardNavigationVariant, CardNavigationWidth } from "./components/CardNavigation/CardNavigation";
 export { CardOverviewLayout, CardOverviewVariant, OverviewMetric, OverviewScore } from "./components/CardOverview/card-overview-types";
 export { CardSettingActionDetail, CardSettingWidth } from "./components/CardSetting/CardSetting";
+export { SettingsScopeRequest } from "./components/CardSettingsScope/CardSettingsScope";
 export { ChartDefinition } from "./utils/chart-grammar";
 export { ChartFocusChangeDetail } from "./components/Chart/Chart";
 export { ChartLegendItem } from "./utils/chart-types";
@@ -595,7 +599,7 @@ export namespace Components {
          */
         "controls": string | undefined;
         /**
-          * Controlled open state of the popup this button triggers. Holds the pressed wash for the popup's rendered lifecycle. ButtonFilled has no selected state, so an open popup never promotes to an active treatment.
+          * Controlled disclosure state forwarded to aria-expanded. Using expanded alone for surface-open styling is deprecated; set surfaceOpen explicitly to separate the rendered surface lifecycle from disclosure state.
          */
         "expanded": boolean | undefined;
         /**
@@ -678,6 +682,10 @@ export namespace Components {
           * @default false
          */
         "split": boolean;
+        /**
+          * The associated menu, picker, or panel is visible, including its exit motion. Holds only the pressed wash; does not set ARIA, selection, or press scaling. In split mode this applies only to the menu segment. Explicit false disables the legacy expanded-derived wash; omission preserves that compatibility path.
+         */
+        "surfaceOpen": boolean | undefined;
         /**
           * Native button type.
           * @default 'button'
@@ -721,7 +729,7 @@ export namespace Components {
          */
         "dot": boolean;
         /**
-          * Controlled disclosure or popup state forwarded to `aria-expanded`. Popup triggers hold only the pressed wash while open; their resting foreground is unchanged. Ordinary disclosures remain visually neutral.
+          * Controlled disclosure state forwarded to aria-expanded. Using expanded alone for surface-open styling is deprecated; set surfaceOpen explicitly to separate the rendered surface lifecycle from disclosure state.
          */
         "expanded": boolean | undefined;
         /**
@@ -809,6 +817,10 @@ export namespace Components {
           * @default false
          */
         "split": boolean;
+        /**
+          * The associated menu, picker, or panel is visible, including its exit motion. Holds only the pressed wash; does not set ARIA, selection, or press scaling. In split mode this applies only to the menu segment. Explicit false disables the legacy expanded-derived wash; omission preserves that compatibility path.
+         */
+        "surfaceOpen": boolean | undefined;
         /**
           * Native button type.
           * @default 'button'
@@ -854,6 +866,30 @@ export namespace Components {
          */
         "variant": CardChartVariant;
     }
+    interface DsCardNavigation {
+        /**
+          * Card width token (`sm` / `md` / `lg`).
+          * @default 'md'
+         */
+        "cardWidth": CardNavigationWidth;
+        /**
+          * Optional supporting copy shown below the heading.
+         */
+        "description": string | undefined;
+        /**
+          * Section or destination heading shown in the card header.
+         */
+        "heading": string;
+        /**
+          * Destination for the card's native link.
+         */
+        "href": string;
+        /**
+          * `navigation-only` makes the complete card the link. `content` keeps the header as the link and exposes a non-interactive body slot below it.
+          * @default 'navigation-only'
+         */
+        "variant": CardNavigationVariant;
+    }
     interface DsCardOverview {
         /**
           * Copy between the current period and comparison control, usually `vs.`.
@@ -937,6 +973,56 @@ export namespace Components {
          */
         "saveLabel": string;
     }
+    interface DsCardSettingsScope {
+        /**
+          * ID of the application-owned product-area menu.
+         */
+        "areaControls": string | undefined;
+        /**
+          * Whether the product-area menu is open.
+          * @default false
+         */
+        "areaExpanded": boolean;
+        /**
+          * Current product area or the label for the combined settings view.
+          * @default 'All settings'
+         */
+        "areaLabel": string;
+        /**
+          * Sentence connector, supplied separately for localization.
+          * @default 'for'
+         */
+        "forLabel": string;
+        /**
+          * Sentence prefix, supplied separately for localization.
+          * @default 'Managing'
+         */
+        "managingLabel": string;
+        /**
+          * ID of the application-owned profiles popup.
+         */
+        "profileControls": string | undefined;
+        /**
+          * Whether the profiles popup is open.
+          * @default false
+         */
+        "profileExpanded": boolean;
+        /**
+          * Current organization or settings profile.
+          * @default 'Organization'
+         */
+        "profileLabel": string;
+        /**
+          * Empty informational profile popups use dialog semantics instead of a menu.
+          * @default 'menu'
+         */
+        "profilePopup": 'menu' | 'dialog';
+        /**
+          * Accessible name for this context region.
+          * @default 'Settings scope'
+         */
+        "scopeLabel": string;
+    }
     interface DsChart {
         /**
           * Derives height from the current width when height is not supplied.
@@ -1586,6 +1672,11 @@ export namespace Components {
           * Explicit collision owner; otherwise the nearest data-ds-overlay-boundary ancestor is used.
          */
         "boundary": HTMLElement | undefined;
+        /**
+          * Informational message shown when there are no choices. Uses a non-modal dialog, not a fake menu item.
+          * @default ''
+         */
+        "emptyMessage": string;
         /**
           * Show a visible ring on the initially focused menu item. Use only when the opener was keyboard-driven.
           * @default false
@@ -1794,6 +1885,11 @@ export namespace Components {
           * @default 'Messages'
          */
         "messagesLabel": string;
+        /**
+          * Context destination retained while a different global tool is active.
+          * @default 'area'
+         */
+        "primaryDestination": 'area' | 'help';
         /**
           * @default false
          */
@@ -1848,6 +1944,11 @@ export namespace Components {
           * @default 'Change page subsection'
          */
         "subsectionsAriaLabel": string;
+        /**
+          * Place local sections below, beside, or combined with the page title in one sheet trigger.
+          * @default 'below'
+         */
+        "subsectionsPlacement": 'below' | 'inline' | 'combined';
         /**
           * Controlled selected child-section id.
           * @default ''
@@ -1870,6 +1971,16 @@ export namespace Components {
           * @default 'Change page section'
          */
         "navigationLabel": string;
+        /**
+          * Stable page identity shown before the selected section in a sheet trigger.
+          * @default ''
+         */
+        "pageLabel": string;
+        /**
+          * Anchored local-view menu or viewport-edge sheet for primary page sections.
+          * @default 'menu'
+         */
+        "presentation": 'menu' | 'sheet';
         /**
           * Ordered controlled sections. Divider entries group the popup menu.
           * @default []
@@ -1914,6 +2025,11 @@ export namespace Components {
           * @default false
          */
         "open": boolean;
+        /**
+          * Flat area navigation or inline disclosure of each area's child routes.
+          * @default 'flat'
+         */
+        "presentation": PanelNavPresentation;
         /**
           * Whether the router-derived current area owns the active mobile stage.
           * @default true
@@ -2043,10 +2159,14 @@ export namespace Components {
          */
         "accountLabel": string;
         /**
-          * Keep the account-menu trigger visually pressed while its popup is open or closing.
+          * Account disclosure state. Expanded-derived styling is deprecated; use accountMenuSurfaceOpen for the rendered lifetime.
           * @default false
          */
         "accountMenuExpanded": boolean;
+        /**
+          * External account surface is visible, including exit motion. Omission preserves the deprecated accountMenuExpanded-derived wash.
+         */
+        "accountMenuSurfaceOpen": boolean | undefined;
         /**
           * ID of the active child route when URL matching is unavailable.
           * @default ''
@@ -2203,6 +2323,10 @@ export namespace Components {
           * @default false
          */
         "menuExpanded": boolean;
+        /**
+          * Associated menu surface is visible, including exit motion.
+         */
+        "menuSurfaceOpen": boolean | undefined;
         /**
           * Stable id placed on the menu trigger host for ds-menu anchoring.
           * @default ''
@@ -2248,6 +2372,10 @@ export namespace Components {
           * @default false
          */
         "filterExpanded": boolean;
+        /**
+          * Associated filter surface is visible, including exit motion.
+         */
+        "filterSurfaceOpen": boolean | undefined;
         /**
           * Stable id placed on the filter trigger for ds-menu anchoring.
           * @default ''
@@ -2689,7 +2817,7 @@ export namespace Components {
          */
         "paperTexture"?: PaperTextureConfig;
         /**
-          * Desktop/tablet route sections in BarNav, or nested beneath PanelNav parents.
+          * Route sections in bar/header pickers, or nested beneath desktop and mobile menu parents.
           * @default 'bar'
          */
         "sectionNavigation": ShellSectionNavigation;
@@ -3338,6 +3466,10 @@ export namespace Components {
           * @default false
          */
         "stickyHeader": boolean;
+        /**
+          * Identity of the interactive row whose associated surface is visible. Holds its pressed wash independently of checkbox selection. Keep the ID through exit motion and clear it after close; the application owns toggling and switching the surface. Off-window identities survive virtualization.
+         */
+        "surfaceOpenRowId": string | undefined;
         "totalCount": number | undefined;
         /**
           * Reserved space below a viewport-fitted table.
@@ -3605,6 +3737,10 @@ export namespace Components {
           * @default 'md'
          */
         "size": TagSize;
+        /**
+          * Associated menu remains visible, including exit motion. Omission preserves the deprecated expanded-derived wash; explicit false suppresses it.
+         */
+        "surfaceOpen": boolean | undefined;
     }
     interface DsText {
         "align": TextAlign | undefined;
@@ -3962,6 +4098,10 @@ export interface DsCardChartCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLDsCardChartElement;
 }
+export interface DsCardNavigationCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLDsCardNavigationElement;
+}
 export interface DsCardOverviewCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLDsCardOverviewElement;
@@ -3970,6 +4110,10 @@ export interface DsCardSettingCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLDsCardSettingElement;
 }
+export interface DsCardSettingsScopeCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLDsCardSettingsScopeElement;
+}
 export interface DsChartCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLDsChartElement;
@@ -4379,6 +4523,23 @@ declare global {
         prototype: HTMLDsCardChartElement;
         new (): HTMLDsCardChartElement;
     };
+    interface HTMLDsCardNavigationElementEventMap {
+        "dsNavigate": CardNavigationDetail;
+    }
+    interface HTMLDsCardNavigationElement extends Components.DsCardNavigation, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLDsCardNavigationElementEventMap>(type: K, listener: (this: HTMLDsCardNavigationElement, ev: DsCardNavigationCustomEvent<HTMLDsCardNavigationElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLDsCardNavigationElementEventMap>(type: K, listener: (this: HTMLDsCardNavigationElement, ev: DsCardNavigationCustomEvent<HTMLDsCardNavigationElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLDsCardNavigationElement: {
+        prototype: HTMLDsCardNavigationElement;
+        new (): HTMLDsCardNavigationElement;
+    };
     interface HTMLDsCardOverviewElementEventMap {
         "dsMetricSelect": OverviewMetric;
     }
@@ -4413,6 +4574,23 @@ declare global {
         prototype: HTMLDsCardSettingElement;
         new (): HTMLDsCardSettingElement;
     };
+    interface HTMLDsCardSettingsScopeElementEventMap {
+        "dsScopeRequest": SettingsScopeRequest;
+    }
+    interface HTMLDsCardSettingsScopeElement extends Components.DsCardSettingsScope, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLDsCardSettingsScopeElementEventMap>(type: K, listener: (this: HTMLDsCardSettingsScopeElement, ev: DsCardSettingsScopeCustomEvent<HTMLDsCardSettingsScopeElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLDsCardSettingsScopeElementEventMap>(type: K, listener: (this: HTMLDsCardSettingsScopeElement, ev: DsCardSettingsScopeCustomEvent<HTMLDsCardSettingsScopeElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLDsCardSettingsScopeElement: {
+        prototype: HTMLDsCardSettingsScopeElement;
+        new (): HTMLDsCardSettingsScopeElement;
+    };
     interface HTMLDsChartElementEventMap {
         "dsChartFocusChange": ChartFocusChangeDetail;
     }
@@ -4748,6 +4926,7 @@ declare global {
     };
     interface HTMLDsMobileSheetNavElementEventMap {
         "dsAreaSelect": string;
+        "dsNavChildSelect": PanelNavChildSelectDetail;
         "dsBrowseContextChange": NavChromeStyle;
         "dsClose": void;
     }
@@ -5367,8 +5546,10 @@ declare global {
         "ds-button-filled": HTMLDsButtonFilledElement;
         "ds-button-unfilled": HTMLDsButtonUnfilledElement;
         "ds-card-chart": HTMLDsCardChartElement;
+        "ds-card-navigation": HTMLDsCardNavigationElement;
         "ds-card-overview": HTMLDsCardOverviewElement;
         "ds-card-setting": HTMLDsCardSettingElement;
+        "ds-card-settings-scope": HTMLDsCardSettingsScopeElement;
         "ds-chart": HTMLDsChartElement;
         "ds-chart-legend": HTMLDsChartLegendElement;
         "ds-checkbox": HTMLDsCheckboxElement;
@@ -5930,7 +6111,7 @@ declare namespace LocalJSX {
          */
         "controls"?: string | undefined;
         /**
-          * Controlled open state of the popup this button triggers. Holds the pressed wash for the popup's rendered lifecycle. ButtonFilled has no selected state, so an open popup never promotes to an active treatment.
+          * Controlled disclosure state forwarded to aria-expanded. Using expanded alone for surface-open styling is deprecated; set surfaceOpen explicitly to separate the rendered surface lifecycle from disclosure state.
          */
         "expanded"?: boolean | undefined;
         /**
@@ -6014,6 +6195,10 @@ declare namespace LocalJSX {
           * @default false
          */
         "split"?: boolean;
+        /**
+          * The associated menu, picker, or panel is visible, including its exit motion. Holds only the pressed wash; does not set ARIA, selection, or press scaling. In split mode this applies only to the menu segment. Explicit false disables the legacy expanded-derived wash; omission preserves that compatibility path.
+         */
+        "surfaceOpen"?: boolean | undefined;
         /**
           * Native button type.
           * @default 'button'
@@ -6057,7 +6242,7 @@ declare namespace LocalJSX {
          */
         "dot"?: boolean;
         /**
-          * Controlled disclosure or popup state forwarded to `aria-expanded`. Popup triggers hold only the pressed wash while open; their resting foreground is unchanged. Ordinary disclosures remain visually neutral.
+          * Controlled disclosure state forwarded to aria-expanded. Using expanded alone for surface-open styling is deprecated; set surfaceOpen explicitly to separate the rendered surface lifecycle from disclosure state.
          */
         "expanded"?: boolean | undefined;
         /**
@@ -6147,6 +6332,10 @@ declare namespace LocalJSX {
           * @default false
          */
         "split"?: boolean;
+        /**
+          * The associated menu, picker, or panel is visible, including its exit motion. Holds only the pressed wash; does not set ARIA, selection, or press scaling. In split mode this applies only to the menu segment. Explicit false disables the legacy expanded-derived wash; omission preserves that compatibility path.
+         */
+        "surfaceOpen"?: boolean | undefined;
         /**
           * Native button type.
           * @default 'button'
@@ -6196,6 +6385,34 @@ declare namespace LocalJSX {
          */
         "variant"?: CardChartVariant;
     }
+    interface DsCardNavigation {
+        /**
+          * Card width token (`sm` / `md` / `lg`).
+          * @default 'md'
+         */
+        "cardWidth"?: CardNavigationWidth;
+        /**
+          * Optional supporting copy shown below the heading.
+         */
+        "description"?: string | undefined;
+        /**
+          * Section or destination heading shown in the card header.
+         */
+        "heading": string;
+        /**
+          * Destination for the card's native link.
+         */
+        "href": string;
+        /**
+          * Emits before native navigation. Prevent this event to take over routing; the component will then prevent the original link navigation.
+         */
+        "onDsNavigate"?: (event: DsCardNavigationCustomEvent<CardNavigationDetail>) => void;
+        /**
+          * `navigation-only` makes the complete card the link. `content` keeps the header as the link and exposes a non-interactive body slot below it.
+          * @default 'navigation-only'
+         */
+        "variant"?: CardNavigationVariant;
+    }
     interface DsCardOverview {
         /**
           * Copy between the current period and comparison control, usually `vs.`.
@@ -6287,6 +6504,60 @@ declare namespace LocalJSX {
          */
         "saveLabel"?: string;
     }
+    interface DsCardSettingsScope {
+        /**
+          * ID of the application-owned product-area menu.
+         */
+        "areaControls"?: string | undefined;
+        /**
+          * Whether the product-area menu is open.
+          * @default false
+         */
+        "areaExpanded"?: boolean;
+        /**
+          * Current product area or the label for the combined settings view.
+          * @default 'All settings'
+         */
+        "areaLabel"?: string;
+        /**
+          * Sentence connector, supplied separately for localization.
+          * @default 'for'
+         */
+        "forLabel"?: string;
+        /**
+          * Sentence prefix, supplied separately for localization.
+          * @default 'Managing'
+         */
+        "managingLabel"?: string;
+        /**
+          * Requests a popup; the owner supplies choices, open state, and selection.
+         */
+        "onDsScopeRequest"?: (event: DsCardSettingsScopeCustomEvent<SettingsScopeRequest>) => void;
+        /**
+          * ID of the application-owned profiles popup.
+         */
+        "profileControls"?: string | undefined;
+        /**
+          * Whether the profiles popup is open.
+          * @default false
+         */
+        "profileExpanded"?: boolean;
+        /**
+          * Current organization or settings profile.
+          * @default 'Organization'
+         */
+        "profileLabel"?: string;
+        /**
+          * Empty informational profile popups use dialog semantics instead of a menu.
+          * @default 'menu'
+         */
+        "profilePopup"?: 'menu' | 'dialog';
+        /**
+          * Accessible name for this context region.
+          * @default 'Settings scope'
+         */
+        "scopeLabel"?: string;
+    }
     interface DsChart {
         /**
           * Derives height from the current width when height is not supplied.
@@ -6990,6 +7261,11 @@ declare namespace LocalJSX {
           * Explicit collision owner; otherwise the nearest data-ds-overlay-boundary ancestor is used.
          */
         "boundary"?: HTMLElement | undefined;
+        /**
+          * Informational message shown when there are no choices. Uses a non-modal dialog, not a fake menu item.
+          * @default ''
+         */
+        "emptyMessage"?: string;
         /**
           * Show a visible ring on the initially focused menu item. Use only when the opener was keyboard-driven.
           * @default false
@@ -7215,6 +7491,11 @@ declare namespace LocalJSX {
         "messagesLabel"?: string;
         "onDsDestinationChange"?: (event: DsMobileBarNavCustomEvent<MobileBarNavDestinationDetail>) => void;
         "onDsSheetNavToggle"?: (event: DsMobileBarNavCustomEvent<boolean>) => void;
+        /**
+          * Context destination retained while a different global tool is active.
+          * @default 'area'
+         */
+        "primaryDestination"?: 'area' | 'help';
         /**
           * @default false
          */
@@ -7277,6 +7558,11 @@ declare namespace LocalJSX {
           * @default 'Change page subsection'
          */
         "subsectionsAriaLabel"?: string;
+        /**
+          * Place local sections below, beside, or combined with the page title in one sheet trigger.
+          * @default 'below'
+         */
+        "subsectionsPlacement"?: 'below' | 'inline' | 'combined';
         /**
           * Controlled selected child-section id.
           * @default ''
@@ -7303,6 +7589,16 @@ declare namespace LocalJSX {
           * Selection intent. The route, tool, or workflow owner updates `value`.
          */
         "onDsChange"?: (event: DsMobileSectionSwitcherCustomEvent<string>) => void;
+        /**
+          * Stable page identity shown before the selected section in a sheet trigger.
+          * @default ''
+         */
+        "pageLabel"?: string;
+        /**
+          * Anchored local-view menu or viewport-edge sheet for primary page sections.
+          * @default 'menu'
+         */
+        "presentation"?: 'menu' | 'sheet';
         /**
           * Ordered controlled sections. Divider entries group the popup menu.
           * @default []
@@ -7346,10 +7642,19 @@ declare namespace LocalJSX {
         "onDsAreaSelect"?: (event: DsMobileSheetNavCustomEvent<string>) => void;
         "onDsBrowseContextChange"?: (event: DsMobileSheetNavCustomEvent<NavChromeStyle>) => void;
         "onDsClose"?: (event: DsMobileSheetNavCustomEvent<void>) => void;
+        /**
+          * Selecting a child requests routing; expanding its parent never navigates.
+         */
+        "onDsNavChildSelect"?: (event: DsMobileSheetNavCustomEvent<PanelNavChildSelectDetail>) => void;
         /**
           * @default false
          */
         "open"?: boolean;
+        /**
+          * Flat area navigation or inline disclosure of each area's child routes.
+          * @default 'flat'
+         */
+        "presentation"?: PanelNavPresentation;
         /**
           * Whether the router-derived current area owns the active mobile stage.
           * @default true
@@ -7491,10 +7796,14 @@ declare namespace LocalJSX {
          */
         "accountLabel"?: string;
         /**
-          * Keep the account-menu trigger visually pressed while its popup is open or closing.
+          * Account disclosure state. Expanded-derived styling is deprecated; use accountMenuSurfaceOpen for the rendered lifetime.
           * @default false
          */
         "accountMenuExpanded"?: boolean;
+        /**
+          * External account surface is visible, including exit motion. Omission preserves the deprecated accountMenuExpanded-derived wash.
+         */
+        "accountMenuSurfaceOpen"?: boolean | undefined;
         /**
           * ID of the active child route when URL matching is unavailable.
           * @default ''
@@ -7672,6 +7981,10 @@ declare namespace LocalJSX {
           * @default false
          */
         "menuExpanded"?: boolean;
+        /**
+          * Associated menu surface is visible, including exit motion.
+         */
+        "menuSurfaceOpen"?: boolean | undefined;
         /**
           * Stable id placed on the menu trigger host for ds-menu anchoring.
           * @default ''
@@ -7720,6 +8033,10 @@ declare namespace LocalJSX {
           * @default false
          */
         "filterExpanded"?: boolean;
+        /**
+          * Associated filter surface is visible, including exit motion.
+         */
+        "filterSurfaceOpen"?: boolean | undefined;
         /**
           * Stable id placed on the filter trigger for ds-menu anchoring.
           * @default ''
@@ -8257,7 +8574,7 @@ declare namespace LocalJSX {
          */
         "paperTexture"?: PaperTextureConfig;
         /**
-          * Desktop/tablet route sections in BarNav, or nested beneath PanelNav parents.
+          * Route sections in bar/header pickers, or nested beneath desktop and mobile menu parents.
           * @default 'bar'
          */
         "sectionNavigation"?: ShellSectionNavigation;
@@ -8925,6 +9242,10 @@ declare namespace LocalJSX {
           * @default false
          */
         "stickyHeader"?: boolean;
+        /**
+          * Identity of the interactive row whose associated surface is visible. Holds its pressed wash independently of checkbox selection. Keep the ID through exit motion and clear it after close; the application owns toggling and switching the surface. Off-window identities survive virtualization.
+         */
+        "surfaceOpenRowId"?: string | undefined;
         "totalCount"?: number | undefined;
         /**
           * Reserved space below a viewport-fitted table.
@@ -9262,6 +9583,10 @@ declare namespace LocalJSX {
           * @default 'md'
          */
         "size"?: TagSize;
+        /**
+          * Associated menu remains visible, including exit motion. Omission preserves the deprecated expanded-derived wash; explicit false suppresses it.
+         */
+        "surfaceOpen"?: boolean | undefined;
     }
     interface DsText {
         "align"?: TextAlign | undefined;
@@ -9689,6 +10014,7 @@ declare namespace LocalJSX {
         "ariaLabel": string | null;
         "controls": string | undefined;
         "expanded": boolean | undefined;
+        "surfaceOpen": boolean | undefined;
         "haspopup": ButtonFilledPopup | undefined;
         "split": boolean;
         "menuAriaLabel": string;
@@ -9716,6 +10042,7 @@ declare namespace LocalJSX {
         "ariaLabel": string | null;
         "controls": string | undefined;
         "expanded": boolean | undefined;
+        "surfaceOpen": boolean | undefined;
         "haspopup": ButtonUnfilledPopup | undefined;
         "split": boolean;
         "menuAriaLabel": string;
@@ -9731,6 +10058,13 @@ declare namespace LocalJSX {
         "showFilter": boolean;
         "filterLabel": string;
     }
+    interface DsCardNavigationAttributes {
+        "href": string;
+        "heading": string;
+        "description": string | undefined;
+        "variant": CardNavigationVariant;
+        "cardWidth": CardNavigationWidth;
+    }
     interface DsCardOverviewAttributes {
         "variant": CardOverviewVariant;
         "layout": CardOverviewLayout;
@@ -9750,6 +10084,18 @@ declare namespace LocalJSX {
         "cancelLabel": string;
         "saveLabel": string;
     }
+    interface DsCardSettingsScopeAttributes {
+        "areaLabel": string;
+        "profileLabel": string;
+        "managingLabel": string;
+        "forLabel": string;
+        "scopeLabel": string;
+        "areaControls": string | undefined;
+        "profileControls": string | undefined;
+        "areaExpanded": boolean;
+        "profileExpanded": boolean;
+        "profilePopup": 'menu' | 'dialog';
+    }
     interface DsChartAttributes {
         "label": string;
         "description": string;
@@ -9923,6 +10269,7 @@ declare namespace LocalJSX {
         "anchorId": string | undefined;
         "initialFocusVisible": boolean;
         "menuLabel": string;
+        "emptyMessage": string;
     }
     interface DsMessageAttributes {
         "messageId": string;
@@ -9961,6 +10308,7 @@ declare namespace LocalJSX {
     }
     interface DsMobileBarNavAttributes {
         "activeDestination": MobileDestination;
+        "primaryDestination": 'area' | 'help';
         "sheetNavExpanded": boolean;
         "menuLabel": string;
         "searchLabel": string;
@@ -9985,16 +10333,20 @@ declare namespace LocalJSX {
         "sectionsSize": TabGroupSize;
         "subvalue": string;
         "subsectionsAriaLabel": string;
+        "subsectionsPlacement": 'below' | 'inline' | 'combined';
         "tone": MobileHeaderTone;
     }
     interface DsMobileSectionSwitcherAttributes {
         "value": string;
         "navigationLabel": string;
+        "presentation": 'menu' | 'sheet';
+        "pageLabel": string;
     }
     interface DsMobileSheetNavAttributes {
         "open": boolean;
         "browseContext": NavChromeStyle;
         "currentUrl": string;
+        "presentation": PanelNavPresentation;
         "routeSelectionActive": boolean;
         "navigationLabel": string;
         "dashboardLabel": string;
@@ -10046,6 +10398,7 @@ declare namespace LocalJSX {
         "settingsLabel": string;
         "accountLabel": string;
         "accountMenuExpanded": boolean;
+        "accountMenuSurfaceOpen": boolean | undefined;
         "dashboardNavigationLabel": string;
         "settingsNavigationLabel": string;
         "expandNavigationLabel": string;
@@ -10068,6 +10421,7 @@ declare namespace LocalJSX {
         "menuTriggerId": string;
         "menuControls": string | undefined;
         "menuExpanded": boolean;
+        "menuSurfaceOpen": boolean | undefined;
     }
     interface DsPanelToolSearchAttributes {
         "value": string;
@@ -10080,6 +10434,7 @@ declare namespace LocalJSX {
         "filterTriggerId": string;
         "filterControls": string | undefined;
         "filterExpanded": boolean;
+        "filterSurfaceOpen": boolean | undefined;
         "filterActive": boolean;
     }
     interface DsPanelToolsAttributes {
@@ -10266,6 +10621,7 @@ declare namespace LocalJSX {
         "viewportInsetBlockEnd": string;
         "scrollLabel": string | undefined;
         "selectionMode": TableSelectionMode;
+        "surfaceOpenRowId": string | undefined;
         "loading": boolean;
         "chromeLoading": boolean;
         "skeletonRows": number;
@@ -10352,6 +10708,7 @@ declare namespace LocalJSX {
         "maxWidth": string;
         "interactive": boolean;
         "expanded": boolean;
+        "surfaceOpen": boolean | undefined;
         "ariaControls": string | undefined;
         "isInactive": boolean;
     }
@@ -10449,8 +10806,10 @@ declare namespace LocalJSX {
         "ds-button-filled": Omit<DsButtonFilled, keyof DsButtonFilledAttributes> & { [K in keyof DsButtonFilled & keyof DsButtonFilledAttributes]?: DsButtonFilled[K] } & { [K in keyof DsButtonFilled & keyof DsButtonFilledAttributes as `attr:${K}`]?: DsButtonFilledAttributes[K] } & { [K in keyof DsButtonFilled & keyof DsButtonFilledAttributes as `prop:${K}`]?: DsButtonFilled[K] };
         "ds-button-unfilled": Omit<DsButtonUnfilled, keyof DsButtonUnfilledAttributes> & { [K in keyof DsButtonUnfilled & keyof DsButtonUnfilledAttributes]?: DsButtonUnfilled[K] } & { [K in keyof DsButtonUnfilled & keyof DsButtonUnfilledAttributes as `attr:${K}`]?: DsButtonUnfilledAttributes[K] } & { [K in keyof DsButtonUnfilled & keyof DsButtonUnfilledAttributes as `prop:${K}`]?: DsButtonUnfilled[K] };
         "ds-card-chart": Omit<DsCardChart, keyof DsCardChartAttributes> & { [K in keyof DsCardChart & keyof DsCardChartAttributes]?: DsCardChart[K] } & { [K in keyof DsCardChart & keyof DsCardChartAttributes as `attr:${K}`]?: DsCardChartAttributes[K] } & { [K in keyof DsCardChart & keyof DsCardChartAttributes as `prop:${K}`]?: DsCardChart[K] } & OneOf<"heading", DsCardChart["heading"], DsCardChartAttributes["heading"]>;
+        "ds-card-navigation": Omit<DsCardNavigation, keyof DsCardNavigationAttributes> & { [K in keyof DsCardNavigation & keyof DsCardNavigationAttributes]?: DsCardNavigation[K] } & { [K in keyof DsCardNavigation & keyof DsCardNavigationAttributes as `attr:${K}`]?: DsCardNavigationAttributes[K] } & { [K in keyof DsCardNavigation & keyof DsCardNavigationAttributes as `prop:${K}`]?: DsCardNavigation[K] } & OneOf<"href", DsCardNavigation["href"], DsCardNavigationAttributes["href"]> & OneOf<"heading", DsCardNavigation["heading"], DsCardNavigationAttributes["heading"]>;
         "ds-card-overview": Omit<DsCardOverview, keyof DsCardOverviewAttributes> & { [K in keyof DsCardOverview & keyof DsCardOverviewAttributes]?: DsCardOverview[K] } & { [K in keyof DsCardOverview & keyof DsCardOverviewAttributes as `attr:${K}`]?: DsCardOverviewAttributes[K] } & { [K in keyof DsCardOverview & keyof DsCardOverviewAttributes as `prop:${K}`]?: DsCardOverview[K] };
         "ds-card-setting": Omit<DsCardSetting, keyof DsCardSettingAttributes> & { [K in keyof DsCardSetting & keyof DsCardSettingAttributes]?: DsCardSetting[K] } & { [K in keyof DsCardSetting & keyof DsCardSettingAttributes as `attr:${K}`]?: DsCardSettingAttributes[K] } & { [K in keyof DsCardSetting & keyof DsCardSettingAttributes as `prop:${K}`]?: DsCardSetting[K] } & OneOf<"heading", DsCardSetting["heading"], DsCardSettingAttributes["heading"]>;
+        "ds-card-settings-scope": Omit<DsCardSettingsScope, keyof DsCardSettingsScopeAttributes> & { [K in keyof DsCardSettingsScope & keyof DsCardSettingsScopeAttributes]?: DsCardSettingsScope[K] } & { [K in keyof DsCardSettingsScope & keyof DsCardSettingsScopeAttributes as `attr:${K}`]?: DsCardSettingsScopeAttributes[K] } & { [K in keyof DsCardSettingsScope & keyof DsCardSettingsScopeAttributes as `prop:${K}`]?: DsCardSettingsScope[K] };
         "ds-chart": Omit<DsChart, keyof DsChartAttributes> & { [K in keyof DsChart & keyof DsChartAttributes]?: DsChart[K] } & { [K in keyof DsChart & keyof DsChartAttributes as `attr:${K}`]?: DsChartAttributes[K] } & { [K in keyof DsChart & keyof DsChartAttributes as `prop:${K}`]?: DsChart[K] } & OneOf<"label", DsChart["label"], DsChartAttributes["label"]>;
         "ds-chart-legend": Omit<DsChartLegend, keyof DsChartLegendAttributes> & { [K in keyof DsChartLegend & keyof DsChartLegendAttributes]?: DsChartLegend[K] } & { [K in keyof DsChartLegend & keyof DsChartLegendAttributes as `attr:${K}`]?: DsChartLegendAttributes[K] } & { [K in keyof DsChartLegend & keyof DsChartLegendAttributes as `prop:${K}`]?: DsChartLegend[K] };
         "ds-checkbox": Omit<DsCheckbox, keyof DsCheckboxAttributes> & { [K in keyof DsCheckbox & keyof DsCheckboxAttributes]?: DsCheckbox[K] } & { [K in keyof DsCheckbox & keyof DsCheckboxAttributes as `attr:${K}`]?: DsCheckboxAttributes[K] } & { [K in keyof DsCheckbox & keyof DsCheckboxAttributes as `prop:${K}`]?: DsCheckbox[K] } & OneOf<"label", DsCheckbox["label"], DsCheckboxAttributes["label"]>;
@@ -10538,8 +10897,10 @@ declare module "@stencil/core" {
              * only the chart/legend relationship; applications continue to own data.
              */
             "ds-card-chart": LocalJSX.IntrinsicElements["ds-card-chart"] & JSXBase.HTMLAttributes<HTMLDsCardChartElement>;
+            "ds-card-navigation": LocalJSX.IntrinsicElements["ds-card-navigation"] & JSXBase.HTMLAttributes<HTMLDsCardNavigationElement>;
             "ds-card-overview": LocalJSX.IntrinsicElements["ds-card-overview"] & JSXBase.HTMLAttributes<HTMLDsCardOverviewElement>;
             "ds-card-setting": LocalJSX.IntrinsicElements["ds-card-setting"] & JSXBase.HTMLAttributes<HTMLDsCardSettingElement>;
+            "ds-card-settings-scope": LocalJSX.IntrinsicElements["ds-card-settings-scope"] & JSXBase.HTMLAttributes<HTMLDsCardSettingsScopeElement>;
             "ds-chart": LocalJSX.IntrinsicElements["ds-chart"] & JSXBase.HTMLAttributes<HTMLDsChartElement>;
             /**
              * Base legend for `ds-chart-*` components. Webapp's Overview widgets each style