@fluentui/react-button 9.0.0-alpha.10 → 9.0.0-alpha.100

package/dist/react-button.d.ts

@@ -1,110 +1,232 @@
-import { ComponentProps } from '@fluentui/react-utilities';
-import { ObjectShorthandProps } from '@fluentui/react-utilities';
-import * as React from 'react';
-import { ShorthandProps } from '@fluentui/react-utilities';
+import { ARIAButtonShorthandProps } from '@fluentui/react-aria';
+import type { ComponentProps } from '@fluentui/react-utilities';
+import type { ComponentState } from '@fluentui/react-utilities';
+import { ForwardRefComponent } from '@fluentui/react-utilities';
+import type { IntrinsicShorthandProps } from '@fluentui/react-utilities';
+import type { MenuTriggerChildProps } from '@fluentui/react-menu';
+import type { ObjectShorthandProps } from '@fluentui/react-utilities';
+import * as React_2 from 'react';
 
 /**
- * Define a styled Button, using the `useButton` hook.
- * {@docCategory Button}
+ * Buttons give people a way to trigger an action.
  */
-export declare const Button: React.ForwardRefExoticComponent<import("@fluentui/react-utilities").ComponentProps & React.ButtonHTMLAttributes<HTMLElement> & {
-    icon?: import("@fluentui/react-utilities").ShorthandProps<React.HTMLAttributes<HTMLSpanElement>>;
-    disabled?: boolean | undefined;
-    iconOnly?: boolean | undefined;
-    iconPosition?: "after" | "before" | undefined;
-    primary?: boolean | undefined;
-    size?: "small" | "large" | undefined;
-} & React.RefAttributes<HTMLElement>>;
-
-export declare type ButtonProps = ComponentProps & React.ButtonHTMLAttributes<HTMLElement> & {
-    /**
-     * Shorthand icon. A shorthand prop can be a literal, object, or
-     * JSX. The `children` prop of the object can be a render function,
-     * taking in the original slot component and props.
-     */
-    icon?: ShorthandProps<React.HTMLAttributes<HTMLSpanElement>>;
-    /** A button can show that it cannot be interacted with. */
-    disabled?: boolean;
-    /** A button can contain only an icon. */
-    iconOnly?: boolean;
-    /** An icon button can format its icon to appear before or after its content. */
-    iconPosition?: 'before' | 'after';
-    /** A button can emphasize that it represents the primary action. */
-    primary?: boolean;
-    /** A button can be sized. */
-    size?: 'small' | 'large';
+export declare const Button: ForwardRefComponent<ButtonProps>;
+
+export declare type ButtonCommons = {
+    /**
+     * A button can have its content and borders styled for greater emphasis or to be subtle.
+     * - 'primary': Emphasizes the button as a primary action.
+     * - 'outline': Removes background styling.
+     * - 'subtle': Minimizes emphasis to blend into the background until hovered or focused.
+     * - 'transparent': Removes background and border styling.
+     */
+    appearance?: 'primary' | 'outline' | 'subtle' | 'transparent';
+    /**
+     * A button can fill the width of its container.
+     * @default false
+     */
+    block: boolean;
+    /**
+     * When set, allows the button to be focusable even when it has been disabled. This is used in scenarios where it
+     * is important to keep a consistent tab order for screen reader and keyboard users. The primary example of this
+     * pattern is when the disabled button is in a menu or a commandbar and is seldom used for standalone buttons.
+     * @default false
+     */
+    disabledFocusable: boolean;
+    /**
+     * A button can show that it cannot be interacted with.
+     * @default false
+     */
+    disabled: boolean;
+    /**
+     * A button can format its icon to appear before or after its content.
+     * @default 'before'
+     */
+    iconPosition: 'before' | 'after';
+    /**
+     * A button can be rounded, circular, or square.
+     * @default 'rounded'
+     */
+    shape: 'rounded' | 'circular' | 'square';
+    /**
+     * A button supports different sizes.
+     * @default 'medium'
+     */
+    size: 'small' | 'medium' | 'large';
+};
+
+export declare type ButtonProps = ComponentProps<ButtonSlots> & Partial<ButtonCommons>;
+
+export declare type ButtonSlots = {
+    /**
+     * Root of the component that renders as either a <button> tag.
+     */
+    root: ARIAButtonShorthandProps;
+    /**
+     * Icon that renders either before or after the `children` as specified by the `iconPosition` prop.
+     */
+    icon?: IntrinsicShorthandProps<'span'>;
+};
+
+export declare type ButtonState = ComponentState<ButtonSlots> & ButtonCommons & {
+    /**
+     * A button can contain only an icon.
+     * @default false
+     */
+    iconOnly: boolean;
 };
 
 /**
- * Consts listing which props are shorthand props.
+ * CompoundButtons are buttons that can have secondary content that adds extra information to the user.
  */
-export declare const buttonShorthandProps: string[];
+export declare const CompoundButton: ForwardRefComponent<CompoundButtonProps>;
+
+export declare type CompoundButtonProps = ComponentProps<CompoundButtonSlots> & Partial<ButtonCommons>;
+
+export declare type CompoundButtonSlots = ButtonSlots & {
+    /**
+     * Second line of text that describes the action this button takes.
+     */
+    secondaryContent?: IntrinsicShorthandProps<'span'>;
+    /**
+     * Container that wraps the children and the secondaryContent slot.
+     */
+    contentContainer: IntrinsicShorthandProps<'span'>;
+};
+
+export declare type CompoundButtonState = ComponentState<CompoundButtonSlots> & Omit<ButtonState, keyof ButtonSlots | 'components'>;
 
 /**
- * {@docCategory Button}
+ * MenuButtons are buttons that handle opening and closing a menu when they are triggered.
  */
-export declare interface ButtonState extends ButtonProps {
-    ref: React.RefObject<HTMLButtonElement>;
-    icon?: ObjectShorthandProps<React.HTMLAttributes<HTMLSpanElement>>;
-    children?: ObjectShorthandProps<React.HTMLAttributes<HTMLSpanElement>>;
-}
-
-export declare type ButtonStyleSelectors = {
-    disabled?: boolean;
-    iconOnly?: boolean;
-    primary?: boolean;
-    size?: string;
+export declare const MenuButton: ForwardRefComponent<MenuButtonProps>;
+
+export declare type MenuButtonProps = ComponentProps<MenuButtonSlots> & Partial<Omit<ButtonCommons, 'iconPosition'>> & Partial<MenuTriggerChildProps>;
+
+export declare type MenuButtonSlots = ButtonSlots & {
+    /**
+     * Menu icon that indicates that this button has a menu that can be expanded.
+     */
+    menuIcon?: IntrinsicShorthandProps<'span'>;
 };
 
-export declare type ButtonTokens = {
-    height: string;
-    paddingX: string;
-    paddingY: string;
-    minWidth: string;
-    maxWidth: string;
-    fontSize: string;
-    fontWeight: number;
-    lineHeight: string;
-    iconWidth: string;
-    iconHeight: string;
-    iconSpacing: string;
-    color: string;
-    content2Color: string;
-    background: string;
-    backgroundHover: string;
-    backgroundPressed: string;
-    backgroundActive: string;
-    borderColor: string;
-    borderColorHover: string;
-    borderColorActive: string;
-    borderWidth: string;
-    borderRadius: string;
-    shadow: string;
-    shadowPressed: string;
+export declare type MenuButtonState = ComponentState<MenuButtonSlots> & Omit<ButtonState, keyof ButtonSlots | 'components' | 'iconPosition'>;
+
+/**
+ * Renders a Button component by passing the state defined props to the appropriate slots.
+ */
+declare const renderButton: (state: ButtonState) => JSX.Element;
+export { renderButton }
+export { renderButton as renderToggleButton }
+
+/**
+ * Renders a CompoundButton component by passing the state defined props to the appropriate slots.
+ */
+export declare const renderCompoundButton: (state: CompoundButtonState) => JSX.Element;
+
+/**
+ * Renders a MenuButton component by passing the state defined props to the appropriate slots.
+ */
+export declare const renderMenuButton: (state: MenuButtonState) => JSX.Element;
+
+/**
+ * Renders a SplitButton component by passing the state defined props to the appropriate slots.
+ */
+export declare const renderSplitButton: (state: SplitButtonState) => JSX.Element;
+
+/**
+ * SplitButtons are a grouping of two interactive surfaces where the interacting with the first one triggers a primary
+ * action, while interacting with the second one opens a menu with secondary actions.
+ */
+export declare const SplitButton: ForwardRefComponent<SplitButtonProps>;
+
+export declare type SplitButtonProps = ComponentProps<SplitButtonSlots> & Omit<ButtonProps, 'root'> & Omit<MenuButtonProps, 'root'>;
+
+export declare type SplitButtonSlots = {
+    /**
+     * Root of the component that wraps the primary action button and menu button.
+     */
+    root: IntrinsicShorthandProps<'div'>;
+    /**
+     * Button that opens menu with secondary actions in SplitButton.
+     */
+    menuButton?: ObjectShorthandProps<MenuButtonProps>;
+    /**
+     * Button to perform primary action in SplitButton.
+     */
+    primaryActionButton?: ObjectShorthandProps<ButtonProps>;
 };
 
-export declare type ButtonVariants = 'base' | 'disabled' | 'iconOnly' | 'primary' | 'small' | 'large' | 'primaryDisabled' | 'iconOnlySmall' | 'iconOnlyLarge';
+export declare type SplitButtonState = ComponentState<SplitButtonSlots> & Omit<ButtonState, 'components' | 'iconOnly' | 'root'> & Omit<MenuButtonState, 'components' | 'iconOnly' | 'root'>;
 
-export declare type ButtonVariantTokens = {
-    [variant in ButtonVariants]: Partial<ButtonTokens>;
+/**
+ * ToggleButtons are buttons that toggle between two defined states when triggered.
+ */
+export declare const ToggleButton: ForwardRefComponent<ToggleButtonProps>;
+
+export declare type ToggleButtonCommons = {
+    /**
+     * Defines the controlled checked state of the `ToggleButton`.
+     * If passed, `ToggleButton` ignores the `defaultChecked` property.
+     * This should only be used if the checked state is to be controlled at a higher level and there is a plan to pass the
+     * correct value based on handling `onClick` events and re-rendering.
+     * @default false
+     */
+    checked: boolean;
 };
 
+export declare type ToggleButtonProps = ButtonProps & Partial<ToggleButtonCommons> & {
+    /**
+     * Defines whether the `ToggleButton` is initially in a checked state or not when rendered.
+     * @default false
+     */
+    defaultChecked?: boolean;
+};
+
+export declare type ToggleButtonState = ButtonState & ToggleButtonCommons;
+
 /**
- * Define the render function. Given the state of a button, renders it.
+ * Given user props, defines default props for the Button, calls useButtonState, and returns processed state.
+ * @param props - User provided props to the Button component.
+ * @param ref - User provided ref to be passed to the Button component.
  */
-export declare const renderButton: (state: ButtonState) => JSX.Element;
+export declare const useButton: (props: ButtonProps, ref: React_2.Ref<HTMLButtonElement | HTMLAnchorElement>) => ButtonState;
+
+export declare const useButtonStyles: (state: ButtonState) => ButtonState;
+
+/**
+ * Given user props, defines default props for the CompoundButton, calls useButtonState, and returns processed state.
+ * @param props - User provided props to the CompoundButton component.
+ * @param ref - User provided ref to be passed to the CompoundButton component.
+ */
+export declare const useCompoundButton: ({ contentContainer, secondaryContent, ...props }: CompoundButtonProps, ref: React_2.Ref<HTMLButtonElement | HTMLAnchorElement>) => CompoundButtonState;
+
+export declare const useCompoundButtonStyles: (state: CompoundButtonState) => CompoundButtonState;
 
 /**
- * Given user props, returns state and render function for a Button.
+ * Given user props, returns the final state for a MenuButton.
  */
-export declare const useButton: (props: ButtonProps, ref: React.Ref<HTMLElement>, defaultProps?: ButtonProps | undefined) => ButtonState;
+export declare const useMenuButton: ({ menuIcon, ...props }: MenuButtonProps, ref: React_2.Ref<HTMLButtonElement | HTMLAnchorElement>) => MenuButtonState;
+
+export declare const useMenuButtonStyles: (state: MenuButtonState) => MenuButtonState;
+
+/**
+ * Given user props, defines default props for the SplitButton and returns processed state.
+ * @param props - User provided props to the SplitButton component.
+ * @param ref - User provided ref to be passed to the SplitButton component.
+ */
+export declare const useSplitButton: (props: SplitButtonProps, ref: React_2.Ref<HTMLButtonElement | HTMLAnchorElement>) => SplitButtonState;
+
+export declare const useSplitButtonStyles: (state: SplitButtonState) => SplitButtonState;
 
 /**
- * The useButton hook processes the Button draft state.
- * @param draftState - Button draft state to mutate.
+ * Given user props, defines default props for the ToggleButton, calls useButtonState and useChecked, and returns
+ * processed state.
+ * @param props - User provided props to the ToggleButton component.
+ * @param ref - User provided ref to be passed to the ToggleButton component.
  */
-export declare const useButtonState: (draftState: ButtonState) => void;
+export declare const useToggleButton: ({ checked, defaultChecked, ...props }: ToggleButtonProps, ref: React_2.Ref<HTMLButtonElement | HTMLAnchorElement>) => ToggleButtonState;
 
-export declare const useButtonStyles: (state: ButtonState, selectors: ButtonStyleSelectors) => void;
+export declare const useToggleButtonStyles: (state: ToggleButtonState) => ToggleButtonState;
 
 export { }

package/lib/Button.js.map

@@ -1 +1 @@
-{"version":3,"file":"Button.js","sourceRoot":"../src/","sources":["Button.tsx"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC","sourcesContent":["export * from './components/Button/index';\n"]}
+{"version":3,"file":"Button.js","sourceRoot":"","sources":["../src/Button.tsx"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC"}

package/lib/CompoundButton.d.ts

@@ -0,0 +1 @@
+export * from './components/CompoundButton/index';

package/lib/CompoundButton.js

@@ -0,0 +1,2 @@
+export * from './components/CompoundButton/index';
+//# sourceMappingURL=CompoundButton.js.map

package/lib/CompoundButton.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompoundButton.js","sourceRoot":"","sources":["../src/CompoundButton.ts"],"names":[],"mappings":"AAAA,cAAc,mCAAmC,CAAC"}

package/lib/MenuButton.d.ts

@@ -0,0 +1 @@
+export * from './components/MenuButton/index';

package/lib/MenuButton.js

@@ -0,0 +1,2 @@
+export * from './components/MenuButton/index';
+//# sourceMappingURL=MenuButton.js.map

package/lib/MenuButton.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MenuButton.js","sourceRoot":"","sources":["../src/MenuButton.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC"}

package/lib/SplitButton.d.ts

@@ -0,0 +1 @@
+export * from './components/SplitButton/index';

package/lib/SplitButton.js

@@ -0,0 +1,2 @@
+export * from './components/SplitButton/index';
+//# sourceMappingURL=SplitButton.js.map

package/lib/SplitButton.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SplitButton.js","sourceRoot":"","sources":["../src/SplitButton.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC"}

package/lib/ToggleButton.d.ts

@@ -0,0 +1 @@
+export * from './components/ToggleButton/index';

package/lib/ToggleButton.js

@@ -0,0 +1,2 @@
+export * from './components/ToggleButton/index';
+//# sourceMappingURL=ToggleButton.js.map

package/lib/ToggleButton.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToggleButton.js","sourceRoot":"","sources":["../src/ToggleButton.ts"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAC"}

package/lib/common/isConformant.d.ts

@@ -1,2 +1,4 @@
-import { IsConformantOptions } from '@fluentui/react-conformance';
-export declare function isConformant(testInfo: Omit<IsConformantOptions, 'componentPath'>): void;
+import type { IsConformantOptions } from '@fluentui/react-conformance';
+export declare function isConformant<TProps = {}>(testInfo: Omit<IsConformantOptions<TProps>, 'componentPath'> & {
+    componentPath?: string;
+}): void;

package/lib/common/isConformant.js

@@ -1,10 +1,13 @@
 import { isConformant as baseIsConformant } from '@fluentui/react-conformance';
+import makeStylesTests from '@fluentui/react-conformance-make-styles';
 export function isConformant(testInfo) {
-    var defaultOptions = {
-        asPropHandlesRef: true,
-        componentPath: module.parent.filename.replace('.test', ''),
-        disabledTests: ['has-docblock', 'kebab-aria-attributes'],
-    };
-    baseIsConformant(defaultOptions, testInfo);
+  var defaultOptions = {
+    asPropHandlesRef: true,
+    componentPath: module.parent.filename.replace('.test', ''),
+    disabledTests: ['has-docblock', 'kebab-aria-attributes'],
+    extraTests: makeStylesTests,
+    skipAsPropTests: true
+  };
+  baseIsConformant(defaultOptions, testInfo);
 }
 //# sourceMappingURL=isConformant.js.map

package/lib/common/isConformant.js.map

@@ -1 +1 @@
-{"version":3,"file":"isConformant.js","sourceRoot":"../src/","sources":["common/isConformant.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,IAAI,gBAAgB,EAAuB,MAAM,6BAA6B,CAAC;AAEpG,MAAM,UAAU,YAAY,CAAC,QAAoD;IAC/E,IAAM,cAAc,GAAG;QACrB,gBAAgB,EAAE,IAAI;QACtB,aAAa,EAAE,MAAO,CAAC,MAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QAC5D,aAAa,EAAE,CAAC,cAAc,EAAE,uBAAuB,CAAC;KACzD,CAAC;IAEF,gBAAgB,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;AAC7C,CAAC","sourcesContent":["import { isConformant as baseIsConformant, IsConformantOptions } from '@fluentui/react-conformance';\n\nexport function isConformant(testInfo: Omit<IsConformantOptions, 'componentPath'>) {\n  const defaultOptions = {\n    asPropHandlesRef: true,\n    componentPath: module!.parent!.filename.replace('.test', ''),\n    disabledTests: ['has-docblock', 'kebab-aria-attributes'],\n  };\n\n  baseIsConformant(defaultOptions, testInfo);\n}\n"]}
+{"version":3,"sources":["../../src/common/isConformant.ts"],"names":[],"mappings":"AAAA,SAAS,YAAY,IAAI,gBAAzB,QAAiD,6BAAjD;AAEA,OAAO,eAAP,MAA4B,yCAA5B;AAEA,OAAM,SAAU,YAAV,CACJ,QADI,EACqF;AAEzF,MAAM,cAAc,GAAyC;AAC3D,IAAA,gBAAgB,EAAE,IADyC;AAE3D,IAAA,aAAa,EAAE,MAAO,CAAC,MAAR,CAAgB,QAAhB,CAAyB,OAAzB,CAAiC,OAAjC,EAA0C,EAA1C,CAF4C;AAG3D,IAAA,aAAa,EAAE,CAAC,cAAD,EAAiB,uBAAjB,CAH4C;AAI3D,IAAA,UAAU,EAAE,eAJ+C;AAK3D,IAAA,eAAe,EAAE;AAL0C,GAA7D;AAQA,EAAA,gBAAgB,CAAC,cAAD,EAAiB,QAAjB,CAAhB;AACD","sourceRoot":""}

package/lib/components/Button/Button.d.ts

@@ -1,13 +1,6 @@
-import * as React from 'react';
+import type { ButtonProps } from './Button.types';
+import type { ForwardRefComponent } from '@fluentui/react-utilities';
 /**
- * Define a styled Button, using the `useButton` hook.
- * {@docCategory Button}
+ * Buttons give people a way to trigger an action.
  */
-export declare const Button: React.ForwardRefExoticComponent<import("@fluentui/react-utilities").ComponentProps & React.ButtonHTMLAttributes<HTMLElement> & {
-    icon?: import("@fluentui/react-utilities").ShorthandProps<React.HTMLAttributes<HTMLSpanElement>>;
-    disabled?: boolean | undefined;
-    iconOnly?: boolean | undefined;
-    iconPosition?: "after" | "before" | undefined;
-    primary?: boolean | undefined;
-    size?: "small" | "large" | undefined;
-} & React.RefAttributes<HTMLElement>>;
+export declare const Button: ForwardRefComponent<ButtonProps>;

package/lib/components/Button/Button.js

@@ -1,24 +1,15 @@
 import * as React from 'react';
-import { useButton } from './useButton';
 import { renderButton } from './renderButton';
+import { useButton } from './useButton';
 import { useButtonStyles } from './useButtonStyles';
 /**
- * Define a styled Button, using the `useButton` hook.
- * {@docCategory Button}
+ * Buttons give people a way to trigger an action.
  */
-export var Button = React.forwardRef(function (props, ref) {
-    var _a, _b;
-    var state = useButton(props, ref);
-    var receivedChildren = !!((_a = state.children) === null || _a === void 0 ? void 0 : _a.children);
-    var receivedIcon = !!((_b = state.icon) === null || _b === void 0 ? void 0 : _b.children);
-    var styleSelectors = {
-        disabled: state.disabled,
-        primary: state.primary,
-        iconOnly: receivedIcon && !receivedChildren,
-        size: state.size,
-    };
-    useButtonStyles(state, styleSelectors);
-    return renderButton(state);
+
+export var Button = /*#__PURE__*/React.forwardRef(function (props, ref) {
+  var state = useButton(props, ref);
+  useButtonStyles(state);
+  return renderButton(state); // Casting is required due to lack of distributive union to support unions on @types/react
 });
 Button.displayName = 'Button';
 //# sourceMappingURL=Button.js.map

package/lib/components/Button/Button.js.map

@@ -1 +1 @@
-{"version":3,"file":"Button.js","sourceRoot":"../src/","sources":["components/Button/Button.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;GAGG;AACH,MAAM,CAAC,IAAM,MAAM,GAAG,KAAK,CAAC,UAAU,CAA2B,UAAC,KAAK,EAAE,GAAG;;IAC1E,IAAM,KAAK,GAAG,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAEpC,IAAM,gBAAgB,GAAG,CAAC,QAAC,KAAK,CAAC,QAAQ,0CAAE,QAAQ,CAAA,CAAC;IACpD,IAAM,YAAY,GAAG,CAAC,QAAC,KAAK,CAAC,IAAI,0CAAE,QAAQ,CAAA,CAAC;IAE5C,IAAM,cAAc,GAAyB;QAC3C,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,QAAQ,EAAE,YAAY,IAAI,CAAC,gBAAgB;QAC3C,IAAI,EAAE,KAAK,CAAC,IAAI;KACjB,CAAC;IAEF,eAAe,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;IAEvC,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC,CAAC,CAAC;AAEH,MAAM,CAAC,WAAW,GAAG,QAAQ,CAAC","sourcesContent":["import * as React from 'react';\nimport { useButton } from './useButton';\nimport { ButtonProps, ButtonStyleSelectors } from './Button.types';\nimport { renderButton } from './renderButton';\nimport { useButtonStyles } from './useButtonStyles';\n\n/**\n * Define a styled Button, using the `useButton` hook.\n * {@docCategory Button}\n */\nexport const Button = React.forwardRef<HTMLElement, ButtonProps>((props, ref) => {\n  const state = useButton(props, ref);\n\n  const receivedChildren = !!state.children?.children;\n  const receivedIcon = !!state.icon?.children;\n\n  const styleSelectors: ButtonStyleSelectors = {\n    disabled: state.disabled,\n    primary: state.primary,\n    iconOnly: receivedIcon && !receivedChildren,\n    size: state.size,\n  };\n\n  useButtonStyles(state, styleSelectors);\n\n  return renderButton(state);\n});\n\nButton.displayName = 'Button';\n"]}
+{"version":3,"sources":["../../../src/components/Button/Button.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAZ,MAAuB,OAAvB;AACA,SAAS,YAAT,QAA6B,gBAA7B;AACA,SAAS,SAAT,QAA0B,aAA1B;AACA,SAAS,eAAT,QAAgC,mBAAhC;AAIA;;AAEG;;AACH,OAAO,IAAM,MAAM,gBAAqC,KAAK,CAAC,UAAN,CAAiB,UAAC,KAAD,EAAQ,GAAR,EAAW;AAClF,MAAM,KAAK,GAAG,SAAS,CAAC,KAAD,EAAQ,GAAR,CAAvB;AAEA,EAAA,eAAe,CAAC,KAAD,CAAf;AAEA,SAAO,YAAY,CAAC,KAAD,CAAnB,CALkF,CAMlF;AACD,CAPuD,CAAjD;AASP,MAAM,CAAC,WAAP,GAAqB,QAArB","sourceRoot":""}

package/lib/components/Button/Button.types.d.ts

@@ -1,65 +1,62 @@
-import * as React from 'react';
-import { ComponentProps, ShorthandProps } from '@fluentui/react-utilities';
-import { ObjectShorthandProps } from '@fluentui/react-utilities';
-export declare type ButtonProps = ComponentProps & React.ButtonHTMLAttributes<HTMLElement> & {
+import { ARIAButtonShorthandProps } from '@fluentui/react-aria';
+import type { ComponentProps, ComponentState, IntrinsicShorthandProps } from '@fluentui/react-utilities';
+export declare type ButtonSlots = {
     /**
-     * Shorthand icon. A shorthand prop can be a literal, object, or
-     * JSX. The `children` prop of the object can be a render function,
-     * taking in the original slot component and props.
+     * Root of the component that renders as either a <button> tag.
      */
-    icon?: ShorthandProps<React.HTMLAttributes<HTMLSpanElement>>;
-    /** A button can show that it cannot be interacted with. */
-    disabled?: boolean;
-    /** A button can contain only an icon. */
-    iconOnly?: boolean;
-    /** An icon button can format its icon to appear before or after its content. */
-    iconPosition?: 'before' | 'after';
-    /** A button can emphasize that it represents the primary action. */
-    primary?: boolean;
-    /** A button can be sized. */
-    size?: 'small' | 'large';
-};
-/**
- * {@docCategory Button}
- */
-export interface ButtonState extends ButtonProps {
-    ref: React.RefObject<HTMLButtonElement>;
-    icon?: ObjectShorthandProps<React.HTMLAttributes<HTMLSpanElement>>;
-    children?: ObjectShorthandProps<React.HTMLAttributes<HTMLSpanElement>>;
-}
-export declare type ButtonStyleSelectors = {
-    disabled?: boolean;
-    iconOnly?: boolean;
-    primary?: boolean;
-    size?: string;
+    root: ARIAButtonShorthandProps;
+    /**
+     * Icon that renders either before or after the `children` as specified by the `iconPosition` prop.
+     */
+    icon?: IntrinsicShorthandProps<'span'>;
 };
-export declare type ButtonVariants = 'base' | 'disabled' | 'iconOnly' | 'primary' | 'small' | 'large' | 'primaryDisabled' | 'iconOnlySmall' | 'iconOnlyLarge';
-export declare type ButtonTokens = {
-    height: string;
-    paddingX: string;
-    paddingY: string;
-    minWidth: string;
-    maxWidth: string;
-    fontSize: string;
-    fontWeight: number;
-    lineHeight: string;
-    iconWidth: string;
-    iconHeight: string;
-    iconSpacing: string;
-    color: string;
-    content2Color: string;
-    background: string;
-    backgroundHover: string;
-    backgroundPressed: string;
-    backgroundActive: string;
-    borderColor: string;
-    borderColorHover: string;
-    borderColorActive: string;
-    borderWidth: string;
-    borderRadius: string;
-    shadow: string;
-    shadowPressed: string;
+export declare type ButtonCommons = {
+    /**
+     * A button can have its content and borders styled for greater emphasis or to be subtle.
+     * - 'primary': Emphasizes the button as a primary action.
+     * - 'outline': Removes background styling.
+     * - 'subtle': Minimizes emphasis to blend into the background until hovered or focused.
+     * - 'transparent': Removes background and border styling.
+     */
+    appearance?: 'primary' | 'outline' | 'subtle' | 'transparent';
+    /**
+     * A button can fill the width of its container.
+     * @default false
+     */
+    block: boolean;
+    /**
+     * When set, allows the button to be focusable even when it has been disabled. This is used in scenarios where it
+     * is important to keep a consistent tab order for screen reader and keyboard users. The primary example of this
+     * pattern is when the disabled button is in a menu or a commandbar and is seldom used for standalone buttons.
+     * @default false
+     */
+    disabledFocusable: boolean;
+    /**
+     * A button can show that it cannot be interacted with.
+     * @default false
+     */
+    disabled: boolean;
+    /**
+     * A button can format its icon to appear before or after its content.
+     * @default 'before'
+     */
+    iconPosition: 'before' | 'after';
+    /**
+     * A button can be rounded, circular, or square.
+     * @default 'rounded'
+     */
+    shape: 'rounded' | 'circular' | 'square';
+    /**
+     * A button supports different sizes.
+     * @default 'medium'
+     */
+    size: 'small' | 'medium' | 'large';
 };
-export declare type ButtonVariantTokens = {
-    [variant in ButtonVariants]: Partial<ButtonTokens>;
+export declare type ButtonProps = ComponentProps<ButtonSlots> & Partial<ButtonCommons>;
+export declare type ButtonState = ComponentState<ButtonSlots> & ButtonCommons & {
+    /**
+     * A button can contain only an icon.
+     * @default false
+     */
+    iconOnly: boolean;
 };

package/lib/components/Button/Button.types.js

@@ -1 +1,2 @@
+export {};
 //# sourceMappingURL=Button.types.js.map

package/lib/components/Button/Button.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"Button.types.js","sourceRoot":"../src/","sources":["components/Button/Button.types.ts"],"names":[],"mappings":"","sourcesContent":["import * as React from 'react';\nimport { ComponentProps, ShorthandProps } from '@fluentui/react-utilities';\nimport { ObjectShorthandProps } from '@fluentui/react-utilities';\n\nexport type ButtonProps = ComponentProps &\n  React.ButtonHTMLAttributes<HTMLElement> & {\n    /**\n     * Shorthand icon. A shorthand prop can be a literal, object, or\n     * JSX. The `children` prop of the object can be a render function,\n     * taking in the original slot component and props.\n     */\n    icon?: ShorthandProps<React.HTMLAttributes<HTMLSpanElement>>;\n\n    // TODO: children needs a new typing to handle render functions along with hook updates for children functionality\n    // children?: ???;\n\n    // /** A button can appear circular. */\n    // circular?: boolean;\n\n    /** A button can show that it cannot be interacted with. */\n    disabled?: boolean;\n\n    // /**\n    // eslint-disable-next-line @fluentui/max-len\n    //  * When set, allows the button to be focusable even when it has been disabled. This is used in scenarios where it is\n    //  * important to keep a consistent tab order for screen reader and keyboard users.\n    //  * @defaultvalue false\n    //  */\n    // disabledFocusable?: boolean;\n\n    // /** A button can fill the width of its container. */\n    // block?: boolean;\n\n    /** A button can contain only an icon. */\n    iconOnly?: boolean;\n\n    /** An icon button can format its icon to appear before or after its content. */\n    iconPosition?: 'before' | 'after';\n\n    // /** A button can show a loading indicator. */\n    // loading?: boolean;\n\n    /** A button can emphasize that it represents the primary action. */\n    primary?: boolean;\n\n    // /** A button can blend into its background to become less emphasized. */\n    // subtle?: boolean;\n\n    // /** A button can have no background styling and just be emphasized through its content styling. */\n    // transparent?: boolean;\n\n    /** A button can be sized. */\n    size?: 'small' | 'large';\n  };\n\n/**\n * {@docCategory Button}\n */\nexport interface ButtonState extends ButtonProps {\n  ref: React.RefObject<HTMLButtonElement>;\n\n  icon?: ObjectShorthandProps<React.HTMLAttributes<HTMLSpanElement>>;\n  children?: ObjectShorthandProps<React.HTMLAttributes<HTMLSpanElement>>;\n}\n\nexport type ButtonStyleSelectors = {\n  disabled?: boolean;\n  iconOnly?: boolean;\n  primary?: boolean;\n  size?: string;\n};\n\nexport type ButtonVariants =\n  | 'base'\n  | 'disabled'\n  | 'iconOnly'\n  | 'primary'\n  | 'small'\n  | 'large'\n  // TODO: get rid of these combinations, use individual variants in matchers\n  | 'primaryDisabled'\n  | 'iconOnlySmall'\n  | 'iconOnlyLarge';\n\nexport type ButtonTokens = {\n  height: string;\n  paddingX: string;\n  paddingY: string;\n  minWidth: string;\n  maxWidth: string;\n\n  fontSize: string;\n  fontWeight: number;\n  lineHeight: string;\n\n  iconWidth: string;\n  iconHeight: string;\n  iconSpacing: string;\n\n  color: string;\n  content2Color: string;\n\n  background: string;\n  backgroundHover: string;\n  backgroundPressed: string;\n  backgroundActive: string;\n\n  borderColor: string;\n  borderColorHover: string;\n  borderColorActive: string;\n  borderWidth: string;\n  borderRadius: string;\n\n  shadow: string;\n  shadowPressed: string;\n};\n\nexport type ButtonVariantTokens = {\n  [variant in ButtonVariants]: Partial<ButtonTokens>;\n};\n"]}
+{"version":3,"file":"Button.types.js","sourceRoot":"","sources":["../../../src/components/Button/Button.types.ts"],"names":[],"mappings":""}

package/lib/components/Button/index.d.ts

@@ -1,6 +1,5 @@
-export * from './Button.types';
 export * from './Button';
+export * from './Button.types';
 export * from './renderButton';
 export * from './useButton';
 export { useButtonStyles } from './useButtonStyles';
-export * from './useButtonState';

package/lib/components/Button/index.js

@@ -1,6 +1,6 @@
 export * from './Button';
+export * from './Button.types';
 export * from './renderButton';
 export * from './useButton';
 export { useButtonStyles } from './useButtonStyles';
-export * from './useButtonState';
 //# sourceMappingURL=index.js.map