@ds-mo/ui 12.9.0 → 13.1.0

package/dist/react/components.js

@@ -16,13 +16,9 @@ export { DsBarWorkflow } from "./ds-bar-workflow.js";
 export { DsBreadcrumb } from "./ds-breadcrumb.js";
 export { DsButtonFilled } from "./ds-button-filled.js";
 export { DsButtonUnfilled } from "./ds-button-unfilled.js";
-export { DsCardDataVizBar } from "./ds-card-data-viz-bar.js";
-export { DsCardDataVizDonut } from "./ds-card-data-viz-donut.js";
-export { DsCardDataVizLine } from "./ds-card-data-viz-line.js";
+export { DsCardDataViz } from "./ds-card-data-viz.js";
 export { DsCardOverview } from "./ds-card-overview.js";
 export { DsCardSetting } from "./ds-card-setting.js";
-export { DsCardShellDataViz } from "./ds-card-shell-data-viz.js";
-export { DsChartBarStacked } from "./ds-chart-bar-stacked.js";
 export { DsChartBar } from "./ds-chart-bar.js";
 export { DsChartDonut } from "./ds-chart-donut.js";
 export { DsChartLegend } from "./ds-chart-legend.js";
@@ -57,11 +53,8 @@ export { DsPanelToolSearch } from "./ds-panel-tool-search.js";
 export { DsPanelTools } from "./ds-panel-tools.js";
 export { DsRadio } from "./ds-radio.js";
 export { DsScrollOverlay } from "./ds-scroll-overlay.js";
-export { DsSelectMulti } from "./ds-select-multi.js";
 export { DsSelect } from "./ds-select.js";
 export { DsShellApp } from "./ds-shell-app.js";
-export { DsShellGradientPicker } from "./ds-shell-gradient-picker.js";
-export { DsShellGradientSwatch } from "./ds-shell-gradient-swatch.js";
 export { DsShellPage } from "./ds-shell-page.js";
 export { DsShellTools } from "./ds-shell-tools.js";
 export { DsSkeleton } from "./ds-skeleton.js";

package/dist/react/ds-card-data-viz.d.ts

@@ -0,0 +1,12 @@
+/**
+ * This file was automatically generated by the Stencil React Output Target.
+ * Changes to this file may cause incorrect behavior and will be lost if the code is regenerated.
+ */
+import type { EventName, StencilReactComponent } from '@stencil/react-output-target/runtime';
+import { type DsCardDataVizCustomEvent } from "@ds-mo/ui";
+import type { Components } from "@ds-mo/ui/dist/components";
+import { DsCardDataViz as DsCardDataVizElement } from "@ds-mo/ui/dist/components/ds-card-data-viz.js";
+export type DsCardDataVizEvents = {
+    onDsFilterClick: EventName<DsCardDataVizCustomEvent<void>>;
+};
+export declare const DsCardDataViz: StencilReactComponent<DsCardDataVizElement, DsCardDataVizEvents, Components.DsCardDataViz, 'heading'>;

package/dist/react/ds-card-data-viz.js

@@ -0,0 +1,12 @@
+'use client';
+import { createComponent } from '@stencil/react-output-target/runtime';
+import React from 'react';
+import { DsCardDataViz as DsCardDataVizElement, defineCustomElement as defineDsCardDataViz } from "@ds-mo/ui/dist/components/ds-card-data-viz.js";
+export const DsCardDataViz = /*@__PURE__*/ createComponent({
+    tagName: 'ds-card-data-viz',
+    elementClass: DsCardDataVizElement,
+    // @ts-ignore - ignore potential React type mismatches between the Stencil Output Target and your project.
+    react: React,
+    events: { onDsFilterClick: 'dsFilterClick' },
+    defineCustomElement: defineDsCardDataViz
+});

package/dist/react/ds-menu.d.ts

@@ -3,14 +3,13 @@
  * Changes to this file may cause incorrect behavior and will be lost if the code is regenerated.
  */
 import type { EventName, StencilReactComponent } from '@stencil/react-output-target/runtime';
-import { type DsMenuCustomEvent, type MenuItemData, type ShellGradientPreset } from "@ds-mo/ui";
+import { type DsMenuCustomEvent, type MenuItemData } from "@ds-mo/ui";
 import type { Components } from "@ds-mo/ui/dist/components";
 import { DsMenu as DsMenuElement } from "@ds-mo/ui/dist/components/ds-menu.js";
 export type DsMenuEvents = {
     onDsClose: EventName<DsMenuCustomEvent<void>>;
     onDsAfterClose: EventName<DsMenuCustomEvent<void>>;
     onDsSelect: EventName<DsMenuCustomEvent<MenuItemData>>;
-    onDsGradientSelect: EventName<DsMenuCustomEvent<ShellGradientPreset>>;
     onDsSwatchSelect: EventName<DsMenuCustomEvent<string>>;
 };
 export declare const DsMenu: StencilReactComponent<DsMenuElement, DsMenuEvents, Components.DsMenu>;

package/dist/react/ds-menu.js

@@ -11,7 +11,6 @@ export const DsMenu = /*@__PURE__*/ createComponent({
         onDsClose: 'dsClose',
         onDsAfterClose: 'dsAfterClose',
         onDsSelect: 'dsSelect',
-        onDsGradientSelect: 'dsGradientSelect',
         onDsSwatchSelect: 'dsSwatchSelect'
     },
     defineCustomElement: defineDsMenu

package/dist/react/ds-select.d.ts

@@ -3,11 +3,11 @@
  * Changes to this file may cause incorrect behavior and will be lost if the code is regenerated.
  */
 import type { EventName, StencilReactComponent } from '@stencil/react-output-target/runtime';
-import { type DsSelectCustomEvent } from "@ds-mo/ui";
+import { type DsSelectCustomEvent, type SelectValue } from "@ds-mo/ui";
 import type { Components } from "@ds-mo/ui/dist/components";
 import { DsSelect as DsSelectElement } from "@ds-mo/ui/dist/components/ds-select.js";
 export type DsSelectEvents = {
-    onDsChange: EventName<DsSelectCustomEvent<string>>;
+    onDsChange: EventName<DsSelectCustomEvent<SelectValue>>;
     onDsClear: EventName<DsSelectCustomEvent<void>>;
     onDsOpenChange: EventName<DsSelectCustomEvent<boolean>>;
 };

package/dist/react/ds-shell-app.d.ts

@@ -3,12 +3,35 @@
  * Changes to this file may cause incorrect behavior and will be lost if the code is regenerated.
  */
 import type { EventName, StencilReactComponent } from '@stencil/react-output-target/runtime';
-import { type DsShellAppCustomEvent, type ShellResponsiveMode } from "@ds-mo/ui";
+import { type BreadcrumbSelectDetail, type DsShellAppCustomEvent, type NavChromeStyle, type PanelNavUserActionDetail, type PanelToolsToolId, type ShellResponsiveMode } from "@ds-mo/ui";
 import type { Components } from "@ds-mo/ui/dist/components";
 import { DsShellApp as DsShellAppElement } from "@ds-mo/ui/dist/components/ds-shell-app.js";
 export type DsShellAppEvents = {
     onDsResponsiveModeChange: EventName<DsShellAppCustomEvent<{
         mode: ShellResponsiveMode;
     }>>;
+    onDsNavSelect: EventName<DsShellAppCustomEvent<string>>;
+    onDsTabChange: EventName<DsShellAppCustomEvent<string>>;
+    onDsSubsectionChange: EventName<DsShellAppCustomEvent<string>>;
+    onDsPageBack: EventName<DsShellAppCustomEvent<MouseEvent>>;
+    onDsBreadcrumbSelect: EventName<DsShellAppCustomEvent<BreadcrumbSelectDetail>>;
+    onDsPageAction: EventName<DsShellAppCustomEvent<string>>;
+    onDsToolChange: EventName<DsShellAppCustomEvent<{
+        id: PanelToolsToolId;
+        selected: boolean;
+    }>>;
+    onDsHeaderBack: EventName<DsShellAppCustomEvent<{
+        tool: PanelToolsToolId;
+    }>>;
+    onDsHeaderAction: EventName<DsShellAppCustomEvent<{
+        tool: PanelToolsToolId;
+        id: string;
+    }>>;
+    onDsPresentationChange: EventName<DsShellAppCustomEvent<{
+        presentation: 'drawer' | 'fullscreen';
+    }>>;
+    onDsBrowseContextChange: EventName<DsShellAppCustomEvent<NavChromeStyle>>;
+    onDsNavFooterAction: EventName<DsShellAppCustomEvent<void>>;
+    onDsNavUserAction: EventName<DsShellAppCustomEvent<PanelNavUserActionDetail>>;
 };
 export declare const DsShellApp: StencilReactComponent<DsShellAppElement, DsShellAppEvents, Components.DsShellApp>;

package/dist/react/ds-shell-app.js

@@ -7,6 +7,21 @@ export const DsShellApp = /*@__PURE__*/ createComponent({
     elementClass: DsShellAppElement,
     // @ts-ignore - ignore potential React type mismatches between the Stencil Output Target and your project.
     react: React,
-    events: { onDsResponsiveModeChange: 'dsResponsiveModeChange' },
+    events: {
+        onDsResponsiveModeChange: 'dsResponsiveModeChange',
+        onDsNavSelect: 'dsNavSelect',
+        onDsTabChange: 'dsTabChange',
+        onDsSubsectionChange: 'dsSubsectionChange',
+        onDsPageBack: 'dsPageBack',
+        onDsBreadcrumbSelect: 'dsBreadcrumbSelect',
+        onDsPageAction: 'dsPageAction',
+        onDsToolChange: 'dsToolChange',
+        onDsHeaderBack: 'dsHeaderBack',
+        onDsHeaderAction: 'dsHeaderAction',
+        onDsPresentationChange: 'dsPresentationChange',
+        onDsBrowseContextChange: 'dsBrowseContextChange',
+        onDsNavFooterAction: 'dsNavFooterAction',
+        onDsNavUserAction: 'dsNavUserAction'
+    },
     defineCustomElement: defineDsShellApp
 });

package/dist/types/components/AgentSourceList/AgentSourceList.d.ts

@@ -3,7 +3,6 @@ export declare class AgentSourceList {
     items: AgentSource[];
     heading: string;
     open: boolean;
-    private safeUrl;
     render(): any;
 }
 //# sourceMappingURL=AgentSourceList.d.ts.map

package/dist/types/components/BarNav/BarNav.d.ts

@@ -10,8 +10,6 @@ export declare class BarNav {
      * Set via JS property: `el.tabs = [...]`. Replace the array reference to update.
      */
     tabs: BarNavTab[];
-    /** JSON fallback for `tabs` — useful when framework bindings don't propagate arrays. */
-    tabsJson: string;
     /** ID of the currently active tab. Overridden when `currentUrl` + `basePath` are set. */
     value: string;
     /**

package/dist/types/components/BarNav/bar-nav-utils.d.ts

@@ -8,8 +8,6 @@ export interface BarNavUrlState {
 /** Derive BarNav tab selection from `currentUrl` relative to `basePath`.
  *  Mirrors motive-webapp-lab `resolveBarNavState` tab-selection semantics. */
 export declare function deriveBarNavValueFromUrl(path: string, basePath: string, tabs: BarNavTab[]): BarNavUrlState;
-/** True when host array/json props have data but resolved internal state is still empty. */
-export declare function shouldResyncBarNavProps(resolvedTabs: BarNavTab[], tabs: BarNavTab[], tabsJson: string): boolean;
-/** Parse tabs from either a JSON attribute string or a JS property array. */
-export declare function parseJsonArrayProp<T>(value: string | T[] | undefined, fallback: T[]): T[];
+/** True when host array props have data but resolved internal state is still empty. */
+export declare function shouldResyncBarNavProps(resolvedTabs: BarNavTab[], tabs: BarNavTab[]): boolean;
 //# sourceMappingURL=bar-nav-utils.d.ts.map

package/dist/types/components/ButtonFilled/ButtonFilled.d.ts

@@ -1,13 +1,13 @@
 import { EventEmitter } from '../../stencil-public-runtime';
-import { type ControlWidth } from '../../utils';
 import type { ChoiceBackground } from '../../utils/choice-list';
+import type { ButtonPopup, ButtonSize, ButtonVariant, ButtonWidth } from '../../utils/button-types';
 export type ButtonFilledIntent = 'neutral' | 'brand' | 'ai' | 'negative' | 'warning' | 'caution' | 'positive' | 'guide' | 'walkthrough';
 export type ButtonFilledContrast = 'bold' | 'strong' | 'medium' | 'faint';
 export type ButtonFilledBackground = ChoiceBackground;
-export type ButtonFilledVariant = 'icon' | 'label' | 'icon-label';
-export type ButtonFilledSize = 'lg' | 'md' | 'sm' | 'xs';
-export type ButtonFilledWidth = ControlWidth;
-export type ButtonFilledPopup = 'true' | 'menu' | 'listbox' | 'tree' | 'grid' | 'dialog';
+export type ButtonFilledVariant = ButtonVariant;
+export type ButtonFilledSize = ButtonSize;
+export type ButtonFilledWidth = ButtonWidth;
+export type ButtonFilledPopup = ButtonPopup;
 export declare class ButtonFilled {
     el: HTMLElement;
     /**
@@ -62,8 +62,6 @@ export declare class ButtonFilled {
     expanded: boolean | undefined;
     /** Popup type exposed to assistive technology. */
     haspopup: ButtonFilledPopup | undefined;
-    /** Pressed semantics for a toggle command that reports state elsewhere. */
-    pressed: boolean | undefined;
     /**
      * This action *has* a menu: implies `aria-haspopup="menu"` and adds the trailing
      * chevron that carries the affordance.
@@ -79,10 +77,6 @@ export declare class ButtonFilled {
     private buttonEl;
     setFocus(): Promise<void>;
     private handleClick;
-    private get showIcon();
-    private get showLabel();
-    /** Icon-only triggers rely on their own glyph, so the chevron is label-bound. */
-    private get showChevron();
     private get resolvedHaspopup();
     private get accessibleName();
     render(): any;

package/dist/types/components/ButtonUnfilled/ButtonUnfilled.d.ts

@@ -1,10 +1,10 @@
 import { EventEmitter } from '../../stencil-public-runtime';
-import { type ControlWidth } from '../../utils';
+import type { ButtonPopup, ButtonSize, ButtonVariant, ButtonWidth } from '../../utils/button-types';
 export type ButtonUnfilledBackground = 'faint' | 'medium' | 'bold' | 'strong' | 'translucent' | 'inverted' | 'media' | 'always-dark';
-export type ButtonUnfilledVariant = 'icon' | 'label' | 'icon-label';
-export type ButtonUnfilledSize = 'lg' | 'md' | 'sm' | 'xs';
-export type ButtonUnfilledWidth = ControlWidth;
-export type ButtonUnfilledPopup = 'true' | 'menu' | 'listbox' | 'tree' | 'grid' | 'dialog';
+export type ButtonUnfilledVariant = ButtonVariant;
+export type ButtonUnfilledSize = ButtonSize;
+export type ButtonUnfilledWidth = ButtonWidth;
+export type ButtonUnfilledPopup = ButtonPopup;
 export declare class ButtonUnfilled {
     el: HTMLElement;
     /**
@@ -20,7 +20,10 @@ export declare class ButtonUnfilled {
     label: string;
     /** Icon name passed to <ds-icon> for `icon` / `icon-label` variants. */
     icon: string;
-    /** Active/selected visual state. Always promotes foreground to primary. */
+    /**
+     * Owner-controlled visual emphasis inside a composite. This does not add
+     * toggle semantics and does not emit dsChange.
+     */
     isActive: boolean;
     /**
      * When active, render the selected interaction fill.
@@ -52,6 +55,10 @@ export declare class ButtonUnfilled {
     controls: string | undefined;
     expanded: boolean | undefined;
     haspopup: ButtonUnfilledPopup | undefined;
+    /**
+     * Controlled state for a genuine toggle button. Adds aria-pressed, promotes
+     * active styling, and makes activation emit dsChange with the requested state.
+     */
     pressed: boolean | undefined;
     /**
      * Mark the button as a Menu trigger. Implies `aria-haspopup="menu"` and covers
@@ -75,11 +82,7 @@ export declare class ButtonUnfilled {
     private buttonEl;
     setFocus(): Promise<void>;
     private handleClick;
-    private get showIcon();
-    private get showLabel();
     private get showDot();
-    /** Icon-only triggers rely on their own glyph, so the chevron is label-bound. */
-    private get showChevron();
     private get resolvedHaspopup();
     /** An expanded popup trigger is visually active even when selection is controlled separately. */
     private get visuallyActive();

package/dist/types/components/CardDataViz/CardDataViz.d.ts

@@ -0,0 +1,32 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+export type CardDataVizWidth = 'sm' | 'md' | 'lg';
+export type CardDataVizVariant = 'custom' | 'bar' | 'line' | 'donut';
+/**
+ * Standard data-visualization card chrome and composition. The variant owns
+ * only the chart/legend relationship; applications continue to own data.
+ */
+export declare class CardDataViz {
+    el: HTMLElement;
+    /** Data-visualization heading shown in the card header. */
+    heading: string;
+    /** Chart composition behavior. */
+    variant: CardDataVizVariant;
+    /** Width token with the matching data-visualization card min-height. */
+    cardWidth: CardDataVizWidth;
+    /** Renders the standard filter action before custom actions. */
+    showFilter: boolean;
+    filterLabel: string;
+    /** Emits when the standard header filter control is activated. */
+    dsFilterClick: EventEmitter<void>;
+    private hasChartSlot;
+    private hasLegendSlot;
+    componentWillRender(): void;
+    componentDidLoad(): void;
+    componentDidRender(): void;
+    disconnectedCallback(): void;
+    private handleChartHover;
+    private handleLegendHover;
+    private handleFilterClick;
+    render(): any;
+}
+//# sourceMappingURL=CardDataViz.d.ts.map

package/dist/types/components/CardDataViz/index.d.ts

@@ -0,0 +1,2 @@
+export type { CardDataVizVariant, CardDataVizWidth } from './CardDataViz';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/components/CardOverview/CardOverview.d.ts

@@ -25,12 +25,29 @@ export declare class CardOverview {
     scoreErrorMessage: string | undefined;
     /** Accessible name for the region. */
     overviewLabel: string;
+    /**
+     * Page-controlled visual collapse from the full card (`0`) toward its 48px
+     * compact handoff height (`1`). The component preserves its expanded flow
+     * height, keeps elevation on the shrinking surface, and clips translated
+     * content internally. The page still owns sticky positioning and the final
+     * swap to `variant="compact"`.
+     */
+    scrollCollapseProgress: number;
     /** Emitted when a metric that is not inactive is activated. */
     dsMetricSelect: EventEmitter<OverviewMetric>;
     /** Roving tab stop across selectable metrics. */
     private focusedMetricIndex;
+    private expandedHeight;
+    private layoutEl?;
+    private layoutResizeObserver;
+    componentDidLoad(): void;
+    componentDidRender(): void;
+    disconnectedCallback(): void;
     private get hasScore();
     private get visibleMetrics();
+    private get resolvedScrollCollapseProgress();
+    private get scrollCollapseGeometry();
+    private observeLayout;
     /** Index of the roving tab stop, skipping inactive metrics. */
     private get rovingIndex();
     private selectMetric;

package/dist/types/components/CardOverview/card-overview-controller.d.ts

@@ -0,0 +1,16 @@
+import type { CardOverviewVariant, OverviewMetric } from './card-overview-types';
+export interface CardOverviewCollapseGeometry {
+    active: boolean;
+    expandedHeight: number;
+    offset: number;
+    visibleHeight: number;
+}
+export declare function resolveCardOverviewCollapseGeometry(options: {
+    variant: CardOverviewVariant;
+    progress: number;
+    expandedHeight: number;
+    compactHeight: number;
+}): CardOverviewCollapseGeometry;
+export declare function resolveOverviewRovingIndex(metrics: readonly OverviewMetric[], focusedIndex: number): number;
+export declare function findNextOverviewMetricIndex(metrics: readonly OverviewMetric[], from: number, step: -1 | 1): number;
+//# sourceMappingURL=card-overview-controller.d.ts.map

package/dist/types/components/ChartBar/ChartBar.d.ts

@@ -1,7 +1,14 @@
-import type { ChartDatum } from '../../utils/chart-types';
+import type { ChartDatum, ChartSeries } from '../../utils/chart-types';
+export type ChartBarVariant = 'single' | 'stacked' | 'percentage';
 export declare class ChartBar {
+    /** Rendering model. Single uses `data`; stacked and percentage use `series` and `categories`. */
+    variant: ChartBarVariant;
     /** Bars to render. Set as a JS property (not an HTML attribute). */
     data: ChartDatum[];
+    /** Ordered stack series for stacked and percentage variants. Set as a JS property. */
+    series: ChartSeries[];
+    /** X-axis labels for stacked and percentage variants. Set as a JS property. */
+    categories: string[];
     /** Standalone intrinsic width. Container constraints reflow the plot at rendered pixel size. */
     width: number;
     /** Standalone intrinsic height. Container constraints reflow the plot at rendered pixel size. */
@@ -15,6 +22,10 @@ export declare class ChartBar {
     private connectViewportController;
     disconnectedCallback(): void;
     handleIntrinsicSizeChange(): void;
+    private renderSingle;
+    private valuesForCategory;
+    private stackedAccessibleLabel;
+    private renderStacked;
     render(): any;
 }
 //# sourceMappingURL=ChartBar.d.ts.map

package/dist/types/components/ChartBar/index.d.ts

@@ -1,2 +1,3 @@
-export type { ChartDatum } from '../../utils/chart-types';
+export type { ChartDatum, ChartSeries } from '../../utils/chart-types';
+export type { ChartBarVariant } from './ChartBar';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/components/Menu/Menu.d.ts

@@ -4,7 +4,6 @@ import type { MenuAlign, MenuSide } from './menu-position';
 import type { MenuItemData, MenuSection } from './menu-types';
 export type MenuSelectionMode = 'none' | 'single';
 export type MenuSize = ControlSize;
-import { type ShellGradientPreset } from '../../shell/shell-gradient-presets';
 export declare class Menu {
     el: HTMLElement;
     open: boolean;
@@ -43,8 +42,6 @@ export declare class Menu {
     /** Emitted after the popup's exit motion is complete and its rendered content is removed. */
     dsAfterClose: EventEmitter<void>;
     dsSelect: EventEmitter<MenuItemData>;
-    /** Emitted when a `gradient-picker` section swatch is chosen. */
-    dsGradientSelect: EventEmitter<ShellGradientPreset>;
     /** Emitted when a generic `swatch-picker` section option is chosen. */
     dsSwatchSelect: EventEmitter<string>;
     private clickOutsideHandler;
@@ -96,7 +93,6 @@ export declare class Menu {
     handleKeyDown(e: KeyboardEvent): void;
     private focusItem;
     private handleItemClick;
-    private handleGradientSelect;
     private handleSwatchSelect;
     render(): any;
 }

package/dist/types/components/Menu/menu-sections.d.ts

@@ -0,0 +1,4 @@
+import type { MenuSection } from './menu-types';
+/** Preserve the exact menu context painted during exit motion. */
+export declare function snapshotMenuSections(sections: readonly MenuSection[]): MenuSection[];
+//# sourceMappingURL=menu-sections.d.ts.map

package/dist/types/components/Menu/menu-types.d.ts

@@ -1,4 +1,3 @@
-import type { ShellGradientPreset } from '../../shell/shell-gradient-presets';
 import type { SwatchPickerOption, SwatchPickerSection } from '../SwatchPicker/swatch-picker-types';
 export type { MenuAlign, MenuSide } from './menu-position';
 export { PANEL_NAV_USER_MENU_PLACEMENT, PANEL_TOOLS_HEADER_MENU_PLACEMENT, type MenuPlacement, } from './menu-placement';
@@ -19,12 +18,6 @@ export interface MenuItemsSection {
     header?: string;
     items: MenuItemData[];
 }
-export interface MenuGradientPickerSection {
-    header?: string;
-    /** @deprecated Use the generic `swatch-picker` section. */
-    variant: 'gradient-picker';
-    value: ShellGradientPreset;
-}
 export interface MenuSwatchPickerSection {
     header?: string;
     variant: 'swatch-picker';
@@ -33,10 +26,8 @@ export interface MenuSwatchPickerSection {
     sections?: SwatchPickerSection[];
     groupLabel?: string;
 }
-export type MenuSection = MenuItemsSection | MenuGradientPickerSection | MenuSwatchPickerSection;
-export declare function isMenuGradientPickerSection(section: MenuSection): section is MenuGradientPickerSection;
+export type MenuSection = MenuItemsSection | MenuSwatchPickerSection;
 export declare function isMenuSwatchPickerSection(section: MenuSection): section is MenuSwatchPickerSection;
-export declare function isMenuPickerSection(section: MenuSection): section is MenuGradientPickerSection | MenuSwatchPickerSection;
-export type { ShellGradientPreset };
+export declare function isMenuPickerSection(section: MenuSection): section is MenuSwatchPickerSection;
 export type { SwatchPickerOption, SwatchPickerSection };
 //# sourceMappingURL=menu-types.d.ts.map

package/dist/types/components/MobileHeader/MobileHeader.d.ts

@@ -8,16 +8,12 @@ export declare class MobileHeader {
     headingLevel: MobileHeaderHeadingLevel;
     /** Controlled peer sections. Their selected label replaces the static title. */
     sections: TabItem[];
-    /** JSON fallback for `sections`. */
-    sectionsJson: string;
     /** Controlled selected section id. */
     value: string;
     /** Accessible name for the section chooser. */
     sectionsAriaLabel: string;
     /** Controlled child sections within the selected page or detail screen. */
     subsections: TabItem[];
-    /** JSON fallback for `subsections`. */
-    subsectionsJson: string;
     /** Controlled selected child-section id. */
     subvalue: string;
     /** Accessible name for the child-section chooser. */
@@ -28,7 +24,6 @@ export declare class MobileHeader {
     dsSectionChange: EventEmitter<string>;
     /** Child-section selection intent. */
     dsSubsectionChange: EventEmitter<string>;
-    private parseSections;
     private get resolvedSections();
     private get resolvedSubsections();
     private get selectedLabel();

package/dist/types/components/MobileSectionSwitcher/MobileSectionSwitcher.d.ts

@@ -4,8 +4,6 @@ export declare class MobileSectionSwitcher {
     el: HTMLElement;
     /** Ordered controlled sections. Divider entries group the popup menu. */
     sections: TabItem[];
-    /** JSON fallback for `sections`. */
-    sectionsJson: string;
     /** Controlled selected section id. */
     value: string;
     /** Accessible name for the section chooser. */

package/dist/types/components/PanelTools/PanelTools.d.ts

@@ -16,14 +16,10 @@ export declare class PanelTools {
      * Set via JS property: `el.items = [...]`. Replace the array reference to update.
      */
     items: PanelToolsItem[];
-    /** JSON fallback for `items` — useful when framework bindings don't propagate arrays. */
-    itemsJson: string;
     toolsLabel: string;
     toolShortcutsLabel: string;
     /** Active header state per tool. Replace the object when title, depth, or actions change. */
     headers: PanelToolsHeaders;
-    /** JSON fallback for `headers`. The `headers` property takes precedence when non-empty. */
-    headersJson: string;
     /**
      * Optional localStorage key for the last active tool. The drawer always starts
      * closed; only the tool identity is restored for continuity within this browser.

package/dist/types/components/PanelTools/index.d.ts

@@ -1,3 +1,3 @@
 export type { PanelToolsItem, PanelToolsToolId } from './panel-tools-types';
-export { PANEL_TOOLS_FOOTER_TOOL_ID, PANEL_TOOLS_LABELS, PANEL_TOOLS_PRIMARY_TOOL_ID, PANEL_TOOLS_SHORTCUTS, PANEL_TOOLS_TOOL_IDS, } from './panel-tools-types';
+export { PANEL_TOOLS_FOOTER_TOOL_ID, PANEL_TOOLS_DEFAULT_ITEMS, PANEL_TOOLS_LABELS, PANEL_TOOLS_PRIMARY_TOOL_ID, PANEL_TOOLS_SHORTCUTS, PANEL_TOOLS_TOOL_IDS, } from './panel-tools-types';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/components/PanelTools/panel-tools-types.d.ts

@@ -1,16 +1,28 @@
-/** Tool ids for the `ds-panel-tools` rail and drawer views. */
-export type PanelToolsToolId = 'search' | 'agents' | 'messages' | 'stacks' | 'activity' | 'help';
-export declare const PANEL_TOOLS_TOOL_IDS: PanelToolsToolId[];
+/** Application-owned tool id for the shell rail and responsive tool views. */
+export type PanelToolsToolId = string;
+/** Canonical Motive shell recipe used when item metadata is omitted. */
+export type CanonicalPanelToolsToolId = 'search' | 'agents' | 'messages' | 'stacks' | 'activity' | 'help';
+export declare const PANEL_TOOLS_TOOL_IDS: CanonicalPanelToolsToolId[];
 /** Rail header slot — mirrors panel-nav M logo row. */
-export declare const PANEL_TOOLS_PRIMARY_TOOL_ID: PanelToolsToolId;
+export declare const PANEL_TOOLS_PRIMARY_TOOL_ID: CanonicalPanelToolsToolId;
 /** Rail footer slot — flush to the bottom of the tools column. */
-export declare const PANEL_TOOLS_FOOTER_TOOL_ID: PanelToolsToolId;
-export declare const PANEL_TOOLS_LABELS: Record<PanelToolsToolId, string>;
-export declare const PANEL_TOOLS_SHORTCUTS: Partial<Record<PanelToolsToolId, string>>;
+export declare const PANEL_TOOLS_FOOTER_TOOL_ID: CanonicalPanelToolsToolId;
+export declare const PANEL_TOOLS_LABELS: Record<CanonicalPanelToolsToolId, string>;
+export declare const PANEL_TOOLS_SHORTCUTS: Partial<Record<CanonicalPanelToolsToolId, string>>;
 export interface PanelToolsItem {
     id: PanelToolsToolId;
     /** Icon name for <ds-icon>. */
     icon: string;
+    /** Visible and accessible fallback label for custom tool ids. */
+    label?: string;
+    /** Explicit rail region; canonical Search/Help placement is the fallback. */
+    railPlacement?: 'header' | 'body' | 'footer';
+    /** Stable ordering within the selected rail region. */
+    order?: number;
+    /** Optional shortcut label displayed by the tooltip. */
+    shortcutKey?: string;
+    /** Mobile destination recipe; canonical ids retain their existing defaults. */
+    mobileDestination?: 'search' | 'agents' | 'inbox' | 'help';
     /** Whether this rail button is currently pressed/active. */
     selected?: boolean;
     /** Show a notification dot. */
@@ -18,6 +30,8 @@ export interface PanelToolsItem {
     isInactive?: boolean;
     ariaLabel?: string;
 }
+/** Canonical shell recipe used by Lab and by managed ShellApp examples. */
+export declare const PANEL_TOOLS_DEFAULT_ITEMS: PanelToolsItem[];
 export interface PanelToolsHeaderAction {
     id: string;
     icon: string;

package/dist/types/components/PanelTools/panel-tools-utils.d.ts

@@ -1,7 +1,7 @@
 import { type PanelToolsItem, type PanelToolsToolId } from './panel-tools-types';
-export declare function parsePanelToolsItems(items: PanelToolsItem[], itemsJson: string): PanelToolsItem[];
 export declare function orderPanelToolsItems(items: PanelToolsItem[]): PanelToolsItem[];
 export declare function isPanelToolsToolId(value: string | null): value is PanelToolsToolId;
+export declare function panelToolsRailPlacement(item: PanelToolsItem): 'header' | 'body' | 'footer';
 export declare function reconcilePanelToolsAvailability(items: PanelToolsItem[], open: boolean, activeTool: PanelToolsToolId | ''): {
     open: boolean;
     activeTool: PanelToolsToolId | '';

package/dist/types/components/Select/Select.d.ts

@@ -6,6 +6,7 @@ export type SelectSection = ChoiceSection;
 export type SelectBackground = ChoiceBackground;
 export type SelectSize = 'lg' | 'md' | 'sm' | 'xs';
 export type SelectWidth = ControlWidth;
+export type SelectValue = string | string[];
 export declare class Select {
     el: HTMLElement;
     internals: ElementInternals;
@@ -13,8 +14,10 @@ export declare class Select {
     options: SelectOption[];
     /** Grouped choices; takes precedence over options. Assign through JavaScript. */
     sections: SelectSection[];
-    /** Selected string value. Unknown values render the placeholder and are not submitted. */
-    value: string;
+    /** Enable independent multi-value selection while keeping the popup open. */
+    multiple: boolean;
+    /** Selected scalar or array value according to `multiple`. */
+    value: SelectValue;
     /** Controlled popup visibility. */
     open: boolean;
     /** Native form field name. */
@@ -45,6 +48,8 @@ export declare class Select {
     allowClear: boolean;
     /** Localized clear action label. */
     clearLabel: string;
+    /** Localized noun displayed after the selected count in multiple mode. */
+    selectedLabel: string;
     /** Show immediate local filtering over option labels, subtext, and section headings. */
     searchable: boolean;
     /** Localized search-field placeholder and accessible name. */
@@ -67,8 +72,8 @@ export declare class Select {
     ariaLabelledby: string | undefined;
     /** Additional IDs that describe the combobox. */
     ariaDescribedby: string | undefined;
-    /** Emitted after user selection or clearing with the next scalar value. */
-    dsChange: EventEmitter<string>;
+    /** Emitted after selection or clearing with the next scalar or array value. */
+    dsChange: EventEmitter<SelectValue>;
     /** Emitted after the footer clear action. */
     dsClear: EventEmitter<void>;
     /** Emitted whenever popup visibility changes. */
@@ -98,10 +103,13 @@ export declare class Select {
     formStateRestoreCallback(state: string | File | FormData | null): void;
     setFocus(): Promise<void>;
     private get isDisabled();
+    private normalizeValueForMode;
     private get allSections();
     private get allOptions();
     private get visibleSections();
     private get visibleOptions();
+    private get scalarValue();
+    private get resolvedValues();
     private get selectedOption();
     private get hasSelection();
     private get activeOptionId();

package/dist/types/components/Select/index.d.ts

@@ -1,2 +1,2 @@
-export type { SelectBackground, SelectOption, SelectSection, SelectSize, SelectWidth, } from './Select';
+export type { SelectBackground, SelectOption, SelectSection, SelectSize, SelectValue, SelectWidth, } from './Select';
 //# sourceMappingURL=index.d.ts.map