@fluentui/react-button 9.0.0-nightly.f81b28ceb3.1 → 9.0.0-rc.11

package/README.md

@@ -2,35 +2,97 @@
 
 **Button components for [Fluent UI React](https://developer.microsoft.com/en-us/fluentui)**
 
-The Button component enables users to trigger an action or event, such as submitting a form, opening a dialog, canceling an action, or performing a delete operation.
-
-## STATUS: WIP 🚧
-
-These are not production-ready components and **should never be used in product**. This space is useful for testing new components whose APIs might change before final release.
+- Buttons enable users to trigger an action or event, such as submitting a form, opening a dialog, canceling an action, or performing a delete operation.
+- CompoundButtons are buttons that can have secondary content that adds extra information to the user.
+- MenuButtons are buttons that have a chevron icon after the button contents and are usually clicked to open/close menus.
+- SplitButtons are a grouping of two interactive surfaces where interacting with the first one triggers a primary action, while interacting with the second one opens a menu with secondary actions.
+- ToggleButtons are buttons that toggle between two defined states when triggered.
 
 ## Usage
 
 To import Button:
 
 ```js
-import { Button } from '@fluentui/react-button';
+import { Button, CompoundButton, MenuButton, SplitButton, ToggleButton } from '@fluentui/react-components';
 ```
 
-Once the Button component graduates to a production release, the component will be available at:
+### Examples
 
-```js
-import { Button } from '@fluentui/react-components';
+### Button
+
+```jsx
+<Button>Submit</Button>
+<Button icon={<SVGIcon />} />
+<Button icon={<SVGIcon />}>Submit</Button>
+<Button icon={<SVGIcon />} iconPosition="after">Submit</Button>
+<Button appearance="primary">Submit</Button>
+<Button disabled>Submit</Button>
+<Button size="small">Submit</Button>
+<Button size="large">Submit</Button>
 ```
 
-### Examples
+### CompoundButton
 
 ```jsx
-<Button>Text</Button>
-<Button icon={<SVGIcon />} />
-<Button icon={<SVGIcon />}>Text</Button>
-<Button icon={<SVGIcon />} iconPosition="after">Text</Button>
-<Button primary>Text</Button>
-<Button disabled>Text</Button>
-<Button size="small">Text</Button>
-<Button size="large">Text</Button>
+<CompoundButton icon={<CalendarMonth />} secondaryContent="Secondary content" {...props}>
+  Example
+</CompoundButton>
+```
+
+### MenuButton
+
+```jsx
+<Menu>
+  <MenuTrigger>
+    <MenuButton>Example</MenuButton>
+  </MenuTrigger>
+
+  <MenuPopover>
+    <MenuList>
+      <MenuItem>Item a</MenuItem>
+      <MenuItem>Item b</MenuItem>
+    </MenuList>
+  </MenuPopover>
+</Menu>
+```
+
+### SplitButton
+
+```jsx
+<Menu positioning="below-end">
+  <MenuTrigger>
+    {(triggerProps: MenuButtonProps) => <SplitButton menuButton={triggerProps}>Example</SplitButton>}
+  </MenuTrigger>
+
+  <MenuPopover>
+    <MenuList>
+      <MenuItem>Item a</MenuItem>
+      <MenuItem>Item b</MenuItem>
+    </MenuList>
+  </MenuPopover>
+</Menu>
+```
+
+### ToggleButton
+
+```jsx
+<ToggleButton>Toggle volume</ToggleButton>
+<ToggleButton defaultChecked={true}>Toggle volume</ToggleButton>
+<ToggleButton checked={true}>Toggle volume</ToggleButton>
+<ToggleButton checked={false}>Toggle volume</ToggleButton>
 ```
+
+See [Fluent UI Storybook](https://aka.ms/fluentui-storybook) for more detailed usage examples.
+
+Alternatively, run Storybook locally with:
+
+1. `yarn start`
+2. Select `react-button` from the list.
+
+### Specification
+
+See [SPEC.md](./src/components/Button/SPEC.md).
+
+### Migration Guide
+
+If you're upgrading to Fluent UI v9 see [MIGRATION.md](./src/components/Button/MIGRATION.md) for guidance on updating to the latest component implementations.

package/dist/{react-button.d.ts → index.d.ts}

@@ -1,76 +1,79 @@
-import { ARIAButtonShorthandProps } from '@fluentui/react-aria';
+import type { ARIAButtonSlotProps } 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';
+import type { Slot } from '@fluentui/react-utilities';
+import type { SlotClassNames } from '@fluentui/react-utilities';
 
 /**
  * Buttons give people a way to trigger an action.
  */
 export declare const Button: ForwardRefComponent<ButtonProps>;
 
-export declare type ButtonCommons = {
+export declare const buttonClassNames: SlotClassNames<ButtonSlots>;
+
+export declare type ButtonProps = ComponentProps<ButtonSlots> & {
     /**
      * A button can have its content and borders styled for greater emphasis or to be subtle.
+     * - 'secondary' (default): Gives emphasis to the button in such a way that it indicates a secondary action.
      * - '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.
+     *
+     * @default 'secondary'
      */
-    appearance?: 'primary' | 'outline' | 'subtle' | 'transparent';
-    /**
-     * A button can fill the width of its container.
-     * @default false
-     */
-    block: boolean;
+    appearance?: 'secondary' | 'primary' | 'outline' | 'subtle' | 'transparent';
     /**
      * 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;
+    disabledFocusable?: boolean;
     /**
      * A button can show that it cannot be interacted with.
+     *
      * @default false
      */
-    disabled: boolean;
+    disabled?: boolean;
     /**
      * A button can format its icon to appear before or after its content.
+     *
      * @default 'before'
      */
-    iconPosition: 'before' | 'after';
+    iconPosition?: 'before' | 'after';
     /**
      * A button can be rounded, circular, or square.
+     *
      * @default 'rounded'
      */
-    shape: 'rounded' | 'circular' | 'square';
+    shape?: 'rounded' | 'circular' | 'square';
     /**
      * A button supports different sizes.
+     *
      * @default 'medium'
      */
-    size: 'small' | 'medium' | 'large';
+    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 of the component that renders as either a `<button>` tag or an `<a>` tag.
      */
-    root: ARIAButtonShorthandProps;
+    root: NonNullable<Slot<ARIAButtonSlotProps>>;
     /**
      * Icon that renders either before or after the `children` as specified by the `iconPosition` prop.
      */
-    icon?: IntrinsicShorthandProps<'span'>;
+    icon?: Slot<'span'>;
 };
 
-export declare type ButtonState = ComponentState<ButtonSlots> & ButtonCommons & {
+export declare type ButtonState = ComponentState<ButtonSlots> & Required<Pick<ButtonProps, 'appearance' | 'disabledFocusable' | 'disabled' | 'iconPosition' | 'shape' | 'size'>> & {
     /**
      * A button can contain only an icon.
+     *
      * @default false
      */
     iconOnly: boolean;
@@ -81,33 +84,38 @@ export declare type ButtonState = ComponentState<ButtonSlots> & ButtonCommons &
  */
 export declare const CompoundButton: ForwardRefComponent<CompoundButtonProps>;
 
-export declare type CompoundButtonProps = ComponentProps<CompoundButtonSlots> & Partial<ButtonCommons>;
+export declare const compoundButtonClassNames: SlotClassNames<CompoundButtonSlots>;
+
+export declare type CompoundButtonProps = ComponentProps<Partial<CompoundButtonSlots>> & Pick<ButtonProps, 'appearance' | 'disabledFocusable' | 'disabled' | 'iconPosition' | 'shape' | 'size'>;
 
 export declare type CompoundButtonSlots = ButtonSlots & {
     /**
      * Second line of text that describes the action this button takes.
      */
-    secondaryContent?: IntrinsicShorthandProps<'span'>;
+    secondaryContent?: Slot<'span'>;
     /**
      * Container that wraps the children and the secondaryContent slot.
      */
-    contentContainer: IntrinsicShorthandProps<'span'>;
+    contentContainer: NonNullable<Slot<'span'>>;
 };
 
 export declare type CompoundButtonState = ComponentState<CompoundButtonSlots> & Omit<ButtonState, keyof ButtonSlots | 'components'>;
 
 /**
- * MenuButtons are buttons that handle opening and closing a menu when they are triggered.
+ * MenuButtons are buttons that have a chevron icon after the button contents and are usually clicked to open/close
+ * menus.
  */
 export declare const MenuButton: ForwardRefComponent<MenuButtonProps>;
 
-export declare type MenuButtonProps = ComponentProps<MenuButtonSlots> & Partial<Omit<ButtonCommons, 'iconPosition'>> & Partial<MenuTriggerChildProps>;
+export declare const menuButtonClassNames: SlotClassNames<MenuButtonSlots>;
+
+export declare type MenuButtonProps = ComponentProps<MenuButtonSlots> & Pick<ButtonProps, 'appearance' | 'disabledFocusable' | 'disabled' | 'shape' | 'size'>;
 
 export declare type MenuButtonSlots = ButtonSlots & {
     /**
      * Menu icon that indicates that this button has a menu that can be expanded.
      */
-    menuIcon?: IntrinsicShorthandProps<'span'>;
+    menuIcon?: Slot<'span'>;
 };
 
 export declare type MenuButtonState = ComponentState<MenuButtonSlots> & Omit<ButtonState, keyof ButtonSlots | 'components' | 'iconPosition'>;
@@ -115,46 +123,48 @@ export declare type MenuButtonState = ComponentState<MenuButtonSlots> & Omit<But
 /**
  * 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 }
+declare const renderButton_unstable: (state: ButtonState) => JSX.Element;
+export { renderButton_unstable }
+export { renderButton_unstable as renderToggleButton_unstable }
 
 /**
  * Renders a CompoundButton component by passing the state defined props to the appropriate slots.
  */
-export declare const renderCompoundButton: (state: CompoundButtonState) => JSX.Element;
+export declare const renderCompoundButton_unstable: (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;
+export declare const renderMenuButton_unstable: (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;
+export declare const renderSplitButton_unstable: (state: SplitButtonState) => JSX.Element;
 
 /**
- * SplitButtons are a grouping of two interactive surfaces where the interacting with the first one triggers a primary
+ * SplitButtons are a grouping of two interactive surfaces where 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 const splitButtonClassNames: SlotClassNames<SplitButtonSlots>;
+
 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'>;
+    root: NonNullable<Slot<'div'>>;
     /**
      * Button that opens menu with secondary actions in SplitButton.
      */
-    menuButton?: ObjectShorthandProps<MenuButtonProps>;
+    menuButton?: Slot<typeof MenuButton>;
     /**
      * Button to perform primary action in SplitButton.
      */
-    primaryActionButton?: ObjectShorthandProps<ButtonProps>;
+    primaryActionButton?: Slot<typeof Button>;
 };
 
 export declare type SplitButtonState = ComponentState<SplitButtonSlots> & Omit<ButtonState, 'components' | 'iconOnly' | 'root'> & Omit<MenuButtonState, 'components' | 'iconOnly' | 'root'>;
@@ -164,60 +174,61 @@ export declare type SplitButtonState = ComponentState<SplitButtonSlots> & Omit<B
  */
 export declare const ToggleButton: ForwardRefComponent<ToggleButtonProps>;
 
-export declare type ToggleButtonCommons = {
+export declare const toggleButtonClassNames: SlotClassNames<ButtonSlots>;
+
+export declare type ToggleButtonProps = ButtonProps & {
+    /**
+     * Defines whether the `ToggleButton` is initially in a checked state or not when rendered.
+     *
+     * @default false
+     */
+    defaultChecked?: boolean;
     /**
      * 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;
+    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;
+export declare type ToggleButtonState = ButtonState & Required<Pick<ToggleButtonProps, 'checked'>>;
 
 /**
  * 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 useButton: (props: ButtonProps, ref: React_2.Ref<HTMLButtonElement | HTMLAnchorElement>) => ButtonState;
+export declare const useButton_unstable: (props: ButtonProps, ref: React_2.Ref<HTMLButtonElement | HTMLAnchorElement>) => ButtonState;
 
-export declare const useButtonStyles: (state: ButtonState) => ButtonState;
+export declare const useButtonStyles_unstable: (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 useCompoundButton_unstable: ({ contentContainer, secondaryContent, ...props }: CompoundButtonProps, ref: React_2.Ref<HTMLButtonElement | HTMLAnchorElement>) => CompoundButtonState;
 
-export declare const useCompoundButtonStyles: (state: CompoundButtonState) => CompoundButtonState;
+export declare const useCompoundButtonStyles_unstable: (state: CompoundButtonState) => CompoundButtonState;
 
 /**
  * Given user props, returns the final state for a MenuButton.
  */
-export declare const useMenuButton: ({ menuIcon, ...props }: MenuButtonProps, ref: React_2.Ref<HTMLButtonElement | HTMLAnchorElement>) => MenuButtonState;
+export declare const useMenuButton_unstable: ({ menuIcon, ...props }: MenuButtonProps, ref: React_2.Ref<HTMLButtonElement | HTMLAnchorElement>) => MenuButtonState;
 
-export declare const useMenuButtonStyles: (state: MenuButtonState) => MenuButtonState;
+export declare const useMenuButtonStyles_unstable: (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 useSplitButton_unstable: (props: SplitButtonProps, ref: React_2.Ref<HTMLButtonElement | HTMLAnchorElement>) => SplitButtonState;
 
-export declare const useSplitButtonStyles: (state: SplitButtonState) => SplitButtonState;
+export declare const useSplitButtonStyles_unstable: (state: SplitButtonState) => SplitButtonState;
 
 /**
  * Given user props, defines default props for the ToggleButton, calls useButtonState and useChecked, and returns
@@ -225,8 +236,10 @@ export declare const useSplitButtonStyles: (state: SplitButtonState) => SplitBut
  * @param props - User provided props to the ToggleButton component.
  * @param ref - User provided ref to be passed to the ToggleButton component.
  */
-export declare const useToggleButton: ({ checked, defaultChecked, ...props }: ToggleButtonProps, ref: React_2.Ref<HTMLButtonElement | HTMLAnchorElement>) => ToggleButtonState;
+export declare const useToggleButton_unstable: (props: ToggleButtonProps, ref: React_2.Ref<HTMLButtonElement | HTMLAnchorElement>) => ToggleButtonState;
+
+export declare const useToggleButtonStyles_unstable: (state: ToggleButtonState) => ToggleButtonState;
 
-export declare const useToggleButtonStyles: (state: ToggleButtonState) => ToggleButtonState;
+export declare function useToggleState<TToggleButtonProps extends Pick<ToggleButtonProps, 'checked' | 'defaultChecked' | 'disabled' | 'disabledFocusable'>, TButtonState extends Pick<ButtonState, 'root'>, TToggleButtonState extends Pick<ToggleButtonState, 'checked' | 'root'>>(props: TToggleButtonProps, state: TButtonState): TToggleButtonState;
 
 export { }

package/lib/Button.js.map

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

package/lib/CompoundButton.js.map

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

package/lib/MenuButton.js.map

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

package/lib/SplitButton.js.map

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

package/lib/ToggleButton.js.map

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

package/lib/components/Button/Button.js

@@ -1,15 +1,15 @@
 import * as React from 'react';
-import { renderButton } from './renderButton';
-import { useButton } from './useButton';
-import { useButtonStyles } from './useButtonStyles';
+import { renderButton_unstable } from './renderButton';
+import { useButton_unstable } from './useButton';
+import { useButtonStyles_unstable } from './useButtonStyles';
 /**
  * Buttons give people a way to trigger an action.
  */
 
-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
+export const Button = /*#__PURE__*/React.forwardRef((props, ref) => {
+  const state = useButton_unstable(props, ref);
+  useButtonStyles_unstable(state);
+  return renderButton_unstable(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,"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":""}
+{"version":3,"sources":["components/Button/Button.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAZ,MAAuB,OAAvB;AACA,SAAS,qBAAT,QAAsC,gBAAtC;AACA,SAAS,kBAAT,QAAmC,aAAnC;AACA,SAAS,wBAAT,QAAyC,mBAAzC;AAIA;;AAEG;;AACH,OAAO,MAAM,MAAM,gBAAqC,KAAK,CAAC,UAAN,CAAiB,CAAC,KAAD,EAAQ,GAAR,KAAe;AACtF,QAAM,KAAK,GAAG,kBAAkB,CAAC,KAAD,EAAQ,GAAR,CAAhC;AAEA,EAAA,wBAAwB,CAAC,KAAD,CAAxB;AAEA,SAAO,qBAAqB,CAAC,KAAD,CAA5B,CALsF,CAMtF;AACD,CAPuD,CAAjD;AASP,MAAM,CAAC,WAAP,GAAqB,QAArB","sourcesContent":["import * as React from 'react';\nimport { renderButton_unstable } from './renderButton';\nimport { useButton_unstable } from './useButton';\nimport { useButtonStyles_unstable } from './useButtonStyles';\nimport type { ButtonProps } from './Button.types';\nimport type { ForwardRefComponent } from '@fluentui/react-utilities';\n\n/**\n * Buttons give people a way to trigger an action.\n */\nexport const Button: ForwardRefComponent<ButtonProps> = React.forwardRef((props, ref) => {\n  const state = useButton_unstable(props, ref);\n\n  useButtonStyles_unstable(state);\n\n  return renderButton_unstable(state);\n  // Casting is required due to lack of distributive union to support unions on @types/react\n}) as ForwardRefComponent<ButtonProps>;\n\nButton.displayName = 'Button';\n"],"sourceRoot":"../src/"}

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

@@ -1 +1 @@
-{"version":3,"file":"Button.types.js","sourceRoot":"","sources":["../../../src/components/Button/Button.types.ts"],"names":[],"mappings":""}
+{"version":3,"file":"Button.types.js","sourceRoot":"../src/","sources":["components/Button/Button.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { ARIAButtonSlotProps } from '@fluentui/react-aria';\nimport type { ComponentProps, ComponentState, Slot } from '@fluentui/react-utilities';\n\nexport type ButtonSlots = {\n  /**\n   * Root of the component that renders as either a `<button>` tag or an `<a>` tag.\n   */\n  root: NonNullable<Slot<ARIAButtonSlotProps>>;\n\n  /**\n   * Icon that renders either before or after the `children` as specified by the `iconPosition` prop.\n   */\n  icon?: Slot<'span'>;\n};\n\nexport type ButtonProps = ComponentProps<ButtonSlots> & {\n  /**\n   * A button can have its content and borders styled for greater emphasis or to be subtle.\n   * - 'secondary' (default): Gives emphasis to the button in such a way that it indicates a secondary action.\n   * - 'primary': Emphasizes the button as a primary action.\n   * - 'outline': Removes background styling.\n   * - 'subtle': Minimizes emphasis to blend into the background until hovered or focused.\n   * - 'transparent': Removes background and border styling.\n   *\n   * @default 'secondary'\n   */\n  appearance?: 'secondary' | 'primary' | 'outline' | 'subtle' | 'transparent';\n\n  /**\n   * When set, allows the button to be focusable even when it has been disabled. This is used in scenarios where it\n   * is important to keep a consistent tab order for screen reader and keyboard users. The primary example of this\n   * pattern is when the disabled button is in a menu or a commandbar and is seldom used for standalone buttons.\n   *\n   * @default false\n   */\n  disabledFocusable?: boolean;\n\n  /**\n   * A button can show that it cannot be interacted with.\n   *\n   * @default false\n   */\n  disabled?: boolean;\n\n  /**\n   * A button can format its icon to appear before or after its content.\n   *\n   * @default 'before'\n   */\n  iconPosition?: 'before' | 'after';\n\n  /**\n   * A button can be rounded, circular, or square.\n   *\n   * @default 'rounded'\n   */\n  shape?: 'rounded' | 'circular' | 'square';\n\n  /**\n   * A button supports different sizes.\n   *\n   * @default 'medium'\n   */\n  size?: 'small' | 'medium' | 'large';\n};\n\nexport type ButtonState = ComponentState<ButtonSlots> &\n  Required<Pick<ButtonProps, 'appearance' | 'disabledFocusable' | 'disabled' | 'iconPosition' | 'shape' | 'size'>> & {\n    /**\n     * A button can contain only an icon.\n     *\n     * @default false\n     */\n    iconOnly: boolean;\n  };\n"]}

package/lib/components/Button/index.js

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

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/Button/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"../src/","sources":["components/Button/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AAGzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC","sourcesContent":["export * from './Button';\n// Explicit exports to omit ButtonCommons\nexport type { ButtonProps, ButtonSlots, ButtonState } from './Button.types';\nexport * from './renderButton';\nexport * from './useButton';\nexport { buttonClassNames, useButtonStyles_unstable } from './useButtonStyles';\n"]}

package/lib/components/Button/renderButton.js

@@ -1,17 +1,21 @@
-import { __assign } from "tslib";
 import * as React from 'react';
 import { getSlots } from '@fluentui/react-utilities';
 /**
  * Renders a Button component by passing the state defined props to the appropriate slots.
  */
 
-export var renderButton = function (state) {
-  var _a = getSlots(state, ['root', 'icon']),
-      slots = _a.slots,
-      slotProps = _a.slotProps;
-
-  var iconOnly = state.iconOnly,
-      iconPosition = state.iconPosition;
-  return /*#__PURE__*/React.createElement(slots.root, __assign({}, slotProps.root), iconPosition !== 'after' && /*#__PURE__*/React.createElement(slots.icon, __assign({}, slotProps.icon)), !iconOnly && state.root.children, iconPosition === 'after' && /*#__PURE__*/React.createElement(slots.icon, __assign({}, slotProps.icon)));
+export const renderButton_unstable = state => {
+  const {
+    slots,
+    slotProps
+  } = getSlots(state);
+  const {
+    iconOnly,
+    iconPosition
+  } = state;
+  return /*#__PURE__*/React.createElement(slots.root, { ...slotProps.root
+  }, iconPosition !== 'after' && slots.icon && /*#__PURE__*/React.createElement(slots.icon, { ...slotProps.icon
+  }), !iconOnly && state.root.children, iconPosition === 'after' && slots.icon && /*#__PURE__*/React.createElement(slots.icon, { ...slotProps.icon
+  }));
 };
 //# sourceMappingURL=renderButton.js.map

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/components/Button/renderButton.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,KAAZ,MAAuB,OAAvB;AACA,SAAS,QAAT,QAAyB,2BAAzB;AAGA;;AAEG;;AACH,OAAO,IAAM,YAAY,GAAG,UAAC,KAAD,EAAmB;AACvC,MAAA,EAAA,GAAuB,QAAQ,CAAc,KAAd,EAAqB,CAAC,MAAD,EAAS,MAAT,CAArB,CAA/B;AAAA,MAAE,KAAK,GAAA,EAAA,CAAA,KAAP;AAAA,MAAS,SAAS,GAAA,EAAA,CAAA,SAAlB;;AACE,MAAA,QAAQ,GAAmB,KAAK,CAAxB,QAAR;AAAA,MAAU,YAAY,GAAK,KAAK,CAAV,YAAtB;AAER,sBACE,KAAA,CAAA,aAAA,CAAC,KAAK,CAAC,IAAP,EAAW,QAAA,CAAA,EAAA,EAAK,SAAS,CAAC,IAAf,CAAX,EACG,YAAY,KAAK,OAAjB,iBAA4B,KAAA,CAAA,aAAA,CAAC,KAAK,CAAC,IAAP,EAAW,QAAA,CAAA,EAAA,EAAK,SAAS,CAAC,IAAf,CAAX,CAD/B,EAEG,CAAC,QAAD,IAAa,KAAK,CAAC,IAAN,CAAW,QAF3B,EAGG,YAAY,KAAK,OAAjB,iBAA4B,KAAA,CAAA,aAAA,CAAC,KAAK,CAAC,IAAP,EAAW,QAAA,CAAA,EAAA,EAAK,SAAS,CAAC,IAAf,CAAX,CAH/B,CADF;AAOD,CAXM","sourceRoot":""}
+{"version":3,"sources":["components/Button/renderButton.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAZ,MAAuB,OAAvB;AACA,SAAS,QAAT,QAAyB,2BAAzB;AAGA;;AAEG;;AACH,OAAO,MAAM,qBAAqB,GAAI,KAAD,IAAuB;AAC1D,QAAM;AAAE,IAAA,KAAF;AAAS,IAAA;AAAT,MAAuB,QAAQ,CAAc,KAAd,CAArC;AACA,QAAM;AAAE,IAAA,QAAF;AAAY,IAAA;AAAZ,MAA6B,KAAnC;AAEA,sBACE,KAAA,CAAA,aAAA,CAAC,KAAK,CAAC,IAAP,EAAW,EAAA,GAAK,SAAS,CAAC;AAAf,GAAX,EACG,YAAY,KAAK,OAAjB,IAA4B,KAAK,CAAC,IAAlC,iBAA0C,KAAA,CAAA,aAAA,CAAC,KAAK,CAAC,IAAP,EAAW,EAAA,GAAK,SAAS,CAAC;AAAf,GAAX,CAD7C,EAEG,CAAC,QAAD,IAAa,KAAK,CAAC,IAAN,CAAW,QAF3B,EAGG,YAAY,KAAK,OAAjB,IAA4B,KAAK,CAAC,IAAlC,iBAA0C,KAAA,CAAA,aAAA,CAAC,KAAK,CAAC,IAAP,EAAW,EAAA,GAAK,SAAS,CAAC;AAAf,GAAX,CAH7C,CADF;AAOD,CAXM","sourcesContent":["import * as React from 'react';\nimport { getSlots } from '@fluentui/react-utilities';\nimport type { ButtonSlots, ButtonState } from './Button.types';\n\n/**\n * Renders a Button component by passing the state defined props to the appropriate slots.\n */\nexport const renderButton_unstable = (state: ButtonState) => {\n  const { slots, slotProps } = getSlots<ButtonSlots>(state);\n  const { iconOnly, iconPosition } = state;\n\n  return (\n    <slots.root {...slotProps.root}>\n      {iconPosition !== 'after' && slots.icon && <slots.icon {...slotProps.icon} />}\n      {!iconOnly && state.root.children}\n      {iconPosition === 'after' && slots.icon && <slots.icon {...slotProps.icon} />}\n    </slots.root>\n  );\n};\n"],"sourceRoot":"../src/"}

package/lib/components/Button/useButton.js

@@ -6,32 +6,26 @@ import { getNativeElementProps, resolveShorthand } from '@fluentui/react-utiliti
  * @param ref - User provided ref to be passed to the Button component.
  */
 
-export var useButton = function (props, ref) {
-  var appearance = props.appearance,
-      as = props.as,
-      _a = props.block,
-      block = _a === void 0 ? false : _a,
-      _b = props.disabled,
-      disabled = _b === void 0 ? false : _b,
-      _c = props.disabledFocusable,
-      disabledFocusable = _c === void 0 ? false : _c,
-      icon = props.icon,
-      _d = props.iconPosition,
-      iconPosition = _d === void 0 ? 'before' : _d,
-      _e = props.shape,
-      shape = _e === void 0 ? 'rounded' : _e,
-      _f = props.size,
-      size = _f === void 0 ? 'medium' : _f;
-  var iconShorthand = resolveShorthand(icon);
+export const useButton_unstable = (props, ref) => {
+  const {
+    appearance = 'secondary',
+    as,
+    disabled = false,
+    disabledFocusable = false,
+    icon,
+    iconPosition = 'before',
+    shape = 'rounded',
+    size = 'medium'
+  } = props;
+  const iconShorthand = resolveShorthand(icon);
   return {
     // Props passed at the top-level
-    appearance: appearance,
-    block: block,
-    disabled: disabled,
-    disabledFocusable: disabledFocusable,
-    iconPosition: iconPosition,
-    shape: shape,
-    size: size,
+    appearance,
+    disabled,
+    disabledFocusable,
+    iconPosition,
+    shape,
+    size,
     // State calculated from a set of props
     iconOnly: Boolean((iconShorthand === null || iconShorthand === void 0 ? void 0 : iconShorthand.children) && !props.children),
     // Slots definition
@@ -44,7 +38,8 @@ export var useButton = function (props, ref) {
       defaultProps: {
         // useARIAButton isn't working with React.Ref<HTMLButtonElement | HTMLAnchorElement>
         ref: ref,
-        type: 'button'
+        type: 'button' // This is added because the default for type is 'submit'
+
       }
     })),
     icon: iconShorthand

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/components/Button/useButton.ts"],"names":[],"mappings":"AACA,SAAS,aAAT,QAA8B,sBAA9B;AACA,SAAS,qBAAT,EAAgC,gBAAhC,QAAwD,2BAAxD;AAGA;;;;AAIG;;AACH,OAAO,IAAM,SAAS,GAAG,UAAC,KAAD,EAAqB,GAArB,EAA0E;AAE/F,MAAA,UAAU,GASR,KAAK,CATG,UAAV;AAAA,MACA,EAAE,GAQA,KAAK,CARL,EADF;AAAA,MAEA,EAAA,GAOE,KAAK,CAPM,KAFb;AAAA,MAEA,KAAK,GAAA,EAAA,KAAA,KAAA,CAAA,GAAG,KAAH,GAAQ,EAFb;AAAA,MAGA,EAAA,GAME,KAAK,CANS,QAHhB;AAAA,MAGA,QAAQ,GAAA,EAAA,KAAA,KAAA,CAAA,GAAG,KAAH,GAAQ,EAHhB;AAAA,MAIA,EAAA,GAKE,KAAK,CALkB,iBAJzB;AAAA,MAIA,iBAAiB,GAAA,EAAA,KAAA,KAAA,CAAA,GAAG,KAAH,GAAQ,EAJzB;AAAA,MAKA,IAAI,GAIF,KAAK,CAJH,IALJ;AAAA,MAMA,EAAA,GAGE,KAAK,CAHgB,YANvB;AAAA,MAMA,YAAY,GAAA,EAAA,KAAA,KAAA,CAAA,GAAG,QAAH,GAAW,EANvB;AAAA,MAOA,EAAA,GAEE,KAAK,CAFU,KAPjB;AAAA,MAOA,KAAK,GAAA,EAAA,KAAA,KAAA,CAAA,GAAG,SAAH,GAAY,EAPjB;AAAA,MAQA,EAAA,GACE,KAAK,CADQ,IARf;AAAA,MAQA,IAAI,GAAA,EAAA,KAAA,KAAA,CAAA,GAAG,QAAH,GAAW,EARf;AAUF,MAAM,aAAa,GAAG,gBAAgB,CAAC,IAAD,CAAtC;AAEA,SAAO;AACL;AACA,IAAA,UAAU,EAAA,UAFL;AAGL,IAAA,KAAK,EAAA,KAHA;AAIL,IAAA,QAAQ,EAAA,QAJH;AAKL,IAAA,iBAAiB,EAAA,iBALZ;AAML,IAAA,YAAY,EAAA,YANP;AAOL,IAAA,KAAK,EAAA,KAPA;AAQL,IAAA,IAAI,EAAA,IARC;AAUL;AACA,IAAA,QAAQ,EAAE,OAAO,CAAC,CAAA,aAAa,KAAA,IAAb,IAAA,aAAa,KAAA,KAAA,CAAb,GAAa,KAAA,CAAb,GAAA,aAAa,CAAE,QAAf,KAA2B,CAAC,KAAK,CAAC,QAAnC,CAXZ;AAaL;AACA,IAAA,UAAU,EAAE;AACV,MAAA,IAAI,EAAE,QADI;AAEV,MAAA,IAAI,EAAE;AAFI,KAdP;AAmBL,IAAA,IAAI,EAAE,qBAAqB,CACzB,EAAE,IAAI,QADmB,EAEzB,aAAa,CAAC,KAAD,EAAQ;AACnB,MAAA,QAAQ,EAAE,IADS;AAEnB,MAAA,YAAY,EAAE;AACZ;AACA,QAAA,GAAG,EAAE,GAFO;AAGZ,QAAA,IAAI,EAAE;AAHM;AAFK,KAAR,CAFY,CAnBtB;AA8BL,IAAA,IAAI,EAAE;AA9BD,GAAP;AAgCD,CA9CM","sourceRoot":""}
+{"version":3,"sources":["components/Button/useButton.ts"],"names":[],"mappings":"AACA,SAAS,aAAT,QAA8B,sBAA9B;AACA,SAAS,qBAAT,EAAgC,gBAAhC,QAAwD,2BAAxD;AAIA;;;;AAIG;;AACH,OAAO,MAAM,kBAAkB,GAAG,CAChC,KADgC,EAEhC,GAFgC,KAGjB;AACf,QAAM;AACJ,IAAA,UAAU,GAAG,WADT;AAEJ,IAAA,EAFI;AAGJ,IAAA,QAAQ,GAAG,KAHP;AAIJ,IAAA,iBAAiB,GAAG,KAJhB;AAKJ,IAAA,IALI;AAMJ,IAAA,YAAY,GAAG,QANX;AAOJ,IAAA,KAAK,GAAG,SAPJ;AAQJ,IAAA,IAAI,GAAG;AARH,MASF,KATJ;AAUA,QAAM,aAAa,GAAG,gBAAgB,CAAC,IAAD,CAAtC;AAEA,SAAO;AACL;AACA,IAAA,UAFK;AAGL,IAAA,QAHK;AAIL,IAAA,iBAJK;AAKL,IAAA,YALK;AAML,IAAA,KANK;AAOL,IAAA,IAPK;AASL;AACA,IAAA,QAAQ,EAAE,OAAO,CAAC,CAAA,aAAa,KAAA,IAAb,IAAA,aAAa,KAAA,KAAA,CAAb,GAAa,KAAA,CAAb,GAAA,aAAa,CAAE,QAAf,KAA2B,CAAC,KAAK,CAAC,QAAnC,CAVZ;AAYL;AACA,IAAA,UAAU,EAAE;AACV,MAAA,IAAI,EAAE,QADI;AAEV,MAAA,IAAI,EAAE;AAFI,KAbP;AAkBL,IAAA,IAAI,EAAE,qBAAqB,CACzB,EAAE,IAAI,QADmB,EAEzB,aAAa,CAAsB,KAAtB,EAA6B;AACxC,MAAA,QAAQ,EAAE,IAD8B;AAExC,MAAA,YAAY,EAAE;AACZ;AACA,QAAA,GAAG,EAAE,GAFO;AAGZ,QAAA,IAAI,EAAE,QAHM,CAGI;;AAHJ;AAF0B,KAA7B,CAFY,CAlBtB;AA6BL,IAAA,IAAI,EAAE;AA7BD,GAAP;AA+BD,CA/CM","sourcesContent":["import * as React from 'react';\nimport { useARIAButton } from '@fluentui/react-aria';\nimport { getNativeElementProps, resolveShorthand } from '@fluentui/react-utilities';\nimport type { ARIAButtonSlotProps } from '@fluentui/react-aria';\nimport type { ButtonProps, ButtonState } from './Button.types';\n\n/**\n * Given user props, defines default props for the Button, calls useButtonState, and returns processed state.\n * @param props - User provided props to the Button component.\n * @param ref - User provided ref to be passed to the Button component.\n */\nexport const useButton_unstable = (\n  props: ButtonProps,\n  ref: React.Ref<HTMLButtonElement | HTMLAnchorElement>,\n): ButtonState => {\n  const {\n    appearance = 'secondary',\n    as,\n    disabled = false,\n    disabledFocusable = false,\n    icon,\n    iconPosition = 'before',\n    shape = 'rounded',\n    size = 'medium',\n  } = props;\n  const iconShorthand = resolveShorthand(icon);\n\n  return {\n    // Props passed at the top-level\n    appearance,\n    disabled,\n    disabledFocusable,\n    iconPosition,\n    shape,\n    size,\n\n    // State calculated from a set of props\n    iconOnly: Boolean(iconShorthand?.children && !props.children),\n\n    // Slots definition\n    components: {\n      root: 'button',\n      icon: 'span',\n    },\n\n    root: getNativeElementProps(\n      as || 'button',\n      useARIAButton<ARIAButtonSlotProps>(props, {\n        required: true,\n        defaultProps: {\n          // useARIAButton isn't working with React.Ref<HTMLButtonElement | HTMLAnchorElement>\n          ref: ref as React.Ref<HTMLButtonElement>,\n          type: 'button', // This is added because the default for type is 'submit'\n        },\n      }),\n    ),\n    icon: iconShorthand,\n  };\n};\n"],"sourceRoot":"../src/"}