@fluentui/web-components 3.0.0-beta.3 → 3.0.0-beta.31

package/dist/dts/form-associated/form-associated.d.ts

@@ -0,0 +1,104 @@
+import type { Constructable, FASTElement } from '@microsoft/fast-element';
+/**
+ * @alpha
+ */
+export declare const supportsElementInternals: boolean;
+/**
+ * Base class for providing Custom Element Form Association.
+ *
+ * @beta
+ */
+export interface FormAssociated extends Omit<ElementInternals, 'labels'> {
+    dirtyValue: boolean;
+    disabled: boolean;
+    readonly elementInternals: ElementInternals | null;
+    readonly formAssociated: boolean;
+    initialValue: string;
+    readonly labels: ReadonlyArray<Node[]>;
+    name: string;
+    required: boolean;
+    value: string;
+    currentValue: string;
+    attachProxy(): void;
+    detachProxy(): void;
+    disabledChanged?(previous: boolean, next: boolean): void;
+    formDisabledCallback?(disabled: boolean): void;
+    formResetCallback(): void;
+    initialValueChanged?(previous: string, next: string): void;
+    nameChanged?(previous: string, next: string): void;
+    requiredChanged(prev: boolean, next: boolean): void;
+    stopPropagation(e: Event): void;
+    /**
+     * Sets the validity of the custom element. By default this uses the proxy element to determine
+     * validity, but this can be extended or replaced in implementation.
+     *
+     * @param anchor - The anchor element to provide to ElementInternals.setValidity for surfacing the browser's constraint validation UI
+     */
+    validate(anchor?: HTMLElement): void;
+    valueChanged(previous: string, next: string): void;
+}
+/**
+ * Base class for providing Custom Element Form Association with checkable features.
+ *
+ * @beta
+ */
+export interface CheckableFormAssociated extends FormAssociated {
+    currentChecked: boolean;
+    dirtyChecked: boolean;
+    checkedAttribute: boolean;
+    defaultChecked: boolean;
+    defaultCheckedChanged(oldValue: boolean | undefined, newValue: boolean): void;
+    checked: boolean;
+    checkedChanged(oldValue: boolean | undefined, newValue: boolean): void;
+}
+/**
+ * Avaiable types for the `proxy` property.
+ * @beta
+ */
+export type ProxyElement = HTMLSelectElement | HTMLTextAreaElement | HTMLInputElement;
+/**
+ * Identifies a class as having a proxy element and optional submethods related
+ * to the proxy element.
+ *
+ * @beta
+ */
+export interface FormAssociatedProxy {
+    proxy: ProxyElement;
+    disabledChanged?(previous: boolean, next: boolean): void;
+    formDisabledCallback?(disabled: boolean): void;
+    formResetCallback?(): void;
+    initialValueChanged?(previous: string, next: string): void;
+    valueChanged?(previous: string, next: string): void;
+    nameChanged?(previous: string, next: string): void;
+}
+/**
+ * Combined type to describe a Form-associated element.
+ *
+ * @beta
+ */
+export type FormAssociatedElement = FormAssociated & FASTElement & HTMLElement & FormAssociatedProxy;
+/**
+ * Combined type to describe a checkable Form-associated element.
+ *
+ * @beta
+ */
+export type CheckableFormAssociatedElement = FormAssociatedElement & CheckableFormAssociated & {
+    proxy: HTMLInputElement;
+};
+/**
+ * Combined type to describe a Constructable Form-Associated type.
+ *
+ * @beta
+ */
+export type ConstructableFormAssociated = Constructable<HTMLElement & FASTElement>;
+/**
+ * Base function for providing Custom Element Form Association.
+ *
+ * @beta
+ */
+export declare function FormAssociated<T extends ConstructableFormAssociated>(BaseCtor: T): T;
+/**
+ * Creates a checkable form associated component.
+ * @beta
+ */
+export declare function CheckableFormAssociated<T extends ConstructableFormAssociated>(BaseCtor: T): T;

package/dist/dts/image/image.bench.d.ts

@@ -0,0 +1,3 @@
+declare const itemRenderer: () => HTMLElement;
+export default itemRenderer;
+export { tests } from '../utils/benchmark-wrapper.js';

package/dist/dts/image/image.options.d.ts

@@ -1,4 +1,4 @@
-import type { ValuesOf } from '@microsoft/fast-foundation/utilities.js';
+import type { ValuesOf } from '../utils/index.js';
 /**
  * Image fit
  * @public
@@ -14,7 +14,7 @@ export declare const ImageFit: {
  * Types for image fit
  * @public
  */
-export declare type ImageFit = ValuesOf<typeof ImageFit>;
+export type ImageFit = ValuesOf<typeof ImageFit>;
 /**
  * Image shape
  * @public
@@ -24,4 +24,4 @@ export declare const ImageShape: {
     readonly rounded: "rounded";
     readonly square: "square";
 };
-export declare type ImageShape = ValuesOf<typeof ImageShape>;
+export type ImageShape = ValuesOf<typeof ImageShape>;

package/dist/dts/image/index.d.ts

@@ -1,5 +1,5 @@
-export * from './image.js';
-export * from './image.options.js';
+export { Image } from './image.js';
+export { ImageFit, ImageShape } from './image.options.js';
 export { definition as ImageDefinition } from './image.definition.js';
 export { template as ImageTemplate } from './image.template.js';
 export { styles as ImageStyles } from './image.styles.js';

package/dist/dts/index-rollup.d.ts

@@ -1 +1,32 @@
-export * from './index.js';
+import './accordion-item/define.js';
+import './accordion/define.js';
+import './anchor-button/define.js';
+import './avatar/define.js';
+import './badge/define.js';
+import './button/define.js';
+import './checkbox/define.js';
+import './compound-button/define.js';
+import './counter-badge/define.js';
+import './dialog/define.js';
+import './dialog-body/define.js';
+import './divider/define.js';
+import './field/define.js';
+import './image/define.js';
+import './label/define.js';
+import './link/define.js';
+import './menu-button/define.js';
+import './menu-item/define.js';
+import './menu-list/define.js';
+import './menu/define.js';
+import './progress-bar/define.js';
+import './radio-group/define.js';
+import './radio/define.js';
+import './slider/define.js';
+import './spinner/define.js';
+import './switch/define.js';
+import './tab-panel/define.js';
+import './tab/define.js';
+import './tabs/define.js';
+import './text-input/define.js';
+import './text/define.js';
+import './toggle-button/define.js';

package/dist/dts/index.d.ts

@@ -1,30 +1,53 @@
-export * from './accordion/index.js';
-export * from './accordion-item/index.js';
-export * from './anchor-button/index.js';
-export * from './avatar/index.js';
-export * from './badge/index.js';
-export * from './button/index.js';
-export * from './checkbox/index.js';
-export * from './compound-button/index.js';
-export * from './counter-badge/index.js';
-export * from './divider/index.js';
-export * from './image/index.js';
-export * from './label/index.js';
-export * from './menu/index.js';
-export * from './menu-button/index.js';
-export * from './menu-item/index.js';
-export * from './menu-list/index.js';
-export * from './progress-bar/index.js';
-export * from './radio/index.js';
-export * from './radio-group/index.js';
-export * from './slider/index.js';
-export * from './spinner/index.js';
-export * from './switch/index.js';
-export * from './tabs/index.js';
-export * from './tab/index.js';
-export * from './tab-panel/index.js';
-export * from './text/index.js';
-export * from './text-input/index.js';
-export * from './toggle-button/index.js';
-export * from './fluent-design-system.js';
-export * from './theme/index.js';
+export { AccordionItem, accordionItemDefinition, AccordionItemExpandIconPosition, AccordionItemSize, accordionItemStyles, accordionItemTemplate, } from './accordion-item/index.js';
+export type { AccordionItemOptions } from './accordion-item/index.js';
+export { Accordion, accordionDefinition, AccordionExpandMode, accordionStyles, accordionTemplate, } from './accordion/index.js';
+export { Link, LinkAppearance, LinkDefinition, LinkTemplate, LinkTarget } from './link/index.js';
+export { Avatar, AvatarActive, AvatarAppearance, AvatarColor, AvatarDefinition, AvatarNamedColor, AvatarShape, AvatarSize, AvatarStyles, AvatarTemplate, } from './avatar/index.js';
+export { Badge, BadgeAppearance, BadgeColor, BadgeDefinition, BadgeShape, BadgeSize, BadgeStyles, BadgeTemplate, } from './badge/index.js';
+export { Button, ButtonAppearance, ButtonDefinition, ButtonFormTarget, ButtonShape, ButtonSize, ButtonStyles, ButtonTemplate, ButtonType, } from './button/index.js';
+export type { ButtonOptions } from './button/index.js';
+export { Checkbox, CheckboxDefinition, CheckboxShape, CheckboxSize, CheckboxStyles, CheckboxTemplate, } from './checkbox/index.js';
+export type { CheckboxOptions } from './checkbox/index.js';
+export { CompoundButton, CompoundButtonAppearance, CompoundButtonDefinition, CompoundButtonShape, CompoundButtonSize, CompoundButtonStyles, CompoundButtonTemplate, } from './compound-button/index.js';
+export { CounterBadge, CounterBadgeAppearance, CounterBadgeColor, CounterBadgeDefinition, CounterBadgeShape, CounterBadgeSize, CounterBadgeStyles, CounterBadgeTemplate, } from './counter-badge/index.js';
+export { Dialog, DialogType, DialogDefinition, DialogTemplate, DialogStyles } from './dialog/index.js';
+export { DialogBody, DialogBodyDefinition, DialogBodyTemplate, DialogBodyStyles } from './dialog-body/index.js';
+export { Divider, DividerAlignContent, DividerAppearance, DividerDefinition, DividerOrientation, DividerRole, DividerStyles, DividerTemplate, } from './divider/index.js';
+export { Field, FieldLabelPosition, ValidationFlags, FieldDefinition, FieldStyles, FieldTemplate, } from './field/index.js';
+export type { SlottableInput } from './field/index.js';
+export { FluentDesignSystem } from './fluent-design-system.js';
+export { Image, ImageDefinition, ImageFit, ImageShape, ImageStyles, ImageTemplate } from './image/index.js';
+export { Label, LabelDefinition, LabelSize, LabelStyles, LabelTemplate, LabelWeight } from './label/index.js';
+export { AnchorButton, AnchorButtonAppearance, AnchorButtonDefinition, AnchorButtonShape, AnchorButtonSize, AnchorButtonTemplate, AnchorTarget, } from './anchor-button/index.js';
+export { MenuButton, MenuButtonAppearance, MenuButtonDefinition, MenuButtonShape, MenuButtonSize, MenuButtonStyles, MenuButtonTemplate, } from './menu-button/index.js';
+export type { MenuButtonOptions } from './menu-button/index.js';
+export { MenuItem, MenuItemDefinition, MenuItemRole, MenuItemStyles, MenuItemTemplate, roleForMenuItem, } from './menu-item/index.js';
+export type { MenuItemColumnCount, MenuItemOptions } from './menu-item/index.js';
+export { MenuList, MenuListDefinition, MenuListStyles, MenuListTemplate } from './menu-list/index.js';
+export { Menu, MenuDefinition, MenuStyles, MenuTemplate } from './menu/index.js';
+export { ProgressBar, ProgressBarDefinition, ProgressBarShape, ProgressBarStyles, ProgressBarTemplate, ProgressBarThickness, ProgressBarValidationState, } from './progress-bar/index.js';
+export { RadioGroup, RadioGroupDefinition, RadioGroupOrientation, RadioGroupStyles, RadioGroupTemplate, } from './radio-group/index.js';
+export { Radio, RadioDefinition, RadioStyles, RadioTemplate } from './radio/index.js';
+export type { RadioControl, RadioOptions } from './radio/index.js';
+export { Slider, SliderDefinition, SliderMode, SliderOrientation, SliderSize, SliderStyles, SliderTemplate, } from './slider/index.js';
+export type { SliderConfiguration, SliderOptions } from './slider/index.js';
+export { Spinner, SpinnerAppearance, SpinnerDefinition, SpinnerSize, SpinnerStyles, SpinnerTemplate, } from './spinner/index.js';
+export { typographyBody1StrongerStyles, typographyBody1StrongStyles, typographyBody1Styles, typographyBody2Styles, typographyCaption1StrongerStyles, typographyCaption1StrongStyles, typographyCaption1Styles, typographyCaption2StrongStyles, typographyCaption2Styles, typographyDisplayStyles, typographyLargeTitleStyles, typographySubtitle1Styles, typographySubtitle2StrongerStyles, typographySubtitle2Styles, typographyTitle1Styles, typographyTitle2Styles, typographyTitle3Styles, } from './styles/partials/typography.partials.js';
+export { Switch, SwitchDefinition, SwitchLabelPosition, SwitchStyles, SwitchTemplate } from './switch/index.js';
+export type { SwitchOptions } from './switch/index.js';
+export { TabPanel, TabPanelDefinition, TabPanelStyles, TabPanelTemplate } from './tab-panel/index.js';
+export { Tab, TabDefinition, TabStyles, TabTemplate } from './tab/index.js';
+export type { TabOptions } from './tab/index.js';
+export { Tabs, TabsAppearance, TabsDefinition, TabsOrientation, TabsSize, TabsStyles, TabsTemplate, } from './tabs/index.js';
+export type { TabsOptions } from './tabs/index.js';
+export { TextInput, TextInputAppearance, TextInputControlSize, TextInputDefinition, TextInputStyles, TextInputTemplate, TextInputType, } from './text-input/index.js';
+export type { TextInputOptions } from './text-input/index.js';
+export { Text, TextAlign, TextDefinition, TextFont, TextSize, TextStyles, TextTemplate, TextWeight, } from './text/index.js';
+export * from './theme/design-tokens.js';
+export { setTheme, setThemeFor } from './theme/index.js';
+export { ToggleButton, ToggleButtonAppearance, ToggleButtonDefinition, ToggleButtonShape, ToggleButtonSize, ToggleButtonStyles, ToggleButtonTemplate, } from './toggle-button/index.js';
+export type { ToggleButtonOptions } from './toggle-button/index.js';
+export { darkModeStylesheetBehavior, forcedColorsStylesheetBehavior, lightModeStylesheetBehavior, MatchMediaBehavior, MatchMediaStyleSheetBehavior, } from './utils/behaviors/match-media-stylesheet-behavior.js';
+export type { MediaQueryListListener } from './utils/behaviors/match-media-stylesheet-behavior.js';
+export { getDirection } from './utils/direction.js';
+export { display } from './utils/display.js';

package/dist/dts/label/index.d.ts

@@ -1,4 +1,5 @@
-export * from './label.js';
+export { Label } from './label.js';
+export { LabelSize, LabelWeight } from './label.options.js';
 export { definition as LabelDefinition } from './label.definition.js';
 export { styles as LabelStyles } from './label.styles.js';
 export { template as LabelTemplate } from './label.template.js';

package/dist/dts/label/label.bench.d.ts

@@ -0,0 +1,3 @@
+declare const itemRenderer: () => HTMLElement;
+export default itemRenderer;
+export { tests } from '../utils/benchmark-wrapper.js';

package/dist/dts/label/label.d.ts

@@ -9,7 +9,6 @@ export declare class Label extends FASTElement {
      * 	Specifies font size of a label
      *
      * @public
-     * @default 'medium'
      * @remarks
      * HTML Attribute: size
      */
@@ -18,7 +17,6 @@ export declare class Label extends FASTElement {
      * 	Specifies font weight of a label
      *
      * @public
-     * @default 'regular'
      * @remarks
      * HTML Attribute: weight
      */

package/dist/dts/label/label.options.d.ts

@@ -1,4 +1,4 @@
-import type { ValuesOf } from '@microsoft/fast-foundation/utilities.js';
+import type { ValuesOf } from '../utils/index.js';
 /**
  * A Labels font size can be small, medium, or large
  */
@@ -11,7 +11,7 @@ export declare const LabelSize: {
  * Applies font size to label
  * @public
  */
-export declare type LabelSize = ValuesOf<typeof LabelSize>;
+export type LabelSize = ValuesOf<typeof LabelSize>;
 /**
  * A label can have a font weight of regular or strong
  */
@@ -23,4 +23,4 @@ export declare const LabelWeight: {
  * Applies font weight to label
  * @public
  */
-export declare type LabelWeight = ValuesOf<typeof LabelWeight>;
+export type LabelWeight = ValuesOf<typeof LabelWeight>;

package/dist/dts/link/define.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/dts/link/index.d.ts

@@ -0,0 +1,4 @@
+export { definition as LinkDefinition } from './link.definition.js';
+export { Link } from './link.js';
+export { LinkAppearance, LinkTarget } from './link.options.js';
+export { template as LinkTemplate } from './link.template.js';

package/dist/dts/link/link.bench.d.ts

@@ -0,0 +1,3 @@
+declare const itemRenderer: () => HTMLElement;
+export default itemRenderer;
+export { tests } from '../utils/benchmark-wrapper.js';

package/dist/dts/link/link.d.ts

@@ -0,0 +1,33 @@
+import { BaseAnchor } from '../anchor-button/anchor-button.js';
+import { type LinkAppearance } from './link.options.js';
+/**
+ * An Anchor Custom HTML Element.
+ * Based largely on the {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a | <a> element }.
+ *
+ * @slot start - Content which can be provided before the link content
+ * @slot end - Content which can be provided after the link content
+ * @slot - The default slot for link content
+ *
+ * @public
+ */
+export declare class Link extends BaseAnchor {
+    /**
+     * The appearance the link should have.
+     *
+     * @public
+     * @remarks
+     * HTML Attribute: `appearance`
+     */
+    appearance?: LinkAppearance | undefined;
+    /**
+     * The link is inline with text
+     * In chromium browsers, if the link is contained within a semantic
+     * text element (`h1`, `h2`, `h3`, `h4`, `h5`, `h6`, `p`) or `fluent-text`,
+     * `:host-context()` ensures inline links are styled appropriately.
+     *
+     * @public
+     * @remarks
+     * HTML Attribute: `inline`
+     */
+    inline: boolean;
+}

package/dist/dts/link/link.definition.d.ts

@@ -0,0 +1,7 @@
+import { Link } from './link.js';
+/**
+ * @public
+ * @remarks
+ * HTML Element: \<fluent-link\>
+ */
+export declare const definition: import("@microsoft/fast-element").FASTElementDefinition<typeof Link>;

package/dist/dts/link/link.options.d.ts

@@ -0,0 +1,52 @@
+import { AnchorTarget } from '../anchor-button/anchor-button.options.js';
+import type { ValuesOf } from '../utils/index.js';
+/**
+ * Link Appearance constants
+ * @public
+ */
+export declare const LinkAppearance: {
+    readonly subtle: "subtle";
+};
+/**
+ * An Link can be subtle or the default appearance
+ * @public
+ */
+export type LinkAppearance = ValuesOf<typeof LinkAppearance>;
+/**
+ * Link target values.
+ *
+ * @public
+ */
+export declare const LinkTarget: {
+    readonly _self: "_self";
+    readonly _blank: "_blank";
+    readonly _parent: "_parent";
+    readonly _top: "_top";
+};
+/**
+ * Type for link target values.
+ *
+ * @public
+ */
+export type LinkTarget = ValuesOf<typeof AnchorTarget>;
+/**
+ * Reflected link attributes.
+ *
+ * @public
+ */
+export declare const LinkAttributes: {
+    readonly download: "download";
+    readonly href: "href";
+    readonly hreflang: "hreflang";
+    readonly ping: "ping";
+    readonly referrerpolicy: "referrerpolicy";
+    readonly rel: "rel";
+    readonly target: "target";
+    readonly type: "type";
+};
+/**
+ * Type for link attributes.
+ *
+ * @public
+ */
+export type LinkAttributes = ValuesOf<typeof LinkAttributes>;

package/dist/dts/link/link.styles.d.ts

@@ -0,0 +1 @@
+export declare const styles: import("@microsoft/fast-element").ElementStyles;

package/dist/dts/link/link.template.d.ts

@@ -0,0 +1,12 @@
+import { ElementViewTemplate, ViewTemplate } from '@microsoft/fast-element';
+import type { Link } from './link.js';
+/**
+ * The template for the Link component.
+ * @public
+ */
+export declare function anchorTemplate<T extends Link>(): ViewTemplate<T>;
+/**
+ * The template for the Link component.
+ * @public
+ */
+export declare const template: ElementViewTemplate<Link>;

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

@@ -1,4 +1,4 @@
-export * from './menu.js';
+export { Menu } from './menu.js';
 export { template as MenuTemplate } from './menu.template.js';
 export { styles as MenuStyles } from './menu.styles.js';
 export { definition as MenuDefinition } from './menu.definition.js';

package/dist/dts/menu/menu.bench.d.ts

@@ -0,0 +1,3 @@
+declare const itemRenderer: () => HTMLElement;
+export default itemRenderer;
+export { tests } from '../utils/benchmark-wrapper.js';

package/dist/dts/menu/menu.d.ts

@@ -47,12 +47,12 @@ export declare class Menu extends FASTElement {
     positioningContainer?: HTMLElement;
     /**
      * The trigger element of the menu.
-     * @private
+     * @internal
      */
     private _trigger?;
     /**
      * The menu list element of the menu.
-     * @private
+     * @internal
      */
     private _menuList?;
     /**
@@ -108,51 +108,53 @@ export declare class Menu extends FASTElement {
      * Updates the 'aria-expanded' attribute and sets the positioning of the menu.
      * Sets menu list position
      * emits openChanged event
+     *
+     * @param oldValue - The previous value of 'open'.
+     * @param newValue - The new value of 'open'.
      * @public
-     * @param {boolean} oldValue - The previous value of 'open'.
-     * @param {boolean} newValue - The new value of 'open'.
      */
     openChanged(oldValue: boolean, newValue: boolean): void;
     /**
      * Called whenever the 'openOnHover' property changes.
      * Adds or removes a 'mouseover' event listener to the trigger based on the new value.
+     *
+     * @param oldValue - The previous value of 'openOnHover'.
+     * @param newValue - The new value of 'openOnHover'.
      * @public
-     * @param {boolean} oldValue - The previous value of 'openOnHover'.
-     * @param {boolean} newValue - The new value of 'openOnHover'.
      */
     openOnHoverChanged(oldValue: boolean, newValue: boolean): void;
     /**
      * Called whenever the 'persistOnItemClick' property changes.
      * Adds or removes a 'click' event listener to the menu list based on the new value.
      * @public
-     * @param {boolean} oldValue - The previous value of 'persistOnItemClick'.
-     * @param {boolean} newValue - The new value of 'persistOnItemClick'.
+     * @param oldValue - The previous value of 'persistOnItemClick'.
+     * @param newValue - The new value of 'persistOnItemClick'.
      */
     persistOnItemClickChanged(oldValue: boolean, newValue: boolean): void;
     /**
      * Called whenever the 'openOnContext' property changes.
      * Adds or removes a 'contextmenu' event listener to the trigger based on the new value.
      * @public
-     * @param {boolean} oldValue - The previous value of 'openOnContext'.
-     * @param {boolean} newValue - The new value of 'openOnContext'.
+     * @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.
      * Adds or removes a 'closeOnScroll' event listener to the trigger based on the new value.
      * @public
-     * @param {boolean} oldValue - The previous value of 'closeOnScroll'.
-     * @param {boolean} newValue - The new value of 'closeOnScroll'.
+     * @param oldValue - The previous value of 'closeOnScroll'.
+     * @param newValue - The new value of 'closeOnScroll'.
      */
     closeOnScrollChanged(oldValue: boolean, newValue: boolean): void;
     /**
      * The task to set the positioning of the menu.
-     * @protected
+     * @internal
      */
     protected setPositioningTask: () => void;
     /**
      * Sets the positioning of the menu.
-     * @protected
+     * @internal
      */
     protected setPositioning(): void;
     /**
@@ -166,29 +168,29 @@ export declare class Menu extends FASTElement {
      * Removes event listeners.
      * Removes click and keydown event listeners from the trigger and a click event listener from the document.
      * Also removes 'mouseover' event listeners from the trigger.
-     * @private
+     * @internal
      */
     private removeListeners;
     /**
-     * Handles keyboard interaction for the menu.
-     * Closes the menu and focuses on the trigger when the Escape key is pressed.
-     * Closes the menu when the Tab key is pressed.
+     * Handles keyboard interaction for the menu. Closes the menu and focuses on the trigger when the Escape key is
+     * pressed. Closes the menu when the Tab key is pressed.
+     *
+     * @param e - the keyboard event
      * @public
-     * @param {KeyboardEvent} e - the keyboard event
      */
     handleMenuKeydown(e: KeyboardEvent): boolean | void;
     /**
-     * Handles keyboard interaction for the trigger.
-     * Toggles the menu when the Space or Enter key is pressed.
-     * If the menu is open, focuses on the menu list.
+     * Handles keyboard interaction for the trigger. Toggles the menu when the Space or Enter key is pressed. If the menu
+     * is open, focuses on the menu list.
+     *
+     * @param e - the keyboard event
      * @public
-     * @param {KeyboardEvent} e - the keyboard event
      */
     handleTriggerKeydown: (e: KeyboardEvent) => boolean | void;
     /**
      * Handles document click events to close the menu when a click occurs outside of the menu or the trigger.
-     * @private
-     * @param {Event} e - The event triggered on document click.
+     * @internal
+     * @param e - The event triggered on document click.
      */
     private handleDocumentClick;
 }

package/dist/dts/menu-button/index.d.ts

@@ -1,5 +1,6 @@
-export * from './menu-button.js';
-export * from './menu-button.options.js';
-export { template as MenuButtonTemplate } from './menu-button.template.js';
 export { styles as MenuButtonStyles } from '../button/button.styles.js';
 export { definition as MenuButtonDefinition } from './menu-button.definition.js';
+export { MenuButton } from './menu-button.js';
+export { MenuButtonAppearance, MenuButtonShape, MenuButtonSize } from './menu-button.options.js';
+export type { MenuButtonOptions } from './menu-button.options.js';
+export { template as MenuButtonTemplate } from './menu-button.template.js';

package/dist/dts/menu-button/menu-button.bench.d.ts

@@ -0,0 +1,3 @@
+declare const itemRenderer: () => HTMLElement;
+export default itemRenderer;
+export { tests } from '../utils/benchmark-wrapper.js';

package/dist/dts/menu-button/menu-button.definition.d.ts

@@ -1,8 +1,5 @@
 import { MenuButton } from './menu-button.js';
 /**
- * The Fluent Menu Button Element. Implements {@link @microsoft/fast-foundation#Button },
- * {@link @microsoft/fast-foundation#buttonTemplate}
- *
  * @public
  * @remarks
  * HTML Element: \<fluent-button\>

package/dist/dts/menu-button/menu-button.options.d.ts

@@ -1,5 +1,5 @@
-import type { ButtonOptions } from '@microsoft/fast-foundation/button.js';
-import type { ValuesOf } from '@microsoft/fast-foundation/utilities.js';
+import type { ButtonOptions } from '../button/button.options.js';
+import type { ValuesOf } from '../utils/index.js';
 /**
  * Menu Button Appearance constants
  * @public
@@ -8,14 +8,13 @@ export declare const MenuButtonAppearance: {
     readonly primary: "primary";
     readonly outline: "outline";
     readonly subtle: "subtle";
-    readonly secondary: "secondary";
     readonly transparent: "transparent";
 };
 /**
  * A Menu Button can be secondary, primary, outline, subtle, transparent
  * @public
  */
-export declare type MenuButtonAppearance = ValuesOf<typeof MenuButtonAppearance>;
+export type MenuButtonAppearance = ValuesOf<typeof MenuButtonAppearance>;
 /**
  * A Menu Button can be square, circular or rounded.
  * @public
@@ -29,7 +28,7 @@ export declare const MenuButtonShape: {
  * A Menu Button can be square, circular or rounded
  * @public
  */
-export declare type MenuButtonShape = ValuesOf<typeof MenuButtonShape>;
+export type MenuButtonShape = ValuesOf<typeof MenuButtonShape>;
 /**
  * A Menu Button can be a size of small, medium or large.
  * @public
@@ -43,5 +42,5 @@ export declare const MenuButtonSize: {
  * A Menu Button can be on of several preset sizes.
  * @public
  */
-export declare type MenuButtonSize = ValuesOf<typeof MenuButtonSize>;
-export { ButtonOptions as MenuButtonOptions };
+export type MenuButtonSize = ValuesOf<typeof MenuButtonSize>;
+export type { ButtonOptions as MenuButtonOptions };