@ds-mo/ui 12.2.0 → 12.4.0

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

@@ -0,0 +1,3 @@
+export type { ChartBarStackedVariant } from './ChartBarStacked';
+export type { ChartSeries } from '../../utils/chart-types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -18,6 +18,8 @@ export declare class ChartLegend {
     showPercentage: boolean;
     /** Fixed number of decimal places shown for percentages. */
     percentageDecimals: ChartLegendPercentageDecimals;
+    /** Let local pointer/focus movement highlight one item and emit `dsItemHover`. */
+    highlightOnHover: boolean;
     /**
      * Externally controlled highlight, matched by `label` — e.g. drive this from a sibling
      * chart's `dsSliceHover` event to keep chart and legend hover in sync. Only dims the other
@@ -35,6 +37,7 @@ export declare class ChartLegend {
         item: ChartLegendItem;
         originalEvent: MouseEvent;
     }>;
+    handleHighlightOnHoverChange(enabled: boolean): void;
     private handleHover;
     private handleClick;
     render(): any;

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

@@ -1,5 +1,7 @@
+import { EventEmitter } from '../../stencil-public-runtime';
 import type { NavChromeStyle } from '../../shell/nav-chrome';
 import { type ShellGradientPreset } from '../../shell/shell-gradient-presets';
+import { type ShellMobileDestination, type ShellResponsiveMode } from '../../shell/shell-responsive';
 export declare class ShellApp {
     /** Chrome style propagated to slotted `ds-panel-nav` and `ds-bar-nav`. */
     navStyle: NavChromeStyle;
@@ -10,9 +12,19 @@ export declare class ShellApp {
     gradientPreset: ShellGradientPreset;
     /** When `true` (default), registers global shell keyboard shortcuts. `[` toggles panel nav; `]` closes tools; K, A, S, M, N, and / toggle tool drawers. Modifiers are ignored so browser chords like ⌘N stay native. */
     shortcutsEnabled: boolean;
+    /** Controlled mobile surface shown above the persistent bottom bar. */
+    mobileDestination: ShellMobileDestination;
+    /** Controlled full-stage mobile navigation-pane state. */
+    mobileNavigationOpen: boolean;
+    /** Emitted after crossing the fixed 768px or 1200px shell boundaries. */
+    dsResponsiveModeChange: EventEmitter<{
+        mode: ShellResponsiveMode;
+    }>;
     el: HTMLElement;
     private toolsFullscreen;
+    private resolvedMode;
     private resizeObserver;
+    private hasLoaded;
     private readonly panelNavTransition;
     private readonly chromeSyncCoalescer;
     private panelWidthTokens;
@@ -20,17 +32,21 @@ export declare class ShellApp {
     private cachedViewportHeight;
     private onWindowResize;
     private onVisualViewportChange;
+    componentWillLoad(): void;
     componentDidLoad(): void;
     handleToolsPresentation(event: CustomEvent<{
         presentation?: string;
     }>): void;
     disconnectedCallback(): void;
     onShellPropsChange(): void;
+    onMobileStateChange(_next: unknown, previous: unknown): void;
+    private updateResponsiveMode;
     private onChromeTransitionStart;
     private onChromeTransitionEnd;
     /** Coalesce ResizeObserver bursts to one layout read per frame. */
     private scheduleChromeSync;
     private syncSlottedNavStyle;
+    private syncSlottedMobileState;
     private connectMetricsObserver;
     private connectViewportListeners;
     private disconnectViewportListeners;

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

@@ -0,0 +1,25 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+import { type ShellMobileDestination } from '../../shell/shell-responsive';
+import type { PanelNavItem } from '../PanelNav/panel-nav-types';
+import type { ShellMobileBarDestinationDetail } from './shell-mobile-bar-types';
+export declare class ShellMobileBar {
+    el: HTMLElement;
+    activeDestination: ShellMobileDestination;
+    currentArea: PanelNavItem;
+    navigationExpanded: boolean;
+    menuLabel: string;
+    searchLabel: string;
+    agentsLabel: string;
+    inboxLabel: string;
+    searchDot: boolean;
+    agentsDot: boolean;
+    inboxDot: boolean;
+    dsNavigationToggle: EventEmitter<boolean>;
+    dsDestinationChange: EventEmitter<ShellMobileBarDestinationDetail>;
+    private destinationConfig;
+    private selectDestination;
+    focusDestination(destination: ShellMobileDestination | 'navigation'): Promise<void>;
+    private renderDestination;
+    render(): any;
+}
+//# sourceMappingURL=ShellMobileBar.d.ts.map

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

@@ -0,0 +1,4 @@
+export type { ShellMobileBarDestinationDetail } from './shell-mobile-bar-types';
+export type { PanelNavItem } from '../PanelNav/panel-nav-types';
+export type { ShellMobileDestination } from '../../shell/shell-responsive';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/components/ShellMobileBar/shell-mobile-bar-types.d.ts

@@ -0,0 +1,5 @@
+import type { ShellMobileDestination } from '../../shell/shell-responsive';
+export interface ShellMobileBarDestinationDetail {
+    destination: ShellMobileDestination;
+}
+//# sourceMappingURL=shell-mobile-bar-types.d.ts.map

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

@@ -0,0 +1,32 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+import type { NavChromeStyle } from '../../shell/nav-chrome';
+import type { PanelNavGroup } from '../PanelNav/panel-nav-types';
+import type { ShellMobileNavAuxiliaryDetail } from './shell-mobile-nav-types';
+export declare class ShellMobileNav {
+    el: HTMLElement;
+    open: boolean;
+    browseContext: NavChromeStyle;
+    dashboardGroups: PanelNavGroup[];
+    settingsGroups: PanelNavGroup[];
+    currentUrl: string;
+    heading: string;
+    navigationLabel: string;
+    dashboardLabel: string;
+    settingsLabel: string;
+    accountLabel: string;
+    helpLabel: string;
+    dsAreaSelect: EventEmitter<string>;
+    dsBrowseContextChange: EventEmitter<NavChromeStyle>;
+    dsAuxiliarySelect: EventEmitter<ShellMobileNavAuxiliaryDetail>;
+    dsClose: EventEmitter<void>;
+    private get groups();
+    private get items();
+    private get activeId();
+    handleOpenChange(open: boolean): void;
+    handleKeyDown(event: KeyboardEvent): void;
+    private handleContextChange;
+    private selectAuxiliary;
+    private renderGroup;
+    render(): any;
+}
+//# sourceMappingURL=ShellMobileNav.d.ts.map

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

@@ -0,0 +1,2 @@
+export type { ShellMobileNavAuxiliaryDetail, ShellMobileNavAuxiliaryId, } from './shell-mobile-nav-types';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/components/ShellMobileNav/shell-mobile-nav-types.d.ts

@@ -0,0 +1,6 @@
+export type ShellMobileNavAuxiliaryId = 'account' | 'help';
+export interface ShellMobileNavAuxiliaryDetail {
+    id: ShellMobileNavAuxiliaryId;
+    anchor: HTMLElement;
+}
+//# sourceMappingURL=shell-mobile-nav-types.d.ts.map

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

@@ -0,0 +1,30 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+import type { BarNavTab } from '../BarNav/bar-nav-types';
+export declare class ShellMobileSectionNav {
+    el: HTMLElement;
+    /** Route sections shared with the corresponding desktop BarNav. */
+    tabs: BarNavTab[];
+    /** JSON fallback for `tabs`. */
+    tabsJson: string;
+    /** Controlled selected tab when URL-derived selection is unavailable. */
+    value: string;
+    /** Active primary-area label shown when the route has no section row. */
+    heading: string | undefined;
+    /** Section base path used to derive the selected route tab. */
+    basePath: string;
+    /** Current application route. */
+    currentUrl: string;
+    navigationLabel: string;
+    /** Route intent; the application owns navigation. */
+    dsTabChange: EventEmitter<string>;
+    private lastScrolledValue;
+    private get resolvedTabs();
+    private get urlState();
+    private get effectiveValue();
+    componentDidLoad(): void;
+    componentDidRender(): void;
+    private scrollSelectedIntoView;
+    private selectTab;
+    render(): any;
+}
+//# sourceMappingURL=ShellMobileSectionNav.d.ts.map

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

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

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

@@ -1,37 +1,49 @@
-import type { ShellPageContentInset, ShellPageHeaderPresentation } from './shell-page-types';
+import type { ShellPageCapacity, ShellPageContentInset, ShellPageHeaderPresentation } from './shell-page-types';
 export declare class ShellPage {
     private static readonly MAX_HEADER_REVEAL_FRAMES;
+    private static readonly MAX_HEADER_GEOMETRY_FRAMES;
     el: HTMLElement;
-    /** Automatic container/scroll behavior, or an explicit header variant override. */
+    /** Automatic capacity/scroll behavior, or an explicit header variant override. */
     headerPresentation: ShellPageHeaderPresentation;
+    /** Available page-header capacity supplied by the owning application shell. */
+    headerCapacity?: ShellPageCapacity;
     /** Standard page gutters, or no inset for full-bleed page content. */
     contentInset: ShellPageContentInset;
-    private capacity;
     private pageTopVisible;
     private sentinelEl;
     private spacerEl;
+    private stickyHeaderEl;
     private headerEl;
     private expandedHeaderHeight;
-    private resizeObserver;
+    private headerTravel;
+    private expandedGeometryFrozen;
     private headerResizeObserver;
+    private headerMutationObserver;
     private headerRevealFrame;
+    private headerGeometryFrame;
     private scrollRoot;
-    private readonly layoutCoalescer;
+    handleHeaderContractChange(): void;
     componentDidLoad(): void;
     componentDidRender(): void;
     disconnectedCallback(): void;
     private get effectiveVariant();
+    private get headerContractResolved();
     private get isScrollCompacted();
-    private connectObservers;
     private composedParent;
     private findScrollRoot;
     private connectScrollRoot;
     private handleScroll;
     private findHeader;
-    private syncCapacity;
     private get compactHeaderHeight();
+    private setHeaderTravel;
+    private measureHeaderTravel;
+    private captureExpandedHeaderGeometry;
     private setSpacerHeight;
     private variantClass;
+    private setStickyHeaderOffset;
+    private syncRenderedHeaderGeometry;
+    private cancelHeaderGeometrySync;
+    private scheduleHeaderGeometrySync;
     private cancelHeaderReveal;
     private revealHeaderWhenSynced;
     private syncHeaderVariant;

package/dist/types/components/ShellPage/shell-page-responsive.d.ts

@@ -1,12 +1,4 @@
 import type { ShellPageCapacity, ShellPageHeaderPresentation } from './shell-page-types';
 import type { BarTitleVariant } from '../BarTitle/bar-title-types';
-export interface ShellPageCapacityOptions {
-    inlineSize: number;
-    compactAt: number;
-    constrainedAt: number;
-    hysteresis: number;
-    previous: ShellPageCapacity | null;
-}
-export declare function resolveShellPageCapacity({ inlineSize, compactAt, constrainedAt, hysteresis, previous, }: ShellPageCapacityOptions): ShellPageCapacity;
 export declare function resolveShellPageHeaderVariant(presentation: ShellPageHeaderPresentation, capacity: ShellPageCapacity, pageTopVisible: boolean): BarTitleVariant;
 //# sourceMappingURL=shell-page-responsive.d.ts.map

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

@@ -0,0 +1,61 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+import { type PanelToolsHeaders, type PanelToolsItem, type PanelToolsToolId } from '../PanelTools/panel-tools-types';
+import { type ShellResponsiveMode } from '../../shell/shell-responsive';
+export declare class ShellTools {
+    el: HTMLElement;
+    /** Resolved by ShellApp; mobile uses a full-stage tool presentation. */
+    responsiveMode: ShellResponsiveMode;
+    open: boolean;
+    activeTool: PanelToolsToolId | '';
+    presentation: 'drawer' | 'fullscreen';
+    fullscreenHeaderMode: 'shared' | 'split';
+    items: PanelToolsItem[];
+    itemsJson: string;
+    headers: PanelToolsHeaders;
+    headersJson: string;
+    storageKey: string;
+    toolsLabel: string;
+    toolShortcutsLabel: string;
+    inboxLabel: string;
+    inboxNavigationLabel: string;
+    dsToolChange: EventEmitter<{
+        id: PanelToolsToolId;
+        selected: boolean;
+    }>;
+    dsPresentationChange: EventEmitter<{
+        presentation: 'drawer' | 'fullscreen';
+    }>;
+    dsHeaderBack: EventEmitter<{
+        tool: PanelToolsToolId;
+    }>;
+    dsHeaderAction: EventEmitter<{
+        tool: PanelToolsToolId;
+        id: string;
+    }>;
+    private panelToolsEl;
+    private get resolvedItems();
+    private get availableInboxTools();
+    private get mobileActiveTool();
+    componentWillLoad(): void;
+    handleItemsChange(): void;
+    private reconcileAvailability;
+    private resolvedHeaders;
+    private activeHeader;
+    private activateMobileTool;
+    private selectInboxTool;
+    private handlePanelToolChange;
+    private handlePanelPresentationChange;
+    private handleMobileHeaderAction;
+    /** Match PanelTools' imperative activation contract in every responsive mode. */
+    activateTool(id: PanelToolsToolId): Promise<void>;
+    /** Close the active global tool surface. */
+    closeDrawer(): Promise<void>;
+    /** Focus an application-owned action in the visible shared tool header. */
+    focusHeaderAction(id: string): Promise<void>;
+    private renderForwardedSlots;
+    private renderDesktop;
+    private renderMobileHeader;
+    private renderMobile;
+    render(): any;
+}
+//# sourceMappingURL=ShellTools.d.ts.map

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

@@ -0,0 +1,3 @@
+export { ShellTools } from './ShellTools';
+export type { PanelToolsHeaderAction, PanelToolsHeaderConfig, PanelToolsHeaders, PanelToolsItem, PanelToolsToolId, } from '../PanelTools/panel-tools-types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -1,5 +1,5 @@
 export declare class TypingIndicator {
-    /** Concise localized status text, ideally naming the participant who is typing. */
+    /** Concise localized typing status. */
     label: string;
     render(): any;
 }