@dxtmisha/wiki 0.39.1 → 0.39.3

package/src/media/mdx/Mask/dateTypes.ru.mdx

@@ -1,111 +0,0 @@
-## Типы дат и времени
-
-Типы дат в Mask обеспечивают автоматическое форматирование и валидацию для ввода даты и времени с учётом локализации.
-
-**Доступные типы:**
-
-- `date`, `datetime`, `full` — полные форматы даты и времени
-- `time`, `hour-minute`, `hour`, `minute`, `second` — компоненты времени
-- `year`, `year-month`, `month`, `day`, `day-month` — компоненты даты
-
-Все типы дат автоматически создают маски согласно региональным настройкам, игнорируя свойство `mask`. Структура маски определяется локалью через `language` (DD.MM.YYYY для русского, MM/DD/YYYY для английского).
-
-Валидация даты происходит на уровне ввода — проверяется корректность числовых значений, количество дней в месяце (включая високосные годы), диапазоны значений (месяцы 01-12, дни 01-31, часы 00-23). Время работает в 24-часовом формате.
-
-```html
-<!-- Полная дата -->
-<Mask type="date" language="ru" />
-
-<!-- Дата и время -->
-<Mask type="datetime" language="ru" />
-
-<!-- Только время -->
-<Mask type="time" />
-```
-
-### Типы
-
-#### date
-
-Полная дата в формате локали (день, месяц, год). Автоматически генерирует структуру согласно языковым настройкам: DD.MM.YYYY для русского, MM/DD/YYYY для английского. Разделитель определяется локалью (точка, слэш, дефис).
-
-#### datetime
-
-Дата и время в формате локали. Комбинирует маску даты и времени, разделяя их пробелом. Формат даты определяется языком, формат времени обычно HH:MM. Валидирует как дату, так и время.
-
-#### full
-
-Полная дата и время с секундами. Расширенная версия `datetime` с добавлением секунд в формат времени (HH:MM:SS).
-
-#### time
-
-Время в формате HH:MM:SS. Генерирует маску для ввода времени с валидацией диапазонов (0-23 для часов, 0-59 для минут и секунд).
-
-#### hour-minute
-
-Часы и минуты в формате HH:MM. Короткая версия времени без секунд. Валидирует диапазоны (0-23 для часов, 0-59 для минут).
-
-#### hour
-
-Только часы (00-23). Маска для ввода часов с валидацией диапазона от 0 до 23.
-
-#### minute
-
-Только минуты (00-59). Маска для ввода минут с валидацией диапазона от 0 до 59.
-
-#### second
-
-Только секунды (00-59). Маска для ввода секунд с валидацией диапазона от 0 до 59.
-
-#### year
-
-Год (обычно 4 цифры). Создаёт простую числовую маску для года. Формат может варьироваться в зависимости от локали (YYYY, YY).
-
-#### year-month
-
-Год и месяц. Комбинирует маску года и месяца. Формат зависит от локали (YYYY/MM, YYYY-MM).
-
-#### month
-
-Месяц (01-12). Маска для ввода месяца с валидацией диапазона от 01 до 12.
-
-#### day
-
-День месяца (01-31). Маска для ввода дня с валидацией диапазона от 01 до 31.
-
-#### day-month
-
-День и месяц. Комбинирует маску дня и месяца без года. Полезно для дней рождения, праздников.
-
-### Локализация
-
-Форматы автоматически адаптируются к локали через свойство `language`:
-
-**Русский (ru):**
-- Формат даты: DD.MM.YYYY
-- Разделитель: точка
-- Пример: `31.12.2024`
-
-**Английский (en-US):**
-- Формат даты: MM/DD/YYYY
-- Разделитель: слэш
-- Пример: `12/31/2024`
-
-**Немецкий (de):**
-- Формат даты: DD.MM.YYYY
-- Разделитель: точка
-- Пример: `31.12.2024`
-
-```html
-<Mask type="date" language="ru" />
-<!-- Результат: 31.12.2024 -->
-
-<Mask type="date" language="en-US" />
-<!-- Результат: 12/31/2024 -->
-
-<Mask type="datetime" language="ru" />
-<!-- Результат: 31.12.2024 14:30 -->
-
-<Mask type="time" />
-<!-- Результат: 14:30:45 -->
-```

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

@@ -1,20 +0,0 @@
-### `value`
-
-Final formatted mask value.
-
-**Type:** `Ref<string>`
-
-### `valueBasic`
-
-Basic mask value without formatting (only entered characters).
-
-**Type:** `Ref<string>`
-
-### `set`
-
-Sets new value and reinitializes the mask.
-
-**Parameters:**
-- `value: string` — new value to set
-
-**Returns:** `boolean` — `true` if the value was changed

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

@@ -1,20 +0,0 @@
-### `value`
-
-Итоговое отформатированное значение маски.
-
-**Тип:** `Ref<string>`
-
-### `valueBasic`
-
-Базовое значение маски без форматирования (только введённые символы).
-
-**Тип:** `Ref<string>`
-
-### `set`
-
-Устанавливает новое значение и переинициализирует маску.
-
-**Параметры:**
-- `value: string` — новое значение для установки
-
-**Возвращает:** `boolean` — `true`, если значение было изменено

package/src/media/mdx/Mask/groupSave.en.mdx

@@ -1,26 +0,0 @@
-## Preserving groups on deletion
-
-The `groupSave` property controls behavior when deleting characters in a mask with multiple types of special characters.
-
-**Possible values:**
-
-- `true` — preserves group separation on deletion (default)
-- `false` — allows characters from different groups to mix on deletion
-
-With `groupSave: true` and different groups ahead, the character is not physically deleted but marked with a deletion marker, preserving the mask structure. With `false`, characters are deleted completely, which can lead to "collapsing" of groups and loss of structure. Only works for fixed (non-rubber) groups of special characters.
-
-```html
-<!-- Preserve group structure (default) -->
-<Mask
-  mask="***-###"
-  :special="['*', '#']"
-  groupSave
-/>
-
-<!-- Without structure preservation -->
-<Mask
-  mask="***-###"
-  :special="['*', '#']"
-  :groupSave="false"
-/>
-```

package/src/media/mdx/Mask/groupSave.ru.mdx

@@ -1,26 +0,0 @@
-## Сохранение групп при удалении
-
-Свойство `groupSave` управляет поведением при удалении символов в маске с несколькими типами специальных символов.
-
-**Возможные значения:**
-
-- `true` — сохраняет разделение групп при удалении (по умолчанию)
-- `false` — позволяет символам из разных групп смешиваться при удалении
-
-При `groupSave: true` и наличии разных групп впереди символ не удаляется физически, а помечается маркером удаления, сохраняя структуру маски. При `false` символы удаляются полностью, что может привести к "схлопыванию" групп и потере структуры. Работает только для фиксированных (не резиновых) групп специальных символов.
-
-```html
-<!-- Сохранение структуры групп (по умолчанию) -->
-<Mask
-  mask="***-###"
-  :special="['*', '#']"
-  groupSave
-/>
-
-<!-- Без сохранения структуры -->
-<Mask
-  mask="***-###"
-  :special="['*', '#']"
-  :groupSave="false"
-/>
-```

package/src/media/mdx/Mask/mask.en.mdx

@@ -1,21 +0,0 @@
-## Mask template
-
-The `mask` property defines a template for structured data input with automatic real-time formatting.
-
-**Possible values:**
-
-- `string` — single mask for fixed format
-- `string[]` — array of masks to support multiple formats with automatic selection
-
-The template uses two types of characters: special characters (default `*`) denote positions for user input, while literal characters are inserted automatically and cannot be changed. The component automatically adds separators during typing and restricts input to only allowed characters in corresponding positions. When using an array of masks, the system automatically selects the most suitable template based on entered data. Works together with the validation system through `pattern` and `check` properties. For built-in types (`currency`, `number`, `date`), masks are generated automatically based on regional settings.
-
-```html
-<!-- Russian phone -->
-<Mask mask="+7 *** *** ** **" />
-
-<!-- Bank card -->
-<Mask mask="**** **** **** ****" />
-
-<!-- Multiple formats -->
-<Mask :mask="['+7 *** *** ** **', '8 *** *** ** **']" />
-```

package/src/media/mdx/Mask/mask.ru.mdx

@@ -1,21 +0,0 @@
-## Шаблон маски
-
-Свойство `mask` определяет шаблон для структурированного ввода данных с автоматическим форматированием в реальном времени.
-
-**Возможные значения:**
-
-- `string` — одиночная маска для фиксированного формата
-- `string[]` — массив масок для поддержки множественных форматов с автоматическим выбором
-
-В шаблоне используются два типа символов: специальные символы (по умолчанию `*`) обозначают позиции для пользовательского ввода, а литеральные символы вставляются автоматически и не могут быть изменены. Компонент автоматически добавляет разделители во время набора и ограничивает ввод только допустимыми символами в соответствующих позициях. При использовании массива масок система автоматически выбирает наиболее подходящий шаблон на основе введённых данных. Работает совместно с системой валидации через свойства `pattern` и `check`. Для встроенных типов (`currency`, `number`, `date`) маски генерируются автоматически на основе региональных настроек.
-
-```html
-<!-- Российский телефон -->
-<Mask mask="+7 *** *** ** **" />
-
-<!-- Банковская карта -->
-<Mask mask="**** **** **** ****" />
-
-<!-- Множественные форматы -->
-<Mask :mask="['+7 *** *** ** **', '8 *** *** ** **']" />
-```

package/src/media/mdx/Mask/match.en.mdx

@@ -1,28 +0,0 @@
-## Input character validation
-
-The `match` property defines a regular expression for checking the validity of entered characters.
-
-**Possible values:**
-
-- `RegExp` — regular expression (default `/[0-9]/`)
-- `string` — string converted to regular expression
-
-Checks each character during input. Characters that don't match the expression are ignored. Local `match` in group settings (`special[group].match`) takes priority over global. Differs from `pattern` in that `match` is a simple regular expression check, while `pattern` can be a function with access to mask state.
-
-```html
-<!-- Digits only (default) -->
-<Mask mask="***-***" />
-
-<!-- HEX characters -->
-<Mask mask="***-***" :match="/[A-F0-9]/i" />
-
-<!-- Different rules for groups -->
-<Mask
-  mask="***-###"
-  match="\\d"
-  :special="{
-    '*': {},
-    '#': { match: /[A-Z]/ }
-  }"
-/>
-```

package/src/media/mdx/Mask/match.ru.mdx

@@ -1,28 +0,0 @@
-## Валидация вводимых символов
-
-Свойство `match` определяет регулярное выражение для проверки допустимости вводимых символов.
-
-**Возможные значения:**
-
-- `RegExp` — регулярное выражение (по умолчанию `/[0-9]/`)
-- `string` — строка, преобразуется в регулярное выражение
-
-Проверяет каждый символ при вводе. Символы, не соответствующие выражению, игнорируются. Локальный `match` в настройках группы (`special[группа].match`) имеет приоритет над глобальным. Отличается от `pattern` тем, что `match` — простая проверка регулярным выражением, а `pattern` может быть функцией с доступом к состоянию маски.
-
-```html
-<!-- Только цифры (по умолчанию) -->
-<Mask mask="***-***" />
-
-<!-- HEX-символы -->
-<Mask mask="***-***" :match="/[A-F0-9]/i" />
-
-<!-- Разные правила для групп -->
-<Mask
-  mask="***-###"
-  match="\\d"
-  :special="{
-    '*': {},
-    '#': { match: /[A-Z]/ }
-  }"
-/>
-```

package/src/media/mdx/Mask/numberTypes.en.mdx

@@ -1,93 +0,0 @@
-## Numeric mask types
-
-Numeric types in Mask provide specialized formatting and validation for working with numbers, currencies, and financial data.
-
-**Available types:**
-
-- `number` — simple numeric mask with rubber structure
-- `number-format` — formatted numbers with thousand separators
-- `currency` — currency mask with automatic currency symbol
-
-All numeric types automatically create rubber masks with variable length, ignoring the `mask` property. Numeric character validation occurs at input level, negative values and constraints via `min`/`max` are supported.
-
-The `number-format` and `currency` types apply localized thousand separators according to `language` (space for Russian, comma for English). Decimal places are configured via `fraction` — number for exact digit count, `true` for auto-detection, `false` for integers.
-
-```html
-<!-- Simple number -->
-<Mask type="number" />
-
-<!-- Formatted number -->
-<Mask type="number-format" language="en-US" :fraction="2" />
-
-<!-- Currency -->
-<Mask type="currency" currency="USD" language="en-US" />
-```
-
-### Types
-
-#### number
-
-Simple numeric mask for entering integers and decimals without formatting. Creates a rubber group with variable length, supports negative values. Decimal separator is determined by locale (dot for English, comma for Russian).
-
-#### number-format
-
-Numeric mask with automatic thousand separators to improve readability of large numbers. Works similarly to `number`, but adds thousand and million separators according to regional settings. Suitable for quantitative indicators and statistics.
-
-#### currency
-
-Currency mask with currency symbol and formatting according to regional standards. Automatically adds currency symbol (₽, $, €) and thousand separators. Symbol can be displayed before or after the number depending on locale. The `currencyHide` property allows hiding the currency symbol while keeping the formatting.
-
-### Property fraction
-
-Defines the number of digits after the decimal separator.
-
-**Possible values:**
-
-- `number` — exact number of digits (e.g., `2` for two digits)
-- `true` — automatic detection based on user input
-- `false` or `0` — no decimal places (integers only)
-
-```html
-<!-- Two decimal places -->
-<Mask type="number" :fraction="2" />
-
-<!-- Auto-detection -->
-<Mask type="number-format" :fraction="true" />
-
-<!-- Integers only -->
-<Mask type="currency" currency="USD" :fraction="false" />
-```
-
-### Localization
-
-Formats automatically adapt to locale via the `language` property:
-
-**Russian (ru):**
-- Thousand separator: space
-- Decimal separator: comma
-- Example: `1 234 567,89`
-
-**English (en-US):**
-- Thousand separator: comma
-- Decimal separator: dot
-- Example: `1,234,567.89`
-
-**German (de):**
-- Thousand separator: dot
-- Decimal separator: comma
-- Example: `1.234.567,89`
-
-```html
-<Mask type="number-format" language="ru" :fraction="2" />
-<!-- Result: 1 234,56 -->
-
-<Mask type="number-format" language="en-US" :fraction="2" />
-<!-- Result: 1,234.56 -->
-
-<Mask type="currency" currency="EUR" language="de" />
-<!-- Result: 1.234,56 € -->
-
-<!-- Currency without symbol -->
-<Mask type="currency" currency="USD" :currencyHide="true" />
-<!-- Result: 1,234.56 -->
-```

package/src/media/mdx/Mask/numberTypes.ru.mdx

@@ -1,93 +0,0 @@
-## Числовые типы масок
-
-Числовые типы в Mask обеспечивают специализированное форматирование и валидацию для работы с числами, валютами и финансовыми данными.
-
-**Доступные типы:**
-
-- `number` — простая числовая маска с резиновой структурой
-- `number-format` — форматированные числа с разделителями разрядов
-- `currency` — валютная маска с автоматическим символом валюты
-
-Все числовые типы автоматически создают резиновые маски переменной длины, игнорируя свойство `mask`. Валидация числовых символов происходит на уровне ввода, поддерживаются отрицательные значения и ограничения через `min`/`max`.
-
-Типы `number-format` и `currency` применяют локализованные разделители разрядов согласно `language` (пробел для русского, запятая для английского). Дробная часть настраивается через `fraction` — число для точного количества знаков, `true` для автоопределения, `false` для целых чисел.
-
-```html
-<!-- Простое число -->
-<Mask type="number" />
-
-<!-- Форматированное число -->
-<Mask type="number-format" language="ru" :fraction="2" />
-
-<!-- Валюта -->
-<Mask type="currency" currency="RUB" language="ru" />
-```
-
-### Типы
-
-#### number
-
-Простая числовая маска для ввода целых и дробных чисел без форматирования. Создаёт резиновую группу переменной длины, поддерживает отрицательные значения. Разделитель дробной части определяется локалью (точка для английского, запятая для русского).
-
-#### number-format
-
-Числовая маска с автоматическими разделителями разрядов для улучшения читаемости больших чисел. Работает аналогично `number`, но добавляет разделители тысяч, миллионов согласно региональным настройкам. Подходит для количественных показателей, статистики.
-
-#### currency
-
-Валютная маска с символом валюты и форматированием согласно региональным стандартам. Автоматически добавляет символ валюты (₽, $, €) и разделители разрядов. Символ может отображаться до или после числа в зависимости от локали. Свойство `currencyHide` позволяет скрыть символ валюты, оставив только форматирование.
-
-### Свойство fraction
-
-Определяет количество знаков после десятичного разделителя.
-
-**Возможные значения:**
-
-- `number` — точное количество знаков (например, `2` для двух знаков)
-- `true` — автоматическое определение по вводу пользователя
-- `false` или `0` — без дробной части (только целые числа)
-
-```html
-<!-- Два знака после запятой -->
-<Mask type="number" :fraction="2" />
-
-<!-- Автоопределение -->
-<Mask type="number-format" :fraction="true" />
-
-<!-- Только целые числа -->
-<Mask type="currency" currency="USD" :fraction="false" />
-```
-
-### Локализация
-
-Форматы автоматически адаптируются к локали через свойство `language`:
-
-**Русский (ru):**
-- Разделитель разрядов: пробел
-- Десятичный разделитель: запятая
-- Пример: `1 234 567,89`
-
-**Английский (en-US):**
-- Разделитель разрядов: запятая
-- Десятичный разделитель: точка
-- Пример: `1,234,567.89`
-
-**Немецкий (de):**
-- Разделитель разрядов: точка
-- Десятичный разделитель: запятая
-- Пример: `1.234.567,89`
-
-```html
-<Mask type="number-format" language="ru" :fraction="2" />
-<!-- Результат: 1 234,56 -->
-
-<Mask type="number-format" language="en-US" :fraction="2" />
-<!-- Результат: 1,234.56 -->
-
-<Mask type="currency" currency="EUR" language="de" />
-<!-- Результат: 1.234,56 € -->
-
-<!-- Валюта без символа -->
-<Mask type="currency" currency="USD" :currencyHide="true" />
-<!-- Результат: 1,234.56 -->
-```

package/src/media/mdx/Mask/pattern.en.mdx

@@ -1,66 +0,0 @@
-## Validation and patterns
-
-The `pattern` and `check` properties are designed for managing input validation in the mask.
-
-**Properties:**
-
-- `pattern` — defines validation patterns for individual mask groups, checking entered values
-- `check` — global validation pattern applied after the mask is fully completed
-
-Properties work sequentially: `pattern` validates entered values at the mask group level, highlighting validation errors after input. Characters are entered into the field, but when they don't match the pattern, an error message is displayed. Each group (defined by special characters) receives its own pattern. After the mask is fully filled, `check` performs final validation of the entire value, providing an additional layer of verification for complex business logic. Both properties are optional and can be used independently or together for multi-level protection against incorrect data.
-
-```html
-<script setup>
-import { ref } from 'vue'
-
-const phone = ref('')
-const cardNumber = ref('')
-</script>
-
-<template>
-  <!-- Pattern for groups: digits only -->
-  <Mask
-    v-model="phone"
-    mask="+7 (***) ***-**-**"
-    pattern="\\d"
-  />
-
-  <!-- Pattern with function for different groups -->
-  <Mask
-    v-model="phone"
-    mask="DD/MM/YYYY"
-    :special="{
-      'D': {
-        pattern: (masks) => {
-          const value = masks['D']?.value || ''
-          if (value === '0') return '[1-9]'
-          if (value === '3') return '[0-1]'
-          return '\\d'
-        }
-      },
-      'M': {
-        pattern: (masks) => {
-          const value = masks['M']?.value || ''
-          if (value === '0') return '[1-9]'
-          if (value === '1') return '[0-2]'
-          return '\\d'
-        }
-      },
-      'Y': { pattern: '\\d' }
-    }"
-  />
-
-  <!-- Check for final validation -->
-  <Mask
-    v-model="cardNumber"
-    mask="**** **** **** ****"
-    pattern="\\d"
-    :check="(maskData) => {
-      const number = maskData.value.replace(/\s/g, '')
-      return isValidLuhn(number) ? {} : {
-        validationMessage: 'Invalid card number'
-      }
-    }"
-  />
-</template>
-```

package/src/media/mdx/Mask/pattern.ru.mdx

@@ -1,66 +0,0 @@
-## Валидация и паттерны
-
-Свойства `pattern` и `check` предназначены для управления валидацией ввода в маске.
-
-**Свойства:**
-
-- `pattern` — определяет паттерны валидации для отдельных групп маски, проверяя введённые значения
-- `check` — глобальный паттерн валидации, применяемый после полного заполнения маски
-
-Свойства работают последовательно: `pattern` проверяет введённые значения на уровне групп маски, подсвечивая ошибки валидации после ввода. Символы вводятся в поле, но при несоответствии паттерну отображается сообщение об ошибке. Каждая группа (определённая специальными символами) получает свой паттерн. После полного заполнения маски `check` выполняет финальную валидацию всего значения, обеспечивая дополнительный слой проверки для сложной бизнес-логики. Оба свойства опциональны и могут использоваться независимо или совместно для многоуровневой защиты от некорректных данных.
-
-```html
-<script setup>
-import { ref } from 'vue'
-
-const phone = ref('')
-const cardNumber = ref('')
-</script>
-
-<template>
-  <!-- Pattern для групп: только цифры -->
-  <Mask
-    v-model="phone"
-    mask="+7 (***) ***-**-**"
-    pattern="\\d"
-  />
-
-  <!-- Pattern с функцией для разных групп -->
-  <Mask
-    v-model="phone"
-    mask="DD/MM/YYYY"
-    :special="{
-      'D': {
-        pattern: (masks) => {
-          const value = masks['D']?.value || ''
-          if (value === '0') return '[1-9]'
-          if (value === '3') return '[0-1]'
-          return '\\d'
-        }
-      },
-      'M': {
-        pattern: (masks) => {
-          const value = masks['M']?.value || ''
-          if (value === '0') return '[1-9]'
-          if (value === '1') return '[0-2]'
-          return '\\d'
-        }
-      },
-      'Y': { pattern: '\\d' }
-    }"
-  />
-
-  <!-- Check для финальной валидации -->
-  <Mask
-    v-model="cardNumber"
-    mask="**** **** **** ****"
-    pattern="\\d"
-    :check="(maskData) => {
-      const number = maskData.value.replace(/\s/g, '')
-      return isValidLuhn(number) ? {} : {
-        validationMessage: 'Неверный номер карты'
-      }
-    }"
-  />
-</template>
-```