@true-engineering/true-react-common-ui-kit 3.29.0 → 3.30.0

package/src/components/WithPopup/WithPopup.stories.tsx

@@ -1,99 +1,100 @@
-import { doNothing } from '@true-engineering/true-react-platform-helpers';
-import { ComponentStory } from '@storybook/react';
-import { Button } from '../Button';
-import { IListItem, List } from '../List';
-import { Tooltip } from '../Tooltip';
-import { WithPopup } from './WithPopup';
-
-const positions = [
-  undefined,
-  'top',
-  'bottom',
-  'right',
-  'left',
-  'top-start',
-  'top-end',
-  'bottom-start',
-  'bottom-end',
-  'right-start',
-  'right-end',
-  'left-start',
-  'left-end',
-];
-
-export default {
-  title: 'Data Display/WithPopup',
-  component: WithPopup,
-  argTypes: {
-    placement: { control: 'select', options: positions },
-    eventType: { control: 'inline-radio', options: ['hover', 'click'] },
-  },
-};
-
-const items: IListItem[] = [
-  {
-    item: 'Copy',
-    onClick: doNothing,
-  },
-  {
-    item: 'Paste',
-    onClick: doNothing,
-  },
-  {
-    item: 'Remove',
-    onClick: doNothing,
-  },
-];
-
-const Template: ComponentStory<typeof WithPopup> = (args) => (
-  <div
-    style={{
-      display: 'flex',
-      alignItems: 'center',
-      justifyContent: 'center',
-      flexDirection: 'column',
-      gap: 32,
-      width: 600,
-      height: 400,
-    }}
-  >
-    <div onClick={() => console.log('parent onclick')}>
-      <WithPopup
-        {...args}
-        trigger={(props) => (
-          <Button icon="plus" isFullWidth {...props}>
-            {props.isActive ? 'Click (Active)' : 'Click (Not Active)'}
-          </Button>
-        )}
-      >
-        {({ onClose }) => <List items={items} onClick={onClose} />}
-      </WithPopup>
-    </div>
-    <WithPopup
-      {...args}
-      eventType="hover"
-      trigger={
-        <Button icon="plus" isDisabled={args.isDisabled} isFullWidth>
-          Hover
-        </Button>
-      }
-    >
-      <Tooltip text="Tooltip" />
-    </WithPopup>
-  </div>
-);
-
-export const Default = Template.bind({});
-
-Default.args = {
-  canBeFlipped: true,
-  isDisabled: false,
-  shouldRenderInBody: true,
-  shouldHideOnScroll: false,
-};
-
-Default.parameters = {
-  controls: {
-    exclude: ['trigger', 'data', 'testId', 'middlewares', 'children', 'eventType'],
-  },
-};
+import { doNothing } from '@true-engineering/true-react-platform-helpers';
+import { ComponentStory } from '@storybook/react';
+import { Button } from '../Button';
+import { IListItem, List } from '../List';
+import { Tooltip } from '../Tooltip';
+import { WithPopup } from './WithPopup';
+
+const positions = [
+  undefined,
+  'top',
+  'bottom',
+  'right',
+  'left',
+  'top-start',
+  'top-end',
+  'bottom-start',
+  'bottom-end',
+  'right-start',
+  'right-end',
+  'left-start',
+  'left-end',
+];
+
+export default {
+  title: 'Data Display/WithPopup',
+  component: WithPopup,
+  argTypes: {
+    placement: { control: 'select', options: positions },
+    eventType: { control: 'inline-radio', options: ['hover', 'click'] },
+  },
+};
+
+const items: IListItem[] = [
+  {
+    item: 'Copy',
+    onClick: doNothing,
+  },
+  {
+    item: 'Paste',
+    onClick: doNothing,
+  },
+  {
+    item: 'Remove',
+    onClick: doNothing,
+  },
+];
+
+const Template: ComponentStory<typeof WithPopup> = (args) => (
+  <div
+    style={{
+      display: 'flex',
+      alignItems: 'center',
+      justifyContent: 'center',
+      flexDirection: 'column',
+      gap: 32,
+      width: 600,
+      height: 400,
+    }}
+  >
+    <div onClick={() => console.log('parent onclick')}>
+      <WithPopup
+        {...args}
+        trigger={(props) => (
+          <Button icon="plus" isFullWidth {...props}>
+            {props.isActive ? 'Click (Active)' : 'Click (Not Active)'}
+          </Button>
+        )}
+      >
+        {({ onClose }) => <List items={items} onClick={onClose} />}
+      </WithPopup>
+    </div>
+    <WithPopup
+      {...args}
+      eventType="hover"
+      trigger={
+        <Button icon="plus" isDisabled={args.isDisabled} isFullWidth>
+          Hover
+        </Button>
+      }
+    >
+      <Tooltip text="Tooltip" />
+    </WithPopup>
+  </div>
+);
+
+export const Default = Template.bind({});
+
+Default.args = {
+  canBeFlipped: true,
+  isDisabled: false,
+  shouldRenderInBody: true,
+  shouldHideOnScroll: false,
+  shouldStopPropagation: true,
+};
+
+Default.parameters = {
+  controls: {
+    exclude: ['trigger', 'data', 'testId', 'middlewares', 'children', 'eventType'],
+  },
+};

package/src/components/WithPopup/WithPopup.styles.ts

@@ -1,40 +1,40 @@
-import { createThemedStyles, ITweakStyles } from '../../theme';
-
-export const useStyles = createThemedStyles('WithPopup', {
-  trigger: {
-    width: 'fit-content',
-    cursor: 'pointer',
-  },
-
-  disabled: {
-    cursor: 'default',
-  },
-
-  popup: {
-    zIndex: 5,
-    outline: 'none',
-  },
-
-  animationEnd: {},
-
-  animationStart: {},
-
-  'dropdown-initial': {
-    extend: 'animationEnd',
-  },
-
-  'dropdown-open': {
-    extend: 'animationStart',
-  },
-
-  'dropdown-close': {
-    visibility: 'hidden',
-    extend: 'animationEnd',
-  },
-
-  'dropdown-unmounted': {
-    extend: 'animationEnd',
-  },
-});
-
-export type IWithPopupStyles = ITweakStyles<typeof useStyles>;
+import { createThemedStyles, ITweakStyles } from '../../theme';
+
+export const useStyles = createThemedStyles('WithPopup', {
+  trigger: {
+    width: 'fit-content',
+    cursor: 'pointer',
+  },
+
+  disabled: {
+    cursor: 'default',
+  },
+
+  popup: {
+    zIndex: 5,
+    outline: 'none',
+  },
+
+  animationEnd: {},
+
+  animationStart: {},
+
+  'dropdown-initial': {
+    extend: 'animationEnd',
+  },
+
+  'dropdown-open': {
+    extend: 'animationStart',
+  },
+
+  'dropdown-close': {
+    visibility: 'hidden',
+    extend: 'animationEnd',
+  },
+
+  'dropdown-unmounted': {
+    extend: 'animationEnd',
+  },
+});
+
+export type IWithPopupStyles = ITweakStyles<typeof useStyles>;

package/src/components/WithPopup/WithPopup.tsx

@@ -1,166 +1,173 @@
-import { FC, useState } from 'react';
-import clsx from 'clsx';
-import {
-  addDataTestId,
-  applyAction,
-  isFunction,
-} from '@true-engineering/true-react-platform-helpers';
-import {
-  autoUpdate,
-  useFloating,
-  useClick,
-  useDismiss,
-  useHover,
-  useInteractions,
-  Placement,
-  Middleware,
-  FloatingPortal,
-  offset,
-  flip,
-  useTransitionStatus,
-  OffsetOptions,
-  UseHoverProps,
-  safePolygon,
-  useFocus,
-} from '@floating-ui/react';
-import { addDataAttributes } from '../../helpers';
-import { ICommonProps, IRenderNode } from '../../types';
-import { DEFAULT_OFFSET } from './constants';
-import {
-  IPopupEventType,
-  IWithPopupChildrenProps,
-  IWithPopupToggleEvent,
-  IWithPopupTriggerProps,
-} from './types';
-import { useStyles, IWithPopupStyles } from './WithPopup.styles';
-
-export interface IWithPopupProps extends ICommonProps<IWithPopupStyles> {
-  trigger: IRenderNode<IWithPopupTriggerProps>;
-  children: IRenderNode<IWithPopupChildrenProps>;
-  middlewares?: Middleware[];
-  /** @default eventType === 'click' ? 'bottom-end' : 'top' */
-  placement?: Placement;
-  /** @default 'click' */
-  eventType?: IPopupEventType;
-  /** @default 0 */
-  hoverDelay?: UseHoverProps['delay'];
-  /** @default 6 */
-  popupOffset?: OffsetOptions;
-  /** @default false */
-  shouldHideOnScroll?: boolean;
-  /** @default true */
-  shouldRenderInBody?: boolean;
-  /** Должен ли WithPopup рендерить свой div-wrapper в качестве триггера
-   * @default true, if eventType === hover */
-  isTriggerWrapped?: boolean;
-  /** @default true */
-  canBeFlipped?: boolean;
-  /** @default false */
-  isDisabled?: boolean;
-  onToggle?: (isActive: boolean, event?: IWithPopupToggleEvent) => void;
-}
-
-export const WithPopup: FC<IWithPopupProps> = ({
-  trigger,
-  children,
-  middlewares = [],
-  eventType = 'click',
-  placement = eventType === 'click' ? 'bottom-end' : 'top',
-  hoverDelay = 0,
-  popupOffset = DEFAULT_OFFSET,
-  shouldHideOnScroll = false,
-  shouldRenderInBody = true,
-  canBeFlipped = true,
-  isTriggerWrapped = eventType === 'hover',
-  isDisabled = false,
-  tweakStyles,
-  data,
-  testId,
-  onToggle,
-}) => {
-  const classes = useStyles({ theme: tweakStyles });
-
-  const [isOpen, setIsOpen] = useState(false);
-
-  const handleToggle = (isActive: boolean, event?: IWithPopupToggleEvent) => {
-    event?.stopPropagation();
-    if (!isDisabled) {
-      onToggle?.(isActive, event);
-      setIsOpen(isActive);
-    }
-  };
-
-  const handleClose = (event?: IWithPopupToggleEvent) => {
-    handleToggle(false, event);
-  };
-
-  const { refs, floatingStyles, context } = useFloating({
-    open: isOpen,
-    middleware: [offset(popupOffset), ...(canBeFlipped ? [flip()] : []), ...middlewares],
-    whileElementsMounted: autoUpdate,
-    placement,
-    onOpenChange: handleToggle,
-  });
-
-  const hover = useHover(context, {
-    enabled: eventType === 'hover',
-    delay: typeof hoverDelay === 'number' ? { open: hoverDelay, close: 0 } : hoverDelay,
-    handleClose: safePolygon(),
-  });
-
-  const focus = useFocus(context, { enabled: eventType === 'hover' });
-
-  const click = useClick(context, { enabled: eventType === 'click' });
-
-  const dismiss = useDismiss(context, {
-    enabled: eventType === 'click',
-    ancestorScroll: shouldHideOnScroll,
-  });
-
-  const { getFloatingProps, getReferenceProps } = useInteractions([hover, click, focus, dismiss]);
-
-  const { isMounted, status } = useTransitionStatus(context, { duration: { close: 500 } });
-
-  const referenceProps: Partial<IWithPopupTriggerProps> = getReferenceProps({
-    ref: refs.setReference,
-  });
-
-  const triggerElement = applyAction(trigger, {
-    isActive: isOpen,
-    ...(isDisabled ? { isDisabled: true } : undefined),
-    ...(!isTriggerWrapped ? referenceProps : undefined),
-  });
-
-  return (
-    <>
-      {isTriggerWrapped ? (
-        <div
-          className={clsx(classes.trigger, { [classes.disabled]: isDisabled })}
-          {...referenceProps}
-          {...addDataTestId(testId)}
-          {...addDataAttributes(data)}
-        >
-          {triggerElement}
-        </div>
-      ) : (
-        triggerElement
-      )}
-      {isMounted && (
-        <FloatingPortal
-          root={!shouldRenderInBody ? (refs.reference.current as HTMLDivElement) : undefined}
-        >
-          <div
-            style={floatingStyles}
-            className={classes.popup}
-            ref={refs.setFloating}
-            {...getFloatingProps()}
-          >
-            <div className={classes[`dropdown-${status}`]}>
-              {isFunction(children) ? children({ onClose: handleClose }) : children}
-            </div>
-          </div>
-        </FloatingPortal>
-      )}
-    </>
-  );
-};
+import { FC, useState } from 'react';
+import clsx from 'clsx';
+import {
+  addDataTestId,
+  applyAction,
+  isFunction,
+  stopPropagation,
+} from '@true-engineering/true-react-platform-helpers';
+import {
+  autoUpdate,
+  useFloating,
+  useClick,
+  useDismiss,
+  useHover,
+  useInteractions,
+  Placement,
+  Middleware,
+  FloatingPortal,
+  offset,
+  flip,
+  useTransitionStatus,
+  OffsetOptions,
+  UseHoverProps,
+  safePolygon,
+  useFocus,
+} from '@floating-ui/react';
+import { addDataAttributes } from '../../helpers';
+import { ICommonProps, IRenderNode } from '../../types';
+import { DEFAULT_OFFSET } from './constants';
+import {
+  IPopupEventType,
+  IWithPopupChildrenProps,
+  IWithPopupToggleEvent,
+  IWithPopupTriggerProps,
+} from './types';
+import { useStyles, IWithPopupStyles } from './WithPopup.styles';
+
+export interface IWithPopupProps extends ICommonProps<IWithPopupStyles> {
+  trigger: IRenderNode<IWithPopupTriggerProps>;
+  children: IRenderNode<IWithPopupChildrenProps>;
+  middlewares?: Middleware[];
+  /** @default eventType === 'click' ? 'bottom-end' : 'top' */
+  placement?: Placement;
+  /** @default 'click' */
+  eventType?: IPopupEventType;
+  /** @default 0 */
+  hoverDelay?: UseHoverProps['delay'];
+  /** @default 6 */
+  popupOffset?: OffsetOptions;
+  /** @default true */
+  shouldStopPropagation?: boolean;
+  /** @default false */
+  shouldHideOnScroll?: boolean;
+  /** @default true */
+  shouldRenderInBody?: boolean;
+  /** Должен ли WithPopup рендерить свой div-wrapper в качестве триггера
+   * @default true, if eventType === hover */
+  isTriggerWrapped?: boolean;
+  /** @default true */
+  canBeFlipped?: boolean;
+  /** @default false */
+  isDisabled?: boolean;
+  onToggle?: (isActive: boolean, event?: IWithPopupToggleEvent) => void;
+}
+
+export const WithPopup: FC<IWithPopupProps> = ({
+  trigger,
+  children,
+  middlewares = [],
+  eventType = 'click',
+  placement = eventType === 'click' ? 'bottom-end' : 'top',
+  hoverDelay = 0,
+  popupOffset = DEFAULT_OFFSET,
+  shouldStopPropagation = true,
+  shouldHideOnScroll = false,
+  shouldRenderInBody = true,
+  canBeFlipped = true,
+  isTriggerWrapped = eventType === 'hover',
+  isDisabled = false,
+  tweakStyles,
+  data,
+  testId,
+  onToggle,
+}) => {
+  const classes = useStyles({ theme: tweakStyles });
+
+  const [isOpen, setIsOpen] = useState(false);
+
+  const handleToggle = (isActive: boolean, event?: IWithPopupToggleEvent) => {
+    event?.stopPropagation();
+    if (!isDisabled) {
+      onToggle?.(isActive, event);
+      setIsOpen(isActive);
+    }
+  };
+
+  const handleClose = (event?: IWithPopupToggleEvent) => {
+    handleToggle(false, event);
+  };
+
+  const { refs, floatingStyles, context } = useFloating({
+    open: isOpen,
+    middleware: [offset(popupOffset), ...(canBeFlipped ? [flip()] : []), ...middlewares],
+    whileElementsMounted: autoUpdate,
+    placement,
+    onOpenChange: handleToggle,
+  });
+
+  const hover = useHover(context, {
+    enabled: eventType === 'hover',
+    delay: typeof hoverDelay === 'number' ? { open: hoverDelay, close: 0 } : hoverDelay,
+    handleClose: safePolygon(),
+  });
+
+  const focus = useFocus(context, { enabled: eventType === 'hover' });
+
+  const click = useClick(context, { enabled: eventType === 'click' });
+
+  const dismiss = useDismiss(context, {
+    enabled: eventType === 'click',
+    ancestorScroll: shouldHideOnScroll,
+  });
+
+  const { getFloatingProps, getReferenceProps } = useInteractions([hover, click, focus, dismiss]);
+
+  const { isMounted, status } = useTransitionStatus(context, { duration: { close: 500 } });
+
+  const referenceProps: Partial<IWithPopupTriggerProps> = getReferenceProps({
+    ref: refs.setReference,
+    ...(shouldStopPropagation && {
+      onClick: stopPropagation,
+    }),
+  });
+
+  const triggerElement = applyAction(trigger, {
+    isActive: isOpen,
+    ...(isDisabled ? { isDisabled: true } : undefined),
+    ...(!isTriggerWrapped ? referenceProps : undefined),
+  });
+
+  return (
+    <>
+      {isTriggerWrapped ? (
+        <div
+          className={clsx(classes.trigger, { [classes.disabled]: isDisabled })}
+          {...referenceProps}
+          {...addDataTestId(testId)}
+          {...addDataAttributes(data)}
+        >
+          {triggerElement}
+        </div>
+      ) : (
+        triggerElement
+      )}
+      {isMounted && (
+        <FloatingPortal
+          root={!shouldRenderInBody ? (refs.reference.current as HTMLDivElement) : undefined}
+        >
+          <div
+            style={floatingStyles}
+            className={classes.popup}
+            ref={refs.setFloating}
+            {...getFloatingProps()}
+          >
+            <div className={classes[`dropdown-${status}`]}>
+              {isFunction(children) ? children({ onClose: handleClose }) : children}
+            </div>
+          </div>
+        </FloatingPortal>
+      )}
+    </>
+  );
+};

package/src/components/WithPopup/constants.ts

@@ -1,3 +1,3 @@
-export const DEFAULT_OFFSET = 6;
-
-export const POPUP_EVENT_TYPES = ['hover', 'click'] as const;
+export const DEFAULT_OFFSET = 6;
+
+export const POPUP_EVENT_TYPES = ['hover', 'click'] as const;

package/src/components/WithPopup/index.ts

@@ -1,2 +1,2 @@
-export * from './WithPopup';
-export type { IWithPopupStyles } from './WithPopup.styles';
+export * from './WithPopup';
+export type { IWithPopupStyles } from './WithPopup.styles';