@atlaskit/button 16.10.2 → 16.12.0

package/dist/types/new-button/variants/default/button.d.ts

@@ -1,9 +1,7 @@
 import React from 'react';
-import { type AdditionalHTMLElementPropsExtender, type CombinedButtonProps } from '../types';
+import { type CommonButtonVariantProps } from '../types';
 import { type CommonDefaultButtonProps } from './types';
-type Element = HTMLButtonElement;
-type AdditionalHTMLElementProps = AdditionalHTMLElementPropsExtender<React.ButtonHTMLAttributes<Element>>;
-export type ButtonProps = CommonDefaultButtonProps & CombinedButtonProps<Element, AdditionalHTMLElementProps>;
+export type ButtonProps = CommonDefaultButtonProps & CommonButtonVariantProps;
 /**
  * __Button__
  *
@@ -15,5 +13,5 @@ export type ButtonProps = CommonDefaultButtonProps & CombinedButtonProps<Element
  * - [Code](https://atlassian.design/components/button/code)
  * - [Usage](https://atlassian.design/components/button/usage)
  */
-declare const Button: React.MemoExoticComponent<React.ForwardRefExoticComponent<CommonDefaultButtonProps & Omit<AdditionalHTMLElementProps, keyof import("../types").CommonButtonProps<TagName>> & import("../types").CommonButtonProps<HTMLButtonElement> & React.RefAttributes<HTMLButtonElement>>>;
+declare const Button: React.MemoExoticComponent<React.ForwardRefExoticComponent<CommonDefaultButtonProps & Omit<import("../types").AdditionalHTMLElementPropsExtender<React.ButtonHTMLAttributes<HTMLButtonElement>>, keyof import("../types").CommonButtonProps<TagName>> & import("../types").CommonButtonProps<HTMLButtonElement> & React.RefAttributes<HTMLButtonElement>>>;
 export default Button;

package/dist/types/new-button/variants/default/link.d.ts

@@ -1,17 +1,20 @@
-import React from 'react';
-import { type AdditionalHTMLElementPropsExtender, type CombinedButtonProps } from '../types';
+import React, { type Ref } from 'react';
+import { type CommonLinkVariantProps } from '../types';
 import { type CommonDefaultButtonProps } from './types';
-type Element = HTMLAnchorElement;
-type AdditionalHTMLElementProps = AdditionalHTMLElementPropsExtender<React.AnchorHTMLAttributes<Element>>;
-export type LinkButtonProps = CommonDefaultButtonProps & CombinedButtonProps<Element, AdditionalHTMLElementProps>;
+export type LinkButtonProps<RouterLinkConfig extends Record<string, any> = never> = CommonDefaultButtonProps & CommonLinkVariantProps<RouterLinkConfig>;
+declare const LinkButtonBase: <RouterLinkConfig extends Record<string, any> = never>({ analyticsContext, autoFocus, appearance, spacing, isDisabled, isSelected, iconBefore, iconAfter, children, shouldFitContainer, interactionName, overlay, onClick, onMouseDownCapture, onMouseUpCapture, onKeyDownCapture, onKeyUpCapture, onTouchStartCapture, onTouchEndCapture, onPointerDownCapture, onPointerUpCapture, onClickCapture, testId, href, ...rest }: LinkButtonProps<RouterLinkConfig>, ref: Ref<HTMLAnchorElement>) => JSX.Element;
 /**
  * __Link Button__
  *
- * A link button renders a link in the style of a button.
+ * Renders a link in the style of a button.
  *
  * - [Examples](https://atlassian.design/components/button/examples)
  * - [Code](https://atlassian.design/components/button/code)
  * - [Usage](https://atlassian.design/components/button/usage)
  */
-declare const LinkButton: React.MemoExoticComponent<React.ForwardRefExoticComponent<CommonDefaultButtonProps & Omit<AdditionalHTMLElementProps, keyof import("../types").CommonButtonProps<TagName>> & import("../types").CommonButtonProps<HTMLAnchorElement> & React.RefAttributes<HTMLAnchorElement>>>;
+declare const LinkButton: <RouterLinkConfig extends Record<string, any> = never>(props: CommonDefaultButtonProps & {
+    href: string | RouterLinkConfig;
+} & Omit<import("../types").AdditionalHTMLElementPropsExtender<Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, "href">>, keyof import("../types").CommonButtonProps<TagName>> & import("../types").CommonButtonProps<HTMLAnchorElement> & {
+    ref?: React.Ref<HTMLAnchorElement> | undefined;
+}) => ReturnType<typeof LinkButtonBase>;
 export default LinkButton;

package/dist/types/new-button/variants/icon/button.d.ts

@@ -1,9 +1,7 @@
 import React from 'react';
-import { type AdditionalHTMLElementPropsExtender, type CombinedButtonProps } from '../types';
+import { type CommonButtonVariantProps } from '../types';
 import { type CommonIconButtonProps } from './types';
-type Element = HTMLButtonElement;
-type AdditionalHTMLElementProps = AdditionalHTMLElementPropsExtender<React.ButtonHTMLAttributes<Element>>;
-export type IconButtonProps = CommonIconButtonProps & CombinedButtonProps<Element, AdditionalHTMLElementProps>;
+export type IconButtonProps = CommonIconButtonProps & CommonButtonVariantProps;
 /**
  * __Icon Button__
  *
@@ -13,5 +11,5 @@ export type IconButtonProps = CommonIconButtonProps & CombinedButtonProps<Elemen
  * - [Code](https://atlassian.design/components/button/code)
  * - [Usage](https://atlassian.design/components/button/usage)
  */
-declare const IconButton: React.MemoExoticComponent<React.ForwardRefExoticComponent<CommonIconButtonProps & Omit<AdditionalHTMLElementProps, keyof import("../types").CommonButtonProps<TagName>> & import("../types").CommonButtonProps<HTMLButtonElement> & React.RefAttributes<HTMLButtonElement>>>;
+declare const IconButton: React.MemoExoticComponent<React.ForwardRefExoticComponent<CommonIconButtonProps & Omit<import("../types").AdditionalHTMLElementPropsExtender<React.ButtonHTMLAttributes<HTMLButtonElement>>, keyof import("../types").CommonButtonProps<TagName>> & import("../types").CommonButtonProps<HTMLButtonElement> & React.RefAttributes<HTMLButtonElement>>>;
 export default IconButton;

package/dist/types/new-button/variants/icon/link.d.ts

@@ -1,17 +1,20 @@
-import React from 'react';
-import { type AdditionalHTMLElementPropsExtender, type CombinedButtonProps } from '../types';
+import React, { type Ref } from 'react';
+import { type CommonLinkVariantProps } from '../types';
 import { type CommonIconButtonProps } from './types';
-type Element = HTMLAnchorElement;
-type AdditionalHTMLElementProps = AdditionalHTMLElementPropsExtender<React.AnchorHTMLAttributes<Element>>;
-export type LinkIconButtonProps = CommonIconButtonProps & CombinedButtonProps<Element, AdditionalHTMLElementProps>;
+export type LinkIconButtonProps<RouterLinkConfig extends Record<string, any> = never> = CommonIconButtonProps & CommonLinkVariantProps<RouterLinkConfig>;
+declare const LinkIconButtonBase: <RouterLinkConfig extends Record<string, any> = never>({ analyticsContext, autoFocus, appearance, spacing, isDisabled, isSelected, icon, children, interactionName, overlay, onClick, onMouseDownCapture, onMouseUpCapture, onKeyDownCapture, onKeyUpCapture, onTouchStartCapture, onTouchEndCapture, onPointerDownCapture, onPointerUpCapture, onClickCapture, testId, href, ...rest }: LinkIconButtonProps<RouterLinkConfig>, ref: Ref<HTMLAnchorElement>) => JSX.Element;
 /**
- * __Link Button__
+ * __Link Icon Button__
  *
- * A link button renders a link in the style of a button.
+ * Renders a link in the style of an icon button.
  *
  * - [Examples](https://atlassian.design/components/button/examples)
  * - [Code](https://atlassian.design/components/button/code)
  * - [Usage](https://atlassian.design/components/button/usage)
  */
-declare const LinkIconButton: React.MemoExoticComponent<React.ForwardRefExoticComponent<CommonIconButtonProps & Omit<AdditionalHTMLElementProps, keyof import("../types").CommonButtonProps<TagName>> & import("../types").CommonButtonProps<HTMLAnchorElement> & React.RefAttributes<HTMLAnchorElement>>>;
+declare const LinkIconButton: <RouterLinkConfig extends Record<string, any> = never>(props: CommonIconButtonProps & {
+    href: string | RouterLinkConfig;
+} & Omit<import("../types").AdditionalHTMLElementPropsExtender<Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, "href">>, keyof import("../types").CommonButtonProps<TagName>> & import("../types").CommonButtonProps<HTMLAnchorElement> & {
+    ref?: React.Ref<HTMLAnchorElement> | undefined;
+}) => ReturnType<typeof LinkIconButtonBase>;
 export default LinkIconButton;

package/dist/types/new-button/variants/shared/use-button-base.d.ts

@@ -33,5 +33,5 @@ export type UseButtonBaseReturn<TagName extends HTMLElement> = {
  *
  * @private
  */
-declare const useButtonBase: <TagName extends HTMLElement>({ analyticsContext, appearance, autoFocus, buttonType, interactionName, isDisabled, isSelected, isIconButton, hasIconBefore, hasIconAfter, children, onClick: providedOnClick, onMouseDownCapture, onMouseUpCapture, onKeyDownCapture, onKeyUpCapture, onTouchStartCapture, onTouchEndCapture, onPointerDownCapture, onPointerUpCapture, onClickCapture, overlay, ref, shouldFitContainer, spacing, }: UseButtonBaseArgs<TagName>) => UseButtonBaseReturn<TagName>;
+declare const useButtonBase: <TagName extends HTMLElement>({ analyticsContext, appearance: propAppearance, autoFocus, buttonType, interactionName, isDisabled: propIsDisabled, isSelected, isIconButton, hasIconBefore, hasIconAfter, children, onClick: providedOnClick, onMouseDownCapture, onMouseUpCapture, onKeyDownCapture, onKeyUpCapture, onTouchStartCapture, onTouchEndCapture, onPointerDownCapture, onPointerUpCapture, onClickCapture, overlay, ref, shouldFitContainer, spacing: propSpacing, }: UseButtonBaseArgs<TagName>) => UseButtonBaseReturn<TagName>;
 export default useButtonBase;

package/dist/types/new-button/variants/shared/xcss.d.ts

@@ -1,10 +1,15 @@
 import { xcss } from '@atlaskit/primitives';
 import { type Appearance, type Spacing } from '../types';
+export declare const heights: {
+    [key in Spacing]: string;
+};
 export type GetXCSSArgs = {
     appearance: Appearance;
     spacing: Spacing;
     isDisabled: boolean;
     isSelected: boolean;
+    isHighlighted: boolean;
+    isActiveOverSelected: boolean;
     shouldFitContainer: boolean;
     hasOverlay: boolean;
     isIconButton: boolean;
@@ -14,5 +19,13 @@ export type GetXCSSArgs = {
      * If the button is a LinkButton
      */
     isLink: boolean;
+    /**
+     * If the button is a SplitButton
+     */
+    isSplit: boolean;
+    /**
+     * If the button is a PrimarySplitButton used in atlassian-navigation
+     */
+    isNavigationSplit: boolean;
 };
-export declare function getXCSS({ appearance, spacing, isDisabled, isSelected, isIconButton, shouldFitContainer, isLink, hasOverlay, hasIconBefore, hasIconAfter, }: GetXCSSArgs): ReturnType<typeof xcss>;
+export declare function getXCSS({ appearance, spacing, isDisabled, isSelected, isHighlighted, isActiveOverSelected, isIconButton, shouldFitContainer, isLink, isSplit, isNavigationSplit, hasOverlay, hasIconBefore, hasIconAfter, }: GetXCSSArgs): ReturnType<typeof xcss>;

package/dist/types/new-button/variants/types.d.ts

@@ -63,7 +63,17 @@ export type AdditionalHTMLElementPropsExtender<Props extends SupportedElementAtt
     'data-testid'?: never;
 }>;
 /**
- * Combines common buttom props with additional HTML attributes.
+ * Combines common button props with additional HTML attributes.
  */
 export type CombinedButtonProps<TagName extends HTMLElement, HTMLAttributes extends SupportedElementAttributes> = Combine<HTMLAttributes, CommonButtonProps<TagName>>;
+/**
+ * Common props for Button `<button>` variants
+ */
+export type CommonButtonVariantProps = CombinedButtonProps<HTMLButtonElement, AdditionalHTMLElementPropsExtender<React.ButtonHTMLAttributes<HTMLButtonElement>>>;
+/**
+ * Common props for Link `<a>` Button variants
+ */
+export type CommonLinkVariantProps<RouterLinkConfig extends Record<string, any> = never> = {
+    href: string | RouterLinkConfig;
+} & CombinedButtonProps<HTMLAnchorElement, AdditionalHTMLElementPropsExtender<Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, 'href'>>>;
 export {};

package/dist/types/old-button/types.d.ts

@@ -78,8 +78,8 @@ export type BaseOwnProps = {
     testId?: string;
     component?: React.ComponentType<React.AllHTMLAttributes<HTMLElement>> | React.ElementType;
     /**
-     * An optional name used to identify this component to press listeners. E.g. interaction tracing
-     * @see https://hello.atlassian.net/wiki/spaces/UFO/pages/2010358949/UFO+Integration+into+Design+System+components
+     * An optional name used to identify this component to press listeners. For example, interaction tracing. For more information,
+     * see [UFO integration into Design System components](https://go.atlassian.com/react-ufo-dst-integration)
      */
     interactionName?: string;
     /**

package/dist/types/utils/variants.d.ts

@@ -1,5 +1,7 @@
 import React from 'react';
 import Button from '../new-button/variants/default/button';
+import { LinkButtonProps } from '../new-button/variants/default/link';
+import { LinkIconButtonProps } from '../new-button/variants/icon/link';
 export type Variant = {
     name: string;
     Component: typeof Button | typeof LinkButtonRender;
@@ -8,8 +10,28 @@ export type Variant = {
      */
     elementType: typeof HTMLButtonElement | typeof HTMLAnchorElement;
 };
-declare const LinkButtonRender: React.ForwardRefExoticComponent<import("../new-button/variants/default/types").CommonDefaultButtonProps & Omit<Omit<Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, "style" | "disabled" | "className" | "role">, "data-testid"> & {
-    'data-testid'?: undefined;
-}, keyof import("../new-button/variants/types").CommonButtonProps<TagName>> & import("../new-button/variants/types").CommonButtonProps<HTMLAnchorElement> & React.RefAttributes<HTMLAnchorElement>>;
+declare const LinkButtonRender: React.ForwardRefExoticComponent<Omit<LinkButtonProps<never>, "href"> & {
+    href?: string | undefined;
+} & React.RefAttributes<HTMLAnchorElement>>;
 export declare const variants: Variant[];
 export default variants;
+export declare const linkButtonVariants: ({
+    name: string;
+    Component: React.ForwardRefExoticComponent<Omit<LinkButtonProps<never>, "href"> & {
+        href?: string | undefined;
+    } & React.RefAttributes<HTMLAnchorElement>>;
+    elementType: {
+        new (): HTMLAnchorElement;
+        prototype: HTMLAnchorElement;
+    };
+} | {
+    name: string;
+    Component: React.ForwardRefExoticComponent<Omit<LinkIconButtonProps<never>, "href" | "icon"> & {
+        href?: string | undefined;
+        icon?: React.ReactChild | undefined;
+    } & React.RefAttributes<HTMLAnchorElement>>;
+    elementType: {
+        new (): HTMLAnchorElement;
+        prototype: HTMLAnchorElement;
+    };
+})[];

package/dist/types-ts4.5/containers/button-group.d.ts

@@ -0,0 +1,12 @@
+/** @jsx jsx */
+import React from 'react';
+import { jsx } from '@emotion/react';
+import { Appearance } from '../old-button/types';
+export type ButtonGroupProps = {
+    /**
+     * The appearance to apply to all buttons.
+     */
+    appearance?: Appearance;
+    children?: React.ReactNode;
+};
+export default function ButtonGroup({ appearance, children, }: ButtonGroupProps): jsx.JSX.Element;

package/dist/types-ts4.5/entry-points/button-group.d.ts

@@ -0,0 +1 @@
+export { default } from '../containers/button-group';

package/dist/types-ts4.5/entry-points/custom-theme-button.d.ts

@@ -0,0 +1,2 @@
+export { default, Theme } from '../old-button/custom-theme-button';
+export type { ThemeTokens, ThemeProps, InteractionState, CustomThemeButtonProps, CustomThemeButtonOwnProps, } from '../old-button/custom-theme-button/custom-theme-button-types';

package/dist/types-ts4.5/entry-points/loading-button.d.ts

@@ -0,0 +1,2 @@
+export { default } from '../old-button/loading-button';
+export type { LoadingButtonProps, LoadingButtonOwnProps, } from '../old-button/loading-button';

package/dist/types-ts4.5/entry-points/new.d.ts

@@ -0,0 +1,6 @@
+export { default, type ButtonProps, } from '../new-button/variants/default/button';
+export { default as LinkButton, type LinkButtonProps, } from '../new-button/variants/default/link';
+export { default as IconButton, type IconButtonProps, } from '../new-button/variants/icon/button';
+export { default as LinkIconButton, type LinkIconButtonProps, } from '../new-button/variants/icon/link';
+export { SplitButton } from '../new-button/containers/split-button';
+export type { Appearance, Spacing } from '../new-button/variants/types';

package/dist/types-ts4.5/entry-points/standard-button.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Must import '@emotion/core' in order to resolve type error
+ * https://product-fabric.atlassian.net/browse/DSP-3222
+ */
+import '@emotion/react';
+export { default } from '../old-button/button';
+export type { ButtonProps } from '../old-button/button';

package/dist/types-ts4.5/entry-points/types.d.ts

@@ -0,0 +1,4 @@
+export type { Appearance, Spacing, BaseOwnProps, BaseProps, } from '../old-button/types';
+export type { ButtonProps } from './standard-button';
+export type { LoadingButtonProps, LoadingButtonOwnProps, } from './loading-button';
+export type { ThemeTokens, ThemeProps, InteractionState, CustomThemeButtonProps, CustomThemeButtonOwnProps, } from './custom-theme-button';

package/dist/types-ts4.5/entry-points/unsafe.d.ts

@@ -0,0 +1,4 @@
+export { default as UNSAFE_BUTTON } from '../new-button/variants/default/button';
+export { default as UNSAFE_ICON_BUTTON } from '../new-button/variants/icon/button';
+export { SplitButton as UNSAFE_SPLIT_BUTTON, SplitButtonContainer as UNSAFE_SPLIT_BUTTON_CONTAINER, Divider as UNSAFE_DIVIDER, getActions as UNSAFE_GET_ACTIONS, } from '../new-button/containers/split-button';
+export { SplitButtonContext as UNSAFE_SPLIT_BUTTON_CONTEXT } from '../new-button/containers/split-button/split-button-context';

package/dist/types-ts4.5/index.d.ts

@@ -0,0 +1,8 @@
+export type { Appearance, Spacing, BaseOwnProps, BaseProps, } from './entry-points/types';
+export { default, } from './entry-points/standard-button';
+export type { ButtonProps } from './entry-points/standard-button';
+export { default as LoadingButton } from './entry-points/loading-button';
+export type { LoadingButtonProps, LoadingButtonOwnProps, } from './entry-points/loading-button';
+export { default as CustomThemeButton, Theme, } from './entry-points/custom-theme-button';
+export type { ThemeTokens, ThemeProps, InteractionState, CustomThemeButtonProps, CustomThemeButtonOwnProps, } from './entry-points/custom-theme-button';
+export { default as ButtonGroup } from './entry-points/button-group';

package/dist/types-ts4.5/new-button/containers/split-button/index.d.ts

@@ -0,0 +1,3 @@
+export { SplitButton, SplitButtonWithSlots, Divider, SplitButtonContainer, } from './split-button';
+export { getActions } from './utils';
+export { SplitButtonContext, useSplitButtonContext, } from './split-button-context';

package/dist/types-ts4.5/new-button/containers/split-button/split-button-context.d.ts

@@ -0,0 +1,47 @@
+/// <reference types="react" />
+import { SplitButtonAppearance, SplitButtonSpacing } from './types';
+type NavigationSplitButtonContextProps = {
+    appearance: 'navigation';
+    isHighlighted: boolean;
+};
+type MainSplitButtonContextProps = {
+    appearance: SplitButtonAppearance;
+    spacing: SplitButtonSpacing;
+    isDisabled: boolean;
+};
+type SplitButtonContextProps = NavigationSplitButtonContextProps | MainSplitButtonContextProps;
+/**
+ * TODO: Add jsdoc
+ */
+export declare const SplitButtonContext: import("react").Context<SplitButtonContextProps | undefined>;
+type UseSplitButtonContext = {
+    appearance: SplitButtonAppearance | 'subtle';
+    spacing: SplitButtonSpacing;
+    isDisabled: boolean;
+    /**
+     * isSelected state has limited relevance (e.g. dropdown-menu trigger button).
+     * There is no isSelected state for color variants (e.g. primary, danger, warning).
+     * Hens we provide ability to override the isSelected state with isActiveOverSelected to display `active` state instead of `selected` state.
+     */
+    isActiveOverSelected: boolean;
+    isNavigationSplitButton: boolean;
+    isHighlighted: boolean;
+};
+type NavigationSplitButtonContext = UseSplitButtonContext & {
+    appearance: 'subtle';
+    spacing: 'default';
+    isDisabled: false;
+    isActiveOverSelected: false;
+    isNavigationSplitButton: true;
+    isHighlighted: boolean;
+};
+type MainSplitButtonContext = UseSplitButtonContext & {
+    appearance: SplitButtonAppearance;
+    spacing: SplitButtonSpacing;
+    isDisabled: boolean;
+    isActiveOverSelected: true;
+    isNavigationSplitButton: false;
+    isHighlighted: false;
+};
+export declare const useSplitButtonContext: () => NavigationSplitButtonContext | MainSplitButtonContext | undefined;
+export {};

package/dist/types-ts4.5/new-button/containers/split-button/split-button.d.ts

@@ -0,0 +1,47 @@
+/** @jsx jsx */
+import { type ReactNode } from 'react';
+import { jsx } from '@emotion/react';
+import type { SplitButtonAppearance, SplitButtonContextAppearance, SplitButtonSpacing } from './types';
+type DividerProps = {
+    appearance: SplitButtonContextAppearance;
+    spacing: SplitButtonSpacing;
+    isDisabled?: boolean;
+};
+/**
+ * TODO: Add JSDoc
+ */
+export declare const Divider: ({ appearance, spacing, isDisabled, }: DividerProps) => jsx.JSX.Element;
+/**
+ * TODO: Add JSdoc
+ */
+export declare const SplitButtonContainer: ({ children }: {
+    children: ReactNode;
+}) => jsx.JSX.Element;
+type SplitButtonProps = {
+    /**
+     * Only two children are allowed.
+     * First child is the primary action, second child is the secondary action.
+     * The assumption is that for both children trees there is a button reading the context.
+     */
+    children: ReactNode;
+    appearance?: SplitButtonAppearance;
+    spacing?: SplitButtonSpacing;
+    isDisabled?: boolean;
+};
+/**
+ * TODO: Add description when adding docs
+ */
+export declare const SplitButton: ({ children, appearance, spacing, isDisabled, }: SplitButtonProps) => jsx.JSX.Element;
+type SplitButtonWithSlotsProps = {
+    primaryAction: ReactNode;
+    secondaryAction: ReactNode;
+    appearance?: SplitButtonAppearance;
+    spacing?: SplitButtonSpacing;
+    isDisabled?: boolean;
+    isSelected?: boolean;
+};
+/**
+ * TODO: Decide on API
+ */
+export declare const SplitButtonWithSlots: ({ primaryAction, secondaryAction, appearance, spacing, isDisabled, }: SplitButtonWithSlotsProps) => jsx.JSX.Element;
+export {};

package/dist/types-ts4.5/new-button/containers/split-button/types.d.ts

@@ -0,0 +1,4 @@
+import type { Appearance, Spacing } from '../../variants/types';
+export type SplitButtonAppearance = Extract<Appearance, 'default' | 'primary' | 'danger' | 'warning'>;
+export type SplitButtonContextAppearance = SplitButtonAppearance | 'navigation';
+export type SplitButtonSpacing = Extract<Spacing, 'default' | 'compact'>;

package/dist/types-ts4.5/new-button/containers/split-button/utils.d.ts

@@ -0,0 +1,5 @@
+import { type ReactNode } from 'react';
+export declare const getActions: (children: ReactNode) => {
+    PrimaryAction: import("react").ReactChild | import("react").ReactFragment | import("react").ReactPortal;
+    SecondaryAction: import("react").ReactChild | import("react").ReactFragment | import("react").ReactPortal;
+};

package/dist/types-ts4.5/new-button/variants/default/button.d.ts

@@ -0,0 +1,17 @@
+import React from 'react';
+import { type CommonButtonVariantProps } from '../types';
+import { type CommonDefaultButtonProps } from './types';
+export type ButtonProps = CommonDefaultButtonProps & CommonButtonVariantProps;
+/**
+ * __Button__
+ *
+ * @warning __UNSAFE__ Button is not yet safe for production use.
+ *
+ * A button triggers an event or action.
+ *
+ * - [Examples](https://atlassian.design/components/button/examples)
+ * - [Code](https://atlassian.design/components/button/code)
+ * - [Usage](https://atlassian.design/components/button/usage)
+ */
+declare const Button: React.MemoExoticComponent<React.ForwardRefExoticComponent<CommonDefaultButtonProps & Omit<import("../types").AdditionalHTMLElementPropsExtender<React.ButtonHTMLAttributes<HTMLButtonElement>>, keyof import("../types").CommonButtonProps<TagName>> & import("../types").CommonButtonProps<HTMLButtonElement> & React.RefAttributes<HTMLButtonElement>>>;
+export default Button;

package/dist/types-ts4.5/new-button/variants/default/link.d.ts

@@ -0,0 +1,20 @@
+import React, { type Ref } from 'react';
+import { type CommonLinkVariantProps } from '../types';
+import { type CommonDefaultButtonProps } from './types';
+export type LinkButtonProps<RouterLinkConfig extends Record<string, any> = never> = CommonDefaultButtonProps & CommonLinkVariantProps<RouterLinkConfig>;
+declare const LinkButtonBase: <RouterLinkConfig extends Record<string, any> = never>({ analyticsContext, autoFocus, appearance, spacing, isDisabled, isSelected, iconBefore, iconAfter, children, shouldFitContainer, interactionName, overlay, onClick, onMouseDownCapture, onMouseUpCapture, onKeyDownCapture, onKeyUpCapture, onTouchStartCapture, onTouchEndCapture, onPointerDownCapture, onPointerUpCapture, onClickCapture, testId, href, ...rest }: LinkButtonProps<RouterLinkConfig>, ref: Ref<HTMLAnchorElement>) => JSX.Element;
+/**
+ * __Link Button__
+ *
+ * Renders a link in the style of a button.
+ *
+ * - [Examples](https://atlassian.design/components/button/examples)
+ * - [Code](https://atlassian.design/components/button/code)
+ * - [Usage](https://atlassian.design/components/button/usage)
+ */
+declare const LinkButton: <RouterLinkConfig extends Record<string, any> = never>(props: CommonDefaultButtonProps & {
+    href: string | RouterLinkConfig;
+} & Omit<import("../types").AdditionalHTMLElementPropsExtender<Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, "href">>, keyof import("../types").CommonButtonProps<TagName>> & import("../types").CommonButtonProps<HTMLAnchorElement> & {
+    ref?: React.Ref<HTMLAnchorElement> | undefined;
+}) => ReturnType<typeof LinkButtonBase>;
+export default LinkButton;

package/dist/types-ts4.5/new-button/variants/default/types.d.ts

@@ -0,0 +1,15 @@
+/// <reference types="react" />
+export type CommonDefaultButtonProps = {
+    /**
+     * Places an icon within the button, after the button's text
+     */
+    iconAfter?: React.ReactChild;
+    /**
+     * Places an icon within the button, before the button's text
+     */
+    iconBefore?: React.ReactChild;
+    /**
+     * Option to fit button width to its parent width
+     */
+    shouldFitContainer?: boolean;
+};

package/dist/types-ts4.5/new-button/variants/default/use-default-button.d.ts

@@ -0,0 +1,15 @@
+import { type UseButtonBaseArgs, type UseButtonBaseReturn } from '../shared/use-button-base';
+import { type CommonDefaultButtonProps } from './types';
+type UseDefaultButtonArgs<TagName extends HTMLElement> = UseButtonBaseArgs<TagName> & CommonDefaultButtonProps;
+type UseButtonReturn<TagName extends HTMLElement> = UseButtonBaseReturn<TagName>;
+/**
+ * __Use default button base__
+ *
+ * A React hook that accepts a set of default Button props,
+ * and processes them to return consistent base props for usage
+ * across Button and LinkButton variants.
+ *
+ * @private
+ */
+declare const useDefaultButton: <TagName extends HTMLElement>({ analyticsContext, appearance, autoFocus, buttonType, iconBefore, iconAfter, interactionName, isDisabled, isSelected, children, onClick, onMouseDownCapture, onMouseUpCapture, onKeyDownCapture, onKeyUpCapture, onTouchStartCapture, onTouchEndCapture, onPointerDownCapture, onPointerUpCapture, onClickCapture, overlay, ref, shouldFitContainer, spacing, }: UseDefaultButtonArgs<TagName>) => UseButtonReturn<TagName>;
+export default useDefaultButton;

package/dist/types-ts4.5/new-button/variants/icon/button.d.ts

@@ -0,0 +1,15 @@
+import React from 'react';
+import { type CommonButtonVariantProps } from '../types';
+import { type CommonIconButtonProps } from './types';
+export type IconButtonProps = CommonIconButtonProps & CommonButtonVariantProps;
+/**
+ * __Icon Button__
+ *
+ * TODO: Description
+ *
+ * - [Examples](https://atlassian.design/components/button/examples)
+ * - [Code](https://atlassian.design/components/button/code)
+ * - [Usage](https://atlassian.design/components/button/usage)
+ */
+declare const IconButton: React.MemoExoticComponent<React.ForwardRefExoticComponent<CommonIconButtonProps & Omit<import("../types").AdditionalHTMLElementPropsExtender<React.ButtonHTMLAttributes<HTMLButtonElement>>, keyof import("../types").CommonButtonProps<TagName>> & import("../types").CommonButtonProps<HTMLButtonElement> & React.RefAttributes<HTMLButtonElement>>>;
+export default IconButton;

package/dist/types-ts4.5/new-button/variants/icon/link.d.ts

@@ -0,0 +1,20 @@
+import React, { type Ref } from 'react';
+import { type CommonLinkVariantProps } from '../types';
+import { type CommonIconButtonProps } from './types';
+export type LinkIconButtonProps<RouterLinkConfig extends Record<string, any> = never> = CommonIconButtonProps & CommonLinkVariantProps<RouterLinkConfig>;
+declare const LinkIconButtonBase: <RouterLinkConfig extends Record<string, any> = never>({ analyticsContext, autoFocus, appearance, spacing, isDisabled, isSelected, icon, children, interactionName, overlay, onClick, onMouseDownCapture, onMouseUpCapture, onKeyDownCapture, onKeyUpCapture, onTouchStartCapture, onTouchEndCapture, onPointerDownCapture, onPointerUpCapture, onClickCapture, testId, href, ...rest }: LinkIconButtonProps<RouterLinkConfig>, ref: Ref<HTMLAnchorElement>) => JSX.Element;
+/**
+ * __Link Icon Button__
+ *
+ * Renders a link in the style of an icon button.
+ *
+ * - [Examples](https://atlassian.design/components/button/examples)
+ * - [Code](https://atlassian.design/components/button/code)
+ * - [Usage](https://atlassian.design/components/button/usage)
+ */
+declare const LinkIconButton: <RouterLinkConfig extends Record<string, any> = never>(props: CommonIconButtonProps & {
+    href: string | RouterLinkConfig;
+} & Omit<import("../types").AdditionalHTMLElementPropsExtender<Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, "href">>, keyof import("../types").CommonButtonProps<TagName>> & import("../types").CommonButtonProps<HTMLAnchorElement> & {
+    ref?: React.Ref<HTMLAnchorElement> | undefined;
+}) => ReturnType<typeof LinkIconButtonBase>;
+export default LinkIconButton;

package/dist/types-ts4.5/new-button/variants/icon/types.d.ts

@@ -0,0 +1,8 @@
+/// <reference types="react" />
+export type CommonIconButtonProps = {
+    /**
+     * TODO: Consider locking-down icon props by converting from slot props to component props
+     * Places an icon within the button, after the button's text
+     */
+    icon: React.ReactChild;
+};

package/dist/types-ts4.5/new-button/variants/icon/use-icon-button.d.ts

@@ -0,0 +1,15 @@
+import { type UseButtonBaseArgs, type UseButtonBaseReturn } from '../shared/use-button-base';
+import { type CommonIconButtonProps } from './types';
+type UseIconButtonArgs<TagName extends HTMLElement> = UseButtonBaseArgs<TagName> & CommonIconButtonProps;
+type UseIconButtonReturn<TagName extends HTMLElement> = UseButtonBaseReturn<TagName>;
+/**
+ * __Use icon button__
+ *
+ * A React hook that accepts a set of icon Button props,
+ * and processes them to return consistent base props for usage
+ * across IconButton and LinkIconButton variants.
+ *
+ * @private
+ */
+declare const useIconButton: <TagName extends HTMLElement>({ analyticsContext, appearance, autoFocus, buttonType, icon, interactionName, isDisabled, isSelected, onClick, onMouseDownCapture, onMouseUpCapture, onKeyDownCapture, onKeyUpCapture, onTouchStartCapture, onTouchEndCapture, onPointerDownCapture, onPointerUpCapture, onClickCapture, overlay, ref, shouldFitContainer, spacing, }: UseIconButtonArgs<TagName>) => UseIconButtonReturn<TagName>;
+export default useIconButton;

package/dist/types-ts4.5/new-button/variants/shared/block-events.d.ts

@@ -0,0 +1,2 @@
+import { type ControlledEvents } from './use-button-base';
+export default function blockEvents<TagName extends HTMLElement>(shouldBlockEvents: boolean, events: ControlledEvents<TagName>): ControlledEvents<TagName>;

package/dist/types-ts4.5/new-button/variants/shared/colors.d.ts

@@ -0,0 +1,18 @@
+import { type BackgroundColor, type TextColor } from '@atlaskit/primitives';
+import { type Appearance } from '../types';
+export type ColorGroup<T extends BackgroundColor | TextColor> = {
+    default: T;
+    hover?: T;
+    active?: T;
+    disabled?: T;
+    selected?: T;
+};
+export type ColorPreset<T extends BackgroundColor | TextColor> = {
+    [key in Appearance]: ColorGroup<T>;
+};
+type Values = {
+    background: ColorPreset<BackgroundColor>;
+    color: ColorPreset<TextColor>;
+};
+declare const values: Values;
+export default values;

package/dist/types-ts4.5/new-button/variants/shared/content.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+type ContentProps = {
+    children: React.ReactNode;
+    type?: 'text' | 'icon';
+    hasOverlay: boolean;
+};
+/**
+ * __Content__
+ *
+ * Used for slots within a Button, including icons and text content.
+ */
+declare const Content: ({ children, type, hasOverlay }: ContentProps) => JSX.Element;
+export default Content;

package/dist/types-ts4.5/new-button/variants/shared/use-button-base.d.ts

@@ -0,0 +1,37 @@
+import React from 'react';
+import { xcss } from '@atlaskit/primitives';
+import { type CommonButtonProps } from '../types';
+export type ControlledEvents<TagName extends HTMLElement> = Pick<React.DOMAttributes<TagName>, 'onMouseDownCapture' | 'onMouseUpCapture' | 'onKeyDownCapture' | 'onKeyUpCapture' | 'onTouchStartCapture' | 'onTouchEndCapture' | 'onPointerDownCapture' | 'onPointerUpCapture' | 'onClickCapture' | 'onClick'>;
+export type ControlledEventsPassed<TagName extends HTMLElement> = Omit<ControlledEvents<TagName>, 'onClick'> & Pick<CommonButtonProps<TagName>, 'onClick'>;
+export type UseButtonBaseArgs<TagName extends HTMLElement> = {
+    ref: React.Ref<TagName>;
+    /**
+     * The type of button. Used to pass action subject context to analytics.
+     */
+    buttonType: 'button' | 'link';
+    isIconButton?: boolean;
+    hasIconBefore?: boolean;
+    hasIconAfter?: boolean;
+    shouldFitContainer?: boolean;
+} & Pick<CommonButtonProps<TagName>, 'analyticsContext' | 'appearance' | 'autoFocus' | 'children' | 'interactionName' | 'isDisabled' | 'isSelected' | 'overlay' | 'spacing'> & ControlledEventsPassed<TagName>;
+export type UseButtonBaseReturn<TagName extends HTMLElement> = {
+    xcss: ReturnType<typeof xcss>;
+    ref(node: TagName | null): void;
+    children: React.ReactNode;
+    isDisabled: boolean;
+} & ControlledEvents<TagName>;
+/**
+ * __Use button base__
+ *
+ * A React hook that accepts a set of common Button props,
+ * and processes them to return consistent base props for usage
+ * across various Button components.
+ *
+ * It also:
+ * - Implements auto focus when enabled.
+ * - Appends the `onClick` event with UFO analytics tracking.
+ *
+ * @private
+ */
+declare const useButtonBase: <TagName extends HTMLElement>({ analyticsContext, appearance: propAppearance, autoFocus, buttonType, interactionName, isDisabled: propIsDisabled, isSelected, isIconButton, hasIconBefore, hasIconAfter, children, onClick: providedOnClick, onMouseDownCapture, onMouseUpCapture, onKeyDownCapture, onKeyUpCapture, onTouchStartCapture, onTouchEndCapture, onPointerDownCapture, onPointerUpCapture, onClickCapture, overlay, ref, shouldFitContainer, spacing: propSpacing, }: UseButtonBaseArgs<TagName>) => UseButtonBaseReturn<TagName>;
+export default useButtonBase;