@dxtmisha/wiki 0.24.2 → 0.25.1

package/src/media/mdx/event/events.input.ru.mdx

@@ -0,0 +1,90 @@
+### `input`
+
+Событие срабатывает при изменении значения в поле ввода, передавая оригинальное DOM событие и данные валидации.
+
+**Параметры:**
+- `event: InputEvent` — оригинальное DOM событие ввода
+- `value: FieldValidationItem` — объект с данными валидации
+
+**Структура FieldValidationItem:**
+- `group: string | undefined` — ключ группы маски
+- `input: HTMLInputElement | HTMLTextAreaElement | undefined` — связанный элемент ввода
+- `pattern: FieldPatternItemOrFunction | undefined` — используемый паттерн валидации
+- `type: string | undefined` — произвольный тип
+- `status: boolean | undefined` — статус успешности валидации
+- `required: boolean | undefined` — флаг обязательности поля
+- `isFull: boolean | undefined` — флаг полноты заполнения значения
+- `validationMessage: string | undefined` — текст сообщения об ошибке
+- `validity: ValidityState | undefined` — нативное состояние валидности
+- `validityMessage: string | undefined` — кастомное сообщение валидности
+- `value: any` — исходное значение
+- `valueInput: any | undefined` — введённое значение
+- `detail: Record<string, any> | undefined` — дополнительные данные
+
+```html
+<script setup>
+const handleInput = (event, value) => {
+  console.log('DOM событие:', event)
+  console.log('Значение:', value.value)
+  console.log('Валидация:', value.status)
+  console.log('Заполнено:', value.isFull)
+
+  if (!value.status) {
+    console.log('Ошибка:', value.validationMessage)
+  }
+}
+</script>
+
+<template>
+  <Mask
+    mask="+7 (***) ***-**-**"
+    @input="handleInput"
+  />
+</template>
+```
+
+### `inputLite`
+
+Событие срабатывает при изменении значения в поле ввода, передавая только данные валидации без оригинального DOM события (облегченная версия).
+
+**Параметры:**
+- `value: FieldValidationItem` — объект с данными валидации
+
+### `change`
+
+Событие срабатывает при завершении ввода и потере фокуса, передавая оригинальное DOM событие и данные валидации.
+
+**Параметры:**
+- `event: InputEvent` — оригинальное DOM событие ввода
+- `value: FieldValidationItem` — объект с данными валидации
+
+**Структура FieldValidationItem:** такая же как у события `input`
+
+```html
+<script setup>
+const handleChange = (event, value) => {
+  console.log('DOM событие:', event)
+  console.log('Финальное значение:', value.value)
+
+  if (value.status && value.isFull) {
+    // Отправка данных на сервер
+    submitForm(value.value)
+  }
+}
+</script>
+
+<template>
+  <Mask
+    mask="+7 (***) ***-**-**"
+    @change="handleChange"
+  />
+</template>
+```
+
+### `changeLite`
+
+Событие срабатывает при завершении ввода и потере фокуса, передавая только данные валидации без оригинального DOM события (облегченная версия).
+
+**Параметры:**
+- `value: FieldValidationItem` — объект с данными валидации
+

package/src/media/mdx/event/events.inputStandard.en.mdx

@@ -0,0 +1,6 @@
+### `input`
+
+Event fires when the value in the input field changes, passing the original DOM event.
+
+**Parameters:**
+- `event: InputEvent` — original DOM input event

package/src/media/mdx/event/events.inputStandard.ru.mdx

@@ -0,0 +1,6 @@
+### `input`
+
+Событие срабатывает при изменении значения в поле ввода, передавая оригинальное DOM событие.
+
+**Параметры:**
+- `event: InputEvent` — оригинальное DOM событие ввода

package/src/media/mdx/event/events.keyboard.en.mdx

@@ -0,0 +1,13 @@
+### `keydown`
+
+Event fires when a key is pressed in the input field, passing the original DOM keyboard event.
+
+**Parameters:**
+- `event: KeyboardEvent` — original DOM keyboard event
+
+### `keyup`
+
+Event fires when a key is released in the input field, passing the original DOM keyboard event.
+
+**Parameters:**
+- `event: KeyboardEvent` — original DOM keyboard event

package/src/media/mdx/event/events.keyboard.ru.mdx

@@ -0,0 +1,13 @@
+### `keydown`
+
+Событие срабатывает при нажатии клавиши в поле ввода, передавая оригинальное DOM событие клавиатуры.
+
+**Параметры:**
+- `event: KeyboardEvent` — оригинальное DOM событие клавиатуры
+
+### `keyup`
+
+Событие срабатывает при отпускании клавиши в поле ввода, передавая оригинальное DOM событие клавиатуры.
+
+**Параметры:**
+- `event: KeyboardEvent` — оригинальное DOM событие клавиатуры

package/src/media/mdx/event/events.paste.en.mdx

@@ -0,0 +1,6 @@
+### `paste`
+
+Event fires when data is pasted from clipboard into the input field, passing the original DOM event.
+
+**Parameters:**
+- `event: ClipboardEvent` — original DOM clipboard event

package/src/media/mdx/event/events.paste.ru.mdx

@@ -0,0 +1,6 @@
+### `paste`
+
+Событие срабатывает при вставке данных из буфера обмена в поле ввода, передавая оригинальное DOM событие.
+
+**Параметры:**
+- `event: ClipboardEvent` — оригинальное DOM событие буфера обмена

package/src/media/mdx/event/events.reset.en.mdx

@@ -0,0 +1,6 @@
+### `reset`
+
+Event fires when the component value is reset, passing the original DOM event.
+
+**Parameters:**
+- `event: Event` — original DOM event

package/src/media/mdx/event/events.reset.ru.mdx

@@ -0,0 +1,6 @@
+### `reset`
+
+Событие срабатывает при сбросе значения компонента, передавая оригинальное DOM событие.
+
+**Параметры:**
+- `event: Event` — оригинальное DOM событие

package/src/media/mdx/event/wikiMdxEvent.ts

@@ -1,91 +1,68 @@
 import type { StorybookComponentsMdxItem } from '../../../types/storybookTypes'
 
-import clickEn from './click.en.mdx'
-import clickRu from './click.ru.mdx'
-import clickLiteEn from './clickLite.en.mdx'
-import clickLiteRu from './clickLite.ru.mdx'
-
-import barsEn from './bars.en.mdx'
-import barsRu from './bars.ru.mdx'
-import barsLiteEn from './barsLite.en.mdx'
-import barsLiteRu from './barsLite.ru.mdx'
-import barsBackEn from './barsBack.en.mdx'
-import barsBackRu from './barsBack.ru.mdx'
-
-import scrollbarBottomEn from './scrollbarBottom.en.mdx'
-import scrollbarBottomRu from './scrollbarBottom.ru.mdx'
-import scrollbarEdgeEn from './scrollbarEdge.en.mdx'
-import scrollbarEdgeRu from './scrollbarEdge.ru.mdx'
-import scrollbarLeaveBottomEn from './scrollbarLeaveBottom.en.mdx'
-import scrollbarLeaveBottomRu from './scrollbarLeaveBottom.ru.mdx'
-import scrollbarLeaveTopEn from './scrollbarLeaveTop.en.mdx'
-import scrollbarLeaveTopRu from './scrollbarLeaveTop.ru.mdx'
-import scrollbarReachBottomEn from './scrollbarReachBottom.en.mdx'
-import scrollbarReachBottomRu from './scrollbarReachBottom.ru.mdx'
-import scrollbarReachTopEn from './scrollbarReachTop.en.mdx'
-import scrollbarReachTopRu from './scrollbarReachTop.ru.mdx'
-import scrollbarTopEn from './scrollbarTop.en.mdx'
-import scrollbarTopRu from './scrollbarTop.ru.mdx'
-
-import windowEn from './window.en.mdx'
-import windowRu from './window.ru.mdx'
+import eventsActionsEn from './events.actions.en.mdx'
+import eventsActionsRu from './events.actions.ru.mdx'
+import eventsBarsEn from './events.bars.en.mdx'
+import eventsBarsRu from './events.bars.ru.mdx'
+import eventsBeforeinputEn from './events.beforeinput.en.mdx'
+import eventsBeforeinputRu from './events.beforeinput.ru.mdx'
+import eventsClickEn from './events.click.en.mdx'
+import eventsClickRu from './events.click.ru.mdx'
+import eventsFocusEn from './events.focus.en.mdx'
+import eventsFocusRu from './events.focus.ru.mdx'
+import eventsInputEn from './events.input.en.mdx'
+import eventsInputRu from './events.input.ru.mdx'
+import eventsInputStandardEn from './events.inputStandard.en.mdx'
+import eventsInputStandardRu from './events.inputStandard.ru.mdx'
+import eventsKeyboardEn from './events.keyboard.en.mdx'
+import eventsKeyboardRu from './events.keyboard.ru.mdx'
+import eventsPasteEn from './events.paste.en.mdx'
+import eventsPasteRu from './events.paste.ru.mdx'
+import eventsResetEn from './events.reset.en.mdx'
+import eventsResetRu from './events.reset.ru.mdx'
 
 export const wikiMdxEvent: StorybookComponentsMdxItem = {
   name: 'Event',
   descriptions: {
-    click: {
-      en: clickEn,
-      ru: clickRu
-    },
-    clickLite: {
-      en: clickLiteEn,
-      ru: clickLiteRu
+    'actions': {
+      en: eventsActionsEn,
+      ru: eventsActionsRu
     },
-
-    bars: {
-      en: barsEn,
-      ru: barsRu
-    },
-    barsLite: {
-      en: barsLiteEn,
-      ru: barsLiteRu
+    'bars': {
+      en: eventsBarsEn,
+      ru: eventsBarsRu
     },
-    barsBack: {
-      en: barsBackEn,
-      ru: barsBackRu
-    },
-
-    scrollbarBottom: {
-      en: scrollbarBottomEn,
-      ru: scrollbarBottomRu
+    'beforeinput': {
+      en: eventsBeforeinputEn,
+      ru: eventsBeforeinputRu
     },
-    scrollbarEdge: {
-      en: scrollbarEdgeEn,
-      ru: scrollbarEdgeRu
+    'click': {
+      en: eventsClickEn,
+      ru: eventsClickRu
     },
-    scrollbarLeaveBottom: {
-      en: scrollbarLeaveBottomEn,
-      ru: scrollbarLeaveBottomRu
+    'focus': {
+      en: eventsFocusEn,
+      ru: eventsFocusRu
     },
-    scrollbarLeaveTop: {
-      en: scrollbarLeaveTopEn,
-      ru: scrollbarLeaveTopRu
+    'input': {
+      en: eventsInputEn,
+      ru: eventsInputRu
     },
-    scrollbarReachBottom: {
-      en: scrollbarReachBottomEn,
-      ru: scrollbarReachBottomRu
+    'input-standard': {
+      en: eventsInputStandardEn,
+      ru: eventsInputStandardRu
     },
-    scrollbarReachTop: {
-      en: scrollbarReachTopEn,
-      ru: scrollbarReachTopRu
+    'keyboard': {
+      en: eventsKeyboardEn,
+      ru: eventsKeyboardRu
     },
-    scrollbarTop: {
-      en: scrollbarTopEn,
-      ru: scrollbarTopRu
+    'paste': {
+      en: eventsPasteEn,
+      ru: eventsPasteRu
     },
-    window: {
-      en: windowEn,
-      ru: windowRu
+    'reset': {
+      en: eventsResetEn,
+      ru: eventsResetRu
     }
   }
 }

package/src/media/mdx/expose/expose.clear.en.mdx

@@ -0,0 +1,3 @@
+### `clear`
+
+Clears the component value to default and focuses the input field.

package/src/media/mdx/expose/expose.clear.ru.mdx

@@ -0,0 +1,3 @@
+### `clear`
+
+Очищает значение компонента до значения по умолчанию и устанавливает фокус на поле ввода.

package/src/media/mdx/expose/expose.descriptionId.en.mdx

@@ -0,0 +1,6 @@
+### `descriptionId`
+
+Unique identifier for the description element. Used for accessibility attributes like `aria-describedby`.
+
+**Type:** `string`
+

package/src/media/mdx/expose/expose.descriptionId.ru.mdx

@@ -0,0 +1,6 @@
+### `descriptionId`
+
+Уникальный идентификатор элемента описания. Используется для атрибутов доступности, таких как `aria-describedby`.
+
+**Тип:** `string`
+

package/src/media/mdx/expose/expose.detail.en.mdx

@@ -0,0 +1,5 @@
+### `detail`
+
+Additional component data.
+
+**Type:** `Record<string, any> | undefined`

package/src/media/mdx/expose/{detail.ru.mdx → expose.detail.ru.mdx}

@@ -2,6 +2,4 @@
 
 Дополнительные данные компонента.
 
-```ts
-type detail = Record<string, any> | undefined
-```
+**Тип:** `Record<string, any> | undefined`

package/src/media/mdx/expose/expose.id.en.mdx

@@ -0,0 +1,6 @@
+### `id`
+
+Unique identifier for the component element. Used as the DOM element's `id` attribute.
+
+**Type:** `string`
+

package/src/media/mdx/expose/expose.id.ru.mdx

@@ -0,0 +1,6 @@
+### `id`
+
+Уникальный идентификатор элемента компонента. Используется в качестве атрибута `id` DOM-элемента.
+
+**Тип:** `string`
+

package/src/media/mdx/expose/expose.labelId.en.mdx

@@ -0,0 +1,6 @@
+### `labelId`
+
+Unique identifier for the label element. Used for accessibility attributes like `aria-labelledby`.
+
+**Type:** `string`
+

package/src/media/mdx/expose/expose.labelId.ru.mdx

@@ -0,0 +1,6 @@
+### `labelId`
+
+Уникальный идентификатор элемента метки. Используется для атрибутов доступности, таких как `aria-labelledby`.
+
+**Тип:** `string`
+

package/src/media/mdx/expose/expose.open.en.mdx

@@ -0,0 +1,5 @@
+### `open`
+
+Reactive open/close state of the component.
+
+**Type:** `ComputedRef<boolean>`

package/src/media/mdx/expose/expose.open.ru.mdx

@@ -0,0 +1,5 @@
+### `open`
+
+Реактивное состояние открытия/закрытия компонента.
+
+**Тип:** `ComputedRef<boolean>`

package/src/media/mdx/expose/expose.selected.en.mdx

@@ -0,0 +1,23 @@
+### `isSelected`
+
+Computed property indicating whether there are selected items in the component.
+
+**Type:** `ComputedRef<boolean>`
+
+### `selectedList`
+
+Reactive list of selected component items.
+
+**Type:** `Ref<any[]>`
+
+### `selectedNames`
+
+Reactive list of labels (names) of selected items.
+
+**Type:** `Ref<string[]>`
+
+### `selectedValues`
+
+Reactive array of values of selected items.
+
+**Type:** `Ref<any[]>`

package/src/media/mdx/expose/expose.selected.ru.mdx

@@ -0,0 +1,23 @@
+### `isSelected`
+
+Вычисляемое свойство, указывающее наличие выбранных элементов в компоненте.
+
+**Тип:** `ComputedRef<boolean>`
+
+### `selectedList`
+
+Реактивный список выбранных элементов компонента.
+
+**Тип:** `Ref<any[]>`
+
+### `selectedNames`
+
+Реактивный список меток (имён) выбранных элементов.
+
+**Тип:** `Ref<string[]>`
+
+### `selectedValues`
+
+Реактивный массив значений выбранных элементов.
+
+**Тип:** `Ref<any[]>`

package/src/media/mdx/expose/{value.en.mdx → expose.value.en.mdx}

@@ -2,6 +2,4 @@
 
 Current component value.
 
-```ts
-type value = any
-```
+**Type:** `any`

package/src/media/mdx/expose/{value.ru.mdx → expose.value.ru.mdx}

@@ -2,6 +2,4 @@
 
 Текущее значение компонента.
 
-```ts
-type value = any
-```
+**Тип:** `any`

package/src/media/mdx/expose/wikiMdxExpose.ts

@@ -1,44 +1,56 @@
 import type { StorybookComponentsMdxItem } from '../../../types/storybookTypes'
 
-import detailEn from './detail.en.mdx'
-import detailRu from './detail.ru.mdx'
-import valueEn from './value.en.mdx'
-import valueRu from './value.ru.mdx'
-import isSelectedEn from './isSelected.en.mdx'
-import isSelectedRu from './isSelected.ru.mdx'
-import selectedListEn from './selectedList.en.mdx'
-import selectedListRu from './selectedList.ru.mdx'
-import selectedNamesEn from './selectedNames.en.mdx'
-import selectedNamesRu from './selectedNames.ru.mdx'
-import selectedValuesEn from './selectedValues.en.mdx'
-import selectedValuesRu from './selectedValues.ru.mdx'
+import exposeClearEn from './expose.clear.en.mdx'
+import exposeClearRu from './expose.clear.ru.mdx'
+import exposeDescriptionIdEn from './expose.descriptionId.en.mdx'
+import exposeDescriptionIdRu from './expose.descriptionId.ru.mdx'
+import exposeDetailEn from './expose.detail.en.mdx'
+import exposeDetailRu from './expose.detail.ru.mdx'
+import exposeIdEn from './expose.id.en.mdx'
+import exposeIdRu from './expose.id.ru.mdx'
+import exposeLabelIdEn from './expose.labelId.en.mdx'
+import exposeLabelIdRu from './expose.labelId.ru.mdx'
+import exposeOpenEn from './expose.open.en.mdx'
+import exposeOpenRu from './expose.open.ru.mdx'
+import exposeSelectedEn from './expose.selected.en.mdx'
+import exposeSelectedRu from './expose.selected.ru.mdx'
+import exposeValueEn from './expose.value.en.mdx'
+import exposeValueRu from './expose.value.ru.mdx'
 
 export const wikiMdxExpose: StorybookComponentsMdxItem = {
   name: 'Expose',
   descriptions: {
+    clear: {
+      en: exposeClearEn,
+      ru: exposeClearRu
+    },
+    descriptionId: {
+      en: exposeDescriptionIdEn,
+      ru: exposeDescriptionIdRu
+    },
     detail: {
-      en: detailEn,
-      ru: detailRu
+      en: exposeDetailEn,
+      ru: exposeDetailRu
     },
-    value: {
-      en: valueEn,
-      ru: valueRu
+    id: {
+      en: exposeIdEn,
+      ru: exposeIdRu
     },
-    isSelected: {
-      en: isSelectedEn,
-      ru: isSelectedRu
+    labelId: {
+      en: exposeLabelIdEn,
+      ru: exposeLabelIdRu
     },
-    selectedList: {
-      en: selectedListEn,
-      ru: selectedListRu
+    open: {
+      en: exposeOpenEn,
+      ru: exposeOpenRu
     },
-    selectedNames: {
-      en: selectedNamesEn,
-      ru: selectedNamesRu
+    selected: {
+      en: exposeSelectedEn,
+      ru: exposeSelectedRu
     },
-    selectedValues: {
-      en: selectedValuesEn,
-      ru: selectedValuesRu
+    value: {
+      en: exposeValueEn,
+      ru: exposeValueRu
     }
   }
 }

package/src/media/mdx/slot/body.en.mdx

@@ -0,0 +1,6 @@
+### `body`
+**Returns:** `VNode` — content
+
+Slot for the main content of the component.
+
+

package/src/media/mdx/slot/body.ru.mdx

@@ -0,0 +1,6 @@
+### `body`
+
+Слот для основного содержимого компонента.
+
+**Возвращает:** `VNode` — содержимое
+

package/src/media/mdx/slot/caption.en.mdx

@@ -1,10 +1,5 @@
 ### `caption`
 
-Slot for passing caption content to the component. It's an alternative to the `caption` prop and allows passing elements instead of plain text.
+Slot for placing a caption or additional explanatory text for the component.
 
-This slot allows you to:
-- Use an alternative to the `caption` property
-- Pass elements instead of plain text
-- Use HTML or components in the caption
-
-The `caption` slot works as a replacement for the `caption` prop and allows passing any elements for more flexible caption content setup.
+**Returns:** `VNode` — element with class `{className}__caption` and attribute `data-event-type="caption"`

package/src/media/mdx/slot/caption.ru.mdx

@@ -1,10 +1,5 @@
 ### `caption`
 
-Слот для передачи содержимого подписи компонента. Является альтернативой props `caption` и позволяет передавать элементы вместо простого текста.
+Слот для размещения подписи или дополнительного пояснительного текста к компоненту.
 
-Этот слот позволяет:
-- Использовать альтернативу свойству `caption`
-- Передавать элементы вместо простого текста
-- Использовать HTML или компоненты в подписи
-
-Слот `caption` работает как замена props `caption` и позволяет передавать любые элементы для более гибкого задания подписи.
+**Возвращает:** `VNode` — элемент с классом `{className}__caption` и атрибутом `data-event-type="caption"`

package/src/media/mdx/slot/control.en.mdx

@@ -1,9 +1,8 @@
 ### `control`
 
-Slot for rendering the component’s control (trigger) element.
+Slot for placing component control elements (buttons, switches, etc.).
 
-This slot lets you:
-- Place a button, icon, or any interactive trigger
-- Receive control data via a scoped slot (if provided by the component)
-- Customize open/close logic and extra actions
+**Parameters:**
+- `props: ControlItem` — object with control element data
 
+**Returns:** `VNode` — component control elements

package/src/media/mdx/slot/control.ru.mdx

@@ -1,9 +1,8 @@
 ### `control`
 
-Слот для рендеринга элемента управления (триггера) компонента.
+Слот для размещения элементов управления компонентом (кнопки, переключатели и т.д.).
 
-Этот слот позволяет:
-- Разместить кнопку, иконку или любой триггер для взаимодействия
-- Получать данные контрола через scoped‑slot (если компонент их предоставляет)
-- Настроить логику открытия/закрытия и дополнительные действия
+**Параметры:**
+- `props: ControlItem` — объект с данными элемента управления
 
+**Возвращает:** `VNode` — элементы управления компонентом

package/src/media/mdx/slot/default.en.mdx

@@ -1,10 +1,5 @@
 ### `default`
 
-Main slot for placing content inside the component.
+Main slot for placing the primary component content.
 
-This slot allows you to:
-- Place any custom content inside the component
-- Pass text, HTML elements, or other Vue components
-- Customize the internal content of the component
-
-The `default` slot is the primary way to add content to the component and supports all standard Vue slot capabilities.
+**Returns:** `VNode` — main component content