@salutejs/plasma-new-hope 0.146.0-dev.0 → 0.147.0-canary.1418.10899581491.0

package/emotion/cjs/examples/plasma_b2c/components/Mask/Mask.stories.tsx

@@ -0,0 +1,127 @@
+import React from 'react';
+import type { ComponentProps } from 'react';
+import type { StoryObj, Meta } from '@storybook/react';
+import { action } from '@storybook/addon-actions';
+
+import { WithTheme } from '../../../_helpers';
+
+import { Mask } from './Mask';
+
+const onChange = action('onChange');
+
+const sizes = ['l', 'm', 's', 'xs'];
+const views = ['default', 'positive', 'warning', 'negative'];
+
+const meta: Meta<typeof Mask> = {
+    title: 'plasma_b2c/Mask',
+    component: Mask,
+    decorators: [WithTheme],
+    argTypes: {
+        view: {
+            options: views,
+            control: {
+                type: 'select',
+            },
+        },
+        size: {
+            options: sizes,
+            control: {
+                type: 'inline-radio',
+            },
+        },
+    },
+};
+
+export default meta;
+
+type StoryPropsDefault = Omit<
+    ComponentProps<typeof Mask>,
+    | 'helperBlock'
+    | 'contentLeft'
+    | 'htmlSize'
+    | 'contentRight'
+    | 'type'
+    | 'name'
+    | 'onFocus'
+    | 'onBlur'
+    | 'onChange'
+    | 'value'
+    | 'checked'
+    | 'maxLength'
+    | 'minLength'
+    | 'required'
+    | 'enumerationType'
+    | 'chips'
+    | 'onChangeChips'
+>;
+
+const StoryDemo = ({ view, ...rest }: StoryPropsDefault) => {
+    return (
+        <div style={{ display: 'flex', flexDirection: 'column', gap: '2rem', width: '50%' }}>
+            <Mask
+                label="Маска телефона"
+                mask="+7 (000) 000 - 00 - 00"
+                maskChar="_"
+                showPrefix={false}
+                view={view}
+                onChange={onChange}
+                {...rest}
+            />
+
+            <Mask
+                label="Маска телефона: отображается всегда"
+                mask="+7 (000) 000 - 00 - 00"
+                maskChar="_"
+                view={view}
+                alwaysShowMask
+                onChange={onChange}
+                {...rest}
+                value="+79123"
+                name="example"
+            />
+
+            <Mask
+                label="Маска даты"
+                mask="00/00/0000"
+                maskString="DD/MM/YYYY"
+                alwaysShowMask
+                view={view}
+                onChange={onChange}
+                {...rest}
+            />
+
+            <Mask
+                label="Маска даты: значения по умолчанию"
+                // eslint-disable-next-line no-octal-escape
+                mask="12.\04.0000"
+                maskChar="_"
+                alwaysShowMask
+                view={view}
+                onChange={onChange}
+                {...rest}
+            />
+
+            <Mask
+                label="Маска времени"
+                mask="00:00"
+                maskChar="_"
+                alwaysShowMask
+                view={view}
+                onChange={onChange}
+                {...rest}
+            />
+        </div>
+    );
+};
+
+export const Default: StoryObj<StoryPropsDefault> = {
+    args: {
+        size: 'l',
+        view: 'default',
+        labelPlacement: 'outer',
+        placeholder: 'Заполните поле',
+        disabled: false,
+        readOnly: false,
+    },
+    render: (args) => <StoryDemo {...args} />,
+};

package/emotion/cjs/examples/plasma_web/components/Mask/Mask.js

@@ -0,0 +1,9 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.Mask = void 0;
+var _Mask = /*#__PURE__*/require("../../../../components/Mask");
+var _TextField = /*#__PURE__*/require("../TextField/TextField");
+var Mask = exports.Mask = /*#__PURE__*/(0, _Mask.composeMask)(_TextField.TextField);

package/emotion/cjs/examples/plasma_web/components/Mask/Mask.stories.tsx

@@ -0,0 +1,125 @@
+import React from 'react';
+import type { ComponentProps } from 'react';
+import type { StoryObj, Meta } from '@storybook/react';
+import { action } from '@storybook/addon-actions';
+
+import { WithTheme } from '../../../_helpers';
+
+import { Mask } from './Mask';
+
+const onChange = action('onChange');
+
+const sizes = ['l', 'm', 's', 'xs'];
+const views = ['default', 'positive', 'warning', 'negative'];
+
+const meta: Meta<typeof Mask> = {
+    title: 'plasma_web/Mask',
+    component: Mask,
+    decorators: [WithTheme],
+    argTypes: {
+        view: {
+            options: views,
+            control: {
+                type: 'select',
+            },
+        },
+        size: {
+            options: sizes,
+            control: {
+                type: 'inline-radio',
+            },
+        },
+    },
+};
+
+export default meta;
+
+type StoryPropsDefault = Omit<
+    ComponentProps<typeof Mask>,
+    | 'helperBlock'
+    | 'contentLeft'
+    | 'htmlSize'
+    | 'contentRight'
+    | 'type'
+    | 'name'
+    | 'onFocus'
+    | 'onBlur'
+    | 'onChange'
+    | 'value'
+    | 'checked'
+    | 'maxLength'
+    | 'minLength'
+    | 'required'
+    | 'enumerationType'
+    | 'chips'
+    | 'onChangeChips'
+>;
+
+const StoryDemo = ({ view, ...rest }: StoryPropsDefault) => {
+    return (
+        <div style={{ display: 'flex', flexDirection: 'column', gap: '2rem', width: '50%' }}>
+            <Mask
+                label="Маска телефона"
+                mask="+7 (000) 000 - 00 - 00"
+                maskChar="_"
+                showPrefix={false}
+                view={view}
+                onChange={onChange}
+                {...rest}
+            />
+
+            <Mask
+                label="Маска телефона: отображается всегда"
+                mask="+7 (000) 000 - 00 - 00"
+                maskChar="_"
+                view={view}
+                alwaysShowMask
+                onChange={onChange}
+                {...rest}
+            />
+
+            <Mask
+                label="Маска даты"
+                mask="00/00/0000"
+                maskString="DD/MM/YYYY"
+                alwaysShowMask
+                view={view}
+                onChange={onChange}
+                {...rest}
+            />
+
+            <Mask
+                label="Маска даты: значения по умолчанию"
+                // eslint-disable-next-line no-octal-escape
+                mask="12.\04.0000"
+                maskChar="_"
+                alwaysShowMask
+                view={view}
+                onChange={onChange}
+                {...rest}
+            />
+
+            <Mask
+                label="Маска времени"
+                mask="00:00"
+                maskChar="_"
+                alwaysShowMask
+                view={view}
+                onChange={onChange}
+                {...rest}
+            />
+        </div>
+    );
+};
+
+export const Default: StoryObj<StoryPropsDefault> = {
+    args: {
+        size: 'l',
+        view: 'default',
+        labelPlacement: 'outer',
+        placeholder: 'Заполните поле',
+        disabled: false,
+        readOnly: false,
+    },
+    render: (args) => <StoryDemo {...args} />,
+};

package/emotion/cjs/index.js

@@ -629,4 +629,15 @@ Object.keys(_Editable).forEach(function (key) {
       return _Editable[key];
     }
   });
+});
+var _Mask = /*#__PURE__*/require("./components/Mask");
+Object.keys(_Mask).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _Mask[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _Mask[key];
+    }
+  });
 });

package/emotion/es/components/Mask/Mask.js

@@ -0,0 +1,212 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+var _excluded = ["mask", "maskChar", "alwaysShowMask", "maskString", "showPrefix", "value", "defaultValue", "showMask", "onChange", "onBlur", "onFocus", "reformat"];
+function _extends() { _extends = Object.assign ? Object.assign.bind() : 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); }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t["return"] && (u = t["return"](), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
+function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
+import React, { forwardRef, useEffect, useMemo, useRef, useState } from 'react';
+import { useForkRef } from '@salutejs/plasma-core';
+import { useDidMountEffect } from '../../hooks';
+import { createMask, defaults } from './utils/createMask';
+import { keyboardCode } from './utils/constants';
+export var composeMask = function composeMask(InputComponent) {
+  return /*#__PURE__*/forwardRef(function (props, outerRef) {
+    var maskValue = props.mask,
+      maskChar = props.maskChar,
+      alwaysShowMask = props.alwaysShowMask,
+      maskString = props.maskString,
+      showPrefix = props.showPrefix,
+      value = props.value,
+      defaultValue = props.defaultValue,
+      showMaskedValue = props.showMask,
+      onChange = props.onChange,
+      onBlur = props.onBlur,
+      onFocus = props.onFocus,
+      reformat = props.reformat,
+      rest = _objectWithoutProperties(props, _excluded);
+    var _useState = useState(alwaysShowMask || showMaskedValue),
+      _useState2 = _slicedToArray(_useState, 2),
+      showMask = _useState2[0],
+      setShowMask = _useState2[1];
+    var _useState3 = useState(''),
+      _useState4 = _slicedToArray(_useState3, 2),
+      innerValue = _useState4[0],
+      setInnerValue = _useState4[1];
+    var mask = useMemo(function () {
+      return createMask({
+        value: String(value) || String(defaultValue) || '',
+        mask: maskValue,
+        maskChar: maskChar || defaults.maskChar,
+        maskString: maskString,
+        showPrefix: showPrefix || defaults.showPrefix,
+        reformat: reformat
+      });
+    }, []);
+    var canSetSelection = useRef(false);
+    var inputRef = useRef(null);
+    var innerRef = useForkRef(inputRef, outerRef);
+    var getSelection = function getSelection() {
+      var _inputRef$current, _inputRef$current2;
+      mask.setSelection = {
+        start: (inputRef === null || inputRef === void 0 || (_inputRef$current = inputRef.current) === null || _inputRef$current === void 0 ? void 0 : _inputRef$current.selectionStart) || 0,
+        end: (inputRef === null || inputRef === void 0 || (_inputRef$current2 = inputRef.current) === null || _inputRef$current2 === void 0 ? void 0 : _inputRef$current2.selectionEnd) || 0
+      };
+    };
+    var setSelection = function setSelection() {
+      var _inputRef$current3;
+      if (!canSetSelection.current) {
+        return;
+      }
+      var selection = mask.getSelection;
+      inputRef === null || inputRef === void 0 || (_inputRef$current3 = inputRef.current) === null || _inputRef$current3 === void 0 || _inputRef$current3.setSelectionRange(selection.start, selection.end);
+      setTimeout(function () {
+        var _inputRef$current4;
+        return inputRef === null || inputRef === void 0 || (_inputRef$current4 = inputRef.current) === null || _inputRef$current4 === void 0 ? void 0 : _inputRef$current4.setSelectionRange(selection.start, selection.end);
+      }, 0);
+    };
+    var showValue = function showValue() {
+      if (!(inputRef !== null && inputRef !== void 0 && inputRef.current)) {
+        return;
+      }
+      if (showMask && (canSetSelection.current || alwaysShowMask)) {
+        inputRef.current.value = mask.getState.maskedValue;
+        setInnerValue(mask.getState.maskedValue);
+        return;
+      }
+      setInnerValue(mask.getState.visibleValue);
+      inputRef.current.value = mask.getState.visibleValue;
+    };
+    var keyPressPropName = function keyPressPropName() {
+      if (typeof navigator !== 'undefined' && navigator.userAgent.match(/Android/i)) {
+        return 'onBeforeInput';
+      }
+      return 'onKeyPress';
+    };
+    var dispatchEvent = function dispatchEvent(e) {
+      var _mask$getState = mask.getState,
+        maskedValue = _mask$getState.maskedValue,
+        visibleValue = _mask$getState.visibleValue;
+      if (onChange) {
+        onChange(e, {
+          maskedValue: maskedValue,
+          value: visibleValue
+        });
+      }
+    };
+    var onPaste = function onPaste(e) {
+      e.preventDefault();
+      getSelection();
+      if (!(e !== null && e !== void 0 && e.clipboardData)) {
+        return;
+      }
+      mask.paste(e.clipboardData.getData('Text'));
+      setTimeout(setSelection, 0);
+      dispatchEvent(e);
+    };
+    var handleChange = function handleChange(e) {
+      var currentValue;
+      if (showMask && (canSetSelection.current || alwaysShowMask)) {
+        currentValue = mask.getState.maskedValue;
+      } else {
+        currentValue = mask.getState.visibleValue;
+      }
+      if (e.target.value !== currentValue) {
+        getSelection();
+        mask.updateValue(e.target.value);
+        setTimeout(setSelection, 0);
+      }
+      dispatchEvent(e);
+    };
+    var onKeyPress = function onKeyPress(e) {
+      if (e.metaKey || e.altKey || e.ctrlKey || e.key === 'Enter') {
+        return;
+      }
+      e.preventDefault();
+      getSelection();
+      mask.input(e.key || String.fromCharCode(e.which));
+      setSelection();
+      dispatchEvent(e);
+    };
+    var onKeyDown = function onKeyDown(e) {
+      if (e.code === keyboardCode.Backspace) {
+        e.preventDefault();
+        getSelection();
+        mask.removePreviousOrSelected();
+        setSelection();
+        dispatchEvent(e);
+      }
+      if (e.code === keyboardCode.Delete) {
+        e.preventDefault();
+        getSelection();
+        mask.removeNextOrSelected();
+        setSelection();
+        dispatchEvent(e);
+      }
+    };
+    var handleFocus = function handleFocus(e) {
+      canSetSelection.current = true;
+      if (onFocus) {
+        onFocus(e);
+      }
+    };
+    var handleBlur = function handleBlur(e) {
+      canSetSelection.current = false;
+      if (onBlur) {
+        onBlur(e);
+      }
+    };
+    var keyPressEvent = _defineProperty({}, keyPressPropName(), onKeyPress);
+    useDidMountEffect(function () {
+      setShowMask(alwaysShowMask || showMask);
+    }, [alwaysShowMask, showMask]);
+    useDidMountEffect(function () {
+      if (reformat) {
+        mask.updateReformat(reformat);
+      }
+    }, [reformat]);
+    useDidMountEffect(function () {
+      mask.updateMask(String(mask));
+    }, [mask]);
+    useDidMountEffect(function () {
+      mask.updateMaskString(String(maskString));
+    }, [maskString]);
+    useDidMountEffect(function () {
+      mask.updateMaskChar(String(maskChar));
+    }, [maskChar]);
+    useEffect(function () {
+      mask.updateValue(String(value));
+    }, [value]);
+    useEffect(function () {
+      showValue();
+    }, [showValue, mask]);
+    useEffect(function () {
+      var subscriber = function subscriber() {
+        showValue();
+        setSelection();
+      };
+      mask.subscribe(subscriber);
+      return function () {
+        mask.unsubscribe(subscriber);
+      };
+    }, [mask, showValue, setSelection]);
+    return /*#__PURE__*/React.createElement(InputComponent, _extends({}, rest, {
+      onChange: handleChange,
+      onKeyDown: onKeyDown,
+      onPaste: onPaste,
+      onFocus: handleFocus,
+      onBlur: handleBlur
+    }, keyPressEvent, {
+      value: innerValue,
+      ref: innerRef,
+      autoComplete: "off"
+    }));
+  });
+};

package/emotion/es/components/Mask/Mask.template-doc.mdx

@@ -0,0 +1,126 @@
+---
+id: mask
+title: Mask
+---
+
+import { PropsTable, Description, StorybookLink } from '@site/src/components';
+
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# Mask
+<Description name="Mask" />
+<PropsTable name="Mask" exclude={['css']} />
+<StorybookLink name="Mask" />
+
+## Использование
+Компонент `Mask` представляет собой поле ввода с возможностью маскирования значения.
+Он реализован на компоненте [TextField](https://plasma.sberdevices.ru/b2c/components/textfield/) 
+и наследует практически все его свойства (`size`, `view`, `disabled`, `label` и тд.)
+
+```tsx live
+import React from 'react';
+import { Mask } from '@salutejs/{{ package }}';
+import { IconDone } from '@salutejs/plasma-icons';
+
+export function App() {
+    return (
+        <div>
+            <Mask
+                label="Лейбл"
+                leftHelper="Подсказка к полю"
+                placeholder="Введите дату"
+                mask="00/00/0000"
+                maskString="DD/MM/YYYY"
+                size="l"
+            />
+        </div>
+    );
+}
+```
+
+### Маска
+Маска задается с помощью свойства `mask`.
+Поддерживает следующие символы:
+
+| Обозначение | Описание                              |
+|-------------|---------------------------------------|
+| 0           | любая цифра от 0 до 9                 |
+| a (англ.)   | A-Z, a-z                              |
+| я           | А-Я, а-я, ё, Ё                        |
+| q           | буква "q"                             |
+| 2           | цифра "2"                             |
+| *           | любой символ                          |
+| \           | символ экранирования "\a" - буква "a" |
+
+
+<Tabs>
+    <TabItem value="phone" label="Маска телефона">
+        Пример маски для ввода телефона
+
+        ```tsx live
+        import React from 'react';
+        import { Mask } from '@salutejs/{{ package }}';
+
+        export function App() {
+            return (
+                <div>
+                    <Mask
+                        label="Маска телефона"
+                        placeholder="Введите телефон"
+                        mask="+7 (000) 000 - 00 - 00"
+                        maskChar="_"
+                        size="l"
+                        alwaysShowMask
+                    />
+                </div>
+            );
+        }
+        ```
+    </TabItem>
+    <TabItem value="date" label="Маска даты">
+        Пример маски для ввода даты
+
+        ```tsx live
+        import React from 'react';
+        import { Mask } from '@salutejs/{{ package }}';
+
+        export function App() {
+            return (
+                <div>
+                    <Mask
+                        label="Маска даты"
+                        placeholder="Введите дату"
+                        mask="00/00/0000"
+                        maskString="DD/MM/YYYY"
+                        size="l"
+                    />
+                </div>
+            );
+        }
+        ```
+    </TabItem>
+    <TabItem value="time" label="Маска времени">
+        Пример маски для ввода даты
+
+        ```tsx live
+        import React from 'react';
+        import { Mask } from '@salutejs/{{ package }}';
+
+        export function App() {
+            return (
+                <div>
+                    <Mask
+                        label="Маска времени"
+                        placeholder="Введите время"
+                        mask="1\0:00"
+                        maskChar="_"
+                        size="l"
+                        showPrefix
+                    />
+                </div>
+            );
+        }
+        ```
+    </TabItem>
+</Tabs>

package/emotion/es/components/Mask/Mask.types.js

@@ -0,0 +1 @@
+export {};

package/emotion/es/components/Mask/index.js

@@ -0,0 +1 @@
+export { composeMask } from './Mask';

package/emotion/es/components/Mask/utils/constants.js

@@ -0,0 +1,23 @@
+export var charType = {
+  User: 1,
+  Char: 2,
+  Mask: 3
+};
+export var keyboardCode = {
+  Backspace: 'Backspace',
+  Delete: 'Delete'
+};
+export var escapeChar = '\\';
+export var defaultFormatChars = [{
+  str: '0',
+  regexp: /[0-9]/
+}, {
+  str: '*',
+  regexp: /./
+}, {
+  str: 'a',
+  regexp: /[a-zA-Z]/
+}, {
+  str: 'я',
+  regexp: /[а-яА-ЯёЁ]/
+}];