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

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

@@ -6,27 +6,51 @@ import { C as CdsFileInputConstants } from "./CdsFileInput.constants.mjs";
 import { a3 as omit, ac as wrapInArray } from "../../../utils/helpers.mjs";
 const defineCdsFileInputProps = propsFactory(
   {
-    /** Отображать выбранные файлы в виде тегов (CdsTag) вместо списка имён. */
+    /**
+     * Отображать выбранные файлы в виде тегов (CdsTag) вместо списка имён.
+     * @en Show the chosen files as tags (CdsTag) instead of a list of names.
+     */
     chips: Boolean,
-    /** Отображать счётчик количества (и, при `showSize`, суммарного размера) выбранных файлов. */
+    /**
+     * Отображать счётчик количества (и, при `showSize`, суммарного размера) выбранных файлов.
+     * @en Show a counter of the number (and, with `showSize`, of the total size) of the chosen files.
+     */
     counter: Boolean,
-    /** Ключ локализации для текста счётчика с размером файлов. */
+    /**
+     * Ключ локализации для текста счётчика с размером файлов.
+     * @en Localization key for the text of the counter with the file size.
+     */
     counterSizeString: {
       type: String,
       default: "$cds.fileInput.counterSize"
     },
-    /** Ключ локализации для текста счётчика количества файлов. */
+    /**
+     * Ключ локализации для текста счётчика количества файлов.
+     * @en Localization key for the text of the file count counter.
+     */
     counterString: {
       type: String,
       default: "$cds.fileInput.counter"
     },
-    /** Скрыть поле ввода, оставив только иконку prepend (например, для использования как кнопки). */
+    /**
+     * Скрыть поле ввода, оставив только иконку prepend (например, для использования как кнопки).
+     * @en Hide the field, leaving only the prepend icon (to use it as a button, for example).
+     */
     hideInput: Boolean,
-    /** Текст-заполнитель, отображаемый в пустом поле (когда файлы ещё не выбраны). */
+    /**
+     * Текст-заполнитель, отображаемый в пустом поле (когда файлы ещё не выбраны).
+     * @en Placeholder text shown in an empty field (while no files are chosen yet).
+     */
     placeholder: String,
-    /** Разрешить выбор нескольких файлов. */
+    /**
+     * Разрешить выбор нескольких файлов.
+     * @en Allow selecting several files.
+     */
     multiple: Boolean,
-    /** Отображать размер выбранных файлов. Булево значение или основание счисления: 1000 (kB) или 1024 (KiB). */
+    /**
+     * Отображать размер выбранных файлов. Булево значение или основание счисления: 1000 (kB) или 1024 (KiB).
+     * @en Show the size of the chosen files. A boolean or the base: 1000 (kB) or 1024 (KiB).
+     */
     showSize: {
       type: [Boolean, Number, String],
       default: false,
@@ -34,12 +58,18 @@ const defineCdsFileInputProps = propsFactory(
         return typeof value === "boolean" || [1e3, 1024].includes(Number(value));
       }
     },
-    /** Максимальная длина имени файла до усечения (символы в начале и конце сохраняются). */
+    /**
+     * Максимальная длина имени файла до усечения (символы в начале и конце сохраняются).
+     * @en Maximum length of a file name before it is truncated (the characters at the start and at the end are kept).
+     */
     truncateLength: {
       type: [Number, String],
       default: 22
     },
-    /** Значение модели: массив файлов (при `multiple`), один файл или `null`. */
+    /**
+     * Значение модели: массив файлов (при `multiple`), один файл или `null`.
+     * @en Value of the model: an array of files (with `multiple`), a single file or `null`.
+     */
     modelValue: {
       type: [Array, Object],
       default: (props) => props.multiple ? [] : null,

package/dist/esm-node/src/components/CdsFileInput/composables/useFileFilter.mjs

@@ -2,7 +2,10 @@ import { p as propsFactory } from "../../../core/propsFactory.mjs";
 import { computed } from "vue";
 const defineFileFilterProps = propsFactory(
   {
-    /** Фильтрация файлов по MIME-типу или расширению (например `image/*,.pdf`). Отклонённые файлы не попадают в модель. */
+    /**
+     * Фильтрация файлов по MIME-типу или расширению (например `image/*,.pdf`). Отклонённые файлы не попадают в модель.
+     * @en Filtering of files by MIME type or extension (`image/*,.pdf`, for example). The rejected files do not get into the model.
+     */
     filterByType: String
   },
   "file-filter"

package/dist/esm-node/src/components/CdsFileUpload/CdsFileUpload.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-file-upload .cds-input__control {
     flex-direction: column;

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

@@ -125,6 +125,10 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
       unref(inputRef).value = "";
     }
     __expose(forwardRefs({
+      /**
+       * Ссылка на нативный элемент `input[type=file]` — для программного открытия диалога выбора файлов.
+       * @en Ref to the native `input[type=file]` element — for opening the file dialog programmatically.
+       */
       controlRef: inputRef
     }, cdsInputRef, dropzoneRef));
     return () => {

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

@@ -11,42 +11,75 @@ import { p as propsFactory } from "../../../core/propsFactory.mjs";
 import { C as CdsFileUploadItemConstants, a as CdsFileUploadDropzoneConstants, b as CdsFileUploadListConstants, c as CdsFileUploadConstants } from "./CdsFileUpload.constants.mjs";
 import { a7 as pick, ac as wrapInArray, a3 as omit } from "../../../utils/helpers.mjs";
 const defineSharedDropzoneProps = () => ({
-  /** Текст кнопки выбора файлов. Поддерживает ключи локализации (`$cds.fileUpload.browse`). */
+  /**
+   * Текст кнопки выбора файлов. Поддерживает ключи локализации (`$cds.fileUpload.browse`).
+   * @en Text of the file browse button. Supports localization keys (`$cds.fileUpload.browse`).
+   */
   browseText: {
     type: String,
     default: "$cds.fileUpload.browse"
   },
-  /** Текст разделителя между иконкой и кнопкой выбора файлов. */
+  /**
+   * Текст разделителя между иконкой и кнопкой выбора файлов.
+   * @en Text of the divider between the icon and the file browse button.
+   */
   dividerText: {
     type: String,
     default: "$cds.fileUpload.divider"
   },
-  /** Заголовок зоны загрузки. */
+  /**
+   * Заголовок зоны загрузки.
+   * @en Title of the upload zone.
+   */
   title: {
     type: String,
     default: "$cds.fileUpload.title"
   },
-  /** Подзаголовок под кнопкой выбора файлов. Отображается только при `size` `md` и `lg`. */
+  /**
+   * Подзаголовок под кнопкой выбора файлов. Отображается только при `size` `md` и `lg`.
+   * @en Subtitle under the file browse button. Shown with `size` `md` and `lg` only.
+   */
   subtitle: String,
-  /** Иконка в центре зоны загрузки. */
+  /**
+   * Иконка в центре зоны загрузки.
+   * @en Icon in the center of the upload zone.
+   */
   icon: {
     type: IconValue,
     default: "upload"
   },
-  /** Разрешает удалять выбранные файлы из списка. */
+  /**
+   * Разрешает удалять выбранные файлы из списка.
+   * @en Allows removing the chosen files from the list.
+   */
   clearable: Boolean,
-  /** Скрывает кнопку выбора файлов — зона загрузки становится кликабельной целиком. */
+  /**
+   * Скрывает кнопку выбора файлов — зона загрузки становится кликабельной целиком.
+   * @en Hides the file browse button — the whole upload zone becomes clickable.
+   */
   hideBrowse: Boolean,
-  /** Отображает список выбранных файлов внутри зоны загрузки, а не под ней. */
+  /**
+   * Отображает список выбранных файлов внутри зоны загрузки, а не под ней.
+   * @en Shows the list of the chosen files inside the upload zone instead of under it.
+   */
   insetFileList: Boolean,
-  /** Разрешает выбор нескольких файлов. */
+  /**
+   * Разрешает выбор нескольких файлов.
+   * @en Allows choosing several files.
+   */
   multiple: Boolean,
-  /** Затемнение зоны загрузки при перетаскивании файлов. */
+  /**
+   * Затемнение зоны загрузки при перетаскивании файлов.
+   * @en Dimming of the upload zone while files are being dragged over it.
+   */
   scrim: {
     type: [Boolean, String],
     default: true
   },
-  /** Отображает размер файла. Число задаёт основание для перевода в человекочитаемый вид. */
+  /**
+   * Отображает размер файла. Число задаёт основание для перевода в человекочитаемый вид.
+   * @en Shows the size of the file. A number sets the base for the human-readable conversion.
+   */
   showSize: {
     type: [Boolean, Number],
     default: false
@@ -54,6 +87,7 @@ const defineSharedDropzoneProps = () => ({
   /**
    * Размер зоны загрузки.
    * При `sm` зона отображается компактной строкой без кнопки выбора файлов и разделителя.
+   * @en Size of the upload zone. With `sm` the zone is shown as a compact row without the browse button and the divider.
    */
   size: {
     type: String,
@@ -63,13 +97,19 @@ const defineSharedDropzoneProps = () => ({
 const defineCdsFileUploadDropzoneProps = propsFactory(
   {
     ...defineSharedDropzoneProps(),
-    /** Отображает зону загрузки в состоянии ошибки. */
+    /**
+     * Отображает зону загрузки в состоянии ошибки.
+     * @en Shows the upload zone in the error state.
+     */
     error: Boolean,
     ...defineDisabledProps(),
     ...defineReadonlyProps(),
     ...pick(defineCdsDividerProps({ length: 150 }), ["length", "thickness", "opacity"]),
     ...defineCdsSurfaceProps(),
-    /** Список выбранных файлов. Используется, когда `CdsFileUploadDropzone` применяется автономно. */
+    /**
+     * Список выбранных файлов. Используется, когда `CdsFileUploadDropzone` применяется автономно.
+     * @en The list of the chosen files. Used when `CdsFileUploadDropzone` is applied on its own.
+     */
     modelValue: {
       type: Array,
       default: () => []
@@ -79,19 +119,31 @@ const defineCdsFileUploadDropzoneProps = propsFactory(
 );
 const defineCdsFileUploadItemProps = propsFactory(
   {
-    /** Разрешает удалить файл из списка. */
+    /**
+     * Разрешает удалить файл из списка.
+     * @en Allows removing the file from the list.
+     */
     clearable: Boolean,
-    /** Файл, который отображает элемент списка. */
+    /**
+     * Файл, который отображает элемент списка.
+     * @en The file shown by the list item.
+     */
     file: {
       type: Object,
       default: null
     },
-    /** Иконка-заглушка для файлов, у которых нет превью. */
+    /**
+     * Иконка-заглушка для файлов, у которых нет превью.
+     * @en Fallback icon for the files that have no preview.
+     */
     fileIcon: {
       type: IconValue,
       default: "doc"
     },
-    /** Отображает размер файла вместо его MIME-типа. */
+    /**
+     * Отображает размер файла вместо его MIME-типа.
+     * @en Shows the size of the file instead of its MIME type.
+     */
     showSize: {
       type: [Boolean, Number],
       default: false
@@ -102,14 +154,23 @@ const defineCdsFileUploadItemProps = propsFactory(
 );
 const defineCdsFileUploadListProps = propsFactory(
   {
-    /** Разрешает удалять файлы из списка. */
+    /**
+     * Разрешает удалять файлы из списка.
+     * @en Allows removing files from the list.
+     */
     clearable: Boolean,
-    /** Отображает размер каждого файла. */
+    /**
+     * Отображает размер каждого файла.
+     * @en Shows the size of every file.
+     */
     showSize: {
       type: [Boolean, Number],
       default: false
     },
-    /** Список файлов. По умолчанию берётся из контекста `CdsFileUpload`. */
+    /**
+     * Список файлов. По умолчанию берётся из контекста `CdsFileUpload`.
+     * @en The list of files. Taken from the `CdsFileUpload` context by default.
+     */
     files: Array,
     ...defineCdsListProps({ lines: false })
   },
@@ -123,7 +184,10 @@ const defineCdsFileUploadProps = propsFactory(
     // `size` исключён намеренно: у `CdsInput` он шире (`xs`–`xl`), а зона загрузки
     // поддерживает только `sm` | `md` | `lg`. Единый источник — `defineSharedDropzoneProps`.
     ...omit(defineCdsInputProps(), ["direction", "modelValue", "size"]),
-    /** Выбранные файлы. Массив при `multiple`, иначе одиночный `File`. */
+    /**
+     * Выбранные файлы. Массив при `multiple`, иначе одиночный `File`.
+     * @en The chosen files. An array with `multiple`, a single `File` otherwise.
+     */
     modelValue: {
       type: [Array, Object],
       default: null,

package/dist/esm-node/src/components/CdsFooter/CdsFooter.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-footer {
     position: relative;

package/dist/esm-node/src/components/CdsForm/CdsForm.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-form {
     display: block;

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

@@ -4,9 +4,15 @@ import { p as propsFactory } from "../../../core/propsFactory.mjs";
 import { C as CdsFormConstants } from "./CdsForm.constants.mjs";
 const defineCdsFormProps = propsFactory(
   {
-    /** Заголовок формы. Рендерится над контентом через `CdsDescription`. */
+    /**
+     * Заголовок формы. Рендерится над контентом через `CdsDescription`.
+     * @en Heading of the form. Rendered above the content through `CdsDescription`.
+     */
     label: String,
-    /** Описание формы. Рендерится под заголовком через `CdsDescription`. */
+    /**
+     * Описание формы. Рендерится под заголовком через `CdsDescription`.
+     * @en Description of the form. Rendered under the heading through `CdsDescription`.
+     */
     description: String,
     ...defineFormProps(),
     ...defineComponentProps()

package/dist/esm-node/src/components/CdsFunctionalButton/CdsFunctionalButton.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-button.cds-functional-button {
     color: rgb(var(--cds-color-content-primary));

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

@@ -10,7 +10,10 @@ import { a3 as omit } from "../../../utils/helpers.mjs";
 import { d as defineColorProps } from "../../../composables/useColor/useColor.mjs";
 const defineCdsFunctionalButtonProps = propsFactory(
   {
-    /** Иконка */
+    /**
+     * Иконка
+     * @en Icon
+     */
     icon: [String, Function, Object],
     ...defineComponentProps(),
     ...defineRouterProps(),

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

@@ -4,13 +4,25 @@ import { c as componentGridName, a as componentRowName, b as componentColName }
 import { a7 as pick } from "../../../utils/helpers.mjs";
 const defineCdsGridProps = propsFactory(
   {
-    /** Удаляет max-width по умолчанию и растягивает сетку на всю ширину контейнера */
+    /**
+     * Удаляет max-width по умолчанию и растягивает сетку на всю ширину контейнера
+     * @en Removes the default max-width and stretches the grid across the whole width of the container
+     */
     wide: Boolean,
-    /** Конденсированная сетка. Уменьшенный отступ до 1px по обеим сторонам */
+    /**
+     * Конденсированная сетка. Уменьшенный отступ до 1px по обеим сторонам
+     * @en Condensed grid. The gap is reduced to 1px on both sides
+     */
     condensed: Boolean,
-    /** Узкая сетка */
+    /**
+     * Узкая сетка
+     * @en Narrow grid
+     */
     narrow: Boolean,
-    /** Only CSS Grid supported. Вложенная сетка */
+    /**
+     * Only CSS Grid supported. Вложенная сетка
+     * @en Only CSS Grid supported. A nested grid
+     */
     subgrid: Boolean,
     ...defineTagProps(),
     ...defineComponentProps()
@@ -27,32 +39,50 @@ const defineCdsRowProps = propsFactory(
 );
 const defineCdsColProps = propsFactory(
   {
-    /** >320px */
+    /**
+     * >320px
+     * @en >320px
+     */
     xs: {
       type: [Object, Number, String, Boolean],
       default: void 0
     },
-    /** >672px */
+    /**
+     * >672px
+     * @en >672px
+     */
     sm: {
       type: [Object, Number, String, Boolean],
       default: void 0
     },
-    /** >1056px */
+    /**
+     * >1056px
+     * @en >1056px
+     */
     md: {
       type: [Object, Number, String, Boolean],
       default: void 0
     },
-    /** >1312px */
+    /**
+     * >1312px
+     * @en >1312px
+     */
     lg: {
       type: [Object, Number, String, Boolean],
       default: void 0
     },
-    /** >1584px */
+    /**
+     * >1584px
+     * @en >1584px
+     */
     xl: {
       type: [Object, Number, String, Boolean],
       default: void 0
     },
-    /** Only CSS Grid supported. Постоянный диапазон колонок, start или end значения, которые не изменятся. */
+    /**
+     * Only CSS Grid supported. Постоянный диапазон колонок, start или end значения, которые не изменятся.
+     * @en Only CSS Grid supported. A permanent column range, start or end values that never change.
+     */
     span: {
       type: [Object, Number, String],
       default: void 0

package/dist/esm-node/src/components/CdsGrid/components/CSSGrid.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
-*/
 :root {
   --cds-grid-gutter: 32px;
   --cds-grid-columns: 4;

package/dist/esm-node/src/components/CdsGrid/components/FlexGrid.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
-*/
 .cds-grid {
   margin-inline: auto;
   max-inline-size: 1584px;

package/dist/esm-node/src/components/CdsHeader/CdsHeader.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-header {
     position: relative;

package/dist/esm-node/src/components/CdsHighlight/CdsHighlight.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-highlight__mark {
     color: var(--cds-highlight-color, inherit);

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

@@ -3,24 +3,48 @@ import { p as propsFactory } from "../../../core/propsFactory.mjs";
 import { C as CdsHighlightConstants } from "./CdsHighlight.constants.mjs";
 const defineCdsHighlightProps = propsFactory(
   {
-    /** Текст, в котором выполняется подсветка. */
+    /**
+     * Текст, в котором выполняется подсветка.
+     * @en The text the highlighting is performed in.
+     */
     text: {
       type: String,
       default: ""
     },
-    /** Поисковый запрос: строка или массив строк-терминов. */
+    /**
+     * Поисковый запрос: строка или массив строк-терминов.
+     * @en Search query: a string or an array of term strings.
+     */
     query: [String, Array],
-    /** Готовые диапазоны совпадений `[start, end]`. Имеют приоритет над `query`. */
+    /**
+     * Готовые диапазоны совпадений `[start, end]`. Имеют приоритет над `query`.
+     * @en Ready match ranges `[start, end]`. They take precedence over `query`.
+     */
     matches: Array,
-    /** Подсвечивать все вхождения, а не только первое. */
+    /**
+     * Подсвечивать все вхождения, а не только первое.
+     * @en Highlights every occurrence, not just the first one.
+     */
     matchAll: Boolean,
-    /** Игнорировать регистр при поиске по `query`. */
+    /**
+     * Игнорировать регистр при поиске по `query`.
+     * @en Ignores the case when searching by `query`.
+     */
     ignoreCase: Boolean,
-    /** Цвет текста подсветки. */
+    /**
+     * Цвет текста подсветки.
+     * @en Color of the highlighted text.
+     */
     color: String,
-    /** Прозрачность фона подсветки (CSS-переменная `--cds-highlight-opacity`). */
+    /**
+     * Прозрачность фона подсветки (CSS-переменная `--cds-highlight-opacity`).
+     * @en Opacity of the highlight background (the `--cds-highlight-opacity` CSS variable).
+     */
     opacity: [String, Number],
-    /** Дополнительный CSS-класс для элемента `<mark>`. */
+    /**
+     * Дополнительный CSS-класс для элемента `<mark>`.
+     * @en Extra CSS class for the `<mark>` element.
+     */
     markClass: String,
     ...defineTagProps({ tag: "span" }),
     ...defineComponentProps()