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

package/src/components/FlexibleTable/components/FlexibleTableCell/FlexibleTableCell.tsx

@@ -1,93 +1,93 @@
-import clsx from 'clsx';
-import { applyAction, isNotEmpty } from '@true-engineering/true-react-platform-helpers';
-import { addDataAttributes } from '../../../../helpers';
-import { ICommonProps } from '../../../../types';
-import { Skeleton } from '../../../Skeleton';
-import { TableRenders } from '../../constants';
-import { formatCellContent } from '../../helpers';
-import {
-  ITableRow,
-  IValueComponentProps,
-  IFlexibleTableConfigType,
-  IFlexibleTableRenderMode,
-  IHeaderContent,
-} from '../../types';
-import { useStyles, IFlexibleTableCellStyles } from './FlexibleTableCell.styles';
-
-export interface IFlexibleTableCellProps<
-  Row extends ITableRow,
-  HeaderContent extends IHeaderContent<Row>,
-> extends Pick<ICommonProps<IFlexibleTableCellStyles>, 'tweakStyles'>,
-    Pick<
-      IValueComponentProps<Row, unknown>,
-      | 'isFocusedRow'
-      | 'isActiveRow'
-      | 'isNestedComponentExpanded'
-      | 'isRowNestedComponentExpanded'
-      | 'onSetNestedComponent'
-    > {
-  row: Row;
-  columnName: keyof Row;
-  config: IFlexibleTableConfigType<Row, HeaderContent>;
-  renderMode: IFlexibleTableRenderMode;
-  isSecond?: boolean;
-  isSticky?: boolean;
-  isLoading?: boolean;
-}
-
-export function FlexibleTableCell<
-  Row extends ITableRow,
-  HeaderContent extends IHeaderContent<Row>,
->({
-  row,
-  columnName,
-  config,
-  renderMode,
-  isSecond,
-  isSticky,
-  isLoading,
-  tweakStyles,
-  ...valueComponentProps
-}: IFlexibleTableCellProps<Row, HeaderContent>): JSX.Element {
-  const classes = useStyles({ theme: tweakStyles });
-
-  const value = row[columnName];
-
-  const {
-    component = formatCellContent(value, config[columnName]),
-    left,
-    right,
-    position,
-    cellAlign,
-    cellVerticalAlign,
-    shouldRenderDataId,
-  } = config[columnName] ?? {};
-
-  const Table = TableRenders[renderMode];
-
-  return (
-    <Table.Cell
-      className={clsx(classes.root, {
-        [classes.sticky]: isSticky,
-        [classes.second]: isSecond,
-        [classes.loading]: isLoading,
-      })}
-      style={{
-        textAlign: cellAlign,
-        position: isSticky ? 'sticky' : position,
-        right,
-        left: isSticky ? 0 : left,
-        verticalAlign: cellVerticalAlign,
-      }}
-      {...addDataAttributes({ id: shouldRenderDataId ? columnName : undefined })}
-    >
-      {isLoading ? (
-        <div className={classes.skeleton}>
-          <Skeleton />
-        </div>
-      ) : (
-        isNotEmpty(value) && applyAction(component, { ...valueComponentProps, value, row })
-      )}
-    </Table.Cell>
-  );
-}
+import clsx from 'clsx';
+import { applyAction, isNotEmpty } from '@true-engineering/true-react-platform-helpers';
+import { addDataAttributes } from '../../../../helpers';
+import { ICommonProps } from '../../../../types';
+import { Skeleton } from '../../../Skeleton';
+import { TableRenders } from '../../constants';
+import { formatCellContent } from '../../helpers';
+import {
+  ITableRow,
+  IValueComponentProps,
+  IFlexibleTableConfigType,
+  IFlexibleTableRenderMode,
+  IHeaderContent,
+} from '../../types';
+import { useStyles, IFlexibleTableCellStyles } from './FlexibleTableCell.styles';
+
+export interface IFlexibleTableCellProps<
+  Row extends ITableRow,
+  HeaderContent extends IHeaderContent<Row>,
+> extends Pick<ICommonProps<IFlexibleTableCellStyles>, 'tweakStyles'>,
+    Pick<
+      IValueComponentProps<Row, unknown>,
+      | 'isFocusedRow'
+      | 'isActiveRow'
+      | 'isNestedComponentExpanded'
+      | 'isRowNestedComponentExpanded'
+      | 'onSetNestedComponent'
+    > {
+  row: Row;
+  columnName: keyof Row;
+  config: IFlexibleTableConfigType<Row, HeaderContent>;
+  renderMode: IFlexibleTableRenderMode;
+  isSecond?: boolean;
+  isSticky?: boolean;
+  isLoading?: boolean;
+}
+
+export function FlexibleTableCell<
+  Row extends ITableRow,
+  HeaderContent extends IHeaderContent<Row>,
+>({
+  row,
+  columnName,
+  config,
+  renderMode,
+  isSecond,
+  isSticky,
+  isLoading,
+  tweakStyles,
+  ...valueComponentProps
+}: IFlexibleTableCellProps<Row, HeaderContent>): JSX.Element {
+  const classes = useStyles({ theme: tweakStyles });
+
+  const value = row[columnName];
+
+  const {
+    component = formatCellContent(value, config[columnName]),
+    left,
+    right,
+    position,
+    cellAlign,
+    cellVerticalAlign,
+    shouldRenderDataId,
+  } = config[columnName] ?? {};
+
+  const Table = TableRenders[renderMode];
+
+  return (
+    <Table.Cell
+      className={clsx(classes.root, {
+        [classes.sticky]: isSticky,
+        [classes.second]: isSecond,
+        [classes.loading]: isLoading,
+      })}
+      style={{
+        textAlign: cellAlign,
+        position: isSticky ? 'sticky' : position,
+        right,
+        left: isSticky ? 0 : left,
+        verticalAlign: cellVerticalAlign,
+      }}
+      {...addDataAttributes({ id: shouldRenderDataId ? columnName : undefined })}
+    >
+      {isLoading ? (
+        <div className={classes.skeleton}>
+          <Skeleton />
+        </div>
+      ) : (
+        isNotEmpty(value) && applyAction(component, { ...valueComponentProps, value, row })
+      )}
+    </Table.Cell>
+  );
+}

package/src/components/FlexibleTable/components/FlexibleTableCell/index.ts

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

package/src/components/FlexibleTable/components/FlexibleTableRow/FlexibleTableRow.tsx

@@ -1,192 +1,192 @@
-import { ReactNode, useState, memo, MouseEvent } from 'react';
-import clsx from 'clsx';
-import { applyAction, isEmpty, isNotEmpty } from '@true-engineering/true-react-platform-helpers';
-import { addDataAttributes } from '../../../../helpers';
-import { useTweakStyles } from '../../../../hooks';
-import { ICommonProps, IDataAttributes } from '../../../../types';
-import { TableRenders } from '../../constants';
-import {
-  ITableRow,
-  IFlexibleTableConfigType,
-  IFlexibleTableRenderMode,
-  INestedComponent,
-  IHeaderContent,
-} from '../../types';
-import { FlexibleTableCell } from '../FlexibleTableCell';
-import { useStyles, IFlexibleTableRowStyles } from './FlexibleTableRow.styles';
-
-export interface IFlexibleTableRowProps<
-  Row extends ITableRow,
-  HeaderContent extends IHeaderContent<Row>,
-  UniqueField extends keyof Row,
-> extends Pick<ICommonProps<IFlexibleTableRowStyles>, 'tweakStyles'> {
-  item: Row;
-  index: number;
-  uniqueField?: UniqueField;
-  renderMode: IFlexibleTableRenderMode;
-  /** @default false */
-  isActive?: boolean;
-  /** @default false */
-  isFocusable?: boolean;
-  /** @default false */
-  isFirstColumnSticky?: boolean;
-  /** @default false */
-  isLoading?: boolean;
-  config: IFlexibleTableConfigType<Row, HeaderContent>;
-  columns: Array<keyof Row & string>;
-  rowAttributes?: Array<keyof Row>;
-  /** @default false */
-  isExpandableRowComponentInitiallyOpen?: boolean | ((row: Row, index: number) => boolean);
-  /** Возвращает React-элемент, который отрисуется под строкой при нажатии на неё  */
-  expandableRowComponent?: (item: Row, isOpen: boolean, close: () => void) => ReactNode;
-  onRowHover?: (id?: Row[UniqueField]) => void;
-  onRowClick?: (id: Row[UniqueField]) => void;
-}
-
-function FlexibleTableRowInner<
-  Row extends ITableRow,
-  HeaderContent extends IHeaderContent<Row>,
-  UniqueField extends keyof Row,
->({
-  item,
-  index,
-  config,
-  columns,
-  uniqueField,
-  renderMode,
-  isActive = false,
-  isFocusable = false,
-  isFirstColumnSticky = false,
-  isLoading = false,
-  rowAttributes,
-  isExpandableRowComponentInitiallyOpen = false,
-  tweakStyles,
-  expandableRowComponent,
-  onRowHover,
-  onRowClick,
-}: IFlexibleTableRowProps<Row, HeaderContent, UniqueField>): JSX.Element {
-  const classes = useStyles({ theme: tweakStyles });
-
-  const tweakTableCellStyles = useTweakStyles({
-    tweakStyles,
-    className: 'tweakTableCell',
-    currentComponentName: 'FlexibleTableRow',
-  });
-
-  const [isFocused, setFocused] = useState(false);
-  const [nestedComponent, setNestedComponent] = useState<INestedComponent>(() => ({
-    isOpen: applyAction(isExpandableRowComponentInitiallyOpen, item, index),
-  }));
-
-  const isEditable = !isLoading && (isNotEmpty(onRowClick) || isNotEmpty(onRowHover));
-  const isClickable = !isLoading && (isNotEmpty(onRowClick) || isNotEmpty(expandableRowComponent));
-
-  const { isOpen: isNestedComponentExpanded, cellKey: nestedComponentCellKey } = nestedComponent;
-
-  // уникальная разработка, позволяющая прокидывать data-атрибуты в <tr>
-  // например: rowAttributes={['id']} => <tr data-id="x" />
-  const rowData: IDataAttributes = Object.fromEntries(
-    rowAttributes?.map((attribute) => [attribute, item[attribute]]) ?? [],
-  );
-
-  const handleMouseEnter = (event: MouseEvent) => {
-    if (isNotEmpty(uniqueField) && isNotEmpty(onRowHover)) {
-      event.stopPropagation();
-      onRowHover(item[uniqueField]);
-    }
-    if (isFocusable) {
-      setFocused(true);
-    }
-  };
-
-  const handleMouseLeave = () => {
-    onRowHover?.(undefined);
-    if (isFocusable) {
-      setFocused(false);
-    }
-  };
-
-  const closeNestedComponent = () => {
-    setNestedComponent({ isOpen: false });
-  };
-
-  const updateNestedComponent = (component: ReactNode, cellKey: string) => {
-    if (isEmpty(component)) {
-      closeNestedComponent();
-    } else {
-      setNestedComponent({ isOpen: true, component, cellKey });
-    }
-  };
-
-  const handleRowClick = () => {
-    if (isNotEmpty(uniqueField)) {
-      onRowClick?.(item[uniqueField]);
-    }
-    if (isEmpty(expandableRowComponent)) {
-      return;
-    }
-
-    if (!isNestedComponentExpanded) {
-      setNestedComponent({ isOpen: true });
-    } else if (isEmpty(nestedComponentCellKey)) {
-      closeNestedComponent();
-    }
-  };
-
-  const Table = TableRenders[renderMode];
-
-  return (
-    <>
-      <Table.Row
-        className={clsx(classes.root, {
-          [classes.active]: isActive,
-          [classes.editable]: isEditable,
-          [classes.clickable]: isClickable,
-        })}
-        {...(!isLoading && {
-          onClick: handleRowClick,
-          onMouseEnter: handleMouseEnter,
-          onMouseLeave: handleMouseLeave,
-        })}
-        {...addDataAttributes({
-          ...rowData,
-          active: isActive ? true : undefined,
-          editable: isEditable ? true : undefined,
-          isExpandableComponentActive: isNestedComponentExpanded ? true : undefined,
-        })}
-      >
-        {columns.map((key, i) => (
-          <FlexibleTableCell
-            key={key}
-            isSticky={isFirstColumnSticky && i === 0}
-            isSecond={isFirstColumnSticky && i === 1}
-            isLoading={isLoading}
-            row={item}
-            config={config}
-            columnName={key}
-            tweakStyles={tweakTableCellStyles}
-            renderMode={renderMode}
-            isFocusedRow={isFocused}
-            isActiveRow={isActive}
-            isNestedComponentExpanded={isNestedComponentExpanded && nestedComponentCellKey === key}
-            isRowNestedComponentExpanded={
-              isNestedComponentExpanded && isEmpty(nestedComponentCellKey)
-            }
-            onSetNestedComponent={(component) => updateNestedComponent(component, key)}
-          />
-        ))}
-      </Table.Row>
-
-      {isNestedComponentExpanded && (
-        <Table.Row className={classes.root}>
-          <Table.Cell className={classes.nestedComponent} colSpan={columns.length}>
-            {nestedComponent.component ??
-              expandableRowComponent?.(item, true, closeNestedComponent)}
-          </Table.Cell>
-        </Table.Row>
-      )}
-    </>
-  );
-}
-
-export const FlexibleTableRow = memo(FlexibleTableRowInner) as typeof FlexibleTableRowInner;
+import { ReactNode, useState, memo, MouseEvent } from 'react';
+import clsx from 'clsx';
+import { applyAction, isEmpty, isNotEmpty } from '@true-engineering/true-react-platform-helpers';
+import { addDataAttributes } from '../../../../helpers';
+import { useTweakStyles } from '../../../../hooks';
+import { ICommonProps, IDataAttributes } from '../../../../types';
+import { TableRenders } from '../../constants';
+import {
+  ITableRow,
+  IFlexibleTableConfigType,
+  IFlexibleTableRenderMode,
+  INestedComponent,
+  IHeaderContent,
+} from '../../types';
+import { FlexibleTableCell } from '../FlexibleTableCell';
+import { useStyles, IFlexibleTableRowStyles } from './FlexibleTableRow.styles';
+
+export interface IFlexibleTableRowProps<
+  Row extends ITableRow,
+  HeaderContent extends IHeaderContent<Row>,
+  UniqueField extends keyof Row,
+> extends Pick<ICommonProps<IFlexibleTableRowStyles>, 'tweakStyles'> {
+  item: Row;
+  index: number;
+  uniqueField?: UniqueField;
+  renderMode: IFlexibleTableRenderMode;
+  /** @default false */
+  isActive?: boolean;
+  /** @default false */
+  isFocusable?: boolean;
+  /** @default false */
+  isFirstColumnSticky?: boolean;
+  /** @default false */
+  isLoading?: boolean;
+  config: IFlexibleTableConfigType<Row, HeaderContent>;
+  columns: Array<keyof Row & string>;
+  rowAttributes?: Array<keyof Row>;
+  /** @default false */
+  isExpandableRowComponentInitiallyOpen?: boolean | ((row: Row, index: number) => boolean);
+  /** Возвращает React-элемент, который отрисуется под строкой при нажатии на неё  */
+  expandableRowComponent?: (item: Row, isOpen: boolean, close: () => void) => ReactNode;
+  onRowHover?: (id?: Row[UniqueField]) => void;
+  onRowClick?: (id: Row[UniqueField]) => void;
+}
+
+function FlexibleTableRowInner<
+  Row extends ITableRow,
+  HeaderContent extends IHeaderContent<Row>,
+  UniqueField extends keyof Row,
+>({
+  item,
+  index,
+  config,
+  columns,
+  uniqueField,
+  renderMode,
+  isActive = false,
+  isFocusable = false,
+  isFirstColumnSticky = false,
+  isLoading = false,
+  rowAttributes,
+  isExpandableRowComponentInitiallyOpen = false,
+  tweakStyles,
+  expandableRowComponent,
+  onRowHover,
+  onRowClick,
+}: IFlexibleTableRowProps<Row, HeaderContent, UniqueField>): JSX.Element {
+  const classes = useStyles({ theme: tweakStyles });
+
+  const tweakTableCellStyles = useTweakStyles({
+    tweakStyles,
+    className: 'tweakTableCell',
+    currentComponentName: 'FlexibleTableRow',
+  });
+
+  const [isFocused, setFocused] = useState(false);
+  const [nestedComponent, setNestedComponent] = useState<INestedComponent>(() => ({
+    isOpen: applyAction(isExpandableRowComponentInitiallyOpen, item, index),
+  }));
+
+  const isEditable = !isLoading && (isNotEmpty(onRowClick) || isNotEmpty(onRowHover));
+  const isClickable = !isLoading && (isNotEmpty(onRowClick) || isNotEmpty(expandableRowComponent));
+
+  const { isOpen: isNestedComponentExpanded, cellKey: nestedComponentCellKey } = nestedComponent;
+
+  // уникальная разработка, позволяющая прокидывать data-атрибуты в <tr>
+  // например: rowAttributes={['id']} => <tr data-id="x" />
+  const rowData: IDataAttributes = Object.fromEntries(
+    rowAttributes?.map((attribute) => [attribute, item[attribute]]) ?? [],
+  );
+
+  const handleMouseEnter = (event: MouseEvent) => {
+    if (isNotEmpty(uniqueField) && isNotEmpty(onRowHover)) {
+      event.stopPropagation();
+      onRowHover(item[uniqueField]);
+    }
+    if (isFocusable) {
+      setFocused(true);
+    }
+  };
+
+  const handleMouseLeave = () => {
+    onRowHover?.(undefined);
+    if (isFocusable) {
+      setFocused(false);
+    }
+  };
+
+  const closeNestedComponent = () => {
+    setNestedComponent({ isOpen: false });
+  };
+
+  const updateNestedComponent = (component: ReactNode, cellKey: string) => {
+    if (isEmpty(component)) {
+      closeNestedComponent();
+    } else {
+      setNestedComponent({ isOpen: true, component, cellKey });
+    }
+  };
+
+  const handleRowClick = () => {
+    if (isNotEmpty(uniqueField)) {
+      onRowClick?.(item[uniqueField]);
+    }
+    if (isEmpty(expandableRowComponent)) {
+      return;
+    }
+
+    if (!isNestedComponentExpanded) {
+      setNestedComponent({ isOpen: true });
+    } else if (isEmpty(nestedComponentCellKey)) {
+      closeNestedComponent();
+    }
+  };
+
+  const Table = TableRenders[renderMode];
+
+  return (
+    <>
+      <Table.Row
+        className={clsx(classes.root, {
+          [classes.active]: isActive,
+          [classes.editable]: isEditable,
+          [classes.clickable]: isClickable,
+        })}
+        {...(!isLoading && {
+          onClick: handleRowClick,
+          onMouseEnter: handleMouseEnter,
+          onMouseLeave: handleMouseLeave,
+        })}
+        {...addDataAttributes({
+          ...rowData,
+          active: isActive ? true : undefined,
+          editable: isEditable ? true : undefined,
+          isExpandableComponentActive: isNestedComponentExpanded ? true : undefined,
+        })}
+      >
+        {columns.map((key, i) => (
+          <FlexibleTableCell
+            key={key}
+            isSticky={isFirstColumnSticky && i === 0}
+            isSecond={isFirstColumnSticky && i === 1}
+            isLoading={isLoading}
+            row={item}
+            config={config}
+            columnName={key}
+            tweakStyles={tweakTableCellStyles}
+            renderMode={renderMode}
+            isFocusedRow={isFocused}
+            isActiveRow={isActive}
+            isNestedComponentExpanded={isNestedComponentExpanded && nestedComponentCellKey === key}
+            isRowNestedComponentExpanded={
+              isNestedComponentExpanded && isEmpty(nestedComponentCellKey)
+            }
+            onSetNestedComponent={(component) => updateNestedComponent(component, key)}
+          />
+        ))}
+      </Table.Row>
+
+      {isNestedComponentExpanded && (
+        <Table.Row className={classes.root}>
+          <Table.Cell className={classes.nestedComponent} colSpan={columns.length}>
+            {nestedComponent.component ??
+              expandableRowComponent?.(item, true, closeNestedComponent)}
+          </Table.Cell>
+        </Table.Row>
+      )}
+    </>
+  );
+}
+
+export const FlexibleTableRow = memo(FlexibleTableRowInner) as typeof FlexibleTableRowInner;

package/src/components/FlexibleTable/components/FlexibleTableRow/index.ts

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

package/src/components/FlexibleTable/components/index.ts

@@ -1,2 +1,2 @@
-export * from './FlexibleTableRow';
-export * from './FlexibleTableCell';
+export * from './FlexibleTableRow';
+export * from './FlexibleTableCell';

package/src/components/FlexibleTable/constants.ts

@@ -1,8 +1,8 @@
-import { IFlexibleTableRenderMode, IFlexibleTableRender } from './types';
-
-export const DEFAULT_DATE_FORMAT = 'dd.MM.yyyy';
-
-export const TableRenders: Record<IFlexibleTableRenderMode, IFlexibleTableRender> = {
-  table: { Root: 'table', Head: 'thead', Body: 'tbody', Row: 'tr', Header: 'th', Cell: 'td' },
-  divs: { Root: 'div', Head: 'div', Body: 'div', Row: 'div', Header: 'div', Cell: 'div' },
-};
+import { IFlexibleTableRenderMode, IFlexibleTableRender } from './types';
+
+export const DEFAULT_DATE_FORMAT = 'dd.MM.yyyy';
+
+export const TableRenders: Record<IFlexibleTableRenderMode, IFlexibleTableRender> = {
+  table: { Root: 'table', Head: 'thead', Body: 'tbody', Row: 'tr', Header: 'th', Cell: 'td' },
+  divs: { Root: 'div', Head: 'div', Body: 'div', Row: 'div', Header: 'div', Cell: 'div' },
+};

package/src/components/FlexibleTable/helpers.ts

@@ -1,16 +1,16 @@
-import { format } from 'date-fns';
-import { isNotEmpty } from '@true-engineering/true-react-platform-helpers';
-import { DEFAULT_DATE_FORMAT } from './constants';
-import { IFlexibleTableConfigType, IHeaderContent, ITableRow } from './types';
-
-export const hasHorizontalScrollBar = (el: HTMLElement | null | undefined): boolean =>
-  isNotEmpty(el) && el.scrollWidth !== el.clientWidth;
-
-export const formatCellContent = <
-  Values extends ITableRow,
-  HeaderContent extends IHeaderContent<Values>,
->(
-  value: unknown,
-  config?: IFlexibleTableConfigType<Values, HeaderContent>[keyof Values],
-): string =>
-  value instanceof Date ? format(value, config?.dateFormat ?? DEFAULT_DATE_FORMAT) : String(value);
+import { format } from 'date-fns';
+import { isNotEmpty } from '@true-engineering/true-react-platform-helpers';
+import { DEFAULT_DATE_FORMAT } from './constants';
+import { IFlexibleTableConfigType, IHeaderContent, ITableRow } from './types';
+
+export const hasHorizontalScrollBar = (el: HTMLElement | null | undefined): boolean =>
+  isNotEmpty(el) && el.scrollWidth !== el.clientWidth;
+
+export const formatCellContent = <
+  Values extends ITableRow,
+  HeaderContent extends IHeaderContent<Values>,
+>(
+  value: unknown,
+  config?: IFlexibleTableConfigType<Values, HeaderContent>[keyof Values],
+): string =>
+  value instanceof Date ? format(value, config?.dateFormat ?? DEFAULT_DATE_FORMAT) : String(value);

package/src/components/FlexibleTable/index.ts

@@ -1,4 +1,4 @@
-export * from './FlexibleTable';
-export * from './types';
-export type { IFlexibleTableStyles } from './FlexibleTable.styles';
-export type { IFlexibleTableCellStyles, IFlexibleTableRowStyles } from './components';
+export * from './FlexibleTable';
+export * from './types';
+export type { IFlexibleTableStyles } from './FlexibleTable.styles';
+export type { IFlexibleTableCellStyles, IFlexibleTableRowStyles } from './components';