@carbon/react 1.23.1 → 1.24.0

package/lib/components/Pagination/experimental/Pagination.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/lib/components/PaginationNav/PaginationNav.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

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

@@ -0,0 +1,51 @@
+/**
+ * Copyright IBM Corp. 2016, 2023
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import React from 'react';
+import { PolymorphicProps } from '../../types/common';
+export type PopoverAlignment = 'top' | 'top-left' | 'top-right' | 'bottom' | 'bottom-left' | 'bottom-right' | 'left' | 'left-bottom' | 'left-top' | 'right' | 'right-bottom' | 'right-top';
+interface PopoverBaseProps {
+    /**
+     * Specify how the popover should align with the trigger element
+     */
+    align?: PopoverAlignment;
+    /**
+     * Will auto-align the popover on first render if it is not visible. This prop is currently experimental and is subject to futurue changes.
+     */
+    autoAlign?: boolean;
+    /**
+     * Specify whether a caret should be rendered
+     */
+    caret?: boolean;
+    /**
+     * Provide elements to be rendered inside of the component
+     */
+    children?: React.ReactNode;
+    /**
+     * Provide a custom class name to be added to the outermost node in the
+     * component
+     */
+    className?: string;
+    /**
+     * Specify whether a drop shadow should be rendered on the popover
+     */
+    dropShadow?: boolean;
+    /**
+     * Render the component using the high-contrast variant
+     */
+    highContrast?: boolean;
+    /**
+     * Specify whether the component is currently open or closed
+     */
+    open: boolean;
+}
+export type PopoverProps<T extends React.ElementType> = PolymorphicProps<T, PopoverBaseProps>;
+declare const Popover: React.ForwardRefExoticComponent<Pick<PopoverBaseProps & Omit<any, "as"> & {
+    as?: React.ElementType<any> | undefined;
+}, string | number | symbol> & React.RefAttributes<Element>>;
+export type PopoverContentProps = React.HTMLAttributes<HTMLSpanElement>;
+declare const PopoverContent: React.ForwardRefExoticComponent<PopoverContentProps & React.RefAttributes<HTMLSpanElement>>;
+export { Popover, PopoverContent };

package/lib/components/Popover/index.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
@@ -30,29 +30,28 @@ var PopoverContext = /*#__PURE__*/React__default["default"].createContext({
     current: null
   }
 });
-var Popover = /*#__PURE__*/React__default["default"].forwardRef(function Popover(props, forwardRef) {
+var Popover = /*#__PURE__*/React__default["default"].forwardRef(function (_ref, forwardRef) {
   var _cx;
 
-  var _props$align = props.align,
-      align = _props$align === void 0 ? 'bottom' : _props$align,
-      _props$as = props.as,
-      BaseComponent = _props$as === void 0 ? 'span' : _props$as,
-      _props$autoAlign = props.autoAlign,
-      autoAlign = _props$autoAlign === void 0 ? false : _props$autoAlign,
-      _props$caret = props.caret,
-      caret = _props$caret === void 0 ? true : _props$caret,
-      customClassName = props.className,
-      children = props.children,
-      _props$dropShadow = props.dropShadow,
-      dropShadow = _props$dropShadow === void 0 ? true : _props$dropShadow,
-      _props$highContrast = props.highContrast,
-      highContrast = _props$highContrast === void 0 ? false : _props$highContrast,
-      open = props.open,
-      rest = _rollupPluginBabelHelpers.objectWithoutProperties(props, _excluded);
+  var _ref$align = _ref.align,
+      align = _ref$align === void 0 ? 'bottom' : _ref$align,
+      as = _ref.as,
+      _ref$autoAlign = _ref.autoAlign,
+      autoAlign = _ref$autoAlign === void 0 ? false : _ref$autoAlign,
+      _ref$caret = _ref.caret,
+      caret = _ref$caret === void 0 ? true : _ref$caret,
+      customClassName = _ref.className,
+      children = _ref.children,
+      _ref$dropShadow = _ref.dropShadow,
+      dropShadow = _ref$dropShadow === void 0 ? true : _ref$dropShadow,
+      _ref$highContrast = _ref.highContrast,
+      highContrast = _ref$highContrast === void 0 ? false : _ref$highContrast,
+      open = _ref.open,
+      rest = _rollupPluginBabelHelpers.objectWithoutProperties(_ref, _excluded);
 
   var prefix = usePrefix.usePrefix();
-  var floating = React.useRef();
-  var popover = React.useRef();
+  var floating = React.useRef(null);
+  var popover = React.useRef(null);
   var value = React.useMemo(function () {
     return {
       floating: floating
@@ -70,7 +69,7 @@ var Popover = /*#__PURE__*/React__default["default"].forwardRef(function Popover
       autoAlignment = _useState4[0],
       setAutoAlignment = _useState4[1];
 
-  var className = cx__default["default"]((_cx = {}, _rollupPluginBabelHelpers.defineProperty(_cx, "".concat(prefix, "--popover-container"), true), _rollupPluginBabelHelpers.defineProperty(_cx, "".concat(prefix, "--popover--caret"), caret), _rollupPluginBabelHelpers.defineProperty(_cx, "".concat(prefix, "--popover--drop-shadow"), dropShadow), _rollupPluginBabelHelpers.defineProperty(_cx, "".concat(prefix, "--popover--high-contrast"), highContrast), _rollupPluginBabelHelpers.defineProperty(_cx, "".concat(prefix, "--popover--open"), open), _rollupPluginBabelHelpers.defineProperty(_cx, "".concat(prefix, "--popover--").concat(autoAlignment), autoAligned), _rollupPluginBabelHelpers.defineProperty(_cx, "".concat(prefix, "--popover--").concat(align), !autoAligned), _rollupPluginBabelHelpers.defineProperty(_cx, customClassName, !!customClassName), _cx));
+  var className = cx__default["default"]((_cx = {}, _rollupPluginBabelHelpers.defineProperty(_cx, "".concat(prefix, "--popover-container"), true), _rollupPluginBabelHelpers.defineProperty(_cx, "".concat(prefix, "--popover--caret"), caret), _rollupPluginBabelHelpers.defineProperty(_cx, "".concat(prefix, "--popover--drop-shadow"), dropShadow), _rollupPluginBabelHelpers.defineProperty(_cx, "".concat(prefix, "--popover--high-contrast"), highContrast), _rollupPluginBabelHelpers.defineProperty(_cx, "".concat(prefix, "--popover--open"), open), _rollupPluginBabelHelpers.defineProperty(_cx, "".concat(prefix, "--popover--").concat(autoAlignment), autoAligned), _rollupPluginBabelHelpers.defineProperty(_cx, "".concat(prefix, "--popover--").concat(align), !autoAligned), _cx), customClassName);
   useIsomorphicEffect["default"](function () {
     if (!open) {
       return;
@@ -118,6 +117,10 @@ var Popover = /*#__PURE__*/React__default["default"].forwardRef(function Popover
     }
 
     function isVisible(alignment) {
+      if (!popover.current || !floating.current) {
+        return false;
+      }
+
       popover.current.classList.add("".concat(prefix, "--popover--").concat(alignment));
       var rect = floating.current.getBoundingClientRect(); // Check if popover is not visible to the left of the screen
 
@@ -164,6 +167,7 @@ var Popover = /*#__PURE__*/React__default["default"].forwardRef(function Popover
       setAutoAlignment(alignment);
     }
   }, [autoAligned, align, autoAlign, prefix, open]);
+  var BaseComponent = as !== null && as !== void 0 ? as : 'span';
   return /*#__PURE__*/React__default["default"].createElement(PopoverContext.Provider, {
     value: value
   }, /*#__PURE__*/React__default["default"].createElement(BaseComponent, _rollupPluginBabelHelpers["extends"]({}, rest, {
@@ -225,10 +229,10 @@ Popover.propTypes = {
    */
   open: PropTypes__default["default"].bool.isRequired
 };
-var PopoverContent = /*#__PURE__*/React__default["default"].forwardRef(function PopoverContent(_ref, forwardRef) {
-  var className = _ref.className,
-      children = _ref.children,
-      rest = _rollupPluginBabelHelpers.objectWithoutProperties(_ref, _excluded2);
+var PopoverContent = /*#__PURE__*/React__default["default"].forwardRef(function PopoverContent(_ref2, forwardRef) {
+  var className = _ref2.className,
+      children = _ref2.children,
+      rest = _rollupPluginBabelHelpers.objectWithoutProperties(_ref2, _excluded2);
 
   var prefix = usePrefix.usePrefix();
 

package/lib/components/PrimaryButton/PrimaryButton.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/lib/components/ProgressBar/ProgressBar.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/lib/components/ProgressIndicator/ProgressIndicator.Skeleton.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/lib/components/ProgressIndicator/ProgressIndicator.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/lib/components/RadioButton/RadioButton.Skeleton.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/lib/components/RadioButton/RadioButton.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/lib/components/RadioButton/index.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/lib/components/RadioButtonGroup/RadioButtonGroup.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/lib/components/RadioTile/RadioTile.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/lib/components/RadioTile/index.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/lib/components/Search/Search.Skeleton.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/lib/components/Search/Search.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/lib/components/Search/index.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/lib/components/SecondaryButton/SecondaryButton.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/lib/components/Select/Select.Skeleton.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2018
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/lib/components/Select/Select.Skeleton.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/lib/components/Select/Select.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/lib/components/Select/index.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/lib/components/SelectItem/SelectItem.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/lib/components/SelectItem/index.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/lib/components/SelectItemGroup/SelectItemGroup.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/lib/components/SkeletonIcon/SkeletonIcon.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/lib/components/SkeletonPlaceholder/SkeletonPlaceholder.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/lib/components/SkeletonText/SkeletonText.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/lib/components/SkeletonText/index.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/lib/components/Slider/Slider.Skeleton.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2018
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
@@ -8,8 +8,8 @@ import PropTypes from 'prop-types';
 import { HTMLAttributes } from 'react';
 export interface SliderSkeletonProps extends HTMLAttributes<HTMLDivElement> {
     /**
-      * Specify an optional className to add to the form item wrapper.
-      */
+     * Specify an optional className to add to the form item wrapper.
+     */
     className?: string;
     /**
      * Specify whether the label should be hidden, or not

package/lib/components/Slider/Slider.Skeleton.js

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2022
+ * Copyright IBM Corp. 2016, 2023
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.