@central-design-system/components 4.0.0-alpha.1 → 4.0.0-alpha.11

package/dist/es/src/components/index.js

@@ -34,7 +34,7 @@ import { C as CdsInput } from "./CdsInput/index.js";
 import { C as CdsLabel } from "./CdsLabel/index.js";
 import { C as CdsLayout } from "./CdsLayout/index.js";
 import { C as CdsLink } from "./CdsLink/index.js";
-import { C as CdsList, c as CdsListGroup, a as CdsListItem, d as CdsListItemAction, e as CdsListItemDescription, b as CdsListItemDivider, f as CdsListItemImage, g as CdsListItemMedia, h as CdsListItemSubtitle, i as CdsListItemTitle } from "./CdsList/index.js";
+import { C as CdsList, c as CdsListGroup, a as CdsListItem, d as CdsListItemAction, e as CdsListItemDescription, b as CdsListItemDivider, f as CdsListItemImage, g as CdsListItemMedia, h as CdsListItemSubtitle, i as CdsListItemTitle, j as CdsListSubheader } from "./CdsList/index.js";
 import { C as CdsLoader } from "./CdsLoader/index.js";
 import { C as CdsMain } from "./CdsMain/index.js";
 import { C as CdsMenu } from "./CdsMenu/index.js";
@@ -42,6 +42,7 @@ import { C as CdsMessages } from "./CdsMessages/index.js";
 import { C as CdsModal } from "./CdsModal/index.js";
 import { C as CdsNotification } from "./CdsNotification/index.js";
 import { C as CdsNotificationAlert } from "./CdsNotificationAlert/index.js";
+import { C as CdsOtpField, a as CdsOtpGroup, b as CdsOtpInput, c as CdsOtpSeparator } from "./CdsOtpInput/index.js";
 import { C as CdsOverlay } from "./CdsOverlay/index.js";
 import { C as CdsPage } from "./CdsPage/index.js";
 import { C as CdsPagination } from "./CdsPagination/index.js";
@@ -78,9 +79,11 @@ import { C as CdsVirtualScroll, a as CdsVirtualScrollItem } from "./CdsVirtualSc
 import { _ as _sfc_main } from "./CdsGrid/CdsCol.vue_vue_type_script_setup_true_lang.js";
 import { _ as _sfc_main$1 } from "./CdsGrid/CdsGrid.vue_vue_type_script_setup_true_lang.js";
 import { _ as _sfc_main$2 } from "./CdsGrid/CdsRow.vue_vue_type_script_setup_true_lang.js";
-import { c as CDS_DRAWER_WIDTH, b as CDS_DRAWER_WIDTH_MINIFIED, d as CDS_DRAWER_Z_INDEX_INNER, a as CDS_DRAWER_Z_INDEX_OUTER } from "./CdsDrawer/api/CdsDrawer.constants.js";
+import { a as CDS_DRAWER_WIDTH, c as CDS_DRAWER_WIDTH_MINIFIED, f as CDS_DRAWER_Z_INDEX_INNER, b as CDS_DRAWER_Z_INDEX_OUTER } from "./CdsDrawer/api/CdsDrawer.constants.js";
+import { d as CdsOtpInputSymbol } from "./CdsOtpInput/api/CdsOtpInput.constants.js";
 import { C as CssGridSymbol } from "./CdsGrid/api/CdsGrid.constants.js";
 import { E as EXPAND_COLUMN, a as SELECTION_ALL, S as SELECTION_COLUMN, b as SELECTION_INVERT, c as SELECTION_NONE, u as useSelection } from "./CdsTable/composable/selection.js";
+import { O as OtpInputPatterns, u as useOtpInput } from "./CdsOtpInput/composables/useOtpInput.js";
 import { a as allowedTypes } from "./CdsSkeletonLoader/api/CdsSkeletonLoader.types.js";
 import { m as makeTableProps, u as useLazyKVMap } from "./CdsTable/composable/table.js";
 import { u as useToastItem, a as useToastQueue } from "./CdsToastQueue/composables/useToastQueue.js";
@@ -154,6 +157,7 @@ const index = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.definePropert
   CdsListItemMedia,
   CdsListItemSubtitle,
   CdsListItemTitle,
+  CdsListSubheader,
   CdsLoader,
   CdsMain,
   CdsMenu,
@@ -161,6 +165,11 @@ const index = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.definePropert
   CdsModal,
   CdsNotification,
   CdsNotificationAlert,
+  CdsOtpField,
+  CdsOtpGroup,
+  CdsOtpInput,
+  CdsOtpInputSymbol,
+  CdsOtpSeparator,
   CdsOverlay,
   CdsPage,
   CdsPagination,
@@ -212,6 +221,7 @@ const index = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.definePropert
   CdsVirtualScrollItem,
   CssGridSymbol,
   EXPAND_COLUMN,
+  OtpInputPatterns,
   SELECTION_ALL,
   SELECTION_COLUMN,
   SELECTION_INVERT,
@@ -219,6 +229,7 @@ const index = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.definePropert
   allowedTypes,
   makeTableProps,
   useLazyKVMap,
+  useOtpInput,
   useSelection,
   useToastItem,
   useToastQueue

package/dist/es/src/composables/useAppearance/useAppearance.js

@@ -4,7 +4,10 @@ import { toRef, toValue } from "vue";
 const availableAppearance = ["primary", "secondary", "tertiary", "inverse"];
 const defineAppearanceProps = propsFactory(
   {
-    /** Внешний вид компонента */
+    /**
+     * Внешний вид компонента
+     * @en Visual appearance of the component
+     */
     appearance: {
       type: String,
       default: "primary",

package/dist/es/src/composables/useColor/useColor.js

@@ -5,15 +5,30 @@ import { n as normalizeColors, f as fixedAliasForeground, i as isColorAlias, s a
 import { r as resolveColorPrimitive, i as isCssColor, f as isParsableColor, p as parseColor, h as hasLightForeground } from "../../utils/colorsUtils/utils.js";
 const defineColorProps = propsFactory(
   {
-    /** Цвет компонента */
+    /**
+     * Цвет компонента
+     * @en Component color
+     */
     color: String,
-    /** Цвет неактивного компонента */
+    /**
+     * Цвет неактивного компонента
+     * @en Color of the component in its inactive state
+     */
     baseColor: String,
-    /** Цвет компонента, когда он находится в активном состоянии */
+    /**
+     * Цвет компонента, когда он находится в активном состоянии
+     * @en Color of the component in its active state
+     */
     activeColor: String,
-    /** Цвет фона компонента */
+    /**
+     * Цвет фона компонента
+     * @en Background color of the component
+     */
     bgColor: String,
-    /** Цвет текста компонента */
+    /**
+     * Цвет текста компонента
+     * @en Text color of the component
+     */
     textColor: String
   },
   "color"

package/dist/es/src/composables/useDatetime/useDatetime.js

@@ -8,6 +8,7 @@ const defineDatetimeProps = propsFactory(
   {
     /**
      * Значение модели
+     * @en Value of the model
      */
     modelValue: {
       type: [String, Array, Object],
@@ -15,6 +16,7 @@ const defineDatetimeProps = propsFactory(
     },
     /**
      * Формат даты/времени
+     * @en Date/time format
      */
     mask: {
       type: String,
@@ -23,6 +25,7 @@ const defineDatetimeProps = propsFactory(
     /**
      * Локаль для дат. Имя локали ('ru' | 'en') или объект `TDateLocale`.
      * По умолчанию берётся текущая локаль из `useLocale`, иначе `ru`.
+     * @en Locale for the dates. A locale name ('ru' | 'en') or a `TDateLocale` object. The current locale from `useLocale` is taken by default, otherwise `ru`.
      */
     locale: {
       type: [String, Object],

package/dist/es/src/composables/useDelay/useDelay.js

@@ -2,9 +2,15 @@ import { p as propsFactory } from "../../core/propsFactory.js";
 import { y as defer } from "../../utils/helpers.js";
 const defineDelayProps = propsFactory(
   {
-    /** Время ожидания в миллисекундах перед закрытием компонента. Работает только с параметром open-on-hover. */
+    /**
+     * Время ожидания в миллисекундах перед закрытием компонента. Работает только с параметром open-on-hover.
+     * @en Delay in milliseconds before the component closes. Works only together with open-on-hover.
+     */
     closeDelay: [Number, String],
-    /** Время ожидания в миллисекундах перед открытием компонента. Работает только с параметром open-on-hover. */
+    /**
+     * Время ожидания в миллисекундах перед открытием компонента. Работает только с параметром open-on-hover.
+     * @en Delay in milliseconds before the component opens. Works only together with open-on-hover.
+     */
     openDelay: [Number, String]
   },
   "delay"

package/dist/es/src/composables/useDimensions/useDimensions.js

@@ -3,32 +3,50 @@ import { u as convertToUnit } from "../../utils/helpers.js";
 import { computed } from "vue";
 const defineDimensionsProps = propsFactory(
   {
-    /** Ширина компонента */
+    /**
+     * Ширина компонента
+     * @en Component width
+     */
     width: {
       type: [Number, String],
       default: void 0
     },
-    /** Высота компонента */
+    /**
+     * Высота компонента
+     * @en Component height
+     */
     height: {
       type: [Number, String],
       default: void 0
     },
-    /** Максимальная ширина компонента */
+    /**
+     * Максимальная ширина компонента
+     * @en Maximum component width
+     */
     maxWidth: {
       type: [Number, String],
       default: void 0
     },
-    /** Максимальная высота компонента */
+    /**
+     * Максимальная высота компонента
+     * @en Maximum component height
+     */
     maxHeight: {
       type: [Number, String],
       default: void 0
     },
-    /** Минимальная ширина компонента */
+    /**
+     * Минимальная ширина компонента
+     * @en Minimum component width
+     */
     minWidth: {
       type: [Number, String],
       default: void 0
     },
-    /** Минимальная высота компонента */
+    /**
+     * Минимальная высота компонента
+     * @en Minimum component height
+     */
     minHeight: {
       type: [Number, String],
       default: void 0

package/dist/es/src/composables/useDirection/useDirection.js

@@ -3,7 +3,10 @@ import { p as propsFactory } from "../../core/propsFactory.js";
 import { computed, toRef, toValue } from "vue";
 const defineDirectionProps = propsFactory(
   {
-    /** Переключение между горизонтальным или вертикальным отображением. */
+    /**
+     * Переключение между горизонтальным или вертикальным отображением.
+     * @en Switches the component between horizontal and vertical layout.
+     */
     direction: {
       type: String,
       default: "horizontal",

package/dist/es/src/composables/useDisabled/useDisabled.js

@@ -3,7 +3,10 @@ import { p as propsFactory } from "../../core/propsFactory.js";
 import { toRef, toValue } from "vue";
 const defineDisabledProps = propsFactory(
   {
-    /** Заблокированное состояние */
+    /**
+     * Заблокированное состояние
+     * @en Disabled state
+     */
     disabled: {
       type: Boolean,
       default: null

package/dist/es/src/composables/useDisplay/useDisplay.js

@@ -10,6 +10,7 @@ const defineDisplayProps = propsFactory(
      * Если значение равно true, компонент будет отображаться в режиме для Mobile.
      * Если значение равно false, компонент будет отображаться в режиме для Desktop.
      * Если значение равно null, режим будет зависеть от текущего Breakpoint.
+     * @en Determines the display mode of the component: `true` renders it in mobile mode, `false` in desktop mode, `null` makes the mode depend on the current breakpoint.
      */
     mobile: {
       type: Boolean,
@@ -17,6 +18,7 @@ const defineDisplayProps = propsFactory(
     },
     /** Указывает точку преломления, при которой отображение будет переключаться в мобильный режим.
      * Может быть числом (например, 600) или строкой, соответствующей одному из предопределенных Breakpoint (например, 'xs', 'sm', 'md', 'lg', 'xl').
+     * @en Sets the breakpoint at which the component switches to mobile mode. Accepts a number (for example, 600) or the name of a predefined breakpoint (`xs`, `sm`, `md`, `lg`, `xl`).
      */
     mobileBreakpoint: [Number, String]
   },

package/dist/es/src/composables/useFilter/useFilter.js

@@ -3,13 +3,33 @@ import { ac as wrapInArray, M as getPropertyFromItem } from "../../utils/helpers
 import { shallowRef, computed, unref, watchEffect } from "vue";
 const defineFilterProps = propsFactory(
   {
+    /**
+     * Своя функция фильтрации значений. Получает значение, поисковый запрос и элемент, возвращает совпадение или `-1`
+     * @en Your own value filtering function. Receives the value, the search query and the item, returns a match or `-1`
+     */
     customFilter: Function,
+    /**
+     * Отдельные функции фильтрации для конкретных ключей элемента — объект вида `{ ключ: функция }`
+     * @en Separate filtering functions for specific item keys — an object of the form `{ key: function }`
+     */
     customKeyFilter: Object,
+    /**
+     * Ключи элемента, по которым идёт поиск. По умолчанию фильтрация идёт по заголовку элемента
+     * @en Item keys the search runs over. By default filtering goes by the item title
+     */
     filterKeys: [Array, String],
+    /**
+     * Как объединяются результаты `customKeyFilter` и общей фильтрации: пересечением, объединением или заменой
+     * @en How the results of `customKeyFilter` and of the general filtering are combined: by intersection, by union or by replacement
+     */
     filterMode: {
       type: String,
       default: "intersection"
     },
+    /**
+     * Отключает встроенную фильтрацию — список показывается как есть, поиск обрабатывается снаружи
+     * @en Turns off the built-in filtering — the list is shown as is, the search is handled outside
+     */
     noFilter: Boolean
   },
   "filter"

package/dist/es/src/composables/useFocus/useFocus.js

@@ -5,9 +5,15 @@ import { E as EventProp } from "../../utils/helpers.js";
 import { toRef, unref } from "vue";
 const defineFocusProps = propsFactory(
   {
-    /** Управляет состоянием фокуса компонента. Когда `true`, компонент считается сфокусированным и может применять соответствующие стили или поведение. */
+    /**
+     * Управляет состоянием фокуса компонента. Когда `true`, компонент считается сфокусированным и может применять соответствующие стили или поведение.
+     * @en Controls the focus state of the component. When `true`, the component is considered focused and may apply the corresponding styles or behavior.
+     */
     focused: Boolean,
-    /** Событие, которое срабатывает при изменении состояния фокуса компонента. */
+    /**
+     * Событие, которое срабатывает при изменении состояния фокуса компонента.
+     * @en Fires when the focus state of the component changes.
+     */
     "onUpdate:focused": EventProp()
   },
   "focus"
@@ -27,7 +33,10 @@ function useFocus(props, name = getCurrentInstanceName()) {
 }
 const defineAutofocusProps = propsFactory(
   {
-    /** Включает автофокус */
+    /**
+     * Включает автофокус
+     * @en Enables autofocus
+     */
     autofocus: Boolean
   },
   "autofocus"

package/dist/es/src/composables/useFocus/useFocusTrap.js

@@ -4,9 +4,15 @@ import { a as IN_BROWSER } from "../../utils/dom/globals.js";
 import { toRef, watch, onScopeDispose, nextTick, toValue } from "vue";
 const defineFocusTrapProps = propsFactory(
   {
-    /** Замыкает Tab-навигацию внутри контента: с последнего фокусируемого элемента фокус переходит на первый и наоборот. */
+    /**
+     * Замыкает Tab-навигацию внутри контента: с последнего фокусируемого элемента фокус переходит на первый и наоборот.
+     * @en Traps Tab navigation inside the content: from the last focusable element the focus moves to the first one and back.
+     */
     retainFocus: Boolean,
-    /** Возвращает фокус внутрь контента, если он ушёл за его пределы — например, по Tab с конца страницы. Клик мышью фокус не перехватывает. */
+    /**
+     * Возвращает фокус внутрь контента, если он ушёл за его пределы — например, по Tab с конца страницы. Клик мышью фокус не перехватывает.
+     * @en Returns the focus back into the content if it has left it — for example on Tab from the end of the page. A mouse click does not steal the focus.
+     */
     captureFocus: Boolean
   },
   "focus-trap"
@@ -119,17 +125,17 @@ function onKeydown(e) {
   const focusable = focusableChildren(closestTrap).filter((x) => x.tabIndex >= 0);
   if (!focusable.length) return;
   const active = document.activeElement;
-  if (focusable.length === 1 && focusable[0].classList.contains("v-list") && focusable[0].contains(active)) {
+  if (focusable.length === 1 && focusable[0].classList.contains("cds-list") && focusable[0].contains(active)) {
     e.preventDefault();
     return;
   }
   const firstElement = focusable[0];
   const lastElement = focusable[focusable.length - 1];
-  if (e.shiftKey && (active === firstElement || firstElement.classList.contains("v-list") && firstElement.contains(active))) {
+  if (e.shiftKey && (active === firstElement || firstElement.classList.contains("cds-list") && firstElement.contains(active))) {
     e.preventDefault();
     lastElement.focus();
   }
-  if (!e.shiftKey && (active === lastElement || lastElement.classList.contains("v-list") && lastElement.contains(active))) {
+  if (!e.shiftKey && (active === lastElement || lastElement.classList.contains("cds-list") && lastElement.contains(active))) {
     e.preventDefault();
     firstElement.focus();
   }

package/dist/es/src/composables/useForm/useForm.js

@@ -3,15 +3,27 @@ import { d as defineReadonlyProps } from "../useReadonly/useReadonly.js";
 import { p as propsFactory } from "../../core/propsFactory.js";
 import { u as useProxyModel } from "../../core/useProxyModel.js";
 import { w as warn } from "../../utils/dom/console.js";
-import { inject, computed, unref, toRef, shallowRef, ref, watch, provide, markRaw } from "vue";
+import { toRef, shallowRef, ref, watch, unref, provide, markRaw, inject, computed } from "vue";
 import { F as FormKey } from "./internal/useForm.constants.js";
 const defineFormProps = propsFactory(
   {
+    /**
+     * Останавливает валидацию на первом же невалидном поле — остальные поля не проверяются
+     * @en Stops the validation at the very first invalid field — the remaining fields are not checked
+     */
     firstFail: Boolean,
+    /**
+     * Итоговая валидность формы: `true` — все поля прошли проверку, `false` — есть ошибки, `null` — форма ещё не валидировалась
+     * @en Resulting validity of the form: `true` — every field passed the check, `false` — there are errors, `null` — the form has not been validated yet
+     */
     modelValue: {
       type: Boolean,
       default: null
     },
+    /**
+     * Когда запускать валидацию полей формы: при вводе, потере фокуса или только вручную
+     * @en When to run the validation of the form fields: on input, on blur or manually only
+     */
     validateOn: {
       type: String,
       default: "input"
@@ -106,14 +118,47 @@ function createForm(props) {
     validateOn: toRef(() => props.validateOn)
   });
   return {
+    /**
+     * Ошибки валидации полей формы: идентификатор поля и его сообщения об ошибках.
+     * @en Validation errors of the form fields: the identifier of a field and its error messages.
+     */
     errors,
+    /**
+     * Заблокированы ли все поля формы.
+     * @en Whether all the fields of the form are blocked.
+     */
     isDisabled,
+    /**
+     * Доступны ли поля формы только для чтения.
+     * @en Whether the fields of the form are read-only.
+     */
     isReadonly,
+    /**
+     * Идёт ли сейчас валидация формы.
+     * @en Whether the form is being validated right now.
+     */
     isValidating,
+    /**
+     * Валидность формы: `true` — все поля прошли проверку, `false` — есть ошибки, `null` — форма ещё не валидировалась.
+     * @en Validity of the form: `true` — every field passed the check, `false` — there are errors, `null` — the form has not been validated yet.
+     */
     isValid: model,
+    /**
+     * Зарегистрированные в форме поля с их состоянием валидации.
+     * @en The fields registered in the form together with their validation state.
+     */
     items,
+    /**
+     * Запускает валидацию всех полей формы и возвращает результат вместе со списком ошибок.
+     * @en Runs the validation of all the form fields and returns the result together with the list of errors.
+     */
     validate,
+    /** Сбрасывает значения всех полей формы и их валидацию. */
     reset,
+    /**
+     * Сбрасывает только состояние валидации, сохраняя введённые значения.
+     * @en Resets the validation state only, keeping the entered values.
+     */
     resetValidation
   };
 }

package/dist/es/src/composables/useGoTo/useGoTo.js

@@ -54,7 +54,7 @@ async function scrollTo(_target, _options, horizontal, goTo) {
 function useGoTo(_options = {}) {
   const goToInstance = inject(GoToSymbol);
   const { isRtl } = useRtl();
-  if (!goToInstance) throw new Error("[Vuetify] Could not find injected goto instance");
+  if (!goToInstance) throw new Error("[CDS] Could not find injected goto instance");
   const goTo = {
     ...goToInstance,
     rtl: toRef(() => unref(goToInstance.rtl) || unref(isRtl))

package/dist/es/src/composables/useGroup/useGroup.js

@@ -7,20 +7,38 @@ import { w as warn } from "../../utils/dom/console.js";
 import { reactive, onMounted, onBeforeUnmount, onUpdated, unref, toRef, provide } from "vue";
 const defineGroupProps = propsFactory(
   {
-    /** Значение выбранных элементов группы */
+    /**
+     * Значение выбранных элементов группы
+     * @en Value of the selected items of the group
+     */
     modelValue: {
       type: null,
       default: void 0
     },
-    /** Разрешить множественный выбор */
+    /**
+     * Разрешить множественный выбор
+     * @en Allows selecting several items at once
+     */
     multiple: Boolean,
-    /** Обязательный выбор хотя бы одного элемента */
+    /**
+     * Обязательный выбор хотя бы одного элемента
+     * @en Requires at least one item to stay selected
+     */
     required: [Boolean, String],
-    /** Обязательный выбор хотя бы одного элемента */
+    /**
+     * Обязательный выбор хотя бы одного элемента
+     * @en Requires at least one item to stay selected
+     */
     mandatory: [Boolean, String],
-    /** Максимальное количество выбираемых элементов */
+    /**
+     * Максимальное количество выбираемых элементов
+     * @en Maximum number of items that can be selected
+     */
     max: Number,
-    /** CSS класс для выбранного состояния */
+    /**
+     * CSS класс для выбранного состояния
+     * @en CSS class applied in the selected state
+     */
     selectedClass: String,
     ...defineDisabledProps()
   },

package/dist/es/src/composables/useGroup/useGroupItem.js

@@ -4,9 +4,15 @@ import { p as propsFactory } from "../../core/propsFactory.js";
 import { useId, provide, inject, toRef, computed, unref, onBeforeUnmount, watch } from "vue";
 const defineGroupItemProps = propsFactory(
   {
-    /** Значение компонента в группе */
+    /**
+     * Значение компонента в группе
+     * @en Value of the component within the group
+     */
     value: null,
-    /** CSS класс для выбранного состояния */
+    /**
+     * CSS класс для выбранного состояния
+     * @en CSS class applied in the selected state
+     */
     selectedClass: String,
     ...defineDisabledProps()
   },

package/dist/es/src/composables/useHydration/useHydration.js

@@ -1,6 +1,6 @@
+import { u as useDisplay } from "../useDisplay/useDisplay.js";
 import { a as IN_BROWSER } from "../../utils/dom/globals.js";
 import { shallowRef, onMounted } from "vue";
-import { u as useDisplay } from "../useDisplay/useDisplay.js";
 function useHydration() {
   if (!IN_BROWSER) return shallowRef(false);
   const { ssr } = useDisplay();

package/dist/es/src/composables/useItems/useItems.js

@@ -3,39 +3,63 @@ import { W as isPrimitive, a7 as pick, x as deepEqual, M as getPropertyFromItem,
 import { computed, shallowRef, watchEffect } from "vue";
 const defineItemsProps = propsFactory(
   {
-    /** Массив элементов для отображения */
+    /**
+     * Массив элементов для отображения
+     * @en Array of items to display
+     */
     items: {
       type: Array,
       default: () => []
     },
-    /** Свойство объекта, используемое как заголовок элемента, либо функция для его получения */
+    /**
+     * Свойство объекта, используемое как заголовок элемента, либо функция для его получения
+     * @en Object field used as the item title, or a function that returns it
+     */
     itemTitle: {
       type: [String, Array, Function],
       default: "title"
     },
-    /** Свойство объекта, используемое как значение элемента, либо функция для его получения */
+    /**
+     * Свойство объекта, используемое как значение элемента, либо функция для его получения
+     * @en Object field used as the item value, or a function that returns it
+     */
     itemValue: {
       type: [String, Array, Function],
       default: "value"
     },
-    /** Свойство объекта, содержащее дочерние элементы, либо функция для их получения */
+    /**
+     * Свойство объекта, содержащее дочерние элементы, либо функция для их получения
+     * @en Object field that holds the child items, or a function that returns them
+     */
     itemChildren: {
       type: [Boolean, String, Array, Function],
       default: "children"
     },
-    /** Свойство объекта, содержащее пропсы для элемента, либо функция для их получения */
+    /**
+     * Свойство объекта, содержащее пропсы для элемента, либо функция для их получения
+     * @en Object field that holds the props of the item, or a function that returns them
+     */
     itemProps: {
       type: [Boolean, String, Array, Function],
       default: "props"
     },
-    /** Свойство объекта, определяющее тип элемента (`item`, `divider`, `subheader`), либо функция для его получения */
+    /**
+     * Свойство объекта, определяющее тип элемента (`item`, `divider`, `subheader`), либо функция для его получения
+     * @en Object field that defines the item type (`item`, `divider`, `subheader`), or a function that returns it
+     */
     itemType: {
       type: [Boolean, String, Array, Function],
       default: "type"
     },
-    /** Возвращать в значении модели объект вместо массива */
+    /**
+     * Возвращать в значении модели объект вместо массива
+     * @en Return an object in the model value instead of an array
+     */
     returnObject: Boolean,
-    /** Функция сравнения значений элементов для определения выбранного состояния */
+    /**
+     * Функция сравнения значений элементов для определения выбранного состояния
+     * @en Function that compares item values to determine the selected state
+     */
     valueComparator: Function
   },
   "list-items"