@true-engineering/true-react-common-ui-kit 1.0.1

package/src/components/Input/Input.tsx

@@ -0,0 +1,308 @@
+import {
+  forwardRef,
+  useRef,
+  useState,
+  MutableRefObject,
+  FormEvent,
+  FocusEvent,
+  MouseEvent,
+  KeyboardEvent,
+  ClipboardEvent,
+  InputHTMLAttributes,
+} from 'react';
+import clsx from 'clsx';
+import InputMask, { Props as ReactInputMaskProps } from 'react-input-mask';
+
+import { Icon, IIconProps } from '../Icon';
+import { ThemedPreloader } from '../ThemedPreloader';
+import { addDataAttributes, addDataTestId, isNotEmpty } from '../../helpers';
+import { ICommonProps } from '../../types';
+import { useTheme, useTweakStyles } from '../../hooks';
+
+import { InputStyles, styles } from './Input.styles';
+
+export const DEFAULT_SIZE = 6;
+
+export interface IInputProps extends ICommonProps {
+  tweakStyles?: InputStyles;
+  value?: string;
+  label?: string;
+  placeholder?: string;
+  /**
+   * @default `text`
+   */
+  type?: 'text' | 'password' | 'email' | 'number';
+  isDisabled?: boolean;
+  /**
+   * @default true
+   */
+  hasFloatingLabel?: boolean;
+  isReadonly?: boolean;
+  isInvalid?: boolean;
+  isActive?: boolean;
+  isClearable?: boolean;
+  infoMessage?: string;
+  errorMessage?: string;
+  /**
+   * @default `bottom`
+   */
+  errorPosition?: 'top' | 'bottom';
+  inlineStyle?:
+    | 'top'
+    | 'bottom'
+    | 'top-left'
+    | 'top-right'
+    | 'bottom-left'
+    | 'bottom-right'
+    | 'left'
+    | 'right'
+    | 'middle';
+  border?: 'top' | 'bottom' | 'left' | 'right';
+  isRequired?: boolean;
+  isLoading?: boolean;
+  /**
+   * Должна ли ширина input'а подстраиваться под ширину контента
+   * @default false
+   */
+  isAutoSizeable?: boolean;
+  /**
+   * Ширина input'а по умолчанию. Используется только вместе с `isAutoSizeable` равному `true`
+   * @default 6
+   */
+  defaultSize?: number;
+  iconType?: IIconProps['type'];
+  units?: string;
+  name?: string;
+  mask?: ReactInputMaskProps['mask'];
+  maskPlaceholder?: ReactInputMaskProps['maskPlaceholder'];
+  hasRequiredLabel?: boolean;
+  shouldFocusOnMount?: boolean;
+  maxLength?: number;
+  testId?: string;
+  tabIndex?: number;
+
+  onChange(value: string, event: FormEvent<HTMLInputElement>): void;
+  onFocus?(event: FocusEvent<HTMLInputElement>): void;
+  onBlur?(event: FocusEvent<HTMLInputElement>): void;
+  onPaste?(event: ClipboardEvent<HTMLInputElement>): void;
+  onIconClick?(): void;
+  onKeyDown?(event: KeyboardEvent<HTMLInputElement>): void;
+}
+
+export const Input = forwardRef<HTMLInputElement, IInputProps>(
+  (
+    {
+      value = '',
+      label,
+      placeholder,
+      type = 'text',
+      isDisabled,
+      isReadonly,
+      hasFloatingLabel = true,
+      isInvalid = false,
+      isActive = false,
+      isClearable = false,
+      infoMessage,
+      errorMessage,
+      errorPosition = 'bottom',
+      inlineStyle,
+      border,
+      isRequired,
+      isLoading,
+      isAutoSizeable,
+      defaultSize = DEFAULT_SIZE,
+      iconType,
+      name,
+      mask,
+      maskPlaceholder,
+      hasRequiredLabel,
+      data,
+      tweakStyles,
+      maxLength,
+      shouldFocusOnMount,
+      units,
+      testId,
+      tabIndex,
+      onChange,
+      onPaste,
+      onFocus,
+      onBlur,
+      onIconClick,
+      onKeyDown,
+    },
+    ref,
+  ) => {
+    const { classes, componentStyles } = useTheme('Input', styles, tweakStyles);
+
+    const [isFocused, setFocused] = useState(false);
+    const inputRef = useRef<HTMLInputElement>(null);
+
+    const handleChange = (event: FormEvent<HTMLInputElement>) => {
+      onChange(event.currentTarget.value, event);
+    };
+
+    const handleFocus = (event: FocusEvent<HTMLInputElement>) => {
+      setFocused(true);
+      onFocus?.(event);
+    };
+
+    const handleBlur = (event: FocusEvent<HTMLInputElement>) => {
+      setFocused(false);
+      onBlur?.(event);
+    };
+
+    // для SmartInput нужен event, иначе onChange не вызовется
+    const handleOnInputClear = async (event: MouseEvent<HTMLDivElement>) => {
+      // await не убирать (важно для порядка выполнения (сначала onChange, затем focus)
+      await onChange('', event as any);
+      const input = (ref as MutableRefObject<HTMLInputElement>) ?? inputRef;
+      input.current?.focus();
+    };
+
+    const hasFocus = isFocused || isActive;
+    const hasClearIcon = isClearable && value.length > 0;
+    const hasControls = hasClearIcon || iconType !== undefined || isLoading;
+    const hasValue = value !== undefined && value !== '';
+    const hasUnits = units !== undefined && units !== '';
+    const hasLabel = isNotEmpty(label);
+    const hasPlaceholder =
+      (!hasLabel || (hasFocus && !isReadonly)) && isNotEmpty(placeholder);
+
+    const props: InputHTMLAttributes<HTMLInputElement> = {
+      className: clsx(classes.input, {
+        [classes.withFloatingLabel]: hasFloatingLabel && hasLabel,
+        [classes.withIcons]: hasControls,
+        [classes.withControls]: hasControls,
+        [classes.floatingLabelWithoutPadding]:
+          hasFloatingLabel && hasLabel && border === 'bottom',
+      }),
+      onFocus: handleFocus,
+      onBlur: handleBlur,
+      onChange: handleChange,
+      onKeyDown,
+      onPaste,
+      value,
+      type,
+      disabled: isDisabled,
+      placeholder: hasPlaceholder ? placeholder : undefined,
+      name,
+      maxLength,
+      autoFocus: shouldFocusOnMount,
+      readOnly: isReadonly,
+      size: isAutoSizeable ? defaultSize : undefined,
+      tabIndex,
+      ...addDataTestId(testId),
+    };
+
+    const tweakPreloaderStyles = useTweakStyles(
+      componentStyles,
+      tweakStyles,
+      'tweakPreloader',
+    );
+
+    return (
+      <div className={classes.root}>
+        <div
+          className={clsx(
+            classes.inputWrapper,
+            {
+              [classes.required]: isRequired && !hasRequiredLabel,
+              [classes.invalid]: isInvalid,
+              [classes.focused]: hasFocus,
+              [classes.disabled]: isDisabled,
+              [classes.autosize]: isAutoSizeable,
+            },
+            inlineStyle !== undefined && classes[inlineStyle],
+            border !== undefined && classes[`border-${border}`],
+          )}
+          data-value={isAutoSizeable ? value : undefined}
+          {...addDataAttributes(data)}
+        >
+          {mask === undefined ? (
+            <input ref={ref ?? inputRef} {...props} />
+          ) : (
+            <InputMask
+              // Баг в типизации react-input-mask
+              // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+              // @ts-ignore: No overload matches this call
+              ref={ref ?? inputRef}
+              mask={mask}
+              maskPlaceholder={maskPlaceholder}
+              {...props}
+            />
+          )}
+          {hasLabel && (
+            <span
+              className={clsx(classes.label, {
+                [classes.invalidLabel]: isInvalid,
+                [classes.requiredLabel]: hasRequiredLabel && !isRequired,
+                [classes.activeLabel]: (hasFocus && !isReadonly) || hasValue,
+                [classes.floating]: hasFloatingLabel,
+                // Обсуждаемо, сделал так, потому что не хочется создавать новую пропсу, на каждый чих в стилях
+                [classes.floatingWithoutPadding]:
+                  hasFloatingLabel && border === 'bottom',
+              })}
+            >
+              {label}
+            </span>
+          )}
+
+          {(hasValue || (isFocused && !hasPlaceholder)) && hasUnits && (
+            <div
+              className={clsx(classes.unitsWrapper, {
+                [classes.withFloatingLabel]: hasFloatingLabel && hasLabel,
+              })}
+            >
+              <span className={classes.fakeValue}>{value}</span>
+              <span className={classes.units}>{units}</span>
+            </div>
+          )}
+
+          {hasControls && (
+            <div className={classes.controls}>
+              {isLoading && (
+                <div className={clsx(classes.inputIcon, classes.loading)}>
+                  <ThemedPreloader tweakStyles={tweakPreloaderStyles} />
+                </div>
+              )}
+
+              {!isDisabled && hasClearIcon && (
+                <div
+                  // .clearIcon extend .icon
+                  className={clsx(classes.clearIcon, classes.activeIcon)}
+                  // превентим блур с инпута (важно)
+                  onMouseDown={(event) => event.preventDefault()}
+                  onClick={handleOnInputClear}
+                >
+                  <Icon type="close" />
+                </div>
+              )}
+              {iconType !== undefined && (
+                <div
+                  // .inputIcon extend .icon
+                  className={clsx(classes.inputIcon, {
+                    [classes.activeIcon]:
+                      !isDisabled && onIconClick !== undefined,
+                  })}
+                  onClick={!isDisabled ? onIconClick : undefined}
+                >
+                  <Icon type={iconType} />
+                </div>
+              )}
+            </div>
+          )}
+        </div>
+        {isNotEmpty(infoMessage) && (
+          <div className={classes.info}>{infoMessage}</div>
+        )}
+        {isNotEmpty(errorMessage) && (
+          <div
+            className={clsx(classes.error, classes[`error-${errorPosition}`])}
+          >
+            {errorMessage}
+          </div>
+        )}
+      </div>
+    );
+  },
+);

package/src/components/Input/index.ts

@@ -0,0 +1,2 @@
+export * from './Input';
+export type { InputStyles } from './Input.styles';

package/src/components/List/List.stories.tsx

@@ -0,0 +1,62 @@
+import { ComponentStory, ComponentMeta } from '@storybook/react';
+import { colors } from '../../theme';
+import { List, IListItem } from './List';
+
+const listItems: IListItem[] = [
+  {
+    item: 'Печатать билет',
+    onClick: console.log,
+    icon: 'sign-out',
+  },
+  { item: 'Выписать', onClick: console.log, withIconGap: true },
+  {
+    item: 'Аннулировать',
+    onClick: console.log,
+    icon: <>2</>,
+  },
+  {
+    item: 'Вернуть',
+    onClick: console.log,
+    disabled: true,
+    withIconGap: true,
+    shouldDrawSpacerBelow: true,
+  },
+  {
+    item: (() => <div style={{ color: colors.RED_ACTIVE }}>Удалить</div>)(),
+    onClick: console.log,
+    disabled: true,
+    withIconGap: true,
+  },
+  {
+    item: (() => <div style={{ color: colors.RED_ACTIVE }}>Удалить</div>)(),
+    onClick: console.log,
+    withIconGap: true,
+  },
+];
+
+export default {
+  title: 'List',
+  component: List,
+  args: {
+    items: listItems,
+  },
+  parameters: {
+    controls: {
+      exclude: ['data', 'tweakStyles', 'testId', 'onClick'],
+    },
+  },
+} as ComponentMeta<typeof List>;
+
+export const Default: ComponentStory<typeof List> = (args) => (
+  <div
+    style={{
+      border: '1px dotted rgba(0,0,0,.2)',
+      display: 'flex',
+      alignItems: 'center',
+      justifyContent: 'center',
+      padding: 40,
+    }}
+  >
+    <List {...args} />
+  </div>
+);

package/src/components/List/List.styles.ts

@@ -0,0 +1,52 @@
+import { colors } from '../../theme';
+import { ComponentStyles } from '../../types';
+
+const ITEM_HORIZONTAL_PADDING = 16;
+const ICON_SIZE = 20;
+const ICON_GAP = 12;
+
+export const styles = {
+  root: {
+    minWidth: 180,
+    backgroundColor: colors.CLASSIC_WHITE,
+    padding: [8, 0],
+    listStyle: 'none',
+    margin: 0,
+  },
+
+  item: {
+    display: 'flex',
+    alignItems: 'center',
+    boxSizing: 'border-box',
+    fontSize: 16,
+    whiteSpace: 'nowrap',
+    minHeight: 40,
+    padding: [0, ITEM_HORIZONTAL_PADDING],
+    transition: 'background-color 0.25s ease-in-out',
+    cursor: 'pointer',
+  },
+
+  disabledItem: {
+    cursor: 'default',
+  },
+
+  spacer: {
+    height: 1,
+    backgroundColor: colors.BORDER_LIGHT,
+  },
+
+  withIconGap: {
+    paddingLeft: ITEM_HORIZONTAL_PADDING + ICON_SIZE + ICON_GAP,
+  },
+
+  icon: {
+    width: ICON_SIZE,
+    height: ICON_SIZE,
+    marginRight: ICON_GAP,
+    flexShrink: 0,
+  },
+
+  content: {},
+};
+
+export type ListStyles = ComponentStyles<typeof styles>;

package/src/components/List/List.tsx

@@ -0,0 +1,75 @@
+import { FC, Fragment, ReactElement, ReactNode } from 'react';
+import clsx from 'clsx';
+import { useTheme } from '../../hooks';
+import { ICommonProps } from '../../types';
+import { isNotEmpty, addDataTestId, addDataAttributes } from '../../helpers';
+import { Icon, IIconType } from '../Icon';
+
+import { ListStyles, styles } from './List.styles';
+
+export interface IListItem {
+  item: ReactNode;
+  icon?: IIconType | ReactElement;
+  disabled?: boolean;
+  shouldDrawSpacerAbove?: boolean;
+  shouldDrawSpacerBelow?: boolean;
+  withIconGap?: boolean;
+  testId?: string;
+  onClick(): void;
+}
+
+export interface IListProps extends ICommonProps {
+  tweakStyles?: ListStyles;
+  items: IListItem[];
+  testId?: string;
+  onClick?(): void;
+}
+
+export const List: FC<IListProps> = ({
+  items,
+  testId,
+  data,
+  tweakStyles,
+  onClick,
+}) => {
+  const { classes } = useTheme('List', styles, tweakStyles);
+
+  const handleItemClick = (item: IListItem) => {
+    item.onClick();
+    onClick?.();
+  };
+
+  return (
+    <div
+      className={classes.root}
+      {...addDataTestId(testId)}
+      {...addDataAttributes(data)}
+    >
+      {items.map((item, idx) => (
+        <Fragment key={idx}>
+          {item.shouldDrawSpacerAbove && <div className={classes.spacer} />}
+          <div
+            className={clsx(classes.item, {
+              [classes.disabledItem]: item.disabled,
+              [classes.withIconGap]: item.withIconGap,
+            })}
+            {...addDataTestId(testId, `item-${idx}`)}
+            onClick={item.disabled ? undefined : () => handleItemClick(item)}
+          >
+            {isNotEmpty(item.icon) && (
+              <span className={classes.icon}>
+                {typeof item.icon === 'string' ? (
+                  <Icon type={item.icon} />
+                ) : (
+                  item.icon
+                )}
+              </span>
+            )}
+            <span className={classes.content}>{item.item}</span>
+          </div>
+          {item.shouldDrawSpacerBelow && <div className={classes.spacer} />}
+        </Fragment>
+      ))}
+    </div>
+  );
+};

package/src/components/List/index.ts

@@ -0,0 +1,2 @@
+export * from './List';
+export type { ListStyles } from './List.styles';

package/src/components/Modal/Modal.stories.tsx

@@ -0,0 +1,113 @@
+import { ComponentStory } from '@storybook/react';
+import { FC, useState } from 'react';
+import { IModalProps, Modal } from './Modal';
+import { Button } from '../Button';
+
+const smallText =
+  'Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.';
+const text =
+  'Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat.';
+const largeText = [...text, ...text, ...text];
+const texts = { small: smallText, medium: text, large: largeText };
+
+export interface IModalWithCustomProps extends IModalProps {
+  textSize: 'small' | 'medium' | 'large';
+}
+
+const ModalWithCustomProps: FC<IModalWithCustomProps> = ({
+  size,
+  textSize,
+  ...args
+}) => {
+  const [isModalOpen, setIsModalOpen] = useState(false);
+  const [isSecondModalOpen, setIsSecondModalOpen] = useState(false);
+
+  return (
+    <div>
+      <Button onClick={() => setIsModalOpen(true)}>Open</Button>
+      <Button onClick={() => setIsSecondModalOpen(true)}>Open 2</Button>
+
+      <Modal
+        {...args}
+        isOpen={isModalOpen}
+        onClose={() => setIsModalOpen(false)}
+        buttons={[
+          <Button
+            key="1"
+            view="secondary"
+            onClick={() => setIsModalOpen(false)}
+            size={size === 's' ? 'm' : 'l'}
+          >
+            Отмена
+          </Button>,
+          <Button
+            key="2"
+            size={size === 's' ? 'm' : 'l'}
+            onClick={() => {
+              setIsModalOpen(false);
+              setIsSecondModalOpen(true);
+            }}
+          >
+            Применить
+          </Button>,
+        ]}
+      >
+        <div style={{ lineHeight: 1.6 }}>{texts[textSize]}</div>
+      </Modal>
+
+      <Modal
+        {...args}
+        isOpen={isSecondModalOpen}
+        onClose={() => setIsSecondModalOpen(false)}
+      >
+        Text
+      </Modal>
+    </div>
+  );
+};
+
+export default {
+  title: 'Modal',
+  component: Modal,
+  argTypes: {
+    buttonsAlign: {
+      control: 'inline-radio',
+      options: ['left', 'center', 'right'],
+    },
+    textSize: {
+      control: 'inline-radio',
+      options: ['small', 'medium', 'large'],
+    },
+    size: { control: 'inline-radio', options: ['s', 'm', 'l'] },
+    position: {
+      control: 'inline-radio',
+      options: ['center', 'left', 'right', 'static'],
+    },
+  },
+};
+
+const Template: ComponentStory<typeof ModalWithCustomProps> = (args) => (
+  <div
+    style={{
+      border: '1px dotted rgba(0,0,0,.2)',
+      height: 1000, // чтобы был скролл на странице
+    }}
+  >
+    <ModalWithCustomProps {...args} />
+  </div>
+);
+
+export const Default = Template.bind({});
+
+Default.args = {
+  title: 'Some modal title',
+  size: 'm',
+  textSize: 'small',
+  buttonsAlign: 'right',
+  shouldCloseOnEsc: true,
+  hasOverlay: true,
+  hasCloseButton: true,
+  shouldCloseOnOverlayClick: true,
+  shouldBlockScroll: true,
+  isFooterSticky: false,
+};