@primer/components 31.2.0-rc.fbb10090 → 31.2.1-rc.32ed6e21

package/lib-esm/ActionList2/Item.js

@@ -0,0 +1,208 @@
+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 { useSSRSafeId } from '@react-aria/ssr';
+import styled from 'styled-components';
+import { useTheme } from '../ThemeProvider';
+import Box from '../Box';
+import sx, { merge } from '../sx';
+import createSlots from '../utils/create-slots';
+import { ListContext } from './List';
+import { Selection } from './Selection';
+export const getVariantStyles = (variant, disabled) => {
+  if (disabled) {
+    return {
+      color: 'primer.fg.disabled',
+      iconColor: 'primer.fg.disabled',
+      annotationColor: 'primer.fg.disabled'
+    };
+  }
+
+  switch (variant) {
+    case 'danger':
+      return {
+        color: 'danger.fg',
+        iconColor: 'danger.fg',
+        annotationColor: 'fg.muted',
+        hoverColor: 'actionListItem.danger.hoverText'
+      };
+
+    default:
+      return {
+        color: 'fg.default',
+        iconColor: 'fg.muted',
+        annotationColor: 'fg.muted',
+        hoverColor: 'fg.default'
+      };
+  }
+};
+const {
+  Slots,
+  Slot
+} = createSlots(['LeadingVisual', 'InlineDescription', 'BlockDescription', 'TrailingVisual']);
+export { Slot };
+const LiBox = styled.li.withConfig({
+  displayName: "Item__LiBox",
+  componentId: "c3scat-0"
+})(sx);
+export const TEXT_ROW_HEIGHT = '20px'; // custom value off the scale
+
+export const Item = /*#__PURE__*/React.forwardRef(({
+  variant = 'default',
+  disabled = false,
+  selected = undefined,
+  onSelect = () => null,
+  sx: sxProp = {},
+  id,
+  _PrivateItemWrapper,
+  ...props
+}, forwardedRef) => {
+  const {
+    variant: listVariant,
+    showDividers
+  } = React.useContext(ListContext);
+  const {
+    theme
+  } = useTheme();
+  const styles = {
+    display: 'flex',
+    paddingX: 2,
+    fontSize: 1,
+    paddingY: '6px',
+    // custom value off the scale
+    lineHeight: TEXT_ROW_HEIGHT,
+    minHeight: 5,
+    marginX: listVariant === 'inset' ? 2 : 0,
+    borderRadius: listVariant === 'inset' ? 2 : 0,
+    transition: 'background 33.333ms linear',
+    color: getVariantStyles(variant, disabled).color,
+    cursor: 'pointer',
+    '&[aria-disabled]': {
+      cursor: 'not-allowed'
+    },
+    '@media (hover: hover) and (pointer: fine)': {
+      ':hover:not([aria-disabled])': {
+        backgroundColor: `actionListItem.${variant}.hoverBg`,
+        color: getVariantStyles(variant, disabled).hoverColor
+      },
+      ':focus:not([data-focus-visible-added])': {
+        backgroundColor: `actionListItem.${variant}.selectedBg`,
+        color: getVariantStyles(variant, disabled).hoverColor,
+        outline: 'none'
+      },
+      '&[data-focus-visible-added]': {
+        // we don't use :focus-visible because not all browsers (safari) have it yet
+        outline: 'none',
+        border: `2 solid`,
+        boxShadow: `0 0 0 2px ${theme === null || theme === void 0 ? void 0 : theme.colors.accent.emphasis}`
+      },
+      ':active:not([aria-disabled])': {
+        backgroundColor: `actionListItem.${variant}.activeBg`,
+        color: getVariantStyles(variant, disabled).hoverColor
+      }
+    },
+
+    /** Divider styles */
+    '[data-component="ActionList.Item--DividerContainer"]': {
+      position: 'relative'
+    },
+    '[data-component="ActionList.Item--DividerContainer"]::before': {
+      content: '" "',
+      display: 'block',
+      position: 'absolute',
+      width: '100%',
+      top: '-7px',
+      border: '0 solid',
+      borderTopWidth: showDividers ? `1px` : '0',
+      borderColor: 'var(--divider-color, transparent)'
+    },
+    // show between 2 items
+    ':not(:first-of-type)': {
+      '--divider-color': theme === null || theme === void 0 ? void 0 : theme.colors.actionListItem.inlineDivider
+    },
+    // hide divider after dividers & group header, with higher importance!
+    '[data-component="ActionList.Divider"] + &': {
+      '--divider-color': 'transparent !important'
+    },
+    // hide border on current and previous item
+    '&:hover:not([aria-disabled]), &:focus:not([aria-disabled]), &[data-focus-visible-added]:not([aria-disabled])': {
+      '--divider-color': 'transparent'
+    },
+    '&:hover:not([aria-disabled]) + &, &:focus:not([aria-disabled]) + &, &[data-focus-visible-added] + li': {
+      '--divider-color': 'transparent'
+    }
+  };
+  const clickHandler = React.useCallback(event => {
+    if (disabled) return;
+    if (!event.defaultPrevented) onSelect(event);
+  }, [onSelect, disabled]);
+  const keyPressHandler = React.useCallback(event => {
+    if (disabled) return;
+
+    if (!event.defaultPrevented && [' ', 'Enter'].includes(event.key)) {
+      onSelect(event);
+    }
+  }, [onSelect, disabled]); // use props.id if provided, otherwise generate one.
+
+  const labelId = useSSRSafeId(id);
+  const inlineDescriptionId = useSSRSafeId(id && `${id}--inline-description`);
+  const blockDescriptionId = useSSRSafeId(id && `${id}--block-description`);
+  const ItemWrapper = _PrivateItemWrapper || React.Fragment;
+  return /*#__PURE__*/React.createElement(Slots, {
+    context: {
+      variant,
+      disabled,
+      inlineDescriptionId,
+      blockDescriptionId
+    }
+  }, slots => /*#__PURE__*/React.createElement(LiBox, _extends({
+    ref: forwardedRef,
+    sx: merge(styles, sxProp),
+    onClick: clickHandler,
+    onKeyPress: keyPressHandler,
+    "aria-selected": selected,
+    "aria-disabled": disabled ? true : undefined,
+    tabIndex: disabled || _PrivateItemWrapper ? undefined : 0,
+    "aria-labelledby": `${labelId} ${slots.InlineDescription ? inlineDescriptionId : ''}`,
+    "aria-describedby": slots.BlockDescription ? blockDescriptionId : undefined
+  }, props), /*#__PURE__*/React.createElement(ItemWrapper, null, /*#__PURE__*/React.createElement(Selection, {
+    selected: selected
+  }), slots.LeadingVisual, /*#__PURE__*/React.createElement(Box, {
+    "data-component": "ActionList.Item--DividerContainer",
+    sx: {
+      display: 'flex',
+      flexDirection: 'column',
+      flexGrow: 1,
+      minWidth: 0
+    }
+  }, /*#__PURE__*/React.createElement(ConditionalBox, {
+    if: Boolean(slots.TrailingVisual),
+    sx: {
+      display: 'flex',
+      flexGrow: 1
+    }
+  }, /*#__PURE__*/React.createElement(ConditionalBox, {
+    if: Boolean(slots.InlineDescription),
+    sx: {
+      display: 'flex',
+      flexGrow: 1,
+      alignItems: 'baseline',
+      minWidth: 0
+    }
+  }, /*#__PURE__*/React.createElement(Box, {
+    as: "span",
+    id: labelId,
+    sx: {
+      flexGrow: slots.InlineDescription ? 0 : 1
+    }
+  }, props.children), slots.InlineDescription), slots.TrailingVisual), slots.BlockDescription))));
+});
+Item.displayName = 'ActionList.Item';
+
+const ConditionalBox = props => {
+  const {
+    if: condition,
+    ...rest
+  } = props;
+  if (condition) return /*#__PURE__*/React.createElement(Box, rest, props.children);else return /*#__PURE__*/React.createElement(React.Fragment, null, props.children);
+};

package/lib-esm/ActionList2/LinkItem.d.ts

@@ -0,0 +1,17 @@
+import React from 'react';
+import { ForwardRefComponent as PolymorphicForwardRefComponent } from '@radix-ui/react-polymorphic';
+import { ItemProps } from './Item';
+declare type LinkProps = {
+    download?: string;
+    href?: string;
+    hrefLang?: string;
+    media?: string;
+    ping?: string;
+    rel?: string;
+    target?: string;
+    type?: string;
+    referrerPolicy?: React.AnchorHTMLAttributes<HTMLAnchorElement>['referrerPolicy'];
+};
+declare type LinkItemProps = Pick<ItemProps, 'children' | 'sx'> & LinkProps;
+export declare const LinkItem: PolymorphicForwardRefComponent<"a", LinkItemProps>;
+export {};

package/lib-esm/ActionList2/LinkItem.js

@@ -0,0 +1,43 @@
+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 Link from '../Link';
+import { merge } from '../sx';
+import { Item } from './Item'; // adopted from React.AnchorHTMLAttributes
+
+export const LinkItem = /*#__PURE__*/React.forwardRef(({
+  sx = {},
+  as: Component,
+  ...props
+}, forwardedRef) => {
+  const styles = {
+    // occupy full size of Item
+    paddingX: 2,
+    paddingY: '6px',
+    // custom value off the scale
+    display: 'flex',
+    flexGrow: 1,
+    // full width
+    borderRadius: 2,
+    // inherit Item styles
+    color: 'inherit',
+    '&:hover': {
+      color: 'inherit',
+      textDecoration: 'none'
+    }
+  };
+  return /*#__PURE__*/React.createElement(Item, {
+    sx: {
+      paddingY: 0,
+      paddingX: 0
+    },
+    _PrivateItemWrapper: ({
+      children
+    }) => /*#__PURE__*/React.createElement(Link, _extends({
+      as: Component,
+      sx: merge(styles, sx)
+    }, props, {
+      ref: forwardedRef
+    }), children)
+  }, props.children);
+});

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

@@ -0,0 +1,26 @@
+import React from 'react';
+import { ForwardRefComponent as PolymorphicForwardRefComponent } from '@radix-ui/react-polymorphic';
+import { SxProp } from '../sx';
+import { AriaRole } from '../utils/types';
+export declare type ListProps = {
+    /**
+     * `inset` children are offset (vertically and horizontally) from `List`’s edges, `full` children are flush (vertically and horizontally) with `List` edges
+     */
+    variant?: 'inset' | 'full';
+    /**
+     * Whether multiple Items or a single Item can be selected.
+     */
+    selectionVariant?: 'single' | 'multiple';
+    /**
+     * Display a divider above each `Item` in this `List` when it does not follow a `Header` or `Divider`.
+     */
+    showDividers?: boolean;
+    /**
+     * The ARIA role describing the function of `List` component. `listbox` or `menu` are a common values.
+     */
+    role?: AriaRole;
+} & SxProp;
+declare type ContextProps = Pick<ListProps, 'variant' | 'selectionVariant' | 'showDividers'>;
+export declare const ListContext: React.Context<ContextProps>;
+export declare const List: PolymorphicForwardRefComponent<"ul", ListProps>;
+export {};

package/lib-esm/ActionList2/List.js

@@ -0,0 +1,37 @@
+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 from 'styled-components';
+import sx, { merge } from '../sx';
+export const ListContext = /*#__PURE__*/React.createContext({});
+const ListBox = styled.ul.withConfig({
+  displayName: "List__ListBox",
+  componentId: "cvbq60-0"
+})(sx);
+export const List = /*#__PURE__*/React.forwardRef(({
+  variant = 'inset',
+  selectionVariant,
+  showDividers = false,
+  sx: sxProp = {},
+  ...props
+}, forwardedRef) => {
+  const styles = {
+    margin: 0,
+    paddingInlineStart: 0,
+    // reset ul styles
+    paddingY: variant === 'inset' ? 2 : 0
+  };
+  return /*#__PURE__*/React.createElement(ListBox, _extends({
+    sx: merge(styles, sxProp),
+    "aria-multiselectable": selectionVariant === 'multiple' ? true : undefined
+  }, props, {
+    ref: forwardedRef
+  }), /*#__PURE__*/React.createElement(ListContext.Provider, {
+    value: {
+      variant,
+      selectionVariant,
+      showDividers
+    }
+  }, props.children));
+});
+List.displayName = 'ActionList';

package/lib-esm/ActionList2/Selection.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import { ItemProps } from './Item';
+declare type SelectionProps = Pick<ItemProps, 'selected'>;
+export declare const Selection: React.FC<SelectionProps>;
+export {};

package/lib-esm/ActionList2/Selection.js

@@ -0,0 +1,66 @@
+import React from 'react';
+import { CheckIcon } from '@primer/octicons-react';
+import { ListContext } from './List';
+import { GroupContext } from './Group';
+import { LeadingVisualContainer } from './Visuals';
+export const Selection = ({
+  selected
+}) => {
+  const {
+    selectionVariant: listSelectionVariant
+  } = React.useContext(ListContext);
+  const {
+    selectionVariant: groupSelectionVariant
+  } = React.useContext(GroupContext);
+  /** selectionVariant in Group can override the selectionVariant in List root */
+
+  const selectionVariant = typeof groupSelectionVariant !== 'undefined' ? groupSelectionVariant : listSelectionVariant; // if selectionVariant is not set on List, don't show selection
+
+  if (!selectionVariant) {
+    // to avoid confusion, fail loudly instead of silently ignoring
+    if (selected) throw new Error('For Item to be selected, ActionList or ActionList.Group needs to have a selectionVariant defined');
+    return null;
+  }
+
+  if (selectionVariant === 'single') {
+    return /*#__PURE__*/React.createElement(LeadingVisualContainer, null, selected && /*#__PURE__*/React.createElement(CheckIcon, null));
+  }
+  /**
+   * selectionVariant is multiple
+   * we use a svg instead of an input because there should not
+   * be an interactive element inside an option
+   * svg copied from primer/css
+   */
+
+
+  return /*#__PURE__*/React.createElement(LeadingVisualContainer, {
+    sx: {
+      rect: {
+        fill: selected ? 'accent.fg' : 'canvas.default',
+        stroke: selected ? 'accent.fg' : 'border.default'
+      },
+      path: {
+        fill: 'fg.onEmphasis',
+        boxShadow: 'shadow.small',
+        opacity: selected ? 1 : 0
+      }
+    }
+  }, /*#__PURE__*/React.createElement("svg", {
+    width: "16",
+    height: "16",
+    viewBox: "0 0 16 16",
+    xmlns: "http://www.w3.org/2000/svg",
+    "aria-hidden": "true"
+  }, /*#__PURE__*/React.createElement("rect", {
+    x: "2",
+    y: "2",
+    width: "12",
+    height: "12",
+    rx: "4"
+  }), /*#__PURE__*/React.createElement("path", {
+    fillRule: "evenodd",
+    strokeWidth: "0",
+    d: "M4.03231 8.69862C3.84775 8.20646 4.49385 7.77554 4.95539 7.77554C5.41693 7.77554 6.80154 9.85246 6.80154 9.85246C6.80154 9.85246 10.2631 4.314 10.4938 4.08323C10.7246 3.85246 11.8785 4.08323 11.4169 5.00631C11.0081 5.82388 7.26308 11.4678 7.26308 11.4678C7.26308 11.4678 6.80154 12.1602 6.34 11.4678C5.87846 10.7755 4.21687 9.19077 4.03231 8.69862Z"
+  })));
+};
+Selection.displayName = "Selection";

package/lib-esm/ActionList2/Visuals.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import { SxProp } from '../sx';
+declare type VisualProps = SxProp & React.HTMLAttributes<HTMLSpanElement>;
+export declare const LeadingVisualContainer: React.FC<VisualProps>;
+export declare type LeadingVisualProps = VisualProps;
+export declare const LeadingVisual: React.FC<VisualProps>;
+export declare type TrailingVisualProps = VisualProps;
+export declare const TrailingVisual: React.FC<VisualProps>;
+export {};

package/lib-esm/ActionList2/Visuals.js

@@ -0,0 +1,68 @@
+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 Box from '../Box';
+import { merge } from '../sx';
+import { get } from '../constants';
+import { getVariantStyles, Slot, TEXT_ROW_HEIGHT } from './Item';
+export const LeadingVisualContainer = ({
+  sx = {},
+  ...props
+}) => {
+  return /*#__PURE__*/React.createElement(Box, _extends({
+    as: "span",
+    sx: merge({
+      height: TEXT_ROW_HEIGHT,
+      // match height of text row
+      minWidth: get('space.3'),
+      maxWidth: TEXT_ROW_HEIGHT,
+      // square (same as height)
+      display: 'flex',
+      justifyContent: 'center',
+      alignItems: 'center',
+      flexShrink: 0,
+      marginRight: 2
+    }, sx)
+  }, props));
+};
+LeadingVisualContainer.displayName = "LeadingVisualContainer";
+export const LeadingVisual = ({
+  sx = {},
+  ...props
+}) => {
+  return /*#__PURE__*/React.createElement(Slot, {
+    name: "LeadingVisual"
+  }, ({
+    variant,
+    disabled
+  }) => /*#__PURE__*/React.createElement(LeadingVisualContainer, _extends({
+    sx: merge({
+      color: getVariantStyles(variant, disabled).iconColor,
+      svg: {
+        fontSize: 0
+      }
+    }, sx)
+  }, props), props.children));
+};
+LeadingVisual.displayName = "LeadingVisual";
+export const TrailingVisual = ({
+  sx = {},
+  ...props
+}) => {
+  return /*#__PURE__*/React.createElement(Slot, {
+    name: "TrailingVisual"
+  }, ({
+    variant,
+    disabled
+  }) => /*#__PURE__*/React.createElement(Box, _extends({
+    as: "span",
+    sx: merge({
+      height: '20px',
+      // match height of text row
+      flexShrink: 0,
+      color: getVariantStyles(variant, disabled).annotationColor,
+      marginLeft: 2
+    }, sx)
+  }, props), props.children));
+};
+TrailingVisual.displayName = "TrailingVisual";

package/lib-esm/ActionList2/index.d.ts

@@ -0,0 +1,36 @@
+/// <reference types="react" />
+import { Divider } from './Divider';
+export type { ListProps as ActionListProps } from './List';
+export type { GroupProps } from './Group';
+export type { ItemProps } from './Item';
+export type { DescriptionProps } from './Description';
+export type { LeadingVisualProps, TrailingVisualProps } from './Visuals';
+/**
+ * Collection of list-related components.
+ */
+export declare const ActionList: import("@radix-ui/react-polymorphic").ForwardRefComponent<"ul", import("./List").ListProps> & {
+    /** Collects related `Items` in an `ActionList`. */
+    Group: import("react").FC<import("./Group").GroupProps>;
+    /** An actionable or selectable `Item` */
+    Item: import("@radix-ui/react-polymorphic").ForwardRefComponent<"li", import("./Item").ItemProps>;
+    /** A `Item` that renders a full-size anchor inside ListItem */
+    LinkItem: import("@radix-ui/react-polymorphic").ForwardRefComponent<"a", Pick<import("./Item").ItemProps, "children" | "sx"> & {
+        download?: string | undefined;
+        href?: string | undefined;
+        hrefLang?: string | undefined;
+        media?: string | undefined;
+        ping?: string | undefined;
+        rel?: string | undefined;
+        target?: string | undefined;
+        type?: string | undefined;
+        referrerPolicy?: import("react").HTMLAttributeReferrerPolicy | undefined;
+    }>;
+    /** Visually separates `Item`s or `Group`s in an `ActionList`. */
+    Divider: typeof Divider;
+    /** Secondary text which provides additional information about an `Item`. */
+    Description: import("react").FC<import("./Description").DescriptionProps>;
+    /** Icon (or similar) positioned before `Item` text. */
+    LeadingVisual: import("react").FC<import("../sx").SxProp & import("react").HTMLAttributes<HTMLSpanElement>>;
+    /** Icon (or similar) positioned after `Item` text. */
+    TrailingVisual: import("react").FC<import("../sx").SxProp & import("react").HTMLAttributes<HTMLSpanElement>>;
+};

package/lib-esm/ActionList2/index.js

@@ -0,0 +1,33 @@
+import { List } from './List';
+import { Group } from './Group';
+import { Item } from './Item';
+import { LinkItem } from './LinkItem';
+import { Divider } from './Divider';
+import { Description } from './Description';
+import { LeadingVisual, TrailingVisual } from './Visuals';
+
+/**
+ * Collection of list-related components.
+ */
+export const ActionList = Object.assign(List, {
+  /** Collects related `Items` in an `ActionList`. */
+  Group,
+
+  /** An actionable or selectable `Item` */
+  Item,
+
+  /** A `Item` that renders a full-size anchor inside ListItem */
+  LinkItem,
+
+  /** Visually separates `Item`s or `Group`s in an `ActionList`. */
+  Divider,
+
+  /** Secondary text which provides additional information about an `Item`. */
+  Description,
+
+  /** Icon (or similar) positioned before `Item` text. */
+  LeadingVisual,
+
+  /** Icon (or similar) positioned after `Item` text. */
+  TrailingVisual
+});