@fabric-msft/fabric-web 7.0.0 → 7.3.1

package/dts/components/dynamic-tab-list/dynamic-tab-list.d.ts

@@ -0,0 +1,360 @@
+import { FASTElement } from "@microsoft/fast-element";
+import type { DynamicTabListOrientation } from "./dynamic-tab-list.options.js";
+import type { DynamicTab } from "../dynamic-tab/dynamic-tab.js";
+/**
+ * Dynamic Tab List
+ * @summary A structural container for dynamic tabs with public methods for tab management.
+ *
+ * @remarks
+ * This component provides structure, emits events, and offers public helper methods
+ * for common tab operations (close, closeOthers, closeToRight, etc.).
+ * Context menus should be implemented by the consumer using the native Popover API,
+ * listening to the `context-menu` event for positioning coordinates.
+ *
+ * @example
+ * ```html
+ * <fabric-dynamic-tab-list activeid="tab-1" show-managed-tabs>
+ *   <fabric-dynamic-tab id="tab-1" selected>Document.docx</fabric-dynamic-tab>
+ *   <fabric-dynamic-tab id="tab-2">Photo.png</fabric-dynamic-tab>
+ *   <button slot="actions">+</button>
+ *   <button slot="manage-tabs">☰</button>
+ * </fabric-dynamic-tab-list>
+ * ```
+ *
+ * @attr {string} activeid - The id of the currently active/selected tab.
+ * @attr {DynamicTabListOrientation} orientation - The layout orientation.
+ * @attr {boolean} show-managed-tabs - When true, renders built-in manage tabs menu.
+ * @attr {string} close-unmodified-label - Label for "Close unmodified tabs" menu item (i18n).
+ * @attr {string} close-all-label - Label for "Close all tabs" menu item (i18n).
+ *
+ * @slot - Container for fabric-dynamic-tab elements.
+ * @slot actions - Optional action buttons between tabs and manage-tabs button.
+ * @slot manage-tabs - Trigger button for manage tabs menu (used when show-managed-tabs is true).
+ *
+ * @csspart tabs-container - The scrollable container for tab elements.
+ * @csspart actions-container - The container for action buttons and manage-tabs.
+ *
+ * @fires tab-dismiss - Fires when a tab's dismiss button is clicked or closeTab() is called.
+ * @fires tab-select - Fires when a tab is selected.
+ * @fires context-menu - Fires when a tab is right-clicked. Detail includes { id, clientX, clientY }.
+ *
+ * @extends FASTElement
+ * @tagname fabric-dynamic-tab-list
+ * @public
+ */
+export declare class DynamicTabList extends FASTElement {
+    /**
+     * The id of the currently active tab.
+     * @public
+     * @remarks
+     * HTML Attribute: `activeid`
+     */
+    activeid?: string;
+    /**
+     * The layout orientation of the tab list.
+     * @public
+     * @remarks
+     * HTML Attribute: `orientation`
+     */
+    orientation: DynamicTabListOrientation;
+    /**
+     * When true, renders a built-in manage tabs menu with "Close unmodified tabs",
+     * "Close all tabs" actions, and a list of all open tabs.
+     * @public
+     * @remarks
+     * HTML Attribute: `show-managed-tabs`
+     */
+    showManagedTabs: boolean;
+    /**
+     * Label for the "Close unmodified tabs" menu item.
+     * Override for i18n/localization.
+     * @public
+     * @remarks
+     * HTML Attribute: `close-unmodified-label`
+     */
+    closeUnmodifiedLabel: string;
+    /**
+     * Label for the "Close all tabs" menu item.
+     * Override for i18n/localization.
+     * @public
+     * @remarks
+     * HTML Attribute: `close-all-label`
+     */
+    closeAllLabel: string;
+    /**
+     * Label for the manage tabs button (accessibility).
+     * Override for i18n/localization.
+     * @public
+     * @remarks
+     * HTML Attribute: `manage-tabs-label`
+     */
+    manageTabsLabel: string;
+    /**
+     * The slotted tab elements.
+     * Exposed as public so consumers can access the tab list for their menu rendering.
+     * @public
+     */
+    tabs: DynamicTab[];
+    /**
+     * The ID of the tab that triggered the context menu.
+     * Exposed as public so consumers can access it for conditional menu rendering.
+     * @public
+     */
+    contextMenuTargetId: string | null;
+    /**
+     * Whether the context menu is currently open.
+     * @public
+     */
+    contextMenuOpen: boolean;
+    /**
+     * The X coordinate where the context menu was triggered.
+     * @public
+     */
+    contextMenuX: number;
+    /**
+     * The Y coordinate where the context menu was triggered.
+     * @public
+     */
+    contextMenuY: number;
+    /**
+     * Slotted manage-tabs trigger element(s).
+     * @internal
+     */
+    slottedManageTabsTrigger: HTMLElement[];
+    /**
+     * Whether the manage-tabs trigger should be interactive.
+     * True when the built-in menu is enabled or a custom trigger is slotted.
+     * @internal
+     */
+    get hasTrigger(): boolean;
+    /**
+     * Whether the manage tabs menu is currently open.
+     * Used for aria-expanded on the trigger.
+     * @internal
+     */
+    manageTabsMenuOpen: boolean;
+    /**
+     * Reference to the manage-tabs-menu popover element.
+     * @internal
+     */
+    private manageTabsMenuEl;
+    /**
+     * Roving focus controller for keyboard navigation.
+     * @internal
+     */
+    private focusController;
+    /**
+     * Flag to track if activeid change is from user gesture.
+     * Used to prevent emitting tab-select on programmatic changes.
+     * @internal
+     */
+    private isUserSelection;
+    /**
+     * Lifecycle callback - initialize focus controller.
+     * @internal
+     */
+    connectedCallback(): void;
+    /**
+     * Lifecycle callback - cleanup.
+     * @internal
+     */
+    disconnectedCallback(): void;
+    /**
+     * Bound handler for manage tabs menu light dismiss.
+     * @internal
+     */
+    private handleManageTabsLightDismiss;
+    /**
+     * Bound handler for manage tabs menu Escape key.
+     * @internal
+     */
+    private handleManageTabsEscape;
+    /**
+     * Set up light dismiss listeners for manage tabs menu.
+     * @internal
+     */
+    private setupManageTabsMenuListeners;
+    /**
+     * Remove light dismiss listeners for manage tabs menu.
+     * Optionally returns focus to the trigger button.
+     * @internal
+     */
+    private removeManageTabsMenuListeners;
+    /**
+     * Initialize the roving focus controller.
+     * @internal
+     */
+    private initializeFocusController;
+    /**
+     * Called when tabs change.
+     * Filters to only DynamicTab elements (excludes text nodes and other elements).
+     * Reconciles activeid if the active tab was removed externally.
+     * @internal
+     */
+    tabsChanged(): void;
+    /**
+     * Called when activeid changes.
+     * @internal
+     */
+    activeidChanged(oldValue: string | undefined, newValue: string | undefined): void;
+    /**
+     * Called when orientation changes - reinitialize focus controller.
+     * @internal
+     */
+    orientationChanged(): void;
+    /**
+     * Updates the selected state on all child tabs.
+     * @internal
+     */
+    private updateTabStates;
+    /**
+     * Handles tab dismiss events from child tabs.
+     * Manages focus transfer and re-emits the event with index for consumer handling.
+     * @internal
+     */
+    handleTabDismiss(event: CustomEvent<{
+        id: string;
+    }>): void;
+    /**
+     * Handles tab select events from child tabs.
+     * @internal
+     */
+    handleTabSelect(event: CustomEvent<{
+        id: string;
+    }>): void;
+    /**
+     * Handles right-click on tabs.
+     * Emits context-menu event with tab ID and cursor coordinates.
+     * Consumer implements their own context menu using native Popover API.
+     * @internal
+     */
+    handleTabContextMenu(event: MouseEvent): boolean;
+    /**
+     * Handles keyboard navigation using roving focus controller.
+     * @internal
+     */
+    handleKeydown(event: KeyboardEvent): boolean;
+    /**
+     * Handles focusin events to sync the focus controller.
+     * @internal
+     */
+    handleFocusin(event: FocusEvent): void;
+    /**
+     * Emits the tab-select event.
+     * @internal
+     */
+    private emitTabSelect;
+    /**
+     * Gets the tab that triggered the context menu.
+     * Useful for consumers to render menu items based on tab state.
+     * @public
+     */
+    getContextMenuTab(): DynamicTab | null;
+    /**
+     * Clears the context menu target ID and state.
+     * Call this when closing your context menu to reset state.
+     * @public
+     */
+    clearContextMenuTarget(): void;
+    /**
+     * Closes the context menu and resets all context menu state.
+     * @public
+     */
+    closeContextMenu(): void;
+    /**
+     * Toggles the manage tabs menu popover.
+     * @public
+     */
+    toggleManageTabsMenu(): void;
+    /**
+     * Closes the manage tabs menu.
+     * @public
+     */
+    closeManageTabsMenu(): void;
+    /**
+     * Requests closing a tab by ID.
+     * Emits `tab-dismiss` event for the consumer to handle DOM removal.
+     * If the tab had focus, moves focus to an adjacent tab.
+     * @param id - The ID of the tab to close
+     * @public
+     */
+    closeTab(id: string): void;
+    /**
+     * Requests closing all tabs except the specified one.
+     * Emits `tab-dismiss` events for each tab to close.
+     * @param id - The ID of the tab to keep open
+     * @public
+     */
+    closeOtherTabs(id: string): void;
+    /**
+     * Requests closing all tabs to the right of the specified tab.
+     * Emits `tab-dismiss` events for each tab to close.
+     * @param id - The ID of the anchor tab
+     * @public
+     */
+    closeTabsToRight(id: string): void;
+    /**
+     * Requests closing all tabs to the left of the specified tab.
+     * Emits `tab-dismiss` events for each tab to close.
+     * @param id - The ID of the anchor tab
+     * @public
+     */
+    closeTabsToLeft(id: string): void;
+    /**
+     * Requests closing all tabs.
+     * Emits `tab-dismiss` events for each tab.
+     * @public
+     */
+    closeAllTabs(): void;
+    /**
+     * Selects the next available tab after a tab is closed.
+     * Prefers the tab at the same index, then previous tabs.
+     * @param closedIndex - The index of the tab that was closed
+     * @internal
+     */
+    private selectNextAvailableTab;
+    /**
+     * Requests closing all tabs that are not marked as modified.
+     * Emits `tab-dismiss` events for each unmodified tab.
+     * Tabs with `modified === true` are preserved.
+     * @public
+     */
+    closeUnmodifiedTabs(): void;
+    /**
+     * Selects a tab from the manage tabs menu, focuses it, and closes the menu.
+     * @param tab - The tab to select
+     * @internal
+     */
+    selectTabFromManageMenu(tab: DynamicTab): void;
+    /**
+     * Closes the manage tabs menu popover and cleans up listeners.
+     * Used internally by built-in menu actions.
+     * @param restoreFocus - When true, returns focus to the trigger button.
+     * @internal
+     */
+    closeManageTabsMenuInternal(restoreFocus?: boolean): void;
+    /**
+     * Gets the display label for a tab in the manage tabs menu.
+     * Reads only the default slot's assigned content for a clean label,
+     * excluding named-slot content (icons, dismiss-icon) and shadow DOM text (hint spans).
+     * Falls back through: default slot text → aria-label → id
+     * @param tab - The tab to get the label for
+     * @returns The display label string
+     * @internal
+     */
+    getTabDisplayLabel(tab: DynamicTab): string;
+    /**
+     * Gets the filtered array of DynamicTab elements from the tabs slot.
+     * Filters out text nodes and non-tab elements.
+     * @returns Array of DynamicTab elements
+     * @public
+     */
+    getTabElements(): DynamicTab[];
+    /**
+     * Handles "Close all tabs" action from the built-in menu.
+     * Closes all tabs and then closes the menu.
+     * @internal
+     */
+    handleCloseAllFromMenu(): void;
+}
+//# sourceMappingURL=dynamic-tab-list.d.ts.map

package/dts/components/dynamic-tab-list/dynamic-tab-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-tab-list.d.ts","sourceRoot":"","sources":["../../../../src/components/dynamic-tab-list/dynamic-tab-list.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EAIZ,MAAM,yBAAyB,CAAC;AASjC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAC/E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,qBAAa,cAAe,SAAQ,WAAW;IAC7C;;;;;OAKG;IAEI,QAAQ,CAAC,EAAE,MAAM,CAAC;IAEzB;;;;;OAKG;IAEI,WAAW,EAAE,yBAAyB,CACL;IAExC;;;;;;OAMG;IAEI,eAAe,EAAE,OAAO,CAAS;IAExC;;;;;;OAMG;IAEI,oBAAoB,EAAE,MAAM,CAAM;IAEzC;;;;;;OAMG;IAEI,aAAa,EAAE,MAAM,CAAM;IAElC;;;;;;OAMG;IAEI,eAAe,EAAE,MAAM,CAAM;IAEpC;;;;OAIG;IAEI,IAAI,EAAE,UAAU,EAAE,CAAM;IAE/B;;;;OAIG;IAEI,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAEjD;;;OAGG;IAEI,eAAe,EAAE,OAAO,CAAS;IAExC;;;OAGG;IAEI,YAAY,EAAE,MAAM,CAAK;IAEhC;;;OAGG;IAEI,YAAY,EAAE,MAAM,CAAK;IAEhC;;;OAGG;IAEI,wBAAwB,EAAE,WAAW,EAAE,CAAM;IAEpD;;;;OAIG;IACH,IAAW,UAAU,IAAI,OAAO,CAE/B;IAED;;;;OAIG;IAEI,kBAAkB,EAAE,OAAO,CAAS;IAE3C;;;OAGG;IACH,OAAO,CAAC,gBAAgB,CAA4B;IAEpD;;;OAGG;IACH,OAAO,CAAC,eAAe,CAAsC;IAE7D;;;;OAIG;IACH,OAAO,CAAC,eAAe,CAAkB;IAEzC;;;OAGG;IACI,iBAAiB,IAAI,IAAI;IAqBhC;;;OAGG;IACI,oBAAoB,IAAI,IAAI;IAOnC;;;OAGG;IACH,OAAO,CAAC,4BAA4B,CAsBlC;IAEF;;;OAGG;IACH,OAAO,CAAC,sBAAsB,CAW5B;IAEF;;;OAGG;IACH,OAAO,CAAC,4BAA4B;IAKpC;;;;OAIG;IACH,OAAO,CAAC,6BAA6B;IAYrC;;;OAGG;IACH,OAAO,CAAC,yBAAyB;IAuBjC;;;;;OAKG;IACI,WAAW,IAAI,IAAI;IAyB1B;;;OAGG;IACI,eAAe,CACpB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC3B,IAAI;IAQP;;;OAGG;IACI,kBAAkB,IAAI,IAAI;IAQjC;;;OAGG;IACH,OAAO,CAAC,eAAe;IAYvB;;;;OAIG;IACI,gBAAgB,CAAC,KAAK,EAAE,WAAW,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI;IAsCjE;;;OAGG;IACI,eAAe,CAAC,KAAK,EAAE,WAAW,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI;IAqBhE;;;;;OAKG;IACI,oBAAoB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO;IAgCvD;;;OAGG;IACI,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO;IAQnD;;;OAGG;IACI,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAa7C;;;OAGG;IACH,OAAO,CAAC,aAAa;IAUrB;;;;OAIG;IACI,iBAAiB,IAAI,UAAU,GAAG,IAAI;IAK7C;;;;OAIG;IACI,sBAAsB,IAAI,IAAI;IAKrC;;;OAGG;IACI,gBAAgB,IAAI,IAAI;IAO/B;;;OAGG;IACI,oBAAoB,IAAI,IAAI;IA+BnC;;;OAGG;IACI,mBAAmB,IAAI,IAAI;IAWlC;;;;;;OAMG;IACI,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IA6BjC;;;;;OAKG;IACI,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAiBvC;;;;;OAKG;IACI,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAoBzC;;;;;OAKG;IACI,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAoBxC;;;;OAIG;IACI,YAAY,IAAI,IAAI;IAgB3B;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;IAuB9B;;;;;OAKG;IACI,mBAAmB,IAAI,IAAI;IAoBlC;;;;OAIG;IACI,uBAAuB,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI;IAcrD;;;;;OAKG;IACI,2BAA2B,CAAC,YAAY,GAAE,OAAc,GAAG,IAAI;IAWtE;;;;;;;;OAQG;IACI,kBAAkB,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM;IAmBlD;;;;;OAKG;IACI,cAAc,IAAI,UAAU,EAAE;IAOrC;;;;OAIG;IACI,sBAAsB,IAAI,IAAI;CAItC"}

package/dts/components/dynamic-tab-list/dynamic-tab-list.definition.d.ts

@@ -0,0 +1,7 @@
+import { DynamicTabList } from "./dynamic-tab-list.js";
+/**
+ * The Fabric DynamicTabList component definition.
+ * @public
+ */
+export declare const definition: import("@microsoft/fast-element").FASTElementDefinition<typeof DynamicTabList>;
+//# sourceMappingURL=dynamic-tab-list.definition.d.ts.map

package/dts/components/dynamic-tab-list/dynamic-tab-list.definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-tab-list.definition.d.ts","sourceRoot":"","sources":["../../../../src/components/dynamic-tab-list/dynamic-tab-list.definition.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAIvD;;;GAGG;AACH,eAAO,MAAM,UAAU,gFAOrB,CAAC"}

package/dts/components/dynamic-tab-list/dynamic-tab-list.options.d.ts

@@ -0,0 +1,24 @@
+import type { ValuesOf } from "../../util/typings.js";
+/**
+ * Dynamic Tab List orientations.
+ * @public
+ */
+export declare const DynamicTabListOrientations: {
+    readonly horizontal: "horizontal";
+    readonly vertical: "vertical";
+};
+/**
+ * Type describing orientation options for {@link DynamicTabList}.
+ * @public
+ */
+export type DynamicTabListOrientation = ValuesOf<typeof DynamicTabListOrientations>;
+/**
+ * Event names for {@link DynamicTabList}.
+ * @public
+ */
+export declare const DynamicTabListEventNames: {
+    readonly "tab-dismiss": "tab-dismiss";
+    readonly "tab-select": "tab-select";
+    readonly "context-menu": "context-menu";
+};
+//# sourceMappingURL=dynamic-tab-list.options.d.ts.map

package/dts/components/dynamic-tab-list/dynamic-tab-list.options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-tab-list.options.d.ts","sourceRoot":"","sources":["../../../../src/components/dynamic-tab-list/dynamic-tab-list.options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;;CAG7B,CAAC;AAEX;;;GAGG;AACH,MAAM,MAAM,yBAAyB,GAAG,QAAQ,CAC9C,OAAO,0BAA0B,CAClC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;CAI3B,CAAC"}

package/dts/components/dynamic-tab-list/dynamic-tab-list.styles.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Styles for the DynamicTabList component.
+ * @public
+ */
+export declare const styles: import("@microsoft/fast-element").ElementStyles;
+//# sourceMappingURL=dynamic-tab-list.styles.d.ts.map

package/dts/components/dynamic-tab-list/dynamic-tab-list.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-tab-list.styles.d.ts","sourceRoot":"","sources":["../../../../src/components/dynamic-tab-list/dynamic-tab-list.styles.ts"],"names":[],"mappings":"AAiBA;;;GAGG;AACH,eAAO,MAAM,MAAM,iDA+IlB,CAAC"}

package/dts/components/dynamic-tab-list/dynamic-tab-list.template.d.ts

@@ -0,0 +1,13 @@
+import type { ElementViewTemplate } from "@microsoft/fast-element";
+import type { DynamicTabList } from "./dynamic-tab-list.js";
+/**
+ * Template for the DynamicTabList component.
+ * @public
+ */
+export declare function dynamicTabListTemplate<T extends DynamicTabList>(): ElementViewTemplate<T>;
+/**
+ * The template for the DynamicTabList component.
+ * @public
+ */
+export declare const template: ElementViewTemplate<DynamicTabList>;
+//# sourceMappingURL=dynamic-tab-list.template.d.ts.map

package/dts/components/dynamic-tab-list/dynamic-tab-list.template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-tab-list.template.d.ts","sourceRoot":"","sources":["../../../../src/components/dynamic-tab-list/dynamic-tab-list.template.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAqE5D;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,CAAC,SAAS,cAAc,KACrB,mBAAmB,CAAC,CAAC,CAAC,CAqE1B;AAED;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAE,mBAAmB,CAAC,cAAc,CAC/B,CAAC"}

package/dts/components/dynamic-tab-list/index.d.ts

@@ -0,0 +1,7 @@
+export { DynamicTabList } from "./dynamic-tab-list.js";
+export { DynamicTabListOrientations, DynamicTabListEventNames } from "./dynamic-tab-list.options.js";
+export type { DynamicTabListOrientation } from "./dynamic-tab-list.options.js";
+export { template as DynamicTabListTemplate } from "./dynamic-tab-list.template.js";
+export { styles as DynamicTabListStyles } from "./dynamic-tab-list.styles.js";
+export { definition as DynamicTabListDefinition } from "./dynamic-tab-list.definition.js";
+//# sourceMappingURL=index.d.ts.map

package/dts/components/dynamic-tab-list/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/dynamic-tab-list/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,EACzB,MAAM,+BAA+B,CAAC;AACvC,YAAY,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAC/E,OAAO,EAAE,QAAQ,IAAI,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACpF,OAAO,EAAE,MAAM,IAAI,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAC9E,OAAO,EAAE,UAAU,IAAI,wBAAwB,EAAE,MAAM,kCAAkC,CAAC"}

package/dts/components/empty-state/define.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=define.d.ts.map

package/dts/components/empty-state/define.d.ts.map

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

package/dts/components/empty-state/empty-state.d.ts

@@ -0,0 +1,32 @@
+import { FASTElement } from "@microsoft/fast-element";
+/**
+ * EmptyState
+ * @summary A component for displaying empty states with optional illustration, title, body, link, and action.
+ *
+ * @example
+ * ```html
+ * <fabric-empty-state>
+ *   <img slot="illustration" src="illustration.svg" alt="" aria-hidden="true" />
+ *   <span slot="title">No items yet</span>
+ *   <span slot="body">Create an item to get started</span>
+ *   <fabric-link slot="link" href="#">Learn more</fabric-link>
+ *   <fabric-button slot="action">Create item</fabric-button>
+ * </fabric-empty-state>
+ * ```
+ *
+ * @slot illustration - Slot for an optional illustration or image.
+ * @slot title - Slot for the main title text.
+ * @slot body - Slot for optional body/description text.
+ * @slot link - Slot for an optional help or learn-more link.
+ * @slot action - Slot for an optional call-to-action button.
+ *
+ * @csspart illustration - The illustration container.
+ * @csspart content - The text and action content container.
+ *
+ * @extends FASTElement
+ * @tagname fabric-empty-state
+ * @public
+ */
+export declare class EmptyState extends FASTElement {
+}
+//# sourceMappingURL=empty-state.d.ts.map

package/dts/components/empty-state/empty-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"empty-state.d.ts","sourceRoot":"","sources":["../../../../src/components/empty-state/empty-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,UAAW,SAAQ,WAAW;CAAG"}

package/dts/components/empty-state/empty-state.definition.d.ts

@@ -0,0 +1,10 @@
+import { EmptyState } from "./empty-state.js";
+/**
+ * The Fabric EmptyState component.
+ *
+ * @public
+ * @remarks
+ * HTML Element: <fabric-empty-state>
+ */
+export declare const definition: import("@microsoft/fast-element").FASTElementDefinition<typeof EmptyState>;
+//# sourceMappingURL=empty-state.definition.d.ts.map

package/dts/components/empty-state/empty-state.definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"empty-state.definition.d.ts","sourceRoot":"","sources":["../../../../src/components/empty-state/empty-state.definition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAK9C;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,4EAOrB,CAAC"}

package/dts/components/empty-state/empty-state.styles.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Styles for the {@link EmptyState} component.
+ * @public
+ */
+export declare const styles: import("@microsoft/fast-element").ElementStyles;
+//# sourceMappingURL=empty-state.styles.d.ts.map

package/dts/components/empty-state/empty-state.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"empty-state.styles.d.ts","sourceRoot":"","sources":["../../../../src/components/empty-state/empty-state.styles.ts"],"names":[],"mappings":"AAgBA;;;GAGG;AACH,eAAO,MAAM,MAAM,iDA+ClB,CAAC"}

package/dts/components/empty-state/empty-state.template.d.ts

@@ -0,0 +1,9 @@
+import type { ElementViewTemplate } from "@microsoft/fast-element";
+import type { EmptyState } from "./empty-state.js";
+/**
+ * The template for the {@link @fabric-msft/fabric-web#(EmptyState:class)} component.
+ * @public
+ */
+export declare function emptyStateTemplate<T extends EmptyState>(): ElementViewTemplate<T>;
+export declare const template: ElementViewTemplate<EmptyState>;
+//# sourceMappingURL=empty-state.template.d.ts.map

package/dts/components/empty-state/empty-state.template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"empty-state.template.d.ts","sourceRoot":"","sources":["../../../../src/components/empty-state/empty-state.template.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,CAAC,SAAS,UAAU,KACjB,mBAAmB,CAAC,CAAC,CAAC,CAc1B;AAED,eAAO,MAAM,QAAQ,EAAE,mBAAmB,CAAC,UAAU,CAAwB,CAAC"}

package/dts/components/empty-state/index.d.ts

@@ -0,0 +1,5 @@
+export { EmptyState } from "./empty-state.js";
+export { definition as EmptyStateDefinition } from "./empty-state.definition.js";
+export { styles as EmptyStateStyles } from "./empty-state.styles.js";
+export { template as EmptyStateTemplate } from "./empty-state.template.js";
+//# sourceMappingURL=index.d.ts.map

package/dts/components/empty-state/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/empty-state/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,UAAU,IAAI,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACjF,OAAO,EAAE,MAAM,IAAI,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,QAAQ,IAAI,kBAAkB,EAAE,MAAM,2BAA2B,CAAC"}

package/dts/components/field/field.d.ts

@@ -33,19 +33,52 @@ import { Field as FluentField, type SlottableInput } from "@fluentui/web-compone
  * @public
  */
 export declare class Field extends FluentField {
+    /**
+     * Tracks slotted label elements that have had a click-forwarding listener
+     * attached, so we can detach the listener when the label is no longer slotted
+     * and avoid attaching duplicates on repeat invocations.
+     *
+     * @internal
+     */
+    private readonly _wiredLabelClickHandlers;
     /**
      * Sets ARIA and form-related attributes on slotted label elements.
      * Extends the base implementation to support custom label elements (e.g., fabric-label)
      * in addition to native HTMLLabelElement.
      *
      * @remarks
-     * The base FluentUI implementation only handles native `<label>` elements.
-     * This method ensures that custom elements like `<fabric-label>` are properly
-     * associated with the input via `aria-labelledby`, enabling screen reader support.
+     * The base FluentUI implementation only handles native `<label>` elements,
+     * which the browser natively wires for both `aria-labelledby` association
+     * and click-to-focus / click-to-toggle behavior via `<label htmlFor>`.
+     *
+     * Custom label elements like `<fabric-label>` extend `HTMLElement` rather
+     * than `HTMLLabelElement`, so neither piece is wired by the upstream
+     * implementation. This method:
+     *
+     * 1. Assigns `aria-labelledby` on the input so screen readers announce the
+     *    custom label as the input's accessible name.
+     * 2. Attaches a click listener to each non-native label that forwards the
+     *    click to the slotted input, emulating native `<label htmlFor>`
+     *    semantics (e.g., clicking the label toggles the radio/checkbox).
      *
      * @internal
      */
     private setLabelPropertiesExtended;
+    /**
+     * Attaches a click listener to a non-native label that forwards clicks to
+     * the slotted input, mirroring native `<label htmlFor>` click-to-toggle
+     * behavior. Idempotent — repeat calls with the same label are no-ops.
+     *
+     * @internal
+     */
+    private wireLabelClickForwarding;
+    /**
+     * Removes the click-forwarding listener from a label that is no longer
+     * slotted into this field.
+     *
+     * @internal
+     */
+    private unwireLabelClickForwarding;
     /**
      * Updates attributes on the slotted label elements.
      * Overrides base to add support for custom label elements.
@@ -55,6 +88,14 @@ export declare class Field extends FluentField {
      * @internal
      */
     labelSlotChanged(prev: Node[], next: Node[]): void;
+    /**
+     * Detaches any remaining click-forwarding listeners when the field is
+     * removed from the DOM. The listeners close over `this`, so without this
+     * cleanup a still-connected label could keep the field instance alive.
+     *
+     * @internal
+     */
+    disconnectedCallback(): void;
     /**
      * Updates the field's states and label properties when the assigned input changes.
      * Overrides base to add support for custom label elements.

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

@@ -1 +1 @@
-{"version":3,"file":"field.d.ts","sourceRoot":"","sources":["../../../../src/components/field/field.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,IAAI,WAAW,EACpB,KAAK,cAAc,EACpB,MAAM,0BAA0B,CAAC;AAGlC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,KAAM,SAAQ,WAAW;IACpC;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,0BAA0B;IAiClC;;;;;;;OAOG;IACM,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,IAAI;IAO3D;;;;;;;OAOG;IACM,YAAY,CACnB,IAAI,EAAE,cAAc,GAAG,SAAS,EAChC,IAAI,EAAE,cAAc,GAAG,SAAS,GAC/B,IAAI;CAMR"}
+{"version":3,"file":"field.d.ts","sourceRoot":"","sources":["../../../../src/components/field/field.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,IAAI,WAAW,EACpB,KAAK,cAAc,EACpB,MAAM,0BAA0B,CAAC;AAGlC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,KAAM,SAAQ,WAAW;IACpC;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAqC;IAE9E;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,OAAO,CAAC,0BAA0B;IAyClC;;;;;;OAMG;IACH,OAAO,CAAC,wBAAwB;IAmBhC;;;;;OAKG;IACH,OAAO,CAAC,0BAA0B;IAQlC;;;;;;;OAOG;IACM,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,IAAI;IAiB3D;;;;;;OAMG;IACM,oBAAoB,IAAI,IAAI;IAOrC;;;;;;;OAOG;IACM,YAAY,CACnB,IAAI,EAAE,cAAc,GAAG,SAAS,EAChC,IAAI,EAAE,cAAc,GAAG,SAAS,GAC/B,IAAI;CAMR"}

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

@@ -2,7 +2,7 @@ export { Menu } from "./menu.js";
 export { definition as MenuDefinition } from "./menu.definition.js";
 export { styles as MenuStyles } from "./menu.styles.js";
 export { template as MenuTemplate } from "./menu.template.js";
-export { MenuPositions, MenuRepositionModes } from "./menu.options.js";
-export type { MenuPosition, MenuRepositionMode } from "./menu.options.js";
+export { MenuAlignments, MenuPositions, MenuRepositionModes } from "./menu.options.js";
+export type { MenuAlignment, MenuPosition, MenuRepositionMode } from "./menu.options.js";
 export { MenuPositioning } from "./menu.positioning.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"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,EACL,cAAc,EACd,aAAa,EACb,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,aAAa,EACb,YAAY,EACZ,kBAAkB,EACnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}