@carbon/ibm-products 2.43.2-canary.15 → 2.43.2-canary.152

package/lib/components/CoachmarkStack/CoachmarkStack.js

@@ -21,6 +21,7 @@ var CoachmarkStackHome = require('./CoachmarkStackHome.js');
 var CoachmarkTagline = require('../Coachmark/CoachmarkTagline.js');
 var context = require('../Coachmark/utils/context.js');
 var enums = require('../Coachmark/utils/enums.js');
+var useIsomorphicEffect = require('../../global/js/hooks/useIsomorphicEffect.js');
 
 function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
@@ -39,7 +40,8 @@ var elementBlockClass = "".concat(settings.pkg.prefix, "--coachmark-stack-elemen
 var defaults = {
   onClose: function onClose() {},
   // Pass through to CoachmarkStackHome
-  theme: 'light'
+  theme: 'light',
+  portalTarget: 'body'
 };
 
 // NOTE
@@ -56,7 +58,6 @@ var defaults = {
  * This variant allows the stacking of multiple coachmark overlays to be displayed by interacting with the tagline.
  */
 exports.CoachmarkStack = /*#__PURE__*/React__default["default"].forwardRef(function (_ref, ref) {
-  var _document$querySelect;
   var children = _ref.children,
     className = _ref.className,
     _ref$onClose = _ref.onClose,
@@ -72,8 +73,12 @@ exports.CoachmarkStack = /*#__PURE__*/React__default["default"].forwardRef(funct
     theme = _ref$theme === void 0 ? defaults.theme : _ref$theme,
     title = _ref.title,
     rest = _rollupPluginBabelHelpers.objectWithoutProperties(_ref, _excluded);
-  var portalNode = portalTarget ? (_document$querySelect = document.querySelector(portalTarget)) !== null && _document$querySelect !== void 0 ? _document$querySelect : document.querySelector('body') : document.querySelector('body');
-  var stackHomeRef = React.useRef();
+  var portalNode = React.useRef(null);
+  useIsomorphicEffect.useIsomorphicEffect(function () {
+    var _document$querySelect, _document, _document2, _document3;
+    portalNode.current = portalTarget ? (_document$querySelect = (_document = document) === null || _document === void 0 ? void 0 : _document.querySelector(portalTarget)) !== null && _document$querySelect !== void 0 ? _document$querySelect : (_document2 = document) === null || _document2 === void 0 ? void 0 : _document2.querySelector('body') : (_document3 = document) === null || _document3 === void 0 ? void 0 : _document3.querySelector('body');
+  }, [portalTarget]);
+  var stackHomeRef = React.useRef(null);
   var stackedCoachmarkRefs = React.useRef([]);
   var _useState = React.useState(false),
     _useState2 = _rollupPluginBabelHelpers.slicedToArray(_useState, 2),
@@ -87,7 +92,7 @@ exports.CoachmarkStack = /*#__PURE__*/React__default["default"].forwardRef(funct
     selectedItemNumber = _useState4[0],
     setSelectedItemNumber = _useState4[1];
   // // The parent height and width values to return to after unstacked
-  var _useState5 = React.useState(null),
+  var _useState5 = React.useState(),
     _useState6 = _rollupPluginBabelHelpers.slicedToArray(_useState5, 2),
     parentHeight = _useState6[0],
     setParentHeight = _useState6[1];
@@ -168,14 +173,20 @@ exports.CoachmarkStack = /*#__PURE__*/React__default["default"].forwardRef(funct
     if (!parentHeight) {
       return;
     }
-    stackHomeRef.current.style.height = "".concat(parentHeight, "px");
+    if (stackHomeRef.current) {
+      stackHomeRef.current.style.height = "".concat(parentHeight, "px");
+    }
     if (!isOpen || targetSelectedItem < 0) {
-      stackHomeRef.current.focus();
+      if (stackHomeRef.current) {
+        stackHomeRef.current.focus();
+      }
       return;
     }
     var targetHomeHeight = stackedCoachmarkRefs.current[targetSelectedItem].clientHeight;
-    stackHomeRef.current.style.height = "".concat(targetHomeHeight, "px");
-    stackedCoachmarkRefs.current[targetSelectedItem].focus();
+    if (stackHomeRef.current) {
+      stackHomeRef.current.style.height = "".concat(targetHomeHeight, "px");
+      stackedCoachmarkRefs.current[targetSelectedItem].focus();
+    }
   }, [selectedItemNumber, isOpen, parentHeight]);
   var wrappedChildren = React.Children.map(childArray, function (child, idx) {
     var mountedClass = mountedRef.current ? "".concat(elementBlockClass, "--is-mounted") : '';
@@ -215,7 +226,7 @@ exports.CoachmarkStack = /*#__PURE__*/React__default["default"].forwardRef(funct
     portalTarget: portalTarget,
     closeButtonLabel: closeButtonLabel,
     title: title
-  }), /*#__PURE__*/reactDom.createPortal(wrappedChildren, portalNode)));
+  }), portalNode !== null && portalNode !== void 0 && portalNode.current ? /*#__PURE__*/reactDom.createPortal(wrappedChildren, portalNode === null || portalNode === void 0 ? void 0 : portalNode.current) : null));
 });
 
 // Return a placeholder if not released and not enabled by feature flag
@@ -263,7 +274,7 @@ exports.CoachmarkStack.propTypes = {
   /**
    * The labels used to link to the stackable Coachmarks.
    */
-  navLinkLabels: index["default"].arrayOf(index["default"].string).isRequired,
+  navLinkLabels: index["default"].arrayOf(index["default"].string.isRequired).isRequired,
   /**
    * Function to call when the CoachmarkStack closes.
    */

package/lib/components/CoachmarkStack/CoachmarkStackHome.d.ts

@@ -1,6 +1,75 @@
+/**
+ * Copyright IBM Corp. 2023, 2024
+ *
+ * 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, { ReactNode } from 'react';
+type Media = {
+    render?: () => ReactNode;
+    filePaths?: never;
+} | {
+    render?: never;
+    filePaths?: string[];
+};
+interface CoachmarkStackHomeProps {
+    /**
+     * Optional class name for this component.
+     */
+    className?: string;
+    /**
+     * The label for the button that will close the stack
+     */
+    closeButtonLabel?: string;
+    /**
+     * The description of the Coachmark.
+     */
+    description: React.ReactNode;
+    /**
+     * If the stack home is open.
+     */
+    isOpen: boolean;
+    /**
+     * The object describing an image in one of two shapes.
+     *
+     * If a single media element is required, use `{render}`.
+     *
+     * If a stepped animation is required, use `{filePaths}`.
+     *
+     * @see {@link MEDIA_PROP_TYPE}.
+     */
+    media?: Media;
+    /**
+     * The labels used to link to the stackable Coachmarks.
+     */
+    navLinkLabels: string[];
+    /**
+     * For internal use only by CoachmarkStack and CoachmarkStackHome.
+     */
+    onClickNavItem: (index: number) => void;
+    /**
+     * Function to call when the stack closes.
+     */
+    onClose: () => void;
+    /**
+     * By default, the CoachmarkStackHome will be appended to the end of `document.body`.
+     * The CoachmarkStackHome will remain persistent as the user navigates the app until
+     * the user closes the CoachmarkStackHome.
+     *
+     * Alternatively, the app developer can tightly couple the CoachmarkStackHome to a DOM
+     * element or other component by specifying a CSS selector. The CoachmarkStackHome will
+     * remain visible as long as that element remains visible or mounted. When the
+     * element is hidden or component is unmounted, the CoachmarkStackHome will disappear.
+     */
+    portalTarget?: string;
+    /**
+     * The title of the Coachmark.
+     */
+    title: string;
+}
 /**
  * DO NOT USE. This component is for the exclusive use
  * of other Onboarding components.
  */
-export let CoachmarkStackHome: React.ForwardRefExoticComponent<React.RefAttributes<any>>;
-import React from 'react';
+export declare let CoachmarkStackHome: React.ForwardRefExoticComponent<CoachmarkStackHomeProps & React.RefAttributes<HTMLDivElement>>;
+export {};

package/lib/components/CoachmarkStack/CoachmarkStackHome.js

@@ -21,6 +21,7 @@ var settings = require('../../settings.js');
 var reactDom = require('react-dom');
 var CoachmarkHeader = require('../Coachmark/CoachmarkHeader.js');
 var SteppedAnimatedMedia = require('../SteppedAnimatedMedia/SteppedAnimatedMedia.js');
+var useIsomorphicEffect = require('../../global/js/hooks/useIsomorphicEffect.js');
 
 function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
@@ -28,7 +29,6 @@ var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
 var cx__default = /*#__PURE__*/_interopDefaultLegacy(cx);
 
 var _excluded = ["className", "description", "isOpen", "media", "navLinkLabels", "onClickNavItem", "onClose", "portalTarget", "closeButtonLabel", "title"];
-
 // Carbon and package components we use.
 /* TODO: @import(s) of carbon components and other package components. */
 
@@ -42,7 +42,6 @@ var componentName = 'CoachmarkStackHome';
  * of other Onboarding components.
  */
 exports.CoachmarkStackHome = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
-  var _document$querySelect;
   var className = _ref.className,
     description = _ref.description,
     isOpen = _ref.isOpen,
@@ -54,7 +53,7 @@ exports.CoachmarkStackHome = /*#__PURE__*/React.forwardRef(function (_ref, ref)
     closeButtonLabel = _ref.closeButtonLabel,
     title = _ref.title,
     rest = _rollupPluginBabelHelpers.objectWithoutProperties(_ref, _excluded);
-  var buttonFocusRef = React.useRef();
+  var buttonFocusRef = React.useRef(null);
   var _useState = React.useState(0),
     _useState2 = _rollupPluginBabelHelpers.slicedToArray(_useState, 2),
     linkFocusIndex = _useState2[0],
@@ -66,11 +65,29 @@ exports.CoachmarkStackHome = /*#__PURE__*/React.forwardRef(function (_ref, ref)
       }
     }, 100);
   }, [isOpen]);
+  var portalNode = React.useRef(null);
+  useIsomorphicEffect.useIsomorphicEffect(function () {
+    var _document$querySelect, _document, _document2, _document3;
+    portalNode.current = portalTarget ? (_document$querySelect = (_document = document) === null || _document === void 0 ? void 0 : _document.querySelector(portalTarget)) !== null && _document$querySelect !== void 0 ? _document$querySelect : (_document2 = document) === null || _document2 === void 0 ? void 0 : _document2.querySelector('body') : (_document3 = document) === null || _document3 === void 0 ? void 0 : _document3.querySelector('body');
+  }, [portalTarget]);
   if (!navLinkLabels) {
     return pconsole["default"].warn("".concat(componentName, " is an Onboarding internal component and is not intended for general use."));
   }
-  var portalNode = portalTarget ? (_document$querySelect = document.querySelector(portalTarget)) !== null && _document$querySelect !== void 0 ? _document$querySelect : document.querySelector('body') : document.querySelector('body');
-  return /*#__PURE__*/reactDom.createPortal( /*#__PURE__*/React__default["default"].createElement("div", _rollupPluginBabelHelpers["extends"]({}, rest, {
+  function renderNavLink(index, label) {
+    var ref = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : null;
+    return /*#__PURE__*/React__default["default"].createElement("li", {
+      key: index
+    }, /*#__PURE__*/React__default["default"].createElement(react.Button, {
+      kind: "ghost",
+      size: "sm",
+      onClick: function onClick() {
+        setLinkFocusIndex(index);
+        onClickNavItem(index + 1);
+      },
+      ref: ref
+    }, label));
+  }
+  return portalNode !== null && portalNode !== void 0 && portalNode.current ? /*#__PURE__*/reactDom.createPortal( /*#__PURE__*/React__default["default"].createElement("div", _rollupPluginBabelHelpers["extends"]({}, rest, {
     className: cx__default["default"](blockClass, className),
     ref: ref,
     role: "main"
@@ -101,9 +118,8 @@ exports.CoachmarkStackHome = /*#__PURE__*/React.forwardRef(function (_ref, ref)
   }, navLinkLabels.map(function (label, index) {
     if (index === linkFocusIndex) {
       return renderNavLink(index, label, buttonFocusRef);
-    } else {
-      return renderNavLink(index, label);
     }
+    return renderNavLink(index, label);
   })), closeButtonLabel && /*#__PURE__*/React__default["default"].createElement("div", {
     className: "".concat(overlayClass, "__footer")
   }, /*#__PURE__*/React__default["default"].createElement(react.Button, {
@@ -112,21 +128,7 @@ exports.CoachmarkStackHome = /*#__PURE__*/React.forwardRef(function (_ref, ref)
       setLinkFocusIndex(0);
       _onClose();
     }
-  }, closeButtonLabel))))), portalNode);
-  function renderNavLink(index, label) {
-    var ref = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : null;
-    return /*#__PURE__*/React__default["default"].createElement("li", {
-      key: index
-    }, /*#__PURE__*/React__default["default"].createElement(react.Button, {
-      kind: "ghost",
-      size: "sm",
-      onClick: function onClick() {
-        setLinkFocusIndex(index);
-        onClickNavItem(index + 1);
-      },
-      ref: ref
-    }, label));
-  }
+  }, closeButtonLabel))))), portalNode === null || portalNode === void 0 ? void 0 : portalNode.current) : null;
 });
 
 // Return a placeholder if not released and not enabled by feature flag
@@ -173,7 +175,7 @@ exports.CoachmarkStackHome.propTypes = {
   /**
    * The labels used to link to the stackable Coachmarks.
    */
-  navLinkLabels: index["default"].arrayOf(index["default"].string).isRequired,
+  navLinkLabels: index["default"].arrayOf(index["default"].string.isRequired).isRequired,
   /**
    * For internal use only by CoachmarkStack and CoachmarkStackHome.
    */

package/lib/components/ComboButton/ComboButton.d.ts

@@ -5,7 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 import React, { ComponentProps, ReactNode } from 'react';
-interface ComboButtonProps extends ComponentProps<'div'> {
+export interface ComboButtonProps extends ComponentProps<'div'> {
     /** Provide the contents of the `ComboButton` */
     children?: ReactNode;
     /** Provide an optional class to be applied to the containing node */

package/lib/components/ComboButton/ComboButton.js

@@ -10,18 +10,18 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var _rollupPluginBabelHelpers = require('../../_virtual/_rollupPluginBabelHelpers.js');
-var icons = require('@carbon/react/icons');
 var react = require('@carbon/react');
-var cx = require('classnames');
-var index = require('../../node_modules/prop-types/index.js');
-var uuidv4 = require('../../global/js/utils/uuidv4.js');
+var icons = require('@carbon/react/icons');
 var React = require('react');
+var index = require('../../node_modules/prop-types/index.js');
+var cx = require('classnames');
 var settings = require('../../settings.js');
+var uuidv4 = require('../../global/js/utils/uuidv4.js');
 
 function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
-var cx__default = /*#__PURE__*/_interopDefaultLegacy(cx);
 var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
+var cx__default = /*#__PURE__*/_interopDefaultLegacy(cx);
 
 var _excluded = ["children", "className", "overflowMenu"],
   _excluded2 = ["children", "renderIcon"];

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

@@ -1,2 +1,9 @@
-export { ComboButton } from "./ComboButton";
-export { ComboButtonItem } from "./ComboButtonItem";
+/**
+ * Copyright IBM Corp. 2020, 2021
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+export { ComboButton } from './ComboButton';
+export { ComboButtonItem } from './ComboButtonItem';
+export type { ComboButtonProps } from './ComboButton';

package/lib/components/ConditionBuilder/ConditionBlock/ConditionBlock.d.ts

@@ -1,28 +1,104 @@
-export default ConditionBlock;
+/**
+ * Copyright IBM Corp. 2024
+ *
+ * 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 PropTypes from 'prop-types';
+import { Condition, ConditionGroup, LogicalOperator } from '../ConditionBuilder.types';
 /**
  * This component build each block of condition consisting of property, operator value and close button.
  */
-declare function ConditionBlock(props: any): import("react/jsx-runtime").JSX.Element;
-declare namespace ConditionBlock {
-    namespace propTypes {
-        let addConditionHandler: PropTypes.Requireable<(...args: any[]) => any>;
-        let addConditionSubGroupHandler: PropTypes.Requireable<(...args: any[]) => any>;
-        let aria: PropTypes.Requireable<object>;
-        let condition: PropTypes.Requireable<object>;
-        let conditionIndex: PropTypes.Requireable<number>;
-        let conjunction: PropTypes.Requireable<string>;
-        let group: PropTypes.Requireable<object>;
-        let hideConditionPreviewHandler: PropTypes.Requireable<(...args: any[]) => any>;
-        let hideConditionSubGroupPreviewHandler: PropTypes.Requireable<(...args: any[]) => any>;
-        let isLastCondition: PropTypes.Requireable<(...args: any[]) => any>;
-        let isStatement: PropTypes.Requireable<boolean>;
-        let onChange: PropTypes.Requireable<(...args: any[]) => any>;
-        let onConnectorOperatorChange: PropTypes.Requireable<(...args: any[]) => any>;
-        let onRemove: PropTypes.Requireable<(...args: any[]) => any>;
-        let onStatementChange: PropTypes.Requireable<(...args: any[]) => any>;
-        let showConditionPreviewHandler: PropTypes.Requireable<(...args: any[]) => any>;
-        let showConditionSubGroupPreviewHandler: PropTypes.Requireable<(...args: any[]) => any>;
-        let state: PropTypes.Requireable<object>;
-    }
+interface ConditionBlockProps {
+    condition?: Condition;
+    onRemove: (e: React.MouseEvent<HTMLButtonElement>) => void;
+    onChange: (condition: Condition) => void;
+    onConnectorOperatorChange?: (op: string) => void;
+    onStatementChange?: (v: string) => void;
+    addConditionHandler?: (conditionIndex: number) => void;
+    addConditionSubGroupHandler?: (conditionIndex: number) => void;
+    hideConditionSubGroupPreviewHandler?: () => void;
+    showConditionSubGroupPreviewHandler?: () => void;
+    hideConditionPreviewHandler?: () => void;
+    showConditionPreviewHandler?: () => void;
+    conjunction?: LogicalOperator;
+    isStatement?: boolean;
+    group: ConditionGroup;
+    conditionIndex: number;
+    aria: {
+        level: number;
+        posinset: number;
+        setsize?: number;
+    };
+    isLastCondition: (index: number, conditions: (ConditionGroup | Condition)[]) => void;
 }
-import PropTypes from 'prop-types';
+declare const ConditionBlock: {
+    (props: ConditionBlockProps): import("react/jsx-runtime").JSX.Element;
+    propTypes: {
+        /**
+         * callback to add a new condition
+         */
+        addConditionHandler: PropTypes.Requireable<(...args: any[]) => any>;
+        /**
+         * callback to add a new condition subgroup
+         */
+        addConditionSubGroupHandler: PropTypes.Requireable<(...args: any[]) => any>;
+        /**
+         * object hold aria attributes
+         */
+        aria: PropTypes.Requireable<object>;
+        condition: PropTypes.Requireable<object>;
+        conditionIndex: PropTypes.Requireable<number>;
+        /**
+         * string that decides to show the condition connector
+         */
+        conjunction: PropTypes.Requireable<string>;
+        /**
+         * object that hold the current group object where is condition is part of
+         */
+        group: PropTypes.Requireable<object>;
+        /**
+         * handler for hiding sub group preview
+         */
+        hideConditionPreviewHandler: PropTypes.Requireable<(...args: any[]) => any>;
+        /**
+         * handler for hiding sub group preview
+         */
+        hideConditionSubGroupPreviewHandler: PropTypes.Requireable<(...args: any[]) => any>;
+        isLastCondition: PropTypes.Requireable<(...args: any[]) => any>;
+        /**
+         *  boolean that decides to show the statement(if/ excl.if)
+         */
+        isStatement: PropTypes.Requireable<boolean>;
+        /**
+         * callback to update the current condition of the state tree
+         */
+        onChange: PropTypes.Requireable<(...args: any[]) => any>;
+        /**
+         * callback to handle the connector(and/or) change
+         */
+        onConnectorOperatorChange: PropTypes.Requireable<(...args: any[]) => any>;
+        /**
+         * callback for Remove a condition
+         */
+        onRemove: PropTypes.Requireable<(...args: any[]) => any>;
+        /**
+         * callback to handle the statement(if/ excl.if) change
+         */
+        onStatementChange: PropTypes.Requireable<(...args: any[]) => any>;
+        /**
+         * handler for showing add condition preview
+         */
+        showConditionPreviewHandler: PropTypes.Requireable<(...args: any[]) => any>;
+        /**
+         * handler for showing sub group preview
+         */
+        showConditionSubGroupPreviewHandler: PropTypes.Requireable<(...args: any[]) => any>;
+        /**
+         * object that hold the current condition
+         */
+        state: PropTypes.Requireable<object>;
+    };
+};
+export default ConditionBlock;