@true-engineering/true-react-common-ui-kit 2.1.1 → 2.3.0

package/src/helpers/{utils.ts → misc.ts}

@@ -1,231 +1,158 @@
-import { HTMLAttributes, KeyboardEvent, MouseEvent } from 'react';
-import { IDataAttributes } from '../types';
-
-export const transformToKebab = (string: string): string => {
-  let result = '';
-  string.split('').forEach((char) => {
-    if (char.toLowerCase() === char) {
-      result += char;
-    } else {
-      result += `-${char.toLowerCase()}`;
-    }
-  });
-
-  return result;
-};
-
-export const hasExactParent = (element: Element, parent: Element): boolean => {
-  if (element === parent) {
-    return true; // Found the exact parent
-  }
-
-  const parentNode = getParentNode(element);
-
-  if (parentNode === element) {
-    return false; // Reached the top-level HTML element or Shadow DOM host
-  }
-
-  return hasExactParent(parentNode, parent);
-};
-
-export const getParentNode = (element: Element | ShadowRoot | Document): Element =>
-  element.nodeName === 'HTML' || element === document
-    ? (element as Element)
-    : (element.parentNode as Element) ?? (element as ShadowRoot).host;
-
-export const getStyleComputedProperty = (element: Element): Partial<CSSStyleDeclaration> =>
-  element.nodeType !== 1 ? {} : getComputedStyle(element, null);
-
-export const getScrollParent = (element: Element | Document): Element => {
-  if (!element) {
-    return document.body;
-  }
-
-  switch (element.nodeName) {
-    case 'HTML':
-    case 'BODY':
-      return (element as Element).ownerDocument.body;
-    case '#document':
-      return (element as Document).body;
-  }
-
-  const { overflow, overflowX, overflowY } = getStyleComputedProperty(element as Element) ?? {};
-  if (/(auto|scroll|overlay)/.test((overflow ?? '') + (overflowY ?? '') + (overflowX ?? ''))) {
-    return element as Element;
-  }
-  return getScrollParent(getParentNode(element as Element));
-};
-
-export const isElementOffScreen = (element: HTMLElement, input?: HTMLElement): boolean => {
-  const el = element;
-  const scrollParent = getScrollParent(element);
-
-  const { scrollHeight: scrollHeightWithElement } = scrollParent;
-  el.hidden = true;
-  const { scrollHeight: scrollHeightWithoutElement } = scrollParent;
-  el.hidden = false;
-
-  const isOffscreen = scrollHeightWithElement !== scrollHeightWithoutElement;
-
-  if (isOffscreen && input !== undefined) {
-    const elRect = el.getBoundingClientRect();
-    const scrollParentRect = scrollParent.getBoundingClientRect();
-    const topOffset = elRect.top - scrollParentRect.top;
-    if (input.clientHeight + el.clientHeight > topOffset) {
-      return false;
-    }
-  }
-
-  return isOffscreen;
-};
-
-export const getNumberInRange = (value: number, min = -Infinity, max = Infinity): number =>
-  Math.min(max, Math.max(min, value));
-
-const DEFAULT_THOUSANDS_SEPARATOR = '\u2009';
-
-export const formatStringNumber = (
-  val?: string,
-  separator = DEFAULT_THOUSANDS_SEPARATOR,
-): string => {
-  if (val === undefined) {
-    return '';
-  }
-  const parts = val.split('.');
-
-  parts[0] = parts[0]
-    // убрать лидирующие нули
-    .replace(/^0+(?=\d)/, '')
-    // проставить сепараторы тысяч
-    .replace(/\B(?=(\d{3})+(?!\d))/g, separator);
-  return (parts[1] ?? '').length > 0 ? parts.join('.') : parts[0];
-};
-
-export const formatNumber = (val?: number, separator = DEFAULT_THOUSANDS_SEPARATOR): string => {
-  if (val === undefined || isNaN(val)) {
-    return '';
-  }
-  return formatStringNumber(String(val), separator);
-};
-
-export const removeStringFormat = (val?: string): string =>
-  (val ?? '').replace(',', '.').replace(/\s/g, '');
-
-export const stringToNumber = (val?: string): number | undefined => {
-  const trimmed = removeStringFormat(val);
-  if (trimmed === '') {
-    return undefined;
-  }
-  const num = Number(trimmed);
-  return isNaN(num) ? undefined : num;
-};
-
-export const setCaretPosition = (elem: HTMLInputElement, caretPos: number | null): void => {
-  if (caretPos === null || elem === null) {
-    return;
-  }
-  if (elem.selectionStart) {
-    elem.focus();
-    elem.setSelectionRange(caretPos, caretPos);
-  } else {
-    elem.focus();
-  }
-};
-
-export const isSpaceChar = (char?: string): boolean =>
-  char !== undefined && char.match(/\s/) !== null;
-
-export const isInt = (n: number): boolean => n % 1 === 0;
-
-export const getNumberLength = (n?: number): number =>
-  n === undefined || isNaN(n) ? 0 : n.toString().length;
-
-// TODO: Не должен проверять строку, т.к. под это есть отдельный хелпер
-/**
- * Проверяет, что `val` не `null`, не `undefined` и не пустая строка
- */
-export const isNotEmpty = <T>(val: T | null | undefined): val is T =>
-  typeof val === 'string' ? val.trim() !== '' : val !== null && val !== undefined;
-
-/**
- * Проверяет, что переданное значение `null` или `undefined`
- */
-export const isEmpty = <T>(val: T | null | undefined): val is null | undefined =>
-  val === null || val === undefined;
-
-/**
- * Проверяет, что передана непустая строка
- */
-export const isStringNotEmpty = <T extends string>(value: T | undefined | null): value is T =>
-  (value ?? '').trim() !== '';
-
-export const trimStringToMaxLength = (val: string, maxLength: number) =>
-  val.length > maxLength ? val.slice(0, maxLength) : val;
-
-export const addDataAttributes = (data: IDataAttributes = {}): IDataAttributes =>
-  Object.fromEntries(
-    Object.entries(data).map(([key, value]) =>
-      isNotEmpty(value) ? [`data-${transformToKebab(key)}`, value] : [],
-    ),
-  );
-
-export const addDataTestId = (
-  ...args: Parameters<typeof getTestId>
-): { 'data-testid': string } | undefined => {
-  const testId = getTestId(...args);
-  return isNotEmpty(testId) ? { 'data-testid': testId } : undefined;
-};
-
-export const getTestId = (
-  testId: string | undefined,
-  postfix?: string | number,
-): string | undefined => {
-  if (!isNotEmpty(testId)) {
-    return undefined;
-  }
-  return isNotEmpty(postfix) ? `${testId}-${postfix}` : testId;
-};
-
-export const getSelectKeyHandler =
-  (cb: (e: KeyboardEvent) => void): ((e: KeyboardEvent) => void) =>
-  (e) => {
-    if (e.code === 'Enter' || e.code === 'NumpadEnter') {
-      cb(e);
-    }
-  };
-
-export const addClickHandler = (
-  cb?: (e: MouseEvent | KeyboardEvent) => void,
-  hasAction = true,
-): HTMLAttributes<unknown> =>
-  hasAction && isNotEmpty(cb)
-    ? {
-        tabIndex: 0,
-        onClick: cb as (e: MouseEvent) => void,
-        onKeyDown: getSelectKeyHandler(cb),
-      }
-    : {
-        tabIndex: -1,
-      };
-
-/**
- * Позволяет создать текстовый фильтр для набора items
- * @param getter - функция возвращающая набор строковых значений из каждого item,
- * по которым должен осуществляться поиск
- */
-export const createFilter =
-  <T>(
-    getter: (item: T) => Array<string | undefined>,
-    compareFn?: (item: string, query: string) => boolean,
-  ): ((items: T[], query: string) => T[]) =>
-  (items, query) =>
-    items.filter((item) => {
-      const possibleValues = getter(item).reduce(
-        (acc, cur) => [...acc, ...(isStringNotEmpty(cur) ? [cur.toLowerCase()] : [])],
-        [] as string[],
-      );
-      const queryString = query.toLowerCase().trim();
-      return possibleValues.some((v) =>
-        (compareFn ?? (() => v?.includes(queryString)))(v, queryString),
-      );
-    });
+import hexToRgba from 'hex-to-rgba';
+import {
+  isNotEmpty,
+  isString,
+  isStringNotEmpty,
+} from '@true-engineering/true-react-platform-helpers';
+import { IDataAttributes } from '../types';
+
+export const rgba = hexToRgba;
+
+export const transformToKebab = (string: string): string => {
+  let result = '';
+  string.split('').forEach((char) => {
+    if (char.toLowerCase() === char) {
+      result += char;
+    } else {
+      result += `-${char.toLowerCase()}`;
+    }
+  });
+
+  return result;
+};
+
+export const hasExactParent = (element: Element, parent: Element): boolean => {
+  if (element === parent) {
+    return true; // Found the exact parent
+  }
+
+  const parentNode = getParentNode(element);
+
+  if (parentNode === element) {
+    return false; // Reached the top-level HTML element or Shadow DOM host
+  }
+
+  return hasExactParent(parentNode, parent);
+};
+
+export const getParentNode = (element: Element | ShadowRoot | Document): Element =>
+  element.nodeName === 'HTML' || element === document
+    ? (element as Element)
+    : (element.parentNode as Element) ?? (element as ShadowRoot).host;
+
+export const getStyleComputedProperty = (element: Element): Partial<CSSStyleDeclaration> =>
+  element.nodeType !== 1 ? {} : getComputedStyle(element, null);
+
+export const getScrollParent = (element: Element | Document): Element => {
+  if (!element) {
+    return document.body;
+  }
+
+  switch (element.nodeName) {
+    case 'HTML':
+    case 'BODY':
+      return (element as Element).ownerDocument.body;
+    case '#document':
+      return (element as Document).body;
+  }
+
+  const { overflow, overflowX, overflowY } = getStyleComputedProperty(element as Element) ?? {};
+  if (/(auto|scroll|overlay)/.test((overflow ?? '') + (overflowY ?? '') + (overflowX ?? ''))) {
+    return element as Element;
+  }
+  return getScrollParent(getParentNode(element as Element));
+};
+
+export const isElementOffScreen = (element: HTMLElement, input?: HTMLElement): boolean => {
+  const el = element;
+  const scrollParent = getScrollParent(element);
+
+  const { scrollHeight: scrollHeightWithElement } = scrollParent;
+  el.hidden = true;
+  const { scrollHeight: scrollHeightWithoutElement } = scrollParent;
+  el.hidden = false;
+
+  const isOffscreen = scrollHeightWithElement !== scrollHeightWithoutElement;
+
+  if (isOffscreen && input !== undefined) {
+    const elRect = el.getBoundingClientRect();
+    const scrollParentRect = scrollParent.getBoundingClientRect();
+    const topOffset = elRect.top - scrollParentRect.top;
+    if (input.clientHeight + el.clientHeight > topOffset) {
+      return false;
+    }
+  }
+
+  return isOffscreen;
+};
+
+export const getNumberInRange = (value: number, min = -Infinity, max = Infinity): number =>
+  Math.min(max, Math.max(min, value));
+
+const DEFAULT_THOUSANDS_SEPARATOR = '\u2009';
+
+export const formatStringNumber = (
+  val?: string,
+  separator = DEFAULT_THOUSANDS_SEPARATOR,
+): string => {
+  if (val === undefined) {
+    return '';
+  }
+  const parts = val.split('.');
+
+  parts[0] = parts[0]
+    // убрать лидирующие нули
+    .replace(/^0+(?=\d)/, '')
+    // проставить сепараторы тысяч
+    .replace(/\B(?=(\d{3})+(?!\d))/g, separator);
+  return (parts[1] ?? '').length > 0 ? parts.join('.') : parts[0];
+};
+
+export const formatNumber = (val?: number, separator = DEFAULT_THOUSANDS_SEPARATOR): string => {
+  if (val === undefined || isNaN(val)) {
+    return '';
+  }
+  return formatStringNumber(String(val), separator);
+};
+
+export const removeStringFormat = (val?: string): string =>
+  (val ?? '').replace(',', '.').replace(/\s/g, '');
+
+export const stringToNumber = (val?: string): number | undefined => {
+  const trimmed = removeStringFormat(val);
+  if (trimmed === '') {
+    return undefined;
+  }
+  const num = Number(trimmed);
+  return isNaN(num) ? undefined : num;
+};
+
+export const setCaretPosition = (elem: HTMLInputElement, caretPos: number | null): void => {
+  if (caretPos === null || elem === null) {
+    return;
+  }
+  if (elem.selectionStart) {
+    elem.focus();
+    elem.setSelectionRange(caretPos, caretPos);
+  } else {
+    elem.focus();
+  }
+};
+
+export const isSpaceChar = (char?: string): boolean =>
+  char !== undefined && char.match(/\s/) !== null;
+
+export const getNumberLength = (n?: number): number =>
+  n === undefined || isNaN(n) ? 0 : n.toString().length;
+
+export const trimStringToMaxLength = (val: string, maxLength: number) =>
+  val.length > maxLength ? val.slice(0, maxLength) : val;
+
+export const addDataAttributes = (data: IDataAttributes = {}): IDataAttributes =>
+  Object.fromEntries(
+    Object.entries(data).map(([key, value]) =>
+      (isString(value) && isStringNotEmpty(value)) || isNotEmpty(value)
+        ? [`data-${transformToKebab(key)}`, value]
+        : [],
+    ),
+  );

package/src/helpers/phone.ts

@@ -1,87 +1,87 @@
-import { phoneInfo, IPhoneInfo, IPhoneValue } from '../components';
-import { isNotEmpty } from './utils';
-
-export const findCountryByCode = (
-  countryCode?: string,
-  countriesList = phoneInfo,
-): IPhoneInfo | undefined =>
-  countryCode !== undefined
-    ? countriesList.find((info) => info.countryCode === countryCode)
-    : undefined;
-
-export const findCountryIndexByCode = (countryCode?: string, countriesList = phoneInfo): number =>
-  countryCode !== undefined
-    ? countriesList.findIndex((info) => info.countryCode === countryCode)
-    : -1;
-
-export const getCountryTextByLocale = (country: IPhoneInfo, locale: string): string =>
-  locale.toLowerCase() === 'ru' ? country.countryRu : country.countryEn;
-
-export const sortCountriesByLocale = (countriesList: IPhoneInfo[], locale: string) =>
-  countriesList.sort((countryA, countryB) =>
-    getCountryTextByLocale(countryA, locale).localeCompare(
-      getCountryTextByLocale(countryB, locale),
-    ),
-  );
-
-export const checkSearchStringInCountry = (country: IPhoneInfo, searchString: string): boolean => {
-  const checkValue = searchString.toLowerCase().trim().replace('+', '');
-
-  const possibleValues = [
-    country.countryRu,
-    country.countryEn,
-    ...country.countryRu.split(' '),
-    ...country.countryEn.split(' '),
-    country.dialCode,
-  ].map((part) => part.toLowerCase());
-
-  return possibleValues.some((v) => v.startsWith(checkValue));
-};
-
-export const getFullPhone = (phone?: IPhoneValue): string =>
-  (phone?.dialCode ?? '') + (phone?.phoneNumber ?? '');
-
-export const getCountryCodeFromPhone = (phoneWithCode: string): string | undefined => {
-  // попробуем найти уникальный код страны fullCode (dialCode + arealCode)
-  let countryCode = phoneInfo.find((info) =>
-    info.fullCodes.some((code) => phoneWithCode.startsWith(code)),
-  )?.countryCode;
-
-  if (countryCode === undefined && isNotEmpty(phoneWithCode)) {
-    // если не нашли уникальный fullCode (dialCode + arealCode),
-    // то пробуем найти dialCode и выбираем с наименьшим Priority
-    countryCode = phoneInfo
-      .filter((info) => phoneWithCode.startsWith(info.dialCode))
-      .sort(
-        (infoA, infoB) => (infoA.dialCodePriority ?? 1000) - (infoB.dialCodePriority ?? 1000),
-      )[0]?.countryCode;
-  }
-
-  return countryCode;
-};
-
-export const getPhoneObjFromString = (fullPhone: string, countryCode?: string): IPhoneValue => {
-  const newCountryCode = countryCode ?? getCountryCodeFromPhone(fullPhone);
-  const dialCode = findCountryByCode(newCountryCode)?.dialCode;
-  const phoneNumber = fullPhone.slice(dialCode?.length);
-
-  return { dialCode, phoneNumber, countryCode: newCountryCode };
-};
-
-export const DEFAULT_PHONE_MASK = '+ 9 999 999 999 999 99';
-
-export const getPhoneMask = (countryCode?: string): string => {
-  let mask = DEFAULT_PHONE_MASK;
-  if (countryCode !== undefined) {
-    const countrySettings = findCountryByCode(countryCode);
-
-    if (countrySettings !== undefined) {
-      const dialCodeLength = countrySettings.dialCode.length;
-      const areaAndPhoneMask =
-        countrySettings.phoneMask ?? mask.substring(2, mask.length - dialCodeLength);
-      mask = `+ ${'9'.repeat(dialCodeLength)} ${areaAndPhoneMask}`;
-    }
-  }
-
-  return mask;
-};
+import { isNotEmpty, isEmpty } from '@true-engineering/true-react-platform-helpers';
+import { phoneInfo, IPhoneInfo, IPhoneValue } from '../components';
+
+export const findCountryByCode = (
+  countryCode?: string,
+  countriesList = phoneInfo,
+): IPhoneInfo | undefined =>
+  isNotEmpty(countryCode)
+    ? countriesList.find((info) => info.countryCode === countryCode)
+    : undefined;
+
+export const findCountryIndexByCode = (countryCode?: string, countriesList = phoneInfo): number =>
+  isNotEmpty(countryCode)
+    ? countriesList.findIndex((info) => info.countryCode === countryCode)
+    : -1;
+
+export const getCountryTextByLocale = (country: IPhoneInfo, locale: string): string =>
+  locale.toLowerCase() === 'ru' ? country.countryRu : country.countryEn;
+
+export const sortCountriesByLocale = (countriesList: IPhoneInfo[], locale: string) =>
+  countriesList.sort((countryA, countryB) =>
+    getCountryTextByLocale(countryA, locale).localeCompare(
+      getCountryTextByLocale(countryB, locale),
+    ),
+  );
+
+export const checkSearchStringInCountry = (country: IPhoneInfo, searchString: string): boolean => {
+  const checkValue = searchString.toLowerCase().trim().replace('+', '');
+
+  const possibleValues = [
+    country.countryRu,
+    country.countryEn,
+    ...country.countryRu.split(' '),
+    ...country.countryEn.split(' '),
+    country.dialCode,
+  ].map((part) => part.toLowerCase());
+
+  return possibleValues.some((v) => v.startsWith(checkValue));
+};
+
+export const getFullPhone = (phone?: IPhoneValue): string =>
+  (phone?.dialCode ?? '') + (phone?.phoneNumber ?? '');
+
+export const getCountryCodeFromPhone = (phoneWithCode: string): string | undefined => {
+  // попробуем найти уникальный код страны fullCode (dialCode + arealCode)
+  let countryCode = phoneInfo.find((info) =>
+    info.fullCodes.some((code) => phoneWithCode.startsWith(code)),
+  )?.countryCode;
+
+  if (isEmpty(countryCode) && isNotEmpty(phoneWithCode)) {
+    // если не нашли уникальный fullCode (dialCode + arealCode),
+    // то пробуем найти dialCode и выбираем с наименьшим Priority
+    countryCode = phoneInfo
+      .filter((info) => phoneWithCode.startsWith(info.dialCode))
+      .sort(
+        (infoA, infoB) => (infoA.dialCodePriority ?? 1000) - (infoB.dialCodePriority ?? 1000),
+      )[0]?.countryCode;
+  }
+
+  return countryCode;
+};
+
+export const getPhoneObjFromString = (fullPhone: string, countryCode?: string): IPhoneValue => {
+  const newCountryCode = countryCode ?? getCountryCodeFromPhone(fullPhone);
+  const dialCode = findCountryByCode(newCountryCode)?.dialCode;
+  const phoneNumber = fullPhone.slice(dialCode?.length);
+
+  return { dialCode, phoneNumber, countryCode: newCountryCode };
+};
+
+export const DEFAULT_PHONE_MASK = '+ 9 999 999 999 999 99';
+
+export const getPhoneMask = (countryCode?: string): string => {
+  let mask = DEFAULT_PHONE_MASK;
+  if (isNotEmpty(countryCode)) {
+    const countrySettings = findCountryByCode(countryCode);
+
+    if (countrySettings !== undefined) {
+      const dialCodeLength = countrySettings.dialCode.length;
+      const areaAndPhoneMask =
+        countrySettings.phoneMask ?? mask.substring(2, mask.length - dialCodeLength);
+      mask = `+ ${'9'.repeat(dialCodeLength)} ${areaAndPhoneMask}`;
+    }
+  }
+
+  return mask;
+};

package/src/helpers/popper-helpers.ts

@@ -1,17 +1,17 @@
-import { Modifier } from 'react-overlays/usePopper';
-
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export const minWidthModifier: Partial<Modifier<any, any>> = {
-  name: 'minWidth',
-  enabled: true,
-  phase: 'beforeWrite',
-  requires: ['computeStyles'],
-  fn: ({ state }) => {
-    state.styles.popper.minWidth = `${state.rects.reference.width}px`;
-  },
-  effect: ({ state }) => {
-    state.elements.popper.style.minWidth = `${
-      (state.elements.reference as HTMLElement).offsetWidth
-    }px`;
-  },
-};
+import { Modifier } from 'react-overlays/usePopper';
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export const minWidthModifier: Partial<Modifier<any, any>> = {
+  name: 'minWidth',
+  enabled: true,
+  phase: 'beforeWrite',
+  requires: ['computeStyles'],
+  fn: ({ state }) => {
+    state.styles.popper.minWidth = `${state.rects.reference.width}px`;
+  },
+  effect: ({ state }) => {
+    state.elements.popper.style.minWidth = `${
+      (state.elements.reference as HTMLElement).offsetWidth
+    }px`;
+  },
+};

package/src/helpers/snippets.tsx

@@ -1,5 +1,6 @@
-import { ReactElement, ReactNode } from 'react';
-import { Icon, IIconType } from '../components';
-
-export const renderIcon = (icon: IIconType | ReactElement): ReactNode =>
-  typeof icon === 'string' ? <Icon type={icon} /> : icon;
+import { ReactNode } from 'react';
+import { Icon } from '../components';
+import { IIcon } from '../types';
+
+export const renderIcon = (icon: IIcon): ReactNode =>
+  typeof icon === 'string' ? <Icon type={icon} /> : icon;

package/src/hooks/index.ts

@@ -1,6 +1,6 @@
-export * from './use-is-mounted';
-export * from './use-on-click-outside';
-export * from './use-theme';
-export * from './use-dropdown';
-export * from './use-tweak-styles';
-export * from './use-did-mount-effect';
+export * from './use-is-mounted';
+export * from './use-on-click-outside';
+export * from './use-theme';
+export * from './use-dropdown';
+export * from './use-tweak-styles';
+export * from './use-did-mount-effect';