@primer/components 0.0.0-20219922627 → 0.0.0-2022530194733

package/lib/utils/theme.d.ts

@@ -1,9 +0,0 @@
-export function fontStack(fonts: any): any;
-export function isShadowValue(value: any): boolean;
-export function isColorValue(value: any): boolean;
-export function filterObject(obj: any, predicate: any): {};
-export function partitionColors(colors: any): {
-    colors: {};
-    shadows: {};
-};
-export function omitScale(obj: any): any;

package/lib/utils/types.d.ts

@@ -1,14 +0,0 @@
-/// <reference types="react" />
-/**
- * Extract a component's props
- *
- * Source: https://react-typescript-cheatsheet.netlify.app/docs/advanced/patterns_by_usecase#wrappingmirroring-a-component
- *
- * @example ComponentProps<typeof MyComponent>
- */
-export declare type ComponentProps<T> = T extends React.ComponentType<infer Props> ? Props extends object ? Props : never : never;
-/**
- * Contruct a type describing the items in `T`, if `T` is an array.
- */
-export declare type Flatten<T extends unknown> = T extends (infer U)[] ? U : never;
-export declare type AriaRole = 'alert' | 'alertdialog' | 'application' | 'article' | 'banner' | 'button' | 'cell' | 'checkbox' | 'columnheader' | 'combobox' | 'complementary' | 'contentinfo' | 'definition' | 'dialog' | 'directory' | 'document' | 'feed' | 'figure' | 'form' | 'grid' | 'gridcell' | 'group' | 'heading' | 'img' | 'link' | 'list' | 'listbox' | 'listitem' | 'log' | 'main' | 'marquee' | 'math' | 'menu' | 'menubar' | 'menuitem' | 'menuitemcheckbox ' | 'menuitemradio' | 'navigation' | 'none' | 'note' | 'option' | 'presentation' | 'progressbar' | 'radio' | 'radiogroup' | 'region' | 'row' | 'rowgroup' | 'rowheader' | 'scrollbar' | 'search' | 'searchbox' | 'separator' | 'slider' | 'spinbutton' | 'status' | 'switch' | 'tab' | 'table' | 'tablist' | 'tabpanel' | 'term' | 'textbox' | 'timer' | 'toolbar' | 'tooltip' | 'tree' | 'treegrid' | 'treeitem';

package/lib/utils/uniqueId.d.ts

@@ -1 +0,0 @@
-export declare function uniqueId(): string;

package/lib/utils/userAgent.d.ts

@@ -1 +0,0 @@
-export declare function isMacOS(): boolean;

package/lib-esm/ActionList/Divider.d.ts

@@ -1,9 +0,0 @@
-/// <reference types="react" />
-export declare const StyledDivider: import("styled-components").StyledComponent<"div", any, {}, never>;
-/**
- * Visually separates `Item`s or `Group`s in an `ActionList`.
- */
-export declare function Divider(): JSX.Element;
-export declare namespace Divider {
-    var renderItem: typeof Divider;
-}

package/lib-esm/ActionList/Divider.js

@@ -1,23 +0,0 @@
-import React from 'react';
-import styled from 'styled-components';
-import { get } from '../constants';
-export const StyledDivider = styled.div.withConfig({
-  displayName: "Divider__StyledDivider",
-  componentId: "sc-42656i-0"
-})(["height:1px;background:", ";margin-top:calc(", " - 1px);margin-bottom:", ";"], get('colors.border.muted'), get('space.2'), get('space.2'));
-/**
- * Visually separates `Item`s or `Group`s in an `ActionList`.
- */
-
-export function Divider() {
-  return /*#__PURE__*/React.createElement(StyledDivider, null);
-}
-Divider.displayName = "Divider";
-
-/**
- * `Divider` fulfills the `ItemPropsWithCustomRenderer` contract,
- * so it can be used inline in an `ActionList`’s `items` prop.
- * In other words, `items={[ActionList.Divider]}` is supported as a concise
- * alternative to `items={[{renderItem: () => <ActionList.Divider />}]}`.
- */
-Divider.renderItem = Divider;

package/lib-esm/ActionList/Group.d.ts

@@ -1,28 +0,0 @@
-import React from 'react';
-import { SxProp } from '../sx';
-import { HeaderProps } from './Header';
-/**
- * Contract for props passed to the `Group` component.
- */
-export interface GroupProps extends React.ComponentPropsWithoutRef<'div'>, SxProp {
-    /**
-     * Props for a `Header` to render in the `Group`.
-     */
-    header?: HeaderProps;
-    /**
-     * The id of the group.
-     */
-    groupId?: string;
-    /**
-     * `Items` to render in the `Group`.
-     */
-    items?: JSX.Element[];
-    /**
-     * Whether to display a divider above each `Item` in this `Group` when it does not follow a `Header` or `Divider`.
-     */
-    showItemDividers?: boolean;
-}
-/**
- * Collects related `Items` in an `ActionList`.
- */
-export declare function Group({ header, items, ...props }: GroupProps): JSX.Element;

package/lib-esm/ActionList/Group.js

@@ -1,24 +0,0 @@
-import React from 'react';
-import styled from 'styled-components';
-import sx from '../sx';
-import { Header } from './Header';
-/**
- * Contract for props passed to the `Group` component.
- */
-
-const StyledGroup = styled.div.withConfig({
-  displayName: "Group__StyledGroup",
-  componentId: "sc-10w5bj9-0"
-})(["", ""], sx);
-/**
- * Collects related `Items` in an `ActionList`.
- */
-
-export function Group({
-  header,
-  items,
-  ...props
-}) {
-  return /*#__PURE__*/React.createElement(StyledGroup, props, header && /*#__PURE__*/React.createElement(Header, header), items);
-}
-Group.displayName = "Group";

package/lib-esm/ActionList/Header.d.ts

@@ -1,29 +0,0 @@
-import React from 'react';
-import { SxProp } from '../sx';
-/**
- * Contract for props passed to the `Header` component.
- */
-export interface HeaderProps extends React.ComponentPropsWithoutRef<'div'>, SxProp {
-    /**
-     * Style variations. Usage is discretionary.
-     *
-     * - `"filled"` - Superimposed on a background, offset from nearby content
-     * - `"subtle"` - Relatively less offset from nearby content
-     */
-    variant?: 'subtle' | 'filled';
-    /**
-     * Primary text which names a `Group`.
-     */
-    title: string;
-    /**
-     * Secondary text which provides additional information about a `Group`.
-     */
-    auxiliaryText?: string;
-}
-export declare const StyledHeader: import("styled-components").StyledComponent<"div", any, {
-    variant: HeaderProps['variant'];
-} & SxProp, never>;
-/**
- * Displays the name and description of a `Group`.
- */
-export declare function Header({ variant, title, auxiliaryText, children: _children, ...props }: HeaderProps): JSX.Element;

package/lib-esm/ActionList/Header.js

@@ -1,33 +0,0 @@
-function _extends() { _extends = Object.assign || function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
-
-import React from 'react';
-import styled, { css } from 'styled-components';
-import { get } from '../constants';
-import sx from '../sx';
-/**
- * Contract for props passed to the `Header` component.
- */
-
-export const StyledHeader = styled.div.withConfig({
-  displayName: "Header__StyledHeader",
-  componentId: "qmofje-0"
-})(["{}padding:6px ", ";font-size:", ";font-weight:", ";color:", ";", " ", ""], get('space.3'), get('fontSizes.0'), get('fontWeights.bold'), get('colors.fg.muted'), ({
-  variant
-}) => variant === 'filled' && css(["background:", ";margin:", " 0;border-top:1px solid ", ";border-bottom:1px solid ", ";&:first-child{margin-top:0;}"], get('colors.canvas.subtle'), get('space.2'), get('colors.neutral.muted'), get('colors.neutral.muted')), sx);
-/**
- * Displays the name and description of a `Group`.
- */
-
-export function Header({
-  variant = 'subtle',
-  title,
-  auxiliaryText,
-  children: _children,
-  ...props
-}) {
-  return /*#__PURE__*/React.createElement(StyledHeader, _extends({
-    role: "heading",
-    variant: variant
-  }, props), title, auxiliaryText && /*#__PURE__*/React.createElement("span", null, "auxiliaryText"));
-}
-Header.displayName = "Header";

package/lib-esm/ActionList/Item.d.ts

@@ -1,92 +0,0 @@
-import { IconProps } from '@primer/octicons-react';
-import React from 'react';
-import { SxProp } from '../sx';
-import { ItemInput } from './List';
-import { ForwardRefComponent as PolymorphicForwardRefComponent } from '@radix-ui/react-polymorphic';
-import { AriaRole } from '../utils/types';
-/**
- * Contract for props passed to the `Item` component.
- */
-export interface ItemProps extends SxProp {
-    /**
-     * Primary text which names an `Item`.
-     */
-    text?: string;
-    /**
-     * Secondary text which provides additional information about an `Item`.
-     */
-    description?: string;
-    /**
-     * Secondary text style variations. Usage is discretionary.
-     *
-     * - `"inline"` - Secondary text is positioned beside primary text.
-     * - `"block"` - Secondary text is positioned below primary text.
-     */
-    descriptionVariant?: 'inline' | 'block';
-    /**
-     * Icon (or similar) positioned before `Item` text.
-     */
-    leadingVisual?: React.FunctionComponent<IconProps>;
-    /**
-     * Icon (or similar) positioned after `Item` text.
-     */
-    trailingIcon?: React.FunctionComponent<IconProps>;
-    /**
-     * Text positioned after `Item` text and optional trailing icon.
-     */
-    trailingText?: string;
-    /**
-     * Style variations associated with various `Item` types.
-     *
-     * - `"default"` - An action `Item`.
-     * - `"danger"` - A destructive action `Item`.
-     */
-    variant?: 'default' | 'danger';
-    /**
-     * Whether to display a divider above the `Item` when it does not follow a `Header` or `Divider`.
-     */
-    showDivider?: boolean;
-    /**
-     * For `Item`s which can be selected, whether the `Item` is currently selected.
-     */
-    selected?: boolean;
-    /**
-     *  For `Item`s which can be selected, whether `multiple` `Item`s or a `single` `Item` can be selected
-     */
-    selectionVariant?: 'single' | 'multiple';
-    /**
-     * Designates the group that an item belongs to.
-     */
-    groupId?: string;
-    /**
-     * Items that are disabled can not be clicked, selected, or navigated through.
-     */
-    disabled?: boolean;
-    /**
-     * Callback that will trigger both on click selection and keyboard selection.
-     */
-    onAction?: (item: ItemProps, event: React.MouseEvent<HTMLDivElement> | React.KeyboardEvent<HTMLDivElement>) => void;
-    /**
-     * An id associated with this item.  Should be unique between items
-     */
-    id?: number | string;
-    /**
-     * Node to be included inside the item before the text.
-     */
-    children?: React.ReactNode;
-    /**
-     * The ARIA role describing the function of `List` component. `option` is a common value.
-     */
-    role?: AriaRole;
-    /**
-     * An item to pass back in the `onAction` callback, meant as
-     */
-    item?: ItemInput;
-}
-export declare const TextContainer: import("styled-components").StyledComponent<"span", any, {
-    dangerouslySetInnerHtml?: React.DOMAttributes<HTMLDivElement>['dangerouslySetInnerHTML'];
-}, never>;
-/**
- * An actionable or selectable `Item` with an optional icon and description.
- */
-export declare const Item: PolymorphicForwardRefComponent<"div", ItemProps>;

package/lib-esm/ActionList/Item.js

@@ -1,253 +0,0 @@
-function _extends() { _extends = Object.assign || function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
-
-import { CheckIcon } from '@primer/octicons-react';
-import React, { useCallback } from 'react';
-import { get } from '../constants';
-import sx from '../sx';
-import Truncate from '../Truncate';
-import styled from 'styled-components';
-import { StyledHeader } from './Header';
-import { StyledDivider } from './Divider';
-import { useColorSchemeVar, useTheme } from '../ThemeProvider';
-import { activeDescendantActivatedDirectly, activeDescendantActivatedIndirectly, isActiveDescendantAttribute } from '../behaviors/focusZone';
-import { useSSRSafeId } from '@react-aria/ssr';
-
-/**
- * These colors are not yet in our default theme.  Need to remove this once they are added.
- */
-const customItemThemes = {
-  default: {
-    hover: {
-      light: 'rgba(46, 77, 108, 0.06)',
-      dark: 'rgba(201, 206, 212, 0.12)',
-      dark_dimmed: 'rgba(201, 206, 212, 0.12)'
-    },
-    focus: {
-      light: 'rgba(54, 77, 100, 0.16)',
-      dark: 'rgba(201, 206, 212, 0.24)',
-      dark_dimmed: 'rgba(201, 206, 212, 0.24)'
-    }
-  },
-  danger: {
-    hover: {
-      light: 'rgba(234, 74, 90, 0.08)',
-      dark: 'rgba(248, 81, 73, 0.16)',
-      dark_dimmed: 'rgba(248, 81, 73, 0.16)'
-    },
-    focus: {
-      light: 'rgba(234, 74, 90, 0.14)',
-      dark: 'rgba(248, 81, 73, 0.24)',
-      dark_dimmed: 'rgba(248, 81, 73, 0.24)'
-    }
-  }
-};
-/**
- * Contract for props passed to the `Item` component.
- */
-
-const getItemVariant = (variant = 'default', disabled) => {
-  if (disabled) {
-    return {
-      color: get('colors.fg.muted'),
-      iconColor: get('colors.fg.muted'),
-      annotationColor: get('colors.fg.muted'),
-      hoverCursor: 'default'
-    };
-  }
-
-  switch (variant) {
-    case 'danger':
-      return {
-        color: get('colors.danger.fg'),
-        iconColor: get('colors.danger.fg'),
-        annotationColor: get('colors.fg.muted'),
-        hoverCursor: 'pointer'
-      };
-
-    default:
-      return {
-        color: get('colors.fg.default'),
-        iconColor: get('colors.fg.muted'),
-        annotationColor: get('colors.fg.muted'),
-        hoverCursor: 'pointer'
-      };
-  }
-};
-
-const DividedContent = styled.div.withConfig({
-  displayName: "Item__DividedContent",
-  componentId: "jqpvy8-0"
-})(["display:flex;min-width:0;position:relative;flex-grow:1;"]);
-const MainContent = styled.div.withConfig({
-  displayName: "Item__MainContent",
-  componentId: "jqpvy8-1"
-})(["align-items:baseline;display:flex;min-width:0;flex-direction:var(--main-content-flex-direction);flex-grow:1;"]);
-const StyledItem = styled.div.withConfig({
-  displayName: "Item__StyledItem",
-  componentId: "jqpvy8-2"
-})(["padding:6px ", ";display:flex;border-radius:", ";color:", ";transition:background 33.333ms linear;text-decoration:none;@media (hover:hover) and (pointer:fine){:hover{background:var(--item-hover-bg-override,", ");cursor:", ";}}:not(:first-of-type):not(", " + &):not(", " + &){margin-top:", ";", "::before{content:' ';display:block;position:absolute;width:100%;top:-7px;border:0 solid ", ";border-top-width:", ";}}&:hover ", "::before,:hover + * ", "::before{border-color:var(--item-hover-divider-border-color-override,transparent) !important;}&:focus ", "::before,:focus + * ", "::before,&[", "] ", "::before,[", "] + & ", "::before{border-color:transparent !important;}&[", "='", "']{background:", ";}&[", "='", "']{background:", ";}&:focus{background:", ";outline:none;}&:active{background:", ";}", ""], get('space.2'), get('radii.2'), ({
-  variant,
-  item
-}) => getItemVariant(variant, item === null || item === void 0 ? void 0 : item.disabled).color, ({
-  hoverBackground
-}) => hoverBackground, ({
-  variant,
-  item
-}) => getItemVariant(variant, item === null || item === void 0 ? void 0 : item.disabled).hoverCursor, StyledDivider, StyledHeader, ({
-  showDivider
-}) => showDivider ? `1px` : '0', DividedContent, get('colors.border.muted'), ({
-  showDivider
-}) => showDivider ? `1px` : '0', DividedContent, DividedContent, DividedContent, DividedContent, isActiveDescendantAttribute, DividedContent, isActiveDescendantAttribute, DividedContent, isActiveDescendantAttribute, activeDescendantActivatedDirectly, ({
-  focusBackground
-}) => focusBackground, isActiveDescendantAttribute, activeDescendantActivatedIndirectly, ({
-  hoverBackground
-}) => hoverBackground, ({
-  focusBackground
-}) => focusBackground, ({
-  focusBackground
-}) => focusBackground, sx);
-export const TextContainer = styled.span.withConfig({
-  displayName: "Item__TextContainer",
-  componentId: "jqpvy8-3"
-})([""]);
-const BaseVisualContainer = styled.div.withConfig({
-  displayName: "Item__BaseVisualContainer",
-  componentId: "jqpvy8-4"
-})(["height:20px;width:", ";margin-right:", ";"], get('space.3'), get('space.2'));
-const ColoredVisualContainer = styled(BaseVisualContainer).withConfig({
-  displayName: "Item__ColoredVisualContainer",
-  componentId: "jqpvy8-5"
-})(["svg{fill:", ";font-size:", ";}"], ({
-  variant,
-  disabled
-}) => getItemVariant(variant, disabled).iconColor, get('fontSizes.0'));
-const LeadingVisualContainer = styled(ColoredVisualContainer).withConfig({
-  displayName: "Item__LeadingVisualContainer",
-  componentId: "jqpvy8-6"
-})(["flex-shrink:0;display:flex;flex-direction:column;justify-content:center;"]);
-const TrailingContent = styled(ColoredVisualContainer).withConfig({
-  displayName: "Item__TrailingContent",
-  componentId: "jqpvy8-7"
-})(["color:", "};margin-left:", ";margin-right:0;width:auto;div:nth-child(2){margin-left:", ";}"], ({
-  variant,
-  disabled
-}) => getItemVariant(variant, disabled).annotationColor, get('space.2'), get('space.2'));
-const DescriptionContainer = styled.span.withConfig({
-  displayName: "Item__DescriptionContainer",
-  componentId: "jqpvy8-8"
-})(["color:", ";font-size:", ";line-height:16px;margin-left:var(--description-container-margin-left);min-width:0;flex-grow:1;flex-basis:var(--description-container-flex-basis);"], get('colors.fg.muted'), get('fontSizes.0'));
-const MultiSelectInput = styled.input.withConfig({
-  displayName: "Item__MultiSelectInput",
-  componentId: "jqpvy8-9"
-})(["pointer-events:none;"]);
-/**
- * An actionable or selectable `Item` with an optional icon and description.
- */
-
-export const Item = /*#__PURE__*/React.forwardRef((itemProps, ref) => {
-  const {
-    as: Component,
-    text,
-    description,
-    descriptionVariant = 'inline',
-    selected,
-    selectionVariant,
-    leadingVisual: LeadingVisual,
-    trailingIcon: TrailingIcon,
-    trailingText,
-    variant = 'default',
-    showDivider,
-    disabled,
-    onAction,
-    onKeyPress,
-    children,
-    onClick,
-    id,
-    ...props
-  } = itemProps;
-  const labelId = useSSRSafeId();
-  const descriptionId = useSSRSafeId();
-  const keyPressHandler = useCallback(event => {
-    if (disabled) {
-      return;
-    }
-
-    onKeyPress === null || onKeyPress === void 0 ? void 0 : onKeyPress(event);
-    const isCheckbox = event.target instanceof HTMLInputElement && event.target.type === 'checkbox';
-
-    if (isCheckbox && event.key === ' ') {
-      // space key on a checkbox will also trigger a click event.  Ignore the space key so we don't get double events
-      return;
-    }
-
-    if (!event.defaultPrevented && [' ', 'Enter'].includes(event.key)) {
-      onAction === null || onAction === void 0 ? void 0 : onAction(itemProps, event);
-    }
-  }, [onAction, disabled, itemProps, onKeyPress]);
-  const clickHandler = useCallback(event => {
-    if (disabled) {
-      return;
-    }
-
-    onClick === null || onClick === void 0 ? void 0 : onClick(event);
-
-    if (!event.defaultPrevented) {
-      onAction === null || onAction === void 0 ? void 0 : onAction(itemProps, event);
-    }
-  }, [onAction, disabled, itemProps, onClick]);
-  const customItemTheme = customItemThemes[variant];
-  const hoverBackground = useColorSchemeVar(customItemTheme.hover, 'inherit');
-  const focusBackground = useColorSchemeVar(customItemTheme.focus, 'inherit');
-  const {
-    theme
-  } = useTheme();
-  return /*#__PURE__*/React.createElement(StyledItem, _extends({
-    ref: ref,
-    as: Component,
-    tabIndex: disabled ? undefined : -1,
-    variant: variant,
-    showDivider: showDivider,
-    "aria-selected": selected,
-    "aria-labelledby": text ? labelId : undefined,
-    "aria-describedby": description ? descriptionId : undefined
-  }, props, {
-    "data-id": id,
-    onKeyPress: keyPressHandler,
-    onClick: clickHandler,
-    hoverBackground: disabled ? 'inherit' : hoverBackground,
-    focusBackground: disabled ? 'inherit' : focusBackground
-  }), !!selected === selected && /*#__PURE__*/React.createElement(BaseVisualContainer, null, selectionVariant === 'multiple' ? /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(MultiSelectInput, {
-    disabled: disabled,
-    tabIndex: -1,
-    type: "checkbox",
-    checked: selected,
-    "aria-label": text,
-    readOnly: true,
-    "aria-readonly": "false"
-  })) : selected && /*#__PURE__*/React.createElement(CheckIcon, {
-    fill: theme === null || theme === void 0 ? void 0 : theme.colors.text.primary
-  })), LeadingVisual && /*#__PURE__*/React.createElement(LeadingVisualContainer, {
-    variant: variant,
-    disabled: disabled
-  }, /*#__PURE__*/React.createElement(LeadingVisual, null)), /*#__PURE__*/React.createElement(DividedContent, null, /*#__PURE__*/React.createElement(MainContent, {
-    style: {
-      '--main-content-flex-direction': descriptionVariant === 'inline' ? 'row' : 'column'
-    }
-  }, children, text ? /*#__PURE__*/React.createElement(TextContainer, {
-    id: labelId
-  }, text) : null, description ? /*#__PURE__*/React.createElement(DescriptionContainer, {
-    id: descriptionId,
-    style: {
-      '--description-container-margin-left': descriptionVariant === 'inline' ? get('space.2')(theme) : 0,
-      '--description-container-flex-basis': descriptionVariant === 'inline' ? 0 : 'auto'
-    }
-  }, descriptionVariant === 'block' ? description : /*#__PURE__*/React.createElement(Truncate, {
-    title: description,
-    inline: true,
-    maxWidth: "100%"
-  }, description)) : null), TrailingIcon || trailingText ? /*#__PURE__*/React.createElement(TrailingContent, {
-    variant: variant,
-    disabled: disabled
-  }, trailingText, TrailingIcon && /*#__PURE__*/React.createElement(TrailingIcon, null)) : null));
-});
-Item.displayName = 'ActionList.Item';

package/lib-esm/ActionList/List.d.ts

@@ -1,87 +0,0 @@
-import React, { Key } from 'react';
-import type { AriaRole } from '../utils/types';
-import { Group, GroupProps } from './Group';
-import { ItemProps } from './Item';
-declare type RenderItemFn = (props: ItemProps) => React.ReactElement;
-export declare type ItemInput = (ItemProps & Omit<React.ComponentPropsWithoutRef<'div'>, keyof ItemProps>) | ((Partial<ItemProps> & {
-    renderItem: RenderItemFn;
-}) & {
-    key?: Key;
-});
-/**
- * Contract for props passed to the `List` component.
- */
-export interface ListPropsBase {
-    /**
-     * A collection of `Item` props and `Item`-level custom `Item` renderers.
-     */
-    items: ItemInput[];
-    /**
-     * The ARIA role describing the function of `List` component. `listbox` is a common value.
-     */
-    role?: AriaRole;
-    /**
-     * id to attach to the base DOM node of the list
-     */
-    id?: string;
-    /**
-     * A `List`-level custom `Item` renderer. Every `Item` within this `List`
-     * without a `Group`-level or `Item`-level custom `Item` renderer will be
-     * rendered using this function component.
-     */
-    renderItem?: RenderItemFn;
-    /**
-     * A `List`-level custom `Group` renderer. Every `Group` within this `List`
-     * without a `Group`-level custom `Item` renderer will be rendered using
-     * this function component.
-     */
-    renderGroup?: typeof Group;
-    /**
-     * Style variations. Usage is discretionary.
-     *
-     * - `"inset"` - `List` children are offset (vertically and horizontally) from `List`’s edges
-     * - `"full"` - `List` children are flush (vertically and horizontally) with `List` edges
-     */
-    variant?: 'inset' | 'full';
-    /**
-     *  For `Item`s which can be selected, whether `multiple` `Item`s or a `single` `Item` can be selected
-     */
-    selectionVariant?: 'single' | 'multiple';
-    /**
-     * Whether to display a divider above each `Item` in this `List` when it does not follow a `Header` or `Divider`.
-     */
-    showItemDividers?: boolean;
-}
-/**
- * Contract for props passed to the `List` component, when its `Item`s are collected in `Group`s.
- */
-export interface GroupedListProps extends ListPropsBase {
-    /**
-     * A collection of `Group` props (except `items`), plus a unique group identifier
-     * and `Group`-level custom `Item` or `Group` renderers.
-     */
-    groupMetadata: ((Omit<GroupProps, 'items'> | Omit<Partial<GroupProps> & {
-        renderItem?: RenderItemFn;
-        renderGroup?: typeof Group;
-    }, 'items'>) & {
-        groupId: string;
-    })[];
-    /**
-     * A collection of `Item` props, plus associated group identifiers
-     * and `Item`-level custom `Item` renderers.
-     */
-    items: ((ItemProps | (Partial<ItemProps> & {
-        renderItem: RenderItemFn;
-    })) & {
-        groupId: string;
-    })[];
-}
-/**
- * Contract for props passed to the `List` component.
- */
-export declare type ListProps = ListPropsBase | GroupedListProps;
-/**
- * Lists `Item`s, either grouped or ungrouped, with a `Divider` between each `Group`.
- */
-export declare const List: React.ForwardRefExoticComponent<ListProps & React.RefAttributes<HTMLDivElement>>;
-export {};