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

package/dist/commonjs/tabs/lib/list/useListModel.d.ts

@@ -1,22 +1,25 @@
 import React from 'react';
 import { Model, ToModelConfig } from '@workday/canvas-kit-react/common';
-export declare type Item = {
-    /** IDREF of the list. Children ids can be derived from this id */
-    id: string;
-    ref: React.RefObject<HTMLElement>;
-};
-export declare type ListState = {
+export declare type ListState<T = unknown> = {
     /** IDREF of the list. Children ids can be derived from this id */
     id: string;
     /** Used as an auto-incrementing ID for accessibility */
     indexRef: React.RefObject<number>;
-    items: Item[];
+    items: T[];
+    /**
+     * An array of ids of non-interactive elements. Non-interactive elements usually have `disabled`
+     * applied to them and thus are not focusable by the browser. Lists need to know about these so
+     * that keyboard navigation properly skips over these items. Interactive elements that are
+     * disabled should use `[aria-disabled]` instead and should still receive focus.
+     * @see https://www.w3.org/TR/wai-aria-practices-1.1/#kbd_disabled_controls
+     */
+    nonInteractiveIds: string[];
 };
-export declare type ListEvents = {
+export declare type ListEvents<T = unknown> = {
     /** Register an item to the list. Takes in an identifier, a React.Ref and an optional index. This should be called on
      * component mount */
     registerItem(data: {
-        item: Item;
+        item: T;
         index?: number;
     }): void;
     /** Unregister an item by its identifier. This should be called when the component is unmounted */
@@ -29,7 +32,9 @@ export declare type ListEvents = {
         index: number;
     }): void;
 };
-export declare type ListModel = Model<ListState, ListEvents>;
+export interface ListModel<T = unknown> extends Model<ListState<T>, ListEvents<T>> {
+    getId: (item: T) => string;
+}
 export declare const listEventMap: {
     guards: {
         /**
@@ -72,10 +77,17 @@ export declare const listEventMap: {
         onUpdateItemPosition: "updateItemPosition";
     };
 };
-export declare type BaseListModelConfig = {
+export declare type BaseListModelConfig<T = unknown> = {
     /** IDREF of the list. Children ids can be derived from this id */
     id?: string;
+    items?: T[];
+    getId?: (item: T) => string;
+    /**
+     * Array of all ids which are currently disabled
+     */
+    nonInteractiveIds?: string[];
 };
-export declare type ListModelConfig = BaseListModelConfig & Partial<ToModelConfig<ListState, ListEvents, typeof listEventMap>>;
-export declare const useListModel: (config?: ListModelConfig) => Model<ListState, ListEvents>;
+export declare type ListModelConfig<T> = BaseListModelConfig<T> & Partial<ToModelConfig<ListState<T>, ListEvents<T>, typeof listEventMap>>;
+export declare const defaultGetId: (item: any) => string;
+export declare const useListModel: <T extends unknown>(config?: ListModelConfig<T>) => ListModel<T>;
 //# sourceMappingURL=useListModel.d.ts.map

package/dist/commonjs/tabs/lib/list/useListModel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useListModel.d.ts","sourceRoot":"","sources":["../../../../../tabs/lib/list/useListModel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAEL,KAAK,EACL,aAAa,EAGd,MAAM,kCAAkC,CAAC;AAE1C,oBAAY,IAAI,GAAG;IACjB,kEAAkE;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;CACnC,CAAC;AAEF,oBAAY,SAAS,GAAG;IACtB,kEAAkE;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,wDAAwD;IACxD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAClC,KAAK,EAAE,IAAI,EAAE,CAAC;CACf,CAAC;AAEF,oBAAY,UAAU,GAAG;IACvB;yBACqB;IACrB,YAAY,CAAC,IAAI,EAAE;QAAC,IAAI,EAAE,IAAI,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAC,GAAG,IAAI,CAAC;IACvD,kGAAkG;IAClG,cAAc,CAAC,IAAI,EAAE;QAAC,EAAE,EAAE,MAAM,CAAA;KAAC,GAAG,IAAI,CAAC;IACzC,yGAAyG;IACzG,kBAAkB,CAAC,IAAI,EAAE;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAC,GAAG,IAAI,CAAC;CAC7D,CAAC;AAEF,oBAAY,SAAS,GAAG,KAAK,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;AAErD,eAAO,MAAM,YAAY;;QAErB;;;aAGK;;QAEL;;;WAGG;;QAEH;;;WAGG;;;;QAIH;;;;;WAKG;;QAEH;;;;;WAKG;;QAEH;;;;;WAKG;;;CAGL,CAAC;AAEH,oBAAY,mBAAmB,GAAG;IAChC,kEAAkE;IAClE,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,oBAAY,eAAe,GAAG,mBAAmB,GAC/C,OAAO,CAAC,aAAa,CAAC,SAAS,EAAE,UAAU,EAAE,OAAO,YAAY,CAAC,CAAC,CAAC;AAErE,eAAO,MAAM,YAAY,4DAsCxB,CAAC"}
+{"version":3,"file":"useListModel.d.ts","sourceRoot":"","sources":["../../../../../tabs/lib/list/useListModel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAEL,KAAK,EACL,aAAa,EAId,MAAM,kCAAkC,CAAC;AAE1C,oBAAY,SAAS,CAAC,CAAC,GAAG,OAAO,IAAI;IACnC,kEAAkE;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,wDAAwD;IACxD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAClC,KAAK,EAAE,CAAC,EAAE,CAAC;IACX;;;;;;OAMG;IACH,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B,CAAC;AAEF,oBAAY,UAAU,CAAC,CAAC,GAAG,OAAO,IAAI;IACpC;yBACqB;IACrB,YAAY,CAAC,IAAI,EAAE;QAAC,IAAI,EAAE,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAC,GAAG,IAAI,CAAC;IACpD,kGAAkG;IAClG,cAAc,CAAC,IAAI,EAAE;QAAC,EAAE,EAAE,MAAM,CAAA;KAAC,GAAG,IAAI,CAAC;IACzC,yGAAyG;IACzG,kBAAkB,CAAC,IAAI,EAAE;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAC,GAAG,IAAI,CAAC;CAC7D,CAAC;AAEF,MAAM,WAAW,SAAS,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IAChF,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;CAC5B;AAKD,eAAO,MAAM,YAAY;;QAErB;;;aAGK;;QAEL;;;WAGG;;QAEH;;;WAGG;;;;QAIH;;;;;WAKG;;QAEH;;;;;WAKG;;QAEH;;;;;WAKG;;;CAGL,CAAC;AAEH,oBAAY,mBAAmB,CAAC,CAAC,GAAG,OAAO,IAAI;IAC7C,kEAAkE;IAClE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;IACZ,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;IAC5B;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B,CAAC;AAEF,oBAAY,eAAe,CAAC,CAAC,IAAI,mBAAmB,CAAC,CAAC,CAAC,GACrD,OAAO,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,OAAO,YAAY,CAAC,CAAC,CAAC;AAE3E,eAAO,MAAM,YAAY,uBAGxB,CAAC;AAEF,eAAO,MAAM,YAAY,kEA4CxB,CAAC"}

package/dist/commonjs/tabs/lib/list/useListModel.js

@@ -12,6 +12,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 var react_1 = __importDefault(require("react"));
 var common_1 = require("@workday/canvas-kit-react/common");
+// We don't have a way of knowing what the generic could be, so we leave it as `unknown`. It will
+// probably need to be cast to the generic in use inside extending models. This will not effect the
+// use of the model in an application, only in models composing this model.
 exports.listEventMap = common_1.createEventMap()({
     guards: {
         /**
@@ -54,12 +57,22 @@ exports.listEventMap = common_1.createEventMap()({
         onUpdateItemPosition: 'updateItemPosition',
     },
 });
+exports.defaultGetId = function (item) {
+    common_1.assert(item.id, 'A list item must have an `id` field or a `getId` function defined');
+    return item.id;
+};
 exports.useListModel = function (config) {
     if (config === void 0) { config = {}; }
     var id = common_1.useUniqueId(config.id);
     var indexRef = react_1.default.useRef(0);
-    var _a = react_1.default.useState([]), items = _a[0], setItems = _a[1];
-    var state = { id: id, items: items, indexRef: indexRef };
+    var _a = react_1.default.useState(config.items || []), items = _a[0], setItems = _a[1];
+    var getId = config.getId || exports.defaultGetId;
+    var state = {
+        id: id,
+        items: config.items || items,
+        indexRef: indexRef,
+        nonInteractiveIds: config.nonInteractiveIds || [],
+    };
     var events = common_1.useEventMap(exports.listEventMap, state, config, {
         registerItem: function (_a) {
             var item = _a.item, index = _a.index;
@@ -76,8 +89,8 @@ exports.useListModel = function (config) {
         unregisterItem: function (_a) {
             var id = _a.id;
             setItems(function (items) {
-                if (items.find(function (item) { return item.id === id; })) {
-                    return items.filter(function (item) { return item.id !== id; });
+                if (items.find(function (item) { return getId(item) === id; })) {
+                    return items.filter(function (item) { return getId(item) !== id; });
                 }
                 else {
                     return items;
@@ -87,11 +100,11 @@ exports.useListModel = function (config) {
         updateItemPosition: function (_a) {
             var id = _a.id, index = _a.index;
             setItems(function (items) {
-                var copy = items.filter(function (item) { return item.id !== id; });
-                copy.splice(index, 0, items.find(function (item) { return item.id === id; }));
+                var copy = items.filter(function (item) { return getId(item) !== id; });
+                copy.splice(index, 0, items.find(function (item) { return getId(item) === id; }));
                 return copy;
             });
         },
     });
-    return { state: state, events: events };
+    return { state: state, events: events, getId: getId };
 };

package/dist/commonjs/tabs/lib/list/useListRegisterItem.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+import { ListModel } from './useListModel';
+/**
+ * Registers an item with a list. It will return elemProps with a `name` which can be used by other
+ * hooks to identify the item in the list.
+ */
+export declare const useListRegisterItem: <P extends {}, R>(model: ListModel<unknown>, elemProps?: P | undefined, ref?: ((instance: R | null) => void) | React.RefObject<R> | null | undefined) => {
+    'data-name': string;
+    name: string;
+    disabled: boolean | undefined;
+} & P & (R extends HTMLOrSVGElement ? {
+    ref: React.Ref<R>;
+} : {});
+//# sourceMappingURL=useListRegisterItem.d.ts.map

package/dist/commonjs/tabs/lib/list/useListRegisterItem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useListRegisterItem.d.ts","sourceRoot":"","sources":["../../../../../tabs/lib/list/useListRegisterItem.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,EAAC,SAAS,EAAC,MAAM,gBAAgB,CAAC;AAEzC;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;OA0C/B,CAAC"}

package/dist/commonjs/tabs/lib/list/useListRegisterItem.js

@@ -0,0 +1,46 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+var react_1 = __importDefault(require("react"));
+var common_1 = require("@workday/canvas-kit-react/common");
+/**
+ * Registers an item with a list. It will return elemProps with a `name` which can be used by other
+ * hooks to identify the item in the list.
+ */
+exports.useListRegisterItem = common_1.createHook(function (_a, _, elemProps) {
+    var state = _a.state, events = _a.events, getId = _a.getId;
+    if (elemProps === void 0) { elemProps = {}; }
+    var _b = react_1.default.useState(elemProps.name || ''), localId = _b[0], setLocalId = _b[1];
+    var firstRender = react_1.default.useRef(true);
+    react_1.default.useLayoutEffect(function () {
+        if (elemProps.index !== undefined && !firstRender.current) {
+            events.updateItemPosition({ id: localId, index: elemProps.index });
+        }
+        // we only care about the index changing
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [elemProps.index]);
+    common_1.useMountLayout(function () {
+        var defaultId = state.indexRef.current;
+        var itemId = elemProps.name || String(defaultId);
+        // bail early if item already exists. This happens if items were already provided.
+        if (state.items.find(function (item) { return getId(item) === elemProps.name; })) {
+            return;
+        }
+        events.registerItem({
+            item: { id: itemId },
+            index: elemProps.index,
+        });
+        setLocalId(itemId);
+        firstRender.current = false;
+        return function () {
+            events.unregisterItem({ id: itemId });
+        };
+    });
+    return {
+        'data-name': localId,
+        name: localId,
+        disabled: elemProps.disabled || state.nonInteractiveIds.includes(localId) ? true : undefined,
+    };
+});

package/dist/commonjs/tabs/lib/menu/Menu.d.ts

@@ -0,0 +1,80 @@
+import React from 'react';
+import { MenuModel, MenuModelConfig } from './useMenuModel';
+export declare const MenuModelContext: React.Context<MenuModel<unknown>>;
+export interface MenuProps<T> extends MenuModelConfig<T> {
+    /**
+     * The contents of the Menu. Can be `Menu` children or any valid elements.
+     */
+    children: React.ReactNode;
+    /**
+     * Optionally pass a model directly to this component. Default is to create a model out of model
+     * config passed to this component.
+     * @default useMenuModel(config)
+     */
+    model?: MenuModel<T>;
+}
+/**
+ * An accessible dropdown menu component. A dropdown menu usually contains a target element that
+ * opens to a menu.
+ * @example
+ * <Menu>
+ *   <Menu.Target>Open</Menu.Target>
+ *   <Menu.Popper>
+ *     <Menu.Card>
+ *       <Menu.List>
+ *         <Menu.Item name="first">First Item</Menu.Item>
+ *         <Menu.Item name="second">Second Item</Menu.Item>
+ *       </Menu.List>
+ *     </Menu.Card>
+ *   </Menu.Popper>
+ * </Menu>
+ */
+export declare const Menu: import("../../../common").Component<MenuProps<any>> & {
+    /**
+     * The menu card is a non-semantic element used to give the dropdown menu its distinct visual
+     * cue that the dropdown menu is floating above other content. A menu card usually contains a
+     * menu list, but can also contain other elements like a header or footer.
+     */
+    Card: import("../../../common").ElementComponent<"div", import("./MenuCard").MenuCardProps<unknown>>;
+    /**
+     * The menu list follows the Collections API. A list can either contain static items
+     * or a render prop and `items` to the model.
+     *
+     * @example
+     * const MyComponent = () => {
+     *   const model = useMenuModel({
+     *     items: [
+     *       { id: 'first',  text: 'First Item' },
+     *       { id: 'second', text: 'Second Item' },
+     *     ]
+     *   })
+     *
+     *   return (
+     *     <Menu model={model}>
+     *       <Menu.List>
+     *         {(item) => <Menu.Item name={item.id}>{item.text}</Menu.Item>}
+     *       </Menu.List>
+     *     </Menu>
+     *   )
+     * }
+     */
+    List: import("../../../common").ElementComponent<"div", import("./MenuList").MenuListProps<unknown>>;
+    /**
+     * A menu item has an optional `name` prop that identifies the item in the menu list and will be
+     * passed to the optional `onSelect` callback of the menu model. A menu item can contain any
+     * HTML. If more complex HTML is provided, consider
+     */
+    Item: import("../../../common").ElementComponent<"button", import("./MenuItem").MenuItemProps<unknown>> & {
+        Icon: typeof import("../../..").SystemIcon;
+        Text: import("@emotion/styled-base").StyledComponent<React.DetailedHTMLProps<React.HTMLAttributes<HTMLSpanElement>, HTMLSpanElement>, Pick<React.DetailedHTMLProps<React.HTMLAttributes<HTMLSpanElement>, HTMLSpanElement>, "css" | "style" | "slot" | "title" | "dir" | "children" | "hidden" | "defaultChecked" | "defaultValue" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "accessKey" | "className" | "contentEditable" | "contextMenu" | "draggable" | "id" | "lang" | "placeholder" | "spellCheck" | "tabIndex" | "translate" | "radioGroup" | "role" | "about" | "datatype" | "inlist" | "prefix" | "property" | "resource" | "typeof" | "vocab" | "autoCapitalize" | "autoCorrect" | "autoSave" | "color" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "results" | "security" | "unselectable" | "inputMode" | "is" | "aria-activedescendant" | "aria-atomic" | "aria-autocomplete" | "aria-busy" | "aria-checked" | "aria-colcount" | "aria-colindex" | "aria-colspan" | "aria-controls" | "aria-current" | "aria-describedby" | "aria-details" | "aria-disabled" | "aria-dropeffect" | "aria-errormessage" | "aria-expanded" | "aria-flowto" | "aria-grabbed" | "aria-haspopup" | "aria-hidden" | "aria-invalid" | "aria-keyshortcuts" | "aria-label" | "aria-labelledby" | "aria-level" | "aria-live" | "aria-modal" | "aria-multiline" | "aria-multiselectable" | "aria-orientation" | "aria-owns" | "aria-placeholder" | "aria-posinset" | "aria-pressed" | "aria-readonly" | "aria-relevant" | "aria-required" | "aria-roledescription" | "aria-rowcount" | "aria-rowindex" | "aria-rowspan" | "aria-selected" | "aria-setsize" | "aria-sort" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "dangerouslySetInnerHTML" | "onCopy" | "onCopyCapture" | "onCut" | "onCutCapture" | "onPaste" | "onPasteCapture" | "onCompositionEnd" | "onCompositionEndCapture" | "onCompositionStart" | "onCompositionStartCapture" | "onCompositionUpdate" | "onCompositionUpdateCapture" | "onFocus" | "onFocusCapture" | "onBlur" | "onBlurCapture" | "onChange" | "onChangeCapture" | "onBeforeInput" | "onBeforeInputCapture" | "onInput" | "onInputCapture" | "onReset" | "onResetCapture" | "onSubmit" | "onSubmitCapture" | "onInvalid" | "onInvalidCapture" | "onLoad" | "onLoadCapture" | "onError" | "onErrorCapture" | "onKeyDown" | "onKeyDownCapture" | "onKeyPress" | "onKeyPressCapture" | "onKeyUp" | "onKeyUpCapture" | "onAbort" | "onAbortCapture" | "onCanPlay" | "onCanPlayCapture" | "onCanPlayThrough" | "onCanPlayThroughCapture" | "onDurationChange" | "onDurationChangeCapture" | "onEmptied" | "onEmptiedCapture" | "onEncrypted" | "onEncryptedCapture" | "onEnded" | "onEndedCapture" | "onLoadedData" | "onLoadedDataCapture" | "onLoadedMetadata" | "onLoadedMetadataCapture" | "onLoadStart" | "onLoadStartCapture" | "onPause" | "onPauseCapture" | "onPlay" | "onPlayCapture" | "onPlaying" | "onPlayingCapture" | "onProgress" | "onProgressCapture" | "onRateChange" | "onRateChangeCapture" | "onSeeked" | "onSeekedCapture" | "onSeeking" | "onSeekingCapture" | "onStalled" | "onStalledCapture" | "onSuspend" | "onSuspendCapture" | "onTimeUpdate" | "onTimeUpdateCapture" | "onVolumeChange" | "onVolumeChangeCapture" | "onWaiting" | "onWaitingCapture" | "onAuxClick" | "onAuxClickCapture" | "onClick" | "onClickCapture" | "onContextMenu" | "onContextMenuCapture" | "onDoubleClick" | "onDoubleClickCapture" | "onDrag" | "onDragCapture" | "onDragEnd" | "onDragEndCapture" | "onDragEnter" | "onDragEnterCapture" | "onDragExit" | "onDragExitCapture" | "onDragLeave" | "onDragLeaveCapture" | "onDragOver" | "onDragOverCapture" | "onDragStart" | "onDragStartCapture" | "onDrop" | "onDropCapture" | "onMouseDown" | "onMouseDownCapture" | "onMouseEnter" | "onMouseLeave" | "onMouseMove" | "onMouseMoveCapture" | "onMouseOut" | "onMouseOutCapture" | "onMouseOver" | "onMouseOverCapture" | "onMouseUp" | "onMouseUpCapture" | "onSelect" | "onSelectCapture" | "onTouchCancel" | "onTouchCancelCapture" | "onTouchEnd" | "onTouchEndCapture" | "onTouchMove" | "onTouchMoveCapture" | "onTouchStart" | "onTouchStartCapture" | "onPointerDown" | "onPointerDownCapture" | "onPointerMove" | "onPointerMoveCapture" | "onPointerUp" | "onPointerUpCapture" | "onPointerCancel" | "onPointerCancelCapture" | "onPointerEnter" | "onPointerEnterCapture" | "onPointerLeave" | "onPointerLeaveCapture" | "onPointerOver" | "onPointerOverCapture" | "onPointerOut" | "onPointerOutCapture" | "onGotPointerCapture" | "onGotPointerCaptureCapture" | "onLostPointerCapture" | "onLostPointerCaptureCapture" | "onScroll" | "onScrollCapture" | "onWheel" | "onWheelCapture" | "onAnimationStart" | "onAnimationStartCapture" | "onAnimationEnd" | "onAnimationEndCapture" | "onAnimationIteration" | "onAnimationIterationCapture" | "onTransitionEnd" | "onTransitionEndCapture">, import("../../../common").EmotionCanvasTheme>;
+    };
+    Target: import("../../../common").ElementComponent<import("../../../common").ElementComponent<"button", import("../../..").SecondaryButtonProps>, import("./MenuTarget").MenuTargetProps<unknown>>;
+    /**
+     * The "Popper" of a menu. The popper will appear around the `Menu.Target`. It renders a `div`
+     * element that is portalled to the `document.body` which is controlled by the `PopupStack. The
+     * `PopupStack` is not part of React. This means no extra props given to this component will be
+     * forwarded to the `div` element, but the `ref` will be forwarded.
+     */
+    Popper: import("../../../common").ElementComponent<"div", import("./MenuPopper").MenuPopperProps<unknown>>;
+};
+//# sourceMappingURL=Menu.d.ts.map

package/dist/commonjs/tabs/lib/menu/Menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Menu.d.ts","sourceRoot":"","sources":["../../../../../tabs/lib/menu/Menu.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,EAAC,SAAS,EAAE,eAAe,EAAe,MAAM,gBAAgB,CAAC;AAOxE,eAAO,MAAM,gBAAgB,mCAA4C,CAAC;AAE1E,MAAM,WAAW,SAAS,CAAC,CAAC,CAAE,SAAQ,eAAe,CAAC,CAAC,CAAC;IACtD;;OAEG;IACH,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B;;;;OAIG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;CACtB;AAED;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,IAAI;IAQb;;;;OAIG;;IAEH;;;;;;;;;;;;;;;;;;;;;OAqBG;;IAEH;;;;OAIG;;;;;;IAGH;;;;;OAKG;;CAGL,CAAC"}

package/dist/commonjs/tabs/lib/menu/Menu.js

@@ -0,0 +1,94 @@
+"use strict";
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+var react_1 = __importDefault(require("react"));
+var common_1 = require("@workday/canvas-kit-react/common");
+var useMenuModel_1 = require("./useMenuModel");
+var MenuPopper_1 = require("./MenuPopper");
+var MenuTarget_1 = require("./MenuTarget");
+var MenuItem_1 = require("./MenuItem");
+var MenuCard_1 = require("./MenuCard");
+var MenuList_1 = require("./MenuList");
+exports.MenuModelContext = react_1.default.createContext({});
+/**
+ * An accessible dropdown menu component. A dropdown menu usually contains a target element that
+ * opens to a menu.
+ * @example
+ * <Menu>
+ *   <Menu.Target>Open</Menu.Target>
+ *   <Menu.Popper>
+ *     <Menu.Card>
+ *       <Menu.List>
+ *         <Menu.Item name="first">First Item</Menu.Item>
+ *         <Menu.Item name="second">Second Item</Menu.Item>
+ *       </Menu.List>
+ *     </Menu.Card>
+ *   </Menu.Popper>
+ * </Menu>
+ */
+exports.Menu = common_1.createComponent()({
+    displayName: 'Menu',
+    Component: function (_a) {
+        var children = _a.children, model = _a.model, config = __rest(_a, ["children", "model"]);
+        var value = common_1.useDefaultModel(model, config, useMenuModel_1.useMenuModel);
+        return react_1.default.createElement(exports.MenuModelContext.Provider, { value: value }, children);
+    },
+    subComponents: {
+        /**
+         * The menu card is a non-semantic element used to give the dropdown menu its distinct visual
+         * cue that the dropdown menu is floating above other content. A menu card usually contains a
+         * menu list, but can also contain other elements like a header or footer.
+         */
+        Card: MenuCard_1.MenuCard,
+        /**
+         * The menu list follows the Collections API. A list can either contain static items
+         * or a render prop and `items` to the model.
+         *
+         * @example
+         * const MyComponent = () => {
+         *   const model = useMenuModel({
+         *     items: [
+         *       { id: 'first',  text: 'First Item' },
+         *       { id: 'second', text: 'Second Item' },
+         *     ]
+         *   })
+         *
+         *   return (
+         *     <Menu model={model}>
+         *       <Menu.List>
+         *         {(item) => <Menu.Item name={item.id}>{item.text}</Menu.Item>}
+         *       </Menu.List>
+         *     </Menu>
+         *   )
+         * }
+         */
+        List: MenuList_1.MenuList,
+        /**
+         * A menu item has an optional `name` prop that identifies the item in the menu list and will be
+         * passed to the optional `onSelect` callback of the menu model. A menu item can contain any
+         * HTML. If more complex HTML is provided, consider
+         */
+        Item: MenuItem_1.MenuItem,
+        Target: MenuTarget_1.MenuTarget,
+        /**
+         * The "Popper" of a menu. The popper will appear around the `Menu.Target`. It renders a `div`
+         * element that is portalled to the `document.body` which is controlled by the `PopupStack. The
+         * `PopupStack` is not part of React. This means no extra props given to this component will be
+         * forwarded to the `div` element, but the `ref` will be forwarded.
+         */
+        Popper: MenuPopper_1.MenuPopper,
+    },
+});

package/dist/commonjs/tabs/lib/menu/MenuCard.d.ts

@@ -0,0 +1,17 @@
+import * as React from 'react';
+import { Card } from '@workday/canvas-kit-react/card';
+import { ExtractProps } from '@workday/canvas-kit-react/common';
+import { MenuModel } from './useMenuModel';
+export interface MenuCardProps<T = unknown> extends ExtractProps<typeof Card, never> {
+    /**
+     * Optionally pass a model directly to this component. Default is to implicitly use the same
+     * model as the container component which uses React context. Only use this for advanced use-cases
+     */
+    model?: MenuModel<T>;
+    children?: React.ReactNode;
+}
+export declare const MenuCard: import("../../../common").ElementComponent<"div", MenuCardProps<unknown>>;
+export declare const useMenuCard: <P extends {}, R>(model: MenuModel<unknown>, elemProps?: P | undefined, ref?: ((instance: R | null) => void) | React.RefObject<R> | null | undefined) => {} & P & (R extends HTMLOrSVGElement ? {
+    ref: React.Ref<R>;
+} : {});
+//# sourceMappingURL=MenuCard.d.ts.map

package/dist/commonjs/tabs/lib/menu/MenuCard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MenuCard.d.ts","sourceRoot":"","sources":["../../../../../tabs/lib/menu/MenuCard.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,EAAC,IAAI,EAAC,MAAM,gCAAgC,CAAC;AAEpD,OAAO,EAOL,YAAY,EAEb,MAAM,kCAAkC,CAAC;AAG1C,OAAO,EAAC,SAAS,EAAC,MAAM,gBAAgB,CAAC;AAGzC,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,YAAY,CAAC,OAAO,IAAI,EAAE,KAAK,CAAC;IAClF;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IACrB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AA2CD,eAAO,MAAM,QAAQ,2EAqBnB,CAAC;AAEH,eAAO,MAAM,WAAW;;OAEtB,CAAC"}

package/dist/commonjs/tabs/lib/menu/MenuCard.js

@@ -0,0 +1,82 @@
+"use strict";
+var __makeTemplateObject = (this && this.__makeTemplateObject) || function (cooked, raw) {
+    if (Object.defineProperty) { Object.defineProperty(cooked, "raw", { value: raw }); } else { cooked.raw = raw; }
+    return cooked;
+};
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (Object.hasOwnProperty.call(mod, k)) result[k] = mod[k];
+    result["default"] = mod;
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+var React = __importStar(require("react"));
+var core_1 = require("@emotion/core");
+var card_1 = require("@workday/canvas-kit-react/card");
+var tokens_1 = require("@workday/canvas-kit-react/tokens");
+var common_1 = require("@workday/canvas-kit-react/common");
+var popup_1 = require("@workday/canvas-kit-react/popup");
+var Menu_1 = require("./Menu");
+var popupAnimation = function (transformOrigin) {
+    var translate = common_1.getTranslateFromOrigin(transformOrigin, tokens_1.space.xxs);
+    return core_1.keyframes(templateObject_1 || (templateObject_1 = __makeTemplateObject(["\n    0% {\n      opacity: 0;\n      transform: translate(", "px, ", "px);\n    }\n    100% {\n      opacity: 1;\n      transform: translate(0);\n    }\n  "], ["\n    0% {\n      opacity: 0;\n      transform: translate(", "px, ", "px);\n    }\n    100% {\n      opacity: 1;\n      transform: translate(0);\n    }\n  "])), translate.x, translate.y);
+};
+var StyledCard = common_1.styled(card_1.Card)(tokens_1.type.levels.subtext.large, {
+    position: 'relative',
+    display: 'flex',
+    flexDirection: 'column',
+}, function (_a) {
+    var transformOrigin = _a.transformOrigin;
+    if (transformOrigin == null) {
+        return {};
+    }
+    return {
+        animation: popupAnimation(transformOrigin),
+        animationDuration: '150ms',
+        animationTimingFunction: 'ease-out',
+        transformOrigin: transformOrigin.vertical + " " + transformOrigin.horizontal,
+        // Allow overriding of animation in special cases
+        '.wd-no-animation &': {
+            animation: 'none',
+        },
+    };
+});
+exports.MenuCard = common_1.createComponent('div')({
+    displayName: 'Menu.Card',
+    Component: function (_a, ref, Element) {
+        var children = _a.children, model = _a.model, _b = _a.padding, padding = _b === void 0 ? 'zero' : _b, elemProps = __rest(_a, ["children", "model", "padding"]);
+        var localModel = common_1.useModelContext(Menu_1.MenuModelContext, model);
+        var props = exports.useMenuCard(localModel, elemProps, ref);
+        var transformOrigin = React.useMemo(function () {
+            return popup_1.getTransformFromPlacement(localModel.state.placement || 'bottom');
+        }, [localModel.state.placement]);
+        return (React.createElement(StyledCard, __assign({ maxWidth: "calc(100vw - " + tokens_1.space.l + ")", as: Element, transformOrigin: transformOrigin, padding: padding }, props), children));
+    },
+});
+exports.useMenuCard = common_1.createHook(function (_) {
+    return {};
+});
+var templateObject_1;

package/dist/commonjs/tabs/lib/menu/MenuItem.d.ts

@@ -0,0 +1,62 @@
+import * as React from 'react';
+import { SystemIcon } from '@workday/canvas-kit-react/icon';
+import { MenuModel } from './useMenuModel';
+export interface MenuItemProps<T = unknown> {
+    /**
+     * Optionally pass index to menu item. This should be done if `Menu.Item` components were created
+     * via a `Array::map` function. This index will ensure keyboard navigation works even if items are
+     * inserted out of order.
+     */
+    index?: number;
+    /**
+     * The label text of the MenuItem.
+     */
+    children: React.ReactNode;
+    /**
+     * The name of the menu item. This name will be used in the `onSelect` callback in the model. If
+     * this property is not provided, it will default to a string representation of the the zero-based
+     * index of the Tab when it was initialized.
+     */
+    name?: string;
+    /**
+     * Optionally pass a model directly to this component. Default is to implicitly use the same
+     * model as the container component which uses React context. Only use this for advanced use-cases
+     */
+    model?: MenuModel<T>;
+    'aria-disabled'?: boolean;
+    /**
+     * Use `hasIcon={true}` when the Tab item contains an icon. This instructs the tab item to render
+     * children as a flex container to accommodate icons. You will have to use `Tabs.Item.Text` as a
+     * child element if this is set to true.
+     *
+     * @example
+     * <Menu.Item hasIcon>
+     *   <Menu.Item.Icon icon={someIcon} />
+     *   <Menu.Item.Text>Tab Text</Menu.Item.Text>
+     * </Menu.Item>
+     */
+    hasIcon?: boolean;
+}
+export declare const MenuItem: import("../../../common").ElementComponent<"button", MenuItemProps<unknown>> & {
+    Icon: typeof SystemIcon;
+    Text: import("@emotion/styled-base").StyledComponent<React.DetailedHTMLProps<React.HTMLAttributes<HTMLSpanElement>, HTMLSpanElement>, Pick<React.DetailedHTMLProps<React.HTMLAttributes<HTMLSpanElement>, HTMLSpanElement>, "css" | "style" | "slot" | "title" | "dir" | "children" | "hidden" | "defaultChecked" | "defaultValue" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "accessKey" | "className" | "contentEditable" | "contextMenu" | "draggable" | "id" | "lang" | "placeholder" | "spellCheck" | "tabIndex" | "translate" | "radioGroup" | "role" | "about" | "datatype" | "inlist" | "prefix" | "property" | "resource" | "typeof" | "vocab" | "autoCapitalize" | "autoCorrect" | "autoSave" | "color" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "results" | "security" | "unselectable" | "inputMode" | "is" | "aria-activedescendant" | "aria-atomic" | "aria-autocomplete" | "aria-busy" | "aria-checked" | "aria-colcount" | "aria-colindex" | "aria-colspan" | "aria-controls" | "aria-current" | "aria-describedby" | "aria-details" | "aria-disabled" | "aria-dropeffect" | "aria-errormessage" | "aria-expanded" | "aria-flowto" | "aria-grabbed" | "aria-haspopup" | "aria-hidden" | "aria-invalid" | "aria-keyshortcuts" | "aria-label" | "aria-labelledby" | "aria-level" | "aria-live" | "aria-modal" | "aria-multiline" | "aria-multiselectable" | "aria-orientation" | "aria-owns" | "aria-placeholder" | "aria-posinset" | "aria-pressed" | "aria-readonly" | "aria-relevant" | "aria-required" | "aria-roledescription" | "aria-rowcount" | "aria-rowindex" | "aria-rowspan" | "aria-selected" | "aria-setsize" | "aria-sort" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "dangerouslySetInnerHTML" | "onCopy" | "onCopyCapture" | "onCut" | "onCutCapture" | "onPaste" | "onPasteCapture" | "onCompositionEnd" | "onCompositionEndCapture" | "onCompositionStart" | "onCompositionStartCapture" | "onCompositionUpdate" | "onCompositionUpdateCapture" | "onFocus" | "onFocusCapture" | "onBlur" | "onBlurCapture" | "onChange" | "onChangeCapture" | "onBeforeInput" | "onBeforeInputCapture" | "onInput" | "onInputCapture" | "onReset" | "onResetCapture" | "onSubmit" | "onSubmitCapture" | "onInvalid" | "onInvalidCapture" | "onLoad" | "onLoadCapture" | "onError" | "onErrorCapture" | "onKeyDown" | "onKeyDownCapture" | "onKeyPress" | "onKeyPressCapture" | "onKeyUp" | "onKeyUpCapture" | "onAbort" | "onAbortCapture" | "onCanPlay" | "onCanPlayCapture" | "onCanPlayThrough" | "onCanPlayThroughCapture" | "onDurationChange" | "onDurationChangeCapture" | "onEmptied" | "onEmptiedCapture" | "onEncrypted" | "onEncryptedCapture" | "onEnded" | "onEndedCapture" | "onLoadedData" | "onLoadedDataCapture" | "onLoadedMetadata" | "onLoadedMetadataCapture" | "onLoadStart" | "onLoadStartCapture" | "onPause" | "onPauseCapture" | "onPlay" | "onPlayCapture" | "onPlaying" | "onPlayingCapture" | "onProgress" | "onProgressCapture" | "onRateChange" | "onRateChangeCapture" | "onSeeked" | "onSeekedCapture" | "onSeeking" | "onSeekingCapture" | "onStalled" | "onStalledCapture" | "onSuspend" | "onSuspendCapture" | "onTimeUpdate" | "onTimeUpdateCapture" | "onVolumeChange" | "onVolumeChangeCapture" | "onWaiting" | "onWaitingCapture" | "onAuxClick" | "onAuxClickCapture" | "onClick" | "onClickCapture" | "onContextMenu" | "onContextMenuCapture" | "onDoubleClick" | "onDoubleClickCapture" | "onDrag" | "onDragCapture" | "onDragEnd" | "onDragEndCapture" | "onDragEnter" | "onDragEnterCapture" | "onDragExit" | "onDragExitCapture" | "onDragLeave" | "onDragLeaveCapture" | "onDragOver" | "onDragOverCapture" | "onDragStart" | "onDragStartCapture" | "onDrop" | "onDropCapture" | "onMouseDown" | "onMouseDownCapture" | "onMouseEnter" | "onMouseLeave" | "onMouseMove" | "onMouseMoveCapture" | "onMouseOut" | "onMouseOutCapture" | "onMouseOver" | "onMouseOverCapture" | "onMouseUp" | "onMouseUpCapture" | "onSelect" | "onSelectCapture" | "onTouchCancel" | "onTouchCancelCapture" | "onTouchEnd" | "onTouchEndCapture" | "onTouchMove" | "onTouchMoveCapture" | "onTouchStart" | "onTouchStartCapture" | "onPointerDown" | "onPointerDownCapture" | "onPointerMove" | "onPointerMoveCapture" | "onPointerUp" | "onPointerUpCapture" | "onPointerCancel" | "onPointerCancelCapture" | "onPointerEnter" | "onPointerEnterCapture" | "onPointerLeave" | "onPointerLeaveCapture" | "onPointerOver" | "onPointerOverCapture" | "onPointerOut" | "onPointerOutCapture" | "onGotPointerCapture" | "onGotPointerCaptureCapture" | "onLostPointerCapture" | "onLostPointerCaptureCapture" | "onScroll" | "onScrollCapture" | "onWheel" | "onWheelCapture" | "onAnimationStart" | "onAnimationStartCapture" | "onAnimationEnd" | "onAnimationEndCapture" | "onAnimationIteration" | "onAnimationIterationCapture" | "onTransitionEnd" | "onTransitionEndCapture">, import("../../../common").EmotionCanvasTheme>;
+};
+export declare const useMenuItem: <P extends {}, R>(model: import("../list").ListModel<unknown>, elemProps?: P | undefined, ref?: ((instance: R | null) => void) | React.RefObject<R> | null | undefined) => {
+    role: string;
+} & {
+    onClick: (event: React.MouseEvent<HTMLElement, MouseEvent>) => void;
+} & {
+    onKeyDown(event: React.KeyboardEvent<Element>): void;
+    onFocus(): void;
+    onBlur(): void;
+    id: string;
+    tabIndex: number;
+    ref: ((instance: any) => void) | React.RefObject<any> | null | undefined;
+} & {
+    'data-name': string;
+    name: string;
+    disabled: boolean | undefined;
+} & P & (R extends HTMLOrSVGElement ? {
+    ref: React.Ref<R>;
+} : {});
+//# sourceMappingURL=MenuItem.d.ts.map

package/dist/commonjs/tabs/lib/menu/MenuItem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MenuItem.d.ts","sourceRoot":"","sources":["../../../../../tabs/lib/menu/MenuItem.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAa/B,OAAO,EAAC,UAAU,EAAC,MAAM,gCAAgC,CAAC;AAM1D,OAAO,EAAC,SAAS,EAAC,MAAM,gBAAgB,CAAC;AAIzC,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACxC;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IACrB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AA2FD,eAAO,MAAM,QAAQ;;;CAkCnB,CAAC;AAEH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;OASvB,CAAC"}