@carbon/ibm-products 2.35.0 → 2.36.0-alpha.27

package/es/components/FullPageError/FullPageError.js

@@ -9,17 +9,14 @@ import { objectWithoutProperties as _objectWithoutProperties, extends as _extend
 import React__default from 'react';
 import PropTypes from '../../node_modules/prop-types/index.js';
 import cx from 'classnames';
-import { Grid, Column } from '@carbon/react';
-import { ErrorGenericSVG } from './assets/ErrorGenericSVG.js';
 import { getDevtoolsProps } from '../../global/js/utils/devtools.js';
 import { pkg } from '../../settings.js';
+import { ErrorGenericSVG } from './assets/ErrorGenericSVG.js';
 import { Error404SVG } from './assets/Error404SVG.js';
 import { Error403SVG } from './assets/Error403SVG.js';
+import { Grid, Column } from '@carbon/react';
 
-var _excluded = ["children", "className", "description", "errorLabel", "kind", "title"];
-
-// Carbon and package components we use.
-/* TODO: @import(s) of carbon components and other package components. */
+var _excluded = ["children", "className", "description", "label", "kind", "title"];
 
 // The block part of our conventional BEM class names (blockClass__E--M).
 var blockClass = "".concat(pkg.prefix, "--full-page-error");
@@ -27,88 +24,68 @@ var componentName = 'FullPageError';
 
 // NOTE: the component SCSS is not imported here: it is rolled up separately.
 
-// Default values can be included here and then assigned to the prop params,
-// e.g. prop = defaults.prop,
-// This gathers default values together neatly and ensures non-primitive
-// values are initialized early to avoid react making unnecessary re-renders.
-// Note that default values are not required for props that are 'required',
-// nor for props where the component can apply undefined values reasonably.
-// Default values should be provided when the component needs to make a choice
-// or assumption when a prop is not supplied.
-
 // Default values for props
 var defaults = {
   kind: 'custom'
 };
 
 /**
- * TODO: A description of the component.
+ * Display a full-page error when the requested page is unavailable to the user.
+ * This is typically caused by issues with the requested URL or access permissions.
  */
 var FullPageError = /*#__PURE__*/React__default.forwardRef(function (_ref, ref) {
   var children = _ref.children,
     className = _ref.className,
     description = _ref.description,
-    errorLabel = _ref.errorLabel,
+    label = _ref.label,
     _ref$kind = _ref.kind,
     kind = _ref$kind === void 0 ? defaults.kind : _ref$kind,
     title = _ref.title,
     rest = _objectWithoutProperties(_ref, _excluded);
   var errorData = {
     403: {
-      title: 'Access denied',
-      description: 'You are not authorized to access the requested page. Please verify that you are logged in to the hosting environment and your access permissions are correct.',
       svg: /*#__PURE__*/React__default.createElement(Error403SVG, {
-        className: cx("".concat(blockClass, "__error-svg"), "".concat(blockClass, "__error-403"))
+        className: "".concat(blockClass, "__svg ").concat(blockClass, "__403")
       })
     },
     404: {
-      title: 'Page not found',
-      description: 'The page you requested has moved or is unavailable, or the specified URL is not valid. Please check the URL or search the site for the requested content.',
       svg: /*#__PURE__*/React__default.createElement(Error404SVG, {
-        className: cx("".concat(blockClass, "__error-svg"), "".concat(blockClass, "__error-404"))
+        className: "".concat(blockClass, "__svg ").concat(blockClass, "__404")
       })
     },
     custom: {
-      title: title,
-      description: description,
       svg: /*#__PURE__*/React__default.createElement(ErrorGenericSVG, {
-        className: cx("".concat(blockClass, "__error-svg"), "".concat(blockClass, "__error-custom"))
+        className: "".concat(blockClass, "__svg ").concat(blockClass, "__custom")
       })
     }
   };
   return /*#__PURE__*/React__default.createElement("div", _extends({}, rest, {
-    className: cx(blockClass,
-    // Apply the block class to the main HTML element
-    className,
-    // Apply any supplied class names to the main HTML element.
-    // example: `${blockClass}__template-string-class-${kind}-n-${size}`,
-    {
-      // switched classes dependant on props or state
-      // example: [`${blockClass}__here-if-small`]: size === 'sm',
-    }),
+    className: cx(blockClass, className),
     ref: ref,
     role: "main"
   }, getDevtoolsProps(componentName)), /*#__PURE__*/React__default.createElement("div", {
-    className: "".concat(blockClass, "__error-container")
+    className: "".concat(blockClass, "__container")
   }, /*#__PURE__*/React__default.createElement(Grid, {
-    className: "".concat(blockClass, "__error-grid")
+    className: "".concat(blockClass, "__grid")
   }, /*#__PURE__*/React__default.createElement(Column, {
     sm: 4,
     md: 3,
     lg: 6,
-    className: "".concat(blockClass, "__error-column")
+    className: "".concat(blockClass, "__column")
   }, /*#__PURE__*/React__default.createElement("h1", {
-    className: "".concat(blockClass, "__error-title")
+    className: "".concat(blockClass, "__title")
   }, /*#__PURE__*/React__default.createElement("span", {
-    className: "".concat(blockClass, "__error-label")
-  }, "\u21B3 ", kind === 'custom' ? errorLabel : "Error ".concat(kind)), /*#__PURE__*/React__default.createElement("span", null, errorData[kind].title)), /*#__PURE__*/React__default.createElement("p", {
+    className: "".concat(blockClass, "__label")
+  }, "\u21B3 ", label), /*#__PURE__*/React__default.createElement("span", null, title)), /*#__PURE__*/React__default.createElement("p", {
     className: "".concat(blockClass, "__description")
-  }, description || errorData[kind].description), children), /*#__PURE__*/React__default.createElement(Column, {
+  }, description), /*#__PURE__*/React__default.createElement("div", {
+    className: "".concat(blockClass, "__body")
+  }, children)), /*#__PURE__*/React__default.createElement(Column, {
     sm: 4,
     md: 5,
     lg: 10
   }, /*#__PURE__*/React__default.createElement("div", {
-    className: "".concat(blockClass, "__error-svg-container")
+    className: "".concat(blockClass, "__svg-container")
   }, errorData[kind].svg)))));
 });
 
@@ -136,20 +113,18 @@ FullPageError.propTypes = {
    * This is optional for 403 and 404 kinds, and passing this would override their default descriptions.
    */
   description: PropTypes.string.isRequired,
-  /**
-   * String that will describe the error that occurred
-   */
-  errorLabel: PropTypes.string.isRequired,
   /**
    * The kind of error page to be displayed, default is custom
    */
   kind: PropTypes.oneOf(['custom', '403', '404']),
+  /**
+   * String that will describe the error that occurred
+   */
+  label: PropTypes.string.isRequired,
   /**
    * This will be for the main title of the FullPageError component
    */
   title: PropTypes.string.isRequired
-
-  /* TODO: add types and DocGen for all props. */
 };
 
 export { FullPageError };

package/es/components/HTTPErrors/HTTPErrorOther/HTTPErrorOther.d.ts

@@ -1,7 +1,45 @@
+/**
+ * Copyright IBM Corp. 2021, 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.
+ */
+import React, { PropsWithChildren } from 'react';
+interface HTTPErrorOtherProps extends PropsWithChildren {
+    /**
+     * Provide an optional class to be applied to the containing node
+     */
+    className?: string;
+    /**
+     * String that will provide the description for the HTTP error code
+     */
+    description: string;
+    /**
+     * String that will describe the error that occurred
+     */
+    errorCodeLabel: string;
+    /**
+     * Links that will display for extra context when receiving particular errors
+     */
+    links?: Array<{
+        /**
+         * The text to display for the link
+         */
+        text: string;
+        /**
+         * The link's destination
+         */
+        href: string;
+    }>;
+    /**
+     * This will be for the main title of the HTTP error component
+     */
+    title: string;
+}
 /**
  * HTTP errors are used in an attempt to access something that isn’t available or
 the user doesn’t have permission for. This HTTPError component is generic so you
 can use it when you receive an error code that isn't provided.
  */
-export let HTTPErrorOther: React.ForwardRefExoticComponent<React.RefAttributes<any>>;
-import React from 'react';
+export declare let HTTPErrorOther: React.ForwardRefExoticComponent<HTTPErrorOtherProps & React.RefAttributes<HTMLDivElement>>;
+export {};

package/es/components/HTTPErrors/HTTPErrorOther/HTTPErrorOther.js

@@ -19,7 +19,6 @@ var _excluded = ["className", "description", "errorCodeLabel", "links", "title"]
 // The block part of our conventional BEM class names (blockClass__E--M).
 var blockClass = "".concat(pkg.prefix, "--http-errors");
 var componentName = 'HTTPErrorOther';
-
 /**
  * HTTP errors are used in an attempt to access something that isn’t available or
 the user doesn’t have permission for. This HTTPError component is generic so you
@@ -71,6 +70,7 @@ HTTPErrorOther.propTypes = {
   /**
    * Links that will display for extra context when receiving particular errors
    */
+  /**@ts-ignore */
   links: propTypesExports.arrayOf(propTypesExports.shape({
     /**
      * The text to display for the link

package/es/components/InlineTip/InlineTipLink.d.ts

@@ -1,5 +1,22 @@
+/**
+ * Copyright IBM Corp. 2023, 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, { PropsWithChildren, ReactNode } from 'react';
+interface InlineTipLinkProps extends PropsWithChildren {
+    /**
+     * Provide the contents of the InlineTipLink.
+     */
+    children: ReactNode;
+    /**
+     * Provide an optional class to be applied to the containing node.
+     */
+    className?: string;
+}
 /**
  * This is a standard Carbon link, styled specifically for use inside InlineTip.
  */
-export let InlineTipLink: React.ForwardRefExoticComponent<React.RefAttributes<any>>;
-import React from 'react';
+export declare let InlineTipLink: React.ForwardRefExoticComponent<InlineTipLinkProps & React.RefAttributes<HTMLDivElement>>;
+export {};

package/es/components/InterstitialScreenView/InterstitialScreenView.d.ts

@@ -1,5 +1,26 @@
+/**
+ * Copyright IBM Corp. 2023, 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, { PropsWithChildren, ReactNode } from 'react';
+interface InterstitialScreenViewProps extends PropsWithChildren {
+    /**
+     * Provide the contents of the InterstitialScreenView.
+     */
+    children?: ReactNode;
+    /**
+     * Optional class name for this component.
+     */
+    className?: string;
+    /**
+     * The label to pass to the ProgressStep component.
+     */
+    stepTitle: string;
+}
 /**
  * A Novice to Pro component intended to be used as the child elements of the InterstitialScreen component.
  */
-export let InterstitialScreenView: React.ForwardRefExoticComponent<React.RefAttributes<any>>;
-import React from 'react';
+export declare let InterstitialScreenView: React.ForwardRefExoticComponent<InterstitialScreenViewProps & React.RefAttributes<HTMLDivElement>>;
+export {};

package/es/components/InterstitialScreenView/InterstitialScreenView.js

@@ -20,7 +20,6 @@ var _excluded = ["children", "className", "stepTitle"];
 // The block part of our conventional BEM class names (blockClass__E--M).
 var blockClass = "".concat(pkg.prefix, "--interstitial-screen-view");
 var componentName = 'InterstitialScreenView';
-
 /**
  * A Novice to Pro component intended to be used as the child elements of the InterstitialScreen component.
  */

package/es/components/InterstitialScreenViewModule/InterstitialScreenViewModule.d.ts

@@ -1,5 +1,26 @@
 /**
- * View module to help in building interstitial screen views.
+ * Copyright IBM Corp. 2024, 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.
  */
-export let InterstitialScreenViewModule: React.ForwardRefExoticComponent<React.RefAttributes<any>>;
 import React from 'react';
+interface InterstitialScreenViewModuleProps {
+    /**
+     * Provide an optional class to be applied to the containing node.
+     */
+    className?: string;
+    /**
+     * The description of this component.
+     */
+    description: string;
+    /**
+     * The title of this component.
+     */
+    title: string;
+}
+/**
+ * View module to help in building interstitial screen views.
+ */
+export declare let InterstitialScreenViewModule: React.ForwardRefExoticComponent<InterstitialScreenViewModuleProps & React.RefAttributes<HTMLElement>>;
+export {};

package/es/components/NonLinearReading/NonLinearReading.d.ts

@@ -1,7 +1,33 @@
+/**
+ * Copyright IBM Corp. 2023, 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, { ReactNode } from 'react';
+type Theme = 'light' | 'dark';
+interface NonLinearReadingProps {
+    /**
+     * The keyword of the component appears as a pill.
+     */
+    children: ReactNode;
+    /**
+     * Provide an optional class to be applied to the containing node.
+     */
+    className?: string;
+    /**
+     * The content that appears when the keyword is toggled open.
+     */
+    definition: ReactNode;
+    /**
+     * Determines the theme of the component.
+     */
+    theme?: Theme;
+}
 /**
  * Use non-linear reading when space is limited to share a
  * brief, at-a-glance, summary of a concept that may require
  * more explanation for some users.
  */
-export let NonLinearReading: React.ForwardRefExoticComponent<React.RefAttributes<any>>;
-import React from 'react';
+export declare let NonLinearReading: React.ForwardRefExoticComponent<NonLinearReadingProps & React.RefAttributes<HTMLSpanElement>>;
+export {};

package/es/components/NonLinearReading/NonLinearReading.js

@@ -20,12 +20,6 @@ var _excluded = ["children", "className", "definition", "theme"];
 // The block part of our conventional BEM class names (blockClass__E--M).
 var blockClass = "".concat(pkg.prefix, "--non-linear-reading");
 var componentName = 'NonLinearReading';
-
-// Default values for props
-var defaults = {
-  theme: 'light'
-};
-
 /**
  * Use non-linear reading when space is limited to share a
  * brief, at-a-glance, summary of a concept that may require
@@ -36,7 +30,7 @@ var NonLinearReading = /*#__PURE__*/React__default.forwardRef(function (_ref, re
     className = _ref.className,
     definition = _ref.definition,
     _ref$theme = _ref.theme,
-    theme = _ref$theme === void 0 ? defaults.theme : _ref$theme,
+    theme = _ref$theme === void 0 ? 'light' : _ref$theme,
     rest = _objectWithoutProperties(_ref, _excluded);
   var _useState = useState(false),
     _useState2 = _slicedToArray(_useState, 2),
@@ -73,6 +67,7 @@ NonLinearReading.propTypes = {
   /**
    * The keyword of the component appears as a pill.
    */
+
   children: PropTypes.node.isRequired,
   /**
    * Provide an optional class to be applied to the containing node.

package/es/components/SearchBar/SearchBar.d.ts

@@ -1,5 +1,53 @@
 /**
- * Search bar with input field and search button
+ * Copyright IBM Corp. 2024, 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.
  */
-export let SearchBar: React.ForwardRefExoticComponent<React.RefAttributes<any>>;
-import React from 'react';
+import React, { PropsWithChildren } from 'react';
+type Scopes = string[] | object[];
+interface SearchBarProps extends PropsWithChildren {
+    /** @type {string} Optional additional class name. */
+    className?: string;
+    /** @type {string} The label text for the search text input. */
+    clearButtonLabelText: string;
+    /**
+     * Whether or not the scopes MultiSelect label is visually hidden.
+     */
+    hideScopesLabel?: boolean;
+    /** @type {string} The label text for the search text input. */
+    labelText?: string;
+    /** @type {Function} Function handler for when the user changes their query search. */
+    onChange?: (event: any) => void;
+    /** @type {Function} Function handler for when the user submits a search. */
+    onSubmit?: (event: any) => void;
+    /** @type {string} Placeholder text to be displayed in the search input. */
+    placeHolderText: string;
+    /** @type {Function} Function to get the text for each scope to display in dropdown. */
+    scopeToString?: () => void;
+    /** @type {Array<any>} Array of allowed search scopes. */
+    scopes?: Scopes;
+    /** @type {string} The name text for the search scope type. */
+    scopesTypeLabel?: typeof conditionalScopePropValidator;
+    /** @type {Array<any> Array of initially selected search scopes. */
+    selectedScopes?: Scopes;
+    /**
+     * Optional custom sorting algorithm for an array of scope items.
+     * By default, scope items are sorted in ascending alphabetical order,
+     * with "selected" items moved to the start of the scope items array.
+     */
+    sortItems?: () => void;
+    /** @type {string} The label text for the search submit button. */
+    submitLabel: string;
+    /**
+     * Provide accessible label text for the scopes MultiSelect.
+     */
+    titleText?: string;
+    /** @type {func} Callback function for translating MultiSelect's child ListBoxMenuIcon SVG title. */
+    translateWithId?: () => void;
+    /** @type {string} Search query value. */
+    value?: string;
+}
+export declare let SearchBar: React.ForwardRefExoticComponent<SearchBarProps & React.RefAttributes<HTMLFormElement>>;
+declare const conditionalScopePropValidator: (props: any, propName: any, componentName: any, ...rest: any[]) => Error | null;
+export {};

package/es/components/SearchBar/SearchBar.js

@@ -29,10 +29,6 @@ var defaults = {
   selectedScopes: [],
   hideScopesLabel: true
 };
-
-/**
- * Search bar with input field and search button
- */
 var SearchBar = /*#__PURE__*/React__default.forwardRef(function (_ref, ref) {
   var className = _ref.className,
     clearButtonLabelText = _ref.clearButtonLabelText,
@@ -45,11 +41,11 @@ var SearchBar = /*#__PURE__*/React__default.forwardRef(function (_ref, ref) {
     onSubmit = _ref$onSubmit === void 0 ? defaults.onSubmit : _ref$onSubmit,
     placeHolderText = _ref.placeHolderText,
     _ref$scopes = _ref.scopes,
-    scopes = _ref$scopes === void 0 ? defaults.scopes : _ref$scopes,
+    scopes = _ref$scopes === void 0 ? [] : _ref$scopes,
     scopesTypeLabel = _ref.scopesTypeLabel,
     scopeToString = _ref.scopeToString,
     _ref$selectedScopes = _ref.selectedScopes,
-    selectedScopes = _ref$selectedScopes === void 0 ? defaults.selectedScopes : _ref$selectedScopes,
+    selectedScopes = _ref$selectedScopes === void 0 ? [] : _ref$selectedScopes,
     sortItems = _ref.sortItems,
     submitLabel = _ref.submitLabel,
     translateWithId = _ref.translateWithId,
@@ -162,6 +158,7 @@ var conditionalScopePropValidator = function conditionalScopePropValidator(props
   if (props.scopes && props.scopes.length > 0 && !props[propName]) {
     return new Error("Required `".concat(propName, "` when `scopes` prop type is supplied to `").concat(componentName, "`. Validation failed."));
   }
+  /**@ts-ignore */
   for (var _len = arguments.length, rest = new Array(_len > 3 ? _len - 3 : 0), _key = 3; _key < _len; _key++) {
     rest[_key - 3] = arguments[_key];
   }
@@ -191,11 +188,13 @@ SearchBar.propTypes = {
   /** @type {Function} Function to get the text for each scope to display in dropdown. */
   scopeToString: PropTypes.func,
   /** @type {Array<any>} Array of allowed search scopes. */
+  /**@ts-ignore */
   scopes: PropTypes.arrayOf(PropTypes.oneOfType([PropTypes.string, PropTypes.object])),
   /** @type {string} The name text for the search scope type. */
   // eslint-disable-next-line react/require-default-props
   scopesTypeLabel: conditionalScopePropValidator,
   /** @type {Array<any> Array of initially selected search scopes. */
+  /**@ts-ignore */
   selectedScopes: PropTypes.arrayOf(PropTypes.oneOfType([PropTypes.string, PropTypes.object])),
   /**
    * Optional custom sorting algorithm for an array of scope items.

package/es/components/SidePanel/SidePanel.js

@@ -24,7 +24,7 @@ import { usePreviousValue } from '../../global/js/hooks/usePreviousValue.js';
 import { useFocus } from '../../global/js/hooks/useFocus.js';
 
 var _excluded = ["actionToolbarButtons", "actions", "animateTitle", "children", "className", "closeIconDescription", "condensedActions", "currentStep", "id", "includeOverlay", "labelText", "navigationBackIconDescription", "onNavigationBack", "onRequestClose", "onUnmount", "open", "placement", "preventCloseOnClickOutside", "selectorPageContent", "selectorPrimaryFocus", "size", "slideIn", "slug", "subtitle", "title"],
-  _excluded2 = ["label", "kind", "icon", "tooltipPosition", "tooltipAlignment", "leading", "disabled", "className", "onClick"];
+  _excluded2 = ["label", "kind", "hasIconOnly", "icon", "renderIcon", "tooltipPosition", "tooltipAlignment", "leading", "disabled", "className", "onClick"];
 var blockClass = "".concat(pkg.prefix, "--side-panel");
 var componentName = 'SidePanel';
 // `any` is a work around until ActionSet is migrated to TS
@@ -387,7 +387,10 @@ var SidePanel = /*#__PURE__*/React__default.forwardRef(function (_ref, ref) {
     }, actionToolbarButtons.map(function (_ref4) {
       var label = _ref4.label,
         kind = _ref4.kind,
+        _ref4$hasIconOnly = _ref4.hasIconOnly,
+        hasIconOnly = _ref4$hasIconOnly === void 0 ? false : _ref4$hasIconOnly,
         icon = _ref4.icon,
+        renderIcon = _ref4.renderIcon,
         tooltipPosition = _ref4.tooltipPosition,
         tooltipAlignment = _ref4.tooltipAlignment,
         leading = _ref4.leading,
@@ -399,11 +402,13 @@ var SidePanel = /*#__PURE__*/React__default.forwardRef(function (_ref, ref) {
         key: label,
         kind: kind || 'ghost',
         size: "sm",
-        renderIcon: icon,
-        iconDescription: label,
+        renderIcon: renderIcon || icon,
+        iconDescription: label
+      }, hasIconOnly && {
         tooltipPosition: tooltipPosition || 'bottom',
-        tooltipAlignment: tooltipAlignment || 'start',
-        hasIconOnly: !leading,
+        tooltipAlignment: tooltipAlignment || 'start'
+      }, {
+        hasIconOnly: hasIconOnly,
         disabled: disabled,
         className: cx(["".concat(blockClass, "__action-toolbar-button"), className, _defineProperty({}, "".concat(blockClass, "__action-toolbar-leading-button"), leading)]),
         onClick: onClick

package/es/components/TruncatedList/TruncatedList.d.ts

@@ -1,7 +1,52 @@
+/**
+ * Copyright IBM Corp. 2024, 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, { PropsWithChildren, ReactNode } from 'react';
+interface TruncatedListProps extends PropsWithChildren {
+    as?: React.ElementType | string;
+    /**
+     * Optional class name for expand/collapse button.
+     */
+    buttonClassName?: string;
+    /**
+     * The contents of the TruncatedList.
+     */
+    children: ReactNode;
+    /**
+     * Provide an optional class to be applied to the containing node.
+     */
+    className?: string;
+    /**
+     * Number of items to render and display when the list is truncated and collapsed.
+     * Scrolling is not enabled when collapsed. The smallest number is 1.
+     */
+    collapsedItemsLimit?: number;
+    /**
+     * Maximum number of items to show when the list is expanded. All
+     * items are rendered when the list is expanded. Scrolling is enabled
+     * if there are more items to display than this number.
+     */
+    expandedItemsLimit?: number;
+    /**
+     * Optional callback reports the collapsed state of the list.
+     */
+    onClick?: (value: any) => void;
+    /**
+     * Text label for when the list is expanded.
+     */
+    viewLessLabel?: string;
+    /**
+     * Callback function for building the label when the list is collapsed.
+     */
+    viewMoreLabel?: (value: any) => void;
+}
 /**
  * The `TruncatedList` allows consumers to control how many items are
  * revealed to the user while giving the user the ability to expand
  * and see the entire list.
  */
-export let TruncatedList: React.ForwardRefExoticComponent<React.RefAttributes<any>>;
-import React from 'react';
+export declare let TruncatedList: React.ForwardRefExoticComponent<TruncatedListProps & React.RefAttributes<HTMLDivElement>>;
+export {};

package/es/components/TruncatedList/TruncatedList.js

@@ -28,7 +28,6 @@ var defaults = {
     return "View more (".concat(value, ")");
   }
 };
-
 /**
  * The `TruncatedList` allows consumers to control how many items are
  * revealed to the user while giving the user the ability to expand
@@ -84,13 +83,15 @@ var TruncatedList = /*#__PURE__*/React__default.forwardRef(function (_ref, ref)
   // list is both collapsed and expanded.
   useEffect(function () {
     if (listRef && childrenArray.length > 0) {
+      var _listRef$current;
       var numItemsToShow = isCollapsed ? minItems : maxItems;
-      var items = listRef.current.childNodes;
+      var items = (_listRef$current = listRef.current) === null || _listRef$current === void 0 ? void 0 : _listRef$current.childNodes;
       var _listHeight = 0;
       for (var index = 0; index < numItemsToShow; index++) {
-        if (items[index]) {
+        if (items && items[index]) {
           var _window;
-          var height = ((_window = window) === null || _window === void 0 || (_window = _window.getComputedStyle(items[index])) === null || _window === void 0 ? void 0 : _window.height) || 16;
+          var itemElement = items[index];
+          var height = ((_window = window) === null || _window === void 0 || (_window = _window.getComputedStyle(itemElement)) === null || _window === void 0 ? void 0 : _window.height) || '16';
           _listHeight += parseInt(height);
         }
       }

package/lib/components/Coachmark/utils/enums.d.ts

@@ -1,23 +1,37 @@
-export namespace BEACON_KIND {
-    let DEFAULT: string;
-}
-export namespace COACHMARK_OVERLAY_KIND {
-    let TOOLTIP: string;
-    let FLOATING: string;
-    let FIXED: string;
-    let STACKED: string;
-}
-export namespace COACHMARK_ALIGNMENT {
-    let BOTTOM: string;
-    let BOTTOM_LEFT: string;
-    let BOTTOM_RIGHT: string;
-    let LEFT: string;
-    let LEFT_TOP: string;
-    let LEFT_BOTTOM: string;
-    let RIGHT: string;
-    let RIGHT_TOP: string;
-    let RIGHT_BOTTOM: string;
-    let TOP: string;
-    let TOP_LEFT: string;
-    let TOP_RIGHT: string;
+/**
+ * Reserved for future expansion, i.e. "RING".
+ */
+export declare enum BEACON_KIND {
+    DEFAULT = "default"
 }
+/**
+ * Describes the style and behavior of a Coachmark.
+ * @param TOOLTIP includes a caret pointing to the animated beacon.
+ * @param FLOATING includes a drag handle across the top.
+ * @param FIXED is fixed to the bottom-right of the viewport.
+ * @param STACKED is fixed to the bottom-right of the viewport, includes links to show more, stackable Coachmarks if included.
+ */
+export declare const COACHMARK_OVERLAY_KIND: {
+    TOOLTIP: string;
+    FLOATING: string;
+    FIXED: string;
+    STACKED: string;
+};
+/**
+ * Where to render the Coachmark relative to its target.
+ * Applies only to Floating and Tooltip Coachmarks.
+ */
+export declare const COACHMARK_ALIGNMENT: {
+    BOTTOM: string;
+    BOTTOM_LEFT: string;
+    BOTTOM_RIGHT: string;
+    LEFT: string;
+    LEFT_TOP: string;
+    LEFT_BOTTOM: string;
+    RIGHT: string;
+    RIGHT_TOP: string;
+    RIGHT_BOTTOM: string;
+    TOP: string;
+    TOP_LEFT: string;
+    TOP_RIGHT: string;
+};