@workday/canvas-kit-react 5.3.15 → 5.4.0-next.1

package/ts3.5/dist/commonjs/tabs/lib/overflow/useOverflowModel.d.ts

@@ -0,0 +1,69 @@
+import { ToModelConfig } from '@workday/canvas-kit-react/common';
+import { SelectionState, SelectionEvents, BaseSelectionModelConfig, selectionEventMap, SelectionModel } from '../selection';
+export declare type OverflowState<T = unknown> = SelectionState<T> & {
+    containerWidth: number;
+    overflowTargetWidth: number;
+    itemWidthCache: Record<string, number>;
+    hiddenIds: string[];
+};
+export declare type OverflowEvents<T = unknown> = SelectionEvents<T> & {
+    setContainerWidth(data: {
+        width?: number;
+    }): void;
+    setOverflowTargetWidth(data: {
+        width: number;
+    }): void;
+    addItemWidth(data: {
+        id: string;
+        width: number;
+    }): void;
+    removeItemWidth(data: {
+        id: string;
+    }): void;
+    addHiddenKey(data: {
+        id: string;
+    }): void;
+    removeHiddenKey(data: {
+        id: string;
+    }): void;
+};
+export interface OverflowModel<T = unknown> extends SelectionModel<T> {
+    state: OverflowState<T>;
+    events: OverflowEvents<T>;
+}
+export declare const overflowEventMap: {
+    guards: {
+        shouldSetContainerWidth: "setContainerWidth";
+        shouldSetOverflowTargetWidth: "setOverflowTargetWidth";
+        shouldAddItemWidth: "addItemWidth";
+        shouldRemoveItemWidth: "removeItemWidth";
+        shouldAddHiddenKey: "addHiddenKey";
+        shouldRemoveHiddenKey: "removeHiddenKey";
+        shouldSelect: "select";
+        shouldGoTo: "goTo";
+        shouldRegisterItem: "registerItem";
+        shouldUnregisterItem: "unregisterItem";
+        shouldUpdateItemPosition: "updateItemPosition";
+    };
+    callbacks: {
+        onSetContainerWidth: "setContainerWidth";
+        onSetOverflowTargetWidth: "setOverflowTargetWidth";
+        onAddItemWidth: "addItemWidth";
+        onRemoveItemWidth: "removeItemWidth";
+        onAddHiddenKey: "addHiddenKey";
+        onRemoveHiddenKey: "removeHiddenKey";
+        onSelect: "select";
+        onGoTo: "goTo";
+        onRegisterItem: "registerItem";
+        onUnregisterItem: "unregisterItem";
+        onUpdateItemPosition: "updateItemPosition";
+    };
+};
+export declare type BaseOverflowModelConfig<T> = BaseSelectionModelConfig<T> & {
+    initialHiddenIds?: string[];
+    containerWidth?: number;
+};
+export declare type OverflowModelConfig<T> = BaseOverflowModelConfig<T> & Partial<ToModelConfig<OverflowState<T>, OverflowEvents<T>, typeof selectionEventMap>>;
+export declare function getHiddenIds(containerWidth: number, overflowTargetWidth: number, itemWidthCache: Record<string, number>, selectedIds: string[] | 'all'): string[];
+export declare const useOverflowModel: <T extends unknown>(config?: OverflowModelConfig<T>) => OverflowModel<T>;
+//# sourceMappingURL=useOverflowModel.d.ts.map

package/ts3.5/dist/commonjs/tabs/lib/overflow/useOverflowTarget.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+import { OverflowModel } from './useOverflowModel';
+export declare const useOverflowTarget: <P extends {}, R>(model: OverflowModel<unknown>, elemProps?: P | undefined, ref?: ((instance: R | null) => void) | React.RefObject<R> | null | undefined) => {
+    ref: (instance: HTMLButtonElement | null) => void;
+    'aria-hidden': boolean;
+    tabIndex: number;
+    style: {};
+} & P & (R extends HTMLOrSVGElement ? {
+    ref: React.Ref<R>;
+} : {});
+//# sourceMappingURL=useOverflowTarget.d.ts.map

package/ts3.5/dist/commonjs/tabs/lib/selection/index.d.ts

@@ -0,0 +1,4 @@
+export * from './useSelectionModel';
+export * from './useSelectionItem';
+export * from './useResetCursorOnBlur';
+//# sourceMappingURL=index.d.ts.map

package/ts3.5/dist/commonjs/tabs/lib/selection/useResetCursorOnBlur.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+import { SelectionModel } from './useSelectionModel';
+/**
+ * Reset the cursor to the selected item when the list looses focus
+ */
+export declare const useResetCursorOnBlur: <P extends {}, R>(model: SelectionModel<unknown>, elemProps?: P | undefined, ref?: ((instance: R | null) => void) | React.RefObject<R> | null | undefined) => {
+    onKeyDown(event: React.KeyboardEvent<Element>): void;
+    onFocus(): void;
+    onBlur(): void;
+} & P & (R extends HTMLOrSVGElement ? {
+    ref: React.Ref<R>;
+} : {});
+//# sourceMappingURL=useResetCursorOnBlur.d.ts.map

package/ts3.5/dist/commonjs/tabs/lib/selection/useSelectionItem.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import { SelectionModel } from './useSelectionModel';
+export declare const useSelectionItem: <P extends {}, R>(model: SelectionModel<unknown>, elemProps?: P | undefined, ref?: ((instance: R | null) => void) | React.RefObject<R> | null | undefined) => {
+    onClick: (event: React.MouseEvent<HTMLElement, MouseEvent>) => void;
+} & P & (R extends HTMLOrSVGElement ? {
+    ref: React.Ref<R>;
+} : {});
+//# sourceMappingURL=useSelectionItem.d.ts.map

package/ts3.5/dist/commonjs/tabs/lib/selection/useSelectionModel.d.ts

@@ -0,0 +1,62 @@
+import { ToModelConfig } from '@workday/canvas-kit-react/common';
+import { CursorState, CursorEvents, BaseCursorModelConfig, CursorModel } from '../cursor/useCursorModel';
+export declare type Orientation = 'horizontal' | 'vertical';
+export declare type SelectionState<T = unknown> = CursorState<T> & {
+    selectedIds: 'all' | string[];
+    unselectedIds: string[];
+};
+export declare type SelectionEvents<T = unknown> = CursorEvents<T> & {
+    /** Select a specific item by its identifier. */
+    select(data: {
+        id: string;
+    }): void;
+    /** Select all items. This will set `selectedIds` to `'all'` and remove all `unselectedIds`.
+     * This is especially useful for virtual lists where not all items are loaded in memory.
+     */
+    selectAll(): void;
+    unselectAll(): void;
+};
+export interface SelectionModel<T = unknown> extends CursorModel<T> {
+    state: SelectionState<T>;
+    events: SelectionEvents<T>;
+    selection: SelectionManager;
+}
+export declare const selectionEventMap: {
+    guards: {
+        /** Should a cursor position be set? Use only in advance use-cases */
+        shouldSelect: "select";
+        shouldGoTo: "goTo";
+        shouldRegisterItem: "registerItem";
+        shouldUnregisterItem: "unregisterItem";
+        shouldUpdateItemPosition: "updateItemPosition";
+    };
+    callbacks: {
+        /**
+         * Called when a cursor position has been changed. Useful to set state or perform side effects.
+         * This is called during state change batching, so calling state setters will not invoke extra
+         * renders.
+         */
+        onSelect: "select";
+        onGoTo: "goTo";
+        onRegisterItem: "registerItem";
+        onUnregisterItem: "unregisterItem";
+        onUpdateItemPosition: "updateItemPosition";
+    };
+};
+/**
+ * A SelectionManager is used
+ */
+export interface SelectionManager {
+    select(id: string, prevState: Pick<SelectionState, 'selectedIds' | 'unselectedIds'>): Pick<SelectionState, 'selectedIds' | 'unselectedIds'>;
+}
+export declare const isSelected: (id: string, { selectedIds, unselectedIds }: Pick<SelectionState<unknown>, "selectedIds" | "unselectedIds">) => boolean;
+export declare const singleSelectionManager: SelectionManager;
+export declare const multiSelectionManager: SelectionManager;
+export declare type BaseSelectionModelConfig<T> = BaseCursorModelConfig<T> & {
+    initialSelectedIds?: string[];
+    initialUnselectedIds?: string[];
+    selection?: SelectionManager;
+};
+export declare type SelectionModelConfig<T> = BaseSelectionModelConfig<T> & Partial<ToModelConfig<SelectionState<T>, SelectionEvents<T>, typeof selectionEventMap>>;
+export declare const useSelectionModel: <T extends unknown>(config?: SelectionModelConfig<T>) => SelectionModel<T>;
+//# sourceMappingURL=useSelectionModel.d.ts.map

package/ts3.5/dist/commonjs/tabs/lib/useTabsModel.d.ts

@@ -1,70 +1,70 @@
-import { Model, ToModelConfig } from '@workday/canvas-kit-react/common';
-import { CursorState, CursorEvents, BaseCursorModelConfig, Orientation } from './cursor/useCursorModel';
-import { Item, ListEvents, ListState } from './list/useListModel';
-export declare type TabsState = CursorState & {
-    /**
-     * The name of the active tab provided to the `Tabs.Item` component. If no name is provided, it
-     * will be a string of the index position.
-     */
-    activeTab: string;
+import { ToModelConfig } from '@workday/canvas-kit-react/common';
+import { Orientation } from './cursor';
+import { ListEvents, ListState } from './list';
+import { MenuModel, MenuModelConfig } from './menu';
+import { OverflowEvents, OverflowState, BaseOverflowModelConfig, OverflowModel } from './overflow';
+export declare type TabsState<T> = OverflowState<T> & {
+    /** IDREF of the list. Children ids can be derived from this id */
+    id: string;
     /**
      * A list of panels. Uses `ListModel`
      */
-    panels: Item[];
+    panels: T[];
     /**
      * A React.Ref of the current item index. A ref is used to allow for updating outside the normal
      * React state cycle to ensure accurate index tracking as items are registered within the same
      * state setting phase.
      */
-    panelIndexRef: ListState['indexRef'];
+    panelIndexRef: ListState<T>['indexRef'];
+    orientation: Orientation;
+    getId: (item: T) => string;
 };
-export declare type TabsEvents = CursorEvents & {
-    /**
-     * This event will set the `activeTab` in the state. Called when a user activates a tab
-     */
-    activate(data: {
-        /**
-         * The name of the tab provided to the `Tabs.Item` component. If no name is provided, it will
-         * be a string of the index position
-         */
-        tab: string;
-    }): void;
+export declare type TabsEvents<T = unknown> = OverflowEvents<T> & {
     /**
      * This event registers panels with state.panels. Called when a panel is mounted.
      */
-    registerPanel: ListEvents['registerItem'];
+    registerPanel: ListEvents<T>['registerItem'];
     /**
      * This event unregisters panels with state.panels. Called when a panel is unmounted.
      */
-    unregisterPanel: ListEvents['unregisterItem'];
+    unregisterPanel: ListEvents<T>['unregisterItem'];
 };
-export declare type TabsModel = Model<TabsState, TabsEvents>;
+export interface TabsModel<T = unknown> extends OverflowModel<T> {
+    state: TabsState<T>;
+    events: TabsEvents<T>;
+    menu: MenuModel<T>;
+}
 export declare const tabEventMap: {
     guards: {
-        /**
-         * Should the tab activate? Can prevent the tab from activating. Use this only for advanced
-         * use-cases.
+        shouldSetContainerWidth: "setContainerWidth";
+        shouldSetOverflowTargetWidth: "setOverflowTargetWidth";
+        shouldAddItemWidth: "addItemWidth";
+        shouldRemoveItemWidth: "removeItemWidth";
+        shouldAddHiddenKey: "addHiddenKey";
+        shouldRemoveHiddenKey: "removeHiddenKey";
+        shouldSelect: "select"; /**
+         * This event unregisters panels with state.panels. Called when a panel is unmounted.
          */
-        shouldActivate: "activate";
         shouldGoTo: "goTo";
         shouldRegisterItem: "registerItem";
         shouldUnregisterItem: "unregisterItem";
         shouldUpdateItemPosition: "updateItemPosition";
     };
     callbacks: {
-        /**
-         * This callback will fire whenever a tab is activated. The data will contain the tab's named
-         * passed to the `Tabs.Item` component. If no name was passed, it will be the index of the tab
-         * as a string.
-         */
-        onActivate: "activate";
+        onSetContainerWidth: "setContainerWidth";
+        onSetOverflowTargetWidth: "setOverflowTargetWidth";
+        onAddItemWidth: "addItemWidth";
+        onRemoveItemWidth: "removeItemWidth";
+        onAddHiddenKey: "addHiddenKey";
+        onRemoveHiddenKey: "removeHiddenKey";
+        onSelect: "select";
         onGoTo: "goTo";
         onRegisterItem: "registerItem";
         onUnregisterItem: "unregisterItem";
         onUpdateItemPosition: "updateItemPosition";
     };
 };
-export declare type BaseTabsModelConfig = Pick<BaseCursorModelConfig, Exclude<keyof BaseCursorModelConfig, 'orientation'>> & {
+export declare type BaseTabsModelConfig<T> = Pick<BaseOverflowModelConfig<T>, Exclude<keyof BaseOverflowModelConfig<T>, 'orientation'>> & {
     /**
      * Optional id for the whole `Tabs` group. The `aria-controls` of the `Tab.Item` and `id` of the
      * `Tab.Panel` will automatically derived from this id. If not provided, a unique id will be
@@ -83,7 +83,8 @@ export declare type BaseTabsModelConfig = Pick<BaseCursorModelConfig, Exclude<ke
      * @default 'horizontal'
      */
     orientation?: Orientation;
+    menuConfig?: MenuModelConfig<T>;
 };
-export declare type TabsModelConfig = BaseTabsModelConfig & Partial<ToModelConfig<TabsState, TabsEvents, typeof tabEventMap>>;
-export declare const useTabsModel: (config?: TabsModelConfig) => Model<TabsState, TabsEvents>;
+export declare type TabsModelConfig<T> = BaseTabsModelConfig<T> & Partial<ToModelConfig<TabsState<T>, TabsEvents<T>, typeof tabEventMap>>;
+export declare const useTabsModel: <T extends unknown>(config?: TabsModelConfig<T>) => TabsModel<T>;
 //# sourceMappingURL=useTabsModel.d.ts.map

package/ts3.5/dist/commonjs/tokens/index.d.ts

@@ -1,7 +1,7 @@
 import { colors, gradients } from '@workday/canvas-colors-web';
 import { borderRadius, CanvasBorderRadius, CanvasBorderRadiusKeys, CanvasBorderRadiusValues } from './lib/radius';
 import { BrandingColor, CanvasColor } from './lib/colors.types';
-import depth, { CanvasDepth, CanvasDepthValue } from './lib/depth';
+import { depth, CanvasDepth, CanvasDepthValues } from './lib/depth';
 import { space, CanvasSpace, CanvasSpaceKeys, CanvasSpaceValues, CanvasSpaceNumberValues, CanvasSpaceNumbers, spaceNumbers } from './lib/space';
 import { type, fontFamily, monoFontFamily, CanvasType, CanvasTypeProperties, CanvasTypeVariants, CanvasTypeHierarchy } from './lib/type';
 import { CSSProperties } from './lib/types';
@@ -326,24 +326,7 @@ declare const canvas: {
         hoverBackground: string;
         divider: string;
     };
-    depth: {
-        inset: {
-            boxShadow: "inset 0px 0px 8px 0 rgba(82, 97, 115, 0.09)";
-        };
-        1: {
-            boxShadow: "0px 2px 4px 0 rgba(0, 0, 0, 0.08)";
-        };
-        2: {
-            boxShadow: "0px 4px 8px 0 rgba(0, 0, 0, 0.1)";
-        };
-        3: {
-            boxShadow: "0px 8px 16px 0 rgba(0, 0, 0, 0.12)";
-        };
-        4: {
-            border: "1px solid rgba(218, 226, 230, 1)";
-            boxShadow: "0px 8px 16px 0 rgba(0, 0, 0, 0.12)";
-        };
-    };
+    depth: CanvasDepth;
     fontFamily: string;
     gradients: {
         [key: string]: string;
@@ -427,7 +410,7 @@ declare const canvas: {
     };
 };
 export * from '@workday/canvas-colors-web';
-export { borderRadius, colors, gradients, depth, space, spaceNumbers, type, fontFamily, monoFontFamily, BrandingColor, CanvasDepth, CanvasDepthValue, CSSProperties, };
+export { borderRadius, colors, gradients, depth, space, spaceNumbers, type, fontFamily, monoFontFamily, BrandingColor, CanvasDepth, CanvasDepthValues, CSSProperties, };
 export default canvas;
 export { CanvasBorderRadius, CanvasBorderRadiusKeys, CanvasBorderRadiusValues, CanvasColor, CanvasSpace, CanvasSpaceKeys, CanvasSpaceValues, CanvasSpaceNumberValues, CanvasSpaceNumbers, CanvasType, CanvasTypeProperties, CanvasTypeVariants, CanvasTypeHierarchy, };
 //# sourceMappingURL=index.d.ts.map

package/ts3.5/dist/commonjs/tokens/lib/depth.d.ts

@@ -1,4 +1,110 @@
-import depth, { CanvasDepth, CanvasDepthValue } from '@workday/canvas-depth-web';
-export { CanvasDepth, CanvasDepthValue };
-export default depth;
+export declare type CanvasDepth = {
+    /**
+     * ### Depth Inset
+     * 	Used for inset containers
+     *
+     * @example
+     * ```ts
+     * import { depth } from '@workday/canvas-kit-react/tokens';
+     *
+     * const insetCardStyles = {
+     *   ...depth.inset,
+     * };
+     * ```
+     */
+    inset: {
+        boxShadow: 'inset 0px 0px 8px 0 rgba(82, 97, 115, 0.09)';
+    };
+    /**
+     * ### Depth 1
+     * Used for minimal offset
+     *
+     * @example
+     * ```ts
+     * import { depth } from '@workday/canvas-kit-react/tokens';
+     *
+     * const cardStyles = {
+     *   ...depth[1],
+     * };
+     * ```
+     */
+    1: {
+        boxShadow: '0px 2px 4px 0 rgba(0, 0, 0, 0.08)';
+    };
+    /**
+     * ### Depth 2
+     * Used for Cards, Popups, and Menus — our most common depth
+     *
+     * @example
+     * ```ts
+     * import { depth } from '@workday/canvas-kit-react/tokens';
+     *
+     * const cardStyles = {
+     *   ...depth[2],
+     * };
+     * ```
+     */
+    2: {
+        boxShadow: '0px 4px 8px 0 rgba(0, 0, 0, 0.1)';
+    };
+    /**
+     * ### Depth 3
+     * Used for interactive Cards on hover
+     *
+     * @example
+     * ```ts
+     * import { depth } from '@workday/canvas-kit-react/tokens';
+     *
+     * const cardStyles = {
+     *   ...depth[3],
+     * };
+     * ```
+     */
+    3: {
+        boxShadow: '0px 8px 16px 0 rgba(0, 0, 0, 0.12)';
+    };
+    /**
+     * ### Depth 4
+     * Used for Cards on white backgrounds — adds border styles for more contrast
+     *
+     * @example
+     * ```ts
+     * import { depth } from '@workday/canvas-kit-react/tokens';
+     *
+     * const cardStyles = {
+     *   ...depth[4],
+     * };
+     * ```
+     */
+    4: {
+        border: '1px solid rgba(218, 226, 230, 1)';
+        boxShadow: '0px 8px 16px 0 rgba(0, 0, 0, 0.12)';
+    };
+};
+declare type ValueOf<T> = T[keyof T];
+export declare type CanvasDepthValues = ValueOf<CanvasDepth>;
+/**
+ * ### Depth Tokens
+ *
+ * Depth is the relative distance between surfaces in the z-axis.
+ * It provides delineation, focus, and priority with shadows and layering.
+ * There are five depth levels, `inset`, `1`, `2`, `3`, and `4`.
+ * Most levels only apply box-shadow styles, but `depth[4]` also applies border styles.
+ *
+ * @example
+ * ```tsx
+ * import { depth } from '@workday/canvas-kit-react/tokens';
+ *
+ * const CustomCard = () => {
+ *   return (
+ *     <div css={depth[2]}>
+ *       A standard-depth card
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ */
+export declare const depth: CanvasDepth;
+export {};
 //# sourceMappingURL=depth.d.ts.map

package/ts3.5/dist/commonjs/tooltip/lib/useTooltip.d.ts

@@ -41,7 +41,7 @@ export declare function useTooltip<T extends Element = Element>({ type, titleTex
         onMouseEnter: (event: React.SyntheticEvent<Element, Event>) => void;
         onMouseLeave: () => void;
         onMouseDown: (event: React.MouseEvent<Element, MouseEvent>) => void;
-        onFocus: (event: React.FocusEvent<Element>) => void;
+        onFocus: (event: React.FocusEvent<Element, Element>) => void;
         onBlur: () => void;
     };
     /** Mix these properties into the `Popper` component */

package/ts3.5/dist/es6/button/lib/PrimaryButton.d.ts

@@ -1,13 +1,20 @@
 import * as React from 'react';
 import { GrowthBehavior, Themeable, EmotionCanvasTheme } from '@workday/canvas-kit-react/common';
 import { CanvasSystemIcon } from '@workday/design-assets-types';
-import { ButtonColors } from './types';
+import { ButtonSizes, IconPositions } from './types';
 export interface PrimaryButtonProps extends Themeable, GrowthBehavior {
     /**
-     * The size of the Button.
+     * The variant of the PrimaryButton.
+     * @default undefined
+     */
+    variant?: 'inverse';
+    /**
+     * There are four button sizes: `extraSmall`, `small`, `medium`, and `large`.
+     * If no size is provided, it will default to `medium`.
+     *
      * @default 'medium'
      */
-    size?: 'small' | 'medium' | 'large';
+    size?: ButtonSizes;
     /**
      * The data label of the Button.
      * Note: not displayed at `small` size
@@ -19,10 +26,11 @@ export interface PrimaryButtonProps extends Themeable, GrowthBehavior {
      */
     icon?: CanvasSystemIcon;
     /**
-     * The position of the TertiaryButton icon.
+     * Button icon positions can either be `left` or `right`.
+     * If no value is provided, it defaults to `left`.
      * @default 'left'
      */
-    iconPosition?: 'left' | 'right';
+    iconPosition?: IconPositions;
     /**
      * If set to `true`, transform the icon's x-axis to mirror the graphic
      * @default false
@@ -31,5 +39,71 @@ export interface PrimaryButtonProps extends Themeable, GrowthBehavior {
     children?: React.ReactNode;
 }
 export declare const PrimaryButton: import("../../common").ElementComponent<"button", PrimaryButtonProps>;
-export declare const getPrimaryButtonColors: ({ canvas: { palette: { primary: themePrimary }, }, }: EmotionCanvasTheme) => ButtonColors;
+export declare const getPrimaryButtonColors: (variant: "inverse" | undefined, theme: EmotionCanvasTheme) => {
+    default: {
+        background: string;
+        icon: string;
+        label: string;
+        labelData?: undefined;
+    };
+    hover: {
+        background: string;
+        icon?: undefined;
+        label?: undefined;
+        labelData?: undefined;
+    };
+    active: {
+        background: string;
+        icon?: undefined;
+        label?: undefined;
+        labelData?: undefined;
+    };
+    focus: {
+        background: string;
+        border?: undefined;
+        icon?: undefined;
+        label?: undefined;
+        labelData?: undefined;
+        focusRing?: undefined;
+    };
+    disabled: {
+        background: string;
+        icon?: undefined;
+        label?: undefined;
+        labelData?: undefined;
+    };
+} | {
+    default: {
+        background: string;
+        icon: string;
+        label: string;
+        labelData: string;
+    };
+    hover: {
+        background: string;
+        icon: string;
+        label: string;
+        labelData: string;
+    };
+    active: {
+        background: string;
+        icon: string;
+        label: string;
+        labelData: string;
+    };
+    focus: {
+        background: string;
+        border: string;
+        icon: string;
+        label: string;
+        labelData: string;
+        focusRing: import("@emotion/serialize").CSSObject;
+    };
+    disabled: {
+        background: string;
+        icon: string;
+        label: string;
+        labelData: string;
+    };
+};
 //# sourceMappingURL=PrimaryButton.d.ts.map

package/ts3.5/dist/es6/button/lib/SecondaryButton.d.ts

@@ -1,7 +1,7 @@
 import * as React from 'react';
 import { GrowthBehavior, Themeable, EmotionCanvasTheme } from '@workday/canvas-kit-react/common';
 import { CanvasSystemIcon } from '@workday/design-assets-types';
-import { ButtonColors } from './types';
+import { ButtonColors, ButtonSizes, IconPositions } from './types';
 export interface SecondaryButtonProps extends Themeable, GrowthBehavior {
     /**
      * The variant of the SecondaryButton.
@@ -9,10 +9,12 @@ export interface SecondaryButtonProps extends Themeable, GrowthBehavior {
      */
     variant?: 'inverse' | undefined;
     /**
-     * The size of the Button.
+     * There are four button sizes: `extraSmall`, `small`, `medium`, and `large`.
+     * If no size is provided, it will default to `medium`.
+     *
      * @default 'medium'
      */
-    size?: 'small' | 'medium' | 'large';
+    size?: ButtonSizes;
     /**
      * The data label of the Button.
      * Note: not displayed at `small` size
@@ -24,10 +26,11 @@ export interface SecondaryButtonProps extends Themeable, GrowthBehavior {
      */
     icon?: CanvasSystemIcon;
     /**
-     * The position of the TertiaryButton icon.
+     * Button icon positions can either be `left` or `right`.
+     * If no value is provided, it defaults to `left`.
      * @default 'left'
      */
-    iconPosition?: 'left' | 'right';
+    iconPosition?: IconPositions;
     /**
      * If set to `true`, transform the icon's x-axis to mirror the graphic
      * @default false

package/ts3.5/dist/es6/button/lib/TertiaryButton.d.ts

@@ -1,6 +1,7 @@
 import * as React from 'react';
 import { Themeable } from '@workday/canvas-kit-react/common';
 import { CanvasSystemIcon } from '@workday/design-assets-types';
+import { TertiaryButtonSizes, IconPositions } from './types';
 export interface TertiaryButtonProps extends Themeable {
     /**
      * The variant of the TertiaryButton.
@@ -8,15 +9,18 @@ export interface TertiaryButtonProps extends Themeable {
      */
     variant?: 'inverse' | undefined;
     /**
-     * The size of the TertiaryButton.
+     * There are three button sizes: `extraSmall`, `small`, and `medium`.
+     * If no size is provided, it will default to `medium`.
+     *
      * @default 'medium'
      */
-    size?: 'small' | 'medium';
+    size?: TertiaryButtonSizes;
     /**
-     * The position of the TertiaryButton icon.
+     * Button icon positions can either be `left` or `right`.
+     * If no value is provided, it defaults to `left`.
      * @default 'left'
      */
-    iconPosition?: 'left' | 'right';
+    iconPosition?: IconPositions;
     /**
      * The icon of the TertiaryButton.
      */

package/ts3.5/dist/es6/button/lib/parts/ButtonContainer.d.ts

@@ -1,14 +1,16 @@
 import * as React from 'react';
 import { CSSObject } from '@emotion/core';
 import { GrowthBehavior, EmotionCanvasTheme, StyledType } from '@workday/canvas-kit-react/common';
-import { ButtonColors } from '../types';
+import { ButtonColors, ButtonSizes } from '../types';
 export interface ButtonContainerProps extends React.ButtonHTMLAttributes<HTMLButtonElement>, GrowthBehavior {
     colors?: ButtonColors;
     /**
-     * The size of the Button.
+     * There are four button sizes: `extraSmall`, `small`, `medium`, and `large`.
+     * If no size is provided, it will default to `medium`.
+     *
      * @default 'medium'
      */
-    size?: 'small' | 'medium' | 'large';
+    size?: ButtonSizes;
     /**
      * The ref to the button that the styled component renders.
      */