@fabric-msft/fabric-web 5.0.0 → 7.0.0

package/dts/components/listbox/listbox.d.ts

@@ -0,0 +1,119 @@
+import { Listbox as FluentListbox } from "@fluentui/web-components";
+import type { DropdownOption } from "../option/index.js";
+/**
+ * Listbox
+ * @summary A Listbox Custom HTML Element that allows for single or multiple selection from a list of options.
+ * Extends the Fluent Listbox to support option groups ({@link @fabric-msft/fabric-web#OptionGroup}).
+ *
+ * @example
+ * ```html
+ * <fabric-listbox id="myListbox" multiple>
+ *   <fabric-option value="option1">Option 1</fabric-option>
+ *   <fabric-option value="option2">Option 2</fabric-option>
+ *   <fabric-option value="option3">Option 3</fabric-option>
+ * </fabric-listbox>
+ * ```
+ *
+ * @example
+ * ```html
+ * <fabric-listbox>
+ *   <fabric-option-group label="Fruits">
+ *     <fabric-option value="apple">Apple</fabric-option>
+ *     <fabric-option value="banana">Banana</fabric-option>
+ *   </fabric-option-group>
+ *   <fabric-option-group label="Vegetables">
+ *     <fabric-option value="carrot">Carrot</fabric-option>
+ *   </fabric-option-group>
+ * </fabric-listbox>
+ * ```
+ *
+ * @attr {string} id - Sets the listbox ID to a unique value if one is not provided.
+ * @attr {boolean | undefined} multiple - Indicates whether the listbox allows multiple selection.
+ *
+ * @prop {Array<HTMLElement>} options - The collection of child options that are not disabled.
+ * @prop {Array<HTMLElement>} selectedOptions - The collection of child options that are selected.
+ * @prop {number} selectedIndex - The index of the currently selected option.
+ *
+ * @slot - The default slot for the options and option groups.
+ *
+ * @method multipleChanged - Updates the multiple selection state of the listbox and its options. Parameters: prev (boolean | undefined), next (boolean | undefined).
+ * @method clickHandler - Sets the `selected` state on a target option when clicked. Parameters: e (PointerEvent).
+ * @method selectOption - Selects an option by index. Parameters: index (number).
+ *
+ * @fires connected - Dispatched when the element is connected to the DOM.
+ *
+ * @extends FluentListbox
+ * @tagname fabric-listbox
+ * @public
+ */
+export declare class Listbox extends FluentListbox {
+    /**
+     * Checks if an option belongs to a disabled option group.
+     *
+     * @param option - The option to check.
+     * @returns true if the option is inside a disabled option group.
+     * @internal
+     */
+    private isOptionInDisabledGroup;
+    /**
+     * Sets the `selected` state on a target option when clicked.
+     * Overrides the base implementation to prevent selection of options in disabled groups.
+     *
+     * @param e - The pointer event
+     * @override
+     * @public
+     */
+    clickHandler(e: PointerEvent): boolean | void;
+    /**
+     * Selects an option by index.
+     * Overrides the base implementation to prevent selection of options in disabled groups.
+     *
+     * @param index - The index of the option to select.
+     * @override
+     * @public
+     */
+    selectOption(index?: number): void;
+    /**
+     * Handles the slotchange event for the listbox.
+     * Overrides the base implementation to support option groups.
+     * Extracts options from both direct option elements and option group children,
+     * flattening them into a single options array while propagating group disabled states.
+     *
+     * @param e - The slot change event.
+     * @override
+     * @internal
+     */
+    slotchangeHandler(e?: Event): void;
+    /**
+     * Handles changes to the options collection.
+     * Overrides the base implementation to apply group-aware ARIA positioning.
+     *
+     * @param prev - The previous options collection.
+     * @param next - The new options collection.
+     * @override
+     * @internal
+     */
+    optionsChanged(prev: DropdownOption[] | undefined, next: DropdownOption[] | undefined): void;
+    /**
+     * Build a list of groups and options
+     * @param options
+     * @param groups
+     */
+    private setOptionGroups;
+    /**
+     * Applies group-scoped ARIA positioning attributes to options.
+     * Options within the same group share aria-setsize scoped to that group.
+     *
+     * @param options - The flattened options collection.
+     * @internal
+     */
+    private applyGroupScopedAria;
+    /**
+     * Updates the multiple selection state of the listbox and its options.
+     *
+     * @param prev - the previous multiple value
+     * @param next - the current multiple value
+     */
+    multipleChanged(_prev: boolean | undefined, next: boolean | undefined): void;
+}
+//# sourceMappingURL=listbox.d.ts.map

package/dts/components/listbox/listbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listbox.d.ts","sourceRoot":"","sources":["../../../../src/components/listbox/listbox.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAOzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,qBAAa,OAAQ,SAAQ,aAAa;IACxC;;;;;;OAMG;IACH,OAAO,CAAC,uBAAuB;IAM/B;;;;;;;OAOG;IACa,YAAY,CAAC,CAAC,EAAE,YAAY,GAAG,OAAO,GAAG,IAAI;IAc7D;;;;;;;OAOG;IACa,YAAY,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IASlD;;;;;;;;;OASG;IACa,iBAAiB,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,IAAI;IA6BlD;;;;;;;;OAQG;IACa,cAAc,CAC5B,IAAI,EAAE,cAAc,EAAE,GAAG,SAAS,EAClC,IAAI,EAAE,cAAc,EAAE,GAAG,SAAS,GACjC,IAAI;IAUP;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAevB;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IAyB5B;;;;;OAKG;IACa,eAAe,CAC7B,KAAK,EAAE,OAAO,GAAG,SAAS,EAC1B,IAAI,EAAE,OAAO,GAAG,SAAS;CAU5B"}

package/dts/components/listbox/listbox.definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listbox.definition.d.ts","sourceRoot":"","sources":["../../../../src/components/listbox/listbox.definition.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,yEAQrB,CAAC"}

package/dts/components/listbox/listbox.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listbox.styles.d.ts","sourceRoot":"","sources":["../../../../src/components/listbox/listbox.styles.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,MAAM,iDAKlB,CAAC"}

package/dts/components/loading-button/define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../../../src/components/loading-button/define.ts"],"names":[],"mappings":""}

package/dts/components/loading-button/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/loading-button/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,UAAU,IAAI,uBAAuB,EAAE,MAAM,gCAAgC,CAAC"}

package/dts/components/loading-button/loading-button.d.ts

@@ -0,0 +1,47 @@
+import { Button as FabricButton } from "@fluentui/web-components";
+/**
+ * LoadingButton
+ * @summary A custom button component with a loading state that extends Fluent UI's Button class. It provides visual feedback with a spinner when the button is in a loading state and disables interaction.
+ *
+ * @example
+ * ```html
+ * <fabric-loading-button
+ *   appearance='primary'
+ *   size='large'
+ *   shape='rounded'
+ *   loading
+ *   disabled
+ *   aria-busy='true'>
+ *   Submit
+ * </fabric-loading-button>
+ * ```
+ *
+ * @attr {boolean} loading - Indicates whether the button is in a loading state.
+ * @attr {ButtonAppearance} appearance - The appearance of the button.
+ * @attr {ButtonShape} shape - The shape of the button.
+ * @attr {ButtonSize} size - The size of the button.
+ * @attr {string} aria-busy - Indicates whether the button is busy.
+ *
+ * @prop {boolean} loading - Indicates whether the button is in a loading state. Default: false.
+ * @prop {boolean} disabled - Indicates whether the button is disabled. Default: false.
+ *
+ * @slot - The default slot for the button content.
+ * @slot start - Slot for the spinner when the button is loading.
+ *
+ * @csspart control - The control part of the button, styled differently when loading and disabled.
+ *
+ * @extends FluentButton
+ * @tagname fabric-loading-button
+ * @public
+ */
+export declare class LoadingButton extends FabricButton {
+    /**
+     * Indicates whether the button is in a loading state.
+     * @public
+     * @type {boolean}
+     * @default false
+     */
+    loading: boolean;
+    connectedCallback(): void;
+}
+//# sourceMappingURL=loading-button.d.ts.map

package/dts/components/loading-button/loading-button.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loading-button.d.ts","sourceRoot":"","sources":["../../../../src/components/loading-button/loading-button.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,IAAI,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGlE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,qBAAa,aAAc,SAAQ,YAAY;IAC7C;;;;;OAKG;IACwB,OAAO,EAAE,OAAO,CAAS;IAEpD,iBAAiB,IAAI,IAAI;CAI1B"}

package/dts/components/loading-button/loading-button.definition.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Composed element definition for `<fabric-loading-button>`, registering the
+ * `fabric-spinner` dependency before the element itself.
+ *
+ * @public
+ * @remarks
+ * HTML Element: `<fabric-loading-button>`
+ */
+export declare const definition: import("../../util/element-definition.js").FabricElementDefinition;
+//# sourceMappingURL=loading-button.definition.d.ts.map

package/dts/components/loading-button/loading-button.definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loading-button.definition.d.ts","sourceRoot":"","sources":["../../../../src/components/loading-button/loading-button.definition.ts"],"names":[],"mappings":"AAiBA;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,oEAGtB,CAAC"}

package/dts/components/loading-button/loading-button.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loading-button.styles.d.ts","sourceRoot":"","sources":["../../../../src/components/loading-button/loading-button.styles.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,MAAM,iDA8BlB,CAAC"}

package/dts/components/loading-button/loading-button.template.d.ts

@@ -0,0 +1,8 @@
+import type { ElementViewTemplate } from "@microsoft/fast-element";
+import { LoadingButton } from "./loading-button.js";
+/**
+ * The template for the {@link @fabric-msft/fabric-web#LoadingButton} component.
+ * @public
+ */
+export declare const template: ElementViewTemplate<LoadingButton>;
+//# sourceMappingURL=loading-button.template.d.ts.map

package/dts/components/loading-button/loading-button.template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loading-button.template.d.ts","sourceRoot":"","sources":["../../../../src/components/loading-button/loading-button.template.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AA2CpD;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAE,mBAAmB,CAAC,aAAa,CAC/B,CAAC"}

package/dts/components/menu/define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../../../src/components/menu/define.ts"],"names":[],"mappings":""}

package/dts/components/menu/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/menu/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,IAAI,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACvE,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dts/components/menu/menu.d.ts

@@ -0,0 +1,371 @@
+import { FASTElement } from "@microsoft/fast-element";
+import { MenuList } from "../menu-list/menu-list.js";
+import { type MenuPosition, type MenuRepositionMode } from "./menu.options.js";
+/**
+ * Menu
+ * @summary A Menu component that provides an interactive menu interface with support for various trigger and open behaviors.
+ *
+ * When `reposition-mode="auto"` is set the component creates a {@link MenuPositioning} manager backed by
+ * `FlexiblePositionStrategy`. On every open/resize/scroll cycle the strategy measures available space, picks
+ * the best-fitting position from the preferred position plus its fallbacks, and resizes the menu if there is
+ * not enough available space. When `reposition-mode="none"` (default) the same strategy positions the menu
+ * once on open but does not reposition on resize or scroll. Supply `overflowBoundary` to scope collision
+ * detection to a specific scrolling container instead of the viewport.
+ *
+ * @example
+ * ```html
+ * <fabric-menu open-on-hover="true" open-on-context="true" close-on-scroll="true" persist-on-item-click="true">
+ *   <div slot="trigger">Menu Trigger</div>
+ *   <ul>
+ *     <li>Menu Item 1</li>
+ *     <li>Menu Item 2</li>
+ *     <li>Menu Item 3</li>
+ *   </ul>
+ * </fabric-menu>
+ * ```
+ *
+ * @attr {boolean | undefined} open-on-hover - Determines if the menu should open on hover.
+ * @attr {boolean | undefined} open-on-context - Determines if the menu should open on right click.
+ * @attr {boolean | undefined} close-on-scroll - Determines if the menu should close on scroll.
+ * @attr {boolean | undefined} persist-on-item-click - Determines if the menu open state should persist on click of a menu item.
+ * @attr {boolean | undefined} split - Determines if the menu is in split state (for split button pattern).
+ * @attr {MenuPosition | undefined} menu-position - Determines whether the menu list is above or below the trigger. Defaults to `"below"`.
+ * @attr {MenuRepositionMode | undefined} reposition-mode - Controls JS-based repositioning. `"auto"` enables
+ *   `FlexiblePositionStrategy` which detects collisions and flips the menu to the best-fitting position on
+ *   every resize/scroll cycle. `"none"` (default) disables JS repositioning and relies on CSS anchored positioning.
+ *
+ * @prop {boolean | undefined} openOnHover - Determines if the menu should open on hover.
+ * @prop {boolean | undefined} openOnContext - Determines if the menu should open on right click.
+ * @prop {boolean | undefined} closeOnScroll - Determines if the menu should close on scroll.
+ * @prop {boolean | undefined} persistOnItemClick - Determines if the menu open state should persist on click of a menu item.
+ * @prop {boolean | undefined} split - Determines if the menu is in split state.
+ * @prop {MenuList[]} slottedMenuList - Holds the slotted menu list.
+ * @prop {HTMLElement[]} slottedTriggers - Holds the slotted triggers.
+ * @prop {MenuPosition | undefined} menuPosition - Reflects the active resolved position (`"above"` or `"below"`). May
+ *   differ from the authored `menu-position` attribute when `reposition-mode="auto"` has flipped the menu.
+ * @prop {MenuRepositionMode | undefined} repositionMode - The active repositioning mode (`"auto"` | `"none"`).
+ * @prop {HTMLElement | undefined} overflowBoundary - An optional scrolling container used by the
+ *   `FlexiblePositionStrategy` as the collision boundary instead of the viewport. Only relevant when
+ *   `reposition-mode="auto"`.
+ *
+ * @slot primary-action - Slot for the primary action element (used when split is true).
+ * @slot trigger - Slot for the trigger element.
+ * @slot - Default slot for the menu list.
+ *
+ * @csspart trigger - Represents the trigger element of the menu.
+ * @csspart menu-list - Represents the menu list element.
+ *
+ * @method toggleMenu - Toggles the open state of the menu.
+ * @method closeMenu - Closes the menu.
+ * @method openMenu - Opens the menu.
+ * @method focusMenuList - Focuses on the menu list.
+ * @method focusTrigger - Focuses on the menu trigger.
+ * @method menuKeydownHandler - Handles keyboard interaction for the menu.
+ * @method triggerKeydownHandler - Handles keyboard interaction for the trigger.
+ *
+ * @fires toggle - Event fired when the menu is toggled.
+ * @fires change - Event fired when the state of a menu item changes.
+ *
+ * @extends FASTElement
+ * @tagname fabric-menu
+ * @public
+ */
+export declare class Menu extends FASTElement {
+    /**
+     * The positioning instance for the menu.
+     * @private
+     */
+    private positioning;
+    /**
+     * Determines if the menu should open on hover.
+     * @public
+     */
+    openOnHover?: boolean;
+    /**
+     * Determines if the menu should open on right click.
+     * @public
+     */
+    openOnContext?: boolean;
+    /**
+     * Determines if the menu should close on scroll.
+     * @public
+     */
+    closeOnScroll?: boolean;
+    /**
+     * Determines if the menu open state should persis on click of menu item
+     * @public
+     */
+    persistOnItemClick?: boolean;
+    /**
+     * Determines if the menu is in split state (for split button pattern).
+     * @public
+     */
+    split?: boolean;
+    /**
+     * Determines whether the menu list is above or below the trigger.
+     * @public
+     */
+    menuPosition?: MenuPosition;
+    /**
+     * Handles changes to the menuPosition attribute.
+     * Updates the positioning strategy and triggers a reposition if
+     * the menu is currently open, without mutating the public attribute.
+     * @public
+     */
+    menuPositionChanged(): void;
+    /**
+     * The mode for repositioning the menu when it overflows the boundary.
+     *
+     * Both modes render the menu list on the top layer via the popover API.
+     *
+     * - `"none"` (default) — uses CSS anchor positioning to keep the popover
+     *   attached to the trigger. No JS scroll/resize listeners are added.
+     *   The menu will not flip or resize to avoid overflow.
+     * - `"auto"` — uses `FlexiblePositionStrategy` for JS-based positioning.
+     *   On every resize and scroll event the strategy measures available space,
+     *   picks the best-fitting position from the preferred position plus its
+     *   fallbacks, and resizes the menu if there is not enough available space.
+     *
+     * @public
+     * @default "none"
+     */
+    repositionMode?: MenuRepositionMode;
+    /**
+     * An optional scrolling container used as the collision boundary by `FlexiblePositionStrategy`.
+     * When provided, the strategy measures overflow against this element's viewport instead of the
+     * document viewport. Only takes effect when `reposition-mode="auto"`.
+     *
+     * Scroll events on this element are listened to and trigger a debounced reposition while the menu
+     * is open.
+     *
+     * @public
+     */
+    overflowBoundary?: HTMLElement;
+    /**
+     * Holds the slotted menu list.
+     * @public
+     */
+    slottedMenuList: MenuList[];
+    /**
+     * Holds the slotted triggers.
+     * @public
+     */
+    slottedTriggers: HTMLElement[];
+    /**
+     * Handles menu list slot changes.
+     * @internal
+     */
+    private slottedMenuListChanged;
+    /**
+     * Handles trigger slot changes.
+     * @internal
+     */
+    private slottedTriggersChanged;
+    /**
+     * Defines whether the menu is open or not.
+     * @internal
+     */
+    private _open;
+    /**
+     * The trigger element of the menu.
+     * @internal
+     */
+    private _trigger?;
+    /**
+     * The menu list element of the menu.
+     * @internal
+     */
+    private _menuList?;
+    /**
+     * Auto-generated CSS anchor name for tying the popover to the trigger
+     * via CSS anchor positioning when `reposition-mode="none"`.
+     * @internal
+     */
+    private readonly _anchorName;
+    /**
+     * Updates menu list open state and ARIA expanded.
+     * @private
+     */
+    private setMenuOpenState;
+    /**
+     * Internal open handler used by multiple entry points.
+     * @private
+     */
+    private openMenuInternal;
+    /**
+     * Internal close handler used by multiple entry points.
+     * @private
+     */
+    private closeMenuInternal;
+    /**
+     * Delegates resize + flip logic to the positioning strategy.
+     * @private
+     */
+    private repositionMenu;
+    /**
+     * Schedules a reposition on the next microtask.
+     * @private
+     */
+    private scheduleReposition;
+    /**
+     * Handler for window resize/scroll changes.
+     * Called synchronously so the menu tracks the trigger without a frame of lag.
+     * @private
+     */
+    private handleWindowChanges;
+    /**
+     * Adds window event listeners.
+     * @private
+     */
+    private addWindowEventListeners;
+    /**
+     * Removes window event listeners.
+     * @private
+     */
+    private removeWindowEventListeners;
+    /**
+     * Adds overflow boundary event listeners.
+     * @private
+     */
+    private addOverflowBoundaryEventListeners;
+    /**
+     * Adds repositioning handlers.
+     * @private
+     */
+    private addRepositioningHandlers;
+    /**
+     * Creates the positioning manager.
+     * @private
+     */
+    private createPositioningManager;
+    /**
+     * Clears inline position styles written by JS positioning so that
+     * CSS anchor positioning rules can take effect.
+     * @private
+     */
+    private clearInlinePositionStyles;
+    /**
+     * Removes repositioning event listeners.
+     * @private
+     */
+    private removeRepositioningListeners;
+    /**
+     * Called when the element is connected to the DOM.
+     * @public
+     */
+    connectedCallback(): void;
+    /**
+     * Called when the element is disconnected from the DOM.
+     * @public
+     */
+    disconnectedCallback(): void;
+    /**
+     * Sets the component.
+     * @public
+     */
+    setComponent(): void;
+    /**
+     * Toggles the open state of the menu.
+     * @public
+     */
+    toggleMenu: () => void;
+    /**
+     * Closes the menu.
+     * @public
+     */
+    closeMenu: () => void;
+    /**
+     * Opens the menu.
+     * @public
+     */
+    openMenu: (e?: Event) => void;
+    /**
+     * Focuses on the menu list.
+     * @public
+     */
+    focusMenuList(): void;
+    /**
+     * Focuses on the menu trigger.
+     * @public
+     */
+    focusTrigger(): void;
+    /**
+     * Called whenever the 'openOnHover' property changes.
+     *
+     * @param oldValue - The previous value of 'openOnHover'.
+     * @param newValue - The new value of 'openOnHover'.
+     * @public
+     */
+    openOnHoverChanged(_oldValue: boolean, newValue: boolean): void;
+    /**
+     * Called whenever the 'persistOnItemClick' property changes.
+     *
+     * @public
+     * @param oldValue - The previous value of 'persistOnItemClick'.
+     * @param newValue - The new value of 'persistOnItemClick'.
+     */
+    persistOnItemClickChanged(_oldValue: boolean, newValue: boolean): void;
+    /**
+     * Called whenever the 'repositionMode' property changes.
+     *
+     * @public
+     * @param oldValue - The previous value of 'repositionMode'.
+     * @param newValue - The new value of 'repositionMode'.
+     */
+    repositionModeChanged(_oldValue: MenuRepositionMode, newValue: MenuRepositionMode): void;
+    /**
+     * Called whenever the 'overflowBoundary' property changes.
+     *
+     * @public
+     */
+    overflowBoundaryChanged(oldValue: HTMLElement | undefined, newValue: HTMLElement | undefined): void;
+    /**
+     * Called whenever the 'openOnContext' property changes.
+     *
+     * @public
+     * @param oldValue - The previous value of 'openOnContext'.
+     * @param newValue - The new value of 'openOnContext'.
+     */
+    openOnContextChanged(_oldValue: boolean, newValue: boolean): void;
+    /**
+     * Called whenever the 'closeOnScroll' property changes.
+     *
+     * @public
+     * @param oldValue - The previous value of 'closeOnScroll'.
+     * @param newValue - The new value of 'closeOnScroll'.
+     */
+    closeOnScrollChanged(_oldValue: boolean, newValue: boolean): void;
+    /**
+     * Adds event listeners.
+     *
+     * @internal
+     */
+    private addListeners;
+    /**
+     * Removes event listeners.
+     *
+     * @internal
+     */
+    private removeListeners;
+    /**
+     * Handles keyboard interaction for the menu. Closes the menu and focuses on the trigger when the Escape key is pressed.
+     *
+     * @param e - the keyboard event
+     * @public
+     */
+    menuKeydownHandler(e: KeyboardEvent): boolean | void;
+    /**
+     * Handles keyboard interaction for the trigger. Toggles the menu when the Space or Enter key is pressed.
+     *
+     * @param e - the keyboard event
+     * @public
+     */
+    triggerKeydownHandler: (e: KeyboardEvent) => boolean | void;
+    /**
+     * Handles document click events to close the menu when clicking outside (light dismiss).
+     * @internal
+     * @param e - The event triggered on document click.
+     */
+    private documentClickHandler;
+}
+//# sourceMappingURL=menu.d.ts.map

package/dts/components/menu/menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu.d.ts","sourceRoot":"","sources":["../../../../src/components/menu/menu.ts"],"names":[],"mappings":"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"}

package/dts/components/menu/menu.definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu.definition.d.ts","sourceRoot":"","sources":["../../../../src/components/menu/menu.definition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAKjC;;;;;GAKG;AACH,eAAO,MAAM,UAAU,sEAOrB,CAAC"}

package/dts/components/menu/menu.options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu.options.d.ts","sourceRoot":"","sources":["../../../../src/components/menu/menu.options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGtD;;;GAGG;AACH,eAAO,MAAM,aAAa;;;CAGhB,CAAC;AAEX;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;CAGtB,CAAC;AAEX;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dts/components/menu/menu.positioning.d.ts

@@ -0,0 +1,53 @@
+import { type MenuPosition } from "./menu.options.js";
+import { type RepositionResult } from "../../util/positioning/index.js";
+/**
+ * Options for the menu positioning manager
+ * @internal
+ */
+export interface MenuPositioningOptions {
+    menuReference: HTMLElement;
+    anchorReference: HTMLElement;
+    overflowBoundaryReference?: HTMLElement | null;
+}
+/**
+ * Positioning manager for menu component.
+ * Delegates all coordinate-based positioning to {@link FlexiblePositionStrategy}.
+ * @internal
+ */
+export declare class MenuPositioning {
+    private positionStrategy;
+    private readonly menuReference;
+    private readonly anchorReference;
+    private overflowBoundaryReference;
+    private _position;
+    set position(value: MenuPosition);
+    get position(): MenuPosition;
+    /**
+     * Updates the overflow boundary reference used for collision detection.
+     */
+    setOverflowBoundaryReference(boundary: HTMLElement | null | undefined): void;
+    constructor(options: MenuPositioningOptions);
+    /**
+     * Build the ordered list of candidate positions.
+     * The original position is always the first entry, followed by fallbacks.
+     */
+    private buildPositionCandidates;
+    /**
+     * Create a new immutable FlexiblePositionStrategy from current state.
+     * Returns null if required element references are not available.
+     */
+    private createPositionStrategy;
+    /**
+     * Performs a combined resize + auto reposition.
+     *
+     * Delegates to the {@link FlexiblePositionStrategy}'s `reposition()` method,
+     * which selects the best-fitting position from the original + fallbacks.
+     * Converts the selected `ConnectedPosition` back to a menu shorthand.
+     *
+     * After repositioning, updates the internal position shorthand.
+     *
+     * @returns The reposition result, or `null` if not configured.
+     */
+    reposition(): RepositionResult | null;
+}
+//# sourceMappingURL=menu.positioning.d.ts.map

package/dts/components/menu/menu.positioning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu.positioning.d.ts","sourceRoot":"","sources":["../../../../src/components/menu/menu.positioning.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAiB,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,iCAAiC,CAAC;AAgCzC;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,WAAW,CAAC;IAC3B,eAAe,EAAE,WAAW,CAAC;IAC7B,yBAAyB,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;CAChD;AAED;;;;GAIG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,gBAAgB,CAAyC;IACjE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAc;IAC5C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAc;IAC9C,OAAO,CAAC,yBAAyB,CAAqB;IAEtD,OAAO,CAAC,SAAS,CAAqC;IAEtD,IAAW,QAAQ,CAAC,KAAK,EAAE,YAAY,EAEtC;IAED,IAAW,QAAQ,IAAI,YAAY,CAElC;IAED;;OAEG;IACI,4BAA4B,CACjC,QAAQ,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,GACvC,IAAI;gBAIK,OAAO,EAAE,sBAAsB;IAM3C;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAY/B;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAmB9B;;;;;;;;;;OAUG;IACI,UAAU,IAAI,gBAAgB,GAAG,IAAI;CAsB7C"}