@dxtmisha/wiki 0.39.2 → 0.39.3

package/src/media/mdx/Actions/actions.ru.mdx

@@ -1,48 +0,0 @@
-Контейнер для организации кнопок действий с поддержкой основной и вторичной группировки, различных режимов выравнивания и адаптивного поведения.
-
-Actions централизует управление расположением интерактивных кнопок в диалогах, формах и панелях, автоматически распределяет пространство между группами, поддерживает гибкую адаптацию к доступному месту и предоставляет единый API для создания консистентных наборов действий. Является фундаментальным компонентом для построения пользовательских интерфейсов с четкой иерархией кнопок.
-
-**Основные возможности:**
-
-- Группировка кнопок (основная группа через list, вторичная через listSecondary)
-- Управление выравниванием (left, right, center, block, none)
-- Адаптивное поведение через свойство flexible (adaptive/container)
-- Автоматический спейсер между группами кнопок
-- Раздельная настройка атрибутов (buttonAttrs, buttonSecondaryAttrs)
-- Поддержка слотов для кастомного контента (default, secondary)
-- Интеграция с компонентом Button со всеми его возможностями
-- Гибкая раскладка с автоматическим переходом в блочный режим
-
-**Типичные сценарии использования:**
-
-- Панели действий в диалоговых окнах и модальных окнах
-- Наборы кнопок в формах (отмена, сохранение, применение)
-- Панели управления с основными и дополнительными действиями
-- Адаптивные интерфейсы с автоматической перестройкой на мобильных устройствах
-
-```html
-<script setup>
-import { ref } from 'vue'
-import { Actions } from '@dxtmisha/constructor'
-
-const isLoading = ref(false)
-
-const handleSave = async () => {
-  isLoading.value = true
-  await saveData()
-  isLoading.value = false
-}
-</script>
-
-<template>
-  <Actions
-    align="right"
-    :list="[
-      { label: 'Отмена' },
-      { label: 'Сохранить', primary: true, loading: isLoading }
-    ]"
-  />
-</template>
-```
-
-> Actions — это умный контейнер: он автоматически управляет расположением кнопок, адаптируется к размеру экрана и обеспечивает визуальную иерархию между основными и вторичными действиями.

package/src/media/mdx/Actions/flexible.en.mdx

@@ -1,19 +0,0 @@
-## Adaptive layout behavior
-
-The `flexible` property determines automatic switching to block mode when space is limited.
-
-**Possible values:**
-
-- `'adaptive'` — uses media queries to determine breakpoint
-- `'container'` — uses container queries to adapt to parent size
-
-Automatically applies `align="block"` property when available space becomes smaller than a defined breakpoint. With `adaptive` it tracks screen width through media queries, with `container` it adapts to parent container size. Suitable for creating adaptive interfaces that display correctly on both desktop and mobile devices without additional code.
-
-```html
-<!-- Automatic transition on narrow screens -->
-<Actions flexible="adaptive" :list="[...]" />
-
-<!-- Adapts to parent size -->
-<Actions flexible="container" :list="[...]" />
-```
-

package/src/media/mdx/Actions/flexible.ru.mdx

@@ -1,19 +0,0 @@
-## Адаптивное поведение раскладки
-
-Свойство `flexible` определяет автоматическое переключение раскладки в блочный режим при нехватке места.
-
-**Возможные значения:**
-
-- `'adaptive'` — использует медиа-запросы для определения точки перехода
-- `'container'` — использует container queries для адаптации к размеру родителя
-
-Автоматически применяет свойство `align="block"` когда доступное пространство становится меньше определенного брейкпоинта. При `adaptive` отслеживает ширину экрана через медиа-запросы, при `container` адаптируется к размеру родительского контейнера. Подходит для создания адаптивных интерфейсов, которые корректно отображаются как на десктопе, так и на мобильных устройствах без дополнительного кода.
-
-```html
-<!-- Автоматический переход на узких экранах -->
-<Actions flexible="adaptive" :list="[...]" />
-
-<!-- Адаптация к размеру родителя -->
-<Actions flexible="container" :list="[...]" />
-```
-

package/src/media/mdx/Actions/list.en.mdx

@@ -1,50 +0,0 @@
-## Managing action button groups
-
-The `list` and `listSecondary` properties work together to organize buttons in the Actions container. They manage the rendering of primary and secondary button groups with automatic attribute application and visual separation.
-
-**Properties:**
-
-- `list` — array of configurations for primary action buttons (Cancel, Save, Apply)
-- `listSecondary` — array of configurations for secondary buttons (Delete, Reset, Export)
-
-Each array element represents an object with button configuration, supporting all Button component properties (label, icon, disabled, primary, loading, and others). The component automatically applies base attributes from `buttonAttrs` to primary buttons and from `buttonSecondaryAttrs` to secondary ones. Secondary buttons are positioned separately with an automatic spacer and are hidden in `align="center"` and `align="block"` modes. Use `list` for primary actions and `listSecondary` for destructive or less important operations.
-
-```html
-<!-- Primary buttons -->
-<Actions
-  :list="[
-    { label: 'Cancel', onClick: () => close() },
-    { label: 'Save', primary: true, onClick: () => save() }
-  ]"
-/>
-
-<!-- Primary and secondary buttons -->
-<Actions
-  :list="[
-    { label: 'Cancel' },
-    { label: 'Save', primary: true }
-  ]"
-  :list-secondary="[
-    { label: 'Delete', text: true, icon: 'delete', palette: 'error' }
-  ]"
-/>
-
-<!-- Buttons with dynamic state -->
-<Actions
-  :list="[
-    { label: 'Cancel', disabled: isProcessing },
-    { label: 'Save', primary: true, loading: isLoading }
-  ]"
-  :button-attrs="{ size: 'medium' }"
-/>
-
-<!-- Secondary buttons with settings -->
-<Actions
-  :list="[{ label: 'Close' }]"
-  :list-secondary="[
-    { label: 'Export', icon: 'download' },
-    { label: 'Help', icon: 'help' }
-  ]"
-  :button-secondary-attrs="{ size: 'small', text: true }"
-/>
-```

package/src/media/mdx/Actions/list.ru.mdx

@@ -1,50 +0,0 @@
-## Управление группами кнопок действий
-
-Свойства `list` и `listSecondary` работают в связке для организации кнопок в контейнере Actions. Они управляют рендерингом основной и вторичной групп кнопок с автоматическим применением атрибутов и визуальным разделением.
-
-**Свойства:**
-
-- `list` — массив конфигураций для основных кнопок действий (Отмена, Сохранить, Применить)
-- `listSecondary` — массив конфигураций для вторичных кнопок (Удалить, Сбросить, Экспорт)
-
-Каждый элемент массива представляет собой объект с конфигурацией кнопки, поддерживающий все свойства компонента Button (label, icon, disabled, primary, loading и другие). Компонент автоматически применяет базовые атрибуты из `buttonAttrs` к основным кнопкам и из `buttonSecondaryAttrs` к вторичным. Вторичные кнопки располагаются отдельно с автоматическим спейсером и скрываются в режимах `align="center"` и `align="block"`. Используйте `list` для основных действий и `listSecondary` для деструктивных или менее важных операций.
-
-```html
-<!-- Основные кнопки -->
-<Actions
-  :list="[
-    { label: 'Отмена', onClick: () => close() },
-    { label: 'Сохранить', primary: true, onClick: () => save() }
-  ]"
-/>
-
-<!-- Основные и вторичные кнопки -->
-<Actions
-  :list="[
-    { label: 'Отмена' },
-    { label: 'Сохранить', primary: true }
-  ]"
-  :list-secondary="[
-    { label: 'Удалить', text: true, icon: 'delete', palette: 'error' }
-  ]"
-/>
-
-<!-- Кнопки с динамическим состоянием -->
-<Actions
-  :list="[
-    { label: 'Отмена', disabled: isProcessing },
-    { label: 'Сохранить', primary: true, loading: isLoading }
-  ]"
-  :button-attrs="{ size: 'medium' }"
-/>
-
-<!-- Вторичные кнопки с настройками -->
-<Actions
-  :list="[{ label: 'Закрыть' }]"
-  :list-secondary="[
-    { label: 'Экспорт', icon: 'download' },
-    { label: 'Справка', icon: 'help' }
-  ]"
-  :button-secondary-attrs="{ size: 'small', text: true }"
-/>
-```

package/src/media/mdx/Actions/wikiMdxActions.ts

@@ -1,31 +0,0 @@
-import type { StorybookComponentsMdxItem } from '../../../types/storybookTypes'
-
-import actionsEn from './actions.en.mdx'
-import actionsRu from './actions.ru.mdx'
-import flexibleEn from './flexible.en.mdx'
-import flexibleRu from './flexible.ru.mdx'
-import listEn from './list.en.mdx'
-import listRu from './list.ru.mdx'
-
-/**
- * MDX files for Actions component
- *
- * MDX файлы для компонента Actions
- */
-export const wikiMdxActions: StorybookComponentsMdxItem = {
-  name: 'Actions',
-  descriptions: {
-    actions: {
-      en: actionsEn,
-      ru: actionsRu
-    },
-    flexible: {
-      en: flexibleEn,
-      ru: flexibleRu
-    },
-    list: {
-      en: listEn,
-      ru: listRu
-    }
-  }
-}

package/src/media/mdx/Anchor/anchor.en.mdx

@@ -1,34 +0,0 @@
-Component for creating anchor links with smooth scrolling and URL copying capabilities.
-
-Anchor provides interactive anchor links for navigating through page sections. The component automatically handles clicks, updates the URL address, supports smooth scrolling with customizable offset, and integrates with Tooltip for displaying copy notifications. It can work both in regular navigation mode and in link copying mode to clipboard.
-
-**Key features:**
-
-- Smooth scrolling to target element with configurable parameters
-- Automatic navigation on page load based on URL hash
-- Copy mode for copying full link to clipboard
-- Tooltip integration for copy notifications
-- Icon support for visual styling
-- Hidden anchors for creating invisible navigation points
-- URL updates via history API without page reload
-
-**Typical use cases:**
-
-- Navigation through documentation sections and long pages
-- Anchors for headings with copy link button
-- Table of contents and page navigation menu
-- "Share link to section" buttons
-- Creating invisible anchor points for programmatic navigation
-
-```html
-<template>
-  <!-- Regular anchor -->
-  <Anchor name="section-1" text="Go to section" />
-
-  <!-- With copy mode -->
-  <Anchor name="section-2" text="Copy link" isCopy />
-
-  <!-- Hidden anchor -->
-  <Anchor name="section-3" hide />
-</template>
-```

package/src/media/mdx/Anchor/anchor.ru.mdx

@@ -1,34 +0,0 @@
-Компонент для создания якорных ссылок с плавной прокруткой и возможностью копирования URL.
-
-Anchor предоставляет интерактивные якорные ссылки для навигации по разделам страницы. Компонент автоматически обрабатывает клики, обновляет URL-адрес, поддерживает плавную прокрутку с настраиваемым отступом и интегрируется с Tooltip для отображения уведомлений при копировании. Может работать как в режиме обычной навигации, так и в режиме копирования ссылки в буфер обмена.
-
-**Основные возможности:**
-
-- Плавная прокрутка к целевому элементу с настройкой параметров
-- Автоматическая навигация при загрузке страницы по хешу в URL
-- Режим копирования полной ссылки в буфер обмена
-- Интеграция с Tooltip для уведомлений о копировании
-- Поддержка иконок для визуального оформления
-- Скрытые якоря для создания невидимых точек навигации
-- Обновление URL через history API без перезагрузки страницы
-
-**Типичные сценарии использования:**
-
-- Навигация по разделам документации и длинных страниц
-- Якоря для заголовков с кнопкой копирования ссылки
-- Оглавление и меню навигации по странице
-- Кнопки "Поделиться ссылкой на раздел"
-- Создание невидимых якорных точек для программной навигации
-
-```html
-<template>
-  <!-- Обычный якорь -->
-  <Anchor name="section-1" text="Перейти к разделу" />
-
-  <!-- С копированием -->
-  <Anchor name="section-2" text="Скопировать ссылку" isCopy />
-
-  <!-- Скрытый якорь -->
-  <Anchor name="section-3" hide />
-</template>
-```

package/src/media/mdx/Anchor/expose.go.en.mdx

@@ -1 +0,0 @@
-- `go(): void` — Method for scrolling the page to the current anchor element. Uses scroll settings (`behavior`, `block`, `inline`, `shift`) and updates the page URL.

package/src/media/mdx/Anchor/expose.go.ru.mdx

@@ -1 +0,0 @@
-- `go(): void` — Метод для прокрутки страницы к текущему элементу якоря. Использует настройки прокрутки (`behavior`, `block`, `inline`, `shift`) и обновляет URL страницы.

package/src/media/mdx/Anchor/hide.en.mdx

@@ -1,28 +0,0 @@
-## Hidden anchors
-
-The `hide` property creates an invisible anchor point for programmatic navigation without visual representation.
-
-**Properties:**
-
-- `hide` — hides the visual representation of the component (default `false`)
-- `name` — anchor name for navigation (required property)
-
-When `hide` is enabled, the component renders as a hidden `<a name="...">` element without text, icons, or styling. This is useful for creating invisible navigation points that can be programmatically scrolled to or used as target elements for other anchors. The hidden anchor remains in the DOM and is accessible for navigation via URL hash or scroll methods.
-
-```html
-<template>
-  <!-- Hidden anchor in section -->
-  <section>
-    <Anchor name="section-start" hide />
-    <h2>Section heading</h2>
-  </section>
-
-  <!-- Combination of hidden and visible -->
-  <h3>
-    <Anchor name="heading" hide />
-    Heading
-    <Anchor name="heading" isCopy iconTag="link" />
-  </h3>
-</template>
-```
-

package/src/media/mdx/Anchor/hide.ru.mdx

@@ -1,28 +0,0 @@
-## Скрытые якоря
-
-Свойство `hide` создаёт невидимую якорную точку для программной навигации без визуального представления.
-
-**Свойства:**
-
-- `hide` — скрывает визуальное представление компонента (по умолчанию `false`)
-- `name` — имя якоря для навигации (обязательное свойство)
-
-При включённом `hide` компонент рендерится как скрытый элемент `<a name="...">` без текста, иконок и стилей оформления. Это полезно для создания невидимых точек навигации, к которым можно программно прокручивать страницу или использовать их как целевые элементы для других якорей. Скрытый якорь остаётся в DOM и доступен для навигации через URL хеш или методы прокрутки.
-
-```html
-<template>
-  <!-- Скрытый якорь в секции -->
-  <section>
-    <Anchor name="section-start" hide />
-    <h2>Заголовок раздела</h2>
-  </section>
-
-  <!-- Комбинация скрытого и видимого -->
-  <h3>
-    <Anchor name="heading" hide />
-    Заголовок
-    <Anchor name="heading" isCopy iconTag="link" />
-  </h3>
-</template>
-```
-

package/src/media/mdx/Anchor/isCopy.en.mdx

@@ -1,23 +0,0 @@
-## Copy link
-
-The `isCopy` property switches the component to anchor link copying mode to clipboard.
-
-**Properties:**
-
-- `isCopy` — enables link copying mode (default `false`)
-- `iconTag` — icon displayed in copy mode
-- `iconContentCopy` — icon shown after successful copy
-- `delayHide` — delay before hiding notification in milliseconds (default `3072`)
-
-When `isCopy` is enabled, clicking the component doesn't scroll to the anchor but copies the full link (including origin and pathname) to clipboard. After copying, a Tooltip with notification automatically opens and closes after the time specified in `delayHide`. The icon changes from `iconTag` to `iconContentCopy` for visual confirmation of the action.
-
-```html
-<template>
-  <!-- Basic mode -->
-  <Anchor name="section" text="Copy link" isCopy />
-
-  <!-- With custom icons -->
-  <Anchor name="heading" isCopy iconTag="share" iconContentCopy="check" />
-</template>
-```
-

package/src/media/mdx/Anchor/isCopy.ru.mdx

@@ -1,23 +0,0 @@
-## Копирование ссылки
-
-Свойство `isCopy` переключает компонент в режим копирования ссылки на якорь в буфер обмена.
-
-**Свойства:**
-
-- `isCopy` — включает режим копирования ссылки (по умолчанию `false`)
-- `iconTag` — иконка, отображаемая в режиме копирования
-- `iconContentCopy` — иконка, показываемая после успешного копирования
-- `delayHide` — задержка перед скрытием уведомления в миллисекундах (по умолчанию `3072`)
-
-При включённом `isCopy` клик по компоненту не выполняет прокрутку к якорю, а копирует полную ссылку (включая origin и pathname) в буфер обмена. После копирования автоматически открывается Tooltip с уведомлением, который закрывается через время, указанное в `delayHide`. Иконка меняется с `iconTag` на `iconContentCopy` для визуального подтверждения действия.
-
-```html
-<template>
-  <!-- Базовый режим -->
-  <Anchor name="section" text="Скопировать ссылку" isCopy />
-
-  <!-- С кастомными иконками -->
-  <Anchor name="heading" isCopy iconTag="share" iconContentCopy="check" />
-</template>
-```
-

package/src/media/mdx/Anchor/scroll.en.mdx

@@ -1,34 +0,0 @@
-## Scroll Settings
-
-The `behavior`, `block`, `inline`, and `shift` properties control the scrolling behavior to the element when navigating via an anchor.
-
-**Properties:**
-
-- `behavior` — defines the scroll transition animation (`auto`, `smooth`, `instant`)
-- `block` — vertical alignment of the element (`start`, `center`, `end`, `nearest`)
-- `inline` — horizontal alignment of the element (`start`, `center`, `end`, `nearest`)
-- `shift` — scroll offset from the top edge (in pixels)
-
-> **Note:** If the `shift` property is set, the component uses `window.scrollTo` instead of `element.scrollIntoView`. In this case, the `block` and `inline` properties are ignored, and scrolling is always aligned to the top edge of the element with the specified offset.
-
-These properties allow you to customize exactly how the page scrolls to the target element. For example, you can enable smooth scrolling or change the positioning of the element on the screen after scrolling.
-
-```html
-<template>
-  <Anchor
-    href="#target"
-    behavior="smooth"
-    block="center"
-    inline="nearest"
-  >
-    Go to element
-  </Anchor>
-
-  <Anchor
-    href="#target"
-    :shift="100"
-  >
-    Go with offset
-  </Anchor>
-</template>
-```

package/src/media/mdx/Anchor/scroll.ru.mdx

@@ -1,35 +0,0 @@
-## Настройка прокрутки
-
-Свойства `behavior`, `block`, `inline` и `shift` управляют поведением прокрутки к элементу при переходе по якорю.
-
-**Свойства:**
-
-- `behavior` — определяет анимацию прокрутки (`auto`, `smooth`, `instant`)
-- `block` — вертикальное выравнивание элемента (`start`, `center`, `end`, `nearest`)
-- `inline` — горизонтальное выравнивание элемента (`start`, `center`, `end`, `nearest`)
-- `shift` — смещение прокрутки от верхнего края (в пикселях)
-
-> **Примечание:** Если задано свойство `shift`, компонент использует `window.scrollTo` вместо `element.scrollIntoView`. В этом случае свойства `block` и `inline` игнорируются, и прокрутка всегда выполняется к верхней границе элемента с учетом указанного смещения.
-
-Эти свойства позволяют настроить, как именно страница будет прокручиваться к целевому элементу. Например, можно сделать плавную прокрутку или изменить позиционирование элемента на экране после прокрутки.
-
-```html
-<template>
-  <Anchor
-    href="#target"
-    behavior="smooth"
-    block="center"
-    inline="nearest"
-  >
-    Перейти к элементу
-  </Anchor>
-
-  <Anchor
-    href="#target"
-    :shift="100"
-  >
-    Перейти со смещением
-  </Anchor>
-</template>
-```
-

package/src/media/mdx/Anchor/wikiMdxAnchor.ts

@@ -1,43 +0,0 @@
-import type { StorybookComponentsMdxItem } from '../../../types/storybookTypes'
-
-import anchorEn from './anchor.en.mdx'
-import anchorRu from './anchor.ru.mdx'
-import exposeGoEn from './expose.go.en.mdx'
-import exposeGoRu from './expose.go.ru.mdx'
-import hideEn from './hide.en.mdx'
-import hideRu from './hide.ru.mdx'
-import isCopyEn from './isCopy.en.mdx'
-import isCopyRu from './isCopy.ru.mdx'
-import scrollEn from './scroll.en.mdx'
-import scrollRu from './scroll.ru.mdx'
-
-/**
- * MDX files for Anchor component
- *
- * MDX файлы для компонента Anchor
- */
-export const wikiMdxAnchor: StorybookComponentsMdxItem = {
-  name: 'Anchor',
-  descriptions: {
-    'anchor': {
-      en: anchorEn,
-      ru: anchorRu
-    },
-    'expose.go': {
-      en: exposeGoEn,
-      ru: exposeGoRu
-    },
-    'hide': {
-      en: hideEn,
-      ru: hideRu
-    },
-    'isCopy': {
-      en: isCopyEn,
-      ru: isCopyRu
-    },
-    'scroll': {
-      en: scrollEn,
-      ru: scrollRu
-    }
-  }
-}

package/src/media/mdx/Arrow/arrow.en.mdx

@@ -1,33 +0,0 @@
-Component for displaying a graphical indicator (arrow) used to visually link floating elements to their target.
-
-Arrow provides automatic or manual positioning of the indicator. It is often used within Tooltip, Popover, and Dropdown components to indicate the direction towards the trigger or target element. The component supports adaptation to various sizes and styles, and can dynamically update its position.
-
-**Key Features:**
-
-- Automatic and manual positioning (top, bottom, left, right)
-- Support for inverted style
-- Binding to a target element (elementTarget)
-- Dynamic position updates
-- Customizable SVG arrow graphics
-- Integration with positioning components
-
-**Typical Use Cases:**
-
-- Indicators in tooltips
-- Arrows in dropdown menus and popovers
-- Visual links in tour guides
-- Directional indicators in the interface
-
-```html
-<script setup>
-import { Arrow } from 'dxt-ui'
-</script>
-
-<template>
-  <div class="relative p-4 border rounded">
-    Content with arrow
-    <Arrow position="top" />
-  </div>
-</template>
-```
-

package/src/media/mdx/Arrow/arrow.ru.mdx

@@ -1,33 +0,0 @@
-Компонент для отображения графического указателя (стрелки), используемого для визуальной связи всплывающих элементов с их целью.
-
-Arrow обеспечивает автоматическое или ручное позиционирование указателя. Часто применяется в составе компонентов Tooltip, Popover и Dropdown для указания направления на триггер или целевой элемент. Компонент поддерживает адаптацию под различные размеры и стили, а также может динамически обновлять свое положение.
-
-**Основные возможности:**
-
-- Автоматическое и ручное позиционирование (top, bottom, left, right)
-- Поддержка инвертированного стиля
-- Привязка к целевому элементу (elementTarget)
-- Динамическое обновление положения
-- Настраиваемая SVG-графика стрелки
-- Интеграция с компонентами позиционирования
-
-**Типичные сценарии использования:**
-
-- Указатели во всплывающих подсказках
-- Стрелки в выпадающих меню и поповерах
-- Визуальные связи в пошаговых руководствах
-- Индикаторы направления в интерфейсе
-
-```html
-<script setup>
-import { Arrow } from 'dxt-ui'
-</script>
-
-<template>
-  <div class="relative p-4 border rounded">
-    Контент с указателем
-    <Arrow position="top" />
-  </div>
-</template>
-```
-

package/src/media/mdx/Arrow/wikiMdxArrow.ts

@@ -1,19 +0,0 @@
-import type { StorybookComponentsMdxItem } from '../../../types/storybookTypes'
-
-import arrowEn from './arrow.en.mdx'
-import arrowRu from './arrow.ru.mdx'
-
-/**
- * MDX files for Arrow component
- *
- * MDX файлы для компонента Arrow
- */
-export const wikiMdxArrow: StorybookComponentsMdxItem = {
-  name: 'Arrow',
-  descriptions: {
-    arrow: {
-      en: arrowEn,
-      ru: arrowRu
-    }
-  }
-}