@ds-mo/ui 12.9.0 → 13.1.0

package/dist/framework/angular.d.ts

@@ -3,5 +3,4 @@ export * from '../angular/proxies.js';
 export { BooleanValueAccessor } from '../angular/boolean-value-accessor.js';
 export { RadioValueAccessor } from '../angular/radio-value-accessor.js';
 export { SelectValueAccessor } from '../angular/select-value-accessor.js';
-export { SelectMultiValueAccessor } from './select-multi-value-accessor.js';
 export { TextValueAccessor } from '../angular/text-value-accessor.js';

package/dist/framework/angular.js

@@ -3,5 +3,4 @@ export * from '../angular/proxies.js';
 export { BooleanValueAccessor } from '../angular/boolean-value-accessor.js';
 export { RadioValueAccessor } from '../angular/radio-value-accessor.js';
 export { SelectValueAccessor } from '../angular/select-value-accessor.js';
-export { SelectMultiValueAccessor } from './select-multi-value-accessor.js';
 export { TextValueAccessor } from '../angular/text-value-accessor.js';

package/dist/lib/components/BarTitle/bar-title-types.d.ts

@@ -0,0 +1,28 @@
+import type { ButtonFilledContrast, ButtonFilledIntent } from '../ButtonFilled/ButtonFilled';
+export interface BarTitleSection {
+    id: string;
+    label: string;
+    isInactive?: boolean;
+}
+export interface BarTitleDivider {
+    type: 'divider';
+}
+export type BarTitleSectionItem = BarTitleSection | BarTitleDivider;
+export interface BarTitleAction {
+    id: string;
+    label: string;
+    isInactive?: boolean;
+    isDestructive?: boolean;
+}
+export interface BarTitlePrimaryAction extends BarTitleAction {
+    icon?: string;
+    intent?: ButtonFilledIntent;
+    contrast?: ButtonFilledContrast;
+    isLoading?: boolean;
+    type?: 'button' | 'submit' | 'reset';
+    collapse?: BarTitlePrimaryActionCollapse;
+}
+export type BarTitleActionItem = BarTitleAction | BarTitleDivider;
+export type BarTitleVariant = 'expanded' | 'compact' | 'constrained';
+export type BarTitlePrimaryActionCollapse = 'auto' | 'never';
+export declare function isBarTitleDivider(item: BarTitleSectionItem | BarTitleActionItem): item is BarTitleDivider;

package/dist/lib/components/Breadcrumb/breadcrumb-types.d.ts

@@ -0,0 +1,16 @@
+export interface BreadcrumbItem {
+    /** Stable value returned from dsSelect. */
+    id: string;
+    /** Visible caption label. */
+    label: string;
+    /** Optional accessible name when the visible label is not destination-specific enough. */
+    ariaLabel?: string;
+    /** Native destination. Omit when the route owner handles dsSelect. */
+    href?: string;
+    /** Marks this item as the current page and removes its interaction. */
+    isCurrent?: boolean;
+}
+export interface BreadcrumbSelectDetail {
+    item: BreadcrumbItem;
+    originalEvent: MouseEvent;
+}

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

@@ -0,0 +1,83 @@
+import { EventEmitter } from '@stencil/core';
+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 = ButtonVariant;
+export type ButtonFilledSize = ButtonSize;
+export type ButtonFilledWidth = ButtonWidth;
+export type ButtonFilledPopup = ButtonPopup;
+export declare class ButtonFilled {
+    el: HTMLElement;
+    /**
+     * Content layout. Default is label-only; pass `icon` for icon-only chrome
+     * (nav / tool rails) or `icon-label` for leading icon + text.
+     */
+    variant: ButtonFilledVariant;
+    /** Control density (height, padding, icon, type). */
+    size: ButtonFilledSize;
+    /** Width fit — hug content (default) or fill the parent. */
+    width: ButtonFilledWidth;
+    /** Visible text for `label` / `icon-label` variants. */
+    label: string;
+    /** Icon name passed to <ds-icon> for `icon` / `icon-label` variants. */
+    icon: string;
+    /** Semantic colour intent. */
+    intent: ButtonFilledIntent;
+    /**
+     * Background fill weight. Foreground uses the paired contrast token:
+     * bold → faint, strong → medium, medium → strong, faint → bold.
+     */
+    contrast: ButtonFilledContrast;
+    /** Show a 1px secondary inset border. */
+    hasBorder: boolean;
+    /**
+     * Actual parent surface context for the optional inset border color only.
+     * Omit on primary and secondary surfaces.
+     */
+    background: ButtonFilledBackground | undefined;
+    /** Use the half-radius treatment instead of the default control radius. */
+    rounded: boolean;
+    /**
+     * Scale down during a physical pointer press.
+     * Disable when an owning composite requires fixed child or background geometry.
+     */
+    pressScale: boolean;
+    /** Disables interaction. */
+    isInactive: boolean;
+    /** Shows an inline loader and prevents interaction without applying inactive opacity. */
+    isLoading: boolean;
+    /** Native button type. */
+    type: 'button' | 'submit' | 'reset';
+    /** Accessible name override. Required for icon-only buttons. */
+    ariaLabel: string | null;
+    /** ID of the popup this button controls. */
+    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.
+     */
+    expanded: boolean | undefined;
+    /** Popup type exposed to assistive technology. */
+    haspopup: ButtonFilledPopup | undefined;
+    /**
+     * This action *has* a menu: implies `aria-haspopup="menu"` and adds the trailing
+     * chevron that carries the affordance.
+     *
+     * Only `label` and `icon-label` are supported. A filled button is never the
+     * overflow / more-options control — that role belongs to ButtonUnfilled with an
+     * `Ellipses` glyph, which conveys the menu without a chevron.
+     *
+     * Use `haspopup` directly for non-menu popups.
+     */
+    hasMenu: boolean;
+    dsClick: EventEmitter<MouseEvent>;
+    private buttonEl;
+    setFocus(): Promise<void>;
+    private handleClick;
+    private get resolvedHaspopup();
+    private get accessibleName();
+    render(): any;
+}

package/dist/lib/components/MobileHeader/mobile-header-types.d.ts

@@ -0,0 +1,4 @@
+import type { TabItem } from '../TabGroup/tab-item-utils';
+export type MobileHeaderTone = 'default' | 'brand';
+export type MobileHeaderHeadingLevel = 'h1' | 'h2';
+export type MobileHeaderSectionItem = TabItem;

package/dist/lib/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/lib/components/ShellApp/shell-app-types.d.ts

@@ -0,0 +1,91 @@
+import type { BarNavTab } from '../BarNav/bar-nav-types';
+import type { BarTitleActionItem, BarTitlePrimaryAction } from '../BarTitle/bar-title-types';
+import type { BreadcrumbItem } from '../Breadcrumb/breadcrumb-types';
+import type { MobileHeaderTone } from '../MobileHeader/mobile-header-types';
+import type { PanelNavGroup, PanelNavItem, PanelNavRouterMode } from '../PanelNav/panel-nav-types';
+import type { PanelToolsHeaders, PanelToolsHeaderAction, PanelToolsItem } from '../PanelTools/panel-tools-types';
+import type { NavChromeStyle } from '../../shell/nav-chrome';
+export type ShellAppComposition = 'managed' | 'slotted';
+/**
+ * Router-owned application navigation supplied to managed ShellApp.
+ * ShellApp renders the responsive chrome but never performs route changes.
+ */
+export interface ShellNavigationConfig {
+    /** Groups shown in the current desktop/tablet PanelNav context. */
+    groups?: PanelNavGroup[];
+    /** Complete Dashboard collection used by the mobile navigation sheet. */
+    dashboardGroups?: PanelNavGroup[];
+    /** Complete Settings collection used by the mobile navigation sheet. */
+    settingsGroups?: PanelNavGroup[];
+    /** Current application URL used for active-item matching. */
+    currentUrl?: string;
+    /** Optional explicit active destination when URL matching is unavailable. */
+    activeId?: string;
+    /** Current Dashboard or Settings browsing context. */
+    browseContext?: NavChromeStyle;
+    /** Managed shells default to event routing so the application router stays authoritative. */
+    routerMode?: PanelNavRouterMode;
+    /** Persisted desktop PanelNav collapse preference key. */
+    storageKey?: string;
+    userName?: string;
+    userInitial?: string;
+    accountMenuExpanded?: boolean;
+    dashboardLabel?: string;
+    settingsLabel?: string;
+    accountLabel?: string;
+    navigationLabel?: string;
+    dashboardNavigationLabel?: string;
+    settingsNavigationLabel?: string;
+}
+/**
+ * Route-owned page chrome. The same data drives desktop BarNav/BarTitle and
+ * the intentionally different mobile MobileHeader presentation.
+ */
+export interface ShellPageChromeConfig {
+    heading?: string;
+    /** Desktop/tablet route-navigation heading when it differs from the page h1. */
+    routeHeading?: string;
+    description?: string;
+    headingLevel?: 'h1' | 'h2';
+    tabs?: BarNavTab[];
+    value?: string;
+    basePath?: string;
+    currentUrl?: string;
+    sectionsAriaLabel?: string;
+    subsections?: BarNavTab[];
+    subvalue?: string;
+    subsectionsAriaLabel?: string;
+    showBack?: boolean;
+    backAriaLabel?: string;
+    backIcon?: string;
+    backLabel?: string;
+    breadcrumbs?: BreadcrumbItem[];
+    breadcrumbAriaLabel?: string;
+    primaryAction?: BarTitlePrimaryAction | null;
+    actions?: BarTitleActionItem[];
+    /** Icon actions rendered in the mobile header's trailing lane. */
+    mobileActions?: PanelToolsHeaderAction[];
+    actionsAriaLabel?: string;
+    tone?: MobileHeaderTone;
+    contentInset?: 'default' | 'none';
+}
+/**
+ * Product-owned global tools supplied to managed ShellApp. Tool view content
+ * remains mounted in the corresponding named `*-view` slots.
+ */
+export interface ShellToolsConfig {
+    items?: PanelToolsItem[];
+    headers?: PanelToolsHeaders;
+    storageKey?: string;
+    fullscreenHeaderMode?: 'shared' | 'split';
+    toolsLabel?: string;
+    toolShortcutsLabel?: string;
+    inboxLabel?: string;
+    inboxNavigationLabel?: string;
+    /** Temporarily conceal the mobile bar while a tool-owned keyboard interaction needs the space. */
+    mobileBarHidden?: boolean;
+}
+export interface ShellNavigationSelectDetail {
+    id: string;
+    item?: PanelNavItem;
+}

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

@@ -1,21 +1,13 @@
 export type { NavChromeStyle } from './nav-chrome';
 export type { PanelNavGroup, PanelNavItem, } from '../components/PanelNav/panel-nav-types';
 export type { BarNavTab } from '../components/BarNav/bar-nav-types';
+export type { ShellAppComposition, ShellNavigationConfig, ShellNavigationSelectDetail, ShellPageChromeConfig, ShellToolsConfig, } from '../components/ShellApp/shell-app-types';
 export type { PanelToolsHeaderAction, PanelToolsHeaderConfig, PanelToolsHeaders, PanelToolsItem, PanelToolsToolId, } from '../components/PanelTools/panel-tools-types';
-export { NAV_STYLE_HINT_ATTR, readNavStyleAttr, setNavStyleHint, clearNavStyleHint, resolveNavChromeStyle, shouldResyncNavChromeStyle, } from './nav-chrome';
-export { SHELL_BAR_NAV_VT_NAME, SHELL_NAV_REVEAL_DURATION_VAR, SHELL_NAV_REVEAL_EASING_VAR, parseCssTimeMs, ensureShellNavVtStyle, resolveShellNavRevealOrigin, setShellNavRevealOriginVars, animateShellNavRadialReveal, runShellNavStyleRevealOnReady, } from './shell-view-transition';
-export type { ShellNavRevealOrigin } from './shell-view-transition';
-export { SHELL_GRADIENT_IMAGE_VAR, SHELL_GRADIENT_SIZE_VAR, SHELL_GRADIENT_POSITION_PANEL_VAR, SHELL_GRADIENT_POSITION_BAR_VAR, SHELL_GRADIENT_OPACITY_VAR, SHELL_CHROME_SURFACE_POSITION_VAR, buildShellRadialGradient, shellGradientImage, shellGradientSize, shellGradientPositionPanel, shellGradientPositionBar, shellChromeSurfacePosition, shellChromeLayerActive, readShellViewportDimensions, } from './shell-gradient';
-export type { ShellGradientLayout, ShellViewportDimensions } from './shell-gradient';
+export { PANEL_TOOLS_DEFAULT_ITEMS } from '../components/PanelTools/panel-tools-types';
+export { NAV_STYLE_HINT_ATTR, readNavStyleAttr, setNavStyleHint, clearNavStyleHint, } from './nav-chrome';
 export type { MenuPlacement } from '../components/Menu/menu-placement';
 export { PANEL_NAV_USER_MENU_PLACEMENT, PANEL_TOOLS_HEADER_MENU_PLACEMENT, } from '../components/Menu/menu-placement';
 export type { ShellGradientPickerOption, ShellGradientPickerPreview, ShellGradientPickerSection, ShellGradientPreset, } from './shell-gradient-presets';
-export { DEFAULT_SHELL_GRADIENT_PRESET, SHELL_GRADIENT_PRESETS, SHELL_GRADIENT_PRESET_LABELS, buildShellRadialGradientForPreset, isShellGradientPreset, normalizeShellGradientPreset, shellGradientPickerSections, shellGradientPresetStopToken, } from './shell-gradient-presets';
-export type { ChromeTransitionDetail, ChromeTransitionSource } from './chrome-transition';
-export { CHROME_TRANSITION_END, CHROME_TRANSITION_START, ChromeTransitionDepth, createRafCoalescer, readChromeTransitionSource, readChromeTransitionPhase, } from './chrome-transition';
-export { barGradientPositionFromPanelWidth, isPanelNavCollapsed, panelWidthPxFromTokens, readCssVarWidthPx, readPanelNavWidthTokens, } from './shell-chrome-metrics';
-export type { PanelNavWidthTokens } from './shell-chrome-metrics';
-export { SHELL_DEFAULT_INBOX_TOOL, SHELL_DESKTOP_BREAKPOINT, SHELL_MOBILE_BREAKPOINT, isShellInboxTool, resolveAvailableInboxTool, resolveShellResponsiveMode, shellMobileDestinationForTool, shouldEmitMobileDestinationChange, } from './shell-responsive';
+export { DEFAULT_SHELL_GRADIENT_PRESET, SHELL_GRADIENT_PRESETS, SHELL_GRADIENT_PRESET_LABELS, isShellGradientPreset, normalizeShellGradientPreset, shellGradientPickerSections, } from './shell-gradient-presets';
+export { SHELL_DEFAULT_INBOX_TOOL, isShellInboxTool, resolveAvailableInboxTool, resolveShellResponsiveMode, shellMobileDestinationForTool, shouldEmitMobileDestinationChange, } from './shell-responsive';
 export type { ShellInboxToolId, MobileDestination, ShellResponsiveMode, } from './shell-responsive';
-export { BADGE_GRADIENT_POSITION_VAR, badgeGradientPosition, findGradientSurface, isShellGradientActive, parseCssBackgroundPosition, readShellGradientPosition, syncBadgeGradientPosition, } from './badge-gradient-ring';
-export type { GradientSurface } from './badge-gradient-ring';