@splunk/react-ui 5.0.0 → 5.2.0

package/types/src/Divider/docs/examples/Appearance.d.ts

@@ -1,3 +1,7 @@
 import React from 'react';
+/**
+ * @name Appearance
+ * @description Divider with preset border colors. Dividers with appearance="weak" will not meet accessibility requirements to be perceivable. If the component should be perceivable, consider the other contrast compliant appearance values. Otherwise, apply the decorative prop.
+ */
 declare function Appearance(): React.JSX.Element;
 export default Appearance;

package/types/src/Divider/docs/examples/Basic.d.ts

@@ -1,3 +1,6 @@
 import React from 'react';
+/**
+ * @name Basic
+ */
 declare function Basic(): React.JSX.Element;
 export default Basic;

package/types/src/Divider/docs/examples/CustomStyle.d.ts

@@ -1,3 +1,7 @@
 import React from 'react';
+/**
+ * @name CustomStyle
+ * @description Divider with custom color.
+ */
 declare function CustomStyle(): React.JSX.Element;
 export default CustomStyle;

package/types/src/Divider/docs/examples/Decorative.d.ts

@@ -1,3 +1,7 @@
 import React from 'react';
+/**
+ * @name Decorative
+ * @description When the Divider does not have semantics, add the decorative prop.
+ */
 declare function Decorative(): React.JSX.Element;
 export default Decorative;

package/types/src/Divider/docs/examples/Vertical.d.ts

@@ -1,3 +1,6 @@
 import React from 'react';
+/**
+ * @name Vertical
+ */
 declare function Vertical(): React.JSX.Element;
 export default Vertical;

package/types/src/Dropdown/docs/examples/Basic.d.ts

@@ -1,3 +1,7 @@
 import React from 'react';
+/**
+ * @name Dropdown
+ * @description A Dropdown can contain any content. The content must constrain its own width.
+ */
 declare function Basic(): React.JSX.Element;
 export default Basic;

package/types/src/Dropdown/docs/examples/BasicMenu.d.ts

@@ -1,3 +1,6 @@
 import React from 'react';
+/**
+ * @name Dropdown menu
+ */
 declare function BasicMenu(): React.JSX.Element;
 export default BasicMenu;

package/types/src/Dropdown/docs/examples/ControlledDropdown.d.ts

@@ -1,3 +1,7 @@
 import React from 'react';
+/**
+ * @name Controlled
+ * @description By default, Dropdown handles its own state. If you want more granular control of the events that open or close a Dropdown, use it as a [controlled component](https://reactjs.org/docs/forms.html#controlled-components). When you use Dropdown as a controlled component, the parent component manages the state of the Dropdown. Note that either the Dropdown or its parent handles its state, never both. See the onRequestClose and onRequestOpen callbacks for hooks you can use to manage state. This examples uses toggleClick and offScreen. It receives but ignores all other close actions.
+ */
 declare function ControlledDropdown(): React.JSX.Element;
 export default ControlledDropdown;

package/types/src/Dropdown/docs/examples/Dialog.d.ts

@@ -1,3 +1,7 @@
 import React from 'react';
+/**
+ * @name Dropdown dialog
+ * @description By default, a Dropdown dialog box does not close on click. Set the closeReasons prop to ignore specific actions.
+ */
 declare function Dialog(): React.JSX.Element;
 export default Dialog;

package/types/src/Dropdown/docs/examples/ScrollContainer.d.ts

@@ -1,3 +1,7 @@
 import React from 'react';
+/**
+ * @name Customized scroll container
+ * @description By default, a Dropdown moves with the window scroll. Use Scroll Container Provider when you want a Dropdown to move within a different scroll container.
+ */
 declare function ScrollContainer(): React.JSX.Element;
 export default ScrollContainer;

package/types/src/Dropdown/docs/examples/ScrollingMenu.d.ts

@@ -1,3 +1,7 @@
 import React from 'react';
+/**
+ * @name Dropdown scrolling menu
+ * @description If a Menu contains many items, you can let the Menu scroll by setting the overflowY and maxHeight style prop.
+ */
 declare function ScrollingMenu(): React.JSX.Element;
 export default ScrollingMenu;

package/types/src/Dropdown/docs/examples/Submenu.d.ts

@@ -1,3 +1,6 @@
 import React from 'react';
+/**
+ * @name Dropdown submenu
+ */
 declare function Submenu(): React.JSX.Element;
 export default Submenu;

package/types/src/Dropdown/docs/examples/TooltipButtonToggle.d.ts

@@ -1,3 +1,7 @@
 import React from 'react';
+/**
+ * @name Toggle with tooltip
+ * @description When using a toggle with a Tooltip, use a React.forwardRef to pass the elementRef to the toggle.
+ */
 declare function TooltipButtonToggle(): React.JSX.Element;
 export default TooltipButtonToggle;

package/types/src/DualListbox/Option.d.ts

@@ -14,7 +14,7 @@ interface OptionPropsBase {
     label: string;
     /**
      * Parent list `name` associated to option.
-     * Used in intial state and controlled variants.
+     * Used in initial state and controlled variants.
      */
     listName?: string;
     /**

package/types/src/DualListbox/docs/examples/Basic.d.ts

@@ -1,3 +1,6 @@
 import React from 'react';
+/**
+ * @name Uncontrolled
+ */
 declare function Uncontrolled(): React.JSX.Element;
 export default Uncontrolled;

package/types/src/DualListbox/docs/examples/Controlled.d.ts

@@ -1,3 +1,6 @@
 import React from 'react';
+/**
+ * @name Controlled
+ */
 declare const Controlled: () => React.JSX.Element;
 export default Controlled;

package/types/src/DualListbox/docs/examples/Fill.d.ts

@@ -1,3 +1,7 @@
 import React from 'react';
+/**
+ * @name Fill
+ * @description Dynamic size example.
+ */
 declare function Fill(): React.JSX.Element;
 export default Fill;

package/types/src/File/docs/examples/CustomizedMessages.d.ts

@@ -1,2 +1,6 @@
 import React from 'react';
+/**
+ * @name Customized supports message and help
+ * @description The default supports message can be customized. A help message can also be added.
+ */
 export default function CustomizedMessages(): React.JSX.Element;

package/types/src/File/docs/examples/Disabled.d.ts

@@ -1,5 +1,8 @@
 import React, { Component } from 'react';
 import { FileRequestAddHandler } from '@splunk/react-ui/File';
+/**
+ * @name Disabled
+ */
 declare class Disabled extends Component<object, {
     filename?: string;
 }> {

package/types/src/File/docs/examples/DropAnywhere.d.ts

@@ -1,5 +1,9 @@
 import React, { Component } from 'react';
 import { FileRequestAddHandler } from '@splunk/react-ui/File';
+/**
+ * @name Drop anywhere
+ * @description The File.Item can be dropped anywhere on the page. This example must open in a modal since the drop zone is the entire page and affects the other Files on this page.
+ */
 declare class DropAnywhere extends Component<object, {
     filename?: string;
     open: boolean;

package/types/src/File/docs/examples/Error.d.ts

@@ -1,2 +1,6 @@
 import React from 'react';
+/**
+ * @name Error
+ * @description The File and File.Item have separate error states. Generally, they should not be used together. Either the File is in error (for example, required field), or an Item is in error (for example, incorrect file type).
+ */
 export default function FileErrors(): React.JSX.Element;

package/types/src/File/docs/examples/FullScreen.d.ts

@@ -1,3 +1,7 @@
 import React from 'react';
+/**
+ * @name Full screen
+ * @description This example must open in a modal. There can only be one File component on the page. Dropping a file anywhere will upload the file.
+ */
 declare function Fullscreen(): React.JSX.Element;
 export default Fullscreen;

package/types/src/File/docs/examples/Multi.d.ts

@@ -4,6 +4,10 @@ interface FileItem {
     name: string;
     value?: string | ArrayBuffer | null;
 }
+/**
+ * @name Multifile
+ * @description By storing an array of items, multiple files can be supported.
+ */
 declare class Multi extends Component<object, {
     files: FileItem[];
 }> {

package/types/src/File/docs/examples/Progress.d.ts

@@ -1,2 +1,6 @@
 import React from 'react';
+/**
+ * @name Progress
+ * @description The File.Item can display its upload progress.
+ */
 export default function Progress(): React.JSX.Element;

package/types/src/File/docs/examples/Single.d.ts

@@ -1,5 +1,9 @@
 import React, { Component } from 'react';
 import { FileRequestAddHandler } from '@splunk/react-ui/File';
+/**
+ * @name Single file
+ * @description Here, selecting a new file will replace the existing file.
+ */
 declare class Single extends Component<object, {
     filename?: string;
 }> {

package/types/src/FormRows/FormRows.d.ts

@@ -1,8 +1,8 @@
 import React from 'react';
 import PropTypes from 'prop-types';
 import Row from './Row';
-import type { RowRequestRemoveHandler } from './Row';
 import { ComponentProps } from '../utils/types';
+import type { RowRequestRemoveHandler } from './Row';
 /** @public */
 type FormRowsRequestMoveHandler = (data: {
     fromIndex: number;

package/types/src/FormRows/docs/examples/Basic.d.ts

@@ -1,5 +1,8 @@
 import React, { Component } from 'react';
 import { FormRowsRequestMoveHandler, RowRequestRemoveHandler } from '@splunk/react-ui/FormRows';
+/**
+ * @name Basic
+ */
 declare class Basic extends Component<object, {
     items: React.ReactElement[];
 }> {

package/types/src/FormRows/docs/examples/Header.d.ts

@@ -1,5 +1,9 @@
 import React, { Component } from 'react';
 import { FormRowsRequestMoveHandler, RowRequestRemoveHandler } from '@splunk/react-ui/FormRows';
+/**
+ * @name Header
+ * @description Form Rows does not provide a concept of columns, but this can be simulated by adding content to the header and setting fixed widths on the elements. For accessibility compliance, ensure each heading has a unique id and form controls have a matching describedBy prop.
+ */
 declare class Header extends Component<object, {
     items: React.ReactElement[];
 }> {

package/types/src/FormRows/docs/examples/Menu.d.ts

@@ -1,6 +1,10 @@
 import React, { Component } from 'react';
 import { FormRowsRequestMoveHandler, RowRequestRemoveHandler } from '@splunk/react-ui/FormRows';
 import { SelectChangeHandler } from '@splunk/react-ui/Select';
+/**
+ * @name Custom add menu
+ * @description The 'Add row' button can be replaced with a button, multiple buttons, or any other content you want to show below the Form Rows.
+ */
 declare class Menu extends Component<object, {
     items: React.ReactElement[];
 }> {

package/types/src/FormRows/docs/examples/ReorderOnly.d.ts

@@ -1,5 +1,9 @@
 import React, { Component } from 'react';
 import { FormRowsRequestMoveHandler } from '@splunk/react-ui/FormRows';
+/**
+ * @name Reorder only
+ * @description The add and delete functionality can be removed by not including the onRequestAdd handler on Form Rows and the onRequestRemove handler on Row. The functionality of reordering Rows will still remain intact. If users can add, they should be able to delete as well.
+ */
 declare class ReorderOnly extends Component<object, {
     items: React.ReactElement[];
 }> {

package/types/src/Heading/docs/examples/Basic.d.ts

@@ -1,3 +1,6 @@
 import React from 'react';
+/**
+ * @name Basic
+ */
 declare function Basic(): React.JSX.Element;
 export default Basic;

package/types/src/Heading/docs/examples/Variant.d.ts

@@ -1,3 +1,7 @@
 import React from 'react';
+/**
+ * @name Variant
+ * @description The level prop determines the <hX> HTML tag and has an associated default typography mixin style. To override this default styling, the variant prop can be used to specify a typography mixin style. For instance, it is possible for a variant to have title1 styling and be a <h2> tag as in the below example.
+ */
 declare function Variant(): React.JSX.Element;
 export default Variant;

package/types/src/Image/docs/examples/Basic.d.ts

@@ -1,3 +1,6 @@
 import React from 'react';
+/**
+ * @name Basic
+ */
 declare function Basic(): React.JSX.Element;
 export default Basic;

package/types/src/JSONTree/JSONTreeItem.d.ts

@@ -3,7 +3,10 @@ import PropTypes from 'prop-types';
 import { JSONElement } from './JSONTree';
 import { TreeItemPropsBase } from '../Tree';
 import { ComponentProps } from '../utils/types';
-export type ExpandLinkHandler = (data: {
+export type ExpandLinkRenderer = (params: {
+    onToggleExpansion: (event: React.KeyboardEvent<HTMLLIElement> | React.MouseEvent<HTMLSpanElement>, data?: {
+        treeItemId?: string;
+    }) => void;
     open: boolean;
     withTooltip: boolean;
     expandLinkRef: React.RefObject<HTMLButtonElement>;
@@ -20,7 +23,7 @@ interface JSONTreeItemPropsBase extends TreeItemPropsBase {
     properties?: string[];
     propertyDataPath: string;
     propertyElement?: JSX.Element | undefined;
-    renderExpandLink?: ExpandLinkHandler;
+    renderExpandLink?: ExpandLinkRenderer;
     representation?: JSX.Element | JSX.Element[];
     value?: JSONElement;
 }

package/types/src/JSONTree/docs/examples/Basic.d.ts

@@ -1,2 +1,5 @@
 import React from 'react';
+/**
+ * @name Basic
+ */
 export default function Basic(): React.JSX.Element;

package/types/src/JSONTree/docs/examples/Events.d.ts

@@ -1,5 +1,9 @@
 import React, { Component } from 'react';
 import { JSONTreeClickValueHandler, JSONTreeClickKeyHandler } from '@splunk/react-ui/JSONTree';
+/**
+ * @name Click events
+ * @description Click the value to see the interaction.
+ */
 declare class Events extends Component<object, {
     key: string;
     keyPath?: (string | number)[];

package/types/src/JSONTree/docs/examples/ExpandChildrenOnShiftKey.d.ts

@@ -1,2 +1,6 @@
 import React from 'react';
+/**
+ * @name Expand children on shift key
+ * @description Shift + Click or Shift + Enter to expand all child nodes at once.
+ */
 export default function ExpandChildrenOnShiftKey(): React.JSX.Element;

package/types/src/Layer/docs/examples/Basic.d.ts

@@ -1,3 +1,7 @@
 import React from 'react';
+/**
+ * @name Basic
+ * @description This example shows a simple overlay that can be dismissed by pressing the Escape key.
+ */
 declare function Basic(): React.JSX.Element;
 export default Basic;

package/types/src/Layout/docs/examples/Basic.d.ts

@@ -1,3 +1,6 @@
 import React from 'react';
+/**
+ * @name Basic
+ */
 declare function Basic(): React.JSX.Element;
 export default Basic;

package/types/src/Link/docs/examples/Basic.d.ts

@@ -1,3 +1,7 @@
 import React from 'react';
+/**
+ * @name Basic
+ * @description Use the Link component instead of an <a> tag, by default it is displayed inline.
+ */
 declare function Basic(): React.JSX.Element;
 export default Basic;

package/types/src/Link/docs/examples/Disabled.d.ts

@@ -1,3 +1,7 @@
 import React from 'react';
+/**
+ * @name Disabled
+ * @description Links can be disabled. The href is then removed from the markup.
+ */
 declare function Disabled(): React.JSX.Element;
 export default Disabled;

package/types/src/Link/docs/examples/NewWindow.d.ts

@@ -1,3 +1,7 @@
 import React from 'react';
+/**
+ * @name New window
+ * @description openInNewContext=true adds an icon and sets target to _blank. A message indicates the behavior for screen reader users. The default message, '(Opens new window)', can be customized by by passing a string to openInNewContext.
+ */
 declare function NewWindow(): React.JSX.Element;
 export default NewWindow;

package/types/src/Link/docs/examples/Standalone.d.ts

@@ -1,3 +1,7 @@
 import React from 'react';
+/**
+ * @name Standalone
+ * @description Use appearance="standalone" when using Link on its own without other text content.
+ */
 declare function Standalone(): React.JSX.Element;
 export default Standalone;

package/types/src/List/docs/examples/CustomizedList.d.ts

@@ -1,3 +1,7 @@
 import React from 'react';
+/**
+ * @name Customized list
+ * @description List style type can be customized using CSS.
+ */
 declare function CustomizedList(): React.JSX.Element;
 export default CustomizedList;

package/types/src/List/docs/examples/OrderedList.d.ts

@@ -1,3 +1,7 @@
 import React from 'react';
+/**
+ * @name Ordered list
+ * @description Ordered Lists use numerals by default.
+ */
 declare function Ordered(): React.JSX.Element;
 export default Ordered;

package/types/src/List/docs/examples/UnorderedList.d.ts

@@ -1,3 +1,6 @@
 import React from 'react';
+/**
+ * @name Unordered list
+ */
 declare function UnorderedList(): React.JSX.Element;
 export default UnorderedList;

package/types/src/Markdown/Markdown.d.ts

@@ -1,8 +1,8 @@
 import React from 'react';
 import PropTypes from 'prop-types';
 import { Options } from 'react-markdown';
-import { ComponentProps } from '../utils/types';
 import { MarkdownAnchorHeading, MarkdownBlockquote, MarkdownCodeBlock, MarkdownCode, MarkdownHeading, MarkdownImage, MarkdownItem, MarkdownLink, MarkdownList, MarkdownParagraph } from './renderers';
+import { ComponentProps } from '../utils/types';
 /** @public */
 type RemarkReturn = React.ReactElement<any, any> | null;
 /** @public */

package/types/src/Markdown/docs/examples/Basic.d.ts

@@ -1,3 +1,7 @@
 import React from 'react';
+/**
+ * @name Basic
+ * @description Most Markdown elements and capabilities are supported. HTML is not permitted.
+ */
 declare function BasicExample(): React.JSX.Element;
 export default BasicExample;

package/types/src/Markdown/docs/examples/I18n.d.ts

@@ -1,3 +1,7 @@
 import React from 'react';
+/**
+ * @name I18n
+ * @description Combine with gettext interpolation.
+ */
 declare function I18nExample(): React.JSX.Element;
 export default I18nExample;

package/types/src/Markdown/renderers/MarkdownBlockquote.d.ts

@@ -1,6 +1,6 @@
 import React from 'react';
-import { StyledHint } from '../MarkdownStyles';
 import { ComponentProps } from '../../utils/types';
+import { StyledHint } from '../MarkdownStyles';
 interface MarkdownBlockquotePropsBase {
     children: React.ReactNode[];
 }

package/types/src/Markdown/renderers/MarkdownCodeBlock.d.ts

@@ -1,6 +1,6 @@
 import React from 'react';
-import { StyledCodeBlock } from '../MarkdownStyles';
 import { ComponentProps } from '../../utils/types';
+import { StyledCodeBlock } from '../MarkdownStyles';
 interface MarkdownCodeBlockPropsBase {
     children: React.ReactNode[];
     language?: string;

package/types/src/Markdown/renderers/index.d.ts

@@ -4,9 +4,9 @@ import MarkdownCode from './MarkdownCode';
 import MarkdownCodeBlock, { StyledCodeBlock } from './MarkdownCodeBlock';
 import MarkdownHeading from './MarkdownHeading';
 import MarkdownImage from './MarkdownImage';
+import MarkdownItem from './MarkdownItem';
 import MarkdownLink from './MarkdownLink';
 import MarkdownList from './MarkdownList';
-import MarkdownItem from './MarkdownItem';
 import MarkdownParagraph from './MarkdownParagraph';
 import { MarkdownTable, MarkdownTableHeadCell, MarkdownTableCell, MarkdownTableRow, MarkdownTableBody, MarkdownTableHead } from './MarkdownTable';
 export { MarkdownAnchorHeading, MarkdownBlockquote, MarkdownCodeBlock, MarkdownCode, MarkdownHeading, MarkdownImage, MarkdownItem, MarkdownLink, MarkdownList, MarkdownParagraph, MarkdownTable, MarkdownTableBody, MarkdownTableCell, MarkdownTableHead, MarkdownTableHeadCell, MarkdownTableRow, StyledCodeBlock, StyledHint, };

package/types/src/Menu/Item.d.ts

@@ -74,20 +74,25 @@ interface ItemPropsBase {
      */
     role?: 'menuitem' | 'menuitemradio' | 'menuitemcheckbox' | 'listboxitem' | 'option';
     /**
-     * If selectable is true, whitespace is left where the checkmark can be shown.
+     * Enables selection for this item and reserves space for the control.
+     * Required when using `selected` or `selectableAppearance`.
      */
     selectable?: boolean;
     /**
-     * If selectable is true, whitespace is left where the checkmark can be shown.
+     * Specifies the type of selection control to display when `selectable` is enabled.
      */
     selectableAppearance?: 'checkmark' | 'checkbox';
     /**
-     * Indicates the selection state of the item.
-     * - With `selectableAppearance='checkmark'`: if `selected` is `true`, a checkmark shows the item is selected.
-     * - With `selectableAppearance='checkbox'`:
-     *   - `selected=true` renders a fully checked checkbox.
-     *   - `selected='some'` renders a partially checked (indeterminate) checkbox, corresponding to `aria-checked='mixed'`.
-     *   - `selected=false` renders an unchecked checkbox.
+     * Controls the selection state of the item.
+     * The selection control (checkmark or checkbox) is only rendered when `selectable` is enabled.
+     *
+     * When `selectableAppearance = 'checkmark'`:
+     * - `true` shows a checkmark.
+     *
+     * When `selectableAppearance = 'checkbox'`:
+     * - `true` renders a checked box.
+     * - `'some'` renders an indeterminate box (`aria-checked="mixed"`).
+     * - `false` renders an unchecked box.
      */
     selected?: boolean | 'some';
     /** Adornment in front of the label. */
@@ -101,8 +106,20 @@ interface ItemPropsBase {
      */
     truncate?: boolean;
 }
-type ItemButtonProps = ComponentProps<ItemPropsBase, 'button'>;
-type ItemLinkProps = ComponentProps<ItemPropsBase, 'a', 'href'>;
+type SharedItemProps = Omit<ItemPropsBase, 'selectable' | 'selectableAppearance' | 'selected'>;
+interface NonSelectableItemProps extends SharedItemProps {
+    selectable?: false;
+    selectableAppearance?: never;
+    selected?: never;
+}
+interface SelectableItemProps extends SharedItemProps {
+    selectable: true;
+    selectableAppearance?: 'checkmark' | 'checkbox';
+    selected?: boolean | 'some';
+}
+type ItemPropsCommon = NonSelectableItemProps | SelectableItemProps;
+type ItemButtonProps = ComponentProps<ItemPropsCommon, 'button'>;
+type ItemLinkProps = ComponentProps<ItemPropsCommon, 'a', 'href'>;
 type ItemProps = ItemButtonProps | ItemLinkProps;
 declare function Item({ active, children, description, descriptionPosition, disabled, endAdornment, elementRef, hasSubmenu, itemKey, matchRanges, onClick, onFocus, openInNewContext, role, selectable, selectableAppearance, selected, startAdornment, to, truncate, ...otherProps }: ItemProps): React.JSX.Element;
 declare namespace Item {

package/types/src/Menu/docs/examples/Adornments.d.ts

@@ -1,3 +1,7 @@
 import React from 'react';
+/**
+ * @name Adornments
+ * @description A startAdornment and/or endAdornment can be added to a Menu.Item. Adornments should be decorative.
+ */
 declare function Adornments(): React.JSX.Element;
 export default Adornments;

package/types/src/Menu/docs/examples/Basic.d.ts

@@ -1,3 +1,6 @@
 import React from 'react';
+/**
+ * @name Basic
+ */
 declare function Basic(): React.JSX.Element;
 export default Basic;

package/types/src/Menu/docs/examples/Complex.d.ts

@@ -1,3 +1,7 @@
 import React from 'react';
+/**
+ * @name Complex
+ * @description All the options can be used together. Additional props, such as hasSubmenu, are detailed in the following example.
+ */
 declare function Complex(): React.JSX.Element;
 export default Complex;

package/types/src/Menu/docs/examples/Descriptions.d.ts

@@ -1,3 +1,7 @@
 import React from 'react';
+/**
+ * @name Descriptions
+ * @description Descriptions can be placed below or to the right of the label. Defaults to descriptionPosition="bottom".
+ */
 declare function Descriptions(): React.JSX.Element;
 export default Descriptions;

package/types/src/Menu/docs/examples/Dimmed.d.ts

@@ -1,3 +1,7 @@
 import React from 'react';
+/**
+ * @name Dimmed
+ * @description If you absolutely need to disable a Menu Item use a dimmed Menu Item. When the disabled prop is set to "dimmed", the Menu Item does not respond to events but can still receive focus to ensure users can navigate to the Item when using assistive technologies. This also sets aria-disabled to true.
+ */
 declare function Dimmed(): React.JSX.Element;
 export default Dimmed;

package/types/src/Menu/docs/examples/Disabled.d.ts

@@ -1,3 +1,6 @@
 import React from 'react';
+/**
+ * @name Disabled
+ */
 declare function Disabled(): React.JSX.Element;
 export default Disabled;

package/types/src/Menu/docs/examples/Dividers.d.ts

@@ -1,3 +1,6 @@
 import React from 'react';
+/**
+ * @name Dividers
+ */
 declare function Dividers(): React.JSX.Element;
 export default Dividers;

package/types/src/Menu/docs/examples/Headings.d.ts

@@ -1,3 +1,7 @@
 import React from 'react';
+/**
+ * @name Headings
+ * @description Menus can have headings to summarize the following items.
+ */
 declare function Headings(): React.JSX.Element;
 export default Headings;

package/types/src/Menu/docs/examples/Links.d.ts

@@ -1,3 +1,7 @@
 import React from 'react';
+/**
+ * @name Links
+ * @description Menu.Items can contain links by including a to attribute.
+ */
 declare function Links(): React.JSX.Element;
 export default Links;