@deque/cauldron-react 6.7.0-canary.2d78ed57 → 6.7.0-canary.38e18ca8

package/lib/broken-image.js

@@ -0,0 +1,36 @@
+'use strict';
+
+var React = require('react');
+
+function _interopNamespace(e) {
+	if (e && e.__esModule) return e;
+	var n = Object.create(null);
+	if (e) {
+		Object.keys(e).forEach(function (k) {
+			if (k !== 'default') {
+				var d = Object.getOwnPropertyDescriptor(e, k);
+				Object.defineProperty(n, k, d.get ? d : {
+					enumerable: true,
+					get: function () { return e[k]; }
+				});
+			}
+		});
+	}
+	n["default"] = e;
+	return Object.freeze(n);
+}
+
+var React__namespace = /*#__PURE__*/_interopNamespace(React);
+
+var _path;
+function _extends() { _extends = Object.assign ? Object.assign.bind() : function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
+const SvgBrokenImage = props => /*#__PURE__*/React__namespace.createElement("svg", _extends({
+  viewBox: "0 0 24 24",
+  fill: "currentColor",
+  height: 24,
+  width: 24
+}, props), _path || (_path = /*#__PURE__*/React__namespace.createElement("path", {
+  d: "M22.154 0H1.846c-.49 0-.96.23-1.305.639C.195 1.049 0 1.603 0 2.182v19.636c0 .579.195 1.134.54 1.543.347.41.817.639 1.306.639h7.385a.831.831 0 0 0 .54-.206c.157-.134.274-.323.335-.54l1.712-6.065 4.22-1.994a.935.935 0 0 0 .31-.242c.088-.105.158-.23.205-.366l1.687-4.984 5.132-2.023a.952.952 0 0 0 .455-.398A1.23 1.23 0 0 0 24 6.545V2.182c0-.579-.195-1.134-.54-1.543C23.112.229 22.642 0 22.153 0ZM10.2 16.019l-1.636 5.8H1.846V18l6-7.09 3.51 4.147-.625.293a.933.933 0 0 0-.327.266c-.092.115-.16.253-.203.403Zm11.953-10.26-4.907 1.933a.908.908 0 0 0-.342.242 1.117 1.117 0 0 0-.224.388l-1.698 5.021-1.762.839-4.07-4.81c-.346-.409-.815-.638-1.305-.638s-.959.23-1.305.638l-4.695 5.542V2.182h20.308v3.577Zm1.463 4.5a.852.852 0 0 0-.4-.194.789.789 0 0 0-.432.044l-2.746 1.082a.908.908 0 0 0-.341.241 1.117 1.117 0 0 0-.224.388l-1.652 4.878-4.127 1.951a.934.934 0 0 0-.328.265 1.146 1.146 0 0 0-.204.403l-.916 3.246a1.28 1.28 0 0 0-.037.51c.021.17.078.333.163.474.086.14.198.254.329.333.13.079.274.12.42.12h9.032c.49 0 .96-.23 1.305-.639.346-.41.541-.964.541-1.543V11.145c0-.173-.035-.343-.101-.497a1.062 1.062 0 0 0-.282-.388v-.001Zm-1.463 11.56h-7.75l.374-1.33 4.098-1.937a.936.936 0 0 0 .31-.242c.088-.104.158-.229.204-.366l1.639-4.842 1.125-.443v9.16Z"
+})));
+
+exports["default"] = SvgBrokenImage;

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

@@ -0,0 +1,15 @@
+import React from 'react';
+interface DrawerProps<T extends HTMLElement = HTMLElement> extends React.HTMLAttributes<HTMLDivElement> {
+    children: React.ReactNode;
+    position: 'top' | 'bottom' | 'left' | 'right';
+    open?: boolean;
+    behavior?: 'modal' | 'non-modal';
+    focusOptions?: {
+        initialFocus?: T | React.RefObject<T> | React.MutableRefObject<T>;
+        returnFocus?: T | React.RefObject<T> | React.MutableRefObject<T>;
+    };
+    onClose?: () => void;
+    portal?: React.RefObject<HTMLElement> | HTMLElement;
+}
+declare const Drawer: React.ForwardRefExoticComponent<DrawerProps<HTMLElement> & React.RefAttributes<HTMLDivElement>>;
+export default Drawer;

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

@@ -2,6 +2,6 @@
  * GENERATED CODE. DO NOT EDIT DIRECTLY!
  */
 /** IconType represents each valid icon type. */
-export type IconType = 'add-user' | 'arrow-circle-up' | 'arrow-circle-down' | 'arrow-circle-left' | 'arrow-circle-right' | 'arrow-up' | 'arrow-down' | 'arrow-left' | 'arrow-right' | 'arrows-alt' | 'bolt' | 'caution' | 'check-circle' | 'check-shield' | 'check-solid' | 'check' | 'checkbox-checked' | 'checkbox-unchecked' | 'chevron-double-up' | 'chevron-double-down' | 'chevron-double-left' | 'chevron-double-right' | 'chevron-up' | 'chevron-down' | 'chevron-left' | 'chevron-right' | 'clipboard' | 'clock' | 'close' | 'code' | 'copy' | 'download' | 'dropper' | 'exchange' | 'export-solid' | 'external-link' | 'eye' | 'filter-solid' | 'filter' | 'flag' | 'gears' | 'github' | 'grid' | 'hamburger-menu' | 'hashtag' | 'highlight' | 'images' | 'info-circle-alt' | 'info-circle' | 'info-square' | 'kabob' | 'link' | 'linkedin' | 'list' | 'lock' | 'magnifying-glass' | 'menu' | 'minus' | 'new-releases' | 'new' | 'no' | 'pencil' | 'person-running' | 'play' | 'plus' | 'question-circle-alt' | 'question-circle' | 'radio-checked' | 'radio-unchecked' | 'recycle-square' | 'recycle' | 'resend' | 'robot' | 'run-again' | 'save' | 'share-nodes' | 'share' | 'sort-triangle' | 'sort' | 'star' | 'step-back' | 'step-forward' | 'sun' | 'table-sort-ascending' | 'table-sort-descending' | 'tag' | 'target' | 'trash' | 'triangle-up' | 'triangle-down' | 'triangle-left' | 'triangle-right' | 'twitter' | 'upload';
+export type IconType = 'add-user' | 'arrow-circle-up' | 'arrow-circle-down' | 'arrow-circle-left' | 'arrow-circle-right' | 'arrow-up' | 'arrow-down' | 'arrow-left' | 'arrow-right' | 'arrows-alt' | 'bolt' | 'broken-image' | 'caution' | 'check-circle' | 'check-shield' | 'check-solid' | 'check' | 'checkbox-checked' | 'checkbox-unchecked' | 'chevron-double-up' | 'chevron-double-down' | 'chevron-double-left' | 'chevron-double-right' | 'chevron-up' | 'chevron-down' | 'chevron-left' | 'chevron-right' | 'clipboard' | 'clock' | 'close' | 'code' | 'copy' | 'download' | 'dropper' | 'exchange' | 'export-solid' | 'external-link' | 'eye' | 'filter-solid' | 'filter' | 'flag' | 'gears' | 'github' | 'grid' | 'hamburger-menu' | 'hashtag' | 'highlight' | 'images' | 'info-circle-alt' | 'info-circle' | 'info-square' | 'kabob' | 'link' | 'linkedin' | 'list' | 'lock' | 'magnifying-glass' | 'menu' | 'minus' | 'new-releases' | 'new' | 'no' | 'pencil' | 'person-running' | 'play' | 'plus' | 'question-circle-alt' | 'question-circle' | 'radio-checked' | 'radio-unchecked' | 'recycle-square' | 'recycle' | 'resend' | 'robot' | 'run-again' | 'save' | 'share-nodes' | 'share' | 'sort-triangle' | 'sort' | 'star' | 'step-back' | 'step-forward' | 'sun' | 'table-sort-ascending' | 'table-sort-descending' | 'tag' | 'target' | 'trash' | 'triangle-up' | 'triangle-down' | 'triangle-left' | 'triangle-right' | 'twitter' | 'upload';
 /** iconTypes holds each valid icon type. */
 export declare const iconTypes: string[];

package/lib/index.d.ts

@@ -59,6 +59,7 @@ export { default as Popover } from './components/Popover';
 export { default as Timeline, TimelineItem } from './components/Timeline';
 export { default as TextEllipsis } from './components/TextEllipsis';
 export { default as CopyButton } from './components/CopyButton';
+export { default as Drawer } from './components/Drawer';
 /**
  * Helpers / Utils
  */

package/lib/index.js

@@ -114,6 +114,7 @@ var iconTypes = [
     'arrow-right',
     'arrows-alt',
     'bolt',
+    'broken-image',
     'caution',
     'check-circle',
     'check-shield',
@@ -206,6 +207,7 @@ function __variableDynamicImportRuntime0__(path) {
     case './icons/arrow.svg': return Promise.resolve().then(function () { return require('./arrow.js'); });
     case './icons/arrows-alt.svg': return Promise.resolve().then(function () { return require('./arrows-alt.js'); });
     case './icons/bolt.svg': return Promise.resolve().then(function () { return require('./bolt.js'); });
+    case './icons/broken-image.svg': return Promise.resolve().then(function () { return require('./broken-image.js'); });
     case './icons/caution.svg': return Promise.resolve().then(function () { return require('./caution.js'); });
     case './icons/check-circle.svg': return Promise.resolve().then(function () { return require('./check-circle.js'); });
     case './icons/check-shield.svg': return Promise.resolve().then(function () { return require('./check-shield.js'); });
@@ -791,6 +793,23 @@ var OptionsMenuWrapper = function (_a) {
     return (React__default["default"].createElement("div", tslib.__assign({ className: classNames__default["default"]('OptionsMenu', menuAlignment(align), className) }, other)));
 };
 
+/**
+ * When an element can be passed as a value that is either an element or an
+ * elementRef, this will resolve the property down to the resulting element
+ */
+function resolveElement(elementOrRef) {
+    if (elementOrRef instanceof Element) {
+        return elementOrRef;
+    }
+    if (elementOrRef &&
+        typeof elementOrRef === 'object' &&
+        'current' in elementOrRef &&
+        elementOrRef.current instanceof Element) {
+        return elementOrRef.current;
+    }
+    return null;
+}
+
 function ClickOutsideListener(_a, ref) {
     var children = _a.children, _b = _a.mouseEvent, mouseEvent = _b === void 0 ? 'click' : _b, _c = _a.touchEvent, touchEvent = _c === void 0 ? 'touchend' : _c, target = _a.target, _d = _a.onClickOutside, onClickOutside = _d === void 0 ? function () { return null; } : _d;
     var childElementRef = React.useRef();
@@ -799,11 +818,9 @@ function ClickOutsideListener(_a, ref) {
             return;
         }
         var eventTarget = event.target;
-        if (target && (target instanceof HTMLElement || 'current' in target)) {
-            var elementTarget = target instanceof HTMLElement ? target : target.current;
-            if (!(elementTarget === null || elementTarget === void 0 ? void 0 : elementTarget.contains(eventTarget))) {
-                onClickOutside(event);
-            }
+        var elementTarget = resolveElement(target);
+        if (target && !(elementTarget === null || elementTarget === void 0 ? void 0 : elementTarget.contains(eventTarget))) {
+            onClickOutside(event);
             // If a target is passed in via a prop, we defer to utilizing that
             // target instead of a child element target
             return;
@@ -1648,6 +1665,46 @@ function hasIdRef(ids, id) {
     return idRefs(ids).has(id);
 }
 
+var isEscapeKey = function (event) {
+    return event.key === 'Escape' || event.key === 'Esc' || event.keyCode === 27;
+};
+/**
+ * When a component needs to implement an escape handler, such as in modal
+ * dialogs, useEscapeKey will handle the events and call the provided callback
+ * handler when an escape key event has been fired.
+ *
+ * @example
+ * useEscapeKey(() => close())
+ */
+function useEscapeKey(options, dependencies) {
+    if (dependencies === void 0) { dependencies = []; }
+    var callback = options.callback;
+    var event = options.event || 'keyup';
+    var target = resolveElement(options.target) || document.body;
+    var active = typeof options.active === 'boolean' ? options.active : true;
+    React.useEffect(function () {
+        var eventListener = function (event) {
+            if (isEscapeKey(event) &&
+                (options.defaultPrevented ? !event.defaultPrevented : true)) {
+                callback(event);
+            }
+        };
+        if (active) {
+            target === null || target === void 0 ? void 0 : target.addEventListener(event, eventListener, options.capture);
+        }
+        return function () {
+            target === null || target === void 0 ? void 0 : target.removeEventListener(event, eventListener, options.capture);
+        };
+    }, tslib.__spreadArray([
+        active,
+        callback,
+        event,
+        target,
+        options.capture,
+        options.defaultPrevented
+    ], tslib.__read(dependencies), false));
+}
+
 var TIP_HIDE_DELAY = 100;
 // fires a custom "cauldron:tooltip:show" / "cauldron:tooltip:hide" event
 // to allow projects using cauldron to hook into when a tooltip is shown/hidden
@@ -1736,30 +1793,14 @@ function Tooltip(_a) {
         attributes.popper['data-popper-placement']) ||
         initialPlacement;
     // Only listen to key ups when the tooltip is visible
-    React.useEffect(function () {
-        var handleEscape = function (event) {
-            if (event.key === 'Escape' ||
-                event.key === 'Esc' ||
-                event.keyCode === 27) {
-                event.preventDefault();
-                setShowTooltip(false);
-            }
-        };
-        var targetElement = document.body;
-        if (showTooltip && typeof showProp !== 'boolean') {
-            targetElement.addEventListener('keyup', handleEscape, { capture: true });
-        }
-        else {
-            targetElement.removeEventListener('keyup', handleEscape, {
-                capture: true
-            });
-        }
-        return function () {
-            targetElement.removeEventListener('keyup', handleEscape, {
-                capture: true
-            });
-        };
-    }, [showTooltip, showProp]);
+    useEscapeKey({
+        callback: function (event) {
+            event.preventDefault();
+            setShowTooltip(false);
+        },
+        capture: true,
+        active: showTooltip && typeof showProp !== 'boolean'
+    }, [setShowTooltip]);
     // Handle hover and focus events for the targetElement
     React.useEffect(function () {
         if (typeof showProp !== 'boolean') {
@@ -3275,25 +3316,10 @@ var TwoColumnPanel = React.forwardRef(function (_a, ref) {
             mediaQueryList.removeEventListener('change', listener);
         };
     }, []);
-    React.useEffect(function () {
-        var handleEscape = function (event) {
-            if (event.key === 'Escape' ||
-                event.key === 'Esc' ||
-                event.keyCode === 27) {
-                setCollapsed(true);
-            }
-        };
-        var targetElement = document.body;
-        if (isFocusTrap) {
-            targetElement.addEventListener('keyup', handleEscape);
-        }
-        else {
-            targetElement.removeEventListener('keyup', handleEscape);
-        }
-        return function () {
-            targetElement.removeEventListener('keyup', handleEscape);
-        };
-    }, [isFocusTrap]);
+    useEscapeKey({
+        callback: function () { return setCollapsed(true); },
+        active: isFocusTrap
+    }, [setCollapsed]);
     var handleClickOutside = function () {
         if (!isCollapsed && isFocusTrap) {
             setCollapsed(true);
@@ -4076,24 +4102,6 @@ var Popover = React.forwardRef(function (_a, ref) {
         }
         targetElement === null || targetElement === void 0 ? void 0 : targetElement.setAttribute('aria-expanded', Boolean(show).toString());
     }, [show, popoverRef.current]);
-    React.useEffect(function () {
-        var handleEscape = function (event) {
-            if (event.key === 'Escape' ||
-                event.key === 'Esc' ||
-                event.keyCode === 27) {
-                handleClosePopover();
-            }
-        };
-        if (show) {
-            document.body.addEventListener('keyup', handleEscape);
-        }
-        else {
-            document.body.removeEventListener('keyup', handleEscape);
-        }
-        return function () {
-            document.body.removeEventListener('keyup', handleEscape);
-        };
-    }, [show]);
     React.useEffect(function () {
         var attrText = targetElement === null || targetElement === void 0 ? void 0 : targetElement.getAttribute('aria-controls');
         var hasPopupAttr = targetElement === null || targetElement === void 0 ? void 0 : targetElement.getAttribute('aria-haspopup');
@@ -4120,6 +4128,10 @@ var Popover = React.forwardRef(function (_a, ref) {
             onClose();
         }
     };
+    useEscapeKey({
+        callback: handleClosePopover,
+        active: show
+    }, [show]);
     if (!show || !isBrowser())
         return null;
     return reactDom.createPortal(React__default["default"].createElement(FocusTrap__default["default"], { focusTrapOptions: {
@@ -4197,6 +4209,111 @@ var TextEllipsis = React__default["default"].forwardRef(function (_a, ref) {
 });
 TextEllipsis.displayName = 'TextEllipsis';
 
+var Drawer = React.forwardRef(function (_a, ref) {
+    var children = _a.children, className = _a.className, position = _a.position, _b = _a.open, open = _b === void 0 ? false : _b, _c = _a.behavior, behavior = _c === void 0 ? 'modal' : _c, _d = _a.focusOptions, focusOptions = _d === void 0 ? {} : _d, portal = _a.portal, onClose = _a.onClose, style = _a.style, props = tslib.__rest(_a, ["children", "className", "position", "open", "behavior", "focusOptions", "portal", "onClose", "style"]);
+    var drawerRef = useSharedRef(ref);
+    var openRef = React.useRef(!!open);
+    var previousActiveElementRef = React.useRef(null);
+    var focusInitial = focusOptions.initialFocus, focusReturn = focusOptions.returnFocus;
+    var _e = tslib.__read(React.useState(!!open), 2), isTransitioning = _e[0], setIsTransitioning = _e[1];
+    var isModal = behavior === 'modal';
+    var handleClose = React.useCallback(function () {
+        // istanbul ignore next
+        if (open && typeof onClose === 'function') {
+            onClose();
+        }
+    }, [open, onClose]);
+    React.useEffect(function () {
+        // jsdom does not trigger transitionend event
+        // istanbul ignore next
+        var transitionEndHandler = function () { return setIsTransitioning(false); };
+        document.addEventListener('transitionend', transitionEndHandler);
+        return function () {
+            document.removeEventListener('transitionend', transitionEndHandler);
+        };
+    }, [setIsTransitioning]);
+    React.useEffect(function () {
+        if (openRef.current !== open) {
+            setIsTransitioning(true);
+        }
+        openRef.current = open;
+    }, [open, setIsTransitioning]);
+    React.useEffect(function () {
+        if (!isModal) {
+            return;
+        }
+        var isolator = new AriaIsolate(drawerRef.current);
+        if (open) {
+            isolator.activate();
+        }
+        else {
+            isolator.deactivate();
+        }
+        return function () {
+            isolator.deactivate();
+        };
+    }, [isModal, open]);
+    React.useLayoutEffect(function () {
+        var _a, _b, _c;
+        if (open) {
+            previousActiveElementRef.current =
+                document.activeElement;
+            var initialFocusElement = resolveElement(focusInitial);
+            if (initialFocusElement) {
+                initialFocusElement.focus();
+            }
+            else {
+                var focusable = (_a = drawerRef.current) === null || _a === void 0 ? void 0 : _a.querySelector(focusableSelector);
+                if (focusable) {
+                    focusable.focus();
+                }
+                else {
+                    // fallback focus
+                    (_b = drawerRef.current) === null || _b === void 0 ? void 0 : _b.focus();
+                }
+            }
+        }
+        else if (previousActiveElementRef.current) {
+            var returnFocusElement = resolveElement(focusReturn);
+            if (returnFocusElement) {
+                returnFocusElement.focus();
+            }
+            else {
+                // fallback focus
+                (_c = previousActiveElementRef.current) === null || _c === void 0 ? void 0 : _c.focus();
+            }
+        }
+    }, [open, focusInitial, focusReturn]);
+    useEscapeKey({ callback: handleClose, active: open, defaultPrevented: true }, [onClose]);
+    // istanbul ignore next
+    if (!isBrowser()) {
+        return null;
+    }
+    var portalElement = resolveElement(portal);
+    return reactDom.createPortal(React__default["default"].createElement(React__default["default"].Fragment, null,
+        React__default["default"].createElement(ClickOutsideListener$1, { onClickOutside: handleClose, mouseEvent: open ? undefined : false, touchEvent: open ? undefined : false, target: drawerRef },
+            React__default["default"].createElement(FocusTrap__default["default"], { active: !!isModal && !!open, focusTrapOptions: {
+                    allowOutsideClick: true,
+                    escapeDeactivates: false,
+                    clickOutsideDeactivates: false,
+                    initialFocus: false,
+                    setReturnFocus: false,
+                    fallbackFocus: function () { return drawerRef.current; }
+                } },
+                React__default["default"].createElement("div", tslib.__assign({ ref: drawerRef, className: classNames__default["default"](className, 'Drawer', {
+                        'Drawer--open': !!open,
+                        'Drawer--top': position === 'top',
+                        'Drawer--bottom': position === 'bottom',
+                        'Drawer--left': position === 'left',
+                        'Drawer--right': position === 'right'
+                    }), "aria-hidden": !open || undefined, style: tslib.__assign({ visibility: !open && !isTransitioning ? 'hidden' : undefined }, style), tabIndex: open ? -1 : undefined }, props), children))),
+        React__default["default"].createElement(Scrim, { show: !!open && !!isModal })), portalElement ||
+        (
+        // eslint-disable-next-line ssr-friendly/no-dom-globals-in-react-fc
+        document === null || document === void 0 ? void 0 : document.body));
+});
+Drawer.displayName = 'Drawer';
+
 var LIGHT_THEME_CLASS = 'cauldron--theme-light';
 var DARK_THEME_CLASS = 'cauldron--theme-dark';
 var ThemeContext = React.createContext({
@@ -4299,6 +4416,7 @@ exports.DescriptionTerm = DescriptionTerm;
 exports.Dialog = Dialog;
 exports.DialogContent = DialogContent;
 exports.DialogFooter = DialogFooter;
+exports.Drawer = Drawer;
 exports.ExpandCollapsePanel = ExpandCollapsePanel;
 exports.FieldWrap = FieldWrap;
 exports.Icon = Icon;

package/lib/utils/resolveElement.d.ts

@@ -0,0 +1,6 @@
+import type { RefObject, MutableRefObject } from 'react';
+/**
+ * When an element can be passed as a value that is either an element or an
+ * elementRef, this will resolve the property down to the resulting element
+ */
+export default function resolveElement<T extends Element = Element>(elementOrRef: T | RefObject<T> | MutableRefObject<T> | undefined): T | null;

package/lib/utils/useEscapeKey.d.ts

@@ -0,0 +1,17 @@
+import { type DependencyList } from 'react';
+/**
+ * When a component needs to implement an escape handler, such as in modal
+ * dialogs, useEscapeKey will handle the events and call the provided callback
+ * handler when an escape key event has been fired.
+ *
+ * @example
+ * useEscapeKey(() => close())
+ */
+export default function useEscapeKey<T extends HTMLElement = HTMLElement>(options: {
+    active?: boolean;
+    callback: (event: KeyboardEvent) => void;
+    event?: 'keydown' | 'keypress' | 'keyup';
+    target?: T | React.RefObject<T> | React.MutableRefObject<T>;
+    defaultPrevented?: boolean;
+    capture?: boolean;
+}, dependencies?: DependencyList): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deque/cauldron-react",
-  "version": "6.7.0-canary.2d78ed57",
+  "version": "6.7.0-canary.38e18ca8",
   "license": "MPL-2.0",
   "description": "Fully accessible react components library for Deque Cauldron",
   "homepage": "https://cauldron.dequelabs.com/",