@ds-mo/ui 14.18.0 → 14.18.1

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

@@ -28,6 +28,8 @@ export declare class Menu {
     anchor: HTMLElement | undefined;
     /** ID of the external trigger element for positioning */
     anchorId: string | undefined;
+    /** Explicit collision owner; otherwise the nearest data-ds-overlay-boundary ancestor is used. */
+    boundary: HTMLElement | undefined;
     /** Show a visible ring on the initially focused menu item. Use only when the opener was keyboard-driven. */
     initialFocusVisible: boolean;
     /** Accessible name for the popup menu. */
@@ -50,7 +52,6 @@ export declare class Menu {
     dsSwatchSelect: EventEmitter<string>;
     /** Emitted after a pointer drop or keyboard move; Menu never mutates item order. */
     dsReorder: EventEmitter<MenuReorderDetail>;
-    private clickOutsideHandler;
     private closeTimer;
     private positionReadyCallback;
     private suppressItemClick;
@@ -61,6 +62,7 @@ export declare class Menu {
      * semantics, not shared geometry.
      */
     private readonly position;
+    private readonly interaction;
     /** Last content actually painted while open; retained unchanged through exit motion. */
     private lastRenderedSections;
     private closingSections;
@@ -78,9 +80,6 @@ export declare class Menu {
     private finishClose;
     private captureClosingSections;
     private get resolvedAnchor();
-    private get anchorFocusTarget();
-    private focusAnchor;
-    private moveFocusAfterTab;
     private compositeTabLeavesPopup;
     private get activeSections();
     private get flatItems();

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

@@ -18,11 +18,8 @@ export declare class MessageComposer {
     dsStop: EventEmitter<void>;
     private textarea?;
     private readonly errorId;
-    componentDidLoad(): void;
-    onValueChange(): void;
     setFocus(): Promise<void>;
     private get streaming();
-    private resize;
     private handleInput;
     private submit;
     private handleKeyDown;

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

@@ -1,5 +1,5 @@
 import { EventEmitter } from '../../stencil-public-runtime';
-import type { PanelToolsHeaderAction } from '../PanelTools/panel-tools-types';
+import type { PanelToolHeaderActionDetail, PanelToolsHeaderAction } from '../PanelTools/panel-tools-types';
 export declare class PanelToolHeader {
     el: HTMLElement;
     /** Visible heading for the active tool view. */
@@ -24,10 +24,7 @@ export declare class PanelToolHeader {
     actions: PanelToolsHeaderAction[];
     dsBack: EventEmitter<MouseEvent>;
     dsMenuToggle: EventEmitter<MouseEvent>;
-    dsAction: EventEmitter<{
-        id: string;
-        originalEvent: MouseEvent;
-    }>;
+    dsAction: EventEmitter<PanelToolHeaderActionDetail>;
     focusMenuTrigger(): Promise<void>;
     render(): any;
 }

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

@@ -1,6 +1,6 @@
 import { EventEmitter } from '../../stencil-public-runtime';
 import type { ChromeTransitionDetail } from '../../shell/chrome-transition';
-import { type PanelToolsHeaders, type PanelToolsItem, type PanelToolsToolId } from './panel-tools-types';
+import { type PanelToolsHeaderActionDetail, type PanelToolsHeaders, type PanelToolsItem, type PanelToolsToolId } from './panel-tools-types';
 export declare class PanelTools {
     el: HTMLElement;
     /** When false, only the icon rail is shown. */
@@ -39,10 +39,7 @@ export declare class PanelTools {
         tool: PanelToolsToolId;
     }>;
     /** Requests one application-owned action from the active tool header. */
-    dsHeaderAction: EventEmitter<{
-        tool: PanelToolsToolId;
-        id: string;
-    }>;
+    dsHeaderAction: EventEmitter<PanelToolsHeaderActionDetail>;
     /** Bubbling lifecycle — `ds-bar-nav` defers overflow checks during drawer motion. */
     dsChromeTransitionStart: EventEmitter<ChromeTransitionDetail>;
     dsChromeTransitionEnd: EventEmitter<ChromeTransitionDetail>;

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

@@ -43,6 +43,18 @@ export interface PanelToolsHeaderAction {
     pressed?: boolean;
     isInactive?: boolean;
 }
+export interface PanelToolsHeaderActionDetail {
+    tool: PanelToolsToolId;
+    id: string;
+    /** Rendered header action host. Pass this to an external overlay's element anchor prop. */
+    anchor?: HTMLElement;
+}
+export interface PanelToolHeaderActionDetail {
+    id: string;
+    originalEvent: MouseEvent;
+    /** Rendered action host, suitable for anchoring an external overlay across a shadow boundary. */
+    anchor: HTMLElement;
+}
 export interface PanelToolsHeaderConfig {
     title?: string;
     showBack?: boolean;

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

@@ -54,6 +54,8 @@ export declare class Select {
     width: SelectWidth;
     /** Align the popup's choice edge to the trigger start or end edge. */
     popupAlign: SelectPopupAlign;
+    /** Explicit collision owner; otherwise the nearest data-ds-overlay-boundary ancestor is used. */
+    boundary: HTMLElement | undefined;
     /** Shared inactive treatment; removes interaction and form submission. */
     isInactive: boolean;
     /** Replace the prefix with a loader and disable option interaction. */
@@ -177,6 +179,7 @@ export declare class Select {
     private get captionIconOnly();
     private syncCaptionCompactObserver;
     private disconnectCaptionCompactObserver;
+    private renderCaptionTooltip;
     render(): any;
 }
 //# sourceMappingURL=Select.d.ts.map

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

@@ -146,8 +146,6 @@ export declare class Table {
     private visibleColumnsCache;
     private renderModelCache;
     private virtualItemsCache;
-    private virtualLookupCache;
-    private virtualRowPoolStates;
     private rootEl;
     private viewportEl;
     private frameEl;
@@ -170,6 +168,7 @@ export declare class Table {
     private fitObservedViewport;
     private fitObservedTable;
     private fitMeasurementPending;
+    private readonly bodyRenderer;
     private readonly layoutController;
     private readonly loadController;
     private readonly groupLoadController;
@@ -255,7 +254,6 @@ export declare class Table {
     private presentOrDismissTruncateTrack;
     private dismissTruncateTooltip;
     private renderTruncateTooltip;
-    private truncateAttr;
     private handleRowKeydown;
     private onVirtualFocusIn;
     private renderSelectionControl;
@@ -265,9 +263,6 @@ export declare class Table {
     private renderColumnHeader;
     private renderColgroup;
     private renderHeader;
-    private renderCellValue;
-    private renderTextCopy;
-    private renderTextTrack;
     private renderRow;
     private emitGroupCollapse;
     private emitAllGroupsCollapse;
@@ -275,15 +270,8 @@ export declare class Table {
     private formatGroupLoadLabel;
     private renderGroupLoadRow;
     private renderStickyGroup;
-    private renderVirtualSpacer;
-    private renderVirtualRow;
-    private virtualRowPoolKeys;
-    private renderVirtualGroup;
-    private renderVirtualBodies;
     private renderDataBodies;
     private renderSkeletonBody;
-    private renderSkeletonCell;
-    private renderSkeletonCellContent;
     private renderStateBody;
     private renderLazyBody;
     private renderDocumentStickyHeader;

package/dist/types/components/Table/table-body-renderer.d.ts

@@ -0,0 +1,36 @@
+import type { TableGroupRenderModel, TableRenderModel } from './table-render-model';
+import type { TableGroup, TableRow } from './table-types';
+import type { TableVirtualNode, TableVirtualPlan } from './table-virtual-model';
+export interface TableVirtualRowPoolState {
+    slotsByRowId: Map<string, number>;
+    nextSlot: number;
+}
+export interface TableBodyRenderOptions {
+    model: TableRenderModel;
+    plan: TableVirtualPlan | null;
+    rows: TableRow[];
+    stickyHeader: boolean;
+    documentStickyHeader: boolean;
+    activeStickyGroupId: string | null;
+    renderRow: (row: TableRow, model: TableRenderModel, ariaRowIndex?: number, variableVirtualSize?: boolean, rowKey?: string) => unknown;
+    renderGroupContent: (group: TableGroupRenderModel) => unknown;
+    renderGroupLoadRow: (group: TableGroup, totalColumns: number) => unknown;
+}
+/**
+ * Assign stable, bounded DOM keys to the rows currently occupying one virtual scope.
+ * Departed rows release their slots so long scrolls recycle DOM instead of growing it.
+ */
+export declare function assignTableVirtualRowPoolKeys(nodes: readonly TableVirtualNode[], state: TableVirtualRowPoolState): Map<number, string>;
+/** Owns grouped and virtual tbody composition while Table remains the behavior orchestrator. */
+export declare class TableBodyRenderer {
+    private virtualLookupCache;
+    private readonly virtualRowPoolStates;
+    resetVirtualState(): void;
+    render(options: TableBodyRenderOptions): any;
+    private renderVirtualSpacer;
+    private renderVirtualRow;
+    private virtualRowPoolKeys;
+    private renderVirtualGroup;
+    private renderVirtualBodies;
+}
+//# sourceMappingURL=table-body-renderer.d.ts.map

package/dist/types/components/Table/table-load-view.d.ts

@@ -0,0 +1,17 @@
+interface TableLoadContentOptions {
+    error?: string;
+    loading: boolean;
+    hasMore: boolean;
+    manualFallback: boolean;
+    retryLabel: string;
+    loadingLabel: string;
+    loadMoreLabel: string;
+    loadMoreAriaLabel?: string;
+    endOfResultsLabel?: string;
+    onRetry: () => void;
+    onLoadMore: () => void;
+}
+/** Shared visible state machine for top-level and per-group incremental loading bands. */
+export declare function renderTableLoadContent(options: TableLoadContentOptions): any;
+export {};
+//# sourceMappingURL=table-load-view.d.ts.map

package/dist/types/components/Table/table-row-view.d.ts

@@ -0,0 +1,26 @@
+import type { TableRenderModel } from './table-render-model';
+import type { TableCellActionDetail, TableColumn, TableRow } from './table-types';
+export interface TableRowViewOptions {
+    row: TableRow;
+    model: TableRenderModel;
+    visibleColumns: TableColumn[];
+    emptyCellLabel: string;
+    actionMenuElementId: string;
+    actionMenu: {
+        rowId: string;
+        columnId: string;
+    } | null;
+    ariaRowIndex?: number;
+    variableVirtualSize?: boolean;
+    rowKey?: string;
+    renderSelectionControl: (label: string, checked: boolean, indeterminate: boolean, disabled: boolean, onActivate: () => void) => unknown;
+    renderStickyEdge: (sticky: TableColumn['sticky']) => unknown;
+    onRowActivate: (row: TableRow, event: Event) => void;
+    onRowKeyDown: (row: TableRow, event: KeyboardEvent) => void;
+    onRowSelection: (row: TableRow) => void;
+    onCellAction: (detail: TableCellActionDetail) => void;
+    onActionMenuToggle: (row: TableRow, column: TableColumn, event: MouseEvent) => void;
+}
+/** Render one semantic body row and the complete declarative table-cell vocabulary. */
+export declare function renderTableRow({ row, model, visibleColumns, emptyCellLabel, actionMenuElementId, actionMenu, ariaRowIndex, variableVirtualSize, rowKey, renderSelectionControl, renderStickyEdge, onRowActivate, onRowKeyDown, onRowSelection, onCellAction, onActionMenuToggle, }: TableRowViewOptions): any;
+//# sourceMappingURL=table-row-view.d.ts.map

package/dist/types/components/Table/table-skeleton-view.d.ts

@@ -0,0 +1,12 @@
+import type { TableRenderModel } from './table-render-model';
+import type { TableColumn } from './table-types';
+interface TableSkeletonViewOptions {
+    model: TableRenderModel;
+    visibleColumns: TableColumn[];
+    skeletonRows: number;
+    renderStickyEdge: (sticky: TableColumn['sticky']) => unknown;
+}
+/** Render the loading body from the same cell recipes used by loaded rows. */
+export declare function renderTableSkeletonBody(options: TableSkeletonViewOptions): any;
+export {};
+//# sourceMappingURL=table-skeleton-view.d.ts.map

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

@@ -1,3 +1,4 @@
+import { type AnchoredOverlayBoundary } from '../../utils/anchored-overlay-boundary';
 import '../Text/Text';
 export type TooltipSide = 'top' | 'right' | 'bottom' | 'left';
 export type TooltipAlign = 'start' | 'center' | 'end';
@@ -22,6 +23,8 @@ export declare class Tooltip {
     sideOffset: number | string;
     /** Cross-axis offset — number (px) or TokoMo length. */
     alignOffset: number | string;
+    /** Explicit collision owner, `viewport`, or the nearest data-ds-overlay-boundary ancestor. */
+    boundary: AnchoredOverlayBoundary | undefined;
     /**
      * Hover show delay before the tooltip appears.
      * Default: `--effect-animation-delay-medium-3` (1000ms). Accepts a number (ms)

package/dist/types/components.d.ts

@@ -33,7 +33,7 @@ import { DividerBackground, DividerInset, DividerLength, DividerOrientation } fr
 import { FilterMenuChangeDetail, FilterMenuFilter, FilterMenuSize, FilterMenuValues, FilterMenuWidth } from "./components/FilterMenu/FilterMenu";
 import { AnchoredAlign, AnchoredSide } from "./utils/anchored-position";
 import { IconColor as IconColor1, IconSize } from "./components/Icon/Icon";
-import { InputSize, InputType, InputWidth } from "./components/Input/Input";
+import { InputSize, InputTextAlign, InputType, InputWidth } from "./components/Input/Input";
 import { LoaderColor, LoaderSize } from "./components/Loader/Loader";
 import { MenuItemData, MenuReorderDetail, MenuSection } from "./components/Menu/menu-types";
 import { MenuSelectionMode, MenuSize } from "./components/Menu/Menu";
@@ -51,7 +51,7 @@ import { PaginationChangeDetail, PaginationPageSizeMode } from "./components/Pag
 import { ChromeTransitionDetail } from "./shell/chrome-transition";
 import { PanelSubNavItem } from "./components/PanelSubNav/panel-sub-nav-types";
 import { PanelSubNavBackground } from "./components/PanelSubNav/PanelSubNav";
-import { PanelToolsHeaderAction, PanelToolsHeaders, PanelToolsItem, PanelToolsToolId } from "./components/PanelTools/panel-tools-types";
+import { PanelToolHeaderActionDetail, PanelToolsHeaderAction, PanelToolsHeaderActionDetail, PanelToolsHeaders, PanelToolsItem, PanelToolsToolId } from "./components/PanelTools/panel-tools-types";
 import { PaperTextureConfig } from "./components/PaperTexture/paper-texture-types";
 import { RadioOption, RadioSize } from "./components/Radio/Radio";
 import { ScrollOverlayScrollDetail } from "./components/ScrollOverlay/ScrollOverlay";
@@ -71,6 +71,7 @@ import { TableSavedView, TableSavedViewChangeDetail, TableSavedViewCreateDetail,
 import { TagContrast, TagIntent, TagSize } from "./components/Tag/Tag";
 import { ToastActionEventDetail, ToastCloseEventDetail, ToastEventDetail, ToastManager, ToastSwipeDirection } from "./toast";
 import { TooltipAlign, TooltipSide, TooltipSize } from "./components/Tooltip/Tooltip";
+import { AnchoredOverlayBoundary } from "./utils/anchored-overlay-boundary";
 import { TooltipChartItem } from "./components/TooltipChart/TooltipChart";
 export { AgentActivityItem, AgentQuestion, AgentQuestionAnswer, AgentQuestionnaireAnswerEventDetail, AgentQuestionnaireCancelEventDetail, AgentQuestionnaireLabels, AgentQuestionnaireStatus, AgentResponsePart, AgentResponseRenderMode, AgentSource, AgentToolState, ConversationAttachment, ConversationItemState, MessageComposerStatus, MessageCopyResultEventDetail, MessageDeliveryState, MessageDirection, MessageFeedback, MessageGroupPosition, MessageMetadataVisibility, MessageScrollerPosition } from "./components/conversation-types";
 export { IconColor, IconSize as IconSize1 } from "./components/Icon/Icon";
@@ -100,7 +101,7 @@ export { DividerBackground, DividerInset, DividerLength, DividerOrientation } fr
 export { FilterMenuChangeDetail, FilterMenuFilter, FilterMenuSize, FilterMenuValues, FilterMenuWidth } from "./components/FilterMenu/FilterMenu";
 export { AnchoredAlign, AnchoredSide } from "./utils/anchored-position";
 export { IconColor as IconColor1, IconSize } from "./components/Icon/Icon";
-export { InputSize, InputType, InputWidth } from "./components/Input/Input";
+export { InputSize, InputTextAlign, InputType, InputWidth } from "./components/Input/Input";
 export { LoaderColor, LoaderSize } from "./components/Loader/Loader";
 export { MenuItemData, MenuReorderDetail, MenuSection } from "./components/Menu/menu-types";
 export { MenuSelectionMode, MenuSize } from "./components/Menu/Menu";
@@ -118,7 +119,7 @@ export { PaginationChangeDetail, PaginationPageSizeMode } from "./components/Pag
 export { ChromeTransitionDetail } from "./shell/chrome-transition";
 export { PanelSubNavItem } from "./components/PanelSubNav/panel-sub-nav-types";
 export { PanelSubNavBackground } from "./components/PanelSubNav/PanelSubNav";
-export { PanelToolsHeaderAction, PanelToolsHeaders, PanelToolsItem, PanelToolsToolId } from "./components/PanelTools/panel-tools-types";
+export { PanelToolHeaderActionDetail, PanelToolsHeaderAction, PanelToolsHeaderActionDetail, PanelToolsHeaders, PanelToolsItem, PanelToolsToolId } from "./components/PanelTools/panel-tools-types";
 export { PaperTextureConfig } from "./components/PaperTexture/paper-texture-types";
 export { RadioOption, RadioSize } from "./components/Radio/Radio";
 export { ScrollOverlayScrollDetail } from "./components/ScrollOverlay/ScrollOverlay";
@@ -138,6 +139,7 @@ export { TableSavedView, TableSavedViewChangeDetail, TableSavedViewCreateDetail,
 export { TagContrast, TagIntent, TagSize } from "./components/Tag/Tag";
 export { ToastActionEventDetail, ToastCloseEventDetail, ToastEventDetail, ToastManager, ToastSwipeDirection } from "./toast";
 export { TooltipAlign, TooltipSide, TooltipSize } from "./components/Tooltip/Tooltip";
+export { AnchoredOverlayBoundary } from "./utils/anchored-overlay-boundary";
 export { TooltipChartItem } from "./components/TooltipChart/TooltipChart";
 export namespace Components {
     interface DsAgentActivity {
@@ -287,10 +289,9 @@ export namespace Components {
          */
         "count": number;
         /**
-          * Ring samples the shell gradient stack (base fill + wash) instead of a flat `box-shadow`. Auto-enabled under an ShellApp with an active gradient preset; set `gradient-background` to opt in/out explicitly.  The attribute must NOT start with `on` — Stencil's setAccessor routes any unknown `on*` member down the event-listener path during attribute reflection, calling addEventListener with a non-listener and throwing.
-          * @default false
+          * Ring samples the shell gradient stack (base fill + wash) instead of a flat `box-shadow`. Omit to inherit ShellApp context; set true or false to override.  The attribute must NOT start with `on` — Stencil's setAccessor routes any unknown `on*` member down the event-listener path during attribute reflection, calling addEventListener with a non-listener and throwing.
          */
-        "gradientBackground": boolean;
+        "gradientBackground"?: boolean;
         /**
           * Show the separation ring when the badge overlaps an icon or other content.
           * @default true
@@ -1229,6 +1230,10 @@ export namespace Components {
           * @default null
          */
         "ariaLabel": string | null;
+        /**
+          * Explicit collision owner; otherwise the nearest data-ds-overlay-boundary ancestor is used.
+         */
+        "boundary": HTMLElement | undefined;
         /**
           * Accessible name for the category tab list.
           * @default 'Filter categories'
@@ -1274,7 +1279,7 @@ export namespace Components {
          */
         "menuLabel": string;
         /**
-          * Popup width. It remains clamped to the viewport by the component recipe.
+          * Popup width. It remains clamped to its collision boundary by the component recipe.
           * @default TOKEN_CSS_LENGTHS.menuWidthLg
          */
         "menuWidth": string;
@@ -1424,6 +1429,11 @@ export namespace Components {
           * Numeric increment used by native stepping and constraint validation.
          */
         "step": number | undefined;
+        /**
+          * Align the editable value; number steppers follow the same inline edge.
+          * @default 'start'
+         */
+        "textAlign": InputTextAlign;
         /**
           * @default 'text'
          */
@@ -1487,6 +1497,10 @@ export namespace Components {
           * ID of the external trigger element for positioning
          */
         "anchorId": string | undefined;
+        /**
+          * Explicit collision owner; otherwise the nearest data-ds-overlay-boundary ancestor is used.
+         */
+        "boundary": HTMLElement | undefined;
         /**
           * Show a visible ring on the initially focused menu item. Use only when the opener was keyboard-driven.
           * @default false
@@ -2335,6 +2349,10 @@ export namespace Components {
           * Actual parent surface context; omit on primary and secondary surfaces.
          */
         "background": SelectBackground | undefined;
+        /**
+          * Explicit collision owner; otherwise the nearest data-ds-overlay-boundary ancestor is used.
+         */
+        "boundary": HTMLElement | undefined;
         /**
           * Localized clear action label.
           * @default 'Clear'
@@ -3446,6 +3464,10 @@ export namespace Components {
           * @default 0
          */
         "alignOffset": number | string;
+        /**
+          * Explicit collision owner, `viewport`, or the nearest data-ds-overlay-boundary ancestor.
+         */
+        "boundary": AnchoredOverlayBoundary | undefined;
         /**
           * Hover show delay before the tooltip appears. Default: `--effect-animation-delay-medium-3` (1000ms). Accepts a number (ms) or a TokoMo time token / `var(--effect-animation-delay-*)`. Applies to the initial hover/focus show only — after a recent dismiss, reopen is instant. Prefer the default; override only for denser chrome or rare/destructive actions.
           * @default TOKEN_DEFAULTS.animationDelayMedium3
@@ -3542,7 +3564,7 @@ export namespace Components {
     interface DsTypingIndicator {
         /**
           * Concise localized typing status.
-          * @default 'Typing...'
+          * @default 'Typing…'
          */
         "label": string;
     }
@@ -4460,7 +4482,7 @@ declare global {
     interface HTMLDsPanelToolHeaderElementEventMap {
         "dsBack": MouseEvent;
         "dsMenuToggle": MouseEvent;
-        "dsAction": { id: string; originalEvent: MouseEvent };
+        "dsAction": PanelToolHeaderActionDetail;
     }
     interface HTMLDsPanelToolHeaderElement extends Components.DsPanelToolHeader, HTMLStencilElement {
         addEventListener<K extends keyof HTMLDsPanelToolHeaderElementEventMap>(type: K, listener: (this: HTMLDsPanelToolHeaderElement, ev: DsPanelToolHeaderCustomEvent<HTMLDsPanelToolHeaderElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -4506,10 +4528,7 @@ declare global {
         "dsHeaderBack": {
     tool: PanelToolsToolId;
   };
-        "dsHeaderAction": {
-    tool: PanelToolsToolId;
-    id: string;
-  };
+        "dsHeaderAction": PanelToolsHeaderActionDetail;
         "dsChromeTransitionStart": ChromeTransitionDetail;
         "dsChromeTransitionEnd": ChromeTransitionDetail;
     }
@@ -5134,8 +5153,7 @@ declare namespace LocalJSX {
          */
         "count"?: number;
         /**
-          * Ring samples the shell gradient stack (base fill + wash) instead of a flat `box-shadow`. Auto-enabled under an ShellApp with an active gradient preset; set `gradient-background` to opt in/out explicitly.  The attribute must NOT start with `on` — Stencil's setAccessor routes any unknown `on*` member down the event-listener path during attribute reflection, calling addEventListener with a non-listener and throwing.
-          * @default false
+          * Ring samples the shell gradient stack (base fill + wash) instead of a flat `box-shadow`. Omit to inherit ShellApp context; set true or false to override.  The attribute must NOT start with `on` — Stencil's setAccessor routes any unknown `on*` member down the event-listener path during attribute reflection, calling addEventListener with a non-listener and throwing.
          */
         "gradientBackground"?: boolean;
         /**
@@ -6162,6 +6180,10 @@ declare namespace LocalJSX {
           * @default null
          */
         "ariaLabel"?: string | null;
+        /**
+          * Explicit collision owner; otherwise the nearest data-ds-overlay-boundary ancestor is used.
+         */
+        "boundary"?: HTMLElement | undefined;
         /**
           * Accessible name for the category tab list.
           * @default 'Filter categories'
@@ -6207,7 +6229,7 @@ declare namespace LocalJSX {
          */
         "menuLabel"?: string;
         /**
-          * Popup width. It remains clamped to the viewport by the component recipe.
+          * Popup width. It remains clamped to its collision boundary by the component recipe.
           * @default TOKEN_CSS_LENGTHS.menuWidthLg
          */
         "menuWidth"?: string;
@@ -6382,6 +6404,11 @@ declare namespace LocalJSX {
           * Numeric increment used by native stepping and constraint validation.
          */
         "step"?: number | undefined;
+        /**
+          * Align the editable value; number steppers follow the same inline edge.
+          * @default 'start'
+         */
+        "textAlign"?: InputTextAlign;
         /**
           * @default 'text'
          */
@@ -6445,6 +6472,10 @@ declare namespace LocalJSX {
           * ID of the external trigger element for positioning
          */
         "anchorId"?: string | undefined;
+        /**
+          * Explicit collision owner; otherwise the nearest data-ds-overlay-boundary ancestor is used.
+         */
+        "boundary"?: HTMLElement | undefined;
         /**
           * Show a visible ring on the initially focused menu item. Use only when the opener was keyboard-driven.
           * @default false
@@ -7113,7 +7144,7 @@ declare namespace LocalJSX {
           * @default ''
          */
         "menuTriggerId"?: string;
-        "onDsAction"?: (event: DsPanelToolHeaderCustomEvent<{ id: string; originalEvent: MouseEvent }>) => void;
+        "onDsAction"?: (event: DsPanelToolHeaderCustomEvent<PanelToolHeaderActionDetail>) => void;
         "onDsBack"?: (event: DsPanelToolHeaderCustomEvent<MouseEvent>) => void;
         "onDsMenuToggle"?: (event: DsPanelToolHeaderCustomEvent<MouseEvent>) => void;
         /**
@@ -7214,10 +7245,7 @@ declare namespace LocalJSX {
         /**
           * Requests one application-owned action from the active tool header.
          */
-        "onDsHeaderAction"?: (event: DsPanelToolsCustomEvent<{
-    tool: PanelToolsToolId;
-    id: string;
-  }>) => void;
+        "onDsHeaderAction"?: (event: DsPanelToolsCustomEvent<PanelToolsHeaderActionDetail>) => void;
         /**
           * Requests navigation to the active tool's parent view.
          */
@@ -7369,6 +7397,10 @@ declare namespace LocalJSX {
           * Actual parent surface context; omit on primary and secondary surfaces.
          */
         "background"?: SelectBackground | undefined;
+        /**
+          * Explicit collision owner; otherwise the nearest data-ds-overlay-boundary ancestor is used.
+         */
+        "boundary"?: HTMLElement | undefined;
         /**
           * Localized clear action label.
           * @default 'Clear'
@@ -8628,6 +8660,10 @@ declare namespace LocalJSX {
           * @default 0
          */
         "alignOffset"?: number | string;
+        /**
+          * Explicit collision owner, `viewport`, or the nearest data-ds-overlay-boundary ancestor.
+         */
+        "boundary"?: AnchoredOverlayBoundary | undefined;
         /**
           * Hover show delay before the tooltip appears. Default: `--effect-animation-delay-medium-3` (1000ms). Accepts a number (ms) or a TokoMo time token / `var(--effect-animation-delay-*)`. Applies to the initial hover/focus show only — after a recent dismiss, reopen is instant. Prefer the default; override only for denser chrome or rare/destructive actions.
           * @default TOKEN_DEFAULTS.animationDelayMedium3
@@ -8716,7 +8752,7 @@ declare namespace LocalJSX {
     interface DsTypingIndicator {
         /**
           * Concise localized typing status.
-          * @default 'Typing...'
+          * @default 'Typing…'
          */
         "label"?: string;
     }
@@ -9024,6 +9060,7 @@ declare namespace LocalJSX {
         "min": number | undefined;
         "max": number | undefined;
         "step": number | undefined;
+        "textAlign": InputTextAlign;
         "autoComplete": string | undefined;
         "inputMode": string;
         "enterKeyHint": string;
@@ -9495,6 +9532,7 @@ declare namespace LocalJSX {
         "align": TooltipAlign;
         "sideOffset": string;
         "alignOffset": string;
+        "boundary": AnchoredOverlayBoundary | undefined;
         "delay": string;
         "shortcutKey": string | undefined;
         "shortcutKeyPosition": 'start' | 'end';

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

@@ -3,7 +3,7 @@ export type { PanelNavGroup, PanelNavItem, } from '../components/PanelNav/panel-
 export type { BarNavTab } from '../components/BarNav/bar-nav-types';
 export type { ShellPageContentInset, ShellPageContentSurface, } from '../components/ShellPage/shell-page-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 type { PanelToolsHeaderAction, PanelToolsHeaderActionDetail, PanelToolHeaderActionDetail, PanelToolsHeaderConfig, PanelToolsHeaders, PanelToolsItem, PanelToolsToolId, } from '../components/PanelTools/panel-tools-types';
 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';

package/dist/types/utils/anchored-overlay-boundary.d.ts

@@ -0,0 +1,14 @@
+import type { AnchoredCollisionRect } from './anchored-position';
+/** Attribute placed on a page or panel whose visible rectangle owns anchored overlays. */
+export declare const ANCHORED_OVERLAY_BOUNDARY_ATTRIBUTE = "data-ds-overlay-boundary";
+/** An element-owned collision rectangle, or an explicit escape to the viewport. */
+export type AnchoredOverlayBoundary = HTMLElement | 'viewport';
+/**
+ * Find the nearest collision owner through light DOM, assigned slots, and open
+ * shadow roots. The popup may live in the top layer or a body portal; ownership
+ * follows its anchor instead of the popup's rendering location.
+ */
+export declare function findAnchoredOverlayBoundary(anchor: Element): HTMLElement | null;
+/** Resolve an explicit owner first, then the nearest composed-tree boundary. */
+export declare function resolveAnchoredOverlayBoundaryRect(anchor: Element, explicitBoundary?: AnchoredOverlayBoundary): AnchoredCollisionRect | undefined;
+//# sourceMappingURL=anchored-overlay-boundary.d.ts.map

package/dist/types/utils/anchored-overlay-interaction-controller.d.ts

@@ -0,0 +1,26 @@
+export interface AnchoredOverlayInteractionOptions {
+    getAnchor: () => HTMLElement | null;
+    getPopup: () => HTMLElement | null;
+    /** Stable owner fallback when framework bindings assign open before anchor. */
+    getOwnerDocument?: () => Document | null;
+    onOutsideActivation: () => void;
+}
+/** Whether an event originated from a boundary, including through open shadow roots. */
+export declare function eventIntersectsComposedBoundary(event: Event, boundary: HTMLElement): boolean;
+/**
+ * Owns the non-visual interaction boundary shared by externally anchored
+ * overlays: composed outside activation, focus return, and Tab continuation.
+ */
+export declare class AnchoredOverlayInteractionController {
+    private readonly options;
+    private ownerDocument;
+    private readonly outsideHandler;
+    constructor(options: AnchoredOverlayInteractionOptions);
+    connect(): void;
+    disconnect(): void;
+    focusAnchor(): void;
+    tabLeavesPopup(event: KeyboardEvent): boolean;
+    moveFocusAfterTab(backwards: boolean): void;
+    private get anchorFocusTarget();
+}
+//# sourceMappingURL=anchored-overlay-interaction-controller.d.ts.map