@carbon/react 1.54.0 → 1.55.0

package/es/components/UIShell/HeaderMenu.d.ts

@@ -0,0 +1,219 @@
+/**
+ * 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 PropTypes from 'prop-types';
+/**
+ * `HeaderMenu` is used to render submenu's in the `Header`. Most often children
+ * will be a `HeaderMenuItem`. It handles certain keyboard events to help
+ * with managing focus. It also passes along refs to each child so that it can
+ * help manage focus state of its children.
+ */
+interface HeaderMenuProps {
+    /**
+     * Required props for the accessibility label of the menu
+     */
+    'aria-label'?: string;
+    'aria-labelledby'?: string;
+    /**
+     * Optionally provide a custom class to apply to the underlying `<li>` node
+     */
+    className?: string;
+    /**
+     * Provide a custom ref handler for the menu button
+     */
+    focusRef?: React.Ref<any>;
+    /**
+     * Applies selected styles to the item if a user sets this to true and `aria-current !== 'page'`.
+     */
+    isActive?: boolean;
+    /**
+     * Applies selected styles to the item if a user sets this to true and `aria-current !== 'page'`.
+     * @deprecated Please use `isActive` instead. This will be removed in the next major release.
+     */
+    isCurrentPage?: boolean;
+    /**
+     * Provide a label for the link text
+     */
+    menuLinkName: string;
+    /**
+     * Optionally provide an onBlur handler that is called when the underlying
+     * button fires it's onblur event
+     */
+    onBlur?: (event: React.FocusEvent<HTMLLIElement>) => void;
+    /**
+     * Optionally provide an onClick handler that is called when the underlying
+     * button fires it's onclick event
+     */
+    onClick?: (event: React.MouseEvent<HTMLLIElement, MouseEvent>) => void;
+    /**
+     * Optionally provide an onKeyDown handler that is called when the underlying
+     * button fires it's onkeydown event
+     */
+    onKeyDown?: (event: React.KeyboardEvent<HTMLLIElement>) => void;
+    /**
+     * Optional component to render instead of string
+     */
+    renderMenuContent?: () => JSX.Element;
+    /**
+     * Optionally provide a tabIndex for the underlying menu button
+     */
+    tabIndex?: number;
+    /**
+     * The children should be a series of `HeaderMenuItem` components.
+     */
+    children?: React.ReactNode;
+}
+interface HeaderMenuState {
+    expanded: boolean;
+    selectedIndex: number | null;
+}
+declare class HeaderMenu extends React.Component<HeaderMenuProps, HeaderMenuState> {
+    static propTypes: {
+        /**
+         * Optionally provide a custom class to apply to the underlying `<li>` node
+         */
+        className: PropTypes.Requireable<string>;
+        /**
+         * Provide a custom ref handler for the menu button
+         */
+        focusRef: PropTypes.Requireable<(...args: any[]) => any>;
+        /**
+         * Applies selected styles to the item if a user sets this to true and `aria-current !== 'page'`.
+         */
+        isActive: PropTypes.Requireable<boolean>;
+        /**
+         * Applies selected styles to the item if a user sets this to true and `aria-current !== 'page'`.
+         * @deprecated Please use `isActive` instead. This will be removed in the next major release.
+         */
+        isCurrentPage: (props: any, propName: any, componentName: any, ...rest: any[]) => any;
+        /**
+         * Provide a label for the link text
+         */
+        menuLinkName: PropTypes.Validator<string>;
+        /**
+         * Optionally provide an onBlur handler that is called when the underlying
+         * button fires it's onblur event
+         */
+        onBlur: PropTypes.Requireable<(...args: any[]) => any>;
+        /**
+         * Optionally provide an onClick handler that is called when the underlying
+         * button fires it's onclick event
+         */
+        onClick: PropTypes.Requireable<(...args: any[]) => any>;
+        /**
+         * Optionally provide an onKeyDown handler that is called when the underlying
+         * button fires it's onkeydown event
+         */
+        onKeyDown: PropTypes.Requireable<(...args: any[]) => any>;
+        /**
+         * Optional component to render instead of string
+         */
+        renderMenuContent: PropTypes.Requireable<(...args: any[]) => any>;
+        /**
+         * Optionally provide a tabIndex for the underlying menu button
+         */
+        tabIndex: PropTypes.Requireable<number>;
+        0: string;
+        length: 1;
+        toString(): string;
+        toLocaleString(): string;
+        pop(): string | undefined;
+        push(...items: string[]): number;
+        concat(...items: ConcatArray<string>[]): string[];
+        concat(...items: (string | ConcatArray<string>)[]): string[];
+        join(separator?: string | undefined): string;
+        reverse(): string[];
+        shift(): string | undefined;
+        slice(start?: number | undefined, end?: number | undefined): string[];
+        sort(compareFn?: ((a: string, b: string) => number) | undefined): [key: string];
+        splice(start: number, deleteCount?: number | undefined): string[];
+        splice(start: number, deleteCount: number, ...items: string[]): string[];
+        unshift(...items: string[]): number;
+        indexOf(searchElement: string, fromIndex?: number | undefined): number;
+        lastIndexOf(searchElement: string, fromIndex?: number | undefined): number;
+        every<S extends string>(predicate: (value: string, index: number, array: string[]) => value is S, thisArg?: any): this is S[];
+        every(predicate: (value: string, index: number, array: string[]) => unknown, thisArg?: any): boolean;
+        some(predicate: (value: string, index: number, array: string[]) => unknown, thisArg?: any): boolean;
+        forEach(callbackfn: (value: string, index: number, array: string[]) => void, thisArg?: any): void;
+        map<U>(callbackfn: (value: string, index: number, array: string[]) => U, thisArg?: any): U[];
+        filter<S_1 extends string>(predicate: (value: string, index: number, array: string[]) => value is S_1, thisArg?: any): S_1[];
+        filter(predicate: (value: string, index: number, array: string[]) => unknown, thisArg?: any): string[];
+        reduce(callbackfn: (previousValue: string, currentValue: string, currentIndex: number, array: string[]) => string): string;
+        reduce(callbackfn: (previousValue: string, currentValue: string, currentIndex: number, array: string[]) => string, initialValue: string): string;
+        reduce<U_1>(callbackfn: (previousValue: U_1, currentValue: string, currentIndex: number, array: string[]) => U_1, initialValue: U_1): U_1;
+        reduceRight(callbackfn: (previousValue: string, currentValue: string, currentIndex: number, array: string[]) => string): string;
+        reduceRight(callbackfn: (previousValue: string, currentValue: string, currentIndex: number, array: string[]) => string, initialValue: string): string;
+        reduceRight<U_2>(callbackfn: (previousValue: U_2, currentValue: string, currentIndex: number, array: string[]) => U_2, initialValue: U_2): U_2;
+        find<S_2 extends string>(predicate: (this: void, value: string, index: number, obj: string[]) => value is S_2, thisArg?: any): S_2 | undefined;
+        find(predicate: (value: string, index: number, obj: string[]) => unknown, thisArg?: any): string | undefined;
+        findIndex(predicate: (value: string, index: number, obj: string[]) => unknown, thisArg?: any): number;
+        fill(value: string, start?: number | undefined, end?: number | undefined): [key: string];
+        copyWithin(target: number, start: number, end?: number | undefined): [key: string];
+        entries(): IterableIterator<[number, string]>;
+        keys(): IterableIterator<number>;
+        values(): IterableIterator<string>;
+        includes(searchElement: string, fromIndex?: number | undefined): boolean;
+        flatMap<U_3, This = undefined>(callback: (this: This, value: string, index: number, array: string[]) => U_3 | readonly U_3[], thisArg?: This | undefined): U_3[];
+        flat<A, D extends number = 1>(this: A, depth?: D | undefined): FlatArray<A, D>[];
+        at(index: number): string | undefined;
+        [Symbol.iterator](): IterableIterator<string>;
+        [Symbol.unscopables](): {
+            copyWithin: boolean;
+            entries: boolean;
+            fill: boolean;
+            find: boolean;
+            findIndex: boolean;
+            keys: boolean;
+            values: boolean;
+        };
+    };
+    static contextType: React.Context<string>;
+    _subMenus: React.RefObject<HTMLUListElement>;
+    private items;
+    private menuButtonRef;
+    constructor(props: any);
+    /**
+     * Toggle the expanded state of the menu on click.
+     */
+    handleOnClick: (e: any) => void;
+    /**
+     * Keyboard event handler for the entire menu.
+     */
+    handleOnKeyDown: (event: any) => void;
+    /**
+     * Handle our blur event from our underlying menuitems. Will mostly be used
+     * for closing our menu in response to a user clicking off or tabbing out of
+     * the menu or menubar.
+     */
+    handleOnBlur: (event: any) => void;
+    /**
+     * ref handler for our menu button. If we are supplied a `focusRef` prop, we also
+     * forward along the node.
+     *
+     * This is useful when this component is a child in a
+     * menu or menubar as it will allow the parent to explicitly focus the menu
+     * button node when that child should receive focus.
+     */
+    handleMenuButtonRef: (node: any) => void;
+    /**
+     * Handles individual menuitem refs. We assign them to a class instance
+     * property so that we can properly manage focus of our children.
+     */
+    handleItemRef: (index: any) => (node: any) => void;
+    handleMenuClose: (event: any) => void;
+    render(): import("react/jsx-runtime").JSX.Element;
+    /**
+     * We capture the `ref` for each child inside of `this.items` to properly
+     * manage focus. In addition to this focus management, all items receive a
+     * `tabIndex: -1` so the user won't hit a large number of items in their tab
+     * sequence when they might not want to go through all the items.
+     */
+    _renderMenuItem: (item: React.ReactNode, index: number) => React.ReactElement<any, string | React.JSXElementConstructor<any>> | undefined;
+}
+declare const HeaderMenuForwardRef: React.ForwardRefExoticComponent<React.RefAttributes<unknown>>;
+export { HeaderMenu };
+export default HeaderMenuForwardRef;

package/es/components/UIShell/HeaderMenu.js

@@ -23,10 +23,13 @@ import { Enter, Space, Escape } from '../../internal/keyboard/keys.js';
  * with managing focus. It also passes along refs to each child so that it can
  * help manage focus state of its children.
  */
+
 class HeaderMenu extends React__default.Component {
   constructor(props) {
     super(props);
     _defineProperty(this, "_subMenus", /*#__PURE__*/React__default.createRef());
+    _defineProperty(this, "items", []);
+    _defineProperty(this, "menuButtonRef", null);
     /**
      * Toggle the expanded state of the menu on click.
      */
@@ -81,8 +84,12 @@ class HeaderMenu extends React__default.Component {
      * button node when that child should receive focus.
      */
     _defineProperty(this, "handleMenuButtonRef", node => {
-      if (this.props.focusRef) {
-        this.props.focusRef(node);
+      const {
+        focusRef
+      } = this.props;
+      // Check if focusRef is a function before calling it
+      if (typeof focusRef === 'function') {
+        focusRef(node);
       }
       this.menuButtonRef = node;
     });
@@ -104,7 +111,9 @@ class HeaderMenu extends React__default.Component {
         }));
 
         // Return focus to menu button when the user hits ESC.
-        this.menuButtonRef.focus();
+        if (this.menuButtonRef !== null) {
+          this.menuButtonRef.focus();
+        }
         return;
       }
     });
@@ -141,23 +150,25 @@ class HeaderMenu extends React__default.Component {
       children,
       renderMenuContent: MenuContent,
       menuLinkName,
+      // eslint-disable-next-line @typescript-eslint/no-unused-vars
       focusRef,
-      // eslint-disable-line no-unused-vars
       onBlur,
       onClick,
       onKeyDown,
       ...rest
     } = this.props;
-    const hasActiveDescendant = childrenArg => React__default.Children.toArray(childrenArg).some(child => child.props && (child.props.isActive || child.props.isCurrentPage || child.props.children instanceof Array && hasActiveDescendant(child.props.children)));
+    const hasActiveDescendant = childrenArg => React__default.Children.toArray(childrenArg).some(child => /*#__PURE__*/React__default.isValidElement(child) && (
+    // This is the type guard
+    child.props.isActive || child.props.isCurrentPage || Array.isArray(child.props.children) && hasActiveDescendant(child.props.children)));
     const accessibilityLabel = {
       'aria-label': ariaLabel,
       'aria-labelledby': ariaLabelledBy
     };
     const itemClassName = cx({
       [`${prefix}--header__submenu`]: true,
-      [customClassName]: !!customClassName
+      [`${customClassName}`]: !!customClassName
     });
-    let isActivePage = isActive ? isActive : isCurrentPage;
+    const isActivePage = isActive ? isActive : isCurrentPage;
     const linkClassName = cx({
       [`${prefix}--header__menu-item`]: true,
       [`${prefix}--header__menu-title`]: true,
@@ -248,11 +259,12 @@ _defineProperty(HeaderMenu, "propTypes", {
 });
 _defineProperty(HeaderMenu, "contextType", PrefixContext);
 const HeaderMenuForwardRef = /*#__PURE__*/React__default.forwardRef((props, ref) => {
-  return /*#__PURE__*/React__default.createElement(HeaderMenu, _extends({}, props, {
+  return /*#__PURE__*/React__default.createElement(HeaderMenu, _extends({
+    menuLinkName: "link"
+  }, props, {
     focusRef: ref
   }));
 });
 HeaderMenuForwardRef.displayName = 'HeaderMenu';
-var HeaderMenuForwardRef$1 = HeaderMenuForwardRef;
 
-export { HeaderMenu, HeaderMenuForwardRef$1 as default };
+export { HeaderMenu, HeaderMenuForwardRef as default };

package/es/components/UIShell/SideNavMenu.js

@@ -28,9 +28,12 @@ const SideNavMenu = /*#__PURE__*/React__default.forwardRef(function SideNavMenu(
     tabIndex,
     title
   } = _ref;
-  const isRail = useContext(SideNavContext);
+  const {
+    isRail
+  } = useContext(SideNavContext);
   const prefix = usePrefix();
   const [isExpanded, setIsExpanded] = useState(defaultExpanded);
+  const [prevExpanded, setPrevExpanded] = useState(defaultExpanded);
   const className = cx({
     [`${prefix}--side-nav__item`]: true,
     [`${prefix}--side-nav__item--active`]: isActive || hasActiveDescendant(children) && !isExpanded,
@@ -38,6 +41,13 @@ const SideNavMenu = /*#__PURE__*/React__default.forwardRef(function SideNavMenu(
     [`${prefix}--side-nav__item--large`]: large,
     [customClassName]: !!customClassName
   });
+  if (!isSideNavExpanded && isExpanded && isRail) {
+    setIsExpanded(false);
+    setPrevExpanded(true);
+  } else if (isSideNavExpanded && prevExpanded && isRail) {
+    setIsExpanded(true);
+    setPrevExpanded(false);
+  }
   return (
     /*#__PURE__*/
     // eslint-disable-next-line jsx-a11y/no-noninteractive-element-interactions

package/es/components/UIShell/SideNavMenuItem.d.ts

@@ -20,6 +20,10 @@ interface SideNavMenuItemProps extends HTMLAttributes<HTMLElement> {
      * `aria-current="page"`, as well.
      */
     isActive?: boolean;
+    /**
+     * Optionally provide an href for the underlying li`
+     */
+    href?: string;
 }
 declare const SideNavMenuItem: React.ForwardRefExoticComponent<SideNavMenuItemProps & React.RefAttributes<HTMLElement>>;
 export default SideNavMenuItem;

package/es/components/UIShell/SideNavMenuItem.js

@@ -19,6 +19,7 @@ const SideNavMenuItem = /*#__PURE__*/React__default.forwardRef(function SideNavM
     children,
     className: customClassName,
     isActive,
+    href,
     ...rest
   } = props;
   const className = cx(`${prefix}--side-nav__menu-item`, customClassName);
@@ -28,7 +29,9 @@ const SideNavMenuItem = /*#__PURE__*/React__default.forwardRef(function SideNavM
   });
   return /*#__PURE__*/React__default.createElement("li", {
     className: className
-  }, /*#__PURE__*/React__default.createElement(Link, _extends({}, rest, {
+  }, /*#__PURE__*/React__default.createElement(Link, _extends({
+    href: href
+  }, rest, {
     className: linkClassName,
     ref: ref
   }), /*#__PURE__*/React__default.createElement(SideNavLinkText, null, children)));
@@ -43,6 +46,10 @@ SideNavMenuItem.propTypes = {
    * Provide an optional class to be applied to the containing node
    */
   className: PropTypes.string,
+  /**
+   * Optionally provide an href for the underlying li`
+   */
+  href: PropTypes.string,
   /**
    * Optionally specify whether the link is "active". An active link is one that
    * has an href that is the same as the current page. Can also pass in

package/es/components/UIShell/SwitcherItem.d.ts

@@ -39,6 +39,10 @@ interface BaseSwitcherItemProps {
      * Specify whether the panel is selected
      */
     isSelected?: boolean;
+    /**
+     * Optionally provide an href for the underlying li`
+     */
+    href?: string;
 }
 interface SwitcherItemWithAriaLabel extends BaseSwitcherItemProps {
     'aria-label': string;

package/es/components/UIShell/SwitcherItem.js

@@ -27,6 +27,7 @@ const SwitcherItem = /*#__PURE__*/forwardRef(function SwitcherItem(props, forwar
     index,
     handleSwitcherItemFocus,
     onKeyDown = () => {},
+    href,
     ...rest
   } = props;
   const prefix = usePrefix();
@@ -63,6 +64,7 @@ const SwitcherItem = /*#__PURE__*/forwardRef(function SwitcherItem(props, forwar
       setTabFocus(evt);
       onKeyDown(evt);
     },
+    href: href,
     ref: forwardRef
   }, rest, {
     className: linkClassName,
@@ -84,6 +86,10 @@ SwitcherItem.propTypes = {
    * event handlers
    */
   handleSwitcherItemFocus: PropTypes.func,
+  /**
+   * Optionally provide an href for the underlying li`
+   */
+  href: PropTypes.string,
   /**
    * Specify the index of the SwitcherItem
    */

package/es/index.js

@@ -19,6 +19,8 @@ export { default as ButtonSet } from './components/ButtonSet/ButtonSet.js';
 export { default as Checkbox } from './components/Checkbox/Checkbox.js';
 export { default as CheckboxSkeleton } from './components/Checkbox/Checkbox.Skeleton.js';
 export { ClassPrefix } from './components/ClassPrefix/index.js';
+export { default as CodeSnippet } from './components/CodeSnippet/CodeSnippet.js';
+export { default as CodeSnippetSkeleton } from './components/CodeSnippet/CodeSnippet.Skeleton.js';
 export { default as ComboBox } from './components/ComboBox/ComboBox.js';
 export { ComboButton } from './components/ComboButton/index.js';
 export { default as ComposedModal, ModalBody } from './components/ComposedModal/ComposedModal.js';
@@ -105,6 +107,9 @@ export { IconTab, Tab, TabList, TabPanel, TabPanels, Tabs } from './components/T
 export { default as TabContent } from './components/TabContent/TabContent.js';
 export { default as TabsSkeleton } from './components/Tabs/Tabs.Skeleton.js';
 export { default as Tag } from './components/Tag/Tag.js';
+export { default as DismissibleTag } from './components/Tag/DismissibleTag.js';
+export { default as OperationalTag } from './components/Tag/OperationalTag.js';
+export { default as SelectableTag } from './components/Tag/SelectableTag.js';
 export { default as TagSkeleton } from './components/Tag/Tag.Skeleton.js';
 export { default as TextArea } from './components/TextArea/TextArea.js';
 export { default as TextAreaSkeleton } from './components/TextArea/TextArea.Skeleton.js';
@@ -173,8 +178,6 @@ export { default as unstable__FluidTextInputSkeleton } from './components/FluidT
 export { default as unstable_PageSelector } from './components/Pagination/experimental/PageSelector.js';
 export { default as unstable_Pagination } from './components/Pagination/experimental/Pagination.js';
 export { default as CheckboxGroup } from './components/CheckboxGroup/CheckboxGroup.js';
-export { default as CodeSnippetSkeleton } from './components/CodeSnippet/CodeSnippet.Skeleton.js';
-export { default as CodeSnippet } from './components/CodeSnippet/CodeSnippet.js';
 export { default as ContainedListItem } from './components/ContainedList/ContainedListItem/ContainedListItem.js';
 export { default as ContainedList } from './components/ContainedList/ContainedList.js';
 export { default as useContextMenu } from './components/ContextMenu/useContextMenu.js';

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

@@ -0,0 +1,37 @@
+/**
+ * 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 PropTypes from 'prop-types';
+import React from 'react';
+export interface CodeSnippetSkeletonProps extends React.HTMLAttributes<Omit<HTMLDivElement, 'children'>> {
+    /**
+     * Specify an optional className to be applied to the container node
+     */
+    className?: string;
+    /**
+     * The type of the code snippet, including single or multi
+     */
+    type?: 'single' | 'multi' | undefined;
+}
+declare function CodeSnippetSkeleton({ className: containerClassName, type, ...rest }: {
+    [x: string]: any;
+    className: any;
+    type?: string | undefined;
+}): import("react/jsx-runtime").JSX.Element | undefined;
+declare namespace CodeSnippetSkeleton {
+    var propTypes: {
+        /**
+         * Specify an optional className to be applied to the container node
+         */
+        className: PropTypes.Requireable<string>;
+        /**
+         * The type of the code snippet, including single or multi
+         */
+        type: PropTypes.Requireable<string>;
+    };
+}
+export default CodeSnippetSkeleton;
+export { CodeSnippetSkeleton };

package/lib/components/CodeSnippet/CodeSnippet.d.ts

@@ -0,0 +1,196 @@
+/**
+ * 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 PropTypes from 'prop-types';
+import { PropsWithChildren } from 'react';
+export interface CodeSnippetProps {
+    /**
+     * Specify how the trigger should align with the tooltip
+     */
+    align?: 'top' | 'top-left' | 'top-right' | 'bottom' | 'bottom-left' | 'bottom-right' | 'left' | 'right';
+    /**
+     * Specify a label to be read by screen readers on the containing textbox
+     * node
+     */
+    ['aria-label']?: string;
+    /**
+     * Deprecated, please use `aria-label` instead.
+     * Specify a label to be read by screen readers on the containing textbox
+     * node
+     */
+    ariaLabel?: string;
+    /**
+     * Specify an optional className to be applied to the container node
+     */
+    className?: string;
+    /**
+     * Specify the description for the Copy Button
+     */
+    copyButtonDescription?: string;
+    /**
+     * Optional text to copy. If not specified, the `children` node's `innerText`
+     * will be used as the copy value.
+     */
+    copyText?: string;
+    /**
+     * Specify whether or not the CodeSnippet should be disabled
+     */
+    disabled?: boolean;
+    /**
+     * Specify the string displayed when the snippet is copied
+     */
+    feedback?: string;
+    /**
+     * Specify the time it takes for the feedback message to timeout
+     */
+    feedbackTimeout?: number;
+    /**
+     * Specify whether or not a copy button should be used/rendered.
+     */
+    hideCopyButton?: boolean;
+    /**
+     * Specify whether you are using the light variant of the Code Snippet,
+     * typically used for inline snippet to display an alternate color
+     */
+    light?: boolean;
+    /**
+     * Specify the maximum number of rows to be shown when in collapsed view
+     */
+    maxCollapsedNumberOfRows?: number;
+    /**
+     * Specify the maximum number of rows to be shown when in expanded view
+     */
+    maxExpandedNumberOfRows?: number;
+    /**
+     * Specify the minimum number of rows to be shown when in collapsed view
+     */
+    minCollapsedNumberOfRows?: number;
+    /**
+     * Specify the minimum number of rows to be shown when in expanded view
+     */
+    minExpandedNumberOfRows?: number;
+    /**
+     * An optional handler to listen to the `onClick` even fired by the Copy
+     * Button
+     */
+    onClick?: (e: MouseEvent) => void;
+    /**
+     * Specify a string that is displayed when the Code Snippet has been
+     * interacted with to show more lines
+     */
+    showLessText?: string;
+    /**
+     * Specify a string that is displayed when the Code Snippet text is more
+     * than 15 lines
+     */
+    showMoreText?: string;
+    /**
+     * Provide the type of Code Snippet
+     */
+    type?: 'single' | 'inline' | 'multi';
+    /**
+     * Specify whether or not to wrap the text.
+     */
+    wrapText?: boolean;
+}
+declare function CodeSnippet({ align, className, type, children, disabled, feedback, feedbackTimeout, onClick, ['aria-label']: ariaLabel, ariaLabel: deprecatedAriaLabel, copyText, copyButtonDescription, light, showMoreText, showLessText, hideCopyButton, wrapText, maxCollapsedNumberOfRows, maxExpandedNumberOfRows, minCollapsedNumberOfRows, minExpandedNumberOfRows, ...rest }: PropsWithChildren<CodeSnippetProps>): import("react/jsx-runtime").JSX.Element;
+declare namespace CodeSnippet {
+    var propTypes: {
+        /**
+         * Specify how the trigger should align with the tooltip
+         */
+        align: PropTypes.Requireable<string>;
+        /**
+         * Specify a label to be read by screen readers on the containing textbox
+         * node
+         */
+        "aria-label": PropTypes.Requireable<string>;
+        /**
+         * Deprecated, please use `aria-label` instead.
+         * Specify a label to be read by screen readers on the containing textbox
+         * node
+         */
+        ariaLabel: (props: any, propName: any, componentName: any, ...rest: any[]) => any;
+        /**
+         * Provide the content of your CodeSnippet as a node or string
+         */
+        children: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+        /**
+         * Specify an optional className to be applied to the container node
+         */
+        className: PropTypes.Requireable<string>;
+        /**
+         * Specify the description for the Copy Button
+         */
+        copyButtonDescription: PropTypes.Requireable<string>;
+        /**
+         * Optional text to copy. If not specified, the `children` node's `innerText`
+         * will be used as the copy value.
+         */
+        copyText: PropTypes.Requireable<string>;
+        /**
+         * Specify whether or not the CodeSnippet should be disabled
+         */
+        disabled: PropTypes.Requireable<boolean>;
+        /**
+         * Specify the string displayed when the snippet is copied
+         */
+        feedback: PropTypes.Requireable<string>;
+        /**
+         * Specify the time it takes for the feedback message to timeout
+         */
+        feedbackTimeout: PropTypes.Requireable<number>;
+        /**
+         * Specify whether or not a copy button should be used/rendered.
+         */
+        hideCopyButton: PropTypes.Requireable<boolean>;
+        /**
+         * Specify whether you are using the light variant of the Code Snippet,
+         * typically used for inline snippet to display an alternate color
+         */
+        light: (props: any, propName: any, componentName: any, ...rest: any[]) => any;
+        /**
+         * Specify the maximum number of rows to be shown when in collapsed view
+         */
+        maxCollapsedNumberOfRows: PropTypes.Requireable<number>;
+        /**
+         * Specify the maximum number of rows to be shown when in expanded view
+         */
+        maxExpandedNumberOfRows: PropTypes.Requireable<number>;
+        /**
+         * Specify the minimum number of rows to be shown when in collapsed view
+         */
+        minCollapsedNumberOfRows: PropTypes.Requireable<number>;
+        /**
+         * Specify the minimum number of rows to be shown when in expanded view
+         */
+        minExpandedNumberOfRows: PropTypes.Requireable<number>;
+        /**
+         * An optional handler to listen to the `onClick` even fired by the Copy
+         * Button
+         */
+        onClick: PropTypes.Requireable<(...args: any[]) => any>;
+        /**
+         * Specify a string that is displayed when the Code Snippet has been
+         * interacted with to show more lines
+         */
+        showLessText: PropTypes.Requireable<string>;
+        /**
+         * Specify a string that is displayed when the Code Snippet text is more
+         * than 15 lines
+         */
+        showMoreText: PropTypes.Requireable<string>;
+        /**
+         * Provide the type of Code Snippet
+         */
+        type: PropTypes.Requireable<string>;
+        /**
+         * Specify whether or not to wrap the text.
+         */
+        wrapText: PropTypes.Requireable<boolean>;
+    };
+}
+export default CodeSnippet;