@salutejs/plasma-new-hope 0.324.1-canary.1994.15271445725.0 → 0.324.1-canary.1996.15273628835.0

package/styled-components/cjs/examples/plasma_web/components/CodeField/CodeField.stories.tsx

@@ -0,0 +1,107 @@
+import React, { ComponentProps, useState } from 'react';
+import type { StoryObj, Meta } from '@storybook/react';
+import { action } from '@storybook/addon-actions';
+import { getConfigVariations } from '@salutejs/plasma-sb-utils';
+
+import { WithTheme } from '../../../_helpers';
+
+import { CodeField } from './CodeField';
+import { config } from './CodeField.config';
+
+const onChange = action('onChange');
+const onFullCodeEnter = action('onFullCodeEnter');
+
+const { views, sizes } = getConfigVariations(config);
+const codeLengths = [4, 5, 6];
+const shapes = ['default', 'segmented'];
+const captionAlignVariants = ['left', 'center'];
+const itemErrorBehaviorVariants = ['remove-symbol', 'keep', 'forbid-enter'];
+const codeErrorBehaviorVariants = ['remove-code', 'keep'];
+
+const meta: Meta<typeof CodeField> = {
+    title: 'web/Data Entry/CodeField',
+    component: CodeField,
+    decorators: [WithTheme],
+    argTypes: {
+        view: {
+            options: views,
+            control: {
+                type: 'select',
+            },
+        },
+        size: {
+            options: sizes,
+            control: {
+                type: 'inline-radio',
+            },
+        },
+        shape: {
+            options: shapes,
+            control: {
+                type: 'inline-radio',
+            },
+        },
+        captionAlign: {
+            options: captionAlignVariants,
+            control: {
+                type: 'inline-radio',
+            },
+        },
+        codeLength: {
+            options: codeLengths,
+            control: {
+                type: 'inline-radio',
+            },
+        },
+        itemErrorBehavior: {
+            options: itemErrorBehaviorVariants,
+            control: {
+                type: 'inline-radio',
+            },
+        },
+        codeErrorBehavior: {
+            options: codeErrorBehaviorVariants,
+            control: {
+                type: 'inline-radio',
+            },
+        },
+    },
+    parameters: {
+        controls: {
+            exclude: ['view'],
+        },
+    },
+};
+
+export default meta;
+
+type StoryPropsDefault = ComponentProps<typeof CodeField>;
+
+const StoryDefault = (args: StoryPropsDefault) => {
+    const [value, setValue] = useState('');
+
+    const handleChange = (newValue: string) => {
+        setValue(newValue);
+        onChange(newValue);
+    };
+
+    return <CodeField {...args} value={value} onChange={handleChange} onFullCodeEnter={onFullCodeEnter} />;
+};
+
+export const Default: StoryObj<StoryPropsDefault> = {
+    args: {
+        view: 'default',
+        size: 'm',
+        shape: 'default',
+        codeLength: 6,
+        caption: 'Caption',
+        captionAlign: 'center',
+        width: '',
+        isError: false,
+        itemErrorBehavior: 'remove-symbol',
+        codeErrorBehavior: 'keep',
+        autoFocus: true,
+        disabled: false,
+    },
+    render: StoryDefault,
+};

package/styled-components/cjs/index.js

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

package/styled-components/es/components/CodeField/CodeField.js

@@ -0,0 +1,290 @@
+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 _Separator;
+var _excluded = ["className", "value", "placeholder", "autoFocus", "codeLength", "caption", "captionAlign", "width", "shape", "view", "size", "disabled", "isError", "allowedSymbols", "itemErrorBehavior", "codeErrorBehavior", "autoComplete", "setIsError", "onChange", "onFullCodeEnter"];
+function _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+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 _toConsumableArray(r) { return _arrayWithoutHoles(r) || _iterableToArray(r) || _unsupportedIterableToArray(r) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _iterableToArray(r) { if ("undefined" != typeof Symbol && null != r[Symbol.iterator] || null != r["@@iterator"]) return Array.from(r); }
+function _arrayWithoutHoles(r) { if (Array.isArray(r)) return _arrayLikeToArray(r); }
+function _slicedToArray(r, e) { return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _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(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
+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(r) { if (Array.isArray(r)) return r; }
+function _objectWithoutProperties(e, t) { if (null == e) return {}; var o, r, i = _objectWithoutPropertiesLoose(e, t); if (Object.getOwnPropertySymbols) { var n = Object.getOwnPropertySymbols(e); for (r = 0; r < n.length; r++) o = n[r], -1 === t.indexOf(o) && {}.propertyIsEnumerable.call(e, o) && (i[o] = e[o]); } return i; }
+function _objectWithoutPropertiesLoose(r, e) { if (null == r) return {}; var t = {}; for (var n in r) if ({}.hasOwnProperty.call(r, n)) { if (-1 !== e.indexOf(n)) continue; t[n] = r[n]; } return t; }
+import React, { forwardRef, Fragment, useCallback, useEffect, useRef, useState } from 'react';
+import cls from 'classnames';
+import { useDidMountEffect } from "../../hooks";
+import { getSizeValueFromProp } from "../../utils";
+import { BACKSPACE_KEY, FORBIDDEN_KEYS, ONLY_DIGITS_PATTERN } from "./utils/constants";
+import { getCodeValue, getFieldPattern, getPlaceholderValue, handleCodeError, handleItemError } from "./utils";
+import { classes } from "./CodeField.tokens";
+import { base, CaptionWrapper, CodeGroup, CodeWrapper, ItemInput, Separator } from "./CodeField.styles";
+import { base as viewCSS } from "./variations/_view/base";
+import { base as sizeCSS } from "./variations/_size/base";
+import { base as shapeCSS } from "./variations/_shape/base";
+import { base as disabledCSS } from "./variations/_disabled/base";
+export var codeFieldRoot = function codeFieldRoot(Root) {
+  return /*#__PURE__*/forwardRef(function (_ref, ref) {
+    var className = _ref.className,
+      outerValue = _ref.value,
+      placeholder = _ref.placeholder,
+      autoFocus = _ref.autoFocus,
+      _ref$codeLength = _ref.codeLength,
+      codeLength = _ref$codeLength === void 0 ? 6 : _ref$codeLength,
+      caption = _ref.caption,
+      _ref$captionAlign = _ref.captionAlign,
+      captionAlign = _ref$captionAlign === void 0 ? 'left' : _ref$captionAlign,
+      width = _ref.width,
+      _ref$shape = _ref.shape,
+      shape = _ref$shape === void 0 ? 'default' : _ref$shape,
+      view = _ref.view,
+      size = _ref.size,
+      disabled = _ref.disabled,
+      isError = _ref.isError,
+      _ref$allowedSymbols = _ref.allowedSymbols,
+      allowedSymbols = _ref$allowedSymbols === void 0 ? ONLY_DIGITS_PATTERN : _ref$allowedSymbols,
+      _ref$itemErrorBehavio = _ref.itemErrorBehavior,
+      itemErrorBehavior = _ref$itemErrorBehavio === void 0 ? 'remove-symbol' : _ref$itemErrorBehavio,
+      _ref$codeErrorBehavio = _ref.codeErrorBehavior,
+      codeErrorBehavior = _ref$codeErrorBehavio === void 0 ? 'remove-code' : _ref$codeErrorBehavio,
+      _ref$autoComplete = _ref.autoComplete,
+      autoComplete = _ref$autoComplete === void 0 ? 'one-time-code' : _ref$autoComplete,
+      setIsError = _ref.setIsError,
+      onChange = _ref.onChange,
+      onFullCodeEnter = _ref.onFullCodeEnter,
+      rest = _objectWithoutProperties(_ref, _excluded);
+    var _useState = useState(getCodeValue(codeLength, outerValue || '')),
+      _useState2 = _slicedToArray(_useState, 2),
+      code = _useState2[0],
+      setCode = _useState2[1];
+    var _useState3 = useState(code.join('')),
+      _useState4 = _slicedToArray(_useState3, 2),
+      originalValue = _useState4[0],
+      setOriginalValue = _useState4[1];
+    var inputRefs = useRef([]);
+    var inputContainerRef = useRef(null);
+    var captionRef = useRef(null);
+    var fieldPattern = getFieldPattern(allowedSymbols);
+    var placeholderValue = getPlaceholderValue(codeLength, placeholder);
+    var parts = codeLength === 6 ? 2 : 1;
+    var widthValue = width ? getSizeValueFromProp(width, 'rem') : undefined;
+    var getLastActiveIndex = function getLastActiveIndex() {
+      if (code.length && code.length < codeLength) {
+        return code.length;
+      }
+      var lastEmptyIndex = code.findIndex(function (digit) {
+        return digit === '';
+      });
+      return lastEmptyIndex >= 0 ? lastEmptyIndex : codeLength - 1;
+    };
+    var handleClick = function handleClick() {
+      if (disabled) {
+        return;
+      }
+      var lastActiveIndex = getLastActiveIndex();
+      if (inputRefs.current[lastActiveIndex]) {
+        inputRefs.current[lastActiveIndex].focus();
+      }
+    };
+    var handleOnKeyDown = function handleOnKeyDown(event, index) {
+      if (disabled) {
+        return;
+      }
+      var key = event.key;
+      if (FORBIDDEN_KEYS.includes(key)) {
+        event.preventDefault();
+        return;
+      }
+      if (key === BACKSPACE_KEY) {
+        if (index > 0 && code[index] === '') {
+          var _inputRefs$current;
+          (_inputRefs$current = inputRefs.current[index - 1]) === null || _inputRefs$current === void 0 || _inputRefs$current.focus();
+        }
+      }
+    };
+    var codeSetter = function codeSetter(newCode) {
+      setCode(newCode);
+      setOriginalValue(newCode.join(''));
+      if (onChange) {
+        onChange(newCode.join(''));
+      }
+    };
+    var handleChange = function handleChange(event, index) {
+      var _inputRefs$current$in;
+      if (disabled) {
+        return;
+      }
+      var rawSymbol = event.currentTarget.value;
+      var symbol = rawSymbol.charAt(rawSymbol.length - 1);
+      var newCode = _toConsumableArray(code);
+      (_inputRefs$current$in = inputRefs.current[index]) === null || _inputRefs$current$in === void 0 || _inputRefs$current$in.classList.remove(classes.itemError);
+      if (isError) {
+        var _captionRef$current;
+        (_captionRef$current = captionRef.current) === null || _captionRef$current === void 0 || _captionRef$current.classList.remove(classes.captionError);
+        if (codeErrorBehavior === 'keep') {
+          var _inputContainerRef$cu;
+          (_inputContainerRef$cu = inputContainerRef.current) === null || _inputContainerRef$cu === void 0 || _inputContainerRef$cu.classList.remove(classes.codeError, classes.codeErrorAnimation);
+        }
+        if (setIsError) {
+          setIsError(false);
+        }
+      }
+      if (!fieldPattern) {
+        newCode[index] = symbol;
+        codeSetter(newCode);
+        if (symbol && index < codeLength - 1) {
+          var _inputRefs$current2;
+          (_inputRefs$current2 = inputRefs.current[index + 1]) === null || _inputRefs$current2 === void 0 || _inputRefs$current2.focus();
+        }
+        return;
+      }
+      if (!symbol) {
+        newCode[index] = '';
+        codeSetter(newCode);
+        return;
+      }
+      if (fieldPattern.test(symbol)) {
+        newCode[index] = symbol.charAt(symbol.length - 1);
+        codeSetter(newCode);
+        if (index < codeLength - 1) {
+          var _inputRefs$current3;
+          (_inputRefs$current3 = inputRefs.current[index + 1]) === null || _inputRefs$current3 === void 0 || _inputRefs$current3.focus();
+        }
+      } else {
+        newCode[index] = symbol.charAt(symbol.length - 1);
+        handleItemError({
+          currentSymbol: symbol,
+          itemErrorBehavior: itemErrorBehavior,
+          index: index,
+          newCode: newCode,
+          inputRefs: inputRefs,
+          setCode: setCode,
+          codeSetter: codeSetter
+        });
+      }
+    };
+    var handlePaste = function handlePaste(event) {
+      var _inputRefs$current$ac;
+      if (disabled) {
+        return;
+      }
+      event.preventDefault();
+      var rawData = event.clipboardData.getData('text/plain');
+      var pastedData = (fieldPattern ? rawData.split('').map(function (symb) {
+        var _symb$match;
+        return ((_symb$match = symb.match(fieldPattern)) === null || _symb$match === void 0 ? void 0 : _symb$match[0]) || '';
+      }).filter(Boolean) || [] : rawData.split('')).slice(0, codeLength);
+      var activeIndex = Math.min(pastedData.length, codeLength - 1);
+      (_inputRefs$current$ac = inputRefs.current[activeIndex]) === null || _inputRefs$current$ac === void 0 || _inputRefs$current$ac.focus();
+      codeSetter(pastedData);
+    };
+    var handleFullCodeEnter = useCallback(function (fullCode) {
+      if (onFullCodeEnter) {
+        onFullCodeEnter(fullCode);
+      }
+    }, []);
+    useEffect(function () {
+      inputRefs.current = inputRefs.current.slice(0, codeLength);
+    }, [codeLength]);
+    useEffect(function () {
+      if (autoFocus && !disabled) {
+        var _inputRefs$current$la;
+        var lastActiveIndex = getLastActiveIndex();
+        (_inputRefs$current$la = inputRefs.current[lastActiveIndex]) === null || _inputRefs$current$la === void 0 || _inputRefs$current$la.focus();
+      }
+    }, [autoFocus]);
+    useDidMountEffect(function () {
+      if (handleFullCodeEnter && originalValue.length === codeLength) {
+        handleFullCodeEnter(originalValue);
+      }
+    }, [originalValue, handleFullCodeEnter]);
+    useDidMountEffect(function () {
+      if (isError) {
+        handleCodeError({
+          codeLength: codeLength,
+          codeErrorBehavior: codeErrorBehavior,
+          currentCode: code,
+          inputRefs: inputRefs,
+          inputContainerRef: inputContainerRef,
+          captionRef: captionRef,
+          setCode: setCode,
+          codeSetter: codeSetter
+        });
+      }
+    }, [isError]);
+    return /*#__PURE__*/React.createElement(Root, _extends({
+      ref: ref,
+      view: view,
+      size: size,
+      shape: shape,
+      disabled: disabled,
+      onClick: handleClick,
+      className: cls(className, _defineProperty({}, classes.captionAlignLeft, captionAlign === 'left'))
+    }, rest), /*#__PURE__*/React.createElement(CodeWrapper, {
+      ref: inputContainerRef
+    }, _toConsumableArray(Array(parts)).map(function (_, partIndex) {
+      return /*#__PURE__*/React.createElement(Fragment, {
+        key: partIndex
+      }, /*#__PURE__*/React.createElement(CodeGroup, {
+        role: "group"
+      }, _toConsumableArray(Array(codeLength / parts)).map(function (_, i) {
+        var inputCorrectIndex = i + codeLength / parts * partIndex;
+        return /*#__PURE__*/React.createElement(ItemInput, _extends({
+          key: partIndex + i + partIndex * i,
+          ref: function ref(element) {
+            inputRefs.current[inputCorrectIndex] = element;
+          },
+          className: cls(_defineProperty(_defineProperty({}, classes.segmented, shape === 'segmented'), classes.hoverEnabled, !disabled && inputCorrectIndex >= originalValue.length)),
+          value: code[inputCorrectIndex] || '',
+          autoComplete: autoComplete,
+          onChange: function onChange(e) {
+            handleChange(e, inputCorrectIndex);
+          },
+          onKeyDown: function onKeyDown(e) {
+            handleOnKeyDown(e, inputCorrectIndex);
+          },
+          onPaste: handlePaste,
+          tabIndex: !disabled && originalValue.length === inputCorrectIndex ? 0 : -1
+        }, placeholderValue && {
+          placeholder: placeholderValue[inputCorrectIndex]
+        }));
+      })), partIndex !== parts - 1 && (_Separator || (_Separator = /*#__PURE__*/React.createElement(Separator, null))));
+    })), caption && /*#__PURE__*/React.createElement(CaptionWrapper, {
+      ref: captionRef,
+      captionAlign: captionAlign,
+      widthValue: widthValue
+    }, caption));
+  });
+};
+export var codeFieldConfig = {
+  name: 'CodeField',
+  tag: 'div',
+  layout: codeFieldRoot,
+  base: base,
+  variations: {
+    view: {
+      css: viewCSS
+    },
+    size: {
+      css: sizeCSS
+    },
+    shape: {
+      css: shapeCSS
+    },
+    disabled: {
+      css: disabledCSS,
+      attrs: true
+    }
+  },
+  defaults: {
+    size: 'm',
+    view: 'default',
+    shape: 'default'
+  }
+};

package/styled-components/es/components/CodeField/CodeField.styles.js

@@ -0,0 +1,30 @@
+var _templateObject;
+function _taggedTemplateLiteral(e, t) { return t || (t = e.slice(0)), Object.freeze(Object.defineProperties(e, { raw: { value: Object.freeze(t) } })); }
+import { css } from 'styled-components';
+import styled from 'styled-components';
+import { classes, tokens } from "./CodeField.tokens";
+export var base = /*#__PURE__*/css(_templateObject || (_templateObject = /*#__PURE__*/_taggedTemplateLiteral(["\n    display: flex;\n    flex-direction: column;\n    justify-content: center;\n    width: min-content;\n    align-items: center;\n\n    &.", " {\n        align-items: start;\n    }\n"])), classes.captionAlignLeft);
+export var CodeWrapper = /*#__PURE__*/styled.div.withConfig({
+  componentId: "plasma-new-hope__sc-1269wxl-0"
+})(["display:flex;align-items:center;"]);
+export var CodeGroup = /*#__PURE__*/styled.div.withConfig({
+  componentId: "plasma-new-hope__sc-1269wxl-1"
+})(["display:flex;align-items:center;"]);
+export var Separator = /*#__PURE__*/styled.div.withConfig({
+  componentId: "plasma-new-hope__sc-1269wxl-2"
+})(["width:var(", ");"], tokens.separatorWidth);
+export var ItemInput = /*#__PURE__*/styled.input.withConfig({
+  componentId: "plasma-new-hope__sc-1269wxl-3"
+})(["box-sizing:border-box;appearance:none;border:0;padding:0;outline:none;pointer-events:none;text-align:center;"]);
+export var CaptionWrapper = /*#__PURE__*/styled.div.withConfig({
+  componentId: "plasma-new-hope__sc-1269wxl-4"
+})(["text-align:", ";align-self:", ";width:", ";white-space:pre-line;"], function (_ref) {
+  var captionAlign = _ref.captionAlign;
+  return captionAlign;
+}, function (_ref2) {
+  var captionAlign = _ref2.captionAlign;
+  return captionAlign;
+}, function (_ref3) {
+  var widthValue = _ref3.widthValue;
+  return widthValue || 'auto';
+});

package/styled-components/es/components/CodeField/CodeField.template-doc.mdx

@@ -0,0 +1,150 @@
+---
+id: codefield
+title: CodeField
+---
+
+import { PropsTable, Description } from '@site/src/components';
+
+# CodeField
+Компонент `CodeField` используется для ввода OTP-кодов.
+
+<Description name="CodeField" />
+<PropsTable name="CodeField" />
+
+## Примеры
+
+### Размер
+Размер задается с помощью свойства `size`. 
+Ширина компонента так же может регулироваться при помощи свойства `width`:
+
+```tsx live
+import React from 'react';
+import { CodeField } from '@salutejs/{{ package }}';
+
+export function App() {
+    return (
+        <div style=\{{ flexDirection: 'column', gap: '2rem' }}>
+            <CodeField
+                size="l"
+                caption="Осталось попыток: 4"
+                captionAlign="center"
+            />
+            <CodeField
+                size="m"
+                caption="Чтобы выслать вам код повторно подождите: 20 секунд"
+                captionAlign="left"
+            />
+            <CodeField 
+                width="25"
+                caption="Не передавайте никому код из СМС. Иначе ваш аккаунт могут взломать"
+                captionAlign="center"
+            />
+        </div>
+    );
+}
+```
+
+### Форма компонента и длина кода
+Форма компонента задается с помощью свойства `shape`, а длина кода с помощью `codeLength`:
+
+```tsx live
+import React from 'react';
+import { CodeField } from '@salutejs/{{ package }}';
+
+export function App() {
+    return (
+        <div style=\{{ flexDirection: 'column', gap: '2rem' }}>
+            <div style=\{{ display: 'flex', gap: '2rem' }}>
+                <CodeField shape="default" codeLength={4} />
+                <CodeField shape="segmented"  codeLength={4} />
+            </div>
+            <div style=\{{ display: 'flex', gap: '2rem' }}>
+                <CodeField shape="default" codeLength={5} />
+                <CodeField shape="segmented"  codeLength={5} />
+            </div>
+            <div style=\{{ display: 'flex', gap: '2rem' }}>
+                <CodeField shape="default" codeLength={6} />
+                <CodeField shape="segmented"  codeLength={6} />
+            </div>
+        </div>
+    );
+}
+```
+
+### Допустимые символы и поведение ячейки при вводе некорректного символа
+За допустимые символы для ввода отвечает свойство `allowedSymbols`. Задается строкой или регулярным выражением.
+Библиотека экспортирует наиболее используемые вариации допустимых символов:
+`import { ONLY_DIGITS_PATTERN, ONLY_CHARS_PATTERN, ONLY_DIGITS_AND_CHARS_PATTERN } from '@salutejs/{{ package }}';`
+
+Поведение ячейки при вводе некорректного символа регулируется свойством `itemErrorBehavior`:
+
+```tsx live
+import React from 'react';
+import { CodeField } from '@salutejs/{{ package }}';
+
+export function App() {
+    return (
+        <div>
+            <CodeField value="123" itemErrorBehavior="remove-symbol" />
+            <CodeField value="123" itemErrorBehavior="keep" />
+            <CodeField value="123" itemErrorBehavior="forbid-enter" />
+        </div>
+    );
+}
+```
+
+### Поведение компонента при вводе некорректного кода и индикация ошибки
+При заполнении всех полей ввода срабатывает колбэк `onFullCodeEnter`. 
+При неверном вводе кода, поведние компонента управляется с помощью свойства `codeErrorBehavior`. 
+Индикация ошибки происходит с помощью флага `isError` и колбека `setIsError`:
+
+```tsx live
+import React, { useState, useRef, Dispatch, SetStateAction } from 'react';
+import { CodeField } from '@salutejs/{{ package }}';
+
+export function App() {
+    const [disabledFirst, setDisabledFirst] = useState(false);
+    const [isErrorFirst, setIsErrorFirst] = useState(false);
+    
+    const [disabledSecond, setDisabledSecond] = useState(false);
+    const [isErrorSecond, setIsErrorSecond] = useState(false);
+
+    const onFullCodeEnter = (
+        code: string,
+        errorSetter: Dispatch<SetStateAction<boolean>>,
+        disableSetter: Dispatch<SetStateAction<boolean>>
+    ) => {
+        disableSetter(true);
+
+        // имитация запроса на сервер
+        setTimeout(() => {
+            disableSetter(false);
+
+            if (code !== '123456') {
+                errorSetter(true);
+            }
+        }, 3000)
+    }
+
+    return (
+        <div style=\{{ flexDirection: 'column', gap: '2rem' }}>
+            <CodeField
+                itemErrorBehavior="remove-symbol"
+                codeErrorBehavior="remove-code"
+                disabled={disabledFirst}
+                isError={isErrorFirst}
+                setIsError={setIsErrorFirst}
+                onFullCodeEnter={(code) => onFullCodeEnter(code, setIsErrorFirst, setDisabledFirst)}
+            />
+            <CodeField
+                itemErrorBehavior="remove-symbol"
+                codeErrorBehavior="keep"
+                disabled={disabledSecond}
+                isError={isErrorSecond}
+                setIsError={setIsErrorSecond}
+                onFullCodeEnter={(code) => onFullCodeEnter(code, setIsErrorSecond, setDisabledSecond)}
+            />
+        </div>
+    );
+}
+```

package/styled-components/es/components/CodeField/CodeField.tokens.js

@@ -0,0 +1,51 @@
+export var classes = {
+  itemError: 'codefield-item-error',
+  itemErrorAnimation: 'codefield-item-error-animation',
+  itemErrorFade: 'codefield-item-error-fade',
+  captionError: 'codefield-caption-error',
+  codeError: 'codefield-code-error',
+  codeErrorAnimation: 'codefield-code-error-animation',
+  codeErrorFade: 'codefield-code-error-fade',
+  captionAlignLeft: 'codefield-caption-align-left',
+  hoverEnabled: 'codefield-item-hover-enabled',
+  segmented: 'codefield-shape-segmented',
+  "default": 'codefield-shape-default',
+  disabled: 'codefield-disabled'
+};
+export var tokens = {
+  captionGap: '--plasma-codefield-caption-gap',
+  codeItemsGap: '--plasma-codefield-code-item-gap',
+  separatorWidth: '--plasma-codefield-separator-width',
+  codeItemWidth: '--plasma-codefield-item-width',
+  codeItemHeight: '--plasma-codefield-item-height',
+  fontFamily: '--plasma-codefield-font-family',
+  fontStyle: '--plasma-codefield-font-style',
+  fontSize: '--plasma-codefield-font-size',
+  fontWeight: '--plasma-codefield-font-weight',
+  letterSpacing: '--plasma-codefield-letter-spacing',
+  lineHeight: '--plasma-codefield-line-height',
+  captionFontFamily: '--plasma-codefield-caption-font-family',
+  captionFontSize: '--plasma-codefield-caption-font-style',
+  captionFontStyle: '--plasma-codefield-caption-font-size',
+  captionFontWeight: '--plasma-codefield-caption-font-weight',
+  captionLetterSpacing: '--plasma-codefield-caption-letter-spacing',
+  captionLineHeight: '--plasma-codefield-caption-line-height',
+  borderRadius: '--plasma-codefield-code-item-border-radius',
+  borderRadiusSegmented: '--plasma-codefield-code-item-border-radius-segmented',
+  segmentedSideBorderRadius: '--plasma-codefield-code-item-segmented-side-border-radius',
+  captionColor: '--plasma-codefield-caption-color',
+  captionColorError: '--plasma-codefield-caption-color-error',
+  codeColor: '--plasma-codefield-code-color',
+  codeColorError: '--plasma-codefield-code-color-error',
+  backgroundColor: '--plasma-codefield-background-color',
+  backgroundColorHover: '--plasma-codefield-background-color-hover',
+  backgroundColorFocus: '--plasma-codefield-background-color-focus',
+  backgroundErrorColor: '--plasma-codefield-background-error-color',
+  borderWidth: '--plasma-codefield-border-width',
+  borderColor: '--plasma-codefield-border-color',
+  borderColorHover: '--plasma-codefield-border-color-hover',
+  borderColorFocus: '--plasma-codefield-border-color-focus',
+  borderErrorColor: '--plasma-codefield-border-error-color',
+  caretColor: '--plasma-codefield-caret-color',
+  disabledOpacity: '--plasma-codefield-disabled-opacity'
+};

package/styled-components/es/components/CodeField/CodeField.types.js

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

package/styled-components/es/components/CodeField/index.js

@@ -0,0 +1,3 @@
+export { codeFieldRoot, codeFieldConfig } from "./CodeField";
+export { tokens as codeFieldTokens, classes as codeFieldClasses } from "./CodeField.tokens";
+export { ONLY_DIGITS_PATTERN, ONLY_CHARS_PATTERN, ONLY_DIGITS_AND_CHARS_PATTERN } from "./utils/constants";

package/styled-components/es/components/CodeField/utils/constants.js

@@ -0,0 +1,6 @@
+export var ONLY_DIGITS_PATTERN = '^\\d+$';
+export var ONLY_CHARS_PATTERN = '^[a-zA-Z]+$';
+export var ONLY_DIGITS_AND_CHARS_PATTERN = '^[a-zA-Z0-9]+$';
+export var FORBIDDEN_KEYS = ['ArrowLeft', 'ArrowRight', 'ArrowUp', 'ArrowDown', 'Delete'];
+export var BACKSPACE_KEY = 'Backspace';
+export var ANIMATION_TIMEOUT = 300;