@ds-mo/ui 12.1.0 → 12.3.0

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

@@ -0,0 +1,31 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+import type { BreadcrumbItem, BreadcrumbSelectDetail } from './breadcrumb-types';
+export declare class Breadcrumb {
+    /** Ordered path from the broadest ancestor to the nearest page. */
+    items: BreadcrumbItem[];
+    /** Accessible name for the breadcrumb navigation landmark. */
+    ariaLabel: string;
+    /** Emitted when an interactive breadcrumb item is activated. Prevent to cancel native navigation. */
+    dsSelect: EventEmitter<BreadcrumbSelectDetail>;
+    private labelWidths;
+    private collapsedLabels;
+    private navElement?;
+    private listElement?;
+    private measurementElements;
+    private separatorElements;
+    private ellipsisMeasurement?;
+    private resizeObserver?;
+    private observedElement?;
+    private measurementFrame?;
+    componentDidLoad(): void;
+    componentDidRender(): void;
+    disconnectedCallback(): void;
+    handleItemsChange(): void;
+    private observeContainer;
+    private scheduleMeasurement;
+    private measureLabels;
+    private handleSelect;
+    private renderItem;
+    render(): any;
+}
+//# sourceMappingURL=Breadcrumb.d.ts.map

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

@@ -0,0 +1,17 @@
+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;
+}
+//# sourceMappingURL=breadcrumb-types.d.ts.map

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

@@ -0,0 +1,24 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+import type { CardShellDataVizWidth } from '../CardShellDataViz/CardShellDataViz';
+export type CardDataVizBarWidth = CardShellDataVizWidth;
+/**
+ * Bar-chart data-viz card — dedicated `ds-card-shell-data-viz` chrome with a fill chart
+ * region and an optional, content-sized static legend.
+ */
+export declare class CardDataVizBar {
+    el: HTMLElement;
+    /** Widget heading shown in the card header. */
+    heading: string;
+    /** Card width token — also sets matching min-height. */
+    cardWidth: CardDataVizBarWidth;
+    filterLabel: string;
+    /** Emits when the header filter control is activated. */
+    dsFilterClick: EventEmitter<void>;
+    private hasChartSlot;
+    private hasLegendSlot;
+    componentWillRender(): void;
+    componentDidRender(): void;
+    private handleFilterClick;
+    render(): any;
+}
+//# sourceMappingURL=CardDataVizBar.d.ts.map

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

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

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

@@ -0,0 +1,24 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+import type { CardShellDataVizWidth } from '../CardShellDataViz/CardShellDataViz';
+export type CardDataVizLineWidth = CardShellDataVizWidth;
+/**
+ * Line-chart data-viz card — dedicated `ds-card-shell-data-viz` chrome with a fill chart
+ * region and a content-sized, static legend.
+ */
+export declare class CardDataVizLine {
+    el: HTMLElement;
+    /** Widget heading shown in the card header. */
+    heading: string;
+    /** Card width token — also sets matching min-height. */
+    cardWidth: CardDataVizLineWidth;
+    filterLabel: string;
+    /** Emits when the header filter control is activated. */
+    dsFilterClick: EventEmitter<void>;
+    private hasChartSlot;
+    private hasLegendSlot;
+    componentWillRender(): void;
+    componentDidRender(): void;
+    private handleFilterClick;
+    render(): any;
+}
+//# sourceMappingURL=CardDataVizLine.d.ts.map

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

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

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

@@ -0,0 +1,15 @@
+import type { ChartSeries } from '../../utils/chart-types';
+export type ChartBarStackedVariant = 'stacked' | 'percentage';
+export declare class ChartBarStacked {
+    /** Ordered stack series. Set as a JS property (not an HTML attribute). */
+    series: ChartSeries[];
+    /** X-axis labels — must match each series' `data` length. Set as a JS property. */
+    categories: string[];
+    variant: ChartBarStackedVariant;
+    width: number;
+    height: number;
+    private valuesForCategory;
+    private accessibleLabel;
+    render(): any;
+}
+//# sourceMappingURL=ChartBarStacked.d.ts.map

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/ConversationList/ConversationList.d.ts

@@ -1,4 +1,16 @@
+export type ConversationListActionLayout = 'floating' | 'footer';
 export declare class ConversationList {
+    el: HTMLElement;
+    /** Corner icon action or full-width persistent footer action. */
+    actionLayout: ConversationListActionLayout;
+    private viewport?;
+    private content?;
+    private overlay?;
+    private scrollOverlayController?;
+    private emptySlotObserver?;
+    componentDidLoad(): void;
+    disconnectedCallback(): void;
+    private syncEmptyStateLayout;
     render(): any;
 }
 //# sourceMappingURL=ConversationList.d.ts.map

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

@@ -11,6 +11,7 @@ export declare class Menu {
     /** Give ordinary rows mutually-exclusive radio-menu semantics using isSelected. */
     selectionMode: MenuSelectionMode;
     sections: MenuSection[];
+    /** Preferred side; placement flips to the opposite side when that offers a better fit. */
     side: MenuSide;
     align: MenuAlign;
     /** Align choice-row edges to the anchor by default; use `popup-frame` only for custom frame geometry. */
@@ -46,10 +47,8 @@ export declare class Menu {
     private clickOutsideHandler;
     private scrollResizeHandler;
     private closeTimer;
-    private itemEls;
     private positionRetryRaf;
     private livePositionRaf;
-    private listenersReady;
     /** Last content actually painted while open; retained unchanged through exit motion. */
     private lastRenderedSections;
     private closingSections;

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

@@ -11,15 +11,12 @@ export declare class MessageScroller {
     private viewport?;
     private content?;
     private overlay?;
-    private resizeObserver?;
-    private overlayResizeObserver?;
+    private scrollOverlayController?;
     private mutationObserver?;
     private following;
     private atStart;
     private programmatic;
     private previousScrollHeight;
-    private overlayBlockSize;
-    private overlayContentBlockSize;
     componentDidLoad(): void;
     disconnectedCallback(): void;
     scrollToMessage(id: string): Promise<boolean>;
@@ -29,8 +26,6 @@ export declare class MessageScroller {
     private scrollTo;
     private connectObservers;
     private handleContentGrowth;
-    private syncContentFade;
-    private syncOverlayContentBlockSize;
     private applyDefaultPosition;
     private isAtLiveEdge;
     private handleScroll;

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

@@ -0,0 +1,28 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+export interface ScrollOverlayScrollDetail {
+    scrollTop: number;
+    scrollHeight: number;
+    clientHeight: number;
+}
+export declare class ScrollOverlay {
+    el: HTMLElement;
+    /** Optional accessible name. When provided, the scrollport is a focusable region. */
+    scrollLabel: string | undefined;
+    /** Reports scroll position without exposing the internal scrollport element. */
+    dsScroll: EventEmitter<ScrollOverlayScrollDetail>;
+    private viewport?;
+    private content?;
+    private overlay?;
+    private controller?;
+    componentDidLoad(): void;
+    disconnectedCallback(): void;
+    /** Move the owned scrollport to its beginning. */
+    scrollToStart(): Promise<void>;
+    /** Move the owned scrollport to its live end. */
+    scrollToEnd(): Promise<void>;
+    /** Re-measure footer geometry after an imperative slotted-content update. */
+    refreshOverlay(): Promise<void>;
+    private handleScroll;
+    render(): any;
+}
+//# sourceMappingURL=ScrollOverlay.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/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;
 }