@central-design-system/components 4.0.0-alpha.4 → 4.0.0-alpha.5

package/dist/esm-node/src/components/CdsUploader/composables/useUpload.mjs

@@ -7,117 +7,186 @@ const defineUploadProps = propsFactory(
       type: String,
       default: void 0
     },
-    /** Тип носителя, откуда захватывать файл для загрузки на мобильных устройствах */
+    /**
+     * Тип носителя, откуда захватывать файл для загрузки на мобильных устройствах
+     * @en Type of the media the file is captured from on mobile devices
+     */
     capture: {
       type: [Boolean, String],
       default: void 0
     },
-    /** Множественная загрузка файлов */
+    /**
+     * Множественная загрузка файлов
+     * @en Uploading several files at once
+     */
     multiple: {
       type: Boolean,
       default: true
     },
-    /** URL, куда загружать файлы */
+    /**
+     * URL, куда загружать файлы
+     * @en URL the files are uploaded to
+     */
     action: {
       type: [String, Function],
       default: void 0
     },
-    /** Тип http-запроса для загрузки файлов */
+    /**
+     * Тип http-запроса для загрузки файлов
+     * @en HTTP method of the upload request
+     */
     method: {
       type: String,
       default: void 0
     },
-    /** Загружать директории */
+    /**
+     * Загружать директории
+     * @en Upload directories
+     */
     directory: {
       type: Boolean,
       default: void 0
     },
-    /** Список файлов по умолчанию */
+    /**
+     * Список файлов по умолчанию
+     * @en Default list of files
+     */
     defaultFileList: {
       type: Array,
       default: void 0
     },
-    /** Показывать список загруженных файлов */
+    /**
+     * Показывать список загруженных файлов
+     * @en Show the list of the uploaded files
+     */
     showUploadList: {
       type: [Boolean, Object],
       default: void 0
     },
-    /** Функция рендера для отображения элемента списка загружаемых файлов */
+    /**
+     * Функция рендера для отображения элемента списка загружаемых файлов
+     * @en Render function for an item of the uploaded file list
+     */
     itemRender: {
       type: Function,
       default: void 0
     },
-    /** Тип списка загружаемых файлов (поддерживается только 'text') */
+    /**
+     * Тип списка загружаемых файлов (поддерживается только 'text')
+     * @en Type of the uploaded file list ('text' only is supported)
+     */
     listType: {
       type: String,
       default: void 0
     },
-    /** Параметры загрузки файла или функция, возвращающая параметры загрузки файла */
+    /**
+     * Параметры загрузки файла или функция, возвращающая параметры загрузки файла
+     * @en Parameters of the file upload or a function returning them
+     */
     data: {
       type: [Object, Function],
       default: void 0
     },
-    /** Заголовки запроса */
+    /**
+     * Заголовки запроса
+     * @en Request headers
+     */
     headers: {
       type: Object,
       default: void 0
     },
-    /** Типы разрешённых файлов */
+    /**
+     * Типы разрешённых файлов
+     * @en Allowed file types
+     */
     accept: {
       type: [String, Array],
       default: void 0
     },
-    /** Собственный запрос на загрузку файла. Переопределяет xhr по умолчанию */
+    /**
+     * Собственный запрос на загрузку файла. Переопределяет xhr по умолчанию
+     * @en Your own file upload request. Overrides the default xhr
+     */
     customRequest: {
       type: Function,
       default: void 0
     },
-    /** Запрос с передачей cookie */
+    /**
+     * Запрос с передачей cookie
+     * @en Send the request with cookies
+     */
     withCredentials: {
       type: Boolean,
       default: void 0
     },
-    /** Открывать ли системное окно при клике на загрузчик файлов */
+    /**
+     * Открывать ли системное окно при клике на загрузчик файлов
+     * @en Whether to open the system dialog on a click on the uploader
+     */
     openFileDialogOnClick: {
       type: Boolean,
       default: void 0
     },
-    /** Хук жизненного цикла перед загрузкой файла */
+    /**
+     * Хук жизненного цикла перед загрузкой файла
+     * @en Lifecycle hook called before a file is uploaded
+     */
     beforeUpload: {
       type: Function,
       default: void 0
     },
-    /** Максимальное количество загружаемых файлов */
+    /**
+     * Максимальное количество загружаемых файлов
+     * @en Maximum number of uploaded files
+     */
     maxCount: {
       type: Number,
       default: void 0
     },
-    /** Настройка отображения миниатюр загружаемых файлов (пока не поддерживается) */
+    /**
+     * Настройка отображения миниатюр загружаемых файлов (пока не поддерживается)
+     * @en Configuration of the thumbnails of the uploaded files (not supported yet)
+     */
     isImageUrl: {
       type: Function,
       default: void 0
     },
-    /** Показывать ли тултип с ошибкой возле каждого файла */
+    /**
+     * Показывать ли тултип с ошибкой возле каждого файла
+     * @en Whether to show a tooltip with the error next to every file
+     */
     showTooltipWithError: {
       type: Boolean,
       default: false
     },
-    /** Свойства для компонента CdsButton */
+    /**
+     * Свойства для компонента CdsButton
+     * @en Props for the CdsButton component
+     */
     buttonProps: {
       type: Object,
       default: null
     },
-    /** Иконка удаления файла */
+    /**
+     * Иконка удаления файла
+     * @en File removal icon
+     */
     removeIcon: {
       type: IconValue,
       default: "delete"
     },
-    /** Иконка скачивания файла */
+    /**
+     * Иконка скачивания файла
+     * @en File download icon
+     */
     downloadIcon: {
       type: IconValue,
       default: "download"
     },
-    /** Иконка загрузки файла */
+    /**
+     * Иконка загрузки файла
+     * @en File upload icon
+     */
     uploadIcon: {
       type: IconValue,
       default: "upload"
@@ -162,17 +231,26 @@ const defineUploadListProps = propsFactory(
       type: Boolean,
       default: false
     },
-    /** Иконка удаления файла */
+    /**
+     * Иконка удаления файла
+     * @en File removal icon
+     */
     removeIcon: {
       type: IconValue,
       default: "delete"
     },
-    /** Иконка скачивания файла */
+    /**
+     * Иконка скачивания файла
+     * @en File download icon
+     */
     downloadIcon: {
       type: IconValue,
       default: "download"
     },
-    /** Иконка загрузки файла */
+    /**
+     * Иконка загрузки файла
+     * @en File upload icon
+     */
     uploadIcon: {
       type: IconValue,
       default: "upload"

package/dist/esm-node/src/components/CdsVirtualScroll/CdsVirtualScroll.css

@@ -1,21 +1,3 @@
-@charset "UTF-8";
-/*
-* Easing component
-* @type Map
-*/
-/*
-* Get the transition-timing-function for a given easing and motion mode
-* @param {String} $type - Can be `ease-in-out`, `ease-in`, or `ease-out`
-* @param {String} $mode [basic] - Can be `basic` or `accent`
-* @param {Map} $easing [$easing] - Easing's map
-* @return {Function} CSS `cubic-bezier()` function
-*/
-/*
-* Set the transition-timing-function for a given easing and motion mode
-* @param {Number} $duration — The dynamic duration in ms
-* @param {String} $type - The name of the easing curve to apply
-* @param {String} $mode - The mode for the easing curve to use
-*/
 @layer cds-components {
   .cds-virtual-scroll {
     position: relative;

package/dist/esm-node/src/components/CdsVirtualScroll/CdsVirtualScroll.vue_vue_type_script_setup_true_lang.mjs

@@ -65,7 +65,15 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
       onScopeDispose(handleListeners);
     });
     __expose({
+      /**
+       * Пересчитывает окно видимых элементов — нужно после изменения их высоты вне цикла обновления.
+       * @en Recalculates the window of visible items — needed after their height changes outside the update cycle.
+       */
       calculateVisibleItems,
+      /**
+       * Прокручивает список к элементу с указанным индексом.
+       * @en Scrolls the list to the item with the given index.
+       */
       scrollToIndex
     });
     return () => {

package/dist/esm-node/src/components/CdsVirtualScroll/api/CdsVirtualScroll.props.mjs

@@ -5,12 +5,18 @@ import { C as CdsVirtualScrollItemConstants, a as CdsVirtualScrollConstants } fr
 import { d as defineDimensionsProps } from "../../../composables/useDimensions/useDimensions.mjs";
 const defineCdsVirtualScrollProps = propsFactory(
   {
-    /** Массив элементов, которые отрисовываются виртуальным скроллом. */
+    /**
+     * Массив элементов, которые отрисовываются виртуальным скроллом.
+     * @en Array of the items rendered by the virtual scroll.
+     */
     items: {
       type: Array,
       default: () => []
     },
-    /** Безрамочный режим: компонент не создаёт собственный скролл-контейнер, а использует ближайший скроллируемый родитель. */
+    /**
+     * Безрамочный режим: компонент не создаёт собственный скролл-контейнер, а использует ближайший скроллируемый родитель.
+     * @en Renderless mode: the component does not create its own scroll container and uses the nearest scrollable parent instead.
+     */
     renderless: Boolean,
     ...defineVirtualProps(),
     ...defineDimensionsProps(),
@@ -20,7 +26,10 @@ const defineCdsVirtualScrollProps = propsFactory(
 );
 const defineCdsVirtualScrollItemProps = propsFactory(
   {
-    /** Безрамочный режим: элемент рендерит только содержимое слота без обёртки. */
+    /**
+     * Безрамочный режим: элемент рендерит только содержимое слота без обёртки.
+     * @en Renderless mode: the item renders only the slot content, without a wrapper.
+     */
     renderless: Boolean,
     ...defineComponentProps()
   },

package/dist/esm-node/src/components/index.mjs

@@ -34,7 +34,7 @@ import { C as CdsInput } from "./CdsInput/index.mjs";
 import { C as CdsLabel } from "./CdsLabel/index.mjs";
 import { C as CdsLayout } from "./CdsLayout/index.mjs";
 import { C as CdsLink } from "./CdsLink/index.mjs";
-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.mjs";
+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.mjs";
 import { C as CdsLoader } from "./CdsLoader/index.mjs";
 import { C as CdsMain } from "./CdsMain/index.mjs";
 import { C as CdsMenu } from "./CdsMenu/index.mjs";
@@ -157,6 +157,7 @@ const index = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.definePropert
   CdsListItemMedia,
   CdsListItemSubtitle,
   CdsListItemTitle,
+  CdsListSubheader,
   CdsLoader,
   CdsMain,
   CdsMenu,

package/dist/esm-node/src/composables/useAppearance/useAppearance.mjs

@@ -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/esm-node/src/composables/useColor/useColor.mjs

@@ -5,15 +5,30 @@ import { r as resolveColorPrimitive, i as isCssColor, f as isParsableColor, p as
 import { z as destructComputed } from "../../utils/helpers.mjs";
 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/esm-node/src/composables/useDatetime/useDatetime.mjs

@@ -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/esm-node/src/composables/useDelay/useDelay.mjs

@@ -2,9 +2,15 @@ import { p as propsFactory } from "../../core/propsFactory.mjs";
 import { y as defer } from "../../utils/helpers.mjs";
 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/esm-node/src/composables/useDimensions/useDimensions.mjs

@@ -3,32 +3,50 @@ import { computed } from "vue";
 import { u as convertToUnit } from "../../utils/helpers.mjs";
 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/esm-node/src/composables/useDirection/useDirection.mjs

@@ -3,7 +3,10 @@ import { p as propsFactory } from "../../core/propsFactory.mjs";
 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/esm-node/src/composables/useDisabled/index.mjs

@@ -1,2 +1,2 @@
-
+import "vue";
 //# sourceMappingURL=index.mjs.map

package/dist/esm-node/src/composables/useDisabled/useDisabled.mjs

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

package/dist/esm-node/src/composables/useDisplay/useDisplay.mjs

@@ -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/esm-node/src/composables/useFilter/useFilter.mjs

@@ -3,13 +3,33 @@ import { shallowRef, computed, unref, watchEffect } from "vue";
 import { ac as wrapInArray, M as getPropertyFromItem } from "../../utils/helpers.mjs";
 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/esm-node/src/composables/useFocus/useFocus.mjs

@@ -5,9 +5,15 @@ import { toRef, unref } from "vue";
 import { E as EventProp } from "../../utils/helpers.mjs";
 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/esm-node/src/composables/useFocus/useFocusTrap.mjs

@@ -4,9 +4,15 @@ import { a as IN_BROWSER } from "../../utils/dom/globals.mjs";
 import { I as focusableChildren } from "../../utils/helpers.mjs";
 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"